dsh-continual-evolve 0.11.0 → 0.12.0

package/lib/recall.d.ts

@@ -1,85 +0,0 @@
-/**
- * Targeted memory recall (P1): the precise-reading counterpart of the cheap
- * directory index.
- *
- * The injected directory view (`inject.ts`) shows one line per entry and the
- * full `evolve_list` dumps whole stores; neither answers "give me everything
- * about X". Recall fills that gap: filter by query/kind/scope/memory-type,
- * rank with the same CJK BM25 machinery as injection, and return full
- * content plus source, version, and staleness signals. Read-only — it never
- * mutates a store.
- */
-import type { EvolutionEngine } from "./service.js";
-import type { HarnessScope, RefinementKind } from "./types.js";
-/** Memory recall types (the `memoryType` taxonomy, not entry kinds). */
-export declare const RECALL_MEMORY_TYPES: readonly ["user", "feedback", "project", "reference"];
-export type RecallMemoryType = (typeof RECALL_MEMORY_TYPES)[number];
-/** Default and maximum hits returned per recall call. */
-export declare const DEFAULT_RECALL_LIMIT = 10;
-export declare const MAX_RECALL_LIMIT = 50;
-export interface RecallFilters {
-    /** Free-text relevance query; empty means "most recently updated first". */
-    query?: string;
-    /** Entry kinds to search; default is memory only. */
-    kinds?: RefinementKind[];
-    /** Stores to search; default is local + project + global. */
-    scopes?: HarnessScope[];
-    /** Memory-type filter (applies to memory entries only). */
-    memoryTypes?: RecallMemoryType[];
-    /** Maximum hits; clamped to 1..50, defaults to 10. */
-    limit?: number;
-    /** Include archived entries; default false. */
-    includeArchived?: boolean;
-}
-/** One recalled entry with full content and provenance. */
-export interface RecallHit {
-    scope: HarnessScope;
-    kind: RefinementKind;
-    id: string;
-    title: string;
-    content: string;
-    path: string;
-    version: number;
-    createdAt: string;
-    updatedAt: string;
-    archived: boolean;
-    /** Memory-type hook for memory entries; undefined for other kinds. */
-    memoryType?: string;
-    /** Conflict-hint stamp left by the promotion guard, when present. */
-    staleHint?: string;
-    /** Session the entry was distilled from, when recorded. */
-    sourceSession?: string;
-    /** Source user-message seqs, when recorded. */
-    sourceSeqs?: number[];
-}
-export interface RecallResult {
-    hits: RecallHit[];
-    /** Skipped scopes with reasons (read-path honesty: never silently drop a store). */
-    notes: string[];
-    /** Candidates seen before ranking/truncation. */
-    totalCandidates: number;
-}
-export interface RecallContext {
-    /** Live session id for the local store; absent → local is skipped with a note. */
-    sessionId?: string | undefined;
-    /** Resolved project key; absent → project is skipped with a note. */
-    projectKey?: string | undefined;
-}
-/**
- * Search the harness stores with mechanical filters and BM25 ranking.
- *
- * @param engine The evolution engine (read-only use).
- * @param context Store identities for the session-scoped stores.
- * @param filters Query/kind/scope/type/limit/archive filters.
- * @returns Ranked hits plus a note for every scope that could not be read.
- * @throws On an unknown kind, scope, or memory type — fail loud instead of
- *         silently narrowing the search.
- */
-export declare function recallMemories(engine: EvolutionEngine, context: RecallContext, filters?: RecallFilters): RecallResult;
-/**
- * Render recall hits for a model or human reader: full content, version,
- * source, and staleness on every hit; skipped scopes are always shown so
- * "no results" can never hide an unread store.
- */
-export declare function formatRecallResult(result: RecallResult, query?: string): string;
-//# sourceMappingURL=recall.d.ts.map

package/lib/recall.js

