@indigoai-us/hq-cli 5.310.0 → 5.311.0

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

@@ -36,21 +36,6 @@ export declare const CHECKPOINT_REPLY_REMINDER: string;
  * demands the findings), so the conditional half still points there.
  */
 export declare const CHECKPOINT_IDLE_REPLY_REMINDER: string;
-/**
- * Kept in TypeScript rather than in a bundled asset: it is an instruction to
- * a locally-installed agent, not a scaffold script that should be packaged.
- */
-export declare const SIBLING_PROMPT_TEMPLATE = "You are the HQ checkpoint sibling \u2014 a background maintenance agent for this\nHQ install. Your parent session's state is in <payloadPath>. Work\nquietly and do not ask questions; if something is ambiguous, record it in the\nreport instead of guessing.\n\n1. Read the payload. If it lists a transcript path that exists, read its tail (~400 lines)\n   both for session context and to extract additional reusable learnings/insights\n   the parent did not pass explicitly. Never quote secrets\n   or tokens from the transcript. If .claude/skills/checkpoint/SKILL.md exists\n   under this HQ root, read it and follow it wherever it goes beyond these instructions;\n   the write bounds below always win over the skill text.\n2. Upgrade the thread file named in the payload IN PLACE: verify/repair its\n   JSON; fill git.remote_url, git.initial_commit, git.commits_made, and\n   git.knowledge_repos by scanning core/knowledge/public/*,\n   core/knowledge/private/*, personal/knowledge/*, and companies/*/knowledge\n   for symlinks or directories containing .git, recording dirty repositories\n   as {\"<name>\": {\"commit\": \"<short>\", \"dirty\": true}}. Fill worker,\n   next_steps, and insights; set type to \"checkpoint\"; then rename the file to\n   drop -auto- from its filename. Use the renamed path in every reference you\n   write afterwards.\n3. For every explicit or transcript-derived learning that is a reusable rule,\n   FIRST search the existing policies for one the learning refines, contradicts\n   or duplicates. Then take exactly one of these actions and name it in the\n   report \u2014 the policy set is curated, not append-only:\n   - AMEND an existing policy in place when the learning sharpens it, narrows\n     its scope, or adds a case, and the rule as written is still correct.\n   - SUPERSEDE it when the learning contradicts it: rewrite the rule to what is\n     now true and record inside the file what changed and why.\n   - MERGE near-duplicates into the single best-named file, then delete the\n     files you merged away.\n   - CREATE a new policy only when no existing policy covers the rule.\n   Follow core/knowledge/public/hq-core/policies-spec.md. Write under\n   personal/policies/ or, only when the payload names a company and the rule is\n   company-specific, companies/<company>/policies/.\n   DELETION BOUNDS: delete a policy only as the MERGE or SUPERSEDE step above,\n   only inside those two directories, and never one whose body marks it HARD \u2014\n   if a hard policy now looks wrong, leave it untouched and flag it in the\n   report for a human to decide. Never delete a file you have not read.\n   Apply the same curation to durable facts (not rules) under\n   personal/knowledge/ or companies/<company>/knowledge/: correct a stale fact\n   in place rather than appending a second, contradictory copy of it.\n   Store up to two explicit or transcript-derived insights per\n   core/knowledge/public/hq-core/insights-spec.md when present, otherwise\n   workspace/insights/.\n4. Close an active session journal fail-soft with\n   bash .claude/skills/_shared/journal.sh close \"<project_dir>\" \"<one-line synthesis>\".\n   Write a legacy checkpoint JSON under workspace/checkpoints/<id>.json with\n   id, created_at, summary, files, and next_steps for backward compatibility.\n5. Update workspace/threads/recent.md and regenerate\n   workspace/threads/INDEX.md. For each company whose knowledge path appears\n   in files_touched, regenerate companies/<company>/knowledge/INDEX.md under\n   core/knowledge/public/hq-core/index-md-spec.md. Mechanical index generation\n   is allowed for those companies, but knowledge/policy content writes remain\n   restricted to the payload's named company.\n<ontologyStep>6. Run .claude/skills/document-release/SKILL.md best-effort when it exists;\n   skip silently on any failure. Hook or automation improvements go ONLY under\n   personal/hooks/ as proposals.\n7. WRITE BOUNDS: you may write only under personal/, workspace/, and companies/<company>/ as constrained above. You must NEVER write into .claude/, core/, .agents/, .codex/, repos/, or anywhere outside the HQ root.\n8. Write <runDir>/report.md \u2014 full prose: what you read, what you changed\n   (paths), and what you skipped and why. List every policy or knowledge file\n   you amended, superseded, merged or deleted with the reason, so a human can\n   audit and reverse it; a deletion you do not name in the report is a defect.\n   Then drain the queue: while\n   workspace/checkpoints/sibling/pending.jsonl exists and is non-empty, claim\n   it atomically by renaming it aside \u2014\n   mv workspace/checkpoints/sibling/pending.jsonl <runDir>/pending-claimed-N.jsonl\n   (N counting up from 2) \u2014 and process the claimed payloads with this same\n   flow. Repeat until a claim finds nothing left, then update the report.\n   NEVER read the queue and truncate it in place: a payload appended between\n   your read and the truncate is lost, and its checkpoint is never enriched.\n";
-/**
- * Rendered into the sibling prompt only when the payload names a company. The
- * flag check happens inside `hq core ontology plan`, in the sibling, because
- * the checkpoint parent performs no network I/O. Only this run's own payload
- * gets the step. A queued payload's company files are recorded as queued
- * touches when it is queued (CO-59), and a later plan for that company takes
- * them while checkpoint.ontology.queued-touches is on; a run with no company
- * of its own gets the step for the company whose touches waited longest.
- */
-export declare const SIBLING_ONTOLOGY_STEP = "5b. ONTOLOGY (this run's own payload only; skip it for claimed queue payloads).\n   Run: hq core ontology plan --run-dir \"<runDir>\" --hq-root \"<hqRoot>\"\n   If it prints \"ontology: skipped\", do nothing more for this step. Otherwise\n   read <runDir>/ontology-plan.json, follow its \"instructions\" exactly, and\n   write <runDir>/ontology-candidates.json. Read only the files and line\n   ranges the plan lists. Then run:\n   hq core ontology apply --run-dir \"<runDir>\" --hq-root \"<hqRoot>\"\n   Never write under the company's ontology/ folder yourself, and never edit\n   payload.json or ontology-plan.json. Copy the command's one-line output into\n   the report. If either command fails, record the error and continue.\n";
 export declare function renderSiblingPrompt(runDir: string, payloadPath: string, options?: {
     company?: string | null;
     hqRoot?: string;
@@ -84,15 +69,6 @@ export declare function autoBackendPreference(preferGrok?: boolean): SpawnableBa
  * registry; a flag change takes effect from the checkpoint after the next plan.
  */
 export declare function companyPrefersGrok(liveRoot: string, companySlug: string | null | undefined): boolean;
-/**
- * Whether the maintenance sibling may run at all. The process environment wins
- * over the settings file, so a one-off `HQ_CHECKPOINT_AGENT=0 hq core
- * checkpoint …` still works and a host that exports the settings `env` block
- * (Claude Code does) agrees with a host that does not.
- */
-export declare function siblingEnabledBySetting(liveRoot: string): boolean;
-/** The sibling's environment: the caller's, minus lane identity. */
-export declare function siblingEnv(base: NodeJS.ProcessEnv, backend: SpawnableBackend): NodeJS.ProcessEnv;
 export declare function siblingArgs(backend: SpawnableBackend, prompt: string): string[];
 /** Attach the native checkpoint command to the hidden `hq core` group. */
 export declare function registerCoreCheckpointCommand(core: Command): void;

package/dist/commands/core-checkpoint.js

@@ -115,7 +115,7 @@ function printError(line) {
  * Kept in TypeScript rather than in a bundled asset: it is an instruction to
  * a locally-installed agent, not a scaffold script that should be packaged.
  */
-export const SIBLING_PROMPT_TEMPLATE = `You are the HQ checkpoint sibling — a background maintenance agent for this
+const SIBLING_PROMPT_TEMPLATE = `You are the HQ checkpoint sibling — a background maintenance agent for this
 HQ install. Your parent session's state is in <payloadPath>. Work
 quietly and do not ask questions; if something is ambiguous, record it in the
 report instead of guessing.
@@ -195,7 +195,7 @@ report instead of guessing.
  * them while checkpoint.ontology.queued-touches is on; a run with no company
  * of its own gets the step for the company whose touches waited longest.
  */
-export const SIBLING_ONTOLOGY_STEP = `5b. ONTOLOGY (this run's own payload only; skip it for claimed queue payloads).
+const SIBLING_ONTOLOGY_STEP = `5b. ONTOLOGY (this run's own payload only; skip it for claimed queue payloads).
    Run: hq core ontology plan --run-dir "<runDir>" --hq-root "<hqRoot>"
    If it prints "ontology: skipped", do nothing more for this step. Otherwise
    read <runDir>/ontology-plan.json, follow its "instructions" exactly, and
@@ -784,7 +784,7 @@ function resolveSwitchSetting(liveRoot, key) {
  * checkpoint …` still works and a host that exports the settings `env` block
  * (Claude Code does) agrees with a host that does not.
  */
-export function siblingEnabledBySetting(liveRoot) {
+function siblingEnabledBySetting(liveRoot) {
     return resolveSwitchSetting(liveRoot, SIBLING_SETTING) ?? true;
 }
 /** Rejects an unknown `--backend` without paying for the probe that resolves one. */
@@ -814,7 +814,7 @@ function resolveBackend(requested, liveRoot, company) {
  */
 const LANE_ENV_KEYS = ["HQ_LANE_ID", "HQ_PROJECT_ID", "HQ_STORY_ID", "HQ_POLICY_WORKER_DIR"];
 /** The sibling's environment: the caller's, minus lane identity. */
-export function siblingEnv(base, backend) {
+function siblingEnv(base, backend) {
     const vars = { ...base };
     for (const name of LANE_ENV_KEYS)
         delete vars[name];

package/dist/commands/core-command-catalog.js

@@ -46,7 +46,7 @@ export function fastScaffoldListingMismatches(listing, fastScripts) {
         else if (fast.kind === "shell" && listed.asset !== fast.asset) {
             mismatches.push(`${fast.name} lists ${listed.asset ?? "no asset"}, fast path uses ${fast.asset ?? "no asset"}`);
         }
-        else if (fast.kind === "native" && (listed.execution !== "native" ||
+        else if (fast.kind === "native" && ((listed.execution !== "native" && listed.execution !== "bundled-shell") ||
             (fast.asset === undefined ? listed.asset !== undefined : listed.asset !== fast.asset))) {
             mismatches.push(`${fast.name} has fast-route metadata that differs from the native command catalog`);
         }

package/dist/commands/core-hq-session-native.d.ts

@@ -0,0 +1,39 @@
+export declare const HQ_SESSION_ASSET = "core/scripts/hq-session.sh";
+export declare const HQ_SESSION_HELP: string;
+export type HqSessionResult = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+export type HqSessionDependencies = {
+    env: NodeJS.ProcessEnv;
+    now: () => Date;
+    readFile: (filePath: string, encoding: BufferEncoding) => string;
+    exists: (filePath: string) => boolean;
+    isFile: (filePath: string) => boolean;
+    isDirectory: (filePath: string) => boolean;
+    isSymlink: (filePath: string) => boolean;
+    listDirectory: (directory: string) => string[];
+    mkdir: (directory: string) => void;
+    writeFile: (filePath: string, contents: string, mode?: number) => void;
+    rename: (from: string, to: string) => void;
+    remove: (filePath: string) => void;
+    makeTempPath: () => string;
+    umask: () => number;
+    findExecutable: (name: string, env?: NodeJS.ProcessEnv) => string | undefined;
+    spawnDetached: (command: string, args: string[], cwd: string, env: NodeJS.ProcessEnv, logFile: string) => void;
+    runCommand: (command: string, args: string[], cwd: string, env: NodeJS.ProcessEnv) => {
+        status: number | null;
+        stdout: string;
+        stderr: string;
+        error?: Error;
+    };
+};
+/** In-process command body, with injectable file access for parity tests. */
+export declare function executeHqSession(argv: readonly string[], context: {
+    cwd: string;
+    hqRoot?: string;
+}, overrides?: Partial<HqSessionDependencies>): HqSessionResult;
+/** Signature consumed by the lightweight fast-core dispatcher. */
+export declare function runHqSessionFast(argv: readonly string[], _stdin: string, cwd: string, hqRoot: string | undefined): Promise<number>;
+//# sourceMappingURL=core-hq-session-native.d.ts.map