@wrongstack/cli 0.303.0 → 0.305.0

package/dist/wiring/domain-terms-mirror.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Refresh the `.wrongstack/domain-terms.md` mirror file from the
+ * resolved SAGE `MemoryPort` at CLI boot.
+ *
+ * Background
+ * ----------
+ * The Project Jargon Dictionary feature splits ownership between two
+ * storage backends (per `packages/sage/docs/direct-icp-usage.md`):
+ *   - SAGE's SQLite store is the authoritative source of truth.
+ *   - `.wrongstack/domain-terms.md` is a *derived* view of the same
+ *     data, kept on disk so humans (and ProjectRoot sandboxes) can
+ *     read the glossary without going through the IPC client.
+ *
+ * `SageDomainTermExtractor.writeDomainTermsFile` already knows how to
+ * regenerate the file from the canonical SAGE state. What it lacks
+ * is a runtime host caller — the helper exists only in tests. This
+ * module closes that gap for the CLI host.
+ *
+ * Behaviour
+ * ---------
+ * - **Fire and forget at boot.** The mirror is a derived artefact;
+ *   a failure to refresh at startup must not abort the CLI. The
+ *   helper logs via `writeErr` and returns `null` on failure.
+ * - **Idempotent.** Calling this on every boot is safe: the file is
+ *   regenerated atomically by `writeDomainTermsFile`, and the content
+ *   is fully derived from SAGE state.
+ * - **Honest about scope.** Only the CLI host invokes this. TUI and
+ *   WebUI hosts share the same SAGE port and read the same file; the
+ *   CLI boot path is the canonical place to refresh the mirror.
+ */
+import type { MemoryPort } from '@wrongstack/core/types';
+export interface RefreshDomainTermsMirrorOptions {
+    /** Absolute project root whose `.wrongstack/domain-terms.md` should be refreshed. */
+    projectRoot: string;
+    /**
+     * Resolved SAGE `MemoryPort`. The extractor reads the `domain-term`
+     * tagged subset from this port.
+     */
+    memoryStore: MemoryPort;
+}
+/**
+ * Regenerate the mirror file from the current SAGE state.
+ *
+ * Returns the absolute path of the written file, or `null` when the
+ * refresh failed (the CLI logs the underlying reason to stderr and
+ * continues — the SAGE corpus remains authoritative).
+ *
+ * Never throws — callers are guaranteed to receive a `string | null`
+ * outcome.
+ */
+export declare function refreshDomainTermsMirror(options: RefreshDomainTermsMirrorOptions): Promise<string | null>;
+//# sourceMappingURL=domain-terms-mirror.d.ts.map

package/dist/wiring/pipeline.d.ts

@@ -79,6 +79,8 @@ export declare function createAgent(params: {
             maxToolTimeoutMs?: number | undefined;
             defaultExecutionStrategy: 'parallel' | 'sequential' | 'smart';
             perIterationOutputCapBytes: number;
+            /** Opt-in Kanban governance gate; see ToolsConfig.kanbanGovernance. */
+            kanbanGovernance?: boolean | undefined;
             loopDetection?: import('@wrongstack/core/types').LoopDetectionConfig | undefined;
         };
     };

package/dist/wiring/replay.d.ts

@@ -23,11 +23,21 @@ import type { WstackPaths } from '@wrongstack/core/utils';
  * The log lives next to the session JSONL via
  * `sessionScopedPath(projectSessions, sessionId, '.replay.jsonl')`,
  * colocated with annotations and audit sidecars.
+ *
+ * Call this AFTER the session exists. `TOKENS.ProviderRunner` is resolved per
+ * request inside the agent loop, not at agent construction, so the binding only
+ * has to be in place before the first `run()` — which is what lets `--record`
+ * name the real session instead of inventing one.
  */
 export interface BindReplayOptions {
     container: Container;
     wpaths: WstackPaths;
-    sessionId: string;
+    /**
+     * Explicit id for `--replay <id>`, or a resolver for `--record` so the log
+     * lands beside the live session's transcript instead of under a synthetic
+     * name. See {@link ReplayProviderRunnerOptions.sessionId}.
+     */
+    sessionId: string | (() => string);
     mode: ReplayMode;
     logger?: Logger | undefined;
 }

