@alex.botez/elaborate 1.0.0

package/dist/interview/macros.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Interview macros — compose-prompt-extract orchestration with deviation resilience.
+ *
+ * Each macro wraps a common interview cycle around `retryOnDeviation`:
+ * - `composePromptExtract` — full compose → prompt → extract with rephrase on clarification.
+ * - `promptExtract` — prompt → extract.
+ * - `promptConfirm` — prompt → classifier thunk. Public-facing wrapper lives here;
+ *   the RE-coupled bits are wrapped by `confirmPhase` in phases/shared.ts.
+ * - `promptReview` — prompt → review classification.
+ * - `promptReextract` — contradiction prompt → reextraction.
+ *
+ * `promptExtractWithRetry` is the file-private shared backing function for
+ * the prompt-then-extract family (promptExtract, promptConfirm, promptReview).
+ *
+ * ## Call-site convention: prompt-via-factory, infer-inline
+ *
+ * Phase code uses two visually different patterns at these macros' call sites,
+ * by deliberate convention — don't unify them:
+ *
+ * - **Prompt macros** (`promptExtract`, `promptConfirm`, `promptReview`) take
+ *   their `prompt` argument from a named factory call:
+ *   `confirmation(artifacts, round)`, `summary(agg)`, `greeting()`,
+ *   `seedPresent(items)`, `nudge()`, `respondentPresent(...)`, etc.
+ *
+ * - **Compose/extract macros** (and direct `ctx.extract` / `ctx.seed` calls)
+ *   take their extraction params as an inline object literal:
+ *   `{ artifactsContext, schema, guidance? }`.
+ *
+ * Rationale: prompt args carry multi-line user-facing English (greetings,
+ * summaries, confirmation statements). Factoring into a named helper gives
+ * the wording a discoverable, testable home and keeps phase control flow
+ * uncluttered. Infer args carry mechanical plumbing — no user-facing wording;
+ * the wording lives in Zod `.describe()` annotations and the extraction
+ * preamble, both centralized. A factory for infer args would rename "object
+ * literal" with no readability or DRY win.
+ *
+ * Rejected alternatives: **unify on functions** — forces `extract(() => ({...}))`
+ * everywhere, pure noise; **unify on data** — inlines prompt-wording factories
+ * into phase files, losing the discoverable-wording property.
+ */
+import { z } from "zod";
+import type { ComposeParams } from "./describe.js";
+import type { ExtractParams } from "./extraction.js";
+/** Options for ctx.composePromptExtract(). */
+export interface ComposePromptExtractOptions<S extends z.ZodObject<any>> {
+    /** Called with items to park when divergence carries content. */
+    park?: (items: Array<{
+        content: string;
+    }>) => void;
+    /** Maximum deviation retries. Default: 2. */
+    maxRetries?: number;
+    /** Returned when all retries are exhausted. If absent, last error re-throws. */
+    defaults?: z.infer<S>;
+}
+/** Options for prompt-extract macros (promptExtract, promptReview). */
+export interface PromptExtractOptions<S extends z.ZodObject<any>> {
+    park?: (items: Array<{
+        content: string;
+    }>) => void;
+    maxRetries?: number;
+    defaults?: z.infer<S>;
+}
+/** Options for promptConfirm and promptReextract. */
+export interface PromptConfirmOptions {
+    park?: (items: Array<{
+        content: string;
+    }>) => void;
+    maxRetries?: number;
+    defaults?: Record<string, unknown>;
+}
+declare module "../durable/workflow.js" {
+    interface WorkflowContext {
+        composePromptExtract<S extends z.ZodObject<any>>(baseId: string, compose: () => ComposeParams, extractionParams: Omit<ExtractParams<S>, 'id' | 'response' | 'asked'>, options?: ComposePromptExtractOptions<S>): Promise<z.infer<S>>;
+        promptExtract<S extends z.ZodObject<any>>(prompt: {
+            id: string;
+            message: string;
+        }, extractionParams: Omit<ExtractParams<S>, 'id' | 'response'>, options?: PromptExtractOptions<S>): Promise<z.infer<S>>;
+        promptConfirm<T>(prompt: {
+            id: string;
+            message: string;
+        }, classifier: (response: string, ri: number) => Promise<T>, options?: PromptConfirmOptions): Promise<T & {
+            response: string;
+        }>;
+        promptReview<S extends z.ZodObject<any>>(prompt: {
+            id: string;
+            message: string;
+        }, reviewId: string, itemRef: string, artifactsContext: string, schema: S, options?: PromptExtractOptions<S>): Promise<z.infer<S>>;
+        promptReextract<S extends z.ZodObject<any>>(contradictionId: string, contradictions: string[], artifactsContext: string, schema: S, options?: PromptConfirmOptions): Promise<z.infer<S>>;
+    }
+}
+//# sourceMappingURL=macros.d.ts.map

