wabachi 0.2.0 → 0.3.0

package/dist/runtime/repository.js

@@ -1,13 +1,78 @@
-import { execFile } from "node:child_process";
+import { execFile, spawn } from "node:child_process";
 import { mkdir } from "node:fs/promises";
 import { promisify } from "node:util";
 const execFileAsync = promisify(execFile);
+const MAX_EXTERNAL_PROCESS_STDERR_LENGTH = 1024;
+function processErrorLike(error) {
+    if (error === null || typeof error !== "object")
+        return undefined;
+    return error;
+}
+export function isExternalProcessError(error) {
+    const processError = processErrorLike(error);
+    return (processError !== undefined &&
+        (processError.stderr !== undefined ||
+            processError.cmd !== undefined ||
+            processError.signal !== undefined ||
+            typeof processError.code === "number"));
+}
+function boundedText(value) {
+    const normalized = value.replace(/\s+/gu, " ").trim();
+    if (normalized.length <= MAX_EXTERNAL_PROCESS_STDERR_LENGTH)
+        return normalized;
+    return `${normalized.slice(0, MAX_EXTERNAL_PROCESS_STDERR_LENGTH - 1)}…`;
+}
+function processStatus(processError) {
+    if (typeof processError?.code === "number")
+        return `exit ${processError.code}`;
+    if (processError?.signal)
+        return `signal ${processError.signal}`;
+    if (processError?.code !== undefined && processError.code !== null)
+        return `error ${processError.code}`;
+    return "failed to start";
+}
+function processCommand(processError, fallbackCommand) {
+    return processError?.cmd ?? fallbackCommand ?? "external process";
+}
+/** Formats process failures for both runtime exceptions and provider records. */
+export function formatExternalProcessError(error, stage, fallbackCommand) {
+    const processError = processErrorLike(error);
+    const stderr = processError?.stderr === undefined ? "" : String(processError.stderr);
+    const detail = boundedText(stderr || (error instanceof Error ? error.message : String(error)));
+    const suffix = detail.length === 0 ? "" : ` stderr: ${detail}`;
+    return `${stage} failed: ${processCommand(processError, fallbackCommand)} (${processStatus(processError)})${suffix}`;
+}
+function captureStderr(stream) {
+    let value = "";
+    let truncated = false;
+    stream.setEncoding("utf8");
+    stream.on("data", (chunk) => {
+        if (value.length >= MAX_EXTERNAL_PROCESS_STDERR_LENGTH) {
+            truncated = true;
+            return;
+        }
+        const next = `${value}${chunk}`;
+        if (next.length > MAX_EXTERNAL_PROCESS_STDERR_LENGTH) {
+            value = next.slice(0, MAX_EXTERNAL_PROCESS_STDERR_LENGTH);
+            truncated = true;
+        }
+        else {
+            value = next;
+        }
+    });
+    return () => (truncated ? boundedText(`${value}…`) : boundedText(value));
+}
 function isRemoteUrl(source) {
     return /^[a-z][a-z0-9+.-]*:\/\//iu.test(source) || /^[^/]+@[^:]+:/u.test(source);
 }
 async function git(args, cwd) {
-    const { stdout } = await execFileAsync("git", args, { cwd });
-    return stdout.trim();
+    try {
+        const { stdout } = await execFileAsync("git", args, { cwd });
+        return stdout.trim();
+    }
+    catch (error) {
+        throw new Error(formatExternalProcessError(error, "git", ["git", ...args].join(" ")), { cause: error });
+    }
 }
 /**
  * Resolves a local repository path or a Git URL, plus an optional revision,
@@ -19,7 +84,7 @@ async function git(args, cwd) {
 export async function resolveRepository(source, revision, bareRepoDir) {
     if (isRemoteUrl(source)) {
         await mkdir(bareRepoDir, { recursive: true });
-        await execFileAsync("git", ["init", "--bare", "-q", bareRepoDir]);
+        await git(["init", "--bare", "-q", bareRepoDir], bareRepoDir);
         await git(["fetch", "-q", "--depth", "1", source, revision ?? "HEAD"], bareRepoDir);
         const commitSha = await git(["rev-parse", "FETCH_HEAD"], bareRepoDir);
         return { resolved: { source, commitSha }, archiveDir: bareRepoDir };
@@ -35,20 +100,79 @@ export async function resolveRepository(source, revision, bareRepoDir) {
 export async function createIsolatedWorkspace(resolution, workspaceRoot) {
     await mkdir(workspaceRoot, { recursive: true });
     await new Promise((resolve, reject) => {
-        const gitArchive = execFile("git", ["archive", resolution.resolved.commitSha], { cwd: resolution.archiveDir, maxBuffer: 1024 * 1024 * 1024 }, (error) => {
-            if (error)
-                reject(error);
+        const gitCommand = ["git", "archive", resolution.resolved.commitSha];
+        const tarCommand = ["tar", "-x", "-C", workspaceRoot];
+        const gitArchive = spawn(gitCommand[0], gitCommand.slice(1), {
+            cwd: resolution.archiveDir,
         });
-        const tar = execFile("tar", ["-x", "-C", workspaceRoot], (error) => {
-            if (error)
-                reject(error);
-            else
-                resolve();
+        const tar = spawn(tarCommand[0], tarCommand.slice(1));
+        const gitArchiveStderr = captureStderr(gitArchive.stderr);
+        const tarStderr = captureStderr(tar.stderr);
+        let gitArchiveExit;
+        let tarExit;
+        let pipeError;
+        let settled = false;
+        const stopOtherProcess = (process) => {
+            if (!process.killed)
+                process.kill();
+        };
+        const rejectWithProcessError = (error, stage, command, sibling) => {
+            if (settled)
+                return;
+            settled = true;
+            stopOtherProcess(sibling);
+            reject(new Error(formatExternalProcessError(error, stage, command.join(" ")), { cause: error }));
+        };
+        const finish = () => {
+            if (settled || gitArchiveExit === undefined || tarExit === undefined)
+                return;
+            // A malformed/empty stream caused by git archive failing should retain
+            // git's actionable stderr instead of replacing it with tar's secondary
+            // "not an archive" diagnostic. A tar failure takes precedence when the
+            // archive side was terminated by the pipe closing (SIGPIPE).
+            if (gitArchiveExit.code !== null && gitArchiveExit.code !== 0) {
+                settled = true;
+                reject(new Error(formatExternalProcessError({ code: gitArchiveExit.code, signal: gitArchiveExit.signal, stderr: gitArchiveStderr() }, "git archive", gitCommand.join(" "))));
+                return;
+            }
+            if (tarExit.code !== 0 || tarExit.signal !== null) {
+                settled = true;
+                reject(new Error(formatExternalProcessError({ code: tarExit.code, signal: tarExit.signal, stderr: tarStderr() }, "tar extraction", tarCommand.join(" "))));
+                return;
+            }
+            if (gitArchiveExit.signal !== null) {
+                settled = true;
+                reject(new Error(formatExternalProcessError({ code: gitArchiveExit.code, signal: gitArchiveExit.signal, stderr: gitArchiveStderr() }, "git archive", gitCommand.join(" "))));
+                return;
+            }
+            if (pipeError !== undefined) {
+                settled = true;
+                reject(new Error(`archive pipe failed: ${boundedText(String(pipeError))}`, { cause: pipeError }));
+                return;
+            }
+            settled = true;
+            resolve();
+        };
+        gitArchive.once("error", (error) => {
+            rejectWithProcessError(error, "git archive", gitCommand, tar);
+        });
+        tar.once("error", (error) => {
+            rejectWithProcessError(error, "tar extraction", tarCommand, gitArchive);
+        });
+        gitArchive.once("close", (code, signal) => {
+            gitArchiveExit = { code, signal };
+            finish();
+        });
+        tar.once("close", (code, signal) => {
+            tarExit = { code, signal };
+            finish();
+        });
+        gitArchive.stdout.once("error", (error) => {
+            pipeError ??= error;
+        });
+        tar.stdin.once("error", (error) => {
+            pipeError ??= error;
         });
-        if (!gitArchive.stdout || !tar.stdin) {
-            reject(new Error("failed to pipe git archive into tar"));
-            return;
-        }
         gitArchive.stdout.pipe(tar.stdin);
     });
 }

package/dist/runtime/repository.js.map

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

package/dist/runtime/run.js

@@ -2,7 +2,7 @@ import { randomUUID } from "node:crypto";
 import { mkdir } from "node:fs/promises";
 import path from "node:path";
 import { collectToolchainVersions, writeManifest } from "./manifest.js";
-import { createIsolatedWorkspace, resolveRepository } from "./repository.js";
+import { createIsolatedWorkspace, formatExternalProcessError, isExternalProcessError, resolveRepository, } from "./repository.js";
 /**
  * Resolves the input repository to an immutable commit, materializes it
  * into an isolated workspace, executes each provider through the common
@@ -75,6 +75,8 @@ async function executeProvider(provider, context) {
     }
 }
 function toErrorMessage(error) {
+    if (isExternalProcessError(error))
+        return formatExternalProcessError(error, "provider process");
     return error instanceof Error ? error.message : String(error);
 }
 //# sourceMappingURL=run.js.map

package/dist/runtime/run.js.map

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

package/dist/skill.d.ts

@@ -0,0 +1,47 @@
+import { type CommandId } from "./command-contract.js";
+/** Deterministic intent-oriented playbooks for the supported Wabachi surface. */
+export declare const SKILL_MODEL_VERSION: "1.0.0";
+export declare const MAX_SKILL_OUTPUT_BYTES = 4096;
+export interface SkillWorkflowStep {
+    readonly summary: string;
+    /** Stable reference into the versioned command contract. */
+    readonly commandId: CommandId;
+    /** Bare executable command derived from commandId. */
+    readonly command: string;
+    /** Practical example derived from commandId. */
+    readonly example: string;
+    /** Progressive-help pointer derived from commandId. */
+    readonly helpPointer: string;
+}
+export interface SkillScenario {
+    readonly id: string;
+    readonly title: string;
+    readonly whenToUse: string;
+    readonly workflow: readonly SkillWorkflowStep[];
+    readonly invariants: readonly string[];
+    readonly canonicalCommandId: CommandId;
+    readonly canonicalEntrypoint: string;
+    readonly helpPointer: string;
+}
+export declare const SKILL_SCENARIOS: readonly SkillScenario[];
+export interface SkillIndexEntry {
+    readonly id: string;
+    readonly title: string;
+    readonly whenToUse: string;
+}
+export interface SkillIndexProjection {
+    readonly version: typeof SKILL_MODEL_VERSION;
+    readonly scenarios: readonly SkillIndexEntry[];
+}
+export interface SkillScenarioProjection extends SkillScenario {
+    readonly version: typeof SKILL_MODEL_VERSION;
+}
+export declare function findSkillScenario(id: string): SkillScenario | undefined;
+export declare function projectSkillIndexToJson(): SkillIndexProjection;
+export declare function projectSkillIndexToText(): string;
+export declare function projectSkillScenarioToJson(scenario: SkillScenario): SkillScenarioProjection;
+export declare function projectSkillScenarioToText(scenario: SkillScenario): string;
+/** Keep text diagnostics and projections within the explicit UTF-8 budget. */
+export declare function boundText(value: string): string;
+/** Serialize a JSON projection without allowing the machine-readable path to exceed the same cap. */
+export declare function serializeSkillJson(value: unknown): string;

