@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/author-attribution.js

@@ -1,469 +1,2 @@
-/**
- * @module sdk/author-attribution
- *
- * Provides reusable diagnostics for mutation-author provenance in tracker history.
- */
-
-!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]="b389e521-f689-5895-a5f4-08c3866b3ea3")}catch(e){}}();
-import { createHash } from "node:crypto";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { appendWorkspaceAuditEvent, WORKSPACE_HISTORY_ID, } from "../core/history/workspace-history.js";
-import { readSettings } from "../core/store/settings.js";
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-import { readRuntimeString, readRuntimeStringArray } from "./runtime-input.js";
-/**
- * Refuse an acknowledgment argument as a classified usage error.
- *
- * Argument validation is an expected outcome of a public mutation surface, not a
- * product failure. Raising a bare `TypeError` left the refusal at exit code 1,
- * which the CLI observability boundary reports as an unclassified handled error
- * and the release gate then reads as a blocking production issue. Carrying
- * {@link EXIT_CODE.USAGE} plus a stable code keeps the refusal teachable and
- * keeps expected validation out of the error channel without masking genuine
- * failures, which retain their own exit codes.
- */
-function refuseAuthorAcknowledgmentArgument(message, context) {
-    throw new PmCliError(message, EXIT_CODE.USAGE, context);
-}
-/** First release-governance anchor after which unknown authors require remediation. */
-export const HISTORY_AUTHOR_ATTRIBUTION_BASELINE = "2026-07-15T06:22:12.276Z";
-/** Parsed epoch for the immutable attribution baseline used by every stream scan. */
-const HISTORY_AUTHOR_ATTRIBUTION_BASELINE_MS = Date.parse(HISTORY_AUTHOR_ATTRIBUTION_BASELINE);
-/** Attribution policy indexed by unknown-author and post-baseline flags. */
-const HISTORY_AUTHOR_EVENT_CLASSIFICATIONS = [
-    ["attributed", "attributed"],
-    ["legacy_unknown", "actionable_unknown"],
-];
-/** Return history string fields unchanged while normalizing other values to empty text. */
-const historyStringValue = (value) => typeof value === "string" ? value : "";
-/** Classifies one parsed history event by author provenance and baseline age. */
-export const classifyHistoryAuthorEvent = (parsed) => {
-    const record = (parsed ?? {});
-    const author = historyStringValue(record.author).trim().toLowerCase();
-    const authorClass = Number(["", "unknown"].includes(author));
-    const timestampClass = Number(Date.parse(historyStringValue(record.ts)) >=
-        HISTORY_AUTHOR_ATTRIBUTION_BASELINE_MS);
-    return HISTORY_AUTHOR_EVENT_CLASSIFICATIONS[authorClass][timestampClass];
-};
-function inspectHistoryAuthorStreamWithActionableEvents(itemId, raw, sampleLimit = 20, acknowledgedEvents = new Set(), includeActionableEvents = false) {
-    const samples = [];
-    const actionableEvents = [];
-    const unknownCounts = {
-        legacy_unknown: 0,
-        actionable_unknown: 0,
-    };
-    const boundedSampleLimit = Math.max(0, sampleLimit);
-    let checkedEvents = 0;
-    let unknownEvents = 0;
-    let acknowledgedActionableEvents = 0;
-    for (const [index, line] of raw.split(/\r?\n/).entries()) {
-        let parsed;
-        try {
-            parsed = JSON.parse(line);
-        }
-        catch {
-            continue;
-        }
-        checkedEvents += 1;
-        const classification = classifyHistoryAuthorEvent(parsed);
-        if (classification === "attributed") {
-            continue;
-        }
-        unknownEvents += 1;
-        if (classification === "actionable_unknown" &&
-            acknowledgedEvents.has(`${itemId}:${index + 1}`)) {
-            acknowledgedActionableEvents += 1;
-            continue;
-        }
-        unknownCounts[classification] += 1;
-        if (includeActionableEvents && classification === "actionable_unknown") {
-            actionableEvents.push({ item_id: itemId, line: index + 1 });
-        }
-        if (samples.length < boundedSampleLimit) {
-            samples.push({ item_id: itemId, line: index + 1 });
-        }
-    }
-    return {
-        checked_events: checkedEvents,
-        unknown_event_count: unknownEvents,
-        legacy_unknown_event_count: unknownCounts.legacy_unknown,
-        actionable_unknown_event_count: unknownCounts.actionable_unknown,
-        acknowledged_actionable_event_count: acknowledgedActionableEvents,
-        samples,
-        samples_truncated: unknownCounts.legacy_unknown + unknownCounts.actionable_unknown >
-            samples.length,
-        actionable_events: actionableEvents,
-    };
-}
-/** Inspect one readable JSONL stream without performing filesystem I/O. */
-export const inspectHistoryAuthorStream = (itemId, raw, sampleLimit = 20, acknowledgedEvents = new Set()) => inspectHistoryAuthorStreamWithActionableEvents(itemId, raw, sampleLimit, acknowledgedEvents);
-function collectAcknowledgedUnknownEvents(raw) {
-    const acknowledged = new Set();
-    for (const line of raw.split(/\r?\n/)) {
-        let parsed;
-        try {
-            parsed = JSON.parse(line);
-        }
-        catch {
-            continue;
-        }
-        const context = typeof parsed === "object" &&
-            parsed !== null &&
-            typeof parsed.context === "object" &&
-            parsed.context !== null
-            ? parsed.context
-            : {};
-        const acknowledgment = context.author_acknowledgment;
-        if (typeof acknowledgment !== "object" ||
-            acknowledgment === null ||
-            !Array.isArray(acknowledgment.events)) {
-            continue;
-        }
-        for (const event of acknowledgment.events) {
-            if (typeof event === "object" &&
-                event !== null &&
-                typeof event.item_id === "string" &&
-                Number.isSafeInteger(event.line)) {
-                acknowledged.add(`${event.item_id}:${String(event.line)}`);
-            }
-        }
-    }
-    return acknowledged;
-}
-/**
- * Scan append-only tracker history for missing or `unknown` author values.
- * Malformed and unreadable streams are deliberately left to integrity diagnostics.
- */
-export const scanHistoryAuthorAttribution = async (pmRoot, sampleLimit = 20, includeActionableEvents = false) => {
-    const historyDirectory = path.join(pmRoot, "history");
-    let fileNames;
-    try {
-        fileNames = (await fs.readdir(historyDirectory))
-            .filter((fileName) => fileName.endsWith(".jsonl"))
-            .sort((left, right) => left.localeCompare(right));
-    }
-    catch {
-        fileNames = [];
-    }
-    const affectedItemIds = new Set();
-    const samples = [];
-    const actionableEvents = [];
-    let checkedStreams = 0;
-    let checkedEvents = 0;
-    let unknownEventCount = 0;
-    let legacyUnknownEventCount = 0;
-    let actionableUnknownEventCount = 0;
-    let acknowledgedActionableEventCount = 0;
-    const workspaceFileName = "_workspace.jsonl";
-    let acknowledgedEvents = new Set();
-    if (fileNames.includes(workspaceFileName)) {
-        try {
-            acknowledgedEvents = collectAcknowledgedUnknownEvents(await fs.readFile(path.join(historyDirectory, workspaceFileName), "utf8"));
-        }
-        catch {
-            acknowledgedEvents = new Set();
-        }
-    }
-    for (const fileName of fileNames) {
-        let raw;
-        try {
-            raw = await fs.readFile(path.join(historyDirectory, fileName), "utf8");
-        }
-        catch {
-            continue;
-        }
-        const itemId = fileName.slice(0, -".jsonl".length);
-        const inspected = inspectHistoryAuthorStreamWithActionableEvents(itemId, raw, sampleLimit - samples.length, acknowledgedEvents, includeActionableEvents);
-        checkedStreams += 1;
-        checkedEvents += inspected.checked_events;
-        unknownEventCount += inspected.unknown_event_count;
-        legacyUnknownEventCount += inspected.legacy_unknown_event_count;
-        actionableUnknownEventCount += inspected.actionable_unknown_event_count;
-        acknowledgedActionableEventCount +=
-            inspected.acknowledged_actionable_event_count;
-        if (inspected.unknown_event_count > 0) {
-            affectedItemIds.add(itemId);
-        }
-        samples.push(...inspected.samples);
-        if (includeActionableEvents) {
-            actionableEvents.push(...inspected.actionable_events);
-        }
-    }
-    const undispositionedUnknownEventCount = legacyUnknownEventCount + actionableUnknownEventCount;
-    return {
-        checked_streams: checkedStreams,
-        checked_events: checkedEvents,
-        unknown_event_count: unknownEventCount,
-        legacy_unknown_event_count: legacyUnknownEventCount,
-        actionable_unknown_event_count: actionableUnknownEventCount,
-        acknowledged_actionable_event_count: acknowledgedActionableEventCount,
-        affected_item_ids: [...affectedItemIds].sort((left, right) => left.localeCompare(right)),
-        samples,
-        samples_truncated: undispositionedUnknownEventCount > samples.length,
-        ...(includeActionableEvents ? { actionable_events: actionableEvents } : {}),
-    };
-};
-/** Deduplicate and deterministically order history coordinates. */
-function normalizeUnknownAuthorHistoryEvents(events) {
-    return [
-        ...new Map(events.map((event) => [
-            `${event.item_id}:${event.line}`,
-            { item_id: event.item_id, line: event.line },
-        ])).values(),
-    ].sort((left, right) => left.item_id.localeCompare(right.item_id) || left.line - right.line);
-}
-/** Read the append-only set of previously dispositioned coordinates. */
-async function readAcknowledgedUnknownEvents(pmRoot) {
-    try {
-        return collectAcknowledgedUnknownEvents(await fs.readFile(path.join(pmRoot, "history", "_workspace.jsonl"), "utf8"));
-    }
-    catch {
-        return new Set();
-    }
-}
-/** Check whether a coordinate can safely name one immutable history line. */
-function isValidUnknownAuthorHistoryEvent(event) {
-    return ((event.item_id === WORKSPACE_HISTORY_ID ||
-        /^[a-z0-9][a-z0-9-]*$/iu.test(event.item_id)) &&
-        Number.isSafeInteger(event.line) &&
-        event.line >= 1);
-}
-/** Resolve one coordinate against its preloaded immutable source stream. */
-function resolveAcknowledgmentPlanCoordinate(event, acknowledgedEvents, sourceLines) {
-    const sourceLine = sourceLines[event.line - 1] ?? "";
-    let parsed;
-    try {
-        parsed = JSON.parse(sourceLine);
-    }
-    catch {
-        refuseAuthorAcknowledgmentArgument(`Unknown-author acknowledgment target ${event.item_id}:${event.line} is not readable.`, { code: "history_author_acknowledge_target_unreadable" });
-    }
-    if (classifyHistoryAuthorEvent(parsed) !== "actionable_unknown") {
-        refuseAuthorAcknowledgmentArgument(`Author acknowledgment target ${event.item_id}:${event.line} is not an actionable unknown-author event.`, { code: "history_author_acknowledge_target_not_actionable" });
-    }
-    return {
-        ...event,
-        source_event_hash: createHash("sha256").update(sourceLine).digest("hex"),
-        disposition: acknowledgedEvents.has(`${event.item_id}:${event.line}`)
-            ? "already_acknowledged"
-            : "actionable",
-    };
-}
-async function resolveUnknownAuthorAcknowledgmentPlan(pmRoot, selector, coordinateLimit) {
-    const explicitEvents = selector.events ?? [];
-    const selectorCount = Number(selector.all_actionable === true) +
-        Number(explicitEvents.length > 0);
-    if (selectorCount === 0) {
-        refuseAuthorAcknowledgmentArgument("Specify exactly one selector: events or all_actionable.", { code: "history_author_acknowledge_selector_required" });
-    }
-    if (selectorCount > 1) {
-        refuseAuthorAcknowledgmentArgument("Author acknowledgment accepts either explicit events or all_actionable, not both.", { code: "history_author_acknowledge_selector_conflict" });
-    }
-    if (!Number.isSafeInteger(coordinateLimit) || coordinateLimit < 0) {
-        refuseAuthorAcknowledgmentArgument("Author acknowledgment coordinate_limit must be a non-negative integer.", { code: "history_author_acknowledge_preview_limit_invalid" });
-    }
-    const selectedEvents = normalizeUnknownAuthorHistoryEvents(selector.all_actionable === true
-        ? (await scanHistoryAuthorAttribution(pmRoot, 0, true))
-            .actionable_events
-        : explicitEvents);
-    const acknowledgedEvents = await readAcknowledgedUnknownEvents(pmRoot);
-    const sourceLinesByItem = new Map();
-    for (const event of selectedEvents) {
-        if (!isValidUnknownAuthorHistoryEvent(event)) {
-            refuseAuthorAcknowledgmentArgument(`Unknown-author acknowledgment target ${event.item_id}:${event.line} is not readable.`, { code: "history_author_acknowledge_target_unreadable" });
-        }
-        if (sourceLinesByItem.has(event.item_id))
-            continue;
-        try {
-            sourceLinesByItem.set(event.item_id, (await fs.readFile(path.join(pmRoot, "history", `${event.item_id}.jsonl`), "utf8")).split(/\r?\n/u));
-        }
-        catch {
-            refuseAuthorAcknowledgmentArgument(`Unknown-author acknowledgment target ${event.item_id}:${event.line} is not readable.`, { code: "history_author_acknowledge_target_unreadable" });
-        }
-    }
-    const completeCoordinates = selectedEvents.map((event) => resolveAcknowledgmentPlanCoordinate(event, acknowledgedEvents, sourceLinesByItem.get(event.item_id)));
-    const kind = selector.all_actionable === true ? "all_actionable" : "events";
-    const planFingerprint = createHash("sha256")
-        .update(JSON.stringify({
-        version: 1,
-        selection: kind,
-        coordinates: completeCoordinates,
-    }))
-        .digest("hex");
-    const actionableCount = completeCoordinates.filter(({ disposition }) => disposition === "actionable").length;
-    return {
-        plan: {
-            selection: { kind },
-            selected_count: completeCoordinates.length,
-            actionable_count: actionableCount,
-            already_acknowledged_count: completeCoordinates.length - actionableCount,
-            omitted_count: Math.max(0, completeCoordinates.length - coordinateLimit),
-            coordinates: completeCoordinates.slice(0, coordinateLimit),
-            plan_fingerprint: planFingerprint,
-        },
-        completeCoordinates,
-    };
-}
-/** Resolve a deterministic, source-bound author-acknowledgement preview. */
-export async function planUnknownAuthorHistoryAcknowledgment(pmRoot, selector, coordinateLimit = 50) {
-    return (await resolveUnknownAuthorAcknowledgmentPlan(pmRoot, selector, coordinateLimit)).plan;
-}
-/** Resolve the mutually exclusive CLI and SDK acknowledgment selectors. */
-export function resolveUnknownAuthorAcknowledgmentSelector(rawEvents, allActionable) {
-    const hasExplicitEvents = rawEvents.length > 0;
-    if (hasExplicitEvents && allActionable) {
-        refuseAuthorAcknowledgmentArgument("Specify exactly one selector: repeat --event or pass --all-actionable.", {
-            code: "history_author_acknowledge_selector_conflict",
-            required: "Exactly one of --event or --all-actionable",
-            examples: [
-                'pm history-author-acknowledge --event pm-a1b2:4 --attributed-author agent --reviewer maintainer --reason "Verified provenance"',
-                'pm history-author-acknowledge --all-actionable --attributed-author import-agent --reviewer maintainer --reason "Reviewed the complete actionable set"',
-            ],
-        });
-    }
-    if (!hasExplicitEvents && !allActionable) {
-        refuseAuthorAcknowledgmentArgument("Specify exactly one selector: repeat --event or pass --all-actionable.", {
-            code: "history_author_acknowledge_selector_required",
-            required: "Exactly one of --event or --all-actionable",
-            examples: [
-                'pm history-author-acknowledge --event pm-a1b2:4 --attributed-author agent --reviewer maintainer --reason "Verified provenance"',
-                'pm history-author-acknowledge --all-actionable --attributed-author import-agent --reviewer maintainer --reason "Reviewed the complete actionable set"',
-            ],
-        });
-    }
-    return {
-        events: parseUnknownAuthorHistoryEventCoordinates(rawEvents),
-        all_actionable: allActionable,
-    };
-}
-/** Parse user-facing item or workspace history coordinates into SDK events. */
-export function parseUnknownAuthorHistoryEventCoordinates(values) {
-    return values.map((value) => {
-        const separator = value.lastIndexOf(":");
-        const itemId = value.slice(0, separator).trim();
-        const line = Number(value.slice(separator + 1));
-        const validItemId = itemId === WORKSPACE_HISTORY_ID || /^[a-z0-9][a-z0-9-]*$/iu.test(itemId);
-        if (separator < 1 ||
-            !validItemId ||
-            !Number.isSafeInteger(line) ||
-            line < 1) {
-            refuseAuthorAcknowledgmentArgument(`history-author-acknowledge --event expects <item-id>:<one-based-line>, received "${value}".`, { code: "history_author_acknowledge_target_unreadable" });
-        }
-        return { item_id: itemId, line };
-    });
-}
-/** Normalize an untyped transport payload and execute author acknowledgment. */
-export function acknowledgeUnknownAuthorHistoryEventsFromTransport(pmRoot, input) {
-    const selector = resolveUnknownAuthorAcknowledgmentSelector(readRuntimeStringArray(input.historyEvent), input.allActionable === true || input.all_actionable === true);
-    return acknowledgeUnknownAuthorHistoryEvents(pmRoot, {
-        events: selector.events,
-        all_actionable: selector.all_actionable,
-        dry_run: input.dryRun === true || input.dry_run === true,
-        plan_fingerprint: readRuntimeString(input, "planFingerprint") ??
-            readRuntimeString(input, "plan_fingerprint"),
-        coordinate_limit: typeof input.limit === "number"
-            ? input.limit
-            : typeof input.limit === "string"
-                ? Number(input.limit)
-                : undefined,
-        attributed_author: readRuntimeString(input, "attributedAuthor") ??
-            readRuntimeString(input, "attributed_author") ??
-            undefined,
-        reviewer: readRuntimeString(input, "reviewer"),
-        reason: readRuntimeString(input, "reason"),
-    });
-}
-/**
- * Append an audited disposition for immutable unknown-author events without
- * rewriting their original streams.
- */
-export async function acknowledgeUnknownAuthorHistoryEvents(pmRoot, options) {
-    const reviewer = options.reviewer?.trim() ?? "";
-    const attributedAuthor = options.attributed_author?.trim() ?? "";
-    const reason = options.reason?.trim() ?? "";
-    const resolved = await resolveUnknownAuthorAcknowledgmentPlan(pmRoot, options, options.coordinate_limit ?? 50);
-    if (options.dry_run === true) {
-        return {
-            dry_run: true,
-            mutated: false,
-            acknowledged: 0,
-            outcome: "preview",
-            exit_code: EXIT_CODE.SUCCESS,
-            plan: resolved.plan,
-        };
-    }
-    const requiredValuesMissing = [
-        reviewer.length > 0,
-        reviewer.toLowerCase() !== "unknown",
-        attributedAuthor.length > 0,
-        attributedAuthor.toLowerCase() !== "unknown",
-        reason.length > 0,
-    ].includes(false);
-    if (requiredValuesMissing) {
-        refuseAuthorAcknowledgmentArgument("Author acknowledgment requires events, reviewer, attributed_author, and reason.", { code: "history_author_acknowledge_required_values_missing" });
-    }
-    if (!options.plan_fingerprint?.trim()) {
-        refuseAuthorAcknowledgmentArgument("Author acknowledgment apply requires plan_fingerprint from a fresh dry-run preview.", {
-            code: "history_author_acknowledge_plan_fingerprint_required",
-            recovery: {
-                suggested_retry: "Rerun history-author-acknowledge with --dry-run, then pass --plan-fingerprint <value>.",
-            },
-        });
-    }
-    if (options.plan_fingerprint.trim() !== resolved.plan.plan_fingerprint) {
-        throw new PmCliError("Author acknowledgment selection changed after preview; no history was mutated.", EXIT_CODE.CONFLICT, {
-            code: "history_author_acknowledge_plan_conflict",
-            recovery: {
-                suggested_retry: "Rerun history-author-acknowledge with --dry-run and apply the fresh plan_fingerprint.",
-            },
-        });
-    }
-    const eventsToAcknowledge = resolved.completeCoordinates
-        .filter(({ disposition }) => resolved.plan.selection.kind === "events" ||
-        disposition === "actionable")
-        .map(({ item_id, line }) => ({ item_id, line }));
-    if (eventsToAcknowledge.length === 0) {
-        return {
-            dry_run: false,
-            mutated: false,
-            acknowledged: 0,
-            outcome: "no_effect",
-            exit_code: EXIT_CODE.NO_EFFECT,
-            plan: resolved.plan,
-        };
-    }
-    const settings = await readSettings(pmRoot);
-    const appended = await appendWorkspaceAuditEvent({
-        pmRoot,
-        op: "history:author-acknowledge",
-        author: reviewer,
-        context: {
-            author_acknowledgment: {
-                events: eventsToAcknowledge,
-                attributed_author: attributedAuthor,
-            },
-        },
-        message: reason,
-        lockTtlSeconds: settings.locks.ttl_seconds,
-        lockWaitMs: settings.locks.wait_ms,
-    });
-    const effectResult = resolved.plan.actionable_count > 0 &&
-        resolved.plan.already_acknowledged_count > 0
-        ? {
-            outcome: "partial_effect",
-            exit_code: EXIT_CODE.PARTIAL_EFFECT,
-        }
-        : { outcome: "effect", exit_code: EXIT_CODE.SUCCESS };
-    return {
-        dry_run: false,
-        mutated: true,
-        acknowledged: eventsToAcknowledge.length,
-        ...effectResult,
-        plan: resolved.plan,
-        history_path: appended.historyPath,
-    };
-}
+!(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]="fd8c4c35-98bb-5f3b-927d-8696125af703")}catch(e2){}})();import{createHash}from"node:crypto";import fs from"node:fs/promises";import path from"node:path";import{appendWorkspaceAuditEvent,WORKSPACE_HISTORY_ID}from"../core/history/workspace-history.js";import{readSettings}from"../core/store/settings.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{readRuntimeString,readRuntimeStringArray}from"./runtime-input.js";function refuseAuthorAcknowledgmentArgument(message,context){throw new PmCliError(message,EXIT_CODE.USAGE,context)}const HISTORY_AUTHOR_ATTRIBUTION_BASELINE="2026-07-15T06:22:12.276Z";const HISTORY_AUTHOR_ATTRIBUTION_BASELINE_MS=Date.parse(HISTORY_AUTHOR_ATTRIBUTION_BASELINE);const HISTORY_AUTHOR_EVENT_CLASSIFICATIONS=[["attributed","attributed"],["legacy_unknown","actionable_unknown"]];const historyStringValue=value=>typeof value==="string"?value:"";const classifyHistoryAuthorEvent=parsed=>{const record=parsed??{};const author=historyStringValue(record.author).trim().toLowerCase();const authorClass=Number(["","unknown"].includes(author));const timestampClass=Number(Date.parse(historyStringValue(record.ts))>=HISTORY_AUTHOR_ATTRIBUTION_BASELINE_MS);return HISTORY_AUTHOR_EVENT_CLASSIFICATIONS[authorClass][timestampClass]};function inspectHistoryAuthorStreamWithActionableEvents(itemId,raw,sampleLimit=20,acknowledgedEvents=new Set,includeActionableEvents=false){const samples=[];const actionableEvents=[];const unknownCounts={legacy_unknown:0,actionable_unknown:0};const boundedSampleLimit=Math.max(0,sampleLimit);let checkedEvents=0;let unknownEvents=0;let acknowledgedActionableEvents=0;for(const[index,line]of raw.split(/\r?\n/).entries()){let parsed;try{parsed=JSON.parse(line)}catch{continue}checkedEvents+=1;const classification=classifyHistoryAuthorEvent(parsed);if(classification==="attributed"){continue}unknownEvents+=1;if(classification==="actionable_unknown"&&acknowledgedEvents.has(`${itemId}:${index+1}`)){acknowledgedActionableEvents+=1;continue}unknownCounts[classification]+=1;if(includeActionableEvents&&classification==="actionable_unknown"){actionableEvents.push({item_id:itemId,line:index+1})}if(samples.length<boundedSampleLimit){samples.push({item_id:itemId,line:index+1})}}return{checked_events:checkedEvents,unknown_event_count:unknownEvents,legacy_unknown_event_count:unknownCounts.legacy_unknown,actionable_unknown_event_count:unknownCounts.actionable_unknown,acknowledged_actionable_event_count:acknowledgedActionableEvents,samples,samples_truncated:unknownCounts.legacy_unknown+unknownCounts.actionable_unknown>samples.length,actionable_events:actionableEvents}}const inspectHistoryAuthorStream=(itemId,raw,sampleLimit=20,acknowledgedEvents=new Set)=>inspectHistoryAuthorStreamWithActionableEvents(itemId,raw,sampleLimit,acknowledgedEvents);function collectAcknowledgedUnknownEvents(raw){const acknowledged=new Set;for(const line of raw.split(/\r?\n/)){let parsed;try{parsed=JSON.parse(line)}catch{continue}const context=typeof parsed==="object"&&parsed!==null&&typeof parsed.context==="object"&&parsed.context!==null?parsed.context:{};const acknowledgment=context.author_acknowledgment;if(typeof acknowledgment!=="object"||acknowledgment===null||!Array.isArray(acknowledgment.events)){continue}for(const event of acknowledgment.events){if(typeof event==="object"&&event!==null&&typeof event.item_id==="string"&&Number.isSafeInteger(event.line)){acknowledged.add(`${event.item_id}:${String(event.line)}`)}}}return acknowledged}const scanHistoryAuthorAttribution=async(pmRoot,sampleLimit=20,includeActionableEvents=false)=>{const historyDirectory=path.join(pmRoot,"history");let fileNames;try{fileNames=(await fs.readdir(historyDirectory)).filter(fileName=>fileName.endsWith(".jsonl")).sort((left,right)=>left.localeCompare(right))}catch{fileNames=[]}const affectedItemIds=new Set;const samples=[];const actionableEvents=[];let checkedStreams=0;let checkedEvents=0;let unknownEventCount=0;let legacyUnknownEventCount=0;let actionableUnknownEventCount=0;let acknowledgedActionableEventCount=0;const workspaceFileName="_workspace.jsonl";let acknowledgedEvents=new Set;if(fileNames.includes(workspaceFileName)){try{acknowledgedEvents=collectAcknowledgedUnknownEvents(await fs.readFile(path.join(historyDirectory,workspaceFileName),"utf8"))}catch{acknowledgedEvents=new Set}}for(const fileName of fileNames){let raw;try{raw=await fs.readFile(path.join(historyDirectory,fileName),"utf8")}catch{continue}const itemId=fileName.slice(0,-".jsonl".length);const inspected=inspectHistoryAuthorStreamWithActionableEvents(itemId,raw,sampleLimit-samples.length,acknowledgedEvents,includeActionableEvents);checkedStreams+=1;checkedEvents+=inspected.checked_events;unknownEventCount+=inspected.unknown_event_count;legacyUnknownEventCount+=inspected.legacy_unknown_event_count;actionableUnknownEventCount+=inspected.actionable_unknown_event_count;acknowledgedActionableEventCount+=inspected.acknowledged_actionable_event_count;if(inspected.unknown_event_count>0){affectedItemIds.add(itemId)}samples.push(...inspected.samples);if(includeActionableEvents){actionableEvents.push(...inspected.actionable_events)}}const undispositionedUnknownEventCount=legacyUnknownEventCount+actionableUnknownEventCount;return{checked_streams:checkedStreams,checked_events:checkedEvents,unknown_event_count:unknownEventCount,legacy_unknown_event_count:legacyUnknownEventCount,actionable_unknown_event_count:actionableUnknownEventCount,acknowledged_actionable_event_count:acknowledgedActionableEventCount,affected_item_ids:[...affectedItemIds].sort((left,right)=>left.localeCompare(right)),samples,samples_truncated:undispositionedUnknownEventCount>samples.length,...includeActionableEvents?{actionable_events:actionableEvents}:{}}};function normalizeUnknownAuthorHistoryEvents(events){return[...new Map(events.map(event=>[`${event.item_id}:${event.line}`,{item_id:event.item_id,line:event.line}])).values()].sort((left,right)=>left.item_id.localeCompare(right.item_id)||left.line-right.line)}async function readAcknowledgedUnknownEvents(pmRoot){try{return collectAcknowledgedUnknownEvents(await fs.readFile(path.join(pmRoot,"history","_workspace.jsonl"),"utf8"))}catch{return new Set}}function isValidUnknownAuthorHistoryEvent(event){return(event.item_id===WORKSPACE_HISTORY_ID||/^[a-z0-9][a-z0-9-]*$/iu.test(event.item_id))&&Number.isSafeInteger(event.line)&&event.line>=1}function resolveAcknowledgmentPlanCoordinate(event,acknowledgedEvents,sourceLines){const sourceLine=sourceLines[event.line-1]??"";let parsed;try{parsed=JSON.parse(sourceLine)}catch{refuseAuthorAcknowledgmentArgument(`Unknown-author acknowledgment target ${event.item_id}:${event.line} is not readable.`,{code:"history_author_acknowledge_target_unreadable"})}if(classifyHistoryAuthorEvent(parsed)!=="actionable_unknown"){refuseAuthorAcknowledgmentArgument(`Author acknowledgment target ${event.item_id}:${event.line} is not an actionable unknown-author event.`,{code:"history_author_acknowledge_target_not_actionable"})}return{...event,source_event_hash:createHash("sha256").update(sourceLine).digest("hex"),disposition:acknowledgedEvents.has(`${event.item_id}:${event.line}`)?"already_acknowledged":"actionable"}}async function resolveUnknownAuthorAcknowledgmentPlan(pmRoot,selector,coordinateLimit){const explicitEvents=selector.events??[];const selectorCount=Number(selector.all_actionable===true)+Number(explicitEvents.length>0);if(selectorCount===0){refuseAuthorAcknowledgmentArgument("Specify exactly one selector: events or all_actionable.",{code:"history_author_acknowledge_selector_required"})}if(selectorCount>1){refuseAuthorAcknowledgmentArgument("Author acknowledgment accepts either explicit events or all_actionable, not both.",{code:"history_author_acknowledge_selector_conflict"})}if(!Number.isSafeInteger(coordinateLimit)||coordinateLimit<0){refuseAuthorAcknowledgmentArgument("Author acknowledgment coordinate_limit must be a non-negative integer.",{code:"history_author_acknowledge_preview_limit_invalid"})}const selectedEvents=normalizeUnknownAuthorHistoryEvents(selector.all_actionable===true?(await scanHistoryAuthorAttribution(pmRoot,0,true)).actionable_events:explicitEvents);const acknowledgedEvents=await readAcknowledgedUnknownEvents(pmRoot);const sourceLinesByItem=new Map;for(const event of selectedEvents){if(!isValidUnknownAuthorHistoryEvent(event)){refuseAuthorAcknowledgmentArgument(`Unknown-author acknowledgment target ${event.item_id}:${event.line} is not readable.`,{code:"history_author_acknowledge_target_unreadable"})}if(sourceLinesByItem.has(event.item_id))continue;try{sourceLinesByItem.set(event.item_id,(await fs.readFile(path.join(pmRoot,"history",`${event.item_id}.jsonl`),"utf8")).split(/\r?\n/u))}catch{refuseAuthorAcknowledgmentArgument(`Unknown-author acknowledgment target ${event.item_id}:${event.line} is not readable.`,{code:"history_author_acknowledge_target_unreadable"})}}const completeCoordinates=selectedEvents.map(event=>resolveAcknowledgmentPlanCoordinate(event,acknowledgedEvents,sourceLinesByItem.get(event.item_id)));const kind=selector.all_actionable===true?"all_actionable":"events";const planFingerprint=createHash("sha256").update(JSON.stringify({version:1,selection:kind,coordinates:completeCoordinates})).digest("hex");const actionableCount=completeCoordinates.filter(({disposition})=>disposition==="actionable").length;return{plan:{selection:{kind},selected_count:completeCoordinates.length,actionable_count:actionableCount,already_acknowledged_count:completeCoordinates.length-actionableCount,omitted_count:Math.max(0,completeCoordinates.length-coordinateLimit),coordinates:completeCoordinates.slice(0,coordinateLimit),plan_fingerprint:planFingerprint},completeCoordinates}}async function planUnknownAuthorHistoryAcknowledgment(pmRoot,selector,coordinateLimit=50){return(await resolveUnknownAuthorAcknowledgmentPlan(pmRoot,selector,coordinateLimit)).plan}function resolveUnknownAuthorAcknowledgmentSelector(rawEvents,allActionable){const hasExplicitEvents=rawEvents.length>0;if(hasExplicitEvents&&allActionable){refuseAuthorAcknowledgmentArgument("Specify exactly one selector: repeat --event or pass --all-actionable.",{code:"history_author_acknowledge_selector_conflict",required:"Exactly one of --event or --all-actionable",examples:['pm history-author-acknowledge --event pm-a1b2:4 --attributed-author agent --reviewer maintainer --reason "Verified provenance"','pm history-author-acknowledge --all-actionable --attributed-author import-agent --reviewer maintainer --reason "Reviewed the complete actionable set"']})}if(!hasExplicitEvents&&!allActionable){refuseAuthorAcknowledgmentArgument("Specify exactly one selector: repeat --event or pass --all-actionable.",{code:"history_author_acknowledge_selector_required",required:"Exactly one of --event or --all-actionable",examples:['pm history-author-acknowledge --event pm-a1b2:4 --attributed-author agent --reviewer maintainer --reason "Verified provenance"','pm history-author-acknowledge --all-actionable --attributed-author import-agent --reviewer maintainer --reason "Reviewed the complete actionable set"']})}return{events:parseUnknownAuthorHistoryEventCoordinates(rawEvents),all_actionable:allActionable}}function parseUnknownAuthorHistoryEventCoordinates(values){return values.map(value=>{const separator=value.lastIndexOf(":");const itemId=value.slice(0,separator).trim();const line=Number(value.slice(separator+1));const validItemId=itemId===WORKSPACE_HISTORY_ID||/^[a-z0-9][a-z0-9-]*$/iu.test(itemId);if(separator<1||!validItemId||!Number.isSafeInteger(line)||line<1){refuseAuthorAcknowledgmentArgument(`history-author-acknowledge --event expects <item-id>:<one-based-line>, received "${value}".`,{code:"history_author_acknowledge_target_unreadable"})}return{item_id:itemId,line}})}function acknowledgeUnknownAuthorHistoryEventsFromTransport(pmRoot,input){const selector=resolveUnknownAuthorAcknowledgmentSelector(readRuntimeStringArray(input.historyEvent),input.allActionable===true||input.all_actionable===true);return acknowledgeUnknownAuthorHistoryEvents(pmRoot,{events:selector.events,all_actionable:selector.all_actionable,dry_run:input.dryRun===true||input.dry_run===true,plan_fingerprint:readRuntimeString(input,"planFingerprint")??readRuntimeString(input,"plan_fingerprint"),coordinate_limit:typeof input.limit==="number"?input.limit:typeof input.limit==="string"?Number(input.limit):void 0,attributed_author:readRuntimeString(input,"attributedAuthor")??readRuntimeString(input,"attributed_author")??void 0,reviewer:readRuntimeString(input,"reviewer"),reason:readRuntimeString(input,"reason")})}async function acknowledgeUnknownAuthorHistoryEvents(pmRoot,options){const reviewer=options.reviewer?.trim()??"";const attributedAuthor=options.attributed_author?.trim()??"";const reason=options.reason?.trim()??"";const resolved=await resolveUnknownAuthorAcknowledgmentPlan(pmRoot,options,options.coordinate_limit??50);if(options.dry_run===true){return{dry_run:true,mutated:false,acknowledged:0,outcome:"preview",exit_code:EXIT_CODE.SUCCESS,plan:resolved.plan}}const requiredValuesMissing=[reviewer.length>0,reviewer.toLowerCase()!=="unknown",attributedAuthor.length>0,attributedAuthor.toLowerCase()!=="unknown",reason.length>0].includes(false);if(requiredValuesMissing){refuseAuthorAcknowledgmentArgument("Author acknowledgment requires events, reviewer, attributed_author, and reason.",{code:"history_author_acknowledge_required_values_missing"})}if(!options.plan_fingerprint?.trim()){refuseAuthorAcknowledgmentArgument("Author acknowledgment apply requires plan_fingerprint from a fresh dry-run preview.",{code:"history_author_acknowledge_plan_fingerprint_required",recovery:{suggested_retry:"Rerun history-author-acknowledge with --dry-run, then pass --plan-fingerprint <value>."}})}if(options.plan_fingerprint.trim()!==resolved.plan.plan_fingerprint){throw new PmCliError("Author acknowledgment selection changed after preview; no history was mutated.",EXIT_CODE.CONFLICT,{code:"history_author_acknowledge_plan_conflict",recovery:{suggested_retry:"Rerun history-author-acknowledge with --dry-run and apply the fresh plan_fingerprint."}})}const eventsToAcknowledge=resolved.completeCoordinates.filter(({disposition})=>resolved.plan.selection.kind==="events"||disposition==="actionable").map(({item_id,line})=>({item_id,line}));if(eventsToAcknowledge.length===0){return{dry_run:false,mutated:false,acknowledged:0,outcome:"no_effect",exit_code:EXIT_CODE.NO_EFFECT,plan:resolved.plan}}const settings=await readSettings(pmRoot);const appended=await appendWorkspaceAuditEvent({pmRoot,op:"history:author-acknowledge",author:reviewer,context:{author_acknowledgment:{events:eventsToAcknowledge,attributed_author:attributedAuthor}},message:reason,lockTtlSeconds:settings.locks.ttl_seconds,lockWaitMs:settings.locks.wait_ms});const effectResult=resolved.plan.actionable_count>0&&resolved.plan.already_acknowledged_count>0?{outcome:"partial_effect",exit_code:EXIT_CODE.PARTIAL_EFFECT}:{outcome:"effect",exit_code:EXIT_CODE.SUCCESS};return{dry_run:false,mutated:true,acknowledged:eventsToAcknowledge.length,...effectResult,plan:resolved.plan,history_path:appended.historyPath}}export{HISTORY_AUTHOR_ATTRIBUTION_BASELINE,acknowledgeUnknownAuthorHistoryEvents,acknowledgeUnknownAuthorHistoryEventsFromTransport,classifyHistoryAuthorEvent,inspectHistoryAuthorStream,parseUnknownAuthorHistoryEventCoordinates,planUnknownAuthorHistoryAcknowledgment,resolveUnknownAuthorAcknowledgmentSelector,scanHistoryAuthorAttribution};
 //# sourceMappingURL=author-attribution.js.map
