@indigoai-us/hq-cli 5.345.42 → 5.345.43

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 ## [Unreleased]
 
+## [5.345.43] — 2026-10-07
+- The published core-command E2E workflow now retries the exact npm release install for up to 10 minutes while registry propagation completes.
+
+- HQ Anywhere resolves person-level flags in unlinked folders. The daemon refreshes the flag and person setting every 60 seconds, then opens or closes its socket when either changes.
+- Claude and Codex global installs use one skill prefix, keep company skills out of global scope, remove old company links during upgrades, and skip broken sources. Dry runs use `~/.hq/root` when run outside a checkout.
+- Doctor checks for a live desktop-hosted daemon instead of treating the sync LaunchAgent as proof. Registry refreshes retain the daemon's machine scope and ID token.
+- Let a failed lane's ancestors or same-company manager resume it, and backfill missing company attribution when reparenting it to a company senior.
+- Let Claude lanes fall back to eligible accounts when every profile-pinned account is unavailable, behind the default-off `lanes.profile-pin-exhausted-fallback` flag.
+
 ## [5.345.42] — 2026-10-07
 - `hq db usage --app <name>` shows one database app's included amounts, use, overage, read-only ceiling and estimated monthly charge.
 

package/dist/command-catalog.generated.d.ts

@@ -12464,7 +12464,7 @@ export declare const COMMAND_CATALOG: readonly [{
         readonly subcommands: readonly [];
     }, {
         readonly name: "resume";
-        readonly description: "Resume an interrupted, done or blocked lane, or an awaiting_input lane with no answerable question; recover failed lanes with the senior-only --from-failed option";
+        readonly description: "Resume an interrupted, done or blocked lane, or an awaiting_input lane with no answerable question; recover failed lanes with --from-failed as a senior ancestor or same-company manager";
         readonly aliases: readonly [];
         readonly hidden: false;
         readonly helpOption: true;
@@ -12483,7 +12483,7 @@ export declare const COMMAND_CATALOG: readonly [{
             readonly hidden: false;
         }, {
             readonly flags: "--from-failed";
-            readonly description: "Explicitly resume a failed lane as its senior";
+            readonly description: "Explicitly resume a failed lane as an ancestor or same-company manager";
             readonly hidden: false;
         }, {
             readonly flags: "--reason <text>";

package/dist/command-catalog.generated.js

@@ -15156,7 +15156,7 @@ export const COMMAND_CATALOG = [
             },
             {
                 "name": "resume",
-                "description": "Resume an interrupted, done or blocked lane, or an awaiting_input lane with no answerable question; recover failed lanes with the senior-only --from-failed option",
+                "description": "Resume an interrupted, done or blocked lane, or an awaiting_input lane with no answerable question; recover failed lanes with --from-failed as a senior ancestor or same-company manager",
                 "aliases": [],
                 "hidden": false,
                 "helpOption": true,
@@ -15179,7 +15179,7 @@ export const COMMAND_CATALOG = [
                     },
                     {
                         "flags": "--from-failed",
-                        "description": "Explicitly resume a failed lane as its senior",
+                        "description": "Explicitly resume a failed lane as an ancestor or same-company manager",
                         "hidden": false
                     },
                     {

package/dist/commands/install-global.d.ts

@@ -75,8 +75,15 @@ export interface GlobalCommandOpts {
     log?: (line: string) => void;
     /** Test seam for the hq-pro person preference read. */
     personSettingReader?: () => Promise<boolean | null>;
+    /** Root-discovery seams used by command tests and wrappers. */
+    home?: string;
+    cwd?: string;
 }
-export declare function resolveInstallRoot(explicit: string | undefined): string;
+export declare function resolveInstallRoot(explicit: string | undefined, options?: {
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+    home?: string;
+}): string;
 /** Entry used by `hq install --global` (wired from pkg-install.ts). */
 export declare function runInstallGlobal(opts: GlobalCommandOpts): Promise<void>;
 export declare function registerUninstallCommand(program: Command): void;

package/dist/commands/install-global.js

@@ -9,6 +9,7 @@
  * ~/.hq/anywhere/claude-install.json so uninstall can restore files byte-for-byte.
  */
 import * as fs from 'fs';
+import * as os from 'node:os';
 import * as path from 'path';
 import { spawnSync } from 'node:child_process';
 import { buildCodexServerDef, claudeConfigFormat, codexConfigFormat, codexRemovalFormat, isCodexInstalled, jsonFormat, mergeCodexServer, removeCodexServer, registerCodexServer, unregisterCodexServer, mergeClaudeServer, readConfigDoc, realpathOrSelf, registerClaudeServer, resolveEnv, unregisterClaudeServer, writeConfigAtomic, } from './mcp-registration.js';
@@ -20,6 +21,8 @@ import { chatgptConnectorInstructions } from '../lib/install/chatgpt-targets.js'
 import { anywhereRuntimeAllowed } from '../lib/anywhere-person-setting.js';
 import { grokConnectorInstructions } from '../lib/install/grok-targets.js';
 import { readRegistry, registryDir, registryFile, writeRegistry } from '../lib/registry/registry.js';
+import { readCompaniesManifestMap } from '../lib/work-context/repo-remote.js';
+import { resolveDefaultHqRoot } from '../utils/hq-root-resolver.js';
 import { DAEMON_LAUNCHD_LABEL, DAEMON_SYSTEMD_UNIT, DAEMON_WINDOWS_TASK, SYSTEM_UNIT_DIR } from '../lib/daemon/install.js';
 import { readDaemonConfig } from '../lib/daemon/config.js';
 import { daemonPaths } from '../lib/daemon/paths.js';
@@ -201,9 +204,13 @@ function mcpManifest(opts) {
     }
     return { type: 'stdio', command, args: [entry, 'mcp', 'serve'], env: { PATH: MCP_SUBPROCESS_PATH } };
 }
+function skillLinkName(name) {
+    return name.startsWith(SKILL_LINK_PREFIX) ? name : `${SKILL_LINK_PREFIX}${name}`;
+}
 function planSkills(hqRoot, t) {
     const source = hqSkillsSource(hqRoot);
-    const plan = { link: [], already: [], skipped: [] };
+    const plan = { link: [], already: [], skipped: [], unresolved: [], companyScoped: [] };
+    const companySlugs = new Set(Object.keys(readCompaniesManifestMap(hqRoot) ?? {}));
     let names;
     try {
         names = fs
@@ -218,8 +225,23 @@ function planSkills(hqRoot, t) {
         throw e;
     }
     for (const name of names) {
-        const link = path.join(t.skillsDir, `${SKILL_LINK_PREFIX}${name}`);
+        const namespace = name.includes(':') ? name.slice(0, name.indexOf(':')) : '';
+        if (namespace && companySlugs.has(namespace)) {
+            plan.companyScoped.push(name);
+            continue;
+        }
         const target = path.join(source, name);
+        try {
+            if (!fs.statSync(target).isDirectory()) {
+                plan.unresolved.push(name);
+                continue;
+            }
+        }
+        catch {
+            plan.unresolved.push(name);
+            continue;
+        }
+        const link = path.join(t.skillsDir, skillLinkName(name));
         let st = null;
         try {
             st = fs.lstatSync(link);
@@ -237,6 +259,15 @@ function planSkills(hqRoot, t) {
     }
     return plan;
 }
+function reportSkippedSkills(plan, log, dryRun) {
+    const prefix = dryRun ? 'Would skip' : 'Skipped';
+    if (plan.unresolved.length > 0) {
+        log(`${prefix} skill source(s) that do not resolve to directories: ${plan.unresolved.join(', ')}`);
+    }
+    if (plan.companyScoped.length > 0) {
+        log(`${prefix} company-scoped skill(s) at global scope: ${plan.companyScoped.join(', ')}`);
+    }
+}
 function hqSkillLinksForRoot(skillsDir, hqRoot) {
     let names;
     try {
@@ -261,6 +292,27 @@ function hqSkillLinksForRoot(skillsDir, hqRoot) {
         }
     }).map((name) => path.join(skillsDir, name));
 }
+function hqCompanySkillLinksForRoot(skillsDir, hqRoot) {
+    const companySlugs = new Set(Object.keys(readCompaniesManifestMap(hqRoot) ?? {}));
+    if (companySlugs.size === 0)
+        return [];
+    const source = hqSkillsSource(hqRoot);
+    return hqSkillLinksForRoot(skillsDir, hqRoot).filter((link) => {
+        try {
+            const target = path.resolve(skillsDir, fs.readlinkSync(link));
+            if (path.dirname(target) !== source)
+                return false;
+            const sourceName = path.basename(target);
+            const separator = sourceName.indexOf(':');
+            return separator > 0 && companySlugs.has(sourceName.slice(0, separator));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return false;
+            throw error;
+        }
+    });
+}
 function removeSeeded(seeded, regFile) {
     if (seeded.length === 0 || !fs.existsSync(regFile))
         return;
@@ -320,7 +372,13 @@ export function installGlobalClaude(opts) {
             : mdOld === null ? null : (removeClaudeMdBlock(mdOld) || null))
         : prior ? prior.claudeMd.original : mdOld;
     const mdNew = pluginSource ? mdOriginal : addClaudeMdBlock(mdOld, hqRoot);
-    const skills = pluginSource ? { link: [], already: [], skipped: [] } : planSkills(hqRoot, t);
+    const skills = pluginSource ? {
+        link: [],
+        already: [],
+        skipped: [],
+        unresolved: [],
+        companyScoped: [],
+    } : planSkills(hqRoot, t);
     const settingsOld = readOrNull(t.settingsJson);
     const settingsDoc = readConfigDoc(t.settingsJson, jsonFormat).doc;
     const directHooksRemoved = pluginSource
@@ -347,7 +405,9 @@ export function installGlobalClaude(opts) {
     const settingsNext = pluginSource
         ? cleanupRoots.reduce((doc, root) => removeHqHooks(doc, root), settingsDoc)
         : addHqHooks(settingsDoc, hqRoot, hookTarget);
-    const skillLinksToRemove = pluginSource ? cleanupRoots.flatMap((root) => hqSkillLinksForRoot(t.skillsDir, root)) : [];
+    const skillLinksToRemove = [...new Set(pluginSource
+            ? cleanupRoots.flatMap((root) => hqSkillLinksForRoot(t.skillsDir, root))
+            : cleanupRoots.flatMap((root) => hqCompanySkillLinksForRoot(t.skillsDir, root)))];
     const claudeDoc = readConfigDoc(t.claudeJson, claudeConfigFormat).doc;
     // Collision check runs here too, so a dry run surfaces a conflicting "hq" server.
     const claudeNext = pluginSource ? claudeDoc : mergeClaudeServer(HQ_MCP_SERVER_NAME, {
@@ -359,7 +419,7 @@ export function installGlobalClaude(opts) {
     if (mdOld !== mdNew)
         touched.push(t.claudeMd);
     for (const s of skills.link)
-        touched.push(path.join(t.skillsDir, `${SKILL_LINK_PREFIX}${s}`));
+        touched.push(path.join(t.skillsDir, skillLinkName(s)));
     touched.push(...skillLinksToRemove);
     if (settingsNext !== settingsDoc)
         touched.push(t.settingsJson);
@@ -374,8 +434,12 @@ export function installGlobalClaude(opts) {
         for (const f of touched)
             log(`  ${f}`);
         if (skills.skipped.length > 0) {
-            log(`Would skip ${skills.skipped.length} skill(s) whose hq-<name> already exists and is not an HQ link: ${skills.skipped.join(', ')}`);
+            log(`Would skip ${skills.skipped.length} skill(s) whose target already exists and is not an HQ link: ${skills.skipped.join(', ')}`);
         }
+        if (!pluginSource && skillLinksToRemove.length > 0) {
+            log(`Would remove ${skillLinksToRemove.length} previous company-scoped skill link(s)`);
+        }
+        reportSkippedSkills(skills, log, true);
         log(`\n--- ${t.settingsJson}`);
         log(lineDiff(jsonFormat.serialize(settingsDoc), jsonFormat.serialize(settingsNext)));
         log(`\n--- ${t.claudeJson}`);
@@ -429,11 +493,10 @@ export function installGlobalClaude(opts) {
     if (!pluginSource)
         fs.mkdirSync(t.skillsDir, { recursive: true });
     for (const name of skills.link) {
-        fs.symlinkSync(path.join(hqSkillsSource(hqRoot), name), path.join(t.skillsDir, `${SKILL_LINK_PREFIX}${name}`));
+        fs.symlinkSync(path.join(hqSkillsSource(hqRoot), name), path.join(t.skillsDir, skillLinkName(name)));
     }
-    if (pluginSource)
-        for (const link of skillLinksToRemove)
-            fs.unlinkSync(link);
+    for (const link of skillLinksToRemove)
+        fs.unlinkSync(link);
     if (pluginSource) {
         // Migrate a prior direct install: remove only our old hook/MCP entries while
         // retaining the original user settings for a later uninstall restore.
@@ -498,6 +561,7 @@ export function installGlobalClaude(opts) {
     writeFileAtomic(t.stateFile, `${JSON.stringify(state, null, 2)}\n`);
     log(`HQ installed for Claude Code from ${hqRoot}.`);
     log(`  skills linked: ${skills.link.length} new, ${skills.already.length} already present, ${skills.skipped.length} skipped`);
+    reportSkippedSkills(skills, log, false);
     if (pluginSource)
         log(`  plugin: ${pluginSource.pluginId} installed from ${pluginSource.sourceDir}; direct hooks and MCP entries removed`);
     else {
@@ -691,6 +755,7 @@ export function installGlobalCodex(opts) {
     const charter = fs.readFileSync(codexCharterSource(hqRoot), 'utf-8');
     const mdOld = readOrNull(t.agentsMd);
     const mdNew = addAgentsMdBlock(mdOld, charter);
+    const cleanupRoots = [...new Set([hqRoot, ...(prior?.hqRoot ? [prior.hqRoot] : [])])];
     const legacy = classifyLegacySkills(t.skillsDir, hqRoot);
     const legacyPath = path.join(t.skillsDir, LEGACY_SKILLS_NAME);
     const legacyBackupPath = path.join(t.skillsDir, LEGACY_BACKUP_NAME);
@@ -698,6 +763,7 @@ export function installGlobalCodex(opts) {
         throw new Error(`${legacyBackupPath} already exists; move it away before installing.`);
     }
     const skills = planSkills(hqRoot, t);
+    const companySkillLinksToRemove = [...new Set(cleanupRoots.flatMap((root) => hqCompanySkillLinksForRoot(t.skillsDir, root)))];
     const hooksOld = readOrNull(t.hooksJson);
     const hooksDoc = readConfigDoc(t.hooksJson, jsonFormat).doc;
     const hookTarget = hookTargetFor(hqRoot, home, opts.daemonInstalled, env);
@@ -719,7 +785,8 @@ export function installGlobalCodex(opts) {
     if (legacy.kind === 'hq-symlink' || legacy.kind === 'hq-dir')
         touched.push(path.join(t.skillsDir, LEGACY_SKILLS_NAME));
     for (const s of skills.link)
-        touched.push(path.join(t.skillsDir, `${SKILL_LINK_PREFIX}${s}`));
+        touched.push(path.join(t.skillsDir, skillLinkName(s)));
+    touched.push(...companySkillLinksToRemove);
     if (hooksNext !== hooksDoc)
         touched.push(t.hooksJson);
     if (tomlNext !== tomlDoc || legacyPackServerPresent)
@@ -736,8 +803,12 @@ export function installGlobalCodex(opts) {
         else if (legacy.kind === 'foreign')
             log(legacyWarning(t.skillsDir));
         if (skills.skipped.length > 0) {
-            log(`Would skip ${skills.skipped.length} skill(s) whose hq-<name> already exists and is not an HQ link: ${skills.skipped.join(', ')}`);
+            log(`Would skip ${skills.skipped.length} skill(s) whose target already exists and is not an HQ link: ${skills.skipped.join(', ')}`);
+        }
+        if (companySkillLinksToRemove.length > 0) {
+            log(`Would remove ${companySkillLinksToRemove.length} previous company-scoped skill link(s)`);
         }
+        reportSkippedSkills(skills, log, true);
         log(`\n--- ${t.hooksJson}`);
         log(lineDiff(jsonFormat.serialize(hooksDoc), jsonFormat.serialize(hooksNext)));
         log(`\n--- ${t.configToml}`);
@@ -761,8 +832,10 @@ export function installGlobalCodex(opts) {
         log(legacyWarning(t.skillsDir));
     fs.mkdirSync(t.skillsDir, { recursive: true });
     for (const name of skills.link) {
-        fs.symlinkSync(path.join(hqSkillsSource(hqRoot), name), path.join(t.skillsDir, `${SKILL_LINK_PREFIX}${name}`));
+        fs.symlinkSync(path.join(hqSkillsSource(hqRoot), name), path.join(t.skillsDir, skillLinkName(name)));
     }
+    for (const link of companySkillLinksToRemove)
+        fs.unlinkSync(link);
     writeConfigAtomic({
         target: t.hooksJson,
         pack: HQ_ANYWHERE_PACK,
@@ -803,6 +876,7 @@ export function installGlobalCodex(opts) {
     writeFileAtomic(t.stateFile, `${JSON.stringify(state, null, 2)}\n`);
     log(`HQ installed for Codex from ${hqRoot}.`);
     log(`  skills linked: ${skills.link.length} new, ${skills.already.length} already present, ${skills.skipped.length} skipped`);
+    reportSkippedSkills(skills, log, false);
     log(`  hooks: ${hookTarget === 'shim' ? shimPath(hqRoot) : codexAdapterPath(hqRoot)} registered in ${t.hooksJson}`);
     log(`  MCP: "${HQ_MCP_SERVER_NAME}" registered in ${t.configToml}`);
     return touched;
@@ -946,34 +1020,63 @@ function assertRuntime(runtime) {
     }
     return r;
 }
-export function resolveInstallRoot(explicit) {
-    const fromFlag = explicit?.trim() || process.env.HQ_ROOT?.trim();
-    const root = fromFlag ? path.resolve(fromFlag) : resolveHqRoot();
-    if (!root) {
+export function resolveInstallRoot(explicit, options = {}) {
+    const env = options.env ?? process.env;
+    const fromFlag = explicit?.trim() || env.HQ_ROOT?.trim();
+    if (fromFlag)
+        return path.resolve(fromFlag);
+    const cwdRoot = resolveHqRoot(options.cwd ?? process.cwd());
+    if (cwdRoot)
+        return cwdRoot;
+    const home = options.home?.trim() || env.HOME?.trim() || os.homedir();
+    try {
+        const pointer = fs.readFileSync(path.join(home, '.hq', 'root'), 'utf8').trim();
+        if (pointer) {
+            const pointedRoot = resolveHqRoot(pointer);
+            if (pointedRoot)
+                return pointedRoot;
+        }
+    }
+    catch {
+        // Fall through to the regular installer/config root discovery.
+    }
+    try {
+        const rootEnv = { ...env };
+        delete rootEnv.HQ_ROOT;
+        return resolveDefaultHqRoot({
+            onMissing: 'throw',
+            env: rootEnv,
+            cwd: options.cwd,
+            home,
+        });
+    }
+    catch {
         throw Object.assign(new Error('Run from inside your HQ checkout, or pass --hq-root <dir>.'), { expected: true });
     }
-    return root;
 }
 /** Entry used by `hq install --global` (wired from pkg-install.ts). */
 export async function runInstallGlobal(opts) {
     const runtime = assertRuntime(opts.runtime);
     const env = opts.env ?? process.env;
-    if (runtime === 'chatgpt' || runtime === 'grok') {
+    if (runtime === 'chatgpt' || runtime === 'grok' || opts.dryRun) {
         const enabled = await anywhereRuntimeAllowed(env, {
             ...(opts.personSettingReader ? { readSetting: opts.personSettingReader } : {}),
             onError: (name) => (opts.log ?? console.log)(`HQ Anywhere person setting unavailable (${name}); access remains off.`),
         });
         if (!enabled)
             throw new AnywhereRuntimeDisabledError();
-        const endpoint = resolveHqMcpEndpoint(opts.env ?? process.env).toString();
-        const lines = runtime === 'chatgpt' ? chatgptConnectorInstructions(endpoint) : grokConnectorInstructions(endpoint);
-        for (const line of lines)
-            (opts.log ?? console.log)(line);
-        return;
+        if (runtime === 'chatgpt' || runtime === 'grok') {
+            const endpoint = resolveHqMcpEndpoint(env).toString();
+            const lines = runtime === 'chatgpt' ? chatgptConnectorInstructions(endpoint) : grokConnectorInstructions(endpoint);
+            for (const line of lines)
+                (opts.log ?? console.log)(line);
+            return;
+        }
     }
     const install = runtime === 'codex' ? installGlobalCodex : installGlobalClaude;
     install({
-        hqRoot: resolveInstallRoot(opts.hqRoot),
+        hqRoot: resolveInstallRoot(opts.hqRoot, { env, cwd: opts.cwd, home: opts.home }),
+        home: opts.home,
         dryRun: opts.dryRun,
         via: opts.via,
         marketplaceDir: opts.marketplaceDir,

package/dist/commands/lanes-message.js

@@ -738,6 +738,7 @@ export function createLaneMessageHandlers(deps) {
                             ...(automatic.preservedModel !== undefined ? { preservedModel: automatic.preservedModel } : {}),
                             ...(resumeProfile !== undefined ? { workerProfile: resumeProfile } : {}),
                             ...(refreshProfileSettings ? { refreshProfileSettings: true, accountSource: "balanced" } : {}),
+                            ...(automatic.historyReason === "profile_pin_exhausted" ? { preserveAdmissionAccounts: true } : {}),
                             ...(resumeEffort !== undefined ? { effort: resumeEffort } : {}),
                             ...(hireGrantContext !== undefined ? { grantContext: hireGrantContext } : {}),
                             pending: {

package/dist/commands/lanes-resume.js

@@ -409,6 +409,9 @@ export function createLaneResumeHandlers(deps) {
                             : {}),
                         ...(resumeProfile !== undefined ? { workerProfile: resumeProfile } : {}),
                         ...(refreshProfileSettings ? { refreshProfileSettings: true, accountSource: "balanced" } : {}),
+                        ...(automaticAccountSelection.historyReason === "profile_pin_exhausted"
+                            ? { preserveAdmissionAccounts: true }
+                            : {}),
                         ...(profileRepin !== undefined ? { profileRepin } : {}),
                         ...(resumeEffort !== undefined ? { effort: resumeEffort } : {}),
                         ...(hireGrantContext !== undefined ? { grantContext: hireGrantContext } : {}),