@unbrained/pm-cli 2026.8.24 → 2026.8.26

package/dist/sdk/agent/refusal-closure-census.d.ts

@@ -44,10 +44,14 @@ export interface PmRefusalClosureCensusReport {
     /** Exactly one row for every catalog code. */
     rows: PmRefusalClosureCensusRow[];
 }
-/** Reviewed floor of 16 catalog rows; includes one alias across 15 canonical groups. */
+/** @deprecated Historical v1 floor retained for SDK compatibility. */
 export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE = 16;
-/** Fifteen canonical compatibility groups that must retain executable evidence. */
+/** @deprecated Historical v1 identities retained for SDK compatibility. */
 export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE: readonly ["bulk_ids_input_empty", "bulk_ids_input_missing_path", "bulk_ids_input_unreadable", "invalid_argument_value", "missing_lifecycle_target", "missing_required_argument", "projection_options_mutually_exclusive", "tracker_not_initialized", "tracker_root_missing", "tracker_root_not_directory", "tracker_root_unreadable", "unknown_context_intent", "unknown_field_projection", "unknown_option", "unknown_subcommand"];
+/** Reviewed v2 floor of 18 catalog rows across 17 canonical groups. */
+export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE_V2 = 18;
+/** V2 canonical identities that must retain executable evidence. */
+export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE_V2: readonly string[];
 /** Ratchet receipt that prevents catalog growth from erasing proven closure. */
 export declare function verifyPmRefusalClosureRatchet(report: PmRefusalClosureCensusReport, baseline?: number): {
     ok: boolean;

package/dist/sdk/agent/refusal-closure-census.js

@@ -1,8 +1,8 @@
-/** Reviewed floor of 16 catalog rows; includes one alias across 15 canonical groups. */
+/** @deprecated Historical v1 floor retained for SDK compatibility. */
 
-!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]="5560aa3a-036e-509c-955c-a09e9bf9df18")}catch(e){}}();
+!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]="a1efaf49-c6ca-53dd-8fad-eb2540c20cc8")}catch(e){}}();
 export const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE = 16;
-/** Fifteen canonical compatibility groups that must retain executable evidence. */
+/** @deprecated Historical v1 identities retained for SDK compatibility. */
 export const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE = Object.freeze([
     "bulk_ids_input_empty",
     "bulk_ids_input_missing_path",
@@ -20,8 +20,16 @@ export const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE = Object.free
     "unknown_option",
     "unknown_subcommand",
 ]);
+/** Reviewed v2 floor of 18 catalog rows across 17 canonical groups. */
+export const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE_V2 = 18;
+/** V2 canonical identities that must retain executable evidence. */
+export const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE_V2 = Object.freeze([
+    ...PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE,
+    "manifest_unknown_key",
+    "no_version_bounds_declared",
+].sort((left, right) => left.localeCompare(right)));
 /** Ratchet receipt that prevents catalog growth from erasing proven closure. */
