@wrongstack/core 0.284.0 → 0.285.0

package/dist/execution/design-kit-loader.d.ts

@@ -0,0 +1,53 @@
+import { type DesignKitEntry, type DesignKitLoader, type DesignKitManifest, type DesignKitTokens, type DesignStack } from '../types/design-kit.js';
+export interface DesignKitLoaderOptions {
+    /** <project>/.wrongstack/design-kits */
+    inProjectDir: string;
+    /** ~/.wrongstack/design-kits */
+    globalDir: string;
+    /** Bundled kits shipped with @wrongstack/core (packages/core/design-kits). */
+    bundledDir?: string | undefined;
+}
+/**
+ * Discovery order (highest priority first; later layers are shadowed by name):
+ *   1. Project-committed:  <project>/.wrongstack/design-kits/
+ *   2. User-global:        ~/.wrongstack/design-kits/
+ *   3. Bundled with build: packages/core/design-kits/
+ *
+ * The `_foundations` directory is a reserved kit id holding the mandatory
+ * cross-cutting baseline; it is excluded from the selectable menu.
+ */
+export declare class DefaultDesignKitLoader implements DesignKitLoader {
+    private readonly dirs;
+    private cache?;
+    private readonly bodyCache;
+    private readonly tokenCache;
+    constructor(opts: DesignKitLoaderOptions);
+    list(): Promise<DesignKitManifest[]>;
+    /** Selectable kits only (excludes the reserved `_foundations` entry). */
+    private selectable;
+    listEntries(): Promise<DesignKitEntry[]>;
+    find(id: string): Promise<DesignKitManifest | undefined>;
+    menuText(): Promise<string>;
+    readBody(id: string, stack?: DesignStack): Promise<string>;
+    readTokens(id: string): Promise<DesignKitTokens | undefined>;
+    foundationsText(stack?: DesignStack): Promise<string>;
+    invalidateCache(): void;
+}
+/**
+ * Resolve the bundled `design-kits/` directory shipped alongside this module.
+ * The directory is a sibling of `src/` (dev) and `dist/` (built), so we probe a
+ * few candidate depths relative to the compiled module location and return the
+ * first that exists. Returns `undefined` if none is found (treated as "no
+ * bundled kits this run").
+ */
+export declare function resolveBundledDesignKitsDir(): string | undefined;
+/**
+ * Memoized per-project loader. Used by the `design` tool and the Design Studio
+ * middleware/slash-command so they share one cached instance without threading
+ * the loader through every boot path. The loader is a pure disk reader (no
+ * injected services), so a module-level memo is safe.
+ */
+export declare function getDesignKitLoader(projectRoot: string): DefaultDesignKitLoader;
+/** Test helper — clears the per-project loader memo. */
+export declare function _resetDesignKitLoaderMemo(): void;
+//# sourceMappingURL=design-kit-loader.d.ts.map

package/dist/execution/design-kit-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-kit-loader.d.ts","sourceRoot":"","sources":["../../src/execution/design-kit-loader.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,WAAW,EAEjB,MAAM,wBAAwB,CAAC;AAwHhC,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyD;IAC9E,OAAO,CAAC,KAAK,CAAC,CAAkC;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkD;IAE7E,YAAY,IAAI,EAAE,sBAAsB,EAMvC;IAEK,IAAI,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAwCzC;IAED,yEAAyE;YAC3D,UAAU;IAIlB,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAS7C;IAEK,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAI7D;IAEK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAUhC;IAEK,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAU/D;IAEK,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAiBjE;IAEK,eAAe,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAM1D;IAED,eAAe,IAAI,IAAI,CAItB;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,GAAG,SAAS,CAgBhE;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,sBAAsB,CAW9E;AAED,wDAAwD;AACxD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/execution/design-materialize.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Materialize a design kit's tokens into a real, stack-appropriate theme file.
+ *
+ * This is what turns Design Studio from "the model SHOULD use these colors" into
+ * "these colors ARE the source of truth in the codebase": the generated file is
+ * committed and imported, so the kit's palette is enforced by the build, not by
+ * a prompt. CSS keeps OKLCH verbatim (native); native stacks get sRGB hex/float
+ * via `oklchToHex`.
+ *
+ * Pure: no disk access — returns `{ path, content }`. Callers (the `design`
+ * tool, `/design materialize`, the WebUI button) decide how/where to write.
+ */
+import type { DesignKitTokens, DesignStack } from '../types/design-kit.js';
+export interface MaterializeResult {
+    /** Suggested project-relative path. */
+    path: string;
+    /** File contents. */
+    content: string;
+    /** Human label for the format. */
+    format: string;
+}
+/**
+ * Generate a stack-appropriate theme file from a kit's (override-applied) tokens.
+ * `outPath` overrides the conventional default path.
+ */
+export declare function materializeTokens(opts: {
+    tokens: DesignKitTokens;
+    stack: DesignStack;
+    kitId: string;
+    outPath?: string | undefined;
+}): MaterializeResult;
+//# sourceMappingURL=design-materialize.d.ts.map