package/dist/skill.js

@@ -0,0 +1,160 @@
+import { commandExample, commandHelpPointer, commandInvocation, getCommand, } from "./command-contract.js";
+/** Deterministic intent-oriented playbooks for the supported Wabachi surface. */
+export const SKILL_MODEL_VERSION = "1.0.0";
+export const MAX_SKILL_OUTPUT_BYTES = 4096;
+function workflowStep(summary, commandId) {
+    getCommand(commandId);
+    return {
+        summary,
+        commandId,
+        command: commandInvocation(commandId),
+        example: commandExample(commandId),
+        helpPointer: commandHelpPointer(commandId),
+    };
+}
+function skillScenario(input) {
+    return {
+        id: input.id,
+        title: input.title,
+        whenToUse: input.whenToUse,
+        workflow: input.workflow.map(([summary, commandId]) => workflowStep(summary, commandId)),
+        invariants: input.invariants,
+        canonicalCommandId: input.canonicalCommandId,
+        canonicalEntrypoint: commandInvocation(input.canonicalCommandId),
+        helpPointer: commandHelpPointer(input.canonicalCommandId),
+    };
+}
+export const SKILL_SCENARIOS = [
+    skillScenario({
+        id: "analyze-repository",
+        title: "Analyze a repository",
+        whenToUse: "Use when you need deterministic provider output for a repository at a selected revision.",
+        workflow: [["Resolve the repository and execute the registered analysis providers.", "run.execute"]],
+        invariants: [
+            "Choose an explicit revision when reproducibility matters; the default resolution remains supported.",
+            "Retain the output directory when another workflow or reviewer needs the manifest and provider artifacts.",
+            "The provider set and analysis execution semantics are owned by the runtime, not this playbook.",
+        ],
+        canonicalCommandId: "run.execute",
+    }),
+    skillScenario({
+        id: "provider-matrix",
+        title: "Build a provider matrix",
+        whenToUse: "Use when you need auditable facts, correlations, matrix output, and a report for one revision.",
+        workflow: [["Run the provider matrix and retain its generated artifacts.", "matrix.execute"]],
+        invariants: [
+            "Use a 40-character commit SHA when matrix evidence must be tied to an immutable revision.",
+            "Provide an output directory so the report and its supporting artifacts remain inspectable.",
+            "Provider registration and matrix execution order remain runtime authority.",
+        ],
+        canonicalCommandId: "matrix.execute",
+    }),
+    skillScenario({
+        id: "validate-architecture-canon",
+        title: "Validate an Architecture Canon",
+        whenToUse: "Use before rendering an explicit Architecture Canon document or handing it to another workflow.",
+        workflow: [["Validate the explicit Canon file and inspect any bounded diagnostics.", "architecture.validate"]],
+        invariants: [
+            "The Canon file is explicit input; this workflow does not create or mutate one.",
+            "Validation must succeed before rendering or publishing derived documentation.",
+            "Machine-readable diagnostics are available through the command's JSON projection.",
+        ],
+        canonicalCommandId: "architecture.validate",
+    }),
+    skillScenario({
+        id: "render-architecture-canon",
+        title: "Render Architecture Canon documentation",
+        whenToUse: "Use when a valid Architecture Canon should become a retained static documentation site.",
+        workflow: [["Render the explicit Canon file into a retained output directory.", "architecture.render"]],
+        invariants: [
+            "Validate the same Canon file first when its validity has not already been established.",
+            "The Structurizr CLI is required for static export; use the command's executable override only when needed.",
+            "Rendering is a projection and does not add an Architecture Canon authoring command.",
+        ],
+        canonicalCommandId: "architecture.render",
+    }),
+    skillScenario({
+        id: "architecture-documentation",
+        title: "Follow the Architecture Documentation workflow",
+        whenToUse: "Use for the normal manual-authoring, validation, and rendering path for Architecture Canon documentation.",
+        workflow: [
+            [
+                "Author or revise the explicit Canon document using repository documentation guidance; no init command is implied.",
+                "architecture.help",
+            ],
+            ["Validate the authored Canon before producing derived documentation.", "architecture.validate"],
+            ["Render the validated Canon into a retained static site.", "architecture.render"],
+        ],
+        invariants: [
+            "Authoring remains a deliberate file-editing step; Wabachi does not invent an init or edit command.",
+            "Validation and rendering operate on an explicit Canon file and preserve existing execution semantics.",
+            "Keep the generated site and source Canon together when the result is intended for review or publication.",
+        ],
+        canonicalCommandId: "architecture.help",
+    }),
+];
+export function findSkillScenario(id) {
+    return SKILL_SCENARIOS.find((scenario) => scenario.id === id);
+}
+export function projectSkillIndexToJson() {
+    return {
+        version: SKILL_MODEL_VERSION,
+        scenarios: SKILL_SCENARIOS.map(({ id, title, whenToUse }) => ({ id, title, whenToUse })),
+    };
+}
+export function projectSkillIndexToText() {
+    const lines = [`Wabachi skill scenarios (v${SKILL_MODEL_VERSION}):`, ""];
+    for (const scenario of SKILL_SCENARIOS) {
+        lines.push(`  ${scenario.id} - ${scenario.title}`);
+        lines.push(`    ${scenario.whenToUse}`);
+    }
+    lines.push("", "Run `wabachi skill <scenario>` for one bounded playbook.");
+    return boundText(lines.join("\n"));
+}
+export function projectSkillScenarioToJson(scenario) {
+    return {
+        version: SKILL_MODEL_VERSION,
+        ...scenario,
+        workflow: scenario.workflow.map((step) => workflowStep(step.summary, step.commandId)),
+    };
+}
+export function projectSkillScenarioToText(scenario) {
+    const projected = projectSkillScenarioToJson(scenario);
+    const lines = [`${projected.title} (${projected.id})`, "", `When to use: ${projected.whenToUse}`, "", "Workflow:"];
+    projected.workflow.forEach((step, index) => {
+        lines.push(`  ${index + 1}. ${step.summary}`);
+        lines.push(`     Command: ${step.command}`);
+        lines.push(`     Example: ${step.example}`);
+        lines.push(`     Help: ${step.helpPointer}`);
+    });
+    lines.push("", "Invariants:");
+    for (const invariant of projected.invariants)
+        lines.push(`  - ${invariant}`);
+    lines.push("", `Canonical entrypoint: ${projected.canonicalEntrypoint}`, `Exact syntax: ${projected.helpPointer}`);
+    return boundText(lines.join("\n"));
+}
+/** Keep text diagnostics and projections within the explicit UTF-8 budget. */
+export function boundText(value) {
+    if (Buffer.byteLength(value, "utf8") <= MAX_SKILL_OUTPUT_BYTES)
+        return value;
+    const suffix = "…";
+    const characters = Array.from(value);
+    while (characters.length > 0 &&
+        Buffer.byteLength(`${characters.join("")}${suffix}`, "utf8") > MAX_SKILL_OUTPUT_BYTES) {
+        characters.pop();
+    }
+    return `${characters.join("")}${suffix}`;
+}
+/** Serialize a JSON projection without allowing the machine-readable path to exceed the same cap. */
+export function serializeSkillJson(value) {
+    const serialized = JSON.stringify(value);
+    if (Buffer.byteLength(serialized, "utf8") <= MAX_SKILL_OUTPUT_BYTES)
+        return serialized;
+    return JSON.stringify({
+        ok: false,
+        diagnostics: [
+            { code: "skill-output-too-large", message: `skill output exceeds ${MAX_SKILL_OUTPUT_BYTES} UTF-8 bytes` },
+        ],
+    });
+}
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

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

