@cortexkit/opencode-magic-context 0.26.0 → 0.27.0

package/dist/features/magic-context/dreamer/retrospective-learnings.d.ts

@@ -0,0 +1,47 @@
+import type { Database } from "../../../shared/sqlite";
+import type { MemoryCategory } from "../memory/types";
+export type RetrospectiveLearningRoute = "memory" | "observation";
+export interface ParsedRetrospectiveLearning {
+    route: RetrospectiveLearningRoute;
+    content: string;
+    category?: MemoryCategory;
+}
+export interface RetrospectiveApplyResult {
+    memoryWritten: number;
+    observationsInserted: number;
+    observationsDropped: number;
+    rejected: Array<{
+        content: string;
+        reason: string;
+    }>;
+}
+export declare function parseRetrospectiveLearnings(text: string): ParsedRetrospectiveLearning[];
+export declare const MAX_SOURCE_WORD_RUN = 7;
+export declare const MAX_SOURCE_WORD_RUN_RATIO = 0.5;
+export declare const MAX_OVERLAP_LEARNING_WORDS = 200;
+/**
+ * True when `content` reads as a near-transcription of any source user line:
+ * it shares a contiguous run of ≥ runCap words (an absolute cap of
+ * MAX_SOURCE_WORD_RUN, or half the learning's own length for very short
+ * learnings). This is the structural enforcement of "distill, don't transcribe"
+ * — the regexes catch quotes/dates/anger; this catches a lightly-reworded user
+ * sentence that would otherwise pass.
+ *
+ * Implementation: since runCap ≤ MAX_SOURCE_WORD_RUN (small), "a shared run ≥
+ * runCap exists" is equivalent to "some runCap-gram of the learning occurs in the
+ * source". We build the learning's runCap-grams once (≤ learning length) and
+ * stream each FULL source past them — O(Σ source words) time, O(learning) memory,
+ * with NO source truncation (a verbatim run at any offset is caught).
+ */
+export declare function hasHighSourceOverlap(content: string, sourceUserTexts: string[]): boolean;
+export declare function validateRetrospectiveLearningText(content: string, sourceUserTexts?: readonly string[]): string | null;
+export declare function applyRetrospectiveLearnings(args: {
+    db: Database;
+    projectIdentity: string;
+    sourceSessionId: string;
+    learnings: ParsedRetrospectiveLearning[];
+    userMemoryCollectionEnabled: boolean;
+    /** The raw source user lines, for the near-transcription reject check. */
+    sourceUserTexts?: readonly string[];
+}): RetrospectiveApplyResult;
+//# sourceMappingURL=retrospective-learnings.d.ts.map

package/dist/features/magic-context/dreamer/retrospective-learnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrospective-learnings.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/retrospective-learnings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAWtD,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,aAAa,CAAC;AAElE,MAAM,WAAW,2BAA2B;IACxC,KAAK,EAAE,0BAA0B,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAgBD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,2BAA2B,EAAE,CAuBvF;AAKD,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAK7C,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAW9C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,OAAO,CAwBxF;AAED,wBAAgB,iCAAiC,CAC7C,OAAO,EAAE,MAAM,EACf,eAAe,GAAE,SAAS,MAAM,EAAO,GACxC,MAAM,GAAG,IAAI,CAMf;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAC9C,EAAE,EAAE,QAAQ,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzC,2BAA2B,EAAE,OAAO,CAAC;IACrC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,GAAG,wBAAwB,CA8D3B"}

package/dist/features/magic-context/dreamer/retrospective-orphan-sweep.d.ts

@@ -0,0 +1,48 @@
+import type { PluginContext } from "../../../plugin/types";
+import type { Database } from "../../../shared/sqlite";
+type OpencodeClient = PluginContext["client"];
+/**
+ * Privacy backstop for dreamer children that carry raw user or project text.
+ *
+ * These child sessions normally delete themselves in `finally`, but a hard
+ * SIGKILL/OOM BETWEEN session-create and that delete would leave their prompts
+ * on disk. This sweep removes such crash-orphaned children.
+ *
+ * CONCURRENCY: `session.delete` has no cross-process "active session" lease (OC
+ * peer confirmed), so the ONLY safe filter is AGE — a child older than any
+ * legitimate run cannot belong to a live run on another OpenCode process.
+ * OpenCode sets `title` + `time_created` immediately at create (not lazily), so
+ * the age gate is airtight. 404 on delete = already-swept = success.
+ */
+export declare const RETROSPECTIVE_CHILD_TITLE = "magic-context-dream-retrospective";
+export declare const USER_MEMORIES_CHILD_TITLE = "magic-context-dream-user-memories";
+export declare const CURATE_CHILD_TITLE = "magic-context-dream-curate";
+export declare const MAINTAIN_DOCS_CHILD_TITLE = "magic-context-dream-maintain-docs";
+export declare const REFRESH_PRIMERS_CHILD_TITLE = "magic-context-dream-refresh-primers";
+export declare const SMART_NOTE_COMPILE_CHILD_TITLE_PREFIX = "magic-context-smart-note-compile-";
+export declare const SMART_NOTE_CONFIRM_CHILD_TITLE_PREFIX = "magic-context-smart-note-confirm-";
+export declare const PRIVACY_SENSITIVE_CHILD_TASKS: readonly ["retrospective", "review-user-memories", "curate", "maintain-docs", "refresh-primers", "evaluate-smart-notes"];
+export interface PrivacySensitiveChildTitleMatches {
+    exact: readonly string[];
+    prefixes: readonly string[];
+}
+export declare const PRIVACY_SENSITIVE_CHILD_TITLE_MATCHES: PrivacySensitiveChildTitleMatches;
+/** Stale threshold from task timeout(s): max(60min, maxTimeout×3) — comfortably
+ *  past every swept child type so a live child is never swept. */
+export declare function retrospectiveOrphanStaleMs(taskTimeoutMinutes: number | undefined | readonly (number | undefined)[]): number;
+/**
+ * Delete crash-orphaned privacy-sensitive dreamer children for THIS project
+ * directory when they are older than `staleMs`. Best-effort + fail-open: any
+ * DB/schema/API error is logged and skipped (never throws into the caller's
+ * sweep). Returns the count deleted.
+ */
+export declare function sweepOrphanedRetrospectiveChildren(args: {
+    opencodeDb: Database | null;
+    client: OpencodeClient;
+    sessionDirectory: string;
+    staleMs: number;
+    titleMatches?: PrivacySensitiveChildTitleMatches;
+    now?: number;
+}): Promise<number>;
+export {};
+//# sourceMappingURL=retrospective-orphan-sweep.d.ts.map

