@smartmemory/compose 0.1.0

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "@smartmemory/compose",
+  "version": "0.1.0",
+  "description": "Structured AI dev pipeline — goal-to-product orchestration with gates, iteration loops, and feature lifecycle management.",
+  "author": "SmartMemory",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "compose": "./bin/compose.js"
+  },
+  "scripts": {
+    "dev": "node server/supervisor.js 2>&1 | tee /tmp/compose-server.log",
+    "dev:server": "node server/supervisor.js",
+    "dev:server:bare": "node server/index.js",
+    "dev:client": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "test": "node --test test/*.test.js",
+    "test:integration": "node --test test/integration/*.test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "compose",
+    "smartmemory",
+    "ai",
+    "orchestration",
+    "agent",
+    "pipeline",
+    "stratum",
+    "claude",
+    "codex",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/smartmemory/compose.git"
+  },
+  "bugs": {
+    "url": "https://github.com/smartmemory/compose/issues"
+  },
+  "homepage": "https://github.com/smartmemory/compose#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "bin/**",
+    "server/**",
+    "lib/**",
+    "dist/**",
+    "templates/**",
+    "presets/**",
+    "pipelines/**",
+    "contracts/**",
+    "scripts/**",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.47",
+    "@dagrejs/dagre": "^2.0.4",
+    "@hello-pangea/dnd": "^18.0.1",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@opencode-ai/sdk": "^1.2.17",
+    "@radix-ui/react-collapsible": "^1.1.12",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-scroll-area": "^1.2.10",
+    "@radix-ui/react-select": "^2.2.6",
+    "@radix-ui/react-separator": "^1.1.8",
+    "@radix-ui/react-slot": "^1.2.4",
+    "@radix-ui/react-toggle": "^1.1.10",
+    "@radix-ui/react-toggle-group": "^1.1.11",
+    "@radix-ui/react-tooltip": "^1.2.8",
+    "@tanstack/react-virtual": "^3.13.23",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cors": "^2.8.5",
+    "cytoscape": "^3.33.1",
+    "cytoscape-dagre": "^2.5.0",
+    "cytoscape-fcose": "^2.2.0",
+    "date-fns": "^3.6.0",
+    "diff": "^8.0.4",
+    "express": "^4.21.0",
+    "ink": "^5.2.1",
+    "lucide-react": "^0.563.0",
+    "mermaid": "^11.13.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1",
+    "tailwind-merge": "^3.4.0",
+    "tailwindcss-animate": "^1.0.7",
+    "uuid": "^11.0.0",
+    "ws": "^8.18.0",
+    "yaml": "^2.8.2",
+    "zustand": "^5.0.11"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.3.4",
+    "autoprefixer": "^10.4.20",
+    "postcss": "^8.5.3",
+    "tailwindcss": "^3.4.17",
+    "vite": "^6.1.0"
+  },
+  "overrides": {
+    "zod": "^4.0.0"
+  }
+}

package/pipelines/bug-fix.stratum.yaml

@@ -0,0 +1,230 @@
+# metadata:
+#   id: bug-fix
+#   label: "Bug Fix"
+#   description: "Diagnose and fix a bug — reproduce, trace root cause, scope audit, fix, test, verify, ship"
+#   category: maintenance
+#   steps: 8
+#   estimated_minutes: 40
+
+version: "0.1"
+
+# bug-fix pipeline
+#
+# Eight-step flow for disciplined bug resolution:
+#   1. reproduce    — confirm the bug exists with a failing test
+#   2. diagnose     — trace root cause by OBSERVING actual data (not assuming)
+#   3. scope_check  — grep audit if change spans multiple layers/repos
+#   4. fix          — implement the minimal correct fix across ALL affected layers
+#   5. test         — run full test suite, ensure no regressions
+#   6. verify       — confirm original reproduction case now passes
+#   7. retro_check  — detect fix chains and log discipline signals
+#   8. ship         — commit and report
+#
+# Debug Discipline (COMP-DEBUG-1):
+#   - diagnose requires trace_evidence (actual command output, not prose assumptions)
+#   - scope_check prevents incremental multi-layer discovery
+#   - retro_check detects fix chains and feeds iteration ledger
+#
+# Inputs:
+#   task — bug description (symptoms, steps to reproduce, affected files)
+#
+# Usage:
+#   stratum_plan <this yaml> "bug_fix" {"task": "..."}
+
+contracts:
+  BugFixResult:
+    phase:                {type: string}
+    summary:              {type: string}
+    outcome:              {type: string, values: [complete, failed]}
+    references_addressed: {type: string}  # stringified int
+
+  TestResult:
+    passing:  {type: boolean}
+    summary:  {type: string}
+    failures: {type: array}
+
+  TraceEvidence:
+    command:       {type: string}
+    actual_output: {type: string}
+    conclusion:    {type: string}
+
+  DiagnoseResult:
+    root_cause:      {type: string}
+    affected_layers: {type: array}
+    trace_evidence:  {type: array, items: TraceEvidence}
+    summary:         {type: string}
+    scope_hint:      {type: string}  # single | cross-layer | unknown
+
+  ScopeResult:
+    scope:                {type: string, values: [single, cross_layer]}
+    references_found:     {type: array}
+    repos_scanned:        {type: number}
+    summary:              {type: string}
+    references_count:     {type: string}  # stringified int for Stratum compat
+
+  RetroCheckResult:
+    fix_chains:       {type: array}
+    attempt_count:    {type: number}
+    escalation:       {type: boolean}
+    discipline_score: {type: number}
+    summary:          {type: string}
+
+functions:
+  reproduce:
+    mode: compute
+    intent: >
+      Write a failing test that demonstrates the bug. The test must fail
+      before any fix is applied. Return a summary of the reproduction.
+    input:
+      task: {type: string}
+    output: BugFixResult
+    retries: 2
+
+  diagnose:
+    mode: compute
+    intent: >
+      Trace the root cause by OBSERVING actual data, not assuming.
+      You MUST run at least one command that prints a real value at the
+      failure point (docker exec, curl, python -c "print(type(x))").
+      Return trace_evidence: a list of {command, actual_output, conclusion}.
+      Also identify which layers are affected (core, service, frontend, infra).
+      "Import OK" and "build passed" are NOT trace evidence.
+    input:
+      task: {type: string}
+    output: DiagnoseResult
+    ensure:
+      - "result.trace_evidence != null"
+      - "result.trace_evidence.length >= 2"
+      - "result.root_cause != null"
+      - "result.scope_hint in ('single', 'cross-layer', 'unknown')"
+    retries: 2
+
+  scope_check:
+    mode: compute
+    intent: >
+      If the diagnosis shows the root cause involves a provider switch,
+      field rename, config key change, or anything spanning multiple
+      repos or layers: grep ALL configured project repos for every reference
+      to the affected term. Return the full reference list grouped by repo.
+      If the change is single-layer, return scope: 'single' and skip.
+      This prevents incremental multi-layer discovery (fixing one layer,
+      deploying, discovering the next layer is broken, repeat).
+    input:
+      task: {type: string}
+      diagnosis: {type: object}
+    output: ScopeResult
+    retries: 1
+
+  fix:
+    mode: compute
+    intent: >
+      Implement the minimal correct fix for the diagnosed root cause.
+      If scope_check found cross-layer references, address ALL of them
+      in coordinated commits — do not leave any reference unaddressed.
+      Change only what is necessary. Return a summary of changes made.
+    input:
+      task: {type: string}
+      scope: {type: object}
+    output: BugFixResult
+    retries: 2
+
+  test:
+    mode: compute
+    intent: >
+      Run the full test suite. Return structured JSON:
+      { "passing": boolean, "summary": string, "failures": string[] }.
+    input:
+      task: {type: string}
+    output: TestResult
+    ensure:
+      - "result.passing == true"
+    retries: 5
+
+  verify:
+    mode: compute
+    intent: >
+      Re-run the reproduction test from step 1. Confirm it now passes.
+      Return a summary confirming the fix resolves the original bug.
+    input:
+      task: {type: string}
+    output: BugFixResult
+    retries: 1
+
+  retro_check:
+    mode: compute
+    intent: >
+      Analyze git history for this session. Detect fix chains: 2+ commits
+      modifying the same file or function. Count total fix attempts on
+      the target bug. For visual/CSS/layout bugs, enforce hard stop at
+      attempt 2 and flag for cross-agent escalation.
+      Return fix_chains (list of repeated files), attempt_count, whether
+      escalation was triggered, and a discipline_score (0-100).
+    input:
+      task: {type: string}
+    output: RetroCheckResult
+    retries: 1
+
+  ship:
+    mode: compute
+    intent: >
+      Commit all changes with a descriptive message. Update CHANGELOG.md
+      if appropriate. Return a summary of what was shipped.
+    input:
+      task: {type: string}
+    output: BugFixResult
+    retries: 1
+
+flows:
+  bug_fix:
+    input:
+      task: {type: string}
+    output: BugFixResult
+    steps:
+      - id: reproduce
+        function: reproduce
+        inputs:
+          task: "$.input.task"
+
+      - id: diagnose
+        function: diagnose
+        inputs:
+          task: "$.input.task"
+        depends_on: [reproduce]
+
+      - id: scope_check
+        function: scope_check
+        inputs:
+          task: "$.input.task"
+          diagnosis: "$.steps.diagnose.output"
+        depends_on: [diagnose]
+
+      - id: fix
+        function: fix
+        inputs:
+          task: "$.input.task"
+          scope: "$.steps.scope_check.output"
+        depends_on: [scope_check]
+
+      - id: test
+        function: test
+        inputs:
+          task: "$.input.task"
+        depends_on: [fix]
+
+      - id: verify
+        function: verify
+        inputs:
+          task: "$.input.task"
+        depends_on: [test]
+
+      - id: retro_check
+        function: retro_check
+        inputs:
+          task: "$.input.task"
+        depends_on: [verify]
+
+      - id: ship
+        function: ship
+        inputs:
+          task: "$.input.task"
+        depends_on: [retro_check]