@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/sdk/output-projection.js

@@ -1,431 +1,2 @@
-/**
- * @module sdk/output-projection
- *
- * Declares machine-readable field-group omissions for bounded command results.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="db6180ed-0b18-5bf8-bcc1-24171e2dfdc4")}catch(e){}}();
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-const MATERIAL_FIELD_GROUPS_BY_RESULT = new WeakMap();
-/** Register non-serialized materiality evidence used to keep omission receipts token-proportional. */
-export function registerOutputMaterialFieldGroups(result, fieldGroups) {
-    MATERIAL_FIELD_GROUPS_BY_RESULT.set(result, new Set(fieldGroups));
-}
-/** Universal selector for results carrying a {@link ReadRowContract}. */
-export const PM_READ_ROW_JQ_SELECTOR = '.row_contract.row_keys[] as $key | getpath($key | split(".")) | if type == "array" then .[] else if type == "object" then to_entries[] else empty end end';
-/** Static row declarations shared by CLI, SDK, MCP, and package consumers. */
-export const PM_READ_ROW_CONTRACTS = {
-    context: { row_keys: ["high_level", "low_level"], fields: "supported" },
-    get: { row_keys: ["children"], fields: "supported" },
-    list: { row_keys: ["items"], fields: "supported" },
-    next: {
-        row_keys: [
-            "recommended",
-            "ready",
-            "decision_needed",
-            "gate_needed",
-            "containers",
-            "blocked",
-            "held_by_others",
-        ],
-        fields: "unsupported",
-    },
-    search: { row_keys: ["items"], fields: "supported" },
-    activity: {
-        row_keys: [
-            "activity_digest",
-            "compact_activity",
-            "provenance_activity",
-            "activity",
-        ],
-        fields: "unsupported",
-    },
-    history: {
-        row_keys: ["compact_history", "provenance_history", "history"],
-        fields: "unsupported",
-    },
-    deps: {
-        row_keys: ["graph.nodes", "graph.edges", "context.nodes", "context.edges"],
-        fields: "unsupported",
-    },
-    health: { row_keys: ["checks"], fields: "unsupported" },
-    aggregate: { row_keys: ["groups"], fields: "unsupported" },
-    duplicates: { row_keys: ["clusters"], fields: "unsupported" },
-    stats: { row_keys: ["by_type", "by_status"], fields: "unsupported" },
-    comments: { row_keys: ["comments"], fields: "unsupported" },
-    notes: { row_keys: ["notes"], fields: "unsupported" },
-    learnings: { row_keys: ["learnings"], fields: "unsupported" },
-    files: { row_keys: ["files"], fields: "unsupported" },
-    docs: { row_keys: ["docs"], fields: "unsupported" },
-    validate: { row_keys: ["checks", "warnings"], fields: "unsupported" },
-    contracts: {
-        row_keys: ["command_summaries", "commands"],
-        fields: "unsupported",
-    },
-};
-/** Shared activity/history contract used by CLI, SDK, MCP, and conformance tests. */
-export const PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS = [
-    {
-        command: "activity",
-        complete_mode: "full",
-        omissions_by_mode: {
-            digest: [
-                {
-                    name: "event_rows",
-                    restore_with: "--raw",
-                },
-            ],
-            compact: [
-                {
-                    name: "provenance",
-                    restore_with: "--full",
-                },
-            ],
-            provenance: [
-                {
-                    name: "patch_and_hashes",
-                    restore_with: "--full",
-                },
-            ],
-        },
-    },
-    {
-        command: "history",
-        complete_mode: "full",
-        omissions_by_mode: {
-            compact: [
-                {
-                    name: "raw_history",
-                    restore_with: "--full",
-                },
-            ],
-            provenance: [
-                {
-                    name: "patch_and_hashes",
-                    restore_with: "--full",
-                },
-            ],
-        },
-    },
-];
-/** Reject a compact projection and its explicit full restoration when callers request both. */
-export function assertProjectionModeChoice(compactRequested, fullRequested, compactFlag) {
-    if (compactRequested && fullRequested) {
-        throw new PmCliError(`${compactFlag} cannot be combined with --full`, EXIT_CODE.USAGE);
-    }
-}
-/** Build an explicit constant-size receipt from declared and included groups. */
-export function createOutputOmissionReceipt(declaredGroups, includedGroupNames = new Set()) {
-    const omittedFieldGroups = declaredGroups
-        .filter((group) => !includedGroupNames.has(group.name))
-        .map((group) => ({ ...group }));
-    return {
-        has_omissions: omittedFieldGroups.length > 0,
-        omitted_field_group_count: omittedFieldGroups.length,
-        omitted_field_groups: omittedFieldGroups,
-    };
-}
-/** Resolve the receipt declared for one mode-paired command result. */
-export function resolveModePairedOutputOmissionReceipt(command, mode) {
-    const contract = PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS.find((candidate) => candidate.command === command);
-    if (contract === undefined) {
-        throw new TypeError(`Unknown mode-paired output command: ${command}`);
-    }
-    if (mode === contract.complete_mode) {
-        return createOutputOmissionReceipt([]);
-    }
-    const groups = contract.omissions_by_mode[mode];
-    if (groups === undefined) {
-        throw new TypeError(`Unknown ${command} output mode: ${mode}`);
-    }
-    return createOutputOmissionReceipt(groups);
-}
-const CONTEXT_FIELD_GROUPS = [
-    { name: "hierarchy", restore_with: "--depth standard" },
-    { name: "activity", restore_with: "--depth standard" },
-    { name: "progress", restore_with: "--depth standard" },
-    { name: "blockers", restore_with: "--depth standard" },
-    { name: "recently_created", restore_with: "--depth standard" },
-    { name: "unparented", restore_with: "--depth standard" },
-    { name: "files", restore_with: "--depth deep" },
-    { name: "workload", restore_with: "--depth standard" },
-    { name: "staleness", restore_with: "--depth deep" },
-    { name: "tests", restore_with: "--depth deep" },
-    { name: "workspace_memory", restore_with: "--depth deep" },
-];
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-const READ_ROW_TOON_ENCODINGS = new Set([
-    undefined,
-    "tabular_when_uniform",
-]);
-const READ_ROW_KINDS = new Set(["collection", "none"]);
-const READ_ROW_FIELD_MODES = new Set(["supported", "unsupported"]);
-function isUniqueNonEmptyStringArray(value, allowEmpty) {
-    return (Array.isArray(value) &&
-        (allowEmpty || value.length > 0) &&
-        value.every((entry) => typeof entry === "string" && entry.length > 0) &&
-        new Set(value).size === value.length);
-}
-/** Return whether an unknown value is a structurally valid row declaration. */
-export function isReadRowContract(value) {
-    return (isRecord(value) &&
-        typeof value.command === "string" &&
-        value.command.trim().length > 0 &&
-        READ_ROW_KINDS.has(value.row_kind) &&
-        isUniqueNonEmptyStringArray(value.row_keys, true) &&
-        (value.continuation_row_keys === undefined ||
-            isUniqueNonEmptyStringArray(value.continuation_row_keys, false)) &&
-        READ_ROW_FIELD_MODES.has(value.fields) &&
-        READ_ROW_TOON_ENCODINGS.has(value.toon_encoding) &&
-        (value.row_kind === "collection"
-            ? value.row_keys.length > 0 &&
-                typeof value.jq_selector === "string" &&
-                value.jq_selector.trim().length > 0
-            : value.row_keys.length === 0 && value.jq_selector === undefined));
-}
-const GRAPH_ROW_KEYS = {
-    ancestors: ["ids"],
-    descendants: ["ids"],
-    predecessors: ["ids"],
-    successors: ["ids"],
-    paths: ["paths"],
-    impact: ["affected"],
-    audit: ["findings"],
-    communities: ["communities"],
-    redundancy: ["redundant"],
-    dominators: ["bottlenecks"],
-    slack: ["rows"],
-    centrality: ["rows"],
-    articulation: ["articulation_points", "bridges"],
-    plan: ["steps"],
-};
-const READ_RESULT_SENTINEL_KEYS = {
-    context: ["sections_included", "high_level", "low_level"],
-    get: ["item"],
-    list: ["items", "projection"],
-    next: [
-        "recommended",
-        "ready",
-        "decision_needed",
-        "gate_needed",
-        "containers",
-        "blocked",
-        "held_by_others",
-    ],
-    search: ["items", "projection"],
-    activity: [
-        "activity_digest",
-        "compact_activity",
-        "provenance_activity",
-        "activity",
-    ],
-    history: ["compact_history", "provenance_history", "history"],
-    deps: ["tree", "graph", "projection"],
-    health: ["checks"],
-    aggregate: ["groups"],
-    duplicates: ["clusters"],
-    stats: ["totals", "by_type", "by_status"],
-    comments: ["comments"],
-    notes: ["notes"],
-    learnings: ["learnings"],
-    files: ["files"],
-    docs: ["docs"],
-    validate: ["checks", "warnings"],
-    contracts: ["command_summaries", "commands", "selected"],
-};
-/** Resolve one command's canonical row collection declaration. */
-export function resolveReadRowContract(command, result) {
-    const rawRootCommand = command.trim().toLowerCase().split(/\s+/u, 1)[0];
-    const rootCommand = rawRootCommand?.startsWith("list-")
-        ? "list"
-        : rawRootCommand;
-    if (rootCommand === "graph") {
-        const subcommand = typeof result.subcommand === "string" ? result.subcommand : "";
-        if (subcommand.length === 0)
-            return undefined;
-        const rowKeys = GRAPH_ROW_KEYS[subcommand];
-        if (rowKeys === undefined)
-            return undefined;
-        const activeRowKeys = rowKeys.filter((key) => Array.isArray(result[key]) || isRecord(result[key]));
-        return {
-            command: "graph",
-            row_kind: activeRowKeys.length > 0 ? "collection" : "none",
-            row_keys: activeRowKeys,
-            fields: "unsupported",
-            ...(activeRowKeys.length > 0
-                ? { jq_selector: PM_READ_ROW_JQ_SELECTOR }
-                : {}),
-            toon_encoding: "tabular_when_uniform",
-        };
-    }
-    const declaration = PM_READ_ROW_CONTRACTS[rootCommand];
-    const sentinelKeys = READ_RESULT_SENTINEL_KEYS[rootCommand];
-    return declaration === undefined ||
-        sentinelKeys === undefined ||
-        !sentinelKeys.some((key) => Object.hasOwn(result, key))
-        ? undefined
-        : (() => {
-            const rowKeys = declaration.row_keys.filter((key) => {
-                const value = key
-                    .split(".")
-                    .reduce((current, segment) => isRecord(current) ? current[segment] : undefined, result);
-                return Array.isArray(value) || isRecord(value);
-            });
-            return {
-                command: rootCommand,
-                row_kind: rowKeys.length > 0 ? "collection" : "none",
-                row_keys: rowKeys,
-                fields: declaration.fields,
-                ...(rowKeys.length > 0
-                    ? { jq_selector: PM_READ_ROW_JQ_SELECTOR }
-                    : {}),
-                toon_encoding: "tabular_when_uniform",
-            };
-        })();
-}
-function resolveDeclaredProjectionReceipt(result) {
-    if (!isRecord(result.projection))
-        return undefined;
-    if (typeof result.projection.mode !== "string" ||
-        result.projection.mode.trim().length === 0) {
-        return undefined;
-    }
-    const declared = result.projection.declared_field_groups;
-    const included = result.projection.included_field_groups;
-    if (!Array.isArray(declared) || !Array.isArray(included))
-        return undefined;
-    const declaredGroups = declared.filter((entry) => isRecord(entry) &&
-        typeof entry.name === "string" &&
-        entry.name.trim().length > 0 &&
-        typeof entry.restore_with === "string" &&
-        entry.restore_with.trim().length > 0);
-    const includedNames = included.filter((entry) => typeof entry === "string");
-    if (declaredGroups.length !== declared.length ||
-        includedNames.length !== included.length) {
-        return undefined;
-    }
-    const declaredNames = new Set(declaredGroups.map((group) => group.name));
-    if (declaredNames.size !== declaredGroups.length ||
-        new Set(includedNames).size !== includedNames.length ||
-        includedNames.some((name) => !declaredNames.has(name))) {
-        return undefined;
-    }
-    return createOutputOmissionReceipt(declaredGroups, new Set(includedNames));
-}
-function resolveContextReceipt(result) {
-    if (!Array.isArray(result.sections_included))
-        return undefined;
-    const receipt = createOutputOmissionReceipt(CONTEXT_FIELD_GROUPS, new Set(result.sections_included.filter((section) => typeof section === "string")));
-    if (isRecord(result.summary) && result.summary.scope === "matching_items") {
-        receipt.summary_scope = "matching_items";
-    }
-    return receipt;
-}
-function resolveGetReceipt(result) {
-    if (!isRecord(result.item))
-        return undefined;
-    const item = result.item;
-    const itemGroups = [
-        "comments",
-        "notes",
-        "learnings",
-        "files",
-        "tests",
-        "docs",
-        "reminders",
-        "events",
-    ];
-    const resultGroups = [
-        "body",
-        "children",
-        "claim_state",
-        "linked",
-        "schedule",
-    ];
-    const materialGroups = MATERIAL_FIELD_GROUPS_BY_RESULT.get(result);
-    const ownerFor = (name) => itemGroups.includes(name) || name === "body" ? item : result;
-    const groups = ["body", ...itemGroups, ...resultGroups.slice(1)]
-        .filter((name) => materialGroups === undefined ||
-        materialGroups.has(name) ||
-        Object.hasOwn(ownerFor(name), name))
-        .map((name) => ({
-        name,
-        restore_with: `--fields ${name}`,
-    }));
-    return createOutputOmissionReceipt(groups, new Set(groups.flatMap(({ name }) => !Object.hasOwn(ownerFor(name), name)
-        ? []
-        : [name])));
-}
-function resolveListOrSearchReceipt(result) {
-    if (!isRecord(result.projection))
-        return undefined;
-    return createOutputOmissionReceipt([{ name: "full_item_fields", restore_with: "--full" }], new Set(result.projection.mode === "full" ? ["full_item_fields"] : []));
-}
-function resolveHealthReceipt(result) {
-    if (!isRecord(result.projection))
-        return createOutputOmissionReceipt([]);
-    if (typeof result.projection.mode !== "string")
-        return undefined;
-    return createOutputOmissionReceipt([{ name: "full_check_details", restore_with: "--full" }], new Set(result.projection.mode === "full" ? ["full_check_details"] : []));
-}
-function resolveContractsReceipt(result) {
-    if (!isRecord(result.selected) ||
-        typeof result.selected.summary !== "boolean") {
-        return undefined;
-    }
-    return createOutputOmissionReceipt([{ name: "full_contract_catalog", restore_with: "--full" }], new Set(result.selected.summary ? [] : ["full_contract_catalog"]));
-}
-/** Derive a receipt from one built-in read result without changing its rows. */
-export function resolveOutputOmissionReceipt(command, result) {
-    const declaredReceipt = resolveDeclaredProjectionReceipt(result);
-    if (declaredReceipt !== undefined)
-        return declaredReceipt;
-    const [rootCommand] = command.split(/\s+/u, 1);
-    if (rootCommand === "context")
-        return resolveContextReceipt(result);
-    if (rootCommand === "get")
-        return resolveGetReceipt(result);
-    if (rootCommand === "list" || rootCommand.startsWith("list-")) {
-        return resolveListOrSearchReceipt(result);
-    }
-    if (rootCommand === "search") {
-        return (resolveListOrSearchReceipt(result) ??
-            createOutputOmissionReceipt([
-                { name: "projection_metadata", restore_with: "--full" },
-            ]));
-    }
-    if (rootCommand === "health")
-        return resolveHealthReceipt(result);
-    if (rootCommand === "contracts")
-        return resolveContractsReceipt(result);
-    return undefined;
-}
-/**
- * Attach a receipt to built-in read results that already expose enough
- * projection state to derive omissions without repeating command logic.
- */
-export function attachOutputOmissionReceipt(command, result) {
-    if (command === undefined || !isRecord(result)) {
-        return result;
-    }
-    const receipt = resolveOutputOmissionReceipt(command, result);
-    const declaredRowContract = result.row_contract;
-    const rowContract = isReadRowContract(declaredRowContract)
-        ? declaredRowContract
-        : resolveReadRowContract(command, result);
-    const disclosedResult = rowContract !== undefined
-        ? { ...result, row_contract: rowContract }
-        : Object.hasOwn(result, "row_contract")
-            ? Object.fromEntries(Object.entries(result).filter(([key]) => key !== "row_contract"))
-            : result;
-    if (isRecord(disclosedResult.omission_receipt))
-        return disclosedResult;
-    return receipt === undefined
-        ? disclosedResult
-        : { ...disclosedResult, omission_receipt: receipt };
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6c87b004-3647-531a-9599-d37fd91c2807")}catch(e2){}})();import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";const MATERIAL_FIELD_GROUPS_BY_RESULT=new WeakMap;function registerOutputMaterialFieldGroups(result,fieldGroups){MATERIAL_FIELD_GROUPS_BY_RESULT.set(result,new Set(fieldGroups))}const PM_READ_ROW_JQ_SELECTOR='.row_contract.row_keys[] as $key | getpath($key | split(".")) | if type == "array" then .[] else if type == "object" then to_entries[] else empty end end';const PM_READ_ROW_CONTRACTS={context:{row_keys:["high_level","low_level"],fields:"supported"},get:{row_keys:["children"],fields:"supported"},list:{row_keys:["items"],fields:"supported"},next:{row_keys:["recommended","ready","decision_needed","gate_needed","containers","blocked","held_by_others"],fields:"unsupported"},search:{row_keys:["items"],fields:"supported"},activity:{row_keys:["activity_digest","compact_activity","provenance_activity","activity"],fields:"unsupported"},history:{row_keys:["compact_history","provenance_history","history"],fields:"unsupported"},deps:{row_keys:["graph.nodes","graph.edges","context.nodes","context.edges"],fields:"unsupported"},health:{row_keys:["checks"],fields:"unsupported"},aggregate:{row_keys:["groups"],fields:"unsupported"},duplicates:{row_keys:["clusters"],fields:"unsupported"},stats:{row_keys:["by_type","by_status"],fields:"unsupported"},comments:{row_keys:["comments"],fields:"unsupported"},notes:{row_keys:["notes"],fields:"unsupported"},learnings:{row_keys:["learnings"],fields:"unsupported"},files:{row_keys:["files"],fields:"unsupported"},docs:{row_keys:["docs"],fields:"unsupported"},validate:{row_keys:["checks","warnings"],fields:"unsupported"},contracts:{row_keys:["command_summaries","commands"],fields:"unsupported"}};const PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS=[{command:"activity",complete_mode:"full",omissions_by_mode:{digest:[{name:"event_rows",restore_with:"--raw"}],compact:[{name:"provenance",restore_with:"--full"}],provenance:[{name:"patch_and_hashes",restore_with:"--full"}]}},{command:"history",complete_mode:"full",omissions_by_mode:{compact:[{name:"raw_history",restore_with:"--full"}],provenance:[{name:"patch_and_hashes",restore_with:"--full"}]}}];function assertProjectionModeChoice(compactRequested,fullRequested,compactFlag){if(compactRequested&&fullRequested){throw new PmCliError(`${compactFlag} cannot be combined with --full`,EXIT_CODE.USAGE)}}function createOutputOmissionReceipt(declaredGroups,includedGroupNames=new Set){const omittedFieldGroups=declaredGroups.filter(group=>!includedGroupNames.has(group.name)).map(group=>({...group}));return{has_omissions:omittedFieldGroups.length>0,omitted_field_group_count:omittedFieldGroups.length,omitted_field_groups:omittedFieldGroups}}function resolveModePairedOutputOmissionReceipt(command,mode){const contract=PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS.find(candidate=>candidate.command===command);if(contract===void 0){throw new TypeError(`Unknown mode-paired output command: ${command}`)}if(mode===contract.complete_mode){return createOutputOmissionReceipt([])}const groups=contract.omissions_by_mode[mode];if(groups===void 0){throw new TypeError(`Unknown ${command} output mode: ${mode}`)}return createOutputOmissionReceipt(groups)}const CONTEXT_FIELD_GROUPS=[{name:"hierarchy",restore_with:"--depth standard"},{name:"activity",restore_with:"--depth standard"},{name:"progress",restore_with:"--depth standard"},{name:"blockers",restore_with:"--depth standard"},{name:"recently_created",restore_with:"--depth standard"},{name:"unparented",restore_with:"--depth standard"},{name:"files",restore_with:"--depth deep"},{name:"workload",restore_with:"--depth standard"},{name:"staleness",restore_with:"--depth deep"},{name:"tests",restore_with:"--depth deep"},{name:"workspace_memory",restore_with:"--depth deep"}];function isRecord(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)}const READ_ROW_TOON_ENCODINGS=new Set([void 0,"tabular_when_uniform"]);const READ_ROW_KINDS=new Set(["collection","none"]);const READ_ROW_FIELD_MODES=new Set(["supported","unsupported"]);function isUniqueNonEmptyStringArray(value,allowEmpty){return Array.isArray(value)&&(allowEmpty||value.length>0)&&value.every(entry=>typeof entry==="string"&&entry.length>0)&&new Set(value).size===value.length}function isReadRowContract(value){return isRecord(value)&&typeof value.command==="string"&&value.command.trim().length>0&&READ_ROW_KINDS.has(value.row_kind)&&isUniqueNonEmptyStringArray(value.row_keys,true)&&(value.continuation_row_keys===void 0||isUniqueNonEmptyStringArray(value.continuation_row_keys,false))&&READ_ROW_FIELD_MODES.has(value.fields)&&READ_ROW_TOON_ENCODINGS.has(value.toon_encoding)&&(value.row_kind==="collection"?value.row_keys.length>0&&typeof value.jq_selector==="string"&&value.jq_selector.trim().length>0:value.row_keys.length===0&&value.jq_selector===void 0)}const GRAPH_ROW_KEYS={ancestors:["ids"],descendants:["ids"],predecessors:["ids"],successors:["ids"],paths:["paths"],impact:["affected"],audit:["findings"],communities:["communities"],redundancy:["redundant"],dominators:["bottlenecks"],slack:["rows"],centrality:["rows"],articulation:["articulation_points","bridges"],plan:["steps"]};const READ_RESULT_SENTINEL_KEYS={context:["sections_included","high_level","low_level"],get:["item"],list:["items","projection"],next:["recommended","ready","decision_needed","gate_needed","containers","blocked","held_by_others"],search:["items","projection"],activity:["activity_digest","compact_activity","provenance_activity","activity"],history:["compact_history","provenance_history","history"],deps:["tree","graph","projection"],health:["checks"],aggregate:["groups"],duplicates:["clusters"],stats:["totals","by_type","by_status"],comments:["comments"],notes:["notes"],learnings:["learnings"],files:["files"],docs:["docs"],validate:["checks","warnings"],contracts:["command_summaries","commands","selected"]};function resolveReadRowContract(command,result){const rawRootCommand=command.trim().toLowerCase().split(/\s+/u,1)[0];const rootCommand=rawRootCommand?.startsWith("list-")?"list":rawRootCommand;if(rootCommand==="graph"){const subcommand=typeof result.subcommand==="string"?result.subcommand:"";if(subcommand.length===0)return void 0;const rowKeys=GRAPH_ROW_KEYS[subcommand];if(rowKeys===void 0)return void 0;const activeRowKeys=rowKeys.filter(key=>Array.isArray(result[key])||isRecord(result[key]));return{command:"graph",row_kind:activeRowKeys.length>0?"collection":"none",row_keys:activeRowKeys,fields:"unsupported",...activeRowKeys.length>0?{jq_selector:PM_READ_ROW_JQ_SELECTOR}:{},toon_encoding:"tabular_when_uniform"}}const declaration=PM_READ_ROW_CONTRACTS[rootCommand];const sentinelKeys=READ_RESULT_SENTINEL_KEYS[rootCommand];return declaration===void 0||sentinelKeys===void 0||!sentinelKeys.some(key=>Object.hasOwn(result,key))?void 0:(()=>{const rowKeys=declaration.row_keys.filter(key=>{const value=key.split(".").reduce((current,segment)=>isRecord(current)?current[segment]:void 0,result);return Array.isArray(value)||isRecord(value)});return{command:rootCommand,row_kind:rowKeys.length>0?"collection":"none",row_keys:rowKeys,fields:declaration.fields,...rowKeys.length>0?{jq_selector:PM_READ_ROW_JQ_SELECTOR}:{},toon_encoding:"tabular_when_uniform"}})()}function resolveDeclaredProjectionReceipt(result){if(!isRecord(result.projection))return void 0;if(typeof result.projection.mode!=="string"||result.projection.mode.trim().length===0){return void 0}const declared=result.projection.declared_field_groups;const included=result.projection.included_field_groups;if(!Array.isArray(declared)||!Array.isArray(included))return void 0;const declaredGroups=declared.filter(entry=>isRecord(entry)&&typeof entry.name==="string"&&entry.name.trim().length>0&&typeof entry.restore_with==="string"&&entry.restore_with.trim().length>0);const includedNames=included.filter(entry=>typeof entry==="string");if(declaredGroups.length!==declared.length||includedNames.length!==included.length){return void 0}const declaredNames=new Set(declaredGroups.map(group=>group.name));if(declaredNames.size!==declaredGroups.length||new Set(includedNames).size!==includedNames.length||includedNames.some(name=>!declaredNames.has(name))){return void 0}return createOutputOmissionReceipt(declaredGroups,new Set(includedNames))}function resolveContextReceipt(result){if(!Array.isArray(result.sections_included))return void 0;const receipt=createOutputOmissionReceipt(CONTEXT_FIELD_GROUPS,new Set(result.sections_included.filter(section=>typeof section==="string")));if(isRecord(result.summary)&&result.summary.scope==="matching_items"){receipt.summary_scope="matching_items"}return receipt}function resolveGetReceipt(result){if(!isRecord(result.item))return void 0;const item=result.item;const itemGroups=["comments","notes","learnings","files","tests","docs","reminders","events"];const resultGroups=["body","children","claim_state","linked","schedule"];const materialGroups=MATERIAL_FIELD_GROUPS_BY_RESULT.get(result);const ownerFor=name=>itemGroups.includes(name)||name==="body"?item:result;const groups=["body",...itemGroups,...resultGroups.slice(1)].filter(name=>materialGroups===void 0||materialGroups.has(name)||Object.hasOwn(ownerFor(name),name)).map(name=>({name,restore_with:`--fields ${name}`}));return createOutputOmissionReceipt(groups,new Set(groups.flatMap(({name})=>!Object.hasOwn(ownerFor(name),name)?[]:[name])))}function resolveListOrSearchReceipt(result){if(!isRecord(result.projection))return void 0;return createOutputOmissionReceipt([{name:"full_item_fields",restore_with:"--full"}],new Set(result.projection.mode==="full"?["full_item_fields"]:[]))}function resolveHealthReceipt(result){if(!isRecord(result.projection))return createOutputOmissionReceipt([]);if(typeof result.projection.mode!=="string")return void 0;return createOutputOmissionReceipt([{name:"full_check_details",restore_with:"--full"}],new Set(result.projection.mode==="full"?["full_check_details"]:[]))}function resolveContractsReceipt(result){if(!isRecord(result.selected)||typeof result.selected.summary!=="boolean"){return void 0}return createOutputOmissionReceipt([{name:"full_contract_catalog",restore_with:"--full"}],new Set(result.selected.summary?[]:["full_contract_catalog"]))}function resolveOutputOmissionReceipt(command,result){const declaredReceipt=resolveDeclaredProjectionReceipt(result);if(declaredReceipt!==void 0)return declaredReceipt;const[rootCommand]=command.split(/\s+/u,1);if(rootCommand==="context")return resolveContextReceipt(result);if(rootCommand==="get")return resolveGetReceipt(result);if(rootCommand==="list"||rootCommand.startsWith("list-")){return resolveListOrSearchReceipt(result)}if(rootCommand==="search"){return resolveListOrSearchReceipt(result)??createOutputOmissionReceipt([{name:"projection_metadata",restore_with:"--full"}])}if(rootCommand==="health")return resolveHealthReceipt(result);if(rootCommand==="contracts")return resolveContractsReceipt(result);return void 0}function attachOutputOmissionReceipt(command,result){if(command===void 0||!isRecord(result)){return result}const receipt=resolveOutputOmissionReceipt(command,result);const declaredRowContract=result.row_contract;const rowContract=isReadRowContract(declaredRowContract)?declaredRowContract:resolveReadRowContract(command,result);const disclosedResult=rowContract!==void 0?{...result,row_contract:rowContract}:Object.hasOwn(result,"row_contract")?Object.fromEntries(Object.entries(result).filter(([key])=>key!=="row_contract")):result;if(isRecord(disclosedResult.omission_receipt))return disclosedResult;return receipt===void 0?disclosedResult:{...disclosedResult,omission_receipt:receipt}}export{PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS,PM_READ_ROW_CONTRACTS,PM_READ_ROW_JQ_SELECTOR,assertProjectionModeChoice,attachOutputOmissionReceipt,createOutputOmissionReceipt,isReadRowContract,registerOutputMaterialFieldGroups,resolveModePairedOutputOmissionReceipt,resolveOutputOmissionReceipt,resolveReadRowContract};
 //# sourceMappingURL=output-projection.js.map
