@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/sdk/context-usage.js

@@ -1,368 +1,2 @@
-/**
- * @module sdk/context-usage
- *
- * Privacy-minimal, derived context-usage feedback primitives. The JSONL ledger
- * contains only item ids, timestamps, authors, ranks, profiles, and command
- * intents; it never enters item history and is safe to delete or rebuild.
- * Persistence requires trusted, stable workspace directory entries and
- * ancestors. For a workspace writable by an untrusted concurrent actor, set
- * PM_CONTEXT_USAGE_DISABLED=1 or use an isolated copy owned by the caller.
- */
-
-!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]="b1b1aa19-b1de-5140-8aea-ee1994ee9ecd")}catch(e){}}();
-import { randomUUID } from "node:crypto";
-import { appendEvents, readEvents, resolveNow, ContextUsageValidationError, CONTEXT_USAGE_LIMITS, } from "./context/usage-ledger.js";
-export { ContextUsageValidationError, CONTEXT_USAGE_LIMITS } from "./context/usage-ledger.js";
-const DAY_MS = 86_400_000;
-const CONTEXT_USAGE_SERVING_RECEIPT = Symbol.for("@unbrained/pm-cli/context-usage-serving-receipt");
-function asObjectRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value)
-        ? value
-        : null;
-}
-/** Attach a JSON-invisible serving receipt to a result for later egress. */
-export function attachContextUsageServingReceipt(result, receipt) {
-    const record = asObjectRecord(result);
-    if (record !== null && receipt !== null) {
-        record[CONTEXT_USAGE_SERVING_RECEIPT] = receipt;
-    }
-}
-/** Copy an attached serving receipt across a result projection boundary. */
-export function propagateContextUsageServingReceipt(source, target) {
-    const sourceRecord = asObjectRecord(source);
-    const targetRecord = asObjectRecord(target);
-    const receipt = sourceRecord?.[CONTEXT_USAGE_SERVING_RECEIPT];
-    if (targetRecord !== null && receipt !== undefined) {
-        targetRecord[CONTEXT_USAGE_SERVING_RECEIPT] = receipt;
-    }
-}
-function receiptFromResult(result) {
-    return (asObjectRecord(result)?.[CONTEXT_USAGE_SERVING_RECEIPT] ?? null);
-}
-function resultReceiptSaysOmitted(result) {
-    const record = asObjectRecord(result);
-    for (const key of ["read_output", "context_intent"]) {
-        const receipt = asObjectRecord(record?.[key]);
-        if (receipt?.result_omitted === true)
-            return true;
-    }
-    return false;
-}
-function addContextUsageId(ids, value) {
-    if (typeof value === "string" && value.trim().length > 0) {
-        ids.add(value.trim());
-    }
-}
-function addContextUsageDirectRows(ids, value) {
-    if (!Array.isArray(value))
-        return;
-    for (const row of value) {
-        addContextUsageId(ids, asObjectRecord(row)?.id);
-    }
-}
-function addContextUsageIdList(ids, value) {
-    if (!Array.isArray(value))
-        return;
-    for (const itemId of value)
-        addContextUsageId(ids, itemId);
-}
-function collectNextResultItemIds(record, ids) {
-    const rows = asObjectRecord(record.recommended) === null
-        ? []
-        : [record.recommended];
-    for (const key of ["ready", "decision_needed", "gate_needed", "containers", "blocked", "held_by_others"]) {
-        if (Array.isArray(record[key]))
-            rows.push(...record[key]);
-    }
-    for (const value of rows) {
-        const row = asObjectRecord(value);
-        addContextUsageId(ids, row?.id);
-        for (const blocker of Array.isArray(row?.blockers) ? row.blockers : []) {
-            addContextUsageId(ids, asObjectRecord(blocker)?.id);
-        }
-        for (const unblockedId of Array.isArray(row?.unblocks)
-            ? row.unblocks
-            : []) {
-            addContextUsageId(ids, unblockedId);
-        }
-    }
-}
-function collectContextResultItemIds(record, ids) {
-    for (const key of [
-        "high_level",
-        "low_level",
-        "blocked_fallback",
-        "recently_created",
-        "unparented",
-        "activity",
-        "progress",
-        "blockers",
-        "staleness",
-    ]) {
-        addContextUsageDirectRows(ids, record[key]);
-    }
-    for (const value of Array.isArray(record.blockers)
-        ? record.blockers
-        : []) {
-        addContextUsageId(ids, asObjectRecord(value)?.blocked_by);
-    }
-    collectContextNestedItemIds(record, ids);
-}
-function collectContextNestedItemIds(record, ids) {
-    for (const value of Array.isArray(record.hierarchy)
-        ? record.hierarchy
-        : []) {
-        const node = asObjectRecord(value);
-        addContextUsageId(ids, node?.id);
-        addContextUsageDirectRows(ids, node?.children);
-    }
-    for (const key of ["files", "workload"]) {
-        for (const value of Array.isArray(record[key]) ? record[key] : []) {
-            addContextUsageIdList(ids, asObjectRecord(value)?.items);
-        }
-    }
-    const agenda = asObjectRecord(record.agenda);
-    for (const value of Array.isArray(agenda?.events) ? agenda.events : []) {
-        addContextUsageId(ids, asObjectRecord(value)?.item_id);
-    }
-    const tests = asObjectRecord(record.tests);
-    addContextUsageIdList(ids, tests?.items_failing);
-}
-/**
- * Collect every item identifier visible in a final context or next result.
- * The traversal is shape-aware so summary counters and unrelated identifier
- * fields cannot enter the privacy-minimal usage ledger.
- */
-export function collectContextUsageDeliveredItemIds(result, surface) {
-    const record = asObjectRecord(result);
-    if (record === null || resultReceiptSaysOmitted(result))
-        return [];
-    const ids = new Set();
-    if (surface === "next") {
-        collectNextResultItemIds(record, ids);
-    }
-    else {
-        collectContextResultItemIds(record, ids);
-    }
-    return [...ids];
-}
-/** Resolve and append one post-egress decision carried by a context result. */
-export async function finalizeContextUsageDelivery(options) {
-    const receipt = receiptFromResult(options.result);
-    if (receipt === null)
-        return false;
-    const resultOmitted = resultReceiptSaysOmitted(options.result);
-    await recordContextUsageDelivery({
-        pmRoot: options.pmRoot,
-        receipt,
-        deliveredItemIds: collectContextUsageDeliveredItemIds(options.result, receipt.surface),
-        resultOmitted,
-    });
-    return true;
-}
-/** Records a bounded prefix of ranked context candidates with explicit sampling counts. */
-export async function recordContextUsageServing(options) {
-    if ([
-        process.env.PM_CONTEXT_USAGE_DISABLED === "1",
-        options.enabled === false,
-    ].includes(true))
-        return null;
-    if (!options.author.trim() ||
-        options.rows.some((row) => !row.id.trim() || !Number.isInteger(row.rank) || row.rank < 1)) {
-        throw new ContextUsageValidationError("Context usage serving requires an author and valid ranked rows");
-    }
-    const normalizedRows = options.rows.map((row) => ({
-        id: row.id.trim(),
-        rank: row.rank,
-        included: row.included,
-    }));
-    if (new Set(normalizedRows.map((row) => row.id)).size !== normalizedRows.length) {
-        throw new ContextUsageValidationError("Context usage serving requires unique normalized row ids");
-    }
-    const recordedRows = normalizedRows.slice(0, CONTEXT_USAGE_LIMITS.max_serving_rows);
-    const receipt = {
-        serve_id: randomUUID(),
-        author: options.author.trim(),
-        surface: options.surface,
-        rows: normalizedRows,
-        recorded_item_ids: recordedRows.map((row) => row.id),
-    };
-    receipt.storage = await appendEvents(options, [{
-            kind: "serve",
-            schema_version: 2,
-            serve_id: receipt.serve_id,
-            at: resolveNow(options).iso,
-            author: options.author.trim(),
-            surface: options.surface,
-            profile: options.profile.trim() || "balanced",
-            rows: recordedRows,
-            candidate_count: normalizedRows.length,
-            omitted_row_count: normalizedRows.length - recordedRows.length,
-            result_omitted: false,
-            packed_item_ids: recordedRows
-                .filter((row) => row.included)
-                .map((row) => row.id),
-        }]);
-    return receipt;
-}
-/** Append the exact post-egress delivery decision for one serving receipt. */
-export async function recordContextUsageDelivery(options) {
-    if (options.receipt === null ||
-        process.env.PM_CONTEXT_USAGE_DISABLED === "1" ||
-        options.enabled === false) {
-        return;
-    }
-    const rankedIds = new Set(options.receipt.rows.map((row) => row.id));
-    const deliveredItemIds = [
-        ...new Set(options.deliveredItemIds.map((id) => id.trim())),
-    ];
-    if (deliveredItemIds.some((id) => id.length === 0 || !rankedIds.has(id)) ||
-        (options.resultOmitted && deliveredItemIds.length > 0)) {
-        throw new ContextUsageValidationError("Context usage delivery requires emitted ranked ids and zero ids for an omitted result");
-    }
-    const recordedIds = new Set(options.receipt.recorded_item_ids ?? options.receipt.rows.map((row) => row.id));
-    const delivery = {
-        kind: "delivery",
-        schema_version: 2,
-        serve_id: options.receipt.serve_id,
-        at: resolveNow(options).iso,
-        author: options.receipt.author,
-        surface: options.receipt.surface,
-        result_omitted: options.resultOmitted,
-        delivered_item_ids: deliveredItemIds.filter((id) => recordedIds.has(id)),
-    };
-    await appendEvents(options, [delivery], delivery.serve_id);
-}
-/** Records one subsequent item read or mutation outcome. */
-export async function recordContextUsageTouch(options) {
-    if (process.env.PM_CONTEXT_USAGE_DISABLED === "1" ||
-        options.enabled === false)
-        return;
-    if (!options.author.trim() ||
-        !options.itemId.trim() ||
-        !options.intent.trim()) {
-        throw new ContextUsageValidationError("Context usage touch requires author, itemId, and intent");
-    }
-    await appendEvents(options, [{
-            kind: "touch",
-            at: resolveNow(options).iso,
-            author: options.author.trim(),
-            item_id: options.itemId.trim(),
-            intent: options.intent.trim(),
-        }]);
-}
-/**
- * Records mutation outcomes as one append and one optional compaction pass.
- */
-export async function recordContextUsageTouches(options) {
-    if (process.env.PM_CONTEXT_USAGE_DISABLED === "1" ||
-        options.enabled === false ||
-        options.itemIds.length === 0)
-        return;
-    const author = options.author.trim();
-    const intent = options.intent.trim();
-    if (!author || !intent) {
-        throw new ContextUsageValidationError("Context usage touch requires author and intent");
-    }
-    const itemIds = new Set();
-    for (const itemId of options.itemIds) {
-        if (typeof itemId !== "string") {
-            throw new ContextUsageValidationError("Context usage touch requires string itemIds");
-        }
-        const trimmedId = itemId.trim();
-        if (!trimmedId)
-            throw new ContextUsageValidationError("Context usage touch requires non-empty itemId");
-        itemIds.add(trimmedId);
-    }
-    const at = resolveNow(options).iso;
-    const events = [...itemIds].map((itemId) => ({
-        kind: "touch",
-        at,
-        author,
-        item_id: itemId,
-        intent,
-    }));
-    await appendEvents(options, events);
-}
-function findTouchTimeInHorizon(touches, itemId, servedAt, horizonMs) {
-    return touches.find(({ entry, time }) => entry.item_id === itemId &&
-        time >= servedAt &&
-        time - servedAt <= horizonMs)?.time;
-}
-function firstDeliveriesByServeId(events, author) {
-    const deliveries = new Map();
-    for (const event of events) {
-        if (event.kind === "delivery" &&
-            event.schema_version === 2 &&
-            event.author === author &&
-            !deliveries.has(event.serve_id)) {
-            deliveries.set(event.serve_id, event);
-        }
-    }
-    return deliveries;
-}
-/**
- * Derives decayed served-then-touched affinity. A small exploration floor keeps
- * ignored and unseen items eligible, preventing a popularity feedback lock-in.
- */
-export async function readContextUsageAffinity(options) {
-    if (process.env.PM_CONTEXT_USAGE_DISABLED === "1" ||
-        options.enabled === false)
-        return {
-            affinity: {},
-            positive_judgments: 0,
-            serving_events: 0,
-            untrusted_serving_events: 0,
-        };
-    const events = await readEvents(options);
-    const now = resolveNow(options).ms;
-    const horizonMs = (options.horizonHours ?? 24) * 3_600_000;
-    if (![Number.isFinite(horizonMs), horizonMs > 0].every(Boolean))
-        throw new ContextUsageValidationError("Context usage horizonHours must be positive");
-    const author = options.author.trim();
-    const touches = events
-        .filter((event) => event.kind === "touch")
-        .filter((event) => event.author === author)
-        .map((entry) => ({ entry, time: Date.parse(entry.at) }));
-    const scores = new Map();
-    let servingEvents = 0;
-    let untrustedServingEvents = 0;
-    let positiveJudgments = 0;
-    const deliveries = firstDeliveriesByServeId(events, author);
-    events
-        .filter((event) => event.kind === "serve")
-        .filter((event) => event.author === author)
-        .forEach((event) => {
-        if (![event.schema_version === 2, Boolean(event.serve_id)].every(Boolean)) {
-            untrustedServingEvents += 1;
-            return;
-        }
-        servingEvents += 1;
-        const servedAt = Date.parse(event.at);
-        const delivery = deliveries.get(event.serve_id);
-        const deliveredIds = new Set(delivery?.delivered_item_ids ?? []);
-        for (const row of event.rows) {
-            if (!deliveredIds.has(row.id))
-                continue;
-            const touchTime = findTouchTimeInHorizon(touches, row.id, servedAt, horizonMs);
-            if (touchTime === undefined)
-                continue;
-            positiveJudgments += 1;
-            const ageDays = Math.max(0, (now - touchTime) / DAY_MS);
-            scores.set(row.id, (scores.get(row.id) ?? 0) + Math.exp(-ageDays / 14));
-        }
-    });
-    const maximum = Math.max(0, ...scores.values());
-    const affinity = Object.fromEntries([...scores.entries()].map(([id, score]) => [
-        id,
-        maximum === 0 ? 0.05 : 0.05 + (0.95 * score) / maximum,
-    ]));
-    return {
-        affinity,
-        positive_judgments: positiveJudgments,
-        serving_events: servingEvents,
-        untrusted_serving_events: untrustedServingEvents,
-    };
-}
+!(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]="3b38d564-6034-54ae-ad24-eddba01a2c5c")}catch(e2){}})();import{randomUUID}from"node:crypto";import{appendEvents,readEvents,resolveNow,ContextUsageValidationError,CONTEXT_USAGE_LIMITS}from"./context/usage-ledger.js";import{ContextUsageValidationError as ContextUsageValidationError2,CONTEXT_USAGE_LIMITS as CONTEXT_USAGE_LIMITS2}from"./context/usage-ledger.js";const DAY_MS=864e5;const CONTEXT_USAGE_SERVING_RECEIPT=Symbol.for("@unbrained/pm-cli/context-usage-serving-receipt");function asObjectRecord(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)?value:null}function attachContextUsageServingReceipt(result,receipt){const record=asObjectRecord(result);if(record!==null&&receipt!==null){record[CONTEXT_USAGE_SERVING_RECEIPT]=receipt}}function propagateContextUsageServingReceipt(source,target){const sourceRecord=asObjectRecord(source);const targetRecord=asObjectRecord(target);const receipt=sourceRecord?.[CONTEXT_USAGE_SERVING_RECEIPT];if(targetRecord!==null&&receipt!==void 0){targetRecord[CONTEXT_USAGE_SERVING_RECEIPT]=receipt}}function receiptFromResult(result){return asObjectRecord(result)?.[CONTEXT_USAGE_SERVING_RECEIPT]??null}function resultReceiptSaysOmitted(result){const record=asObjectRecord(result);for(const key of["read_output","context_intent"]){const receipt=asObjectRecord(record?.[key]);if(receipt?.result_omitted===true)return true}return false}function addContextUsageId(ids,value){if(typeof value==="string"&&value.trim().length>0){ids.add(value.trim())}}function addContextUsageDirectRows(ids,value){if(!Array.isArray(value))return;for(const row of value){addContextUsageId(ids,asObjectRecord(row)?.id)}}function addContextUsageIdList(ids,value){if(!Array.isArray(value))return;for(const itemId of value)addContextUsageId(ids,itemId)}function collectNextResultItemIds(record,ids){const rows=asObjectRecord(record.recommended)===null?[]:[record.recommended];for(const key of["ready","decision_needed","gate_needed","containers","blocked","held_by_others"]){if(Array.isArray(record[key]))rows.push(...record[key])}for(const value of rows){const row=asObjectRecord(value);addContextUsageId(ids,row?.id);for(const blocker of Array.isArray(row?.blockers)?row.blockers:[]){addContextUsageId(ids,asObjectRecord(blocker)?.id)}for(const unblockedId of Array.isArray(row?.unblocks)?row.unblocks:[]){addContextUsageId(ids,unblockedId)}}}function collectContextResultItemIds(record,ids){for(const key of["high_level","low_level","blocked_fallback","recently_created","unparented","activity","progress","blockers","staleness"]){addContextUsageDirectRows(ids,record[key])}for(const value of Array.isArray(record.blockers)?record.blockers:[]){addContextUsageId(ids,asObjectRecord(value)?.blocked_by)}collectContextNestedItemIds(record,ids)}function collectContextNestedItemIds(record,ids){for(const value of Array.isArray(record.hierarchy)?record.hierarchy:[]){const node=asObjectRecord(value);addContextUsageId(ids,node?.id);addContextUsageDirectRows(ids,node?.children)}for(const key of["files","workload"]){for(const value of Array.isArray(record[key])?record[key]:[]){addContextUsageIdList(ids,asObjectRecord(value)?.items)}}const agenda=asObjectRecord(record.agenda);for(const value of Array.isArray(agenda?.events)?agenda.events:[]){addContextUsageId(ids,asObjectRecord(value)?.item_id)}const tests=asObjectRecord(record.tests);addContextUsageIdList(ids,tests?.items_failing)}function collectContextUsageDeliveredItemIds(result,surface){const record=asObjectRecord(result);if(record===null||resultReceiptSaysOmitted(result))return[];const ids=new Set;if(surface==="next"){collectNextResultItemIds(record,ids)}else{collectContextResultItemIds(record,ids)}return[...ids]}async function finalizeContextUsageDelivery(options){const receipt=receiptFromResult(options.result);if(receipt===null)return false;const resultOmitted=resultReceiptSaysOmitted(options.result);await recordContextUsageDelivery({pmRoot:options.pmRoot,receipt,deliveredItemIds:collectContextUsageDeliveredItemIds(options.result,receipt.surface),resultOmitted});return true}async function recordContextUsageServing(options){if([process.env.PM_CONTEXT_USAGE_DISABLED==="1",options.enabled===false].includes(true))return null;if(!options.author.trim()||options.rows.some(row=>!row.id.trim()||!Number.isInteger(row.rank)||row.rank<1)){throw new ContextUsageValidationError("Context usage serving requires an author and valid ranked rows")}const normalizedRows=options.rows.map(row=>({id:row.id.trim(),rank:row.rank,included:row.included}));if(new Set(normalizedRows.map(row=>row.id)).size!==normalizedRows.length){throw new ContextUsageValidationError("Context usage serving requires unique normalized row ids")}const recordedRows=normalizedRows.slice(0,CONTEXT_USAGE_LIMITS.max_serving_rows);const receipt={serve_id:randomUUID(),author:options.author.trim(),surface:options.surface,rows:normalizedRows,recorded_item_ids:recordedRows.map(row=>row.id)};receipt.storage=await appendEvents(options,[{kind:"serve",schema_version:2,serve_id:receipt.serve_id,at:resolveNow(options).iso,author:options.author.trim(),surface:options.surface,profile:options.profile.trim()||"balanced",rows:recordedRows,candidate_count:normalizedRows.length,omitted_row_count:normalizedRows.length-recordedRows.length,result_omitted:false,packed_item_ids:recordedRows.filter(row=>row.included).map(row=>row.id)}]);return receipt}async function recordContextUsageDelivery(options){if(options.receipt===null||process.env.PM_CONTEXT_USAGE_DISABLED==="1"||options.enabled===false){return}const rankedIds=new Set(options.receipt.rows.map(row=>row.id));const deliveredItemIds=[...new Set(options.deliveredItemIds.map(id=>id.trim()))];if(deliveredItemIds.some(id=>id.length===0||!rankedIds.has(id))||options.resultOmitted&&deliveredItemIds.length>0){throw new ContextUsageValidationError("Context usage delivery requires emitted ranked ids and zero ids for an omitted result")}const recordedIds=new Set(options.receipt.recorded_item_ids??options.receipt.rows.map(row=>row.id));const delivery={kind:"delivery",schema_version:2,serve_id:options.receipt.serve_id,at:resolveNow(options).iso,author:options.receipt.author,surface:options.receipt.surface,result_omitted:options.resultOmitted,delivered_item_ids:deliveredItemIds.filter(id=>recordedIds.has(id))};await appendEvents(options,[delivery],delivery.serve_id)}async function recordContextUsageTouch(options){if(process.env.PM_CONTEXT_USAGE_DISABLED==="1"||options.enabled===false)return;if(!options.author.trim()||!options.itemId.trim()||!options.intent.trim()){throw new ContextUsageValidationError("Context usage touch requires author, itemId, and intent")}await appendEvents(options,[{kind:"touch",at:resolveNow(options).iso,author:options.author.trim(),item_id:options.itemId.trim(),intent:options.intent.trim()}])}async function recordContextUsageTouches(options){if(process.env.PM_CONTEXT_USAGE_DISABLED==="1"||options.enabled===false||options.itemIds.length===0)return;const author=options.author.trim();const intent=options.intent.trim();if(!author||!intent){throw new ContextUsageValidationError("Context usage touch requires author and intent")}const itemIds=new Set;for(const itemId of options.itemIds){if(typeof itemId!=="string"){throw new ContextUsageValidationError("Context usage touch requires string itemIds")}const trimmedId=itemId.trim();if(!trimmedId)throw new ContextUsageValidationError("Context usage touch requires non-empty itemId");itemIds.add(trimmedId)}const at=resolveNow(options).iso;const events=[...itemIds].map(itemId=>({kind:"touch",at,author,item_id:itemId,intent}));await appendEvents(options,events)}function findTouchTimeInHorizon(touches,itemId,servedAt,horizonMs){return touches.find(({entry,time})=>entry.item_id===itemId&&time>=servedAt&&time-servedAt<=horizonMs)?.time}function firstDeliveriesByServeId(events,author){const deliveries=new Map;for(const event of events){if(event.kind==="delivery"&&event.schema_version===2&&event.author===author&&!deliveries.has(event.serve_id)){deliveries.set(event.serve_id,event)}}return deliveries}async function readContextUsageAffinity(options){if(process.env.PM_CONTEXT_USAGE_DISABLED==="1"||options.enabled===false)return{affinity:{},positive_judgments:0,serving_events:0,untrusted_serving_events:0};const events=await readEvents(options);const now=resolveNow(options).ms;const horizonMs=(options.horizonHours??24)*36e5;if(![Number.isFinite(horizonMs),horizonMs>0].every(Boolean))throw new ContextUsageValidationError("Context usage horizonHours must be positive");const author=options.author.trim();const touches=events.filter(event=>event.kind==="touch").filter(event=>event.author===author).map(entry=>({entry,time:Date.parse(entry.at)}));const scores=new Map;let servingEvents=0;let untrustedServingEvents=0;let positiveJudgments=0;const deliveries=firstDeliveriesByServeId(events,author);events.filter(event=>event.kind==="serve").filter(event=>event.author===author).forEach(event=>{if(![event.schema_version===2,Boolean(event.serve_id)].every(Boolean)){untrustedServingEvents+=1;return}servingEvents+=1;const servedAt=Date.parse(event.at);const delivery=deliveries.get(event.serve_id);const deliveredIds=new Set(delivery?.delivered_item_ids??[]);for(const row of event.rows){if(!deliveredIds.has(row.id))continue;const touchTime=findTouchTimeInHorizon(touches,row.id,servedAt,horizonMs);if(touchTime===void 0)continue;positiveJudgments+=1;const ageDays=Math.max(0,(now-touchTime)/DAY_MS);scores.set(row.id,(scores.get(row.id)??0)+Math.exp(-ageDays/14))}});const maximum=Math.max(0,...scores.values());const affinity=Object.fromEntries([...scores.entries()].map(([id,score])=>[id,maximum===0?.05:.05+.95*score/maximum]));return{affinity,positive_judgments:positiveJudgments,serving_events:servingEvents,untrusted_serving_events:untrustedServingEvents}}export{CONTEXT_USAGE_LIMITS2 as CONTEXT_USAGE_LIMITS,ContextUsageValidationError2 as ContextUsageValidationError,attachContextUsageServingReceipt,collectContextUsageDeliveredItemIds,finalizeContextUsageDelivery,propagateContextUsageServingReceipt,readContextUsageAffinity,recordContextUsageDelivery,recordContextUsageServing,recordContextUsageTouch,recordContextUsageTouches};
 //# sourceMappingURL=context-usage.js.map
