Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 2 additions & 12 deletions .agents/spark/SPARK_EXTRAPOLATION_NOTEBOOK.md
Original file line number Diff line number Diff line change
Expand Up @@ -278,18 +278,8 @@ command.
full lane exists.
5. Add tests that reject unregistered scenario directories and missing
done-or-handoff markers.
6. Run:

```bash
python .agents/spark/scripts/validate_spark_lane.py
python -m unittest discover -s .agents/spark/tests -p 'test*.py'
python scripts/validate_agents_md_shape.py
python scripts/validate_agents_mesh.py
python scripts/build_agents_mesh_index.py --check
python scripts/validate_agents_mesh_index.py
python scripts/validate_repo.py
python scripts/release_check.py
```
6. Run the Spark-local checks and repository validation lanes routed by
`.agents/spark/AGENTS.md`.

Adjust the test invocation if the final test module path cannot be imported as
a dotted module because `.agents` is hidden; the center repo uses direct pytest
Expand Down
2 changes: 1 addition & 1 deletion .agents/spark/scenarios/diff-review/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,5 +23,5 @@ source authority, or owner judgment outside the diff.

## Validation

Run read-only checks when useful, such as `git diff --check` or the changed
Run read-only checks when useful, such as the diff hygiene check or the changed
surface validator.
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Changes made:
- None.

Validation run:
- `git diff --check`
- Diff hygiene check

Skipped checks:
- Full release gate skipped because this was review-only.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Changes made:
- Added Spark lane validation command to release check.

Validation run:
- `python .agents/spark/scripts/validate_spark_lane.py`
- Spark-lane validator

Skipped checks:
- None.
Expand Down
2 changes: 1 addition & 1 deletion .agents/spark/scenarios/release-prep/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,4 +24,4 @@ acceptance, multi-repo synthesis, or a slower review.

## Validation

Run `python scripts/release_check.py` when local dependencies are available.
Run the release lane when local dependencies are available.
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Changes made:
- None.

Validation run:
- `python scripts/release_check.py`
- Release lane

Skipped checks:
- GitHub validation not run in this example.
Expand Down
4 changes: 2 additions & 2 deletions .agents/spark/scenarios/technique-refinement/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,6 @@ mechanic or sibling repository must accept the next move.
## Validation

Run the narrowest validation named by the target bundle or owner route. For a
text-only patch with no generated surface, `git diff --check` plus an honest
manual contract pass is enough. Use `python scripts/validate_repo.py` only when
text-only patch with no generated surface, the diff hygiene check plus an honest
manual contract pass is enough. Use repository validation only when
repo law, touched generated surfaces, or the user asks for that broader proof.
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,11 @@ Changes made:
- Tightened the adaptation note without changing technique meaning.

Validation run:
- `git diff --check`
- Diff hygiene check
- Manual atom-contract pass

Skipped checks:
- `python scripts/validate_repo.py` deferred because no generated surfaces changed.
- Repository validation deferred because no generated surfaces changed.
- Full release check deferred because this was a one-bundle text patch.

Remaining risk:
Expand Down
2 changes: 1 addition & 1 deletion .agents/spark/scenarios/test-factory/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,5 +23,5 @@ work before tests can be honest.
## Validation

Run the targeted test command for the changed test family and the validator
named by the owning source surface. Use `python scripts/run_tests.py` only when
named by the owning source surface. Use the repository test runner only when
the user, owner route, or release-prep explicitly asks for broader proof.
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Changes made:
- Added `.agents/spark/tests/test_spark_lane.py`.

Validation run:
- `python -m unittest discover -s .agents/spark/tests -p 'test*.py'`
- Spark-lane tests

