@decibelsystems/tools 2.1.2 → 2.1.3

package/dist/tools/concepts.js

@@ -0,0 +1,283 @@
+/**
+ * Concepts Domain — pre-project product ideas.
+ *
+ * Discrete from dojo: dojo wishes/proposals are *feature-scoped* (a capability
+ * inside an existing project). Concepts are *project-scoped* — a candidate for
+ * a NEW project that doesn't yet exist. Once a concept is committed, it
+ * graduates to a real project (project_init + registry_add stay separate
+ * deliberately, so the user sees what's happening).
+ *
+ * Storage: ~/.decibel/concepts/<id>.yaml — user-level, cross-project. Concepts
+ * have no project_id by definition; they are pre-project artifacts. The
+ * graduated_to field links a committed concept to its eventual project_id.
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+import YAML from 'yaml';
+import { toolSuccess, toolError, requireFields } from './shared/index.js';
+const CONCEPTS_DIR = path.join(os.homedir(), '.decibel', 'concepts');
+async function ensureConceptsDir() {
+    await fs.mkdir(CONCEPTS_DIR, { recursive: true });
+}
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .substring(0, 50);
+}
+function generateId(title, when = new Date()) {
+    const date = when.toISOString().slice(0, 10);
+    const slug = slugify(title) || 'concept';
+    const suffix = Math.random().toString(36).slice(2, 5);
+    return `concept-${date}-${slug}-${suffix}`;
+}
+function conceptPath(id) {
+    return path.join(CONCEPTS_DIR, `${id}.yaml`);
+}
+async function readConcept(id) {
+    try {
+        const raw = await fs.readFile(conceptPath(id), 'utf-8');
+        return YAML.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function writeConcept(concept) {
+    await ensureConceptsDir();
+    const yaml = YAML.stringify(concept, { lineWidth: 0 });
+    await fs.writeFile(conceptPath(concept.id), yaml, 'utf-8');
+}
+// ============================================================================
+// Tools
+// ============================================================================
+export const conceptsAddTool = {
+    definition: {
+        name: 'concepts_add',
+        description: 'Capture a new product concept — a candidate for a new project that does not yet exist. Distinct from dojo_add_wish (feature-scoped, inside an existing project). Use this when the idea is project-scale: "we should build a new app for X" rather than "we should add feature Y to project Z".',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: { type: 'string', description: 'Short name for the concept (becomes part of the id).' },
+                pitch: { type: 'string', description: 'One-sentence elevator pitch.' },
+                problem: { type: 'string', description: 'What problem this concept would solve.' },
+                why_now: { type: 'string', description: 'Why this is worth exploring now (optional).' },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Tags for filtering (e.g. ["desktop", "ui", "agents"]).',
+                },
+                prior_attempts: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Project ids of prior failed attempts at this concept (e.g. ["vector"] for HQ).',
+                },
+            },
+            required: ['title', 'pitch', 'problem'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            requireFields(args, 'title', 'pitch', 'problem');
+            const now = new Date();
+            const concept = {
+                id: generateId(args.title, now),
+                title: args.title,
+                pitch: args.pitch,
+                problem: args.problem,
+                why_now: args.why_now || undefined,
+                status: 'ideating',
+                tags: args.tags || [],
+                prior_attempts: args.prior_attempts || [],
+                graduated_to: null,
+                graduated_at: null,
+                shelved_reason: null,
+                shelved_at: null,
+                created_at: now.toISOString(),
+                updated_at: now.toISOString(),
+            };
+            await writeConcept(concept);
+            return toolSuccess({
+                id: concept.id,
+                path: conceptPath(concept.id),
+                status: concept.status,
+            });
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+export const conceptsListTool = {
+    definition: {
+        name: 'concepts_list',
+        description: 'List captured product concepts from ~/.decibel/concepts/. Optional filter by status. Returns id, title, pitch, status, tags, graduated_to, created_at — sorted newest first.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status: {
+                    type: 'string',
+                    enum: ['ideating', 'exploring', 'committed', 'shelved'],
+                    description: 'Filter by lifecycle status.',
+                },
+                tag: { type: 'string', description: 'Filter to concepts containing this tag.' },
+            },
+        },
+    },
+    handler: async (args) => {
+        try {
+            await ensureConceptsDir();
+            const files = await fs.readdir(CONCEPTS_DIR);
+            const yamlFiles = files.filter((f) => f.endsWith('.yaml'));
+            const concepts = [];
+            for (const file of yamlFiles) {
+                const id = file.replace(/\.yaml$/, '');
+                const c = await readConcept(id);
+                if (c)
+                    concepts.push(c);
+            }
+            let filtered = concepts;
+            if (args.status)
+                filtered = filtered.filter((c) => c.status === args.status);
+            if (args.tag)
+                filtered = filtered.filter((c) => c.tags.includes(args.tag));
+            filtered.sort((a, b) => (b.created_at > a.created_at ? 1 : -1));
+            return toolSuccess({
+                concepts: filtered.map((c) => ({
+                    id: c.id,
+                    title: c.title,
+                    pitch: c.pitch,
+                    status: c.status,
+                    tags: c.tags,
+                    graduated_to: c.graduated_to,
+                    created_at: c.created_at,
+                })),
+                count: filtered.length,
+                storage_dir: CONCEPTS_DIR,
+            });
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+export const conceptsReadTool = {
+    definition: {
+        name: 'concepts_read',
+        description: 'Read a single concept by id. Returns the full YAML record.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Concept id (e.g. "concept-2026-04-26-decibel-hq-7f").' },
+            },
+            required: ['id'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            requireFields(args, 'id');
+            const concept = await readConcept(args.id);
+            if (!concept) {
+                return toolError(`Concept "${args.id}" not found`, `Storage dir: ${CONCEPTS_DIR}. Use concepts_list to see all.`);
+            }
+            return toolSuccess({ concept, path: conceptPath(concept.id) });
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+export const conceptsCommitTool = {
+    definition: {
+        name: 'concepts_commit',
+        description: 'Mark a concept as committed — i.e. you are going to build it. Optionally links to a project_id (existing or about-to-be-created). Does NOT call project_init or registry_add — those stay separate so you see what is happening. Status moves to "committed", graduated_to + graduated_at recorded.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Concept id to commit.' },
+                project_id: {
+                    type: 'string',
+                    description: 'The project_id this concept graduates into (optional — can be set later via concepts_commit again).',
+                },
+            },
+            required: ['id'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            requireFields(args, 'id');
+            const concept = await readConcept(args.id);
+            if (!concept) {
+                return toolError(`Concept "${args.id}" not found`);
+            }
+            const now = new Date().toISOString();
+            // Kernel normalizes incoming project_id → projectId before reaching handlers.
+            const incomingProjectId = args.projectId || args.project_id;
+            concept.status = 'committed';
+            concept.graduated_to = incomingProjectId || concept.graduated_to;
+            concept.graduated_at = concept.graduated_at || now;
+            concept.updated_at = now;
+            await writeConcept(concept);
+            return toolSuccess({
+                id: concept.id,
+                status: concept.status,
+                graduated_to: concept.graduated_to,
+                graduated_at: concept.graduated_at,
+                next_step: concept.graduated_to
+                    ? `Concept linked to project_id "${concept.graduated_to}". Run project_init + registry_add separately if it does not exist yet.`
+                    : 'Set project_id later by running concepts_commit again with a project_id.',
+            });
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+export const conceptsShelveTool = {
+    definition: {
+        name: 'concepts_shelve',
+        description: 'Park a concept with a reason. Status moves to "shelved". Use when you decide not to pursue (yet) — the record stays so future Claudes can see prior thinking and avoid re-litigating.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Concept id to shelve.' },
+                reason: { type: 'string', description: 'Why this is being shelved (timing, scope, redundant, etc.).' },
+            },
+            required: ['id', 'reason'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            requireFields(args, 'id', 'reason');
+            const concept = await readConcept(args.id);
+            if (!concept) {
+                return toolError(`Concept "${args.id}" not found`);
+            }
+            const now = new Date().toISOString();
+            concept.status = 'shelved';
+            concept.shelved_reason = args.reason;
+            concept.shelved_at = now;
+            concept.updated_at = now;
+            await writeConcept(concept);
+            return toolSuccess({
+                id: concept.id,
+                status: concept.status,
+                shelved_reason: concept.shelved_reason,
+                shelved_at: concept.shelved_at,
+            });
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+export const conceptsTools = [
+    conceptsAddTool,
+    conceptsListTool,
+    conceptsReadTool,
+    conceptsCommitTool,
+    conceptsShelveTool,
+];
+//# sourceMappingURL=concepts.js.map

package/dist/tools/concepts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concepts.js","sourceRoot":"","sources":["../../src/tools/concepts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAyB1E,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAErE,KAAK,UAAU,iBAAiB;IAC9B,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,IAAI,GAAG,IAAI,IAAI,EAAE;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,OAAO,WAAW,IAAI,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,WAAW,CAAC,EAAU;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,EAAU;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,OAAgB;IAC1C,MAAM,iBAAiB,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,MAAM,CAAC,MAAM,eAAe,GAAa;IACvC,UAAU,EAAE;QACV,IAAI,EAAE,cAAc;QACpB,WAAW,EACT,iSAAiS;QACnS,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sDAAsD,EAAE;gBAC9F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;gBACtE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wCAAwC,EAAE;gBAClF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;gBACvF,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,wDAAwD;iBACtE;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,gFAAgF;iBAC9F;aACF;YACD,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;SACxC;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;YAEjD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,OAAO,GAAY;gBACvB,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,KAAe,EAAE,GAAG,CAAC;gBACzC,KAAK,EAAE,IAAI,CAAC,KAAe;gBAC3B,KAAK,EAAE,IAAI,CAAC,KAAe;gBAC3B,OAAO,EAAE,IAAI,CAAC,OAAiB;gBAC/B,OAAO,EAAG,IAAI,CAAC,OAAkB,IAAI,SAAS;gBAC9C,MAAM,EAAE,UAAU;gBAClB,IAAI,EAAG,IAAI,CAAC,IAAiB,IAAI,EAAE;gBACnC,cAAc,EAAG,IAAI,CAAC,cAA2B,IAAI,EAAE;gBACvD,YAAY,EAAE,IAAI;gBAClB,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,IAAI;gBACpB,UAAU,EAAE,IAAI;gBAChB,UAAU,EAAE,GAAG,CAAC,WAAW,EAAE;gBAC7B,UAAU,EAAE,GAAG,CAAC,WAAW,EAAE;aAC9B,CAAC;YAEF,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,WAAW,CAAC;gBACjB,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAa;IACxC,UAAU,EAAE;QACV,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,8KAA8K;QAChL,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC;oBACvD,WAAW,EAAE,6BAA6B;iBAC3C;gBACD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;aAChF;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,iBAAiB,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAE3D,MAAM,QAAQ,GAAc,EAAE,CAAC;YAC/B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBACvC,MAAM,CAAC,GAAG,MAAM,WAAW,CAAC,EAAE,CAAC,CAAC;gBAChC,IAAI,CAAC;oBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;YAED,IAAI,QAAQ,GAAG,QAAQ,CAAC;YACxB,IAAI,IAAI,CAAC,MAAM;gBAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;YAC7E,IAAI,IAAI,CAAC,GAAG;gBAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAa,CAAC,CAAC,CAAC;YAErF,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAEhE,OAAO,WAAW,CAAC;gBACjB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,YAAY,EAAE,CAAC,CAAC,YAAY;oBAC5B,UAAU,EAAE,CAAC,CAAC,UAAU;iBACzB,CAAC,CAAC;gBACH,KAAK,EAAE,QAAQ,CAAC,MAAM;gBACtB,WAAW,EAAE,YAAY;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAa;IACxC,UAAU,EAAE;QACV,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,4DAA4D;QACzE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uDAAuD,EAAE;aAC7F;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,EAAY,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,SAAS,CAAC,YAAY,IAAI,CAAC,EAAE,aAAa,EAAE,gBAAgB,YAAY,iCAAiC,CAAC,CAAC;YACpH,CAAC;YACD,OAAO,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAa;IAC1C,UAAU,EAAE;QACV,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,qSAAqS;QACvS,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;gBAC5D,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qGAAqG;iBACnH;aACF;YACD,QAAQ,EAAE,CAAC,IAAI,CAAC;SACjB;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,EAAY,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,SAAS,CAAC,YAAY,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC;YACrD,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,8EAA8E;YAC9E,MAAM,iBAAiB,GAAI,IAAI,CAAC,SAAoB,IAAK,IAAI,CAAC,UAAqB,CAAC;YACpF,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC;YAC7B,OAAO,CAAC,YAAY,GAAG,iBAAiB,IAAI,OAAO,CAAC,YAAY,CAAC;YACjE,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,GAAG,CAAC;YACnD,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC;YAEzB,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,WAAW,CAAC;gBACjB,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,SAAS,EAAE,OAAO,CAAC,YAAY;oBAC7B,CAAC,CAAC,iCAAiC,OAAO,CAAC,YAAY,yEAAyE;oBAChI,CAAC,CAAC,0EAA0E;aAC/E,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAa;IAC1C,UAAU,EAAE;QACV,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,uLAAuL;QACzL,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;gBAC5D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;aACvG;YACD,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC;SAC3B;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YACpC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,EAAY,CAAC,CAAC;YACrD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,SAAS,CAAC,YAAY,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC;YACrD,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;YAC3B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,MAAgB,CAAC;YAC/C,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC;YACzB,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC;YAEzB,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,WAAW,CAAC;gBACjB,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAe;IACvC,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,kBAAkB;CACnB,CAAC"}

package/dist/tools/corpus/index.d.ts

@@ -1,5 +1,8 @@
 import { ToolSpec } from '../types.js';
 export declare const corpusSearchTool: ToolSpec;
 export declare const corpusStatusTool: ToolSpec;
+export declare const corpusAddPatternTool: ToolSpec;
+export declare const corpusAddFieldNoteTool: ToolSpec;
+export declare const corpusAddPlaybookTool: ToolSpec;
 export declare const corpusTools: ToolSpec[];
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/corpus/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/corpus/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAoBvC,eAAO,MAAM,gBAAgB,EAAE,QAoD9B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,QA8B9B,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,QAAQ,EAGjC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/corpus/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA0BvC,eAAO,MAAM,gBAAgB,EAAE,QAoD9B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,QA8B9B,CAAC;AAMF,eAAO,MAAM,oBAAoB,EAAE,QAgElC,CAAC;AAMF,eAAO,MAAM,sBAAsB,EAAE,QAoDpC,CAAC;AAMF,eAAO,MAAM,qBAAqB,EAAE,QAgDnC,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,QAAQ,EAMjC,CAAC"}

package/dist/tools/corpus/index.js

@@ -5,7 +5,7 @@
 // Enables cross-project learning from patterns, playbooks, and field notes.
 // ============================================================================
 import { toolSuccess, toolError, requireFields } from '../shared/index.js';
-import { corpusSearch, getCorpusPath, corpusExists, } from '../corpus.js';
+import { corpusSearch, getCorpusPath, corpusExists, addPattern, addFieldNote, addPlaybook, } from '../corpus.js';
 // ============================================================================
 // Constants
 // ============================================================================
@@ -96,10 +96,192 @@ export const corpusStatusTool = {
     },
 };
 // ============================================================================
+// Corpus Add Pattern Tool
+// ============================================================================
+export const corpusAddPatternTool = {
+    definition: {
+        name: 'corpus_add_pattern',
+        description: `Add a reusable pattern to decibel-corpus. Patterns are named solutions to recurring problems (e.g., "advisory lock for idempotency", "exponential backoff with jitter"). The id must match PREFIX-NNNN format (e.g., DBS-0004). Will not overwrite existing files.`,
+        annotations: {
+            title: 'Add Corpus Pattern',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: {
+                    type: 'string',
+                    description: 'Pattern identifier in PREFIX-NNNN format (e.g., DBS-0004, A11Y-0001)',
+                },
+                title: {
+                    type: 'string',
+                    description: 'Human-readable title (e.g., "Advisory Lock for Idempotent Mutations")',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Markdown body — problem statement, solution, code examples, trade-offs',
+                },
+                category: {
+                    type: 'string',
+                    description: 'Optional subdirectory within primitives/patterns/ (e.g., "concurrency", "auth")',
+                },
+                status: {
+                    type: 'string',
+                    description: 'Pattern maturity: draft, reviewed, canonical (default: draft)',
+                },
+                severity: {
+                    type: 'string',
+                    description: 'Impact level if the pattern is not followed (e.g., "high", "critical")',
+                },
+                source: {
+                    type: 'string',
+                    description: 'Where this pattern was discovered (e.g., "EPIC-0032", "incident-2026-03")',
+                },
+                owner: {
+                    type: 'string',
+                    description: 'Who authored or is responsible for this pattern',
+                },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Searchable tags (e.g., ["postgres", "concurrency", "idempotency"])',
+                },
+            },
+            required: ['id', 'title', 'content'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'id', 'title', 'content');
+            const result = await addPattern(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Corpus Add Field Note Tool
+// ============================================================================
+export const corpusAddFieldNoteTool = {
+    definition: {
+        name: 'corpus_add_field_note',
+        description: `Add a field note to decibel-corpus. Field notes capture lessons learned, gotchas, and observations from real work — things that aren't patterns yet but are worth remembering. Filename is auto-generated as YYYY-MM-DD-{slug}.md. Will not overwrite existing files.`,
+        annotations: {
+            title: 'Add Corpus Field Note',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: {
+                    type: 'string',
+                    description: 'Descriptive title (e.g., "Supabase RLS gotcha with service role key")',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Markdown body — what happened, what was learned, any code examples',
+                },
+                source: {
+                    type: 'string',
+                    description: 'Context where this was observed (e.g., "EPIC-0032", "senken deploy 2026-03")',
+                },
+                owner: {
+                    type: 'string',
+                    description: 'Who captured this note',
+                },
+                status: {
+                    type: 'string',
+                    description: 'Note maturity: draft, reviewed, promoted (default: draft)',
+                },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Searchable tags (e.g., ["supabase", "rls", "auth"])',
+                },
+            },
+            required: ['title', 'content'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'title', 'content');
+            const result = await addFieldNote(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Corpus Add Playbook Tool
+// ============================================================================
+export const corpusAddPlaybookTool = {
+    definition: {
+        name: 'corpus_add_playbook',
+        description: `Add a playbook to decibel-corpus. Playbooks are step-by-step guides for specific operations (e.g., "deploy senken to production", "rotate Supabase keys", "onboard new MCP module"). Filename is auto-generated as {slug}.md. Will not overwrite existing files.`,
+        annotations: {
+            title: 'Add Corpus Playbook',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: {
+                    type: 'string',
+                    description: 'Playbook title (e.g., "Deploy Senken to Production")',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Markdown body — numbered steps, prerequisites, rollback procedures',
+                },
+                owner: {
+                    type: 'string',
+                    description: 'Who authored this playbook',
+                },
+                status: {
+                    type: 'string',
+                    description: 'Playbook maturity: draft, reviewed, canonical (default: draft)',
+                },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Searchable tags (e.g., ["deployment", "senken", "production"])',
+                },
+            },
+            required: ['title', 'content'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'title', 'content');
+            const result = await addPlaybook(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
 // Export All Tools
 // ============================================================================
 export const corpusTools = [
     corpusSearchTool,
     corpusStatusTool,
+    corpusAddPatternTool,
+    corpusAddFieldNoteTool,
+    corpusAddPlaybookTool,
 ];
 //# sourceMappingURL=index.js.map

package/dist/tools/corpus/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/corpus/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/corpus/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/corpus.d.ts

@@ -18,6 +18,38 @@ export interface CorpusSearchResult {
     searched: number;
     corpus_path: string;
 }
+export interface AddPatternInput {
+    id: string;
+    title: string;
+    content: string;
+    category?: string;
+    status?: string;
+    severity?: string;
+    source?: string;
+    owner?: string;
+    tags?: string[];
+}
+export interface AddFieldNoteInput {
+    title: string;
+    content: string;
+    source?: string;
+    owner?: string;
+    status?: string;
+    tags?: string[];
+}
+export interface AddPlaybookInput {
+    title: string;
+    content: string;
+    owner?: string;
+    status?: string;
+    tags?: string[];
+}
+export interface CorpusWriteResult {
+    id: string;
+    path: string;
+    absolute_path: string;
+    title: string;
+}
 /**
  * Search the decibel-corpus for patterns, playbooks, and field notes
  */