@@ -1,142 +0,0 @@
-import { buildRelevanceIndex, relevanceScore } from "./search.js";
-import { CONFLICT_HINT_KEY } from "./types.js";
-import { isArchived, isMemoryType, ARCHIVED_AT_KEY, MEMORY_TYPE_KEY, SOURCE_SEQS_KEY, SOURCE_SESSION_KEY } from "./types.js";
-/** Memory recall types (the `memoryType` taxonomy, not entry kinds). */
-export const RECALL_MEMORY_TYPES = ["user", "feedback", "project", "reference"];
-/** Entry kinds recall can filter on; memory is the default. */
-const RECALL_KINDS = ["prompt", "memory", "skill", "subagent"];
-/** Default and maximum hits returned per recall call. */
-export const DEFAULT_RECALL_LIMIT = 10;
-export const MAX_RECALL_LIMIT = 50;
-/**
- * Search the harness stores with mechanical filters and BM25 ranking.
- *
- * @param engine The evolution engine (read-only use).
- * @param context Store identities for the session-scoped stores.
- * @param filters Query/kind/scope/type/limit/archive filters.
- * @returns Ranked hits plus a note for every scope that could not be read.
- * @throws On an unknown kind, scope, or memory type — fail loud instead of
- *         silently narrowing the search.
- */
-export function recallMemories(engine, context, filters = {}) {
-    const kinds = filters.kinds ?? ["memory"];
-    for (const kind of kinds) {
-        if (!RECALL_KINDS.includes(kind)) {
-            throw new Error(`evolve_recall: unknown kind "${kind}" (expected one of ${RECALL_KINDS.join(", ")})`);
-        }
-    }
-    const scopes = filters.scopes ?? ["local", "project", "global"];
-    for (const scope of scopes) {
-        if (scope !== "local" && scope !== "project" && scope !== "global") {
-            throw new Error(`evolve_recall: unknown scope "${scope}" (expected local, project, or global)`);
-        }
-    }
-    const memoryTypes = filters.memoryTypes ?? [];
-    for (const memoryType of memoryTypes) {
-        if (!RECALL_MEMORY_TYPES.includes(memoryType)) {
-            throw new Error(`evolve_recall: unknown memoryType "${memoryType}" (expected one of ${RECALL_MEMORY_TYPES.join(", ")})`);
-        }
-    }
-    const limit = typeof filters.limit === "number" && Number.isFinite(filters.limit) && filters.limit > 0
-        ? Math.min(Math.floor(filters.limit), MAX_RECALL_LIMIT)
-        : DEFAULT_RECALL_LIMIT;
-    const query = filters.query?.trim() ?? "";
-    const candidates = [];
-    const notes = [];
-    for (const scope of scopes) {
-        const storeId = scope === "local" ? context.sessionId : scope === "project" ? context.projectKey : undefined;
-        if (scope !== "global" && storeId === undefined) {
-            notes.push(`${scope} store skipped: ${scope === "local" ? "no live session id" : "no project key for this session"}`);
-            continue;
-        }
-        let state;
-        try {
-            state = engine.load(scope, storeId);
-        }
-        catch (cause) {
-            notes.push(`${scope} store unreadable: ${cause instanceof Error ? cause.message : String(cause)}`);
-            continue;
-        }
-        for (const kind of kinds) {
-            for (const entry of Object.values(state.entries[kind])) {
-                if (!filters.includeArchived && isArchived(entry))
-                    continue;
-                if (kind === "memory" && memoryTypes.length > 0) {
-                    const type = entry.metadata[MEMORY_TYPE_KEY];
-                    if (typeof type !== "string" || !memoryTypes.includes(type))
-                        continue;
-                }
-                candidates.push(entry);
-            }
-        }
-    }
-    const ranked = query.length > 0 ? rankByRelevance(candidates, query) : [...candidates].sort((a, b) => (a.updated_at < b.updated_at ? 1 : a.updated_at > b.updated_at ? -1 : 0));
-    return { hits: ranked.slice(0, limit).map(toRecallHit), notes, totalCandidates: candidates.length };
-}
-function rankByRelevance(candidates, query) {
-    const index = buildRelevanceIndex(candidates);
-    const normalized = query.trim().toLowerCase();
-    return candidates
-        .map((entry) => {
-        let score = relevanceScore(index, entry, query);
-        // Exact scope:id addressing wins over fuzzy relevance (the
-        // memory-agent manifest search precedent).
-        if (`${entry.scope}:${entry.id}`.toLowerCase() === normalized)
-            score += 1000;
-        return { entry, score };
-    })
-        .filter((hit) => hit.score > 0)
-        .sort((a, b) => b.score - a.score || (a.entry.updated_at < b.entry.updated_at ? 1 : -1))
-        .map((hit) => hit.entry);
-}
-function toRecallHit(entry) {
-    const memoryType = entry.kind === "memory" && isMemoryType(entry.metadata[MEMORY_TYPE_KEY])
-        ? String(entry.metadata[MEMORY_TYPE_KEY])
-        : undefined;
-    const staleHint = typeof entry.metadata[CONFLICT_HINT_KEY] === "string" && entry.metadata[CONFLICT_HINT_KEY].length > 0
-        ? String(entry.metadata[CONFLICT_HINT_KEY])
-        : undefined;
-    const sourceSession = typeof entry.metadata[SOURCE_SESSION_KEY] === "string" ? String(entry.metadata[SOURCE_SESSION_KEY]) : undefined;
-    const rawSeqs = entry.metadata[SOURCE_SEQS_KEY];
-    const sourceSeqs = Array.isArray(rawSeqs) && rawSeqs.every((seq) => typeof seq === "number") ? rawSeqs : undefined;
-    return {
-        scope: entry.scope,
-        kind: entry.kind,
-        id: entry.id,
-        title: entry.title,
-        content: entry.content,
-        path: entry.path,
-        version: entry.version,
-        createdAt: entry.created_at,
-        updatedAt: entry.updated_at,
-        archived: isArchived(entry),
-        ...(memoryType !== undefined ? { memoryType } : {}),
-        ...(staleHint !== undefined ? { staleHint } : {}),
-        ...(sourceSession !== undefined ? { sourceSession } : {}),
-        ...(sourceSeqs !== undefined ? { sourceSeqs } : {}),
-    };
-}
-/**
- * Render recall hits for a model or human reader: full content, version,
- * source, and staleness on every hit; skipped scopes are always shown so
- * "no results" can never hide an unread store.
- */
-export function formatRecallResult(result, query) {
-    const lines = [`recall: ${result.hits.length} hit(s)${query?.trim() ? ` for "${query.trim()}"` : ""} (${result.totalCandidates} candidate(s))`];
-    for (const hit of result.hits) {
-        const type = hit.memoryType !== undefined ? ` · type=${hit.memoryType}` : "";
-        const archived = hit.archived ? " · archived" : "";
-        const stale = hit.staleHint !== undefined ? ` · conflict-hint=${hit.staleHint}` : "";
-        const source = hit.sourceSession !== undefined ? ` · src=${hit.sourceSession}${hit.sourceSeqs ? `:${hit.sourceSeqs.join(",")}` : ""}` : "";
-        lines.push(`- [${hit.scope}:${hit.kind}:${hit.id}] ${hit.title} (v${hit.version}${type}${archived}${stale}${source})`);
-        lines.push(`  ${hit.content}`);
-    }
-    for (const note of result.notes) {
-        lines.push(`note: ${note}`);
-    }
-    if (result.hits.length === 0) {
-        lines.push(`(${ARCHIVED_AT_KEY} entries are hidden unless includeArchived is set)`);
-    }
-    return lines.join("\n");
-}
-//# sourceMappingURL=recall.js.map

