@indigoai-us/hq-cli 5.312.2-beta.0 → 5.314.0

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

@@ -1,66 +0,0 @@
-/**
- * `hq core ontology plan|apply` — the checkpoint sibling's ontology steps.
- *
- * The checkpoint parent never runs these: `plan` reads the hq-flags registry,
- * which is network I/O. The detached sibling runs `plan`, writes candidates
- * from the files the plan lists, then runs `apply`. Both commands take the
- * company from the run's `payload.json`, never from the agent, so an agent
- * cannot point the writes at another company.
- */
-import { Command } from "commander";
-import { type FlagReader } from "../lib/checkpoint-ontology/plan.js";
-import { type DeleteVaultKey, type MergeCopiesReport } from "../lib/checkpoint-ontology/merge-copies.js";
-export interface OntologyCommandDeps {
-    readFlag?: FlagReader;
-    now?: () => Date;
-    /** Builds the exact-key vault delete for a company uid. */
-    vaultDeleter?: (companyUid: string) => Promise<DeleteVaultKey>;
-}
-export declare function runOntologyPlan(hqRoot: string, runDirOption: string | undefined, deps?: OntologyCommandDeps): Promise<string>;
-export declare function runOntologyApply(hqRoot: string, runDirOption: string | undefined, deps?: OntologyCommandDeps): string;
-/**
- * `hq core ontology duplicates`: every group of same-type entities whose
- * names collide, with a proposed survivor. Read-only; gated by
- * `checkpoint.ontology.multi-writer`.
- */
-export declare function runOntologyDuplicates(hqRoot: string, slug: string | undefined, json: boolean, deps?: OntologyCommandDeps): Promise<string>;
-export interface MergeCopiesCommandOptions {
-    apply?: boolean;
-    delete?: boolean;
-    variants?: boolean;
-    /** Merge exactly the `--only` pairs, whatever their names (flag merge-listed-pairs). */
-    listed?: boolean;
-    limit?: number;
-    only?: string;
-    /** Also re-point refs and links held today (flag merge-rewrite-refs). */
-    rewriteRefs?: boolean;
-    json?: boolean;
-}
-export declare function mergeCopiesSummary(report: MergeCopiesReport): string;
-/**
- * `hq core ontology merge-copies`: merge `<slug> <n>.md` copies into their
- * original (`--apply`), then delete merged copies from the vault
- * (`--delete`). Without either it only reports. Gated by
- * `checkpoint.ontology.merge-copies` and `checkpoint.ontology.multi-writer`.
- * With `--variants`, merges two-file duplicate groups whose names differ only
- * in case, spacing or punctuation instead, gated by
- * `checkpoint.ontology.merge-variants`. `--rewrite-refs` (flag
- * `checkpoint.ontology.merge-rewrite-refs`) also re-points invoice and
- * knowledge links to the survivor and carries external ids and web domains;
- * pairs named by signals or sources stay held. `--listed` (flag
- * `checkpoint.ontology.merge-listed-pairs`) merges exactly the `--only` pairs,
- * which a person reviewed, instead of the pairs a finder produces.
- */
-export declare function runOntologyMergeCopies(hqRoot: string, slug: string | undefined, options: MergeCopiesCommandOptions, deps?: OntologyCommandDeps): Promise<string>;
-/**
- * `hq core ontology drop-aliases`: remove the reviewed `{ entity, alias }`
- * pairs in `--only` from entity files (`--apply`); without it only reports.
- * Gated by `checkpoint.ontology.drop-aliases` and `checkpoint.ontology.multi-writer`.
- */
-export declare function runOntologyDropAliases(hqRoot: string, slug: string | undefined, options: {
-    only?: string;
-    apply?: boolean;
-    json?: boolean;
-}, deps?: OntologyCommandDeps): Promise<string>;
-export declare function registerCoreOntologyCommand(core: Command): void;
-//# sourceMappingURL=core-ontology.d.ts.map

package/dist/commands/core-ontology.js

