@soleri/core 2.7.0 → 2.9.0

package/dist/runtime/facades/orchestrate-facade.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Orchestrate facade — execution orchestration ops.
+ * project registration, playbooks, plan/execute/complete.
+ */
+import type { OpDefinition } from '../../facades/types.js';
+import type { AgentRuntime } from '../types.js';
+export declare function createOrchestrateFacadeOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=orchestrate-facade.d.ts.map

package/dist/runtime/facades/orchestrate-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrate-facade.d.ts","sourceRoot":"","sources":["../../../src/runtime/facades/orchestrate-facade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAuDhF"}

package/dist/runtime/facades/orchestrate-facade.js

@@ -0,0 +1,58 @@
+/**
+ * Orchestrate facade — execution orchestration ops.
+ * project registration, playbooks, plan/execute/complete.
+ */
+import { z } from 'zod';
+import { createOrchestrateOps } from '../orchestrate-ops.js';
+import { createProjectOps } from '../project-ops.js';
+import { createPlaybookOps } from '../playbook-ops.js';
+export function createOrchestrateFacadeOps(runtime) {
+    const { vault, governance, projectRegistry } = runtime;
+    return [
+        // ─── Register (inline from core-ops.ts) ─────────────────────
+        {
+            name: 'register',
+            description: 'Register a project for this session. Call on every new session to track usage and get context.',
+            auth: 'write',
+            schema: z.object({
+                projectPath: z.string().optional().default('.'),
+                name: z.string().optional().describe('Project display name (derived from path if omitted)'),
+            }),
+            handler: async (params) => {
+                const { resolve } = await import('node:path');
+                const projectPath = resolve(params.projectPath ?? '.');
+                const project = vault.registerProject(projectPath, params.name);
+                // Also track in project registry for cross-project features
+                projectRegistry.register(projectPath, params.name);
+                const stats = vault.stats();
+                const isNew = project.sessionCount === 1;
+                // Expire stale proposals on session start (fire-and-forget)
+                const policy = governance.getPolicy(projectPath);
+                const expired = governance.expireStaleProposals(policy.autoCapture.autoExpireDays);
+                const proposalStats = governance.getProposalStats(projectPath);
+                const quotaStatus = governance.getQuotaStatus(projectPath);
+                return {
+                    project,
+                    is_new: isNew,
+                    message: isNew
+                        ? 'Welcome! New project registered.'
+                        : 'Welcome back! Session #' + project.sessionCount + ' for ' + project.name + '.',
+                    vault: { entries: stats.totalEntries, domains: Object.keys(stats.byDomain) },
+                    governance: {
+                        pendingProposals: proposalStats.pending,
+                        quotaPercent: quotaStatus.maxTotal > 0
+                            ? Math.round((quotaStatus.total / quotaStatus.maxTotal) * 100)
+                            : 0,
+                        isQuotaWarning: quotaStatus.isWarning,
+                        expiredThisSession: expired,
+                    },
+                };
+            },
+        },
+        // ─── Satellite ops ───────────────────────────────────────────
+        ...createOrchestrateOps(runtime),
+        ...createProjectOps(runtime),
+        ...createPlaybookOps(runtime),
+    ];
+}
+//# sourceMappingURL=orchestrate-facade.js.map

package/dist/runtime/facades/orchestrate-facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrate-facade.js","sourceRoot":"","sources":["../../../src/runtime/facades/orchestrate-facade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,UAAU,0BAA0B,CAAC,OAAqB;IAC9D,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAEvD,OAAO;QACL,+DAA+D;QAC/D;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EACT,gGAAgG;YAClG,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;gBAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;aAC5F,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACxB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;gBAC9C,MAAM,WAAW,GAAG,OAAO,CAAE,MAAM,CAAC,WAAsB,IAAI,GAAG,CAAC,CAAC;gBACnE,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC,IAA0B,CAAC,CAAC;gBACtF,4DAA4D;gBAC5D,eAAe,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,IAA0B,CAAC,CAAC;gBACzE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,KAAK,CAAC,CAAC;gBAEzC,4DAA4D;gBAC5D,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;gBACjD,MAAM,OAAO,GAAG,UAAU,CAAC,oBAAoB,CAAC,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;gBAEnF,MAAM,aAAa,GAAG,UAAU,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;gBAC/D,MAAM,WAAW,GAAG,UAAU,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;gBAE3D,OAAO;oBACL,OAAO;oBACP,MAAM,EAAE,KAAK;oBACb,OAAO,EAAE,KAAK;wBACZ,CAAC,CAAC,kCAAkC;wBACpC,CAAC,CAAC,yBAAyB,GAAG,OAAO,CAAC,YAAY,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,GAAG;oBACnF,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE;oBAC5E,UAAU,EAAE;wBACV,gBAAgB,EAAE,aAAa,CAAC,OAAO;wBACvC,YAAY,EACV,WAAW,CAAC,QAAQ,GAAG,CAAC;4BACtB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC;4BAC9D,CAAC,CAAC,CAAC;wBACP,cAAc,EAAE,WAAW,CAAC,SAAS;wBACrC,kBAAkB,EAAE,OAAO;qBAC5B;iBACF,CAAC;YACJ,CAAC;SACF;QAED,gEAAgE;QAChE,GAAG,oBAAoB,CAAC,OAAO,CAAC;QAChC,GAAG,gBAAgB,CAAC,OAAO,CAAC;QAC5B,GAAG,iBAAiB,CAAC,OAAO,CAAC;KAC9B,CAAC;AACJ,CAAC"}

