Commit Graph
8 Commits
Author SHA1 Message Date
ed 074047fed9 conductor(track): Update intent_dsl_survey bookkeeping to v1.2 (213e4994)
Three bookkeeping files updated to reflect the v1.2 deliverable:
- metadata.json: deliverable now points at report_v1.2.md; added
  deliverable_v1_1, final_commit=213e4994
- tracks.md: track #23 heading shows COMPLETE: 213e4994; status
  line lists v1.0 -> v1.1 -> v1.2 history with the 3 v1.2 changes
  (rename, postfix heuristic, nagent fix)
- state.toml: added version='v1.2'; deliverable_summary updated with
  v1_2, v1_1, v1_0 fields and v1_2_changes list
2026-06-12 10:38:19 -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 bae30cc3a7 conductor(track): Mark intent_dsl_survey_20260612 complete
Three files updated to close out the track:

1. state.toml — all 28 tasks marked completed with their commit SHAs;
   current_phase = complete; all 14 verification flags = true; added
   deliverable_summary section pointing at report_v1.1.md, reportreview.md,
   and the 5 research/ sub-reports.

2. metadata.json — status: complete; added deliverable_v1_0, review,
   and final_commit fields.

3. tracks.md — track #23 heading now reads 'COMPLETE: c7e92896';
   added a 'Status: 2026-06-12 — COMPLETE' line summarizing the
   v1.1 deliverable (1301 lines, 7 sections + 9-subsection appendix,
   42-verb vocab, 8 prior-art clusters, 14-grammar primitives, 4
   hardware anchor claims, 10 AI-agent properties, 8 open questions).

This is the final bookkeeping for the track. nagent v2.2 can now
reference the report's Section 6 (AI-Agent Properties) and Section 7
(Open Questions) for its 'Future-Track Candidate #4: Intent-based
DSL' planning.
2026-06-12 10:10:12 -04:00
ed c7e9289624 conductor(track): Add intent_dsl_survey_20260612 reportreview + v1.1 (expanded appendix)
Two files:

1. reportreview.md (154 lines) — the final secondary review pass.
   - Verified 29+ load-bearing claims across 5 sub-reports against
     their actual sources (johno.se URLs, Onat/Lottes refs, Jofito
     codeberg README, nagent docs, mcp_architecture spec, etc.)
   - 28 claims confirmed accurate; 1 inaccuracy found: the user's
     XML/JSON rejection quote was cited as decisions.md:50 but
     that line doesn't contain it (the quote is from the brainstorming
     session, not a project file)
   - Recommendation: write report_v1.1.md with the citation fix and
     a few optional small improvements (OCR-restored Lottes quote,
     softened Wasm streaming-parse inference, Uiua open-source
     onboarding already in main report)

2. report_v1.1.md (1301 lines, +883 over report.md) — the v1.1 report
   with:
   (a) The v1.0 corrections:
       - Fixed XML/JSON rejection citation (now points to the
         brainstorming session, not a project file)
       - OCR-restored the Lottes X.com quote ('actually' added)
       - Softened the Wasm streaming-parse inference
   (b) A substantially expanded Appendix (Deep-Dives):
       - A.1 Section 1 Deep-Dive: 4 anchor claims in detail
       - A.2 Section 2 Deep-Dive: full text of all prior-art entries
         (O'Donnell's 4 anchor claims with full context; all 6
         Concatenative entries; all 4 Array entries; all 4
         Intent-Mapping entries; all 4 Meta-Tooling entries; full
         SSDL table; full 33 Command Palette commands; full Result
         convention details)
       - A.3 Section 3 Deep-Dive: formal EBNF grammar spec
       - A.4 Section 4 Deep-Dive: full vocab reference for all 42
         verbs (with signatures, semantics, examples, edge cases)
       - A.5 Section 5 Deep-Dive: register allocation + memory
         layout + FFI bridge
       - A.6 Section 6 Deep-Dive: implementation notes per claim
       - A.7 Section 7 Deep-Dive: open questions with proposed
         solutions and trade-offs
       - A.8 Glossary
       - A.9 Expanded Bibliography (4 categories with 1-line
         descriptions and key-claim summaries)