package/dist/wiring/sage.d.ts

@@ -1,19 +1,7 @@
-import type { AgentPipelines } from '@wrongstack/core/agent';
-import type { EventBus } from '@wrongstack/core/kernel';
-import type { Config, Logger, MemoryPort } from '@wrongstack/core/types';
-export interface SageWiringDeps {
-    config: Config;
-    pipelines: AgentPipelines;
-    memoryStore: MemoryPort | undefined;
-    logger: Logger;
-    events: EventBus;
-    getSessionId?: (() => string | undefined) | undefined;
-}
 /**
- * Test-only: reset the auto-hygiene throttle so the next teardown always
- * runs hygiene. Used by the regression test to verify the throttle skips
- * on the second call within the interval.
+ * CLI host adapter for shared SAGE wiring.
+ *
+ * Implementation lives in `@wrongstack/sage` so CLI and WebUI cannot drift.
  */
-export declare function _resetAutoHygieneThrottleForTesting(): void;
-export declare function setupSage(deps: SageWiringDeps): () => Promise<void>;
+export { AUTO_HYGIENE_INTERVAL_MS, _resetAutoHygieneThrottleForTesting, sageHygieneOptionsFromConfig, setupSage, type SageHostWiringDeps as SageWiringDeps, } from '@wrongstack/sage';
 //# sourceMappingURL=sage.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrongstack/cli",
-  "version": "0.303.0",
+  "version": "0.305.0",
   "license": "MIT",
   "description": "WrongStack CLI — terminal AI coding agent with provider catalog from models.dev. Provides `wrongstack` and `wstack` binaries.",
   "keywords": [
@@ -42,30 +42,30 @@
   ],
   "dependencies": {
     "ws": "^8.21.1",
-    "@wrongstack/acp": "0.303.0",
-    "@wrongstack/bench": "0.303.0",
-    "@wrongstack/core": "0.303.0",
-    "@wrongstack/plug-lsp": "0.303.0",
-    "@wrongstack/runtime": "0.303.0",
-    "@wrongstack/security-scanner": "0.303.0",
-    "@wrongstack/mcp": "0.303.0",
-    "@wrongstack/plugins": "0.303.0",
-    "@wrongstack/providers": "0.303.0",
-    "@wrongstack/sdd": "0.303.0",
-    "@wrongstack/kanban": "0.303.0",
-    "@wrongstack/requirement-intake": "0.303.0",
-    "@wrongstack/sage": "0.303.0",
-    "@wrongstack/simpleui": "0.303.0",
-    "@wrongstack/tui": "0.303.0",
-    "@wrongstack/tools": "0.303.0",
-    "@wrongstack/webui-hq": "0.303.0",
-    "@wrongstack/techstack": "0.303.0",
-    "@wrongstack/telegram": "0.303.0",
-    "@wrongstack/webui": "0.303.0",
-    "@wrongstack/webui-server": "0.303.0"
+    "@wrongstack/bench": "0.305.0",
+    "@wrongstack/core": "0.305.0",
+    "@wrongstack/acp": "0.305.0",
+    "@wrongstack/kanban": "0.305.0",
+    "@wrongstack/plug-lsp": "0.305.0",
+    "@wrongstack/mcp": "0.305.0",
+    "@wrongstack/requirement-intake": "0.305.0",
+    "@wrongstack/sdd": "0.305.0",
+    "@wrongstack/sage": "0.305.0",
+    "@wrongstack/providers": "0.305.0",
+    "@wrongstack/runtime": "0.305.0",
+    "@wrongstack/plugins": "0.305.0",
+    "@wrongstack/security-scanner": "0.305.0",
+    "@wrongstack/techstack": "0.305.0",
+    "@wrongstack/simpleui": "0.305.0",
+    "@wrongstack/tools": "0.305.0",
+    "@wrongstack/telegram": "0.305.0",
+    "@wrongstack/webui-hq": "0.305.0",
+    "@wrongstack/webui": "0.305.0",
+    "@wrongstack/tui": "0.305.0",
+    "@wrongstack/webui-server": "0.305.0"
   },
   "optionalDependencies": {
-    "@wrongstack/desktop": "0.303.0"
+    "@wrongstack/desktop": "0.305.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",