package/dist/interview/macros.d.ts.map

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

package/dist/interview/macros.js

@@ -0,0 +1,138 @@
+/**
+ * Interview macros — compose-prompt-extract orchestration with deviation resilience.
+ *
+ * Each macro wraps a common interview cycle around `retryOnDeviation`:
+ * - `composePromptExtract` — full compose → prompt → extract with rephrase on clarification.
+ * - `promptExtract` — prompt → extract.
+ * - `promptConfirm` — prompt → classifier thunk. Public-facing wrapper lives here;
+ *   the RE-coupled bits are wrapped by `confirmPhase` in phases/shared.ts.
+ * - `promptReview` — prompt → review classification.
+ * - `promptReextract` — contradiction prompt → reextraction.
+ *
+ * `promptExtractWithRetry` is the file-private shared backing function for
+ * the prompt-then-extract family (promptExtract, promptConfirm, promptReview).
+ *
+ * ## Call-site convention: prompt-via-factory, infer-inline
+ *
+ * Phase code uses two visually different patterns at these macros' call sites,
+ * by deliberate convention — don't unify them:
+ *
+ * - **Prompt macros** (`promptExtract`, `promptConfirm`, `promptReview`) take
+ *   their `prompt` argument from a named factory call:
+ *   `confirmation(artifacts, round)`, `summary(agg)`, `greeting()`,
+ *   `seedPresent(items)`, `nudge()`, `respondentPresent(...)`, etc.
+ *
+ * - **Compose/extract macros** (and direct `ctx.extract` / `ctx.seed` calls)
+ *   take their extraction params as an inline object literal:
+ *   `{ artifactsContext, schema, guidance? }`.
+ *
+ * Rationale: prompt args carry multi-line user-facing English (greetings,
+ * summaries, confirmation statements). Factoring into a named helper gives
+ * the wording a discoverable, testable home and keeps phase control flow
+ * uncluttered. Infer args carry mechanical plumbing — no user-facing wording;
+ * the wording lives in Zod `.describe()` annotations and the extraction
+ * preamble, both centralized. A factory for infer args would rename "object
+ * literal" with no readability or DRY win.
+ *
+ * Rejected alternatives: **unify on functions** — forces `extract(() => ({...}))`
+ * everywhere, pure noise; **unify on data** — inlines prompt-wording factories
+ * into phase files, losing the discoverable-wording property.
+ */
+import { WorkflowContext } from "../durable/index.js";
+import { Confusion, deviationMessage } from "./deviation.js";
+/** Rephrase hint prepended to composition message on clarification retry. */
+function rephraseHint() {
+    return "The respondent asked for clarification. Rephrase the question using simpler language, a concrete example, or a different angle.\n\n";
+}
+/**
+ * Compose → prompt → extract with deviation resilience.
+ */
+WorkflowContext.prototype.composePromptExtract = async function (baseId, compose, extractionParams, options) {
+    return this.retryOnDeviation(async (ri, error) => {
+        if (error && !(error instanceof Confusion) && "parkedItems" in error && error.parkedItems.length > 0) {
+            options?.park?.(error.parkedItems);
+        }
+        const step = compose();
+        const message = error instanceof Confusion
+            ? rephraseHint() + step.message
+            : step.message;
+        const ask = await this.compose({ ...step, message, id: `${baseId}-composition-r${ri}` });
+        const question = error && !(error instanceof Confusion)
+            ? deviationMessage(error) + "\n\n" + ask.question
+            : ask.question;
+        const response = await this.promptQuestion(`${baseId}-question-r${ri}`, { ...ask, question });
+        return this.extract({
+            ...extractionParams,
+            id: `${baseId}-extraction-r${ri}`,
+            response,
+            asked: ask,
+        });
+    }, {
+        maxRetries: options?.maxRetries ?? 2,
+        ...(options && "defaults" in options ? { defaults: options.defaults } : {}),
+    });
+};
+/**
+ * Generic prompt → extract with deviation resilience.
+ *
+ * Shared backing function for promptExtract, promptConfirm, and promptReview.
+ * File-private — prevents the classifier callback shape leaking to callers.
+ */
+async function promptExtractWithRetry(ctx, prompt, extract, options) {
+    return ctx.retryOnDeviation(async (ri, error) => {
+        if (error && !(error instanceof Confusion) && "parkedItems" in error && error.parkedItems.length > 0) {
+            options?.park?.(error.parkedItems);
+        }
+        const message = error ? deviationMessage(error) + "\n\n" + prompt.message : prompt.message;
+        const response = await ctx.promptStep({ ...prompt, id: `${prompt.id}-r${ri}`, message });
+        return extract(response, ri);
+    }, {
+        maxRetries: options?.maxRetries ?? 1,
+        ...(options?.defaults !== undefined ? { defaults: options.defaults } : {}),
+    });
+}
+/** Prompt → extract with deviation resilience. */
+WorkflowContext.prototype.promptExtract = async function (prompt, extractionParams, options) {
+    return promptExtractWithRetry(this, prompt, (response, ri) => this.extract({ ...extractionParams, id: `${prompt.id}-extraction-r${ri}`, response }), options);
+};
+/**
+ * Prompt → classify with deviation resilience. The classifier thunk receives
+ * the raw response + retry index and returns the classification payload.
+ * Result is the classifier's return merged with `{ response }`.
+ *
+ * RE-agnostic: keeps the `Artifacts`/`Phase` coupling on the caller's side.
+ * Phase code typically goes through the `confirmPhase` helper in `phases/shared.ts`.
+ */
+WorkflowContext.prototype.promptConfirm = async function (prompt, classifier, options) {
+    const wrappedOptions = options?.defaults
+        ? { ...options, defaults: { ...options.defaults, response: "" } }
+        : options;
+    return promptExtractWithRetry(this, prompt, async (response, ri) => {
+        const result = await classifier(response, ri);
+        return { ...result, response };
+    }, wrappedOptions);
+};
+/** Prompt → review classification with deviation resilience. */
+WorkflowContext.prototype.promptReview = async function (prompt, reviewId, itemRef, artifactsContext, schema, options) {
+    return promptExtractWithRetry(this, prompt, (response, ri) => this.review(reviewId, response, itemRef, artifactsContext, schema, ri), options);
+};
+/** Contradiction prompt → reextraction with deviation resilience. */
+WorkflowContext.prototype.promptReextract = async function (contradictionId, contradictions, artifactsContext, schema, options) {
+    return this.retryOnDeviation(async (ri, error) => {
+        if (error && !(error instanceof Confusion) && "parkedItems" in error && error.parkedItems.length > 0) {
+            options?.park?.(error.parkedItems);
+        }
+        const clarification = await this.promptContradiction(`${contradictionId}-r${ri}`, contradictions);
+        return this.reextract(`${contradictionId}-reextraction-r${ri}`, clarification, artifactsContext, schema);
+    }, {
+        maxRetries: options?.maxRetries ?? 1,
+        ...(options?.defaults !== undefined ? { defaults: options.defaults } : {}),
+    });
+};
+const REQUIRED_PROTOTYPE_METHODS = ["composePromptExtract", "promptExtract", "promptConfirm", "promptReview", "promptReextract"];
+for (const method of REQUIRED_PROTOTYPE_METHODS) {
+    if (typeof WorkflowContext.prototype[method] !== "function") {
+        throw new Error(`interview/macros.ts self-check failed: WorkflowContext.prototype.${method} is not a function.`);
+    }
+}
+//# sourceMappingURL=macros.js.map