@@ -30,4 +62,24 @@ export declare function getCorpusPath(): string;
  * Check if corpus exists at the configured path
  */
 export declare function corpusExists(): Promise<boolean>;
+/**
+ * Slugify text for use in filenames.
+ * Lowercases, replaces non-alphanumeric with dashes, trims dashes, max 80 chars.
+ */
+export declare function slugify(text: string): string;
+/**
+ * Add a pattern to decibel-corpus.
+ * Writes to primitives/patterns/{category?}/{id}-{slug}.md
+ */
+export declare function addPattern(input: AddPatternInput): Promise<CorpusWriteResult>;
+/**
+ * Add a field note to decibel-corpus.
+ * Writes to field-notes/YYYY-MM-DD-{slug}.md
+ */
+export declare function addFieldNote(input: AddFieldNoteInput): Promise<CorpusWriteResult>;
+/**
+ * Add a playbook to decibel-corpus.
+ * Writes to playbooks/{slug}.md
+ */
+export declare function addPlaybook(input: AddPlaybookInput): Promise<CorpusWriteResult>;
 //# sourceMappingURL=corpus.d.ts.map

package/dist/tools/corpus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../../src/tools/corpus.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAyHD;;GAEG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6DxF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAOrD"}
+{"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../../src/tools/corpus.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAyHD;;GAEG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6DxF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAOrD;AAQD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAmDD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiEnF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqDvF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkDrF"}