@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/workspace.js

@@ -1,129 +1,5 @@
-/**
- * @module sdk/workspace
- *
- * Maintains repository-scaffold contracts shared by the public SDK and CLI.
- */
+!(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]="5b131b40-e139-5a7d-a6ef-633fe2cbee64")}catch(e2){}})();import{isFileMissingError}from"../core/fs/fs-utils.js";import{readFile,writeFile}from"node:fs/promises";import path from"node:path";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";const PM_GITIGNORE_START="# pm-cli:runtime-cache:start";const PM_GITIGNORE_END="# pm-cli:runtime-cache:end";const PM_GITIGNORE_DEFAULT_TRACKER_ROOT=".agents/pm";const PM_GITIGNORE_RUNTIME_DIRECTORIES=["runtime/","search/","locks/","transactions/","checkpoints/"];const PM_GITIGNORE_TRACKED_FILES=["search/eval-queries.json"];async function withGitignorePermissionRecovery(operation){try{return await operation()}catch(error){if(error instanceof Error&&"code"in error&&typeof error.code==="string"&&["EACCES","EPERM","EROFS"].includes(error.code)){throw new PmCliError("The workspace .gitignore is not writable.",EXIT_CODE.GENERIC_FAILURE,{code:"init_gitignore_unwritable",reason:error.code.toLowerCase(),required:"Grant the current user read and write access to the workspace .gitignore before initialization.",why:"pm init must publish its managed runtime-cache ignore fence without replacing unrelated entries.",nextSteps:["Grant read and write access to the workspace .gitignore and rerun pm init.","If the workspace is intentionally read-only, initialize pm in a writable workspace or clone."]})}throw error}}function normalizeTrackerRelativeRoot(trackerRelativeRoot){return trackerRelativeRoot.replaceAll("\\","/").replace(/^\.\/+/,"").replace(/\/+$/,"")}function isPathOutsideRoot(relativePath){const normalized=relativePath.replaceAll("\\","/");return path.isAbsolute(relativePath)||normalized===".."||normalized.startsWith("../")}function getPmGitignoreBlock(trackerRelativeRoot=PM_GITIGNORE_DEFAULT_TRACKER_ROOT){const root=normalizeTrackerRelativeRoot(trackerRelativeRoot);return[PM_GITIGNORE_START,...PM_GITIGNORE_RUNTIME_DIRECTORIES.map(directory=>directory==="search/"?`${root}/${directory}*`:`${root}/${directory}`),...PM_GITIGNORE_TRACKED_FILES.map(file=>`!${root}/${file}`),PM_GITIGNORE_END].join("\n")}async function ensurePmGitignore(workspaceRoot,options={}){const gitignorePath=path.join(workspaceRoot,".gitignore");let trackerRelativeRoot=PM_GITIGNORE_DEFAULT_TRACKER_ROOT;if(options.pmRoot!==void 0){const relative=normalizeTrackerRelativeRoot(path.relative(path.resolve(workspaceRoot),path.resolve(options.pmRoot)));if(isPathOutsideRoot(relative)){return{path:gitignorePath,changed:false}}if(relative.length>0){trackerRelativeRoot=relative}}let current="";try{current=await withGitignorePermissionRecovery(()=>readFile(gitignorePath,"utf8"))}catch(error){if(!(error instanceof Error&&"code"in error&&isFileMissingError(error))){throw error}}const start=current.indexOf(PM_GITIGNORE_START);const end=current.indexOf(PM_GITIGNORE_END);const withoutManagedBlock=start>=0&&end>=start?`${current.slice(0,start)}${current.slice(end+PM_GITIGNORE_END.length)}`:current;const prefix=withoutManagedBlock.trimEnd();const next=`${prefix.length>0?`${prefix}
 
