dsh-continual-evolve 0.10.6 → 0.12.0

package/lib/goal-command.js

@@ -1,37 +0,0 @@
-import { blockEvolutionGoal, completeEvolutionGoal, goalServiceOf, goalStatusText, upsertEvolutionGoal } from "./goal.js";
-function success(text) {
-    return { kind: "success", text };
-}
-function error(text) {
-    return { kind: "error", text };
-}
-export function executeGoalCommand(ctx, invocation, rest) {
-    const agent = invocation.agent;
-    const goals = goalServiceOf(ctx);
-    if (!goals) {
-        return error(`/evolve goal requires the goals service (load @deepseek-ai/dsh-goal)`);
-    }
-    const sub = rest[0] ?? "";
-    try {
-        if (sub === "done") {
-            const view = completeEvolutionGoal(ctx, agent);
-            return view ? success(`evolution goal completed: ${goalStatusText(view)}`) : success("(no goal to complete)");
-        }
-        if (sub === "block") {
-            const reason = rest.slice(1).join(" ") || "user requested block";
-            const view = blockEvolutionGoal(ctx, agent, reason);
-            return view ? success(`evolution goal blocked: ${goalStatusText(view)}`) : success("(no active goal to block)");
-        }
-        if (sub.length === 0) {
-            const current = goals.get(agent);
-            return current ? success(goalStatusText(current)) : success("(no evolution goal — /evolve goal <objective> to create one)");
-        }
-        const objective = rest.join(" ");
-        const view = upsertEvolutionGoal(ctx, agent, objective);
-        return success(`evolution goal ready: ${goalStatusText(view)}\n(active goal drives the review gate every round)`);
-    }
-    catch (cause) {
-        return error(cause instanceof Error ? cause.message : String(cause));
-    }
-}
-//# sourceMappingURL=goal-command.js.map

package/lib/goal.d.ts