Skipped checks:
- Full release check deferred to PR validation.
Expand Down
1 change: 1 addition & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@
/requirements-dev.txt @8Dionysus
/schemas/ @8Dionysus
/scripts/ @8Dionysus
/stats/ @8Dionysus
/techniques/ @8Dionysus
/templates/ @8Dionysus
/tests/ @8Dionysus
16 changes: 16 additions & 0 deletions .github/workflows/nightly-sentinel.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ jobs:
runs-on: ubuntu-latest
env:
ABYSS_MACHINE_REPO_ROOT: ${{ github.workspace }}/.deps/abyss-machine
AOA_KAG_ROOT: ${{ github.workspace }}/.deps/aoa-kag
AOA_STATS_ROOT: ${{ github.workspace }}/.deps/aoa-stats
steps:
- name: Checkout
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
Expand All @@ -28,6 +30,20 @@ jobs:
ref: 5724ce73cae69a0cd2b43996f006dc2bba2ab711
path: .deps/abyss-machine

- name: Checkout aoa-kag index builder
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
with:
repository: 8Dionysus/aoa-kag
ref: da9f50a581645b2173b99dbf771a63d447ec2fec
path: .deps/aoa-kag

- name: Checkout aoa-stats protocol validator
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
with:
repository: 8Dionysus/aoa-stats
ref: 25ebfb784f01d3b93f62994908579c4a2c5d87b1
path: .deps/aoa-stats

- name: Setup Python
uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405
with:
Expand Down
8 changes: 8 additions & 0 deletions .github/workflows/release-audit.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ jobs:
runs-on: ubuntu-latest
env:
ABYSS_MACHINE_REPO_ROOT: ${{ github.workspace }}/.deps/abyss-machine
AOA_STATS_ROOT: ${{ github.workspace }}/.deps/aoa-stats
steps:
- name: Checkout
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
Expand All @@ -29,6 +30,13 @@ jobs:
ref: 5724ce73cae69a0cd2b43996f006dc2bba2ab711
path: .deps/abyss-machine

- name: Checkout aoa-stats protocol validator
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
with:
repository: 8Dionysus/aoa-stats
ref: 25ebfb784f01d3b93f62994908579c4a2c5d87b1
path: .deps/aoa-stats

- name: Setup Python
uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405
with:
Expand Down
8 changes: 8 additions & 0 deletions .github/workflows/repo-validation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ jobs:
runs-on: ubuntu-latest
env:
AOA_KAG_ROOT: ${{ github.workspace }}/.deps/aoa-kag
AOA_STATS_ROOT: ${{ github.workspace }}/.deps/aoa-stats
AOA_REPO_LOCAL_KAG_HISTORY_REPO: aoa-techniques
AOA_REPO_LOCAL_KAG_HISTORY_REF: ${{ github.event.pull_request.base.sha || github.event.before || github.sha }}
AOA_REPO_LOCAL_KAG_EVENT_HISTORY_REF: ${{ github.event.pull_request.base.sha || github.event.before || github.sha }}
Expand All @@ -32,6 +33,13 @@ jobs:
ref: da9f50a581645b2173b99dbf771a63d447ec2fec
path: .deps/aoa-kag

- name: Checkout aoa-stats protocol validator
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd
with:
repository: 8Dionysus/aoa-stats
ref: 25ebfb784f01d3b93f62994908579c4a2c5d87b1
path: .deps/aoa-stats

- name: Setup Python
uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405
with:
Expand Down
9 changes: 8 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,12 +24,15 @@ This repository owns:
- public-safe technique wording and topology selection, including current
domain/kind truth and future family/capability/substrate/risk axes
- owner-local participation in AoA cross-mechanics around reusable practice movement
- owner-local statistical questions, measurement meaning, and public reference
packets about the technique canon
- root-level public-safe legacy provenance, archive, and migration receipts for repo-wide technique-canon history
- generated technique catalogs, capsules, feat-card reader surfaces, and source-lift surfaces

It does not own:

- skill workflow meaning, proof doctrine, routing, role contracts, memory, playbooks, KAG substrate meaning, or stats summaries
- skill workflow meaning, proof doctrine, routing, role contracts, memory,
playbooks, KAG substrate meaning, cross-owner aggregation, or stats summaries
- private project operations, secrets, or infrastructure detail

[DESIGN](DESIGN.md) names the repository system form. [DESIGN.AGENTS](DESIGN.AGENTS.md)
Expand Down Expand Up @@ -58,6 +61,7 @@ for agents.
18. affected generated catalogs, capsules, feat cards, agent-mesh mirrors, or source-lift outputs
19. the nearest local `AGENTS.md` under the touched path when a branch needs
more detail than this root route card
20. [Stats](stats/README.md) when owner-local measurement questions or exports move

