dsh-continual-evolve 0.11.0 → 0.12.1

package/lib/index.d.ts

@@ -1,101 +1,52 @@
+/**
+ * dsh-continual-evolve — plugin entry.
+ *
+ * After the 2026-10-04 ZCode-alignment teardown the plugin is one thing: a
+ * session-start system-prompt section that injects the workspace memory
+ * index (`<cwd>/.evolve/memory/MEMORY.md`), hands out the store path, and
+ * teaches the when-to-save guide. The model reads and writes the markdown
+ * files with its native tools; there are no plugin tools, no commands, no
+ * background extraction, and no governance. See
+ * .agents/notes/implemented/architecture/2026-10-04-zcode-alignment-teardown.md.
+ *
+ * The 2026-10-04 plugin-management card adds a read-only surface: the
+ * workspace roots the section has served feed an in-memory allowlist, and a
+ * `webServer` route pair projects any known workspace's store for the card
+ * in the official plugin manager (`plugins.bundle.config`, client bundle in
+ * client/client.js). The card is a viewer — see
+ * .agents/notes/implemented/feature/2026-10-04-plugin-management-card.md.
+ *
+ * The host API surface is declared locally (the minimal shape this plugin
+ * touches) instead of importing the DSH type packages — the section call is
+ * the same one every prior release used, verified in production.
+ */
 import z from "@deepseek-ai/schemastery";
-import type { Context } from "@deepseek-ai/cordis";
-import { type EvolutionEngine } from "./service.js";
 export declare const name = "continual-evolve";
-/** Service key under which the evolution engine is published. */
-export declare const EVOLUTION_SERVICE = "evolution";
 export declare const inject: string[];