@@ -1,72 +0,0 @@
-/**
- * Goal-driven evolution rounds (v3 optional item, design.md §6): a
- * same-session goal turns the auto-review into a per-round driver — while a
- * goal is active, the review gate runs every round instead of every
- * `reviewIntervalTurns`, so the "continual evolution loop" is driven by the
- * goal's round machine (goal-round-driver keeps the session continuing) and
- * stops when the goal is completed or blocked.
- *
- * The goal service (`ctx.goals`) is resolved lazily and never required
- * (FAQ #1 discipline): without it, `/evolve goal` reports the feature
- * unavailable and auto-review keeps its plain interval.
- */
-import type { Context } from "@deepseek-ai/cordis";
-import type { Agent } from "@deepseek-ai/dsh-agent";
-/** The durable goal phases we drive on. */
-export type GoalPhase = "active" | "paused" | "blocked" | "complete";
-/** Minimal structural view of a goal view (duck-typed against dsh-goal). */
-export interface GoalViewLike {
-    readonly id: string;
-    readonly revision: number;
-    readonly objective: string;
-    readonly phase: GoalPhase;
-    readonly maxGoalRounds: number;
-}
-export interface GoalRefLike {
-    readonly id: string;
-    readonly revision: number;
-}
-export interface GoalServiceLike {
-    get(agent: Agent): GoalViewLike | undefined;
-    create(agent: Agent, request: {
-        objective: string;
-        maxGoalRounds?: number;
-    }): GoalViewLike;
-    edit(agent: Agent, ref: GoalRefLike, request: {
-        objective?: string;
-        maxGoalRounds?: number;
-    }): GoalViewLike;
-    complete(agent: Agent, ref: GoalRefLike): GoalViewLike;
-    block?(agent: Agent, ref: GoalRefLike, reason: {
-        code: string;
-        reason: string;
-    }): GoalViewLike;
-}
-/** The default objective used by `/evolve goal` without an explicit one. */
-export declare const DEFAULT_EVOLVE_GOAL_OBJECTIVE = "\u6301\u7EED\u8FDB\u5316\u672C\u4F1A\u8BDD harness \u72B6\u6001\uFF1A\u6BCF\u8F6E\u6C89\u6DC0\u53EF\u590D\u7528\u7ECF\u9A8C\uFF08\u5931\u8D25/\u6218\u672F/\u4E8B\u5B9E/\u59D4\u6D3E\u89C4\u683C\uFF09\uFF0C\u4FDD\u6301\u6761\u76EE\u5C0F\u800C\u5E26\u8BC1\u636E";
-/**
- * Resolve the goal service lazily; undefined when the profile lacks it.
- * Uses `ctx.get("goals")` (the global service registry) — a direct property
- * access like `ctx.goals` walks only the caller's fiber ancestor chain and
- * throws "cannot get property \"goals\" without inject" for services
- * provided by sibling plugin entries (the goal plugin is a sibling of this
- * one in the profile tree).
- */
-export declare function goalServiceOf(ctx: Context): GoalServiceLike | undefined;
-/** True when a goal view exists and is in a round-driving phase (active). */
-export declare function goalDrivesRounds(view: GoalViewLike | undefined): boolean;
-/** True when a goal exists at all (any phase) — used to gate create vs edit. */
-export declare function goalExists(view: GoalViewLike | undefined): view is GoalViewLike;
-/** Human-readable one-line status for a goal view. */
-export declare function goalStatusText(view: GoalViewLike): string;
-/**
- * Create or edit the session's evolution goal. With no current goal: create.
- * With a current goal: edit its objective (create-on-first-use semantics are
- * enforced by the goal service itself; completed goals may be replaced).
- */
-export declare function upsertEvolutionGoal(ctx: Context, agent: Agent, objective?: string): GoalViewLike;
-/** Complete the current goal, returning the completed view or undefined. */
-export declare function completeEvolutionGoal(ctx: Context, agent: Agent): GoalViewLike | undefined;
-/** Block the current goal with a reason (when the service supports it). */
-export declare function blockEvolutionGoal(ctx: Context, agent: Agent, reason: string): GoalViewLike | undefined;
-//# sourceMappingURL=goal.d.ts.map

package/lib/goal.js

@@ -1,72 +0,0 @@
-/** The default objective used by `/evolve goal` without an explicit one. */
-export const DEFAULT_EVOLVE_GOAL_OBJECTIVE = "持续进化本会话 harness 状态：每轮沉淀可复用经验（失败/战术/事实/委派规格），保持条目小而带证据";
-/**
- * Resolve the goal service lazily; undefined when the profile lacks it.
- * Uses `ctx.get("goals")` (the global service registry) — a direct property
- * access like `ctx.goals` walks only the caller's fiber ancestor chain and
- * throws "cannot get property \"goals\" without inject" for services
- * provided by sibling plugin entries (the goal plugin is a sibling of this
- * one in the profile tree).
- */
-export function goalServiceOf(ctx) {
-    return ctx.get("goals");
-}
-/** True when a goal view exists and is in a round-driving phase (active). */
-export function goalDrivesRounds(view) {
-    return view?.phase === "active";
-}
-/** True when a goal exists at all (any phase) — used to gate create vs edit. */
-export function goalExists(view) {
-    return view !== undefined;
-}
-/** Human-readable one-line status for a goal view. */
-export function goalStatusText(view) {
-    const rounds = typeof view.roundsStarted === "number"
-        ? String(view.roundsStarted)
-        : "?";
-    return `[${view.phase}] ${view.objective} (rounds=${rounds}/${view.maxGoalRounds}, revision=${view.revision})`;
-}
-/**
- * Create or edit the session's evolution goal. With no current goal: create.
- * With a current goal: edit its objective (create-on-first-use semantics are
- * enforced by the goal service itself; completed goals may be replaced).
- */
-export function upsertEvolutionGoal(ctx, agent, objective) {
-    const goals = goalServiceOf(ctx);
-    if (!goals) {
-        throw new Error("evolve: /evolve goal requires the goals service (load @deepseek-ai/dsh-goal)");
-    }
-    const current = goals.get(agent);
-    const nextObjective = objective && objective.length > 0 ? objective : DEFAULT_EVOLVE_GOAL_OBJECTIVE;
-    if (goalExists(current)) {
-        if (current.phase === "active" || current.phase === "paused") {
-            return goals.edit(agent, { id: current.id, revision: current.revision }, { objective: nextObjective });
-        }
-    }
-    return goals.create(agent, { objective: nextObjective });
-}
-/** Complete the current goal, returning the completed view or undefined. */
-export function completeEvolutionGoal(ctx, agent) {
-    const goals = goalServiceOf(ctx);
-    if (!goals) {
-        throw new Error("evolve: /evolve goal requires the goals service (load @deepseek-ai/dsh-goal)");
-    }
-    const current = goals.get(agent);
-    if (!goalExists(current) || current.phase === "complete") {
-        return current;
-    }
-    return goals.complete(agent, { id: current.id, revision: current.revision });
-}
-/** Block the current goal with a reason (when the service supports it). */
-export function blockEvolutionGoal(ctx, agent, reason) {
-    const goals = goalServiceOf(ctx);
-    if (!goals || typeof goals.block !== "function") {
-        return undefined;
-    }
-    const current = goals.get(agent);
-    if (!goalExists(current) || current.phase !== "active") {
-        return current;
-    }
-    return goals.block(agent, { id: current.id, revision: current.revision }, { code: "evolve-blocked", reason });
-}
-//# sourceMappingURL=goal.js.map

