@ranimontagna/agent-toolkit 0.2.3 → 0.3.1

package/dist/src/ariadne/status.js

@@ -0,0 +1,280 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { capture, findCommand } from "../system.js";
+import { AriadneGit } from "./git.js";
+import { createRuntimeRegistry } from "./runtimes/index.js";
+import { AriadneStateError } from "./schema.js";
+import { AriadneStore } from "./store.js";
+export { formatAriadneStatus } from "./render.js";
+function gitExec(command, args, cwd, env) {
+    const result = spawnSync(command, args, {
+        cwd,
+        encoding: "utf8",
+        env: env ? { ...process.env, ...env } : process.env,
+    });
+    return {
+        ok: !result.error && result.status === 0,
+        status: result.status ?? 1,
+        stdout: result.stdout ?? "",
+        stderr: result.stderr || result.error?.message || "",
+    };
+}
+export function createAriadneGit(projectRoot) {
+    return new AriadneGit(projectRoot, gitExec);
+}
+function defaultRegistry() {
+    return createRuntimeRegistry({ findCommand, capture, baseEnv: process.env });
+}
+function processAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}
+function lockRecord(source) {
+    let value;
+    try {
+        value = JSON.parse(source);
+    }
+    catch {
+        throw new AriadneStateError(".ariadne/lock", "Ariadne lock is malformed.");
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new AriadneStateError(".ariadne/lock", "Ariadne lock is malformed.");
+    }
+    const record = value;
+    const expectedKeys = [
+        "schemaVersion",
+        "pid",
+        "startedAt",
+        "runId",
+        "ownerToken",
+    ];
+    const ownerTokenPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    if (Object.keys(record).length !== expectedKeys.length ||
+        expectedKeys.some((key) => !Object.hasOwn(record, key)) ||
+        record.schemaVersion !== 1 ||
+        !Number.isSafeInteger(record.pid) ||
+        record.pid <= 0 ||
+        typeof record.startedAt !== "string" ||
+        Number.isNaN(Date.parse(record.startedAt)) ||
+        typeof record.runId !== "string" ||
+        record.runId === "" ||
+        typeof record.ownerToken !== "string" ||
+        !ownerTokenPattern.test(record.ownerToken)) {
+        throw new AriadneStateError(".ariadne/lock", "Ariadne lock is malformed.");
+    }
+    return record;
+}
+export function inspectAriadneLock(lockPath, isProcessAlive = processAlive) {
+    let raw;
+    try {
+        raw = fs.readFileSync(lockPath, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return { state: "absent" };
+        }
+        throw error;
+    }
+    const record = lockRecord(raw);
+    return {
+        state: isProcessAlive(record.pid) ? "live" : "stale",
+        pid: record.pid,
+        runId: record.runId,
+    };
+}
+function record(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function readRecord(source) {
+    try {
+        return record(JSON.parse(fs.readFileSync(source, "utf8")));
+    }
+    catch (error) {
+        if (error.code === "ENOENT" ||
+            error instanceof SyntaxError) {
+            return undefined;
+        }
+        throw error;
+    }
+}
+function stringValue(sources, key) {
+    for (const source of sources) {
+        if (typeof source?.[key] === "string")
+            return source[key];
+    }
+    return undefined;
+}
+function numberValue(sources, key) {
+    for (const source of sources) {
+        const value = source?.[key];
+        if (typeof value === "number" && Number.isFinite(value))
+            return value;
+    }
+    return undefined;
+}
+function runCandidate(runsPath, id) {
+    const runPath = path.join(runsPath, id);
+    const summary = readRecord(path.join(runPath, "summary.json"));
+    const run = readRecord(path.join(runPath, "run.json"));
+    const stop = readRecord(path.join(runPath, "stop.json"));
+    const failure = readRecord(path.join(runPath, "failure.json"));
+    const result = readRecord(path.join(runPath, "result.json"));
+    const processResult = readRecord(path.join(runPath, "process.json"));
+    const attempt = readRecord(path.join(runPath, "attempt.json"));
+    const sources = [summary, run, stop, failure, result, processResult, attempt];
+    const startedAt = stringValue([attempt, run, processResult], "startedAt");
+    const finishedAt = stringValue([summary, run, stop, failure, processResult], "finishedAt") ??
+        stringValue([stop, failure], "timestamp");
+    const timestampText = finishedAt ?? startedAt;
+    let timestamp = timestampText ? Date.parse(timestampText) : Number.NaN;
+    if (Number.isNaN(timestamp)) {
+        try {
+            timestamp = fs.statSync(runPath).mtimeMs;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    const explicitOutcome = stringValue([summary, run, stop], "outcome");
+    const outcome = explicitOutcome ??
+        (failure ? "failed" : stringValue([result], "outcome")) ??
+        (processResult?.status === 0 ? "completed" : "incomplete");
+    let durationMs = numberValue(sources, "durationMs") ?? 0;
+    if (durationMs === 0 && startedAt && finishedAt) {
+        durationMs = Math.max(0, Date.parse(finishedAt) - Date.parse(startedAt));
+    }
+    const initialHead = stringValue(sources, "initialHead");
+    const finalHead = stringValue(sources, "finalHead");
+    return {
+        id,
+        timestamp,
+        outcome,
+        durationMs,
+        ...(initialHead ? { initialHead } : {}),
+        ...(finalHead ? { finalHead } : {}),
+    };
+}
+export function inspectLastAriadneRun(runsPath) {
+    const latest = inspectRunCandidates(runsPath)[0];
+    return latest
+        ? {
+            id: latest.id,
+            outcome: latest.outcome,
+            durationMs: latest.durationMs,
+            ...(latest.initialHead ? { initialHead: latest.initialHead } : {}),
+            ...(latest.finalHead ? { finalHead: latest.finalHead } : {}),
+        }
+        : undefined;
+}
+function inspectRunCandidates(runsPath) {
+    let entries;
+    try {
+        entries = fs.readdirSync(runsPath, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    return entries
+        .filter((entry) => entry.isDirectory() && entry.name !== ".lock-coordinator")
+        .map((entry) => runCandidate(runsPath, entry.name))
+        .filter((candidate) => candidate !== undefined)
+        .sort((left, right) => right.timestamp - left.timestamp || right.id.localeCompare(left.id));
+}
+function consecutiveFailures(runsPath) {
+    let count = 0;
+    for (const candidate of inspectRunCandidates(runsPath)) {
+        if (candidate.outcome !== "failed" && candidate.outcome !== "blocked") {
+            break;
+        }
+        count += 1;
+    }
+    return count;
+}
+function storyCounts(prd) {
+    const counts = {
+        pending: 0,
+        inProgress: 0,
+        completed: 0,
+        blocked: 0,
+    };
+    for (const story of prd.userStories) {
+        if (story.status === "in_progress")
+            counts.inProgress += 1;
+        else
+            counts[story.status] += 1;
+    }
+    return counts;
+}
+export function buildAriadneStatus(input) {
+    const store = input.store ?? new AriadneStore(input.projectRoot);
+    const git = input.git ?? createAriadneGit(input.projectRoot);
+    const prd = input.state?.prd ?? store.loadPrd();
+    const config = input.state?.config ?? store.loadConfig();
+    git.assertRepository();
+    const runtimeDetection = config.runtime
+        ? (input.registry ?? defaultRegistry())[config.runtime].detect()
+        : undefined;
+    const active = prd.userStories.find((story) => story.status === "in_progress");
+    const blocked = prd.userStories.find((story) => story.status === "blocked");
+    const ownershipViolation = input.ownershipViolation === undefined
+        ? store.loadOwnershipViolation()
+        : (input.ownershipViolation ?? undefined);
+    const lastRun = inspectLastAriadneRun(store.paths.runs);
+    return {
+        schemaVersion: 1,
+        command: "status",
+        project: prd.project,
+        branch: {
+            configured: prd.branchName,
+            current: git.currentBranch(),
+        },
+        ...(runtimeDetection
+            ? {
+                runtime: {
+                    name: runtimeDetection.name,
+                    state: runtimeDetection.state,
+                    ...(runtimeDetection.version
+                        ? { version: runtimeDetection.version }
+                        : {}),
+                },
+            }
+            : {}),
+        stories: storyCounts(prd),
+        ...(active
+            ? {
+                activeStory: {
+                    id: active.id,
+                    title: active.title,
+                    attempts: active.attempts,
+                },
+            }
+            : {}),
+        ...(blocked
+            ? {
+                blockedStory: {
+                    id: blocked.id,
+                    title: blocked.title,
+                    attempts: blocked.attempts,
+                },
+            }
+            : {}),
+        ...(ownershipViolation ? { ownershipViolation } : {}),
+        ...(lastRun ? { lastRun } : {}),
+        consecutiveFailures: consecutiveFailures(store.paths.runs),
+        dirty: git.statusPorcelain() !== "",
+        lock: input.lock ??
+            inspectAriadneLock(store.paths.lock, input.isProcessAlive ?? processAlive),
+        paths: { progress: store.paths.progress, runs: store.paths.runs },
+    };
+}
+//# sourceMappingURL=status.js.map

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

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

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

@@ -0,0 +1,99 @@
+import type { AriadneConfig, AriadneOwnershipViolation, AriadneOwnershipViolationChange, AriadnePrd } from "./types.js";
+export type AriadnePaths = {
+    root: string;
+    config: string;
+    prd: string;
+    progress: string;
+    lock: string;
+    runs: string;
+    ownershipViolation: string;
+    ownershipCheckpoint: string;
+    archive: string;
+};
+export type AriadnePathIdentity = {
+    source: string;
+    kind: "directory" | "file";
+    device: number;
+    inode: number;
+    links: number;
+};
+export type AriadneCanonicalFileCertificate = AriadnePathIdentity & {
+    kind: "file";
+    contents: string;
+};
+export type AriadneExternalFileIdentity = Pick<AriadnePathIdentity, "source" | "device" | "inode" | "links">;
+export type AriadneRunBoundary = {
+    runId: string;
+    root: AriadnePathIdentity;
+    runs: AriadnePathIdentity;
+    directory: AriadnePathIdentity;
+    artifacts: AriadnePathIdentity[];
+};
+export type AriadnePersistedCanonicalCertificate = Pick<AriadneCanonicalFileCertificate, "device" | "inode" | "links"> & {
+    sha256: string;
+};
+export type AriadneOwnershipCheckpoint = {
+    schemaVersion: 1;
+    runId: string;
+    storyId: string;
+    certifiedAt: string;
+    certifiedHead: string;
+    certifiedRef: string;
+    prd: AriadnePersistedCanonicalCertificate;
+    progress: AriadnePersistedCanonicalCertificate;
+};
+export declare const ARIADNE_OWNERSHIP_CHECKPOINT_MARKER = "<!-- ariadne-ownership-checkpoint:v1 -->";
+export declare class AriadneStore {
+    readonly projectRoot: string;
+    readonly paths: AriadnePaths;
+    constructor(projectRoot: string);
+    ensureLayout(): void;
+    loadConfig(): AriadneConfig;
+    loadPrd(): AriadnePrd;
+    hasCanonicalState(): boolean;
+    saveConfig(config: AriadneConfig): void;
+    savePrd(prd: AriadnePrd): AriadneCanonicalFileCertificate;
+    loadOwnershipViolation(): AriadneOwnershipViolation | undefined;
+    saveOwnershipViolation(marker: AriadneOwnershipViolation): void;
+    loadOwnershipCheckpoint(): AriadneOwnershipCheckpoint | undefined;
+    saveOwnershipCheckpoint(input: {
+        runId: string;
+        storyId: string;
+        certifiedAt: string;
+        certifiedHead: string;
+        certifiedRef: string;
+        prd: AriadneCanonicalFileCertificate;
+        progress: AriadneCanonicalFileCertificate;
+    }): AriadneOwnershipCheckpoint;
+    ownershipCheckpointChanges(checkpoint: AriadneOwnershipCheckpoint): AriadneOwnershipViolationChange[];
+    ownershipCheckpointRequired(): boolean;
+    assertNoOwnershipViolation(): void;
+    appendProgress(entry: string, expected?: AriadneCanonicalFileCertificate): AriadneCanonicalFileCertificate;
+    captureCanonicalCertificate(source: string): AriadneCanonicalFileCertificate;
+    assertCanonicalCertificate(certificate: AriadneCanonicalFileCertificate): void;
+    createRunDir(runId: string): string;
+    assertRunDirectory(runId: string): string;
+    assertRunArtifacts(runId: string, names: string[]): void;
+    assertRunDirectoryContents(runId: string): void;
+    certifyRunBoundary(runId: string, requiredArtifacts?: string[], expectedArtifacts?: AriadneExternalFileIdentity[]): AriadneRunBoundary;
+    extendRunBoundary(boundary: AriadneRunBoundary, expectedArtifacts: AriadneExternalFileIdentity[]): AriadneRunBoundary;
+    assertRunBoundary(boundary: AriadneRunBoundary): void;
+    writeRunJson(runId: string, name: string, value: unknown): string;
+    writeRunTextExclusive(runId: string, name: string, contents: string): AriadnePathIdentity;
+    archiveImportedPrd(sourceText: string, timestamp: string): string;
+    private readJson;
+    private assertRealDirectory;
+    private capturePathIdentity;
+    private assertPathIdentity;
+    private ensureRealDirectory;
+    private ensureRunsDirectory;
+    private assertProjectRoot;
+    private readProjectRootFile;
+    private sameIdentity;
+    private sameCertificate;
+    private assertExpectedArtifacts;
+    private certificateFromDescriptor;
+    private writeQuarantineAtomic;
+    private writeProjectRootAtomic;
+    private writeJsonAtomic;
+}