package/dist/interview/macros.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"macros.js","sourceRoot":"","sources":["../../src/interview/macros.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAuB,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA+DlF,6EAA6E;AAC7E,SAAS,YAAY;IACnB,OAAO,qIAAqI,CAAC;AAC/I,CAAC;AAED;;GAEG;AACH,eAAe,CAAC,SAAS,CAAC,oBAAoB,GAAG,KAAK,WAAW,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO;IACzG,OAAO,IAAI,CAAC,gBAAgB,CAC1B,KAAK,EAAE,EAAU,EAAE,KAAsB,EAAE,EAAE;QAC3C,IAAI,KAAK,IAAI,CAAC,CAAC,KAAK,YAAY,SAAS,CAAC,IAAI,aAAa,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrG,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,KAAK,YAAY,SAAS;YACxC,CAAC,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,OAAO;YAC/B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QACjB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,MAAM,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC;QAEzF,MAAM,QAAQ,GAAG,KAAK,IAAI,CAAC,CAAC,KAAK,YAAY,SAAS,CAAC;YACrD,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC,QAAQ;YACjD,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;QAEjB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CACxC,GAAG,MAAM,cAAc,EAAE,EAAE,EAC3B,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,CACrB,CAAC;QAEF,OAAO,IAAI,CAAC,OAAO,CAAC;YAClB,GAAG,gBAAgB;YACnB,EAAE,EAAE,GAAG,MAAM,gBAAgB,EAAE,EAAE;YACjC,QAAQ;YACR,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;IACL,CAAC,EACD;QACE,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC;QACpC,GAAG,CAAC,OAAO,IAAI,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5E,CACF,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;GAKG;AACH,KAAK,UAAU,sBAAsB,CACnC,GAAoB,EACpB,MAAuC,EACvC,OAAqD,EACrD,OAAmG;IAEnG,OAAO,GAAG,CAAC,gBAAgB,CAAC,KAAK,EAAE,EAAU,EAAE,KAAsB,EAAE,EAAE;QACvE,IAAI,KAAK,IAAI,CAAC,CAAC,KAAK,YAAY,SAAS,CAAC,IAAI,aAAa,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrG,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAC3F,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACzF,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC,EAAE;QACD,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC;QACpC,GAAG,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAC,CAAC;AACL,CAAC;AAoCD,kDAAkD;AAClD,eAAe,CAAC,SAAS,CAAC,aAAa,GAAI,KAAK,WAE9C,MAAuC,EACvC,gBAA6D,EAC7D,OAAmC;IAEnC,OAAO,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAC3D,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,gBAAgB,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EACrF,OAAO,CACR,CAAC;AACJ,CAAqC,CAAC;AAEtC;;;;;;;GAOG;AACH,eAAe,CAAC,SAAS,CAAC,aAAa,GAAI,KAAK,WAE9C,MAAuC,EACvC,UAA0D,EAC1D,OAA8B;IAE9B,MAAM,cAAc,GAAG,OAAO,EAAE,QAAQ;QACtC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE;QACjE,CAAC,CAAC,OAAO,CAAC;IACZ,OAAO,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE;QACjE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC9C,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC,EAAE,cAAc,CAAC,CAAC;AACrB,CAAqC,CAAC;AAEtC,gEAAgE;AAChE,eAAe,CAAC,SAAS,CAAC,YAAY,GAAI,KAAK,WAE7C,MAAuC,EACvC,QAAgB,EAChB,OAAe,EACf,gBAAwB,EACxB,MAAwB,EACxB,OAAmC;IAEnC,OAAO,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,CAC3D,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,CAAC,EACtE,OAAO,CACR,CAAC;AACJ,CAAoC,CAAC;AAErC,qEAAqE;AACrE,eAAe,CAAC,SAAS,CAAC,eAAe,GAAI,KAAK,WAEhD,eAAuB,EACvB,cAAwB,EACxB,gBAAwB,EACxB,MAAwB,EACxB,OAA8B;IAE9B,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,EAAU,EAAE,KAAsB,EAAE,EAAE;QACxE,IAAI,KAAK,IAAI,CAAC,CAAC,KAAK,YAAY,SAAS,CAAC,IAAI,aAAa,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrG,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,GAAG,eAAe,KAAK,EAAE,EAAE,EAAE,cAAc,CAAC,CAAC;QAClG,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,eAAe,kBAAkB,EAAE,EAAE,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC3G,CAAC,EAAE;QACD,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC;QACpC,GAAG,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3E,CAAC,CAAC;AACL,CAAuC,CAAC;AAExC,MAAM,0BAA0B,GAAG,CAAC,sBAAsB,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,CAAU,CAAC;AAC1I,KAAK,MAAM,MAAM,IAAI,0BAA0B,EAAE,CAAC;IAChD,IAAI,OAAQ,eAAe,CAAC,SAAgD,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;QACpG,MAAM,IAAI,KAAK,CAAC,oEAAoE,MAAM,qBAAqB,CAAC,CAAC;IACnH,CAAC;AACH,CAAC"}

