@indigoai-us/hq-cli 5.313.0 → 5.314.0

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

@@ -1,504 +0,0 @@
-/**
- * `hq core ontology plan`: pick this run's inputs.
- *
- * Runs in the detached checkpoint sibling. It resolves the flag, finds the
- * company's changed knowledge and signal files with a content-hash ledger,
- * applies the per-run budget, and writes `<runDir>/ontology-plan.json` for the
- * backend model to read. The model only fills a candidates file; everything
- * that affects identity, scope and cost stays in code.
- */
-import { createHash } from "node:crypto";
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { writeCompanyBrief } from "./company-brief.js";
-import { resolveOntologyCompany, safeWriteFile, stateRoot } from "./company.js";
-import { startMultiWriterRun } from "./multi-writer.js";
-import { claimQueuedTouches, recordQueuedTouches } from "./queued-touches.js";
-import { checkSyncClient, readSyncClientVersions } from "./sync-client.js";
-import { buildEntityIndex, listKnowledgeFiles, listSignalFiles, readSignal } from "./tree.js";
-export const ONTOLOGY_FLAG = "checkpoint.ontology";
-/**
- * Turns the step on like `checkpoint.ontology`, but only builds that check the
- * sync client read it (CO-45, owner decision CO-D-005). Older CLI builds read
- * only `checkpoint.ontology`, so this key can default on without starting the
- * step next to an hq-cloud older than 6.18.7. Either key needs a sync client of
- * 6.18.7 or later; see ./sync-client.ts.
- */
-export const ONTOLOGY_SYNC_GATED_FLAG = "checkpoint.ontology.sync-gated";
-/**
- * Several writers in one company vault (design section 20): record written
- * entity bytes in the outbox, merge back set-aside versions, and report
- * duplicate entities.
- */
-export const MULTI_WRITER_FLAG = "checkpoint.ontology.multi-writer";
-/**
- * CO-59: consume the files touched by company checkpoints that were queued
- * behind a busy sibling (see queued-touches.ts). On, the plan adds the
- * company's queued touches to this run's session-touched set, and a run whose
- * own payload names no company plans the company the parent picked for it
- * (`ontology_company`), without that run's session text. Off, queued touches
- * wait on disk and a company-less run skips the ontology step as before.
- */
-export const QUEUED_TOUCHES_FLAG = "checkpoint.ontology.queued-touches";
-export const PLAN_FILE = "ontology-plan.json";
-export const CANDIDATES_FILE = "ontology-candidates.json";
-export const REPORT_FILE = "ontology-report.json";
-export const PLAN_SCHEMA = "hq-checkpoint-ontology-plan.v1";
-export const CANDIDATES_SCHEMA = "hq-checkpoint-ontology-candidates.v1";
-const LEDGER_SCHEMA = "hq-checkpoint-ontology-ledger.v1";
-export const BUDGET = {
-    maxInputs: 20,
-    maxTokens: 60_000,
-    chunkTokens: 12_000,
-};
-export const READ_PATH_INSTRUCTION = "When an input has read_path, read that file (relative to the run directory) instead of path, with the same line range. It is the same text with an older annotator's entity lists and entity links removed.";
-export const FIRST_NAME_PEOPLE_INSTRUCTION = "Name a person by the full name the input or the company's entities give. When neither gives more than a first name, name the person by that first name; do not leave them out.";
-const CANDIDATE_INSTRUCTIONS = [
-    `Write ${CANDIDATES_FILE} in the run directory as {"schema":"${CANDIDATES_SCHEMA}","candidates":[...]} and nothing else.`,
-    "Each candidate: {input, type, name, aliases, confidence, evidence}. input is one of this plan's input ids; type is person, project, company or concept; name is the entity's full proper name; aliases are other names the input uses for it (at most 5); confidence is 0 to 1; evidence is a short quote from the input.",
-    "Read only the files and line ranges this plan lists. For a signal, read its body and name the entities in missing_refs if the signal supports them.",
-    "Name the specific people, projects, products, companies and named concepts that the input says something about. That includes the company that owns this knowledge and its own products when the input describes them. Name a third-party tool, vendor or service only when a section of the input is about it; skip ones that appear in a list, a stack summary or a passing mention. Skip generic words, file names and headings.",
-    "For the session input (its text is session_text in this plan), name only entities that already exist in the company and that the session did work on. Session candidates are recorded as links, never created.",
-    "Do not create, edit, move or delete anything under ontology/, signals/ or sources/ yourself.",
-];
-function sha256File(file) {
-    return createHash("sha256").update(fs.readFileSync(file)).digest("hex");
-}
-function ledgerPath(hqRoot, company) {
-    return path.join(stateRoot(hqRoot, company), "ledger.json");
-}
-export function readLedger(hqRoot, company) {
-    let raw;
-    try {
-        raw = fs.readFileSync(ledgerPath(hqRoot, company), "utf8");
-    }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return null;
-        throw error;
-    }
-    const parsed = JSON.parse(raw);
-    if (parsed.schema !== LEDGER_SCHEMA || parsed.company !== company.slug || typeof parsed.entries !== "object") {
-        throw new Error(`ontology ledger for ${company.slug} has an unexpected schema`);
-    }
-    return parsed;
-}
-export function writeLedger(hqRoot, company, ledger) {
-    const target = ledgerPath(hqRoot, company);
-    safeWriteFile(hqRoot, [stateRoot(hqRoot, company)], target, `${JSON.stringify(ledger, null, 2)}\n`);
-}
-export function backendPreferencePath(hqRoot, company) {
-    return path.join(stateRoot(hqRoot, company), "backend.json");
-}
-/** The grok-backend flag value the last plan recorded; false when no plan has recorded one. */
-export function readBackendPreference(hqRoot, company) {
-    let raw;
-    try {
-        raw = fs.readFileSync(backendPreferencePath(hqRoot, company), "utf8");
-    }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return false;
-        throw error;
-    }
-    return JSON.parse(raw)?.prefer_grok === true;
-}
-function recordBackendPreference(hqRoot, company, preferGrok) {
-    const target = backendPreferencePath(hqRoot, company);
-    safeWriteFile(hqRoot, [stateRoot(hqRoot, company)], target, `${JSON.stringify({ prefer_grok: preferGrok })}\n`);
-}
-/** Company-relative paths of the payload's touched files that are inside this company. */
-function sessionTouched(hqRoot, company, files) {
-    const out = new Set();
-    if (!Array.isArray(files))
-        return out;
-    for (const file of files) {
-        if (typeof file !== "string" || !file.trim())
-            continue;
-        const absolute = path.resolve(hqRoot, file.trim());
-        const rel = path.relative(company.dir, absolute);
-        if (!rel || rel.startsWith("..") || path.isAbsolute(rel))
-            continue;
-        out.add(rel.split(path.sep).join("/"));
-    }
-    return out;
-}
-/** 1-based line ranges, each at most `chunkTokens` tokens (bytes / 4). */
-function chunkLines(content, chunkTokens) {
-    const lines = content.split("\n");
-    const maxBytes = chunkTokens * 4;
-    const chunks = [];
-    let start = 1;
-    let bytes = 0;
-    lines.forEach((line, i) => {
-        const size = Buffer.byteLength(line, "utf8") + 1;
-        if (bytes > 0 && bytes + size > maxBytes) {
-            chunks.push([start, i]);
-            start = i + 1;
-            bytes = 0;
-        }
-        bytes += size;
-    });
-    chunks.push([start, lines.length]);
-    return chunks;
-}
-function estTokens(bytes) {
-    return Math.ceil(bytes / 4);
-}
-/** Latest `last_updated` over the company's writable entity types (design 14.3). */
-function entityBoundary(index) {
-    let best = null;
-    let bestMs = -Infinity;
-    for (const entity of index.byRel.values()) {
-        if (!["person", "project", "company", "concept"].includes(entity.type) || !entity.last_updated)
-            continue;
-        const ms = Date.parse(entity.last_updated);
-        if (Number.isFinite(ms) && ms > bestMs) {
-            bestMs = ms;
-            best = entity.last_updated;
-        }
-    }
-    return best;
-}
-function missingRefs(companyDir, rel) {
-    const signal = readSignal(companyDir, rel);
-    if (!signal)
-        return [];
-    return signal.refs.filter((ref) => !fs.existsSync(path.join(companyDir, "ontology", "entities", `${ref}.md`)));
-}
-/**
- * Update the ledger with the current tree and return it. New or changed files
- * the session touched become pending; others are recorded as seen. The first
- * run records the entity boundary (design 14.3).
- */
-function refreshLedger(company, existing, touched) {
-    const firstRun = existing === null;
-    const index = firstRun ? buildEntityIndex(company.dir) : null;
-    const boundary = existing ? existing.boundary : entityBoundary(index);
-    const entries = {};
-    const files = [...listKnowledgeFiles(company.dir), ...listSignalFiles(company.dir)];
-    for (const rel of files) {
-        const absolute = path.join(company.dir, rel);
-        const stat = fs.statSync(absolute);
-        const previous = existing?.entries[rel];
-        const unchangedStat = previous && previous.size === stat.size && previous.mtime_ms === stat.mtimeMs;
-        const sha256 = unchangedStat ? previous.sha256 : sha256File(absolute);
-        const base = { sha256, size: stat.size, mtime_ms: stat.mtimeMs };
-        if (previous && previous.sha256 === sha256) {
-            // Same content. A pending entry stays pending until apply finishes it.
-            // A file another run recorded as seen is still this session's input.
-            entries[rel] = previous.state === "seen" && touched.has(rel)
-                ? { ...base, state: "pending", reason: "session-touched" }
-                : { ...previous, ...base };
-            continue;
-        }
-        entries[rel] = touched.has(rel) ? { ...base, state: "pending", reason: "session-touched" } : { ...base, state: "seen" };
-    }
-    return { ledger: { schema: LEDGER_SCHEMA, company: company.slug, boundary, entries }, firstRun };
-}
-/**
- * The company this run's ontology step works on: the payload's own company,
- * or else the `ontology_company` the checkpoint parent picked for queued
- * touches (`borrowed`).
- */
-export function payloadOntologyCompany(payload) {
-    if (typeof payload.company === "string" && payload.company)
-        return { slug: payload.company, borrowed: false };
-    if (typeof payload.ontology_company === "string" && payload.ontology_company) {
-        return { slug: payload.ontology_company, borrowed: true };
-    }
-    return { slug: null, borrowed: false };
-}
-/** Plan this run. Never throws for a skip; returns the reason instead. */
-export async function planOntologyRun(options) {
-    const { hqRoot, runDir, payload } = options;
-    const { slug, borrowed } = payloadOntologyCompany(payload);
-    const resolution = resolveOntologyCompany(hqRoot, slug);
-    if (!resolution.ok)
-        return { status: "skipped", reason: resolution.reason };
-    const company = resolution.company;
-    // A borrowed company exists only for queued touches, so its run needs the
-    // queued-touches flag before anything else is read or written.
-    if (borrowed && !(await options.readFlag(QUEUED_TOUCHES_FLAG, company))) {
-        return { status: "skipped", reason: "flag off" };
-    }
-    const ontologyOn = (await options.readFlag(ONTOLOGY_FLAG, company)) || (await options.readFlag(ONTOLOGY_SYNC_GATED_FLAG, company));
-    const syncClient = ontologyOn ? checkSyncClient((options.syncClientVersions ?? readSyncClientVersions)()) : null;
-    if (!ontologyOn || !syncClient?.ok) {
-        // A preference recorded while the ontology was on must not outlive it.
-        fs.rmSync(backendPreferencePath(hqRoot, company), { force: true });
-        return { status: "skipped", reason: syncClient && !syncClient.ok ? syncClient.reason : "flag off" };
-    }
-    // Was checkpoint.ontology.ignore-annotations, always on since CO-68.
-    // Applies only when the payload's sibling backend is grok. On gold-v2, Claude
-    // with stripped inputs lost 0.139 recall; Grok with stripped inputs gained
-    // precision without losing recall. A machine that falls back from grok keeps
-    // the annotated inputs.
-    const ignoreAnnotations = payload.backend === "grok";
-    // Was checkpoint.ontology.grok-backend, always on since CO-68.
-    // With `--backend auto`, `hq core checkpoint` tries grok first for this
-    // company. Read here, in the detached sibling, and recorded in the company's
-    // state directory, so the foreground checkpoint makes no network call.
-    recordBackendPreference(hqRoot, company, true);
-    const multiWriterOn = await options.readFlag(MULTI_WRITER_FLAG, company);
-    const queuedTouchesOn = borrowed || (await options.readFlag(QUEUED_TOUCHES_FLAG, company));
-    // A borrowed company's run belongs to another session: its own files and
-    // session text are not this company's input.
-    const touched = sessionTouched(hqRoot, company, borrowed ? [] : payload.files);
-    if (queuedTouchesOn) {
-        for (const rel of sessionTouched(hqRoot, company, claimQueuedTouches(hqRoot, company, runDir)))
-            touched.add(rel);
-    }
-    // A first run takes its boundary from the entity tree, so the ledger is
-    // refreshed before merge-back moves any `last_updated` forward.
-    const { ledger, firstRun } = refreshLedger(company, readLedger(hqRoot, company), touched);
-    // Merge-back and the brief come before the nothing-changed return, so such
-    // a plan still merges set-aside versions and records the brief; the brief
-    // follows merge-back so its counts include merged entities.
-    const multiWriter = multiWriterOn ? startMultiWriterRun(hqRoot, company, options.now ?? new Date()) : undefined;
-    // Was checkpoint.ontology.company-brief, always on since CO-68.
-    const companyBrief = writeCompanyBrief(hqRoot, company, options.now ?? new Date());
-    const pending = Object.entries(ledger.entries)
-        .filter(([, entry]) => entry.state === "pending" && entry.reason === "session-touched")
-        .sort(([aRel, a], [bRel, b]) => a.mtime_ms - b.mtime_ms || aRel.localeCompare(bRel));
-    const inputs = [];
-    let tokens = 0;
-    let remaining = 0;
-    const leftover = [];
-    for (const [rel, entry] of pending) {
-        if (inputs.length >= BUDGET.maxInputs || tokens >= BUDGET.maxTokens) {
-            remaining += 1;
-            leftover.push(rel);
-            continue;
-        }
-        const text = fs.readFileSync(path.join(company.dir, rel), "utf8");
-        const lines = text.split("\n");
-        const chunks = chunkLines(lines.join("\n"), BUDGET.chunkTokens);
-        const kind = rel.startsWith("signals/") ? "signal" : "knowledge";
-        const cleaned = ignoreAnnotations && kind === "knowledge" ? stripAnnotations(text) : null;
-        const readPath = cleaned === null ? null : path.join(READ_COPY_DIR, rel);
-        if (readPath !== null) {
-            fs.mkdirSync(path.dirname(path.join(runDir, readPath)), { recursive: true });
-            fs.writeFileSync(path.join(runDir, readPath), cleaned);
-        }
-        let index = entry.next_chunk ?? 0;
-        for (; index < chunks.length; index += 1) {
-            const [start, end] = chunks[index];
-            const cost = estTokens(Buffer.byteLength(lines.slice(start - 1, end).join("\n"), "utf8"));
-            if (inputs.length >= BUDGET.maxInputs || tokens + cost > BUDGET.maxTokens)
-                break;
-            inputs.push({
-                id: chunks.length > 1 ? `${rel}#${index}` : rel,
-                kind,
-                path: rel,
-                audience: "company",
-                reason: "session-touched",
-                sha256: entry.sha256,
-                est_tokens: cost,
-                lines: chunks.length > 1 ? [start, end] : null,
-                chunk: chunks.length > 1 ? { index, count: chunks.length } : null,
-                ...(kind === "signal" ? { missing_refs: missingRefs(company.dir, rel) } : {}),
-                ...(readPath !== null ? { read_path: readPath } : {}),
-            });
-            tokens += cost;
-        }
-        if (index < chunks.length) {
-            remaining += 1;
-            leftover.push(rel);
-        }
-    }
-    writeLedger(hqRoot, company, ledger);
-    // The leftover files stay queued so a later company-less run can borrow this company again.
-    if (queuedTouchesOn && leftover.length > 0) {
-        try {
-            recordQueuedTouches(hqRoot, company.slug, leftover.map((rel) => path.relative(hqRoot, path.join(company.dir, rel))), options.now ?? new Date());
-        }
-        catch {
-            // Re-queueing leftovers must not fail the plan.
-        }
-    }
-    if (inputs.length === 0) {
-        const reason = pending.length > 0 ? "over budget" : "nothing changed";
-        return {
-            status: "skipped",
-            reason,
-            ...(companyBrief ? { companyBrief } : {}),
-            ...(multiWriter ? { multiWriter } : {}),
-        };
-    }
-    // Session content is scoped to the session's user (design section 6, D2).
-    // v1 records the existing entities it names as links in the report and
-    // writes nothing from it, so it rides along only when files changed.
-    const sessionText = borrowed ? null : sessionContent(payload);
-    if (sessionText) {
-        const cost = estTokens(Buffer.byteLength(sessionText, "utf8"));
-        inputs.unshift({
-            id: "session",
-            kind: "session",
-            path: null,
-            audience: "session",
-            reason: "session-touched",
-            sha256: null,
-            est_tokens: cost,
-            lines: null,
-            chunk: null,
-        });
-        tokens += cost;
-    }
-    const plan = {
-        schema: PLAN_SCHEMA,
-        company: company.slug,
-        run_id: path.basename(runDir),
-        created_at: (options.now ?? new Date()).toISOString(),
-        first_run: firstRun,
-        boundary: ledger.boundary,
-        ...(companyBrief
-            ? {
-                company_brief: companyBrief.reason
-                    ? { status: companyBrief.status, reason: companyBrief.reason }
-                    : { status: companyBrief.status },
-            }
-            : {}),
-        ...(multiWriter ? { multi_writer: multiWriter } : {}),
-        // Was checkpoint.ontology.no-link-aliases, always on since CO-68.
-        // A candidate that links to an existing entity adds no aliases to it; the plan
-        // carries `link_aliases: false` and apply honours it. CO-42: most aliases
-        // written through links on the CO-41 runs were other things the text named
-        // next to the entity (`Publisher` on indigo, `Stripe Connect` on Stripe), and
-        // entity-hints multiplied them (22 aliases on a flag-off run, 45 and 125 on two
-        // hinted runs).
-        link_aliases: false,
-        // Was checkpoint.ontology.first-name-people, always on since CO-68.
-        // A person the input and the company's entities give only a first name for is
-        // named by that first name instead of being left out. CO-44: on the CO-41
-        // grok-4.6 runs the model read "not a first name alone" as "skip them", and
-        // dropped people such as Amir and Sebastian, whose own entities carry only a
-        // first name. People were 24 of the 138 missed gold entities over three runs.
-        // The plan carries `first_name_people: true`, and apply then defers a one-word
-        // person whose word starts an existing person's fuller name or alias, since
-        // the model cannot see that `John Smith` already exists.
-        first_name_people: true,
-        // Was checkpoint.ontology.skip-ambiguous-concept-links, always on since CO-68.
-        // A knowledge input does not link to a concept entity whose canonical name is
-        // also the canonical name of an entity of another type (`concept/hq-secrets`
-        // beside `project/hq-secrets`). The plan carries
-        // `skip_ambiguous_concept_links: true`, and apply rejects the link as
-        // `ambiguous_type`. CO-46: 34 of the 73 false positives on the knowledge
-        // fixtures were such concept links; skipping them raised precision from 0.733
-        // to 0.803 and cost recall 0.023 on a replay of six runs.
-        skip_ambiguous_concept_links: true,
-        // Was checkpoint.ontology.dominant-sibling-link, always on since CO-68.
-        // A knowledge link to the weaker of two entities that share a canonical name
-        // across types is redirected to the sibling other entity files link to
-        // (`project/build-your-own-agi` beside `concept/build-your-own-agi`, or
-        // `project/hq-core 2` beside `project/hq-core` when a concept also holds the
-        // name). The plan carries `dominant_sibling_link: true`, and apply reports
-        // the move in `dominant_sibling_redirects` without writing the entity files.
-        // CO-60: a replay of six runs raised knowledge precision from 0.725 to 0.754
-        // and recall from 0.784 to 0.816, and never changed a create.
-        dominant_sibling_link: true,
-        // Was checkpoint.ontology.hub-mention-floor, always on since CO-68.
-        // A knowledge link to a non-person entity that 50 or more
-        // other entity files link to is rejected as `hub_under_mentioned` when the
-        // input names it fewer than 2 times (whole word, any case, canonical name
-        // only). The plan carries `hub_mention_floor: true`. CO-62: a replay of six
-        // runs raised knowledge precision from 0.753 to 0.781 at the same recall.
-        hub_mention_floor: true,
-        // Was checkpoint.ontology.concept-project-link, always on since CO-68.
-        // A knowledge concept candidate whose name is an alias of more than one
-        // entity, and which apply would defer as `ambiguous_alias`, links instead to
-        // the one project whose canonical name it is (`HQ` typed as a concept beside
-        // `project/HQ` and several concepts aliased `HQ`). The plan carries
-        // `concept_project_link: true`. CO-51: over six runs of the shipping config
-        // the model typed HQ as a concept in some runs and not others, and the
-        // deferral lost 61 gold links; a replay of this rule raised recall from 0.639
-        // to 0.709 at precision 0.747 to 0.731 (61 of the 63 added links are HQ).
-        concept_project_link: true,
-        // Was checkpoint.ontology.named-evidence, always on since CO-68.
-        // A knowledge link to the company's own company entity, or a
-        // concept-project-link redirect, needs evidence that names the entity as a
-        // word: the candidate name or one of its aliases, not inside a path, domain,
-        // handle, tag or identifier (`indigoai-us/hq`, `getindigo.ai`,
-        // `scope: company:indigo`). The plan carries `named_evidence: true`, and apply
-        // rejects such a link as `unnamed_in_evidence`. CO-57: on the six CO-52 runs,
-        // 67 of 143 false positives were links to company/indigo and project/HQ, most
-        // on evidence that only held the name inside an identifier; a replay of this
-        // rule raised precision on the concept-project-link arm from 0.705 to 0.750
-        // and lost no gold link.
-        named_evidence: true,
-        inputs,
-        session_text: sessionText,
-        pending_after_run: remaining,
-        budget: {
-            max_inputs: BUDGET.maxInputs,
-            max_tokens: BUDGET.maxTokens,
-            chunk_tokens: BUDGET.chunkTokens,
-            planned_tokens: tokens,
-        },
-        candidates_file: CANDIDATES_FILE,
-        instructions: [
-            ...CANDIDATE_INSTRUCTIONS.slice(0, 3),
-            ...(inputs.some((input) => input.read_path) ? [READ_PATH_INSTRUCTION] : []),
-            `${CANDIDATE_INSTRUCTIONS[3]} ${FIRST_NAME_PEOPLE_INSTRUCTION}`,
-            ...CANDIDATE_INSTRUCTIONS.slice(4),
-        ],
-    };
-    fs.mkdirSync(runDir, { recursive: true });
-    const planPath = path.join(runDir, PLAN_FILE);
-    fs.writeFileSync(planPath, `${JSON.stringify(plan, null, 2)}\n`);
-    return companyBrief ? { status: "planned", plan, planPath, companyBrief } : { status: "planned", plan, planPath };
-}
-const READ_COPY_DIR = "ontology-inputs";
-/**
- * The cloud annotator wrote an `entities:` list into knowledge front matter and
- * `[[ontology/entities/...]]` links into the text. Most are wrong, and a model
- * told to ignore them still copies them (design section 18), so the model reads
- * a copy without them. The list's lines are blanked rather than removed so the
- * plan's line ranges still hold; a link becomes its label, or its last path
- * segment. Returns null when the text has neither.
- */
-export function stripAnnotations(text) {
-    let out = text;
-    const front = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(text);
-    if (front && /^entities:/m.test(front[1])) {
-        let inList = false;
-        const body = front[1]
-            .split("\n")
-            .map((line) => {
-            if (/^entities:/.test(line))
-                inList = true;
-            else if (inList && /^\S/.test(line))
-                inList = false;
-            return inList ? "" : line;
-        })
-            .join("\n");
-        const start = text.indexOf("\n") + 1;
-        out = text.slice(0, start) + body + text.slice(start + front[1].length);
-    }
-    out = out
-        .replace(/\[\[ontology\/entities\/[^\]|\n]*\|([^\]\n]*)\]\]/g, "$1")
-        .replace(/\[\[ontology\/entities\/(?:[^\]\n]*\/)?([^\]/\n]*)\]\]/g, "$1");
-    return out === text ? null : out;
-}
-const SESSION_TEXT_MAX_BYTES = 8_000;
-/** The session summary, decisions and learnings from the payload, capped. */
-function sessionContent(payload) {
-    const parts = [];
-    if (typeof payload.summary === "string" && payload.summary.trim())
-        parts.push(payload.summary.trim());
-    for (const key of ["decisions", "learnings", "insights"]) {
-        const items = payload[key];
-        if (!Array.isArray(items))
-            continue;
-        for (const item of items)
-            if (typeof item === "string" && item.trim())
-                parts.push(`- ${item.trim()}`);
-    }
-    if (parts.length === 0)
-        return null;
-    const text = parts.join("\n");
-    return Buffer.byteLength(text, "utf8") > SESSION_TEXT_MAX_BYTES
-        ? Buffer.from(text, "utf8").subarray(0, SESSION_TEXT_MAX_BYTES).toString("utf8").replace(/\uFFFD$/, "")
-        : text;
-}
-//# sourceMappingURL=plan.js.map

