chief-helm 0.1.1

package/dist/commands/secrets.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @file helm secrets — OS keychain credential management.
+ *
+ * Subcommands:
+ *   helm secrets set <key>      Masked input → stored in OS keychain
+ *   helm secrets list           Key names only, never values
+ *   helm secrets verify <key>   Confirm key exists in keychain
+ *   helm secrets delete <key>   Remove with confirmation prompt
+ *
+ * Secret values are never printed, logged, or included in error messages.
+ * The only moment a value appears on-screen is during `helm secrets set`
+ * where inquirer masks the input with asterisks.
+ */
+import type { Command } from "commander";
+/**
+ * Registers the `helm secrets` subcommand group on the given Commander program.
+ *
+ * @param program - The root Commander Command instance.
+ */
+export declare function registerSecretsCommand(program: Command): void;
+//# sourceMappingURL=secrets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../../src/commands/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0H7D"}

package/dist/commands/secrets.js

@@ -0,0 +1,110 @@
+/**
+ * @file helm secrets — OS keychain credential management.
+ *
+ * Subcommands:
+ *   helm secrets set <key>      Masked input → stored in OS keychain
+ *   helm secrets list           Key names only, never values
+ *   helm secrets verify <key>   Confirm key exists in keychain
+ *   helm secrets delete <key>   Remove with confirmation prompt
+ *
+ * Secret values are never printed, logged, or included in error messages.
+ * The only moment a value appears on-screen is during `helm secrets set`
+ * where inquirer masks the input with asterisks.
+ */
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { requireSetup, getLocalConfig } from "../core/repo.js";
+import { setSecret, listSecretKeys, verifySecret, deleteSecret, } from "../core/secrets.js";
+import { HelmError } from "../utils/errors.js";
+import { theme, symbol } from "../ui/theme.js";
+// ─── Command Registration ─────────────────────────────────────────────────────
+/**
+ * Registers the `helm secrets` subcommand group on the given Commander program.
+ *
+ * @param program - The root Commander Command instance.
+ */
+export function registerSecretsCommand(program) {
+    const secrets = program
+        .command("secrets")
+        .description("Manage OS keychain credentials");
+    // ── set ────────────────────────────────────────────────────────────────────
+    secrets
+        .command("set <key>")
+        .description("Store a secret in the OS keychain (masked input)")
+        .action(async (key) => {
+        requireSetup();
+        const { active_user: username } = getLocalConfig();
+        const { value } = await inquirer.prompt([
+            {
+                type: "password",
+                name: "value",
+                message: `  ${key}:`,
+                mask: "*",
+                validate: (v) => v.trim().length > 0 || "Value cannot be empty.",
+            },
+        ]);
+        await setSecret(username, key, value);
+        console.log(`  ${chalk.hex(theme.success)(symbol.success)}  Secret "${key}" stored in OS keychain.`);
+    });
+    // ── list ───────────────────────────────────────────────────────────────────
+    secrets
+        .command("list")
+        .description("List stored secret key names (values are never shown)")
+        .action(() => {
+        requireSetup();
+        const { active_user: username } = getLocalConfig();
+        const keys = listSecretKeys(username);
+        if (keys.length === 0) {
+            console.log(chalk.hex(theme.muted)(`  No secrets stored for ${username}.\n  Run: helm secrets set <KEY_NAME>`));
+            return;
+        }
+        console.log(`\n  ${chalk.hex(theme.text).bold("Stored secret keys")}  ${chalk.hex(theme.muted)(`(${keys.length} total — values not shown)`)}`);
+        for (const key of keys) {
+            console.log(`  ${chalk.hex(theme.muted)(symbol.bullet)}  ${chalk.hex(theme.text)(key)}`);
+        }
+        console.log();
+    });
+    // ── verify ─────────────────────────────────────────────────────────────────
+    secrets
+        .command("verify <key>")
+        .description("Confirm a secret key exists in the OS keychain")
+        .action(async (key) => {
+        requireSetup();
+        const { active_user: username } = getLocalConfig();
+        const exists = await verifySecret(username, key);
+        if (exists) {
+            console.log(`  ${chalk.hex(theme.success)(symbol.success)}  "${key}" exists in the OS keychain.`);
+        }
+        else {
+            throw new HelmError(`Secret "${key}" was not found in the OS keychain.`, `Run: helm secrets set ${key}`);
+        }
+    });
+    // ── delete ─────────────────────────────────────────────────────────────────
+    secrets
+        .command("delete <key>")
+        .description("Remove a secret from the OS keychain")
+        .action(async (key) => {
+        requireSetup();
+        const { active_user: username } = getLocalConfig();
+        const { confirmed } = await inquirer.prompt([
+            {
+                type: "confirm",
+                name: "confirmed",
+                message: `  Delete secret "${key}" from the OS keychain?`,
+                default: false,
+            },
+        ]);
+        if (!confirmed) {
+            console.log(chalk.hex(theme.muted)("  Cancelled."));
+            return;
+        }
+        const deleted = await deleteSecret(username, key);
+        if (deleted) {
+            console.log(`  ${chalk.hex(theme.success)(symbol.success)}  Secret "${key}" deleted from OS keychain.`);
+        }
+        else {
+            throw new HelmError(`Secret "${key}" was not found in the OS keychain.`, `Run: helm secrets list to see what keys are stored.`);
+        }
+    });
+}
+//# sourceMappingURL=secrets.js.map