package/dist/interview/preambles.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Authored LLM instruction content — quality preambles and closers.
+ *
+ * This module holds prompt *content* only. Injection happens inside each
+ * extension method's body in its own concern file (composition, extraction,
+ * classification, prompt). See ADR: composition-quality.
+ */
+/** Prepended to every ctx.compose call. */
+export declare function compositionPreamble(): string;
+/** Prepended to confirmation classification guidance. */
+export declare function classificationPreamble(): string;
+/** Prepended to every ctx.extract call. */
+export declare function extractionPreamble(): string;
+/** Appended after suggestion list in promptQuestion. */
+export declare function suggestionCloser(): string;
+/** Correction-inviting closer for phase confirmation prompts (not validation). */
+export declare function confirmationCloser(): string;
+//# sourceMappingURL=preambles.d.ts.map

package/dist/interview/preambles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preambles.d.ts","sourceRoot":"","sources":["../../src/interview/preambles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2CAA2C;AAC3C,wBAAgB,mBAAmB,IAAI,MAAM,CA0C5C;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,IAAI,MAAM,CAe/C;AAED,2CAA2C;AAC3C,wBAAgB,kBAAkB,IAAI,MAAM,CAgB3C;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,IAAI,MAAM,CAAwH;AAElK,kFAAkF;AAClF,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/interview/preambles.js