package/dist/execution/design-materialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-materialize.d.ts","sourceRoot":"","sources":["../../src/execution/design-materialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG3E,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAsKD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,GAAG,iBAAiB,CA2BpB"}

package/dist/execution/design-project-store.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Project-local Design Studio store — a gitignored `<project>/.design/` directory
+ * that persists design DECISIONS and project-specific design RULES across
+ * sessions, separate from the committed `.wrongstack/design-kits/` (shared
+ * custom kits). Layout:
+ *
+ *   .design/.gitignore   `*`  — self-ignores so the dir is untracked in ANY repo
+ *   .design/rules.md     project design rules (always injected when UI work is active)
+ *   .design/active.json  { kit, stack } — the pinned kit, restored on session start
+ *   .design/decisions.md append-only log of kit choices (timestamp · kit · stack · via)
+ *
+ * All writes are best-effort: a failure here must never break the tool, slash
+ * command, or a turn.
+ */
+export declare function designProjectDir(projectRoot: string): string;
+/** Read `.design/rules.md` (or RULES.md / design.md). Cached per project root. */
+export declare function loadProjectDesignRules(projectRoot: string): Promise<string | undefined>;
+/**
+ * User color/token overrides. Keys are token names (`primary`, `bg`, …) applied
+ * to BOTH themes, or theme-scoped (`light.primary`, `dark.bg`). Values are any
+ * token string (OKLCH/hex). These override kit `tokens.json` everywhere tokens
+ * are consumed — the `use` snapshot, `materialize`, and `verify`.
+ */
+export type DesignOverrides = Record<string, string>;
+export interface PersistedActiveKit {
+    kit: string;
+    stack?: string | undefined;
+    overrides?: DesignOverrides | undefined;
+}
+/** Read the persisted active kit from `.design/active.json`, if any. */
+export declare function loadActiveKit(projectRoot: string): Promise<PersistedActiveKit | undefined>;
+/**
+ * Apply token overrides onto a kit's light/dark token sets. A bare key
+ * (`primary`) is applied to both themes; a scoped key (`light.bg`/`dark.bg`)
+ * only to that theme. Returns NEW objects — never mutates the input.
+ */
+export declare function applyTokenOverrides<T extends {
+    light?: Record<string, string> | undefined;
+    dark?: Record<string, string> | undefined;
+}>(tokens: T, overrides: DesignOverrides | undefined): T;
+/**
+ * Persist a kit choice: update `active.json` and append to `decisions.md`.
+ * `isoTime` is passed in so callers control the timestamp (and tests stay
+ * deterministic). Best-effort — swallows all errors.
+ */
+export declare function recordKitChoice(projectRoot: string, kit: string, stack: string | undefined, source: string, isoTime: string, overrides?: DesignOverrides | undefined): Promise<void>;
+/**
+ * Merge color/token overrides into `active.json` WITHOUT changing the pinned
+ * kit (used by `design set primary=…`). Returns the merged override map, or
+ * undefined if there is no active kit to attach them to. Best-effort on write.
+ */
+export declare function recordOverrides(projectRoot: string, patch: DesignOverrides, isoTime: string): Promise<DesignOverrides | undefined>;
+/** Clear the persisted active kit (e.g. `/design off`). Best-effort. */
+export declare function clearPersistedActiveKit(projectRoot: string): Promise<void>;
+/** Test helper — clears the rules cache. */
+export declare function _resetDesignRulesCache(): void;
+//# sourceMappingURL=design-project-store.d.ts.map

