@vendoai/apps 0.4.0

package/dist/pins.d.ts

@@ -0,0 +1,231 @@
+import { type AppDocument, type AppId, type IsoDateTime, type Json, type Pin } from "@vendoai/core";
+import { z } from "zod";
+/** 06-apps §8 — source captured from one host remixable component slot. */
+export interface PinBaseline {
+    slot: string;
+    source: string;
+    hash: string;
+    exportable: boolean;
+    capturedAt: IsoDateTime;
+    sourceImports?: Record<string, string>;
+    subSources?: Record<string, PinSubSource>;
+    sampleProps?: Record<string, Json>;
+    styles?: PinStyle[];
+}
+/** Captured source-owned virtual module plus its own resolved import table. */
+export interface PinSubSource {
+    source: string;
+    imports: Record<string, string>;
+}
+/** One inert host stylesheet snapshot captured from a canonical app root. */
+export interface PinStyle {
+    path: string;
+    css: string;
+}
+/** 06-apps §8 — validated persisted representation of a captured host baseline. */
+export declare const pinBaselineSchema: z.ZodObject<{
+    slot: z.ZodString;
+    source: z.ZodString;
+    hash: z.ZodString;
+    exportable: z.ZodBoolean;
+    capturedAt: z.ZodString;
+    sourceImports: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    subSources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        source: z.ZodString;
+        imports: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        source: z.ZodString;
+        imports: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        source: z.ZodString;
+        imports: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    sampleProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    styles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        css: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        path: z.ZodString;
+        css: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        path: z.ZodString;
+        css: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    slot: z.ZodString;
+    source: z.ZodString;
+    hash: z.ZodString;
+    exportable: z.ZodBoolean;
+    capturedAt: z.ZodString;
+    sourceImports: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    subSources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        source: z.ZodString;
+        imports: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        source: z.ZodString;
+        imports: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        source: z.ZodString;
+        imports: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    sampleProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    styles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        css: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        path: z.ZodString;
+        css: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        path: z.ZodString;
+        css: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    slot: z.ZodString;
+    source: z.ZodString;
+    hash: z.ZodString;
+    exportable: z.ZodBoolean;
+    capturedAt: z.ZodString;
+    sourceImports: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    subSources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        source: z.ZodString;
+        imports: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        source: z.ZodString;
+        imports: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        source: z.ZodString;
+        imports: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    sampleProps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    styles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        css: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        path: z.ZodString;
+        css: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        path: z.ZodString;
+        css: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Internal stable generated-component name for one captured host slot. */
+export declare const pinComponentName: (slot: string) => string;
+/** Whether the fork entry source exposes the default export the jail renders:
+    `export default …`, `export { X as default }`, or `export { default } from …`
+    — but NOT a renamed re-export like `export { default as X } from …`, which
+    exposes only the named binding. */
+export declare const hasDefaultExport: (rawSource: string) => boolean;
+/**
+ * ENG-348 — the generated-component entry source a fork ships. The jail entry
+ * renders only a default export, but a host may register a NAMED export as
+ * remixable and sync captures its module verbatim; forking that capture as-is
+ * crashes at render ("must have a React default export"). Synthesize the
+ * default export by aliasing the captured component's named export. A source
+ * that already has a default export — or offers no component-cased export to
+ * alias — passes through verbatim.
+ */
+export declare const pinForkSource: (source: string) => string;
+/** 06-apps §8 — unified source diff proposed for host approval. */
+export interface PinShipRequest {
+    appId: AppId;
+    slot: string;
+    baseHash: string;
+    diff: string;
+}
+/** 06-apps §8 — validated wire representation of a pin ship request. */
+export declare const pinShipRequestSchema: z.ZodObject<{
+    appId: z.ZodString;
+    slot: z.ZodString;
+    baseHash: z.ZodString;
+    diff: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    appId: z.ZodString;
+    slot: z.ZodString;
+    baseHash: z.ZodString;
+    diff: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    appId: z.ZodString;
+    slot: z.ZodString;
+    baseHash: z.ZodString;
+    diff: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+/** 06-apps §8 — immutable host approval for one baseline-to-version transition. */
+export interface PinApproval {
+    slot: string;
+    baseHash: string;
+    approvedHash: string;
+    approvedBy: string;
+    at: IsoDateTime;
+}
+/** 06-apps §8 — validated wire representation of a host pin approval. */
+export declare const pinApprovalSchema: z.ZodObject<{
+    slot: z.ZodString;
+    baseHash: z.ZodString;
+    approvedHash: z.ZodString;
+    approvedBy: z.ZodString;
+    at: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    slot: z.ZodString;
+    baseHash: z.ZodString;
+    approvedHash: z.ZodString;
+    approvedBy: z.ZodString;
+    at: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    slot: z.ZodString;
+    baseHash: z.ZodString;
+    approvedHash: z.ZodString;
+    approvedBy: z.ZodString;
+    at: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+/** 06-apps §9 — approval to mount one exact app version in the host page. */
+export interface InClientApproval {
+    appId: AppId;
+    versionHash: string;
+    approvedBy: string;
+    at: IsoDateTime;
+}
+/** 06-apps §9 — validated wire representation of an in-client approval. */
+export declare const inClientApprovalSchema: z.ZodObject<{
+    appId: z.ZodString;
+    versionHash: z.ZodString;
+    approvedBy: z.ZodString;
+    at: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    appId: z.ZodString;
+    versionHash: z.ZodString;
+    approvedBy: z.ZodString;
+    at: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    appId: z.ZodString;
+    versionHash: z.ZodString;
+    approvedBy: z.ZodString;
+    at: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+/**
+ * 06-apps §8 — one drifted pin: the host component changed (or its baseline
+ * disappeared) under a fork, so the fork's `base` no longer names the source
+ * the host is running. SERVER-AUTHORITATIVE when it rides an open() payload:
+ * only `detectPinDrift` over the composition's loaded baselines writes it.
+ */
+export interface PinDrift {
+    slot: string;
+    /** The generated-component name the fork ships under (`pinComponentName`). */
+    component: string;
+    /** The baseline hash the pin was forked from (`Pin.base`). */
+    baseHash: string;
+    /** The hash of the currently captured host baseline, when one exists. */
+    baselineHash?: string;
+    reason: "baseline-changed" | "baseline-missing";
+}
+/**
+ * 06-apps §8 — "a host update to the component marks the pin drifted". Pure
+ * over the app document and the composition's loaded baselines so the opener,
+ * the edit path, and the rebase surface all report the same verdict.
+ */
+export declare const detectPinDrift: (doc: AppDocument, baselines: readonly PinBaseline[]) => PinDrift[];
+/**
+ * 06-apps §7–§8 — require explicit host permission for every exported pin.
+ * Missing baselines fail closed because an artifact export must never strip pins.
+ */
+export declare const assertPinsExportable: (pins: readonly Pin[], baselines: readonly PinBaseline[]) => void;
+//# sourceMappingURL=pins.d.ts.map

package/dist/pins.d.ts.map

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

package/dist/pins.js

@@ -0,0 +1,213 @@
+import { VendoError, appIdSchema, isoDateTimeSchema, sha256Hex, } from "@vendoai/core";
+import { z } from "zod";
+const pinSubSourceSchema = z.object({
+    source: z.string(),
+    imports: z.record(z.string()),
+}).passthrough();
+const pinStyleSchema = z.object({
+    path: z.string(),
+    css: z.string(),
+}).passthrough();
+/** 06-apps §8 — validated persisted representation of a captured host baseline. */
+export const pinBaselineSchema = z.object({
+    slot: z.string(),
+    source: z.string(),
+    hash: z.string().startsWith("sha256:"),
+    exportable: z.boolean(),
+    capturedAt: isoDateTimeSchema,
+    sourceImports: z.record(z.string()).optional(),
+    subSources: z.record(pinSubSourceSchema).optional(),
+    sampleProps: z.record(z.unknown()).optional(),
+    styles: z.array(pinStyleSchema).optional(),
+}).passthrough();
+/** Internal stable generated-component name for one captured host slot. */
+export const pinComponentName = (slot) => {
+    const stem = (slot.match(/[A-Za-z0-9]+/g) ?? [])
+        .map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`)
+        .join("") || "Slot";
+    // The hash suffix prevents punctuation-only normalization collisions while
+    // keeping the name a valid generated-component PascalCase identifier.
+    return `Pinned${stem}${sha256Hex(slot).slice(0, 8)}`;
+};
+/**
+ * Blank comment and string/template contents (length-preserving) so export
+ * detection never matches commented-out or quoted code. (Adapted from the
+ * `stripComments` helper sync's extraction carried before it moved onto the
+ * TypeScript AST — actions may not be imported here.)
+ */
+const blankCommentsAndStrings = (source) => {
+    let output = "";
+    let quote = null;
+    let escaped = false;
+    for (let index = 0; index < source.length; index += 1) {
+        const character = source[index];
+        const next = source[index + 1];
+        if (quote) {
+            if (escaped) {
+                escaped = false;
+                output += " ";
+                continue;
+            }
+            if (character === "\\") {
+                escaped = true;
+                output += " ";
+                continue;
+            }
+            if (character === quote) {
+                quote = null;
+                output += character;
+                continue;
+            }
+            output += character === "\n" ? "\n" : " ";
+            continue;
+        }
+        if (character === "'" || character === "\"" || character === "`") {
+            quote = character;
+            output += character;
+            continue;
+        }
+        if (character === "/" && next === "/") {
+            while (index < source.length && source[index] !== "\n") {
+                output += " ";
+                index += 1;
+            }
+            if (index < source.length)
+                output += "\n";
+            continue;
+        }
+        if (character === "/" && next === "*") {
+            output += "  ";
+            index += 2;
+            while (index < source.length && !(source[index] === "*" && source[index + 1] === "/")) {
+                output += source[index] === "\n" ? "\n" : " ";
+                index += 1;
+            }
+            if (index < source.length)
+                output += "  ";
+            index += 1;
+            continue;
+        }
+        output += character;
+    }
+    return output;
+};
+const EXPORT_LIST = /\bexport\s*\{([^}]*)\}/gu;
+/** Whether the fork entry source exposes the default export the jail renders:
+    `export default …`, `export { X as default }`, or `export { default } from …`
+    — but NOT a renamed re-export like `export { default as X } from …`, which
+    exposes only the named binding. */
+export const hasDefaultExport = (rawSource) => {
+    const source = blankCommentsAndStrings(rawSource);
+    // `export default interface …` (and any type-level default) is erased from
+    // the emitted JavaScript, so it is not a runtime default export.
+    if (/\bexport\s+default\b(?!\s+(?:interface|type)\b)/u.test(source))
+        return true;
+    for (const match of source.matchAll(EXPORT_LIST)) {
+        for (const entry of match[1].split(",")) {
+            const trimmed = entry.trim();
+            // A `type` entry is erased from the emitted JavaScript — no runtime default.
+            if (/^type\s/u.test(trimmed))
+                continue;
+            const [local, exported] = trimmed.split(/\s+as\s+/u).map((part) => part.trim());
+            if ((exported ?? local) === "default")
+                return true;
+        }
+    }
+    return false;
+};
+/** Every named-export binding: the local name to alias plus the exported name. */
+const namedExportBindings = (source) => {
+    const bindings = [];
+    const declaration = /\bexport\s+(?:async\s+)?(?:function\s*\*?|const|let|var|class)\s+([A-Za-z_$][\w$]*)/gu;
+    for (const match of source.matchAll(declaration)) {
+        bindings.push({ local: match[1], exported: match[1], at: match.index ?? 0 });
+    }
+    // Local export lists only — a `from` re-export has no local binding to alias.
+    const list = /\bexport\s*\{([^}]*)\}(?!\s*from\b)/gu;
+    for (const match of source.matchAll(list)) {
+        for (const entry of match[1].split(",")) {
+            const [local, exported] = entry.trim().split(/\s+as\s+/u).map((part) => part.trim());
+            if (!local || !/^[A-Za-z_$][\w$]*$/u.test(local))
+                continue;
+            bindings.push({ local, exported: exported ?? local, at: match.index ?? 0 });
+        }
+    }
+    return bindings.sort((left, right) => left.at - right.at);
+};
+/**
+ * ENG-348 — the generated-component entry source a fork ships. The jail entry
+ * renders only a default export, but a host may register a NAMED export as
+ * remixable and sync captures its module verbatim; forking that capture as-is
+ * crashes at render ("must have a React default export"). Synthesize the
+ * default export by aliasing the captured component's named export. A source
+ * that already has a default export — or offers no component-cased export to
+ * alias — passes through verbatim.
+ */
+export const pinForkSource = (source) => {
+    if (hasDefaultExport(source))
+        return source;
+    const component = namedExportBindings(blankCommentsAndStrings(source))
+        .find(({ exported }) => /^[A-Z]/u.test(exported));
+    if (component === undefined)
+        return source;
+    return `${source}\nexport { ${component.local} as default };\n`;
+};
+/** 06-apps §8 — validated wire representation of a pin ship request. */
+export const pinShipRequestSchema = z.object({
+    appId: appIdSchema,
+    slot: z.string(),
+    baseHash: z.string(),
+    diff: z.string(),
+}).passthrough();
+/** 06-apps §8 — validated wire representation of a host pin approval. */
+export const pinApprovalSchema = z.object({
+    slot: z.string(),
+    baseHash: z.string(),
+    approvedHash: z.string(),
+    approvedBy: z.string(),
+    at: isoDateTimeSchema,
+}).passthrough();
+/** 06-apps §9 — validated wire representation of an in-client approval. */
+export const inClientApprovalSchema = z.object({
+    appId: appIdSchema,
+    versionHash: z.string(),
+    approvedBy: z.string(),
+    at: isoDateTimeSchema,
+}).passthrough();
+/**
+ * 06-apps §8 — "a host update to the component marks the pin drifted". Pure
+ * over the app document and the composition's loaded baselines so the opener,
+ * the edit path, and the rebase surface all report the same verdict.
+ */
+export const detectPinDrift = (doc, baselines) => (doc.pins ?? []).flatMap((pin) => {
+    const baseline = baselines.find((candidate) => candidate.slot === pin.slot);
+    if (baseline?.hash === pin.base)
+        return [];
+    return [{
+            slot: pin.slot,
+            component: pinComponentName(pin.slot),
+            baseHash: pin.base,
+            ...(baseline === undefined ? {} : { baselineHash: baseline.hash }),
+            reason: baseline === undefined ? "baseline-missing" : "baseline-changed",
+        }];
+});
+/**
+ * 06-apps §7–§8 — require explicit host permission for every exported pin.
+ * Missing baselines fail closed because an artifact export must never strip pins.
+ */
+export const assertPinsExportable = (pins, baselines) => {
+    for (const pin of pins) {
+        const baseline = baselines.find((candidate) => candidate.slot === pin.slot);
+        if (baseline?.hash === pin.base && baseline.exportable === true)
+            continue;
+        const reason = baseline === undefined
+            ? "missing-baseline"
+            : baseline.hash !== pin.base ? "baseline-hash-mismatch" : "baseline-forbids-export";
+        throw new VendoError("blocked", `pin ${pin.slot} is not exportable`, {
+            slot: pin.slot,
+            base: pin.base,
+            reason,
+        });
+    }
+};
+//# sourceMappingURL=pins.js.map

