e74d8899fd
feat(ci): gate live-hooks reintroduction in docs/ (ag-rryf #doc-hooks-drift-gate) ( #713 )
...
## What
Adds `scripts/check-doc-hooks-drift.sh` — a CI regression guard that
fails when a **live-facing** doc reintroduces a live hooks runtime after
the 3.0 hookless teardown:
- `hooks/hooks.json` (retired manifest), a `hooks/<name>.sh` runtime
path,
- `ao hooks` (not a registered command — verified absent from
`cli/cmd/ao/`),
- a bare `session-{start,end,autostart}*.sh` hook-file ref
…unless the **same line** hedges it as hookless / opt-in / historical /
removed / a git-hook. Companion to `sync-skill-counts.sh` (skill-count
drift) and `check-hookless-cold-start.sh` (fixed-list cold-start gate).
## Scope (and why the exclusions)
`docs/` **minus** surfaces that legitimately/archivally name hooks:
- **archival history** — `CHANGELOG.md`, `releases/`, `learnings/`,
`plans/`, `adr/`, `convergence/`, `sovereignty-proof/` (document the
past / the removal itself)
- **opt-in subsystem** — `contracts/` (hooks-authoring opt-in specs),
`runbooks/` (diagnostic enumeration), `code-map/` (point-in-time audits)
The gate keeps the onboarding / operator / architecture narrative
hookless.
## Also: finishes the ag-t1ca residue the gate flags
The ag-t1ca de-hooking missed 8 live-facing lines (gate caught them);
each is reframed:
- stale `ao hooks` command/smoke refs → removed / `ao doctor`
(`cli-skills-map`, `UPGRADING`, `release-e2e-checklist`,
`contracts/release-readiness`)
- present-tense hooks-as-rules → CI gates (`strategic-direction`)
- hook-runtime mentions → `ao curate constrain` / opt-in framing
(`curation-pipeline`, `leverage-points`, `SCHEMAS` legacy-manifest
label, `workflows/session-lifecycle`)
## Verification
- `scripts/check-doc-hooks-drift.sh` → PASS on this branch (FAILed on
all 8 before the reframes)
- `tests/scripts/check-doc-hooks-drift.bats` → 8/8 (positive /
negative×3 / hedge×2 / exclusion / no-docs error)
- `shellcheck` clean · `markdownlint` 0 errors (9 docs) ·
`validate-cli-skills-map.sh` PASS · `generate-ci-jobs-table.sh --check`
PASS · existing `check-hookless-cold-start.sh` still green
- Wired into `validate.yml` lint/contracts (gated on docs/ci/shell
changes) + auto-run via the bats suite
Closes-scenario: ag-rryf#doc-hooks-drift-gate
Bounded-context: BC2-Validation
Evidence: scripts/check-doc-hooks-drift.sh
2026-06-03 22:38:26 -04:00
b8aa715fa8
docs(roadmap): move aspirational claims into docs/ROADMAP.md (soc-icvff #w1b-roadmap) ( #470 )
...
W1b of the 3.0 reconciliation (match reality). Designed-but-unbuilt
features were scattered through live docs; consolidated into one roadmap
so live docs describe only what exists.
- **docs/ROADMAP.md (NEW)**: gt convoy / bd mol / bd cook, curation
later stages, hookless default-install (ADR-0002 S2–S5), legacy-RPI
removal (soc-1gbpz) — non-committed framing
- troubleshooting.md / brownian-ratchet.md / curation-pipeline.md:
removed inline unbuilt-command examples → ROADMAP pointers
- documentation-index.md + mkdocs nav: cataloged
No code. grep confirms no unbuilt-as-available language left in live
docs.
NOTE: claude-review infra-red (weekly limit, resets May 25) —
operator-authorized bypass when sole red.
Closes-scenario: soc-icvff#w1b-roadmap
Bounded-context: BC1-Corpus
Evidence: docs/ROADMAP.md
2026-05-23 10:08:13 -04:00
816a36d83f
docs: align box-drawing vertical lines in ASCII art
...
Systematic pass over 104 markdown files with box-drawing characters.
Fixed 15 files where interior `│` / outer `┌┐└┘` / divider `┬┴` columns
were off by 1-2 cols from their reference row. Zero content changes —
only whitespace and `─` fill chars moved to recover column alignment.
## Files fixed
**docs/** — CI-CD.md, agentops-system-map.md, brownian-ratchet.md,
context-packet.md, curation-pipeline.md, the-science.md,
comparisons/README.md, comparisons/vs-claude-flow.md
**skills/** — SKILL-TIERS.md, swarm/SKILL.md,
crank/references/fire.md, standards/references/test-pyramid.md
**skills-codex/** — crank/references/fire.md,
quickstart/references/full-catalog.md,
standards/references/test-pyramid.md
## Common failure modes found
- Off-by-one closing corners (e.g., `└───────── ┘` with stray space → `└──────────┘`)
- Box width vs content width mismatch (interior row 1-2 chars wider than its `┌┐` box)
- Diverging canonical widths across rows (widened the narrow rows rather
than truncate content)
- T-junctions (`┬` / `┴`) not aligned with `│` rows above/below
## Scope preserved
- Tree diagrams (`├── file.md` / `│ └── child.md`) — intentional
variable-width indentation, left alone
- Markdown pipe tables — not ASCII art, not touched
- Content of labels/box text — unchanged
Verified: `scripts/docs-build.sh --check` (mkdocs strict) passes clean.
2026-04-19 15:11:31 -04:00
03a97978c5
fix(docs): align ASCII box-drawing diagrams across 23 files
...
Fix right-side │ border alignment in box diagrams. Three fix types:
- Trailing space adjustment for border alignment
- Box border widening for content that exceeded width
- Bottom border dash count matching top border
2026-03-29 07:55:25 -04:00
cec1e6030a
hotfix: include pending repo updates
2026-03-21 11:50:30 -04:00
0e62657856
docs(flywheel): close prevention-ratchet validation loop
2026-03-10 07:44:59 -04:00
899c0eaea5
feat: add finding registry prevention ratchet
2026-03-09 16:44:54 -04:00
4abd2a69be
docs(context): sweep remaining ao inject references across docs/tests/scripts
...
Wave 3 of context-enforcement-phase3: replace ao inject workflow
guidance with ao lookup across documentation, test fixtures, and
scripts. Remaining 32 references are legitimate (inject command
implementation, CHANGELOG history, CLI reference tables, test
fixtures for command detection).
Files updated:
- 11 core docs (context-packet, seed-definition, leverage-points, etc.)
- 7 workflow diagram docs (brief, system-map, cli-skills-map, HOOKS, etc.)
- 4 scripts (proof-run, test-flywheel, check-skill-flag-refs, etc.)
- 3 shell tests (proof-run e2e, token-budgets, no-compaction)
- 1 Go test (json_validity_test.go)
- Production code: metrics_nudge.go, metrics_flywheel.go, hooks.go
2026-03-07 11:59:18 -05:00
9d06279043
chore(na-3re): wave 2 — harden hooks, wire context, clean docs, add CI job (5 issues)
...
Issues: na-3re.7, na-3re.8, na-3re.9, na-3re.10, na-3re.12
Wave 2 changes (37 files):
- na-3re.7: Add check-test-staleness CI job (warn-only, continue-on-error)
- na-3re.8: Harden 4 hooks with WARN-first defaults:
- pre-mortem-gate: AGENTOPS_PREMORTEM_FALLBACK=open (advisory by default)
- task-validation-gate: recursion depth limit (max 3), AGENTOPS_METADATA_GATE=warn
- ratchet-advance: epic-scoped gating via AGENTOPS_ACTIVE_EPIC
- go-complexity-precommit: _validate_restricted_cmd helper
- na-3re.9: Extract section name constants, add context section validation tests
- na-3re.10: Clean stale /learn→/retro refs (5 docs), .agents/retros/→.agents/learnings/
refs (17 files), fix post-mortem SKILL.md step numbering
- na-3re.12: Verify Go code items (6/7 already correct), add ASCII fast-path comment
2026-03-05 10:21:27 -05:00
4fd2512c87
refactor: flatten CLI namespace and liquidate debt
...
Remove 5 namespace parent commands (know, work, quality, settings, start)
and register all 49 leaf commands directly on rootCmd. Flat namespace is
simpler for users; GroupID-based help provides visual grouping without
requiring namespace tokens.
Namespace flattening (184 files):
- Delete know.go, work.go, quality.go, settings.go, start.go
- Invert deprecatedCommands map (old namespace paths → flat paths)
- Update 127 consumer files (hooks, skills, docs, scripts, tests)
Debt liquidation (7 items from post-mortem):
- Fix 62 broken smoke test invocations
- Delete 118 LOC dead deprecatedAlias code
- Widen doctor scan to docs/, scripts/, and subdirectories
- Expand expectedCmds test to all 49 commands (floor 45)
- Add bidirectional expectedCmds sync check
- Create sweep-namespace-references.sh automation
- Fix EXPECTED_COMMANDS array to list flat commands
- Escape sed variables in sweep script
All Go tests pass (36s). All conformance checks pass.
2026-02-26 09:27:38 -05:00
a539546d33
codex installer: ship no-clone install flow and docs sync
2026-02-26 06:24:21 -05:00
c665343d2c
fix: resolve 32 vibe findings (2 critical, 7 high, 12 medium, 11 low)
...
Fix all findings from the v2.17.0..HEAD vibe review across 12 source files:
Critical: panic guards for negative budget in truncateToCharBudget and
dead prefix slice in generateArtifactID. High: bead override in batch
extract, json file counting in metrics, constraint index.json exclusion,
complexity reduction in curate status/verify (38→<25), flexible hook
script count assertion. Medium: truncate panic guards, error logging for
silent failures, null→[] JSON output, goals auto-detect (GOALS.md then
GOALS.yaml), raw var→getter usage, truncate-before-lock race fix. Low:
scanner.Err() checks, os.Stdout→cmd.OutOrStdout(), dry-run output
differentiation.
Docs: 5 missing INDEX.md concept links, curation-pipeline v1 status
callout. Tests: new TestSeed_DryRun_JSON. Regen: COMMANDS.md, embedded
hooks synced. All gates pass: build, vet, test, gocyclo, heal, doc-gate.
2026-02-24 16:51:26 -05:00
cceee2b7c0
feat(seed): Wave 1 docs — strategic direction, seed definition, context packet, curation pipeline
...
The Seed epic (ag-poz) Wave 1: foundational specs for the strategic evolution.
- docs/strategic-direction.md: consolidation synthesis, Meadows 12 LP mapping,
6 paradigm shifts, dK/dt equation, agent-first principles, preserved patterns
- docs/seed-definition.md: 6 minimal seed elements (<10 constraint), DNA metaphor,
fractal property, Meadows mapping per element
- docs/context-packet.md: 5-section spec (GOALS/HISTORY/INTEL/TASK/PROTOCOL),
28K char budget, redaction contract, assembly algorithm, provenance tracking
- docs/curation-pipeline.md: 6-stage pipeline (CATALOG→VERIFY→INDEX→SCORE→
REJECT→CONSTRAIN), incremental v1/v2/v3 build plan, immune system analogy,
failure modes per stage, schema_version: 1
Closes: ag-poz.1, ag-poz.2, ag-poz.3
2026-02-24 12:37:42 -05:00
Bo