3 Commits
Author SHA1 Message Date
ed cbe65b3f71 conductor(track): intent_dsl_survey v1.2 — add Cluster 8 (Metadesk) + Cluster 9 (Verse)
Survey now covers 10 prior-art clusters (was 8). New clusters per
user direction (Option A in the v1.2 cluster-fit discussion):

NEW: research/cluster_8_metadesk.md (research sub-report):
- Metadesk (Ryan Fleury + Allen Webster, Dion Systems, 2020-2021)
- 5 distinctive design properties: uniform 'lego-brick' AST, tags
  as dispatch keys, multiple interchangeable delimiters, comment
  + source-location preservation, first-class C interop with
  copy-paste distribution
- 2 citable anchor quotes with source URLs
- Synthesis: maps to Tier 3 (read/edit/discover) and Tier 4
  (audit/fuzzy) verbs

NEW: research/cluster_9_verse.md (research sub-report):
- Verse (Simon Peyton Jones + Tim Sweeney, Epic Games, 2021-)
- 5 distinctive design properties: transactional semantics with
  speculative execution, failure as first-class control flow, effect
  tracking in function signature, new Verse Calculus (ICFP 2023
  Distinguished Paper), everything-is-an-expression + live variables
- 3 citable anchor quotes
- Synthesis: maps to Tier 4 (try/recover/sandbox/audit) verbs;
  two-layer failure model maps to Cluster 7's Result convention

UPDATED: report_v1.2.md (1343 lines, +42 from v1.2 base):
- Inserted Cluster 8 (Metadesk) and Cluster 9 (Verse) sections
  between Cluster 7 and the section 2/3 divider
- Updated §2 intro to say '10 clusters' (was '8')
- Updated glossary 'clusters' entry to list all 10
- Updated v1.2 changelog note (4) to document the cluster additions

UPDATED: tracks.md:
- Track #23 status line now lists all 10 clusters
- Goal line updated to say '10 clusters' (was '8')

UPDATED: state.toml deliverable_summary:
- Added v1.2_changes[4] for the cluster additions
- Added cluster_count = 10
- research_sub_reports now lists 7 cluster files (0-9)

The spec/plan/review files still say '8 clusters' — left as
historical context (spec is approved with 8; expanding to 10 is
an editorial decision the user has now made; future revisions of
spec/plan should reflect 10).
2026-06-12 11:10:27 -04:00
ed 213e499420 conductor(track): intent_dsl_survey v1.2 (rename + postfix + nagent fix)
Three files changed:

1. report_v1.2.md (NEW, 1301 lines) — v1.2 of the report with:
   (a) Renamed arena { } to tape { } (better term; aligns syntax with
       the Lottes tape-drive metaphor). All 46 occurrences replaced;
       3 awkward double-tape phrases cleaned up (heading 3.6,
       table cell, glossary entry).
   (b) Mixed postfix/infix notation for math (per user heuristic):
       - Strictly postfix for math primitives with precedence:
         + - * / ^, math indexing [], reducers sum/product.
       - Infix for structural ops (no precedence concern):
         :=, function calls, control flow (for/if), field access,
         block delimiters.
       - Heuristic: 'if the operator has precedence, postfix it;
         if it doesn't, infix it.' Mixed examples like
         'result := Matrix(m.rows 1 -, m.columns 1 -)' are canonical.
   (c) nagent attribution corrected: previously said nagent is
       Jody Bruchon's; it is Mike Acton's (github.com/macton/nagent;
       per conductor/tracks/nagent_review_20260608/). Jofito stays
       correctly attributed to Jody Bruchon.
   (d) Added v1.2 changelog note at top + heuristic table at start
       of section 3.

2. report_v1.1.md — nagent attribution fix propagated (post-hoc
   correction; the original v1.1 commit had the same error in the
   glossary line 1671).

3. research/cluster_3_intent_mapping.md — nagent attribution fix
   in 2 places (header at line 188, body at line 190).

Appendix A.3 (EBNF) and A.4 (Tier 1 vocab) retain v1.1 form
pending a sync pass; noted in the v1.2 changelog at the top of
the report.
2026-06-12 10:37:10 -04:00
ed 72e9a63c86 docs(ideation→track): Move report into intent_dsl_survey_20260612 folder
Per user instruction: the report is too closely related to the track
to live in the general docs/ideation/ folder. It's the track's main
deliverable, not a general ideation doc. The existing convention for
track reports is the track folder (e.g., nagent_review_20260608/report.md).

This commit is the phase 2+3 work:
  - Adds the integrated report (417 lines, 8 ## headings, 40 ###)
    to conductor/tracks/intent_dsl_survey_20260612/report.md
  - Adds 5 Tier 2 sub-reports (1319 lines combined) to
    conductor/tracks/intent_dsl_survey_20260612/research/
  - Removes the old docs/ideation/ location (moved, not duplicated)
  - Updates spec.md, plan.md, metadata.json, tracks.md to point at
    the new location

Report structure:
  Section 1: 4 anchor claims (O'Donnell, Onat/Lottes, CoSy, Jofito)
  Section 2: 8 prior-art clusters (with sub-report references)
  Section 3: 14-primitive grammar + ambiguity flags
  Section 4: 4-tier vocab (12+12+10+8 = 42 verbs)
  Section 5: 4 hardware-mapping anchor claims
  Section 6: 10 AI-agent properties
  Section 7: 8 open questions for follow-up B
  Appendix: bibliography (external, project, sub-reports)

The sub-reports contain the deep analysis with citations; the main
report is the ejecutiva summary. Tier 2 sub-agents handled the heavy
research (5 cluster sub-reports in research/); Tier 1 focused on
integration and writing the simpler sections inline.

Time-sensitive: report must complete before nagent v2.2.
2026-06-12 09:28:06 -04:00