-//# debugId=b1b1aa19-b1de-5140-8aea-ee1994ee9ecd

package/dist/sdk/contracts.js

@@ -1,24 +1,2 @@
-/**
- * @module sdk/contracts
- *
- * Exposes command and action contract data without loading SDK runtime code.
- */
-
-!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]="b47a3cc6-caba-5de8-8813-a4e6112dbe61")}catch(e){}}();
-export * from "./cli-contracts.js";
-export * from "./cli-contracts/grammar-contracts.js";
-export * from "./cli-contracts/command-exit-contracts.js";
-export * from "./context-intent-contracts.js";
-export * from "./error-code-catalog.js";
-export * from "./generated-error-code-catalog.js";
-export * from "./flag-invocation-contracts.js";
-export * from "./cli-contracts/flag-lexicon-contracts.js";
-export * from "./output-token-accounting.js";
-export * from "./output-contracts.js";
-export * from "./agent/task-transcript-contracts.js";
-export * from "./read-output-contracts.js";
-export * from "./agent/refusal-closure.js";
-export * from "./agent/closed-domain-contracts.js";
-export * from "./agent/tracker-preflight-contracts.js";
+!(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]="caf705f9-2eb5-5af8-986e-27936dafe7c8")}catch(e2){}})();export*from"./cli-contracts.js";export*from"./cli-contracts/grammar-contracts.js";export*from"./cli-contracts/command-exit-contracts.js";export*from"./context-intent-contracts.js";export*from"./error-code-catalog.js";export*from"./generated-error-code-catalog.js";export*from"./flag-invocation-contracts.js";export*from"./cli-contracts/flag-lexicon-contracts.js";export*from"./output-token-accounting.js";export*from"./output-contracts.js";export*from"./agent/task-transcript-contracts.js";export*from"./read-output-contracts.js";export*from"./agent/refusal-closure.js";export*from"./agent/closed-domain-contracts.js";export*from"./agent/tracker-preflight-contracts.js";
 //# sourceMappingURL=contracts.js.map
