@smartmemory/compose 0.1.33-beta → 0.1.35-beta

package/README.md

@@ -82,6 +82,48 @@ Check what you're running:
 compose --version
 ```
 
+## Tracker providers
+
+Compose can persist feature data to different backends via the `tracker` block in `.compose/compose.json`.
+
+**Default (local) — zero configuration required:**
+
+```json
+{ "tracker": { "provider": "local" } }
+```
+
+`local` is the default when no `tracker` block is present. All writes go to the filesystem exactly as before — no behavior change.
+
+**GitHub provider:**
+
+```json
+{
+  "tracker": {
+    "provider": "github",
+    "github": {
+      "repo": "owner/repo",
+      "projectNumber": 42,
+      "branch": "main",
+      "roadmapPath": "ROADMAP.md",
+      "changelogPath": "CHANGELOG.md",
+      "cacheTtlSeconds": 300,
+      "auth": { "tokenEnv": "GITHUB_TOKEN" }
+    }
+  }
+}
+```
+
+The GitHub provider syncs features to **Issues** (one per feature), **Projects v2** (`Status` custom field), and **Contents API** (roadmap + changelog files). Requires a token in the named env var (or `gh auth login` fallback) with `repo` and `project` scopes.
+
+CLI verbs:
+
+```bash
+compose tracker status   # show provider health + pending op-log + conflict ledger
+compose tracker sync     # reconcile op-log against remote provider
+```
+
+See [docs/configuration.md](docs/configuration.md) for the full `tracker` config reference.
+
 ## Documentation
 
 Topic-scoped reference:

package/bin/compose.js

@@ -340,7 +340,7 @@ async function runInit(flags) {
   let hasStratum = !noStratum && spawnSync('which', ['stratum-mcp'], { encoding: 'utf-8' }).status === 0
   if (!noStratum && !hasStratum) {
     console.log('stratum-mcp not found — installing via pip...')
-    const pipResult = spawnSync('pip', ['install', 'stratum'], {
+    const pipResult = spawnSync('pip', ['install', 'stratum-mcp'], {
       stdio: 'inherit',
       encoding: 'utf-8',
     })
@@ -350,11 +350,13 @@ async function runInit(flags) {
       if (hasStratum) {
         console.log('stratum-mcp installed successfully')
       } else {
-        console.warn('Warning: pip install stratum succeeded but stratum-mcp not found on PATH')
+        console.warn('Warning: pip install stratum-mcp succeeded but stratum-mcp not found on PATH')
+        console.warn('  The binary may live in a pyenv version dir not on $PATH.')
+        console.warn('  Try: ln -sf "$(python -c \'import sys,os; print(os.path.join(sys.prefix, "bin", "stratum-mcp"))\')" ~/.local/bin/stratum-mcp')
       }
     } else {
-      console.warn('Warning: pip install stratum failed — Stratum will be disabled')
-      console.warn('  Install manually: pip install stratum')
+      console.warn('Warning: pip install stratum-mcp failed — Stratum will be disabled')
+      console.warn('  Install manually: pip install stratum-mcp  (requires Python >= 3.11)')
     }
   }
   const hasLifecycle = !noLifecycle
@@ -2672,6 +2674,22 @@ if (cmd === 'build') {
     process.exit(1)
   }
 
+} else if (cmd === 'tracker') {
+  // ---------------------------------------------------------------------------
+  // compose tracker status   — print provider name, canonical, pendingOps, conflicts, mixedSources
+  // compose tracker sync     — flush op-log and report drained/quarantined counts
+  // COMP-TRACKER-PROVIDER T18
+  // ---------------------------------------------------------------------------
+  try {
+    const { runTrackerCli } = await import('../lib/tracker/cli.js')
+    const result = await runTrackerCli(process.cwd(), args)
+    console.log(result.output)
+    if (result.exitCode !== 0) process.exit(result.exitCode)
+  } catch (err) {
+    console.error(`tracker: ${err.message}`)
+    process.exit(1)
+  }
+
 } else {
   console.error(`Unknown command: ${cmd}`)
   process.exit(1)