46ed7fee5a
docs(3.0): sweep remaining daemon/schedule/hook prose + MIGRATION-3.0 (ag-qbw) ( #520 )
...
## What
Wave 2 of the AgentOps 3.0 honest-docs sweep (post-#518 audit, bead
ag-qbw). Makes the `docs/` prose match the shipped code: the daemon,
scheduler, factory, and all hooks were **DELETED** (not deprecated).
AgentOps is the in-session loop + context compiler; out-of-session
orchestration is delegated to a substrate (Gas City reference City /
Olympus). Mirrors the already-correct `docs/3.0.md`.
This makes `docs/3.0.md:150` ("the standalone
daemon/scheduler/overnight-runner surfaces are gone from ... live doc
prose") true for the enumerated wave-2 surfaces.
## Deleted (whole docs about deleted commands)
- `docs/scheduling.md` — entire `ao schedule` + `ao daemon` guide
-
`docs/contracts/{agentopsd-control-plane,agentopsd-schedule,routing-policy}.md`
- `docs/contracts/jobspec-openapi-v0.yaml`
- `docs/templates/dark-factory-schedule.yaml.example`
- `docs/design/olympus-v4-specs/*.md` — v4-port reference for the dead
Olympus → agentopsd extraction
## Reframed (prose → in-session + Gas City)
- Daemon/schedule/overnight: `agentops-3-youtube-starter-series.md`,
`agentops-3-pmf-evidence-loop.md`, `wiki-for-agents.md`,
`activation-profiles.md` (+ `profiles/README.md` profile rename),
`CI-CD.md` (overnight lane)
- Hooks → hookless + CI-as-authoritative-gate (hooks removed #511 ):
`knowledge-flywheel.md`, `troubleshooting.md`, `reference.md`,
`CI-CD.md`, `release-e2e-checklist.md`, `seed-definition.md`
## Catalog + cross-link cleanup (no broken links)
- `documentation-index.md` — removed deleted-doc rows + the v4 section
- `contracts/index.md` — removed deleted-contract cards
- `rfcs/0002-jobspec-openapi-v0.md` marked superseded; `SCHEMAS.md`,
`templates/README.md` cross-links fixed
## Created
- `docs/MIGRATION-3.0.md` (from the approved draft) + catalog row +
mkdocs nav entry
## Gates (green for this PR's surfaces)
- Link check: **2723 links, 0 broken**
- Contracts structural floor: **PASS (45 contracts)**
- Contract compatibility (orphans): **PASS**
- markdownlint (all changed/new files): **clean**
- `heal.sh --strict`: **All clean**
- mkdocs-strict: my new doc + nav entry build cleanly. The strict build
is **red on main for pre-existing reasons outside this scope** —
`docs/_hooks/gen_cli_reference.py` FATALs on missing `cli/docs/HOOKS.md`
(hooks removed #511 , generator not updated; release-mechanics domain)
and `docs/3.0.md:172` links `../PRODUCT.md`/`../GOALS.md` (root files
outside the docs tree). Both confirmed present on `origin/main`; filed
for wave 3.
## Scope notes
- Did **not** touch `CHANGELOG.md`, `cli/`, or version files (parallel
worker owns release mechanics).
- The audit grep still matches ~40 more out-of-scope `docs/` files
(contracts/*, code-map, comparisons, narrative pages, runbooks). Filed
as **wave 3 (ag-p7j)**.
Closes-scenario: ag-qbw#doc-sweep-2
Bounded-context: BC1-Corpus
Evidence: docs/3.0.md
2026-05-24 18:27:24 -04:00
b8c5a3761b
feat(agentops): make 3.0 hookless-first
...
Add DDD skill-domain contracts, hook lease inventory, replacement ports, artifact-first RPI skill boundaries, and release exact-SHA validation. Demote ao inject to a compatibility adapter and remove prompt-only default hooks.
2026-05-16 09:43:08 -04:00
cd0d4b9555
fix(codex): keep session-start hook quiet
2026-04-23 23:15:27 -04:00
22fbfa2253
fix(codex): repair native hook manifest install
2026-04-23 23:15:27 -04:00
4a179cd94d
docs(codex): update hookless references to reflect native hooks in v0.115.0+
...
Codex CLI v0.115.0+ supports native hooks (SessionStart, Stop,
UserPromptSubmit, PreToolUse, PostToolUse). Update skills, CLI help
text, and docs to reflect this:
- Skills: using-agentops, recover, quickstart, post-mortem, rpi
now document native hooks as primary, hookless as fallback
- CLI: codex.go help text updated (ao codex start/stop are fallback)
- Docs: architecture, contracts, flywheel, session-lifecycle updated
with codex-native-hooks runtime mode alongside hookless fallback
2026-04-07 09:44:47 -04:00
3eb679c6f6
feat(knowledge): rename athena → compile + add Karpathy-style knowledge compiler
...
Rename the athena skill to compile — a descriptive name that communicates
what it actually does. Extend with Karpathy's LLM Knowledge Bases architecture:
- New compile phase: LLM reads raw .agents/ artifacts and produces interlinked
markdown wiki at .agents/compiled/ with index.md, log.md, backlinks
- New lint phase: detects contradictions, orphan pages, stale claims, coverage gaps
- Pluggable compute backend via AGENTOPS_COMPILE_RUNTIME (ollama|claude|openai)
- Hash-based incremental compilation (only recompile changed sources)
- compile.sh engine with security fixes (no shell injection, path traversal guard)
- Full rename across 93 files: skills, docs, CLI, tests, hooks, scripts, codex
Existing Mine → Grow → Defrag cycle preserved as phases within the larger
compile workflow. No vector DB — compiled wiki IS the retrieval layer.
2026-04-05 17:57:40 -04:00
0030790283
feat(skills): encode evidence-driven anti-patterns, unify flywheel metrics, add normalization defect detection
...
- Create global ~/.agents/MEMORY.md with 7 universal principles and top patterns
- Unify sigma/rho/delta definitions across skills/docs/code (code is truth)
- Add normalization defect scan to Athena defrag (placeholder, stacked frontmatter, bundled, dupes)
- Add anti-pattern pre-flight to /plan (dead infra, brainstorm-as-plan, 40% context, commit cadence)
- Expand pre-mortem from top-5 to top-8 FAIL patterns (dead infra activation, rollback maps, four-surface closure)
- Add 4 new forge uncaptured lesson categories (normalization defects, promotion pipeline, taxonomy, stale contradictions)
- Add normalization defect check to post-mortem four-surface closure
- Fix pre-existing broken link in flywheel-diagnostics.md (regex in code block)
- Sync all changes to skills-codex with Codex-specific adaptations preserved
2026-03-30 15:27:49 -04:00
95d38a61b4
docs(lifecycle): align operational docs with three-gap context lifecycle contract
...
Map runtime mechanics in how-it-works.md and knowledge-flywheel.md to the
canonical three gaps (judgment validation, durable learning, loop closure).
Add gap annotations to hook tables, flywheel stages, and compounding effect.
Replace generic language with AgentOps-specific terminology.
2026-03-29 08:34:28 -04:00
9e4ddcf859
feat: add codex hookless lifecycle fallback
2026-03-23 15:24:33 -04:00
8d1475f328
fix(flywheel): close remaining ag-73u gaps
2026-03-22 16:04:52 -04:00
e93826fdaa
fix(flywheel): update docs and tests for always-on golden signals
...
- Update flywheel skill SKILL.md to remove --golden flag references
- Update README.md and docs/knowledge-flywheel.md
- Rename test to TestFlywheelStatus_GoldenSignalsAlwaysShown and verify
golden signals appear without the flag
2026-03-20 19:38:33 -04:00
771ba2fa88
feat(flywheel): add golden signals for knowledge compounding health
...
Four derived health indicators that distinguish knowledge compounding
from noise accumulation:
1. Velocity Trend — is σρ-δ increasing over time?
2. Citation Pipeline — are citations delivering value?
3. Research Closure — is research being mined into learnings?
4. Reuse Concentration — is the whole pool active or just a few items?
Accessible via `ao flywheel status --golden` (JSON/YAML/table).
Also adds forge→pool bridge (forge_pending.go) that writes pending
learnings as markdown for close-loop ingestion, and session-end
baseline capture hook for velocity trend tracking.
Security fixes from council review: path traversal sanitization,
frontmatter injection prevention, YAML encoder resource leak.
2026-03-20 14:25:30 -04:00
582ff325e4
feat(flywheel): add ranked stigmergic packet scorecard
2026-03-11 14:00:35 -04:00
0c1d4f6308
docs: align lifecycle docs with primitive chain audit
2026-03-11 12:37:24 -04:00
b68a739331
feat(context): replace ao inject with signpost network + on-demand ao lookup
...
Kill the pre-loaded inject blob pattern. Context is now delivered via:
- AGENTS.md signpost files in .agents/ subdirectories (navigation)
- ao lookup --query for on-demand learnings retrieval
- session-start.sh emits a pointer instead of a blob
Issues 1-8 of context-enforcement-phase3 plan:
1. Root .agents/AGENTS.md signpost + .gitignore restructure
2. Six directory signposts (learnings, patterns, plans, council, handoff, rpi)
3. session-start.sh and worktree-setup.sh no longer call ao inject
4. Skills updated: recover, evolve, crank, swarm, council, SKILL-TIERS
5. CLAUDE.md zero-context startup references .agents/AGENTS.md
6. context-contract-check hook deleted + CI/BATS refs removed
7. ao inject stderr deprecation notice + ao lookup help improved
8. Flywheel docs updated (ARCHITECTURE.md, knowledge-flywheel.md)
2026-03-07 11:03:13 -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
37d4b5b2ae
Merge branch 'codex/rpi-supervisor-cli' into main
2026-02-21 19:41:50 -05:00
Bo