@smartmemory/compose 0.1.34-beta → 0.1.36-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

@@ -2674,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)