nagent: add v2.2 review (style + intent DSL survey cross-refs)

v2.2 (nagent_review_v2_2_20260612.md, ~35KB) is a focused delta, not a full
rewrite. Two user inputs drove it:

1. The user published intent_dsl_survey_20260612/report_v1.2.md (1367 lines,
   10 prior-art clusters, 4 anchor claims, ~42-verb vocab, 10 AI-Agent
   Properties in §6). The survey's §6 Claims 4 and 5 explicitly cite
   nagent_review_v2_1 §2.1 and §2.2 as the source for the 4 memory
   dimensions and stable-to-volatile cache ordering — so the v2.1 patterns
   are now formally codified by the survey.

2. The user said: 'I don't really like JSON, I like table based formats
   more, or things that are forth/array-like.'

v2.2 applies the data-format preferences:
- JSON block in v2.1 §2.1 (harvest output schema) replaced with a §4.4
  7-column table (Symbol, Name, Signature, Semantics, Example,
  Borrowed from, Shape)
- Comparison table (§5) reformatted with SSDL shape tags
- Future-track candidate list (§6) reformatted as a single 16-row table
  with all metadata columns
- Proposed new artifacts (§8) in table form

v2.2 adopts survey grammar primitives (name := value, for x .. n,
if cond { ... }, tape { ... }, try { ... } recover err { ... },
sandbox { ... }, audit msg, fuzzy { ... }) where applicable.

v2.2 adds:
- Candidate 12b (cache TTL GUI controls) - the v2.1 sub-candidate
- Candidate 16 (AGENTS.md @import + canonical DOD file) - HIGH priority,
  the foundation for all the other styleguides
- New §11 'In dialogue with intent DSL survey' - the 9 mutual cross-refs

v2 and v2.1 are preserved (per user instruction). All v1 artifacts and
the human Readme files are preserved. Format commitment for the
next-turn artifacts: all new styleguides and project docs will follow
the §4.4 table format.
This commit is contained in:
ed
2026-06-12 11:55:35 -04:00
parent 7105f75756
commit fb7b08a5d1
3 changed files with 513 additions and 0 deletions
@@ -229,5 +229,42 @@
"https://github.com/macton/nagent (nagent source code)",
"https://github.com/macton/nagent/blob/main/README.md (nagent README)"
]
},
"v2_2_review": {
"date": "2026-06-12",
"report": "nagent_review_v2_2_20260612.md",
"status": "v2.2 is the focused delta applying the user's data-format preferences and cross-referencing intent_dsl_survey_20260612; v2 and v2.1 are preserved",
"user_input_acknowledged": [
"User published intent_dsl_survey_20260612/report_v1.2.md (1367 lines, 10 prior-art clusters, 4 anchor claims, ~42-verb vocab, 10 AI-Agent Properties)",
"User said: 'I don't really like JSON, I like table based formats more, or things that are forth/array-like'",
"Survey's §6 Claims 4 and 5 explicitly cite nagent_review_v2_1 §2.1 and §2.2 as the source for the 4 memory dimensions and stable-to-volatile cache ordering"
],
"v2_2_user_corrections_applied": [
"Data-format preferences: tables (§4.4 7-column format from survey), SSDL shape tags, no JSON, forth/array notation (for x .. n, name := value, if cond { ... }, tape { ... }, try { ... } recover err { ... }, sandbox { ... })",
"JSON block in v2.1 §2.1 (harvest output schema) replaced with a §4.4-style table",
"Comparison table (§5) reformatted with SSDL shape tags",
"Future-track candidate list (§6) reformatted as a single 16-row table with metadata columns (Symbol, Name, Domain, Priority, Effort, Shape, Depends on, Cross-refs)",
"Proposed new artifacts (§8) reformatted in table form",
"New §11: 'In dialogue with the intent DSL survey' — the 9 mutual cross-references"
],
"intent_dsl_survey_dependencies": [
"report_v1.2.md §1 (4 anchor claims) — applied to the nagent review",
"report_v1.2.md §3.5 (try/recover envelope) — applied to the compaction pattern",
"report_v1.2.md §4.4 (Tier 4 table format) — adopted as the new style for the nagent review",
"report_v1.2.md §6 Claim 4 (4 memory dimensions) — formally codifies nagent v2.1 §2.1",
"report_v1.2.md §6 Claim 5 (stable-to-volatile cache ordering) — formally codifies nagent v2.1 §2.2",
"report_v1.2.md §6 Claim 9 (sandbox as IEventTarget) — referenced",
"report_v1.2.md §6 Claim 10 (reads are free) — referenced"
],
"v2_2_focused_delta": "v2.2 is a FOCUSED DELTA, not a full rewrite. Tables adopt the survey's §4.4 7-column layout. JSON blocks become tables. The 16 future-track candidates are a single table with all metadata columns. The 9 cross-references to the survey are consolidated in a new §11.",
"next_turn_format_commitment": "All new styleguides and project docs proposed in v2.1/v2.2 §8 will follow the §4.4 7-column table format. No JSON code blocks. SSDL shape tags where applicable. Survey grammar primitives (name := value, for x .. n, if cond { ... }, tape { ... }, try { ... } recover err { ... }, sandbox { ... }, audit msg, fuzzy { ... }) used in code examples.",
"preserved_files_NOT_modified": [
"nagent_review_v2_20260612.md (v2 draft, preserved per user instruction)",
"nagent_review_v2_1_20260612.md (v2.1 user-revised, preserved per user instruction)",
"report.md, comparison_table.md, decisions.md, nagent_takeaways_20260608.md (v1 review artifacts, preserved)",
"Readme.md (project root, human-facing, preserved)",
"docs/Readme.md (docs index, human-facing, preserved)",
"spec.md (preserved)"
]
}
}