package/lib/record-language.d.ts

@@ -1,85 +0,0 @@
-/**
- * Record language resolution for evolution writes.
- *
- * Every durable record (refinement summary/rationale, entry title/content,
- * review and wrap-up verdicts) is generated prose. Its language is resolved
- * per call through one chain — never hardcoded at any single site:
- *
- * 1. explicit `recordLanguage` plugin config (`zh`|`en`; `auto` defers);
- * 2. the durable DSH client preference (`locale` namespace, `preference`
- *    field — the same source the desktop shell and the web GUI follow);
- * 3. detection over recent direct user text (Han-character signal);
- * 4. `en`, matching the DSH `FALLBACK_LOCALE`.
- *
- * The durable-preference read is intentionally fail-open: the settings
- * service is host-owned and its shape may drift, so any mismatch yields
- * `undefined` and the chain moves on instead of breaking the evolution run.
- */
-/** Natural languages evolution records are authored in. */
-export type RecordLanguage = "zh" | "en";
-/** Plugin-facing preference: an explicit language or deferral to detection. */
-export type RecordLanguagePreference = "auto" | RecordLanguage;
-/**
- * Upstream durable-settings address reused verbatim
- * (`@deepseek-ai/dsh-client-locale`: `LOCALE_SETTINGS_NAMESPACE`,
- * `LOCALE_PREFERENCE_FIELD`). New keys are never invented here.
- */
-export declare const DSH_LOCALE_NAMESPACE = "locale";
-export declare const DSH_LOCALE_PREFERENCE_FIELD = "preference";
-/**
- * Detect Chinese from user text by Han-character density.
- *
- * @param text Arbitrary user-supplied text.
- * @returns `"zh"` on sufficient Han signal, otherwise `undefined` (no
- *          signal — never a default; the resolver owns the fallback).
- */
-export declare function detectLanguageFromText(text: string): RecordLanguage | undefined;
-/**
- * Read the durable DSH client language preference through the host settings
- * service. Fail-open by contract: a missing service, a throwing read, an
- * async-shaped reply, or an unknown value all yield `undefined`.
- *
- * The service is resolved through `ctx.get("settings")` (the global registry),
- * which sees services provided by sibling plugin entries. A direct
- * `ctx.settings` walks only the caller's fiber ancestor chain and throws
- * "cannot get property \"settings\" without inject" — the same failure mode
- * documented in `goal.ts` — and a throw here would abort the whole snapshot
- * gate, so the property access itself is guarded. Plain-object contexts
- * (tests, non-Cordis hosts) fall back to the direct property.
- *
- * @param ctx Cordis context that may carry the host settings service.
- * @returns The stored preference (`zh`/`en`, subtag-tolerant) or `undefined`.
- */
-export declare function durableLocalePreference(ctx: unknown): string | undefined;
-/**
- * Normalize an explicit preference or durable value to a record language.
- *
- * @param value Candidate language id (config or durable preference).
- * @returns `"zh"`/`"en"` on a recognized id, otherwise `undefined`.
- */
-export declare function normalizeRecordLanguage(value: string | undefined): RecordLanguage | undefined;
-export interface ResolveRecordLanguageInput {
-    /** Explicit plugin config; absent/`auto` defers to the chain below. */
-    configured?: RecordLanguagePreference | undefined;
-    /** Host context for the durable-preference read; absent skips that tier. */
-    ctx?: unknown;
-    /** Recent direct user text for the detection tier; absent skips it. */
-    trajectoryText?: string;
-}
-/**
- * Resolve the authoring language for one evolution write.
- *
- * @param input Configured preference, host context, and trajectory sample.
- * @returns The winning language; always defined (`en` is the final fallback).
- */
-export declare function resolveRecordLanguage(input: ResolveRecordLanguageInput): RecordLanguage;
-/**
- * The one-line prompt addendum appended to every record-authoring system
- * prompt. Machine contracts (JSON keys, ids, paths, code) stay untouched —
- * only natural-language values follow the resolved language.
- *
- * @param lang Resolved record language.
- * @returns The instruction line for `lang`.
- */
-export declare function recordLanguageInstruction(lang: RecordLanguage): string;
-//# sourceMappingURL=record-language.d.ts.map

