generated from coulomb/repo-seed
tegwick
72bbdad2c8
Some checks failed
validate-registry / validate (push) Has been cancelled
T02: remove inherited capability.infotech.repo-template and template consumer docs (statehub-register, template-validation-checklist); add capability.infotech.config-surface-atlas and rewrite capabilities.yaml. T03: seed 4 configuration surfaces (state-hub api-config, ops-warden routing-catalog, reuse-surface federation-sources, ops-bridge tunnel-config) with registry/indexes/surfaces.yaml; source-linked, no values, secret deps by reference. T06: add tools/validate_registry.py (schema + index gate), Makefile (make validate), and .github/workflows/validate.yml (GitHub + Gitea Actions); document in stack-and-commands. Verified malformed entries are rejected. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
34 lines
1.4 KiB
Markdown
34 lines
1.4 KiB
Markdown
## Stack
|
|
|
|
- **Language:** Markdown-first registry and planning repo (no application runtime)
|
|
- **Key deps:** State Hub ADR-001 workplans, `registry/indexes/{capabilities,surfaces}.yaml`,
|
|
`schemas/surface-entry.schema.json` (validated with PyYAML + jsonschema)
|
|
|
|
## Dev Commands
|
|
|
|
```bash
|
|
# Orient (offline-safe)
|
|
cat .custodian-brief.md
|
|
cat INTENT.md
|
|
cat SCOPE.md
|
|
ls workplans/
|
|
ls registry/
|
|
|
|
# Validate the registry (the CI gate — run after any registry/schema edit)
|
|
make validate # schema + index + whitespace + reuse-surface
|
|
python3 tools/validate_registry.py # schema + index consistency only
|
|
git diff --check # whitespace / conflict markers
|
|
reuse-surface validate --root . # capability federation (from reuse-surface checkout)
|
|
|
|
# After workplan or registry edits — from ~/state-hub
|
|
make fix-consistency REPO=config-atlas
|
|
```
|
|
|
|
**Validation gate (CI):** `make validate` is the single gate run by agents and CI
|
|
(`.github/workflows/validate.yml`, read by GitHub *and* Gitea Actions). It validates
|
|
every `registry/surfaces/*.md` against `schemas/surface-entry.schema.json`
|
|
(forbidding inline values/secrets), checks `registry/indexes/surfaces.yaml`
|
|
consistency, and runs `git diff --check`. Requires `pip install pyyaml jsonschema`.
|
|
|
|
**Install / test / build / run:** not applicable — no application runtime. Verify
|
|
changes with `make validate`. |