@porast1/mcp-cognitive 1.0.0

package/dist/ports/cognitive-store.port.d.ts

@@ -0,0 +1,34 @@
+import type { AuditReport, Fact, FactInput, RecallQuery, RecallResult, VerifyResult } from '../types.js';
+/**
+ * CognitiveStore — the core port interface for the cognitive database.
+ *
+ * This is the MOST IMPORTANT contract in the system. Both SqliteStore
+ * (Level 3) and future WeaviateStore (Level 4) implement this interface.
+ *
+ * Changing this file = changing the API for ALL adapters.
+ */
+export interface CognitiveStore {
+    /** Store a new fact. Generates id and timestamps automatically. */
+    store(input: FactInput): Promise<Fact>;
+    /** Update an existing fact by id. Only provided fields are changed. */
+    update(id: string, patch: Partial<FactInput>): Promise<Fact>;
+    /** Archive a fact (soft delete with reason). */
+    archive(id: string, reason: string): Promise<void>;
+    /** Recall facts matching a query. Updates recall metadata as side effect. */
+    recall(query: RecallQuery): Promise<RecallResult>;
+    /** Verify citations for a single fact. */
+    verify(factId: string): Promise<VerifyResult>;
+    /** Verify citations for ALL active facts. */
+    verifyAll(): Promise<VerifyResult[]>;
+    /** Generate a full health audit report. */
+    audit(): Promise<AuditReport>;
+    /** Check for facts that should be marked stale based on TTL rules. */
+    decayCheck(): Promise<Fact[]>;
+    /** Bulk import facts (for migration from Copilot Memory or other sources). */
+    migrate(facts: readonly FactInput[]): Promise<void>;
+    /** Export all facts (for migration to Weaviate or backup). */
+    exportAll(): Promise<Fact[]>;
+    /** Count total facts (all statuses). */
+    count(): Promise<number>;
+}
+//# sourceMappingURL=cognitive-store.port.d.ts.map

package/dist/ports/cognitive-store.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-store.port.d.ts","sourceRoot":"","sources":["../../src/ports/cognitive-store.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,IAAI,EACJ,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,EACb,MAAM,aAAa,CAAC;AAErB;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAG7B,mEAAmE;IACnE,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,uEAAuE;IACvE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D,gDAAgD;IAChD,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAInD,6EAA6E;IAC7E,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAIlD,0CAA0C;IAC1C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE9C,6CAA6C;IAC7C,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAErC,2CAA2C;IAC3C,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAI9B,sEAAsE;IACtE,UAAU,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAE9B,8EAA8E;IAC9E,OAAO,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAIpD,8DAA8D;IAC9D,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAE7B,wCAAwC;IACxC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1B"}

package/dist/ports/cognitive-store.port.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cognitive-store.port.js.map

package/dist/ports/cognitive-store.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitive-store.port.js","sourceRoot":"","sources":["../../src/ports/cognitive-store.port.ts"],"names":[],"mappings":""}

package/dist/profiles/agent-profiles.d.ts

@@ -0,0 +1,20 @@
+import type { Module } from '../types.js';
+/** Agent-specific recall preferences for optimizing context relevance */
+export interface AgentProfile {
+    readonly name: string;
+    readonly priorityTypes: readonly string[];
+    readonly boostTags: readonly string[];
+    readonly suppressTags: readonly string[];
+    readonly defaultModule?: Module;
+    readonly maxRecall: number;
+}
+/**
+ * Get the agent profile for a given agent name.
+ * Falls back to 'default' if the agent is unknown.
+ */
+export declare function getAgentProfile(agentName?: string): AgentProfile;
+/**
+ * Get all registered agent profiles.
+ */
+export declare function getAllProfiles(): AgentProfile[];
+//# sourceMappingURL=agent-profiles.d.ts.map