-//# debugId=b47a3cc6-caba-5de8-8813-a4e6112dbe61

package/dist/sdk/core-governance.js

@@ -1,15 +1,2 @@
-/**
- * @module sdk/core-governance
- *
- * Defines the shared agent-provenance and CLI-completeness governance surface
- * exposed by both the focused core entrypoint and the complete SDK barrel.
- */
-
-!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]="cea03617-5e90-5683-a9d1-289087ed4646")}catch(e){}}();
-export { AGENT_PROVENANCE_DIMENSIONS, BUILTIN_AGENT_PROVENANCE_ADAPTERS, BUILTIN_HARNESS_SIGNAL_DESCRIPTORS, diagnoseAgentIdentity, detectAgentIdentity, detectHarnessIdentity, listAgentProvenanceAdapters, normalizeAgentProvenanceAdapterValue, readAuthorEnvironment, registerHarnessSignalDescriptors, registerAgentProvenanceAdapters, resolveAuthorIdentity, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, } from "../core/shared/author.js";
-export { SEMANTIC_ATTRIBUTION_LIMITS, recordClaimSemanticAttribution, recordFocusSemanticAttribution, recordReleaseSemanticAttribution, resolveSemanticLineageIds, semanticAttributionAffinity, } from "./context/semantic-session-attribution.js";
-export { explainSourceTraceability, parseSourceLineRange, } from "./traceability/source-traceability.js";
-export { analyzeAgentProvenanceDescriptorCoverage, evaluateSemanticAttributionCoverage, groupHistoryByEpisode, resolveHistoryEpisodeGroupIdentity, summarizeAgentProvenance, summarizeAgentModelProvenance, } from "./provenance.js";
-export { analyzeSdkCliParameterCompleteness, } from "./cli-contracts.js";
+!(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]="48d03e9b-14a4-545c-8e5d-5f5f2092a113")}catch(e2){}})();import{AGENT_PROVENANCE_DIMENSIONS,BUILTIN_AGENT_PROVENANCE_ADAPTERS,BUILTIN_HARNESS_SIGNAL_DESCRIPTORS,diagnoseAgentIdentity,detectAgentIdentity,detectHarnessIdentity,listAgentProvenanceAdapters,normalizeAgentProvenanceAdapterValue,readAuthorEnvironment,registerHarnessSignalDescriptors,registerAgentProvenanceAdapters,resolveAuthorIdentity,runWithHarnessDetectionSignals,runWithWorkspaceHarnessSignalDescriptors,writeAuthorEnvironment}from"../core/shared/author.js";import{SEMANTIC_ATTRIBUTION_LIMITS,recordClaimSemanticAttribution,recordFocusSemanticAttribution,recordReleaseSemanticAttribution,resolveSemanticLineageIds,semanticAttributionAffinity}from"./context/semantic-session-attribution.js";import{explainSourceTraceability,parseSourceLineRange}from"./traceability/source-traceability.js";import{analyzeAgentProvenanceDescriptorCoverage,evaluateSemanticAttributionCoverage,groupHistoryByEpisode,resolveHistoryEpisodeGroupIdentity,summarizeAgentProvenance,summarizeAgentModelProvenance}from"./provenance.js";import{analyzeSdkCliParameterCompleteness}from"./cli-contracts.js";export{AGENT_PROVENANCE_DIMENSIONS,BUILTIN_AGENT_PROVENANCE_ADAPTERS,BUILTIN_HARNESS_SIGNAL_DESCRIPTORS,SEMANTIC_ATTRIBUTION_LIMITS,analyzeAgentProvenanceDescriptorCoverage,analyzeSdkCliParameterCompleteness,detectAgentIdentity,detectHarnessIdentity,diagnoseAgentIdentity,evaluateSemanticAttributionCoverage,explainSourceTraceability,groupHistoryByEpisode,listAgentProvenanceAdapters,normalizeAgentProvenanceAdapterValue,parseSourceLineRange,readAuthorEnvironment,recordClaimSemanticAttribution,recordFocusSemanticAttribution,recordReleaseSemanticAttribution,registerAgentProvenanceAdapters,registerHarnessSignalDescriptors,resolveAuthorIdentity,resolveHistoryEpisodeGroupIdentity,resolveSemanticLineageIds,runWithHarnessDetectionSignals,runWithWorkspaceHarnessSignalDescriptors,semanticAttributionAffinity,summarizeAgentModelProvenance,summarizeAgentProvenance,writeAuthorEnvironment};
 //# sourceMappingURL=core-governance.js.map