package/dist/features/magic-context/dreamer/retrospective-orphan-sweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrospective-orphan-sweep.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/retrospective-orphan-sweep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,KAAK,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,sCAAsC,CAAC;AAC7E,eAAO,MAAM,yBAAyB,sCAAsC,CAAC;AAC7E,eAAO,MAAM,kBAAkB,+BAA+B,CAAC;AAC/D,eAAO,MAAM,yBAAyB,sCAAsC,CAAC;AAC7E,eAAO,MAAM,2BAA2B,wCAAwC,CAAC;AACjF,eAAO,MAAM,qCAAqC,sCAAsC,CAAC;AACzF,eAAO,MAAM,qCAAqC,sCAAsC,CAAC;AAEzF,eAAO,MAAM,6BAA6B,0HAOG,CAAC;AAE9C,MAAM,WAAW,iCAAiC;IAC9C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,eAAO,MAAM,qCAAqC,EAAE,iCASnD,CAAC;AAEF;kEACkE;AAClE,wBAAgB,0BAA0B,CACtC,kBAAkB,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GACzE,MAAM,CAUR;AAOD;;;;;GAKG;AACH,wBAAsB,kCAAkC,CAAC,IAAI,EAAE;IAC3D,UAAU,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,cAAc,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,iCAAiC,CAAC;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDlB"}

package/dist/features/magic-context/dreamer/retrospective-raw-provider.d.ts

@@ -0,0 +1,81 @@
+import type { Database } from "../../../shared/sqlite";
+export declare const RETROSPECTIVE_MAX_MESSAGES_PER_SESSION = 80;
+export declare const RETROSPECTIVE_MAX_MESSAGES_PER_RUN = 240;
+export declare const RETROSPECTIVE_MAX_SESSIONS_PER_RUN = 20;
+export type RetrospectiveMessageRole = "user" | "assistant" | "tool";
+export interface RetrospectiveProjectSession {
+    sessionId: string;
+    path?: string;
+    updatedAt?: number;
+}
+export interface RetrospectiveRawMessage {
+    sessionId: string;
+    ordinal: number;
+    role: RetrospectiveMessageRole;
+    text: string;
+    toolName?: string;
+    isError?: boolean;
+    ts: number;
+}
+/** A per-session since-read. `truncated` is the EXACT saturation signal (the
+ *  underlying read hit `capPerSession` with more rows available) — never inferred
+ *  from `messages.length`, because normalization both drops rows (assistant/empty)
+ *  and adds rows (one assistant message → many tool rows), so a length-based guess
+ *  can false-NEGATIVE and lose data. */
+export interface RetrospectiveSinceRead {
+    messages: RetrospectiveRawMessage[];
+    truncated: boolean;
+}
+export interface RetrospectiveRawProvider {
+    listProjectSessions(projectIdentity: string): RetrospectiveProjectSession[] | Promise<RetrospectiveProjectSession[]>;
+    readUserMessagesSince(sessionId: string, sinceMs: number, capPerSession: number): RetrospectiveSinceRead | Promise<RetrospectiveSinceRead>;
+    /** The ~`count` most recent typed USER messages at or before `beforeMs` — the
+     *  run-boundary overlap so friction spanning two runs isn't missed. */
+    readUserMessagesBefore(sessionId: string, beforeMs: number, count: number): RetrospectiveRawMessage[] | Promise<RetrospectiveRawMessage[]>;
+    /** Release any reused resources (e.g. a pooled DB handle) after a run. */
+    dispose?(): void;
+}
+interface OpenCodeRetrospectiveRawProviderDeps {
+    contextDb: Database;
+    openOpenCodeDb?: () => Database | null;
+    /** Test-only shortcut: when provided, this connection is not closed by the provider. */
+    opencodeDb?: Database;
+}
+export declare class OpenCodeRetrospectiveRawProvider implements RetrospectiveRawProvider {
+    private readonly deps;
+    private readonly openDb;
+    private sharedDb;
+    private sharedDbOpened;
+    constructor(deps: OpenCodeRetrospectiveRawProviderDeps);
+    listProjectSessions(projectIdentity: string): RetrospectiveProjectSession[];
+    private resolveDb;
+    readUserMessagesSince(sessionId: string, sinceMs: number, capPerSession: number): RetrospectiveSinceRead;
+    readUserMessagesBefore(sessionId: string, beforeMs: number, count: number): RetrospectiveRawMessage[];
+    /** Close the reused read-only handle. Safe to call multiple times. */
+    dispose(): void;
+}
+export interface RetrospectiveScanWindow {
+    /** All scanned messages (user rows + tool metadata), oldest→newest, ordinals
+     *  reassigned globally. Includes the pre-watermark overlap (user-only). */
+    messages: RetrospectiveRawMessage[];
+    /** The max message ts ACTUALLY scanned this run (the content watermark to
+     *  persist on completion). Never less than `watermarkMs` (overlap rows are
+     *  ≤ watermark and cannot pull it back). */
+    maxScannedTs: number;
+}
+/**
+ * The retrospective scan window for one run: everything new since the content
+ * watermark, PLUS the ~`overlapUserCount` user lines immediately before the
+ * watermark for sessions that have kept new rows (so friction straddling a run
+ * boundary isn't missed).
+ * The since portion carries user rows + tool metadata (the deepen context); the
+ * overlap portion is user-only (gate context). Ordinals are reassigned globally.
+ */
+export declare function readRetrospectiveScanWindow(provider: RetrospectiveRawProvider, projectIdentity: string, watermarkMs: number, overlapUserCount: number, options?: {
+    maxMessagesPerRun?: number;
+    capPerSession?: number;
+    maxSessionsPerRun?: number;
+}): Promise<RetrospectiveScanWindow>;
+export declare function sameResolvedPath(a: string, b: string): boolean;
+export {};
+//# sourceMappingURL=retrospective-raw-provider.d.ts.map