+/** The minimal host surface this plugin touches. */
+interface SectionContext {
+    agent?: unknown;
+}
+interface HostContext {
+    systemPrompt: {
+        section(section: {
+            name: string;
+            order: number;
+            text: string | ((context: SectionContext) => string);
+        }): void;
+    };
+    logger(name: string): {
+        info(message: string): void;
+        warn(message: string): void;
+    };
+}
 export declare const Config: z<Schemastery.ObjectS<NoInfer<{
-    /** Root for evolution stores; defaults to the resolved DSH home. */
-    baseDir: z<string, string, "plain">;
-    /** System-prompt section order for the evolution guidance. */
-    sectionOrder: z<number, number, "defined">;
-    /** Initial Memory Agent default when no `evolve/runtime.json` exists; not a registration gate. */
-    autoReview: z<boolean, boolean, "defined">;
-    /** ZCode-style minimum lexical words in one direct user text part. */
-    memoryMinUserWords: z<number, number, "defined">;
-    /**
-     * Session-close bounded drain for in-flight extraction, in milliseconds.
-     * Absent → 15s; 0 restores the legacy immediate abort on dispose.
-     */
-    sessionCloseDrainMs: z<number, number, "defined">;
-    /** Trajectory slice handed to the extractor, in characters. */
-    maxReviewInputChars: z<number, number, "defined">;
-    /** Output budget for the cheap gate call. */
-    reviewBudgetTokens: z<number, number, "defined">;
     /**
-     * Planner prefix-cache routing for the gate and planner inputs: `auto`
-     * prepends a session-derived message prefix when the session shows
-     * cache-read evidence (dropping the redundant flat trajectory text),
-     * `session` always prefixes, `off` keeps the legacy flat-text input.
-     */
-    plannerPrefixCache: z<"session" | "auto" | "off", "session" | "auto" | "off", "defined">;
-    /** Session-prefix budget for Route A planning inputs, in characters. */
-    plannerPrefixMaxChars: z<number, number, "defined">;
-    /** After an approved gate run with applied edits, queue a visible follow-up notice. */
-    notifyOnAutoReview: z<boolean, boolean, "defined">;
-    /** Cross-session (global) edits require an explicit human approval. */
-    requireGlobalApproval: z<boolean, boolean, "defined">;
-    /**
-     * Authoring language for evolution records (refinement summaries,
-     * rationales, entry titles/content, review and wrap-up verdicts).
-     * `auto` follows the DSH client language (durable `locale.preference`,
-     * then trajectory detection, then `en`); `zh`/`en` pin it.
-     */
-    recordLanguage: z<"auto" | "zh" | "en", "auto" | "zh" | "en", "defined">;
-    /** Skills root for materialized skill entries; defaults to <dshHome>/skills. */
-    skillsDir: z<string, string, "plain">;
-    /** Passphrase for rubric encryption; falls back to DSH_EVOLVE_RUBRIC_KEY, then a local key file. */
-    rubricKey: z<string, string, "plain">;
-    /** Write all cordis log messages to <baseDir>/evolve/plugin.log (JSONL). */
-    logToFile: z<boolean, boolean, "defined">;
-    /** File log level: 0=error, 1=info, 2=warn, 3=debug. */
-    logLevel: z<number, number, "defined">;
-    /** Rotate the file log when it exceeds this many bytes. */
-    logMaxBytes: z<number, number, "defined">;
-    /** After a benchmark decision rejects a candidate, roll the refinement back automatically. */
-    autoRollbackOnReject: z<boolean, boolean, "defined">;
-    /**
-     * P1 auto-case capture: failed evolution attempts (benchmark-rejected
-     * candidates, gate proposals without consent) land as draft cases in the
-     * auto-regression container benchmark, seeding the regression loop.
-     */
-    autoCase: z<boolean, boolean, "defined">;
-    /**
-     * Optional model override for the memory extractor (cheaper model).
-     * Format: "provider/model" or just "model" (same provider as the agent).
-     * When absent, the extractor uses the agent's own provider/model.
-     */
-    reviewModel: z<string, string, "plain">;
-    /**
-     * Goal-blocked moment: after this many CONSECUTIVE idle probes that
-     * observe the session goal in phase "blocked", run one memory extraction
-     * so the stuck encounter is distilled. 0 disables.
-     */
-    goalBlockedWrapupTurns: z<number, number, "defined">;
-    /**
-     * Promotion policy (2026-08-22): regex sources whose match in a
-     * candidate's title/content marks it project-scoped — such entries are
-     * never promoted to the cross-session global store. Replaces the built-in
-     * defaults when set.
-     */
-    /**
-     * Promotion policy (2026-08-22): regex sources whose match in a
-     * candidate's title/content marks it project-scoped — such entries are
-     * never promoted to the cross-session global store. Replaces the built-in
-     * defaults when set.
-     */
-    promotionBlockPatterns: z<string[], string[], "plain">;
-    /** Whole promotions below this content length stay local (chars). */
-    promotionMinChars: z<number, number, "defined">;
-    /** Entry-directory lines injected per build before folding into a counter. */
-    injectionDirectoryLines: z<number, number, "defined">;
-    /**
-     * evolve v2 memory index: the section that injects memory CONTENT (not just
-     * an id/title directory) at session start, frozen per session to keep the
-     * system prompt byte-stable (prompt cache). `enabled`/`guide`/`order`/
-     * `maxChars` default to true/true/400/6000; with `guide` off and an empty
-     * store the section renders to "" and costs no tokens.
+     * The memory section: injects the workspace memory index at session
+     * start, frozen per session to keep the system prompt byte-stable
+     * (prompt cache). `enabled`/`guide`/`order`/`maxChars` default to
+     * true/true/400/6000; with `guide` off and an empty store the section
+     * renders to "" and costs no tokens.
      */
     memoryIndex: z<Schemastery.ObjectS<NoInfer<{
         enabled: z<boolean, boolean, "plain">;
@@ -109,115 +60,23 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         maxChars: z<number, number, "plain">;
     }>>, "plain">;
     /**
-     * Storage hygiene (#20): how much append-only past each write keeps.
-     * `snapshots` = full-state copies per store, `refinements` = tail lines
-     * per store history, `reviews` = tail lines of the shared audit trail,
-     * `tokenUsage` = tail lines of the direct-call token ledger.
-     * Absent fields fall back to the store defaults (20 / 500 / 500 / 500) —
-     * rollback needs recent snapshots, readers need a recent window.
+     * The read-only memory card in the official plugin manager
+     * (`plugins.bundle.config`). Defaults to on; hosts without the
+     * `webServer` service or the `plugins.bundle.config` slot degrade to no
+     * card, with the memory section unaffected.
      */
-    historyRetain: z<Schemastery.ObjectS<NoInfer<{
-        snapshots: z<number, number, "plain">;
-        refinements: z<number, number, "plain">;
-        reviews: z<number, number, "plain">;
-        tokenUsage: z<number, number, "plain">;
+    memoryCard: z<Schemastery.ObjectS<NoInfer<{
+        enabled: z<boolean, boolean, "plain">;
     }>>, Schemastery.ObjectT<NoInfer<{
-        snapshots: z<number, number, "plain">;
-        refinements: z<number, number, "plain">;
-        reviews: z<number, number, "plain">;
-        tokenUsage: z<number, number, "plain">;
+        enabled: z<boolean, boolean, "plain">;
     }>>, "plain">;
 }>>, Schemastery.ObjectT<NoInfer<{
-    /** Root for evolution stores; defaults to the resolved DSH home. */
-    baseDir: z<string, string, "plain">;
-    /** System-prompt section order for the evolution guidance. */
-    sectionOrder: z<number, number, "defined">;
-    /** Initial Memory Agent default when no `evolve/runtime.json` exists; not a registration gate. */
-    autoReview: z<boolean, boolean, "defined">;
-    /** ZCode-style minimum lexical words in one direct user text part. */
-    memoryMinUserWords: z<number, number, "defined">;
-    /**
-     * Session-close bounded drain for in-flight extraction, in milliseconds.
-     * Absent → 15s; 0 restores the legacy immediate abort on dispose.
-     */
-    sessionCloseDrainMs: z<number, number, "defined">;
-    /** Trajectory slice handed to the extractor, in characters. */
-    maxReviewInputChars: z<number, number, "defined">;
-    /** Output budget for the cheap gate call. */
-    reviewBudgetTokens: z<number, number, "defined">;
-    /**
-     * Planner prefix-cache routing for the gate and planner inputs: `auto`
-     * prepends a session-derived message prefix when the session shows
-     * cache-read evidence (dropping the redundant flat trajectory text),
-     * `session` always prefixes, `off` keeps the legacy flat-text input.
-     */
-    plannerPrefixCache: z<"session" | "auto" | "off", "session" | "auto" | "off", "defined">;
-    /** Session-prefix budget for Route A planning inputs, in characters. */
-    plannerPrefixMaxChars: z<number, number, "defined">;
-    /** After an approved gate run with applied edits, queue a visible follow-up notice. */
-    notifyOnAutoReview: z<boolean, boolean, "defined">;
-    /** Cross-session (global) edits require an explicit human approval. */
-    requireGlobalApproval: z<boolean, boolean, "defined">;
-    /**
-     * Authoring language for evolution records (refinement summaries,
-     * rationales, entry titles/content, review and wrap-up verdicts).
-     * `auto` follows the DSH client language (durable `locale.preference`,
-     * then trajectory detection, then `en`); `zh`/`en` pin it.
-     */
-    recordLanguage: z<"auto" | "zh" | "en", "auto" | "zh" | "en", "defined">;
-    /** Skills root for materialized skill entries; defaults to <dshHome>/skills. */
-    skillsDir: z<string, string, "plain">;
-    /** Passphrase for rubric encryption; falls back to DSH_EVOLVE_RUBRIC_KEY, then a local key file. */
-    rubricKey: z<string, string, "plain">;
-    /** Write all cordis log messages to <baseDir>/evolve/plugin.log (JSONL). */
-    logToFile: z<boolean, boolean, "defined">;
-    /** File log level: 0=error, 1=info, 2=warn, 3=debug. */
-    logLevel: z<number, number, "defined">;
-    /** Rotate the file log when it exceeds this many bytes. */
-    logMaxBytes: z<number, number, "defined">;
-    /** After a benchmark decision rejects a candidate, roll the refinement back automatically. */
-    autoRollbackOnReject: z<boolean, boolean, "defined">;
-    /**
-     * P1 auto-case capture: failed evolution attempts (benchmark-rejected
-     * candidates, gate proposals without consent) land as draft cases in the
-     * auto-regression container benchmark, seeding the regression loop.
-     */
-    autoCase: z<boolean, boolean, "defined">;
-    /**
-     * Optional model override for the memory extractor (cheaper model).
-     * Format: "provider/model" or just "model" (same provider as the agent).
-     * When absent, the extractor uses the agent's own provider/model.
-     */
-    reviewModel: z<string, string, "plain">;
-    /**
-     * Goal-blocked moment: after this many CONSECUTIVE idle probes that
-     * observe the session goal in phase "blocked", run one memory extraction
-     * so the stuck encounter is distilled. 0 disables.
-     */
-    goalBlockedWrapupTurns: z<number, number, "defined">;
-    /**
-     * Promotion policy (2026-08-22): regex sources whose match in a
-     * candidate's title/content marks it project-scoped — such entries are
-     * never promoted to the cross-session global store. Replaces the built-in
-     * defaults when set.
-     */
     /**
-     * Promotion policy (2026-08-22): regex sources whose match in a
-     * candidate's title/content marks it project-scoped — such entries are
-     * never promoted to the cross-session global store. Replaces the built-in
-     * defaults when set.
-     */
-    promotionBlockPatterns: z<string[], string[], "plain">;
-    /** Whole promotions below this content length stay local (chars). */
-    promotionMinChars: z<number, number, "defined">;
-    /** Entry-directory lines injected per build before folding into a counter. */
-    injectionDirectoryLines: z<number, number, "defined">;
-    /**
-     * evolve v2 memory index: the section that injects memory CONTENT (not just
-     * an id/title directory) at session start, frozen per session to keep the
-     * system prompt byte-stable (prompt cache). `enabled`/`guide`/`order`/
-     * `maxChars` default to true/true/400/6000; with `guide` off and an empty
-     * store the section renders to "" and costs no tokens.
+     * The memory section: injects the workspace memory index at session
+     * start, frozen per session to keep the system prompt byte-stable
+     * (prompt cache). `enabled`/`guide`/`order`/`maxChars` default to
+     * true/true/400/6000; with `guide` off and an empty store the section
+     * renders to "" and costs no tokens.
      */
     memoryIndex: z<Schemastery.ObjectS<NoInfer<{
         enabled: z<boolean, boolean, "plain">;
@@ -231,23 +90,15 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
         maxChars: z<number, number, "plain">;
     }>>, "plain">;
     /**
-     * Storage hygiene (#20): how much append-only past each write keeps.
-     * `snapshots` = full-state copies per store, `refinements` = tail lines
-     * per store history, `reviews` = tail lines of the shared audit trail,
-     * `tokenUsage` = tail lines of the direct-call token ledger.
-     * Absent fields fall back to the store defaults (20 / 500 / 500 / 500) —
-     * rollback needs recent snapshots, readers need a recent window.
+     * The read-only memory card in the official plugin manager
+     * (`plugins.bundle.config`). Defaults to on; hosts without the
+     * `webServer` service or the `plugins.bundle.config` slot degrade to no
+     * card, with the memory section unaffected.
      */
-    historyRetain: z<Schemastery.ObjectS<NoInfer<{
-        snapshots: z<number, number, "plain">;
-        refinements: z<number, number, "plain">;
-        reviews: z<number, number, "plain">;
-        tokenUsage: z<number, number, "plain">;
+    memoryCard: z<Schemastery.ObjectS<NoInfer<{
+        enabled: z<boolean, boolean, "plain">;
     }>>, Schemastery.ObjectT<NoInfer<{
-        snapshots: z<number, number, "plain">;
-        refinements: z<number, number, "plain">;
-        reviews: z<number, number, "plain">;
-        tokenUsage: z<number, number, "plain">;
+        enabled: z<boolean, boolean, "plain">;
     }>>, "plain">;
 }>>, "plain">;
 /**
@@ -255,9 +106,6 @@ export declare const Config: z<Schemastery.ObjectS<NoInfer<{
  * Derived from the schemastery schema — single source of truth, no manual sync.
  */
 export type EvolveConfig = Partial<Schemastery.TypeT<typeof Config>>;
-export interface EvolutionService {
-    readonly engine: EvolutionEngine;
-    readonly baseDir: string;
-}
-export declare function apply(ctx: Context, config: EvolveConfig): void;
+export declare function apply(host: HostContext, config: EvolveConfig): void;
+export {};
 //# sourceMappingURL=index.d.ts.map