-export function verifyPmRefusalClosureRatchet(report, baseline = PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE) {
+export function verifyPmRefusalClosureRatchet(report, baseline = PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE_V2) {
     return {
         ok: report.executable_error_code_count >= baseline,
         baseline,
@@ -29,7 +37,7 @@ export function verifyPmRefusalClosureRatchet(report, baseline = PM_REFUSAL_CLOS
     };
 }
 /** Ratchet canonical compatibility-group identities independently from counts. */
-export function verifyPmRefusalClosureIdentityRatchet(report, requiredCanonicalCodes = PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE) {
+export function verifyPmRefusalClosureIdentityRatchet(report, requiredCanonicalCodes = PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE_V2) {
     const executableCanonicalCodes = new Set(report.rows
         .filter(({ disposition }) => disposition === "executable")
         .map(({ canonical_code: canonicalCode }) => canonicalCode));
@@ -127,8 +135,8 @@ export function renderPmRefusalClosureCensusMarkdown(report) {
         "",
         `- Catalog error codes: ${report.catalog_error_code_count}`,
         `- Executable error codes: ${report.executable_error_code_count}`,
-        `- Executable-code ratchet floor: ${PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE}`,
-        `- Required executable canonical codes: ${PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE.map((code) => `\`${code}\``).join(", ")}`,
+        `- Executable-code ratchet floor: ${PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE_V2}`,
+        `- Required executable canonical codes: ${PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE_V2.map((code) => `\`${code}\``).join(", ")}`,
         `- Uncovered error codes: ${report.uncovered_error_code_count}`,
         `- Coverage fraction: ${report.coverage_fraction.toFixed(6)}`,
         `- Closed-domain probes: ${report.closed_domain_probe_count}`,
@@ -141,4 +149,4 @@ export function renderPmRefusalClosureCensusMarkdown(report) {
     ].join("\n");
 }
 //# sourceMappingURL=refusal-closure-census.js.map
-//# debugId=5560aa3a-036e-509c-955c-a09e9bf9df18
+//# debugId=a1efaf49-c6ca-53dd-8fad-eb2540c20cc8

package/dist/sdk/cli-contracts/runtime-contracts.d.ts

@@ -126,6 +126,16 @@ export interface ContractsResult {
         degradation_ladder: string[];
         allows_unbounded_opt_out: boolean;
     };
+    /** Exact per-command projection vocabularies and the scope of the compatibility union. */
+    output_projection_contracts?: {
+        global_ladder_field: "output_policy.degradation_ladder";
+        global_ladder_scope: "union_not_per_command";
+        discovery: "pm contracts --command <command> --summary";
+        commands?: Array<{
+            command: string;
+            modes: string[];
+        }>;
+    };
     /** Value that configures or reports runtime schema for this contract. */
     runtime_schema?: {
         statuses: string[];

package/dist/sdk/cli-contracts/runtime-contracts.js

@@ -4,7 +4,7 @@
  * Implements the pm contracts command surface and its agent-facing runtime behavior.
  */
 
-!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]="e8f1efca-4e83-570f-8c33-96f0405035b0")}catch(e){}}();
+!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]="428a19d2-be42-548a-a328-aa0e476b8a71")}catch(e){}}();
 import { EXIT_CODE, SETTINGS_DEFAULTS, PmCliError, activateExtensions, getActiveExtensionRegistrations, loadExtensions, pathExists, commandOptionFlagLabel, resolveCommandOptionPolicyState, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, getSettingsPath, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
 import { buildMcpToolContracts, } from "../../mcp/tool-definitions.js";
 import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_OUTPUT_DEGRADATION_STEPS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_DEPRECATED_TOOL_ACTIONS, PM_TOOL_ACTIONS, PM_TOOL_PARAMETERS_SCHEMA, REINDEX_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, compactFlagAliasContracts, PM_COMMAND_ALIAS_CONTRACTS, PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS, resolvePmCommandOutputBudget, } from "../cli-contracts.js";
@@ -12,7 +12,7 @@ import { PM_POSITIONAL_ACTION_FLAG_CONTRACTS } from "./flag-contracts.js";
 import { GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES, GOVERNANCE_CREATE_MODE_DEFAULT_VALUES, GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES, GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES, } from "../../types.js";
 import { BRIEF_LIST_FIELDS, DEFAULT_COMPACT_LIST_FIELDS, LIST_COMMAND_DEFAULT_PROJECTIONS, } from "../query/list.js";
 import { getActiveContextIntentContracts, } from "../context-intent-contracts.js";
-import { PM_READ_OUTPUT_SURFACE_CONTRACTS, } from "../read-output-contracts.js";
+import { readOutputIncludeModeOptions, resolveReadOutputSurface, PM_READ_OUTPUT_SURFACE_CONTRACTS, } from "../read-output-contracts.js";
 import { enrichCliFlagInvocationContracts, } from "../flag-invocation-contracts.js";
 import { resolvePmCommandVisibilityTier, } from "../agent-capability-contracts.js";
 import { PM_ERROR_CODE_CATALOG } from "../generated-error-code-catalog.js";
@@ -1954,6 +1954,22 @@ function attachAgentCommandContractsResult(result, outputCommands, extensionComm
         degradation_ladder: [...PM_OUTPUT_DEGRADATION_STEPS],
         allows_unbounded_opt_out: true,
     };
+    result.output_projection_contracts = {
+        global_ladder_field: "output_policy.degradation_ladder",
+        global_ladder_scope: "union_not_per_command",
+        discovery: "pm contracts --command <command> --summary",
+        ...(options.includeProjectionModeMatrix
+            ? {
+                commands: [...new Set(outputCommands.map(normalizeCommandPath))]
+                    .filter((command) => resolveReadOutputSurface(command) !== undefined)
+                    .sort((left, right) => left.localeCompare(right))
+                    .map((command) => ({
+                    command,
+                    modes: [...readOutputIncludeModeOptions(command).keys()],
+                })),
+            }
+            : {}),
+    };
     result.grammar_contracts = {
         nouns: PM_CLI_GRAMMAR_CONTRACT.nouns,
         shared_verbs: PM_CLI_GRAMMAR_CONTRACT.shared_verbs,
@@ -1989,6 +2005,7 @@ export async function runContracts(options, global) {
             includeFormatBudgets: includeCommandDetails,
             includeIntentProvenance: includeCommandDetails,
             includePositionalSignatures: includeCommandDetails,
+            includeProjectionModeMatrix: includeCommandDetails,
         });
     }
     if (selection.summary) {
@@ -2065,4 +2082,4 @@ export const _testOnlyContractsCommand = {
     toRuntimeShortFlagToken,
 };
 //# sourceMappingURL=runtime-contracts.js.map
-//# debugId=e8f1efca-4e83-570f-8c33-96f0405035b0
+//# debugId=428a19d2-be42-548a-a328-aa0e476b8a71

package/dist/sdk/compose.d.ts

@@ -31,6 +31,9 @@ import type { ProjectProfileRegistrationInput } from "../core/profile/profile-pr
 import type { PmMaxVersionExceededMode } from "../core/extensions/extension-types.js";
 import type { RelationshipKindDefinition } from "./relationships.js";
 import { type PmVersionBoundKind } from "../core/extensions/version-compat.js";
+import { inspectExtensionManifestSchema, lintExtensionManifestSchema, type ExtensionManifestSchemaFinding, type ExtensionManifestSchemaInspection, type ExtensionManifestSchemaLintResult } from "../core/extensions/manifest-schema.js";
+export { inspectExtensionManifestSchema, lintExtensionManifestSchema };
+export type { ExtensionManifestSchemaFinding, ExtensionManifestSchemaInspection, ExtensionManifestSchemaLintResult, };
 /**
  * Documents the extension module payload exchanged by command, SDK, and package integrations.
  *
@@ -489,7 +492,7 @@ export interface ExtensionManifestCompatibilityFinding {
 export interface ExtensionManifestCompatibilityResult {
     /** `true` when no `error`-severity finding blocks the load against the target version. */
     compatible: boolean;
-    /** Every bound finding, lower bound before upper bound; empty when both bounds are absent or satisfied. */
+    /** Every schema and bound finding in stable evaluation order. */
     findings: ExtensionManifestCompatibilityFinding[];
     /** The target pm version the manifest was checked against, echoed back for messaging. */
     pmVersion: string;

package/dist/sdk/compose.js

@@ -1,11 +1,12 @@
 
-!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]="bbc8dcd1-7dde-54f5-bebf-6d95ea0aaa1e")}catch(e){}}();
+!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]="23224ef3-9c86-5ae7-9ad8-0b3c687d4df7")}catch(e){}}();
 import { normalizeKnownExtensionCapability, resolveLegacyExtensionCapabilityAlias, } from "../core/extensions/extension-capability-aliases.js";
 import { normalizeCommandName } from "../core/extensions/extension-runtime-helpers.js";
 import { RESERVED_ITEM_FIELD_NAMES } from "../core/extensions/item-fields.js";
 import { describeExtensionLongFlagFailure, findExtensionFlagTokenFailure, } from "../core/extensions/flag-definition-validation.js";
 import { evaluatePmMaxVersionBound, evaluatePmMinVersionBound, } from "../core/extensions/version-compat.js";
-import { inspectExtensionManifestSchema } from "../core/extensions/manifest-schema.js";
+import { inspectExtensionManifestSchema, lintExtensionManifestSchema, } from "../core/extensions/manifest-schema.js";
+export { inspectExtensionManifestSchema, lintExtensionManifestSchema };
 /**
  * Typed identity helper for extension module exports.
  *
@@ -962,47 +963,33 @@ function toCompatibilityFinding(evaluation, pmVersion) {
 export function checkExtensionManifestCompatibility(manifest, target) {
     const minEvaluation = evaluatePmMinVersionBound(manifest.pm_min_version, target.pmVersion);
     const maxEvaluation = evaluatePmMaxVersionBound(manifest.pm_max_version, target.pmVersion, target.pmMaxVersionExceededMode ?? "block");
-    const findings = [];
-    const schema = inspectExtensionManifestSchema(manifest);
-    for (const key of schema.unknownKeys) {
-        findings.push({
-            code: "manifest_unknown_key",
-            severity: "warning",
-            constraint: "manifest",
-            required: key,
-            current: target.pmVersion,
-            path: key,
-            ...(key === "compatibility"
-                ? { suggested_key: "pm_min_version" }
-                : {}),
-            message: key === "compatibility"
-                ? 'Manifest key "compatibility" is ignored; declare the canonical pm_min_version and optional pm_max_version fields instead.'
-                : `Manifest key "${key}" is not part of the extension manifest contract and will be ignored.`,
-        });
-    }
-    if (schema.missingVersionBounds) {
-        findings.push({
-            code: "no_version_bounds_declared",
-            severity: "warning",
-            constraint: "manifest",
-            required: "pm_min_version",
-            current: target.pmVersion,
-            path: "$",
-            suggested_key: "pm_min_version",
-            message: "No canonical pm version bounds are declared; add pm_min_version so compatibility intent is explicit.",
-        });
-    }
+    const schema = lintExtensionManifestSchema(manifest);
+    const schemaFindings = schema.findings.map((finding) => ({
+        code: finding.code,
+        severity: "warning",
+        constraint: "manifest",
+        required: finding.code === "manifest_unknown_key"
+            ? finding.path
+            : "pm_min_version",
+        current: target.pmVersion,
+        path: finding.path,
+        ...(finding.suggested_key
+            ? { suggested_key: finding.suggested_key }
+            : {}),
+        message: finding.message,
+    }));
+    const compatibilityFindings = [];
     const minFinding = toCompatibilityFinding(minEvaluation, target.pmVersion);
     if (minFinding !== null) {
-        findings.push(minFinding);
+        compatibilityFindings.push(minFinding);
     }
     const maxFinding = toCompatibilityFinding(maxEvaluation, target.pmVersion);
     if (maxFinding !== null) {
-        findings.push(maxFinding);
+        compatibilityFindings.push(maxFinding);
     }
     return {
         compatible: minEvaluation.allowed && maxEvaluation.allowed,
-        findings,
+        findings: [...schemaFindings, ...compatibilityFindings],
         pmVersion: target.pmVersion,
     };
 }
@@ -1101,4 +1088,4 @@ export function preflightExtension(blueprint, options = {}) {
     };
 }
 //# sourceMappingURL=compose.js.map
-//# debugId=bbc8dcd1-7dde-54f5-bebf-6d95ea0aaa1e
+//# debugId=23224ef3-9c86-5ae7-9ad8-0b3c687d4df7

package/dist/sdk/extension/author-manifest.d.ts

@@ -0,0 +1,22 @@
+import { type ExtensionManifestSchemaFinding } from "../../core/extensions/manifest-schema.js";
+/** Read-only author-workspace manifest diagnostic shared by health and doctor. */
+export interface ExtensionAuthorManifestDiagnostic {
+    /** Absolute path inspected for the extension runtime manifest. */
+    path: string;
+    /** Whether the workspace declares a root extension manifest. */
+    present: boolean;
+    /** Parse state for absent, valid, or malformed manifest content. */
+    parse_status: "absent" | "valid" | "invalid_json" | "invalid_shape";
+    /** Canonical package catalog metadata location, distinct from manifest.json. */
+    package_metadata_location: "package.json#pm";
+    /** Public schema findings when the file is a JSON object. */
+    schema_findings: ExtensionManifestSchemaFinding[];
+    /** Runtime warning tokens incorporated into health/doctor status. */
+    warnings: string[];
+    /** Direct author correction for every reported state. */
+    remediation: string[];
+}
+/** Inspect `<workspace>/manifest.json` without loading extension code. */
+export declare function inspectExtensionAuthorManifest(workspaceRoot: string): Promise<ExtensionAuthorManifestDiagnostic>;
+/** Inspect the author manifest for a resolved project tracker root. */
+export declare function inspectExtensionAuthorManifestAtPmRoot(pmRoot: string): Promise<ExtensionAuthorManifestDiagnostic>;

package/dist/sdk/extension/author-manifest.js

@@ -0,0 +1,93 @@
+/**
+ * @module sdk/extension/author-manifest
+ *
+ * Reads the optional extension manifest at a package-author workspace root and
+ * projects the public schema lint into health/doctor diagnostics.
+ */
+
+!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]="5755dee7-d2df-5ced-8a94-aeb51762edb7")}catch(e){}}();
+import fs from "node:fs/promises";
+import path from "node:path";
+import { isFileAbsentError } from "../../core/fs/fs-utils.js";
+import { lintExtensionManifestSchema, } from "../../core/extensions/manifest-schema.js";
+import { resolveWorkspaceRoot } from "../../core/store/paths.js";
+function manifestName(raw) {
+    return typeof raw.name === "string" && raw.name.trim().length > 0
+        ? raw.name.trim()
+        : "workspace-manifest";
+}
+function authorManifestWarning(name, finding) {
+    return finding.code === "manifest_unknown_key"
+        ? `extension_manifest_unknown_key:author:${name}:key=${finding.path}${finding.suggested_key ? `:suggested=${finding.suggested_key}` : ""}`
+        : `extension_manifest_no_version_bounds:author:${name}:suggested=pm_min_version`;
+}
+/** Inspect `<workspace>/manifest.json` without loading extension code. */
+export async function inspectExtensionAuthorManifest(workspaceRoot) {
+    const manifestPath = path.join(workspaceRoot, "manifest.json");
+    let content;
+    try {
+        content = await fs.readFile(manifestPath, "utf8");
+    }
+    catch (error) {
+        if (isFileAbsentError(error)) {
+            return {
+                path: manifestPath,
+                present: false,
+                parse_status: "absent",
+                package_metadata_location: "package.json#pm",
+                schema_findings: [],
+                warnings: [],
+                remediation: [],
+            };
+        }
+        throw error;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        return {
+            path: manifestPath,
+            present: true,
+            parse_status: "invalid_json",
+            package_metadata_location: "package.json#pm",
+            schema_findings: [],
+            warnings: ["extension_author_manifest_invalid_json:manifest.json"],
+            remediation: [
+                "Repair manifest.json so it contains one valid JSON object, then rerun pm package doctor --project.",
+            ],
+        };
+    }
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+        return {
+            path: manifestPath,
+            present: true,
+            parse_status: "invalid_shape",
+            package_metadata_location: "package.json#pm",
+            schema_findings: [],
+            warnings: ["extension_author_manifest_invalid_shape:manifest.json"],
+            remediation: [
+                "Replace manifest.json with one JSON object, then rerun pm package doctor --project.",
+            ],
+        };
+    }
+    const raw = parsed;
+    const lint = lintExtensionManifestSchema(raw);
+    const name = manifestName(raw);
+    return {
+        path: manifestPath,
+        present: true,
+        parse_status: "valid",
+        package_metadata_location: "package.json#pm",
+        schema_findings: lint.findings,
+        warnings: lint.findings.map((finding) => authorManifestWarning(name, finding)),
+        remediation: lint.findings.map((finding) => finding.message),
+    };
+}
+/** Inspect the author manifest for a resolved project tracker root. */
+export function inspectExtensionAuthorManifestAtPmRoot(pmRoot) {
+    return inspectExtensionAuthorManifest(resolveWorkspaceRoot(pmRoot));
+}
+//# sourceMappingURL=author-manifest.js.map
+//# debugId=5755dee7-d2df-5ced-8a94-aeb51762edb7

package/dist/sdk/extension.js

@@ -4,7 +4,7 @@
  * Implements the pm extension command surface and its agent-facing runtime behavior.
  */
 
-!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]="8b0fbe09-2221-5b8e-8712-90a83df19306")}catch(e){}}();
+!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]="8d5ed026-8d61-5083-956c-9281caa0168b")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { activateExtensions, createSerialQueue, loadExtensions, nextExtensionReloadToken, } from "../core/extensions/index.js";
@@ -41,6 +41,7 @@ import { collectGlobalOutputOverrideDoctorWarnings } from "./extension/output-ow
 import { collectMcpCustomFieldCollisionDoctorWarnings } from "./extension/custom-field-collisions.js";
 import { checkGithubUpdate } from "./extension/update-check.js";
 import { runExtensionMigrateAction } from "./extension/migrations.js";
+import { inspectExtensionAuthorManifestAtPmRoot } from "./extension/author-manifest.js";
 import { resolveExtensionInstallSourceIdentity, } from "./extension/source-resolution.js";
 import { captureExtensionInstallSnapshot, readOptionalMetadataFile, restoreExtensionInstallSnapshot, } from "./extension/install-snapshot.js";
 // Re-export the public surface that lives in sibling modules but was previously
@@ -1773,7 +1774,8 @@ const runExtensionDoctorAction = async (ctx) => {
         ...loadResult,
         loaded: loadResult.loaded,
     });
-    warnings.push(...loadResult.warnings);
+    const authorManifest = await inspectExtensionAuthorManifestAtPmRoot(resolvedRoots.pm_root);
+    warnings.push(...authorManifest.warnings, ...loadResult.warnings);
     warnings.push(...classifyDoctorLoadFailureWarnings(loadResult.failed));
     warnings.push(...activationResult.warnings);
     warnings.push(...classifyDoctorActivationFailureWarnings(activationResult.failed));
@@ -1885,6 +1887,7 @@ const runExtensionDoctorAction = async (ctx) => {
         capability_contract: capabilityContract,
         capability_guidance: capabilityGuidance,
         managed_state_fix: managedStateFixSummary,
+        author_manifest: authorManifest,
         isolation,
         policy: loadResult.policy,
     };
@@ -2191,4 +2194,4 @@ export const _testOnly = {
     withExtensionInstallLock,
 };
 //# sourceMappingURL=extension.js.map
-//# debugId=8b0fbe09-2221-5b8e-8712-90a83df19306
+//# debugId=8d5ed026-8d61-5083-956c-9281caa0168b

package/dist/sdk/generated/generated-error-code-catalog-part-1.js

@@ -1,6 +1,6 @@
 /** Generated partition 1 of the exhaustive error-code catalog. */
 
-!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]="030027d7-2703-56ea-9235-64bc602a25c3")}catch(e){}}();
+!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]="c51fce27-5acd-513d-83c4-5fd75bd999f9")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_1 = [
     {
         code: "acceptance_criteria_mutation_conflict",
@@ -1163,6 +1163,18 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "history_drift_hash_mismatch",
         aliases: ["validate_history_drift_hash_mismatches"],
     },
+    {
+        code: "history_drift_merge_receipt",
+        meaning: "History drift merge receipt condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "history_drift_merge_receipt",
+        aliases: [],
+    },
     {
         code: "history_drift_missing_stream",
         meaning: "History drift missing stream condition.",
@@ -1933,13 +1945,16 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         code: "manifest_unknown_key",
         meaning: "Manifest unknown key condition.",
         stability: "provisional",
-        exit_code: 2,
-        class: "usage",
+        exit_code: 1,
+        class: "generic_failure",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["sdk/compose.ts"],
+        sources: ["core/extensions/manifest-schema.ts"],
         emitting_commands: ["*"],
         canonical_code: "manifest_unknown_key",
         aliases: [],
+        owned_states: [
+            { state: "author_workspace_manifest_declares_an_unknown_top_level_key", probe_id: "author-manifest-unknown-key", entrypoints: ["health"], expected_exit_class: "generic_failure" },
+        ],
     },
     {
         code: "mcp_annotation_file_unavailable",
@@ -1965,6 +1980,18 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "mcp_stdin_unavailable",
         aliases: [],
     },
+    {
+        code: "mcp_task_not_found_or_not_authorized",
+        meaning: "Mcp task not found or not authorized condition.",
+        stability: "provisional",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/mcp/tasks.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "mcp_task_not_found_or_not_authorized",
+        aliases: [],
+    },
     {
         code: "merge_conflict_markers_detected",
         meaning: "Merge conflict markers detected condition.",
@@ -2002,53 +2029,65 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         aliases: [],
     },
     {
-        code: "merge_reconcile_discards_require_acceptance",
-        meaning: "Merge reconcile discards require acceptance condition.",
+        code: "merge_receipt_evidence_invalid",
+        meaning: "Merge receipt evidence invalid condition.",
         stability: "provisional",
         exit_code: 4,
         class: "conflict",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["sdk/merge/reconcile.ts"],
+        sources: ["core/diagnostics/remediation.ts", "sdk/merge/reconcile.ts"],
         emitting_commands: ["*"],
-        canonical_code: "merge_reconcile_discards_require_acceptance",
+        canonical_code: "merge_receipt_evidence_invalid",
         aliases: [],
     },
     {
-        code: "merge_root_not_found",
-        meaning: "Merge root not found condition.",
-        stability: "stable",
-        exit_code: 3,
-        class: "not_found",
+        code: "merge_receipts_pending",
+        meaning: "Merge receipts pending condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["sdk/merge/install.ts"],
+        sources: ["core/diagnostics/remediation.ts"],
         emitting_commands: ["*"],
-        canonical_code: "merge_root_not_found",
+        canonical_code: "merge_receipts_pending",
         aliases: [],
     },
     {
-        code: "missing_allowed_values",
-        meaning: "Missing allowed values condition.",
+        code: "merge_reconcile_discards_require_acceptance",
+        meaning: "Merge reconcile discards require acceptance condition.",
         stability: "provisional",
-        exit_code: 1,
-        class: "generic_failure",
+        exit_code: 4,
+        class: "conflict",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["sdk/agent/refusal-closure.ts"],
+        sources: ["sdk/merge/reconcile.ts"],
         emitting_commands: ["*"],
-        canonical_code: "missing_allowed_values",
+        canonical_code: "merge_reconcile_discards_require_acceptance",
         aliases: [],
     },
     {
-        code: "missing_budget",
-        meaning: "Missing budget condition.",
+        code: "merge_reconcile_receipt_evidence_untrusted",
+        meaning: "Merge reconcile receipt evidence untrusted condition.",
         stability: "provisional",
-        exit_code: 1,
-        class: "generic_failure",
+        exit_code: 4,
+        class: "conflict",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["sdk/cli-contracts/flag-lexicon-contracts.ts"],
+        sources: ["sdk/history-repair.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "merge_reconcile_receipt_evidence_untrusted",
+        aliases: [],
+    },
+    {
+        code: "merge_root_not_found",
+        meaning: "Merge root not found condition.",
+        stability: "stable",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/merge/install.ts"],
         emitting_commands: ["*"],
-        canonical_code: "missing_budget",
+        canonical_code: "merge_root_not_found",
         aliases: [],
     },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-1.js.map
-//# debugId=030027d7-2703-56ea-9235-64bc602a25c3
+//# debugId=c51fce27-5acd-513d-83c4-5fd75bd999f9

package/dist/sdk/generated/generated-error-code-catalog-part-2.js

@@ -1,7 +1,31 @@
 /** Generated partition 2 of the exhaustive error-code catalog. */
 
-!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]="8724f8ed-1236-5779-9e97-dc4b35866839")}catch(e){}}();
+!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]="347933e7-190b-5679-9379-f25f63d0351a")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_2 = [
+    {
+        code: "missing_allowed_values",
+        meaning: "Missing allowed values condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/agent/refusal-closure.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "missing_allowed_values",
+        aliases: [],
+    },
+    {
+        code: "missing_budget",
+        meaning: "Missing budget condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/cli-contracts/flag-lexicon-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "missing_budget",
+        aliases: [],
+    },
     {
         code: "missing_cli_flag",
         meaning: "Missing cli flag condition.",
@@ -287,10 +311,13 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
         exit_code: 1,
         class: "generic_failure",
         recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["sdk/compose.ts"],
+        sources: ["core/extensions/manifest-schema.ts"],
         emitting_commands: ["*"],
         canonical_code: "no_version_bounds_declared",
         aliases: [],
+        owned_states: [
+            { state: "author_workspace_manifest_omits_canonical_pm_version_bounds", probe_id: "author-manifest-version-bounds-missing", entrypoints: ["health"], expected_exit_class: "generic_failure" },
+        ],
     },
     {
         code: "non_refusal_exit",
@@ -2075,4 +2102,4 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
     },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-2.js.map
-//# debugId=8724f8ed-1236-5779-9e97-dc4b35866839
+//# debugId=347933e7-190b-5679-9379-f25f63d0351a