dsh-advisor 0.1.0

package/lib/index.js

@@ -0,0 +1,485 @@
+/**
+ * dsh advisor plugin — a per-session reviewer model (port of the omp
+ * "advisor" subsystem). Observes the primary transcript, reviews each stepped
+ * turn with an explicitly configured model, and injects severity-ranked
+ * advice (nit/concern/blocker) without polluting or recursively reviewing
+ * itself.
+ *
+ * T1 scaffold: declares the Cordis plugin entry (`name`/`inject`/`apply`).
+ * T2: config contract — the Loader schema (`Config`) plus the explicit
+ * provider/model gate via `resolveAdvisorConfig` (spec §5 / S4).
+ * T3: session observation — subscribe `session/event`, detect stepped
+ * `turn/end` (reason.kind ∈ {completed, 'max-tokens', error}, spec §4), drive
+ * a per-session bounded delta renderer, and dispose per-session state on
+ * `session/disposed` / `agent/disposed` (KD-5).
+ * T4: the per-session advisor runtime — queue each rendered delta, drain
+ * asynchronously via `ctx.llm.stream` (system prompt + delta, `purpose` left
+ * unset, KD-5), extract `{note, severity}` (KD-2), and apply the failure
+ * policy (retry-light → drop, 3-drop backlog flush, quota pause, permanent
+ * halt — never park the primary). The emission guard (T5) gates extracted
+ * notes before delivery; the delivery router (T6) routes accepted notes into
+ * the primary agent (nit → inject, concern/blocker → steer, immuneTurns
+ * cooldown, KD-4 agent map). T7: `/advisor` toggle/on/off/status commands
+ * (registered through the conditional `ctx.inject(['commands'], ...)` child)
+ * drive a per-session override consulted by the runtime gate — the commands
+ * start/stop per-session runtimes without touching the persisted config.
+ * Settings (plan dsh-advisor-settings-n2): the plugin-row config is the
+ * composition base of the `advisor` settings namespace (`src/settings.ts`),
+ * read live through the bridge source; committed settings edits re-apply
+ * derived state (immuneTurns / maxDeltaMessages / per-session runtimes)
+ * without a restart.
+ * Config gateway (plan dsh-advisor-settings-gateway-n5): `apply` also
+ * registers the host-side `AdvisorConfigGateway` (`src/gateway.ts`) — the
+ * `/api/advisor/get` + `/api/advisor/set` endpoints (explicit
+ * `ctx.typert.register` contribution — the host typertGateway claims
+ * `ctx.typert.local` first, so link-plugin module identity never matters)
+ * that make the Settings card truly readable/writable from the web client.
+ *
+ * @module dsh-advisor
+ */
+import { resolveAdvisorConfig } from './config.js';
+import { installAdvisorSettings } from './settings.js';
+import { AdvisorConfigGateway, advisorTypertContribution } from './gateway.js';
+import { SessionTranscriptObserver } from './transcript.js';
+import { AdvisorRuntime } from './advisor-runtime.js';
+import { AdvisorDelivery } from './delivery.js';
+import { DEFAULT_ADVISOR_SYSTEM_PROMPT } from './prompts.js';
+import { AdvisorSessionOverrides, registerAdvisorCommands } from './commands.js';
+export const name = 'dsh-advisor';
+/** Services the advisor consumes; the row loads once all are available. */
+export const inject = ['sessions', 'agents', 'llm'];
+/** Loader schema (schemastery, strict) — validated by the cordis Loader. */
+export { Config } from './config.js';
+/** n4 QC F-6: single-reviewer guard. The host composes multiple dsh-advisor
+ * fibers (observed: 3 active); with the global session/event subscription every
+ * instance would observe every session and N×-review/N×-call per round. The
+ * FIRST apply to claim the reviewer role wires the observer/runtime/delivery
+ * and the /advisor commands; later instances attempt the settings registration
+ * only (qc1 W-5: it is NOT idempotent — dsh-settings register throws on a
+ * duplicate; installAdvisorSettings dedupes it and falls back to the entry
+ * source, so the first registration owns the live namespace) and stay inert
+ * otherwise. The claim is taken only AFTER the construction-time config gate
+ * (qc1 W-4: a rejected first row never leaves the flag claimed) and is
+ * released when the claiming fiber is disposed, so a later re-apply/re-mount
+ * can take over. The flag rides globalThis so it survives even module-copy
+ * divergence. */
+const REVIEWER_KEY = '__dshAdvisorReviewer__';
+function claimReviewer() {
+    const g = globalThis;
+    if (g[REVIEWER_KEY] === true)
+        return false;
+    g[REVIEWER_KEY] = true;
+    return true;
+}
+export function apply(ctx, config) {
+    // T2: the explicit provider/model gate — no model call without both
+    // (spec §5.2). Unknown keys / malformed config throw here, rejecting the
+    // plugin row at load; the gate resolves to disabled-with-reason instead.
+    //
+    // T1-settings (plan dsh-advisor-settings-n2): the plugin-row config is the
+    // composition BASE of the `advisor` settings namespace. The runtime reads
+    // the LIVE composed value through the bridge source (schema defaults →
+    // base → settings user layer); with no settings service the source is
+    // exactly `config` — behavior identical to today. The hard gate is applied
+    // to every read: `resolveAdvisorConfig` stays the SSOT for the
+    // disabled-with-reason resolution.
+    const bridge = installAdvisorSettings(ctx, config);
+    // n5 (plan dsh-advisor-settings-gateway-n5): the host-side `advisor` config
+    // gateway — the `/api/advisor/get` + `/api/advisor/set` endpoints. The
+    // endpoints are registered EXPLICITLY through `ctx.typert.register(...)`
+    // (NOT the @Remote SRC markers): the host typertGateway checks
+    // `ctx.typert.local` FIRST for claim + dispatch, while SRC discovery reads
+    // a module-private marker table that a locally-linked plugin can never
+    // share with the host installation (link plugins resolve their peers from
+    // their real directory, physically separate from the dlx host tree — the
+    // observed failure was zero claimed endpoints → `/api/advisor/*` 404).
+    // It reads the SAME bridge the runtime reads, so get/set always operate on
+    // the live composed config. Multi-fiber dedupe mirrors the settings
+    // registration (qc1 W-5): the cordis Service registration fails loud on a
+    // duplicate key, so the catch lets the FIRST fiber own the `advisor` service
+    // key while later fibers fall back (no gateway) — a later fiber's typert
+    // re-registration fails the same way (`already registered`). The
+    // registrations are fiber effects (unregistered when this fiber disposes),
+    // so a re-apply/re-mount can take over. The instance needs no handle here:
+    // the typertGateway dispatches through `ctx.get('advisor')`.
+    try {
+        new AdvisorConfigGateway(ctx, bridge);
+    }
+    catch (error) {
+        if (!(error instanceof Error) || !error.message.includes('has been registered'))
+            throw error;
+        ctx.logger('advisor').debug('advisor gateway already registered — no gateway on this fiber (multi-fiber dedupe)');
+    }
+    // The typert endpoint registration is OPTIONAL, like the settings service:
+    // it activates through a conditional inject child, so compositions without
+    // a typert registry (headless/standalone/integration harnesses) keep the
+    // advisor runtime working and simply omit the /api endpoints. The child
+    // disposer is the registration's own effect disposer, so the endpoints
+    // withdraw when this fiber (or the typert service) goes away.
+    ctx.inject(['typert'], (tctx) => {
+        try {
+            return tctx.typert.register(advisorTypertContribution());
+        }
+        catch (error) {
+            if (!(error instanceof Error) || !error.message.includes('already registered'))
+                throw error;
+            tctx.logger('advisor').debug('advisor typert endpoints already registered — no endpoints on this fiber (multi-fiber dedupe)');
+            return () => { };
+        }
+    });
+    const sourceConfig = () => bridge.source();
+    const resolved = () => resolveAdvisorConfig(sourceConfig());
+    // qc2 W-1 containment: a settings user layer the resolver rejects (e.g. an
+    // unknown key survives the non-strict settings schema) must never wedge the
+    // live hot path — every read that can run inside an event handler goes
+    // through the safe wrappers, which catch resolver throws and return
+    // disabled-with-reason carrying the message, so gate semantics hold (no
+    // model call can start) and handlers stay functional. The LOAD-TIME
+    // plugin-row throw contract is unchanged: construction-time reads below
+    // (delivery/observer latches) still use the throwing `resolved()`, so a bad
+    // entry rejects the plugin row at load (config.test.ts ⑤).
+    const safeFallback = (reason) => ({
+        enabled: false,
+        systemPrompt: '',
+        immuneTurns: 3,
+        maxDeltaMessages: 60,
+        disabledReason: reason,
+    });
+    const safeResolved = () => {
+        try {
+            return resolveAdvisorConfig(sourceConfig());
+        }
+        catch (error) {
+            return safeFallback(error instanceof Error ? error.message : String(error));
+        }
+    };
+    const safeEffective = (sessionId) => {
+        try {
+            return resolveAdvisorConfig({ ...sourceConfig(), enabled: effectiveEnabled(sessionId) });
+        }
+        catch (error) {
+            return safeFallback(error instanceof Error ? error.message : String(error));
+        }
+    };
+    ctx.logger('advisor').debug('dsh-advisor loaded', {
+        enabled: safeResolved().enabled,
+        disabledReason: safeResolved().disabledReason,
+    });
+    // T7: the per-session override mechanism — `/advisor on|off|toggle` write
+    // here and the runtime gate consults `override ?? config.enabled`, so the
+    // commands start/stop per-session runtimes WITHOUT touching the persisted
+    // config (spec §4 mapping — omp `/advisor` semantics). Ephemeral: entries
+    // are cleared on `agent/disposed` / `session/disposed` below. Seeded with
+    // the RAW config switch (not the post-gate `resolved.enabled`): a config-
+    // enabled-but-gate-blocked session (enabled without provider/model) then
+    // re-derives the disabled-with-reason through the resolver, so `/advisor
+    // status` shows the reason (spec §5.2; qc3 I-1) — the gate itself still
+    // blocks every runtime (the resolver is the SSOT for the gate).
+    const overrides = new AdvisorSessionOverrides(config.enabled);
+    const effectiveEnabled = (sessionId) => overrides.effective(sessionId);
+    // Live-path alias: every consumer reads the effective config through the
+    // safe wrapper (qc2 W-1 — a throwing resolver must not break the
+    // session/event handler or `/advisor status`).
+    const effectiveConfig = (sessionId) => safeEffective(sessionId);
+    // T3+T4: per-session transcript observation wired into one advisor runtime
+    // per session. On each stepped reviewable turn/end a bounded markdown delta
+    // is rendered and queued on the session's runtime; the runtime drains it
+    // asynchronously through `ctx.llm.stream`, gates the extracted `AdviceNote`
+    // through the T5 emission guard (inside the runtime, between extraction and
+    // delivery), and hands accepted notes to `onNote` (T6 routes them).
+    // T6: the delivery router. Owns the KD-4 per-session agent map (keyed by
+    // agent.id === session.id, maintained on agent/created / agent/disposed
+    // below), the severity → channel mapping (nit → inject; concern/blocker →
+    // steer), and the immuneTurns cooldown (spec §6). Accepted notes from the
+    // runtime's onNote are routed here; missing agent → drop + log (KD-4).
+    const delivery = new AdvisorDelivery({
+        immuneTurns: resolved().immuneTurns,
+        // Registry fallback (KD-4): covers agents published before this plugin
+        // loaded, whose `agent/created` was never observed. The delivery module is
+        // session-id-string-typed; the registry key is the branded SessionId.
+        lookupAgent: (sessionId) => ctx.agents.get(sessionId),
+        logger: ctx.logger('advisor'),
+    });
+    const runtimes = new Map();
+    /**
+     * Runtime-affecting signature per session — the values that pin one
+     * {@link AdvisorRuntime}: the effective switch, the post-gate enable (S4),
+     * and the {provider, model, systemPrompt} triple. Recorded at runtime
+     * creation and compared on every settings change (qc3 W-1 / qc1 W-2): only
+     * a signature change tears the runtime down — an immuneTurns/
+     * maxDeltaMessages-only edit updates the latches in place and keeps every
+     * in-flight call and backlog.
+     */
+    const runtimeSignatures = new Map();
+    const runtimeSignature = (sessionId) => {
+        const effective = safeEffective(sessionId);
+        return [
+            effectiveEnabled(sessionId) ? 1 : 0,
+            effective.enabled ? 1 : 0,
+            effective.provider ?? '',
+            effective.model ?? '',
+            effective.systemPrompt,
+        ].join('\u0000');
+    };
+    /**
+     * Create (or return) the runtime for one session, gated on the effective
+     * switch: `undefined` when the session is disabled or the S4 explicit gate
+     * blocks model calls (effective enabled without provider/model — spec
+     * §5.2). T7's `/advisor on` turns a session on without a config change by
+     * flipping the override, which this gate reads.
+     */
+    const ensureRuntime = (sessionId) => {
+        if (!effectiveEnabled(sessionId))
+            return undefined;
+        let runtime = runtimes.get(sessionId);
+        if (runtime !== undefined)
+            return runtime;
+        const effective = effectiveConfig(sessionId);
+        // The re-resolved config guarantees provider + model when enabled — the
+        // runtime is only constructed behind the gate.
+        if (!effective.enabled)
+            return undefined;
+        runtime = new AdvisorRuntime({
+            provider: effective.provider,
+            model: effective.model,
+            systemPrompt: safeResolved().systemPrompt || DEFAULT_ADVISOR_SYSTEM_PROMPT,
+            // n4 root-cause (host-observed NO_ADAPTER): this plugin's ctx may live in
+            // an isolated scope whose local llm service lacks the provider adapters
+            // (adapter registrations live on the application root's LlmRuntime). Resolve
+            // the llm service from the APPLICATION ROOT so the advisor's model calls
+            // reach the registered deepseek-official adapter.
+            llm: ctx.root?.get?.('llm') ?? ctx.llm,
+            onNote: (note) => {
+                // Accepted notes only — the runtime's emission guard (T5) already
+                // filtered suppressed ones. T6 routes the accepted note to the primary
+                // agent (inject/steer); delivery throws stay contained in the runtime
+                // path (T4 F1), so a failing agent can only drop its own advice.
+                const channel = delivery.route(sessionId, note);
+                ctx.logger('advisor').debug('advice note delivered', {
+                    sessionId,
+                    severity: note.severity,
+                    channel,
+                });
+            },
+        });
+        runtimes.set(sessionId, runtime);
+        runtimeSignatures.set(sessionId, runtimeSignature(sessionId));
+        return runtime;
+    };
+    const disposeRuntime = (sessionId) => {
+        const runtime = runtimes.get(sessionId);
+        if (runtime === undefined)
+            return;
+        runtimes.delete(sessionId);
+        runtimeSignatures.delete(sessionId);
+        runtime.dispose();
+    };
+    // n4 QC F-6: claim the single-reviewer role HERE — after every
+    // construction-time throwing read (the delivery latch above resolves the
+    // config and can throw on a rejected row), so a first fiber whose config
+    // fails the gate never leaves the flag claimed (qc1 W-4). Non-reviewer
+    // instances stop here — observer/runtime/delivery and the /advisor commands
+    // are wired only by the single claimed reviewer. The settings registration
+    // (installAdvisorSettings above) already ran deduped (qc1 W-5): the first
+    // registration owns the live namespace on every composition.
+    const reviewer = claimReviewer();
+    if (!reviewer) {
+        ctx.logger('advisor').debug('non-reviewer instance — observer/runtime/commands skipped (single-reviewer guard)');
+        return;
+    }
+    // qc1 W-4: release the claim when THIS (reviewer) fiber is disposed, so a
+    // later re-apply/re-mount (plugin-row removal, composition reload, host hot
+    // reload) can take over instead of leaving the advisor silently inert for
+    // the process lifetime. Registered only on the claiming fiber.
+    ctx.effect(() => () => {
+        delete globalThis[REVIEWER_KEY];
+    }, 'advisor: release reviewer claim');
+    const observer = new SessionTranscriptObserver({
+        maxDeltaMessages: resolved().maxDeltaMessages,
+        onSteppedTurnEnd: (sessionId) => {
+            // One completed stepped primary turn — decrement the immuneTurns
+            // cooldown (T6, spec §6). Fires before the delta render, so the note
+            // this very turn produces is routed with the decremented cooldown.
+            delivery.onSteppedTurnEnd(sessionId);
+        },
+        onRewrite: (sessionId) => {
+            // KD-5: a compaction / surface rewrite resets the immuneTurns latch
+            // (delivery) AND the emission-guard dedupe history (runtime) — session
+            // state is being rewritten, so both latches' basis no longer applies.
+            // T8: guard reset wired through the runtime (T5 ⚠️ follow-through).
+            delivery.reset(sessionId);
+            runtimes.get(sessionId)?.resetGuard();
+        },
+        onDelta: (sessionId, delta) => {
+            // Lazy creation fallback covers agents that existed before this plugin
+            // loaded (their `agent/created` was never observed); `agent/created`
+            // below creates eagerly for the common path. The runtime gate drops the
+            // delta for sessions that are disabled or S4-gate-blocked (T7).
+            ensureRuntime(sessionId)?.enqueue(delta);
+        },
+    });
+    // `session/event` is scope-filtered: the dsh scope carrier sets a
+    // `[Context.filter]` on emitted events — untagged listeners pass, but a
+    // tagged listener only receives events whose carrier key is on its own
+    // key's ancestor chain (see `packages/core/scope/src/index.ts` scopeTarget).
+    // Cordis dispatch skips the filter for global hooks
+    // (`hook.global || !filter || filter.call(...)` — `cordis/src/events.ts`
+    // dispatch), and the plugin's instances may be composed in isolated scopes
+    // (dsh-advisor appears as multiple active fibers, e.g. 3), so `{ global:
+    // true }` is required for the observer to receive every session's events
+    // regardless of scope placement. Q2=grill-me-locked fix; verified by host
+    // test (PM operator step, evidence in iteration guides).
+    //
+    // The three lifecycle listeners below dispatch through the SAME
+    // scope-filtered carrier as `session/event` (dsh-session/dsh-agent
+    // `announce`/`emitDisposed`), so they must be `{ global: true }` too (qc3
+    // F4): a scoped fiber that observes out-of-scope sessions via the global
+    // session/event listener would otherwise create per-session state —
+    // renderers, runtimes, cooldowns, overrides — whose dispose events are
+    // filtered out, a per-session leak for the host's lifetime. Create/dispose
+    // symmetry restored; both dispose listeners are documented idempotent
+    // (a runtime is disposed at most once, whichever signal lands first).
+    ctx.on('session/event', (session, event) => {
+        observer.handleEvent(session.id, session.events, event);
+    }, { global: true });
+    // Per-session runtime lifecycle. Spec KD-5(c) pins `agent/disposed`;
+    // `session/disposed` is the store-level pair (both are idempotent — a
+    // runtime is disposed at most once, whichever signal lands first). `agent/created`
+    // creates the runtime eagerly (plan T4) when the session is enabled and
+    // registers the agent in the KD-4 delivery map (T6); the observer fallback
+    // covers pre-existing agents (KD-4-style robustness).
+    ctx.on('agent/created', ({ agent }) => {
+        ensureRuntime(agent.id);
+        delivery.registerAgent(agent);
+    }, { global: true });
+    ctx.on('agent/disposed', ({ agent }) => {
+        observer.disposeSession(agent.id);
+        disposeRuntime(agent.id);
+        delivery.unregisterAgent(agent.id);
+        overrides.clear(agent.id);
+    }, { global: true });
+    ctx.on('session/disposed', (session) => {
+        observer.disposeSession(session.id);
+        disposeRuntime(session.id);
+        delivery.unregisterAgent(session.id);
+        overrides.clear(session.id);
+    }, { global: true });
+    // T1-settings live re-apply: construction-time latches (immuneTurns on the
+    // delivery, maxDeltaMessages on the observer, systemPrompt + provider/model
+    // on each per-session runtime) are re-derived from the NEW source on every
+    // committed settings change and re-applied — delivery/observer update in
+    // place, per-session runtimes rebuild only when their runtime-affecting
+    // signature actually changed (qc3 W-1 / qc1 W-2: an immuneTurns/
+    // maxDeltaMessages-only edit must not abort in-flight advisor calls or drop
+    // backlogs). The S4 gate is re-applied by the resolver on every read, so a
+    // settings edit can never start a gated model call (SSOT unchanged); the
+    // config-level fallback switch follows the live source so new sessions pick
+    // up a Settings-page `enabled` edit immediately. A settings user layer the
+    // resolver rejects (qc2 W-1 — unknown key) stops the advisor without
+    // wedging the re-apply path, and the last-good latches stay until the
+    // config is repaired.
+    bridge.onChange(() => {
+        let next;
+        try {
+            next = resolveAdvisorConfig(sourceConfig());
+        }
+        catch (error) {
+            // The raw source is still readable for the switch even when the
+            // resolver rejects the composed value; if even that fails, keep the
+            // current config-level switch (the gate below still blocks runtimes).
+            try {
+                overrides.setConfigEnabled(sourceConfig().enabled);
+            }
+            catch {
+                // unreadable source — the effective switch stays as-is
+            }
+            for (const sessionId of [...runtimes.keys()])
+                disposeRuntime(sessionId);
+            ctx.logger('advisor').warn('settings change: invalid advisor config — advisor stopped', {
+                disabledReason: error instanceof Error ? error.message : String(error),
+            });
+            return;
+        }
+        delivery.setImmuneTurns(next.immuneTurns);
+        observer.setMaxDeltaMessages(next.maxDeltaMessages);
+        overrides.setConfigEnabled(sourceConfig().enabled);
+        let rebuilt = 0;
+        for (const sessionId of [...runtimes.keys()]) {
+            if (runtimeSignatures.get(sessionId) === runtimeSignature(sessionId))
+                continue;
+            disposeRuntime(sessionId);
+            ensureRuntime(sessionId);
+            rebuilt += 1;
+        }
+        if (rebuilt > 0) {
+            ctx.logger('advisor').debug('settings change rebuilt session runtimes', {
+                rebuilt,
+                provider: next.provider,
+                model: next.model,
+            });
+        }
+    });
+    // T7: the `/advisor` command controller — the commands' session-scoped
+    // operations against the observer/runtimes above. `/advisor on` seeds the
+    // observer cursor to the current transcript length (KD-5 seed-on-enable —
+    // no full-history replay) and creates/resumes/recoveries the session runtime;
+    // `/advisor off` disposes it (abort in-flight, drop backlog). The S4 gate
+    // reason is re-derived through the config resolver, the SSOT for the
+    // disabled-with-reason text (spec §5.2).
+    const controller = {
+        setEnabled(sessionId, enabled, sessionLength) {
+            // Recovery, not just a switch flip: `/advisor on` (and toggle-to-on)
+            // must restart a session advisor that is `quota_exhausted` (KD-5 —
+            // manual resume, no auto-resume timer) or `halted` (permanent model
+            // error — terminal in place, rebuilt fresh here) (qc1/qc2/qc3 W-1/I-4).
+            // The override is written only when the effective switch actually
+            // changes; enabling an already-effectively-enabled session still routes
+            // through the recovery path below instead of early-returning.
+            const already = effectiveEnabled(sessionId) === enabled;
+            if (!already)
+                overrides.set(sessionId, enabled);
+            if (!enabled) {
+                if (!already)
+                    disposeRuntime(sessionId);
+                return;
+            }
+            // enabled (newly or already): KD-5 seed — no full-history replay of
+            // deltas that predate (or occurred while paused/halted under) the enable.
+            if (sessionLength !== undefined)
+                observer.seedTo(sessionId, sessionLength);
+            const runtime = ensureRuntime(sessionId);
+            if (runtime === undefined)
+                return; // S4 explicit gate blocks model calls
+            if (runtime.status() === 'halted') {
+                // KD-5 halting is terminal in place; `/advisor on` is the manual
+                // recovery path — rebuild a fresh runtime (the S4 gate is re-applied
+                // by ensureRuntime, so this can never start a gated model call).
+                disposeRuntime(sessionId);
+                ensureRuntime(sessionId);
+            }
+            else {
+                runtime.resume(); // no-op on 'running'; resumes 'quota_exhausted' (KD-5)
+            }
+        },
+        getStatus(sessionId) {
+            const runtime = runtimes.get(sessionId);
+            const effective = effectiveConfig(sessionId);
+            return {
+                enabled: effective.enabled,
+                ...(effective.disabledReason === undefined ? {} : { disabledReason: effective.disabledReason }),
+                provider: safeResolved().provider,
+                model: safeResolved().model,
+                runtimeStatus: runtime?.status() ?? 'disabled',
+                pendingCount: runtime?.pendingCount ?? 0,
+                lastActivityAt: runtime?.lastActivity,
+            };
+        },
+    };
+    // T7: the command child activates ONLY when a command registry is composed
+    // (conditional child activation — `commands` must NOT join the top-level
+    // `inject` list, T1 fix). `/advisor` toggle/on/off/status (spec §2 S5).
+    ctx.inject(['commands'], (commandCtx) => {
+        registerAdvisorCommands(commandCtx.commands, controller);
+    });
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/kinds.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Advisor source kind + the `MessageSourceMap` merge extension (spec §6).
+ *
+ * Advisor-injected messages enter the session as user-role messages carrying
+ * `source.kind === 'advisor'` (via the plugin's `MessageSourceMap` merge
+ * declaration, `declare module '@deepseek-ai/dsh-llm'`). The delta renderer
+ * (T3) and the delivery router (T6) both key off this kind:
+ *
+ * - **Self-review exclusion (spec §6):** every advisor-source message is
+ *   excluded from subsequent advisor deltas, so the advisor never reads its
+ *   own injected advice back.
+ * - **Delivery tagging (T6):** `createUserMessage({ ..., source: { kind:
+ *   ADVISOR_SOURCE_KIND } })` marks injected advice so it is visible in the
+ *   session stream yet excluded from later deltas.
+ *
+ * @module dsh-advisor/kinds
+ */
+import type { ContextFormed, Message } from '@deepseek-ai/dsh-llm';
+declare module '@deepseek-ai/dsh-llm' {
+    interface MessageSourceMap {
+        /**
+         * An advisor-injected message (user-role, self-describing
+         * `[advisor:{severity}] {note}` content). Never derived into advisor
+         * deltas (self-review guard, spec §6). Extends {@link ContextFormed} so
+         * the plugin can declare the `notice` form + one-line `summary` the web
+         * shell renders on a collapsed context row.
+         */
+        advisor: {
+            readonly kind: 'advisor';
+        } & ContextFormed;
+    }
+}
+/** The `source.kind` value carried by every advisor-injected message. */
+export declare const ADVISOR_SOURCE_KIND: "advisor";
+/** Type of a message source carrying the advisor kind. */
+export type AdvisorSourceKind = typeof ADVISOR_SOURCE_KIND;
+/** True when a message was injected by the advisor itself. */
+export declare function isAdvisorMessage(message: Message): boolean;

package/lib/kinds.js

@@ -0,0 +1,24 @@
+/**
+ * Advisor source kind + the `MessageSourceMap` merge extension (spec §6).
+ *
+ * Advisor-injected messages enter the session as user-role messages carrying
+ * `source.kind === 'advisor'` (via the plugin's `MessageSourceMap` merge
+ * declaration, `declare module '@deepseek-ai/dsh-llm'`). The delta renderer
+ * (T3) and the delivery router (T6) both key off this kind:
+ *
+ * - **Self-review exclusion (spec §6):** every advisor-source message is
+ *   excluded from subsequent advisor deltas, so the advisor never reads its
+ *   own injected advice back.
+ * - **Delivery tagging (T6):** `createUserMessage({ ..., source: { kind:
+ *   ADVISOR_SOURCE_KIND } })` marks injected advice so it is visible in the
+ *   session stream yet excluded from later deltas.
+ *
+ * @module dsh-advisor/kinds
+ */
+/** The `source.kind` value carried by every advisor-injected message. */
+export const ADVISOR_SOURCE_KIND = 'advisor';
+/** True when a message was injected by the advisor itself. */
+export function isAdvisorMessage(message) {
+    return message.source.kind === ADVISOR_SOURCE_KIND;
+}
+//# sourceMappingURL=kinds.js.map

package/lib/kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.js","sourceRoot":"","sources":["../src/kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAiBH,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAkB,CAAA;AAKrD,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,mBAAmB,CAAA;AACpD,CAAC"}

package/lib/prompts.d.ts

@@ -0,0 +1,22 @@
+/**
+ * dsh-advisor reviewer system prompt (spec §6, §8.2 KD-2).
+ *
+ * The advisor is an independent reviewer attached to a coding session: it
+ * receives an incremental markdown delta prefixed with `### Session update`
+ * (the T3 `DeltaRenderer` output) after each stepped primary turn and replies
+ * with exactly one JSON object `{"note", "severity"}`.
+ *
+ * The prompt pins the delivery contract KD-2 relies on:
+ * - the reviewer framing (independent, advisory-only — never approves actions);
+ * - the severity definitions from spec §6 (nit / concern / blocker);
+ * - the JSON-frame output contract: exactly one object, `severity` optional
+ *   (omitted = nit), `note` non-empty, one note per update;
+ * - a valid "nothing to add" frame, which the T5 emission guard's content-free
+ *   suppression filters out at delivery time.
+ *
+ * The extraction code tolerates prose/fences defensively, but the prompt asks
+ * for a bare frame so the happy path is a clean parse.
+ *
+ * @module dsh-advisor/prompts
+ */
+export declare const DEFAULT_ADVISOR_SYSTEM_PROMPT = "You are an independent reviewer attached to a coding-agent session. You observe the primary agent's work and surface concise, severity-ranked advice. You are advisory only: you never approve or reject the agent's actions, and you never issue commands as if you were the primary agent.\n\nAfter each completed primary turn you receive an incremental transcript update prefixed with \"### Session update\" (a user message). Review only what changed in this update.\n\nSeverity levels:\n- nit: a minor style, clarity, or quality suggestion; no course change is needed.\n- concern: a material risk or a clearly better direction that the primary should weigh before continuing.\n- blocker: continuing clearly wastes work \u2014 the primary contradicts an explicit user instruction, is going in circles, or the approach is fundamentally unsound.\n\nReply with EXACTLY ONE JSON object and nothing else:\n{\"note\": \"<your note>\", \"severity\": \"nit\"|\"concern\"|\"blocker\"}\n\n- \"severity\" is optional; when omitted it means \"nit\".\n- \"note\" must be a non-empty string: one concise, specific, actionable observation about this update. One note per update.\n- If there is genuinely nothing worth advising, respond with {\"note\": \"Nothing to add\"}.\n- Do not include prose, markdown fences, or anything outside the JSON object.";

package/lib/prompts.js

@@ -0,0 +1,38 @@
+/**
+ * dsh-advisor reviewer system prompt (spec §6, §8.2 KD-2).
+ *
+ * The advisor is an independent reviewer attached to a coding session: it
+ * receives an incremental markdown delta prefixed with `### Session update`
+ * (the T3 `DeltaRenderer` output) after each stepped primary turn and replies
+ * with exactly one JSON object `{"note", "severity"}`.
+ *
+ * The prompt pins the delivery contract KD-2 relies on:
+ * - the reviewer framing (independent, advisory-only — never approves actions);
+ * - the severity definitions from spec §6 (nit / concern / blocker);
+ * - the JSON-frame output contract: exactly one object, `severity` optional
+ *   (omitted = nit), `note` non-empty, one note per update;
+ * - a valid "nothing to add" frame, which the T5 emission guard's content-free
+ *   suppression filters out at delivery time.
+ *
+ * The extraction code tolerates prose/fences defensively, but the prompt asks
+ * for a bare frame so the happy path is a clean parse.
+ *
+ * @module dsh-advisor/prompts
+ */
+export const DEFAULT_ADVISOR_SYSTEM_PROMPT = `You are an independent reviewer attached to a coding-agent session. You observe the primary agent's work and surface concise, severity-ranked advice. You are advisory only: you never approve or reject the agent's actions, and you never issue commands as if you were the primary agent.
+
+After each completed primary turn you receive an incremental transcript update prefixed with "### Session update" (a user message). Review only what changed in this update.
+
+Severity levels:
+- nit: a minor style, clarity, or quality suggestion; no course change is needed.
+- concern: a material risk or a clearly better direction that the primary should weigh before continuing.
+- blocker: continuing clearly wastes work — the primary contradicts an explicit user instruction, is going in circles, or the approach is fundamentally unsound.
+
+Reply with EXACTLY ONE JSON object and nothing else:
+{"note": "<your note>", "severity": "nit"|"concern"|"blocker"}
+
+- "severity" is optional; when omitted it means "nit".
+- "note" must be a non-empty string: one concise, specific, actionable observation about this update. One note per update.
+- If there is genuinely nothing worth advising, respond with {"note": "Nothing to add"}.
+- Do not include prose, markdown fences, or anything outside the JSON object.`;
+//# sourceMappingURL=prompts.js.map

package/lib/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG;;;;;;;;;;;;;;;8EAeiC,CAAA"}