@indigoai-us/hq-cli 5.313.0 → 5.314.0

package/dist/commands/core-pin-native.js

@@ -1,236 +0,0 @@
-/** Native per-session pin implementation matching core/scripts/hq-pin.sh. */
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-import { resolveLiveRoot } from "../utils/hq-roots.js";
-import { bundledShellUnboundValue, registerNativeUtility, utilityError } from "./core-native-utilities.js";
-export const PIN_ASSET = "core/scripts/hq-pin.sh";
-export const PIN_HELP = `# hq-pin.sh — anchor the current session to one goal (the "pin").
-#
-# A pin is the message, goal, or target the session keeps working toward
-# across loops, wakeups, compactions, and hand-offs. It is stored per session
-# and re-read at every checkpoint so the session cannot drift.
-#
-# Usage:
-#   core/scripts/hq-pin.sh set  "<goal>" [--done "<criterion>"]... [--owner <name>] [--channel <dm-channel>]
-#   core/scripts/hq-pin.sh show                # print the pin (goal, done criteria, owner, channel, set-at)
-#   core/scripts/hq-pin.sh check               # print a one-line reminder for loop ticks; exit 3 if no pin
-#   core/scripts/hq-pin.sh note "<progress>"   # append a dated progress line under the pin
-#   core/scripts/hq-pin.sh clear               # remove the pin (the goal is met or withdrawn)
-#
-# Storage: workspace/sessions/<sid>/pin.md plus \`pin: <goal>\` in the session's
-`;
-const SESSION_ENV_KEYS = ["HQ_SESSION_ID", "CLAUDE_CODE_SESSION_ID", "CLAUDE_SESSION_ID", "CODEX_SESSION_ID", "CODEX_THREAD_ID", "GROK_SESSION_ID"];
-const stamp = (date) => date.toISOString().replace(/\.\d{3}Z$/, "Z");
-function normalizeId(value) { return value.replace(/[\t\n\v\f\r ]/g, ""); }
-function validId(value) { return value !== "" && value !== "." && value !== ".." && /^[A-Za-z0-9._-]+$/.test(value); }
-export function resolvePinSessionId(root, env) {
-    for (const key of SESSION_ENV_KEYS) {
-        const value = normalizeId(env[key] ?? "");
-        if (validId(value))
-            return value;
-    }
-    try {
-        const value = normalizeId(fs.readFileSync(path.join(root, "workspace/sessions/.current"), "utf8"));
-        return validId(value) ? value : "";
-    }
-    catch {
-        return "";
-    }
-}
-function pinPath(deps, sid) { return path.join(deps.root, "workspace/sessions", sid, "pin.md"); }
-function fail(message) { return utilityError(`hq-pin: ${message}`, 2); }
-function sessionMetaPath(deps, sid) { return path.join(deps.root, "workspace/sessions", sid, "meta.yaml"); }
-function writeSessionPin(deps, sid, goal) {
-    const meta = sessionMetaPath(deps, sid);
-    fs.mkdirSync(path.dirname(meta), { recursive: true });
-    let contents;
-    try {
-        contents = fs.readFileSync(meta, "utf8");
-    }
-    catch (error) {
-        if (error.code !== "ENOENT")
-            throw error;
-        contents = `session_id: ${sid}\nstarted_at: "${stamp(deps.now())}"\nsenior: user\n`;
-    }
-    const lines = contents ? contents.replace(/\n$/, "").split("\n") : [];
-    let found = false;
-    const next = lines.map((line) => {
-        if (line.trimStart().split(/[\t ]/)[0] === "pin:") {
-            found = true;
-            return `pin: ${goal}`;
-        }
-        return line;
-    });
-    if (!found)
-        next.push(`pin: ${goal}`);
-    const text = `${next.join("\n")}\n`;
-    const temp = path.join(path.dirname(meta), `.meta.yaml.${process.pid}.${Math.random().toString(16).slice(2)}.tmp`);
-    fs.writeFileSync(temp, text, { mode: 0o600 });
-    fs.renameSync(temp, meta);
-}
-function createPinDirectory(deps) {
-    const sid = resolvePinSessionId(deps.root, deps.env);
-    if (!sid)
-        return { error: fail("no current session (hq-session.sh current is empty)") };
-    const file = pinPath(deps, sid);
-    fs.mkdirSync(path.dirname(file), { recursive: true });
-    return { sid, file };
-}
-function setPin(args, deps) {
-    const goal = args[0] ?? "";
-    if (!goal)
-        return fail("set needs the goal text");
-    let owner = "";
-    let channel = "";
-    const done = [];
-    for (let i = 1; i < args.length;) {
-        const arg = args[i];
-        if (arg === "--done") {
-            if (i + 1 >= args.length)
-                return bundledShellUnboundValue(PIN_ASSET, 36);
-            done.push(args[i + 1]);
-            i += 2;
-        }
-        else if (arg === "--owner") {
-            if (i + 1 >= args.length)
-                return bundledShellUnboundValue(PIN_ASSET, 37);
-            owner = args[i + 1];
-            i += 2;
-        }
-        else if (arg === "--channel") {
-            if (i + 1 >= args.length)
-                return bundledShellUnboundValue(PIN_ASSET, 38);
-            channel = args[i + 1];
-            i += 2;
-        }
-        else
-            return fail(`set: unknown arg ${arg}`);
-    }
-    const current = createPinDirectory(deps);
-    if (current.error)
-        return current.error;
-    const lines = ["# Pin", "", `Goal: ${goal}`, "", `Set: ${stamp(deps.now())}`];
-    if (owner)
-        lines.push(`Owner: ${owner}`);
-    if (channel)
-        lines.push(`Channel: ${channel}`);
-    if (done.length > 0)
-        lines.push("", "## Done when", ...done.map((criterion) => `- [ ] ${criterion}`));
-    lines.push("", "## Progress");
-    fs.writeFileSync(current.file, `${lines.join("\n")}\n`, { encoding: "utf8", mode: 0o666 });
-    writeSessionPin(deps, current.sid, goal);
-    return { code: 0, stdout: `pinned session ${current.sid}: ${goal}\n`, stderr: "" };
-}
-function showPin(deps) {
-    const current = createPinDirectory(deps);
-    if (current.error)
-        return current.error;
-    if (!fs.existsSync(current.file))
-        return { code: 3, stdout: `no pin for session ${current.sid}\n`, stderr: "" };
-    return { code: 0, stdout: fs.readFileSync(current.file, "utf8"), stderr: "" };
-}
-function checkPin(deps) {
-    const current = createPinDirectory(deps);
-    if (current.error)
-        return current.error;
-    if (!fs.existsSync(current.file))
-        return { code: 3, stdout: "no pin\n", stderr: "" };
-    const text = fs.readFileSync(current.file, "utf8");
-    const goal = text.split(/\r?\n/).find((line) => line.startsWith("Goal: "))?.slice(6) ?? "";
-    const open = (text.match(/^- \[ \]/gm) ?? []).length;
-    const closed = (text.match(/^- \[x\]/gm) ?? []).length;
-    return { code: 0, stdout: `PIN: ${goal} (done criteria: ${closed} met, ${open} open)\n`, stderr: "" };
-}
-function notePin(args, deps) {
-    const text = args[0] ?? "";
-    if (!text)
-        return fail("note needs text");
-    const current = createPinDirectory(deps);
-    if (current.error)
-        return current.error;
-    if (!fs.existsSync(current.file))
-        return fail("no pin to note against");
-    const time = deps.now().toISOString().slice(11, 16);
-    fs.appendFileSync(current.file, `- ${time}Z ${text}\n`);
-    return { code: 0, stdout: "noted\n", stderr: "" };
-}
-function donePin(args, deps) {
-    const needle = args[0] ?? "";
-    if (!needle)
-        return fail("done needs a criterion substring");
-    const current = createPinDirectory(deps);
-    if (current.error)
-        return current.error;
-    if (!fs.existsSync(current.file))
-        return fail("no pin");
-    const text = fs.readFileSync(current.file, "utf8");
-    const lines = text.split("\n");
-    // Bash read ignores a final line without a newline. The shell script then
-    // echoes every line it did read, adding a newline to each one.
-    lines.pop();
-    let hit = false;
-    const next = lines.map((line) => {
-        if (line.startsWith("- [ ] ") && line.includes(needle)) {
-            hit = true;
-            // Preserve the bundled shell's parameter-expansion result: it keeps the
-            // matched source line after adding the checked marker.
-            return `- [x] ${line}`;
-        }
-        return line;
-    });
-    const output = next.length > 0 ? `${next.join("\n")}\n` : "";
-    const tempDir = fs.mkdtempSync(path.join(deps.tmpDir ?? os.tmpdir(), "hq-pin-"));
-    const tempFile = path.join(tempDir, "pin");
-    try {
-        fs.writeFileSync(tempFile, output, { encoding: "utf8", mode: 0o600, flag: "wx" });
-        try {
-            fs.renameSync(tempFile, current.file);
-        }
-        catch (error) {
-            if (error.code !== "EXDEV")
-                throw error;
-            fs.copyFileSync(tempFile, current.file);
-            fs.chmodSync(current.file, 0o600);
-            fs.unlinkSync(tempFile);
-        }
-    }
-    finally {
-        fs.rmSync(tempDir, { recursive: true, force: true });
-    }
-    return hit
-        ? { code: 0, stdout: `marked done: ${needle}\n`, stderr: "" }
-        : fail(`no open criterion matches: ${needle}`);
-}
-function clearPin(deps) {
-    const current = createPinDirectory(deps);
-    if (current.error)
-        return current.error;
-    fs.rmSync(current.file, { force: true });
-    writeSessionPin(deps, current.sid, "");
-    return { code: 0, stdout: "pin cleared\n", stderr: "" };
-}
-export function runPin(args, deps) {
-    const [command = "", ...rest] = args;
-    if (command === "set")
-        return setPin(rest, deps);
-    if (command === "show")
-        return showPin(deps);
-    if (command === "check")
-        return checkPin(deps);
-    if (command === "note")
-        return notePin(rest, deps);
-    if (command === "done")
-        return donePin(rest, deps);
-    if (command === "clear")
-        return clearPin(deps);
-    return { code: 2, stdout: PIN_HELP, stderr: "" };
-}
-export function registerCorePinNative(core) {
-    registerNativeUtility(core, {
-        name: "pin", asset: PIN_ASSET, root: "live", summary: "Pin the current session to one goal",
-        resolveRoot: (_cwd, hqRoot) => resolveLiveRoot({ hqRoot }),
-        run: (args, context) => runPin(args, context),
-    });
-}
-//# sourceMappingURL=core-pin-native.js.map

