{"_id":"speckit-memory","_rev":"7-ab7d2270eac6801f581bb6dc49e9f396","name":"speckit-memory","dist-tags":{"latest":"0.1.5"},"versions":{"0.0.0-stage":{"name":"speckit-memory","version":"0.0.0-stage","_id":"speckit-memory@0.0.0-stage","stub":true,"maintainers":[{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"}],"dist":{"shasum":"6260d93b7781af24c5962c163c44f2932a089eae","tarball":"https://registry.npmjs.org/speckit-memory/-/speckit-memory-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-JpqaqIEQbVMOr+TrnZZvSnQtEbKTTdWp6TIe0toROqm9eCtT0iUGA0gYTG/+zyeURMwSPujuk+ieud/lSp2X0Q==","signatures":[{"sig":"MEQCICEnzL4nY+NTzzeL69UKftF+vYHt1D43iX4Gc0uc6K+cAiAaMq2hgR/mu4kR9CqBMx02JTiSmjyoF9y2FZsWQMI8KA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":336},"_npmUser":{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"speckit-memory","version":"0.1.0","keywords":["spec-kit","memory","ai","context","assistant"],"license":"MIT","_id":"speckit-memory@0.1.0","maintainers":[{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"}],"homepage":"https://github.com/DyanGalih/spec-kit-memory-hub#readme","bugs":{"url":"https://github.com/DyanGalih/spec-kit-memory-hub/issues"},"bin":{"speckit-memory":"cli.js"},"dist":{"shasum":"c1b30302e3a97705b0d521fac41a4b985df2d2fa","tarball":"https://registry.npmjs.org/speckit-memory/-/speckit-memory-0.1.0.tgz","fileCount":4,"integrity":"sha512-cob2gF3q/kmYulWBJ4edWBSP/At+T2QcT3D89QCOrfkZnKC1dziEOGET1p4936a+efR0F7Hng+Ab1zkC9tUJ6A==","signatures":[{"sig":"MEYCIQC9VZ8GiwradJEBBfzFmW6kwjV5Pc8YFjN6xWwEH0RyoQIhAPVCgzU8O/+ZOF8iEXmfouLd8b9rojqelwFvy+ICSUnb","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIDX8i0XusMfMyf8dY6ZeHY7zOz6ryiiSr49+ysarA8CVAiEA7+1zqr5Ko+OZhNLSVFiOYn4z6Q6eoBA/J+e0PSjoYX4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1050},"main":"index.js","_npmUser":{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"},"repository":{"url":"git+https://github.com/DyanGalih/spec-kit-memory-hub.git","type":"git"},"_npmVersion":"9.2.0","description":"Durable project memory and context for AI-assisted development","directories":{},"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/speckit-memory_0.1.0_1793083295639_0.310332138873885","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"speckit-memory","version":"0.1.1","keywords":["mcp","model-context-protocol","memory","spec","specification","ai","assistant","context"],"license":"MIT","_id":"speckit-memory@0.1.1","maintainers":[{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"}],"bin":{"speckit-memory":"bin/cli.js"},"dist":{"shasum":"553667dbadf9d3e6866e2d0ac4b234859a389bde","tarball":"https://registry.npmjs.org/speckit-memory/-/speckit-memory-0.1.1.tgz","fileCount":16,"integrity":"sha512-9TbHykh1jfp22Jlb7kTDYO7FI4HuUjL6JMovZtS0oCmZr6EGQWuts0W0IhX9BPYeH2vRchaz8uwKooOhbSPYrQ==","signatures":[{"sig":"MEYCIQCHY0Ll1Ezez6t90LK4fjYBSAKniBplHK5TSnf9Cg78ggIhAOBnZNn78AqMEp4Kd7VeHgbrtIXpFB0GnYBcqhOiKIQo","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCbHpFCmdqI98y3CFGGKtSVknc6Zywv53onJIEmtE+3mAIhANSMrt7/DHt57V1/1NIJr+ARd/JcctvpmSXUu2OqtjCG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":154570},"main":"./mcp-server.js","engines":{"node":">=22.5"},"scripts":{"test":"node test/run-tests.js && node test/mcp-smoke.js && node test/sqlite-synthesis.js && node test/engine-contract.js","mcp-start":"node mcp-server.js"},"_npmUser":{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"},"_npmVersion":"9.2.0","description":"Persistent spec-driven memory for AI coding assistants: engine, CLI, and MCP server (JSON-RPC 2.0 over stdio)","directories":{},"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/speckit-memory_0.1.1_1793115556392_0.6567082652330256","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"speckit-memory","version":"0.1.2","keywords":["mcp","model-context-protocol","memory","spec","specification","ai","assistant","context"],"author":{"name":"venkatreddygutha9-stack"},"license":"MIT","_id":"speckit-memory@0.1.2","maintainers":[{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"}],"homepage":"https://github.com/venkatreddygutha9-stack/speckit-memory","bugs":{"url":"https://github.com/venkatreddygutha9-stack/speckit-memory/issues"},"bin":{"speckit-memory":"bin/cli.js"},"dist":{"shasum":"819e7f1589761df46741d69f43ac4b2a28af7995","tarball":"https://registry.npmjs.org/speckit-memory/-/speckit-memory-0.1.2.tgz","fileCount":16,"integrity":"sha512-1ihf8Hlw2Jo9zIE2lPn/TF1FVZHhkwTMJULU9xqUr+Td7mxtF4Rm+T4ppgyTNURpeXC+nDffpJmvip+vjYPxaw==","signatures":[{"sig":"MEYCIQDE1GRX4UIKD55LqiYLr4qoWmWhnEmv7UmnEnw6o6ZlZgIhAPfGYqF17sUazx4pxhM2Re0H2upc4CM5PWDZqOzjYIov","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIBZTtdil3TjIpjEjuJTtDtbCaU2Vi3kGe45V8eycbKzQAiBjjV1TZCOUmesFyuxBsdMbLUByqH1lSExBeoOYUojFuQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":155106},"main":"./mcp-server.js","engines":{"node":">=22.5"},"gitHead":"584455890bc6c50a45b386b482f3c56fa14fa63e","scripts":{"test":"node test/run-tests.js && node test/mcp-smoke.js && node test/sqlite-synthesis.js && node test/engine-contract.js","mcp-start":"node mcp-server.js"},"_npmUser":{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"},"repository":{"url":"git+https://github.com/venkatreddygutha9-stack/speckit-memory.git","type":"git"},"_npmVersion":"9.2.0","description":"Persistent spec-driven memory for AI coding assistants: engine, CLI, and MCP server (JSON-RPC 2.0 over stdio)","directories":{},"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/speckit-memory_0.1.2_1793127435607_0.4820045785257019","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"speckit-memory","version":"0.1.3","keywords":["mcp","model-context-protocol","memory","spec","specification","ai","assistant","context"],"author":{"name":"venkatreddygutha9-stack"},"license":"MIT","_id":"speckit-memory@0.1.3","maintainers":[{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"}],"homepage":"https://github.com/venkatreddygutha9-stack/speckit-memory","bugs":{"url":"https://github.com/venkatreddygutha9-stack/speckit-memory/issues"},"bin":{"speckit-memory":"bin/cli.js"},"dist":{"shasum":"8f427ca90b6ff952e62fcff06b5614abce1323c3","tarball":"https://registry.npmjs.org/speckit-memory/-/speckit-memory-0.1.3.tgz","fileCount":17,"integrity":"sha512-Gzh9CIDLNmPIvK3e6gULJxqQi5DuUNbDopqHjHcUgi6B8lSQJeuU40tPWzzI2PIfu206mmXXBKu3+KvG6UPiDA==","signatures":[{"sig":"MEYCIQDVdV2HC1XO6BLR4IPfvPbk65zkAr+lj0Vt7iVr23e/IQIhAKVBwS8X+kkU0qvbnIyJRRTFUVRRtbKgrURBRPOz3enL","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCjJRE7lWOZ/IWVRSjr2D528kp/XYPh45NC1QSWcRA1JgIhAMu7zDbCKiIlY3Clu4nBrVRRohMx2VN/G33lLEXWj3O2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":175074},"main":"./mcp-server.js","types":"./index.d.ts","engines":{"node":">=22.5"},"exports":{".":{"types":"./index.d.ts","default":"./mcp-server.js","require":"./mcp-server.js"},"./lib":{"types":"./index.d.ts","default":"./lib/index.js","require":"./lib/index.js"},"./package.json":"./package.json"},"scripts":{"test":"node test/run-tests.js && node test/mcp-smoke.js && node test/sqlite-synthesis.js && node test/engine-contract.js && node test/regression.js","mcp-start":"node mcp-server.js"},"_npmUser":{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"},"repository":{"url":"git+https://github.com/venkatreddygutha9-stack/speckit-memory.git","type":"git"},"_npmVersion":"9.2.0","description":"Persistent spec-driven memory for AI coding assistants: engine, CLI, and MCP server (JSON-RPC 2.0 over stdio)","directories":{},"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/speckit-memory_0.1.3_1793299783495_0.02233306793008294","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"speckit-memory","version":"0.1.4","keywords":["spec-driven-development","project-memory","ai-memory","coding-assistant","mcp","model-context-protocol","mcp-server","claude","cursor","llm","ai-agent","ai-tools","persistent-memory","knowledge-base","context-management","spec-management","development-memory","documentation","json-rpc","stdio","nodejs","javascript","typescript","developer-tools","ai-coding","memory","spec","specification","assistant","context","code-memory","session-memory","workspace-memory","spec-driven","ai-assistant"],"author":{"name":"venkatreddygutha9-stack"},"license":"MIT","_id":"speckit-memory@0.1.4","maintainers":[{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"}],"homepage":"https://github.com/venkatreddygutha9-stack/speckit-memory#readme","bugs":{"url":"https://github.com/venkatreddygutha9-stack/speckit-memory/issues"},"bin":{"speckit-memory":"bin/cli.js"},"dist":{"shasum":"5a9e1225048bb8d66d421eb98f4c6aff0af35b14","tarball":"https://registry.npmjs.org/speckit-memory/-/speckit-memory-0.1.4.tgz","fileCount":17,"integrity":"sha512-L/Zk+NV/GujPbAmsdka8hgmvwYikzPkwWOpGkr+sUDBzaK3C1reqlpfZtlWBW+S8aAYQPeFdV6331jkDlL1OUA==","signatures":[{"sig":"MEUCIDn/b7usjCxkLj4hUgxLkiYhf+LsXSd4YXxGG3LSu5HLAiEArIn1D8SFymeijU3rvSt6BRibrKSGv7a/jQWWQG1/KsE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIA4Yp7q9Okg+XQ1HhwhwxZe6j2/h3uQbg+WInuv7OQXUAiEAs2fHam++35j6/cYDH0TMMao0Q2v5WsL4owR9LFFLBi8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":177631},"main":"./mcp-server.js","types":"./index.d.ts","engines":{"node":">=22.5"},"exports":{".":{"types":"./index.d.ts","default":"./mcp-server.js","require":"./mcp-server.js"},"./lib":{"types":"./index.d.ts","default":"./lib/index.js","require":"./lib/index.js"},"./package.json":"./package.json"},"scripts":{"test":"node test/run-tests.js && node test/mcp-smoke.js && node test/sqlite-synthesis.js && node test/engine-contract.js && node test/regression.js","mcp-start":"node mcp-server.js"},"_npmUser":{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"},"repository":{"url":"git+https://github.com/venkatreddygutha9-stack/speckit-memory.git","type":"git"},"_npmVersion":"9.2.0","description":"Persistent spec-driven memory for AI coding assistants: engine, CLI, and MCP server (JSON-RPC 2.0 over stdio)","directories":{},"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/speckit-memory_0.1.4_1793317905490_0.8593984144612316","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"_id":"speckit-memory@0.1.5","bin":{"speckit-memory":"bin/cli.js"},"bugs":{"url":"https://github.com/reeenasingh882-ui/speckit-memory/issues"},"dist":{"shasum":"d02dc258d9448629556d83ff7a04276a8a731b30","tarball":"https://registry.npmjs.org/speckit-memory/-/speckit-memory-0.1.5.tgz","fileCount":17,"integrity":"sha512-4NzIlnd5O1aiapd6PTPlvVcb+xHAqyewwe/pVEDvzomukxhCDig286RKjwg36d+MIjczPqlxMRTJJdzVshKacQ==","signatures":[{"sig":"MEYCIQD8YsIn3keQi0XBD8FB819JXbptwMBJB2PcQIdJF6NrtgIhAMH2XKvgW1bL0WNJ6kXHDN+KnfnC2xc8WbMY/VPLbKQ1","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBZd7+Rn6I8nBr4a9ZtuXi4eHj3KAaDfqd/7b8pIF6zjAiAJA1VwpyyR2y8VLlJNf3bh7UacafRqhJRg1vl9kAReHg=="}],"unpackedSize":177607},"main":"./mcp-server.js","name":"speckit-memory","types":"./index.d.ts","author":{"name":"reeenasingh882-ui"},"engines":{"node":">=22.5"},"exports":{".":{"types":"./index.d.ts","default":"./mcp-server.js","require":"./mcp-server.js"},"./lib":{"types":"./index.d.ts","default":"./lib/index.js","require":"./lib/index.js"},"./package.json":"./package.json"},"license":"MIT","scripts":{"test":"node test/run-tests.js && node test/mcp-smoke.js && node test/sqlite-synthesis.js && node test/engine-contract.js && node test/regression.js","mcp-start":"node mcp-server.js"},"version":"0.1.5","_npmUser":{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"},"homepage":"https://github.com/reeenasingh882-ui/speckit-memory#readme","keywords":["spec-driven-development","project-memory","ai-memory","coding-assistant","mcp","model-context-protocol","mcp-server","claude","cursor","llm","ai-agent","ai-tools","persistent-memory","knowledge-base","context-management","spec-management","development-memory","documentation","json-rpc","stdio","nodejs","javascript","typescript","developer-tools","ai-coding","memory","spec","specification","assistant","context","code-memory","session-memory","workspace-memory","spec-driven","ai-assistant"],"repository":{"url":"git+https://github.com/reeenasingh882-ui/speckit-memory.git","type":"git"},"_npmVersion":"9.2.0","description":"Persistent spec-driven memory for AI coding assistants: engine, CLI, and MCP server (JSON-RPC 2.0 over stdio)","directories":{},"maintainers":[{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"}],"_nodeVersion":"22.22.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/speckit-memory_0.1.5_1793352545513_0.2384115144713661"}}},"time":{"created":"2026-10-27T06:40:58.036Z","modified":"2026-10-30T09:29:05.759Z","0.0.0-stage":"2026-10-27T06:40:58.036Z","0.1.0":"2026-10-27T06:41:35.712Z","0.1.1":"2026-10-27T15:39:16.481Z","0.1.2":"2026-10-27T18:57:15.706Z","0.1.3":"2026-10-29T18:49:43.588Z","0.1.4":"2026-10-29T23:51:45.573Z","0.1.5":"2026-10-30T09:29:05.610Z"},"bugs":{"url":"https://github.com/reeenasingh882-ui/speckit-memory/issues"},"author":{"name":"reeenasingh882-ui"},"license":"MIT","homepage":"https://github.com/reeenasingh882-ui/speckit-memory#readme","keywords":["spec-driven-development","project-memory","ai-memory","coding-assistant","mcp","model-context-protocol","mcp-server","claude","cursor","llm","ai-agent","ai-tools","persistent-memory","knowledge-base","context-management","spec-management","development-memory","documentation","json-rpc","stdio","nodejs","javascript","typescript","developer-tools","ai-coding","memory","spec","specification","assistant","context","code-memory","session-memory","workspace-memory","spec-driven","ai-assistant"],"repository":{"url":"git+https://github.com/reeenasingh882-ui/speckit-memory.git","type":"git"},"description":"Persistent spec-driven memory for AI coding assistants: engine, CLI, and MCP server (JSON-RPC 2.0 over stdio)","maintainers":[{"name":"platform-sync-bot-80228","email":"venkatreddygutha9@gmail.com"}],"readme":"# speckit-memory\n\nPersistent, file-first memory for spec-driven development with AI coding\nassistants. Three markdown trees inside your project, one CLI, one MCP\nserver, one derived SQLite index. Zero runtime dependencies, no install\nscripts.\n\n## Frequently asked questions\n\nWorks with Claude Desktop, Cursor, Windsurf and any MCP client.\n\n### How do I give my AI coding assistant persistent memory?\n\nInstall `speckit-memory` and register it as an MCP server. Your assistant can\nthen record decisions, worklogs and watchpoints as markdown files inside the\nproject, and read them back in later sessions.\n\n### What is spec-driven development memory?\n\nIt is a practice of keeping structured project knowledge — governance laws,\ndecisions, worklogs, bug preventions and per-feature watchpoints — in versioned\nmarkdown trees. `speckit-memory` manages those trees and keeps a derived index\nso search stays fast.\n\n### How do I keep context between Claude sessions?\n\nStore context as project memory entries (`speckit-memory add`). The next session\nresumes with full knowledge instead of starting cold — the filesystem is the\nsource of truth, so nothing is lost.\n\n### How does speckit-memory store project decisions?\n\nDecisions are `DEC-####` entries with YAML frontmatter under\n`docs/memory/decisions/`. They can be updated, marked resolved, or removed, and\ngovernance laws (`LAW-####`) are immutable by design.\n\n### Does speckit-memory need a database or API key?\n\nNo. Everything lives in markdown files in your project. The SQLite index is\nderived and rebuildable. Zero runtime dependencies and no API keys.\n\n### How do I search my project memory from the CLI?\n\nRun `speckit-memory search <keywords>`. You can also list with date filters\n(`--since`, `--until`), export/import bundles, and run `speckit-memory doctor`\nto check tree health.\n\n### What MCP tools does speckit-memory provide?\n\n`memory_add`, `memory_search`, `memory_resolve`, `memory_delete` and more over\nJSON-RPC on stdio — see the MCP server section below.\n\n## Memory model\n\n| Tree | Purpose | Entries |\n|---|---|---|\n| `.specify/memory/laws/` | Governance Law — immutable, append-only | `LAW-####` |\n| `docs/memory/{decisions,worklogs,bug-preventions}/` | Project History — long-term memory | `DEC-####` / `LOG-####` / `BUG-####` |\n| `specs/<feature>/` | Feature Memory — working context | `WP-<FEATURE>-####` watchpoints, `OQ-<FEATURE>-####` open questions |\n| `specs/<feature>/memory.md` | Generated ~900-word synthesis (do not edit) | regenerated by `synthesize` |\n\nMarkdown files carry YAML frontmatter (`id`, `type`, `title`, `created`,\n`updated`, `tags`, ...). The filesystem is the source of truth; everything in\n`.speckit-memory/` (SQLite when `node:sqlite` is available — Node >= 22.5 —\nJSON otherwise) is a derived, rebuildable index.\n\nGovernance laws are immutable: `update`/`remove` on a `LAW-` id throws\n`ImmutableLawError`. History and feature entries can be updated, resolved\n(`**[RESOLVED YYYY-MM-DD]**` marker), or removed.\n\n## Docker\n\nRun the MCP server in a container:\n\n    docker build -t speckit-memory .\n    docker run -i --rm -v \"$PWD:/project\" -w /project speckit-memory\n\nThe image uses `node:22-alpine` and starts the MCP stdio server by default.\n\n## Install\n\n    npm install speckit-memory\n\nRequires Node.js 22.5 or newer. No postinstall, no native builds, no dependencies.\n\n## CLI\n\n    speckit-memory init\n    speckit-memory add law \"Never store plaintext private keys\" --tag security\n    speckit-memory add history \"Chose argon2id for password hashing\" --category decision\n    speckit-memory add feature \"Token expiry drifts under load\" --feature auth --kind watchpoint\n    speckit-memory add feature \"Which redirect flow for mobile?\" --feature auth --kind open-question\n    speckit-memory list --type law\n    speckit-memory list --feature auth --json\n    speckit-memory list --since 2026-01-01 --until 2026-06-30\n    speckit-memory show WP-AUTH-0001\n    speckit-memory search \"token expiry\" auth --limit 10\n    speckit-memory remove LOG-0002\n    speckit-memory resolve OQ-AUTH-0001\n    speckit-memory export backup.json     # full JSON backup of every entry\n    speckit-memory import backup.json     # restore (existing ids are skipped)\n    speckit-memory stats                  # counts by type/category/status\n    speckit-memory doctor                 # tree + cache health check\n    speckit-memory synthesize auth        # writes specs/auth/memory.md (~900 words)\n    speckit-memory synthesize auth --words 600 --stdout\n    speckit-memory mcp-start              # MCP server on stdio (JSON-RPC 2.0)\n\nAll commands accept `--root DIR` to target a specific project root (default:\nauto-discover via `.specify`, `package.json`, or `.git`). Exit codes:\n0 success, 1 domain/runtime error, 2 usage error.\n\n## Synthesis\n\n`speckit-memory synthesize <feature>` assembles a bounded (~900 word,\n`--words` to override) memory document, deterministically and offline:\n\n1. **Active watchpoints** and **open questions** for the feature take the\n   largest share of the word budget.\n2. **Project history** is ranked by relevance to the feature (tags/title/\n   content mentions, `feature:` references), then recency.\n3. **Governance laws** appear as one-line digests.\n4. Anything trimmed for budget is listed by id under **Synthesis Notes**;\n   nothing is invented — every sentence comes from a stored entry.\n\n## MCP server\n\n`speckit-memory mcp-start` (or `node mcp-server.js`) speaks MCP over stdio\nand exposes six tools: `memory_add`, `memory_list`, `memory_search`,\n`memory_synthesize`, `memory_resolve`, `memory_delete`. The server resolves\nits engine in this order:\n\n1. `SPECKIT_MEMORY_ENGINE` env var (path to an engine module)\n2. `lib/engine.js` — **canonical engine** (shipped; backed by MemoryStore)\n3. `lib/memory-engine.js` — alternate name\n4. `lib/fallback-engine.js` — built-in single-file store (always present)\n\nThe canonical engine maps friendly types (`decision`, `pattern`, `lesson`,\n`watchpoint`, ...) onto the three trees and honors `SPECKIT_MEMORY_ROOT`\n(explicit project root) and `SPECKIT_MEMORY_PATH` (project directory, or a\nlegacy `.json`/`.db` path whose parent directory becomes the project root).\nCLI and MCP therefore read and write the same memories.\n\n### MCP client configuration\n\nRegister the server in your MCP client, e.g. `claude_desktop_config.json`:\n\n    {\n      \"mcpServers\": {\n        \"speckit-memory\": {\n          \"command\": \"npx\",\n          \"args\": [\"-y\", \"speckit-memory\", \"mcp-start\"]\n        }\n      }\n    }\n\nOr point `command` at a local checkout (`node /path/to/speckit-memory\nmcp-start`). Set `SPECKIT_MEMORY_ROOT` in `env` when the server should bind to\na specific project instead of auto-discovering one.\n\n### Search semantics\n\n`speckit-memory search` and `memory_search` treat the query as OR-ish\nkeywords: a memory matches when the keywords hit, and more hits rank higher.\nThe standalone `lib/sqlite-cache.js` search helper instead requires **all**\nkeywords (AND). This is intentional: the CLI/MCP search is a friendly\nrecall tool, while the cache helper is a strict filter.\n\n## Programmatic API\n\n    const { MemoryStore, synthesize } = require('speckit-memory/lib');\n\n    const store = MemoryStore.open(process.cwd()); // or new MemoryStore(rootDir)\n    store.init();\n    store.add({ type: 'law', content: '...', tags: ['security'] });\n    store.add({ type: 'history', content: '...', category: 'decisions', feature: 'auth' });\n    store.add({ type: 'feature', content: '...', feature: 'auth', kind: 'watchpoint' });\n    const laws = store.list({ type: 'law' });\n    const one = store.get('LAW-0001');\n    store.update('DEC-0001', { content: 'revised' });\n    store.resolve('OQ-AUTH-0001');\n    store.remove('LOG-0002');           // throws for LAW-#### ids\n    const doc = synthesize(store, 'auth'); // { wordCount, body, document, file, ... }\n\nEntry shape: `{ id, type, category, feature, title, filePath, created,\nupdated, tags, content, status, hash, wordCount }`.\n\nDerived index cache (`store.cache`): `replaceAll(entries)`,\n`query({type, category, feature, tag})`, `count()`, `close()` — schema\nversion tracked in the `meta` table (`CACHE_SCHEMA_VERSION`). Rebuild at any\ntime with `store.scan()`.\n\n## Troubleshooting\n\n- **\"Memory trees are not initialized\"** — since 0.1.3 the MCP engine no\n  longer silently creates `.specify/`/`docs/memory/` trees in whatever\n  directory it was started from. Run `speckit-memory init` in the project\n  (or point `SPECKIT_MEMORY_ROOT` at an initialized one) before starting the\n  server.\n\n- **\"file is not a database\" or a corrupt `.speckit-memory/index.db`** — the\n  index is a derived cache. Since 0.1.3 a corrupt `index.db` is moved aside as\n  `index.db.corrupt-<timestamp>` and rebuilt automatically; the original\n  markdown trees are never touched. If problems persist, delete\n  `.speckit-memory/` and run `speckit-memory doctor`.\n- **Windows-authored markdown loses frontmatter** — files saved with a UTF-8\n  BOM are handled correctly since 0.1.3 (the BOM is stripped before parsing).\n- **`no SQLite backend available`** — `lib/sqlite-cache.js` and\n  `lib/synthesis-engine.js` need `node:sqlite` (Node 22.5+, still marked\n  experimental by Node; you may see an `ExperimentalWarning`). The core\n  memory store (`lib/memory-store.js`) falls back to JSON when sqlite is\n  missing, so basic add/list/search keep working everywhere.\n\n## Development\n\n    npm test            # full suite: core + MCP + SQLite/synthesis + engine contract\n    node test/mcp-smoke.js\n\n## License\n\nMIT\n\n## Links\n\n- GitHub: https://github.com/venkatreddygutha9-stack/speckit-memory\n- Issues: https://github.com/venkatreddygutha9-stack/speckit-memory/issues\n- npm: https://www.npmjs.com/package/speckit-memory\n","readmeFilename":"README.md"}