-//# debugId=b389e521-f689-5895-a5f4-08c3866b3ea3

package/dist/sdk/authoring.js

@@ -1,21 +1,2 @@
-/**
- * @module sdk/authoring
- *
- * Provides the focused extension and package authoring surface.
- */
-
-!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]="bca95ba2-258c-5be2-8428-dcb8dbc87ef0")}catch(e){}}();
-export * from "./compose.js";
-export * from "./define.js";
-export * from "./extension-contracts.js";
-export { RESERVED_ITEM_FIELD_NAMES } from "../core/extensions/item-fields.js";
-export { PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS, PM_PACKAGE_RESOURCE_KINDS, collectPackageExtensionDirectories, readPmPackageManifest, } from "../core/packages/manifest.js";
-export { BUILTIN_PROFILES, listProfiles, normalizeProfileName, PROFILE_NAMES, resolveProfile, } from "../core/profile/profile-presets.js";
-export { describeProfileComposition, describeProjectProfile, } from "../core/profile/profile-describe.js";
-export { lintProjectProfile, PROFILE_LINT_CODES, PROFILE_LINT_DIMENSIONS, } from "../core/profile/profile-lint.js";
-export { planProfileApplication, } from "../core/profile/profile-plan.js";
-export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabilities, reconcileExtensionCapabilityUsage, } from "../core/extensions/capability-usage.js";
-export { renderExtensionSurfaceMarkdown, } from "../core/extensions/activation-summary-markdown.js";
-export { createExtensionContributionInventory, normalizeExtensionContributionInventory, } from "../core/extensions/contribution-inventory.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]="af4da99c-f557-5bf7-a439-c14878e4970d")}catch(e2){}})();export*from"./compose.js";export*from"./define.js";export*from"./extension-contracts.js";import{RESERVED_ITEM_FIELD_NAMES}from"../core/extensions/item-fields.js";import{PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,PM_PACKAGE_RESOURCE_KINDS,collectPackageExtensionDirectories,readPmPackageManifest}from"../core/packages/manifest.js";import{BUILTIN_PROFILES,listProfiles,normalizeProfileName,PROFILE_NAMES,resolveProfile}from"../core/profile/profile-presets.js";import{describeProfileComposition,describeProjectProfile}from"../core/profile/profile-describe.js";import{lintProjectProfile,PROFILE_LINT_CODES,PROFILE_LINT_DIMENSIONS}from"../core/profile/profile-lint.js";import{planProfileApplication}from"../core/profile/profile-plan.js";import{EXTENSION_CAPABILITY_REGISTRATION_SURFACES,collectUsedExtensionCapabilities,reconcileExtensionCapabilityUsage}from"../core/extensions/capability-usage.js";import{renderExtensionSurfaceMarkdown}from"../core/extensions/activation-summary-markdown.js";import{createExtensionContributionInventory,normalizeExtensionContributionInventory}from"../core/extensions/contribution-inventory.js";export{BUILTIN_PROFILES,EXTENSION_CAPABILITY_REGISTRATION_SURFACES,PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,PM_PACKAGE_RESOURCE_KINDS,PROFILE_LINT_CODES,PROFILE_LINT_DIMENSIONS,PROFILE_NAMES,RESERVED_ITEM_FIELD_NAMES,collectPackageExtensionDirectories,collectUsedExtensionCapabilities,createExtensionContributionInventory,describeProfileComposition,describeProjectProfile,lintProjectProfile,listProfiles,normalizeExtensionContributionInventory,normalizeProfileName,planProfileApplication,readPmPackageManifest,reconcileExtensionCapabilityUsage,renderExtensionSurfaceMarkdown,resolveProfile};
 //# sourceMappingURL=authoring.js.map
-//# debugId=bca95ba2-258c-5be2-8428-dcb8dbc87ef0