@smartmemory/compose-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 regression-io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# @smartmemory/compose-mcp
+
+Slim MCP stdio launcher for [`@smartmemory/compose`](https://github.com/smartmemory/compose). Installing this package transitively pulls the full compose runtime; the `compose-mcp` binary spawns the embedded MCP server.
+
+Compose is a structured AI dev pipeline that takes a goal to shipped code. Your agent writes the code, Compose makes it prove it: design decisions are gated before any code, every step has to clear its postconditions, and review runs on a different model than the one that wrote the work.
+
+## Install
+
+```bash
+npm install -g @smartmemory/compose-mcp
+```
+
+This installs both `@smartmemory/compose-mcp` and its peer `@smartmemory/compose`.
+
+## Run
+
+```bash
+npx -y @smartmemory/compose-mcp
+```
+
+The launcher resolves the embedded MCP server (`@smartmemory/compose/mcp`) and spawns it with stdio inheritance — suitable for direct Claude Code / MCP client wiring.
+
+## Wire into Claude Code
+
+Add an entry to `.claude/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "compose": {
+      "command": "npx",
+      "args": ["-y", "@smartmemory/compose-mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Code; the typed compose tools (roadmap, changelog, artifact linking, journal, completion) become available.
+
+## Project layout requirement
+
+The MCP tools mutate canonical compose artifacts (`ROADMAP.md`, `CHANGELOG.md`, `docs/features/<code>/`, `docs/journal/`). Run `compose-mcp` from inside a compose-initialized project — see [the compose README](https://github.com/smartmemory/compose#readme) for `compose init`.
+
+## Why a slim wrapper?
+
+Discovery: published as `io.github.smartmemory/compose-mcp` on the [official MCP registry](https://registry.modelcontextprotocol.io). Installing the slim package keeps `npx` startup fast while the full runtime is fetched transitively.
+
+## License
+
+MIT — same as the compose root.

package/bin/compose-mcp.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+/**
+ * @smartmemory/compose-mcp — stdio launcher
+ *
+ * Resolves and spawns the MCP stdio server embedded in @smartmemory/compose.
+ * Discovery is via the slim package; install pulls the full app transitively.
+ * Single source of truth: every consumer runs server/compose-mcp.js.
+ */
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+
+let serverPath;
+try {
+  serverPath = require.resolve('@smartmemory/compose/mcp');
+} catch (err) {
+  console.error(
+    '[compose-mcp] Could not locate @smartmemory/compose. Install it: npm install @smartmemory/compose'
+  );
+  console.error(`[compose-mcp] resolve error: ${err.message}`);
+  process.exit(127);
+}
+
+const child = spawn(process.execPath, [serverPath, ...process.argv.slice(2)], {
+  stdio: 'inherit',
+  env: process.env,
+});
+child.on('exit', (code, signal) => process.exit(code ?? (signal ? 1 : 0)));
+child.on('error', (err) => {
+  console.error(`[compose-mcp] failed to spawn server: ${err.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@smartmemory/compose-mcp",
+  "version": "0.1.0",
+  "description": "MCP stdio server for @smartmemory/compose: typed feature management tools (roadmap, changelog, artifact linking, and more). Requires a compose-initialized project.",
+  "type": "module",
+  "bin": {
+    "compose-mcp": "./bin/compose-mcp.js"
+  },
+  "dependencies": {
+    "@smartmemory/compose": "^0.3.8"
+  },
+  "files": ["bin/**", "README.md", "LICENSE"],
+  "publishConfig": { "access": "public" },
+  "license": "MIT",
+  "engines": { "node": ">=18.0.0" },
+  "keywords": ["mcp", "modelcontextprotocol", "compose", "smartmemory", "claude", "claude-code", "feature-management"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/smartmemory/compose.git",
+    "directory": "compose-mcp"
+  },
+  "homepage": "https://github.com/smartmemory/compose/tree/main/compose-mcp",
+  "bugs": "https://github.com/smartmemory/compose/issues"
+}