## Route modes

Expand All @@ -72,6 +76,7 @@ for agents.
| `direction-change` | roadmap, corpus-scale pressure, portability posture, or future triggers change | [ROADMAP](ROADMAP.md) |
| `mechanic-change` | practice movement, donor intake, audit, recurrence, checkpoint, RPG, or release-support surfaces change | [Mechanics](mechanics/README.md) -> nearest mechanic `AGENTS.md` |
| `generated-parity` | generated catalogs, capsules, source-lift, or repo-doc surfaces change | source doc -> builder -> generated output -> validator/test |
| `local-stats` | owner-local technique-canon measurement meaning or reference packets change | [Stats](stats/README.md) -> owning source -> consuming mechanic |

## AGENTS stack law

Expand Down Expand Up @@ -146,6 +151,8 @@ Update only the ones that moved; otherwise say no update was needed.
schemas, builders, validators, or a stronger sibling owner.
- Do not make root files, docs-root files, or top-level directories without
checking [ROOT_SURFACE_LAW](docs/ROOT_SURFACE_LAW.md).
- Do not infer quality, adoption, runtime use, or promotion decisions from a
local stats packet; return to authored technique and review owners.

## Route away when

Expand Down
39 changes: 21 additions & 18 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,9 @@ The format is intentionally simple and human-first.

### Changed

- added the root `stats/` owner port with a revision-bound promotion-readiness
pass ratio, central protocol validation, and coverage that rejects a false
numerator while preserving technique and audit authority
- added the root `kag/` local provider district and wired it into root surface
law, the AGENTS mesh, and generated mesh index for downstream KAG consumers
- tightened the OS Abyss KAG export artifact envelope so the manifest, validator,
Expand Down Expand Up @@ -945,10 +948,10 @@ The format is intentionally simple and human-first.

### Validation

- `python scripts/validate_repo.py`
- `python scripts/run_tests.py`
- `python scripts/release_check.py`
- `git diff --check`
- repository validation
- the repository test runner
- the release lane
- the diff hygiene check

### Notes

Expand All @@ -959,9 +962,9 @@ The format is intentionally simple and human-first.
- generated outputs remain derived companions; authored technique bundles,
route cards, contracts, decisions, and mechanic-owned review packets remain
the authority surfaces
- exact executable command lanes now live in the owning `AGENTS.md` or
[RELEASING](docs/RELEASING.md) surfaces rather than public route or reader
docs
- exact executable command lanes now live in
`config/validation_lanes.json`, with focused local commands only in the
owning `AGENTS.md`, rather than public route or reader docs
- package publishing to PyPI, npm, or other registries remains out of scope for
this release

Expand Down Expand Up @@ -1002,10 +1005,10 @@ The format is intentionally simple and human-first.

### Validation

- `python scripts/release_check.py`
- `python mechanics/agon/parts/move-technique-bridge/scripts/build_agon_technique_binding_candidates.py --check`
- `python mechanics/agon/parts/move-technique-bridge/scripts/validate_agon_technique_binding_candidates.py`
- `python -m pytest -q mechanics/agon/parts/move-technique-bridge/tests/test_agon_technique_binding_candidates.py`
- the release lane
- the owning part builder
- the owning part validator
- the targeted part-local tests

### Notes

Expand Down Expand Up @@ -1036,7 +1039,7 @@ The format is intentionally simple and human-first.

### Validation

- `python scripts/release_check.py`
- the release lane

### Notes

Expand All @@ -1053,7 +1056,7 @@ The format is intentionally simple and human-first.

### Validation

- `python scripts/release_check.py`
- the release lane

### Notes

Expand Down Expand Up @@ -1145,7 +1148,7 @@ This changelog entry uses the release-prep merge date.

### Validation

- `python scripts/release_check.py`
- the release lane

### Notes

