chief-helm 0.1.1

package/dist/ui/theme.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @file CHIEF visual design system.
+ *
+ * Single source of truth for all colours and status symbols used
+ * across HELM terminal output and Ink components. All values are
+ * hex strings compatible with chalk's hex() API and Ink's color prop.
+ *
+ * Defined in PRD Section 12.
+ */
+/**
+ * Colour palette for the CHIEF design system.
+ *
+ * Semantic names (dispatch, prep, yours, skip) correspond to the four
+ * classification states. Utility names (border, text, muted, success,
+ * warning, error, accent) are used for structural chrome.
+ */
+export declare const theme: {
+    /** Classification: AI can handle fully. */
+    readonly dispatch: "#22c55e";
+    /** Classification: AI gets 80% there, human finishes. */
+    readonly prep: "#eab308";
+    /** Classification: Requires human judgment. */
+    readonly yours: "#ef4444";
+    /** Classification: Not actionable today. */
+    readonly skip: "#6b7280";
+    /** Panel and row border lines. */
+    readonly border: "#334155";
+    /** Primary text on dark background. */
+    readonly text: "#f1f5f9";
+    /** Secondary/subdued text. */
+    readonly muted: "#94a3b8";
+    /** Positive outcome indicator. */
+    readonly success: "#22c55e";
+    /** Non-blocking issue indicator. */
+    readonly warning: "#f59e0b";
+    /** Blocking failure indicator. */
+    readonly error: "#ef4444";
+    /** Highlight / interactive accent. */
+    readonly accent: "#6366f1";
+};
+/**
+ * Unicode status symbols used in all HELM output.
+ * Consistent placement: symbol always precedes the label it qualifies.
+ */
+export declare const symbol: {
+    readonly success: "✓";
+    readonly error: "✗";
+    readonly warning: "⚠";
+    readonly disabled: "○";
+    readonly bullet: "·";
+    readonly arrow: "→";
+    readonly info: "ℹ";
+};
+/**
+ * Header format string template.
+ * Usage: replace [SCREEN], [USERNAME], [CONTEXT] at render time.
+ * Context segment is optional — omit trailing " · [CONTEXT]" when absent.
+ */
+export declare const HEADER_FORMAT = "CHIEF  \u00B7  [SCREEN]  \u00B7  [USERNAME]  \u00B7  [CONTEXT]";
+//# sourceMappingURL=theme.d.ts.map

package/dist/ui/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,KAAK;IAChB,2CAA2C;;IAE3C,yDAAyD;;IAEzD,+CAA+C;;IAE/C,4CAA4C;;IAG5C,kCAAkC;;IAElC,uCAAuC;;IAEvC,8BAA8B;;IAG9B,kCAAkC;;IAElC,oCAAoC;;IAEpC,kCAAkC;;IAElC,sCAAsC;;CAE9B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;;;;CAQT,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,aAAa,mEAAoD,CAAC"}

package/dist/ui/theme.js

@@ -0,0 +1,60 @@
+/**
+ * @file CHIEF visual design system.
+ *
+ * Single source of truth for all colours and status symbols used
+ * across HELM terminal output and Ink components. All values are
+ * hex strings compatible with chalk's hex() API and Ink's color prop.
+ *
+ * Defined in PRD Section 12.
+ */
+/**
+ * Colour palette for the CHIEF design system.
+ *
+ * Semantic names (dispatch, prep, yours, skip) correspond to the four
+ * classification states. Utility names (border, text, muted, success,
+ * warning, error, accent) are used for structural chrome.
+ */
+export const theme = {
+    /** Classification: AI can handle fully. */
+    dispatch: "#22c55e",
+    /** Classification: AI gets 80% there, human finishes. */
+    prep: "#eab308",
+    /** Classification: Requires human judgment. */
+    yours: "#ef4444",
+    /** Classification: Not actionable today. */
+    skip: "#6b7280",
+    /** Panel and row border lines. */
+    border: "#334155",
+    /** Primary text on dark background. */
+    text: "#f1f5f9",
+    /** Secondary/subdued text. */
+    muted: "#94a3b8",
+    /** Positive outcome indicator. */
+    success: "#22c55e",
+    /** Non-blocking issue indicator. */
+    warning: "#f59e0b",
+    /** Blocking failure indicator. */
+    error: "#ef4444",
+    /** Highlight / interactive accent. */
+    accent: "#6366f1",
+};
+/**
+ * Unicode status symbols used in all HELM output.
+ * Consistent placement: symbol always precedes the label it qualifies.
+ */
+export const symbol = {
+    success: "✓",
+    error: "✗",
+    warning: "⚠",
+    disabled: "○",
+    bullet: "·",
+    arrow: "→",
+    info: "ℹ",
+};
+/**
+ * Header format string template.
+ * Usage: replace [SCREEN], [USERNAME], [CONTEXT] at render time.
+ * Context segment is optional — omit trailing " · [CONTEXT]" when absent.
+ */
+export const HEADER_FORMAT = "CHIEF  ·  [SCREEN]  ·  [USERNAME]  ·  [CONTEXT]";
+//# sourceMappingURL=theme.js.map