-!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]="89261a49-97e5-5ffc-a81c-2409f0b529cf")}catch(e){}}();
-import { isFileMissingError } from "../core/fs/fs-utils.js";
-import { readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-/** Opening marker for the init-owned ignore block. */
-export const PM_GITIGNORE_START = "# pm-cli:runtime-cache:start";
-/** Closing marker for the init-owned ignore block. */
-export const PM_GITIGNORE_END = "# pm-cli:runtime-cache:end";
-/** Default workspace-relative tracker root used when no custom root is resolved. */
-export const PM_GITIGNORE_DEFAULT_TRACKER_ROOT = ".agents/pm";
-/**
- * Tracker-relative directories that hold per-clone runtime state (caches,
- * search indexes, locks, crash-recovery receipts). They must never be
- * committed: they churn on every command and conflict on every concurrent
- * branch merge. `transactions/` (SDK workspace-transaction journals) and
- * `checkpoints/` (bulk-mutation rollback receipts) are per-branch recovery
- * state with their own GC (`pm gc --scope transactions|checkpoints`), so
- * keeping them untracked is the recorded merge-safety disposition.
- */
-export const PM_GITIGNORE_RUNTIME_DIRECTORIES = [
-    "runtime/",
-    "search/",
-    "locks/",
-    "transactions/",
-    "checkpoints/",
-];
-/** Tracker-relative curated search evidence that remains version controlled. */
-export const PM_GITIGNORE_TRACKED_FILES = ["search/eval-queries.json"];
-/** Convert expected workspace permission failures into stable, path-safe recovery. */
-async function withGitignorePermissionRecovery(operation) {
-    try {
-        return await operation();
-    }
-    catch (error) {
-        if (error instanceof Error &&
-            "code" in error &&
-            typeof error.code === "string" &&
-            ["EACCES", "EPERM", "EROFS"].includes(error.code)) {
-            throw new PmCliError("The workspace .gitignore is not writable.", EXIT_CODE.GENERIC_FAILURE, {
-                code: "init_gitignore_unwritable",
-                reason: error.code.toLowerCase(),
-                required: "Grant the current user read and write access to the workspace .gitignore before initialization.",
-                why: "pm init must publish its managed runtime-cache ignore fence without replacing unrelated entries.",
-                nextSteps: [
-                    "Grant read and write access to the workspace .gitignore and rerun pm init.",
-                    "If the workspace is intentionally read-only, initialize pm in a writable workspace or clone.",
-                ],
-            });
-        }
-        throw error;
-    }
-}
-function normalizeTrackerRelativeRoot(trackerRelativeRoot) {
-    return trackerRelativeRoot
-        .replaceAll("\\", "/")
-        .replace(/^\.\/+/, "")
-        .replace(/\/+$/, "");
-}
-/** Return whether a relative path escapes its owning root, without rejecting valid names such as `..pm`. */
-export function isPathOutsideRoot(relativePath) {
-    const normalized = relativePath.replaceAll("\\", "/");
-    return (path.isAbsolute(relativePath) ||
-        normalized === ".." ||
-        normalized.startsWith("../"));
-}
-/** Return the canonical pm ignore block rendered for the given workspace-relative tracker root (defaults to `.agents/pm`), primarily for documentation and tests. */
-export function getPmGitignoreBlock(trackerRelativeRoot = PM_GITIGNORE_DEFAULT_TRACKER_ROOT) {
-    const root = normalizeTrackerRelativeRoot(trackerRelativeRoot);
-    return [
-        PM_GITIGNORE_START,
-        ...PM_GITIGNORE_RUNTIME_DIRECTORIES.map((directory) => directory === "search/"
-            ? `${root}/${directory}*`
-            : `${root}/${directory}`),
-        ...PM_GITIGNORE_TRACKED_FILES.map((file) => `!${root}/${file}`),
-        PM_GITIGNORE_END,
-    ].join("\n");
-}
-/**
- * Idempotently create or replace the fenced pm cache block in a workspace
- * `.gitignore`. When `pmRoot` is provided the ignored runtime directories are
- * rendered under the resolved workspace-relative tracker root, so custom-root
- * workspaces (`--pm-path`/`PM_PATH`) stop committing runtime caches (GH-598).
- * A tracker root outside the workspace needs no ignore rules here, so the
- * file is left untouched.
- */
-export async function ensurePmGitignore(workspaceRoot, options = {}) {
-    const gitignorePath = path.join(workspaceRoot, ".gitignore");
-    let trackerRelativeRoot = PM_GITIGNORE_DEFAULT_TRACKER_ROOT;
-    if (options.pmRoot !== undefined) {
-        const relative = normalizeTrackerRelativeRoot(path.relative(path.resolve(workspaceRoot), path.resolve(options.pmRoot)));
-        if (isPathOutsideRoot(relative)) {
-            return { path: gitignorePath, changed: false };
-        }
-        if (relative.length > 0) {
-            trackerRelativeRoot = relative;
-        }
-    }
-    let current = "";
-    try {
-        current = await withGitignorePermissionRecovery(() => readFile(gitignorePath, "utf8"));
-    }
-    catch (error) {
-        if (!(error instanceof Error && "code" in error && isFileMissingError(error))) {
-            throw error;
-        }
-    }
-    const start = current.indexOf(PM_GITIGNORE_START);
-    const end = current.indexOf(PM_GITIGNORE_END);
-    const withoutManagedBlock = start >= 0 && end >= start
-        ? `${current.slice(0, start)}${current.slice(end + PM_GITIGNORE_END.length)}`
-        : current;
-    const prefix = withoutManagedBlock.trimEnd();
-    const next = `${prefix.length > 0 ? `${prefix}\n\n` : ""}${getPmGitignoreBlock(trackerRelativeRoot)}\n`;
-    if (next === current) {
-        return { path: gitignorePath, changed: false };
-    }
-    await withGitignorePermissionRecovery(() => writeFile(gitignorePath, next, "utf8"));
-    return { path: gitignorePath, changed: true };
-}
+`:""}${getPmGitignoreBlock(trackerRelativeRoot)}
+`;if(next===current){return{path:gitignorePath,changed:false}}await withGitignorePermissionRecovery(()=>writeFile(gitignorePath,next,"utf8"));return{path:gitignorePath,changed:true}}export{PM_GITIGNORE_DEFAULT_TRACKER_ROOT,PM_GITIGNORE_END,PM_GITIGNORE_RUNTIME_DIRECTORIES,PM_GITIGNORE_START,PM_GITIGNORE_TRACKED_FILES,ensurePmGitignore,getPmGitignoreBlock,isPathOutsideRoot};
 //# sourceMappingURL=workspace.js.map
-//# debugId=89261a49-97e5-5ffc-a81c-2409f0b529cf

package/dist/types/index.js

@@ -1,10 +1,2 @@
-/**
- * @module types/index
- *
- * Defines the shared project-management data model used by CLI, SDK, MCP, and packages.
- */
-
-!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]="f6e82c93-54e8-53a7-94df-10a573aae933")}catch(e){}}();
-export * from "../types.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]="0ca7f52c-fb31-5cd9-b689-a918f4e61816")}catch(e2){}})();export*from"../types.js";
 //# sourceMappingURL=index.js.map
-//# debugId=f6e82c93-54e8-53a7-94df-10a573aae933

package/dist/types.js

