mcp-memory-bucket 0.5.0 → 0.5.3

package/dist/client/index.html

@@ -27,7 +27,7 @@
     :root[data-theme='dark'] { color-scheme: dark; }
     body { font-family: system-ui, sans-serif; margin: 0; background: var(--bg); color: var(--fg); }
   </style>
-  <script type="module" crossorigin src="/assets/index-DSHtiYCt.js"></script>
+  <script type="module" crossorigin src="/assets/index-CqgDoHFV.js"></script>
 </head>
 <body>
   <mem-bucket-app></mem-bucket-app>

package/dist/src/memory/repository.js

@@ -172,7 +172,7 @@ export class MemoryRepository {
             description: input.description,
             doc_type: input.doc_type,
             tags: input.tags ?? [],
-            status: 'active',
+            status: input.status ?? 'active',
             related_to: input.related_to ?? null,
             deprecated: false,
             created_at: new Date().toISOString(),

package/dist/src/memory/tools.js

@@ -1,7 +1,8 @@
 import { z } from 'zod';
+import { statusSchema } from '../shared/status.js';
 const MEMORY_DOC_TYPES = ['plan', 'spec', 'sql', 'testing-todo', 'discovery', 'session-summary', 'other'];
 const MEMORY_KEY_TYPES = ['ticket', 'freeform'];
-const MEMORY_STATUS = ['active', 'shipped', 'abandoned'];
+const MEMORY_STATUS_DEFAULTS = ['active', 'shipped', 'abandoned'];
 const AUTHORING_SKILL_HINT = "Before your first call in a session, run skill_get(\"memory-bucket-authoring\") to learn the exact frontmatter schema and conventions — don't guess the shape.";
 export function registerMemoryTools(mcp, repo) {
     const roots = repo.listRoots();
@@ -26,7 +27,7 @@ export function registerMemoryTools(mcp, repo) {
     mcp.tool('memory_search', 'Full-text search over memory doc description/body/tags (grep/find-like, ranked by relevance) — unlike memory_get\'s exact-key lookup, this searches by content across all keys. `query` is raw SQLite FTS5 MATCH syntax: bare words, "exact phrases", prefix* wildcards, AND/OR/NOT boolean operators; hyphenated/punctuated terms must be quoted, e.g. "blue-green". Can be combined with doc_type/status/tag filters. Returns ranked hits with a highlighted snippet, not the full body — call memory_get(key) or fetch by id for that. Paused docs are hidden by default — pass include_paused to see them.', {
         query: z.string().describe('FTS5 match expression, e.g. `migration AND rollback` or `"blue green"`'),
         doc_type: z.enum(MEMORY_DOC_TYPES).optional(),
-        status: z.enum(MEMORY_STATUS).optional(),
+        status: statusSchema(MEMORY_STATUS_DEFAULTS).optional(),
         tag: z.string().optional(),
         ...(multiRoot ? { root: z.string().optional().describe(`filter to one root: ${rootNames}`) } : {}),
         limit: z.number().int().positive().max(100).optional(),
@@ -45,7 +46,7 @@ export function registerMemoryTools(mcp, repo) {
         ids: z.array(z.string()).min(1),
         add_tags: z.array(z.string()).optional(),
         remove_tags: z.array(z.string()).optional(),
-        status: z.enum(MEMORY_STATUS).optional(),
+        status: statusSchema(MEMORY_STATUS_DEFAULTS).optional(),
         related_to: z.string().nullable().optional(),
         deprecated: z.boolean().optional().describe('marks docs as deprecated (or un-deprecates when false) — independent of status'),
     }, async ({ ids, add_tags, remove_tags, status, related_to, deprecated }) => {
@@ -59,12 +60,13 @@ export function registerMemoryTools(mcp, repo) {
         description: z.string().describe('distinguishes this doc from others sharing the same key'),
         body: z.string(),
         tags: z.array(z.string()).optional(),
+        status: statusSchema(MEMORY_STATUS_DEFAULTS).optional().describe('defaults to "active"'),
         related_to: z.string().optional().describe('id of a related doc, e.g. a spec linking to its plan'),
         folder: z.string().optional().describe('optional subdirectory under the memory root'),
         ...(multiRoot ? { root: z.string().describe(`which configured memory root to write into: ${rootNames}`) } : {}),
-    }, async ({ key, key_type, doc_type, description, body, tags, related_to, folder, root }) => {
+    }, async ({ key, key_type, doc_type, description, body, tags, status, related_to, folder, root }) => {
         try {
-            const doc = repo.create({ key, key_type, doc_type, description, body, tags, related_to, folder, root });
+            const doc = repo.create({ key, key_type, doc_type, description, body, tags, status, related_to, folder, root });
             return { content: [{ type: 'text', text: JSON.stringify(doc, null, 2) }] };
         }
         catch (err) {
@@ -78,6 +80,7 @@ export function registerMemoryTools(mcp, repo) {
         description: z.string().describe('distinguishes this doc from others sharing the same key'),
         body: z.string(),
         tags: z.array(z.string()).optional(),
+        status: statusSchema(MEMORY_STATUS_DEFAULTS).optional().describe('defaults to "active"'),
         related_to: z.string().optional(),
         folder: z.string().optional(),
         ...(multiRoot ? { root: z.string().describe(`which configured memory root to write into: ${rootNames}`) } : {}),
@@ -94,7 +97,7 @@ export function registerMemoryTools(mcp, repo) {
         description: z.string().optional(),
         body: z.string().optional(),
         tags: z.array(z.string()).optional(),
-        status: z.enum(MEMORY_STATUS).optional(),
+        status: statusSchema(MEMORY_STATUS_DEFAULTS).optional(),
         related_to: z.string().optional(),
         deprecated: z.boolean().optional().describe('marks the doc as deprecated (or un-deprecates when false) — independent of status'),
     }, async ({ id, body, ...frontmatterFields }) => {

package/dist/src/shared/relocate-tool.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { relocate, relocateMany } from './relocate.js';
+import { statusSchema } from './status.js';
 const AUTHORING_SKILL_HINT = "Before your first call in a session, run skill_get(\"memory-bucket-authoring\") to learn the exact frontmatter schema and conventions — don't guess the shape.";
 const overridesSchema = z
     .object({
@@ -13,7 +14,7 @@ const overridesSchema = z
     key_type: z.enum(['ticket', 'freeform']).optional().describe('memory target only'),
     doc_type: z.enum(['plan', 'spec', 'sql', 'testing-todo', 'discovery', 'session-summary', 'other']).optional().describe('memory target only'),
     tags: z.array(z.string()).optional(),
-    status: z.enum(['stable', 'beta', 'unreviewed', 'active', 'shipped', 'abandoned']).optional(),
+    status: statusSchema(['stable', 'beta', 'unreviewed', 'active', 'shipped', 'abandoned']).optional(),
     folder: z.string().optional().describe('optional subdirectory under the target root'),
     root: z.string().optional().describe('which configured root to write into; required if multiple roots exist for the target type'),
 })

package/dist/src/shared/status.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+/**
+ * Status is a free-form label, not a closed enum — the DB column has no CHECK
+ * constraint and the web UI's filter dropdown is populated from distinct values
+ * actually in use (see buildFacets in web/routes.ts), so any normalized string
+ * works end to end. This schema only enforces a consistent shape (lowercase,
+ * hyphenated) so casing/typo variants don't silently fragment that dropdown.
+ */
+const STATUS_PATTERN = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
+export function normalizeStatus(status) {
+    return status.trim().toLowerCase().replace(/\s+/g, '-');
+}
+export function statusSchema(defaults) {
+    return z
+        .string()
+        .min(1)
+        .max(40)
+        .transform(normalizeStatus)
+        .refine((s) => STATUS_PATTERN.test(s), {
+        message: 'status must be lowercase alphanumeric with hyphens, e.g. "active" or "needs-review"',
+    })
+        .describe(`free-form status label, normalized to lowercase-hyphenated; conventional values: ${defaults.join(', ')} — but any value is accepted`);
+}

package/dist/src/skills/tools.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-const SKILL_STATUS = ['stable', 'beta', 'unreviewed'];
+import { statusSchema } from '../shared/status.js';
+const SKILL_STATUS_DEFAULTS = ['stable', 'beta', 'unreviewed'];
 const SKILL_NAME_DESCRIPTION = 'stable id, must be 1-64 chars, lowercase letters/numbers/hyphens only, no leading/trailing/consecutive hyphens — this becomes the skill\'s folder name (agentskills.io spec requirement)';
 const AUTHORING_SKILL_HINT = "Before your first call in a session, run skill_get(\"memory-bucket-authoring\") to learn the exact frontmatter schema and conventions — don't guess the shape.";
 export function registerSkillTools(mcp, repo) {
@@ -21,7 +22,7 @@ export function registerSkillTools(mcp, repo) {
     });
     mcp.tool('skill_search', 'Full-text search over skill description/body/tags (grep/find-like, ranked by relevance) — unlike skill_list\'s substring metadata filter, this searches the full markdown body. `query` is raw SQLite FTS5 MATCH syntax: bare words, "exact phrases", prefix* wildcards, AND/OR/NOT boolean operators; hyphenated/punctuated terms must be quoted, e.g. "blue-green". Can be combined with status/owner/tag filters. Returns ranked hits with a highlighted snippet, not the full body — call skill_get on a hit\'s name for that. Paused skills are hidden by default — pass include_paused to see them.', {
         query: z.string().describe('FTS5 match expression, e.g. `deploy AND rollback` or `"blue green"`'),
-        status: z.enum(SKILL_STATUS).optional(),
+        status: statusSchema(SKILL_STATUS_DEFAULTS).optional(),
         owner: z.string().optional(),
         tag: z.string().optional(),
         limit: z.number().int().positive().max(100).optional(),
@@ -42,7 +43,7 @@ export function registerSkillTools(mcp, repo) {
         add_tags: z.array(z.string()).optional(),
         remove_tags: z.array(z.string()).optional(),
         owner: z.string().nullable().optional(),
-        status: z.enum(SKILL_STATUS).optional(),
+        status: statusSchema(SKILL_STATUS_DEFAULTS).optional(),
         extends: z.string().nullable().optional(),
         deprecated: z.boolean().optional().describe('marks skills as deprecated (or un-deprecates when false) — independent of status'),
     }, async ({ names, add_tags, remove_tags, owner, status, extends: extendsId, deprecated }) => {
@@ -70,7 +71,7 @@ export function registerSkillTools(mcp, repo) {
         license: z.string().optional(),
         compatibility: z.string().max(500).optional().describe('only needed if the skill has specific environment requirements'),
         owner: z.string().optional().describe('squad or "company" — stored in frontmatter.metadata, unused for resolution in V0'),
-        status: z.enum(SKILL_STATUS).optional().describe('defaults to "unreviewed"; stored in frontmatter.metadata'),
+        status: statusSchema(SKILL_STATUS_DEFAULTS).optional().describe('defaults to "unreviewed"; stored in frontmatter.metadata'),
         tags: z.array(z.string()).optional(),
         trigger_phrases: z.array(z.string()).optional(),
         extends: z.string().optional().describe('reserved for a future overlay mechanism — stored in frontmatter.metadata'),
@@ -92,7 +93,7 @@ export function registerSkillTools(mcp, repo) {
         license: z.string().optional(),
         compatibility: z.string().max(500).optional(),
         owner: z.string().optional(),
-        status: z.enum(SKILL_STATUS).optional(),
+        status: statusSchema(SKILL_STATUS_DEFAULTS).optional(),
         tags: z.array(z.string()).optional(),
         trigger_phrases: z.array(z.string()).optional(),
         extends: z.string().optional(),
@@ -125,7 +126,7 @@ export function registerSkillTools(mcp, repo) {
         license: z.string().optional(),
         compatibility: z.string().max(500).optional(),
         owner: z.string().optional(),
-        status: z.enum(SKILL_STATUS).optional(),
+        status: statusSchema(SKILL_STATUS_DEFAULTS).optional(),
         tags: z.array(z.string()).optional(),
         trigger_phrases: z.array(z.string()).optional(),
         extends: z.string().optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-memory-bucket",
-  "version": "0.5.0",
+  "version": "0.5.3",
   "type": "module",
   "description": "MCP server exposing skill_* (reusable coding patterns) and memory_* (point-in-time working context) tools over a markdown+frontmatter source, cached into SQLite at runtime.",
   "repository": {