This is the final deliverable for the intent_dsl_survey_20260612
track. v1.1.md is what nagent v2.2 will reference for its
'Future-Track Candidate #4: Intent-based DSL' section.
2026-06-12 10:00:57 -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
ed dfbb03ba06 docs(ideation): Add intent_dsl_survey_20260612 phase 1 outline + state
Phase 1 of 4. Adds:
- conductor/tracks/intent_dsl_survey_20260612/state.toml (28 tasks,
  4 phases, 14 verification flags)
- conductor/tracks/intent_dsl_survey_20260612/metadata.json
  (research-only, no blockers, time-sensitive)
- conductor/tracks/intent_dsl_survey_20260612/research/ (subfolder
  for Tier 2 sub-agent sub-reports)
- docs/ideation/2026-06-12-intent-based-scripting-languages.md
  (outline stub: header + 7 sections + Appendix, all stubbed with
  1-paragraph descriptions; actual content to be written in
  phases 2-3, with Tier 2 sub-agents handling the research-heavy
  prior-art clusters 0-4)
2026-06-12 08:47:42 -04:00
ed 5ef68a0046 conductor(track): Add intent_dsl_survey_20260612 plan
Executable plan for the report. 28 tasks across 4 phases:

- Phase 1 (Tasks 1-3): source gathering + state/metadata + outline stub
- Phase 2 (Tasks 4-14): write sections 1, 2 (8 clusters), 3
- Phase 3 (Tasks 15-23): write sections 4 (4 tiers), 5, 6, 7 + Appendix
- Phase 4 (Tasks 24-28): self-review + user review + final commit + tracks.md

Each task has file:line references, exact commands, and expected
output. Self-review confirms all 21 spec requirements are covered;
no placeholders; type-consistent.

The track is research-only, so the plan recommends inline execution
by a single Tier 2 Tech Lead. Subagent-driven per task is also an
option if context isolation is preferred.

Time-sensitive: report must complete before nagent v2.2.
2026-06-12 08:30:38 -04:00
ed b389f1be98 conductor(track): Add intent_dsl_survey_20260612 spec
Foundation research track. Produces a single markdown report at
docs/ideation/2026-06-12-intent-based-scripting-languages.md surveying
intent-based scripting languages and proposing a 4-tier vocab (~40
verbs) for a Meta-Tooling-facing intent DSL.

The report's 7 sections:
1. The 'intent-based' design philosophy (O'Donnell immediate-mode,
   Onat/Lottes hardware, CoSy open-vocab, Jofito intent-mapping)
2. Prior art across 8 clusters (0: IMGUI, 1: Concatenative,
   2: Array, 3: Intent-mapping, 4: Meta-Tooling, 5: SSDL shapes,
   6: Command Palette, 7: Result error handling)
3. The grammar (14 primitives formalized from user's pseudocode)
4. The 4-tier vocab (math, data pipeline, shell, AI-fuzzing tolerance)
5. Hardware mapping (4 anchor claims to Onat/Lottes/O'Donnell/APL-K)
6. AI-agent properties (10 claims tying to existing project
   architecture: Meta-Tooling domain, 3-layer security, 4 memory
   dimensions, stable-to-volatile cache, Result envelope,
   Command Palette 33 commands, Hook API, IEventTarget/sandbox,
   'reads are free')
7. Open questions for follow-up interpreter prototype + connection
   to intent_dsl_for_meta_tooling_20260608_PLACEHOLDER

Time-sensitive: report must complete before user's nagent v2.2.

No new src/ code, no new tests, no pyproject.toml changes.
Pure research deliverable.
2026-06-12 08:19:02 -04:00