@smartmemory/compose 0.2.53-beta → 0.2.55-beta

package/README.md

@@ -161,6 +161,34 @@ Tunnel layer is yours: Tailscale (serve/funnel), Cloudflare Tunnel, or a reverse
 
 `compose remote rotate-secret --yes` invalidates every paired device (post-leak hammer).
 
+## SmartMemory coupling (opt-in)
+
+Compose can feed its own lifecycle history (feature events, gate decisions, journal entries,
+artifacts) into [SmartMemory](https://github.com/smartmemory) for relevance-ranked recall,
+via a `smartmemory` block in `.compose/compose.json`:
+
+```json
+{
+  "smartmemory": {
+    "enabled": true,
+    "baseUrl": "http://localhost:9001",
+    "apiKeyEnv": "SMARTMEMORY_API_KEY",
+    "timeoutMs": 3000
+  }
+}
+```
+
+`smartmemory` is absent by default, which means the coupling is fully off: no probes, no
+network calls, no new log lines. With `enabled: true` and a reachable SmartMemory service,
+compose ingests lifecycle events live (fail-open) and the cockpit gains a Recall tab on each
+feature's detail panel.
+
+```bash
+compose smartmemory sync                 # idempotent backfill of events, journal, artifacts
+compose smartmemory sync --dry-run       # preview counts without ingesting
+compose smartmemory sync --feature CODE  # scope the sync to one feature
+```
+
 ## Documentation
 
 Topic-scoped reference:

package/bin/compose.js

@@ -3778,6 +3778,49 @@ if (cmd === 'build') {
     process.exit(1)
   }
 
+} else if (cmd === 'smartmemory') {
+  // ---------------------------------------------------------------------------
+  // compose smartmemory sync [--dry-run] [--feature <CODE>]
+  //   COMP-SMARTMEMORY-INGEST: idempotent backfill/re-sync of feature-events,
+  //   gate-log, journal entries, and per-feature artifacts into SmartMemory.
+  // ---------------------------------------------------------------------------
+  const sub = args[0]
+
+  if (sub === 'sync') {
+    const { runSync } = await import('../lib/smartmemory-sync.js')
+    const { flushPending } = await import('../lib/smartmemory-ingest.js')
+    const flagIdx = (flag) => args.indexOf(flag)
+    const flagVal = (flag) => {
+      const i = flagIdx(flag)
+      return i !== -1 && args[i + 1] ? args[i + 1] : null
+    }
+    const dryRun = args.includes('--dry-run')
+    const feature = flagVal('--feature')
+
+    const { root: cwd } = resolveCwdWithWorkspace(args)
+
+    let result
+    try {
+      result = await runSync({ cwd, dryRun, feature })
+    } catch (err) {
+      console.error(`smartmemory sync failed: ${err.message}`)
+      process.exit(1)
+    }
+
+    console.log(
+      `smartmemory sync: ingested=${result.ingested} unchanged=${result.unchanged} ` +
+      `skipped=${result.skipped} failed=${result.failed}` +
+      (result.stoppedOnQuota ? ' (stopped: workspace quota reached)' : '')
+    )
+    await flushPending()
+    process.exit(0)
+  }
+
+  console.error(`Unknown smartmemory subcommand: ${sub}`)
+  console.error('Usage:')
+  console.error('  compose smartmemory sync [--dry-run] [--feature <CODE>]')
+  process.exit(1)
+
 } else {
   console.error(`Unknown command: ${cmd}`)
   process.exit(1)