package/dist/profiles/agent-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-profiles.d.ts","sourceRoot":"","sources":["../../src/profiles/agent-profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AA6DD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,CAGhE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,YAAY,EAAE,CAE/C"}

package/dist/profiles/agent-profiles.js

@@ -0,0 +1,74 @@
+const AGENT_PROFILES = {
+    'implement-subagent': {
+        name: 'implement-subagent',
+        priorityTypes: ['invariant', 'policy', 'convention'],
+        boostTags: ['architecture', 'ports', 'cross-bc', 'dependency-rule', 'value-object'],
+        suppressTags: ['e2e-only', 'test-only'],
+        maxRecall: 7,
+    },
+    'test-E2E-subagent': {
+        name: 'test-E2E-subagent',
+        priorityTypes: ['convention', 'observation'],
+        boostTags: ['test', 'e2e', 'flaky', 'serial', 'uuid', 'playwright'],
+        suppressTags: ['architecture-only'],
+        maxRecall: 10,
+    },
+    'review-guard-subagent': {
+        name: 'review-guard-subagent',
+        priorityTypes: ['invariant', 'policy'],
+        boostTags: ['cross-bc', 'dependency-rule', 'domain-purity', 'architecture'],
+        suppressTags: ['ephemeral'],
+        maxRecall: 5,
+    },
+    'fixTypecheck-subagent': {
+        name: 'fixTypecheck-subagent',
+        priorityTypes: ['observation', 'convention'],
+        boostTags: ['typescript', 'type-error', 'enum', 'zod', 'prisma'],
+        suppressTags: ['e2e-only'],
+        maxRecall: 5,
+    },
+    'fixLinters-subagent': {
+        name: 'fixLinters-subagent',
+        priorityTypes: ['convention', 'observation'],
+        boostTags: ['eslint', 'lint', 'enum', 'i18n', 'import'],
+        suppressTags: ['e2e-only'],
+        maxRecall: 5,
+    },
+    'test-subagent': {
+        name: 'test-subagent',
+        priorityTypes: ['convention', 'observation', 'policy'],
+        boostTags: ['test', 'uuid', 'serial', 'mock', 'fixture'],
+        suppressTags: ['architecture-only'],
+        maxRecall: 7,
+    },
+    'planning-subagent': {
+        name: 'planning-subagent',
+        priorityTypes: ['invariant', 'policy', 'convention'],
+        boostTags: ['architecture', 'cross-bc', 'module', 'domain'],
+        suppressTags: ['ephemeral'],
+        maxRecall: 10,
+    },
+    'default': {
+        name: 'default',
+        priorityTypes: ['invariant', 'policy', 'convention', 'observation'],
+        boostTags: [],
+        suppressTags: ['ephemeral'],
+        maxRecall: 5,
+    },
+};
+/**
+ * Get the agent profile for a given agent name.
+ * Falls back to 'default' if the agent is unknown.
+ */
+export function getAgentProfile(agentName) {
+    if (!agentName)
+        return AGENT_PROFILES['default'];
+    return AGENT_PROFILES[agentName] ?? AGENT_PROFILES['default'];
+}
+/**
+ * Get all registered agent profiles.
+ */
+export function getAllProfiles() {
+    return Object.values(AGENT_PROFILES);
+}
+//# sourceMappingURL=agent-profiles.js.map

