@smartmemory/compose 0.1.28-beta → 0.1.29-beta

package/bin/compose.js

@@ -112,6 +112,7 @@ if (!cmd || cmd === '--help' || cmd === '-h') {
   console.log('  feature   Add a single feature (folder, design seed, ROADMAP entry)')
   console.log('  build     Run a feature through the headless lifecycle')
   console.log('  fix       Run a bug through the headless bug-fix lifecycle')
+  console.log('  gsd       Per-task fresh-context dispatch from existing blueprint+Boundary Map')
   console.log('  pipeline  View and edit the build pipeline')
   console.log('  roadmap            Show roadmap status and next buildable features')
   console.log('  roadmap generate   Regenerate ROADMAP.md from feature.json files')
@@ -1913,6 +1914,32 @@ if (cmd === 'build') {
       process.exit(1)
     })
   })
+} else if (cmd === 'gsd') {
+  // compose gsd <feature-code> — runs the per-task fresh-context dispatch
+  // pipeline (pipelines/gsd.stratum.yaml). Hard-requires existing
+  // docs/features/<code>/blueprint.md with a parseable Boundary Map.
+  const gsdCode = args.find(a => !a.startsWith('-'))
+  if (!gsdCode) {
+    console.error('Usage: compose gsd <feature-code>')
+    console.error('')
+    console.error('Runs the per-task fresh-context dispatch pipeline (COMP-GSD-2).')
+    console.error('Hard-requires docs/features/<code>/blueprint.md with a valid Boundary Map.')
+    console.error('')
+    console.error('Options:')
+    console.error('  --cwd <path>   Working directory (defaults to current)')
+    process.exit(1)
+  }
+  const { root: gsdCwd } = resolveCwdWithWorkspace(args)
+  const cwdIdx = args.indexOf('--cwd')
+  const gsdAgentCwd = cwdIdx !== -1 ? resolve(args[cwdIdx + 1]) : gsdCwd
+  const { runGsd } = await import('../lib/gsd.js')
+  try {
+    const result = await runGsd(gsdCode, { cwd: gsdAgentCwd })
+    console.log(`gsd complete: ${result.blackboardEntries} task results captured.`)
+  } catch (err) {
+    console.error(`gsd failed: ${err.message}`)
+    process.exit(1)
+  }
 } else if (cmd === 'triage') {
   const triageCode = args.find(a => !a.startsWith('-'))
   if (!triageCode) {

package/contracts/task-result.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "task-result.json",
+  "_source": "docs/features/COMP-GSD-2/blueprint.md",
+  "_roadmap": "COMP-GSD-2",
+  "title": "TaskResult",
+  "description": "Per-task post-execution capture written by the task agent at .compose/gsd/<featureCode>/results/<task_id>.json and committed as part of its diff. After execute step completion, runGsd walks the merged base cwd, reads each per-task file, and writes the consolidated blackboard.json. This schema is the post-execution audit/retro substrate (consumed by GSD-7 milestone reports), NOT a runtime channel between tasks.",
+  "type": "object",
+  "required": ["status", "files_changed", "summary", "produces", "gates", "attempts"],
+  "properties": {
+    "status": {
+      "type": "string",
+      "enum": ["passed", "failed"],
+      "description": "Whether the agent considered the task complete with all gates green."
+    },
+    "files_changed": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Repo-relative paths the agent touched in its worktree."
+    },
+    "summary": {
+      "type": "string",
+      "description": "One- or two-paragraph machine-readable summary of what was done."
+    },
+    "produces": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "Realized symbol map: { symbolName: signature-or-shape-string }. Mirrors the task's declared produces but with the actually-implemented signatures."
+    },
+    "gates": {
+      "type": "array",
+      "items": { "$ref": "#/definitions/GateRun" },
+      "description": "One entry per gate command run. Array (not lint/build/test object) so arbitrary project-configured gateCommands are supported."
+    },
+    "attempts": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of internal TDD-loop iterations the agent took before declaring done."
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "GateRun": {
+      "type": "object",
+      "required": ["command", "status", "output"],
+      "properties": {
+        "command": { "type": "string", "minLength": 1 },
+        "status": {
+          "type": "string",
+          "enum": ["pass", "fail"]
+        },
+        "output": {
+          "type": "string",
+          "description": "Truncated stdout/stderr from the gate run (e.g., last 2000 chars)."
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/contracts/taskgraph-gsd.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "taskgraph-gsd.json",
+  "_source": "docs/features/COMP-GSD-2/blueprint.md",
+  "_roadmap": "COMP-GSD-2",
+  "title": "TaskGraphGsd",
+  "description": "Output of the gsd pipeline's decompose_gsd step. Extends the bare TaskGraph (from build.stratum.yaml's decompose) with required produces/consumes per task, sourced from the blueprint's Boundary Map. Each task carries a rich `description` string pre-baked with the spec context that Stratum's parallel_dispatch interpolation cannot carry on its own.",
+  "type": "object",
+  "required": ["tasks"],
+  "properties": {
+    "tasks": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/definitions/Task" }
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "Task": {
+      "type": "object",
+      "required": ["id", "files_owned", "files_read", "depends_on", "description", "produces", "consumes"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "files_owned": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Files this task may write. Must not overlap with other tasks' files_owned (enforced by no_file_conflicts ensure)."
+        },
+        "files_read": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Files this task may read but not write."
+        },
+        "depends_on": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Task ids that must complete before this one."
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Rich prompt fragment containing the per-task spec context (produces/consumes/slice/upstream summary/gates). Packed at decompose time because Stratum's parallel_dispatch only interpolates a fixed set of tokens."
+        },
+        "produces": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/ProducesEntry" },
+          "description": "Symbols this task lands. Sourced from the matching Boundary Map slice."
+        },
+        "consumes": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/ConsumesEntry" },
+          "description": "Symbols this task may import from upstream tasks (resolved at end-of-step merge in topological order)."
+        }
+      },
+      "additionalProperties": true
+    },
+    "ProducesEntry": {
+      "type": "object",
+      "required": ["file", "symbols", "kind"],
+      "properties": {
+        "file": { "type": "string", "minLength": 1 },
+        "symbols": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string" }
+        },
+        "kind": {
+          "type": "string",
+          "enum": ["interface", "type", "function", "class", "const", "hook", "component"],
+          "description": "Symbol kind. Mirrors lib/boundary-map.js KIND_ALLOWLIST."
+        }
+      },
+      "additionalProperties": false
+    },
+    "ConsumesEntry": {
+      "type": "object",
+      "required": ["from", "file", "symbols"],
+      "properties": {
+        "from": {
+          "type": "string",
+          "pattern": "^S\\d{2,}$",
+          "description": "Upstream slice id (S01, S02, ...)."
+        },
+        "file": { "type": "string", "minLength": 1 },
+        "symbols": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}