package/dist/commands/core-policy-frontmatter.d.ts

@@ -1,8 +0,0 @@
-export type FrontmatterResult = {
-    code: number;
-    stdout: Buffer;
-    stderr: Buffer;
-};
-/** Byte-preserving port of core/scripts/read-policy-frontmatter.sh. */
-export declare function runPolicyFrontmatter(args: readonly string[], cwd: string): FrontmatterResult;
-//# sourceMappingURL=core-policy-frontmatter.d.ts.map

package/dist/commands/core-policy-frontmatter.js

@@ -1,52 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-const USAGE = Buffer.from('USAGE: read-policy-frontmatter.sh <policy-file>\n');
-/** Byte-preserving port of core/scripts/read-policy-frontmatter.sh. */
-export function runPolicyFrontmatter(args, cwd) {
-    const first = args[0];
-    if (first === undefined)
-        return { code: 1, stdout: Buffer.alloc(0), stderr: USAGE };
-    const filePath = path.isAbsolute(first) ? first : path.resolve(cwd, first);
-    let source;
-    try {
-        fs.accessSync(filePath, fs.constants.R_OK);
-        source = fs.readFileSync(filePath);
-    }
-    catch (error) {
-        const code = error.code;
-        if (code === 'EISDIR') {
-            return {
-                code: 0,
-                stdout: Buffer.alloc(0),
-                stderr: Buffer.from(`awk: warning: command line argument \`${first}' is a directory: skipped\n`),
-            };
-        }
-        if (code === 'ENOENT' || code === 'ENOTDIR' || code === 'EACCES' || code === 'ELOOP') {
-            return {
-                code: 1,
-                stdout: Buffer.alloc(0),
-                stderr: Buffer.from(`ERROR: File not readable: ${first}\n`),
-            };
-        }
-        throw error;
-    }
-    const output = [];
-    let markers = 0;
-    let start = 0;
-    while (start < source.length) {
-        const end = source.indexOf(0x0a, start);
-        const lineEnd = end < 0 ? source.length : end;
-        const line = source.subarray(start, lineEnd);
-        if (line.length === 3 && line[0] === 0x2d && line[1] === 0x2d && line[2] === 0x2d) {
-            markers += 1;
-        }
-        else if (markers === 1) {
-            output.push(line, Buffer.from('\n'));
-        }
-        if (end < 0)
-            break;
-        start = end + 1;
-    }
-    return { code: 0, stdout: Buffer.concat(output), stderr: Buffer.alloc(0) };
-}
-//# sourceMappingURL=core-policy-frontmatter.js.map

package/dist/commands/core-policy.d.ts

@@ -1,14 +0,0 @@
-import type { Command } from 'commander';
-import { type FrontmatterResult } from './core-policy-frontmatter.js';
-export type CorePolicyResult = {
-    code: number;
-    stdout: Buffer;
-    stderr: Buffer;
-};
-export declare function runPolicyAgeReport(args: readonly string[], root: string, env?: NodeJS.ProcessEnv, nowEpoch?: number): CorePolicyResult;
-export declare function runPolicyFrontmatter(args: readonly string[], cwd: string): FrontmatterResult;
-export declare function runPolicyRetire(args: readonly string[], root: string, cwd: string, env?: NodeJS.ProcessEnv, now?: Date): CorePolicyResult;
-/** Fast-entry adapter; family gating and shell fallback happen before import. */
-export declare function runPolicyFast(args: readonly string[], _stdin: string, cwd: string, hqRoot: string | undefined, commandName: string): number;
-export declare function registerCorePolicyCommand(core: Command): void;
-//# sourceMappingURL=core-policy.d.ts.map