package/lib/record-language.js

@@ -1,152 +0,0 @@
-/**
- * Record language resolution for evolution writes.
- *
- * Every durable record (refinement summary/rationale, entry title/content,
- * review and wrap-up verdicts) is generated prose. Its language is resolved
- * per call through one chain — never hardcoded at any single site:
- *
- * 1. explicit `recordLanguage` plugin config (`zh`|`en`; `auto` defers);
- * 2. the durable DSH client preference (`locale` namespace, `preference`
- *    field — the same source the desktop shell and the web GUI follow);
- * 3. detection over recent direct user text (Han-character signal);
- * 4. `en`, matching the DSH `FALLBACK_LOCALE`.
- *
- * The durable-preference read is intentionally fail-open: the settings
- * service is host-owned and its shape may drift, so any mismatch yields
- * `undefined` and the chain moves on instead of breaking the evolution run.
- */
-/**
- * Upstream durable-settings address reused verbatim
- * (`@deepseek-ai/dsh-client-locale`: `LOCALE_SETTINGS_NAMESPACE`,
- * `LOCALE_PREFERENCE_FIELD`). New keys are never invented here.
- */
-export const DSH_LOCALE_NAMESPACE = "locale";
-export const DSH_LOCALE_PREFERENCE_FIELD = "preference";
-/** Han ideographs — the detection signal for Chinese user text. */
-const HAN_PATTERN = /[\u4e00-\u9fff]/g;
-/** Minimum Han hits to count as signal (stray characters must not flip). */
-const HAN_SIGNAL_MIN = 5;
-/** Detection scans a bounded prefix; trajectories are long and the signal is dense. */
-const DETECT_SCAN_CHARS = 4000;
-/**
- * Detect Chinese from user text by Han-character density.
- *
- * @param text Arbitrary user-supplied text.
- * @returns `"zh"` on sufficient Han signal, otherwise `undefined` (no
- *          signal — never a default; the resolver owns the fallback).
- */
-export function detectLanguageFromText(text) {
-    const hits = (text.slice(0, DETECT_SCAN_CHARS).match(HAN_PATTERN) ?? []).length;
-    return hits >= HAN_SIGNAL_MIN ? "zh" : undefined;
-}
-/**
- * Read the durable DSH client language preference through the host settings
- * service. Fail-open by contract: a missing service, a throwing read, an
- * async-shaped reply, or an unknown value all yield `undefined`.
- *
- * The service is resolved through `ctx.get("settings")` (the global registry),
- * which sees services provided by sibling plugin entries. A direct
- * `ctx.settings` walks only the caller's fiber ancestor chain and throws
- * "cannot get property \"settings\" without inject" — the same failure mode
- * documented in `goal.ts` — and a throw here would abort the whole snapshot
- * gate, so the property access itself is guarded. Plain-object contexts
- * (tests, non-Cordis hosts) fall back to the direct property.
- *
- * @param ctx Cordis context that may carry the host settings service.
- * @returns The stored preference (`zh`/`en`, subtag-tolerant) or `undefined`.
- */
-export function durableLocalePreference(ctx) {
-    if (typeof ctx !== "object" || ctx === null)
-        return undefined;
-    let settings;
-    try {
-        const get = ctx.get;
-        settings = typeof get === "function" ? get.call(ctx, "settings") : undefined;
-        if (settings === undefined)
-            settings = ctx.settings;
-    }
-    catch {
-        return undefined;
-    }
-    if (typeof settings !== "object" || settings === null)
-        return undefined;
-    const describe = settings.describe;
-    if (typeof describe !== "function")
-        return undefined;
-    let rows;
-    try {
-        rows = describe({ redactSecrets: true });
-    }
-    catch {
-        return undefined;
-    }
-    if (!Array.isArray(rows))
-        return undefined;
-    for (const row of rows) {
-        if (typeof row !== "object" || row === null)
-            continue;
-        const record = row;
-        if (record["ns"] !== DSH_LOCALE_NAMESPACE)
-            continue;
-        const value = record["value"];
-        if (typeof value !== "object" || value === null)
-            return undefined;
-        const preference = value[DSH_LOCALE_PREFERENCE_FIELD];
-        if (typeof preference !== "string")
-            return undefined;
-        const id = preference.toLowerCase();
-        if (id === "zh" || id.startsWith("zh-"))
-            return "zh";
-        if (id === "en" || id.startsWith("en-"))
-            return "en";
-        return undefined;
-    }
-    return undefined;
-}
-/**
- * Normalize an explicit preference or durable value to a record language.
- *
- * @param value Candidate language id (config or durable preference).
- * @returns `"zh"`/`"en"` on a recognized id, otherwise `undefined`.
- */
-export function normalizeRecordLanguage(value) {
-    if (value === "zh" || value === "en")
-        return value;
-    return undefined;
-}
-/**
- * Resolve the authoring language for one evolution write.
- *
- * @param input Configured preference, host context, and trajectory sample.
- * @returns The winning language; always defined (`en` is the final fallback).
- */
-export function resolveRecordLanguage(input) {
-    const configured = normalizeRecordLanguage(input.configured === "auto" ? undefined : input.configured);
-    if (configured !== undefined)
-        return configured;
-    if (input.ctx !== undefined) {
-        const durable = normalizeRecordLanguage(durableLocalePreference(input.ctx));
-        if (durable !== undefined)
-            return durable;
-    }
-    if (input.trajectoryText !== undefined) {
-        const detected = detectLanguageFromText(input.trajectoryText);
-        if (detected !== undefined)
-            return detected;
-    }
-    return "en";
-}
-/**
- * The one-line prompt addendum appended to every record-authoring system
- * prompt. Machine contracts (JSON keys, ids, paths, code) stay untouched —
- * only natural-language values follow the resolved language.
- *
- * @param lang Resolved record language.
- * @returns The instruction line for `lang`.
- */
-export function recordLanguageInstruction(lang) {
-    return lang === "zh"
-        ? "记录语言：用简体中文写所有的自然语言值（title、content、summary、rationale、reason、expectedOutcome）。JSON 键名、id、path 与代码片段保持原样。"
-        : "Record language: write all natural-language values (title, content, summary, rationale, reason, expectedOutcome) in English. Keep JSON keys, ids, paths, and code snippets unchanged.";
-}
-//# sourceMappingURL=record-language.js.map

