@ranimontagna/agent-toolkit 0.2.3 → 0.3.1

package/dist/src/ariadne/runtimes/shared.js

@@ -0,0 +1,141 @@
+const versionTokenPattern = /(?:^|[^0-9A-Za-z])v?(\d+(?:\.\d+){1,3}(?:[-+][0-9A-Za-z.-]+)?)(?=$|[^0-9A-Za-z])/;
+export function parseVersionToken(output) {
+    return versionTokenPattern.exec(output)?.[1];
+}
+export function compareNumericVersions(left, right) {
+    const numeric = (value) => value
+        .split(/[+-]/, 1)[0]
+        ?.split(".")
+        .map((part) => Number.parseInt(part, 10)) ?? [];
+    const leftParts = numeric(left);
+    const rightParts = numeric(right);
+    const length = Math.max(leftParts.length, rightParts.length);
+    for (let index = 0; index < length; index += 1) {
+        const difference = (leftParts[index] ?? 0) - (rightParts[index] ?? 0);
+        if (difference !== 0)
+            return Math.sign(difference);
+    }
+    return 0;
+}
+export function promptInstruction(relativePromptPath) {
+    return `Read ${relativePromptPath} and follow it exactly.`;
+}
+function probeFailureReason(fallback, stdout, stderr) {
+    return stderr.trim() || stdout.trim() || fallback;
+}
+function detectRuntime(definition, deps) {
+    const commandPath = deps.findCommand(definition.command);
+    if (!commandPath) {
+        return {
+            name: definition.name,
+            state: "unavailable",
+            reason: `${definition.command} was not found on PATH.`,
+        };
+    }
+    const versionResult = deps.capture(commandPath, ["--version"]);
+    const version = parseVersionToken(`${versionResult.stdout}\n${versionResult.stderr}`);
+    if (!versionResult.ok || !version) {
+        return {
+            name: definition.name,
+            state: "incompatible",
+            commandPath,
+            version,
+            reason: probeFailureReason(`Could not verify the ${definition.name} version.`, versionResult.stdout, versionResult.stderr),
+        };
+    }
+    const versionCompatible = definition.version.kind === "exact"
+        ? version === definition.version.version
+        : compareNumericVersions(version, definition.version.version) >= 0;
+    if (!versionCompatible) {
+        const requirement = definition.version.kind === "exact"
+            ? `exactly ${definition.version.version}`
+            : `at least ${definition.version.version}`;
+        return {
+            name: definition.name,
+            state: "incompatible",
+            commandPath,
+            version,
+            reason: `${definition.name} must be ${requirement}; found ${version}.`,
+        };
+    }
+    const helpResult = deps.capture(commandPath, definition.helpArgs);
+    const help = `${helpResult.stdout}\n${helpResult.stderr}`;
+    const missingFlags = definition.requiredHelp.filter((required) => !help.includes(required));
+    if (!helpResult.ok || missingFlags.length > 0) {
+        const reason = missingFlags.length > 0
+            ? `Missing required headless flags: ${missingFlags.join(", ")}.`
+            : probeFailureReason(`Could not inspect ${definition.name} headless capabilities.`, helpResult.stdout, helpResult.stderr);
+        return {
+            name: definition.name,
+            state: "incompatible",
+            commandPath,
+            version,
+            reason,
+        };
+    }
+    if (!definition.authArgs) {
+        return {
+            name: definition.name,
+            state: "unverified",
+            commandPath,
+            version,
+            reason: "No zero-credit local authentication probe is available.",
+        };
+    }
+    const authResult = deps.capture(commandPath, definition.authArgs);
+    if (!authResult.ok) {
+        return {
+            name: definition.name,
+            state: "unverified",
+            commandPath,
+            version,
+            reason: probeFailureReason("Local authentication readiness could not be confirmed.", authResult.stdout, authResult.stderr),
+        };
+    }
+    return {
+        name: definition.name,
+        state: "healthy",
+        commandPath,
+        version,
+        reason: "Executable, version, headless flags, and local auth are ready.",
+    };
+}
+export function interpretProcessResult(result) {
+    if (result.timedOut) {
+        return {
+            ok: false,
+            status: result.status,
+            reason: "Runtime process timed out.",
+        };
+    }
+    if (result.aborted) {
+        return {
+            ok: false,
+            status: result.status,
+            reason: "Runtime process was aborted.",
+        };
+    }
+    if (result.status !== 0) {
+        return {
+            ok: false,
+            status: result.status,
+            reason: `Runtime exited with status ${result.status ?? "unknown"}; inspect machine-local logs.`,
+        };
+    }
+    return { ok: true, status: result.status };
+}
+export function createRuntimeAdapter(definition, deps) {
+    return Object.freeze({
+        name: definition.name,
+        command: definition.command,
+        detect: () => detectRuntime(definition, deps),
+        buildInvocation: (context) => ({
+            command: deps.findCommand(definition.command) ?? definition.command,
+            args: definition.invocationArgs(context),
+            cwd: context.projectRoot,
+            env: { ...deps.baseEnv, ARIADNE_RUN_ID: context.runId },
+        }),
+        interpretResult: interpretProcessResult,
+    });
+}
+//# sourceMappingURL=shared.js.map