package/dist/pins.js.map

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

package/dist/pipeline.d.ts

@@ -0,0 +1,142 @@
+import { type NormalizedCatalog, type TreeNode, type TreeV2, type WireCompileResult } from "@vendoai/core";
+import type { GeneratedAppDocument, GenerationDependencies, HostToolInfo } from "./engine.js";
+/** W4 pipeline (spec §How a generation runs) — engine-internal knobs.
+ *  `structuredRepair` (adopt-now) replaces free-form repair regeneration with
+ *  one strict tool-use call over the closed fix space; on by default.
+ *  `regionParallel` (outline + parallel section writers) and `endPass`
+ *  (no-think polish read-through) are opt-in flags while being measured. */
+export interface PipelineConfig {
+    structuredRepair?: boolean;
+    regionParallel?: boolean;
+    endPass?: boolean;
+    /** v4 wave — the rewritten create contract (single-voice sections, principles
+     *  stated once, worked exemplars; scar-tissue rules retired to validators +
+     *  repair). Opt-in while the A/B against the current contract is measured. */
+    promptRewrite?: boolean;
+}
+/** W4 pipeline — opt-in per-stage diagnostics: rounds, no-valid-fix
+ *  take-rate, region-parallel fallback reasons, end-pass adoption, wall-clock
+ *  per stage. Powers live measurement and production observability. */
+export type PipelineEvent = {
+    stage: "repair";
+    rounds: number;
+    repaired: boolean;
+    noValidFix: number;
+    ms: number;
+} | {
+    stage: "region-parallel";
+    fallback?: "no-outline" | "sections-failed" | "assembly-invalid";
+    sectionsPlanned?: number;
+    sectionsLanded?: number;
+    ms: number;
+} | {
+    stage: "end-pass";
+    applied: boolean;
+    ms: number;
+};
+/** The engine's create validation, passed in as a callback so pipeline.ts
+ *  never imports engine internals (engine → pipeline stays one-directional). */
+export type CreateValidator = (compiled: WireCompileResult) => Promise<{
+    document?: GeneratedAppDocument;
+    issues: string[];
+}>;
+export interface PipelineContext {
+    deps: GenerationDependencies;
+    hostComponents: readonly string[];
+    validate: CreateValidator;
+    /** Milliseconds origin of the surrounding create() for onTiming events. */
+    startedAt: number;
+}
+/** Button labels that promise a state change. A Button carrying one of these
+ *  is a submit/primary affordance: it must DO something (a mutating host tool
+ *  bound to real context) or honestly say it can't — a no-op submit is the
+ *  facade class. Read-only verbs (view/show/open) and dismiss verbs
+ *  (cancel/clear/close) are deliberately excluded. */
+export declare const SUBMIT_LABEL: RegExp;
+export declare const isMutatingRisk: (risk: string | undefined) => boolean;
+export declare const hasPayload: (payload: unknown) => boolean;
+/** Every {action,payload?} binding reachable in a node's props, with the prop
+ *  it sits under (actions can nest inside arrays/objects, not just top-level
+ *  on* attributes). */
+export declare const actionBindingsInProps: (props: Record<string, unknown>) => Array<{
+    prop: string;
+    action: string;
+    payload: unknown;
+}>;
+/** One structured action-honesty failure (the string rendering lives in
+ *  engine.actionIssues; this shape feeds the repair fix space). W3 adds the
+ *  law-2 grounding kinds: an action must name a REAL tool, and its payload
+ *  fields must be the tool's REAL input parameters. */
+export interface ActionFault {
+    nodeId: string;
+    kind: "dead-submit" | "missing-payload" | "read-only-submit" | "unknown-tool" | "ungrounded-payload";
+    prop?: string;
+    action?: string;
+    label?: string;
+    /** ungrounded-payload — the payload keys the tool's input schema does not declare. */
+    unknownFields?: string[];
+    /** ungrounded-payload — the tool's real input parameter names. */
+    allowedFields?: string[];
+    /** ungrounded-payload — REQUIRED input parameters absent from the payload. */
+    missingFields?: string[];
+}
+export declare const actionFaults: (tree: TreeV2, tools: readonly HostToolInfo[] | undefined) => ActionFault[];
+/** The data-classed prop names of one node: Kit prop classes for adopted Kit
+ *  names, the legacy map for the old prewired set, schema-derived for host
+ *  catalog components. */
+export declare const dataClassedProps: (node: TreeNode, catalog: NormalizedCatalog) => readonly string[];
+export interface LiteralDataFault {
+    nodeId: string;
+    component: string;
+    prop: string;
+}
+/** Law 1 — every data-classed prop present on a node must be a `$path` /
+ *  `$state` binding. A literal there is hand-typed business data. */
+export declare const literalDataFaults: (tree: TreeV2, catalog: NormalizedCatalog) => LiteralDataFault[];
+export declare const NO_VALID_FIX = "__no_valid_fix__";
+export interface StructuredRepairResult {
+    document?: GeneratedAppDocument;
+    /** Strict-call rounds actually spent (spliced or not). */
+    rounds: number;
+    issues: string[];
+    /** How many fixes resolved to the no-valid-fix/Disclaimer arm. */
+    noValidFixCount: number;
+}
+/** v3 pipeline step 5 — structured repair. Compile errors with a closed fix
+ *  space are fixed by ONE strict tool-use call per round (max `maxRounds`),
+ *  spliced deterministically into the canonical tree, re-printed, re-compiled
+ *  and re-validated. Anything outside the closed space (or a failed call)
+ *  returns with `document` unset and the caller falls back to today's
+ *  free-form regeneration loop. */
+export declare const structuredRepair: (compiled: WireCompileResult, userRequest: string, context: PipelineContext, maxRounds?: number) => Promise<StructuredRepairResult>;
+export declare const endPassViolations: (base: TreeV2, patched: TreeV2, baseComponents: Record<string, string>, patchedComponents: Record<string, string>) => string[];
+/** Same fence tolerance as engine.ts's extractWire, for <Edit> documents
+ *  (shared by the edit dialect and the end pass). */
+export declare const extractEdit: (text: string) => string;
+/** v3 pipeline step 6, sharpened in v4 — the end pass. Runs only under the
+ *  `endPass` flag (default flips when the v4 A/B earns it); a patch survives
+ *  only if it compiles clean, applies at most 4 ops, and the patched app
+ *  re-validates — otherwise the original document ships untouched.
+ *  Structurally cannot break the app. */
+export declare const endPass: (document: GeneratedAppDocument, userRequest: string, context: PipelineContext) => Promise<GeneratedAppDocument>;
+export interface RegionParallelResult {
+    document?: GeneratedAppDocument;
+    /** Why the parallel path yielded no document (measurement + fallback). */
+    fallback?: "no-outline" | "sections-failed" | "assembly-invalid";
+    sectionsPlanned?: number;
+    sectionsLanded?: number;
+}
+export interface RegionParallelHooks {
+    /** The engine's streamWire, bound to deps/system: returns raw wire text. */
+    generateSection: (prompt: string) => Promise<string | undefined>;
+    /** Forwarded partial emission (already resident-suppressed by the engine). */
+    emitPartial?: (assembledWire: string) => void;
+    userRequest: string;
+}
+/** v3 pipeline steps 1+3 — outline then N parallel per-section writers whose
+ *  outputs assemble (in outline order) into one wire document that goes
+ *  through the normal whole-app validation. Any planning/assembly failure
+ *  returns fallback info and the engine's single-stream lane takes over —
+ *  never blocks. */
+export declare const regionParallelCreate: (context: PipelineContext, hooks: RegionParallelHooks) => Promise<RegionParallelResult>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

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