@smartmemory/compose 0.2.23-beta → 0.2.24-beta

package/README.md

@@ -40,7 +40,7 @@ The package is published to npm as `@smartmemory/compose`. Pick one install styl
 
 ```bash
 npm install -g @smartmemory/compose
-compose setup                # global skill + stratum-mcp registration
+compose setup                # install bundled skills + register stratum-mcp (alias: compose sync)
 ```
 
 **Option B — git clone (for development):**
@@ -82,6 +82,15 @@ Check what you're running:
 compose --version
 ```
 
+## Bundled skills
+
+`compose setup` (alias `compose sync`) mirrors compose-owned skills into your agent skill dirs (`~/.claude/skills/`, shared with Codex). Re-run it after a `compose update` or after editing skills locally — it's idempotent.
+
+- **`/compose`** — the build/fix lifecycle orchestrator (idea → design → blueprint → implement; or triage → fix → verify).
+- **`/context-budget`** — read-only audit of the session-start loaded surface (agents, skills, rules, MCP tool schemas, CLAUDE.md chain). Estimates per-component token cost, classifies each into always / sometimes / rarely needed, and prints a ranked cut list with estimated reclaim. Never auto-applies cuts.
+
+`compose update` fetches a newer compose (npm or git) and then runs setup for you; use `compose sync` when there's no new version to pull — you just changed skills locally.
+
 ## Tracker providers
 
 Compose can persist feature data to different backends via the `tracker` block in `.compose/compose.json`.

package/bin/compose.js

@@ -125,7 +125,8 @@ if (!cmd || cmd === '--help' || cmd === '-h') {
   console.log('  triage    Analyze a feature and recommend build profile')
   console.log('  qa-scope  Show affected routes from a feature\'s changed files')
   console.log('  init      Initialize Compose in the current project')
-  console.log('  setup     Install global skill + register stratum-mcp')
+  console.log('  setup     Install/sync global skills + register stratum-mcp (alias: sync)')
+  console.log('  sync      Re-sync global skills from this install (alias of setup)')
   console.log('  update    Pull latest compose, reinstall deps, refresh global skill')
   console.log('  doctor    Check external skill dependencies')
   console.log('  --version Print compose version, git SHA, and install root')
@@ -682,7 +683,11 @@ if (cmd === 'init') {
   process.exit(0)
 }
 
-if (cmd === 'setup') {
+if (cmd === 'setup' || cmd === 'sync') {
+  // `sync` is an alias for `setup` — both mirror compose-owned skills into the
+  // agent skill dirs and register stratum-mcp. The name `sync` better signals
+  // the idempotent "reconcile local skills with this install" job (run it after
+  // editing skills locally, when there's no new version to `update` to).
   runSetup()
   process.exit(0)
 }

package/package.json

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