@@ -0,0 +1,93 @@
+/**
+ * Authored LLM instruction content — quality preambles and closers.
+ *
+ * This module holds prompt *content* only. Injection happens inside each
+ * extension method's body in its own concern file (composition, extraction,
+ * classification, prompt). See ADR: composition-quality.
+ */
+/** Prepended to every ctx.compose call. */
+export function compositionPreamble() {
+    return `
+    <composition_rules>
+      You are composing a single interview question with optional suggested answers. Format output as markdown.
+
+      <questioning>
+        1. Question stem under 20 words. One sentence, SVO structure, no embedded clauses.
+        2. Compose context as a separate preceding statement — keep it out of the question.
+        3. Keep total message concise — prefer 3-4 sentences.
+        4. Use affirmative question stems ("Which of these are goals?" not "Which are NOT goals?").
+        5. Attach a concrete handle to "why" questions ("What led you to…?" not bare "Why?").
+        6. Prefer experience-grounded questions ("Tell me about a time…") over hypotheticals, except for negative probing.
+        7. When rephrasing, change the approach and angle — offer a concrete example or scaffold when the respondent signals confusion.
+        8. Ask exactly one question per message — never include two or more question marks.
+      </questioning>
+
+      <formatting>
+        1. Bold the key noun phrase (2-4 words) in each question: "What **safety equipment** do you currently use?"
+        2. Keep bolding under ~30% of text.
+        3. Leave suggestions unbolded.
+      </formatting>
+
+      <bias>
+        1. Use neutral language — no evaluative adjectives, no positive/negative framing preambles.
+        2. Ask existence-checking questions before assuming specifics ("Walk me through your current process" before "What features do you want?").
+        3. Frame for openness ("How do you feel about…?" not "Do you agree that…?").
+        4. Normalize uncertainty when appropriate ("It's completely fine if you're not sure").
+        5. Reflect the respondent's own words without upgrading their certainty or specificity.
+        6. Present the question only — do not offer your own interpretation or answer within it.
+        7. Vary suggested answers across different angles or specificity levels when the topic allows — avoid clustering all suggestions around the same type.
+      </bias>
+
+      <register>
+        1. Approachable, clear tone — "knowledgeable friend." Not overly formal, not buddy-like.
+        2. Mirror the respondent's vocabulary level.
+        3. Gloss jargon only when the respondent hasn't used the term themselves.
+        4. Frame questions from the respondent's perspective — use the name and role of the stakeholder marked isRespondent in the context. Do not frame questions for other stakeholders' perspectives.
+      </register>
+
+      Keep questions focused and unbiased. The respondent's words are the source of truth.
+    </composition_rules>
+  `;
+}
+/** Prepended to confirmation classification guidance. */
+export function classificationPreamble() {
+    return `
+    <classification_rules>
+      You are classifying whether the respondent approved a summary or requested a revision.
+
+      <bias_correction>
+        1. Weight correction signals generously — if the respondent mentions anything to change, classify as revision even if they also express general approval.
+        2. Treat ambiguous responses as revision requests, not approvals.
+        3. Treat hedging language ("I guess it's fine", "mostly", "probably ok") as revision signals.
+        4. Only classify as approved when the respondent clearly and unambiguously endorses the summary.
+      </bias_correction>
+
+      When in doubt, classify as revision. A false revision is cheaper than a missed correction.
+    </classification_rules>
+  `;
+}
+/** Prepended to every ctx.extract call. */
+export function extractionPreamble() {
+    return `
+    <extraction_rules>
+      You are extracting structured data from the respondent's words.
+
+      <fidelity>
+        1. Extract the respondent's words faithfully — preserve their language, don't interpret or rephrase.
+        2. Record what they said, not what you think they meant. "Mentioned mobile" stays "mentioned mobile", not "mobile-first requirement".
+        3. Do not upgrade certainty — "might need" stays tentative, not "needs".
+        4. Do not add evaluative framing ("key", "main", "critical") unless the respondent used those words.
+        5. Do not infer fields the respondent did not mention — leave them empty.
+      </fidelity>
+
+      The respondent is the authority on their own intent. Extract, don't interpret.
+    </extraction_rules>
+  `;
+}
+/** Appended after suggestion list in promptQuestion. */
+export function suggestionCloser() { return "...or better yet, describe in your own words — your phrasing captures nuances that pre-made options can't"; }
+/** Correction-inviting closer for phase confirmation prompts (not validation). */
+export function confirmationCloser() {
+    return "What would you change or add? If this looks right as-is, let me know and we'll move on.";
+}
+//# sourceMappingURL=preambles.js.map