package/dist/features/magic-context/dreamer/retrospective-raw-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrospective-raw-provider.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/retrospective-raw-provider.ts"],"names":[],"mappings":"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"}

package/dist/features/magic-context/dreamer/storage-dream-runs.d.ts

@@ -10,6 +10,10 @@ export interface DreamRunMemoryChanges {
     deleted: number;
     archived: number;
     merged: number;
+    writtenIds?: number[];
+    deletedIds?: number[];
+    archivedIds?: number[];
+    mergedIds?: number[];
 }
 export interface DreamRunRow {
     id: number;
@@ -35,6 +39,10 @@ export interface DreamRunInput {
     smartNotesSurfaced: number;
     smartNotesPending: number;
     memoryChanges?: DreamRunMemoryChanges | null;
+    /** Dreamer child session that produced this run — lets the dashboard scope
+     *  the token join to this run (avoids cross-summing concurrent same-name
+     *  cross-project runs). null when no parent session was resolved. */
+    parentSessionId?: string | null;
 }
 export declare function insertDreamRun(db: Database, run: DreamRunInput): void;
 export declare function getDreamRuns(db: Database, projectPath: string, limit?: number): DreamRunRow[];

package/dist/features/magic-context/dreamer/storage-dream-runs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-dream-runs.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/storage-dream-runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAkC,MAAM,wBAAwB,CAAC;AAEvF,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAChD;AAwDD,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAarE;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,WAAW,EAAE,CAMzF"}
+{"version":3,"file":"storage-dream-runs.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/storage-dream-runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAkC,MAAM,wBAAwB,CAAC;AAEvF,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IAOf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC7C;;yEAEqE;IACrE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAwDD,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAcrE;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,WAAW,EAAE,CAMzF"}

package/dist/features/magic-context/dreamer/storage-task-schedule.d.ts

@@ -0,0 +1,82 @@
+import type { Database } from "../../../shared/sqlite";
+/**
+ * Per-task dreamer scheduling state (Dreamer v2). One row per (project, task):
+ * when it last ran, when it's next due, and its last outcome. Replaces the
+ * project-level `dream_queue` + the single `last_dream_at:<project>` key — drains
+ * run straight off this table + keyed leases (see lease.ts).
+ *
+ * Project-scoped, NOT session-scoped → intentionally absent from clearSession().
+ */
+export interface TaskScheduleStateRow {
+    projectPath: string;
+    task: string;
+    /** Epoch ms of the last actual run (success or fail). null = never run. */
+    lastRunAt: number | null;
+    /** Epoch ms of the next scheduled fire. null = never due (disabled / impossible cron). */
+    nextDueAt: number | null;
+    /** The cron `schedule` string `next_due_at` was last computed FROM. The
+     *  scheduler reconciles this against the live config each pass: when the
+     *  config schedule differs, `next_due_at` is recomputed so config is always
+     *  authoritative (a disabled/enabled/changed task takes effect immediately,
+     *  not only after the stale slot fires once). null on legacy rows. */
+    schedule: string | null;
+    lastStatus: "completed" | "failed" | "skipped" | null;
+    lastError: string | null;
+    retryCount: number;
+    /** LEGACY/INERT: the old verify commit watermark. Verify now gates per-memory
+     *  on each memory's own `verified_at` (map records the file→memory mapping
+     *  first), so no global commit watermark is written. Column kept (v43) to
+     *  avoid a DROP-COLUMN migration; field kept for a faithful round-trip. Do
+     *  NOT read it for new logic. */
+    lastCheckedCommit?: string | null;
+    /** LEGACY/INERT: the old internal broad-pass cadence watermark. Broad is now
+     *  its own scheduled task (`verify-broad`); nothing writes a meaningful value.
+     *  Column kept (v43) to avoid a DROP-COLUMN migration; field kept so the
+     *  COALESCE round-trip is faithful. Do NOT read it for new logic. */
+    lastBroadRunAt?: number | null;
+    /** retrospective CONTENT watermark: max message ts actually scanned. Distinct
+     *  from lastRunAt (schedule-completion time) — lastRunAt as a content cutoff
+     *  loses messages that arrive mid-run. Undefined on writes preserves the DB
+     *  value. */
+    retrospectiveWatermarkMs?: number | null;
+}
+export declare function getTaskScheduleState(db: Database, projectPath: string, task: string): TaskScheduleStateRow | null;
+export declare function getTaskScheduleStatesForProject(db: Database, projectPath: string): TaskScheduleStateRow[];
+/**
+ * Delete task_schedule_state rows for a project whose `task` is NOT in the given
+ * keep-set. Used to garbage-collect RETIRED task names (e.g. the v1
+ * improve/consolidate/archive-stale rows superseded by the verify/curate split):
+ * reconcile adds/updates canonical tasks but never removed obsolete rows, so they
+ * lingered forever as perpetually-"due" garbage that polluted the dashboard.
+ * Returns the number of rows deleted.
+ */
+export declare function pruneNonCanonicalTaskRows(db: Database, projectPath: string, canonicalTasks: readonly string[]): number;
+/**
+ * Delete ALL task_schedule_state rows for a project. Used to GC a fully-orphaned
+ * project — a `dir:<md5>` identity whose backing directory is gone (e.g. a
+ * finalized mason worktree). NEVER call this for a `git:` identity: that is
+ * shared across worktrees/clones of the same repo, so a single dead worktree
+ * must not delete the shared project's schedule. Returns rows deleted.
+ */
+export declare function deleteTaskScheduleRowsForProject(db: Database, projectPath: string): number;
+/**
+ * Idempotent first-seed: insert the row only if absent. Concurrent processes can
+ * both call this safely — ON CONFLICT DO NOTHING means the first writer wins and
+ * the second is a no-op (both compute the same next_due_at from the same cron).
+ */
+export declare function seedTaskScheduleState(db: Database, projectPath: string, task: string, nextDueAt: number | null, lastRunAt: number | null, schedule: string): void;
+/** Full upsert of a row's schedule fields (used on run completion / gate-skip /
+ *  retry advancement / schedule reconciliation). Callers that read-then-write
+ *  should wrap in BEGIN IMMEDIATE; run-completion writes are already
+ *  single-writer under the domain lease. */
+export declare function writeTaskScheduleState(db: Database, row: TaskScheduleStateRow): void;
+/**
+ * Source-window idempotence for the retrospective task. A friction window
+ * re-seen across the run-overlap (the ~12 user lines re-read before the
+ * watermark) must not re-extract the same learning. `windowKey` is a stable hash
+ * over the flagged user lines' (sessionId:ts) anchors — NOT prompt ordinals,
+ * which are batch-local and unstable.
+ */
+export declare function isRetrospectiveWindowProcessed(db: Database, projectPath: string, windowKey: string): boolean;
+export declare function recordRetrospectiveWindowProcessed(db: Database, projectPath: string, windowKey: string): void;
+//# sourceMappingURL=storage-task-schedule.d.ts.map

package/dist/features/magic-context/dreamer/storage-task-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-task-schedule.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/storage-task-schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;;;;GAOG;AAEH,MAAM,WAAW,oBAAoB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0FAA0F;IAC1F,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;0EAIsE;IACtE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC;IACtD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;qCAIiC;IACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;yEAGqE;IACrE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;iBAGa;IACb,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAmCD,wBAAgB,oBAAoB,CAChC,EAAE,EAAE,QAAQ,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACb,oBAAoB,GAAG,IAAI,CAO7B;AAED,wBAAgB,+BAA+B,CAC3C,EAAE,EAAE,QAAQ,EACZ,WAAW,EAAE,MAAM,GACpB,oBAAoB,EAAE,CAOxB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACrC,EAAE,EAAE,QAAQ,EACZ,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,SAAS,MAAM,EAAE,GAClC,MAAM,CASR;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAK1F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACjC,EAAE,EAAE,QAAQ,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,MAAM,GACjB,IAAI,CAIN;AAED;;;4CAG4C;AAC5C,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,oBAAoB,GAAG,IAAI,CA4BpF;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC1C,EAAE,EAAE,QAAQ,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAClB,OAAO,CAOT;AAED,wBAAgB,kCAAkC,CAC9C,EAAE,EAAE,QAAQ,EACZ,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAClB,IAAI,CAIN"}

package/dist/features/magic-context/dreamer/task-config.d.ts

@@ -0,0 +1,28 @@
+import type { DreamerConfig } from "../../../config/schema/magic-context";
+import { type DreamTaskName } from "./task-registry";
+import type { DreamTaskRuntimeConfig } from "./task-scheduler";
+/**
+ * Resolve the full per-task runtime config the scheduler consumes from the
+ * validated dreamer config: each task's schedule + its effective model chain
+ * (task override → dreamer-level default), thinking level, timeout, and
+ * task-specific params. One place owns the inheritance rule.
+ */
+export declare function buildDreamTaskRuntimeConfigs(dreamer: DreamerConfig): DreamTaskRuntimeConfig[];
+/**
+ * The collection privacy gate (Option C): user-behavior observation candidates
+ * are stored during historian runs ONLY when the user has scheduled the
+ * review-user-memories task (schedule != ""). Replaces the v1
+ * `user_memories.enabled` flag, which both gated collection AND review.
+ */
+export declare function userMemoryCollectionEnabled(dreamer: DreamerConfig | undefined): boolean;
+/** The promotion threshold for user-memory review (collection + review share it). */
+export declare function userMemoryPromotionThreshold(dreamer: DreamerConfig | undefined): number;
+/** True when a task is scheduled (schedule != ""). Generic enable check. */
+export declare function dreamTaskScheduled(dreamer: DreamerConfig | undefined, task: keyof NonNullable<DreamerConfig["tasks"]>): boolean;
+/** Names of the tasks the user has scheduled (schedule != ""), in canonical order. */
+export declare function enabledDreamTasks(dreamer: DreamerConfig | undefined): DreamTaskName[];
+/** A compact `/ctx-status`-style schedule summary, e.g.
+ *  "verify 0 3 * * *, curate 0 4 * * 0" — or "manual-only" when nothing is
+ *  scheduled. */
+export declare function summarizeDreamSchedule(dreamer: DreamerConfig | undefined): string;
+//# sourceMappingURL=task-config.d.ts.map

package/dist/features/magic-context/dreamer/task-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-config.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/task-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,sCAAsC,CAAC;AAE3F,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,aAAa,GAAG,sBAAsB,EAAE,CAyB7F;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAGvF;AAED,qFAAqF;AACrF,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAEvF;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,aAAa,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,GAChD,OAAO,CAGT;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa,EAAE,CAGrF;AAED;;iBAEiB;AACjB,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAIjF"}

package/dist/features/magic-context/dreamer/task-executor.d.ts

@@ -0,0 +1,49 @@
+import type { RawMessageProvider } from "../../../hooks/magic-context/read-session-chunk";
+import type { PluginContext } from "../../../plugin/types";
+import type { Database } from "../../../shared/sqlite";
+import { type RetrospectiveRawProvider } from "./retrospective-raw-provider";
+import { isAgenticTask } from "./task-registry";
+import type { TaskExecutor } from "./task-scheduler";
+export interface DreamTaskExecutorDeps {
+    client: PluginContext["client"];
+    /** Filesystem directory of the project this drain owns (NOT the identity). */
+    sessionDirectory: string;
+    /** Opens the OpenCode DB read-only (for the key-files candidate scan). The
+     *  dream-timer owns the path resolution; null when unavailable. */
+    openOpenCodeDb: () => Database | null;
+    retrospectiveRawProvider?: RetrospectiveRawProvider | ((db: Database, projectIdentity: string) => RetrospectiveRawProvider | null);
+    /** Host-side privacy gate for route="observation" learnings. */
+    userMemoryCollectionEnabled?: boolean;
+    /** Ensure the project embedding provider is registered before primer clustering embeds candidates. */
+    ensureProjectRegistered?: (directory: string, db: Database) => Promise<void> | void;
+    /**
+     * Pi only: builds a RawMessageProvider for an arbitrary historical session id
+     * so refresh-primers can render the orientation seed from Pi JSONL. OpenCode
+     * leaves this undefined (the seed read falls to the read-only opencode.db
+     * path). Returning null for a session → refresh falls back to closed-book.
+     */
+    primerRawProviderFactory?: (sessionId: string) => Promise<RawMessageProvider | null> | RawMessageProvider | null;
+}
+/**
+ * Build the TaskExecutor the v2 scheduler drives. The scheduler owns the keyed
+ * domain lease + holderId and hands them in; this executor runs one task's actual
+ * work (LLM loop / specialized runner), renews the lease during the run, aborts
+ * if the lease is lost, and writes one per-task dream_runs telemetry row.
+ */
+export declare function createDreamTaskExecutor(deps: DreamTaskExecutorDeps): TaskExecutor;
+/** Parse the gate's verdict. Expected shape: a single line `n` (no friction) or
+ *  `y: 3, 7` (flagged ordinals). Robust to a model that wraps it in prose:
+ *  - scan LINE BY LINE for the first verdict-leading line (`y`/`yes`/`n`/`no`);
+ *  - ordinals are taken ONLY from that verdict line (so a stray year/number in
+ *    surrounding prose can't fabricate a deepen);
+ *  - if no verdict-leading line exists, look for an embedded `y: <nums>` pattern;
+ *  - anything unparseable → NO hit (fail safe — the caller still advances the
+ *    watermark on a clean run, so a garbled verdict can't wedge progress).
+ *  A `y` with zero ordinals is NOT a hit (there are no lines to deepen on). */
+export declare function parseFrictionGateVerdict(verdict: string): {
+    hit: boolean;
+    ordinals: number[];
+};
+/** Re-export for the dream-timer's executor wiring. */
+export { isAgenticTask };
+//# sourceMappingURL=task-executor.d.ts.map

package/dist/features/magic-context/dreamer/task-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/task-executor.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAM3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAyBvD,OAAO,EAEH,KAAK,wBAAwB,EAEhC,MAAM,8BAA8B,CAAC;AAkBtC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAA2C,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAG9F,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAC;IACzB;uEACmE;IACnE,cAAc,EAAE,MAAM,QAAQ,GAAG,IAAI,CAAC;IACtC,wBAAwB,CAAC,EACnB,wBAAwB,GACxB,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,KAAK,wBAAwB,GAAG,IAAI,CAAC,CAAC;IACnF,gEAAgE;IAChE,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,sGAAsG;IACtG,uBAAuB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpF;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,CACvB,SAAS,EAAE,MAAM,KAChB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,kBAAkB,GAAG,IAAI,CAAC;CACvE;AAoDD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,YAAY,CAyRjF;AA4BD;;;;;;;;+EAQ+E;AAC/E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA+B9F;AAgdD,uDAAuD;AACvD,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/features/magic-context/dreamer/task-gates.d.ts

@@ -0,0 +1,29 @@
+import type { Database } from "../../../shared/sqlite";
+import type { DreamTaskName } from "./task-registry";
+/**
+ * Per-task activity gates (Dreamer v2 A+B). A due task runs ONLY if its gate
+ * passes, so cron cadence never burns a 60-turn agentic loop on an unchanged
+ * pool. Gates are conservative — allow when uncertain — and cheap (count
+ * queries, no full-row loads, no LLM).
+ *
+ * `lastRunAt` is the task's own `task_schedule_state.last_run_at` (null = never
+ * run → treat "changed since" gates as "is there anything at all").
+ */
+export interface TaskGateContext {
+    db: Database;
+    projectIdentity: string;
+    lastRunAt: number | null;
+    /** retrospective content watermark (max message ts scanned). Distinct from
+     *  lastRunAt: a session updated mid-run is newer than its scanned content but
+     *  older than the run-completion time, so gating on lastRunAt would skip it. */
+    retrospectiveWatermarkMs?: number | null;
+    /** review-user-memories: min candidate observations before a review is worthwhile. */
+    promotionThreshold: number;
+}
+/**
+ * Evaluate a task's activity gate. Returns true if the task has work to do.
+ * Throwing DB errors propagate to the caller (a gate that can't read is a real
+ * problem, not silently "no work").
+ */
+export declare function evaluateTaskGate(task: DreamTaskName, ctx: TaskGateContext): boolean;
+//# sourceMappingURL=task-gates.d.ts.map

package/dist/features/magic-context/dreamer/task-gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-gates.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/task-gates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAQvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;GAQG;AAEH,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;oFAEgF;IAChF,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,sFAAsF;IACtF,kBAAkB,EAAE,MAAM,CAAC;CAC9B;AA4DD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAoEnF"}

package/dist/features/magic-context/dreamer/task-prompts.d.ts

@@ -1,12 +1,40 @@
 import type { DreamingTask } from "../../../config/schema/magic-context";
-export declare const DREAMER_SYSTEM_PROMPT = "You are a memory maintenance agent for the magic-context system.\nYou run during scheduled dream windows to maintain a project's cross-session memory store and codebase documentation.\n\n## Available Tools\n\n**Memory operations** (ctx_memory with extended dreamer actions):\n- `action=\"list\"` \u2014 browse all active memories, optionally filter by category\n- `action=\"update\", ids=[N], content=\"...\"` \u2014 rewrite a memory's content\n- `action=\"merge\", ids=[N,M,...], content=\"...\", category=\"...\"` \u2014 consolidate duplicates into one canonical memory\n- `action=\"archive\", ids=[N], reason=\"...\"` \u2014 remove a stale memory (soft-archive, with provenance)\n- `action=\"write\", category=\"...\", content=\"...\"` \u2014 create a new memory\n\n**Codebase tools** (standard OpenCode tools):\n- Read files, grep, glob, bash \u2014 for verification against actual code\n\n## Rules\n\n1. **Work methodically.** Decide your own batch size based on the task \u2014 process as many items per round as makes sense.\n2. **Always verify against actual files** before declaring a memory stale or updating it.\n3. **Be conservative with archives.** Only archive when the codebase clearly contradicts the memory.\n4. **Explain reasoning briefly** before each action \u2014 one line is enough.\n5. **Use present-tense operational language** in all memory rewrites. \"X uses Y\" not \"X was changed to use Y.\"\n6. **One rule/fact per memory.** Split compound memories during improvement.\n7. **Never read or quote secrets** from .env, credentials, keys, or similar sensitive files.\n8. **Do not commit changes.** The user handles git operations.\n\n## Memory Taxonomy (5 categories)\n\nProject memory uses exactly 5 categories. Every memory belongs to one:\n- **PROJECT_RULES** \u2014 durable process/workflow rules for this repo (releases, commits, testing, debugging conventions).\n- **ARCHITECTURE** \u2014 load-bearing design decisions and WHY they hold (not WHAT a file does).\n- **CONSTRAINTS** \u2014 hard limits imposed by EXTERNAL systems (APIs, providers, platforms, protocols). Not our own code's behavior.\n- **CONFIG_VALUES** \u2014 stable configuration keys/values and conventions. Not transient measurements (test counts, sizes, versions).\n- **NAMING** \u2014 naming conventions and canonical names. Not inventories.\n\n**Legacy categories during transition:** older memories may still carry pre-v2 category names. When you touch one, map it to its 5-category home with `action=\"update\"` (or `merge`): WORKFLOW_RULES\u2192PROJECT_RULES, ARCHITECTURE_DECISIONS\u2192ARCHITECTURE, CONFIG_DEFAULTS\u2192CONFIG_VALUES, ENVIRONMENT\u2192CONFIG_VALUES (paths) or CONSTRAINTS, KNOWN_ISSUES\u2192CONSTRAINTS only if it's an external-system limit (otherwise archive \u2014 our own fixed bugs are not world facts). USER_DIRECTIVES / USER_PREFERENCES are NOT project categories \u2014 they live in the global user profile; archive project copies only when they add zero project-specific detail.";
-export declare function buildConsolidatePrompt(projectPath: string): string;
-export declare function buildVerifyPrompt(projectPath: string): string;
-export declare function buildArchiveStalePrompt(projectPath: string, userMemories?: Array<{
+/** Memory shape the curate prompt renders (verify now has its own runner/prompt). */
+export interface CuratePromptMemory {
     id: number;
+    category: string;
     content: string;
-}>): string;
-export declare function buildImprovePrompt(projectPath: string): string;
+    mappedFiles: string[];
+    hasNoFileSentinel: boolean;
+}
+export declare const DREAMER_SYSTEM_PROMPT = "You are a background maintenance agent for the magic-context system, running during a scheduled dream window. Your task and its full instructions arrive in the message below. Never read or quote secrets from .env, credentials, or key files, and never commit \u2014 the user handles git.";
+export declare const CURATE_SYSTEM_PROMPT = "You are a memory-pool curator for the magic-context system. You run during a scheduled dream window to keep a project's cross-session memory store lean and well-formed.\n\n## Memory operations (ctx_memory)\n- `action=\"list\"` \u2014 browse active memories, optionally filter by category\n- `action=\"merge\", ids=[N,M,...], content=\"...\", category=\"...\"` \u2014 consolidate duplicates into one canonical memory\n- `action=\"update\", ids=[N], content=\"...\"` \u2014 rewrite a memory's content\n- `action=\"write\", category=\"...\", content=\"...\"` \u2014 create a memory (SPLITS ONLY \u2014 never mint new facts)\n- `action=\"archive\", ids=[N], reason=\"...\"` \u2014 soft-archive a stale or low-value memory\n\n## Rules\n1. **Assume the pool is accurate.** A separate verify task checks memories against code. You handle QUALITY only \u2014 duplicates, wording, low-value entries \u2014 never correctness, and you do NOT read the codebase.\n2. **Work methodically.** Choose your own batch size.\n3. **Be conservative with archives.** Use the task's archive criteria.\n4. **Present-tense operational language.** \"X uses Y\" not \"X was changed to use Y.\"\n5. **One rule/fact per memory.**\n6. **Never mint new facts** \u2014 that is the historian's job. `write` is for splitting a compound memory only.\n\n## Memory taxonomy (5 categories)\n\nProject memory uses exactly 5 categories. Every memory belongs to one:\n- **PROJECT_RULES** \u2014 durable process/workflow rules for this repo (releases, commits, testing, debugging conventions).\n- **ARCHITECTURE** \u2014 load-bearing design decisions and WHY they hold (not WHAT a file does).\n- **CONSTRAINTS** \u2014 hard limits imposed by EXTERNAL systems (APIs, providers, platforms, protocols). Not our own code's behavior.\n- **CONFIG_VALUES** \u2014 stable configuration keys/values and conventions. Not transient measurements (test counts, sizes, versions).\n- **NAMING** \u2014 naming conventions and canonical names. Not inventories.\n\n**Legacy categories during transition:** older memories may still carry pre-v2 category names. When you touch one, map it to its 5-category home with `action=\"update\"` (or `merge`): WORKFLOW_RULES\u2192PROJECT_RULES, ARCHITECTURE_DECISIONS\u2192ARCHITECTURE, CONFIG_DEFAULTS\u2192CONFIG_VALUES, ENVIRONMENT\u2192CONFIG_VALUES (paths) or CONSTRAINTS, KNOWN_ISSUES\u2192CONSTRAINTS only if it's an external-system limit (otherwise archive \u2014 our own fixed bugs are not world facts). USER_DIRECTIVES / USER_PREFERENCES are NOT project categories \u2014 they live in the global user profile; archive project copies only when they add zero project-specific detail.";
+export declare const MAINTAIN_DOCS_SYSTEM_PROMPT = "You are a documentation maintainer for the magic-context system. You run during a scheduled dream window to keep a project's root `ARCHITECTURE.md` and `STRUCTURE.md` synchronized with the actual code.\n\n## Tools\n- Read files, grep, glob, bash \u2014 explore the codebase to verify current state.\n- Write / edit \u2014 update the two docs (project root only, never `.planning/`).\n\n## Rules\n- **NEVER touch protected regions.** Any content between `<!-- mc:protected START ... -->` and `<!-- mc:protected END -->` is hand-authored and cache-critical. Reproduce it BYTE-FOR-BYTE \u2014 do not edit, reword, reorder, summarize, trim, or drop a single line, and keep the marker comments. Only a human edits that region.\n- **Be prescriptive** (\"Use X pattern\", not \"X pattern is used\"). **Current state only** \u2014 no temporal language, no history.\n- **Verify before writing** \u2014 read the actual files, never guess. All file paths in the docs must point to files that exist.";
+export declare const REVIEW_USER_MEMORIES_SYSTEM_PROMPT = "You are a user-profile reviewer for the magic-context system. You run during a scheduled dream window to decide which recurring behavioral observations about the human user are real, persistent patterns worth keeping in their global user profile.\n\nYou do NOT call any tools and you do NOT touch project memories \u2014 you read the candidate observations the host gives you and return a JSON verdict. Distill durable patterns; never transcribe a single moment. Output only the JSON the task asks for, with no surrounding prose.";
+export declare const PRIMER_INVESTIGATOR_SYSTEM_PROMPT = "You are a read-only code investigator for the magic-context system. You run during a scheduled dream window to answer a single standing question about THIS codebase by reading its current source.\n\n## Tools (read-only)\n`read`, `grep`, `glob`, `aft_outline`, `aft_zoom`, `aft_search`. You have no write, edit, bash, or memory tools \u2014 you investigate and report, you change nothing.\n\n## Rules\n- **Ground every claim in code you actually opened this run.** Open the files the question points at and verify against them. A paraphrase that reads no files is not an answer.\n- **Answer directly and concretely** \u2014 name paths, symbols, and mechanisms, in present tense.";
+export declare function buildCuratePrompt(args: {
+    projectPath: string;
+    memories: CuratePromptMemory[];
+    userProfile?: string;
+}): string;
+export interface RetrospectivePromptEvent {
+    sessionId: string;
+    kind: string;
+    fields: Record<string, string>;
+    createdAt: number;
+}
+export declare const RETROSPECTIVE_SYSTEM_PROMPT = "You are a retrospective learning agent for Magic Context.\n\nYou learn only from recurring user-friction moments where the user had to correct, re-explain, or recover from the assistant's repeated behavior. You receive a pre-rendered friction window from the host and may use ctx_search to look for corroborating prior patterns.\n\nRules:\n1. Pattern, not one-off: extract only recurring behavior that is likely to happen again. Zero learnings is fine.\n2. Distill, do not transcribe: never quote the user, never include dates, and never preserve session-local anger.\n3. Root cause + correction: the learning must tell a future agent what to do differently.\n4. Privacy by host-apply: do not call memory-writing tools. Emit only the XML schema requested by the prompt.";
+/** Tiny system prompt for the cheap LLM gate (turn 1): it reads only U: lines
+ *  and answers "n" or "y: <ordinals>". Kept minimal so the gate is cheap. */
+export declare const FRICTION_GATE_SYSTEM_PROMPT = "You are a conservative friction detector for a coding agent. You read recent user message lines and decide whether the user was correcting, re-explaining to, or frustrated with the assistant. Output exactly one line and nothing else.";
+export declare function buildFrictionGatePrompt(args: {
+    userLines: string[];
+}): string;
+export declare function buildRetrospectivePrompt(args: {
+    projectPath: string;
+    frictionWindow: string;
+    events: RetrospectivePromptEvent[];
+}): string;
 export declare function buildMaintainDocsPrompt(projectPath: string, lastDreamAt: string | null, existingDocs: {
     architecture: boolean;
     structure: boolean;
@@ -22,5 +50,8 @@ export declare function buildDreamTaskPrompt(task: DreamingTask, args: {
         id: number;
         content: string;
     }>;
+    curate?: {
+        memories: CuratePromptMemory[];
+    };
 }): string;
 //# sourceMappingURL=task-prompts.d.ts.map

package/dist/features/magic-context/dreamer/task-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-prompts.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/task-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAIzE,eAAO,MAAM,qBAAqB,y8FAmCulB,CAAC;AAI1nB,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA+BlE;AAID,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAiC7D;AAID,wBAAgB,uBAAuB,CACnC,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACtD,MAAM,CA0ER;AAID,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA0C9D;AAID,wBAAgB,uBAAuB,CACnC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,YAAY,EAAE;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAC5D,MAAM,CAgDR;AA0GD,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE;QAAE,YAAY,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7D,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD,GACF,MAAM,CAiBR"}
+{"version":3,"file":"task-prompts.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/task-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;CAC9B;AAQD,eAAO,MAAM,qBAAqB,mSAA8R,CAAC;AAkBjU,eAAO,MAAM,oBAAoB,knFAiBN,CAAC;AAK5B,eAAO,MAAM,2BAA2B,g+BASqF,CAAC;AAK9H,eAAO,MAAM,kCAAkC,shBAEoO,CAAC;AAMpR,eAAO,MAAM,iCAAiC,0qBAOgD,CAAC;AAsB/F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAsBT;AAID,MAAM,WAAW,wBAAwB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,2BAA2B,swBAQsE,CAAC;AAE/G;6EAC6E;AAC7E,eAAO,MAAM,2BAA2B,8OACuM,CAAC;AAEhP,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CAS7E;AAcD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,wBAAwB,EAAE,CAAC;CACtC,GAAG,MAAM,CA2BT;AAID,wBAAgB,uBAAuB,CACnC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,YAAY,EAAE;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAC5D,MAAM,CAgDR;AA0GD,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE;QAAE,YAAY,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7D,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE;QACL,QAAQ,EAAE,kBAAkB,EAAE,CAAC;KAClC,CAAC;CACL,GACF,MAAM,CAeR"}

package/dist/features/magic-context/dreamer/task-registry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Canonical Dreamer v2 task registry (pure — no DB imports, so the config schema
+ * can import the task names without pulling runtime code).
+ *
+ * v2 promotes the former post-phases (review-user-memories, key-files,
+ * evaluate-smart-notes) to first-class scheduled tasks alongside the agentic
+ * maintenance tasks, and assigns each a LEASE DOMAIN so disjoint-state tasks run
+ * concurrently while memory-mutating tasks serialize. See lease.ts + the A+B spec.
+ */
+export declare const CANONICAL_DREAM_TASKS: readonly ["map-memories", "verify", "verify-broad", "curate", "classify-memories", "retrospective", "maintain-docs", "evaluate-smart-notes", "review-user-memories", "promote-primers", "refresh-primers"];
+export type DreamTaskName = (typeof CANONICAL_DREAM_TASKS)[number];
+/**
+ * The agentic tasks — those run as a generic dreamer agent session driven by
+ * `buildDreamTaskPrompt`. The other canonical tasks (map-memories, verify,
+ * verify-broad, classify-memories, review-user-memories, evaluate-smart-notes,
+ * primers, retrospective) have their own specialized runners and do NOT go
+ * through the prompt builder.
+ */
+export declare const AGENTIC_DREAM_TASKS: readonly ["curate", "maintain-docs"];
+export type AgenticDreamTask = (typeof AGENTIC_DREAM_TASKS)[number];
+export declare function isAgenticTask(task: DreamTaskName): task is AgenticDreamTask;
+/**
+ * Tasks that read-modify-write the project `memories` table (+ epoch +
+ * supersede-delta rows). They SHARE one per-project "memory" lease so they
+ * serialize with each other — concurrent runs race semantically (stale-view
+ * merges/splits). Canonical run order when several are due in one drain.
+ */
+export declare const MEMORY_DOMAIN_TASKS: readonly DreamTaskName[];
+/**
+ * Lease KIND per task. `memory` + the three independent kinds are per-project;
+ * `user-memories` is GLOBAL (mutates the cross-project user-profile pool, so two
+ * different projects' dreamers must not review concurrently).
+ */
+export type LeaseKind = "memory" | "maintain-docs" | "evaluate-smart-notes" | "user-memories";
+export declare function leaseKindFor(task: DreamTaskName): LeaseKind;
+/**
+ * Resolve the concrete lease key for a task in a project. The global
+ * `user-memories` lease is NOT project-scoped (one reviewer across all projects);
+ * every other domain is keyed by project so different projects never block.
+ */
+export declare function leaseKeyFor(task: DreamTaskName, projectIdentity: string): string;
+export declare function isCanonicalDreamTask(value: string): value is DreamTaskName;
+/**
+ * Stable canonical ordering used when multiple due tasks share a lease domain
+ * (preserves the suite order for the memory domain).
+ */
+export declare function compareTaskOrder(a: DreamTaskName, b: DreamTaskName): number;
+//# sourceMappingURL=task-registry.d.ts.map

package/dist/features/magic-context/dreamer/task-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-registry.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/dreamer/task-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,qBAAqB,4MAcxB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,sCAAuC,CAAC;AAExE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,IAAI,gBAAgB,CAE3E;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,aAAa,EASvD,CAAC;AAIF;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,eAAe,GAAG,sBAAsB,GAAG,eAAe,CAAC;AAE9F,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAgB3D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAGhF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAE1E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,MAAM,CAE3E"}