package/dist/ui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,2CAA2C;IAC3C,QAAQ,EAAE,SAAS;IACnB,yDAAyD;IACzD,IAAI,EAAE,SAAS;IACf,+CAA+C;IAC/C,KAAK,EAAE,SAAS;IAChB,4CAA4C;IAC5C,IAAI,EAAE,SAAS;IAEf,kCAAkC;IAClC,MAAM,EAAE,SAAS;IACjB,uCAAuC;IACvC,IAAI,EAAE,SAAS;IACf,8BAA8B;IAC9B,KAAK,EAAE,SAAS;IAEhB,kCAAkC;IAClC,OAAO,EAAE,SAAS;IAClB,oCAAoC;IACpC,OAAO,EAAE,SAAS;IAClB,kCAAkC;IAClC,KAAK,EAAE,SAAS;IAChB,sCAAsC;IACtC,MAAM,EAAE,SAAS;CACT,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,GAAG;IACV,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,MAAM,EAAE,GAAG;IACX,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,GAAG;CACD,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,iDAAiD,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @file Typed error handling for HELM.
+ *
+ * Every user-facing failure is a HelmError with two required fields:
+ * a description of what went wrong and a specific actionable fix.
+ * This enforces the PRD requirement that every error surfaces with
+ * a clear message and a concrete next step.
+ *
+ * Unexpected errors (bugs, unhandled rejections) are caught at the
+ * top-level handler in index.ts and formatted separately.
+ */
+/**
+ * All intentional HELM failures. Thrown when a known failure condition
+ * is encountered (missing config, bad credentials, git conflicts, etc.).
+ *
+ * The `fix` field is mandatory — HELM never shows an error without
+ * telling the user exactly what to do next.
+ */
+export declare class HelmError extends Error {
+    /** The specific remediation instruction to show the user. */
+    readonly fix: string;
+    constructor(what: string, fix: string);
+}
+/**
+ * Formats a HelmError into the CHIEF visual design error format:
+ * ```
+ * ✗ Error: [what]
+ *   → [fix]
+ * ```
+ *
+ * Output is plain text. Callers apply chalk colouring if needed.
+ */
+export declare function formatHelmError(error: HelmError): string;
+/**
+ * Formats an unexpected (non-HelmError) exception for display.
+ * Used by the top-level error handler in index.ts.
+ *
+ * The error message is surfaced as-is. No fix suggestion is provided
+ * because the cause is not a known application state.
+ */
+export declare function formatUnexpectedError(error: unknown): string;
+/**
+ * Asserts that a value is not null or undefined at a known-safe
+ * location, throwing HelmError with the provided context if it is.
+ *
+ * Use this instead of non-null assertions (!) to keep error messages
+ * actionable rather than crashing silently.
+ */
+export declare function assertDefined<T>(value: T | null | undefined, what: string, fix: string): asserts value is T;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;CAKtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI5D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,IAAI,CAAC,CAIpB"}

package/dist/utils/errors.js

