@smartmemory/compose 0.1.3-beta → 0.1.4-beta

package/bin/compose.js

@@ -576,13 +576,13 @@ if (cmd === 'new') {
     if (result.options.reviewAgent === 'Codex (automated review)') {
       const { pipelineSet } = await import('../lib/pipeline-cli.js')
       try {
-        pipelineSet(cwd, 'review_gate', ['--mode', 'review'])
-      } catch { /* gate may not exist in new.stratum.yaml */ }
+        pipelineSet(cwd, 'review_gate', ['--mode', 'review'], 'new.stratum.yaml')
+      } catch { /* kickoff spec missing or review_gate already absent */ }
     } else if (result.options.reviewAgent === 'Skip review') {
       const { pipelineDisable } = await import('../lib/pipeline-cli.js')
       try {
-        pipelineDisable(cwd, ['review_gate'])
-      } catch { /* ignore */ }
+        pipelineDisable(cwd, ['review_gate'], 'new.stratum.yaml')
+      } catch { /* kickoff spec missing or review_gate already absent */ }
     }
   } else if (hasAnswers && !autoMode) {
     // Load saved answers to enrich intent without prompting

package/lib/pipeline-cli.js

@@ -20,12 +20,13 @@ import { parse, stringify } from 'yaml'
 // Helpers
 // ---------------------------------------------------------------------------
 
-function loadSpec(cwd) {
-  const specPath = join(cwd, 'pipelines', 'build.stratum.yaml')
+function loadSpec(cwd, specName = 'build.stratum.yaml') {
+  const specPath = join(cwd, 'pipelines', specName)
   if (!existsSync(specPath)) {
     throw new Error(`No pipeline found at ${specPath}. Run 'compose init' first.`)
   }
-  return { specPath, spec: parse(readFileSync(specPath, 'utf-8')) }
+  const flowName = specName.replace(/\.stratum\.yaml$/, '')
+  return { specPath, spec: parse(readFileSync(specPath, 'utf-8')), flowName }
 }
 
 function saveSpec(specPath, spec) {
@@ -54,12 +55,12 @@ const LEVEL_COLORS = {
 }
 const RESET = '\x1b[0m'
 
-export function pipelineShow(cwd) {
-  const { spec } = loadSpec(cwd)
-  const mainFlow = spec.flows?.build
-  if (!mainFlow) throw new Error('No "build" flow found in pipeline spec.')
+export function pipelineShow(cwd, specName = 'build.stratum.yaml') {
+  const { spec, flowName } = loadSpec(cwd, specName)
+  const mainFlow = spec.flows?.[flowName]
+  if (!mainFlow) throw new Error(`No "${flowName}" flow found in pipeline spec.`)
 
-  console.log(`\n  Pipeline: build (${mainFlow.steps.length} steps)\n`)
+  console.log(`\n  Pipeline: ${flowName} (${mainFlow.steps.length} steps)\n`)
 
   for (const step of mainFlow.steps) {
     const isGate = !!step.function
@@ -133,10 +134,10 @@ function gateTimeout(spec, funcName) {
 // set
 // ---------------------------------------------------------------------------
 
-export function pipelineSet(cwd, stepId, flags) {
-  const { specPath, spec } = loadSpec(cwd)
-  const mainFlow = spec.flows?.build
-  if (!mainFlow) throw new Error('No "build" flow found.')
+export function pipelineSet(cwd, stepId, flags, specName = 'build.stratum.yaml') {
+  const { specPath, spec, flowName } = loadSpec(cwd, specName)
+  const mainFlow = spec.flows?.[flowName]
+  if (!mainFlow) throw new Error(`No "${flowName}" flow found.`)
 
   const { step, idx } = findStep(mainFlow.steps, stepId)
 
@@ -305,10 +306,10 @@ function convertToAgent(spec, mainFlow, step, stepId) {
 // add
 // ---------------------------------------------------------------------------
 
-export function pipelineAdd(cwd, flags) {
-  const { specPath, spec } = loadSpec(cwd)
-  const mainFlow = spec.flows?.build
-  if (!mainFlow) throw new Error('No "build" flow found.')
+export function pipelineAdd(cwd, flags, specName = 'build.stratum.yaml') {
+  const { specPath, spec, flowName } = loadSpec(cwd, specName)
+  const mainFlow = spec.flows?.[flowName]
+  if (!mainFlow) throw new Error(`No "${flowName}" flow found.`)
 
   const id = flagVal(flags, '--id')
   const after = flagVal(flags, '--after')
@@ -353,10 +354,10 @@ export function pipelineAdd(cwd, flags) {
 // remove
 // ---------------------------------------------------------------------------
 
-export function pipelineRemove(cwd, stepId) {
-  const { specPath, spec } = loadSpec(cwd)
-  const mainFlow = spec.flows?.build
-  if (!mainFlow) throw new Error('No "build" flow found.')
+export function pipelineRemove(cwd, stepId, specName = 'build.stratum.yaml') {
+  const { specPath, spec, flowName } = loadSpec(cwd, specName)
+  const mainFlow = spec.flows?.[flowName]
+  if (!mainFlow) throw new Error(`No "${flowName}" flow found.`)
 
   const { step, idx } = findStep(mainFlow.steps, stepId)
 
@@ -388,10 +389,10 @@ export function pipelineRemove(cwd, stepId) {
 // enable / disable
 // ---------------------------------------------------------------------------
 
-export function pipelineEnable(cwd, stepIds) {
-  const { specPath, spec } = loadSpec(cwd)
-  const mainFlow = spec.flows?.build
-  if (!mainFlow) throw new Error('No "build" flow found.')
+export function pipelineEnable(cwd, stepIds, specName = 'build.stratum.yaml') {
+  const { specPath, spec, flowName } = loadSpec(cwd, specName)
+  const mainFlow = spec.flows?.[flowName]
+  if (!mainFlow) throw new Error(`No "${flowName}" flow found.`)
 
   for (const stepId of stepIds) {
     const { step } = findStep(mainFlow.steps, stepId)
@@ -403,10 +404,10 @@ export function pipelineEnable(cwd, stepIds) {
   saveSpec(specPath, spec)
 }
 
-export function pipelineDisable(cwd, stepIds) {
-  const { specPath, spec } = loadSpec(cwd)
-  const mainFlow = spec.flows?.build
-  if (!mainFlow) throw new Error('No "build" flow found.')
+export function pipelineDisable(cwd, stepIds, specName = 'build.stratum.yaml') {
+  const { specPath, spec, flowName } = loadSpec(cwd, specName)
+  const mainFlow = spec.flows?.[flowName]
+  if (!mainFlow) throw new Error(`No "${flowName}" flow found.`)
 
   for (const stepId of stepIds) {
     const { step } = findStep(mainFlow.steps, stepId)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartmemory/compose",
-  "version": "0.1.3-beta",
+  "version": "0.1.4-beta",
   "description": "Structured AI dev pipeline — goal-to-product orchestration with gates, iteration loops, and feature lifecycle management.",
   "author": "SmartMemory",
   "license": "MIT",

package/pipelines/new.stratum.yaml

@@ -0,0 +1,182 @@
+version: "0.2"
+
+workflow:
+  name: new
+  description: "Product kickoff — research, brainstorm, and scaffold a new project from intent"
+  input:
+    projectName:
+      type: string
+      required: true
+    intent:
+      type: string
+      required: true
+
+contracts:
+  ResearchResult:
+    priorArt:    {type: array}
+    patterns:    {type: array}
+    risks:       {type: array}
+    summary:     {type: string}
+
+  BrainstormResult:
+    features:    {type: array}
+    userStories: {type: array}
+    archOptions: {type: array}
+    summary:     {type: string}
+
+  RoadmapResult:
+    phases:      {type: array}
+    features:    {type: array}
+    summary:     {type: string}
+    artifact:    {type: string}
+
+  ScaffoldResult:
+    created:     {type: array}
+    summary:     {type: string}
+
+functions:
+  review_gate:
+    mode: gate
+    timeout: 7200
+
+  roadmap_gate:
+    mode: gate
+    timeout: 3600
+
+flows:
+  new:
+    input:
+      projectName: {type: string}
+      intent: {type: string}
+    output: ScaffoldResult
+    steps:
+      # Phase: Research prior art
+      - id: research
+        agent: claude
+        intent: >
+          Research prior art for this product idea. Search the web for:
+          1. Existing tools that solve the same or similar problems
+          2. Common architectural patterns used in this domain
+          3. Known pitfalls and risks
+
+          Write your findings to docs/discovery/research.md.
+          If docs/discovery/research.md already exists, read it and build on it
+          rather than starting from scratch.
+        inputs:
+          intent: "$.input.intent"
+        output_contract: ResearchResult
+        ensure:
+          - "file_exists('docs/discovery/research.md')"
+        validate:
+          artifact: docs/discovery/research.md
+          criteria:
+            - "Contains at least 2 existing tools or prior art entries"
+            - "Mentions architectural patterns or common approaches"
+            - "Lists risks or pitfalls"
+        retries: 3
+
+      # Phase: Brainstorm features
+      - id: brainstorm
+        agent: claude
+        intent: >
+          Given the product intent (and any available research findings),
+          brainstorm the product. Generate:
+          1. A feature list — discrete capabilities the product should have,
+             each with a short code (e.g. LOG-1, LOG-2) and description.
+             Order features by dependency: foundational first, advanced later.
+          2. User stories — "As a <user>, I want <goal>, so that <benefit>"
+          3. Architecture options — 2-3 high-level approaches with trade-offs
+
+          If docs/discovery/research.md exists, read it first for prior-art
+          context. Otherwise proceed from the product intent alone — research
+          is an optional input, not a hard requirement (the questionnaire can
+          skip it).
+
+          Write the full brainstorm to docs/discovery/brainstorm.md.
+          If docs/discovery/brainstorm.md already exists, read it and refine it
+          rather than starting from scratch.
+        inputs:
+          intent: "$.input.intent"
+          research: "$.steps.research.output.summary"  # may be null when research is skipped
+        output_contract: BrainstormResult
+        ensure:
+          - "file_exists('docs/discovery/brainstorm.md')"
+        validate:
+          artifact: docs/discovery/brainstorm.md
+          criteria:
+            - "Contains at least 3 features with short codes (e.g. LOG-1, LOG-2)"
+            - "Contains user stories in 'As a... I want... so that...' format"
+            - "Contains at least 2 architecture options with trade-offs"
+        retries: 3
+        depends_on: [research]
+
+      # Gate: Human reviews brainstorm
+      - id: review_gate
+        function: review_gate
+        on_approve: roadmap
+        on_revise: brainstorm
+        on_kill: null
+        depends_on: [brainstorm]
+
+      # Phase: Structure the roadmap
+      - id: roadmap
+        agent: claude
+        intent: >
+          Take the approved brainstorm and structure it into a phased ROADMAP.
+
+          First read docs/discovery/brainstorm.md for the full brainstorm.
+          If ROADMAP.md already exists, read it and update it rather than overwriting.
+
+          Write ROADMAP.md in the project root with:
+          1. Project name and description
+          2. Roadmap conventions (status values, numbering rules)
+          3. Phases grouping features by dependency order
+          4. Each feature as a numbered row with its code, description, and PLANNED status
+
+          Follow this table format for each phase:
+          | # | Feature | Item | Status |
+          |---|---------|------|--------|
+          | 1 | CODE-1  | Description | PLANNED |
+        inputs:
+          intent: "$.input.intent"
+          brainstorm: "$.steps.brainstorm.output.summary"
+        output_contract: RoadmapResult
+        ensure:
+          - "file_exists('ROADMAP.md')"
+        validate:
+          artifact: ROADMAP.md
+          criteria:
+            - "Contains a markdown table with feature codes and status columns"
+            - "Features are organized into phases"
+            - "All features have PLANNED status"
+        retries: 3
+        depends_on: [review_gate]
+
+      # Gate: Human approves the roadmap
+      - id: roadmap_gate
+        function: roadmap_gate
+        on_approve: scaffold
+        on_revise: roadmap
+        on_kill: null
+        depends_on: [roadmap]
+
+      # Phase: Scaffold feature folders
+      - id: scaffold
+        agent: claude
+        intent: >
+          Read the approved ROADMAP.md and create a feature folder for each
+          feature listed. For each feature:
+          1. Create docs/features/<CODE>/design.md with a seed design doc containing:
+             - Title: "<CODE>: <description>"
+             - Status: PLANNED
+             - Created date
+             - Intent section with the feature description
+             - Notes section explaining this is a seed for compose build
+        inputs:
+          intent: "$.input.intent"
+          roadmap: "$.steps.roadmap.output.summary"
+        output_contract: ScaffoldResult
+        ensure:
+          - "len(result.created) > 0"
+        retries: 2
+        depends_on: [roadmap_gate]