@jaimevalasek/aioson 1.16.0 → 1.17.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +49 -0
- package/package.json +4 -2
- package/src/cli.js +5 -0
- package/src/commands/chain-audit.js +156 -0
- package/src/commands/runtime.js +27 -0
- package/src/commands/store-system.js +100 -12
- package/src/i18n/messages/en.js +9 -0
- package/src/i18n/messages/es.js +9 -0
- package/src/i18n/messages/fr.js +9 -0
- package/src/i18n/messages/pt-BR.js +9 -0
- package/src/neural-chain-agent-ingest.js +400 -0
- package/src/neural-chain-config.js +95 -0
- package/src/neural-chain-git-ingest.js +280 -0
- package/src/neural-chain-migration.js +61 -0
- package/src/neural-chain-noise-file.js +332 -0
- package/src/neural-chain-sanitize.js +0 -0
- package/src/neural-chain-telemetry.js +90 -0
- package/src/runtime-store.js +2 -0
- package/template/.aioson/agents/analyst.md +1 -1
- package/template/.aioson/agents/briefing.md +3 -1
- package/template/.aioson/agents/copywriter.md +1 -1
- package/template/.aioson/agents/dev.md +2 -2
- package/template/.aioson/agents/deyvin.md +12 -12
- package/template/.aioson/agents/neo.md +94 -72
- package/template/.aioson/agents/product.md +1 -1
- package/template/.aioson/agents/qa.md +3 -3
- package/template/.aioson/agents/sheldon.md +3 -3
- package/template/.aioson/agents/tester.md +1 -1
- package/template/.aioson/docs/briefing/briefing-craft.md +16 -0
- package/template/.aioson/docs/deyvin/runtime-handoffs.md +1 -1
- package/template/.aioson/docs/handoff-persistence.md +7 -7
|
@@ -25,21 +25,21 @@ Before suggesting `/clear` to the user, persist the actionable diagnostic to `pl
|
|
|
25
25
|
2. /clear is safe — the next agent reads plans/{slug}.md
|
|
26
26
|
```
|
|
27
27
|
|
|
28
|
-
`plans/` is the canonical input directory for `/briefing` (and a useful seed for `/product` too). The directory may not exist yet — create it.
|
|
28
|
+
`plans/` is the canonical input directory for `/aioson:agent:briefing` (and a useful seed for `/aioson:agent:product` too). The directory may not exist yet — create it.
|
|
29
29
|
|
|
30
30
|
## When to apply
|
|
31
31
|
|
|
32
32
|
| Situation | Persist? |
|
|
33
33
|
|---|---|
|
|
34
|
-
| Handoff routes to an agent that takes raw plans (`/briefing` first and foremost, sometimes `/product`) | Yes |
|
|
35
|
-
| Handoff routes to an agent that needs a discovery pass (`/analyst`, `/architect`, `/sheldon`) | Yes — they read context from `.aioson/context/` AND from raw plans |
|
|
36
|
-
| Same-session continuation (`/dev` keeps going, `/qa` reviews implementation just done) | No — context is in chat |
|
|
34
|
+
| Handoff routes to an agent that takes raw plans (`/aioson:agent:briefing` first and foremost, sometimes `/aioson:agent:product`) | Yes |
|
|
35
|
+
| Handoff routes to an agent that needs a discovery pass (`/aioson:agent:analyst`, `/aioson:agent:architect`, `/aioson:agent:sheldon`) | Yes — they read context from `.aioson/context/` AND from raw plans |
|
|
36
|
+
| Same-session continuation (`/aioson:agent:dev` keeps going, `/aioson:agent:qa` reviews implementation just done) | No — context is in chat |
|
|
37
37
|
| Handoff happens via tracked live session (`aioson live:handoff`) | No — telemetry already carries the trail |
|
|
38
|
-
| Trivial routing ("you want `/setup` first") with no diagnostic to preserve | No |
|
|
38
|
+
| Trivial routing ("you want `/aioson:agent:setup` first") with no diagnostic to preserve | No |
|
|
39
39
|
|
|
40
40
|
## What to write
|
|
41
41
|
|
|
42
|
-
Structure of `plans/{slug}.md` (lightweight — `/briefing` will enrich it):
|
|
42
|
+
Structure of `plans/{slug}.md` (lightweight — `/aioson:agent:briefing` will enrich it):
|
|
43
43
|
|
|
44
44
|
```md
|
|
45
45
|
# {Short title} — raw plan
|
|
@@ -89,6 +89,6 @@ Session artifacts written:
|
|
|
89
89
|
## Anti-patterns
|
|
90
90
|
|
|
91
91
|
- **Inlining 2 KB of diagnostic as a "seed prompt" in the routing message.** The user shouldn't have to copy-paste a wall of text. Persist it.
|
|
92
|
-
- **Persisting trivial routings.** A user who asks "what does `/setup` do" doesn't need a `plans/` file written. Apply the table above.
|
|
92
|
+
- **Persisting trivial routings.** A user who asks "what does `/aioson:agent:setup` do" doesn't need a `plans/` file written. Apply the table above.
|
|
93
93
|
- **Persisting code archaeology.** Code lives in code; reading recommendations live in the artifact only when they would otherwise be lost across `/clear`.
|
|
94
94
|
- **Forgetting to mention the file.** If you wrote `plans/{slug}.md` but the handoff message doesn't reference it, the user won't know to read it (or to let the next agent read it).
|