package/dist/working-set/codec.d.ts

@@ -0,0 +1,7 @@
+import { type CandidateWorkingSet, type CandidateWorkingSetInput } from "./model.js";
+/** Deterministic JSON serialization of the canonical artifact shape. */
+export declare function serializeCandidateWorkingSet(input: CandidateWorkingSetInput | CandidateWorkingSet): string;
+/** Parses JSON and rejects malformed or unsupported artifacts before semantic use. */
+export declare function parseCandidateWorkingSet(serialized: string): CandidateWorkingSet;
+/** Alias for callers that need validation without parsing a JSON string. */
+export declare const decodeCandidateWorkingSet: typeof parseCandidateWorkingSet;

package/dist/working-set/codec.js

@@ -0,0 +1,53 @@
+import { CANDIDATE_WORKING_SET_KIND, createCandidateWorkingSet, validateCandidateWorkingSet, } from "./model.js";
+function canonicalDocument(workingSet) {
+    return {
+        kind: CANDIDATE_WORKING_SET_KIND,
+        schemaVersion: workingSet.schemaVersion,
+        workingSetId: workingSet.workingSetId,
+        repository: {
+            repositoryHost: workingSet.repository.repositoryHost,
+            repositoryId: workingSet.repository.repositoryId,
+            repository: workingSet.repository.repository,
+        },
+        revision: workingSet.revision,
+        entries: workingSet.entries.map((entry) => ({
+            state: entry.state,
+            target: {
+                kind: entry.target.kind,
+                locator: entry.target.locator,
+            },
+            reason: {
+                id: entry.reason.id,
+                summary: entry.reason.summary,
+            },
+            evidence: entry.evidence.map((reference) => ({
+                artifact: reference.artifact,
+                reference: reference.reference,
+            })),
+        })),
+    };
+}
+/** Deterministic JSON serialization of the canonical artifact shape. */
+export function serializeCandidateWorkingSet(input) {
+    const workingSet = validateCandidateWorkingSet({
+        ...createCandidateWorkingSet(input),
+        schemaVersion: 1,
+    });
+    return JSON.stringify(canonicalDocument(workingSet));
+}
+/** Parses JSON and rejects malformed or unsupported artifacts before semantic use. */
+export function parseCandidateWorkingSet(serialized) {
+    if (typeof serialized !== "string")
+        throw new TypeError("candidate working set serialization must be a string");
+    let parsed;
+    try {
+        parsed = JSON.parse(serialized);
+    }
+    catch {
+        throw new TypeError("candidate working set serialization is malformed");
+    }
+    return validateCandidateWorkingSet(parsed);
+}
+/** Alias for callers that need validation without parsing a JSON string. */
+export const decodeCandidateWorkingSet = parseCandidateWorkingSet;
+//# sourceMappingURL=codec.js.map

