chief-helm 0.1.1

package/dist/commands/status.js

@@ -0,0 +1,184 @@
+/**
+ * @file helm status — system health overview panel.
+ *
+ * Renders a static bordered status panel in the CHIEF visual design
+ * showing: repo path and git cleanliness, all configured inputs with
+ * connection state, last run timestamps per flow, and engine availability.
+ *
+ * This command is read-only — it makes no writes and issues no git
+ * operations. Input "connection state" is derived from the `configured`
+ * flag in inputs.yaml (set by helm setup and helm inputs test) rather
+ * than making live API calls on every status invocation.
+ */
+import chalk from "chalk";
+import { execa } from "execa";
+import { requireSetup, getLocalConfig } from "../core/repo.js";
+import { readInputsConfig, readFlowsConfig, readEngineConfig } from "../core/config.js";
+import { getRepoStatus } from "../core/git.js";
+import { readLastRunState } from "../core/state.js";
+import { theme, symbol } from "../ui/theme.js";
+import { boxTop, boxDivider, boxBottom, boxRow, formatHeaderDate, formatLastRun, padEnd, } from "../utils/format.js";
+// ─── Engine Check ─────────────────────────────────────────────────────────────
+/**
+ * Returns true if the engine CLI command is available in PATH.
+ * Uses the command from engine.yaml, defaulting to "claude".
+ *
+ * @param command - The CLI command to check (e.g. "claude").
+ */
+async function isEngineAvailable(command) {
+    try {
+        await execa(command, ["--version"], { reject: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ─── Row Builders ─────────────────────────────────────────────────────────────
+/**
+ * Builds the header row content string for the top section.
+ * Format: CHIEF  ·  STATUS  ·  [username]  ·  [date]
+ */
+function buildHeaderContent(username) {
+    const dateStr = formatHeaderDate(new Date());
+    const sep = chalk.hex(theme.border)("  ·  ");
+    return [
+        chalk.hex(theme.text).bold("CHIEF"),
+        sep,
+        chalk.hex(theme.accent).bold("STATUS"),
+        sep,
+        chalk.hex(theme.muted)(username),
+        sep,
+        chalk.hex(theme.muted)(dateStr),
+    ].join("");
+}
+/**
+ * Builds the repo section row content.
+ * Shows the repo path and clean/dirty state.
+ */
+function buildRepoContent(repoRoot, status) {
+    const label = padEnd(chalk.hex(theme.text)("REPO"), 12);
+    const pathStr = chalk.hex(theme.muted)(repoRoot);
+    const statusStr = status.clean
+        ? chalk.hex(theme.success)(`${symbol.success} clean`)
+        : chalk.hex(theme.warning)(`${symbol.warning} dirty (${status.fileCount} file${status.fileCount !== 1 ? "s" : ""})`);
+    return `${label}${pathStr}   ${statusStr}`;
+}
+/**
+ * Builds one input row for the INPUTS section.
+ * Connected: ✓ green. Disabled: ○ gray. Configured-but-untested: ⚠ yellow.
+ */
+function buildInputRow(input) {
+    const labelStr = padEnd(input.label, 22);
+    if (!input.enabled) {
+        return (chalk.hex(theme.skip)(symbol.disabled) +
+            "  " +
+            chalk.hex(theme.skip)(labelStr) +
+            chalk.hex(theme.skip)("disabled"));
+    }
+    if (input.configured) {
+        return (chalk.hex(theme.success)(symbol.success) +
+            "  " +
+            chalk.hex(theme.text)(labelStr) +
+            chalk.hex(theme.success)("connected"));
+    }
+    return (chalk.hex(theme.warning)(symbol.warning) +
+        "  " +
+        chalk.hex(theme.text)(labelStr) +
+        chalk.hex(theme.warning)("not configured"));
+}
+/**
+ * Builds one last-run row for the LAST RUNS section.
+ */
+function buildLastRunRow(flowId, flowLabel, record) {
+    const labelStr = padEnd(flowLabel, 22);
+    const timeStr = formatLastRun(record?.timestamp);
+    const statusStr = record
+        ? record.status === "success"
+            ? chalk.hex(theme.success)(`${symbol.success} success`)
+            : chalk.hex(theme.error)(`${symbol.error} failed`)
+        : chalk.hex(theme.muted)("—");
+    return (chalk.hex(theme.text)(labelStr) +
+        chalk.hex(theme.muted)(padEnd(timeStr, 18)) +
+        "  " +
+        statusStr);
+}
+/**
+ * Builds the engine status row.
+ */
+function buildEngineRow(engineLabel, available) {
+    const label = padEnd(chalk.hex(theme.text)("ENGINE"), 12);
+    const nameStr = chalk.hex(theme.muted)(padEnd(engineLabel, 20));
+    const statusStr = available
+        ? chalk.hex(theme.success)(`${symbol.success} available`)
+        : chalk.hex(theme.error)(`${symbol.error} not found`);
+    return `${label}${nameStr}${statusStr}`;
+}
+// ─── Panel Renderer ───────────────────────────────────────────────────────────
+/**
+ * Assembles and prints the full CHIEF status panel to stdout.
+ * All data is fetched before this function is called so rendering
+ * is synchronous and non-interactive.
+ */
+function renderStatusPanel(data) {
+    const lines = [
+        boxTop(),
+        boxRow(buildHeaderContent(data.username)),
+        boxDivider(),
+        boxRow(buildRepoContent(data.repoRoot, data.repoStatus)),
+        boxDivider(),
+        boxRow(chalk.hex(theme.text).bold("INPUTS")),
+        ...data.inputs.map((inp) => boxRow(buildInputRow(inp))),
+        boxDivider(),
+        boxRow(chalk.hex(theme.text).bold("LAST RUNS")),
+        ...data.flows.map((flow) => boxRow(buildLastRunRow(flow.id, flow.label, data.lastRunState[flow.id]))),
+        boxDivider(),
+        boxRow(buildEngineRow(data.engineLabel, data.engineAvailable)),
+        boxBottom(),
+    ];
+    console.log("\n" + lines.join("\n") + "\n");
+}
+// ─── Command Registration ─────────────────────────────────────────────────────
+/**
+ * Registers the `helm status` command on the given Commander program.
+ *
+ * @param program - The root Commander Command instance.
+ */
+export function registerStatusCommand(program) {
+    program
+        .command("status")
+        .description("Show system health overview")
+        .action(async () => {
+        requireSetup();
+        const config = getLocalConfig();
+        const repoRoot = config.instance_repo_path;
+        const username = config.active_user;
+        const [repoStatus, inputs, flows, lastRunState, engineConfig] = await Promise.all([
+            getRepoStatus(repoRoot),
+            Promise.resolve(readInputsConfig(repoRoot)),
+            Promise.resolve(readFlowsConfig(repoRoot)),
+            Promise.resolve(readLastRunState(repoRoot, username)),
+            Promise.resolve(readEngineConfig(repoRoot)),
+        ]);
+        const engineLabel = engineConfig.engine === "claude-code"
+            ? "Claude Code CLI"
+            : "Anthropic API";
+        const engineAvailable = await isEngineAvailable(engineConfig.command);
+        const lastRunMap = {};
+        for (const flow of flows) {
+            const record = lastRunState[flow.id];
+            lastRunMap[flow.id] = record;
+        }
+        renderStatusPanel({
+            username,
+            repoRoot,
+            repoStatus,
+            inputs,
+            flows,
+            lastRunState: lastRunMap,
+            engineLabel,
+            engineAvailable,
+        });
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/sync.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @file helm sync — pull latest changes from the instance repo remote.
+ *
+ * Performs `git pull` on the personal instance repo, updates the
+ * last_sync timestamp in local config, and displays the current
+ * repo status (clean or dirty with file count).
+ *
+ * This command is the mandatory first step before any flow run.
+ * Running it manually confirms the local copy is up to date with
+ * any changes made in other environments or by Railway automation.
+ */
+import type { Command } from "commander";
+/**
+ * Registers the `helm sync` command on the given Commander program.
+ *
+ * @param program - The root Commander Command instance.
+ */
+export declare function registerSyncCommand(program: Command): void;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8C1D"}

package/dist/commands/sync.js

@@ -0,0 +1,47 @@
+/**
+ * @file helm sync — pull latest changes from the instance repo remote.
+ *
+ * Performs `git pull` on the personal instance repo, updates the
+ * last_sync timestamp in local config, and displays the current
+ * repo status (clean or dirty with file count).
+ *
+ * This command is the mandatory first step before any flow run.
+ * Running it manually confirms the local copy is up to date with
+ * any changes made in other environments or by Railway automation.
+ */
+import chalk from "chalk";
+import { requireSetup, getLocalConfig, updateLocalConfig } from "../core/repo.js";
+import { pullLatest, getRepoStatus } from "../core/git.js";
+import { theme, symbol } from "../ui/theme.js";
+import { formatHeaderDate } from "../utils/format.js";
+// ─── Command Registration ─────────────────────────────────────────────────────
+/**
+ * Registers the `helm sync` command on the given Commander program.
+ *
+ * @param program - The root Commander Command instance.
+ */
+export function registerSyncCommand(program) {
+    program
+        .command("sync")
+        .description("Pull latest from origin and show repo status")
+        .action(async () => {
+        requireSetup();
+        const { instance_repo_path: repoRoot, active_user: username } = getLocalConfig();
+        process.stdout.write(chalk.hex(theme.muted)("  Pulling from origin… "));
+        await pullLatest(repoRoot);
+        const now = new Date();
+        updateLocalConfig({ last_sync: now.toISOString() });
+        const status = await getRepoStatus(repoRoot);
+        process.stdout.write("\n");
+        const statusStr = status.clean
+            ? chalk.hex(theme.success)(`${symbol.success} clean`)
+            : chalk.hex(theme.warning)(`${symbol.warning} dirty — ${status.fileCount} file${status.fileCount !== 1 ? "s" : ""} modified`);
+        console.log(`  ${chalk.hex(theme.success)(symbol.success)}  Synced  ${chalk.hex(theme.muted)(formatHeaderDate(now))}`);
+        console.log(`  ${chalk.hex(theme.muted)(symbol.bullet)}  Repo status: ${statusStr}`);
+        if (!status.clean) {
+            console.log(chalk.hex(theme.muted)(`\n  Uncommitted changes are present.\n  Run: helm push  to commit and push them.`));
+        }
+        console.log();
+    });
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,YAAY,EAAE,CAAC;QAEf,MAAM,EAAE,kBAAkB,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,GAC3D,cAAc,EAAE,CAAC;QAEnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,yBAAyB,CAAC,CAClD,CAAC;QAEF,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QAE3B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAEpD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;QAE7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE3B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK;YAC5B,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,QAAQ,CAAC;YACrD,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CACtB,GAAG,MAAM,CAAC,OAAO,YAAY,MAAM,CAAC,SAAS,QAAQ,MAAM,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,WAAW,CAClG,CAAC;QAEN,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,CAC1G,CAAC;QACF,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,SAAS,EAAE,CACxE,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CACpB,kFAAkF,CACnF,CACF,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @file Instance repo YAML config file I/O.
+ *
+ * Provides typed read and write functions for every config file that
+ * HELM manages in the personal instance repo under /config/. All
+ * functions fail fast with a descriptive HelmError when a file is
+ * missing, unreadable, or does not contain the expected top-level type.
+ *
+ * Write functions serialise with consistent YAML formatting so diffs
+ * remain readable when the user views their git history.
+ */
+import type { Input, Agent, Flow, Trigger, SystemConfig, EngineConfig } from "../types/index.js";
+/**
+ * Reads and returns all Input entries from config/inputs.yaml.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ */
+export declare function readInputsConfig(repoRoot: string): Input[];
+/**
+ * Writes the given Input array to config/inputs.yaml, replacing
+ * the current file contents.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ * @param inputs   - Full array of Input entries to persist.
+ */
+export declare function writeInputsConfig(repoRoot: string, inputs: Input[]): void;
+/**
+ * Reads and returns all Agent entries from config/agents.yaml.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ */
+export declare function readAgentsConfig(repoRoot: string): Agent[];
+/**
+ * Writes the given Agent array to config/agents.yaml.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ * @param agents   - Full array of Agent entries to persist.
+ */
+export declare function writeAgentsConfig(repoRoot: string, agents: Agent[]): void;
+/**
+ * Reads and returns all Flow entries from config/flows.yaml.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ */
+export declare function readFlowsConfig(repoRoot: string): Flow[];
+/**
+ * Writes the given Flow array to config/flows.yaml.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ * @param flows    - Full array of Flow entries to persist.
+ */
+export declare function writeFlowsConfig(repoRoot: string, flows: Flow[]): void;
+/**
+ * Reads and returns all Trigger entries from config/triggers.yaml.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ */
+export declare function readTriggersConfig(repoRoot: string): Trigger[];
+/**
+ * Reads engine.yaml if it exists and returns its contents, or returns
+ * a safe default EngineConfig when the file is absent (the file is
+ * optional — HELM falls back to the Claude Code CLI defaults).
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ */
+export declare function readEngineConfig(repoRoot: string): EngineConfig;
+/**
+ * Reads config/system.yaml if it exists and returns its contents.
+ * Returns null if the file is absent so callers can skip it gracefully.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ */
+export declare function readSystemConfig(repoRoot: string): SystemConfig | null;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EACV,KAAK,EACL,KAAK,EACL,IAAI,EACJ,OAAO,EACP,YAAY,EACZ,YAAY,EACb,MAAM,mBAAmB,CAAC;AA8D3B;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,CAY1D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAGzE;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,CAY1D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAGzE;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,CAYxD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAGtE;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAAE,CAY9D;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAe/D;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAOtE"}

package/dist/core/config.js

@@ -0,0 +1,182 @@
+/**
+ * @file Instance repo YAML config file I/O.
+ *
+ * Provides typed read and write functions for every config file that
+ * HELM manages in the personal instance repo under /config/. All
+ * functions fail fast with a descriptive HelmError when a file is
+ * missing, unreadable, or does not contain the expected top-level type.
+ *
+ * Write functions serialise with consistent YAML formatting so diffs
+ * remain readable when the user views their git history.
+ */
+import fs from "fs";
+import path from "path";
+import yaml from "js-yaml";
+import { HelmError } from "../utils/errors.js";
+// ─── Internal Helpers ─────────────────────────────────────────────────────────
+/**
+ * Reads a YAML file at the given absolute path and returns the parsed
+ * value. Throws HelmError on missing file or parse failure.
+ *
+ * @param filePath - Absolute path to the YAML file.
+ * @param label    - Human-readable name used in error messages (e.g. "inputs.yaml").
+ */
+function readYaml(filePath, label) {
+    if (!fs.existsSync(filePath)) {
+        throw new HelmError(`Config file not found: ${label}`, `Ensure your instance repo is fully initialised. Missing: ${filePath}`);
+    }
+    const raw = fs.readFileSync(filePath, "utf-8");
+    try {
+        return yaml.load(raw);
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new HelmError(`Failed to parse ${label}: ${detail}`, `Fix the YAML syntax in ${filePath}, then retry.`);
+    }
+}
+/**
+ * Serialises data to YAML and writes it atomically to the given path.
+ * Throws HelmError if the write fails.
+ *
+ * @param filePath - Absolute path to write.
+ * @param data     - Value to serialise.
+ * @param label    - Human-readable name for error messages.
+ */
+function writeYaml(filePath, data, label) {
+    const content = yaml.dump(data, {
+        indent: 2,
+        lineWidth: -1,
+        noRefs: true,
+        sortKeys: false,
+    });
+    try {
+        fs.writeFileSync(filePath, content, "utf-8");
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new HelmError(`Failed to write ${label}: ${detail}`, `Check file permissions for ${filePath}.`);
+    }
+}
+// ─── inputs.yaml ─────────────────────────────────────────────────────────────
+/**
+ * Reads and returns all Input entries from config/inputs.yaml.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ */
+export function readInputsConfig(repoRoot) {
+    const filePath = path.join(repoRoot, "config", "inputs.yaml");
+    const parsed = readYaml(filePath, "inputs.yaml");
+    if (!Array.isArray(parsed)) {
+        throw new HelmError("inputs.yaml must contain a top-level array.", `Open ${filePath} and ensure the root value is a YAML sequence.`);
+    }
+    return parsed;
+}
+/**
+ * Writes the given Input array to config/inputs.yaml, replacing
+ * the current file contents.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ * @param inputs   - Full array of Input entries to persist.
+ */
+export function writeInputsConfig(repoRoot, inputs) {
+    const filePath = path.join(repoRoot, "config", "inputs.yaml");
+    writeYaml(filePath, inputs, "inputs.yaml");
+}
+// ─── agents.yaml ─────────────────────────────────────────────────────────────
+/**
+ * Reads and returns all Agent entries from config/agents.yaml.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ */
+export function readAgentsConfig(repoRoot) {
+    const filePath = path.join(repoRoot, "config", "agents.yaml");
+    const parsed = readYaml(filePath, "agents.yaml");
+    if (!Array.isArray(parsed)) {
+        throw new HelmError("agents.yaml must contain a top-level array.", `Open ${filePath} and ensure the root value is a YAML sequence.`);
+    }
+    return parsed;
+}
+/**
+ * Writes the given Agent array to config/agents.yaml.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ * @param agents   - Full array of Agent entries to persist.
+ */
+export function writeAgentsConfig(repoRoot, agents) {
+    const filePath = path.join(repoRoot, "config", "agents.yaml");
+    writeYaml(filePath, agents, "agents.yaml");
+}
+// ─── flows.yaml ──────────────────────────────────────────────────────────────
+/**
+ * Reads and returns all Flow entries from config/flows.yaml.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ */
+export function readFlowsConfig(repoRoot) {
+    const filePath = path.join(repoRoot, "config", "flows.yaml");
+    const parsed = readYaml(filePath, "flows.yaml");
+    if (!Array.isArray(parsed)) {
+        throw new HelmError("flows.yaml must contain a top-level array.", `Open ${filePath} and ensure the root value is a YAML sequence.`);
+    }
+    return parsed;
+}
+/**
+ * Writes the given Flow array to config/flows.yaml.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ * @param flows    - Full array of Flow entries to persist.
+ */
+export function writeFlowsConfig(repoRoot, flows) {
+    const filePath = path.join(repoRoot, "config", "flows.yaml");
+    writeYaml(filePath, flows, "flows.yaml");
+}
+// ─── triggers.yaml ───────────────────────────────────────────────────────────
+/**
+ * Reads and returns all Trigger entries from config/triggers.yaml.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ */
+export function readTriggersConfig(repoRoot) {
+    const filePath = path.join(repoRoot, "config", "triggers.yaml");
+    const parsed = readYaml(filePath, "triggers.yaml");
+    if (!Array.isArray(parsed)) {
+        throw new HelmError("triggers.yaml must contain a top-level array.", `Open ${filePath} and ensure the root value is a YAML sequence.`);
+    }
+    return parsed;
+}
+// ─── engine.yaml ─────────────────────────────────────────────────────────────
+/**
+ * Reads engine.yaml if it exists and returns its contents, or returns
+ * a safe default EngineConfig when the file is absent (the file is
+ * optional — HELM falls back to the Claude Code CLI defaults).
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ */
+export function readEngineConfig(repoRoot) {
+    const filePath = path.join(repoRoot, "config", "engine.yaml");
+    const DEFAULT_ENGINE_CONFIG = {
+        engine: "claude-code",
+        command: "claude",
+        timeout_seconds: 120,
+    };
+    if (!fs.existsSync(filePath)) {
+        return DEFAULT_ENGINE_CONFIG;
+    }
+    const parsed = readYaml(filePath, "engine.yaml");
+    return { ...DEFAULT_ENGINE_CONFIG, ...parsed };
+}
+// ─── system.yaml ─────────────────────────────────────────────────────────────
+/**
+ * Reads config/system.yaml if it exists and returns its contents.
+ * Returns null if the file is absent so callers can skip it gracefully.
+ *
+ * @param repoRoot - Absolute path to the instance repo root.
+ */
+export function readSystemConfig(repoRoot) {
+    const filePath = path.join(repoRoot, "config", "system.yaml");
+    if (!fs.existsSync(filePath))
+        return null;
+    const parsed = readYaml(filePath, "system.yaml");
+    return parsed;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/git.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @file Git operations for HELM.
+ *
+ * All git interactions are routed through this module. Every function
+ * operates on the personal instance repo at the path provided by the
+ * caller (obtained from repoPath() in core/repo.ts).
+ *
+ * Git discipline enforced by this module:
+ *   - pullLatest() must be called before any flow run.
+ *   - commitAndPush() must be called after any successful flow run.
+ *   - Merge conflicts abort all operations with explicit manual steps.
+ *   - git add is always called with an explicit file list — never -A.
+ *
+ * Push failures after a completed run are non-fatal: they surface as a
+ * warning with the manual push command so the user can recover without
+ * re-running the flow.
+ */
+import type { RepoStatus } from "../types/index.js";
+/**
+ * Pulls the latest changes from the remote origin for the current branch.
+ *
+ * Fails fast if:
+ *   - The pull results in a merge conflict.
+ *   - The git command itself fails (no remote, auth error, etc.).
+ *
+ * This must be called before any flow run begins to ensure the agent
+ * instructions and config are up to date.
+ *
+ * @param repoRoot - Absolute path to the instance repo.
+ * @throws {HelmError} On merge conflict or pull failure.
+ */
+export declare function pullLatest(repoRoot: string): Promise<void>;
+/**
+ * Returns the current working tree status of the repo.
+ *
+ * @param repoRoot - Absolute path to the instance repo.
+ * @throws {HelmError} If git status cannot be read.
+ */
+export declare function getRepoStatus(repoRoot: string): Promise<RepoStatus>;
+/**
+ * Stages an explicit list of files, commits with the given message,
+ * and pushes to origin.
+ *
+ * If the push fails the commit is preserved locally and the function
+ * prints a recoverable warning rather than throwing. This matches the
+ * PRD behaviour: a completed run's outputs are never discarded due to
+ * a push failure.
+ *
+ * @param repoRoot    - Absolute path to the instance repo.
+ * @param files       - Explicit list of repo-relative paths to stage.
+ * @param message     - Commit message (caller applies [tag] prefix convention).
+ * @returns True if the push succeeded; false if it failed (warning printed).
+ * @throws {HelmError} If the commit itself fails.
+ */
+export declare function commitAndPush(repoRoot: string, files: string[], message: string): Promise<boolean>;
+/**
+ * Stages all tracked modified files and pushes with a given commit message.
+ * Unlike commitAndPush(), this uses `git add -u` (tracked files only) rather
+ * than an explicit file list. Intended for helm push where the user is
+ * explicitly choosing to push whatever is dirty.
+ *
+ * @param repoRoot - Absolute path to the instance repo.
+ * @param message  - Commit message.
+ * @returns True if push succeeded.
+ * @throws {HelmError} If there is nothing to commit or commit fails.
+ */
+export declare function addAllAndPush(repoRoot: string, message: string): Promise<boolean>;
+/**
+ * Returns true if the `git` executable is available in PATH.
+ * Used by the startup check in index.ts.
+ */
+export declare function isGitAvailable(): Promise<boolean>;
+//# sourceMappingURL=git.d.ts.map

package/dist/core/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/core/git.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAyBpD;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkChE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAoBzE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAwClB;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAOvD"}