package/dist/interview/preambles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preambles.js","sourceRoot":"","sources":["../../src/interview/preambles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2CAA2C;AAC3C,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCN,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,sBAAsB;IACpC,OAAO;;;;;;;;;;;;;GAaN,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;GAcN,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,gBAAgB,KAAa,OAAO,2GAA2G,CAAC,CAAC,CAAC;AAElK,kFAAkF;AAClF,MAAM,UAAU,kBAAkB;IAChC,OAAO,yFAAyF,CAAC;AACnG,CAAC"}

package/dist/interview/progress.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Progress tracking — step/total/label state on WorkflowContext, a sublabel
+ * formatter for human-readable progress prefixes, and a transition-message
+ * slot consumed by the next user-facing prompt.
+ */
+/** Progress state for the current phase. */
+export interface ProgressState {
+    step: number;
+    total: number;
+    label: string;
+}
+/**
+ * Derive a human-readable sublabel from a prompt id.
+ * "goal-refinement-question-goal_001-clarify-0" → "refining goal #1"
+ * "purpose-confirmation-0" → "confirmation"
+ * "scope-constraint-question" → "constraints"
+ */
+export declare function formatSublabel(id: string): string;
+/** Build a progress prefix string from state and prompt id. */
+export declare function progressPrefix(progress: ProgressState | null, id: string): string;
+declare module "../durable/workflow.js" {
+    interface WorkflowContext {
+        /** Progress state for the current phase. */
+        progress: ProgressState | null;
+        /** Transition message to prepend to the next user-facing prompt (consumed once). */
+        pendingTransition: string | null;
+        setProgress(step: number, total: number, label: string): void;
+        setTransition(message: string | undefined): void;
+    }
+}
+//# sourceMappingURL=progress.d.ts.map

package/dist/interview/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/interview/progress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAE7E;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAKjF;AAED,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,eAAe;QACvB,4CAA4C;QAC5C,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;QAC/B,oFAAoF;QACpF,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;KAClD;CACF"}

package/dist/interview/progress.js