package/dist/runtime/facades/plan-facade.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Plan facade — plan lifecycle ops.
+ * create, approve, execute, reconcile, complete, grading.
+ */
+import type { OpDefinition } from '../../facades/types.js';
+import type { AgentRuntime } from '../types.js';
+export declare function createPlanFacadeOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=plan-facade.d.ts.map

package/dist/runtime/facades/plan-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-facade.d.ts","sourceRoot":"","sources":["../../../src/runtime/facades/plan-facade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CA2GzE"}

package/dist/runtime/facades/plan-facade.js

@@ -0,0 +1,110 @@
+/**
+ * Plan facade — plan lifecycle ops.
+ * create, approve, execute, reconcile, complete, grading.
+ */
+import { z } from 'zod';
+import { createPlanningExtraOps } from '../planning-extra-ops.js';
+import { createGradingOps } from '../grading-ops.js';
+export function createPlanFacadeOps(runtime) {
+    const { planner } = runtime;
+    return [
+        // ─── Planning (inline from core-ops.ts) ─────────────────────
+        {
+            name: 'create_plan',
+            description: 'Create a new plan in draft status. Plans track multi-step tasks with decisions and sub-tasks.',
+            auth: 'write',
+            schema: z.object({
+                objective: z.string().describe('What the plan aims to achieve'),
+                scope: z.string().describe('Which parts of the codebase are affected'),
+                decisions: z.array(z.string()).optional().default([]),
+                tasks: z
+                    .array(z.object({ title: z.string(), description: z.string() }))
+                    .optional()
+                    .default([]),
+            }),
+            handler: async (params) => {
+                const plan = planner.create({
+                    objective: params.objective,
+                    scope: params.scope,
+                    decisions: params.decisions ?? [],
+                    tasks: params.tasks ?? [],
+                });
+                return { created: true, plan };
+            },
+        },
+        {
+            name: 'get_plan',
+            description: 'Get a plan by ID, or list all active plans if no ID provided.',
+            auth: 'read',
+            schema: z.object({
+                planId: z.string().optional().describe('Plan ID. Omit to list all active plans.'),
+            }),
+            handler: async (params) => {
+                if (params.planId) {
+                    const plan = planner.get(params.planId);
+                    if (!plan)
+                        return { error: 'Plan not found: ' + params.planId };
+                    return plan;
+                }
+                return { active: planner.getActive(), executing: planner.getExecuting() };
+            },
+        },
+        {
+            name: 'approve_plan',
+            description: 'Approve a draft plan and optionally start execution.',
+            auth: 'write',
+            schema: z.object({
+                planId: z.string(),
+                startExecution: z
+                    .boolean()
+                    .optional()
+                    .default(false)
+                    .describe('If true, immediately start execution after approval'),
+            }),
+            handler: async (params) => {
+                let plan = planner.approve(params.planId);
+                if (params.startExecution) {
+                    plan = planner.startExecution(plan.id);
+                }
+                return { approved: true, executing: plan.status === 'executing', plan };
+            },
+        },
+        {
+            name: 'update_task',
+            description: 'Update a task status within an executing plan.',
+            auth: 'write',
+            schema: z.object({
+                planId: z.string(),
+                taskId: z.string(),
+                status: z.enum(['pending', 'in_progress', 'completed', 'skipped', 'failed']),
+            }),
+            handler: async (params) => {
+                const plan = planner.updateTask(params.planId, params.taskId, params.status);
+                const task = plan.tasks.find((t) => t.id === params.taskId);
+                return { updated: true, task, plan: { id: plan.id, status: plan.status } };
+            },
+        },
+        {
+            name: 'complete_plan',
+            description: 'Mark an executing plan as completed.',
+            auth: 'write',
+            schema: z.object({
+                planId: z.string(),
+            }),
+            handler: async (params) => {
+                const plan = planner.complete(params.planId);
+                const taskSummary = {
+                    completed: plan.tasks.filter((t) => t.status === 'completed').length,
+                    skipped: plan.tasks.filter((t) => t.status === 'skipped').length,
+                    failed: plan.tasks.filter((t) => t.status === 'failed').length,
+                    total: plan.tasks.length,
+                };
+                return { completed: true, plan, taskSummary };
+            },
+        },
+        // ─── Satellite ops ───────────────────────────────────────────
+        ...createPlanningExtraOps(runtime),
+        ...createGradingOps(runtime),
+    ];
+}
+//# sourceMappingURL=plan-facade.js.map

