@pellux/goodvibes-sdk 0.37.2 → 1.0.0

package/dist/platform/state/knowledge-injection.d.ts

@@ -18,6 +18,29 @@ type KnowledgeRegistrySource = {
     getAll(): readonly MemoryRecord[];
     searchSemantic?(input: Parameters<MemoryRegistry['searchSemantic']>[0]): readonly MemorySemanticSearchResult[];
 };
+/**
+ * One scored candidate from the ranking pipeline: the fully-built
+ * `KnowledgeInjection` plus the numeric score that placed it, before any
+ * `limit` slice is applied. Exists so callers other than the spawn-time
+ * baseline (e.g. per-turn retrieval in turn-knowledge-injection.ts) can
+ * apply their own relevance floor / budget trim over the SAME ranked list
+ * without re-implementing scoreKnowledge/determineReason/determineIngestMode.
+ */
+export interface ScoredKnowledgeInjection {
+    readonly injection: KnowledgeInjection;
+    readonly score: number;
+}
+/**
+ * Full ranking pipeline, unsliced: scores every registry record that clears
+ * the confidence>=55 gate against `task`/`writeScope`, folds in semantic
+ * similarity when the registry supports it, and returns every candidate with
+ * score>0 sorted best-first. `limit` only widens the semantic-search
+ * candidate pool (`Math.max(limit*4,12)`, mirroring the historical
+ * behavior) — it does NOT slice the returned array. Callers that want the
+ * spawn-time top-N behavior should slice the result themselves; see
+ * `selectKnowledgeForTask` below.
+ */
+export declare function selectKnowledgeForTaskScored(registry: KnowledgeRegistrySource, task: string, writeScope?: readonly string[], limit?: number): ScoredKnowledgeInjection[];
 export declare function selectKnowledgeForTask(registry: KnowledgeRegistrySource, task: string, writeScope?: readonly string[], limit?: number): KnowledgeInjection[];
 export declare function buildKnowledgeInjectionPrompt(injections: readonly KnowledgeInjectionPromptInput[]): string | null;
 export {};

package/dist/platform/state/knowledge-injection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-injection.d.ts","sourceRoot":"","sources":["../../../src/platform/state/knowledge-injection.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,0BAA0B,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;IACtE,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;IAChD,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;CACnD;AAED,KAAK,6BAA6B,GAC9B,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,CAAC,GAC5F,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC;AAEzG,KAAK,uBAAuB,GAAG;IAC7B,MAAM,IAAI,SAAS,YAAY,EAAE,CAAC;IAClC,cAAc,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,0BAA0B,EAAE,CAAC;CAChH,CAAC;AA4FF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,uBAAuB,EACjC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,SAAS,MAAM,EAAO,EAClC,KAAK,SAAI,GACR,kBAAkB,EAAE,CAgDtB;AAgBD,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,SAAS,6BAA6B,EAAE,GAAG,MAAM,GAAG,IAAI,CAgBjH"}
+{"version":3,"file":"knowledge-injection.d.ts","sourceRoot":"","sources":["../../../src/platform/state/knowledge-injection.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,0BAA0B,EAC3B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,CAAC;IACtE,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;IAChD,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;CACnD;AAED,KAAK,6BAA6B,GAC9B,IAAI,CAAC,kBAAkB,EAAE,IAAI,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,CAAC,GAC5F,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC;AAEzG,KAAK,uBAAuB,GAAG;IAC7B,MAAM,IAAI,SAAS,YAAY,EAAE,CAAC;IAClC,cAAc,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,0BAA0B,EAAE,CAAC;CAChH,CAAC;AA4FF;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,uBAAuB,EACjC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,SAAS,MAAM,EAAO,EAClC,KAAK,SAAI,GACR,wBAAwB,EAAE,CA+C5B;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,uBAAuB,EACjC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,SAAS,MAAM,EAAO,EAClC,KAAK,SAAI,GACR,kBAAkB,EAAE,CAItB;AAgBD,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,SAAS,6BAA6B,EAAE,GAAG,MAAM,GAAG,IAAI,CAgBjH"}

package/dist/platform/state/knowledge-injection.js

@@ -69,7 +69,17 @@ function scoreKnowledge(record, taskTokens, scopeTokens) {
     }
     return score;
 }
-export function selectKnowledgeForTask(registry, task, writeScope = [], limit = 3) {
+/**
+ * Full ranking pipeline, unsliced: scores every registry record that clears
+ * the confidence>=55 gate against `task`/`writeScope`, folds in semantic
+ * similarity when the registry supports it, and returns every candidate with
+ * score>0 sorted best-first. `limit` only widens the semantic-search
+ * candidate pool (`Math.max(limit*4,12)`, mirroring the historical
+ * behavior) — it does NOT slice the returned array. Callers that want the
+ * spawn-time top-N behavior should slice the result themselves; see
+ * `selectKnowledgeForTask` below.
+ */
+export function selectKnowledgeForTaskScored(registry, task, writeScope = [], limit = 3) {
     const taskTokens = tokenize(task);
     const scopeTokens = writeScope.flatMap((entry) => tokenize(entry));
     const semanticResults = registry.searchSemantic?.({
@@ -85,7 +95,7 @@ export function selectKnowledgeForTask(registry, task, writeScope = [], limit =
     for (const entry of semanticResults) {
         recordsById.set(entry.record.id, entry.record);
     }
-    const records = [...recordsById.values()]
+    return [...recordsById.values()]
         .filter((record) => record.confidence >= 55)
         .map((record) => {
         const semantic = semanticById.get(record.id);
@@ -96,26 +106,31 @@ export function selectKnowledgeForTask(registry, task, writeScope = [], limit =
     })
         .filter((entry) => entry.score > 0)
         .sort((a, b) => b.score - a.score || b.record.updatedAt - a.record.updatedAt)
-        .map((entry) => entry.record);
-    return records
-        .slice(0, limit)
-        .map((record) => ({
-        id: record.id,
-        cls: record.cls,
-        summary: record.summary,
-        reason: determineReason(record, taskTokens, scopeTokens, semanticById.get(record.id)?.similarity),
-        confidence: record.confidence,
-        reviewState: record.reviewState,
-        trustTier: inferKnowledgeInjectionTrustTier(record.reviewState),
-        useAs: 'reference-material',
-        retention: 'task-only',
-        provenance: {
-            source: 'project-memory',
-            links: record.provenance,
+        .map(({ record, score }) => ({
+        score,
+        injection: {
+            id: record.id,
+            cls: record.cls,
+            summary: record.summary,
+            reason: determineReason(record, taskTokens, scopeTokens, semanticById.get(record.id)?.similarity),
+            confidence: record.confidence,
+            reviewState: record.reviewState,
+            trustTier: inferKnowledgeInjectionTrustTier(record.reviewState),
+            useAs: 'reference-material',
+            retention: 'task-only',
+            provenance: {
+                source: 'project-memory',
+                links: record.provenance,
+            },
+            ingestMode: determineIngestMode(record, taskTokens, scopeTokens, semanticById.get(record.id)?.similarity),
         },
-        ingestMode: determineIngestMode(record, taskTokens, scopeTokens, semanticById.get(record.id)?.similarity),
     }));
 }
+export function selectKnowledgeForTask(registry, task, writeScope = [], limit = 3) {
+    return selectKnowledgeForTaskScored(registry, task, writeScope, limit)
+        .map((entry) => entry.injection)
+        .slice(0, limit);
+}
 function normalizeKnowledgeInjectionPromptInput(injection) {
     return {
         ...injection,

package/dist/platform/state/memory-recall-contract.d.ts

@@ -0,0 +1,63 @@
+/**
+ * memory-recall-contract.ts — the CROSS-SURFACE recall-honesty contract (Wave-6 E6).
+ *
+ * PROVENANCE. This is the agent's Wave-4 W4-A1 memory-honesty discipline, promoted
+ * verbatim from a single surface (the agent's memory-prompt.ts) into the SDK so it
+ * is ONE shared contract, not a discipline re-derived (and re-weakened) per surface.
+ * Under E6 the store is unified and cross-surface, which multiplies the cost of a
+ * dishonest recall — so this discipline becomes MORE load-bearing, not less. A
+ * unified store must not be able to lie more loudly than the siloed one did.
+ *
+ * The contract is three rules:
+ *   1. INJECTION FLOOR = the store's own declared baseline trust (60), never higher.
+ *      MemoryStore.add() stamps every new record at confidence 60 unless the caller
+ *      says otherwise. A floor above 60 would starve every honestly-stored fact — a
+ *      freshly-learned fact could never clear recall on its own. The floor trusts a
+ *      record exactly as much as the store already vouches for it; anything stored
+ *      BELOW 60 (explicitly marked less certain) still does not qualify.
+ *   2. FLAGGED RECORDS ARE NEVER INJECTED. stale/contradicted records are excluded
+ *      outright, regardless of confidence — the surface already knows they are wrong
+ *      or superseded, so no confidence number buys them back into a prompt.
+ *   3. DEGRADED STATES ARE HONEST, NOT SILENT. an unavailable semantic index yields
+ *      a STATED reason and a literal fallback — never a silent empty result that
+ *      reads as "nothing was ever stored." 'no match' and 'index unavailable' are
+ *      distinct and both said out loud.
+ */
+import type { MemoryRecord } from './memory-store.js';
+import type { MemoryVectorStats } from './memory-vector-store.js';
+/**
+ * Recall-prompt confidence floor. Tied to the store's own baseline: MemoryStore.add
+ * stamps new records at confidence 60. This is NOT a number chosen to make things
+ * pass — it is the store's own definition of "a real, usable fact."
+ */
+export declare const MIN_PROMPT_MEMORY_CONFIDENCE = 60;
+export interface MemoryPromptEligibility {
+    readonly eligible: boolean;
+    /** Why this record did or did not clear the recall floor — confidence, review state, and provenance, never silent. */
+    readonly reason: string;
+}
+/**
+ * Recall-eligibility decision for one record, with an honest human-readable reason
+ * attached (never a silent yes/no). This is the receipt every surface surfaces.
+ *
+ * Flagged records (stale/contradicted) are excluded outright regardless of
+ * confidence. Everything else is judged on its own stored confidence against
+ * MIN_PROMPT_MEMORY_CONFIDENCE — the store's own baseline. Nothing is blanket-boosted.
+ */
+export declare function describeMemoryPromptEligibility(record: MemoryRecord): MemoryPromptEligibility;
+export declare function isPromptActiveMemory(record: MemoryRecord): boolean;
+/**
+ * A HARD unavailable reason: the semantic index cannot be consulted at all, so a
+ * search must fall back to a literal scan and SAY SO — never a silent empty result
+ * that reads as "no memory matches" when the index was never asked. Returns null
+ * when the index is available and can be consulted.
+ */
+export declare function describeMemoryIndexUnavailable(stats: MemoryVectorStats): string | null;
+/**
+ * A SOFT caveat: the index is up and consulted, but running on the built-in
+ * hashed-only fallback embedding provider rather than a modeled semantic provider.
+ * Still ranks real matches better than a literal scan, but say so rather than
+ * presenting it as equivalent. Returns null when a real provider is configured.
+ */
+export declare function describeMemoryIndexCaveat(stats: MemoryVectorStats): string | null;
+//# sourceMappingURL=memory-recall-contract.d.ts.map

package/dist/platform/state/memory-recall-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-recall-contract.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-recall-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,sHAAsH;IACtH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAOD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,YAAY,GAAG,uBAAuB,CAkB7F;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAKtF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAKjF"}

package/dist/platform/state/memory-recall-contract.js

@@ -0,0 +1,94 @@
+/**
+ * memory-recall-contract.ts — the CROSS-SURFACE recall-honesty contract (Wave-6 E6).
+ *
+ * PROVENANCE. This is the agent's Wave-4 W4-A1 memory-honesty discipline, promoted
+ * verbatim from a single surface (the agent's memory-prompt.ts) into the SDK so it
+ * is ONE shared contract, not a discipline re-derived (and re-weakened) per surface.
+ * Under E6 the store is unified and cross-surface, which multiplies the cost of a
+ * dishonest recall — so this discipline becomes MORE load-bearing, not less. A
+ * unified store must not be able to lie more loudly than the siloed one did.
+ *
+ * The contract is three rules:
+ *   1. INJECTION FLOOR = the store's own declared baseline trust (60), never higher.
+ *      MemoryStore.add() stamps every new record at confidence 60 unless the caller
+ *      says otherwise. A floor above 60 would starve every honestly-stored fact — a
+ *      freshly-learned fact could never clear recall on its own. The floor trusts a
+ *      record exactly as much as the store already vouches for it; anything stored
+ *      BELOW 60 (explicitly marked less certain) still does not qualify.
+ *   2. FLAGGED RECORDS ARE NEVER INJECTED. stale/contradicted records are excluded
+ *      outright, regardless of confidence — the surface already knows they are wrong
+ *      or superseded, so no confidence number buys them back into a prompt.
+ *   3. DEGRADED STATES ARE HONEST, NOT SILENT. an unavailable semantic index yields
+ *      a STATED reason and a literal fallback — never a silent empty result that
+ *      reads as "nothing was ever stored." 'no match' and 'index unavailable' are
+ *      distinct and both said out loud.
+ */
+import { HASHED_MEMORY_EMBEDDING_PROVIDER } from './memory-embeddings.js';
+/**
+ * Recall-prompt confidence floor. Tied to the store's own baseline: MemoryStore.add
+ * stamps new records at confidence 60. This is NOT a number chosen to make things
+ * pass — it is the store's own definition of "a real, usable fact."
+ */
+export const MIN_PROMPT_MEMORY_CONFIDENCE = 60;
+function provenanceSummary(record) {
+    if (record.provenance.length === 0)
+        return 'no provenance recorded';
+    return `provenance ${record.provenance.slice(0, 2).map((entry) => `${entry.kind}:${entry.ref}`).join(', ')}`;
+}
+/**
+ * Recall-eligibility decision for one record, with an honest human-readable reason
+ * attached (never a silent yes/no). This is the receipt every surface surfaces.
+ *
+ * Flagged records (stale/contradicted) are excluded outright regardless of
+ * confidence. Everything else is judged on its own stored confidence against
+ * MIN_PROMPT_MEMORY_CONFIDENCE — the store's own baseline. Nothing is blanket-boosted.
+ */
+export function describeMemoryPromptEligibility(record) {
+    const provenance = provenanceSummary(record);
+    if (record.reviewState === 'stale' || record.reviewState === 'contradicted') {
+        return {
+            eligible: false,
+            reason: `reviewState is ${record.reviewState} — flagged memory is never injected regardless of confidence (${provenance})`,
+        };
+    }
+    if (record.confidence < MIN_PROMPT_MEMORY_CONFIDENCE) {
+        return {
+            eligible: false,
+            reason: `confidence ${record.confidence}% is below the ${MIN_PROMPT_MEMORY_CONFIDENCE}% recall floor (${provenance})`,
+        };
+    }
+    return {
+        eligible: true,
+        reason: `confidence ${record.confidence}% clears the ${MIN_PROMPT_MEMORY_CONFIDENCE}% recall floor, reviewState ${record.reviewState} (${provenance})`,
+    };
+}
+export function isPromptActiveMemory(record) {
+    return describeMemoryPromptEligibility(record).eligible;
+}
+/**
+ * A HARD unavailable reason: the semantic index cannot be consulted at all, so a
+ * search must fall back to a literal scan and SAY SO — never a silent empty result
+ * that reads as "no memory matches" when the index was never asked. Returns null
+ * when the index is available and can be consulted.
+ */
+export function describeMemoryIndexUnavailable(stats) {
+    if (!stats.enabled)
+        return 'the semantic memory index is disabled for this store';
+    if (!stats.available)
+        return `the semantic memory index is unavailable${stats.error ? `: ${stats.error}` : ''}`;
+    if (stats.indexedRecords === 0)
+        return 'the semantic memory index has no indexed records yet';
+    return null;
+}
+/**
+ * A SOFT caveat: the index is up and consulted, but running on the built-in
+ * hashed-only fallback embedding provider rather than a modeled semantic provider.
+ * Still ranks real matches better than a literal scan, but say so rather than
+ * presenting it as equivalent. Returns null when a real provider is configured.
+ */
+export function describeMemoryIndexCaveat(stats) {
+    if (stats.embeddingProviderId === HASHED_MEMORY_EMBEDDING_PROVIDER.id) {
+        return 'running on the hashed-only fallback embedding provider (no dedicated semantic model configured) — ranking is approximate, not modeled semantic understanding';
+    }
+    return null;
+}

package/dist/platform/state/memory-store.d.ts

@@ -141,6 +141,8 @@ export declare class MemoryStore {
     constructor(dbPath: string | undefined, options: MemoryStoreOptions);
     init(): Promise<void>;
     get isReady(): boolean;
+    /** The on-disk database path backing this store, or null when ephemeral. */
+    get dbPath(): string | null;
     /** Add a new memory record. Returns the created record. */
     add(opts: MemoryAddOptions): Promise<MemoryRecord>;
     /** Retrieve a single record by ID. */

package/dist/platform/state/memory-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-store.ts"],"names":[],"mappings":"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"}

package/dist/platform/state/memory-store.js

@@ -41,6 +41,10 @@ export class MemoryStore {
     get isReady() {
         return this.ready;
     }
+    /** The on-disk database path backing this store, or null when ephemeral. */
+    get dbPath() {
+        return this.sqlite.databasePath;
+    }
     /** Add a new memory record. Returns the created record. */
     async add(opts) {
         if (!this.ready)

package/dist/platform/state/memory-vector-store.d.ts

@@ -1,18 +1,6 @@
 import type { MemoryClass, MemoryRecord, MemoryReviewState, MemoryScope } from './memory-store.js';
 import { MemoryEmbeddingProviderRegistry } from './memory-embeddings.js';
-/**
- * Resolves the path to the sqlite-vec native extension.
- *
- * When running inside a Bun bundled executable (import.meta.url path contains
- * "$bunfs"), the npm package's import.meta.resolve() cannot find the extension
- * because the virtual filesystem does not contain node_modules. In that case,
- * the extension must be co-located with the binary under
- * `<execDir>/lib/sqlite-vec-<os>-<arch>/vec0.<suffix>`.
- *
- * In development (bun run / node), the package's own getLoadablePath() is used
- * via the re-exported `load()` function.
- */
-export declare function resolveSqliteVecPath(): string;
+export { resolveSqliteVecPath } from './sqlite-vec-loader.js';
 export declare const MEMORY_VECTOR_DIMS = 384;
 export { embedMemoryText } from './memory-embeddings.js';
 export interface MemoryVectorSearchFilter {

package/dist/platform/state/memory-vector-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-vector-store.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-vector-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-vector-store.d.ts","sourceRoot":"","sources":["../../../src/platform/state/memory-vector-store.ts"],"names":[],"mappings":"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"}

package/dist/platform/state/memory-vector-store.js

@@ -1,46 +1,25 @@
 import { createHash } from 'node:crypto';
-import { dirname, join } from 'node:path';
+import { dirname } from 'node:path';
 import { mkdirSync } from 'node:fs';
-import { Database } from 'bun:sqlite';
-import { load as loadSqliteVec } from 'sqlite-vec';
+import { createRequire } from 'node:module';
 import { MemoryEmbeddingProviderRegistry, embedMemoryText, normalizeMemoryEmbeddingVector, } from './memory-embeddings.js';
+import { loadSqliteVecExtension } from './sqlite-vec-loader.js';
 import { logger } from '../utils/logger.js';
 import { summarizeError } from '../utils/error-display.js';
-/**
- * Resolves the path to the sqlite-vec native extension.
- *
- * When running inside a Bun bundled executable (import.meta.url path contains
- * "$bunfs"), the npm package's import.meta.resolve() cannot find the extension
- * because the virtual filesystem does not contain node_modules. In that case,
- * the extension must be co-located with the binary under
- * `<execDir>/lib/sqlite-vec-<os>-<arch>/vec0.<suffix>`.
- *
- * In development (bun run / node), the package's own getLoadablePath() is used
- * via the re-exported `load()` function.
- */
-export function resolveSqliteVecPath() {
-    const isBundled = import.meta.url.includes('$bunfs');
-    if (isBundled) {
-        const os = process.platform === 'win32' ? 'windows' : process.platform;
-        const arch = process.arch;
-        const suffix = process.platform === 'win32' ? 'dll' : process.platform === 'darwin' ? 'dylib' : 'so';
-        return join(dirname(process.execPath), 'lib', `sqlite-vec-${os}-${arch}`, `vec0.${suffix}`);
-    }
-    // In dev mode, delegate to sqlite-vec's own resolver.
-    return '';
-}
-/**
- * Loads the sqlite-vec extension into a Bun SQLite database.
- * Handles both bundled-binary and development execution contexts.
- */
-function loadSqliteVecExtension(db) {
-    const bundledPath = resolveSqliteVecPath();
-    if (bundledPath) {
-        db.loadExtension(bundledPath);
-    }
-    else {
-        loadSqliteVec(db);
-    }
+// Lifted to sqlite-vec-loader.ts (Wave-5 W5.3) so code-index-store.ts can load
+// the exact same native extension the exact same way. Re-exported here so
+// existing callers that import resolveSqliteVecPath from this module keep working.
+export { resolveSqliteVecPath } from './sqlite-vec-loader.js';
+// bun:sqlite is a Bun-only builtin; a static import makes this module unloadable
+// under any non-Bun runtime (Node's ESM linker rejects the `bun:` scheme at link
+// time, breaking the release install-smoke check and any Node import of the
+// surfaces that transitively reach this module). Resolve the Database constructor
+// lazily via require so the `bun:` specifier stays off the static import graph —
+// it is only pulled on the Bun-only code path that opens a database. Real Bun
+// behavior is unchanged.
+let bunDatabaseCtor = null;
+function bunSqliteDatabase() {
+    return (bunDatabaseCtor ??= createRequire(import.meta.url)('bun:sqlite').Database);
 }
 // Keep this in sync with DEFAULT_MEMORY_EMBEDDING_DIMS in memory-embeddings.ts.
 // Duplicating the literal here avoids an initialization cycle when state/index.ts
@@ -103,7 +82,7 @@ export class SqliteVecMemoryIndex {
             if (this.dbPath !== ':memory:') {
                 mkdirSync(dirname(this.dbPath), { recursive: true });
             }
-            this.db = new Database(this.dbPath);
+            this.db = new (bunSqliteDatabase())(this.dbPath);
             loadSqliteVecExtension(this.db);
             this.available = true;
             this.enabled = true;

package/dist/platform/state/sqlite-store.d.ts

@@ -15,6 +15,8 @@ export declare class SQLiteStore {
     private saveDirty;
     constructor(dbPath?: string);
     get isReady(): boolean;
+    /** The on-disk database path, or null for an ephemeral/in-memory store. */
+    get databasePath(): string | null;
     init(schema: (db: SqlDatabase) => void): Promise<void>;
     run(sql: string, params?: (string | number | Uint8Array | null)[]): void;
     exec(sql: string, params?: (string | number)[]): Array<{

package/dist/platform/state/sqlite-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../../src/platform/state/sqlite-store.ts"],"names":[],"mappings":"AAKA,UAAU,WAAW;IACnB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;IACzE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC,CAAC;IACnG,MAAM,IAAI,UAAU,CAAC;IACrB,KAAK,IAAI,IAAI,CAAC;CACf;AAYD,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,CAAC,EAAE,MAAM;IAI3B,IAAI,OAAO,IAAI,OAAO,CAErB;IAEK,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI;IAIxE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC;IAI5F,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAajD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAsB9B,KAAK,IAAI,IAAI;YAMC,UAAU;IAwBxB,OAAO,CAAC,KAAK;CAMd"}
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../../src/platform/state/sqlite-store.ts"],"names":[],"mappings":"AAKA,UAAU,WAAW;IACnB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;IACzE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC,CAAC;IACnG,MAAM,IAAI,UAAU,CAAC;IACrB,KAAK,IAAI,IAAI,CAAC;CACf;AAYD,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,CAAC,EAAE,MAAM;IAI3B,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,2EAA2E;IAC3E,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAEhC;IAEK,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI;IAIxE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAA;KAAE,CAAC;IAI5F,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAajD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAsB9B,KAAK,IAAI,IAAI;YAMC,UAAU;IAwBxB,OAAO,CAAC,KAAK;CAMd"}

package/dist/platform/state/sqlite-store.js

@@ -21,6 +21,10 @@ export class SQLiteStore {
     get isReady() {
         return this.db !== null;
     }
+    /** The on-disk database path, or null for an ephemeral/in-memory store. */
+    get databasePath() {
+        return this.dbPath;
+    }
     async init(schema) {
         if (this.db)
             return;

package/dist/platform/state/sqlite-vec-loader.d.ts

@@ -0,0 +1,25 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+import type { Database } from 'bun:sqlite';
+/**
+ * Resolves the path to the sqlite-vec native extension.
+ *
+ * When running inside a Bun bundled executable (import.meta.url path contains
+ * "$bunfs"), the npm package's import.meta.resolve() cannot find the extension
+ * because the virtual filesystem does not contain node_modules. In that case,
+ * the extension must be co-located with the binary under
+ * `<execDir>/lib/sqlite-vec-<os>-<arch>/vec0.<suffix>`.
+ *
+ * In development (bun run / node), the package's own getLoadablePath() is used
+ * via the re-exported `load()` function.
+ *
+ * Shared by memory-vector-store.ts (MemoryStore's vector index) and
+ * code-index-store.ts (the repo source-tree code index, Wave-5 W5.3) so both
+ * indexes load the exact same native extension the exact same way.
+ */
+export declare function resolveSqliteVecPath(): string;
+/**
+ * Loads the sqlite-vec extension into a Bun SQLite database.
+ * Handles both bundled-binary and development execution contexts.
+ */
+export declare function loadSqliteVecExtension(db: Database): void;
+//# sourceMappingURL=sqlite-vec-loader.d.ts.map

package/dist/platform/state/sqlite-vec-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-vec-loader.d.ts","sourceRoot":"","sources":["../../../src/platform/state/sqlite-vec-loader.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAGrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAOzD"}

package/dist/platform/state/sqlite-vec-loader.js

@@ -0,0 +1,43 @@
+/** SDK-owned platform module. This implementation is maintained in goodvibes-sdk. */
+import { dirname, join } from 'node:path';
+import { load as loadSqliteVec } from 'sqlite-vec';
+/**
+ * Resolves the path to the sqlite-vec native extension.
+ *
+ * When running inside a Bun bundled executable (import.meta.url path contains
+ * "$bunfs"), the npm package's import.meta.resolve() cannot find the extension
+ * because the virtual filesystem does not contain node_modules. In that case,
+ * the extension must be co-located with the binary under
+ * `<execDir>/lib/sqlite-vec-<os>-<arch>/vec0.<suffix>`.
+ *
+ * In development (bun run / node), the package's own getLoadablePath() is used
+ * via the re-exported `load()` function.
+ *
+ * Shared by memory-vector-store.ts (MemoryStore's vector index) and
+ * code-index-store.ts (the repo source-tree code index, Wave-5 W5.3) so both
+ * indexes load the exact same native extension the exact same way.
+ */
+export function resolveSqliteVecPath() {
+    const isBundled = import.meta.url.includes('$bunfs');
+    if (isBundled) {
+        const os = process.platform === 'win32' ? 'windows' : process.platform;
+        const arch = process.arch;
+        const suffix = process.platform === 'win32' ? 'dll' : process.platform === 'darwin' ? 'dylib' : 'so';
+        return join(dirname(process.execPath), 'lib', `sqlite-vec-${os}-${arch}`, `vec0.${suffix}`);
+    }
+    // In dev mode, delegate to sqlite-vec's own resolver.
+    return '';
+}
+/**
+ * Loads the sqlite-vec extension into a Bun SQLite database.
+ * Handles both bundled-binary and development execution contexts.
+ */
+export function loadSqliteVecExtension(db) {
+    const bundledPath = resolveSqliteVecPath();
+    if (bundledPath) {
+        db.loadExtension(bundledPath);
+    }
+    else {
+        loadSqliteVec(db);
+    }
+}

package/dist/platform/state/vibe-projection.d.ts

@@ -0,0 +1,67 @@
+/**
+ * vibe-projection.ts — VIBE.md as a PROJECTION of memory records (Wave-6 E6).
+ *
+ * BEFORE E6, VIBE.md was a persona file read off disk and injected into the prompt
+ * — a projection of ITSELF, a source of truth disjoint from the memory store. E6
+ * demotes the file to an import/export FORMAT and makes the prompt block a
+ * projection of first-class memory records:
+ *
+ *   - Persona/preference facts persist as MemoryRecords with cls 'constraint',
+ *     scope project|team, tagged VIBE_PERSONA_TAG.
+ *   - renderVibeProjection(records) emits the same '## GoodVibes Agent VIBE.md'
+ *     prompt block from those records — the block the file used to emit.
+ *   - The file round-trips THROUGH the record set (vibeBodyToConstraintOptions
+ *     imports a VIBE.md body into records; the records export back through the
+ *     normal MemoryStore bundle seam). The file is a format, not the truth.
+ *
+ * INVARIANT PRESERVED. The projected block keeps the precedence caveat verbatim:
+ * persona instructions are followed only when they do not conflict with explicit
+ * user instructions, safety policy, tool contracts, confirmation requirements, or
+ * secret-handling rules. Demoting the file to a projection must not drop that.
+ */
+import type { MemoryAddOptions, MemoryRecord, MemoryScope } from './memory-store.js';
+/** Tag marking a constraint record as a VIBE.md persona/preference line. */
+export declare const VIBE_PERSONA_TAG = "vibe";
+/** The projected prompt block heading. */
+export declare const VIBE_PROJECTION_HEADING = "## GoodVibes Agent VIBE.md";
+/**
+ * The precedence caveat. MUST accompany every projected block — persona records
+ * never override explicit instructions, safety, tool contracts, confirmations, or
+ * secret-handling.
+ */
+export declare const VIBE_PROJECTION_CAVEAT = "These user-authored vibe/personality instructions shape the same serial assistant conversation. Follow them only when they do not conflict with explicit user instructions, safety policy, tool contracts, confirmation requirements, or secret-handling rules.";
+export interface VibeProjectionOptions {
+    /** Restrict to these scopes; defaults to project + team. */
+    readonly scopes?: readonly MemoryScope[];
+}
+/**
+ * Select the constraint records that make up the VIBE persona: cls 'constraint',
+ * tagged VIBE_PERSONA_TAG, in an eligible scope. Ordered stably by scope (team
+ * after project) then creation time so the projected block is deterministic.
+ */
+export declare function selectVibeRecords(records: readonly MemoryRecord[], options?: VibeProjectionOptions): MemoryRecord[];
+/**
+ * Render the VIBE.md prompt block from persona/constraint records. Returns null
+ * when there are no persona records to project (no empty block). The caveat is
+ * always included when a block is produced.
+ */
+export declare function renderVibeProjection(records: readonly MemoryRecord[], options?: VibeProjectionOptions): string | null;
+export interface VibeImportOptions {
+    /** Scope to stamp on the imported persona records. Defaults to 'project'. */
+    readonly scope?: MemoryScope;
+    /** Optional persona name, added as a secondary tag for grouping. */
+    readonly name?: string;
+    /** Provenance ref describing where this VIBE body came from (e.g. the file path). */
+    readonly sourceRef?: string;
+}
+/**
+ * Turn a VIBE.md body into constraint MemoryAddOptions — the file demoted to an
+ * IMPORT FORMAT. Each bullet line becomes one persona record so that editing a
+ * single record later changes exactly one line of the projected block. A body
+ * with no bullets becomes a single record carrying the whole body as detail.
+ *
+ * Heading lines (starting with '#') and blank lines are dropped; they carry no
+ * persona instruction.
+ */
+export declare function vibeBodyToConstraintOptions(body: string, options?: VibeImportOptions): MemoryAddOptions[];
+//# sourceMappingURL=vibe-projection.d.ts.map

package/dist/platform/state/vibe-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibe-projection.d.ts","sourceRoot":"","sources":["../../../src/platform/state/vibe-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErF,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAEvC,0CAA0C;AAC1C,eAAO,MAAM,uBAAuB,+BAA+B,CAAC;AAEpE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,oQACgO,CAAC;AAKpQ,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,OAAO,GAAE,qBAA0B,GAClC,YAAY,EAAE,CAUhB;AAOD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,OAAO,GAAE,qBAA0B,GAClC,MAAM,GAAG,IAAI,CASf;AAED,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,EAAE,CAoCpB"}