package/dist/src/ariadne/runtimes/shared.js.map

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

package/dist/src/ariadne/runtimes/types.d.ts

@@ -0,0 +1,56 @@
+import type { RunResult } from "../../system.js";
+import type { AriadneRuntimeName, ProcessResult } from "../types.js";
+export type RuntimeDetectionState = "unavailable" | "incompatible" | "unverified" | "healthy";
+export type AgentInvocation = {
+    command: string;
+    args: string[];
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+};
+export type RuntimeDetection = {
+    name: AriadneRuntimeName;
+    state: RuntimeDetectionState;
+    commandPath?: string;
+    version?: string;
+    reason: string;
+};
+export type IterationContext = {
+    runId: string;
+    projectRoot: string;
+    promptPath: string;
+    relativePromptPath: string;
+};
+export type AgentOutcome = {
+    ok: boolean;
+    status: number | null;
+    reason?: string;
+};
+export type RuntimeProbeDeps = {
+    findCommand: (command: string) => string | null;
+    capture: (command: string, args: string[]) => RunResult;
+    baseEnv: NodeJS.ProcessEnv;
+};
+export type RuntimeRegistry = Record<AriadneRuntimeName, AriadneRuntimeAdapter>;
+export type RuntimeSelectionInput = {
+    explicit?: AriadneRuntimeName;
+    configured?: AriadneRuntimeName;
+    globalPreferred?: AriadneRuntimeName;
+    interactive: boolean;
+    choose?: (choices: RuntimeDetection[]) => Promise<AriadneRuntimeName>;
+    registry: RuntimeRegistry;
+};
+export type RuntimeSelection = {
+    name: AriadneRuntimeName;
+    adapter: AriadneRuntimeAdapter;
+    detection: RuntimeDetection;
+    source: "explicit" | "configured" | "automatic" | "global" | "interactive";
+};
+export declare class AriadneRuntimeError extends Error {
+}
+export interface AriadneRuntimeAdapter {
+    readonly name: AriadneRuntimeName;
+    readonly command: string;
+    detect(): RuntimeDetection;
+    buildInvocation(context: IterationContext): AgentInvocation;
+    interpretResult(result: ProcessResult): AgentOutcome;
+}

package/dist/src/ariadne/runtimes/types.js

@@ -0,0 +1,3 @@
+export class AriadneRuntimeError extends Error {
+}
+//# sourceMappingURL=types.js.map

package/dist/src/ariadne/runtimes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/ariadne/runtimes/types.ts"],"names":[],"mappings":"AA6DA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;CAAG"}

package/dist/src/ariadne/schema.d.ts

@@ -0,0 +1,11 @@
+import type { AgentResult, ExpectedAgentResult } from "./result.js";
+import type { AriadneConfig, AriadnePrd, StoryStatus } from "./types.js";
+export declare class AriadneStateError extends Error {
+    readonly jsonPath: string;
+    constructor(jsonPath: string, message: string);
+}
+export declare function validatePrd(input: unknown): AriadnePrd;
+export declare function validateConfig(input: unknown): AriadneConfig;
+export declare function assertRunnableConfig(config: AriadneConfig): void;
+export declare function assertStoryTransition(from: StoryStatus, to: StoryStatus): void;
+export declare function validateAgentResult(input: unknown, expected: ExpectedAgentResult): AgentResult;

package/dist/src/ariadne/schema.js

