@indigoai-us/hq-cli 5.263.0 → 5.265.0

package/dist/lib/lanes/watcher.js

@@ -49,6 +49,7 @@ import { createLaneMesh, emitLaneDecisionEvents, emitLaneProgressEvent, emitLane
 import { envelopeQuestionId } from "./questions.js";
 import { readLanesRegistryFlag } from "./registry-flag.js";
 import { blockerFreshnessFingerprint, resolveBlockerFreshnessForLane, } from "./blocker-freshness.js";
+import { krFreshnessFingerprint, resolveKrFreshnessForLane, } from "./kr-freshness.js";
 import { MANAGER_STATUS_GATE_FLAG, managerStatusWasWritten, readStatusSnapshot, resolveManagerStatusTarget, managerStatusGateEnabledForLane, } from "./manager-status-gate.js";
 import { queueLaneTerminalResume, queueManagerStatusGateResume } from "./keep-alive.js";
 import { monitorSessionDir } from "../monitor.js";
@@ -863,6 +864,72 @@ async function settleBlockerFreshness(hqRoot, lane, manifestTurnId, at, deps, me
     }
     return updated;
 }
+async function settleKrFreshness(hqRoot, lane, manifestTurnId, at, deps, logDecision) {
+    if (manifestTurnId !== undefined && lane.status_gate !== undefined && lane.status_gate.turn_id !== manifestTurnId) {
+        logDecision({ event: "kr_freshness_baseline_mismatch", at, turn_id: lane.status_gate.turn_id });
+        return lane;
+    }
+    let errorLogged = false;
+    const resolution = await resolveKrFreshnessForLane(hqRoot, lane, {
+        readFlag: deps.readKrFreshnessFlag ?? readLanesRegistryFlag,
+        now: Date.parse(at),
+        onError: (error) => {
+            if (errorLogged)
+                return;
+            errorLogged = true;
+            const code = error instanceof LanesError ? error.error : "kr_freshness_unavailable";
+            process.stderr.write(`hq lanes watcher: KR freshness disabled for ${lane.lane_id}: ${code}\n`);
+            logDecision({ event: "kr_freshness_disabled", at, error: code });
+        },
+    });
+    if (!resolution.enabled || resolution.statusPath === undefined || resolution.error !== undefined)
+        return lane;
+    const stalled = resolution.kpis.filter((kpi) => kpi.verdict === "stalled");
+    if (stalled.length === 0) {
+        if (lane.kr_freshness_state === undefined)
+            return lane;
+        return retryUpdateLane(hqRoot, lane.lane_id, "watcher", (current) => current.kr_freshness_state === undefined
+            ? current
+            : { ...current, kr_freshness_state: undefined });
+    }
+    const fingerprint = krFreshnessFingerprint(resolution.stalledKeys);
+    const names = stalled.map((kpi) => kpi.name);
+    const turnId = manifestTurnId ?? lane.status_gate?.turn_id ?? `unknown-${at}`;
+    const resumeText = `These KPIs in ${resolution.statusPath} were not re-measured in the last ${resolution.windowHours}h: ${names.join(", ")}. Measure each one now, update value and measured_at, then end the turn.`;
+    return retryUpdateLane(hqRoot, lane.lane_id, "watcher", (current) => {
+        const history = current.status_gate_history ?? [];
+        if (history.some((entry) => entry.event === "kr_stalled" && entry.turn_id === turnId))
+            return current;
+        const sameStalledSet = current.kr_freshness_state?.stalled_fingerprint === fingerprint;
+        let nextLane = current;
+        let resumeQueued = false;
+        let resumeSkippedReason;
+        if (!sameStalledSet) {
+            const mergeExisting = current.pending_resume !== undefined &&
+                current.state !== "blocked" && current.state !== "awaiting_input";
+            const resume = queueLaneTerminalResume(current, at, resumeText, { mergeExisting });
+            nextLane = resume.lane;
+            resumeQueued = resume.resumeQueued;
+            resumeSkippedReason = resume.resumeSkippedReason;
+        }
+        const entry = {
+            event: "kr_stalled",
+            turn_id: turnId,
+            path: resolution.statusPath,
+            at,
+            names,
+            count: stalled.length,
+            fingerprint,
+            ...(resumeQueued ? { resume_queued: true } : {}),
+            ...(resumeSkippedReason !== undefined ? { resume_skipped_reason: resumeSkippedReason } : {}),
+        };
+        return {
+            ...nextLane,
+            kr_freshness_state: { stalled_fingerprint: fingerprint },
+            status_gate_history: appendCappedHistory(history, entry),
+        };
+    });
+}
 function resolveBlockerFreshnessSessionInbox(hqRoot, sessionId) {
     let candidates;
     try {
@@ -1452,11 +1519,13 @@ async function runWatcherLoopOwned(hqRoot, laneId, deps) {
                 if (terminalWrite.changed) {
                     updated = await settleManagerStatusGate(hqRoot, updated, manifest.turn_id, tick.emit.at, deps, logDecision);
                     updated = await settleBlockerFreshness(hqRoot, updated, manifest.turn_id, tick.emit.at, deps, mesh, logDecision);
+                    updated = await settleKrFreshness(hqRoot, updated, manifest.turn_id, tick.emit.at, deps, logDecision);
                 }
                 const managerStatusFollowupQueued = manifest.turn_id !== undefined &&
                     updated.status_gate_history?.some((entry) => entry.turn_id === manifest.turn_id &&
                         ((entry.event === "status_missed" && entry.resume_queued === true) ||
-                            (entry.event === "blocker_stale" && entry.resume_queued === true))) === true;
+                            (entry.event === "blocker_stale" && entry.resume_queued === true) ||
+                            (entry.event === "kr_stalled" && entry.resume_queued === true))) === true;
                 if (terminalWrite.changed && deps.recoverQueuedMessages && !managerStatusFollowupQueued) {
                     try {
                         if (dropboxInboxHasMessages(hqRoot, laneId)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.263.0",
+  "version": "5.265.0",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {

package/dist/lib/checkpoint-ontology/hints.d.ts

@@ -1,41 +0,0 @@
-/**
- * Existing entities an input names, for `checkpoint.ontology.entity-hints`.
- *
- * The model never sees the company's entities, so it can only link one when it
- * happens to pick a name or alias the index holds. On the CO-39 fixtures it
- * created `SpaceXAI` beside `xAI`, `Indigo desktop app` beside `indigo-nx`
- * (alias `Indigo desktop repo`) and `hq-work-site` beside `Indigo Workspace`
- * (workspace/checkpoint-ontology/analysis/co41-wrong-creates.json). Each
- * input's plan entry lists the existing entities whose name the input text
- * contains, so the model can use that name.
- */
-import type { EntityIndex } from "./tree.js";
-export declare const ENTITY_HINTS: {
-    /** Entities listed per input. */
-    readonly perInput: 25;
-    /** An alias match counts this fraction of a canonical-name match with the same words. */
-    readonly aliasWeight: 0.5;
-    /** Aliases shown per entity. */
-    readonly aliases: 3;
-    /** Longest name, in words, matched through the n-gram set. Longer names use a phrase search. */
-    readonly maxGram: 4;
-};
-export interface EntityHint {
-    type: string;
-    name: string;
-    aliases: string[];
-}
-/**
- * Inverse document frequency of each word over the entities' match names, so
- * `Sentry` outranks `HQ Build` in a document that names both.
- */
-export declare function wordWeights(index: EntityIndex): Map<string, number>;
-/**
- * Up to `ENTITY_HINTS.perInput` writable entities whose canonical name or
- * qualifying alias appears in `text` as whole words within one sentence, table
- * cell or markdown block, highest weight first (ties by path). A match scores the summed word weights, halved for an alias.
- * Entities with the same type and canonical name are listed once. Only
- * entities from `index`, which is the plan's own company.
- */
-export declare function entityHints(index: EntityIndex, weights: Map<string, number>, text: string): EntityHint[];
-//# sourceMappingURL=hints.d.ts.map

package/dist/lib/checkpoint-ontology/hints.js

@@ -1,146 +0,0 @@
-/**
- * Existing entities an input names, for `checkpoint.ontology.entity-hints`.
- *
- * The model never sees the company's entities, so it can only link one when it
- * happens to pick a name or alias the index holds. On the CO-39 fixtures it
- * created `SpaceXAI` beside `xAI`, `Indigo desktop app` beside `indigo-nx`
- * (alias `Indigo desktop repo`) and `hq-work-site` beside `Indigo Workspace`
- * (workspace/checkpoint-ontology/analysis/co41-wrong-creates.json). Each
- * input's plan entry lists the existing entities whose name the input text
- * contains, so the model can use that name.
- */
-export const ENTITY_HINTS = {
-    /** Entities listed per input. */
-    perInput: 25,
-    /** An alias match counts this fraction of a canonical-name match with the same words. */
-    aliasWeight: 0.5,
-    /** Aliases shown per entity. */
-    aliases: 3,
-    /** Longest name, in words, matched through the n-gram set. Longer names use a phrase search. */
-    maxGram: 4,
-};
-const HINT_TYPES = new Set(["person", "project", "company", "concept"]);
-/** Token that stands for a sentence, cell or block boundary. A name never matches across one it does not contain. */
-const BOUNDARY = "\n";
-const TOKEN = /[\p{L}\p{N}]+|[.!?;:](?=\s|$)|\|/gu;
-/**
- * A line that continues the previous one when the previous one is prose or a
- * list item: hard-wrapped markdown keeps a name that wraps across the line
- * break. Blank lines, headings, list items, table rows, quotes and fences start
- * a new block.
- */
-function continuesProse(line) {
-    return line.trim() !== "" && !/^\s*(#|[-*+]\s|\d+[.)]\s|\||>|```|~~~)/.test(line);
-}
-/**
- * Lowercased words, with `BOUNDARY` between sentences (`.`, `!`, `?`, `;` or
- * `:` before whitespace), table cells and markdown blocks. Names and text are
- * split the same way, so a name that holds a boundary, such as `Tip 001:
- * checkpoint`, still matches its own text.
- */
-function tokens(text) {
-    const out = [];
-    const push = (token) => {
-        if (token !== BOUNDARY || (out.length > 0 && out[out.length - 1] !== BOUNDARY))
-            out.push(token);
-    };
-    let prevProse = null;
-    for (const line of text.toLowerCase().split("\n")) {
-        const prose = continuesProse(line);
-        if (prevProse !== null && !(prose && prevProse))
-            push(BOUNDARY);
-        for (const match of line.matchAll(TOKEN))
-            push(/^[\p{L}\p{N}]/u.test(match[0]) ? match[0] : BOUNDARY);
-        prevProse = prose || /^\s*([-*+]|\d+[.)])\s/.test(line);
-    }
-    while (out[0] === BOUNDARY)
-        out.shift();
-    while (out[out.length - 1] === BOUNDARY)
-        out.pop();
-    return out;
-}
-function words(name) {
-    return name.filter((token) => token !== BOUNDARY);
-}
-function matchNames(entity) {
-    const out = [];
-    const canonical = tokens(entity.canonical_name);
-    if (words(canonical).length > 0)
-        out.push({ tokens: canonical, weight: 1 });
-    for (const alias of entity.aliases) {
-        const aliasTokens = tokens(alias);
-        const count = words(aliasTokens).length;
-        if (count >= 2 || (count === 1 && /[-_./0-9]/.test(alias))) {
-            out.push({ tokens: aliasTokens, weight: ENTITY_HINTS.aliasWeight, alias });
-        }
-    }
-    return out;
-}
-/**
- * Inverse document frequency of each word over the entities' match names, so
- * `Sentry` outranks `HQ Build` in a document that names both.
- */
-export function wordWeights(index) {
-    const counts = new Map();
-    let total = 0;
-    for (const entity of index.byRel.values()) {
-        if (!HINT_TYPES.has(entity.type))
-            continue;
-        total += 1;
-        for (const word of new Set(matchNames(entity).flatMap((name) => words(name.tokens))))
-            counts.set(word, (counts.get(word) ?? 0) + 1);
-    }
-    const weights = new Map();
-    for (const [word, count] of counts)
-        weights.set(word, Math.log((total + 1) / count));
-    return weights;
-}
-/**
- * Up to `ENTITY_HINTS.perInput` writable entities whose canonical name or
- * qualifying alias appears in `text` as whole words within one sentence, table
- * cell or markdown block, highest weight first (ties by path). A match scores the summed word weights, halved for an alias.
- * Entities with the same type and canonical name are listed once. Only
- * entities from `index`, which is the plan's own company.
- */
-export function entityHints(index, weights, text) {
-    const textTokens = tokens(text);
-    const grams = new Set();
-    for (let i = 0; i < textTokens.length; i += 1) {
-        for (let n = 1; n <= ENTITY_HINTS.maxGram && i + n <= textTokens.length; n += 1) {
-            grams.add(textTokens.slice(i, i + n).join(" "));
-        }
-    }
-    const padded = ` ${textTokens.join(" ")} `;
-    const best = new Map();
-    for (const entity of index.byRel.values()) {
-        if (!HINT_TYPES.has(entity.type))
-            continue;
-        let score = 0;
-        const matched = [];
-        for (const name of matchNames(entity)) {
-            const phrase = name.tokens.join(" ");
-            const found = name.tokens.length <= ENTITY_HINTS.maxGram ? grams.has(phrase) : padded.includes(` ${phrase} `);
-            if (!found)
-                continue;
-            if (name.alias !== undefined)
-                matched.push(name.alias);
-            score = Math.max(score, name.weight * words(name.tokens).reduce((sum, word) => sum + (weights.get(word) ?? 0), 0));
-        }
-        if (score <= 0)
-            continue;
-        const key = `${entity.type}\0${entity.canonical_name.toLowerCase()}`;
-        const held = best.get(key);
-        if (!held || score > held.score || (score === held.score && entity.rel < held.entity.rel))
-            best.set(key, { entity, score, matched });
-    }
-    return [...best.values()]
-        .sort((a, b) => b.score - a.score || (a.entity.rel < b.entity.rel ? -1 : a.entity.rel > b.entity.rel ? 1 : 0))
-        .slice(0, ENTITY_HINTS.perInput)
-        .map(({ entity, matched }) => ({
-        type: entity.type,
-        name: entity.canonical_name,
-        // Aliases the text used come first, so the model sees the name it read.
-        aliases: [...matched, ...entity.aliases.filter((alias) => !matched.includes(alias))].slice(0, ENTITY_HINTS.aliases),
-    }));
-}
-//# sourceMappingURL=hints.js.map