Expand All @@ -1172,7 +1175,7 @@ This changelog entry uses the release-prep merge date.
- the canonical default set expanded across agent workflows, docs, evaluation, and KAG/source-lift surfaces, including `AOA-T-0004`, `AOA-T-0013` through `AOA-T-0019`, `AOA-T-0021`, `AOA-T-0023`, and `AOA-T-0034`
- evidence and review posture is stronger across the corpus through broader `second-context-adaptation`, `canonical-readiness`, `external-origin`, `external-import-review`, and canonical-only `adverse-effects-review` coverage
- repo routing now centers on `docs/START_HERE.md` and the bounded `pick -> inspect -> expand -> object use` operating path
- release and validation posture now centers on `python scripts/release_check.py`, with tighter generator-drift checks, repo-doc and review-surface validation, broader public-hygiene URL scanning, and cleaner worktree behavior
- release and validation posture now centers on the release lane, with tighter generator-drift checks, repo-doc and review-surface validation, broader public-hygiene URL scanning, and cleaner worktree behavior

### Included in this release

Expand All @@ -1185,7 +1188,7 @@ This changelog entry uses the release-prep merge date.

### Validation

- `python scripts/release_check.py`
- the release lane
- the bounded release check reruns repo-doc, catalog, capsule, section, checklist, example, evidence-note, GitHub review-template, semantic-review, and shadow-review builders before `unittest` and `validate_repo`

### Notes
Expand Down Expand Up @@ -1227,8 +1230,8 @@ The GitHub release for `v0.1.0` was published on `2026-03-18`.

Documented local validation path for this release:

- `python -m unittest discover -s tests`
- `python scripts/validate_repo.py`
- the repository test suite
- repository validation

### Notes

Expand Down
6 changes: 6 additions & 0 deletions DESIGN.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,7 @@ should I leave for another AoA owner?
- practice-motion mechanics under [mechanics](mechanics/README.md)
- repo-wide schemas, templates, configs, and examples
- generated reader and machine companions
- an owner-local statistical measurement port for bounded corpus questions
- public-safe legacy and provenance surfaces
- agent-facing route cards

Expand Down Expand Up @@ -123,6 +124,11 @@ Skills, evals, routing, KAG, memory, playbooks, roles, stats, runtime, and ToS
meaning have stronger owners. This repo may route to them but should not absorb
their truth.

Owner-local measurement meaning remains here when it concerns the technique
canon. Cross-owner statistical grammar, aggregation, and views remain with
`aoa-stats`, and neither side may turn a corpus ratio into technique status or
promotion authority.

### 7. Validation before confidence

Every meaningful change should have a local check, a generated-freshness check
Expand Down
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@ owning [mechanics](mechanics/README.md) package.
- `root-editing`: [ROOT_SURFACE_LAW](docs/ROOT_SURFACE_LAW.md)
- `agent-surface-design`: [DESIGN.AGENTS](DESIGN.AGENTS.md)
- `generated-parity`: authored source -> builder -> generated output -> validator
- `local-stats`: [stats](stats/README.md) -> owning source -> consuming mechanic

## Technique Check

Expand Down Expand Up @@ -121,6 +122,7 @@ technique bundle when the reusable practice itself is already authored.
| [docs](docs/README.md) | contracts, route maps, review guides, release docs, and generated-reader interpretation |
| [mechanics](mechanics/README.md) | practice movement, evidence, provenance, and mechanic-local routes |
| [generated](generated/) | reproducible catalogs, capsules, source-lift, review, and mesh companions |
| [stats](stats/README.md) | owner-local corpus questions, measurement contracts, and public reference packets |
| [examples](examples/README.md) | public-safe repo-wide worked examples |
| [templates](templates/) | technique authoring and promotion scaffolds |
| [legacy](legacy/README.md) | public-safe repo-wide raw, archive, and migration receipts |
Expand Down
1 change: 1 addition & 0 deletions config/agents_mesh.json
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,7 @@
"schemas/AGENTS.md",
"scripts/AGENTS.md",
"scripts/validators/AGENTS.md",
"stats/AGENTS.md",
"techniques/AGENTS.md",
"techniques/agent-workflows/AGENTS.md",
"techniques/continuity/AGENTS.md",
Expand Down
Loading