package/dist/profiles/agent-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-profiles.js","sourceRoot":"","sources":["../../src/profiles/agent-profiles.ts"],"names":[],"mappings":"AAYA,MAAM,cAAc,GAAiC;IACnD,oBAAoB,EAAE;QACpB,IAAI,EAAE,oBAAoB;QAC1B,aAAa,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC;QACpD,SAAS,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,CAAC;QACnF,YAAY,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;QACvC,SAAS,EAAE,CAAC;KACb;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,mBAAmB;QACzB,aAAa,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;QAC5C,SAAS,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC;QACnE,YAAY,EAAE,CAAC,mBAAmB,CAAC;QACnC,SAAS,EAAE,EAAE;KACd;IACD,uBAAuB,EAAE;QACvB,IAAI,EAAE,uBAAuB;QAC7B,aAAa,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC;QACtC,SAAS,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,CAAC;QAC3E,YAAY,EAAE,CAAC,WAAW,CAAC;QAC3B,SAAS,EAAE,CAAC;KACb;IACD,uBAAuB,EAAE;QACvB,IAAI,EAAE,uBAAuB;QAC7B,aAAa,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC;QAC5C,SAAS,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC;QAChE,YAAY,EAAE,CAAC,UAAU,CAAC;QAC1B,SAAS,EAAE,CAAC;KACb;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,qBAAqB;QAC3B,aAAa,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;QAC5C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;QACvD,YAAY,EAAE,CAAC,UAAU,CAAC;QAC1B,SAAS,EAAE,CAAC;KACb;IACD,eAAe,EAAE;QACf,IAAI,EAAE,eAAe;QACrB,aAAa,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,QAAQ,CAAC;QACtD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC;QACxD,YAAY,EAAE,CAAC,mBAAmB,CAAC;QACnC,SAAS,EAAE,CAAC;KACb;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,mBAAmB;QACzB,aAAa,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,CAAC;QACpD,SAAS,EAAE,CAAC,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC;QAC3D,YAAY,EAAE,CAAC,WAAW,CAAC;QAC3B,SAAS,EAAE,EAAE;KACd;IACD,SAAS,EAAE;QACT,IAAI,EAAE,SAAS;QACf,aAAa,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,CAAC;QACnE,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,CAAC,WAAW,CAAC;QAC3B,SAAS,EAAE,CAAC;KACb;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,SAAkB;IAChD,IAAI,CAAC,SAAS;QAAE,OAAO,cAAc,CAAC,SAAS,CAAE,CAAC;IAClD,OAAO,cAAc,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC,SAAS,CAAE,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;AACvC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/dist/server.js