package/dist/lib/checkpoint-ontology/queued-touches.d.ts

@@ -1,29 +0,0 @@
-import { type OntologyCompany } from "./company.js";
-export declare const MAX_QUEUED_TOUCHES = 200;
-export declare function queuedTouchesPath(hqRoot: string, slug: string): string;
-/**
- * Record the files a queued checkpoint touched inside its company. Files
- * outside `companies/<slug>/` are dropped. Returns the number of files
- * recorded; 0 when the company is not a manifest company or nothing is inside
- * it. The queue keeps its newest {@link MAX_QUEUED_TOUCHES} lines.
- */
-export declare function recordQueuedTouches(hqRoot: string, slug: string | null, files: string[], now: Date): number;
-/**
- * Record that a company-less run borrowed `slug`, so the next such run prefers
- * a company that has waited longer.
- */
-export declare function markBorrowed(hqRoot: string, slug: string, now: Date): void;
-/**
- * The manifest company whose queued touches have waited longest, or null.
- * The order key is the later of the first queued record and the last borrow,
- * so a company a company-less run just borrowed goes to the back. A run whose
- * own payload names no company uses it for its ontology step.
- */
-export declare function oldestQueuedCompany(hqRoot: string): string | null;
-/**
- * Take the company's queued touches by renaming the file into the run
- * directory, then return the HQ-relative paths it lists. Renaming is atomic,
- * so a touch recorded during the claim lands in a fresh file for a later run.
- */
-export declare function claimQueuedTouches(hqRoot: string, company: OntologyCompany, runDir: string): string[];
-//# sourceMappingURL=queued-touches.d.ts.map