package/dist/commands/secrets.js.map

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

package/dist/commands/setup.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @file helm setup — guided first-time setup wizard.
+ *
+ * Walks the user through six sequential steps to configure HELM against
+ * their personal CHIEF instance repo. setup_complete is only set to true
+ * after Step 6 (git push) succeeds. If the wizard is interrupted or push
+ * fails, re-running helm setup is safe — existing config and credentials
+ * are preserved and steps that have already completed are idempotent.
+ *
+ * Step 1: Locate and validate the instance repo.
+ * Step 2: Create user identity and initialise /users/[username]/.
+ * Step 3: Connect inputs — collect credentials, test each connection.
+ * Step 4: Review agents and flows, optionally disable any.
+ * Step 5: Remind about key documents, offer to open in editor.
+ * Step 6: Commit and push all setup changes.
+ */
+import type { Command } from "commander";
+/**
+ * Registers the `helm setup` command on the given Commander program.
+ *
+ * @param program - The root Commander Command instance.
+ */
+export declare function registerSetupCommand(program: Command): void;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAggBzC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6B3D"}

package/dist/commands/setup.js

@@ -0,0 +1,421 @@
+/**
+ * @file helm setup — guided first-time setup wizard.
+ *
+ * Walks the user through six sequential steps to configure HELM against
+ * their personal CHIEF instance repo. setup_complete is only set to true
+ * after Step 6 (git push) succeeds. If the wizard is interrupted or push
+ * fails, re-running helm setup is safe — existing config and credentials
+ * are preserved and steps that have already completed are idempotent.
+ *
+ * Step 1: Locate and validate the instance repo.
+ * Step 2: Create user identity and initialise /users/[username]/.
+ * Step 3: Connect inputs — collect credentials, test each connection.
+ * Step 4: Review agents and flows, optionally disable any.
+ * Step 5: Remind about key documents, offer to open in editor.
+ * Step 6: Commit and push all setup changes.
+ */
+import fs from "fs";
+import path from "path";
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { isValidRepoStructure, expandHomePath, updateLocalConfig, localStore, } from "../core/repo.js";
+import { readInputsConfig, writeInputsConfig, readAgentsConfig, writeAgentsConfig, readFlowsConfig, writeFlowsConfig, } from "../core/config.js";
+import { setSecret } from "../core/secrets.js";
+import { INPUT_CREDENTIAL_KEYS, testInput } from "../core/inputs.js";
+import { commitAndPush } from "../core/git.js";
+import { ensureStateDir } from "../core/state.js";
+import { theme, symbol } from "../ui/theme.js";
+import { execa } from "execa";
+// ─── Constants ────────────────────────────────────────────────────────────────
+/**
+ * User profile documents that must exist under /users/[username]/.
+ * Created as blank placeholders if /users/_template/ is absent.
+ */
+const USER_DOCS = [
+    "USER.md",
+    "VOICE.md",
+    "CLIENTS.md",
+    "SCHEDULING.md",
+    "CLASSIFY.md",
+];
+/** Commit message used at the end of helm setup. */
+const SETUP_COMMIT_PREFIX = "[manual] setup: initialized user";
+// ─── Print Helpers ────────────────────────────────────────────────────────────
+/** Prints a step header to visually separate wizard phases. */
+function printStep(n, title) {
+    console.log(`\n${chalk.hex(theme.accent).bold(`  Step ${n}`)}  ${chalk.hex(theme.text)(title)}`);
+    console.log(chalk.hex(theme.border)(`  ${"─".repeat(50)}`));
+}
+/** Prints a success line. */
+function ok(msg) {
+    console.log(`  ${chalk.hex(theme.success)(symbol.success)}  ${msg}`);
+}
+/** Prints a warning line. */
+function warn(msg) {
+    console.log(`  ${chalk.hex(theme.warning)(symbol.warning)}  ${msg}`);
+}
+// ─── Step 1: Locate Instance Repo ────────────────────────────────────────────
+/**
+ * Prompts the user for their instance repo path, validates the CHIEF
+ * directory structure, and persists the path to local config.
+ *
+ * Fails fast if the directory does not contain a valid CHIEF structure,
+ * directing the user to finish setting up CHIEF before running helm setup.
+ *
+ * @returns The validated absolute repo path.
+ */
+async function step1LocateRepo() {
+    printStep(1, "Locate instance repo");
+    const { rawPath } = await inquirer.prompt([
+        {
+            type: "input",
+            name: "rawPath",
+            message: "  Path to your personal CHIEF instance repo:",
+            validate: (input) => {
+                if (!input.trim())
+                    return "Path cannot be empty.";
+                const expanded = expandHomePath(input.trim());
+                if (!fs.existsSync(expanded))
+                    return `Directory not found: ${expanded}`;
+                if (!isValidRepoStructure(expanded)) {
+                    return ("This does not look like a fully initialised CHIEF instance repo.\n" +
+                        "  Ensure /config/inputs.yaml, agents.yaml, flows.yaml, and triggers.yaml exist before running helm setup.");
+                }
+                return true;
+            },
+        },
+    ]);
+    const repoRoot = expandHomePath(rawPath.trim());
+    updateLocalConfig({ instance_repo_path: repoRoot });
+    ok(`Repo found: ${repoRoot}`);
+    return repoRoot;
+}
+// ─── Step 2: Create User Identity ────────────────────────────────────────────
+/**
+ * Collects username, full name, timezone, language, and preferred
+ * editor. Creates /users/[username]/ by copying _template/ if present,
+ * or by writing blank placeholder files. Pre-populates USER.md with
+ * the collected identity fields.
+ *
+ * @param repoRoot - Validated absolute path to the instance repo.
+ * @returns The username entered by the user.
+ */
+async function step2CreateUserIdentity(repoRoot) {
+    printStep(2, "Create user identity");
+    const { username, fullName, timezone, language, editor } = await inquirer.prompt([
+        {
+            type: "input",
+            name: "username",
+            message: "  Username (letters, numbers, hyphens only):",
+            validate: (v) => /^[a-z0-9-]+$/.test(v) ||
+                "Use only lowercase letters, numbers, and hyphens.",
+        },
+        {
+            type: "input",
+            name: "fullName",
+            message: "  Full name:",
+            validate: (v) => v.trim().length > 0 || "Full name cannot be empty.",
+        },
+        {
+            type: "input",
+            name: "timezone",
+            message: "  Timezone (e.g. America/New_York):",
+            default: Intl.DateTimeFormat().resolvedOptions().timeZone,
+        },
+        {
+            type: "input",
+            name: "language",
+            message: "  Language code (e.g. en):",
+            default: "en",
+        },
+        {
+            type: "input",
+            name: "editor",
+            message: "  Editor command (e.g. code, vim, nano):",
+            default: process.env["EDITOR"] ?? "code",
+        },
+    ]);
+    const userDir = path.join(repoRoot, "users", username);
+    const templateDir = path.join(repoRoot, "users", "_template");
+    const templateExists = fs.existsSync(templateDir);
+    if (!fs.existsSync(userDir)) {
+        if (templateExists) {
+            fs.cpSync(templateDir, userDir, { recursive: true });
+            ok(`Copied template to users/${username}/`);
+        }
+        else {
+            fs.mkdirSync(userDir, { recursive: true });
+            for (const doc of USER_DOCS) {
+                const docPath = path.join(userDir, doc);
+                fs.writeFileSync(docPath, `# ${doc.replace(".md", "")} — ${fullName}\n\n<!-- Fill in this document. See SETUP.md for guidance. -->\n`, "utf-8");
+            }
+            warn(`users/_template/ not found — blank placeholder files created in users/${username}/. Fill them in before running flows.`);
+        }
+    }
+    else {
+        ok(`users/${username}/ already exists — skipping creation.`);
+    }
+    // Pre-populate USER.md with identity fields regardless of source.
+    const userMdPath = path.join(userDir, "USER.md");
+    const existing = fs.existsSync(userMdPath)
+        ? fs.readFileSync(userMdPath, "utf-8")
+        : "";
+    const identityBlock = [
+        `<!-- HELM setup — do not remove this block -->`,
+        `**Username:** ${username}`,
+        `**Full Name:** ${fullName}`,
+        `**Timezone:** ${timezone}`,
+        `**Language:** ${language}`,
+        `<!-- end HELM setup block -->`,
+    ].join("\n");
+    if (!existing.includes("<!-- HELM setup")) {
+        fs.writeFileSync(userMdPath, `${identityBlock}\n\n${existing}`, "utf-8");
+    }
+    // Ensure runtime support directories exist.
+    ensureStateDir(repoRoot, username);
+    for (const dir of ["outputs", "logs", "context", "knowledge"]) {
+        const userSubDir = path.join(repoRoot, dir, username);
+        if (!fs.existsSync(userSubDir)) {
+            fs.mkdirSync(userSubDir, { recursive: true });
+        }
+    }
+    updateLocalConfig({ active_user: username, editor });
+    ok(`User identity saved: ${fullName} (${username})`);
+    return username;
+}
+// ─── Step 3: Connect Inputs ───────────────────────────────────────────────────
+/**
+ * For each input in inputs.yaml, asks whether to enable it. For enabled
+ * inputs, collects all required credentials via masked prompts, stores
+ * them in the OS keychain, and runs a connectivity test.
+ *
+ * Updates the `enabled` and `configured` fields in inputs.yaml after
+ * each input is processed. This ensures partial progress is persisted
+ * even if the wizard is interrupted.
+ *
+ * @param repoRoot - Absolute path to the instance repo.
+ * @param username - Active username for keychain scoping.
+ */
+async function step3ConnectInputs(repoRoot, username) {
+    printStep(3, "Connect inputs");
+    const inputs = readInputsConfig(repoRoot);
+    for (const input of inputs) {
+        console.log(`\n  ${chalk.hex(theme.text).bold(input.label)}`);
+        if (input.setup_guide) {
+            console.log(chalk.hex(theme.muted)(`  ${input.setup_guide}`));
+        }
+        const { enable } = await inquirer.prompt([
+            {
+                type: "confirm",
+                name: "enable",
+                message: `  Enable ${input.label}?`,
+                default: input.enabled,
+            },
+        ]);
+        input.enabled = enable;
+        if (!enable) {
+            input.configured = false;
+            console.log(chalk.hex(theme.skip)(`  ${symbol.disabled} Skipped`));
+            continue;
+        }
+        const credentialKeys = INPUT_CREDENTIAL_KEYS[input.id] ??
+            (input.credentials_ref ? [input.credentials_ref] : []);
+        if (credentialKeys.length === 0) {
+            warn(`No credential keys defined for ${input.id} — skipping.`);
+            continue;
+        }
+        for (const key of credentialKeys) {
+            const { value } = await inquirer.prompt([
+                {
+                    type: "password",
+                    name: "value",
+                    message: `  ${key}:`,
+                    mask: "*",
+                    validate: (v) => v.trim().length > 0 || `${key} cannot be empty.`,
+                },
+            ]);
+            await setSecret(username, key, value);
+        }
+        process.stdout.write(`  ${chalk.hex(theme.muted)("Testing connection…")} `);
+        const result = await testInput(input.id, username);
+        if (result.ok) {
+            input.configured = true;
+            ok(`Connected${result.detail ? ` — ${result.detail}` : ""}`);
+        }
+        else {
+            input.configured = false;
+            console.log(`\n  ${chalk.hex(theme.error)(symbol.error)} ${result.error ?? "Connection failed."}`);
+            if (result.fix) {
+                console.log(chalk.hex(theme.muted)(`  ${symbol.arrow} ${result.fix}`));
+            }
+            warn("You can fix this later with: helm inputs test " + input.id);
+        }
+        // Persist after each input so partial progress survives interruptions.
+        writeInputsConfig(repoRoot, inputs);
+    }
+}
+// ─── Step 4: Confirm Agents and Flows ────────────────────────────────────────
+/**
+ * Displays all agents and flows from config (all enabled by default).
+ * Asks which, if any, should be disabled. Writes updated config files.
+ *
+ * @param repoRoot - Absolute path to the instance repo.
+ */
+async function step4ConfirmAgentsFlows(repoRoot) {
+    printStep(4, "Confirm agents and flows");
+    const agents = readAgentsConfig(repoRoot);
+    const flows = readFlowsConfig(repoRoot);
+    // Agents
+    console.log(`\n  ${chalk.hex(theme.text)("Agents:")}`);
+    for (const agent of agents) {
+        console.log(`  ${agent.enabled ? chalk.hex(theme.success)(symbol.success) : chalk.hex(theme.skip)(symbol.disabled)}  ${agent.label} (${agent.id})`);
+    }
+    const agentChoices = agents.map((a) => ({
+        name: `${a.label} (${a.id})`,
+        value: a.id,
+        checked: a.enabled,
+    }));
+    const { enabledAgentIds } = await inquirer.prompt([
+        {
+            type: "checkbox",
+            name: "enabledAgentIds",
+            message: "  Select agents to keep enabled:",
+            choices: agentChoices,
+        },
+    ]);
+    for (const agent of agents) {
+        agent.enabled = enabledAgentIds.includes(agent.id);
+    }
+    writeAgentsConfig(repoRoot, agents);
+    // Flows
+    console.log(`\n  ${chalk.hex(theme.text)("Flows:")}`);
+    for (const flow of flows) {
+        console.log(`  ${flow.enabled ? chalk.hex(theme.success)(symbol.success) : chalk.hex(theme.skip)(symbol.disabled)}  ${flow.label} (${flow.id})`);
+    }
+    const flowChoices = flows.map((f) => ({
+        name: `${f.label} (${f.id})`,
+        value: f.id,
+        checked: f.enabled,
+    }));
+    const { enabledFlowIds } = await inquirer.prompt([
+        {
+            type: "checkbox",
+            name: "enabledFlowIds",
+            message: "  Select flows to keep enabled:",
+            choices: flowChoices,
+        },
+    ]);
+    for (const flow of flows) {
+        flow.enabled = enabledFlowIds.includes(flow.id);
+    }
+    writeFlowsConfig(repoRoot, flows);
+    ok("Agent and flow configuration saved.");
+}
+// ─── Step 5: Key Documents ────────────────────────────────────────────────────
+/**
+ * Lists the five key profile documents the user must fill in before
+ * running flows. Offers to open each in the configured editor.
+ *
+ * @param repoRoot - Absolute path to the instance repo.
+ * @param username - Active username.
+ * @param editor   - Editor command (e.g. "code").
+ */
+async function step5KeyDocuments(repoRoot, username, editor) {
+    printStep(5, "Key documents");
+    console.log(chalk.hex(theme.muted)("\n  These documents define how agents understand you and your work.\n" +
+        "  Fill them in thoroughly — document quality directly affects output quality.\n"));
+    for (const doc of USER_DOCS) {
+        const docPath = path.join(repoRoot, "users", username, doc);
+        console.log(`  ${chalk.hex(theme.text)(doc)}  ${chalk.hex(theme.muted)(docPath)}`);
+    }
+    const { openDocs } = await inquirer.prompt([
+        {
+            type: "confirm",
+            name: "openDocs",
+            message: "\n  Open all key documents in your editor now?",
+            default: false,
+        },
+    ]);
+    if (openDocs) {
+        const editorParts = editor.split(" ");
+        const editorCmd = editorParts[0];
+        const editorArgs = editorParts.slice(1);
+        for (const doc of USER_DOCS) {
+            const docPath = path.join(repoRoot, "users", username, doc);
+            try {
+                await execa(editorCmd, [...editorArgs, docPath], {
+                    stdio: "inherit",
+                });
+            }
+            catch {
+                warn(`Could not open ${doc} with "${editor}". Open it manually: ${docPath}`);
+            }
+        }
+    }
+    else {
+        console.log(chalk.hex(theme.muted)(`\n  Open them later with: helm docs edit <name>, or directly in your editor.`));
+    }
+}
+// ─── Step 6: Commit and Push ──────────────────────────────────────────────────
+/**
+ * Commits all setup-generated files and pushes to origin.
+ *
+ * setup_complete is only set to true after a successful push. If push
+ * fails, setup_complete remains false and the user is shown a clear
+ * recovery message. Re-running helm setup will skip already-completed
+ * steps (idempotent) and retry the push.
+ *
+ * @param repoRoot - Absolute path to the instance repo.
+ * @param username - Active username for the commit message.
+ */
+async function step6CommitAndPush(repoRoot, username) {
+    printStep(6, "Commit and push");
+    const filesToCommit = [
+        path.join("config", "inputs.yaml"),
+        path.join("config", "agents.yaml"),
+        path.join("config", "flows.yaml"),
+        path.join("users", username),
+        path.join("state", username),
+        path.join("outputs", username),
+        path.join("logs", username),
+        path.join("context", username),
+        path.join("knowledge", username),
+    ];
+    const pushed = await commitAndPush(repoRoot, filesToCommit, `${SETUP_COMMIT_PREFIX} ${username}`);
+    if (pushed) {
+        updateLocalConfig({ setup_complete: true });
+        ok("Committed and pushed to origin.");
+        ok("Setup complete. Run: helm status");
+    }
+    else {
+        updateLocalConfig({ setup_complete: false });
+        console.log(`\n  ${chalk.hex(theme.error)(symbol.error)} Setup could not complete: git push failed.`);
+        console.log(chalk.hex(theme.muted)(`  ${symbol.arrow} Fix your git remote auth, then push manually:\n` +
+            `       cd ${repoRoot} && git push\n` +
+            `  ${symbol.arrow} Then run: helm setup  (it will resume safely from where it left off)`));
+    }
+}
+// ─── Command Registration ─────────────────────────────────────────────────────
+/**
+ * Registers the `helm setup` command on the given Commander program.
+ *
+ * @param program - The root Commander Command instance.
+ */
+export function registerSetupCommand(program) {
+    program
+        .command("setup")
+        .description("Guided first-time setup wizard")
+        .action(async () => {
+        console.log(`\n${chalk.hex(theme.accent).bold("  ╔══════════════════════════════════════╗")}`);
+        console.log(chalk.hex(theme.accent).bold("  ║  CHIEF  ·  HELM SETUP                ║"));
+        console.log(chalk.hex(theme.accent).bold("  ╚══════════════════════════════════════╝\n"));
+        const repoRoot = await step1LocateRepo();
+        const username = await step2CreateUserIdentity(repoRoot);
+        await step3ConnectInputs(repoRoot, username);
+        await step4ConfirmAgentsFlows(repoRoot);
+        const editor = localStore.get("editor") ?? "code";
+        await step5KeyDocuments(repoRoot, username, editor);
+        await step6CommitAndPush(repoRoot, username);
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @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 type { Command } from "commander";
+/**
+ * Registers the `helm status` command on the given Commander program.
+ *
+ * @param program - The root Commander Command instance.
+ */
+export declare function registerStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkMzC;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+C5D"}