package/lib/inject.d.ts

@@ -1,196 +0,0 @@
-/**
- * Real prompt/spec injection: the dynamic system-prompt section that makes
- * `prompt` entries visible to the model without a tool call, and `subagent`
- * entries available as reusable delegation specs at the delegation seam.
- *
- * Design (design.md §7 Phase 2):
- * - the section text is a provider evaluated at every assembly with the
- *   assembling agent; a section that renders to "" is dropped by the prompt
- *   renderer, so an empty store costs zero tokens;
- * - prompt entries render as an additive section (the base system prompt is
- *   never touched); subagent entries render as delegation specs the parent
- *   follows when delegating, and are inherited by child agents through the
- *   `SessionHeader.parentSession` chain so a freshly spawned subagent carries
- *   its parent's specs without any provider wrapping;
- * - every cap mirrors render.ts (6 entries/kind, 180 chars/entry, stable
- *   sort), keeping the injected cost bounded no matter how the store grows;
- * - full text stays one `evolve_list` call away: the injected block is a
- *   summary index, not a duplicate of the store.
- */
-import type { HarnessEntry, HarnessState } from "./types.js";
-import type { EvolutionEngine } from "./service.js";
-import { tokenize } from "./search.js";
-/** CJK-bigram tokenizer re-exported for ranking consumers (see search.ts). */
-export { tokenize };
-/** Prompt sections render at most this many entries per kind. */
-export declare const MAX_INJECTED_ENTRIES_PER_KIND = 6;
-/** Per-entry content budget inside the injected block (matches render.ts). */
-export declare const MAX_INJECTED_CONTENT_LENGTH = 180;
-/** How many `parentSession` hops a child walks to inherit entries. */
-export declare const MAX_PARENT_CHAIN_DEPTH = 8;
-/** Recency half-life for the injection ranking: an entry this old scores 0. */
-export declare const RECENCY_HALF_LIFE_MS: number;
-/** At most this many recent user messages feed the relevance query. */
-export declare const MAX_QUERY_MESSAGES = 3;
-/** Query text handed to the relevance scorer is capped at this many chars. */
-export declare const MAX_QUERY_CHARS = 400;
-/** A user-message event's durable shape, loosened for duck typing. */
-export interface UserMessageEventLike {
-    type?: string;
-    data?: {
-        content?: unknown;
-        source?: {
-            kind?: string;
-        };
-    };
-}
-/** The minimal agent shape the section provider needs (duck-typed). */
-export interface AgentLike {
-    id: string;
-    session?: {
-        header?: {
-            parentSession?: string;
-        };
-        /**
-         * Live append-only session log as the public `session.events` getter.
-         * Typed loosely (`unknown[]`) so the real `SessionEvent[]` union from
-         * dsh-session is assignable; rows are narrowed to
-         * {@link UserMessageEventLike} at read time.
-         */
-        events?: readonly unknown[];
-        /**
-         * Full-log snapshot reader that answers the same rows in the same order
-         * where the `events` getter is absent. Called with no arguments for the
-         * whole log, which is the read {@link sessionEventsOf} needs.
-         */
-        snapshotEvents?: () => readonly unknown[];
-    };
-}
-/**
- * The session's event log through whichever reader the running harness
- * generation exposes. Returns [] when neither is present, so every caller
- * degrades to its empty-log path rather than throwing.
- */
-export declare function sessionEventsOf(agent: AgentLike | undefined): readonly unknown[];
-/** The section-provider context shape we consume (subset of AssembleContext). */
-export interface InjectContext {
-    agent?: AgentLike;
-}
-/**
- * Normalized recency in [0, 1]: 1 when the entry was just updated, decaying
- * linearly to 0 after {@link RECENCY_HALF_LIFE_MS}. Unparseable timestamps
- * score 0 (never preferred over a timestamped entry).
- */
-export declare function recencyScore(entry: HarnessEntry, now: number): number;
-/**
- * Rank entries for injection, best first. With no query the ranking is
- * negative-valence first (contradicted entries last), then pure recency
- * (newest first). With a query, entries are scored once against a per-call
- * BM25 index (CJK bigrams; field-weighted title ×2 — see search.ts): any
- * entry with a positive score (≥1 matched token) outranks every hit-less
- * entry (score exactly 0), scores decide the order among relevant entries,
- * the negative-valence counter breaks remaining ties (contradicted entries
- * sink), recency breaks remaining ties, and the stable dictionary order is
- * the final tiebreak, so the result is deterministic. The input is never
- * mutated.
- */
-export declare function rankEntries(entries: readonly HarnessEntry[], query?: string, now?: number): HarnessEntry[];
-/**
- * Compose the relevance query from the assembling agent's most recent direct
- * user messages (event rows whose `type` is `user/message` and whose source
- * is a human `user`, so injected plugin context and tool results never leak
- * into the query). Returns "" when nothing qualifies — the ranking then
- * falls back to pure recency.
- */
-export declare function recentUserText(agent: AgentLike | undefined, opts?: {
-    maxMessages?: number;
-    maxChars?: number;
-}): string;
-/** True when the state carries at least one entry of any kind. */
-export declare function hasAnyEntries(state: HarnessState): boolean;
-/** The additive prompt-notes block (empty when there are no visible prompt entries). */
-export declare function formatPromptEntriesSection(entries: readonly HarnessEntry[], query?: string): string;
-/** The reusable delegation-specs block (empty when there are no visible subagent entries). */
-export declare function formatSubagentSpecsSection(entries: readonly HarnessEntry[], query?: string): string;
-/**
- * Gap B3: a lightweight directory of ALL non-archived entries across all
- * kinds — one line per entry, no content. Memory lines carry their recall
- * type (`- [memory:feedback:id] title`) so the model can judge relevance
- * from the index alone. This gives the model a zero-cost overview of what
- * exists so it can ask for full text via `evolve_list` or `/evolve list`.
- * The directory is appended after the curated top-N injection sections and
- * adds minimal tokens.
- *
- * 2026-08-22 throttle: the directory is CAPPED at {@link DEFAULT_DIRECTORY_LINES}
- * lines with the remainder folded into a single counter line — an uncapped
- * directory across a polluted global store was measured at ~2K chars of
- * every build in every project.
- *
- * 2026-09-23 relevance order: the directory is sorted by
- * {@link rankEntries} against the assembly's relevance query, so the lines
- * folded below the cap are the least relevant — not the dictionary tail.
- */
-export declare const DEFAULT_DIRECTORY_LINES = 15;
-/** One directory index line: memory lines carry their recall-type hook. */
-export declare function directoryLine(entry: HarnessEntry): string;
-export declare function formatEntriesDirectory(...kindEntries: readonly HarnessEntry[][]): string;
-/** {@link formatEntriesDirectory} with an explicit cap (configurable). */
-export declare function formatEntriesDirectoryCapped(maxLines: number, ...kindEntries: readonly HarnessEntry[][]): string;
-/**
- * {@link formatEntriesDirectoryCapped} with a relevance query: entries are
- * ordered by {@link rankEntries} (relevance first, then recency) so the cap
- * folds the least relevant entries — never the dictionary tail. An empty
- * query degrades to the valence/recency/stable order, still deterministic.
- */
-export declare function formatEntriesDirectoryRanked(maxLines: number, query: string | undefined, ...kindEntries: readonly HarnessEntry[][]): string;
-/**
- * The directory entries actually shown under the cap, in display order —
- * the single source for both the rendered text and usage accounting (so a
- * memory's injection IS its directory line even with the `:type` hook).
- * Returns [] when the directory is suppressed or empty.
- */
-export declare function rankedDirectoryEntries(maxLines: number, query: string | undefined, ...kindEntries: readonly HarnessEntry[][]): HarnessEntry[];
-/**
- * Walk the parent-session chain from `agent` upward and return the nearest
- * session whose local store is non-empty, if any. Children inherit their
- * ancestor's prompt notes and delegation specs; the chain walk stops at the
- * first store that has entries (deep descendants do not re-inject ancestors
- * beyond the nearest carrying store).
- */
-export declare function nearestLocalStateWithEntries(engine: EvolutionEngine, agent: AgentLike): HarnessState | undefined;
-/**
- * The single three-store merge every injection path reads from: the global
- * store merged with this project's store (when the session cwd resolves one)
- * and the nearest carrying local store (precedence global < project < local —
- * see {@link mergeHarnessStates}). One home, so the memory section and the
- * entry directory can never disagree about what the model can see.
- */
-export declare function mergedInjectionState(engine: EvolutionEngine, agent: AgentLike, opts?: {
-    projectKey?: string;
-}): HarnessState;
-/**
- * Compose the full injected block for one assembling agent: global entries
- * merged with this project's store (when the session cwd resolves one) and
- * the nearest carrying local store (precedence global < project < local).
- * The optional `query` — when absent, derived from the agent's most recent
- * direct user messages — ranks which entries fill the per-kind cap
- * (relevance first, then recency; see {@link rankEntries}). Returns "" when
- * nothing is injectable — the prompt renderer then drops the section, so an
- * empty store adds zero tokens to every assembly.
- *
- * `opts.directoryLines` caps the entry-directory index (2026-08-22 throttle);
- * `opts.projectKey` pins the project layer explicitly (tests, tools) —
- * otherwise it is derived from the agent's session cwd, best-effort.
- * `opts.includeMemoryDirectory` (default true) drops memory lines from the
- * directory when the memory section already carries them (evolve v2) — one
- * fact, one home, so the same memories are never paid for twice.
- * Usage recording covers ALL kinds — memories and skills appear as directory
- * lines, prompts/subagents as content — and is deduped per session so the
- * counts read "how many sessions saw this", not "how many prompt builds".
- */
-export declare function entriesSectionText(engine: EvolutionEngine, agent: AgentLike | undefined, query?: string, opts?: {
-    directoryLines?: number;
-    projectKey?: string;
-    includeMemoryDirectory?: boolean;
-}): string;
-//# sourceMappingURL=inject.d.ts.map