package/dist/working-set/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../../src/working-set/codec.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,GAG5B,MAAM,YAAY,CAAC;AAEpB,SAAS,iBAAiB,CAAC,UAA+B;IACxD,OAAO;QACL,IAAI,EAAE,0BAA0B;QAChC,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,UAAU,EAAE;YACV,cAAc,EAAE,UAAU,CAAC,UAAU,CAAC,cAAc;YACpD,YAAY,EAAE,UAAU,CAAC,UAAU,CAAC,YAAY;YAChD,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,UAAU;SAC7C;QACD,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1C,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE;gBACN,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;gBACvB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;aAC9B;YACD,MAAM,EAAE;gBACN,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;gBACnB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO;aAC9B;YACD,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBAC3C,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,SAAS,EAAE,SAAS,CAAC,SAAS;aAC/B,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,4BAA4B,CAAC,KAAqD;IAChG,MAAM,UAAU,GAAG,2BAA2B,CAAC;QAC7C,GAAG,yBAAyB,CAAC,KAAK,CAAC;QACnC,aAAa,EAAE,CAAC;KACjB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,wBAAwB,CAAC,UAAkB;IACzD,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAC;IAChH,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,2BAA2B,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAC"}

package/dist/working-set/conflicts.d.ts

@@ -0,0 +1,46 @@
+import { type CandidateWorkingSetEntry, type RepositoryIdentity, type WorkingSetEvidenceReference, type WorkingSetTarget } from "./model.js";
+/** V1 diagnostics that must remain visible instead of being resolved implicitly. */
+export declare const WORKING_SET_CONFLICT_KINDS: readonly ["ambiguity", "disagreement", "stale-evidence", "mapping-gap", "required-but-unauthorized", "insufficient-evidence"];
+export type WorkingSetConflictKind = (typeof WORKING_SET_CONFLICT_KINDS)[number];
+export interface WorkingSetConflict {
+    readonly kind: WorkingSetConflictKind;
+    /** Unresolved target used to preserve the conflict in the Candidate Working Set artifact. */
+    readonly target: WorkingSetTarget;
+    readonly reason: {
+        readonly id: string;
+        readonly summary: string;
+    };
+    readonly evidence: readonly WorkingSetEvidenceReference[];
+}
+export interface WorkingSetAuthorizationEntry {
+    readonly target: WorkingSetTarget;
+    readonly evidence?: readonly WorkingSetEvidenceReference[];
+}
+/**
+ * External authorization is intentionally only an input to comparison. It is
+ * never copied into the Candidate Working Set as authority and never widened
+ * by Wabachi.
+ */
+export interface WorkingSetAuthorizationInput {
+    readonly repository?: RepositoryIdentity;
+    readonly revision?: string;
+    readonly targets?: readonly (WorkingSetTarget | WorkingSetAuthorizationEntry)[];
+    readonly entries?: readonly WorkingSetAuthorizationEntry[];
+    readonly authorizedTargets?: readonly (WorkingSetTarget | WorkingSetAuthorizationEntry)[];
+}
+export interface WorkingSetConflictInput {
+    readonly kind: WorkingSetConflictKind;
+    /** Stable conflict-local locator, not provider payload. */
+    readonly locator: string;
+    readonly evidence?: readonly WorkingSetEvidenceReference[];
+}
+/** Creates one deterministic, unresolved conflict record from bounded evidence. */
+export declare function createWorkingSetConflict(input: WorkingSetConflictInput): WorkingSetConflict;
+/** Converts the semantic conflict record into the existing artifact entry shape. */
+export declare function conflictToWorkingSetEntry(conflict: WorkingSetConflict): CandidateWorkingSetEntry;
+/** Returns the machine-readable conflict class carried by an unresolved entry. */
+export declare function getWorkingSetConflictKind(entry: CandidateWorkingSetEntry): WorkingSetConflictKind | undefined;
+/** Canonicalizes the supported authorization comparison shapes without issuing authority. */
+export declare function authorizationEntries(input: WorkingSetAuthorizationInput): readonly WorkingSetAuthorizationEntry[];
+export declare function workingSetTargetKey(target: WorkingSetTarget): string;
+export declare function conflictSummary(kind: WorkingSetConflictKind): string;