@@ -0,0 +1,63 @@
+/**
+ * @file Typed error handling for HELM.
+ *
+ * Every user-facing failure is a HelmError with two required fields:
+ * a description of what went wrong and a specific actionable fix.
+ * This enforces the PRD requirement that every error surfaces with
+ * a clear message and a concrete next step.
+ *
+ * Unexpected errors (bugs, unhandled rejections) are caught at the
+ * top-level handler in index.ts and formatted separately.
+ */
+/**
+ * All intentional HELM failures. Thrown when a known failure condition
+ * is encountered (missing config, bad credentials, git conflicts, etc.).
+ *
+ * The `fix` field is mandatory — HELM never shows an error without
+ * telling the user exactly what to do next.
+ */
+export class HelmError extends Error {
+    /** The specific remediation instruction to show the user. */
+    fix;
+    constructor(what, fix) {
+        super(what);
+        this.name = "HelmError";
+        this.fix = fix;
+    }
+}
+/**
+ * Formats a HelmError into the CHIEF visual design error format:
+ * ```
+ * ✗ Error: [what]
+ *   → [fix]
+ * ```
+ *
+ * Output is plain text. Callers apply chalk colouring if needed.
+ */
+export function formatHelmError(error) {
+    return `✗ Error: ${error.message}\n  → ${error.fix}`;
+}
+/**
+ * Formats an unexpected (non-HelmError) exception for display.
+ * Used by the top-level error handler in index.ts.
+ *
+ * The error message is surfaced as-is. No fix suggestion is provided
+ * because the cause is not a known application state.
+ */
+export function formatUnexpectedError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return `✗ Unexpected error: ${message}\n  → This is a bug. Please report it at https://github.com/[owner]/chief/issues`;
+}
+/**
+ * Asserts that a value is not null or undefined at a known-safe
+ * location, throwing HelmError with the provided context if it is.
+ *
+ * Use this instead of non-null assertions (!) to keep error messages
+ * actionable rather than crashing silently.
+ */
+export function assertDefined(value, what, fix) {
+    if (value === null || value === undefined) {
+        throw new HelmError(what, fix);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;GAMG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,6DAA6D;IACpD,GAAG,CAAS;IAErB,YAAY,IAAY,EAAE,GAAW;QACnC,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,OAAO,YAAY,KAAK,CAAC,OAAO,SAAS,KAAK,CAAC,GAAG,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO,uBAAuB,OAAO,kFAAkF,CAAC;AAC1H,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,KAA2B,EAC3B,IAAY,EACZ,GAAW;IAEX,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/utils/format.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @file Terminal output formatting utilities.
+ *
+ * Covers date/time display, string padding, and the box-drawing
+ * primitives used to render the CHIEF bordered panels (helm status,
+ * helm sync output). All box-drawing functions accept chalk-coloured
+ * strings and use visible-length calculation to ignore ANSI escape codes
+ * when computing padding.
+ */
+/**
+ * Returns the printable character count of a string, ignoring any
+ * embedded ANSI escape sequences. Required for correct padding when
+ * chalk-coloured content is placed inside fixed-width box rows.
+ */
+export declare function visibleLength(str: string): number;
+/**
+ * Width of the horizontal rule (═ characters) between the two corner
+ * glyphs. All box-drawing functions share this constant so panels
+ * remain consistent across commands.
+ */
+export declare const BOX_RULE_WIDTH = 60;
+/** Renders the top border of a CHIEF panel: ╔══...══╗ */
+export declare function boxTop(): string;
+/** Renders an internal section divider: ╠══...══╣ */
+export declare function boxDivider(): string;
+/** Renders the bottom border of a CHIEF panel: ╚══...══╝ */
+export declare function boxBottom(): string;
+/**
+ * Renders a single content row inside a CHIEF panel.
+ *
+ * The content string may contain chalk ANSI codes. Padding is calculated
+ * using visibleLength so the right border aligns correctly regardless of
+ * colour codes embedded in the content.
+ *
+ * @param content - The text to display, optionally chalk-coloured.
+ * @param indent  - Leading spaces inside the left border. Defaults to 2.
+ */
+export declare function boxRow(content: string, indent?: number): string;
+/** Renders an empty row (blank line inside the panel). */
+export declare function boxEmpty(): string;
+/**
+ * Formats a Date into the header display string used in CHIEF panels:
+ * "Saturday March 7"
+ */
+export declare function formatHeaderDate(date: Date): string;
+/**
+ * Formats an ISO timestamp into a concise human-readable label
+ * suitable for the LAST RUNS section of helm status.
+ *
+ * - Same calendar day → "today H:mm a"
+ * - Previous calendar day → "yesterday"
+ * - Older → "N days ago"
+ * - Empty/missing → "never"
+ */
+export declare function formatLastRun(isoTimestamp: string | undefined): string;
+/**
+ * Left-pads a string to a target visible width.
+ * Safe for chalk-coloured strings.
+ */
+export declare function padEnd(str: string, targetWidth: number): string;
+/**
+ * Truncates a string to a maximum visible width, appending "…" if
+ * truncation occurred. Safe for plain strings only (no ANSI codes).
+ */
+export declare function truncate(str: string, maxWidth: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAID;;;;GAIG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,yDAAyD;AACzD,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,qDAAqD;AACrD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,CAI1D;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAOtE;AAID;;;GAGG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9D"}

package/dist/utils/format.js

@@ -0,0 +1,107 @@
+/**
+ * @file Terminal output formatting utilities.
+ *
+ * Covers date/time display, string padding, and the box-drawing
+ * primitives used to render the CHIEF bordered panels (helm status,
+ * helm sync output). All box-drawing functions accept chalk-coloured
+ * strings and use visible-length calculation to ignore ANSI escape codes
+ * when computing padding.
+ */
+import { format, formatDistanceToNow, isToday, isYesterday } from "date-fns";
+// ─── ANSI / Visible Length ────────────────────────────────────────────────────
+/** Regex that matches all ANSI CSI escape sequences (colour, style, etc.). */
+const ANSI_ESCAPE_RE = /\x1B\[[0-9;]*m/g;
+/**
+ * Returns the printable character count of a string, ignoring any
+ * embedded ANSI escape sequences. Required for correct padding when
+ * chalk-coloured content is placed inside fixed-width box rows.
+ */
+export function visibleLength(str) {
+    return str.replace(ANSI_ESCAPE_RE, "").length;
+}
+// ─── Box Drawing ─────────────────────────────────────────────────────────────
+/**
+ * Width of the horizontal rule (═ characters) between the two corner
+ * glyphs. All box-drawing functions share this constant so panels
+ * remain consistent across commands.
+ */
+export const BOX_RULE_WIDTH = 60;
+/** Renders the top border of a CHIEF panel: ╔══...══╗ */
+export function boxTop() {
+    return `╔${"═".repeat(BOX_RULE_WIDTH)}╗`;
+}
+/** Renders an internal section divider: ╠══...══╣ */
+export function boxDivider() {
+    return `╠${"═".repeat(BOX_RULE_WIDTH)}╣`;
+}
+/** Renders the bottom border of a CHIEF panel: ╚══...══╝ */
+export function boxBottom() {
+    return `╚${"═".repeat(BOX_RULE_WIDTH)}╝`;
+}
+/**
+ * Renders a single content row inside a CHIEF panel.
+ *
+ * The content string may contain chalk ANSI codes. Padding is calculated
+ * using visibleLength so the right border aligns correctly regardless of
+ * colour codes embedded in the content.
+ *
+ * @param content - The text to display, optionally chalk-coloured.
+ * @param indent  - Leading spaces inside the left border. Defaults to 2.
+ */
+export function boxRow(content, indent = 2) {
+    const inner = `${" ".repeat(indent)}${content}`;
+    const pad = BOX_RULE_WIDTH - visibleLength(inner);
+    return `║${inner}${" ".repeat(Math.max(0, pad))}║`;
+}
+/** Renders an empty row (blank line inside the panel). */
+export function boxEmpty() {
+    return boxRow("");
+}
+// ─── Date / Time ─────────────────────────────────────────────────────────────
+/**
+ * Formats a Date into the header display string used in CHIEF panels:
+ * "Saturday March 7"
+ */
+export function formatHeaderDate(date) {
+    return format(date, "EEEE MMMM d");
+}
+/**
+ * Formats an ISO timestamp into a concise human-readable label
+ * suitable for the LAST RUNS section of helm status.
+ *
+ * - Same calendar day → "today H:mm a"
+ * - Previous calendar day → "yesterday"
+ * - Older → "N days ago"
+ * - Empty/missing → "never"
+ */
+export function formatLastRun(isoTimestamp) {
+    if (!isoTimestamp)
+        return "never";
+    const date = new Date(isoTimestamp);
+    if (isNaN(date.getTime()))
+        return "never";
+    if (isToday(date))
+        return `today ${format(date, "h:mm a")}`;
+    if (isYesterday(date))
+        return "yesterday";
+    return formatDistanceToNow(date, { addSuffix: true });
+}
+// ─── String Helpers ───────────────────────────────────────────────────────────
+/**
+ * Left-pads a string to a target visible width.
+ * Safe for chalk-coloured strings.
+ */
+export function padEnd(str, targetWidth) {
+    const pad = targetWidth - visibleLength(str);
+    return pad > 0 ? `${str}${" ".repeat(pad)}` : str;
+}
+/**
+ * Truncates a string to a maximum visible width, appending "…" if
+ * truncation occurred. Safe for plain strings only (no ANSI codes).
+ */
+export function truncate(str, maxWidth) {
+    if (str.length <= maxWidth)
+        return str;
+    return `${str.slice(0, maxWidth - 1)}…`;
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @file Structured logger for HELM.
+ *
+ * Wraps console output with log levels and prefixes. The logger is
+ * intentionally simple — HELM is a CLI tool, not a long-running service.
+ * Its primary purpose is to provide a single interception point so that:
+ *
+ *   1. Debug output can be suppressed in normal use.
+ *   2. Secret values are never accidentally surfaced (secret-aware code
+ *      must never pass secret values to any logger method).
+ *   3. Log output format is consistent across all commands.
+ *
+ * Log level is controlled by the HELM_LOG environment variable:
+ *   - "debug" → all output
+ *   - "info"  → info, warn, error (default)
+ *   - "error" → errors only
+ *   - "silent" → no output (useful in tests)
+ */
+/** Emits a debug-level message. Suppressed unless HELM_LOG=debug. */
+export declare function debug(message: string): void;
+/**
+ * Emits an informational message to stderr.
+ * Do not use for user-facing panel output — use console.log directly
+ * with chalk formatting for those.
+ */
+export declare function info(message: string): void;
+/** Emits a warning to stderr. */
+export declare function warn(message: string): void;
+/**
+ * Emits an error message to stderr.
+ * For HelmErrors, use formatHelmError() and print via console.error
+ * in the top-level handler — not this function.
+ */
+export declare function error(message: string): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA4BH,qEAAqE;AACrE,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI3C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI1C;AAED,iCAAiC;AACjC,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI1C;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI3C"}

package/dist/utils/logger.js

@@ -0,0 +1,71 @@
+/**
+ * @file Structured logger for HELM.
+ *
+ * Wraps console output with log levels and prefixes. The logger is
+ * intentionally simple — HELM is a CLI tool, not a long-running service.
+ * Its primary purpose is to provide a single interception point so that:
+ *
+ *   1. Debug output can be suppressed in normal use.
+ *   2. Secret values are never accidentally surfaced (secret-aware code
+ *      must never pass secret values to any logger method).
+ *   3. Log output format is consistent across all commands.
+ *
+ * Log level is controlled by the HELM_LOG environment variable:
+ *   - "debug" → all output
+ *   - "info"  → info, warn, error (default)
+ *   - "error" → errors only
+ *   - "silent" → no output (useful in tests)
+ */
+/** Ordered log levels — higher index means less verbose. */
+const LEVELS = ["debug", "info", "warn", "error", "silent"];
+function resolveLevel() {
+    const raw = process.env["HELM_LOG"]?.toLowerCase();
+    if (raw && LEVELS.includes(raw)) {
+        return raw;
+    }
+    return "info";
+}
+function levelIndex(level) {
+    return LEVELS.indexOf(level);
+}
+const activeLevel = resolveLevel();
+/**
+ * Returns true if the given level should produce output given the
+ * currently configured log level.
+ */
+function isEnabled(level) {
+    return levelIndex(level) >= levelIndex(activeLevel);
+}
+/** Emits a debug-level message. Suppressed unless HELM_LOG=debug. */
+export function debug(message) {
+    if (isEnabled("debug")) {
+        process.stderr.write(`[debug] ${message}\n`);
+    }
+}
+/**
+ * Emits an informational message to stderr.
+ * Do not use for user-facing panel output — use console.log directly
+ * with chalk formatting for those.
+ */
+export function info(message) {
+    if (isEnabled("info")) {
+        process.stderr.write(`[info]  ${message}\n`);
+    }
+}
+/** Emits a warning to stderr. */
+export function warn(message) {
+    if (isEnabled("warn")) {
+        process.stderr.write(`[warn]  ${message}\n`);
+    }
+}
+/**
+ * Emits an error message to stderr.
+ * For HelmErrors, use formatHelmError() and print via console.error
+ * in the top-level handler — not this function.
+ */
+export function error(message) {
+    if (isEnabled("error")) {
+        process.stderr.write(`[error] ${message}\n`);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,4DAA4D;AAC5D,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAU,CAAC;AAGrE,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IACnD,IAAI,GAAG,IAAK,MAA4B,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,GAAe,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,KAAe;IACjC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,WAAW,GAAa,YAAY,EAAE,CAAC;AAE7C;;;GAGG;AACH,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;AACtD,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,IAAI,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,IAAI,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,IAAI,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,OAAe;IACnC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,IAAI,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "chief-helm",
+  "version": "0.1.1",
+  "description": "CLI for CHIEF — Personal AI Operations System",
+  "type": "module",
+  "bin": {
+    "helm": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build",
+    "format": "prettier --write src/**/*.{ts,tsx}"
+  },
+  "dependencies": {
+    "@inkjs/ui": "^2.0.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "conf": "^13.0.1",
+    "date-fns": "^3.6.0",
+    "execa": "^9.3.0",
+    "gray-matter": "^4.0.3",
+    "ink": "^5.1.4",
+    "inquirer": "^13.3.0",
+    "js-yaml": "^4.1.0",
+    "keytar": "^7.9.0",
+    "open": "^10.1.0",
+    "ora": "^8.0.1",
+    "react": "^18.3.1",
+    "simple-git": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.14.0",
+    "@types/react": "^18.3.3",
+    "prettier": "^3.3.3",
+    "tsx": "^4.16.2",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5"
+  }
+}