package/lib/render.d.ts

@@ -1,13 +0,0 @@
-/**
- * Prompt rendering: bounded, model-visible views of harness state and
- * refinement history. Every cap exists to keep token cost predictable no
- * matter how large the store grows.
- */
-import type { HarnessEntry, HarnessState, RefinementResult } from "./types.js";
-export declare function compactText(text: string, maxLength: number): string;
-export declare function entryLine(entry: HarnessEntry, maxContentLength: number): string;
-/** Render the full merged state as a bounded overview for the system prompt. */
-export declare function formatHarnessStateForPrompt(state: HarnessState): string;
-/** Render recent refinement results for the planner. */
-export declare function historyForPrompt(history: readonly RefinementResult[]): string;
-//# sourceMappingURL=render.d.ts.map

package/lib/render.js

@@ -1,80 +0,0 @@
-import { SOURCE_SESSION_KEY, SOURCE_SEQS_KEY, isArchived } from "./types.js";
-const DEFAULT_MAX_ENTRIES_PER_KIND = 6;
-const DEFAULT_MAX_REFINEMENTS = 5;
-const DEFAULT_MAX_CONTENT_LENGTH = 180;
-export function compactText(text, maxLength) {
-    const normalized = text.replace(/\s+/g, " ").trim();
-    if (normalized.length <= maxLength) {
-        return normalized;
-    }
-    return `${normalized.slice(0, Math.max(0, maxLength - 3))}...`;
-}
-export function entryLine(entry, maxContentLength) {
-    const argumentsText = entry.kind === "skill" && Object.keys(entry.arguments).length > 0
-        ? ` args=${compactText(JSON.stringify(entry.arguments), maxContentLength)}`
-        : "";
-    const referenceText = entry.kind === "skill" && Object.keys(entry.reference).length > 0
-        ? ` ref=${compactText(JSON.stringify(entry.reference), maxContentLength)}`
-        : "";
-    const citationText = citationSuffix(entry);
-    const archivedText = isArchived(entry) ? " [archived]" : "";
-    const formText = entry.kind === "skill" && entry.skill_kind === "guidance" ? " [guidance]" : "";
-    return `- [${entry.scope}:${entry.id}] ${entry.title} (${entry.path}, v${entry.version})${archivedText}${formText}${referenceText}${argumentsText}${citationText}: ${compactText(entry.content, maxContentLength)}`;
-}
-/** Trajectory citation suffix (` src=sessionId:1,2`), empty when uncited. */
-function citationSuffix(entry) {
-    const sessionId = entry.metadata[SOURCE_SESSION_KEY];
-    if (typeof sessionId !== "string" || sessionId.length === 0) {
-        return "";
-    }
-    const seqs = entry.metadata[SOURCE_SEQS_KEY];
-    const seqText = Array.isArray(seqs) && seqs.length > 0 ? `:${seqs.join(",")}` : "";
-    return ` src=${sessionId}${seqText}`;
-}
-/** Render the full merged state as a bounded overview for the system prompt. */
-export function formatHarnessStateForPrompt(state) {
-    const lines = [
-        "# Continual Harness State",
-        "",
-        "Local entries belong to this session. Global entries persist across sessions.",
-        "The base system prompt is immutable; prompt entries are supplemental notes only.",
-        "",
-    ];
-    let total = 0;
-    for (const kind of Object.keys(state.entries)) {
-        const entries = Object.values(state.entries[kind]).sort((a, b) => [a.path, a.title, a.id].join("\0").localeCompare([b.path, b.title, b.id].join("\0")));
-        total += entries.length;
-        lines.push(`${kind}: ${entries.length}`);
-        for (const entry of entries.slice(0, DEFAULT_MAX_ENTRIES_PER_KIND)) {
-            lines.push(entryLine(entry, DEFAULT_MAX_CONTENT_LENGTH));
-        }
-        const overflow = entries.length - Math.min(entries.length, DEFAULT_MAX_ENTRIES_PER_KIND);
-        if (overflow > 0) {
-            lines.push(`- +${overflow} more ${kind} entries`);
-        }
-        lines.push("");
-    }
-    if (total === 0) {
-        lines.push("No saved harness entries yet.", "");
-    }
-    lines.push(`recent refinements: ${state.refinements.length}`);
-    for (const event of state.refinements.slice(-DEFAULT_MAX_REFINEMENTS)) {
-        lines.push(`- [${event.id}] ${compactText(event.trigger, DEFAULT_MAX_CONTENT_LENGTH)}: ${event.changes.join(", ") || "no applied edits"}`);
-    }
-    return lines.join("\n").trim();
-}
-/** Render recent refinement results for the planner. */
-export function historyForPrompt(history) {
-    if (history.length === 0) {
-        return "No prior refinement history.";
-    }
-    return history
-        .slice(-20)
-        .map((item) => {
-        const edits = item.appliedEdits.map((e) => `${e.applied ? "applied" : "failed"} ${e.action} ${e.kind}:${e.id}`).join(", ");
-        const rollback = item.rollbackOf ? ` rollbackOf=${item.rollbackOf}` : "";
-        return `[${item.id}]${rollback} ${item.summary}\n${edits}\nExpected outcome: ${item.expectedOutcome}`;
-    })
-        .join("\n\n");
-}
-//# sourceMappingURL=render.js.map

