@claude-flow/cli 3.53.0 → 3.54.0

package/dist/src/memory/memory-bridge.js

@@ -17,6 +17,7 @@
  * @module v3/cli/memory-bridge
  */
 import { liveMemoryRowSql } from './live-memory-row.js';
+import { encodeEmbeddingQ8, MAX_LIST_EMBEDDINGS } from './embedding-q8.js';
 import * as path from 'path';
 import * as crypto from 'crypto';
 import { realpathSync } from 'node:fs';
@@ -1430,7 +1431,7 @@ export async function bridgeListEntries(options) {
         ORDER BY updated_at DESC
         LIMIT ? OFFSET ?
       `);
-            const rows = stmt.all(...filterParams, limit, offset);
+            const rows = stmt.all(...filterParams, options.includeEmbedding ? Math.min(limit, MAX_LIST_EMBEDDINGS) : limit, offset);
             for (const row of rows) {
                 const entry = {
                     // #2073: don't truncate id when content is requested — callers
@@ -1448,6 +1449,11 @@ export async function bridgeListEntries(options) {
                 if (options.includeContent) {
                     entry.content = row.content || '';
                 }
+                if (options.includeEmbedding) {
+                    const q8 = encodeEmbeddingQ8(row.embedding);
+                    if (q8)
+                        entry.embeddingQ8 = q8;
+                }
                 entries.push(entry);
             }
         }

package/dist/src/memory/memory-initializer.d.ts

@@ -8,6 +8,7 @@
  *
  * @module v3/cli/memory-initializer
  */
+import { type EmbeddingQ8 } from './embedding-q8.js';
 /**
  * ADR-323 — typed memory provenance. Distinguishes WHO/WHAT wrote a memory
  * entry (a user's stated claim vs an agent's own output vs a tool result vs
@@ -504,6 +505,8 @@ export declare function listEntries(options: {
     includeContent?: boolean;
     /** ADR-323: restrict rows to these provenance types. */
     provenanceFilter?: string[];
+    /** ADR-472: include each entry's embedding as int8+scale (`embeddingQ8`); at most MAX_LIST_EMBEDDINGS rows. Read-only. */
+    includeEmbedding?: boolean;
 }): Promise<{
     success: boolean;
     entries: {
@@ -518,6 +521,8 @@ export declare function listEntries(options: {
         /** #2073: Present when `includeContent: true` was requested. */
         content?: string;
         provenanceType?: string;
+        /** ADR-472: present when `includeEmbedding: true` and the row has a valid stored vector. */
+        embeddingQ8?: EmbeddingQ8;
     }[];
     total: number;
     error?: string;

package/dist/src/memory/memory-initializer.js

@@ -9,6 +9,7 @@
  * @module v3/cli/memory-initializer
  */
 import { liveMemoryRowSql } from './live-memory-row.js';
+import { encodeEmbeddingQ8, MAX_LIST_EMBEDDINGS } from './embedding-q8.js';
 import * as fs from 'fs';
 import * as path from 'path';
 import { AsyncLocalStorage } from 'node:async_hooks';
@@ -3018,7 +3019,7 @@ export async function listEntries(options) {
         const countResult = countRows.length > 0 ? [{ values: countRows }] : [];
         const total = countResult[0]?.values?.[0]?.[0] || 0;
         // Get entries
-        const safeLimit = parseInt(String(limit), 10) || 100;
+        const safeLimit = Math.min(parseInt(String(limit), 10) || 100, options.includeEmbedding ? MAX_LIST_EMBEDDINGS : Number.MAX_SAFE_INTEGER);
         const safeOffset = parseInt(String(offset), 10) || 0;
         // #2120 — same NULL-as-active acceptance as the count above.
         const listStmt = db.prepare(`SELECT id, key, namespace, content, embedding, access_count, created_at, updated_at, provenance_type
@@ -3051,6 +3052,11 @@ export async function listEntries(options) {
                 if (options.includeContent) {
                     entry.content = content || '';
                 }
+                if (options.includeEmbedding) {
+                    const q8 = encodeEmbeddingQ8(embedding);
+                    if (q8)
+                        entry.embeddingQ8 = q8;
+                }
                 entries.push(entry);
             }
         }

package/dist/src/missions/schemas.d.ts

@@ -73,56 +73,56 @@ export declare const missionRecordSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    objective: string;
+    createdAt: string;
+    updatedAt: string;
     schemaVersion: 1;
-    missionId: string;
-    tenantId: string;
-    workspaceId: string;
-    ownerPrincipalId: string;
-    revision: number;
+    state: "completed" | "cancelled" | "failed" | "blocked" | "running" | "paused" | "queued" | "draft" | "planned" | "awaitingAuthorization" | "pauseRequested" | "verifying" | "cancelRequested";
     plan: {
         revision: number;
         digest: string;
         taskGraphRef: string;
     };
+    objective: string;
+    missionId: string;
+    tenantId: string;
+    workspaceId: string;
+    ownerPrincipalId: string;
+    revision: number;
     policyRef: string;
     budgetRef: string;
     executionMode: "durable-executor" | "session-bound";
-    state: "draft" | "planned" | "awaitingAuthorization" | "queued" | "running" | "pauseRequested" | "paused" | "blocked" | "verifying" | "completed" | "failed" | "cancelRequested" | "cancelled";
     evidenceRefs: string[];
     acceptance: {
         revision: number;
         criteriaDigest: string;
     };
     lastEventSequence: number;
-    createdAt: string;
-    updatedAt: string;
     authorizationRef?: string | undefined;
 }, {
-    objective: string;
+    createdAt: string;
+    updatedAt: string;
     schemaVersion: 1;
-    missionId: string;
-    tenantId: string;
-    workspaceId: string;
-    ownerPrincipalId: string;
-    revision: number;
+    state: "completed" | "cancelled" | "failed" | "blocked" | "running" | "paused" | "queued" | "draft" | "planned" | "awaitingAuthorization" | "pauseRequested" | "verifying" | "cancelRequested";
     plan: {
         revision: number;
         digest: string;
         taskGraphRef: string;
     };
+    objective: string;
+    missionId: string;
+    tenantId: string;
+    workspaceId: string;
+    ownerPrincipalId: string;
+    revision: number;
     policyRef: string;
     budgetRef: string;
     executionMode: "durable-executor" | "session-bound";
-    state: "draft" | "planned" | "awaitingAuthorization" | "queued" | "running" | "pauseRequested" | "paused" | "blocked" | "verifying" | "completed" | "failed" | "cancelRequested" | "cancelled";
     evidenceRefs: string[];
     acceptance: {
         revision: number;
         criteriaDigest: string;
     };
     lastEventSequence: number;
-    createdAt: string;
-    updatedAt: string;
     authorizationRef?: string | undefined;
 }>;
 export type MissionRecord = z.infer<typeof missionRecordSchema>;
@@ -145,8 +145,8 @@ export declare const taskSpecSchema: z.ZodObject<{
     checkpoint: z.ZodOptional<z.ZodString>;
     acceptanceEvidence: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
 }, "strict", z.ZodTypeAny, {
-    title: string;
     id: string;
+    title: string;
     dependsOn: string[];
     executor: {
         mode: "durable-executor" | "session-bound";
@@ -157,16 +157,16 @@ export declare const taskSpecSchema: z.ZodObject<{
     acceptanceEvidence: string[];
     checkpoint?: string | undefined;
 }, {
-    title: string;
     id: string;
+    title: string;
     executor: {
         mode: "durable-executor" | "session-bound";
         requirement: string;
     };
+    checkpoint?: string | undefined;
     dependsOn?: string[] | undefined;
     capabilityCeiling?: string[] | undefined;
     estimatedCostMinor?: number | undefined;
-    checkpoint?: string | undefined;
     acceptanceEvidence?: string[] | undefined;
 }>;
 export declare const acceptanceCriterionSchema: z.ZodObject<{
@@ -185,15 +185,15 @@ export declare const acceptanceCriterionSchema: z.ZodObject<{
     producer: string;
     independent: boolean;
     mandatory: boolean;
-    baseline?: string | undefined;
     threshold?: string | undefined;
+    baseline?: string | undefined;
 }, {
     id: string;
     check: string;
     producer: string;
-    inputs?: string[] | undefined;
-    baseline?: string | undefined;
     threshold?: string | undefined;
+    baseline?: string | undefined;
+    inputs?: string[] | undefined;
     independent?: boolean | undefined;
     mandatory?: boolean | undefined;
 }>;
@@ -207,16 +207,16 @@ export declare const budgetSpecSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     currency: string;
     ceilingMinor: number;
+    concurrency?: number | undefined;
     tokens?: number | undefined;
     wallTimeSeconds?: number | undefined;
-    concurrency?: number | undefined;
     retries?: number | undefined;
 }, {
     currency: string;
     ceilingMinor: number;
+    concurrency?: number | undefined;
     tokens?: number | undefined;
     wallTimeSeconds?: number | undefined;
-    concurrency?: number | undefined;
     retries?: number | undefined;
 }>;
 export declare const planBodySchema: z.ZodObject<{
@@ -239,8 +239,8 @@ export declare const planBodySchema: z.ZodObject<{
         checkpoint: z.ZodOptional<z.ZodString>;
         acceptanceEvidence: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     }, "strict", z.ZodTypeAny, {
-        title: string;
         id: string;
+        title: string;
         dependsOn: string[];
         executor: {
             mode: "durable-executor" | "session-bound";
@@ -251,16 +251,16 @@ export declare const planBodySchema: z.ZodObject<{
         acceptanceEvidence: string[];
         checkpoint?: string | undefined;
     }, {
-        title: string;
         id: string;
+        title: string;
         executor: {
             mode: "durable-executor" | "session-bound";
             requirement: string;
         };
+        checkpoint?: string | undefined;
         dependsOn?: string[] | undefined;
         capabilityCeiling?: string[] | undefined;
         estimatedCostMinor?: number | undefined;
-        checkpoint?: string | undefined;
         acceptanceEvidence?: string[] | undefined;
     }>, "many">;
     acceptance: z.ZodArray<z.ZodObject<{
@@ -279,15 +279,15 @@ export declare const planBodySchema: z.ZodObject<{
         producer: string;
         independent: boolean;
         mandatory: boolean;
-        baseline?: string | undefined;
         threshold?: string | undefined;
+        baseline?: string | undefined;
     }, {
         id: string;
         check: string;
         producer: string;
-        inputs?: string[] | undefined;
-        baseline?: string | undefined;
         threshold?: string | undefined;
+        baseline?: string | undefined;
+        inputs?: string[] | undefined;
         independent?: boolean | undefined;
         mandatory?: boolean | undefined;
     }>, "many">;
@@ -301,16 +301,16 @@ export declare const planBodySchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         currency: string;
         ceilingMinor: number;
+        concurrency?: number | undefined;
         tokens?: number | undefined;
         wallTimeSeconds?: number | undefined;
-        concurrency?: number | undefined;
         retries?: number | undefined;
     }, {
         currency: string;
         ceilingMinor: number;
+        concurrency?: number | undefined;
         tokens?: number | undefined;
         wallTimeSeconds?: number | undefined;
-        concurrency?: number | undefined;
         retries?: number | undefined;
     }>;
     scope: z.ZodDefault<z.ZodObject<{
@@ -322,8 +322,8 @@ export declare const planBodySchema: z.ZodObject<{
     }>>;
 }, "strict", z.ZodTypeAny, {
     tasks: {
-        title: string;
         id: string;
+        title: string;
         dependsOn: string[];
         executor: {
             mode: "durable-executor" | "session-bound";
@@ -334,6 +334,17 @@ export declare const planBodySchema: z.ZodObject<{
         acceptanceEvidence: string[];
         checkpoint?: string | undefined;
     }[];
+    scope: {
+        capabilities: string[];
+    };
+    budget: {
+        currency: string;
+        ceilingMinor: number;
+        concurrency?: number | undefined;
+        tokens?: number | undefined;
+        wallTimeSeconds?: number | undefined;
+        retries?: number | undefined;
+    };
     acceptance: {
         id: string;
         check: string;
@@ -341,52 +352,41 @@ export declare const planBodySchema: z.ZodObject<{
         producer: string;
         independent: boolean;
         mandatory: boolean;
-        baseline?: string | undefined;
         threshold?: string | undefined;
+        baseline?: string | undefined;
     }[];
-    budget: {
-        currency: string;
-        ceilingMinor: number;
-        tokens?: number | undefined;
-        wallTimeSeconds?: number | undefined;
-        concurrency?: number | undefined;
-        retries?: number | undefined;
-    };
-    scope: {
-        capabilities: string[];
-    };
 }, {
     tasks: {
-        title: string;
         id: string;
+        title: string;
         executor: {
             mode: "durable-executor" | "session-bound";
             requirement: string;
         };
+        checkpoint?: string | undefined;
         dependsOn?: string[] | undefined;
         capabilityCeiling?: string[] | undefined;
         estimatedCostMinor?: number | undefined;
-        checkpoint?: string | undefined;
         acceptanceEvidence?: string[] | undefined;
     }[];
+    budget: {
+        currency: string;
+        ceilingMinor: number;
+        concurrency?: number | undefined;
+        tokens?: number | undefined;
+        wallTimeSeconds?: number | undefined;
+        retries?: number | undefined;
+    };
     acceptance: {
         id: string;
         check: string;
         producer: string;
-        inputs?: string[] | undefined;
-        baseline?: string | undefined;
         threshold?: string | undefined;
+        baseline?: string | undefined;
+        inputs?: string[] | undefined;
         independent?: boolean | undefined;
         mandatory?: boolean | undefined;
     }[];
-    budget: {
-        currency: string;
-        ceilingMinor: number;
-        tokens?: number | undefined;
-        wallTimeSeconds?: number | undefined;
-        concurrency?: number | undefined;
-        retries?: number | undefined;
-    };
     scope?: {
         capabilities?: string[] | undefined;
     } | undefined;
@@ -427,8 +427,8 @@ export declare const planInputSchema: z.ZodObject<{
             checkpoint: z.ZodOptional<z.ZodString>;
             acceptanceEvidence: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         }, "strict", z.ZodTypeAny, {
-            title: string;
             id: string;
+            title: string;
             dependsOn: string[];
             executor: {
                 mode: "durable-executor" | "session-bound";
@@ -439,16 +439,16 @@ export declare const planInputSchema: z.ZodObject<{
             acceptanceEvidence: string[];
             checkpoint?: string | undefined;
         }, {
-            title: string;
             id: string;
+            title: string;
             executor: {
                 mode: "durable-executor" | "session-bound";
                 requirement: string;
             };
+            checkpoint?: string | undefined;
             dependsOn?: string[] | undefined;
             capabilityCeiling?: string[] | undefined;
             estimatedCostMinor?: number | undefined;
-            checkpoint?: string | undefined;
             acceptanceEvidence?: string[] | undefined;
         }>, "many">;
         acceptance: z.ZodArray<z.ZodObject<{
@@ -467,15 +467,15 @@ export declare const planInputSchema: z.ZodObject<{
             producer: string;
             independent: boolean;
             mandatory: boolean;
-            baseline?: string | undefined;
             threshold?: string | undefined;
+            baseline?: string | undefined;
         }, {
             id: string;
             check: string;
             producer: string;
-            inputs?: string[] | undefined;
-            baseline?: string | undefined;
             threshold?: string | undefined;
+            baseline?: string | undefined;
+            inputs?: string[] | undefined;
             independent?: boolean | undefined;
             mandatory?: boolean | undefined;
         }>, "many">;
@@ -489,16 +489,16 @@ export declare const planInputSchema: z.ZodObject<{
         }, "strict", z.ZodTypeAny, {
             currency: string;
             ceilingMinor: number;
+            concurrency?: number | undefined;
             tokens?: number | undefined;
             wallTimeSeconds?: number | undefined;
-            concurrency?: number | undefined;
             retries?: number | undefined;
         }, {
             currency: string;
             ceilingMinor: number;
+            concurrency?: number | undefined;
             tokens?: number | undefined;
             wallTimeSeconds?: number | undefined;
-            concurrency?: number | undefined;
             retries?: number | undefined;
         }>;
         scope: z.ZodDefault<z.ZodObject<{
@@ -510,8 +510,8 @@ export declare const planInputSchema: z.ZodObject<{
         }>>;
     }, "strict", z.ZodTypeAny, {
         tasks: {
-            title: string;
             id: string;
+            title: string;
             dependsOn: string[];
             executor: {
                 mode: "durable-executor" | "session-bound";
@@ -522,6 +522,17 @@ export declare const planInputSchema: z.ZodObject<{
             acceptanceEvidence: string[];
             checkpoint?: string | undefined;
         }[];
+        scope: {
+            capabilities: string[];
+        };
+        budget: {
+            currency: string;
+            ceilingMinor: number;
+            concurrency?: number | undefined;
+            tokens?: number | undefined;
+            wallTimeSeconds?: number | undefined;
+            retries?: number | undefined;
+        };
         acceptance: {
             id: string;
             check: string;
@@ -529,63 +540,50 @@ export declare const planInputSchema: z.ZodObject<{
             producer: string;
             independent: boolean;
             mandatory: boolean;
-            baseline?: string | undefined;
             threshold?: string | undefined;
+            baseline?: string | undefined;
         }[];
-        budget: {
-            currency: string;
-            ceilingMinor: number;
-            tokens?: number | undefined;
-            wallTimeSeconds?: number | undefined;
-            concurrency?: number | undefined;
-            retries?: number | undefined;
-        };
-        scope: {
-            capabilities: string[];
-        };
     }, {
         tasks: {
-            title: string;
             id: string;
+            title: string;
             executor: {
                 mode: "durable-executor" | "session-bound";
                 requirement: string;
             };
+            checkpoint?: string | undefined;
             dependsOn?: string[] | undefined;
             capabilityCeiling?: string[] | undefined;
             estimatedCostMinor?: number | undefined;
-            checkpoint?: string | undefined;
             acceptanceEvidence?: string[] | undefined;
         }[];
+        budget: {
+            currency: string;
+            ceilingMinor: number;
+            concurrency?: number | undefined;
+            tokens?: number | undefined;
+            wallTimeSeconds?: number | undefined;
+            retries?: number | undefined;
+        };
         acceptance: {
             id: string;
             check: string;
             producer: string;
-            inputs?: string[] | undefined;
-            baseline?: string | undefined;
             threshold?: string | undefined;
+            baseline?: string | undefined;
+            inputs?: string[] | undefined;
             independent?: boolean | undefined;
             mandatory?: boolean | undefined;
         }[];
-        budget: {
-            currency: string;
-            ceilingMinor: number;
-            tokens?: number | undefined;
-            wallTimeSeconds?: number | undefined;
-            concurrency?: number | undefined;
-            retries?: number | undefined;
-        };
         scope?: {
             capabilities?: string[] | undefined;
         } | undefined;
     }>;
 }, "strict", z.ZodTypeAny, {
-    requestId: string;
-    missionId: string;
     plan: {
         tasks: {
-            title: string;
             id: string;
+            title: string;
             dependsOn: string[];
             executor: {
                 mode: "durable-executor" | "session-bound";
@@ -596,6 +594,17 @@ export declare const planInputSchema: z.ZodObject<{
             acceptanceEvidence: string[];
             checkpoint?: string | undefined;
         }[];
+        scope: {
+            capabilities: string[];
+        };
+        budget: {
+            currency: string;
+            ceilingMinor: number;
+            concurrency?: number | undefined;
+            tokens?: number | undefined;
+            wallTimeSeconds?: number | undefined;
+            retries?: number | undefined;
+        };
         acceptance: {
             id: string;
             check: string;
@@ -603,61 +612,52 @@ export declare const planInputSchema: z.ZodObject<{
             producer: string;
             independent: boolean;
             mandatory: boolean;
-            baseline?: string | undefined;
             threshold?: string | undefined;
+            baseline?: string | undefined;
         }[];
-        budget: {
-            currency: string;
-            ceilingMinor: number;
-            tokens?: number | undefined;
-            wallTimeSeconds?: number | undefined;
-            concurrency?: number | undefined;
-            retries?: number | undefined;
-        };
-        scope: {
-            capabilities: string[];
-        };
     };
-    expectedRevision: number;
-}, {
     requestId: string;
     missionId: string;
+    expectedRevision: number;
+}, {
     plan: {
         tasks: {
-            title: string;
             id: string;
+            title: string;
             executor: {
                 mode: "durable-executor" | "session-bound";
                 requirement: string;
             };
+            checkpoint?: string | undefined;
             dependsOn?: string[] | undefined;
             capabilityCeiling?: string[] | undefined;
             estimatedCostMinor?: number | undefined;
-            checkpoint?: string | undefined;
             acceptanceEvidence?: string[] | undefined;
         }[];
+        budget: {
+            currency: string;
+            ceilingMinor: number;
+            concurrency?: number | undefined;
+            tokens?: number | undefined;
+            wallTimeSeconds?: number | undefined;
+            retries?: number | undefined;
+        };
         acceptance: {
             id: string;
             check: string;
             producer: string;
-            inputs?: string[] | undefined;
-            baseline?: string | undefined;
             threshold?: string | undefined;
+            baseline?: string | undefined;
+            inputs?: string[] | undefined;
             independent?: boolean | undefined;
             mandatory?: boolean | undefined;
         }[];
-        budget: {
-            currency: string;
-            ceilingMinor: number;
-            tokens?: number | undefined;
-            wallTimeSeconds?: number | undefined;
-            concurrency?: number | undefined;
-            retries?: number | undefined;
-        };
         scope?: {
             capabilities?: string[] | undefined;
         } | undefined;
     };
+    requestId: string;
+    missionId: string;
     expectedRevision: number;
 }>;
 export declare const getInputSchema: z.ZodObject<{
@@ -672,13 +672,13 @@ export declare const eventsInputSchema: z.ZodObject<{
     afterSequence: z.ZodDefault<z.ZodNumber>;
     limit: z.ZodDefault<z.ZodNumber>;
 }, "strict", z.ZodTypeAny, {
+    limit: number;
     missionId: string;
     afterSequence: number;
-    limit: number;
 }, {
     missionId: string;
-    afterSequence?: number | undefined;
     limit?: number | undefined;
+    afterSequence?: number | undefined;
 }>;
 export declare const requestActionInputSchema: z.ZodObject<{
     requestId: z.ZodString;
@@ -687,16 +687,16 @@ export declare const requestActionInputSchema: z.ZodObject<{
     action: z.ZodEnum<["pause", "resume", "cancel", "requestAuthorization", "admit"]>;
     reason: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
+    action: "pause" | "resume" | "cancel" | "requestAuthorization" | "admit";
     requestId: string;
     missionId: string;
     expectedRevision: number;
-    action: "pause" | "resume" | "cancel" | "requestAuthorization" | "admit";
     reason?: string | undefined;
 }, {
+    action: "pause" | "resume" | "cancel" | "requestAuthorization" | "admit";
     requestId: string;
     missionId: string;
     expectedRevision: number;
-    action: "pause" | "resume" | "cancel" | "requestAuthorization" | "admit";
     reason?: string | undefined;
 }>;
 export type CreateInput = z.infer<typeof createInputSchema>;