arggon-harness 0.1.0

package/dist/plugin/engine/git.js

@@ -0,0 +1,61 @@
+import { execFile } from "child_process";
+import { promisify } from "util";
+const execFileAsync = promisify(execFile);
+/**
+ * Checks whether the given directory is inside a git repository.
+ * Runs `git rev-parse --is-inside-work-tree` in projectRoot.
+ * Never throws — errors are captured in the return value.
+ */
+export async function isGitRepo(projectRoot) {
+    try {
+        await execFileAsync("git", ["rev-parse", "--is-inside-work-tree"], { cwd: projectRoot });
+        return { success: true, isRepo: true };
+    }
+    catch {
+        return { success: true, isRepo: false };
+    }
+}
+/**
+ * Checks whether there are uncommitted changes (staged or unstaged).
+ * Runs `git status --porcelain` in projectRoot.
+ * Never throws — errors are captured in the return value.
+ */
+export async function hasChanges(projectRoot) {
+    try {
+        const { stdout } = await execFileAsync("git", ["status", "--porcelain"], { cwd: projectRoot });
+        return { success: true, hasChanges: stdout.trim().length > 0 };
+    }
+    catch (err) {
+        return { success: false, hasChanges: false };
+    }
+}
+/**
+ * Stages all changes with `git add -A` and creates a commit with the given message.
+ * Returns the full 40-character commit hash on success.
+ * Never throws — all errors are captured in the return value.
+ */
+export async function gitCommit(projectRoot, message) {
+    try {
+        await execFileAsync("git", ["add", "-A"], { cwd: projectRoot });
+        const { stdout } = await execFileAsync("git", ["commit", "-m", message], { cwd: projectRoot });
+        const hashMatch = stdout.match(/\[([a-f0-9]+)\s/) ?? stdout.match(/([a-f0-9]{40})/);
+        let hash = hashMatch?.[1] ?? null;
+        // If we didn't capture a hash from stdout, retrieve it with git rev-parse
+        if (!hash) {
+            try {
+                const { stdout: revParseOut } = await execFileAsync("git", ["rev-parse", "HEAD"], { cwd: projectRoot });
+                hash = revParseOut.trim() || null;
+            }
+            catch {
+                // Could not retrieve hash — leave as null
+            }
+        }
+        return { success: true, hash, error: null };
+    }
+    catch (err) {
+        const stderr = err?.stderr?.toString?.()?.trim() ?? "";
+        const errMsg = stderr || err?.message || "git commit failed";
+        return { success: false, hash: null, error: errMsg };
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/plugin/engine/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../src/plugin/engine/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAEhC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAkBzC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,WAAmB;IACjD,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAA;QACxF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IACzC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAmB;IAClD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAA;QAC9F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAA;IAChE,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;IAC9C,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,WAAmB,EAAE,OAAe;IAClE,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAA;QAC/D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAA;QAC9F,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;QACnF,IAAI,IAAI,GAAkB,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;QAEhD,0EAA0E;QAC1E,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC;gBACH,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAA;gBACvG,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,IAAI,CAAA;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IAC7C,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;QACtD,MAAM,MAAM,GAAG,MAAM,IAAI,GAAG,EAAE,OAAO,IAAI,mBAAmB,CAAA;QAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IACtD,CAAC;AACH,CAAC"}

package/dist/plugin/engine/integrity.d.ts

@@ -0,0 +1,45 @@
+import type { IntegrityResult } from './types.js';
+/**
+ * Per-artifact hash information for integrity verification.
+ */
+export interface ArtifactHashInfo {
+    path?: string;
+    paths?: string[];
+    hash?: string;
+    hashes?: string[];
+    completed: boolean;
+    completed_at?: string;
+}
+/**
+ * Computes SHA-256 hash of content.
+ * @param content - The content to hash
+ * @returns Hex-encoded hash string
+ */
+export declare function computeHash(content: string): string;
+/**
+ * Verifies a file's hash matches expected value.
+ * @param filePath - Path to the file
+ * @param expectedHash - Expected SHA-256 hash
+ * @returns True if hash matches
+ */
+export declare function verifyArtifact(filePath: string, expectedHash: string): Promise<boolean>;
+/**
+ * Verifies integrity of all artifacts in a change.
+ * @param changeDir - Path to the change directory
+ * @param artifacts - Record of artifact hash info (formerly on Meta)
+ * @returns Integrity result with mismatches and missing files
+ */
+export declare function verifyChange(changeDir: string, artifacts: Record<string, ArtifactHashInfo>): Promise<IntegrityResult>;
+/**
+ * Computes hash for a file.
+ * @param filePath - Path to the file
+ * @returns Hex-encoded hash string or null if file doesn't exist
+ */
+export declare function hashFile(filePath: string): Promise<string | null>;
+/**
+ * Computes hashes for multiple files.
+ * @param filePaths - Array of file paths
+ * @returns Map of file paths to hashes
+ */
+export declare function hashFiles(filePaths: string[]): Promise<Map<string, string>>;
+//# sourceMappingURL=integrity.d.ts.map

package/dist/plugin/engine/integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.d.ts","sourceRoot":"","sources":["../../../src/plugin/engine/integrity.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ7F;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC1C,OAAO,CAAC,eAAe,CAAC,CAwC1B;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOvE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAWjF"}

package/dist/plugin/engine/integrity.js

@@ -0,0 +1,98 @@
+import * as fs from 'fs/promises';
+import * as crypto from 'crypto';
+/**
+ * Computes SHA-256 hash of content.
+ * @param content - The content to hash
+ * @returns Hex-encoded hash string
+ */
+export function computeHash(content) {
+    return crypto.createHash('sha256').update(content, 'utf8').digest('hex');
+}
+/**
+ * Verifies a file's hash matches expected value.
+ * @param filePath - Path to the file
+ * @param expectedHash - Expected SHA-256 hash
+ * @returns True if hash matches
+ */
+export async function verifyArtifact(filePath, expectedHash) {
+    try {
+        const content = await fs.readFile(filePath, 'utf8');
+        const actualHash = computeHash(content);
+        return actualHash === expectedHash;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Verifies integrity of all artifacts in a change.
+ * @param changeDir - Path to the change directory
+ * @param artifacts - Record of artifact hash info (formerly on Meta)
+ * @returns Integrity result with mismatches and missing files
+ */
+export async function verifyChange(changeDir, artifacts) {
+    const mismatches = [];
+    const missing = [];
+    for (const [artifactId, artifactInfo] of Object.entries(artifacts)) {
+        if (!artifactInfo)
+            continue;
+        const paths = artifactInfo.paths || (artifactInfo.path ? [artifactInfo.path] : []);
+        const hashes = artifactInfo.hashes || (artifactInfo.hash ? [artifactInfo.hash] : []);
+        for (let i = 0; i < paths.length; i++) {
+            const filePath = paths[i];
+            const expectedHash = hashes[i];
+            if (!expectedHash)
+                continue;
+            const fullPath = `${changeDir}/${filePath}`;
+            try {
+                const content = await fs.readFile(fullPath, 'utf8');
+                const actualHash = computeHash(content);
+                if (actualHash !== expectedHash) {
+                    mismatches.push({
+                        path: filePath,
+                        expected: expectedHash,
+                        actual: actualHash
+                    });
+                }
+            }
+            catch {
+                missing.push(filePath);
+            }
+        }
+    }
+    return {
+        valid: mismatches.length === 0 && missing.length === 0,
+        mismatches,
+        missing
+    };
+}
+/**
+ * Computes hash for a file.
+ * @param filePath - Path to the file
+ * @returns Hex-encoded hash string or null if file doesn't exist
+ */
+export async function hashFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf8');
+        return computeHash(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Computes hashes for multiple files.
+ * @param filePaths - Array of file paths
+ * @returns Map of file paths to hashes
+ */
+export async function hashFiles(filePaths) {
+    const result = new Map();
+    for (const filePath of filePaths) {
+        const hash = await hashFile(filePath);
+        if (hash) {
+            result.set(filePath, hash);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=integrity.js.map

package/dist/plugin/engine/integrity.js.map

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

package/dist/plugin/engine/registry.d.ts

@@ -0,0 +1,39 @@
+import type { ChangeInfo, Registry } from './types.ts';
+/**
+ * Reads the change registry from spec/registry.yaml.
+ * @param projectRoot - Path to the project root
+ * @returns The parsed registry
+ */
+export declare function readRegistry(projectRoot: string): Promise<Registry>;
+/**
+ * Writes the change registry to spec/registry.yaml.
+ * @param projectRoot - Path to the project root
+ * @param registry - The registry to write
+ */
+export declare function writeRegistry(projectRoot: string, registry: Registry): Promise<void>;
+/**
+ * Registers a new change in the registry.
+ * @param projectRoot - Path to the project root
+ * @param change - The change info to register
+ */
+export declare function registerChange(projectRoot: string, change: ChangeInfo): Promise<void>;
+/**
+ * Unregisters a change from the registry.
+ * @param projectRoot - Path to the project root
+ * @param changeName - Name of the change to remove
+ */
+export declare function unregisterChange(projectRoot: string, changeName: string): Promise<void>;
+/**
+ * Gets a specific change from the registry.
+ * @param projectRoot - Path to the project root
+ * @param changeName - Name of the change to find
+ * @returns The change info or undefined
+ */
+export declare function getChange(projectRoot: string, changeName: string): Promise<ChangeInfo | undefined>;
+/**
+ * Lists all active changes in the registry.
+ * @param projectRoot - Path to the project root
+ * @returns Array of active change infos
+ */
+export declare function listActiveChanges(projectRoot: string): Promise<ChangeInfo[]>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/plugin/engine/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/plugin/engine/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEtD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAYzE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1F;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3F;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7F;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAGxG;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAGlF"}

package/dist/plugin/engine/registry.js

@@ -0,0 +1,191 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+/**
+ * Reads the change registry from spec/registry.yaml.
+ * @param projectRoot - Path to the project root
+ * @returns The parsed registry
+ */
+export async function readRegistry(projectRoot) {
+    const registryPath = path.join(projectRoot, 'spec', 'registry.yaml');
+    try {
+        const content = await fs.readFile(registryPath, 'utf8');
+        return parseRegistryYaml(content);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return { changes: [], last_updated: new Date().toISOString() };
+        }
+        throw err;
+    }
+}
+/**
+ * Writes the change registry to spec/registry.yaml.
+ * @param projectRoot - Path to the project root
+ * @param registry - The registry to write
+ */
+export async function writeRegistry(projectRoot, registry) {
+    const registryPath = path.join(projectRoot, 'spec', 'registry.yaml');
+    const specDir = path.join(projectRoot, 'spec');
+    try {
+        await fs.mkdir(specDir, { recursive: true });
+    }
+    catch {
+        // directory may already exist
+    }
+    const content = serializeRegistryYaml(registry);
+    await fs.writeFile(registryPath, content, 'utf8');
+}
+/**
+ * Registers a new change in the registry.
+ * @param projectRoot - Path to the project root
+ * @param change - The change info to register
+ */
+export async function registerChange(projectRoot, change) {
+    const registry = await readRegistry(projectRoot);
+    const existing = registry.changes.findIndex(c => c.name === change.name);
+    if (existing !== -1) {
+        registry.changes[existing] = change;
+    }
+    else {
+        registry.changes.push(change);
+    }
+    registry.last_updated = new Date().toISOString();
+    await writeRegistry(projectRoot, registry);
+}
+/**
+ * Unregisters a change from the registry.
+ * @param projectRoot - Path to the project root
+ * @param changeName - Name of the change to remove
+ */
+export async function unregisterChange(projectRoot, changeName) {
+    const registry = await readRegistry(projectRoot);
+    registry.changes = registry.changes.filter(c => c.name !== changeName);
+    registry.last_updated = new Date().toISOString();
+    await writeRegistry(projectRoot, registry);
+}
+/**
+ * Gets a specific change from the registry.
+ * @param projectRoot - Path to the project root
+ * @param changeName - Name of the change to find
+ * @returns The change info or undefined
+ */
+export async function getChange(projectRoot, changeName) {
+    const registry = await readRegistry(projectRoot);
+    return registry.changes.find(c => c.name === changeName);
+}
+/**
+ * Lists all active changes in the registry.
+ * @param projectRoot - Path to the project root
+ * @returns Array of active change infos
+ */
+export async function listActiveChanges(projectRoot) {
+    const registry = await readRegistry(projectRoot);
+    return registry.changes.filter(c => c.status === 'active');
+}
+/**
+ * Simple YAML parser for registry files.
+ */
+function parseRegistryYaml(content) {
+    const result = { changes: [], last_updated: new Date().toISOString() };
+    const lines = content.split('\n');
+    let currentChange = null;
+    let inChanges = false;
+    let inArtifacts = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === '' || trimmed.startsWith('#'))
+            continue;
+        const indent = line.length - line.trimStart().length;
+        if (indent === 0) {
+            if (trimmed.startsWith('last_updated:')) {
+                result.last_updated = trimmed.substring('last_updated:'.length).trim().replace(/['"]/g, '');
+            }
+            else if (trimmed === 'changes:') {
+                inChanges = true;
+            }
+            continue;
+        }
+        if (inChanges) {
+            if (trimmed.startsWith('- ')) {
+                if (currentChange) {
+                    result.changes.push(currentChange);
+                }
+                currentChange = { artifacts: {} };
+                inArtifacts = false;
+                const rest = trimmed.substring(2).trim();
+                if (rest.includes(':')) {
+                    const colonIdx = rest.indexOf(':');
+                    const key = rest.substring(0, colonIdx).trim();
+                    const val = rest.substring(colonIdx + 1).trim().replace(/['"]/g, '');
+                    setChangeField(currentChange, key, val);
+                }
+            }
+            else if (currentChange) {
+                if (trimmed === 'artifacts:') {
+                    inArtifacts = true;
+                }
+                else if (inArtifacts && trimmed.includes(':')) {
+                    const colonIdx = trimmed.indexOf(':');
+                    const key = trimmed.substring(0, colonIdx).trim();
+                    const val = trimmed.substring(colonIdx + 1).trim();
+                    currentChange.artifacts[key] = val === 'true';
+                }
+                else if (trimmed.includes(':')) {
+                    inArtifacts = false;
+                    const colonIdx = trimmed.indexOf(':');
+                    const key = trimmed.substring(0, colonIdx).trim();
+                    const val = trimmed.substring(colonIdx + 1).trim().replace(/['"]/g, '');
+                    setChangeField(currentChange, key, val);
+                }
+            }
+        }
+    }
+    if (currentChange) {
+        result.changes.push(currentChange);
+    }
+    return result;
+}
+function setChangeField(change, key, value) {
+    switch (key) {
+        case 'name':
+            change.name = value;
+            break;
+        case 'schema':
+            change.schema = value;
+            break;
+        case 'status':
+            change.status = value;
+            break;
+        case 'created':
+            change.created = value;
+            break;
+        case 'progress':
+            change.progress = parseFloat(value) || 0;
+            break;
+    }
+}
+/**
+ * Serializes registry to YAML format.
+ */
+function serializeRegistryYaml(registry) {
+    const lines = [];
+    lines.push(`last_updated: '${registry.last_updated}'`);
+    lines.push('changes:');
+    for (const change of registry.changes) {
+        lines.push(`  - name: '${change.name}'`);
+        lines.push(`    schema: '${change.schema}'`);
+        lines.push(`    status: ${change.status}`);
+        lines.push(`    created: '${change.created}'`);
+        lines.push(`    progress: ${change.progress}`);
+        lines.push('    artifacts:');
+        if (change.artifacts) {
+            for (const [key, value] of Object.entries(change.artifacts)) {
+                if (value !== undefined) {
+                    lines.push(`      ${key}: ${value}`);
+                }
+            }
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=registry.js.map

package/dist/plugin/engine/registry.js.map

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

package/dist/plugin/engine/state.d.ts

@@ -0,0 +1,31 @@
+import type { ArtifactId, CompletedSet, Schema } from './types.js';
+/**
+ * Detects which artifacts are completed by checking file existence.
+ * @param changeDir - Path to the change directory
+ * @param schema - The schema containing artifact definitions
+ * @returns Set of completed artifact IDs
+ */
+export declare function detectCompleted(changeDir: string, schema: Schema): Promise<CompletedSet>;
+/**
+ * Checks if an artifact is complete by verifying its generated files exist.
+ * @param changeDir - Path to the change directory
+ * @param generates - Glob pattern or path for generated files
+ * @returns True if the artifact is complete
+ */
+export declare function isArtifactComplete(changeDir: string, generates: string): Promise<boolean>;
+/**
+ * Gets the file paths for a completed artifact.
+ * @param changeDir - Path to the change directory
+ * @param generates - Glob pattern or path for generated files
+ * @returns Array of file paths
+ */
+export declare function getArtifactPaths(changeDir: string, generates: string): Promise<string[]>;
+/**
+ * Finds all artifact IDs that are ready to be built.
+ * @param changeDir - Path to the change directory
+ * @param schema - The schema containing artifact definitions
+ * @param skipped - Optional set of artifact IDs to skip (only respected for optional artifacts)
+ * @returns Array of artifact IDs that can be built next
+ */
+export declare function getBuildableArtifacts(changeDir: string, schema: Schema, skipped?: CompletedSet): Promise<ArtifactId[]>;
+//# sourceMappingURL=state.d.ts.map

package/dist/plugin/engine/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/plugin/engine/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAGlE;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAW9F;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4B/F;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA4B9F;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,EAAE,CAAC,CAkBvB"}

package/dist/plugin/engine/state.js

@@ -0,0 +1,116 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { buildGraph, getNextArtifacts } from './artifact-graph.js';
+/**
+ * Detects which artifacts are completed by checking file existence.
+ * @param changeDir - Path to the change directory
+ * @param schema - The schema containing artifact definitions
+ * @returns Set of completed artifact IDs
+ */
+export async function detectCompleted(changeDir, schema) {
+    const completed = new Set();
+    for (const artifact of schema.artifacts) {
+        const isComplete = await isArtifactComplete(changeDir, artifact.generates);
+        if (isComplete) {
+            completed.add(artifact.id);
+        }
+    }
+    return completed;
+}
+/**
+ * Checks if an artifact is complete by verifying its generated files exist.
+ * @param changeDir - Path to the change directory
+ * @param generates - Glob pattern or path for generated files
+ * @returns True if the artifact is complete
+ */
+export async function isArtifactComplete(changeDir, generates) {
+    try {
+        if (generates.includes('*')) {
+            const dirPattern = generates.split('*')[0];
+            const dirPath = path.join(changeDir, dirPattern);
+            try {
+                const stat = await fs.stat(dirPath);
+                if (!stat.isDirectory())
+                    return false;
+                const files = await fs.readdir(dirPath);
+                return files.length > 0;
+            }
+            catch {
+                return false;
+            }
+        }
+        else {
+            const filePath = path.join(changeDir, generates);
+            try {
+                const stat = await fs.stat(filePath);
+                return stat.isFile() || stat.isDirectory();
+            }
+            catch {
+                return false;
+            }
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Gets the file paths for a completed artifact.
+ * @param changeDir - Path to the change directory
+ * @param generates - Glob pattern or path for generated files
+ * @returns Array of file paths
+ */
+export async function getArtifactPaths(changeDir, generates) {
+    try {
+        if (generates.includes('*')) {
+            const dirPattern = generates.split('*')[0];
+            const dirPath = path.join(changeDir, dirPattern);
+            try {
+                const stat = await fs.stat(dirPath);
+                if (!stat.isDirectory())
+                    return [];
+                const files = await fs.readdir(dirPath);
+                return files.map(f => path.join(dirPattern, f));
+            }
+            catch {
+                return [];
+            }
+        }
+        else {
+            const filePath = path.join(changeDir, generates);
+            try {
+                await fs.access(filePath);
+                return [generates];
+            }
+            catch {
+                return [];
+            }
+        }
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Finds all artifact IDs that are ready to be built.
+ * @param changeDir - Path to the change directory
+ * @param schema - The schema containing artifact definitions
+ * @param skipped - Optional set of artifact IDs to skip (only respected for optional artifacts)
+ * @returns Array of artifact IDs that can be built next
+ */
+export async function getBuildableArtifacts(changeDir, schema, skipped) {
+    const completed = await detectCompleted(changeDir, schema);
+    // Filter skipped to only include artifacts defined as optional in the schema
+    const validSkipped = new Set();
+    if (skipped) {
+        const optionalIds = new Set(schema.artifacts.filter(a => a.optional).map(a => a.id));
+        for (const id of skipped) {
+            if (optionalIds.has(id)) {
+                validSkipped.add(id);
+            }
+        }
+    }
+    const graph = buildGraph(schema);
+    return getNextArtifacts(graph, completed, validSkipped);
+}
+//# sourceMappingURL=state.js.map

package/dist/plugin/engine/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/plugin/engine/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAE5B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAElE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,MAAc;IACrE,MAAM,SAAS,GAAiB,IAAI,GAAG,EAAE,CAAA;IAEzC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAA;QAC1E,IAAI,UAAU,EAAE,CAAC;YACf,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,SAAiB;IAC3E,IAAI,CAAC;QACH,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;YAEhD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;oBAAE,OAAO,KAAK,CAAA;gBAErC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;gBACvC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;YAEhD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;gBACpC,OAAO,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAA;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB,EAAE,SAAiB;IACzE,IAAI,CAAC;QACH,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;YAEhD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;oBAAE,OAAO,EAAE,CAAA;gBAElC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;gBACvC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAA;YACjD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;YAEhD,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;gBACzB,OAAO,CAAC,SAAS,CAAC,CAAA;YACpB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAiB,EACjB,MAAc,EACd,OAAsB;IAEtB,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IAE1D,6EAA6E;IAC7E,MAAM,YAAY,GAAiB,IAAI,GAAG,EAAE,CAAA;IAC5C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACxD,CAAA;QACD,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACzB,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACxB,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAChC,OAAO,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,CAAC,CAAA;AACzD,CAAC"}