package/lib/review-scheduler.d.ts

@@ -1,38 +0,0 @@
-/**
- * Serial latest-boundary scheduler for automatic memory+review snapshots.
- *
- * One runner exists per session. A burst is coalesced by durable cursor rather
- * than promise arrival: once multiple pending captures settle, the highest
- * comparable boundary runs first. A cursor advances only after success/no-op;
- * errors, aborts, and stale boundaries leave it unchanged.
- */
-/** Compare two scheduler cursors; undefined means the cursor families differ. */
-/** Terminal state of one scheduled snapshot. */
-export type ReviewSchedulerStatus = "success" | "no-op" | "error" | "aborted";
-/** A scheduler execution receives the exact snapshot and its owner signal. */
-export interface ReviewSchedulerExecution<TSnapshot> {
-    readonly snapshot: TSnapshot;
-    readonly signal: AbortSignal;
-}
-/** Public scheduler surface used by the auto-review driver and tests. */
-export interface ReviewScheduler<TSnapshot> {
-    /** Wait until the current run and all coalesced pending work settle. */
-    drain(): Promise<void>;
-    /** Last successfully processed or skipped snapshot boundary. */
-    getCursor(): string | undefined;
-    /** Whether a run or a pending acquisition exists. */
-    hasPendingWork(): boolean;
-    /** Submit a snapshot (or an async acquisition) without blocking the caller. */
-    schedule(snapshot: TSnapshot | Promise<TSnapshot>): void;
-    /** Abort the owner signal, drop pending work, and make later schedules no-ops. */
-    shutdown(): void;
-}
-/**
- * Create a scheduler with ZCode-compatible serial/coalescing semantics.
- *
- * @param execute - one serial extraction/review operation
- * @param cursorOf - extracts the durable boundary from a snapshot
- */
-export declare function createReviewScheduler<TSnapshot>(execute: (input: ReviewSchedulerExecution<TSnapshot>) => Promise<ReviewSchedulerStatus>, cursorOf: (snapshot: TSnapshot) => string | undefined): ReviewScheduler<TSnapshot>;
-export { compareReviewCursors } from "./turn-snapshot.js";
-//# sourceMappingURL=review-scheduler.d.ts.map