@@ -1,246 +1,2 @@
-/**
- * @module types
- *
- * Defines the shared project-management data model used by CLI, SDK, MCP, and packages.
- */
-/** Supported values accepted by the builtin item type contract. */
-
-!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]="8173bdb0-39c8-56c0-85c2-5c39f5c213cc")}catch(e){}}();
-export const BUILTIN_ITEM_TYPE_VALUES = [
-    "Epic",
-    "Feature",
-    "Task",
-    "Chore",
-    "Issue",
-    "Decision",
-    "Event",
-    "Reminder",
-    "Milestone",
-    "Meeting",
-    "Plan",
-];
-/** Supported values accepted by the item type contract. */
-export const ITEM_TYPE_VALUES = BUILTIN_ITEM_TYPE_VALUES;
-/** Supported values accepted by the status contract. */
-export const STATUS_VALUES = [
-    "draft",
-    "open",
-    "in_progress",
-    "blocked",
-    "closed",
-    "canceled",
-];
-/** Supported values accepted by the runtime status role contract. */
-export const RUNTIME_STATUS_ROLE_VALUES = [
-    "draft",
-    "active",
-    "blocked",
-    "terminal",
-    "terminal_done",
-    "terminal_canceled",
-    "default_open",
-    "default_close",
-    "default_cancel",
-];
-/** Supported values accepted by the runtime field type contract. */
-export const RUNTIME_FIELD_TYPE_VALUES = [
-    "string",
-    "number",
-    "boolean",
-    "string_array",
-    "array",
-    "object",
-];
-/** Supported values accepted by the runtime field command contract. */
-export const RUNTIME_FIELD_COMMAND_VALUES = [
-    "create",
-    "update",
-    "update_many",
-    "list",
-    "search",
-    "calendar",
-    "context",
-];
-/** Supported values accepted by the runtime unknown field policy contract. */
-export const RUNTIME_UNKNOWN_FIELD_POLICY_VALUES = [
-    "allow",
-    "warn",
-    "reject",
-];
-/** Supported values accepted by the dependency kind contract. */
-export const DEPENDENCY_KIND_VALUES = [
-    "blocks",
-    "parent",
-    "child",
-    "parent_child",
-    "child_of",
-    "related",
-    "related_to",
-    "discovered_from",
-    "blocked_by",
-    "incident_from",
-    "epic",
-    "implements",
-    "recurs_from",
-    "supersedes",
-    "task",
-    "verifies",
-];
-/** Supported values accepted by the scope contract. */
-export const SCOPE_VALUES = ["project", "global"];
-/** Supported values accepted by the risk contract. */
-export const RISK_VALUES = ["low", "medium", "high", "critical"];
-/** Supported values accepted by the issue severity contract. */
-export const ISSUE_SEVERITY_VALUES = [
-    "low",
-    "medium",
-    "high",
-    "critical",
-];
-/** Supported values accepted by the confidence text contract. */
-export const CONFIDENCE_TEXT_VALUES = ["low", "medium", "high"];
-/** Supported values accepted by the item format contract. */
-export const ITEM_FORMAT_VALUES = ["toon", "json_markdown"];
-/** Supported values accepted by the sprint release format policy contract. */
-export const SPRINT_RELEASE_FORMAT_POLICY_VALUES = [
-    "warn",
-    "strict_error",
-];
-/** Supported values accepted by the parent reference policy contract. */
-export const PARENT_REFERENCE_POLICY_VALUES = ["warn", "strict_error"];
-/** Supported values accepted by the validate metadata profile contract. */
-export const VALIDATE_METADATA_PROFILE_VALUES = [
-    "core",
-    "strict",
-    "custom",
-];
-/** Supported values accepted by the governance preset contract. */
-export const GOVERNANCE_PRESET_VALUES = [
-    "minimal",
-    "default",
-    "strict",
-    "custom",
-];
-/** Supported values accepted by the governance ownership enforcement contract. */
-export const GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES = [
-    "none",
-    "warn",
-    "strict",
-];
-/** Supported values accepted by the governance create mode default contract. */
-export const GOVERNANCE_CREATE_MODE_DEFAULT_VALUES = [
-    "progressive",
-    "strict",
-];
-/** Supported values accepted by the governance close validation default contract. */
-export const GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES = [
-    "off",
-    "warn",
-    "strict",
-];
-/** Supported values accepted by the governance workflow enforcement contract. */
-export const GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES = [
-    "off",
-    "warn",
-    "strict",
-];
-/** Supported create/copy near-duplicate governance modes. */
-export const GOVERNANCE_DUPLICATE_DETECTION_MODE_VALUES = [
-    "off",
-    "advisory",
-    "strict",
-];
-/** Supported values accepted by the validate metadata required field contract. */
-export const VALIDATE_METADATA_REQUIRED_FIELD_VALUES = [
-    "author",
-    "acceptance_criteria",
-    "estimated_minutes",
-    "close_reason",
-    "reviewer",
-    "risk",
-    "confidence",
-    "sprint",
-    "release",
-];
-/** Supported values accepted by the recurrence frequency contract. */
-export const RECURRENCE_FREQUENCY_VALUES = [
-    "daily",
-    "weekly",
-    "monthly",
-    "yearly",
-];
-/** Supported values accepted by the recurrence weekday contract. */
-export const RECURRENCE_WEEKDAY_VALUES = [
-    "mon",
-    "tue",
-    "wed",
-    "thu",
-    "fri",
-    "sat",
-    "sun",
-];
-/** Canonical week-order index for a recurrence weekday (mon=0 .. sun=6). Shared by item serialization, create/update parsing, and calendar expansion so weekday ordering cannot drift between those modules. */
-export function weekdayOrderIndex(value) {
-    return RECURRENCE_WEEKDAY_VALUES.indexOf(value);
-}
-/** Supported values accepted by the plan mode contract. */
-export const PLAN_MODE_VALUES = [
-    "draft",
-    "research",
-    "review",
-    "approved",
-    "executing",
-    "paused",
-    "completed",
-    "superseded",
-];
-/** Supported values accepted by the plan step status contract. */
-export const PLAN_STEP_STATUS_VALUES = [
-    "pending",
-    "in_progress",
-    "completed",
-    "blocked",
-    "skipped",
-    "superseded",
-];
-/** Supported values accepted by the plan harness contract. */
-export const PLAN_HARNESS_VALUES = [
-    "codex",
-    "claude-code",
-    "cursor",
-    "generic",
-];
-/** Supported values accepted by the plan step link kind contract. */
-export const PLAN_STEP_LINK_KIND_VALUES = [
-    "related",
-    "blocks",
-    "blocked_by",
-    "depends_on",
-    "discovered_from",
-    "implements",
-    "recurs_from",
-    "verifies",
-    "supersedes",
-];
-/** Supported values accepted by the context depth contract. */
-export const CONTEXT_DEPTH_VALUES = [
-    "brief",
-    "standard",
-    "deep",
-    "full",
-];
-/** Supported values accepted by the context section contract. */
-export const CONTEXT_SECTION_VALUES = [
-    "hierarchy",
-    "activity",
-    "progress",
-    "recently_created",
-    "unparented",
-    "blockers",
-    "files",
-    "workload",
-    "staleness",
-    "tests",
-];
+!(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]="39eb895c-059b-5b65-b1ef-b73bfa13f093")}catch(e2){}})();const BUILTIN_ITEM_TYPE_VALUES=["Epic","Feature","Task","Chore","Issue","Decision","Event","Reminder","Milestone","Meeting","Plan"];const ITEM_TYPE_VALUES=BUILTIN_ITEM_TYPE_VALUES;const STATUS_VALUES=["draft","open","in_progress","blocked","closed","canceled"];const RUNTIME_STATUS_ROLE_VALUES=["draft","active","blocked","terminal","terminal_done","terminal_canceled","default_open","default_close","default_cancel"];const RUNTIME_FIELD_TYPE_VALUES=["string","number","boolean","string_array","array","object"];const RUNTIME_FIELD_COMMAND_VALUES=["create","update","update_many","list","search","calendar","context"];const RUNTIME_UNKNOWN_FIELD_POLICY_VALUES=["allow","warn","reject"];const DEPENDENCY_KIND_VALUES=["blocks","parent","child","parent_child","child_of","related","related_to","discovered_from","blocked_by","incident_from","epic","implements","recurs_from","supersedes","task","verifies"];const SCOPE_VALUES=["project","global"];const RISK_VALUES=["low","medium","high","critical"];const ISSUE_SEVERITY_VALUES=["low","medium","high","critical"];const CONFIDENCE_TEXT_VALUES=["low","medium","high"];const ITEM_FORMAT_VALUES=["toon","json_markdown"];const SPRINT_RELEASE_FORMAT_POLICY_VALUES=["warn","strict_error"];const PARENT_REFERENCE_POLICY_VALUES=["warn","strict_error"];const VALIDATE_METADATA_PROFILE_VALUES=["core","strict","custom"];const GOVERNANCE_PRESET_VALUES=["minimal","default","strict","custom"];const GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES=["none","warn","strict"];const GOVERNANCE_CREATE_MODE_DEFAULT_VALUES=["progressive","strict"];const GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES=["off","warn","strict"];const GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES=["off","warn","strict"];const GOVERNANCE_DUPLICATE_DETECTION_MODE_VALUES=["off","advisory","strict"];const VALIDATE_METADATA_REQUIRED_FIELD_VALUES=["author","acceptance_criteria","estimated_minutes","close_reason","reviewer","risk","confidence","sprint","release"];const RECURRENCE_FREQUENCY_VALUES=["daily","weekly","monthly","yearly"];const RECURRENCE_WEEKDAY_VALUES=["mon","tue","wed","thu","fri","sat","sun"];function weekdayOrderIndex(value){return RECURRENCE_WEEKDAY_VALUES.indexOf(value)}const PLAN_MODE_VALUES=["draft","research","review","approved","executing","paused","completed","superseded"];const PLAN_STEP_STATUS_VALUES=["pending","in_progress","completed","blocked","skipped","superseded"];const PLAN_HARNESS_VALUES=["codex","claude-code","cursor","generic"];const PLAN_STEP_LINK_KIND_VALUES=["related","blocks","blocked_by","depends_on","discovered_from","implements","recurs_from","verifies","supersedes"];const CONTEXT_DEPTH_VALUES=["brief","standard","deep","full"];const CONTEXT_SECTION_VALUES=["hierarchy","activity","progress","recently_created","unparented","blockers","files","workload","staleness","tests"];export{BUILTIN_ITEM_TYPE_VALUES,CONFIDENCE_TEXT_VALUES,CONTEXT_DEPTH_VALUES,CONTEXT_SECTION_VALUES,DEPENDENCY_KIND_VALUES,GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES,GOVERNANCE_CREATE_MODE_DEFAULT_VALUES,GOVERNANCE_DUPLICATE_DETECTION_MODE_VALUES,GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES,GOVERNANCE_PRESET_VALUES,GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES,ISSUE_SEVERITY_VALUES,ITEM_FORMAT_VALUES,ITEM_TYPE_VALUES,PARENT_REFERENCE_POLICY_VALUES,PLAN_HARNESS_VALUES,PLAN_MODE_VALUES,PLAN_STEP_LINK_KIND_VALUES,PLAN_STEP_STATUS_VALUES,RECURRENCE_FREQUENCY_VALUES,RECURRENCE_WEEKDAY_VALUES,RISK_VALUES,RUNTIME_FIELD_COMMAND_VALUES,RUNTIME_FIELD_TYPE_VALUES,RUNTIME_STATUS_ROLE_VALUES,RUNTIME_UNKNOWN_FIELD_POLICY_VALUES,SCOPE_VALUES,SPRINT_RELEASE_FORMAT_POLICY_VALUES,STATUS_VALUES,VALIDATE_METADATA_PROFILE_VALUES,VALIDATE_METADATA_REQUIRED_FIELD_VALUES,weekdayOrderIndex};
 //# sourceMappingURL=types.js.map