@@ -0,0 +1,51 @@
+/**
+ * Progress tracking — step/total/label state on WorkflowContext, a sublabel
+ * formatter for human-readable progress prefixes, and a transition-message
+ * slot consumed by the next user-facing prompt.
+ */
+import { WorkflowContext } from "../durable/index.js";
+/**
+ * Derive a human-readable sublabel from a prompt id.
+ * "goal-refinement-question-goal_001-clarify-0" → "refining goal #1"
+ * "purpose-confirmation-0" → "confirmation"
+ * "scope-constraint-question" → "constraints"
+ */
+export function formatSublabel(id) {
+    const phases = ["opening", "purpose", "goal", "goals", "stakeholder", "stakeholders", "scope", "assumption", "assumptions", "validation"];
+    let rest = id;
+    for (const p of phases) {
+        if (rest.startsWith(p + "-")) {
+            rest = rest.slice(p.length + 1);
+            break;
+        }
+    }
+    rest = rest.replace(/_0*(\d+)/g, " #$1");
+    rest = rest.replace(/-r\d+$/, "").replace(/-\d+$/, "");
+    rest = rest.replace(/-?question-?/g, "-").replace(/-?extraction-?/g, "-").replace(/-?composition-?/g, "-");
+    rest = rest.replace(/-+/g, " ").trim();
+    rest = rest.replace(/\s+\d+$/, "");
+    return rest;
+}
+/** Build a progress prefix string from state and prompt id. */
+export function progressPrefix(progress, id) {
+    if (!progress)
+        return "";
+    const { step, total, label } = progress;
+    const sub = formatSublabel(id);
+    return sub ? `[${step}/${total} ${label} · ${sub}]` : `[${step}/${total} ${label}]`;
+}
+WorkflowContext.prototype.progress = null;
+WorkflowContext.prototype.pendingTransition = null;
+WorkflowContext.prototype.setProgress = function (step, total, label) {
+    this.progress = { step, total, label };
+};
+WorkflowContext.prototype.setTransition = function (message) {
+    this.pendingTransition = message ?? null;
+};
+const REQUIRED_PROTOTYPE_METHODS = ["setProgress", "setTransition"];
+for (const method of REQUIRED_PROTOTYPE_METHODS) {
+    if (typeof WorkflowContext.prototype[method] !== "function") {
+        throw new Error(`interview/progress.ts self-check failed: WorkflowContext.prototype.${method} is not a function.`);
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/interview/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/interview/progress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAKtD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;IAC1I,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAAC,MAAM;QAAC,CAAC;IAC3E,CAAC;IAED,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAC3G,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAEnC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,QAA8B,EAAE,EAAU;IACvE,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IACxC,MAAM,GAAG,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAC/B,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,KAAK,IAAI,KAAK,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC;AACtF,CAAC;AAaD,eAAe,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1C,eAAe,CAAC,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC;AAEnD,eAAe,CAAC,SAAS,CAAC,WAAW,GAAG,UAAU,IAAI,EAAE,KAAK,EAAE,KAAK;IAClE,IAAI,CAAC,QAAQ,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACzC,CAAC,CAAC;AAEF,eAAe,CAAC,SAAS,CAAC,aAAa,GAAG,UAAU,OAAO;IACzD,IAAI,CAAC,iBAAiB,GAAG,OAAO,IAAI,IAAI,CAAC;AAC3C,CAAC,CAAC;AAEF,MAAM,0BAA0B,GAAG,CAAC,aAAa,EAAE,eAAe,CAAU,CAAC;AAC7E,KAAK,MAAM,MAAM,IAAI,0BAA0B,EAAE,CAAC;IAChD,IAAI,OAAQ,eAAe,CAAC,SAAgD,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;QACpG,MAAM,IAAI,KAAK,CAAC,sEAAsE,MAAM,qBAAqB,CAAC,CAAC;IACrH,CAAC;AACH,CAAC"}

package/dist/interview/prompt.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Prompt formatters — wrap ctx.prompt() with progress prefix, pending transition,
+ * suggestion lists, and contradiction formatting.
+ */
+/** Agent-composed question with optional suggested answers. */
+export type QuestionContext = {
+    question: string;
+    suggestions?: string[];
+};
+declare module "../durable/workflow.js" {
+    interface WorkflowContext {
+        promptStep(step: {
+            id: string;
+            message: string;
+        }): Promise<string>;
+        promptQuestion(id: string, ask: QuestionContext): Promise<string>;
+        promptContradiction(id: string, contradictions: string[]): Promise<string>;
+    }
+}
+//# sourceMappingURL=prompt.d.ts.map

package/dist/interview/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/interview/prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,+DAA+D;AAC/D,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3E,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,eAAe;QACvB,UAAU,CAAC,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACnE,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAClE,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;KAC5E;CACF"}

package/dist/interview/prompt.js

@@ -0,0 +1,58 @@
+/**
+ * Prompt formatters — wrap ctx.prompt() with progress prefix, pending transition,
+ * suggestion lists, and contradiction formatting.
+ */
+import { WorkflowContext } from "../durable/index.js";
+import { progressPrefix } from "./progress.js";
+import { suggestionCloser } from "./preambles.js";
+/** Prompt with a PromptStep, auto-applying progress prefix and pending transition. */
+WorkflowContext.prototype.promptStep = async function (step) {
+    let message = step.message;
+    if (this.pendingTransition) {
+        message = this.pendingTransition + "\n\n" + message;
+        this.pendingTransition = null;
+    }
+    const prefix = progressPrefix(this.progress, step.id);
+    return this.prompt({ ...step, message: prefix ? `${prefix}\n${message}` : message });
+};
+/** Format a QuestionContext with lettered suggestions and prompt the respondent. */
+WorkflowContext.prototype.promptQuestion = async function (id, ask) {
+    let message = ask.question;
+    if (ask.suggestions && ask.suggestions.length > 0) {
+        const letters = "abcdefghijklmnopqrstuvwxyz";
+        message += "\n\nFor example:";
+        for (let i = 0; i < ask.suggestions.length; i++) {
+            message += `\n${letters[i]}) ${ask.suggestions[i]}`;
+        }
+        if (suggestionCloser())
+            message += `\n${suggestionCloser()}`;
+    }
+    if (this.pendingTransition) {
+        message = this.pendingTransition + "\n\n" + message;
+        this.pendingTransition = null;
+    }
+    const prefix = progressPrefix(this.progress, id);
+    return this.prompt({ id, message: prefix ? `${prefix}\n${message}` : message, suggestions: ask.suggestions });
+};
+/** Present detected contradictions to the respondent and ask for clarification. */
+WorkflowContext.prototype.promptContradiction = async function (id, contradictions) {
+    const parts = ["I noticed something that might be inconsistent with what you said earlier:"];
+    for (const c of contradictions) {
+        parts.push(`\n- ${c}`);
+    }
+    parts.push("\n\nCould you help me understand what changed?");
+    let message = parts.join("");
+    if (this.pendingTransition) {
+        message = this.pendingTransition + "\n\n" + message;
+        this.pendingTransition = null;
+    }
+    const prefix = progressPrefix(this.progress, id);
+    return this.prompt({ id, message: prefix ? `${prefix}\n${message}` : message });
+};
+const REQUIRED_PROTOTYPE_METHODS = ["promptStep", "promptQuestion", "promptContradiction"];
+for (const method of REQUIRED_PROTOTYPE_METHODS) {
+    if (typeof WorkflowContext.prototype[method] !== "function") {
+        throw new Error(`interview/prompt.ts self-check failed: WorkflowContext.prototype.${method} is not a function.`);
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/interview/prompt.js.map

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

package/dist/phases/aggregate/assumptions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Assumption aggregate mutations — unvalidated / validated / flagged states
+ * with status-driven confidence.
+ */
+import type { Artifacts, Assumption, AssumptionType, AssumptionStatus, Source } from "../schema.js";
+export declare function addAssumptions(data: Artifacts, items: Array<{
+    statement: string;
+    type?: AssumptionType;
+    relatedGoals?: string[];
+}>, confidence?: number, status?: AssumptionStatus, source?: Source): void;
+export declare function setAssumptionStatus(data: Artifacts, id: string, status: AssumptionStatus): void;
+export declare function removeAssumptions(data: Artifacts, ids: Set<string>): void;
+export declare function findAssumption(data: Artifacts, id: string): Assumption | undefined;
+//# sourceMappingURL=assumptions.d.ts.map

package/dist/phases/aggregate/assumptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assumptions.d.ts","sourceRoot":"","sources":["../../../src/phases/aggregate/assumptions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAIpG,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,cAAc,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EACnF,UAAU,SAAoC,EAC9C,MAAM,GAAE,gBAAgC,EACxC,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAYN;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAK/F;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAEzE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAElF"}

package/dist/phases/aggregate/assumptions.js

@@ -0,0 +1,33 @@
+/**
+ * Assumption aggregate mutations — unvalidated / validated / flagged states
+ * with status-driven confidence.
+ */
+import { ASSUMPTION_CONFIDENCE } from "../schema.js";
+import { nextId } from "./shared.js";
+export function addAssumptions(data, items, confidence = ASSUMPTION_CONFIDENCE.unvalidated, status = "unvalidated", source) {
+    for (const item of items) {
+        data.assumptions.push({
+            id: nextId("assumption", data.assumptions),
+            statement: item.statement,
+            type: item.type ?? "hypothesis",
+            status,
+            relatedGoals: item.relatedGoals ?? [],
+            confidence,
+            ...(source && { source }),
+        });
+    }
+}
+export function setAssumptionStatus(data, id, status) {
+    const a = findAssumption(data, id);
+    if (!a)
+        return;
+    a.status = status;
+    a.confidence = ASSUMPTION_CONFIDENCE[status];
+}
+export function removeAssumptions(data, ids) {
+    data.assumptions = data.assumptions.filter((a) => !ids.has(a.id));
+}
+export function findAssumption(data, id) {
+    return data.assumptions.find((a) => a.id === id);
+}
+//# sourceMappingURL=assumptions.js.map

package/dist/phases/aggregate/assumptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assumptions.js","sourceRoot":"","sources":["../../../src/phases/aggregate/assumptions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,UAAU,cAAc,CAC5B,IAAe,EACf,KAAmF,EACnF,UAAU,GAAG,qBAAqB,CAAC,WAAW,EAC9C,SAA2B,aAAa,EACxC,MAAe;IAEf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YACpB,EAAE,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC;YAC1C,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,YAAY;YAC/B,MAAM;YACN,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,EAAE;YACrC,UAAU;YACV,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,CAAC;SAC1B,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAe,EAAE,EAAU,EAAE,MAAwB;IACvF,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,CAAC;QAAE,OAAO;IACf,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC,CAAC,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAe,EAAE,GAAgB;IACjE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAe,EAAE,EAAU;IACxD,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/phases/aggregate/findings.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Findings aggregate mutations — observations surfaced during any phase
+ * (typically validation / contradiction checks), tagged with their originating
+ * phase for later display.
+ */
+import type { Artifacts, Finding } from "../schema.js";
+export declare function addDomainHints(data: Artifacts, hints: string[]): void;
+export declare function addFinding(data: Artifacts, content: string, phase: string): void;
+export declare function findingsByPhase(data: Artifacts, phase: string): Finding[];
+//# sourceMappingURL=findings.d.ts.map

package/dist/phases/aggregate/findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../../../src/phases/aggregate/findings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAErE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMhF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAEzE"}