package/dist/execution/design-project-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-project-store.d.ts","sourceRoot":"","sources":["../../src/execution/design-project-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAMD,kFAAkF;AAClF,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7F;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CACzC;AAWD,wEAAwE;AACxE,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAehG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;CAAE,EACrI,MAAM,EAAE,CAAC,EACT,SAAS,EAAE,eAAe,GAAG,SAAS,GACrC,CAAC,CAiBH;AAmBD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,eAAe,GAAG,SAAS,GACtC,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAsBtC;AAED,wEAAwE;AACxE,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhF;AAED,4CAA4C;AAC5C,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/execution/design-verify.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Heuristic adherence check: does generated UI code actually use the active
+ * kit's palette, or did the model drift to off-palette hardcoded colors?
+ *
+ * `verifyFiles` is pure over file contents; `runDesignVerify` adds the node-side
+ * file collection (explicit list or a bounded UI-file walk) so the `design` tool
+ * and the WebUI handler share identical rules. For each file it scans color
+ * literals (`#hex`, `oklch()`, `rgb()`) and generic Tailwind color utilities
+ * (`bg-blue-500`), then flags any that don't resolve to a kit token (directly or
+ * via the materialized CSS var / token name). It can't prove adherence — it
+ * surfaces likely drift to steer a correction pass.
+ */
+import type { DesignKitTokens } from '../types/design-kit.js';
+export interface DesignViolation {
+    file: string;
+    line: number;
+    snippet: string;
+    reason: string;
+}
+export interface DesignVerifyReport {
+    filesScanned: number;
+    /** Normalized kit palette (hex). */
+    palette: string[];
+    /** Kit color token names (for var/utility matching). */
+    tokenNames: string[];
+    violations: DesignViolation[];
+    /** 0..1 — share of color signals that are on-palette. 1 when no signals. */
+    score: number;
+    ok: boolean;
+}
+/**
+ * Verify a batch of file contents against a kit's (override-applied) tokens.
+ */
+export declare function verifyFiles(tokens: DesignKitTokens, files: {
+    path: string;
+    text: string;
+}[]): DesignVerifyReport;
+/**
+ * Resolve + read UI files (explicit list, or a bounded walk) and verify them
+ * against a kit's tokens. Shared by the `design` tool and the WebUI handler so
+ * the file-collection rules stay identical.
+ */
+export declare function runDesignVerify(projectRoot: string, tokens: DesignKitTokens, explicitFiles?: string[] | undefined): Promise<DesignVerifyReport>;
+//# sourceMappingURL=design-verify.d.ts.map

package/dist/execution/design-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-verify.d.ts","sourceRoot":"","sources":["../../src/execution/design-verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wDAAwD;IACxD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;CACb;AA8BD;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GACtC,kBAAkB,CAgEpB;AA4CD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,EACvB,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,GACnC,OAAO,CAAC,kBAAkB,CAAC,CAgB7B"}

package/dist/execution/error-handler.d.ts

@@ -0,0 +1,34 @@
+import type { Context } from '../core/context.js';
+import type { ErrorHandler, RecoveryDecision } from '../types/error-handler.js';
+import type { Compactor } from '../types/compactor.js';
+import type { ModelsRegistry } from '../types/models-registry.js';
+import type { Config } from '../types/config.js';
+/**
+ * Tiered error recovery strategies.
+ * Each strategy is attempted in order until one returns a decision.
+ */
+export interface RecoveryStrategy {
+    /** Human-readable label for logs. */
+    label: string;
+    /** Optional compactor for context_overflow recovery. */
+    compactor?: Compactor | undefined;
+    /** Returns an explicit recovery decision, or null to fall through. */
+    attempt: (err: unknown, ctx: Context) => Promise<RecoveryDecision | null>;
+}
+/**
+ * Builds the ordered list of recovery strategies used by DefaultErrorHandler.
+ * Exported so callers can customise or extend the strategy chain.
+ */
+export declare function buildRecoveryStrategies(opts?: {
+    compactor?: Compactor | undefined;
+    modelsRegistry?: ModelsRegistry | undefined;
+    getConfig?: (() => Config) | undefined;
+}): RecoveryStrategy[];
+export declare const DEFAULT_RECOVERY_STRATEGIES: RecoveryStrategy[];
+export declare class DefaultErrorHandler implements ErrorHandler {
+    private readonly strategies;
+    constructor(strategies?: RecoveryStrategy[]);
+    classify(err: unknown): ReturnType<ErrorHandler['classify']>;
+    recover(err: unknown, ctx: Context): Promise<RecoveryDecision | null>;
+}
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/execution/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/execution/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAGhF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,sEAAsE;IACtE,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CAC3E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE;IAC7C,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC5C,SAAS,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CACxC,GAAG,gBAAgB,EAAE,CAsJrB;AAED,eAAO,MAAM,2BAA2B,oBAA4B,CAAC;AAsBrE,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,YAAY,UAAU,GAAE,gBAAgB,EAAgC,EAEvE;IAED,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CA4B3D;IAEK,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAM1E;CACF"}