-//# debugId=cea03617-5e90-5683-a9d1-289087ed4646

package/dist/sdk/core.js

@@ -1,15 +1,2 @@
-/**
- * @module sdk/core
- *
- * Provides the stable item lifecycle client and universal project data types.
- */
-
-!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]="f44898af-0809-51e1-a6fb-74716c0971f5")}catch(e){}}();
-export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, canonicalDocument, classifyItemFormatVersion, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, isPmCliExpectedError, normalizeItemFormatVersion, normalizeItemId, normalizeStatusInput, nowIso, runAction, serializeItemDocument, aggregate, append, claim, claimNext, close, comments, context, copy, create, deleteItem, deps, docs, files, filesDiscover, focus, get, graph, learnings, list, next, notes, release, reopen, restore, search, update, listAllComplete, } from "./runtime.js";
-export * from "./core-governance.js";
-export * from "./agent-session-context.js";
-export { isAlreadyClaimedError } from "./lifecycle/claim.js";
-export { PM_READ_OUTPUT_DIMENSIONS, PM_READ_OUTPUT_OPTION_FLAGS, PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS, PM_READ_OUTPUT_SURFACE_CONTRACTS, applyReadOutputDimensions, decodeReadOutputContinuationCursor, encodeReadOutputContinuationCursor, isReadOutputBudgetExceeded, resolveReadOutputDimensions, resolveReadOutputEncoding, resolveReadOutputSurface, validateReadOutputOptions, } from "./read-output-contracts.js";
-export { applyReadOutputSessionReferences, attachReadOutputSessionReceipt, parseReadOutputSession, readOutputSessionRemainingTokens, } from "./read-output-session.js";
+!(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]="3eaa41f7-77a1-5838-8a2f-2ab6a49c21ef")}catch(e2){}})();import{BASELINE_ITEM_FORMAT_VERSION,BUILTIN_ITEM_TYPE_VALUES,CONFIDENCE_TEXT_VALUES,CURRENT_ITEM_FORMAT_VERSION,DEPENDENCY_KIND_VALUES,EXIT_CODE,ISSUE_SEVERITY_VALUES,ITEM_TYPE_VALUES,PM_CLI_EXPECTED_ERROR_NAME,PmCliError,PmClient,RISK_VALUES,STATUS_VALUES,canonicalDocument,classifyItemFormatVersion,createPmCliExpectedError,effectiveItemFormatVersion,emptyImportedDocument,isPmCliExpectedError,normalizeItemFormatVersion,normalizeItemId,normalizeStatusInput,nowIso,runAction,serializeItemDocument,aggregate,append,claim,claimNext,close,comments,context,copy,create,deleteItem,deps,docs,files,filesDiscover,focus,get,graph,learnings,list,next,notes,release,reopen,restore,search,update,listAllComplete}from"./runtime.js";export*from"./core-governance.js";export*from"./agent-session-context.js";import{isAlreadyClaimedError}from"./lifecycle/claim.js";import{PM_READ_OUTPUT_DIMENSIONS,PM_READ_OUTPUT_OPTION_FLAGS,PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS,PM_READ_OUTPUT_SURFACE_CONTRACTS,applyReadOutputDimensions,decodeReadOutputContinuationCursor,encodeReadOutputContinuationCursor,isReadOutputBudgetExceeded,resolveReadOutputDimensions,resolveReadOutputEncoding,resolveReadOutputSurface,validateReadOutputOptions}from"./read-output-contracts.js";import{applyReadOutputSessionReferences,attachReadOutputSessionReceipt,parseReadOutputSession,readOutputSessionRemainingTokens}from"./read-output-session.js";export{BASELINE_ITEM_FORMAT_VERSION,BUILTIN_ITEM_TYPE_VALUES,CONFIDENCE_TEXT_VALUES,CURRENT_ITEM_FORMAT_VERSION,DEPENDENCY_KIND_VALUES,EXIT_CODE,ISSUE_SEVERITY_VALUES,ITEM_TYPE_VALUES,PM_CLI_EXPECTED_ERROR_NAME,PM_READ_OUTPUT_COMPOSITION_OPTION_FLAGS,PM_READ_OUTPUT_DIMENSIONS,PM_READ_OUTPUT_OPTION_FLAGS,PM_READ_OUTPUT_SURFACE_CONTRACTS,PmCliError,PmClient,RISK_VALUES,STATUS_VALUES,aggregate,append,applyReadOutputDimensions,applyReadOutputSessionReferences,attachReadOutputSessionReceipt,canonicalDocument,claim,claimNext,classifyItemFormatVersion,close,comments,context,copy,create,createPmCliExpectedError,decodeReadOutputContinuationCursor,deleteItem,deps,docs,effectiveItemFormatVersion,emptyImportedDocument,encodeReadOutputContinuationCursor,files,filesDiscover,focus,get,graph,isAlreadyClaimedError,isPmCliExpectedError,isReadOutputBudgetExceeded,learnings,list,listAllComplete,next,normalizeItemFormatVersion,normalizeItemId,normalizeStatusInput,notes,nowIso,parseReadOutputSession,readOutputSessionRemainingTokens,release,reopen,resolveReadOutputDimensions,resolveReadOutputEncoding,resolveReadOutputSurface,restore,runAction,search,serializeItemDocument,update,validateReadOutputOptions};
 //# sourceMappingURL=core.js.map
-//# debugId=f44898af-0809-51e1-a6fb-74716c0971f5