@ranimontagna/agent-toolkit 0.2.3 → 0.3.1

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

@@ -0,0 +1,16 @@
+import { type AriadneStatusInput, type AriadneStatusReport } from "./status.js";
+export { formatAriadneDoctor } from "./render.js";
+export type AriadneDoctorIssue = {
+    code: string;
+    severity: "error" | "warning";
+    message: string;
+};
+export type AriadneDoctorReport = {
+    schemaVersion: 1;
+    command: "doctor";
+    ok: boolean;
+    issues: AriadneDoctorIssue[];
+    status: AriadneStatusReport;
+};
+export type AriadneDoctorInput = Omit<AriadneStatusInput, "state" | "lock" | "ownershipViolation">;
+export declare function buildAriadneDoctor(input: AriadneDoctorInput): AriadneDoctorReport;

package/dist/src/ariadne/doctor.js

@@ -0,0 +1,207 @@
+import fs from "node:fs";
+import path from "node:path";
+import { buildAriadneStatus, createAriadneGit, inspectAriadneLock, } from "./status.js";
+import { AriadneStore as Store } from "./store.js";
+export { formatAriadneDoctor } from "./render.js";
+function issue(issues, code, severity, message) {
+    issues.push({ code, severity, message });
+}
+function fallbackPrd(projectRoot, branchName) {
+    return {
+        schemaVersion: 1,
+        project: path.basename(projectRoot),
+        branchName: branchName || "unknown",
+        description: "Invalid or unavailable Ariadne state",
+        userStories: [],
+    };
+}
+function fallbackConfig() {
+    return {
+        schemaVersion: 1,
+        qualityChecks: [],
+        maxAttemptsPerStory: 3,
+    };
+}
+function readState(store, projectRoot, issues) {
+    let prd;
+    let config;
+    const failures = [];
+    try {
+        prd = store.loadPrd();
+    }
+    catch (error) {
+        failures.push(`prd.json: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    try {
+        config = store.loadConfig();
+    }
+    catch (error) {
+        failures.push(`config.json: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (failures.length > 0) {
+        issue(issues, "invalid_schema", "error", `Ariadne state is missing or invalid: ${failures.join("; ")}`);
+    }
+    return {
+        prd: prd ?? fallbackPrd(projectRoot, "unknown"),
+        config: config ?? fallbackConfig(),
+        prdValid: prd !== undefined,
+        configValid: config !== undefined,
+    };
+}
+function missingIgnoreEntries(projectRoot) {
+    let contents = "";
+    try {
+        contents = fs.readFileSync(path.join(projectRoot, ".gitignore"), "utf8");
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    const lines = new Set(contents.split(/\r?\n/));
+    return [".ariadne/lock", ".ariadne/runs/", ".ariadne-quarantine.json"].filter((entry) => !lines.has(entry));
+}
+function minimalStatus(projectRoot, state, currentBranch, dirty, lock, ownershipViolation) {
+    const stories = { pending: 0, inProgress: 0, completed: 0, blocked: 0 };
+    for (const story of state.prd.userStories) {
+        if (story.status === "in_progress")
+            stories.inProgress += 1;
+        else
+            stories[story.status] += 1;
+    }
+    const active = state.prd.userStories.find((story) => story.status === "in_progress");
+    const blocked = state.prd.userStories.find((story) => story.status === "blocked");
+    const store = new Store(projectRoot);
+    return {
+        schemaVersion: 1,
+        command: "status",
+        project: state.prd.project,
+        branch: { configured: state.prd.branchName, current: currentBranch },
+        stories,
+        ...(active
+            ? {
+                activeStory: {
+                    id: active.id,
+                    title: active.title,
+                    attempts: active.attempts,
+                },
+            }
+            : {}),
+        ...(blocked
+            ? {
+                blockedStory: {
+                    id: blocked.id,
+                    title: blocked.title,
+                    attempts: blocked.attempts,
+                },
+            }
+            : {}),
+        ...(ownershipViolation ? { ownershipViolation } : {}),
+        dirty,
+        lock,
+        consecutiveFailures: 0,
+        paths: { progress: store.paths.progress, runs: store.paths.runs },
+    };
+}
+function statusWithState(input) {
+    return buildAriadneStatus({
+        projectRoot: input.projectRoot,
+        store: input.store,
+        git: input.git,
+        state: input.state,
+        lock: input.lock,
+        ownershipViolation: input.ownershipViolation ?? null,
+        ...(input.registry ? { registry: input.registry } : {}),
+        ...(input.isProcessAlive ? { isProcessAlive: input.isProcessAlive } : {}),
+    });
+}
+export function buildAriadneDoctor(input) {
+    const issues = [];
+    const store = input.store ?? new Store(input.projectRoot);
+    const state = readState(store, input.projectRoot, issues);
+    const git = input.git ?? createAriadneGit(input.projectRoot);
+    let gitReady = true;
+    let currentBranch = "unknown";
+    let dirty = false;
+    try {
+        git.assertRepository();
+        currentBranch = git.currentBranch();
+        dirty = git.statusPorcelain() !== "";
+    }
+    catch (error) {
+        gitReady = false;
+        issue(issues, "git_repository", "error", error instanceof Error ? error.message : String(error));
+    }
+    let lock = { state: "absent" };
+    try {
+        lock = inspectAriadneLock(store.paths.lock, input.isProcessAlive);
+    }
+    catch (error) {
+        issue(issues, "invalid_lock", "error", error instanceof Error ? error.message : String(error));
+    }
+    let ownershipViolation;
+    try {
+        ownershipViolation = store.loadOwnershipViolation();
+    }
+    catch (error) {
+        issue(issues, "invalid_ownership_marker", "error", error instanceof Error ? error.message : String(error));
+    }
+    let status;
+    if (gitReady) {
+        status = statusWithState({
+            projectRoot: input.projectRoot,
+            store,
+            git,
+            state,
+            lock,
+            ...(ownershipViolation ? { ownershipViolation } : {}),
+            ...(input.registry ? { registry: input.registry } : {}),
+            ...(input.isProcessAlive ? { isProcessAlive: input.isProcessAlive } : {}),
+        });
+    }
+    else {
+        status = minimalStatus(input.projectRoot, state, currentBranch, dirty, lock, ownershipViolation);
+    }
+    if (gitReady &&
+        state.prdValid &&
+        status.branch.current !== status.branch.configured) {
+        issue(issues, "wrong_branch", "error", `Configured branch ${status.branch.configured} does not match current branch ${status.branch.current}.`);
+    }
+    if (status.dirty && !status.activeStory && !status.blockedStory) {
+        issue(issues, "dirty_worktree", "error", "The worktree is dirty without an in-progress story to recover.");
+    }
+    if (ownershipViolation) {
+        issue(issues, "ownership_violation", "error", `Run ${ownershipViolation.runId} changed coordinator-owned ${ownershipViolation.changed.join(", ")}; inspect and restore Git/canonical state, then deliberately remove ${store.paths.ownershipViolation}.`);
+    }
+    if (state.configValid && state.config.qualityChecks.length === 0) {
+        issue(issues, "missing_checks", "error", "At least one quality check must be configured.");
+    }
+    const missingIgnore = missingIgnoreEntries(input.projectRoot);
+    if (missingIgnore.length > 0) {
+        issue(issues, "missing_gitignore", "warning", `Missing required .gitignore entries: ${missingIgnore.join(", ")}.`);
+    }
+    if (state.configValid && !state.config.runtime) {
+        issue(issues, "runtime_unavailable", "error", "No Ariadne runtime is configured.");
+    }
+    else if (state.configValid &&
+        status.runtime &&
+        status.runtime.state !== "healthy") {
+        const runtimeState = status.runtime.state;
+        issue(issues, `runtime_${runtimeState}`, runtimeState === "unverified" ? "warning" : "error", `Configured runtime ${state.config.runtime} is ${runtimeState}${status.runtime?.version ? ` (version ${status.runtime.version})` : ""}.`);
+    }
+    if (status.lock.state === "stale") {
+        issue(issues, "stale_lock", "warning", `Lock for run ${status.lock.runId ?? "unknown"} belongs to a process that is no longer alive.`);
+    }
+    if (status.lastRun?.outcome === "interrupted") {
+        issue(issues, "interrupted_state", status.activeStory ? "warning" : "error", status.activeStory
+            ? `Interrupted story ${status.activeStory.id} is preserved for recovery.`
+            : "The last run was interrupted but no in-progress story is available for recovery.");
+    }
+    return {
+        schemaVersion: 1,
+        command: "doctor",
+        ok: !issues.some((candidate) => candidate.severity === "error"),
+        issues,
+        status,
+    };
+}
+//# sourceMappingURL=doctor.js.map

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

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

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

@@ -0,0 +1,58 @@
+import type { AriadneStory } from "./types.js";
+export type GitExec = (command: "git", args: string[], cwd: string, env?: NodeJS.ProcessEnv) => {
+    ok: boolean;
+    status: number;
+    stdout: string;
+    stderr: string;
+};
+export type AriadneStageCertificate = {
+    parentHead: string;
+    ref: string;
+    tree: string;
+};
+export type AriadnePublicationCertificate = AriadneStageCertificate & {
+    commit: string;
+};
+export declare class AriadneGit {
+    readonly root: string;
+    private readonly exec;
+    private pendingStage?;
+    private publishedState?;
+    constructor(root: string, exec: GitExec);
+    private capture;
+    private require;
+    private privateIndexEnv;
+    private removePrivateIndex;
+    private discardPendingStage;
+    private readRegularFile;
+    private writeExclusive;
+    private gitIndexPath;
+    private assertIndexMatches;
+    private atomicReplaceIndex;
+    private restoreIndexIfSafe;
+    private indexTree;
+    assertRepository(): void;
+    currentBranch(): string;
+    headRef(): string;
+    head(): string;
+    private refObject;
+    private captureRefState;
+    private assertRefState;
+    statusPorcelain(): string;
+    assertReady(expectedBranch: string, allowActiveDiff: boolean): void;
+    private indexPaths;
+    private treePaths;
+    private machineLocalIndexPaths;
+    private machineLocalTreePaths;
+    private assertMachineLocalBoundary;
+    private storyDeltaPaths;
+    private assertCompleteDelta;
+    stageAll(expectedHead?: string, expectedRef?: string): AriadneStageCertificate;
+    private assertPrePublication;
+    private assertPublishedState;
+    private disabledHooksPath;
+    private rollbackPublishedState;
+    commit(story: AriadneStory, expectedHead: string, assertPublicationBoundary?: () => void, expectedRef?: string): string;
+    assertPublished(commit?: string): void;
+    publicationCertificate(): AriadnePublicationCertificate | undefined;
+}