-//# debugId=db6180ed-0b18-5bf8-bcc1-24171e2dfdc4

package/dist/sdk/output-token-accounting.js

@@ -1,141 +1,2 @@
-/**
- * @module sdk/output-token-accounting
- *
- * Provides transport-neutral, opt-in attribution for the bytes emitted by a pm
- * command. The receipt deliberately excludes itself from the accounted total,
- * while reporting its own independently measured overhead.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="02baf966-46eb-5e19-b7eb-2f9fe05bb263")}catch(e){}}();
-import { estimatePmOutputTokens } from "./cli-contracts/agent-output-contracts.js";
-const SECTION_ORDER = [
-    "result_rows",
-    "envelope",
-    "diagnostics",
-    "hints",
-];
-const ROW_KEYS = /^(?:items|results|rows|ready|blocked|recommended|decision_needed|children|dependencies|events|matches|commands|tools)$/u;
-const DIAGNOSTIC_KEYS = /^(?:diagnostics|errors?|warnings?|findings|violations|failures?)$/u;
-const HINT_KEYS = /^(?:hints?|suggestions?|next_steps?|recovery|remediation|examples?)$/u;
-const MAX_RECEIPT_STABILIZATION_PASSES = 8;
-function utf8Bytes(value) {
-    return Buffer.byteLength(value, "utf8");
-}
-function canonicalJsonBytes(value) {
-    return utf8Bytes(JSON.stringify(value) ?? "null");
-}
-function sectionForEntry(key, value) {
-    if (DIAGNOSTIC_KEYS.test(key))
-        return "diagnostics";
-    if (HINT_KEYS.test(key))
-        return "hints";
-    if (ROW_KEYS.test(key) || Array.isArray(value))
-        return "result_rows";
-    return "envelope";
-}
-function collectSectionWeights(result) {
-    const weights = {
-        result_rows: 0,
-        envelope: 0,
-        diagnostics: 0,
-        hints: 0,
-    };
-    if (typeof result !== "object" || result === null || Array.isArray(result)) {
-        weights[Array.isArray(result) ? "result_rows" : "envelope"] =
-            canonicalJsonBytes(result);
-        return weights;
-    }
-    for (const [key, value] of Object.entries(result)) {
-        weights[sectionForEntry(key, value)] += canonicalJsonBytes({
-            [key]: value,
-        });
-    }
-    if (Object.values(weights).every((weight) => weight === 0)) {
-        weights.envelope = 1;
-    }
-    return weights;
-}
-function allocateExactBytes(totalBytes, weights) {
-    const weightTotal = SECTION_ORDER.reduce((total, section) => total + weights[section], 0);
-    const exact = SECTION_ORDER.map((section) => ({
-        section,
-        value: (totalBytes * weights[section]) / weightTotal,
-    }));
-    const allocated = {
-        result_rows: 0,
-        envelope: 0,
-        diagnostics: 0,
-        hints: 0,
-    };
-    for (const entry of exact)
-        allocated[entry.section] = Math.floor(entry.value);
-    let remainder = totalBytes -
-        SECTION_ORDER.reduce((total, section) => total + allocated[section], 0);
-    for (const entry of [...exact].sort((left, right) => right.value -
-        Math.floor(right.value) -
-        (left.value - Math.floor(left.value)) ||
-        SECTION_ORDER.indexOf(left.section) -
-            SECTION_ORDER.indexOf(right.section))) {
-        if (remainder === 0)
-            break;
-        allocated[entry.section] += 1;
-        remainder -= 1;
-    }
-    return allocated;
-}
-function attachReceipt(result, receipt) {
-    if (typeof result === "object" && result !== null && !Array.isArray(result)) {
-        return {
-            ...result,
-            token_accounting: receipt,
-        };
-    }
-    return {
-        result,
-        token_accounting: receipt,
-    };
-}
-/**
- * Attach a deterministic receipt for exactly the bytes produced by
- * {@link render} before accounting. The renderer is supplied by the transport,
- * so CLI TOON/JSON, MCP JSON, and package-defined hosts all measure their real
- * representation rather than a guessed intermediate shape.
- */
-export function attachOutputTokenAccounting(result, render) {
-    const originalBytes = utf8Bytes(render(result));
-    const allocatedBytes = allocateExactBytes(originalBytes, collectSectionWeights(result));
-    const sections = Object.fromEntries(SECTION_ORDER.map((section) => [
-        section,
-        {
-            bytes: allocatedBytes[section],
-            estimated_tokens: estimatePmOutputTokens(allocatedBytes[section]),
-        },
-    ]));
-    let receipt = {
-        version: 1,
-        measurement_scope: "output_before_token_accounting",
-        estimator: "ceil(utf8_bytes / 4)",
-        total_bytes: originalBytes,
-        total_estimated_tokens: estimatePmOutputTokens(originalBytes),
-        sections,
-        accounting_receipt_bytes: 0,
-        accounting_receipt_estimated_tokens: 0,
-        excluded_fields: ["token_accounting"],
-        section_allocation: "proportional_canonical_json",
-    };
-    let accounted = attachReceipt(result, receipt);
-    for (let pass = 0; pass < MAX_RECEIPT_STABILIZATION_PASSES; pass += 1) {
-        const measuredReceiptBytes = utf8Bytes(render(accounted)) - originalBytes;
-        if (measuredReceiptBytes === receipt.accounting_receipt_bytes)
-            return accounted;
-        receipt = {
-            ...receipt,
-            accounting_receipt_bytes: measuredReceiptBytes,
-            accounting_receipt_estimated_tokens: estimatePmOutputTokens(measuredReceiptBytes),
-        };
-        accounted = attachReceipt(result, receipt);
-    }
-    return accounted;
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="83c82348-64f8-5f10-9396-b03add0b7932")}catch(e2){}})();import{estimatePmOutputTokens}from"./cli-contracts/agent-output-contracts.js";const SECTION_ORDER=["result_rows","envelope","diagnostics","hints"];const ROW_KEYS=/^(?:items|results|rows|ready|blocked|recommended|decision_needed|children|dependencies|events|matches|commands|tools)$/u;const DIAGNOSTIC_KEYS=/^(?:diagnostics|errors?|warnings?|findings|violations|failures?)$/u;const HINT_KEYS=/^(?:hints?|suggestions?|next_steps?|recovery|remediation|examples?)$/u;const MAX_RECEIPT_STABILIZATION_PASSES=8;function utf8Bytes(value){return Buffer.byteLength(value,"utf8")}function canonicalJsonBytes(value){return utf8Bytes(JSON.stringify(value)??"null")}function sectionForEntry(key,value){if(DIAGNOSTIC_KEYS.test(key))return"diagnostics";if(HINT_KEYS.test(key))return"hints";if(ROW_KEYS.test(key)||Array.isArray(value))return"result_rows";return"envelope"}function collectSectionWeights(result){const weights={result_rows:0,envelope:0,diagnostics:0,hints:0};if(typeof result!=="object"||result===null||Array.isArray(result)){weights[Array.isArray(result)?"result_rows":"envelope"]=canonicalJsonBytes(result);return weights}for(const[key,value]of Object.entries(result)){weights[sectionForEntry(key,value)]+=canonicalJsonBytes({[key]:value})}if(Object.values(weights).every(weight=>weight===0)){weights.envelope=1}return weights}function allocateExactBytes(totalBytes,weights){const weightTotal=SECTION_ORDER.reduce((total,section)=>total+weights[section],0);const exact=SECTION_ORDER.map(section=>({section,value:totalBytes*weights[section]/weightTotal}));const allocated={result_rows:0,envelope:0,diagnostics:0,hints:0};for(const entry of exact)allocated[entry.section]=Math.floor(entry.value);let remainder=totalBytes-SECTION_ORDER.reduce((total,section)=>total+allocated[section],0);for(const entry of[...exact].sort((left,right)=>right.value-Math.floor(right.value)-(left.value-Math.floor(left.value))||SECTION_ORDER.indexOf(left.section)-SECTION_ORDER.indexOf(right.section))){if(remainder===0)break;allocated[entry.section]+=1;remainder-=1}return allocated}function attachReceipt(result,receipt){if(typeof result==="object"&&result!==null&&!Array.isArray(result)){return{...result,token_accounting:receipt}}return{result,token_accounting:receipt}}function attachOutputTokenAccounting(result,render){const originalBytes=utf8Bytes(render(result));const allocatedBytes=allocateExactBytes(originalBytes,collectSectionWeights(result));const sections=Object.fromEntries(SECTION_ORDER.map(section=>[section,{bytes:allocatedBytes[section],estimated_tokens:estimatePmOutputTokens(allocatedBytes[section])}]));let receipt={version:1,measurement_scope:"output_before_token_accounting",estimator:"ceil(utf8_bytes / 4)",total_bytes:originalBytes,total_estimated_tokens:estimatePmOutputTokens(originalBytes),sections,accounting_receipt_bytes:0,accounting_receipt_estimated_tokens:0,excluded_fields:["token_accounting"],section_allocation:"proportional_canonical_json"};let accounted=attachReceipt(result,receipt);for(let pass=0;pass<MAX_RECEIPT_STABILIZATION_PASSES;pass+=1){const measuredReceiptBytes=utf8Bytes(render(accounted))-originalBytes;if(measuredReceiptBytes===receipt.accounting_receipt_bytes)return accounted;receipt={...receipt,accounting_receipt_bytes:measuredReceiptBytes,accounting_receipt_estimated_tokens:estimatePmOutputTokens(measuredReceiptBytes)};accounted=attachReceipt(result,receipt)}return accounted}export{attachOutputTokenAccounting};
 //# sourceMappingURL=output-token-accounting.js.map
-//# debugId=02baf966-46eb-5e19-b7eb-2f9fe05bb263