decibel-tools-mcp 1.0.0

package/dist/tools/friction.js

@@ -0,0 +1,331 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { log } from '../config.js';
+import { ensureDir } from '../dataRoot.js';
+import { resolveProjectPaths, validateWritePath } from '../projectRegistry.js';
+import { emitCreateProvenance } from './provenance.js';
+function makeProjectResolutionError(operation) {
+    return {
+        error: 'project_resolution_failed',
+        message: `Cannot ${operation}: No project context available.`,
+        hint: 'Either specify projectId parameter, set DECIBEL_PROJECT_ROOT env var, or run from a directory containing .decibel/',
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .substring(0, 50);
+}
+function formatTimestampForFilename(date) {
+    const iso = date.toISOString();
+    return iso.replace(/:/g, '-').replace(/\.\d{3}Z$/, 'Z');
+}
+const impactOrder = {
+    low: 1,
+    medium: 2,
+    high: 3,
+    blocking: 4,
+};
+async function parseFrictionFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch)
+            return null;
+        const frontmatter = {};
+        for (const line of frontmatterMatch[1].split('\n')) {
+            const colonIndex = line.indexOf(':');
+            if (colonIndex > 0) {
+                const key = line.slice(0, colonIndex).trim();
+                let value = line.slice(colonIndex + 1).trim();
+                if (value.startsWith('[') && value.endsWith(']')) {
+                    frontmatter[key] = value
+                        .slice(1, -1)
+                        .split(',')
+                        .map((s) => s.trim())
+                        .filter((s) => s.length > 0);
+                }
+                else {
+                    frontmatter[key] = value;
+                }
+            }
+        }
+        // Extract description from first paragraph after frontmatter
+        const bodyMatch = content.match(/---\n\n# .+\n\n([\s\S]*?)(?=\n## |$)/);
+        const description = bodyMatch ? bodyMatch[1].trim().split('\n')[0] : '';
+        return {
+            id: path.basename(filePath, '.md'),
+            context: frontmatter.context || '',
+            description,
+            frequency: frontmatter.frequency || 'occasional',
+            impact: frontmatter.impact || 'medium',
+            status: frontmatter.status || 'open',
+            signal_count: parseInt(frontmatter.signal_count, 10) || 1,
+            last_reported: frontmatter.last_reported || '',
+            tags: frontmatter.tags || [],
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function findFrictionFile(frictionId, projectId) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(projectId);
+    }
+    catch {
+        return null;
+    }
+    const frictionDir = resolved.subPath('friction');
+    try {
+        const files = await fs.readdir(frictionDir);
+        // Exact match
+        const exact = files.find(f => f === frictionId || f === `${frictionId}.md`);
+        if (exact)
+            return path.join(frictionDir, exact);
+        // Partial match
+        const partial = files.find(f => f.toLowerCase().includes(frictionId.toLowerCase()));
+        if (partial)
+            return path.join(frictionDir, partial);
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Functions
+// ============================================================================
+export async function logFriction(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch (err) {
+        return makeProjectResolutionError('log friction');
+    }
+    const now = new Date();
+    const timestamp = now.toISOString();
+    const fileTimestamp = formatTimestampForFilename(now);
+    const frictionDir = resolved.subPath('friction');
+    ensureDir(frictionDir);
+    const slug = slugify(input.description);
+    const filename = `${fileTimestamp}-${slug}.md`;
+    const filePath = path.join(frictionDir, filename);
+    const frequency = input.frequency || 'occasional';
+    const impact = input.impact || 'medium';
+    const source = input.source || 'human';
+    const tags = input.tags || [];
+    // Check for similar existing friction (same context + similar description)
+    let signalStrength = 1;
+    try {
+        const existingFiles = await fs.readdir(frictionDir);
+        for (const file of existingFiles) {
+            if (!file.endsWith('.md'))
+                continue;
+            const existing = await parseFrictionFile(path.join(frictionDir, file));
+            if (existing &&
+                existing.context === input.context &&
+                existing.status === 'open' &&
+                (existing.description.toLowerCase().includes(slug.replace(/-/g, ' ')) ||
+                    slug.replace(/-/g, ' ').includes(existing.description.toLowerCase().substring(0, 20)))) {
+                signalStrength++;
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist yet
+    }
+    // Build frontmatter
+    const frontmatter = [
+        '---',
+        `context: ${input.context}`,
+        `frequency: ${frequency}`,
+        `impact: ${impact}`,
+        `status: open`,
+        `source: ${source}`,
+        `signal_count: 1`,
+        `created_at: ${timestamp}`,
+        `last_reported: ${timestamp}`,
+        `tags: [${tags.join(', ')}]`,
+        '---',
+    ].join('\n');
+    // Build body
+    const bodyLines = [
+        `# ${input.description}`,
+        '',
+        input.description,
+        '',
+        '## Context',
+        '',
+        `**Where:** ${input.context}`,
+        `**Frequency:** ${frequency}`,
+        `**Impact:** ${impact}`,
+        `**Reported by:** ${source}`,
+    ];
+    if (input.workaround) {
+        bodyLines.push('', '## Current Workaround', '', input.workaround);
+    }
+    bodyLines.push('', '## Signal Log', '', `- ${timestamp} [${source}] Initial report`);
+    const content = `${frontmatter}\n\n${bodyLines.join('\n')}\n`;
+    validateWritePath(filePath, resolved);
+    await fs.writeFile(filePath, content, 'utf-8');
+    log(`Friction: Logged friction at ${filePath} (project: ${resolved.id})`);
+    // Emit provenance event for this creation
+    await emitCreateProvenance(`friction:log:${filename.replace('.md', '')}`, content, `Logged friction: ${input.description}`, input.projectId);
+    return {
+        id: filename.replace('.md', ''),
+        timestamp,
+        path: filePath,
+        context: input.context,
+        signal_strength: signalStrength,
+    };
+}
+export async function listFriction(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch (err) {
+        return makeProjectResolutionError('list friction');
+    }
+    const frictionDir = resolved.subPath('friction');
+    const limit = input.limit || 20;
+    let frictionList = [];
+    try {
+        const files = await fs.readdir(frictionDir);
+        for (const file of files) {
+            if (!file.endsWith('.md'))
+                continue;
+            const filePath = path.join(frictionDir, file);
+            const friction = await parseFrictionFile(filePath);
+            if (!friction)
+                continue;
+            // Apply filters
+            if (input.context && friction.context !== input.context)
+                continue;
+            if (input.status && friction.status !== input.status)
+                continue;
+            if (input.source) {
+                // Would need to check file content for source filter
+            }
+            if (input.min_impact && impactOrder[friction.impact] < impactOrder[input.min_impact])
+                continue;
+            frictionList.push(friction);
+        }
+    }
+    catch {
+        // Directory doesn't exist
+    }
+    const totalCount = frictionList.length;
+    // Sort by impact (desc), then signal_count (desc), then last_reported (desc)
+    frictionList.sort((a, b) => {
+        const impactDiff = impactOrder[b.impact] - impactOrder[a.impact];
+        if (impactDiff !== 0)
+            return impactDiff;
+        const signalDiff = b.signal_count - a.signal_count;
+        if (signalDiff !== 0)
+            return signalDiff;
+        return b.last_reported.localeCompare(a.last_reported);
+    });
+    // Apply limit
+    frictionList = frictionList.slice(0, limit);
+    return {
+        friction: frictionList,
+        total_count: totalCount,
+    };
+}
+export async function resolveFriction(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch (err) {
+        return makeProjectResolutionError('resolve friction');
+    }
+    const filePath = await findFrictionFile(input.friction_id, input.projectId);
+    if (!filePath) {
+        return { error: `Friction not found: ${input.friction_id}` };
+    }
+    const content = await fs.readFile(filePath, 'utf-8');
+    const now = new Date();
+    const resolvedAt = now.toISOString();
+    const newStatus = input.status || 'resolved';
+    // Update frontmatter
+    let updatedContent = content.replace(/^(---\n[\s\S]*?)status: \w+/m, `$1status: ${newStatus}`);
+    // Add resolved_at to frontmatter
+    if (!updatedContent.includes('resolved_at:')) {
+        updatedContent = updatedContent.replace(/^(---\n[\s\S]*?)(---)$/m, `$1resolved_at: ${resolvedAt}\n$2`);
+    }
+    // Add resolution section
+    const resolutionSection = [
+        '',
+        '## Resolution',
+        '',
+        input.resolution,
+    ];
+    if (input.solution_ref) {
+        resolutionSection.push('', `**Solution Reference:** ${input.solution_ref}`);
+    }
+    resolutionSection.push('', `**Resolved:** ${resolvedAt}`);
+    if (updatedContent.includes('## Resolution')) {
+        updatedContent = updatedContent.replace(/## Resolution[\s\S]*$/, resolutionSection.join('\n') + '\n');
+    }
+    else {
+        updatedContent = updatedContent.trimEnd() + '\n' + resolutionSection.join('\n') + '\n';
+    }
+    validateWritePath(filePath, resolved);
+    await fs.writeFile(filePath, updatedContent, 'utf-8');
+    log(`Friction: Resolved friction at ${filePath} (project: ${resolved.id})`);
+    return {
+        id: path.basename(filePath, '.md'),
+        path: filePath,
+        status: newStatus,
+        resolved_at: resolvedAt,
+    };
+}
+export async function bumpFriction(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch (err) {
+        return makeProjectResolutionError('bump friction');
+    }
+    const filePath = await findFrictionFile(input.friction_id, input.projectId);
+    if (!filePath) {
+        return { error: `Friction not found: ${input.friction_id}` };
+    }
+    const content = await fs.readFile(filePath, 'utf-8');
+    const now = new Date();
+    const timestamp = now.toISOString();
+    const source = input.source || 'human';
+    // Parse current signal_count
+    const signalMatch = content.match(/signal_count: (\d+)/);
+    const currentCount = signalMatch ? parseInt(signalMatch[1], 10) : 1;
+    const newCount = currentCount + 1;
+    // Update frontmatter
+    let updatedContent = content
+        .replace(/signal_count: \d+/, `signal_count: ${newCount}`)
+        .replace(/last_reported: .+/, `last_reported: ${timestamp}`);
+    // Add to signal log
+    const logEntry = input.note
+        ? `- ${timestamp} [${source}] ${input.note}`
+        : `- ${timestamp} [${source}] Bump`;
+    updatedContent = updatedContent.replace(/(## Signal Log\n\n)([\s\S]*?)(\n\n## |$)/, `$1$2\n${logEntry}$3`);
+    validateWritePath(filePath, resolved);
+    await fs.writeFile(filePath, updatedContent, 'utf-8');
+    log(`Friction: Bumped friction at ${filePath} (project: ${resolved.id}, signal: ${newCount})`);
+    return {
+        id: path.basename(filePath, '.md'),
+        signal_count: newCount,
+        last_reported: timestamp,
+    };
+}
+//# sourceMappingURL=friction.js.map

package/dist/tools/friction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction.js","sourceRoot":"","sources":["../../src/tools/friction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAwB,MAAM,uBAAuB,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAYvD,SAAS,0BAA0B,CAAC,SAAiB;IACnD,OAAO;QACL,KAAK,EAAE,2BAA2B;QAClC,OAAO,EAAE,UAAU,SAAS,iCAAiC;QAC7D,IAAI,EACF,oHAAoH;KACvH,CAAC;AACJ,CAAC;AAoFD,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,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,0BAA0B,CAAC,IAAU;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,WAAW,GAAmC;IAClD,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;CACZ,CAAC;AAEF,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAChE,IAAI,CAAC,gBAAgB;YAAE,OAAO,IAAI,CAAC;QAEnC,MAAM,WAAW,GAAsC,EAAE,CAAC;QAC1D,KAAK,MAAM,IAAI,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBACnB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC7C,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAE9C,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBACjD,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK;yBACrB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;yBACZ,KAAK,CAAC,GAAG,CAAC;yBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;yBACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACjC,CAAC;qBAAM,CAAC;oBACN,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QAED,6DAA6D;QAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACxE,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAExE,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;YAClC,OAAO,EAAG,WAAW,CAAC,OAAkB,IAAI,EAAE;YAC9C,WAAW;YACX,SAAS,EAAG,WAAW,CAAC,SAA+B,IAAI,YAAY;YACvE,MAAM,EAAG,WAAW,CAAC,MAAyB,IAAI,QAAQ;YAC1D,MAAM,EAAG,WAAW,CAAC,MAAyB,IAAI,MAAM;YACxD,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,YAAsB,EAAE,EAAE,CAAC,IAAI,CAAC;YACnE,aAAa,EAAG,WAAW,CAAC,aAAwB,IAAI,EAAE;YAC1D,IAAI,EAAG,WAAW,CAAC,IAAiB,IAAI,EAAE;SAC3C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,UAAkB,EAAE,SAAkB;IACpE,IAAI,QAA8B,CAAC;IACnC,IAAI,CAAC;QACH,QAAQ,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAE5C,cAAc;QACd,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,GAAG,UAAU,KAAK,CAAC,CAAC;QAC5E,IAAI,KAAK;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAEhD,gBAAgB;QAChB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACpF,IAAI,OAAO;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAEpD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAuB;IACvD,IAAI,QAA8B,CAAC;IACnC,IAAI,CAAC;QACH,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,0BAA0B,CAAC,cAAc,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,aAAa,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAC;IAEtD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACjD,SAAS,CAAC,WAAW,CAAC,CAAC;IAEvB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,GAAG,aAAa,IAAI,IAAI,KAAK,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,YAAY,CAAC;IAClD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC;IACxC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;IAE9B,2EAA2E;IAC3E,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACpD,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,SAAS;YACpC,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;YACvE,IAAI,QAAQ;gBACR,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;gBAClC,QAAQ,CAAC,MAAM,KAAK,MAAM;gBAC1B,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;oBACpE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5F,cAAc,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;IAED,oBAAoB;IACpB,MAAM,WAAW,GAAG;QAClB,KAAK;QACL,YAAY,KAAK,CAAC,OAAO,EAAE;QAC3B,cAAc,SAAS,EAAE;QACzB,WAAW,MAAM,EAAE;QACnB,cAAc;QACd,WAAW,MAAM,EAAE;QACnB,iBAAiB;QACjB,eAAe,SAAS,EAAE;QAC1B,kBAAkB,SAAS,EAAE;QAC7B,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC5B,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,aAAa;IACb,MAAM,SAAS,GAAG;QAChB,KAAK,KAAK,CAAC,WAAW,EAAE;QACxB,EAAE;QACF,KAAK,CAAC,WAAW;QACjB,EAAE;QACF,YAAY;QACZ,EAAE;QACF,cAAc,KAAK,CAAC,OAAO,EAAE;QAC7B,kBAAkB,SAAS,EAAE;QAC7B,eAAe,MAAM,EAAE;QACvB,oBAAoB,MAAM,EAAE;KAC7B,CAAC;IAEF,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,uBAAuB,EAAE,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACpE,CAAC;IAED,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,KAAK,SAAS,KAAK,MAAM,kBAAkB,CAAC,CAAC;IAErF,MAAM,OAAO,GAAG,GAAG,WAAW,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAE9D,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,GAAG,CAAC,gCAAgC,QAAQ,cAAc,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;IAE1E,0CAA0C;IAC1C,MAAM,oBAAoB,CACxB,gBAAgB,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,EAC7C,OAAO,EACP,oBAAoB,KAAK,CAAC,WAAW,EAAE,EACvC,KAAK,CAAC,SAAS,CAChB,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAC/B,SAAS;QACT,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,eAAe,EAAE,cAAc;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAwB;IACzD,IAAI,QAA8B,CAAC;IACnC,IAAI,CAAC;QACH,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,0BAA0B,CAAC,eAAe,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAEhC,IAAI,YAAY,GAAsB,EAAE,CAAC;IAEzC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAE5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,SAAS;YAEpC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC9C,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YACnD,IAAI,CAAC,QAAQ;gBAAE,SAAS;YAExB,gBAAgB;YAChB,IAAI,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO;gBAAE,SAAS;YAClE,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;gBAAE,SAAS;YAC/D,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,qDAAqD;YACvD,CAAC;YACD,IAAI,KAAK,CAAC,UAAU,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC;gBAAE,SAAS;YAE/F,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC;IAEvC,6EAA6E;IAC7E,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACzB,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACjE,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC;QAExC,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC;QACnD,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC;QAExC,OAAO,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,cAAc;IACd,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAE5C,OAAO;QACL,QAAQ,EAAE,YAAY;QACtB,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAA2B;IAC/D,IAAI,QAA8B,CAAC;IACnC,IAAI,CAAC;QACH,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,0BAA0B,CAAC,kBAAkB,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAE5E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,uBAAuB,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,IAAI,UAAU,CAAC;IAE7C,qBAAqB;IACrB,IAAI,cAAc,GAAG,OAAO,CAAC,OAAO,CAClC,8BAA8B,EAC9B,aAAa,SAAS,EAAE,CACzB,CAAC;IAEF,iCAAiC;IACjC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7C,cAAc,GAAG,cAAc,CAAC,OAAO,CACrC,yBAAyB,EACzB,kBAAkB,UAAU,MAAM,CACnC,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,MAAM,iBAAiB,GAAG;QACxB,EAAE;QACF,eAAe;QACf,EAAE;QACF,KAAK,CAAC,UAAU;KACjB,CAAC;IAEF,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACvB,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,2BAA2B,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,iBAAiB,UAAU,EAAE,CAAC,CAAC;IAE1D,IAAI,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC7C,cAAc,GAAG,cAAc,CAAC,OAAO,CACrC,uBAAuB,EACvB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CACpC,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,cAAc,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzF,CAAC;IAED,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IACtD,GAAG,CAAC,kCAAkC,QAAQ,cAAc,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC;IAE5E,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;QAClC,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,UAAU;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAwB;IACzD,IAAI,QAA8B,CAAC;IACnC,IAAI,CAAC;QACH,QAAQ,GAAG,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,0BAA0B,CAAC,eAAe,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAE5E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,KAAK,EAAE,uBAAuB,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC;IAEvC,6BAA6B;IAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,YAAY,GAAG,CAAC,CAAC;IAElC,qBAAqB;IACrB,IAAI,cAAc,GAAG,OAAO;SACzB,OAAO,CAAC,mBAAmB,EAAE,iBAAiB,QAAQ,EAAE,CAAC;SACzD,OAAO,CAAC,mBAAmB,EAAE,kBAAkB,SAAS,EAAE,CAAC,CAAC;IAE/D,oBAAoB;IACpB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI;QACzB,CAAC,CAAC,KAAK,SAAS,KAAK,MAAM,KAAK,KAAK,CAAC,IAAI,EAAE;QAC5C,CAAC,CAAC,KAAK,SAAS,KAAK,MAAM,QAAQ,CAAC;IAEtC,cAAc,GAAG,cAAc,CAAC,OAAO,CACrC,0CAA0C,EAC1C,SAAS,QAAQ,IAAI,CACtB,CAAC;IAEF,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IACtD,GAAG,CAAC,gCAAgC,QAAQ,cAAc,QAAQ,CAAC,EAAE,aAAa,QAAQ,GAAG,CAAC,CAAC;IAE/F,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;QAClC,YAAY,EAAE,QAAQ;QACtB,aAAa,EAAE,SAAS;KACzB,CAAC;AACJ,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+import { ToolSpec } from './types.js';
+export declare const modularTools: ToolSpec[];
+export declare const modularToolMap: Map<string, ToolSpec>;
+export declare function getModularToolNames(): string[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAqBtC,eAAO,MAAM,YAAY,EAAE,QAAQ,EAgBlC,CAAC;AAMF,eAAO,MAAM,cAAc,uBAE1B,CAAC;AAMF,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}

package/dist/tools/index.js

@@ -0,0 +1,52 @@
+// ============================================================================
+// Tools Aggregator
+// ============================================================================
+// Central registry of all modular tools.
+// Domains are added here as they are migrated from server.ts.
+// ============================================================================
+import { registryTools } from './registry/index.js';
+import { sentinelTools } from './sentinel/index.js';
+import { dojoTools } from './dojo/index.js';
+import { provenanceTools } from './provenance/index.js';
+import { oracleTools } from './oracle/index.js';
+import { learningsTools } from './learnings/index.js';
+import { frictionTools } from './friction/index.js';
+import { designerTools } from './designer/index.js';
+import { voiceTools } from './voice/index.js';
+import { contextTools } from './context/index.js';
+import { agenticTools } from './agentic/index.js';
+import { roadmapTools } from './roadmap/index.js';
+import { architectTools } from './architect/index.js';
+import { studioTools } from './studio/index.js';
+import { deckTools } from './deck.js';
+// ============================================================================
+// Aggregate All Tools
+// ============================================================================
+export const modularTools = [
+    ...registryTools,
+    ...sentinelTools,
+    ...dojoTools,
+    ...provenanceTools,
+    ...oracleTools,
+    ...learningsTools,
+    ...frictionTools,
+    ...designerTools,
+    ...voiceTools,
+    ...contextTools,
+    ...agenticTools,
+    ...roadmapTools,
+    ...architectTools,
+    ...studioTools,
+    ...deckTools,
+];
+// ============================================================================
+// Tool Map for Fast Lookup
+// ============================================================================
+export const modularToolMap = new Map(modularTools.map(t => [t.definition.name, t]));
+// ============================================================================
+// Helper to get tool names (for debugging)
+// ============================================================================
+export function getModularToolNames() {
+    return modularTools.map(t => t.definition.name);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAC/E,yCAAyC;AACzC,8DAA8D;AAC9D,+EAA+E;AAG/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,GAAG,aAAa;IAChB,GAAG,aAAa;IAChB,GAAG,SAAS;IACZ,GAAG,eAAe;IAClB,GAAG,WAAW;IACd,GAAG,cAAc;IACjB,GAAG,aAAa;IAChB,GAAG,aAAa;IAChB,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,YAAY;IACf,GAAG,YAAY;IACf,GAAG,cAAc;IACjB,GAAG,WAAW;IACd,GAAG,SAAS;CACb,CAAC;AAEF,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CACnC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAC9C,CAAC;AAEF,+EAA+E;AAC/E,2CAA2C;AAC3C,+EAA+E;AAE/E,MAAM,UAAU,mBAAmB;IACjC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC"}

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

@@ -0,0 +1,5 @@
+import { ToolSpec } from '../types.js';
+export declare const learningsAppendTool: ToolSpec;
+export declare const learningsListTool: ToolSpec;
+export declare const learningsTools: ToolSpec[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/learnings/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AA8BvC,eAAO,MAAM,mBAAmB,EAAE,QAmDjC,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,QAwC/B,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,QAAQ,EAGpC,CAAC"}

package/dist/tools/learnings/index.js

@@ -0,0 +1,123 @@
+// ============================================================================
+// Learnings Domain Tools
+// ============================================================================
+// Tools for tracking technical learnings and insights.
+// ============================================================================
+import { toolSuccess, toolError, requireFields } from '../shared/index.js';
+import { appendLearning, listLearnings, } from '../learnings.js';
+// ============================================================================
+// Types
+// ============================================================================
+const VALID_CATEGORIES = ['debug', 'integration', 'architecture', 'tooling', 'process', 'other'];
+// ============================================================================
+// Helper: Normalize project_id → projectId
+// ============================================================================
+function normalizeProjectId(args) {
+    if (!args.projectId && args.project_id) {
+        args.projectId = args.project_id;
+    }
+}
+// ============================================================================
+// Append Learning Tool
+// ============================================================================
+export const learningsAppendTool = {
+    definition: {
+        name: 'learnings_append',
+        description: "Append a new entry to a project's technical learnings document. Creates a living document that accumulates lessons learned, gotchas, and insights over time.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'The project identifier (creates learnings/{project_id}.md)',
+                },
+                category: {
+                    type: 'string',
+                    enum: ['debug', 'integration', 'architecture', 'tooling', 'process', 'other'],
+                    description: 'Category of the learning',
+                },
+                title: {
+                    type: 'string',
+                    description: 'Brief title for this learning entry',
+                },
+                content: {
+                    type: 'string',
+                    description: 'The learning content - what happened, what was learned, how to avoid/replicate',
+                },
+                tags: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Optional tags for searchability (e.g., ["mcp", "auth", "tokens"])',
+                },
+            },
+            required: ['project_id', 'category', 'title', 'content'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const rawInput = args;
+            normalizeProjectId(rawInput);
+            const input = rawInput;
+            requireFields(input, 'category', 'title', 'content');
+            if (!VALID_CATEGORIES.includes(input.category)) {
+                throw new Error(`Invalid category. Must be one of: ${VALID_CATEGORIES.join(', ')}`);
+            }
+            const result = await appendLearning(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// List Learnings Tool
+// ============================================================================
+export const learningsListTool = {
+    definition: {
+        name: 'learnings_list',
+        description: "List entries from a project's technical learnings document, optionally filtered by category.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'The project identifier',
+                },
+                category: {
+                    type: 'string',
+                    enum: ['debug', 'integration', 'architecture', 'tooling', 'process', 'other'],
+                    description: 'Optional category filter',
+                },
+                limit: {
+                    type: 'integer',
+                    description: 'Maximum number of entries to return (most recent first)',
+                },
+            },
+            required: ['project_id'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const rawInput = args;
+            normalizeProjectId(rawInput);
+            const input = rawInput;
+            if (input.category && !VALID_CATEGORIES.includes(input.category)) {
+                throw new Error(`Invalid category. Must be one of: ${VALID_CATEGORIES.join(', ')}`);
+            }
+            const result = await listLearnings(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Export All Tools
+// ============================================================================
+export const learningsTools = [
+    learningsAppendTool,
+    learningsListTool,
+];
+//# sourceMappingURL=index.js.map

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

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

package/dist/tools/learnings.d.ts

@@ -0,0 +1,41 @@
+export interface LearningsError {
+    error: string;
+    message: string;
+    hint?: string;
+}
+export declare function isLearningsError(result: unknown): result is LearningsError;
+export type LearningCategory = 'debug' | 'integration' | 'architecture' | 'tooling' | 'process' | 'other';
+export interface AppendLearningInput {
+    projectId?: string;
+    category: LearningCategory;
+    title: string;
+    content: string;
+    tags?: string[];
+}
+export interface AppendLearningOutput {
+    timestamp: string;
+    path: string;
+    entry_count: number;
+    location: 'project' | 'global';
+}
+export interface ListLearningsInput {
+    projectId?: string;
+    category?: LearningCategory;
+    limit?: number;
+}
+export interface LearningEntry {
+    timestamp: string;
+    category: LearningCategory;
+    title: string;
+    content: string;
+    tags: string[];
+}
+export interface ListLearningsOutput {
+    path: string;
+    entries: LearningEntry[];
+    total_count: number;
+    location: 'project' | 'global';
+}
+export declare function appendLearning(input: AppendLearningInput): Promise<AppendLearningOutput | LearningsError>;
+export declare function listLearnings(input: ListLearningsInput): Promise<ListLearningsOutput | LearningsError>;
+//# sourceMappingURL=learnings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"learnings.d.ts","sourceRoot":"","sources":["../../src/tools/learnings.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAUD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,cAAc,CAO1E;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1G,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;CAChC;AA+BD,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,GAAG,cAAc,CAAC,CAqEhD;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,GAAG,cAAc,CAAC,CAsD/C"}