@@ -1,430 +0,0 @@
-/**
- * `hq core ontology plan|apply` — the checkpoint sibling's ontology steps.
- *
- * The checkpoint parent never runs these: `plan` reads the hq-flags registry,
- * which is network I/O. The detached sibling runs `plan`, writes candidates
- * from the files the plan lists, then runs `apply`. Both commands take the
- * company from the run's `payload.json`, never from the agent, so an agent
- * cannot point the writes at another company.
- */
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { resolveLiveRoot } from "../utils/hq-roots.js";
-import { describeCoreCommand } from "./core-command-catalog.js";
-import { readLanesRegistryFlag } from "../lib/lanes/registry-flag.js";
-import { MULTI_WRITER_FLAG, planOntologyRun, payloadOntologyCompany, } from "../lib/checkpoint-ontology/plan.js";
-import { applyOntologyRun, ApplyError } from "../lib/checkpoint-ontology/apply.js";
-import { resolveOntologyCompany, WriteBoundsError } from "../lib/checkpoint-ontology/company.js";
-import { findDuplicateGroups, summarizeMergeBack, } from "../lib/checkpoint-ontology/multi-writer.js";
-import { buildEntityIndex } from "../lib/checkpoint-ontology/tree.js";
-import { DROP_ALIASES_FLAG, dropAliases } from "../lib/checkpoint-ontology/drop-aliases.js";
-import { MERGE_COPIES_FLAG, MERGE_LISTED_PAIRS_FLAG, MERGE_REWRITE_REFS_FLAG, MERGE_VARIANTS_FLAG, mergeCopies, } from "../lib/checkpoint-ontology/merge-copies.js";
-import { callDeleteEndpoint } from "./files.js";
-import { resolveVaultCredential } from "../utils/resolve-vault-credential.js";
-import { registerCoreOntologyNativeCommands } from "./core-ontology-native.js";
-const ONTOLOGY_PAYLOAD_FILE = "payload.json";
-class OntologyUsageError extends Error {
-}
-function readPayload(runDir) {
-    const file = path.join(runDir, ONTOLOGY_PAYLOAD_FILE);
-    let raw;
-    try {
-        raw = JSON.parse(fs.readFileSync(file, "utf8"));
-    }
-    catch (error) {
-        throw new OntologyUsageError(`ontology: cannot read ${file} (${error.name})`);
-    }
-    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
-        throw new OntologyUsageError(`ontology: ${file} is not a JSON object`);
-    }
-    return raw;
-}
-function requireRunDir(runDir) {
-    if (!runDir)
-        throw new OntologyUsageError("ontology: --run-dir is required");
-    const resolved = path.resolve(runDir);
-    if (!fs.existsSync(resolved) || !fs.statSync(resolved).isDirectory()) {
-        throw new OntologyUsageError(`ontology: run directory not found: ${resolved}`);
-    }
-    return resolved;
-}
-/** The hq-flags read, scoped to the payload company. */
-const registryFlagReader = (flagKey, company) => readLanesRegistryFlag(flagKey, {
-    company: company.cloudUid ? { slug: company.slug, uid: company.cloudUid } : null,
-});
-function companyBriefSuffix(brief) {
-    if (!brief)
-        return "";
-    return `; company brief ${brief.status}${brief.reason ? ` (${brief.reason})` : ""}`;
-}
-function multiWriterSuffix(start) {
-    if (!start)
-        return "";
-    const parts = [];
-    if (start.merge_back.length > 0)
-        parts.push(`set-aside versions: ${summarizeMergeBack(start.merge_back)}`);
-    if (start.error)
-        parts.push(`multi-writer error ${start.error}`);
-    return parts.length > 0 ? `; ${parts.join("; ")}` : "";
-}
-export async function runOntologyPlan(hqRoot, runDirOption, deps = {}) {
-    const runDir = requireRunDir(runDirOption);
-    const outcome = await planOntologyRun({
-        hqRoot,
-        runDir,
-        payload: readPayload(runDir),
-        readFlag: deps.readFlag ?? registryFlagReader,
-        now: deps.now?.(),
-    });
-    if (outcome.status === "skipped") {
-        return `ontology: skipped (${outcome.reason})${companyBriefSuffix(outcome.companyBrief)}${multiWriterSuffix(outcome.multiWriter)}`;
-    }
-    const { plan } = outcome;
-    return (`ontology: planned ${plan.inputs.length} input(s), ~${plan.budget.planned_tokens} tokens, ` +
-        `${plan.pending_after_run} left for later runs; plan at ${outcome.planPath}` +
-        companyBriefSuffix(outcome.companyBrief) +
-        multiWriterSuffix(plan.multi_writer));
-}
-export function runOntologyApply(hqRoot, runDirOption, deps = {}) {
-    const runDir = requireRunDir(runDirOption);
-    const company = payloadOntologyCompany(readPayload(runDir)).slug;
-    if (company === null) {
-        throw new OntologyUsageError("ontology: the run payload names no company");
-    }
-    const report = applyOntologyRun({ hqRoot, runDir, company, now: deps.now?.() });
-    if (report.status === "sync_client_old")
-        return `ontology: skipped (${report.skip_reason}); nothing written`;
-    if (report.status !== "applied")
-        return `ontology: ${report.status.replaceAll("_", " ")}; nothing written`;
-    return (`ontology: ${report.created.length} created, ${report.updated.length} updated, ` +
-        `${report.matched} matched, ${report.rejected.length} rejected, ${report.deferred.length} deferred, ` +
-        `${report.suspect_duplicates.length} suspect duplicate(s), ${report.write_errors.length} write error(s)` +
-        companyBriefSuffix(report.company_brief) +
-        (report.multi_writer?.duplicates ? `; ${report.multi_writer.duplicates.groups} duplicate group(s) in the company` : "") +
-        (report.multi_writer?.error ? `; multi-writer error ${report.multi_writer.error}` : ""));
-}
-/**
- * `hq core ontology duplicates`: every group of same-type entities whose
- * names collide, with a proposed survivor. Read-only; gated by
- * `checkpoint.ontology.multi-writer`.
- */
-export async function runOntologyDuplicates(hqRoot, slug, json, deps = {}) {
-    const resolution = resolveOntologyCompany(hqRoot, slug);
-    if (!resolution.ok)
-        throw new OntologyUsageError(`ontology: company rejected: ${resolution.reason}`);
-    const company = resolution.company;
-    if (!(await (deps.readFlag ?? registryFlagReader)(MULTI_WRITER_FLAG, company))) {
-        return json ? JSON.stringify({ company: company.slug, skipped: "flag off" }) : `ontology duplicates: skipped (${MULTI_WRITER_FLAG} is off)`;
-    }
-    const groups = findDuplicateGroups(buildEntityIndex(company.dir));
-    if (json)
-        return JSON.stringify({ company: company.slug, groups }, null, 2);
-    if (groups.length === 0)
-        return `ontology duplicates: none in ${company.slug}`;
-    const lines = [`ontology duplicates: ${groups.length} group(s) in ${company.slug}`];
-    for (const group of groups) {
-        lines.push(`${group.type} (${group.reason.replaceAll("_", " ")}), keep ${group.survivor}`);
-        for (const rel of group.paths)
-            if (rel !== group.survivor)
-                lines.push(`  ${rel}`);
-    }
-    return lines.join("\n");
-}
-/** Delete one exact company vault key, refusing when the server would match anything else. */
-async function companyVaultDeleter(companyUid) {
-    const token = (await resolveVaultCredential()).token;
-    return async (key) => {
-        const preview = await callDeleteEndpoint({ token, companyUid, prefix: key, dryRun: true });
-        if (preview.matched === 0)
-            return 0;
-        if (preview.matched !== 1 || preview.keys.length !== 1 || preview.keys[0] !== key) {
-            throw new Error(`vault preview matched ${preview.matched} object(s), not exactly ${key}`);
-        }
-        return (await callDeleteEndpoint({ token, companyUid, prefix: key, dryRun: false })).deleted;
-    };
-}
-export function mergeCopiesSummary(report) {
-    const held = report.plans.filter((plan) => plan.held).length;
-    const lines = [
-        `ontology merge-copies (${report.mode.replace("_", " ")}) in ${report.company} (${report.pair_kind}): ${report.plans.length} of ${report.copies_found} copies, ${held} held, ${report.skipped.length} skipped`,
-        `  merged ${report.merged.length}, relinked ${report.relinked.length}${report.rewritten !== undefined ? `, rewritten ${report.rewritten.length}` : ""}, deleted ${report.deleted.length}, not ready ${report.not_ready.length}, errors ${report.errors.length}`,
-        `  duplicate groups ${report.duplicate_groups_before} -> ${report.duplicate_groups_after}; broken entity links ${report.broken_links_before} -> ${report.broken_links_after}`,
-    ];
-    for (const plan of report.plans.filter((entry) => entry.held)) {
-        lines.push(`  held ${plan.copy}: ${plan.held}${plan.held === "external_id_conflict" || plan.held === "server_owned_refs" ? ` (${plan.detail})` : ""}`);
-    }
-    for (const error of report.errors)
-        lines.push(`  error ${error.path}: ${error.error}`);
-    for (const entry of report.only_unmatched ?? [])
-        lines.push(`  not found ${entry.copy} -> ${entry.original}`);
-    return lines.join("\n");
-}
-/** Reads a `--only` file: a JSON array of `{ copy, original }` company-relative paths. */
-function readListedPairs(file) {
-    let parsed;
-    try {
-        parsed = JSON.parse(fs.readFileSync(file, "utf8"));
-    }
-    catch (error) {
-        throw new OntologyUsageError(`ontology: --only file ${file} is not readable JSON: ${error.message}`);
-    }
-    if (!Array.isArray(parsed) ||
-        parsed.length === 0 ||
-        !parsed.every((entry) => {
-            if (!entry || typeof entry !== "object")
-                return false;
-            const record = entry;
-            return typeof record.copy === "string" && typeof record.original === "string";
-        })) {
-        throw new OntologyUsageError("ontology: --only must be a non-empty JSON array of { copy, original } paths");
-    }
-    return parsed.map((entry) => {
-        if (entry.resolve_external_ids === undefined)
-            return { copy: entry.copy, original: entry.original };
-        return { copy: entry.copy, original: entry.original, resolve_external_ids: readResolution(entry.copy, entry.resolve_external_ids) };
-    });
-}
-/** `{ provider: { primary, namespace, object_type? } }`, every value a non-empty string. */
-function readResolution(copy, raw) {
-    const usage = `ontology: --only entry ${copy}: resolve_external_ids must map each provider to { primary, namespace, object_type? } strings`;
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw) || Object.keys(raw).length === 0)
-        throw new OntologyUsageError(usage);
-    const out = {};
-    for (const [provider, value] of Object.entries(raw)) {
-        if (value === null || typeof value !== "object" || Array.isArray(value))
-            throw new OntologyUsageError(usage);
-        const record = value;
-        const nonEmpty = (field) => typeof field === "string" && field.length > 0;
-        if (!Object.keys(record).every((key) => key === "primary" || key === "namespace" || key === "object_type") ||
-            !nonEmpty(record.primary) ||
-            !nonEmpty(record.namespace) ||
-            (record.object_type !== undefined && !nonEmpty(record.object_type))) {
-            throw new OntologyUsageError(usage);
-        }
-        out[provider] = {
-            primary: record.primary,
-            namespace: record.namespace,
-            ...(record.object_type !== undefined ? { object_type: record.object_type } : {}),
-        };
-    }
-    return out;
-}
-/**
- * `hq core ontology merge-copies`: merge `<slug> <n>.md` copies into their
- * original (`--apply`), then delete merged copies from the vault
- * (`--delete`). Without either it only reports. Gated by
- * `checkpoint.ontology.merge-copies` and `checkpoint.ontology.multi-writer`.
- * With `--variants`, merges two-file duplicate groups whose names differ only
- * in case, spacing or punctuation instead, gated by
- * `checkpoint.ontology.merge-variants`. `--rewrite-refs` (flag
- * `checkpoint.ontology.merge-rewrite-refs`) also re-points invoice and
- * knowledge links to the survivor and carries external ids and web domains;
- * pairs named by signals or sources stay held. `--listed` (flag
- * `checkpoint.ontology.merge-listed-pairs`) merges exactly the `--only` pairs,
- * which a person reviewed, instead of the pairs a finder produces.
- */
-export async function runOntologyMergeCopies(hqRoot, slug, options, deps = {}) {
-    if (options.apply && options.delete) {
-        throw new OntologyUsageError("ontology: run --apply first, let sync push the merged files, then run --delete");
-    }
-    if (options.limit !== undefined && (!Number.isInteger(options.limit) || options.limit < 1)) {
-        throw new OntologyUsageError("ontology: --limit must be a positive whole number");
-    }
-    if (options.listed && options.variants) {
-        throw new OntologyUsageError("ontology: use either --listed or --variants");
-    }
-    if (options.listed && options.only === undefined) {
-        throw new OntologyUsageError("ontology: --listed needs --only <file>");
-    }
-    const only = options.only !== undefined ? readListedPairs(options.only) : undefined;
-    const resolution = resolveOntologyCompany(hqRoot, slug);
-    if (!resolution.ok)
-        throw new OntologyUsageError(`ontology: company rejected: ${resolution.reason}`);
-    const company = resolution.company;
-    const readFlag = deps.readFlag ?? registryFlagReader;
-    const kindFlag = options.listed ? MERGE_LISTED_PAIRS_FLAG : options.variants ? MERGE_VARIANTS_FLAG : MERGE_COPIES_FLAG;
-    for (const flag of [kindFlag, MULTI_WRITER_FLAG, ...(options.rewriteRefs ? [MERGE_REWRITE_REFS_FLAG] : [])]) {
-        if (!(await readFlag(flag, company))) {
-            return options.json ? JSON.stringify({ company: company.slug, skipped: `${flag} off` }) : `ontology merge-copies: skipped (${flag} is off)`;
-        }
-    }
-    const mode = options.apply ? "merge" : options.delete ? "delete" : "dry_run";
-    let deleteVaultKey;
-    if (mode === "delete") {
-        if (!company.cloudUid)
-            throw new OntologyUsageError("ontology: the company has no cloud_uid in the manifest");
-        deleteVaultKey = await (deps.vaultDeleter ?? companyVaultDeleter)(company.cloudUid);
-    }
-    const report = await mergeCopies({
-        hqRoot,
-        company,
-        mode,
-        now: deps.now?.() ?? new Date(),
-        ...(options.variants ? { pairKind: "variants" } : {}),
-        ...(options.listed ? { pairKind: "listed" } : {}),
-        ...(options.limit !== undefined ? { limit: options.limit } : {}),
-        ...(only ? { only } : {}),
-        ...(options.rewriteRefs ? { rewriteRefs: true } : {}),
-        ...(deleteVaultKey ? { deleteVaultKey } : {}),
-    });
-    return options.json ? JSON.stringify(report, null, 2) : mergeCopiesSummary(report);
-}
-/** Reads a `drop-aliases --only` file: a JSON array of `{ entity, alias }`. */
-function readAliasDrops(file) {
-    let parsed;
-    try {
-        parsed = JSON.parse(fs.readFileSync(file, "utf8"));
-    }
-    catch (error) {
-        throw new OntologyUsageError(`ontology: --only file ${file} is not readable JSON: ${error.message}`);
-    }
-    const usage = "ontology: --only must be a non-empty JSON array of { entity, alias } strings";
-    if (!Array.isArray(parsed) || parsed.length === 0)
-        throw new OntologyUsageError(usage);
-    return parsed.map((item) => {
-        const record = item;
-        if (!record || typeof record.entity !== "string" || typeof record.alias !== "string" || record.alias === "") {
-            throw new OntologyUsageError(usage);
-        }
-        return { entity: record.entity, alias: record.alias };
-    });
-}
-/**
- * `hq core ontology drop-aliases`: remove the reviewed `{ entity, alias }`
- * pairs in `--only` from entity files (`--apply`); without it only reports.
- * Gated by `checkpoint.ontology.drop-aliases` and `checkpoint.ontology.multi-writer`.
- */
-export async function runOntologyDropAliases(hqRoot, slug, options, deps = {}) {
-    if (options.only === undefined)
-        throw new OntologyUsageError("ontology: drop-aliases needs --only <file>");
-    const drops = readAliasDrops(options.only);
-    const resolution = resolveOntologyCompany(hqRoot, slug);
-    if (!resolution.ok)
-        throw new OntologyUsageError(`ontology: company rejected: ${resolution.reason}`);
-    const company = resolution.company;
-    const readFlag = deps.readFlag ?? registryFlagReader;
-    for (const flag of [DROP_ALIASES_FLAG, MULTI_WRITER_FLAG]) {
-        if (!(await readFlag(flag, company))) {
-            return options.json ? JSON.stringify({ company: company.slug, skipped: `${flag} off` }) : `ontology drop-aliases: skipped (${flag} is off)`;
-        }
-    }
-    const report = dropAliases({ hqRoot, company, mode: options.apply ? "apply" : "dry_run", drops, now: deps.now?.() ?? new Date() });
-    if (options.json)
-        return JSON.stringify(report, null, 2);
-    const planned = Object.values(report.planned).reduce((sum, list) => sum + list.length, 0);
-    const lines = [
-        `ontology drop-aliases (${report.mode.replace("_", " ")}) in ${report.company}: ${planned} alias(es) on ${Object.keys(report.planned).length} entities, written ${report.written.length}, skipped ${report.skipped.length}, errors ${report.errors.length}`,
-        `  duplicate groups ${report.duplicate_groups_before} -> ${report.duplicate_groups_after}`,
-    ];
-    for (const skip of report.skipped)
-        lines.push(`  skipped ${skip.entity} "${skip.alias}": ${skip.reason}${skip.detail ? ` (${skip.detail})` : ""}`);
-    for (const error of report.errors)
-        lines.push(`  error ${error.path}: ${error.error}`);
-    return lines.join("\n");
-}
-function fail(error) {
-    if (error instanceof OntologyUsageError || error instanceof ApplyError || error instanceof WriteBoundsError) {
-        process.stderr.write(`${error.message}\n`);
-        process.exit(1);
-    }
-    throw error;
-}
-export function registerCoreOntologyCommand(core) {
-    const ontology = core
-        .command("ontology")
-        .description("Checkpoint ontology steps run by the checkpoint sibling (gated by checkpoint.ontology)");
-    const rootFor = (options) => resolveLiveRoot({ hqRoot: options.hqRoot ?? core.opts().hqRoot });
-    const plan = ontology
-        .command("plan")
-        .description("Check the flag and list the changed company files for this checkpoint run")
-        .option("--run-dir <path>", "checkpoint sibling run directory holding payload.json")
-        .option("--hq-root <path>", "HQ installation to operate on")
-        .action(async (options) => {
-        try {
-            process.stdout.write(`${await runOntologyPlan(rootFor(options), options.runDir)}\n`);
-        }
-        catch (error) {
-            fail(error);
-        }
-    });
-    describeCoreCommand(plan, { execution: "native", root: "live" });
-    const duplicates = ontology
-        .command("duplicates")
-        .description("List same-type entities whose names collide, with a proposed survivor (read-only)")
-        .requiredOption("--company <slug>", "company to scan")
-        .option("--json", "print JSON")
-        .option("--hq-root <path>", "HQ installation to operate on")
-        .action(async (options) => {
-        try {
-            process.stdout.write(`${await runOntologyDuplicates(rootFor(options), options.company, options.json === true)}\n`);
-        }
-        catch (error) {
-            fail(error);
-        }
-    });
-    describeCoreCommand(duplicates, { execution: "native", root: "live" });
-    const mergeCopies = ontology
-        .command("merge-copies")
-        .description("Merge '<name> N.md' entity copies into their original, then delete them from the vault (dry run by default)")
-        .requiredOption("--company <slug>", "company to change")
-        .option("--apply", "merge each copy into its original and re-point links (writes entity files)")
-        .option("--delete", "delete fully merged copies from the vault by exact key (after sync pushed the merge)")
-        .option("--variants", "merge two-file duplicate groups whose names differ only in case, spacing or punctuation (checkpoint.ontology.merge-variants)")
-        .option("--listed", "merge exactly the pairs in the --only file, whatever their names (checkpoint.ontology.merge-listed-pairs)")
-        .option("--limit <n>", "handle at most this many copies", (value) => Number(value))
-        .option("--only <file>", "handle only the copy -> original pairs listed in this JSON file")
-        .option("--rewrite-refs", "also re-point invoice and knowledge links to the survivor and carry external ids and web domains; pairs named by signals or sources stay held (checkpoint.ontology.merge-rewrite-refs)")
-        .option("--json", "print JSON")
-        .option("--hq-root <path>", "HQ installation to operate on")
-        .action(async (options) => {
-        try {
-            process.stdout.write(`${await runOntologyMergeCopies(rootFor(options), options.company, options)}\n`);
-        }
-        catch (error) {
-            fail(error);
-        }
-    });
-    describeCoreCommand(mergeCopies, { execution: "native", root: "live" });
-    const dropAliasesCommand = ontology
-        .command("drop-aliases")
-        .description("Remove reviewed wrong aliases from entity files (dry run by default)")
-        .requiredOption("--company <slug>", "company to change")
-        .option("--only <file>", "JSON array of { entity, alias } to remove; entity is a company-relative path")
-        .option("--apply", "write the entity files")
-        .option("--json", "print JSON")
-        .option("--hq-root <path>", "HQ installation to operate on")
-        .action(async (options) => {
-        try {
-            process.stdout.write(`${await runOntologyDropAliases(rootFor(options), options.company, options)}\n`);
-        }
-        catch (error) {
-            fail(error);
-        }
-    });
-    describeCoreCommand(dropAliasesCommand, { execution: "native", root: "live" });
-    const apply = ontology
-        .command("apply")
-        .description("Validate the run's entity candidates and write them to the payload company")
-        .option("--run-dir <path>", "checkpoint sibling run directory holding the plan and candidates")
-        .option("--hq-root <path>", "HQ installation to operate on")
-        .action((options) => {
-        try {
-            process.stdout.write(`${runOntologyApply(rootFor(options), options.runDir)}\n`);
-        }
-        catch (error) {
-            fail(error);
-        }
-    });
-    describeCoreCommand(apply, { execution: "native", root: "live" });
-    registerCoreOntologyNativeCommands(ontology, () => {
-        const argv = process.argv.slice(2);
-        const coreIndex = argv.indexOf("core");
-        const ontologyIndex = argv.indexOf("ontology", coreIndex + 1);
-        const rootOptionIndex = argv.indexOf("--hq-root", coreIndex + 1);
-        const groupRoot = rootOptionIndex >= 0 && (ontologyIndex < 0 || rootOptionIndex < ontologyIndex)
-            ? argv[rootOptionIndex + 1]
-            : undefined;
-        return groupRoot ? rootFor({ hqRoot: groupRoot }) : process.env.HQ_ROOT || rootFor({});
-    });
-}
-//# sourceMappingURL=core-ontology.js.map