@@ -0,0 +1,59 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { resolve } from 'node:path';
+import { SqliteStore } from './adapters/sqlite.adapter.js';
+import { WeaviateStore } from './adapters/weaviate.adapter.js';
+import { auditInputSchema, auditToolDescription, auditToolName, executeAudit, } from './tools/audit.tool.js';
+import { executeRecall, recallInputSchema, recallToolDescription, recallToolName, } from './tools/recall.tool.js';
+import { executeStore, storeInputSchema, storeToolDescription, storeToolName, } from './tools/store.tool.js';
+import { executeVerify, verifyInputSchema, verifyToolDescription, verifyToolName, } from './tools/verify.tool.js';
+// ─── Configuration ──────────────────────────────────────────────────────────
+const WORKSPACE_ROOT = process.env['WORKSPACE_ROOT'] ?? process.cwd();
+const DB_PATH = process.env['COGNITIVE_DB_PATH'] ?? '.cognitive/facts.sqlite';
+const resolvedDbPath = resolve(WORKSPACE_ROOT, DB_PATH);
+// ─── Store initialization ────────────────────────────────────────────────────
+async function createStore() {
+    const useWeaviate = process.env['USE_WEAVIATE'] === 'true';
+    const weaviateUrl = process.env['WEAVIATE_URL'] ?? 'localhost:8200';
+    if (useWeaviate) {
+        try {
+            return await WeaviateStore.create(weaviateUrl, WORKSPACE_ROOT);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`WARN: Weaviate unavailable, falling back to SQLite: ${message}`);
+        }
+    }
+    return await SqliteStore.create(resolvedDbPath, WORKSPACE_ROOT);
+}
+// ─── MCP Server ──────────────────────────────────────────────────────────────
+async function main() {
+    const store = await createStore();
+    const server = new McpServer({
+        name: 'cognitive-db',
+        version: '0.1.0',
+    });
+    // Register tools
+    server.tool(recallToolName, recallToolDescription, recallInputSchema.shape, async (input) => ({
+        content: [{ type: 'text', text: await executeRecall(store, input) }],
+    }));
+    server.tool(storeToolName, storeToolDescription, storeInputSchema.shape, async (input) => ({
+        content: [{ type: 'text', text: await executeStore(store, input) }],
+    }));
+    server.tool(verifyToolName, verifyToolDescription, verifyInputSchema.shape, async (input) => ({
+        content: [{ type: 'text', text: await executeVerify(store, input) }],
+    }));
+    server.tool(auditToolName, auditToolDescription, auditInputSchema.shape, async (input) => ({
+        content: [{ type: 'text', text: await executeAudit(store, input) }],
+    }));
+    // Start server with stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Stderr for logging (stdout is reserved for MCP protocol)
+    console.error(`[cognitive-db] MCP server started (db: ${resolvedDbPath})`);
+}
+main().catch((err) => {
+    console.error('[cognitive-db] Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/audit.tool.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import type { CognitiveStore } from '../ports/cognitive-store.port.js';
+export declare const auditToolName = "cognitive_audit";
+export declare const auditToolDescription: string;
+export declare const auditInputSchema: z.ZodObject<{}, z.core.$strip>;
+export type AuditInput = z.infer<typeof auditInputSchema>;
+export declare function executeAudit(store: CognitiveStore, _input: AuditInput): Promise<string>;
+//# sourceMappingURL=audit.tool.d.ts.map

package/dist/tools/audit.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.tool.d.ts","sourceRoot":"","sources":["../../src/tools/audit.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAE/C,eAAO,MAAM,oBAAoB,QAEoD,CAAC;AAEtF,eAAO,MAAM,gBAAgB,gCAAe,CAAC;AAE7C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,wBAAsB,YAAY,CAChC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,MAAM,CAAC,CAqDjB"}

package/dist/tools/audit.tool.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+export const auditToolName = 'cognitive_audit';
+export const auditToolDescription = 'Generate a health audit report for the cognitive knowledge base. ' +
+    'Shows fact distribution, stale facts, broken citations, and duplicate candidates.';
+export const auditInputSchema = z.object({});
+export async function executeAudit(store, _input) {
+    const report = await store.audit();
+    const lines = [
+        '═══ Cognitive Database Audit Report ═══',
+        `Generated: ${report.generatedAt}`,
+        '',
+        `Total facts: ${report.totalFacts}`,
+        '',
+        '── By Status ──',
+        `  Active:   ${report.byStatus.active}`,
+        `  Stale:    ${report.byStatus.stale}`,
+        `  Archived: ${report.byStatus.archived}`,
+        '',
+        '── By Type ──',
+        `  Invariant:   ${report.byType.invariant}`,
+        `  Policy:      ${report.byType.policy}`,
+        `  Convention:  ${report.byType.convention}`,
+        `  Observation: ${report.byType.observation}`,
+        `  Ephemeral:   ${report.byType.ephemeral}`,
+        '',
+        '── By Module ──',
+    ];
+    for (const [mod, count] of Object.entries(report.byModule)) {
+        lines.push(`  ${mod}: ${count}`);
+    }
+    if (report.staleFacts.length > 0) {
+        lines.push('', `── Stale Facts (${report.staleFacts.length}) ──`);
+        for (const fact of report.staleFacts) {
+            lines.push(`  ⚠ [${fact.type}] ${fact.fact.substring(0, 80)}...`);
+        }
+    }
+    if (report.brokenCitations.length > 0) {
+        lines.push('', `── Broken Citations (${report.brokenCitations.length}) ──`);
+        for (const v of report.brokenCitations) {
+            lines.push(`  ✗ ${v.factId}: "${v.factSnippet}..."`);
+        }
+    }
+    if (report.duplicateCandidates.length > 0) {
+        lines.push('', `── Duplicate Candidates (${report.duplicateCandidates.length}) ──`);
+        for (const d of report.duplicateCandidates) {
+            lines.push(`  ~ ${d.a} ↔ ${d.b} (${d.similarity} overlap)`);
+        }
+    }
+    const healthScore = calculateHealthScore(report);
+    lines.push('', `── Health Score: ${healthScore}/100 ──`);
+    return lines.join('\n');
+}
+function calculateHealthScore(report) {
+    if (report.totalFacts === 0)
+        return 100;
+    let score = 100;
+    // Penalize stale facts (max -30)
+    const staleRatio = report.byStatus.stale / report.totalFacts;
+    score -= Math.min(30, Math.round(staleRatio * 100));
+    // Penalize broken citations (max -40)
+    const brokenRatio = report.brokenCitations.length / report.totalFacts;
+    score -= Math.min(40, Math.round(brokenRatio * 200));
+    // Penalize duplicates (max -20)
+    const dupRatio = report.duplicateCandidates.length / report.totalFacts;
+    score -= Math.min(20, Math.round(dupRatio * 100));
+    // Bonus for having enough facts (+10)
+    if (report.byStatus.active >= 50)
+        score = Math.min(100, score + 10);
+    return Math.max(0, score);
+}
+//# sourceMappingURL=audit.tool.js.map

package/dist/tools/audit.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.tool.js","sourceRoot":"","sources":["../../src/tools/audit.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE/C,MAAM,CAAC,MAAM,oBAAoB,GAC/B,mEAAmE;IACnE,mFAAmF,CAAC;AAEtF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAI7C,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAqB,EACrB,MAAkB;IAElB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IAEnC,MAAM,KAAK,GAAG;QACZ,yCAAyC;QACzC,cAAc,MAAM,CAAC,WAAW,EAAE;QAClC,EAAE;QACF,gBAAgB,MAAM,CAAC,UAAU,EAAE;QACnC,EAAE;QACF,iBAAiB;QACjB,eAAe,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;QACvC,eAAe,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE;QACtC,eAAe,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE;QACzC,EAAE;QACF,eAAe;QACf,kBAAkB,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;QAC3C,kBAAkB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;QACxC,kBAAkB,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE;QAC5C,kBAAkB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE;QAC7C,kBAAkB,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;QAC3C,EAAE;QACF,iBAAiB;KAClB,CAAC;IAEF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,mBAAmB,MAAM,CAAC,UAAU,CAAC,MAAM,MAAM,CAAC,CAAC;QAClE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,wBAAwB,MAAM,CAAC,eAAe,CAAC,MAAM,MAAM,CAAC,CAAC;QAC5E,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,4BAA4B,MAAM,CAAC,mBAAmB,CAAC,MAAM,MAAM,CAAC,CAAC;QACpF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,WAAW,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,oBAAoB,WAAW,SAAS,CAAC,CAAC;IAEzD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,oBAAoB,CAAC,MAK7B;IACC,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAExC,IAAI,KAAK,GAAG,GAAG,CAAC;IAEhB,iCAAiC;IACjC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;IAC7D,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC;IAEpD,sCAAsC;IACtC,MAAM,WAAW,GAAG,MAAM,CAAC,eAAe,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;IACtE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC;IAErD,gCAAgC;IAChC,MAAM,QAAQ,GAAG,MAAM,CAAC,mBAAmB,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;IACvE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC;IAElD,sCAAsC;IACtC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE;QAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;IAEpE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/tools/recall.tool.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import type { CognitiveStore } from '../ports/cognitive-store.port.js';
+export declare const recallToolName = "cognitive_recall";
+export declare const recallToolDescription: string;
+export declare const recallInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    agent: z.ZodOptional<z.ZodString>;
+    module: z.ZodOptional<z.ZodEnum<{
+        identity: "identity";
+        organization: "organization";
+        platform: "platform";
+        infrastructure: "infrastructure";
+        tooling: "tooling";
+        testing: "testing";
+        general: "general";
+    }>>;
+    types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        invariant: "invariant";
+        policy: "policy";
+        convention: "convention";
+        observation: "observation";
+        ephemeral: "ephemeral";
+    }>>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    minConfidence: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export type RecallInput = z.infer<typeof recallInputSchema>;
+export declare function executeRecall(store: CognitiveStore, input: RecallInput): Promise<string>;
+//# sourceMappingURL=recall.tool.d.ts.map

package/dist/tools/recall.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.tool.d.ts","sourceRoot":"","sources":["../../src/tools/recall.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAIvE,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAEjD,eAAO,MAAM,qBAAqB,QAEiE,CAAC;AAEpG,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;iBAQ5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,wBAAsB,aAAa,CACjC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,CAAC,CAmCjB"}

package/dist/tools/recall.tool.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { getAgentProfile } from '../profiles/agent-profiles.js';
+export const recallToolName = 'cognitive_recall';
+export const recallToolDescription = 'Search the cognitive knowledge base for relevant facts. ' +
+    'Returns facts matching a keyword query, optionally filtered by module, type, and agent profile.';
+export const recallInputSchema = z.object({
+    query: z.string().min(2).describe('Keywords to search for in facts and tags (e.g. "cross-bc isolation", "password reset serial")'),
+    agent: z.string().optional().describe('Agent name for profile-based filtering (e.g. "implement-subagent", "test-E2E-subagent")'),
+    module: z.enum(['identity', 'organization', 'platform', 'infrastructure', 'tooling', 'testing', 'general']).optional().describe('Filter by bounded context or area'),
+    types: z.array(z.enum(['invariant', 'policy', 'convention', 'observation', 'ephemeral'])).optional().describe('Filter by fact types'),
+    tags: z.array(z.string()).max(5).optional().describe('Filter by tags (all must match)'),
+    minConfidence: z.number().min(0).max(1).optional().default(0).describe('Minimum confidence threshold (0-1)'),
+    limit: z.number().min(1).max(50).optional().default(10).describe('Maximum number of results'),
+});
+export async function executeRecall(store, input) {
+    const profile = getAgentProfile(input.agent);
+    const query = {
+        query: input.query,
+        ...(input.agent !== undefined ? { agent: input.agent } : {}),
+        ...(input.module !== undefined ? { module: input.module } : {}),
+        types: input.types ?? profile.priorityTypes,
+        ...(input.tags !== undefined ? { tags: input.tags } : {}),
+        ...(input.minConfidence !== undefined ? { minConfidence: input.minConfidence } : {}),
+        limit: input.limit ?? profile.maxRecall,
+    };
+    const result = await store.recall(query);
+    if (result.facts.length === 0) {
+        return `No facts found for query: "${input.query}"`;
+    }
+    const lines = [
+        `Found ${result.totalMatches} facts (showing ${result.facts.length}, ${result.queryTimeMs}ms):`,
+        '',
+    ];
+    for (const fact of result.facts) {
+        const tags = fact.tags.length > 0 ? ` [${fact.tags.join(', ')}]` : '';
+        const citations = fact.citations.length > 0
+            ? `\n    Citations: ${fact.citations.map((c) => c.line ? `${c.file}:L${c.line}` : c.file).join(', ')}`
+            : '';
+        lines.push(`• [${fact.type}/${fact.module}] (${Math.round(fact.confidence * 100)}%) ${fact.fact}${tags}${citations}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=recall.tool.js.map

package/dist/tools/recall.tool.js.map

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

package/dist/tools/store.tool.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import type { CognitiveStore } from '../ports/cognitive-store.port.js';
+export declare const storeToolName = "cognitive_store";
+export declare const storeToolDescription: string;
+export declare const storeInputSchema: z.ZodObject<{
+    fact: z.ZodString;
+    type: z.ZodEnum<{
+        invariant: "invariant";
+        policy: "policy";
+        convention: "convention";
+        observation: "observation";
+        ephemeral: "ephemeral";
+    }>;
+    module: z.ZodEnum<{
+        identity: "identity";
+        organization: "organization";
+        platform: "platform";
+        infrastructure: "infrastructure";
+        tooling: "tooling";
+        testing: "testing";
+        general: "general";
+    }>;
+    confidence: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    citations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        context: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    supersedes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StoreInput = z.infer<typeof storeInputSchema>;
+export declare function executeStore(store: CognitiveStore, input: StoreInput): Promise<string>;
+//# sourceMappingURL=store.tool.d.ts.map

package/dist/tools/store.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.tool.d.ts","sourceRoot":"","sources":["../../src/tools/store.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAE/C,eAAO,MAAM,oBAAoB,QAGsB,CAAC;AAExD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,wBAAsB,YAAY,CAChC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,MAAM,CAAC,CAgCjB"}

package/dist/tools/store.tool.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+export const storeToolName = 'cognitive_store';
+export const storeToolDescription = 'Store a new fact in the cognitive knowledge base. ' +
+    'Facts should be actionable, verifiable, and scoped. ' +
+    'Include citations (file:line) and appropriate tags.';
+export const storeInputSchema = z.object({
+    fact: z.string().min(10).max(500).describe('The fact text — must be actionable and verifiable (e.g. "oRPC 500 with OK use case = missing return in router handler")'),
+    type: z.enum(['invariant', 'policy', 'convention', 'observation', 'ephemeral'])
+        .describe('Fact classification: invariant (permanent arch rule), policy (until business decision change), convention (6mo audit), observation (30d re-verify), ephemeral (7d auto-expire)'),
+    module: z.enum(['identity', 'organization', 'platform', 'infrastructure', 'tooling', 'testing', 'general'])
+        .describe('Which bounded context or area this fact belongs to'),
+    confidence: z.number().min(0).max(1).optional().default(0.8)
+        .describe('Confidence level 0.0-1.0. Use 1.0 for invariants, 0.9-0.95 for verified conventions, 0.7-0.8 for observations'),
+    citations: z.array(z.object({
+        file: z.string().min(1).describe('Relative file path from workspace root (e.g. "apps/web/lib/modules/identity/domain/user.ts")'),
+        line: z.number().min(1).optional().describe('Line number (1-based)'),
+        context: z.string().max(200).optional().describe('What this citation proves'),
+    })).min(1).optional().describe('File:line citations that support this fact — at least 1 recommended'),
+    tags: z.array(z.string().min(1).max(30)).max(10).optional().describe('Searchable tags for categorization (e.g. ["architecture", "cross-bc", "ddd"])'),
+    supersedes: z.string().optional().describe('UUID of fact this replaces — old fact will be archived'),
+});
+export async function executeStore(store, input) {
+    const factInput = {
+        fact: input.fact,
+        type: input.type,
+        module: input.module,
+        ...(input.confidence !== undefined ? { confidence: input.confidence } : {}),
+        ...(input.citations !== undefined ? { citations: input.citations } : {}),
+        ...(input.tags !== undefined ? { tags: input.tags } : {}),
+        ...(input.supersedes !== undefined ? { supersedes: input.supersedes } : {}),
+    };
+    const stored = await store.store(factInput);
+    const lines = [
+        `✓ Fact stored successfully:`,
+        `  ID: ${stored.id}`,
+        `  Type: ${stored.type}`,
+        `  Module: ${stored.module}`,
+        `  Confidence: ${Math.round(stored.confidence * 100)}%`,
+    ];
+    if (stored.tags.length > 0) {
+        lines.push(`  Tags: ${stored.tags.join(', ')}`);
+    }
+    if (stored.citations.length > 0) {
+        lines.push(`  Citations: ${stored.citations.length}`);
+    }
+    if (stored.supersedes) {
+        lines.push(`  Supersedes: ${stored.supersedes} (old fact archived)`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=store.tool.js.map

package/dist/tools/store.tool.js.map

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

package/dist/tools/verify.tool.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import type { CognitiveStore } from '../ports/cognitive-store.port.js';
+export declare const verifyToolName = "cognitive_verify";
+export declare const verifyToolDescription: string;
+export declare const verifyInputSchema: z.ZodObject<{
+    factId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type VerifyInput = z.infer<typeof verifyInputSchema>;
+export declare function executeVerify(store: CognitiveStore, input: VerifyInput): Promise<string>;
+//# sourceMappingURL=verify.tool.d.ts.map

package/dist/tools/verify.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.tool.d.ts","sourceRoot":"","sources":["../../src/tools/verify.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAEvE,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAEjD,eAAO,MAAM,qBAAqB,QAGkC,CAAC;AAErE,eAAO,MAAM,iBAAiB;;iBAG5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,wBAAsB,aAAa,CACjC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,CAAC,CAuDjB"}

package/dist/tools/verify.tool.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+export const verifyToolName = 'cognitive_verify';
+export const verifyToolDescription = 'Verify citation integrity for facts in the cognitive knowledge base. ' +
+    'Checks if referenced files and lines still exist and are valid. ' +
+    'Call with a factId to verify one fact, or without to verify all.';
+export const verifyInputSchema = z.object({
+    factId: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i).optional()
+        .describe('UUID of specific fact to verify. Omit to verify all active facts with citations.'),
+});
+export async function executeVerify(store, input) {
+    if (input.factId) {
+        const result = await store.verify(input.factId);
+        if (result.citations.length === 0) {
+            return `Fact ${result.factId}: No citations to verify.\n"${result.factSnippet}..."`;
+        }
+        const lines = [
+            `Fact ${result.factId}: ${result.overallStatus.toUpperCase()}`,
+            `"${result.factSnippet}..."`,
+            '',
+        ];
+        for (const c of result.citations) {
+            const loc = c.citation.line ? `${c.citation.file}:L${c.citation.line}` : c.citation.file;
+            lines.push(`  ${c.status === 'valid' ? '✓' : c.status === 'stale' ? '⚠' : '✗'} ${loc} → ${c.status}${c.detail ? ` (${c.detail})` : ''}`);
+        }
+        return lines.join('\n');
+    }
+    // Verify all
+    const results = await store.verifyAll();
+    if (results.length === 0) {
+        return 'No active facts with citations to verify.';
+    }
+    const valid = results.filter((r) => r.overallStatus === 'valid').length;
+    const stale = results.filter((r) => r.overallStatus === 'stale').length;
+    const broken = results.filter((r) => r.overallStatus === 'broken').length;
+    const lines = [
+        `Citation Verification Report:`,
+        `  ✓ Valid: ${valid}`,
+        `  ⚠ Stale: ${stale}`,
+        `  ✗ Broken: ${broken}`,
+        `  Total checked: ${results.length}`,
+    ];
+    // Show details for broken/stale only
+    const problems = results.filter((r) => r.overallStatus !== 'valid');
+    if (problems.length > 0) {
+        lines.push('', 'Problems:');
+        for (const result of problems) {
+            lines.push(`  [${result.overallStatus}] ${result.factId}: "${result.factSnippet}..."`);
+            for (const c of result.citations.filter((ci) => ci.status !== 'valid')) {
+                const loc = c.citation.line ? `${c.citation.file}:L${c.citation.line}` : c.citation.file;
+                lines.push(`    ${c.status === 'stale' ? '⚠' : '✗'} ${loc}: ${c.detail ?? c.status}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=verify.tool.js.map

package/dist/tools/verify.tool.js.map

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