package/dist/{parallel-eternal-engine-HUrtePLd.d.ts → execution/eternal-autonomy.d.ts}

@@ -1,99 +1,8 @@
-import { A as Agent, a as AgentFactory, D as DispatchClassifier, b as DefaultMultiAgentCoordinator } from './multi-agent-coordinator-4RCRZKjN.js';
-import { B as BrainArbiter, E as EventBus } from './events-Bgnh43r9.js';
-import { C as Compactor } from './compactor-DQLL4HTo.js';
-import { J as JournalEntry } from './goal-store-Datpp-ar.js';
-
-/**
- * Design Studio — curated frontend/mobile UI design kits.
- *
- * A "design kit" is a self-contained, selectable design direction (an aesthetic
- * + concrete design tokens + per-stack implementation guidance) that the model
- * commits to BEFORE writing UI code. Kits are surfaced progressively: a compact
- * menu is injected when frontend work is detected, and the heavy kit body is
- * only loaded once the model (or user) picks one — keeping per-turn tokens low.
- *
- * This mirrors the skills subsystem (`types/skill.ts` + `execution/skill-loader.ts`)
- * but adds the per-stack body selection and a token snapshot for visual pickers.
- */
-/** Target implementation stacks a kit can speak to. */
-declare const DESIGN_STACKS: readonly ["web", "react-native", "flutter", "swiftui", "compose"];
-type DesignStack = (typeof DESIGN_STACKS)[number];
-declare function isDesignStack(v: string): v is DesignStack;
-interface DesignKitManifest {
-    id: string;
-    name: string;
-    /** One-line vibe shown in the menu, e.g. "Restrained, Linear-style minimalism". */
-    aesthetic: string;
-    /** Free-form tags for filtering. */
-    tags: string[];
-    /** Stacks this kit provides guidance for. */
-    stacks: DesignStack[];
-    /** Whether the kit ships light + dark themes (almost always true). */
-    themes: string[];
-    /** "Best for…" one-liner used in menu + pickers. */
-    bestFor: string;
-    version?: string | undefined;
-    path: string;
-    source: 'project' | 'user' | 'bundled';
-}
-/** A single theme's concrete token values (OKLCH strings, font names, etc.). */
-interface DesignTokenSet {
-    [token: string]: string;
-}
-/** Parsed `tokens.json` — light + dark token snapshots used by visual pickers. */
-interface DesignKitTokens {
-    light?: DesignTokenSet | undefined;
-    dark?: DesignTokenSet | undefined;
-}
-/** Compact menu entry rendered into the request when frontend work is detected. */
-interface DesignKitEntry {
-    id: string;
-    name: string;
-    aesthetic: string;
-    bestFor: string;
-    stacks: DesignStack[];
-    source: DesignKitManifest['source'];
-}
-/**
- * Live Design Studio state stashed on `ctx.meta.designStudio`. Set by the
- * detection middleware (user intent + frontend file writes); read by the
- * request middleware that injects the menu / active-kit reminder.
- */
-interface DesignStudioState {
-    /** True once frontend/UI work has been detected this session. */
-    active: boolean;
-    /** Detected target stack, if any. */
-    stack?: DesignStack | undefined;
-    /** What triggered activation (for transparency / debugging). */
-    signals: string[];
-    /** Kit id the model/user committed to, if any. */
-    activeKit?: string | undefined;
-    /**
-     * User color/token overrides applied over the active kit's tokens. Keys are
-     * token names (`primary`) applied to both themes, or theme-scoped
-     * (`light.bg`/`dark.bg`). See `applyTokenOverrides`.
-     */
-    overrides?: Record<string, string> | undefined;
-}
-interface DesignKitLoader {
-    list(): Promise<DesignKitManifest[]>;
-    /** Structured entries for the compact menu. */
-    listEntries(): Promise<DesignKitEntry[]>;
-    find(id: string): Promise<DesignKitManifest | undefined>;
-    /** Compact, model-facing menu of every available kit. */
-    menuText(): Promise<string>;
-    /**
-     * Full kit body for a given stack. Strips frontmatter and, when `stack` is
-     * provided, narrows stack-specific sections to that stack.
-     */
-    readBody(id: string, stack?: DesignStack | undefined): Promise<string>;
-    /** Parsed `tokens.json` for a kit (light/dark snapshots), if present. */
-    readTokens(id: string): Promise<DesignKitTokens | undefined>;
-    /** The mandatory cross-cutting baseline (responsive / a11y / theming / motion). */
-    foundationsText(stack?: DesignStack | undefined): Promise<string>;
-    invalidateCache(): void;
-}
-
+import type { Agent } from '../core/agent.js';
+import type { EventBus } from '../kernel/events.js';
+import type { Compactor } from '../types/compactor.js';
+import type { BrainArbiter } from '../coordination/brain.js';
+import { type JournalEntry } from '../storage/goal-store.js';
 /**
  * Sense-decide-execute-reflect loop on top of a long-running Goal.
  *
@@ -108,7 +17,7 @@ interface DesignKitLoader {
  * user wants "sittin sene". Failures are logged and the loop continues
  * with a different source on the next tick.
  */
