harnery 0.0.1 → 0.2.0

package/dist/lib/completion/zsh.js

@@ -0,0 +1,249 @@
+/**
+ * Zsh completion generator. Emits a single `#compdef <bin>` script that uses
+ * `_arguments -C` for nested-subcommand parsing and supports descriptions
+ * inline (the main zsh-over-bash win). The bin name is injected by the caller.
+ *
+ * Architecture mirrors bash.ts:
+ *   - Static tables for subcommands + options keyed by path
+ *   - `<bin> __complete <provider>` callback for dynamic values
+ *   - Driver function walks $words to determine the current command path
+ */
+/** Derive a valid shell function-name prefix from the bin name. */
+function fnPrefix(binName) {
+    return `_${binName.replace(/[^a-zA-Z0-9_]/g, "_")}`;
+}
+function valueSpec(opt) {
+    if (opt.dynamicProvider)
+        return `DYN:${opt.dynamicProvider}`;
+    if (opt.valueChoices && opt.valueChoices.length > 0) {
+        return `ENUM:${opt.valueChoices.join(" ")}`;
+    }
+    return "";
+}
+/** Escape a string for single-quoted zsh string. Same rule as bash. */
+function zshEscape(s) {
+    return s.replace(/'/g, `'\\''`);
+}
+function zshPath(path) {
+    return path === "" ? "ROOT" : path.replace(/ /g, "__");
+}
+export function generateZsh(root, binName) {
+    const fn = fnPrefix(binName);
+    const subcommandsByPath = new Map();
+    const optionsByPath = new Map();
+    const positionalsByPath = new Map();
+    const walk = (s) => {
+        subcommandsByPath.set(s.path, s.subcommands
+            .map((c) => ({ name: c.name, description: c.description }))
+            .sort((a, b) => a.name.localeCompare(b.name)));
+        optionsByPath.set(s.path, s.options);
+        positionalsByPath.set(s.path, s.positionals);
+        for (const sub of s.subcommands)
+            walk(sub);
+    };
+    walk(root);
+    const out = [];
+    out.push(`#compdef ${binName}`);
+    out.push(`# ${binName} zsh completion, generated by \`${binName} completion zsh\`. Do not edit.`);
+    out.push(`# Source via:  eval "$(${binName} completion zsh)"`);
+    out.push("");
+    out.push(`${fn}_subcommands_with_desc() {`);
+    out.push(`  case "$1" in`);
+    for (const [path, subs] of [...subcommandsByPath.entries()].sort()) {
+        if (subs.length === 0)
+            continue;
+        const lines = subs.map((s) => `'${zshEscape(s.name)}:${zshEscape(truncate(s.description, 80))}'`);
+        out.push(`    ${zshPath(path)}) print -l ${lines.join(" ")} ;;`);
+    }
+    out.push("  esac");
+    out.push("}");
+    out.push("");
+    out.push(`${fn}_options_with_desc() {`);
+    out.push(`  case "$1" in`);
+    for (const [path, opts] of [...optionsByPath.entries()].sort()) {
+        if (opts.length === 0)
+            continue;
+        const lines = [];
+        for (const o of opts) {
+            const flags = [o.long, o.short].filter((f) => f.length > 0);
+            for (const flag of flags) {
+                lines.push(`'${zshEscape(flag)}:${zshEscape(truncate(o.description, 80))}'`);
+            }
+        }
+        out.push(`    ${zshPath(path)}) print -l ${lines.join(" ")} ;;`);
+    }
+    out.push("  esac");
+    out.push("}");
+    out.push("");
+    out.push(`${fn}_option_takes_value() {`);
+    out.push(`  case "$1|$2" in`);
+    for (const [path, opts] of [...optionsByPath.entries()].sort()) {
+        for (const o of opts) {
+            if (!o.takesValue)
+                continue;
+            for (const flag of [o.long, o.short].filter((f) => f.length > 0)) {
+                out.push(`    ${zshPath(path)}\\|${zshEscape(flag)}) echo 1 ;;`);
+            }
+        }
+    }
+    out.push("  esac");
+    out.push("}");
+    out.push("");
+    out.push(`${fn}_option_value_spec() {`);
+    out.push(`  case "$1|$2" in`);
+    for (const [path, opts] of [...optionsByPath.entries()].sort()) {
+        for (const o of opts) {
+            if (!o.takesValue)
+                continue;
+            const spec = valueSpec(o);
+            if (!spec)
+                continue;
+            for (const flag of [o.long, o.short].filter((f) => f.length > 0)) {
+                out.push(`    ${zshPath(path)}\\|${zshEscape(flag)}) echo '${zshEscape(spec)}' ;;`);
+            }
+        }
+    }
+    out.push("  esac");
+    out.push("}");
+    out.push("");
+    out.push(`${fn}_positional_value_spec() {`);
+    out.push(`  case "$1|$2" in`);
+    for (const [path, positionals] of [...positionalsByPath.entries()].sort()) {
+        positionals.forEach((p, i) => {
+            const spec = valueSpec(p);
+            if (!spec)
+                return;
+            out.push(`    ${zshPath(path)}\\|${i}) echo '${zshEscape(spec)}' ;;`);
+        });
+    }
+    out.push("  esac");
+    out.push("}");
+    out.push("");
+    out.push(zshDriver(fn, binName));
+    out.push("");
+    out.push(`compdef ${fn} ${binName}`);
+    return `${out.join("\n")}\n`;
+}
+function truncate(s, n) {
+    if (!s)
+        return "";
+    return s.length > n ? `${s.slice(0, n - 1)}…` : s;
+}
+/**
+ * The driver walks `$words` to determine the current command path, then
+ * dispatches to subcommand / option / value completion. `fn` is the
+ * function-name prefix; `binName` is the CLI name for the `__complete` callback.
+ */
+function zshDriver(fn, binName) {
+    return `${fn}() {
+  local cur prev path_str path_parts
+  local -a words
+  words=( "\${(@)words}" )
+  local cword=$CURRENT
+  cur="\${words[$cword]}"
+  prev="\${words[$((cword-1))]}"
+
+  # Walk words[2..cword-1] (zsh is 1-indexed; words[1] is the bin) to determine path.
+  path_str="ROOT"
+  local -a path_parts
+  local i=2
+  while [ $i -lt $cword ]; do
+    local w="\${words[$i]}"
+    case "$w" in
+      -*)
+        if [ "$(${fn}_option_takes_value "$path_str" "$w")" = "1" ]; then
+          i=$((i+1))
+        fi
+        ;;
+      *)
+        path_parts+=("$w")
+        local joined="\${(j:__:)path_parts}"
+        local known
+        known=$(${fn}_subcommands_with_desc "$path_str" | awk -F: '{print $1}' | tr -d "'")
+        if [[ " $known " == *" $w "* ]]; then
+          path_str="$joined"
+        fi
+        ;;
+    esac
+    i=$((i+1))
+  done
+
+  # Case 1: prev is an option that takes a value.
+  if [ -n "$prev" ] && [ "$(${fn}_option_takes_value "$path_str" "$prev")" = "1" ]; then
+    local spec=$(${fn}_option_value_spec "$path_str" "$prev")
+    ${fn}_emit_values "$spec" "$cur"
+    return
+  fi
+
+  # Case 2: completing an option (cur starts with -).
+  if [[ "$cur" == -* ]]; then
+    local -a opt_descs
+    opt_descs=( \${(f)"$(${fn}_options_with_desc "$path_str")"} )
+    if [ \${#opt_descs[@]} -gt 0 ]; then
+      _describe 'options' opt_descs
+    fi
+    return
+  fi
+
+  # Case 3: subcommands at this level.
+  local -a sub_descs
+  sub_descs=( \${(f)"$(${fn}_subcommands_with_desc "$path_str")"} )
+  if [ \${#sub_descs[@]} -gt 0 ]; then
+    _describe 'subcommands' sub_descs
+    return
+  fi
+
+  # Case 4: positional value. Count non-option, non-subcommand words after path.
+  local after_cmd=0
+  local seen_path="ROOT"
+  local j=2
+  while [ $j -lt $cword ]; do
+    local w="\${words[$j]}"
+    case "$w" in
+      -*)
+        if [ "$(${fn}_option_takes_value "$seen_path" "$w")" = "1" ]; then
+          j=$((j+1))
+        fi
+        ;;
+      *)
+        local joined
+        if [ "$seen_path" = "ROOT" ]; then joined="$w"; else joined="\${seen_path}__\${w}"; fi
+        local known
+        known=$(${fn}_subcommands_with_desc "$seen_path" | awk -F: '{print $1}' | tr -d "'")
+        if [[ " $known " == *" $w "* ]]; then
+          seen_path="$joined"
+        else
+          after_cmd=$((after_cmd+1))
+        fi
+        ;;
+    esac
+    j=$((j+1))
+  done
+
+  local pos_spec=$(${fn}_positional_value_spec "$path_str" "$after_cmd")
+  if [ -n "$pos_spec" ]; then
+    ${fn}_emit_values "$pos_spec" "$cur"
+    return
+  fi
+
+  _files
+}
+
+${fn}_emit_values() {
+  local spec="$1"
+  local cur="$2"
+  if [[ "$spec" == DYN:* ]]; then
+    local provider="\${spec#DYN:}"
+    local -a values
+    values=( \${(f)"$(${binName} __complete "$provider" -- "$cur" 2>/dev/null)"} )
+    if [ \${#values[@]} -gt 0 ]; then
+      compadd -a values
+    fi
+  elif [[ "$spec" == ENUM:* ]]; then
+    local choices="\${spec#ENUM:}"
+    local -a values
+    values=( \${(s: :)choices} )
+    compadd -a values
+  fi
+}`;
+}

package/dist/lib/context/index.d.ts

@@ -0,0 +1,107 @@
+interface SubmoduleStatus {
+    name: string;
+    branch: string;
+    ahead: number;
+    behind: number;
+    dirty: boolean;
+    modifiedFiles: number;
+    untrackedFiles: number;
+}
+/**
+ * `harn context`: one-shot orientation snapshot for session start / post-compaction
+ * recovery / subagent dispatch. Aggregates self / time / repo / commits / submodules
+ * / peers, plus opt-in services. Fail-open per section so a missing dependency
+ * never blocks the rest from rendering.
+ *
+ * No process spawns for default sections except git; every other source is
+ * filesystem-direct via existing lib helpers.
+ */
+export type SectionName = "self" | "time" | "repo" | "commits" | "submodules" | "peers" | "services";
+export declare const DEFAULT_SECTIONS: SectionName[];
+export declare const OPT_IN_SECTIONS: SectionName[];
+export interface ContextOptions {
+    sections?: SectionName[];
+    include?: SectionName[];
+    showClean?: boolean;
+    /** Monorepo root for git ops. Defaults to process.cwd() when omitted. */
+    repoRoot?: string;
+    /** Submodule names relative to repoRoot. When omitted, submodules section reports an error. */
+    submodules?: readonly string[];
+}
+export interface ContextReport {
+    self?: SelfSection | {
+        error: string;
+    };
+    time?: TimeSection;
+    repo?: RepoSection | {
+        error: string;
+    };
+    commits?: CommitsSection | {
+        error: string;
+    };
+    submodules?: SubmodulesSection | {
+        error: string;
+    };
+    peers?: PeersSection | {
+        error: string;
+    };
+    services?: ServicesSection | {
+        error: string;
+    };
+    meta: {
+        elapsed_ms: number;
+        sections_requested: SectionName[];
+    };
+}
+export interface SelfSection {
+    name: string | null;
+    instance_id: string;
+    session_age_secs: number;
+    task: string | null;
+    last_tool: string | null;
+    last_tool_target: string | null;
+    files_held: string[];
+}
+export interface TimeSection {
+    chicago: string;
+    utc: string;
+}
+export interface RepoSection {
+    cwd: string;
+    branch: string;
+    ahead: number;
+    behind: number;
+    modified: number;
+    untracked: number;
+    staged: number;
+}
+export interface CommitsSection {
+    rows: {
+        sha: string;
+        subject: string;
+    }[];
+}
+export interface SubmodulesSection {
+    rows: SubmoduleStatus[];
+    clean_omitted: number;
+}
+export interface PeersSection {
+    rows: {
+        name: string;
+        instance_id_short: string;
+        age_min: number;
+        files: number;
+        last_tool: string | null;
+        task: string | null;
+    }[];
+}
+export interface ServicesSection {
+    docker_compose: {
+        project: string;
+        service: string;
+        status: string;
+    }[];
+}
+export declare function buildContext(opts?: ContextOptions): Promise<ContextReport>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/context/index.d.ts.map

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

package/dist/lib/context/index.js

@@ -0,0 +1,275 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { monorepoRoot, readHeartbeat, resolveOwner, } from "../../core/agents/index.js";
+import { exec } from "../exec.js";
+import { NO_DATA } from "../format.js";
+export const DEFAULT_SECTIONS = [
+    "self",
+    "time",
+    "repo",
+    "commits",
+    "submodules",
+    "peers",
+];
+export const OPT_IN_SECTIONS = ["services"];
+export async function buildContext(opts = {}) {
+    const started = Date.now();
+    const requested = new Set(opts.sections ?? DEFAULT_SECTIONS);
+    for (const s of opts.include ?? [])
+        requested.add(s);
+    const report = {
+        meta: {
+            elapsed_ms: 0,
+            sections_requested: Array.from(requested),
+        },
+    };
+    const repoRoot = opts.repoRoot ?? process.cwd();
+    const submodules = opts.submodules ?? null;
+    if (requested.has("self"))
+        report.self = await safe(() => buildSelf());
+    if (requested.has("time"))
+        report.time = buildTime();
+    if (requested.has("repo"))
+        report.repo = await safe(() => buildRepo(repoRoot));
+    if (requested.has("commits"))
+        report.commits = await safe(() => buildCommits(repoRoot));
+    if (requested.has("submodules")) {
+        report.submodules = await safe(() => buildSubmodules(!!opts.showClean, repoRoot, submodules));
+    }
+    if (requested.has("peers"))
+        report.peers = await safe(() => buildPeers());
+    if (requested.has("services"))
+        report.services = await safe(() => buildServices(repoRoot));
+    report.meta.elapsed_ms = Date.now() - started;
+    return report;
+}
+// ─── Sections ──────────────────────────────────────────────────────────────
+function buildSelf() {
+    const owner = resolveOwner();
+    if (!owner)
+        throw new Error("not in an agent session (no pid-map entry)");
+    const hb = readHeartbeat(owner);
+    if (!hb)
+        throw new Error(`pid-map resolved owner=${owner.slice(0, 8)}… but no heartbeat`);
+    const startedMs = Date.parse(hb.started_at);
+    const ageSecs = Number.isFinite(startedMs)
+        ? Math.max(0, Math.floor((Date.now() - startedMs) / 1000))
+        : 0;
+    return {
+        name: hb.name ?? null,
+        instance_id: hb.instance_id,
+        session_age_secs: ageSecs,
+        task: hb.task ?? null,
+        last_tool: hb.last_tool ?? null,
+        last_tool_target: hb.last_tool_target ?? null,
+        files_held: hb.files_touched ?? [],
+    };
+}
+function buildTime() {
+    const now = new Date();
+    return {
+        chicago: formatChicago(now),
+        utc: now.toISOString(),
+    };
+}
+async function buildRepo(repoRoot) {
+    const [branchResult, statusResult, aheadBehindResult] = await Promise.all([
+        exec(["git", "rev-parse", "--abbrev-ref", "HEAD"], { cwd: repoRoot }),
+        // trim:false, since porcelain's first line of ` M PATH` would lose its leading
+        // space and shift the X/Y status columns, miscounting staged vs modified.
+        exec(["git", "status", "--porcelain"], { cwd: repoRoot, trim: false }),
+        exec(["git", "rev-list", "--left-right", "--count", "HEAD...@{upstream}"], { cwd: repoRoot }),
+    ]);
+    const branch = branchResult.stdout || "detached";
+    const statusLines = statusResult.stdout ? statusResult.stdout.split("\n") : [];
+    let modified = 0;
+    let untracked = 0;
+    let staged = 0;
+    for (const line of statusLines) {
+        if (line.startsWith("??"))
+            untracked++;
+        else if (line.length >= 2) {
+            const x = line[0];
+            const y = line[1];
+            if (x !== " " && x !== "?")
+                staged++;
+            if (y !== " " && y !== "?")
+                modified++;
+        }
+    }
+    let ahead = 0;
+    let behind = 0;
+    if (aheadBehindResult.exitCode === 0) {
+        const parts = aheadBehindResult.stdout.split(/\s+/);
+        ahead = Number.parseInt(parts[0] ?? "0", 10);
+        behind = Number.parseInt(parts[1] ?? "0", 10);
+    }
+    return {
+        cwd: process.cwd(),
+        branch,
+        ahead,
+        behind,
+        modified,
+        untracked,
+        staged,
+    };
+}
+async function buildCommits(repoRoot) {
+    const result = await exec(["git", "log", "--oneline", "-3", "--no-decorate"], { cwd: repoRoot });
+    const rows = result.stdout
+        .split("\n")
+        .filter((l) => l.length > 0)
+        .map((l) => {
+        const idx = l.indexOf(" ");
+        if (idx < 0)
+            return { sha: l, subject: "" };
+        return { sha: l.slice(0, idx), subject: l.slice(idx + 1) };
+    });
+    return { rows };
+}
+async function buildSubmodules(showClean, repoRoot, submodules) {
+    if (!submodules || submodules.length === 0) {
+        throw new Error("no submodules configured (pass submodules via HarneryProgramContext)");
+    }
+    const all = await Promise.all(submodules.map(async (name) => statusFor(name, resolve(repoRoot, name))));
+    const rows = showClean ? all : all.filter((s) => s.dirty || s.ahead > 0 || s.behind > 0);
+    const cleanOmitted = showClean ? 0 : all.length - rows.length;
+    return { rows, clean_omitted: cleanOmitted };
+}
+async function statusFor(name, cwd) {
+    const empty = {
+        name,
+        branch: NO_DATA,
+        ahead: 0,
+        behind: 0,
+        dirty: false,
+        modifiedFiles: 0,
+        untrackedFiles: 0,
+    };
+    if (!existsSync(cwd))
+        return empty;
+    const [branchR, statusR, abR] = await Promise.all([
+        exec(["git", "rev-parse", "--abbrev-ref", "HEAD"], { cwd }),
+        exec(["git", "status", "--porcelain"], { cwd, trim: false }),
+        exec(["git", "rev-list", "--left-right", "--count", "HEAD...@{upstream}"], { cwd }),
+    ]);
+    let modified = 0;
+    let untracked = 0;
+    for (const line of statusR.stdout.split("\n")) {
+        if (line.startsWith("??"))
+            untracked++;
+        else if (line.length >= 2)
+            modified++;
+    }
+    const [aheadS, behindS] = abR.stdout.split("\t");
+    return {
+        name,
+        branch: branchR.stdout || "detached",
+        ahead: Number.parseInt(aheadS ?? "0", 10) || 0,
+        behind: Number.parseInt(behindS ?? "0", 10) || 0,
+        dirty: modified + untracked > 0,
+        modifiedFiles: modified,
+        untrackedFiles: untracked,
+    };
+}
+function buildPeers() {
+    const root = monorepoRoot();
+    if (!root)
+        throw new Error("coord_root() returned null");
+    const activeDir = resolve(root, ".harnery", "active");
+    if (!existsSync(activeDir))
+        return { rows: [] };
+    const myOwner = resolveOwner();
+    // No freshness filter; matches the SessionStart/UserPromptSubmit snapshot.
+    // Stale entries get swept by the SessionStart janitor on the next session start.
+    const rows = [];
+    for (const f of readdirSync(activeDir)) {
+        if (!f.endsWith(".json"))
+            continue;
+        try {
+            const hb = JSON.parse(readFileSync(resolve(activeDir, f), "utf8"));
+            if (!hb || typeof hb.instance_id !== "string")
+                continue;
+            if (hb.instance_id === myOwner)
+                continue;
+            if ((hb.kind ?? "") === "transient")
+                continue;
+            const startedMs = Date.parse(hb.started_at);
+            const ageMin = Number.isFinite(startedMs) ? Math.floor((Date.now() - startedMs) / 60000) : 0;
+            rows.push({
+                name: hb.name ?? "unknown",
+                instance_id_short: hb.instance_id.slice(0, 8),
+                age_min: ageMin,
+                files: hb.files_touched?.length ?? 0,
+                last_tool: hb.last_tool ?? null,
+                task: hb.task ?? null,
+            });
+        }
+        catch {
+            // skip
+        }
+    }
+    // Sort: file-holders first (more activity), then by recency (younger age first).
+    rows.sort((a, b) => b.files - a.files || a.age_min - b.age_min);
+    return { rows };
+}
+async function buildServices(repoRoot) {
+    // Probe common compose-file locations at the repo root.
+    const candidates = [
+        resolve(repoRoot, "docker-compose.yml"),
+        resolve(repoRoot, "compose.yml"),
+        resolve(repoRoot, "compose.yaml"),
+    ];
+    const composePath = candidates.find((p) => existsSync(p));
+    if (!composePath) {
+        return { docker_compose: [] };
+    }
+    const result = await exec(["docker", "compose", "-f", composePath, "ps", "--format", "json"], {
+        cwd: repoRoot,
+        timeout: 5000,
+    });
+    if (result.exitCode !== 0) {
+        throw new Error(result.stderr || `docker compose ps exited ${result.exitCode}`);
+    }
+    // `docker compose ps --format json` emits one JSON object per line.
+    const items = [];
+    for (const line of result.stdout.split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            const obj = JSON.parse(line);
+            items.push({
+                project: obj.Project ?? "",
+                service: obj.Service ?? "",
+                status: obj.Status ?? obj.State ?? "",
+            });
+        }
+        catch {
+            // tolerate non-JSON banner lines
+        }
+    }
+    return { docker_compose: items };
+}
+// ─── Helpers ───────────────────────────────────────────────────────────────
+async function safe(fn) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        return { error: err.message };
+    }
+}
+const CHICAGO_FORMATTER = new Intl.DateTimeFormat("en-US", {
+    weekday: "short",
+    year: "numeric",
+    month: "short",
+    day: "numeric",
+    hour: "numeric",
+    minute: "2-digit",
+    timeZoneName: "short",
+    hour12: true,
+    timeZone: "America/Chicago",
+});
+function formatChicago(d) {
+    return CHICAGO_FORMATTER.format(d);
+}