package/dist/commands/core-pin-native.d.ts

@@ -1,14 +0,0 @@
-import type { Command } from "commander";
-import { type UtilityOutput } from "./core-native-utilities.js";
-export declare const PIN_ASSET = "core/scripts/hq-pin.sh";
-export declare const PIN_HELP = "# hq-pin.sh \u2014 anchor the current session to one goal (the \"pin\").\n#\n# A pin is the message, goal, or target the session keeps working toward\n# across loops, wakeups, compactions, and hand-offs. It is stored per session\n# and re-read at every checkpoint so the session cannot drift.\n#\n# Usage:\n#   core/scripts/hq-pin.sh set  \"<goal>\" [--done \"<criterion>\"]... [--owner <name>] [--channel <dm-channel>]\n#   core/scripts/hq-pin.sh show                # print the pin (goal, done criteria, owner, channel, set-at)\n#   core/scripts/hq-pin.sh check               # print a one-line reminder for loop ticks; exit 3 if no pin\n#   core/scripts/hq-pin.sh note \"<progress>\"   # append a dated progress line under the pin\n#   core/scripts/hq-pin.sh clear               # remove the pin (the goal is met or withdrawn)\n#\n# Storage: workspace/sessions/<sid>/pin.md plus `pin: <goal>` in the session's\n";
-export type PinDependencies = {
-    root: string;
-    env: NodeJS.ProcessEnv;
-    now: () => Date;
-    tmpDir?: string;
-};
-export declare function resolvePinSessionId(root: string, env: NodeJS.ProcessEnv): string;
-export declare function runPin(args: string[], deps: PinDependencies): UtilityOutput;
-export declare function registerCorePinNative(core: Command): void;
-//# sourceMappingURL=core-pin-native.d.ts.map