@@ -0,0 +1,214 @@
+import { isRuntimeName } from "../state.js";
+export class AriadneStateError extends Error {
+    jsonPath;
+    constructor(jsonPath, message) {
+        super(`${jsonPath}: ${message}`);
+        this.jsonPath = jsonPath;
+        this.name = "AriadneStateError";
+    }
+}
+function stateError(path, message) {
+    throw new AriadneStateError(path, message);
+}
+function recordAt(input, jsonPath) {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        stateError(jsonPath, "expected an object");
+    }
+    return input;
+}
+function assertOnlyKeys(input, allowedKeys, jsonPath) {
+    for (const key of Object.keys(input)) {
+        if (!allowedKeys.includes(key)) {
+            stateError(`${jsonPath}.${key}`, "is not allowed");
+        }
+    }
+}
+function stringAt(input, jsonPath) {
+    if (typeof input !== "string" || input.trim() === "") {
+        stateError(jsonPath, "expected a non-empty string");
+    }
+    return input;
+}
+function integerAt(input, jsonPath, minimum = 0) {
+    if (!Number.isSafeInteger(input) || input < minimum) {
+        stateError(jsonPath, `expected an integer greater than or equal to ${minimum}`);
+    }
+    return input;
+}
+function arrayAt(input, jsonPath) {
+    if (!Array.isArray(input))
+        stateError(jsonPath, "expected an array");
+    return input;
+}
+function schemaVersionAt(input, jsonPath) {
+    if (input !== 1)
+        stateError(jsonPath, "expected schema version 1");
+    return 1;
+}
+function statusAt(input, jsonPath) {
+    if (input === "pending" ||
+        input === "in_progress" ||
+        input === "completed" ||
+        input === "blocked") {
+        return input;
+    }
+    return stateError(jsonPath, "expected pending, in_progress, completed, or blocked");
+}
+function validateStory(input, jsonPath) {
+    const story = recordAt(input, jsonPath);
+    const acceptanceCriteria = arrayAt(story.acceptanceCriteria, `${jsonPath}.acceptanceCriteria`).map((criterion, index) => stringAt(criterion, `${jsonPath}.acceptanceCriteria[${index}]`));
+    return {
+        id: stringAt(story.id, `${jsonPath}.id`),
+        title: stringAt(story.title, `${jsonPath}.title`),
+        description: stringAt(story.description, `${jsonPath}.description`),
+        acceptanceCriteria,
+        priority: integerAt(story.priority, `${jsonPath}.priority`, 1),
+        status: statusAt(story.status, `${jsonPath}.status`),
+        attempts: integerAt(story.attempts, `${jsonPath}.attempts`),
+    };
+}
+export function validatePrd(input) {
+    const prd = recordAt(input, "$");
+    const userStories = arrayAt(prd.userStories, "$.userStories").map((story, index) => validateStory(story, `$.userStories[${index}]`));
+    const ids = new Set();
+    for (let index = 0; index < userStories.length; index += 1) {
+        const id = userStories[index]?.id;
+        if (!id)
+            continue;
+        if (ids.has(id))
+            stateError(`$.userStories[${index}].id`, `duplicate story id: ${id}`);
+        ids.add(id);
+    }
+    return {
+        schemaVersion: schemaVersionAt(prd.schemaVersion, "$.schemaVersion"),
+        project: stringAt(prd.project, "$.project"),
+        branchName: stringAt(prd.branchName, "$.branchName"),
+        description: stringAt(prd.description, "$.description"),
+        userStories,
+    };
+}
+export function validateConfig(input) {
+    const config = recordAt(input, "$");
+    const qualityChecks = arrayAt(config.qualityChecks, "$.qualityChecks").map((check, index) => stringAt(check, `$.qualityChecks[${index}]`));
+    const runtime = config.runtime;
+    if (runtime !== undefined &&
+        (typeof runtime !== "string" || !isRuntimeName(runtime))) {
+        stateError("$.runtime", "expected a supported runtime");
+    }
+    const maxAttemptsPerStory = config.maxAttemptsPerStory === undefined
+        ? 3
+        : integerAt(config.maxAttemptsPerStory, "$.maxAttemptsPerStory", 1);
+    return {
+        schemaVersion: schemaVersionAt(config.schemaVersion, "$.schemaVersion"),
+        ...(runtime === undefined ? {} : { runtime }),
+        qualityChecks,
+        maxAttemptsPerStory,
+    };
+}
+export function assertRunnableConfig(config) {
+    if (config.qualityChecks.length === 0) {
+        stateError("$.qualityChecks", "at least one quality check is required for a run");
+    }
+}
+const transitions = {
+    pending: ["in_progress"],
+    in_progress: ["completed", "blocked", "in_progress"],
+    completed: [],
+    blocked: [],
+};
+export function assertStoryTransition(from, to) {
+    if (!transitions[from].includes(to)) {
+        stateError("$.userStories[].status", `invalid story transition from ${from} to ${to}`);
+    }
+}
+function booleanAt(input, jsonPath) {
+    if (typeof input !== "boolean")
+        stateError(jsonPath, "expected a boolean");
+    return input;
+}
+function safeRelativePathAt(input, jsonPath) {
+    const value = stringAt(input, jsonPath);
+    if (value.includes("\0") ||
+        value.startsWith("/") ||
+        value.startsWith("\\") ||
+        /^[A-Za-z]:[\\/]/.test(value) ||
+        value
+            .split(/[\\/]+/)
+            .some((part) => part === "" || part === "." || part === "..")) {
+        stateError(jsonPath, "expected a safe relative path");
+    }
+    return value;
+}
+function validateAgentCriterion(input, jsonPath) {
+    const criterion = recordAt(input, jsonPath);
+    assertOnlyKeys(criterion, ["criterion", "passed", "evidence"], jsonPath);
+    return {
+        criterion: stringAt(criterion.criterion, `${jsonPath}.criterion`),
+        passed: booleanAt(criterion.passed, `${jsonPath}.passed`),
+        evidence: stringAt(criterion.evidence, `${jsonPath}.evidence`),
+    };
+}
+export function validateAgentResult(input, expected) {
+    const result = recordAt(input, "$");
+    assertOnlyKeys(result, [
+        "schemaVersion",
+        "runId",
+        "storyId",
+        "outcome",
+        "criteria",
+        "summary",
+        "filesChanged",
+        "checksAttempted",
+        "learnings",
+        "failureReason",
+    ], "$");
+    const criteria = arrayAt(result.criteria, "$.criteria").map((criterion, index) => validateAgentCriterion(criterion, `$.criteria[${index}]`)), filesChanged = arrayAt(result.filesChanged, "$.filesChanged").map((file, index) => safeRelativePathAt(file, `$.filesChanged[${index}]`)), checksAttempted = arrayAt(result.checksAttempted, "$.checksAttempted").map((check, index) => stringAt(check, `$.checksAttempted[${index}]`)), learnings = arrayAt(result.learnings, "$.learnings").map((learning, index) => stringAt(learning, `$.learnings[${index}]`));
+    const outcome = result.outcome;
+    if (outcome !== "completed" && outcome !== "failed") {
+        stateError("$.outcome", "expected completed or failed");
+    }
+    const runId = stringAt(result.runId, "$.runId");
+    if (runId !== expected.runId)
+        stateError("$.runId", "does not match run");
+    const storyId = stringAt(result.storyId, "$.storyId");
+    if (storyId !== expected.storyId)
+        stateError("$.storyId", "does not match story");
+    const criteriaByName = new Map();
+    for (const [index, criterion] of criteria.entries()) {
+        if (criteriaByName.has(criterion.criterion)) {
+            stateError(`$.criteria[${index}].criterion`, "duplicate criterion");
+        }
+        criteriaByName.set(criterion.criterion, criterion);
+    }
+    for (const criterion of expected.acceptanceCriteria) {
+        if (!criteriaByName.has(criterion)) {
+            stateError("$.criteria", `missing criterion: ${criterion}`);
+        }
+    }
+    if (criteriaByName.size !== expected.acceptanceCriteria.length) {
+        stateError("$.criteria", "contains an unexpected criterion");
+    }
+    if (outcome === "completed" &&
+        criteria.some((criterion) => !criterion.passed)) {
+        stateError("$.criteria", "completed results require passing criteria");
+    }
+    const failureReason = result.failureReason === undefined
+        ? undefined
+        : stringAt(result.failureReason, "$.failureReason");
+    if (outcome === "failed" && failureReason === undefined) {
+        stateError("$.failureReason", "is required for failed results");
+    }
+    return {
+        schemaVersion: schemaVersionAt(result.schemaVersion, "$.schemaVersion"),
+        runId,
+        storyId,
+        outcome,
+        criteria,
+        summary: stringAt(result.summary, "$.summary"),
+        filesChanged,
+        checksAttempted,
+        learnings,
+        ...(failureReason === undefined ? {} : { failureReason }),
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/src/ariadne/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/ariadne/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAa5C,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAExB,QAAQ;IAD1B,YACkB,QAAgB,EAChC,OAAe;QAEf,KAAK,CAAC,GAAG,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;wBAHjB,QAAQ;QAIxB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,OAAe;IAC/C,MAAM,IAAI,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,QAAgB;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,UAAU,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,cAAc,CACrB,KAA8B,EAC9B,WAA8B,EAC9B,QAAgB;IAEhB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,UAAU,CAAC,GAAG,QAAQ,IAAI,GAAG,EAAE,EAAE,gBAAgB,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,QAAgB;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,UAAU,CAAC,QAAQ,EAAE,6BAA6B,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,QAAgB,EAAE,OAAO,GAAG,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAK,KAAgB,GAAG,OAAO,EAAE,CAAC;QAChE,UAAU,CACR,QAAQ,EACR,gDAAgD,OAAO,EAAE,CAC1D,CAAC;IACJ,CAAC;IACD,OAAO,KAAe,CAAC;AACzB,CAAC;AAED,SAAS,OAAO,CAAC,KAAc,EAAE,QAAgB;IAC/C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,UAAU,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IACrE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,QAAgB;IACvD,IAAI,KAAK,KAAK,CAAC;QAAE,UAAU,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,QAAgB;IAChD,IACE,KAAK,KAAK,SAAS;QACnB,KAAK,KAAK,aAAa;QACvB,KAAK,KAAK,WAAW;QACrB,KAAK,KAAK,SAAS,EACnB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,UAAU,CACf,QAAQ,EACR,sDAAsD,CACvD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,QAAgB;IACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxC,MAAM,kBAAkB,GAAG,OAAO,CAChC,KAAK,CAAC,kBAAkB,EACxB,GAAG,QAAQ,qBAAqB,CACjC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CACzB,QAAQ,CAAC,SAAS,EAAE,GAAG,QAAQ,uBAAuB,KAAK,GAAG,CAAC,CAChE,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,QAAQ,KAAK,CAAC;QACxC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,QAAQ,QAAQ,CAAC;QACjD,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,QAAQ,cAAc,CAAC;QACnE,kBAAkB;QAClB,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,QAAQ,WAAW,EAAE,CAAC,CAAC;QAC9D,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,QAAQ,SAAS,CAAC;QACpD,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,QAAQ,WAAW,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,GAAG,CAC/D,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,iBAAiB,KAAK,GAAG,CAAC,CAClE,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACb,UAAU,CAAC,iBAAiB,KAAK,MAAM,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAC;QACxE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IAED,OAAO;QACL,aAAa,EAAE,eAAe,CAAC,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC;QACpE,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC;QAC3C,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,cAAc,CAAC;QACpD,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,eAAe,CAAC;QACvD,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpC,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC,GAAG,CACxE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,KAAK,GAAG,CAAC,CAC/D,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IACE,OAAO,KAAK,SAAS;QACrB,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,EACxD,CAAC;QACD,UAAU,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,mBAAmB,GACvB,MAAM,CAAC,mBAAmB,KAAK,SAAS;QACtC,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,mBAAmB,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC;IAExE,OAAO;QACL,aAAa,EAAE,eAAe,CAAC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC;QACvE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QAC7C,aAAa;QACb,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAqB;IACxD,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,UAAU,CACR,iBAAiB,EACjB,kDAAkD,CACnD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,WAAW,GAAgD;IAC/D,OAAO,EAAE,CAAC,aAAa,CAAC;IACxB,WAAW,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC;IACpD,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,IAAiB,EACjB,EAAe;IAEf,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACpC,UAAU,CACR,wBAAwB,EACxB,iCAAiC,IAAI,OAAO,EAAE,EAAE,CACjD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAc,EAAE,QAAgB;IACjD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,UAAU,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc,EAAE,QAAgB;IAC1D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxC,IACE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QACtB,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC7B,KAAK;aACF,KAAK,CAAC,QAAQ,CAAC;aACf,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,EAC/D,CAAC;QACD,UAAU,CAAC,QAAQ,EAAE,+BAA+B,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAAc,EACd,QAAgB;IAEhB,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC5C,cAAc,CAAC,SAAS,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IACzE,OAAO;QACL,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,QAAQ,YAAY,CAAC;QACjE,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,QAAQ,SAAS,CAAC;QACzD,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,QAAQ,WAAW,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAc,EACd,QAA6B;IAE7B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpC,cAAc,CACZ,MAAM,EACN;QACE,eAAe;QACf,OAAO;QACP,SAAS;QACT,SAAS;QACT,UAAU;QACV,SAAS;QACT,cAAc;QACd,iBAAiB;QACjB,WAAW;QACX,eAAe;KAChB,EACD,GAAG,CACJ,CAAC;IACF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,GAAG,CACvD,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CACnB,sBAAsB,CAAC,SAAS,EAAE,cAAc,KAAK,GAAG,CAAC,CAC5D,EACD,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC,GAAG,CAC/D,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,KAAK,GAAG,CAAC,CACtE,EACD,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC,GAAG,CACxE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,KAAK,GAAG,CAAC,CACjE,EACD,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,GAAG,CACtD,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,KAAK,GAAG,CAAC,CACjE,CAAC;IACJ,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACpD,UAAU,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,QAAQ,CAAC,KAAK;QAAE,UAAU,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACtD,IAAI,OAAO,KAAK,QAAQ,CAAC,OAAO;QAC9B,UAAU,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC;IAElD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAgC,CAAC;IAC/D,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACpD,IAAI,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5C,UAAU,CAAC,cAAc,KAAK,aAAa,EAAE,qBAAqB,CAAC,CAAC;QACtE,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACrD,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QACpD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,UAAU,CAAC,YAAY,EAAE,sBAAsB,SAAS,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,IAAI,cAAc,CAAC,IAAI,KAAK,QAAQ,CAAC,kBAAkB,CAAC,MAAM,EAAE,CAAC;QAC/D,UAAU,CAAC,YAAY,EAAE,kCAAkC,CAAC,CAAC;IAC/D,CAAC;IACD,IACE,OAAO,KAAK,WAAW;QACvB,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,EAC/C,CAAC;QACD,UAAU,CAAC,YAAY,EAAE,4CAA4C,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,aAAa,GACjB,MAAM,CAAC,aAAa,KAAK,SAAS;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;IACxD,IAAI,OAAO,KAAK,QAAQ,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QACxD,UAAU,CAAC,iBAAiB,EAAE,gCAAgC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO;QACL,aAAa,EAAE,eAAe,CAAC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC;QACvE,KAAK;QACL,OAAO;QACP,OAAO;QACP,QAAQ;QACR,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC;QAC9C,YAAY;QACZ,eAAe;QACf,SAAS;QACT,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/dist/src/ariadne/status.d.ts

@@ -0,0 +1,72 @@
+import { AriadneGit } from "./git.js";
+import type { RuntimeDetectionState, RuntimeRegistry } from "./runtimes/types.js";
+import { AriadneStore } from "./store.js";
+import type { AriadneConfig, AriadneOwnershipViolation, AriadnePrd, AriadneRuntimeName } from "./types.js";
+export { formatAriadneStatus } from "./render.js";
+export type AriadneStoryCounts = {
+    pending: number;
+    inProgress: number;
+    completed: number;
+    blocked: number;
+};
+export type AriadneStatusReport = {
+    schemaVersion: 1;
+    command: "status";
+    project: string;
+    branch: {
+        configured: string;
+        current: string;
+    };
+    runtime?: {
+        name: AriadneRuntimeName;
+        state: RuntimeDetectionState;
+        version?: string;
+    };
+    stories: AriadneStoryCounts;
+    activeStory?: {
+        id: string;
+        title: string;
+        attempts: number;
+    };
+    blockedStory?: {
+        id: string;
+        title: string;
+        attempts: number;
+    };
+    ownershipViolation?: AriadneOwnershipViolation;
+    lastRun?: {
+        id: string;
+        outcome: string;
+        durationMs: number;
+        initialHead?: string;
+        finalHead?: string;
+    };
+    consecutiveFailures: number;
+    dirty: boolean;
+    lock: {
+        state: "absent" | "live" | "stale";
+        pid?: number;
+        runId?: string;
+    };
+    paths: {
+        progress: string;
+        runs: string;
+    };
+};
+export type AriadneStatusInput = {
+    projectRoot: string;
+    registry?: RuntimeRegistry;
+    isProcessAlive?: (pid: number) => boolean;
+    store?: AriadneStore;
+    git?: AriadneGit;
+    state?: {
+        prd: AriadnePrd;
+        config: AriadneConfig;
+    };
+    lock?: AriadneStatusReport["lock"];
+    ownershipViolation?: AriadneOwnershipViolation | null;
+};
+export declare function createAriadneGit(projectRoot: string): AriadneGit;
+export declare function inspectAriadneLock(lockPath: string, isProcessAlive?: (pid: number) => boolean): AriadneStatusReport["lock"];
+export declare function inspectLastAriadneRun(runsPath: string): AriadneStatusReport["lastRun"];
+export declare function buildAriadneStatus(input: AriadneStatusInput): AriadneStatusReport;