-//# debugId=8173bdb0-39c8-56c0-85c2-5c39f5c213cc

package/docs/AGENT_GUIDE.md

@@ -288,7 +288,7 @@ Use these defaults unless the task requires otherwise:
 Concurrent agents work on ordinary Git branches/worktrees; tracker artifacts need the semantic merge contract from [Merge Safety](MERGE_SAFETY.md). The short loop:
 
 - After a fresh clone or new worktree, run `pm merge install` once so the field-aware merge drivers back the committed `.gitattributes` fence.
-- After every merge that touches `.agents/pm`, run `pm merge reconcile --dry-run --json`, review the receipt classification, then apply `pm merge reconcile`. Add `--force` only after explicitly accepting or re-applying every discarded scalar value. Finish with `pm validate --check-storage-integrity` and `pm history --verify --strict-exit`.
+- After every merge that touches `.agents/pm`, run `pm merge reconcile --dry-run --json`, review the receipt classification, then apply `pm merge reconcile`. Add `--force` only after explicitly accepting or re-applying every discarded scalar value. Finish with `pm validate --check-storage-integrity --check-history-drift`, then `pm history <id> --verify --strict-exit` for each affected stream (`_workspace` for workspace state).
 - Repositories fanning out many branches between merges should raise id entropy: `pm config project set ids_token_length 6`.
 - Use `--add-ac`/`--remove-ac` (not `--ac`) so concurrent acceptance-criteria edits merge instead of clobbering.
 