-interface EternalAutonomyOptions {
+export interface EternalAutonomyOptions {
     agent: Agent;
     projectRoot: string;
     /**
@@ -221,12 +130,12 @@ interface EternalAutonomyOptions {
     /** Optional EventBus for emitting storage.* observability events from goal I/O. */
     events?: EventBus | undefined;
 }
-type EternalEngineState = 'idle' | 'running' | 'stopped';
+export type EternalEngineState = 'idle' | 'running' | 'stopped';
 /**
  * Per-iteration phase emitted via `onStage` so UIs can render the
  * engine's live location in the sense-decide-execute-reflect loop.
  */
-type IterationStage = {
+export type IterationStage = {
     phase: 'idle';
 } | {
     phase: 'decide';
@@ -249,7 +158,7 @@ type IterationStage = {
     phase: 'error';
     message: string;
 };
-declare class EternalAutonomyEngine {
+export declare class EternalAutonomyEngine {
     private readonly opts;
     private state;
     private stopRequested;
@@ -362,128 +271,4 @@ declare class EternalAutonomyEngine {
     private updateProgress;
     private persistEngineState;
 }
-
-type ParallelEngineState = 'idle' | 'running' | 'stopped';
-type ParallelIterationStage = {
-    phase: 'idle';
-} | {
-    phase: 'decompose';
-} | {
-    phase: 'fanout';
-    slots: number;
-} | {
-    phase: 'await';
-    taskIds: string[];
-} | {
-    phase: 'aggregate';
-    successCount: number;
-    total: number;
-    goalComplete: boolean;
-} | {
-    phase: 'sleep';
-    ms: number;
-} | {
-    phase: 'stopped';
-} | {
-    phase: 'error';
-    message: string;
-};
-interface ParallelEternalOptions {
-    /** The coordinating agent — NOT a subagent. Owns container/tools/providers. */
-    agent: Agent;
-    /** Project root (used for goal.json path). */
-    projectRoot: string;
-    /**
-     * Override the resolved goal.json path. Defaults to
-     * `goalFilePath(projectRoot)` — the canonical per-project goal file under
-     * `~/.wrongstack/projects/<slug>/`, shared with `/goal` and the TUI.
-     * Primarily for tests that want an isolated goal file under a temp dir.
-     */
-    goalPath?: string | undefined;
-    /**
-     * Number of parallel subagent slots per tick.
-     * Default: 4. Range 1–16; values >8 are for high-throughput machines.
-     */
-    parallelSlots?: number | undefined;
-    /** Per-subagent default timeout in ms. Default: 300_000 (5 min). */
-    iterationTimeoutMs?: number | undefined;
-    onIteration?: (((entry: JournalEntry) => void)) | undefined;
-    onError?: (err: Error | undefined, iteration: number) => void;
-    /** Per-tick phase notifications for live UI/status updates. */
-    onStage?: (((stage: ParallelIterationStage) => void)) | undefined;
-    gitStatusReader?: ((() => Promise<string>)) | undefined;
-    now?: ((() => Date)) | undefined;
-    compactor?: Compactor | undefined;
-    compactEveryNIterations?: number | undefined;
-    aggressiveCompactRatio?: number | undefined;
-    maxContextTokens?: number | undefined;
-    /** Override the default agent factory (uses main agent if not provided). */
-    subagentFactory?: AgentFactory | undefined;
-    /**
-     * Route each decomposed slot task to the best-fit catalog agent via the
-     * smart dispatcher (heuristic keyword scoring). When enabled (default), each
-     * slot spawns in-role — the role's budget tier applies and a persona line is
-     * injected into the task — instead of as a faceless generic worker. Set
-     * false to keep the legacy generic spawn.
-     */
-    dispatch?: boolean | undefined;
-    /**
-     * Optional LLM fallback for ambiguous tasks. Passed straight to
-     * `dispatchAgent`; when omitted, routing is pure heuristic (instant, no
-     * provider call — preferred for a continuously-ticking autonomous loop).
-     */
-    dispatchClassifier?: DispatchClassifier | undefined;
-    /** Optional EventBus for emitting storage.* observability events from goal I/O. */
-    events?: EventBus | undefined;
-}
-/**
- * Sense → Decide → Fan-out (4–8 parallel agents) → Aggregate → Loop.
- *
- * Each tick:
- *   1. Sense    — load goal, todos, git status
- *   2. Decide   — decompose goal into N parallel sub-tasks
- *   3. Fan-out  — spawn N subagents simultaneously, await all
- *   4. Aggregate — write journal, update todos, check [GOAL_COMPLETE]
- *   5. Loop     — continue until stop() or mission complete
- *
- * Uses DefaultMultiAgentCoordinator + AgentSubagentRunner for subagent lifecycle.
- */
-declare class ParallelEternalEngine {
-    private readonly opts;
-    private state;
-    private stopRequested;
-    private iterationsSinceCompact;
-    private iterations;
-    private consecutiveFailures;
-    private readonly goalPath;
-    private readonly slots;
-    private readonly timeoutMs;
-    private coordinator;
-    private agentFactory;
-    private readonly dispatchEnabled;
-    private readonly dispatchClassifier?;
-    constructor(opts: ParallelEternalOptions);
-    get currentState(): ParallelEngineState;
-    /**
-     * Get the underlying coordinator for stats/monitoring.
-     */
-    getCoordinator(): DefaultMultiAgentCoordinator | null;
-    stop(): void;
-    prime(): Promise<void>;
-    run(): Promise<void>;
-    /**
-     * Execute one tick: decompose → fan-out → aggregate → compact.
-     * Called by the REPL in its main loop (REPL drives, engine is stateless per tick).
-     */
-    runOneIteration(): Promise<boolean>;
-    private fanOut;
-    private decomposeGoal;
-    private readGitStatus;
-    private brainstormSubtasks;
-    private maybeCompact;
-    private appendIterationEntry;
-    private appendFailure;
-    private persistState;
-}
-
-export { type DesignStack as D, EternalAutonomyEngine as E, type IterationStage as I, type ParallelEngineState as P, type DesignStudioState as a, type DesignKitLoader as b, type DesignKitManifest as c, type DesignKitEntry as d, type DesignKitTokens as e, DESIGN_STACKS as f, type DesignTokenSet as g, type EternalAutonomyOptions as h, type EternalEngineState as i, ParallelEternalEngine as j, type ParallelEternalOptions as k, type ParallelIterationStage as l, isDesignStack as m };
+//# sourceMappingURL=eternal-autonomy.d.ts.map

package/dist/execution/eternal-autonomy.d.ts.map

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

package/dist/execution/goal-preamble.d.ts

@@ -0,0 +1,2 @@
+export declare function buildGoalPreamble(goal: string, deliverables?: string[]): string;
+//# sourceMappingURL=goal-preamble.d.ts.map

package/dist/execution/goal-preamble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-preamble.d.ts","sourceRoot":"","sources":["../../src/execution/goal-preamble.ts"],"names":[],"mappings":"AAiCA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAiB/E"}