package/dist/runtime/facades/plan-facade.js.map

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

package/dist/runtime/facades/vault-facade.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Vault facade — knowledge management ops.
+ * search, CRUD, import/export, intake, archival.
+ */
+import type { OpDefinition } from '../../facades/types.js';
+import type { AgentRuntime } from '../types.js';
+export declare function createVaultFacadeOps(runtime: AgentRuntime): OpDefinition[];
+//# sourceMappingURL=vault-facade.d.ts.map

package/dist/runtime/facades/vault-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-facade.d.ts","sourceRoot":"","sources":["../../../src/runtime/facades/vault-facade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAiN1E"}

package/dist/runtime/facades/vault-facade.js

@@ -0,0 +1,194 @@
+/**
+ * Vault facade — knowledge management ops.
+ * search, CRUD, import/export, intake, archival.
+ */
+import { z } from 'zod';
+import { createVaultExtraOps } from '../vault-extra-ops.js';
+import { createCaptureOps } from '../capture-ops.js';
+import { createIntakeOps } from '../intake-ops.js';
+export function createVaultFacadeOps(runtime) {
+    const { vault, brain, cognee, llmClient, syncManager, intakePipeline } = runtime;
+    return [
+        // ─── Search / Vault (inline from core-ops.ts) ───────────────
+        {
+            name: 'search',
+            description: 'Search across all knowledge domains. Results ranked by TF-IDF + severity + recency + tag overlap + domain match.',
+            auth: 'read',
+            schema: z.object({
+                query: z.string(),
+                domain: z.string().optional(),
+                type: z.enum(['pattern', 'anti-pattern', 'rule', 'playbook']).optional(),
+                severity: z.enum(['critical', 'warning', 'suggestion']).optional(),
+                tags: z.array(z.string()).optional(),
+                limit: z.number().optional(),
+            }),
+            handler: async (params) => {
+                return brain.intelligentSearch(params.query, {
+                    domain: params.domain,
+                    type: params.type,
+                    severity: params.severity,
+                    tags: params.tags,
+                    limit: params.limit ?? 10,
+                });
+            },
+        },
+        {
+            name: 'vault_stats',
+            description: 'Get vault statistics — entry counts by type, domain, severity.',
+            auth: 'read',
+            handler: async () => vault.stats(),
+        },
+        {
+            name: 'list_all',
+            description: 'List all knowledge entries with optional filters.',
+            auth: 'read',
+            schema: z.object({
+                domain: z.string().optional(),
+                type: z.enum(['pattern', 'anti-pattern', 'rule', 'playbook']).optional(),
+                severity: z.enum(['critical', 'warning', 'suggestion']).optional(),
+                tags: z.array(z.string()).optional(),
+                limit: z.number().optional(),
+                offset: z.number().optional(),
+            }),
+            handler: async (params) => {
+                return vault.list({
+                    domain: params.domain,
+                    type: params.type,
+                    severity: params.severity,
+                    tags: params.tags,
+                    limit: params.limit ?? 50,
+                    offset: params.offset ?? 0,
+                });
+            },
+        },
+        {
+            name: 'export',
+            description: 'Export vault entries as JSON intelligence bundles — one per domain. Enables version control and sharing.',
+            auth: 'read',
+            schema: z.object({
+                domain: z.string().optional().describe('Export only this domain. Omit to export all.'),
+            }),
+            handler: async (params) => {
+                const stats = vault.stats();
+                const domains = params.domain ? [params.domain] : Object.keys(stats.byDomain);
+                const bundles = [];
+                for (const d of domains) {
+                    const entries = vault.list({ domain: d, limit: 10000 });
+                    bundles.push({ domain: d, version: '1.0.0', entries });
+                }
+                return {
+                    exported: true,
+                    bundles,
+                    totalEntries: bundles.reduce((sum, b) => sum + b.entries.length, 0),
+                    domains: bundles.map((b) => b.domain),
+                };
+            },
+        },
+        // ─── Enriched Capture ────────────────────────────────────────
+        {
+            name: 'capture_enriched',
+            description: 'Unified LLM-enriched capture — accepts minimal fields (title, description, type), uses LLM to auto-infer tags, category, and severity.',
+            auth: 'write',
+            schema: z.object({
+                title: z.string().describe('Knowledge title'),
+                description: z.string().describe('Knowledge description'),
+                type: z
+                    .enum(['pattern', 'anti-pattern', 'rule', 'playbook'])
+                    .optional()
+                    .describe('Entry type. If omitted, LLM infers from content.'),
+                domain: z.string().optional().describe('Domain. If omitted, LLM infers.'),
+                tags: z.array(z.string()).optional().describe('Tags. LLM adds more if needed.'),
+            }),
+            handler: async (params) => {
+                try {
+                    const title = params.title;
+                    const description = params.description;
+                    // Try LLM enrichment for auto-tagging
+                    let inferredTags = params.tags ?? [];
+                    let inferredType = params.type ?? 'pattern';
+                    const inferredDomain = params.domain ?? 'general';
+                    let inferredSeverity = 'suggestion';
+                    const enriched = false;
+                    try {
+                        const captureId = `enriched-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+                        const enrichResult = brain.enrichAndCapture({
+                            id: captureId,
+                            title,
+                            description,
+                            type: inferredType,
+                            domain: inferredDomain,
+                            severity: inferredSeverity,
+                            tags: inferredTags,
+                        });
+                        if (enrichResult.captured) {
+                            return {
+                                captured: true,
+                                enriched: true,
+                                entryId: enrichResult.id,
+                                autoTags: enrichResult.autoTags,
+                                duplicate: enrichResult.duplicate ?? null,
+                            };
+                        }
+                    }
+                    catch {
+                        // LLM enrichment failed — fall back to basic capture
+                    }
+                    // Fallback: basic capture without LLM enrichment
+                    // Infer type from keywords
+                    const lowerDesc = description.toLowerCase();
+                    if (!params.type) {
+                        if (lowerDesc.includes('avoid') ||
+                            lowerDesc.includes("don't") ||
+                            lowerDesc.includes('anti-pattern'))
+                            inferredType = 'anti-pattern';
+                        else if (lowerDesc.includes('rule') ||
+                            lowerDesc.includes('must') ||
+                            lowerDesc.includes('always'))
+                            inferredType = 'rule';
+                    }
+                    // Infer severity from keywords
+                    if (lowerDesc.includes('critical') ||
+                        lowerDesc.includes('security') ||
+                        lowerDesc.includes('breaking'))
+                        inferredSeverity = 'critical';
+                    else if (lowerDesc.includes('warning') ||
+                        lowerDesc.includes('careful') ||
+                        lowerDesc.includes('avoid'))
+                        inferredSeverity = 'warning';
+                    // Auto-generate tags from title words
+                    if (inferredTags.length === 0) {
+                        inferredTags = title
+                            .toLowerCase()
+                            .split(/\s+/)
+                            .filter((w) => w.length > 3 && !['with', 'from', 'that', 'this', 'have', 'been'].includes(w))
+                            .slice(0, 5);
+                    }
+                    const entry = {
+                        id: `enriched-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+                        type: inferredType,
+                        domain: inferredDomain,
+                        title,
+                        severity: inferredSeverity,
+                        description,
+                        tags: inferredTags,
+                    };
+                    vault.add(entry);
+                    return {
+                        captured: true,
+                        enriched,
+                        entry,
+                        autoTags: inferredTags,
+                    };
+                }
+                catch (err) {
+                    return { error: err.message };
+                }
+            },
+        },
+        // ─── Satellite ops ───────────────────────────────────────────
+        ...createVaultExtraOps(runtime),
+        ...createCaptureOps(runtime),
+        ...createIntakeOps(intakePipeline),
+    ];
+}
+//# sourceMappingURL=vault-facade.js.map

package/dist/runtime/facades/vault-facade.js.map

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

package/dist/runtime/grading-ops.d.ts

@@ -1,6 +1,6 @@
 /**
  * Plan grading operations — 5 ops for iterative plan quality scoring.
- * Uses 6-pass gap analysis with severity-weighted scoring (ported from Salvador).
+ * Uses 7-pass gap analysis with severity-weighted scoring + substance bonuses.
  *
  * Ops: plan_grade, plan_check_history, plan_latest_check,
  *      plan_meets_grade, plan_auto_improve.

package/dist/runtime/grading-ops.js

@@ -1,6 +1,6 @@
 /**
  * Plan grading operations — 5 ops for iterative plan quality scoring.
- * Uses 6-pass gap analysis with severity-weighted scoring (ported from Salvador).
+ * Uses 7-pass gap analysis with severity-weighted scoring + substance bonuses.
  *
  * Ops: plan_grade, plan_check_history, plan_latest_check,
  *      plan_meets_grade, plan_auto_improve.
@@ -15,7 +15,7 @@ export function createGradingOps(runtime) {
     return [
         {
             name: 'plan_grade',
-            description: 'Grade a plan using 6-pass gap analysis — severity-weighted scoring (critical=30, major=15, minor=2). Returns grade, score, gaps with recommendations, and iteration number.',
+            description: 'Grade a plan using 7-pass gap analysis — severity-weighted scoring (critical=30, major=15, minor=2) with substance bonuses for vault-informed depth. Returns grade, score, gaps with recommendations, and iteration number.',
             auth: 'read',
             schema: z.object({
                 planId: z.string().describe('The plan ID to grade.'),

package/dist/runtime/grading-ops.js.map

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

package/dist/runtime/vault-extra-ops.d.ts

@@ -1,9 +1,9 @@
 /**
- * Extra vault operations — 23 ops that extend the 4 base vault ops in core-ops.ts.
+ * Extra vault operations — 25 ops that extend the 4 base vault ops in core-ops.ts.
  *
  * Groups: single-entry CRUD (3), bulk (2), discovery (3), import/export (3),
  *         analytics (1), seed canonical (1), knowledge lifecycle (4), temporal (3),
- *         archival (3).
+ *         archival (3), content hashing (2).
  */
 import type { OpDefinition } from '../facades/types.js';
 import type { AgentRuntime } from './types.js';

package/dist/runtime/vault-extra-ops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vault-extra-ops.d.ts","sourceRoot":"","sources":["../../src/runtime/vault-extra-ops.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiB/C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CA+iBzE"}
+{"version":3,"file":"vault-extra-ops.d.ts","sourceRoot":"","sources":["../../src/runtime/vault-extra-ops.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiB/C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAmlBzE"}

package/dist/runtime/vault-extra-ops.js

@@ -1,9 +1,9 @@
 /**
- * Extra vault operations — 23 ops that extend the 4 base vault ops in core-ops.ts.
+ * Extra vault operations — 25 ops that extend the 4 base vault ops in core-ops.ts.
  *
  * Groups: single-entry CRUD (3), bulk (2), discovery (3), import/export (3),
  *         analytics (1), seed canonical (1), knowledge lifecycle (4), temporal (3),
- *         archival (3).
+ *         archival (3), content hashing (2).
  */
 import { z } from 'zod';
 import { readFileSync, readdirSync, existsSync } from 'node:fs';
@@ -522,6 +522,41 @@ export function createVaultExtraOps(runtime) {
                 return vault.optimize();
             },
         },
+        // ── Content hashing (#166) ────────────────────────────────────────
+        {
+            name: 'vault_content_hash',
+            description: 'Compute content hash for an entry without inserting',
+            auth: 'read',
+            schema: z.object({
+                type: z.string(),
+                domain: z.string(),
+                title: z.string(),
+                description: z.string(),
+                tags: z.array(z.string()).optional(),
+                example: z.string().optional(),
+                counterExample: z.string().optional(),
+            }),
+            handler: async (params) => {
+                const { computeContentHash: hashFn } = await import('../vault/content-hash.js');
+                const hash = hashFn(params);
+                const existingId = vault.findByContentHash(hash);
+                return { hash, duplicate: existingId !== null, existingId };
+            },
+        },
+        {
+            name: 'vault_dedup_status',
+            description: 'Report content hash coverage and duplicate statistics',
+            auth: 'read',
+            handler: async () => {
+                const stats = vault.contentHashStats();
+                const duplicates = stats.total - stats.uniqueHashes;
+                return {
+                    ...stats,
+                    duplicates,
+                    coverage: stats.total > 0 ? Math.round((stats.hashed / stats.total) * 100) : 100,
+                };
+            },
+        },
     ];
 }
 /**