@indigoai-us/hq-cli 5.345.170 → 5.345.171

package/dist/lib/doctor/fix/apply.js

@@ -44,6 +44,7 @@ import { getStateDir } from "@indigoai-us/hq-cloud";
 import { isPersonalJournalSlug } from "../checks/sync-health.js";
 import { createDefaultRegistry } from "../registry.js";
 import { flattenFamilies } from "../report.js";
+import { repairDanglingReleaseLinks } from "../checks/release-links.js";
 import { parseHookGateProfiles, requiredMissingProfiles, } from "../hook-gate-profiles.js";
 import { createBackup } from "./backup.js";
 import { removeStrayGateEntries } from "../stray-gate-entries.js";
@@ -905,6 +906,8 @@ function planFix(hqRoot, result, rem, refreshSync, rewriteBotNodePath = defaultR
             return planRefreshSync(hqRoot, result, rem, refreshSync);
         case "refresh-manifest":
             return planRefreshManifest(hqRoot, result, rem, refreshManifest);
+        case "repair-release-link":
+            return planRepairReleaseLink(hqRoot, result, rem);
         default:
             return null;
     }
@@ -1075,6 +1078,57 @@ function planRefreshManifest(hqRoot, result, rem, refreshManifest) {
         failureReason: () => failureReason,
     };
 }
+/**
+ * Repoint (or remove) one dangling HQ-managed release link. The repair writes
+ * only the link entry, never a hook body, so it needs no backup: a link that
+ * does not resolve has no content to restore.
+ */
+function planRepairReleaseLink(hqRoot, result, rem) {
+    const rel = rem.fixTarget;
+    if (!rel)
+        return null;
+    let failure;
+    return {
+        checkId: result.checkId,
+        fixClass: "repair-release-link",
+        target: rel,
+        relpath: "",
+        preview: `  ${rel}\n` +
+            `    - dangling link\n` +
+            `    + the shipped link to its target under the HQ root (removed if that target is missing)`,
+        summary: `repair dangling link ${rel}`,
+        apply: () => {
+            // Each plan repairs only its own link, and a throw is recorded as this
+            // plan's failure so the remaining plans still run.
+            try {
+                const own = repairDanglingReleaseLinks(hqRoot, { only: rel });
+                const entry = own.find((item) => item.rel === rel);
+                if (!entry) {
+                    failure = `${rel} was not repaired`;
+                }
+                else if (entry.action === "skipped" || entry.action === "failed") {
+                    failure = `${rel} was not repaired: ${entry.reason ?? entry.action}`;
+                }
+                else {
+                    failure = undefined;
+                }
+            }
+            catch (err) {
+                failure = `${rel} was not repaired: ${err instanceof Error ? err.message : String(err)}`;
+            }
+        },
+        postStatus: (results) => {
+            const own = results.filter((entry) => entry.checkId === result.checkId);
+            if (own.some((entry) => entry.target === rel))
+                return "FAIL";
+            // Another link's failure is that plan's status, not this one's.
+            if (own.some((entry) => entry.status === "FAIL"))
+                return "PASS";
+            return own[0]?.status ?? null;
+        },
+        failureReason: () => failure,
+    };
+}
 /** Restore the execute bit on a hook script. */
 function planExecutableBit(hqRoot, result, rem) {
     const abs = rem.fixTarget;

package/dist/lib/doctor/fix/remediation.d.ts

@@ -43,6 +43,13 @@
  *                         hq-cli shim (see `lib/windows/ps1-shims.ts`); the
  *                         execution policy is never changed. This is the one
  *                         scoped exception to the no-delete rule below.
+ *   - `repair-release-link` — repoint an HQ-managed release link
+ *                         (`.agents/skills`, `.codex/claude`, ...) whose target
+ *                         is missing, using the link text HQ ships (absolute junction on Windows).
+ *                         When that target is missing too, the dangling link
+ *                         entry is removed. Only a link that does not resolve
+ *                         is touched; a real file or folder never is, and the
+ *                         link is removed without following it.
  *
  * EVERYTHING else — content drift between platform copies, a missing script, a
  * missing Codex counterpart, an unquoted `$CLAUDE_PROJECT_DIR`, a stale
@@ -54,7 +61,7 @@
  */
 import type { CheckResult } from "../types.js";
 /** The allowlisted safe repair classes `--fix` is permitted to apply. */
-export type FixClass = "executable-bit" | "gate-profile" | "remove-stray-gate-entries" | "refresh-sync" | "refresh-manifest" | "bot-node-path" | "bot-hq-binary" | "remove-ps1-shims";
+export type FixClass = "executable-bit" | "gate-profile" | "remove-stray-gate-entries" | "refresh-sync" | "refresh-manifest" | "bot-node-path" | "bot-hq-binary" | "remove-ps1-shims" | "repair-release-link";
 /**
  * A finding's structured remediation. `autoFixable`, `action`, and `command`
  * are the `--json` surface (AC1); `fixTarget`/`fixClass` are the internal handle

package/dist/lib/doctor/fix/remediation.js

@@ -43,6 +43,13 @@
  *                         hq-cli shim (see `lib/windows/ps1-shims.ts`); the
  *                         execution policy is never changed. This is the one
  *                         scoped exception to the no-delete rule below.
+ *   - `repair-release-link` — repoint an HQ-managed release link
+ *                         (`.agents/skills`, `.codex/claude`, ...) whose target
+ *                         is missing, using the link text HQ ships (absolute junction on Windows).
+ *                         When that target is missing too, the dangling link
+ *                         entry is removed. Only a link that does not resolve
+ *                         is touched; a real file or folder never is, and the
+ *                         link is removed without following it.
  *
  * EVERYTHING else — content drift between platform copies, a missing script, a
  * missing Codex counterpart, an unquoted `$CLAUDE_PROJECT_DIR`, a stale
@@ -53,6 +60,7 @@
  * deciding which of two diverged copies is correct needs human judgement.
  */
 import * as path from "node:path";
+import { DANGLING_RELEASE_LINK_PROBLEM, RELEASE_LINKS, RELEASE_LINKS_CHECK_ID, } from "../checks/release-links.js";
 import { isCompanyJournalSlug, isSafeCompanySlug, isPersonalJournalSlug, journalSlugFromCheckId, } from "../checks/sync-health.js";
 /** Matches an exec-bit remediation command, quoted or not: `chmod +x <path>`. */
 const CHMOD_EXEC = /^chmod\s+\+x\s+(.+)$/;
@@ -165,6 +173,20 @@ export function deriveRemediation(result) {
             command: "hq.cmd install --global",
         };
     }
+    // repair-release-link — a shipped link whose target is missing, such as one
+    // a rescue pointed at its deleted temp folder (feedback_2ab63e50).
+    if (checkId === RELEASE_LINKS_CHECK_ID &&
+        result.status === "FAIL" &&
+        RELEASE_LINKS.some((entry) => entry.rel === target) &&
+        result.message.startsWith(target + " " + DANGLING_RELEASE_LINK_PROBLEM)) {
+        return {
+            autoFixable: true,
+            fixClass: "repair-release-link",
+            fixTarget: target,
+            action: `Repoint the dangling ${target} link at its target under the HQ root (or remove the link when that target is missing).`,
+            command: "hq doctor --fix",
+        };
+    }
     // Available hq-core upgrade. WARN is intentional in `hq doctor` and is
     // not a broken sync; --fix has no mechanical repair for it.
     if (checkId === "sync.update.core") {