@herdctl/core 0.0.1

package/dist/state/directory.js

@@ -0,0 +1,170 @@
+/**
+ * State directory management
+ *
+ * Provides functions to initialize and access the .herdctl/ state directory
+ */
+import { mkdir, stat, access, constants } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { STATE_SUBDIRECTORIES, DEFAULT_STATE_DIR_NAME, STATE_FILE_NAME, } from "./types.js";
+import { StateDirectoryCreateError, StateDirectoryValidationError, StateFileError, getPermissionErrorMessage, } from "./errors.js";
+import { createInitialFleetState, FleetStateSchema } from "./schemas/index.js";
+import { atomicWriteYaml } from "./utils/index.js";
+import { safeReadYaml } from "./utils/reads.js";
+/**
+ * Get the paths for all state directory components
+ *
+ * @param rootPath - Root path to the state directory (e.g., /path/to/.herdctl)
+ * @returns StateDirectory object with paths to all subdirectories and files
+ */
+export function getStateDirectory(rootPath) {
+    const root = rootPath
+        ? resolve(rootPath)
+        : resolve(process.cwd(), DEFAULT_STATE_DIR_NAME);
+    return {
+        root,
+        jobs: join(root, "jobs"),
+        sessions: join(root, "sessions"),
+        logs: join(root, "logs"),
+        stateFile: join(root, STATE_FILE_NAME),
+    };
+}
+/**
+ * Check if a path exists and is a directory
+ */
+async function isDirectory(path) {
+    try {
+        const stats = await stat(path);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a path exists (file or directory)
+ */
+async function pathExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validate that the state directory structure exists and is accessible
+ *
+ * @param stateDir - StateDirectory object to validate
+ * @returns Validation result with any missing paths or errors
+ */
+export async function validateStateDirectory(stateDir) {
+    const missing = [];
+    const errors = [];
+    // Check root directory
+    if (!(await isDirectory(stateDir.root))) {
+        const exists = await pathExists(stateDir.root);
+        if (exists) {
+            errors.push(`'${stateDir.root}' exists but is not a directory`);
+        }
+        else {
+            missing.push(stateDir.root);
+        }
+    }
+    // Check subdirectories
+    for (const subdir of STATE_SUBDIRECTORIES) {
+        const subdirPath = stateDir[subdir];
+        if (!(await isDirectory(subdirPath))) {
+            const exists = await pathExists(subdirPath);
+            if (exists) {
+                errors.push(`'${subdirPath}' exists but is not a directory`);
+            }
+            else {
+                missing.push(subdirPath);
+            }
+        }
+    }
+    // Check state file (should exist, can be file)
+    if (!(await pathExists(stateDir.stateFile))) {
+        missing.push(stateDir.stateFile);
+    }
+    return {
+        valid: missing.length === 0 && errors.length === 0,
+        missing,
+        errors,
+    };
+}
+/**
+ * Create a single directory with descriptive error handling
+ */
+async function createDirectory(path) {
+    try {
+        await mkdir(path, { recursive: true });
+    }
+    catch (error) {
+        const code = error.code;
+        throw new StateDirectoryCreateError(getPermissionErrorMessage(code, path), path, error);
+    }
+}
+/**
+ * Initialize the state directory structure
+ *
+ * Creates the .herdctl/ directory and its subdirectories (jobs/, sessions/, logs/)
+ * if they don't exist. Also creates an initial state.yaml file with empty fleet state.
+ *
+ * @param options - Options for initialization
+ * @returns StateDirectory object with paths to all subdirectories
+ * @throws {StateDirectoryCreateError} If directories cannot be created
+ * @throws {StateFileError} If state.yaml cannot be created
+ *
+ * @example
+ * ```typescript
+ * // Initialize in current directory
+ * const stateDir = await initStateDirectory();
+ *
+ * // Initialize in custom location
+ * const stateDir = await initStateDirectory({ path: '/custom/path/.herdctl' });
+ * ```
+ */
+export async function initStateDirectory(options = {}) {
+    const stateDir = getStateDirectory(options.path);
+    // Create root directory
+    await createDirectory(stateDir.root);
+    // Create subdirectories
+    for (const subdir of STATE_SUBDIRECTORIES) {
+        await createDirectory(stateDir[subdir]);
+    }
+    // Create state.yaml if it doesn't exist
+    if (!(await pathExists(stateDir.stateFile))) {
+        try {
+            const initialState = createInitialFleetState();
+            await atomicWriteYaml(stateDir.stateFile, initialState);
+        }
+        catch (error) {
+            throw new StateFileError(`Failed to create initial state file: ${error.message}`, stateDir.stateFile, "write", error);
+        }
+    }
+    else {
+        // Validate existing state.yaml is readable and valid
+        const result = await safeReadYaml(stateDir.stateFile);
+        if (!result.success) {
+            throw new StateFileError(`Existing state file is corrupted or unreadable: ${result.error.message}`, stateDir.stateFile, "read", result.error);
+        }
+        // Validate against schema
+        const parseResult = FleetStateSchema.safeParse(result.data);
+        if (!parseResult.success) {
+            const issues = parseResult.error.issues
+                .map((i) => `${i.path.join(".")}: ${i.message}`)
+                .join("; ");
+            throw new StateFileError(`Existing state file has invalid schema: ${issues}`, stateDir.stateFile, "read");
+        }
+    }
+    // Final validation
+    const validation = await validateStateDirectory(stateDir);
+    if (!validation.valid) {
+        const allIssues = [...validation.missing, ...validation.errors];
+        throw new StateDirectoryValidationError(`State directory validation failed: ${allIssues.join(", ")}`, validation.missing);
+    }
+    return stateDir;
+}
+//# sourceMappingURL=directory.js.map

package/dist/state/directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.js","sourceRoot":"","sources":["../../src/state/directory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAIL,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,cAAc,EACd,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAiB;IACjD,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACnB,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAC;IAEnD,OAAO;QACL,IAAI;QACJ,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC;KACvC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAwB;IAExB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,uBAAuB;IACvB,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,iCAAiC,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,KAAK,MAAM,MAAM,IAAI,oBAAoB,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;YAC5C,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CAAC,IAAI,UAAU,iCAAiC,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAED,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAClD,OAAO;QACP,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,MAAM,IAAI,yBAAyB,CACjC,yBAAyB,CAAC,IAAI,EAAE,IAAI,CAAC,EACrC,IAAI,EACJ,KAAc,CACf,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAqC,EAAE;IAEvC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjD,wBAAwB;IACxB,MAAM,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAErC,wBAAwB;IACxB,KAAK,MAAM,MAAM,IAAI,oBAAoB,EAAE,CAAC;QAC1C,MAAM,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,wCAAwC;IACxC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,uBAAuB,EAAE,CAAC;YAC/C,MAAM,eAAe,CAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,cAAc,CACtB,wCAAyC,KAAe,CAAC,OAAO,EAAE,EAClE,QAAQ,CAAC,SAAS,EAClB,OAAO,EACP,KAAc,CACf,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,qDAAqD;QACrD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,cAAc,CACtB,mDAAmD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EACzE,QAAQ,CAAC,SAAS,EAClB,MAAM,EACN,MAAM,CAAC,KAAK,CACb,CAAC;QACJ,CAAC;QAED,0BAA0B;QAC1B,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM;iBACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC/C,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,cAAc,CACtB,2CAA2C,MAAM,EAAE,EACnD,QAAQ,CAAC,SAAS,EAClB,MAAM,CACP,CAAC;QACJ,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,IAAI,6BAA6B,CACrC,sCAAsC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC5D,UAAU,CAAC,OAAO,CACnB,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/state/errors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Error classes for state management operations
+ *
+ * Provides typed errors with descriptive messages for state-related failures
+ */
+/**
+ * Base error class for state management errors
+ */
+export declare class StateError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when the state directory cannot be created
+ */
+export declare class StateDirectoryCreateError extends StateError {
+    /** Path that could not be created */
+    readonly path: string;
+    /** System error code if available (e.g., EACCES, ENOENT) */
+    readonly code?: string;
+    constructor(message: string, path: string, cause?: Error);
+}
+/**
+ * Error thrown when the state directory validation fails
+ */
+export declare class StateDirectoryValidationError extends StateError {
+    /** Paths that failed validation */
+    readonly missingPaths: string[];
+    constructor(message: string, missingPaths: string[]);
+}
+/**
+ * Error thrown when the state file cannot be read or written
+ */
+export declare class StateFileError extends StateError {
+    /** Path to the state file */
+    readonly path: string;
+    /** The operation that failed */
+    readonly operation: "read" | "write";
+    constructor(message: string, path: string, operation: "read" | "write", cause?: Error);
+}
+/**
+ * Get a descriptive error message for common permission errors
+ */
+export declare function getPermissionErrorMessage(code: string | undefined, path: string): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/state/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/state/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,UAAU;IACvD,qCAAqC;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAOzD;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,UAAU;IAC3D,mCAAmC;IACnC,SAAgB,YAAY,EAAE,MAAM,EAAE,CAAC;gBAE3B,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE;CAKpD;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,6BAA6B;IAC7B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,gCAAgC;IAChC,SAAgB,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;gBAG1C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,OAAO,EAC3B,KAAK,CAAC,EAAE,KAAK;CAQhB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,CAmBR"}

package/dist/state/errors.js

@@ -0,0 +1,82 @@
+/**
+ * Error classes for state management operations
+ *
+ * Provides typed errors with descriptive messages for state-related failures
+ */
+/**
+ * Base error class for state management errors
+ */
+export class StateError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "StateError";
+    }
+}
+/**
+ * Error thrown when the state directory cannot be created
+ */
+export class StateDirectoryCreateError extends StateError {
+    /** Path that could not be created */
+    path;
+    /** System error code if available (e.g., EACCES, ENOENT) */
+    code;
+    constructor(message, path, cause) {
+        super(message);
+        this.name = "StateDirectoryCreateError";
+        this.path = path;
+        this.cause = cause;
+        this.code = cause?.code;
+    }
+}
+/**
+ * Error thrown when the state directory validation fails
+ */
+export class StateDirectoryValidationError extends StateError {
+    /** Paths that failed validation */
+    missingPaths;
+    constructor(message, missingPaths) {
+        super(message);
+        this.name = "StateDirectoryValidationError";
+        this.missingPaths = missingPaths;
+    }
+}
+/**
+ * Error thrown when the state file cannot be read or written
+ */
+export class StateFileError extends StateError {
+    /** Path to the state file */
+    path;
+    /** The operation that failed */
+    operation;
+    constructor(message, path, operation, cause) {
+        super(message);
+        this.name = "StateFileError";
+        this.path = path;
+        this.operation = operation;
+        this.cause = cause;
+    }
+}
+/**
+ * Get a descriptive error message for common permission errors
+ */
+export function getPermissionErrorMessage(code, path) {
+    switch (code) {
+        case "EACCES":
+            return `Permission denied: Cannot access '${path}'. Check file permissions.`;
+        case "EPERM":
+            return `Operation not permitted: Cannot modify '${path}'. This may require elevated privileges.`;
+        case "EROFS":
+            return `Read-only filesystem: Cannot write to '${path}'.`;
+        case "ENOSPC":
+            return `No space left on device: Cannot create '${path}'.`;
+        case "ENOENT":
+            return `Path does not exist: '${path}' or one of its parent directories is missing.`;
+        case "ENOTDIR":
+            return `Not a directory: A component of '${path}' is not a directory.`;
+        case "EEXIST":
+            return `Path already exists: '${path}' already exists as a file but should be a directory.`;
+        default:
+            return `Failed to access '${path}'${code ? ` (${code})` : ""}.`;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/state/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/state/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,UAAU;IACvD,qCAAqC;IACrB,IAAI,CAAS;IAC7B,4DAA4D;IAC5C,IAAI,CAAU;IAE9B,YAAY,OAAe,EAAE,IAAY,EAAE,KAAa;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAI,KAA2C,EAAE,IAAI,CAAC;IACjE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,6BAA8B,SAAQ,UAAU;IAC3D,mCAAmC;IACnB,YAAY,CAAW;IAEvC,YAAY,OAAe,EAAE,YAAsB;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;QAC5C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,6BAA6B;IACb,IAAI,CAAS;IAC7B,gCAAgC;IAChB,SAAS,CAAmB;IAE5C,YACE,OAAe,EACf,IAAY,EACZ,SAA2B,EAC3B,KAAa;QAEb,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAwB,EACxB,IAAY;IAEZ,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,qCAAqC,IAAI,4BAA4B,CAAC;QAC/E,KAAK,OAAO;YACV,OAAO,2CAA2C,IAAI,0CAA0C,CAAC;QACnG,KAAK,OAAO;YACV,OAAO,0CAA0C,IAAI,IAAI,CAAC;QAC5D,KAAK,QAAQ;YACX,OAAO,2CAA2C,IAAI,IAAI,CAAC;QAC7D,KAAK,QAAQ;YACX,OAAO,yBAAyB,IAAI,gDAAgD,CAAC;QACvF,KAAK,SAAS;YACZ,OAAO,oCAAoC,IAAI,uBAAuB,CAAC;QACzE,KAAK,QAAQ;YACX,OAAO,yBAAyB,IAAI,uDAAuD,CAAC;QAC9F;YACE,OAAO,qBAAqB,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/state/fleet-state.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Fleet state management (state.yaml)
+ *
+ * Provides functions for reading, writing, and updating fleet state.
+ * Handles missing files gracefully and corrupted files with warnings.
+ */
+import { type FleetState, type AgentState } from "./schemas/fleet-state.js";
+/**
+ * Logger interface for warning messages
+ */
+export interface StateLogger {
+    warn: (message: string) => void;
+}
+/**
+ * Options for reading fleet state
+ */
+export interface ReadFleetStateOptions {
+    /**
+     * Logger for warning messages (e.g., corrupted file warnings)
+     * Default: console.warn
+     */
+    logger?: StateLogger;
+}
+/**
+ * Options for writing fleet state
+ */
+export interface WriteFleetStateOptions {
+    /**
+     * YAML indent level
+     * Default: 2
+     */
+    indent?: number;
+}
+/**
+ * Read and validate fleet state from state.yaml
+ *
+ * Handles:
+ * - Missing file: Returns default empty state
+ * - Corrupted file: Logs warning, returns default empty state
+ * - Valid file: Returns validated FleetState
+ *
+ * @param stateFilePath - Path to state.yaml file
+ * @param options - Read options including logger
+ * @returns Validated FleetState object
+ *
+ * @example
+ * ```typescript
+ * const state = await readFleetState('.herdctl/state.yaml');
+ * console.log(state.fleet.started_at);
+ * console.log(state.agents);
+ * ```
+ */
+export declare function readFleetState(stateFilePath: string, options?: ReadFleetStateOptions): Promise<FleetState>;
+/**
+ * Write fleet state to state.yaml atomically
+ *
+ * Uses atomic write (write to temp file, then rename) to prevent corruption.
+ *
+ * @param stateFilePath - Path to state.yaml file
+ * @param state - FleetState object to write
+ * @param options - Write options
+ * @throws {StateFileError} If write fails
+ *
+ * @example
+ * ```typescript
+ * const state = await readFleetState('.herdctl/state.yaml');
+ * state.fleet.started_at = new Date().toISOString();
+ * await writeFleetState('.herdctl/state.yaml', state);
+ * ```
+ */
+export declare function writeFleetState(stateFilePath: string, state: FleetState, options?: WriteFleetStateOptions): Promise<void>;
+/**
+ * Partial updates for agent state
+ */
+export type AgentStateUpdates = Partial<AgentState>;
+/**
+ * Update a single agent's state within the fleet state
+ *
+ * This is a convenience function that:
+ * 1. Reads current state
+ * 2. Applies partial updates to the specified agent
+ * 3. Writes the updated state back atomically
+ *
+ * If the agent doesn't exist, it will be created with the provided updates.
+ *
+ * @param stateFilePath - Path to state.yaml file
+ * @param agentName - Name of the agent to update
+ * @param updates - Partial AgentState updates to apply
+ * @param options - Options for read/write operations
+ * @returns The updated FleetState
+ * @throws {StateFileError} If write fails
+ *
+ * @example
+ * ```typescript
+ * // Mark agent as running with a job
+ * await updateAgentState('.herdctl/state.yaml', 'my-agent', {
+ *   status: 'running',
+ *   current_job: 'job-123',
+ * });
+ *
+ * // Clear error state
+ * await updateAgentState('.herdctl/state.yaml', 'my-agent', {
+ *   status: 'idle',
+ *   error_message: null,
+ * });
+ * ```
+ */
+export declare function updateAgentState(stateFilePath: string, agentName: string, updates: AgentStateUpdates, options?: ReadFleetStateOptions & WriteFleetStateOptions): Promise<FleetState>;
+/**
+ * Initialize fleet state with started_at timestamp if not already set
+ *
+ * @param stateFilePath - Path to state.yaml file
+ * @param options - Options for read/write operations
+ * @returns The initialized FleetState
+ */
+export declare function initializeFleetState(stateFilePath: string, options?: ReadFleetStateOptions & WriteFleetStateOptions): Promise<FleetState>;
+/**
+ * Remove an agent from the fleet state
+ *
+ * @param stateFilePath - Path to state.yaml file
+ * @param agentName - Name of the agent to remove
+ * @param options - Options for read/write operations
+ * @returns The updated FleetState
+ */
+export declare function removeAgentState(stateFilePath: string, agentName: string, options?: ReadFleetStateOptions & WriteFleetStateOptions): Promise<FleetState>;
+//# sourceMappingURL=fleet-state.d.ts.map

package/dist/state/fleet-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-state.d.ts","sourceRoot":"","sources":["../../src/state/fleet-state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AAKlC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AASD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,UAAU,CAAC,CA0CrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,qBAAqB,GAAG,sBAA2B,GAC3D,OAAO,CAAC,UAAU,CAAC,CA0BrB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,qBAAqB,GAAG,sBAA2B,GAC3D,OAAO,CAAC,UAAU,CAAC,CAiBrB;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,qBAAqB,GAAG,sBAA2B,GAC3D,OAAO,CAAC,UAAU,CAAC,CAarB"}

package/dist/state/fleet-state.js

@@ -0,0 +1,196 @@
+/**
+ * Fleet state management (state.yaml)
+ *
+ * Provides functions for reading, writing, and updating fleet state.
+ * Handles missing files gracefully and corrupted files with warnings.
+ */
+import { ZodError } from "zod";
+import { FleetStateSchema, createInitialFleetState, } from "./schemas/fleet-state.js";
+import { safeReadYaml } from "./utils/reads.js";
+import { atomicWriteYaml } from "./utils/atomic.js";
+import { StateFileError } from "./errors.js";
+/**
+ * Default console logger
+ */
+const defaultLogger = {
+    warn: (message) => console.warn(`[herdctl] ${message}`),
+};
+/**
+ * Read and validate fleet state from state.yaml
+ *
+ * Handles:
+ * - Missing file: Returns default empty state
+ * - Corrupted file: Logs warning, returns default empty state
+ * - Valid file: Returns validated FleetState
+ *
+ * @param stateFilePath - Path to state.yaml file
+ * @param options - Read options including logger
+ * @returns Validated FleetState object
+ *
+ * @example
+ * ```typescript
+ * const state = await readFleetState('.herdctl/state.yaml');
+ * console.log(state.fleet.started_at);
+ * console.log(state.agents);
+ * ```
+ */
+export async function readFleetState(stateFilePath, options = {}) {
+    const logger = options.logger ?? defaultLogger;
+    // Attempt to read the file
+    const readResult = await safeReadYaml(stateFilePath);
+    // Handle file not found - return default state
+    if (!readResult.success) {
+        if (readResult.error.code === "ENOENT") {
+            return createInitialFleetState();
+        }
+        // For other read errors, log and return default
+        logger.warn(`Failed to read state file '${stateFilePath}': ${readResult.error.message}. Using default state.`);
+        return createInitialFleetState();
+    }
+    // Handle empty file - return default state
+    if (readResult.data === null || readResult.data === undefined) {
+        return createInitialFleetState();
+    }
+    // Validate against schema
+    try {
+        return FleetStateSchema.parse(readResult.data);
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            const issues = error.issues
+                .map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`)
+                .join(", ");
+            logger.warn(`Corrupted state file '${stateFilePath}': ${issues}. Using default state.`);
+            return createInitialFleetState();
+        }
+        // Unexpected error - log and return default
+        logger.warn(`Unexpected error parsing state file '${stateFilePath}': ${error.message}. Using default state.`);
+        return createInitialFleetState();
+    }
+}
+/**
+ * Write fleet state to state.yaml atomically
+ *
+ * Uses atomic write (write to temp file, then rename) to prevent corruption.
+ *
+ * @param stateFilePath - Path to state.yaml file
+ * @param state - FleetState object to write
+ * @param options - Write options
+ * @throws {StateFileError} If write fails
+ *
+ * @example
+ * ```typescript
+ * const state = await readFleetState('.herdctl/state.yaml');
+ * state.fleet.started_at = new Date().toISOString();
+ * await writeFleetState('.herdctl/state.yaml', state);
+ * ```
+ */
+export async function writeFleetState(stateFilePath, state, options = {}) {
+    // Validate before writing
+    const validatedState = FleetStateSchema.parse(state);
+    try {
+        await atomicWriteYaml(stateFilePath, validatedState, {
+            indent: options.indent ?? 2,
+        });
+    }
+    catch (error) {
+        throw new StateFileError(`Failed to write state file '${stateFilePath}': ${error.message}`, stateFilePath, "write", error);
+    }
+}
+/**
+ * Update a single agent's state within the fleet state
+ *
+ * This is a convenience function that:
+ * 1. Reads current state
+ * 2. Applies partial updates to the specified agent
+ * 3. Writes the updated state back atomically
+ *
+ * If the agent doesn't exist, it will be created with the provided updates.
+ *
+ * @param stateFilePath - Path to state.yaml file
+ * @param agentName - Name of the agent to update
+ * @param updates - Partial AgentState updates to apply
+ * @param options - Options for read/write operations
+ * @returns The updated FleetState
+ * @throws {StateFileError} If write fails
+ *
+ * @example
+ * ```typescript
+ * // Mark agent as running with a job
+ * await updateAgentState('.herdctl/state.yaml', 'my-agent', {
+ *   status: 'running',
+ *   current_job: 'job-123',
+ * });
+ *
+ * // Clear error state
+ * await updateAgentState('.herdctl/state.yaml', 'my-agent', {
+ *   status: 'idle',
+ *   error_message: null,
+ * });
+ * ```
+ */
+export async function updateAgentState(stateFilePath, agentName, updates, options = {}) {
+    // Read current state
+    const currentState = await readFleetState(stateFilePath, options);
+    // Get current agent state or create new one
+    const currentAgentState = currentState.agents[agentName] ?? { status: "idle" };
+    // Merge updates
+    const updatedAgentState = {
+        ...currentAgentState,
+        ...updates,
+    };
+    // Update the state
+    const updatedState = {
+        ...currentState,
+        agents: {
+            ...currentState.agents,
+            [agentName]: updatedAgentState,
+        },
+    };
+    // Write back
+    await writeFleetState(stateFilePath, updatedState, options);
+    return updatedState;
+}
+/**
+ * Initialize fleet state with started_at timestamp if not already set
+ *
+ * @param stateFilePath - Path to state.yaml file
+ * @param options - Options for read/write operations
+ * @returns The initialized FleetState
+ */
+export async function initializeFleetState(stateFilePath, options = {}) {
+    const currentState = await readFleetState(stateFilePath, options);
+    // Only set started_at if not already set
+    if (!currentState.fleet.started_at) {
+        const updatedState = {
+            ...currentState,
+            fleet: {
+                ...currentState.fleet,
+                started_at: new Date().toISOString(),
+            },
+        };
+        await writeFleetState(stateFilePath, updatedState, options);
+        return updatedState;
+    }
+    return currentState;
+}
+/**
+ * Remove an agent from the fleet state
+ *
+ * @param stateFilePath - Path to state.yaml file
+ * @param agentName - Name of the agent to remove
+ * @param options - Options for read/write operations
+ * @returns The updated FleetState
+ */
+export async function removeAgentState(stateFilePath, agentName, options = {}) {
+    const currentState = await readFleetState(stateFilePath, options);
+    // Create new agents map without the specified agent
+    const { [agentName]: _, ...remainingAgents } = currentState.agents;
+    const updatedState = {
+        ...currentState,
+        agents: remainingAgents,
+    };
+    await writeFleetState(stateFilePath, updatedState, options);
+    return updatedState;
+}
+//# sourceMappingURL=fleet-state.js.map

package/dist/state/fleet-state.js.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * State management module
+ *
+ * Provides utilities for managing herdctl state files including:
+ * - State directory initialization and management
+ * - Atomic file writes to prevent corruption
+ * - YAML and JSONL file operations
+ * - Safe reads with validation
+ * - Fleet state (state.yaml) management
+ * - Job metadata (job-<id>.yaml) management
+ */
+export * from "./types.js";
+export * from "./errors.js";
+export * from "./schemas/index.js";
+export { initStateDirectory, getStateDirectory, validateStateDirectory, } from "./directory.js";
+export * from "./utils/index.js";
+export { readFleetState, writeFleetState, updateAgentState, initializeFleetState, removeAgentState, type StateLogger, type ReadFleetStateOptions, type WriteFleetStateOptions, type AgentStateUpdates, } from "./fleet-state.js";
+export { createJob, updateJob, getJob, listJobs, deleteJob, type JobMetadataOptions, type JobLogger, type JobMetadataUpdates, type ListJobsFilter, type ListJobsResult, } from "./job-metadata.js";
+export { getJobOutputPath, appendJobOutput, appendJobOutputBatch, readJobOutput, readJobOutputAll, type JobOutputLogger, type JobOutputOptions, type ReadJobOutputOptions, } from "./job-output.js";
+export { getSessionInfo, updateSessionInfo, clearSession, type SessionOptions, type SessionLogger, type SessionInfoUpdates, } from "./session.js";
+//# sourceMappingURL=index.d.ts.map