coulomb/guide-board
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A compliance and certification helper framework.
276 commits 1 branch 0 tags 286 KiB
Find a file
codex 7e28f4ee55
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Successful in 1s
Details
docs(agents): repoint remote State Hub URL to the in-cluster address 
The remote row pointed at 127.0.0.1:18000, a reverse tunnel back to the
workstation. On railiance01 the State Hub runs in the cluster on that same
machine, so the request left the box and came back to reach a local service.

Refs CUST-WP-0067-T07

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 2583210@bnt-lap001
Assistant-Session: f2bff2d5-e9b2-4338-92ca-10282a927006
2026-08-25 00:21:06 +02:00
.claude/rules docs: workplan-first agent guidance prose (CUST-WP-0055 T04 batch 5) 2026-07-08 19:51:26 +02:00
.forgejo/workflows Add Forgejo CI smoke workflow (enablement template) 2026-07-08 12:32:44 +02:00
docs Add report fragments and export manifest 2026-05-16 03:11:56 +02:00
extensions Add report fragments and export manifest 2026-05-16 03:11:56 +02:00
profiles Separated open-cmis-tck and guide-board repositories 2026-05-07 21:52:44 +02:00
registry Draft capability entry (reuse-surface REUSE-WP-0017-T04, cohort 1) 2026-07-06 19:03:42 +02:00
scripts Add report fragments and export manifest 2026-05-16 03:11:56 +02:00
src/guide_board Add report fragments and export manifest 2026-05-16 03:11:56 +02:00
tests Add report fragments and export manifest 2026-05-16 03:11:56 +02:00
workplans Normalize agent instructions and workplan frontmatter (STATE-WP-0067) 2026-06-22 23:16:25 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-06-22 23:22:01 +02:00
.dockerignore Separated open-cmis-tck and guide-board repositories 2026-05-07 21:52:44 +02:00
.gitignore Initial commit 2026-05-07 18:31:08 +00:00
.repo-classification.yaml Add .repo-classification.yaml (CUST-WP-0050 T11 agent first-pass) 2026-06-22 17:47:36 +02:00
AGENTS.md docs(agents): repoint remote State Hub URL to the in-cluster address 2026-08-25 00:21:06 +02:00
CLAUDE.md Add credential routing instructions for all agent runtimes 2026-06-18 22:48:38 +02:00
Containerfile Add container smoke acceptance 2026-05-15 14:46:21 +02:00
INTENT.md Separated open-cmis-tck and guide-board repositories 2026-05-07 21:52:44 +02:00
LICENSE Adopt Target Revenue Source License V1C1 (org-wide preliminary rollout) 2026-07-30 00:20:58 +02:00
pyproject.toml Separated open-cmis-tck and guide-board repositories 2026-05-07 21:52:44 +02:00
README.md Add report fragments and export manifest 2026-05-16 03:11:56 +02:00
SCOPE.md Refresh agent instruction files 2026-05-18 16:55:42 +02:00

README.md

guide-board

guide-board is a certification and compliance preparation framework. It turns standards, conformance, regulatory, and repository-quality claims into structured evidence that can be reviewed, repeated, compared, and used during assessments.

The root project owns the framework contracts. Domain-specific work lives in extensions.

Local Baseline

The first core is intentionally dependency-light. From a clean checkout:

PYTHONPATH=src python3 -m guide_board extensions list
PYTHONPATH=src python3 -m guide_board extensions validate
PYTHONPATH=src python3 -m guide_board profile validate-target profiles/targets/sample-repository.json
PYTHONPATH=src python3 -m guide_board profile validate-assessment profiles/assessments/sample-noop.json
PYTHONPATH=src python3 -m guide_board plan \
  --target profiles/targets/sample-repository.json \
  --assessment profiles/assessments/sample-noop.json
PYTHONPATH=src python3 -m guide_board run \
  --target profiles/targets/sample-repository.json \
  --assessment profiles/assessments/sample-noop.json
PYTHONPATH=src python3 -m guide_board runs list
PYTHONPATH=src python3 -m guide_board runs trend
PYTHONPATH=src python3 -m guide_board runs gate
PYTHONPATH=src python3 -m guide_board serve --host 127.0.0.1 --port 8080
PYTHONPATH=src python3 -m unittest discover -s tests

External extension repos plug in with --extension-dir:

PYTHONPATH=src python3 -m guide_board --extension-dir ../open-cmis-tck extensions list
PYTHONPATH=src python3 -m guide_board --extension-dir ../open-cmis-tck plan \
  --target ../open-cmis-tck/profiles/targets/kontextual-cmis-compat.json \
  --assessment ../open-cmis-tck/profiles/assessments/cmis-browser-baseline.json

The same CLI contracts are packaged by the container baseline. See docs/CONTAINER.md. The dependency-light local API wraps those contracts for service and container operation; see docs/LOCAL-SERVICE-API.md. New runs write a richer sources.lock.json, reports/submission-package.json, extension report fragments, and exports/export-manifest.json alongside the assessment package so reviewers can inspect source, metadata, artifact, export, and boundary references.

The sample-noop extension exercises the guide-board contracts without invoking an external harness. sdk-fixture demonstrates the extension SDK contracts for schemas, normalizers, mappings, and fixture profiles. open-cmis-tck is the first real seed extension.

See: