opensquid 0.5.395

package/dist/rag/scope.js

@@ -0,0 +1,45 @@
+/**
+ * Recall-scope resolution (T-memory-scope-isolation). Resolves the caller's project namespace for a
+ * scoped `recall(query, k, scope)`. The key is the UMBRELLA id (so loop + loop-engine + opensquid — one
+ * umbrella, three project UUIDs — collapse to ONE namespace, matching how chat already keys inbox/lease),
+ * falling back to the project UUID for a cwd in no umbrella, and null only when there is no project
+ * context at all (a bare global CLI call).
+ *
+ * A null namespace is fail-closed at recall time: only `shared`-tier memories are returned (project
+ * memory is never leaked when the project is unknown). Because this resolver falls back umbrella →
+ * project-uuid, null is rare.
+ *
+ * Imports from: ../channels/routing.js, ../runtime/paths.js, ./types.js.
+ * Imported by: mcp/tools/recall, mcp/tools/memorize, functions/recall_pre_inject, functions/rag,
+ *   runtime/agent_bridge/tools/recall, runtime/wedge/compression_deps, setup/cli/memory,
+ *   setup/migrate/auto_memory_snapshot. All eight use the cwd default; in MCP-server processes
+ *   that cwd is normalized at boot by mcp/anchor.ts (host-controlled spawn cwd).
+ */
+import { loadChannelsConfig, resolveUmbrellaForCwd } from '../channels/routing.js';
+import { resolveProjectUuidFromEnv, walkForProjectUuid } from '../runtime/paths.js';
+/** Resolve the recall namespace for `cwd`: umbrella → project-uuid → null. Never throws. */
+export async function resolveRecallScope(cwd = process.cwd()) {
+    try {
+        const cfg = await loadChannelsConfig();
+        const umbrella = cfg === null ? null : resolveUmbrellaForCwd(cfg, cwd);
+        if (umbrella !== null)
+            return { namespace: umbrella };
+    }
+    catch {
+        // channels config absent/unreadable → fall through to project-uuid resolution
+    }
+    try {
+        const proj = (await walkForProjectUuid(cwd)) ?? resolveProjectUuidFromEnv();
+        return { namespace: proj };
+    }
+    catch {
+        return { namespace: null };
+    }
+}
+/**
+ * The loud notice emitted when a scoped recall resolves to a null namespace — project memory is
+ * withheld this turn. NEVER a silent forget (directly answers the "AI forgets what I told it" drift).
+ * Callers that surface text (recall MCP, recall_pre_inject) prepend/emit this; null namespace is rare.
+ */
+export const NULL_SCOPE_NOTICE = '[opensquid] project unresolved (no umbrella/project context) → project-scoped memory withheld this turn; only shared memory recalled.';
+//# sourceMappingURL=scope.js.map

package/dist/rag/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/rag/scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAIpF,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAClE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,kBAAkB,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACvE,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,8EAA8E;IAChF,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,yBAAyB,EAAE,CAAC;QAC5E,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,uIAAuI,CAAC"}

package/dist/rag/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * RAG types: `Lesson`, `RecallHit`, `RagBackend`.
+ *
+ * The `RagBackend` interface is the ONLY surface that `src/functions/rag.ts`
+ * sees — no `@libsql/client` types leak past this boundary. That is what
+ * makes the backend pluggable: Task 1.11 lands `libsql-lexical`, Task 1.12
+ * lands `claude-auto-memory`, and neither requires touching the primitives.
+ *
+ * `embed()` returns `Promise<number[] | null>` rather than throwing on
+ * embedder-down because the backend treats Ollama-absent as a degraded
+ * (lexical-only) mode, not an error. The primitive caller decides what to
+ * do with `null` — by default, `store_lesson` still inserts the row.
+ *
+ * Imports from: nothing (leaf type module).
+ * Imported by: src/rag/* + src/functions/rag.ts.
+ */
+export interface Lesson {
+    id: string;
+    content: string;
+    tags: string[];
+    source: string;
+    author: 'user' | 'agent';
+    createdAt: string;
+    derivedFrom?: string[];
+    consumedByUserLessons?: number;
+    tier?: MemoryTier;
+    namespace?: string | null;
+}
+/**
+ * A memory's scope tier. `shared` crosses every project (user/global knowledge); `project` is isolated
+ * to one umbrella `namespace`. Kept to exactly two grounded values — every write path can produce both
+ * (memorize enum-maps, the importer resolves the umbrella). See T-memory-scope-isolation.
+ */
+export type MemoryTier = 'shared' | 'project';
+/** The required recall scope: the caller's resolved umbrella namespace (null = no project context). */
+export interface RecallScope {
+    namespace: string | null;
+}
+/**
+ * The PURE eligibility predicate — the one place the cross/isolate rule lives, so it is unit-testable and
+ * cannot drift. A hit is eligible iff it is `shared`, OR it is `project` AND its namespace matches the
+ * recall scope. A null recall namespace (no project context) therefore matches ONLY `shared` rows
+ * (fail-closed: project memory is never leaked when the project is unknown). Absent tier ⇒ `shared`.
+ */
+export declare function inScope(tier: MemoryTier | undefined, namespace: string | null | undefined, scope: RecallScope): boolean;
+export interface RecallHit {
+    lesson: Lesson;
+    score: number;
+    source: 'semantic' | 'lexical' | 'fused';
+}
+/** Result of `deleteLesson`. `deleted:false` = id not found (caller maps to INVALID_PARAMS). */
+export interface DeleteResult {
+    deleted: boolean;
+    forced: boolean;
+}
+/**
+ * Thrown by `deleteLesson` when the target is a `user`-authored lesson and `force` was not set.
+ * Defined here (not in mcp/tools) so every backend can throw it without depending on the MCP layer
+ * (`forget.ts` re-exports it for back-compat with existing imports). Mirrors the engine's
+ * USER_MEMORY_IMMUNE (-32003) — explicit user deletion is allowed (with force); automatic eviction
+ * of user memories is forbidden (the no-auto-delete invariant).
+ */
+export declare class UserAuthoredImmunityError extends Error {
+    readonly id: string;
+    constructor(id: string);
+}
+export interface RagBackend {
+    init(): Promise<void>;
+    embed(text: string): Promise<number[] | null>;
+    recall(query: string, k: number, scope: RecallScope): Promise<RecallHit[]>;
+    storeLesson(lesson: Lesson): Promise<void>;
+    deleteLesson(id: string, opts?: {
+        force?: boolean;
+    }): Promise<DeleteResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/rag/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/rag/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAGlB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAG/B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9C,uGAAuG;AACvG,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,UAAU,GAAG,SAAS,EAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,KAAK,EAAE,WAAW,GACjB,OAAO,CAGT;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;CAC1C;AAED,gGAAgG;AAChG,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;aACtB,EAAE,EAAE,MAAM;gBAAV,EAAE,EAAE,MAAM;CAIvC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAG9C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3E,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC7E"}

package/dist/rag/types.js

@@ -0,0 +1,43 @@
+/**
+ * RAG types: `Lesson`, `RecallHit`, `RagBackend`.
+ *
+ * The `RagBackend` interface is the ONLY surface that `src/functions/rag.ts`
+ * sees — no `@libsql/client` types leak past this boundary. That is what
+ * makes the backend pluggable: Task 1.11 lands `libsql-lexical`, Task 1.12
+ * lands `claude-auto-memory`, and neither requires touching the primitives.
+ *
+ * `embed()` returns `Promise<number[] | null>` rather than throwing on
+ * embedder-down because the backend treats Ollama-absent as a degraded
+ * (lexical-only) mode, not an error. The primitive caller decides what to
+ * do with `null` — by default, `store_lesson` still inserts the row.
+ *
+ * Imports from: nothing (leaf type module).
+ * Imported by: src/rag/* + src/functions/rag.ts.
+ */
+/**
+ * The PURE eligibility predicate — the one place the cross/isolate rule lives, so it is unit-testable and
+ * cannot drift. A hit is eligible iff it is `shared`, OR it is `project` AND its namespace matches the
+ * recall scope. A null recall namespace (no project context) therefore matches ONLY `shared` rows
+ * (fail-closed: project memory is never leaked when the project is unknown). Absent tier ⇒ `shared`.
+ */
+export function inScope(tier, namespace, scope) {
+    if ((tier ?? 'shared') === 'shared')
+        return true;
+    return namespace != null && namespace === scope.namespace;
+}
+/**
+ * Thrown by `deleteLesson` when the target is a `user`-authored lesson and `force` was not set.
+ * Defined here (not in mcp/tools) so every backend can throw it without depending on the MCP layer
+ * (`forget.ts` re-exports it for back-compat with existing imports). Mirrors the engine's
+ * USER_MEMORY_IMMUNE (-32003) — explicit user deletion is allowed (with force); automatic eviction
+ * of user memories is forbidden (the no-auto-delete invariant).
+ */
+export class UserAuthoredImmunityError extends Error {
+    id;
+    constructor(id) {
+        super(`Memory ${id} is user-authored and eviction-immune. Pass force: true to delete.`);
+        this.id = id;
+        this.name = 'UserAuthoredImmunityError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/rag/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/rag/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA+BH;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CACrB,IAA4B,EAC5B,SAAoC,EACpC,KAAkB;IAElB,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,SAAS,IAAI,IAAI,IAAI,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC;AAC5D,CAAC;AAcD;;;;;;GAMG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACtB;IAA5B,YAA4B,EAAU;QACpC,KAAK,CAAC,UAAU,EAAE,oEAAoE,CAAC,CAAC;QAD9D,OAAE,GAAF,EAAE,CAAQ;QAEpC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF"}

package/dist/rag/wedge/gate.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Promotion gate — the marketing wedge (TS port of the Rust
+ * `engine/src/engine/lessons/gate.rs` `check_promotion_gate`, retire-Rust RES-3a).
+ *
+ * Pure + synchronous: given a lesson's frontmatter + a `PromotionConfig` + `now`,
+ * decide whether it is eligible for promotion. Accumulates ALL violations (no
+ * first-fail) so callers render the full picture. The wedge against self-grading:
+ * promotion refuses to take frontmatter at face value (24h dwell, ≥3 applied,
+ * external signal required, no thumbs-down, non-speculative narrative).
+ *
+ * Block `reasons` carry a stable kebab PREFIX (the wire contract `promote_lesson`
+ * surfaces as opaque strings, `src/functions/lessons.ts`); the embedded data
+ * (timestamps/counts) is informational + TS-rendered (NOT byte-matched to the
+ * Rust chrono Display/Debug). `promote` carries no reasons — the consumer never
+ * surfaces pass-reasons.
+ *
+ * NOTE (the wedge invariant): the Rust gate's `TamperedAge` anti-backdate check
+ * relied on filesystem birthtime, which libSQL has no per-row equivalent of. It is
+ * DROPPED here; the invariant migrates to the store (RES-3b) as a HARD requirement:
+ * `createdAt` MUST be store-owned (the DB insert time, never caller-supplied), or
+ * the 24h time-floor below is backdate-bypassable with no backstop.
+ *
+ * Imports from: nothing (leaf, pure). Imported by: RES-3b lesson store (not yet wired).
+ */
+export type Confidence = 'observed' | 'inferred' | 'speculative';
+export interface CausalNarrative {
+    confidence: Confidence;
+    evidenceRefs: string[];
+}
+/**
+ * Normalize a raw on-disk / DB `causal_narrative` object to a `CausalNarrative`. The TS writer emits
+ * camelCase `evidenceRefs`, but the RES-3d-migrated Rust lessons carry snake_case `evidence_refs`
+ * (and a richer field set — `trigger`/`failure_mode`/`correction`); a blind cast left `evidenceRefs`
+ * undefined and the gate mis-blocked (or, pre-guard, crashed) on such a lesson. Maps the key
+ * (camelCase wins if both present, absent/malformed → []) while PRESERVING every other field so a
+ * read→write round-trip is lossless. Shared by both readers (per-file source + the libSQL row).
+ */
+export declare function normalizeCausalNarrative(raw: Record<string, unknown>): CausalNarrative;
+export type LessonStatus = 'pending' | 'active' | 'promoted' | 'superseded' | 'discarded';
+export interface LessonFrontmatter {
+    status: LessonStatus;
+    supersededAt?: string;
+    /** ISO 8601. STORE-OWNED in RES-3b (the dropped-TamperedAge invariant). */
+    createdAt: string;
+    appliedCount: number;
+    thumbsDownCount: number;
+    externalSignalSources: string[];
+    appliedSessionIds: string[];
+    causalNarrative?: CausalNarrative;
+}
+export interface PromotionConfig {
+    minAgeMs: number;
+    minAppliedCount: number;
+    minDistinctOrigins: number;
+}
+/** gate.rs:75-87 — 24h dwell, ≥3 applied, origin-diversity disabled by default. */
+export declare const DEFAULT_PROMOTION_CONFIG: PromotionConfig;
+export type GateDecision = {
+    kind: 'promote';
+} | {
+    kind: 'block';
+    reasons: string[];
+};
+/**
+ * Faithful port of `check_promotion_gate` (gate.rs:325-454): accumulate ALL
+ * violations in the stable 1→8 order; return `block` if any, else `promote`.
+ */
+export declare function checkPromotionGate(fm: LessonFrontmatter, config?: PromotionConfig, now?: Date): GateDecision;
+//# sourceMappingURL=gate.d.ts.map

package/dist/rag/wedge/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../../src/rag/wedge/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAQtF;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAC;AAE1F,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,EAAE,eAItC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEtF;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,iBAAiB,EACrB,MAAM,GAAE,eAA0C,EAClD,GAAG,GAAE,IAAiB,GACrB,YAAY,CA6Dd"}

package/dist/rag/wedge/gate.js

@@ -0,0 +1,104 @@
+/**
+ * Promotion gate — the marketing wedge (TS port of the Rust
+ * `engine/src/engine/lessons/gate.rs` `check_promotion_gate`, retire-Rust RES-3a).
+ *
+ * Pure + synchronous: given a lesson's frontmatter + a `PromotionConfig` + `now`,
+ * decide whether it is eligible for promotion. Accumulates ALL violations (no
+ * first-fail) so callers render the full picture. The wedge against self-grading:
+ * promotion refuses to take frontmatter at face value (24h dwell, ≥3 applied,
+ * external signal required, no thumbs-down, non-speculative narrative).
+ *
+ * Block `reasons` carry a stable kebab PREFIX (the wire contract `promote_lesson`
+ * surfaces as opaque strings, `src/functions/lessons.ts`); the embedded data
+ * (timestamps/counts) is informational + TS-rendered (NOT byte-matched to the
+ * Rust chrono Display/Debug). `promote` carries no reasons — the consumer never
+ * surfaces pass-reasons.
+ *
+ * NOTE (the wedge invariant): the Rust gate's `TamperedAge` anti-backdate check
+ * relied on filesystem birthtime, which libSQL has no per-row equivalent of. It is
+ * DROPPED here; the invariant migrates to the store (RES-3b) as a HARD requirement:
+ * `createdAt` MUST be store-owned (the DB insert time, never caller-supplied), or
+ * the 24h time-floor below is backdate-bypassable with no backstop.
+ *
+ * Imports from: nothing (leaf, pure). Imported by: RES-3b lesson store (not yet wired).
+ */
+/**
+ * Normalize a raw on-disk / DB `causal_narrative` object to a `CausalNarrative`. The TS writer emits
+ * camelCase `evidenceRefs`, but the RES-3d-migrated Rust lessons carry snake_case `evidence_refs`
+ * (and a richer field set — `trigger`/`failure_mode`/`correction`); a blind cast left `evidenceRefs`
+ * undefined and the gate mis-blocked (or, pre-guard, crashed) on such a lesson. Maps the key
+ * (camelCase wins if both present, absent/malformed → []) while PRESERVING every other field so a
+ * read→write round-trip is lossless. Shared by both readers (per-file source + the libSQL row).
+ */
+export function normalizeCausalNarrative(raw) {
+    const { evidence_refs, ...rest } = raw;
+    const evidence = rest.evidenceRefs ?? evidence_refs;
+    return {
+        ...rest,
+        confidence: rest.confidence,
+        evidenceRefs: Array.isArray(evidence) ? evidence : [],
+    };
+}
+/** gate.rs:75-87 — 24h dwell, ≥3 applied, origin-diversity disabled by default. */
+export const DEFAULT_PROMOTION_CONFIG = {
+    minAgeMs: 24 * 60 * 60 * 1000,
+    minAppliedCount: 3,
+    minDistinctOrigins: 0,
+};
+/**
+ * Faithful port of `check_promotion_gate` (gate.rs:325-454): accumulate ALL
+ * violations in the stable 1→8 order; return `block` if any, else `promote`.
+ */
+export function checkPromotionGate(fm, config = DEFAULT_PROMOTION_CONFIG, now = new Date()) {
+    const blocks = [];
+    const requiredSec = Math.floor(config.minAgeMs / 1000);
+    // 1. superseded (gate.rs:335)
+    if (fm.status === 'superseded' || fm.supersededAt !== undefined) {
+        blocks.push('already-superseded');
+    }
+    // 2. created_at parse + future + 24h time-floor (gate.rs:340-364). A future date
+    //    dual-emits future-created-at + time-floor; age is CLAMPED to 0 (a future date
+    //    can't satisfy a positive floor — never a negative age).
+    const createdMs = Date.parse(fm.createdAt);
+    if (Number.isNaN(createdMs)) {
+        blocks.push(`malformed-created-at: ${JSON.stringify(fm.createdAt)}`);
+    }
+    else if (createdMs > now.getTime()) {
+        blocks.push(`future-created-at: ${fm.createdAt}`);
+        blocks.push(`time-floor: age=0s < required=${requiredSec}s`);
+    }
+    else if (now.getTime() - createdMs < config.minAgeMs) {
+        const ageSec = Math.floor((now.getTime() - createdMs) / 1000);
+        blocks.push(`time-floor: age=${ageSec}s < required=${requiredSec}s`);
+    }
+    // (TamperedAge DROPPED — no per-row birthtime in libSQL; RES-3b owns createdAt)
+    // 3. applied-count floor (gate.rs:390)
+    if (fm.appliedCount < config.minAppliedCount) {
+        blocks.push(`insufficient-applied-count: observed=${fm.appliedCount} < required=${config.minAppliedCount}`);
+    }
+    // 4. thumbs-down hard block (gate.rs:400)
+    if (fm.thumbsDownCount > 0) {
+        blocks.push(`thumbs-down-block: count=${fm.thumbsDownCount}`);
+    }
+    // 5. external signal required (gate.rs:409)
+    if (fm.externalSignalSources.length === 0) {
+        blocks.push('missing-external-signal-sources');
+    }
+    // 5b. origin diversity — inert at the default 0 (gate.rs:420)
+    if (config.minDistinctOrigins > 0 && fm.appliedSessionIds.length < config.minDistinctOrigins) {
+        blocks.push(`insufficient-origin-diversity: distinct_sessions=${fm.appliedSessionIds.length} < required=${config.minDistinctOrigins}`);
+    }
+    // 6. causal narrative ladder (gate.rs:433-447)
+    if (fm.causalNarrative === undefined) {
+        blocks.push('missing-causal-narrative');
+    }
+    else if (fm.causalNarrative.confidence === 'speculative') {
+        blocks.push('speculative-narrative');
+    }
+    else if (fm.causalNarrative.confidence === 'observed' &&
+        (fm.causalNarrative.evidenceRefs?.length ?? 0) === 0) {
+        blocks.push('observed-confidence-without-evidence-refs');
+    }
+    return blocks.length === 0 ? { kind: 'promote' } : { kind: 'block', reasons: blocks };
+}
+//# sourceMappingURL=gate.js.map

package/dist/rag/wedge/gate.js.map

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

package/dist/rag/wedge/migrate.d.ts

@@ -0,0 +1,7 @@
+export declare function migrateWedgeLessons(opts: {
+    dbUrl: string;
+    sourceDir: string;
+}): Promise<{
+    migrated: number;
+}>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/rag/wedge/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/rag/wedge/migrate.ts"],"names":[],"mappings":"AAcA,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAMhC"}

package/dist/rag/wedge/migrate.js

@@ -0,0 +1,21 @@
+/**
+ * Wedge lesson migration (retire-Rust RES-3d). The on-disk engine lessons at
+ * `~/.opensquid/lessons/<status>/les-*.md` ARE the wedge per-file source (RES-3b layout), so this is
+ * a pure DB-index rebuild — read every record back via `readWedgeRecords` and repopulate the
+ * `wg_lessons` libSQL index (no file copy/rewrite). Idempotent: `store.rebuild` DELETEs all then
+ * re-inserts, so re-running yields the same count with no duplicates. Mirrors the memory-store
+ * `migrateMemories` precedent.
+ *
+ * Imports from: ./store.js, ./source.js.
+ * Imported by: src/cli.ts (the `migrate-lessons` command).
+ */
+import { readWedgeRecords } from './source.js';
+import { wedgeLessonStore } from './store.js';
+export async function migrateWedgeLessons(opts) {
+    const store = wedgeLessonStore({ dbUrl: opts.dbUrl, sourceDir: opts.sourceDir });
+    await store.init();
+    const records = await readWedgeRecords(opts.sourceDir);
+    const { indexed } = await store.rebuild(records);
+    return { migrated: indexed };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/rag/wedge/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/rag/wedge/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAGzC;IACC,MAAM,KAAK,GAAG,gBAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IACjF,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACnB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/rag/wedge/paths.d.ts

@@ -0,0 +1,3 @@
+export declare const wedgeLessonsDbUrl: () => string;
+export declare const wedgeLessonsDir: () => string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/rag/wedge/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/rag/wedge/paths.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,iBAAiB,QAAO,MAA2D,CAAC;AACjG,eAAO,MAAM,eAAe,QAAO,MAA2C,CAAC"}

package/dist/rag/wedge/paths.js

@@ -0,0 +1,13 @@
+/**
+ * Filesystem paths for the wedge lesson store (retire-Rust RES-3c). Resolves the dedicated
+ * `wg_lessons` DB + the status-dir per-file source root under OPENSQUID_HOME (so tests can redirect
+ * via the env var). Separate from the memory store paths.
+ *
+ * Imports from: node:path, ../../runtime/paths.js.
+ * Imported by: src/runtime/bootstrap.ts, src/mcp/server.ts.
+ */
+import { join } from 'node:path';
+import { OPENSQUID_HOME } from '../../runtime/paths.js';
+export const wedgeLessonsDbUrl = () => `file:${join(OPENSQUID_HOME(), 'wg_lessons.db')}`;
+export const wedgeLessonsDir = () => join(OPENSQUID_HOME(), 'lessons');
+//# sourceMappingURL=paths.js.map

package/dist/rag/wedge/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/rag/wedge/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE,CAAC,QAAQ,IAAI,CAAC,cAAc,EAAE,EAAE,eAAe,CAAC,EAAE,CAAC;AACjG,MAAM,CAAC,MAAM,eAAe,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,SAAS,CAAC,CAAC"}

package/dist/rag/wedge/source.d.ts

@@ -0,0 +1,11 @@
+import type { LessonStatus } from './gate.js';
+import type { WedgeLesson } from './store.js';
+/** gate.rs MAX_APPLIED_SESSION_IDS — cap applied_session_ids growth. */
+export declare const MAX_APPLIED_SESSION_IDS = 50;
+/** Write `<sourceDir>/<status>/<id>.md` atomically (dir DERIVED from `lesson.status`). */
+export declare function writeWedgeRecord(sourceDir: string, lesson: WedgeLesson): Promise<void>;
+/** Remove `<sourceDir>/<status>/<id>.md` (the OLD status file on a move). Idempotent. */
+export declare function deleteWedgeRecord(sourceDir: string, status: LessonStatus, id: string): Promise<void>;
+/** Read every `<sourceDir>/<status>/*.md` back into `WedgeLesson[]` (RES-3d rebuild). */
+export declare function readWedgeRecords(sourceDir: string): Promise<WedgeLesson[]>;
+//# sourceMappingURL=source.d.ts.map

package/dist/rag/wedge/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../src/rag/wedge/source.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAI1C,0FAA0F;AAC1F,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB5F;AAED,yFAAyF;AACzF,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,yFAAyF;AACzF,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA4DhF"}

package/dist/rag/wedge/source.js

@@ -0,0 +1,111 @@
+/**
+ * Per-file source-of-truth for wedge-gate lessons (retire-Rust RES-3b). Mirrors
+ * `src/rag/backends/perfile_source.ts` but with the wedge field set and a STATUS-DIR layout:
+ * each lesson is `<sourceDir>/<status>/<id>.md` — the same on-disk shape the Rust engine uses
+ * (`~/.opensquid/lessons/<status>/les-*.md`), so RES-3d migrates the existing 49 lessons by
+ * re-indexing them. The per-file form is the git-versionable truth; the libSQL `wg_lessons` table
+ * is the derived, rebuildable index. A status transition is a FILE MOVE between status dirs:
+ * `writeWedgeRecord` writes the NEW status file, then the caller `deleteWedgeRecord`s the old one.
+ *
+ * Imports from: node:fs/promises, node:path, yaml, ../../storage/atomic_file.js.
+ * Imported by: src/rag/wedge/store.ts.
+ */
+import { readFile, readdir, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { atomicWriteFile, safeRecordId } from '../../storage/atomic_file.js';
+import { normalizeCausalNarrative } from './gate.js';
+/** gate.rs MAX_APPLIED_SESSION_IDS — cap applied_session_ids growth. */
+export const MAX_APPLIED_SESSION_IDS = 50;
+const STATUS_DIRS = ['pending', 'active', 'promoted', 'superseded', 'discarded'];
+/** Write `<sourceDir>/<status>/<id>.md` atomically (dir DERIVED from `lesson.status`). */
+export async function writeWedgeRecord(sourceDir, lesson) {
+    const frontmatter = stringifyYaml({
+        id: lesson.id,
+        description: lesson.description,
+        status: lesson.status,
+        authored_by: lesson.authoredBy,
+        ...(lesson.packId !== undefined ? { pack_id: lesson.packId } : {}),
+        ...(lesson.externalId !== undefined ? { external_id: lesson.externalId } : {}),
+        created_at: lesson.createdAt,
+        updated_at: lesson.updatedAt,
+        ...(lesson.promotedAt !== undefined ? { promoted_at: lesson.promotedAt } : {}),
+        ...(lesson.supersededAt !== undefined ? { superseded_at: lesson.supersededAt } : {}),
+        ...(lesson.lastAppliedAt !== undefined ? { last_applied_at: lesson.lastAppliedAt } : {}),
+        applied_count: lesson.appliedCount,
+        thumbs_up_count: lesson.thumbsUpCount,
+        thumbs_down_count: lesson.thumbsDownCount,
+        external_signal_sources: lesson.externalSignalSources,
+        applied_session_ids: lesson.appliedSessionIds,
+        ...(lesson.causalNarrative !== undefined ? { causal_narrative: lesson.causalNarrative } : {}),
+    });
+    await atomicWriteFile(join(sourceDir, lesson.status, `${safeRecordId(lesson.id)}.md`), `---\n${frontmatter}---\n${lesson.body}`);
+}
+/** Remove `<sourceDir>/<status>/<id>.md` (the OLD status file on a move). Idempotent. */
+export async function deleteWedgeRecord(sourceDir, status, id) {
+    await rm(join(sourceDir, status, `${safeRecordId(id)}.md`), { force: true });
+}
+/** Read every `<sourceDir>/<status>/*.md` back into `WedgeLesson[]` (RES-3d rebuild). */
+export async function readWedgeRecords(sourceDir) {
+    const out = [];
+    for (const status of STATUS_DIRS) {
+        const dir = join(sourceDir, status);
+        let files;
+        try {
+            files = (await readdir(dir)).filter((f) => f.endsWith('.md'));
+        }
+        catch {
+            continue; // status dir absent
+        }
+        for (const f of files) {
+            const raw = await readFile(join(dir, f), 'utf8');
+            if (!raw.startsWith('---\n'))
+                continue;
+            const end = raw.indexOf('\n---\n', 4);
+            if (end === -1)
+                continue;
+            try {
+                const fm = parseYaml(raw.slice(4, end + 1));
+                if (typeof fm.id !== 'string')
+                    continue;
+                out.push({
+                    id: fm.id,
+                    description: typeof fm.description === 'string' ? fm.description : '',
+                    body: raw.slice(end + 5),
+                    status: (typeof fm.status === 'string' ? fm.status : status),
+                    authoredBy: fm.authored_by === 'user' || fm.authored_by === 'pack' ? fm.authored_by : 'agent',
+                    ...(typeof fm.pack_id === 'string' ? { packId: fm.pack_id } : {}),
+                    ...(typeof fm.external_id === 'string' ? { externalId: fm.external_id } : {}),
+                    createdAt: typeof fm.created_at === 'string' ? fm.created_at : new Date(0).toISOString(),
+                    updatedAt: typeof fm.updated_at === 'string'
+                        ? fm.updated_at
+                        : typeof fm.created_at === 'string'
+                            ? fm.created_at
+                            : new Date(0).toISOString(),
+                    ...(typeof fm.promoted_at === 'string' ? { promotedAt: fm.promoted_at } : {}),
+                    ...(typeof fm.superseded_at === 'string' ? { supersededAt: fm.superseded_at } : {}),
+                    ...(typeof fm.last_applied_at === 'string' ? { lastAppliedAt: fm.last_applied_at } : {}),
+                    appliedCount: typeof fm.applied_count === 'number' ? fm.applied_count : 0,
+                    thumbsUpCount: typeof fm.thumbs_up_count === 'number' ? fm.thumbs_up_count : 0,
+                    thumbsDownCount: typeof fm.thumbs_down_count === 'number' ? fm.thumbs_down_count : 0,
+                    externalSignalSources: Array.isArray(fm.external_signal_sources)
+                        ? fm.external_signal_sources
+                        : [],
+                    appliedSessionIds: Array.isArray(fm.applied_session_ids)
+                        ? fm.applied_session_ids
+                        : [],
+                    ...(fm.causal_narrative !== undefined && fm.causal_narrative !== null
+                        ? {
+                            causalNarrative: normalizeCausalNarrative(fm.causal_narrative),
+                        }
+                        : {}),
+                });
+            }
+            catch {
+                // skip a malformed record; one bad file must not blind the rebuild
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=source.js.map

package/dist/rag/wedge/source.js.map

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

package/dist/rag/wedge/store.d.ts

@@ -0,0 +1,64 @@
+import { type LessonFrontmatter, type LessonStatus } from './gate.js';
+/** Thrown by `promoteLesson` when the gate blocks. `reasons` are the kebab-prefix block strings. */
+export declare class PromotionBlockedError extends Error {
+    readonly id: string;
+    readonly reasons: string[];
+    constructor(id: string, reasons: string[]);
+}
+/** A wedge lesson row. WIDENS the gate's `LessonFrontmatter` (which lacks `thumbsUpCount`). */
+export interface WedgeLesson extends LessonFrontmatter {
+    id: string;
+    description: string;
+    body: string;
+    authoredBy: 'user' | 'agent' | 'pack';
+    packId?: string;
+    externalId?: string;
+    thumbsUpCount: number;
+    updatedAt: string;
+    promotedAt?: string;
+    lastAppliedAt?: string;
+}
+export interface CreateLessonInput {
+    description: string;
+    body: string;
+    evidenceRefs?: string[];
+    authoredBy?: 'user' | 'agent' | 'pack';
+}
+export interface WedgeRecallHit {
+    kind: 'lesson';
+    id: string;
+    description: string;
+    status: LessonStatus;
+    body_preview: string;
+    similarity: number;
+    applied_count: number;
+}
+export interface WedgeLessonStore {
+    init(): Promise<void>;
+    createLesson(input: CreateLessonInput): Promise<{
+        id: string;
+        status: 'pending';
+        createdAt: string;
+    }>;
+    promoteLesson(id: string): Promise<{
+        id: string;
+        status: 'promoted';
+    }>;
+    recallLesson(query: string, limit?: number): Promise<{
+        query: string;
+        returned: number;
+        results: WedgeRecallHit[];
+    }>;
+    captureFeedback(id: string, polarity: 'up' | 'down', signalId: string): Promise<void>;
+    recordApplied(id: string, sessionId?: string): Promise<void>;
+    /** Clean DB-index rebuild from already-on-disk records (migration; no file rewrite). */
+    rebuild(records: WedgeLesson[]): Promise<{
+        indexed: number;
+    }>;
+}
+export declare function wedgeLessonStore(opts: {
+    dbUrl: string;
+    sourceDir: string;
+    nowIso?: () => string;
+}): WedgeLessonStore;
+//# sourceMappingURL=store.d.ts.map