package/docs/CONTEXT_ALGORITHM_PORTFOLIO.md

@@ -0,0 +1,167 @@
+# Context Algorithm Portfolio
+
+Tracked by [pm-g8t7b9](../.agents/pm/tasks/pm-g8t7b9.toon), [pm-4k6b](../.agents/pm/features/pm-4k6b.toon), and [pm-vvib](../.agents/pm/decisions/pm-vvib.toon).
+
+This is a navigation index of the historical algorithm ledger and cognitive proposals.
+Individual pm items own scope, decisions, experiments, and current evidence.
+A shared substrate or an earlier defect fix does not establish that a proposed
+ranking mechanism has been implemented. Read each owner live before claiming its state.
+
+## Bounded discovery
+
+```bash
+pm list --all --tags algorithm-proposal --limit 10
+pm search "<stable-slug>" --limit 5
+pm get <owner-id> --full
+pm history <owner-id> --full
+```
+
+Use the result cursor and omission receipt before making a complete-catalog claim.
+The four agent skills route to generated capability references; this portfolio
+does not add a new command family or a second execution backlog.
+
+## Algorithm ledger
+
+The 76 mechanisms below retain their original note timestamps and numeric aliases.
+An ordinal is ambiguous without its source note; new proposals use stable slugs.
+Where two descriptions express one experiment, both slugs resolve to its owner.
+Existing acceptance owners retain their original delivery boundary.
+
+| Stable slug | Historical ordinal | Source note (UTC) | Canonical owner | Disposition |
+| --- | --- | --- | --- | --- |
+| `act-r-activation` | 1 | 2026-07-07T15:12:12.161Z | [pm-fr9ok0](../.agents/pm/tasks/pm-fr9ok0.toon) | Proposed experiment |
+| `typed-spreading-activation` | 2 | 2026-07-07T15:12:12.161Z | [pm-fdb8e8](../.agents/pm/tasks/pm-fdb8e8.toon) | Proposed experiment |
+| `learned-linear-signal-weights` | 3 | 2026-07-07T15:12:12.161Z | [pm-ex5p2u](../.agents/pm/tasks/pm-ex5p2u.toon) | Proposed experiment |
+| `submodular-token-selection` | 4 | 2026-07-07T15:12:12.161Z | [pm-oadvw7](../.agents/pm/tasks/pm-oadvw7.toon) | Proposed experiment |
+| `reciprocal-rank-fusion` | 5 | 2026-07-07T15:26:05.199Z | [pm-h3no](../.agents/pm/tasks/pm-h3no.toon) | Existing acceptance owner |
+| `incremental-signal-fold` | 6 | 2026-07-07T15:26:05.199Z | [pm-801d](../.agents/pm/features/pm-801d.toon) | Existing acceptance owner |
+| `quota-bounded-retrieval-funnel` | 7 | 2026-07-07T15:37:10.972Z | [pm-v3grp9](../.agents/pm/tasks/pm-v3grp9.toon) | Proposed experiment |
+| `sketch-backed-affinity-state` | 8 | 2026-07-07T15:57:35.738Z | [pm-cxydzq](../.agents/pm/tasks/pm-cxydzq.toon) | Proposed experiment |
+| `granularity-adaptive-packing` | 9 | 2026-07-07T16:35:16.531Z | [pm-55ra](../.agents/pm/tasks/pm-55ra.toon) | Existing acceptance owner |
+| `structural-analogical-recall` | 10 | 2026-07-07T20:06:11.214Z | [pm-l4a5q9](../.agents/pm/tasks/pm-l4a5q9.toon) | Proposed experiment |
+| `open-loop-persistence` | 11 | 2026-07-07T20:26:24.821Z | [pm-u8rjvb](../.agents/pm/tasks/pm-u8rjvb.toon) | Proposed experiment |
+| `co-change-precedent-projection` | 12 | 2026-07-08T04:50:57.291Z | [pm-uk74i4](../.agents/pm/tasks/pm-uk74i4.toon) | Proposed experiment |
+| `salience-broadcast-habituation` | 13 | 2026-07-08T04:59:00.593Z | [pm-jd2wst](../.agents/pm/tasks/pm-jd2wst.toon) | Proposed experiment |
+| `retrieval-contradiction-gating` | 14 | 2026-07-08T22:51:13.305Z | [pm-xfta80](../.agents/pm/tasks/pm-xfta80.toon) | Proposed experiment |
+| `gist-verbatim-retention` | 15 | 2026-07-08T22:59:05.110Z | [pm-n7fpe8](../.agents/pm/tasks/pm-n7fpe8.toon) | Proposed experiment |
+| `successor-representation-map` | 16 | 2026-07-08T23:04:09.486Z | [pm-bj248h](../.agents/pm/tasks/pm-bj248h.toon) | Proposed experiment |
+| `learning-progress-exploration` | 17 | 2026-07-09T10:35:29.359Z | [pm-w0x318](../.agents/pm/tasks/pm-w0x318.toon) | Proposed experiment |
+| `deadline-anytime-assembly` | 18 | 2026-07-12T19:06:43.973Z | [pm-ltygoc](../.agents/pm/tasks/pm-ltygoc.toon) | Proposed experiment |
+| `intent-conditioned-profiles` | 19 | 2026-07-12T19:07:07.668Z | [pm-55ra](../.agents/pm/tasks/pm-55ra.toon) | Existing acceptance owner |
+| `temporal-era-segmentation` | 20 | 2026-07-13T17:49:16.342Z | [pm-tnkni6](../.agents/pm/tasks/pm-tnkni6.toon) | Proposed experiment |
+| `empirical-bayes-signal-shrinkage` | 21 | 2026-07-13T17:49:39.249Z | [pm-4lg7gl](../.agents/pm/tasks/pm-4lg7gl.toon) | Proposed experiment |
+| `lineage-relevance-continuity` | 22 | 2026-07-13T17:50:01.162Z | [pm-pyny5e](../.agents/pm/tasks/pm-pyny5e.toon) | Proposed experiment |
+| `consumer-conditioned-context` | 23 | 2026-07-24T23:56:51.483Z | [pm-oiml5g](../.agents/pm/tasks/pm-oiml5g.toon) | Proposed experiment |
+| `intent-ambiguity-hedging` | 24 | 2026-07-25T06:21:11.864Z | [pm-3t4fpz](../.agents/pm/tasks/pm-3t4fpz.toon) | Proposed experiment |
+| `description-length-stopping` | 25 | 2026-07-25T06:21:11.864Z | [pm-hnnsk4](../.agents/pm/tasks/pm-hnnsk4.toon) | Proposed experiment |
+| `fleet-shared-assembly` | 26 | 2026-07-25T06:21:11.864Z | [pm-tch9cs](../.agents/pm/features/pm-tch9cs.toon) | Existing acceptance owner |
+| `session-budget-allocation` | 27 | 2026-07-25T06:21:11.864Z | [pm-0d8cx0](../.agents/pm/tasks/pm-0d8cx0.toon) | Proposed experiment |
+| `model-conditioned-packing` | 19 | 2026-07-25T12:33:08.547Z | [pm-oiml5g](../.agents/pm/tasks/pm-oiml5g.toon) | Alias of `consumer-conditioned-context` |
+| `merge-probability-provenance` | 20 | 2026-07-25T12:33:09.924Z | [pm-2owmm9](../.agents/pm/tasks/pm-2owmm9.toon) | Proposed experiment |
+| `hash-keyed-summary-pyramid` | 21 | 2026-07-25T12:33:12.348Z | [pm-7go3ml](../.agents/pm/tasks/pm-7go3ml.toon) | Proposed experiment |
+| `counterfactual-replay-evaluation` | 22 | 2026-07-25T12:33:13.616Z | [pm-atfm](../.agents/pm/features/pm-atfm.toon) | Existing acceptance owner |
+| `federated-relevance-calibration` | 23 | 2026-07-25T17:55:26.153Z | [pm-p5x04j](../.agents/pm/tasks/pm-p5x04j.toon) | Proposed experiment |
+| `fleet-joint-diversification` | 24 | 2026-07-25T17:55:27.244Z | [pm-u7dei0](../.agents/pm/tasks/pm-u7dei0.toon) | Proposed experiment |
+| `outcome-distance-prior` | slug only | 2026-07-26T06:05:19.670Z | [pm-j915gx](../.agents/pm/tasks/pm-j915gx.toon) | Proposed experiment |
+| `maintenance-invariant-temporal-coordinates` | slug only | 2026-07-26T17:12:19.040Z | [pm-07pt16](../.agents/pm/issues/pm-07pt16.toon) | Existing acceptance owner |
+| `on-policy-context-evaluation-in-replayable-episodes` | slug only | 2026-07-26T22:10:55.488Z | [pm-atfm](../.agents/pm/features/pm-atfm.toon) | Existing acceptance owner |
+| `cited-substrate-churn-retention` | 28 | 2026-07-27T04:16:41.976Z | [pm-7xva2q](../.agents/pm/tasks/pm-7xva2q.toon) | Proposed experiment |
+| `ordering-slack-conditioned-urgency` | slug only | 2026-07-27T12:56:49.162Z | [pm-a795un](../.agents/pm/tasks/pm-a795un.toon) | Proposed experiment |
+| `recorded-order-arbitration` | slug only | 2026-07-28T15:06:04.775Z | [pm-6x7o](../.agents/pm/features/pm-6x7o.toon) | Existing acceptance owner |
+| `refuted-and-abandoned-evidence-retrieval` | slug only | 2026-07-28T22:37:05.155Z | [pm-j0hhum](../.agents/pm/tasks/pm-j0hhum.toon) | Proposed experiment |
+| `trust-weighted-context-assembly` | slug only | 2026-07-28T22:37:06.038Z | [pm-uzjalq](../.agents/pm/tasks/pm-uzjalq.toon) | Proposed experiment |
+| `omission-cost-asymmetric-ranking` | slug only | 2026-07-29T04:53:05.081Z | [pm-u64x78](../.agents/pm/tasks/pm-u64x78.toon) | Proposed experiment |
+| `absence-as-signal-coverage-complement` | slug only | 2026-07-29T04:53:05.081Z | [pm-qy48yz](../.agents/pm/tasks/pm-qy48yz.toon) | Proposed experiment |
+| `pinned-epoch-context-determinism` | slug only | 2026-07-29T04:53:05.081Z | [pm-8bgeye](../.agents/pm/features/pm-8bgeye.toon) | Existing acceptance owner |
+| `action-legality-conditioned-assembly` | slug only | 2026-07-29T16:59:47.781Z | [pm-cg9tgx](../.agents/pm/tasks/pm-cg9tgx.toon) | Proposed experiment |
+| `shape-conditioned-parameter-selection` | slug only | 2026-07-29T16:59:47.781Z | [pm-jxszo5](../.agents/pm/tasks/pm-jxszo5.toon) | Proposed experiment |
+| `cross-channel-disagreement-salience` | slug only | 2026-07-30T09:24:36.574Z | [pm-zhowns](../.agents/pm/tasks/pm-zhowns.toon) | Proposed experiment |
+| `budget-feasible-projection-descent` | slug only | 2026-07-30T17:12:42.066Z | [pm-yekkvt](../.agents/pm/issues/pm-yekkvt.toon) | Existing acceptance owner |
+| `co-mutation-cohort-inference` | slug only | 2026-07-31T06:12:41.171Z | [pm-8996e1](../.agents/pm/tasks/pm-8996e1.toon) | Proposed experiment |
+| `state-erased-signal-recovery` | slug only | 2026-07-31T14:19:33.829Z | [pm-oz1p2u](../.agents/pm/tasks/pm-oz1p2u.toon) | Proposed experiment |
+| `occupancy-interval-contention-inference` | slug only | 2026-08-01T09:51:18.539Z | [pm-ieskvz](../.agents/pm/tasks/pm-ieskvz.toon) | Proposed experiment |
+| `refusal-conditioned-retrieval-repair` | slug only | 2026-08-01T13:07:13.153Z | [pm-f6kmj2](../.agents/pm/tasks/pm-f6kmj2.toon) | Proposed experiment |
+| `citation-stable-evidence-addressing` | 23 | 2026-08-02T15:04:50.169Z | [pm-8bgeye](../.agents/pm/features/pm-8bgeye.toon) | Existing acceptance owner |
+| `convergence-confidence-weighting` | 24 | 2026-08-02T21:14:06.605Z | [pm-2owmm9](../.agents/pm/tasks/pm-2owmm9.toon) | Alias of `merge-probability-provenance` |
+| `session-marginal-relevance` | 25 | 2026-08-03T06:28:46.897Z | [pm-hid9g1](../.agents/pm/features/pm-hid9g1.toon) | Existing acceptance owner |
+| `recurrence-conditioned-retrieval` | 26 | 2026-08-03T20:40:23.212Z | [pm-x8cw63](../.agents/pm/tasks/pm-x8cw63.toon) | Proposed experiment |
+| `temporally-anchored-graph-proximity` | 27 | 2026-08-04T05:54:30.594Z | [pm-9lhtuf](../.agents/pm/tasks/pm-9lhtuf.toon) | Proposed experiment |
+| `act-conditioned-loss-asymmetry` | 28 | 2026-08-07T05:23:58.135Z | [pm-u64x78](../.agents/pm/tasks/pm-u64x78.toon) | Alias of `omission-cost-asymmetric-ranking` |
+| `structure-conditioned-signal-weighting` | 29 | 2026-08-07T11:23:09.664Z | [pm-77pz59](../.agents/pm/tasks/pm-77pz59.toon) | Proposed experiment |
+| `cost-priced-signal-admission` | 30 | 2026-08-07T17:23:07.639Z | [pm-ltygoc](../.agents/pm/tasks/pm-ltygoc.toon) | Alias of `deadline-anytime-assembly` |
+| `reader-writer-contract-change-salience` | 31 | 2026-08-08T08:04:42.076Z | [pm-h3l0th](../.agents/pm/tasks/pm-h3l0th.toon) | Proposed experiment |
+| `epoch-conditioned-evidence-confidence` | 32 | 2026-08-08T22:00:52.713Z | [pm-nh1348](../.agents/pm/tasks/pm-nh1348.toon) | Proposed experiment |
+| `coverage-ratio-conditioned-evidence` | 33 | 2026-08-09T06:06:13.120Z | [pm-hlf7ca](../.agents/pm/tasks/pm-hlf7ca.toon) | Proposed experiment |
+| `property-lifetime-evidence-retention` | 34 | 2026-08-09T13:39:47.942Z | [pm-n7u3he](../.agents/pm/tasks/pm-n7u3he.toon) | Proposed experiment |
+| `subscriber-weighted-salience` | 35 | 2026-08-09T20:05:21.715Z | [pm-stdu2g](../.agents/pm/tasks/pm-stdu2g.toon) | Proposed experiment |
+| `truthful-field-omission-receipts` | 36 | 2026-08-10T06:08:53.534Z | [pm-tld20c](../.agents/pm/issues/pm-tld20c.toon) | Existing acceptance owner |
+| `governance-invariant-topology-signals` | 37 | 2026-08-10T12:19:15.015Z | [pm-5wc91d](../.agents/pm/tasks/pm-5wc91d.toon) | Proposed experiment |
+| `canonical-graph-measurement-reuse` | 38 | 2026-08-10T16:10:50.473Z | [pm-atfm](../.agents/pm/features/pm-atfm.toon) | Existing acceptance owner |
+| `redundancy-discounted-structural-weight` | 39 | 2026-08-10T21:02:34.076Z | [pm-nmti7j](../.agents/pm/tasks/pm-nmti7j.toon) | Proposed experiment |
+| `kind-rarity-edge-weighting` | 40 | 2026-08-11T14:11:06.615Z | [pm-cpnzmc](../.agents/pm/tasks/pm-cpnzmc.toon) | Proposed experiment |
+| `reachability-basis-aware-lineage` | 41 | 2026-08-13T08:51:22.149Z | [pm-wsyj7k](../.agents/pm/tasks/pm-wsyj7k.toon) | Proposed experiment |
+| `distribution-gated-structural-weight` | 42 | 2026-08-13T14:32:56.524Z | [pm-77pz59](../.agents/pm/tasks/pm-77pz59.toon) | Alias of `structure-conditioned-signal-weighting` |
+| `coverage-preserving-budget-truncation` | 43 | 2026-08-13T21:15:51.685Z | [pm-mo38ao](../.agents/pm/tasks/pm-mo38ao.toon) | Proposed experiment |
+| `event-quantile-recency` | 44 | 2026-08-14T05:25:41.723Z | [pm-8ryvgm](../.agents/pm/tasks/pm-8ryvgm.toon) | Proposed experiment |
+| `retrieval-action-ranking` | 45 | 2026-08-16T10:35:34.761Z | [pm-ra49iv](../.agents/pm/tasks/pm-ra49iv.toon) | Proposed experiment |
+| `declared-summary-populations` | 46 | 2026-09-04T18:40:47.913Z | [pm-79gv6q](../.agents/pm/issues/pm-79gv6q.toon) | Existing acceptance owner |
+
+## Cognitive subsystem mapping
+
+The 18 candidate compositions from pm-vvib retain the architecture decision gate.
+Individual experiment drafts record the ideas without accepting that decision.
+
+| Candidate | Composition | Canonical owner |
+| --- | --- | --- |
+| 1 | Prospective memory | [pm-0uvib0](../.agents/pm/tasks/pm-0uvib0.toon) |
+| 2 | Metacognitive revalidation | [pm-ur2t9o](../.agents/pm/tasks/pm-ur2t9o.toon) |
+| 3 | Interference and belief revision | [pm-xfta80](../.agents/pm/tasks/pm-xfta80.toon) |
+| 4 | Novelty and returning-agent deltas | [pm-tuadp2](../.agents/pm/features/pm-tuadp2.toon) |
+| 5 | Receiver-relative handoff | [pm-isldic](../.agents/pm/tasks/pm-isldic.toon) |
+| 6 | Source monitoring | [pm-uzjalq](../.agents/pm/tasks/pm-uzjalq.toon) |
+| 7 | Failure-sensitive avoidance | [pm-u64x78](../.agents/pm/tasks/pm-u64x78.toon) |
+| 8 | Procedural acquisition | [pm-5ay6gn](../.agents/pm/tasks/pm-5ay6gn.toon) |
+| 9 | Encoding context and source situations | [pm-8bgeye](../.agents/pm/features/pm-8bgeye.toon) |
+| 10 | Chunking and representation selection | [pm-55ra](../.agents/pm/tasks/pm-55ra.toon) |
+| 11 | Analogical retrieval | [pm-l4a5q9](../.agents/pm/tasks/pm-l4a5q9.toon) |
+| 12 | Open-loop persistence | [pm-u8rjvb](../.agents/pm/tasks/pm-u8rjvb.toon) |
+| 13 | Episodic future thinking | [pm-uk74i4](../.agents/pm/tasks/pm-uk74i4.toon) |
+| 14 | Salience broadcast | [pm-jd2wst](../.agents/pm/tasks/pm-jd2wst.toon) |
+| 15 | Reconsolidation gating | [pm-xfta80](../.agents/pm/tasks/pm-xfta80.toon) |
+| 16 | Gist/verbatim retention | [pm-n7fpe8](../.agents/pm/tasks/pm-n7fpe8.toon) |
+| 17 | Predictive cognitive map | [pm-bj248h](../.agents/pm/tasks/pm-bj248h.toon) |
+| 18 | Learning-progress exploration | [pm-w0x318](../.agents/pm/tasks/pm-w0x318.toon) |
+
+## Shared experiment contract
+
+Each proposal names its source, bounded SDK contract, inputs, evaluation population,
+costs, deterministic fallback, and promotion or rejection rule. Compare against
+an unchanged baseline on held-out judgments. Report task success, critical-evidence
+omission, ranking quality, tokens, latency, memory, and rebuild cost separately.
+
+Use tiny, real-shaped, sparse/dense, returning-session, concurrent, and long-history
+fixtures. A smoke run cannot certify million-item performance or fleet convergence.
+Read and write through the public SDK; CLI and MCP remain adapters.
+
+Historical descriptions may contain hypotheses about optimality, independence, or
+constant-time behavior. Those are claims to test. State the assumptions required
+by an approximation guarantee, and preserve missing evidence as unknown.
+
+Promotion requires an explicit decision and passing current mandatory gates.
+A proposed experiment does not authorize a production policy, adaptive learning,
+or workspace-data export. Rejected experiments remain searchable evidence.
+
+## Mathematical checks before promotion
+
+- RRF's published offset of 60 was an empirical choice. Retain a deterministic
+  baseline and test alternatives; it is not a universal calibration constant.
+  [Cormack, Clarke, and Büttcher (2009)](https://cormack.uwaterloo.ca/cormacksigir09-rrf.pdf).
+- A plain value-per-token greedy heuristic does not inherit every submodular
+  approximation guarantee. Sviridenko's knapsack result assumes a nonnegative,
+  nondecreasing submodular objective and uses partial enumeration with greedy
+  completion. Representation exclusivity and negative penalties need their own
+  analysis. [Sviridenko (2004)](https://www.sciencedirect.com/science/article/pii/S0167637703000622).
+- WL subtree features scale with edges and refinement rounds in the published
+  formulation. Our proposed use still needs bounded neighborhoods and an
+  evaluation of whether structural similarity predicts useful project evidence.
+  [Shervashidze et al. (2011)](https://www.jmlr.org/papers/v12/shervashidze11a.html).

package/docs/DIAGNOSTIC_OUTPUT_CONTRACTS.md

@@ -1,6 +1,6 @@
 # Diagnostic Output Contracts
 
-Tracker references: [pm-cha95z](../.agents/pm/tasks/pm-cha95z.toon), [pm-5t33or](../.agents/pm/features/pm-5t33or.toon), [pm-f05lsg](../.agents/pm/features/pm-f05lsg.toon), and [pm-h8tpeh](../.agents/pm/features/pm-h8tpeh.toon).
+Tracker references: [pm-cha95z](../.agents/pm/tasks/pm-cha95z.toon), [pm-5t33or](../.agents/pm/features/pm-5t33or.toon), [pm-f05lsg](../.agents/pm/features/pm-f05lsg.toon), [pm-h8tpeh](../.agents/pm/features/pm-h8tpeh.toon), and [pm-m4uyyj](../.agents/pm/issues/pm-m4uyyj.toon).
 
 ## Agent Quick Context
 
@@ -77,8 +77,14 @@ The deterministic ladder is:
 
 Human diagnostics lead with `What is required` and next steps before explaining
 what happened. If their declared ceiling binds, the compact text still begins
-with the required action and points to structured JSON for the bounded recovery
-envelope.
+with the required action, retains the first identifying line (up to 320 UTF-8
+bytes), and points to structured JSON for the bounded recovery envelope. The
+first line should name the specific failure, such as `Error: Unknown option
+--label`. Oversized caller-input echoes are discarded before this identity;
+the retained identity and corrective action share the binding byte budget.
+The text projector strips terminal escape sequences and replaces remaining
+control characters before measuring output, including short diagnostics that
+fit the budget. Line breaks and ordinary indentation are preserved.
 
 ## Executable Assurance
 

package/docs/EXTENSIONS.md

@@ -16,6 +16,7 @@ pm package upgrade --dry-run
 Hidden `pm extension ...`, `pm install ...`, and `pm upgrade ...` aliases remain supported for compatibility. They execute the canonical package handlers, keep stdout machine-compatible, and emit one migration hint on stderr unless the public config key `ux_deprecation_hints` (stored at `ux.deprecation_hints`) is disabled. Related docs: [SDK](SDK.md), [Configuration](CONFIGURATION.md), [Testing](TESTING.md), [Command Reference](COMMANDS.md), [Extension Author Contracts](EXTENSION_AUTHOR_CONTRACTS.md).
 
 ## Package Sources
+See [Install plans and update evidence](PACKAGE_EVIDENCE.md) for copy-cost planning and freshness semantics.
 
 `pm package install` accepts local, registry, and GitHub sources: