perttool 0.11.1 → 0.12.1

package/dist/command/contract11-discovery.d.ts

@@ -0,0 +1,17 @@
+import type { CommandHelpQuery } from "./discovery.js";
+import { type Contract10CommandDescriptor, type Contract10CommandHelpResult } from "./contract10-discovery.js";
+export type Contract11CommandDescriptor = Omit<Contract10CommandDescriptor, "contractVersion"> & {
+    readonly contractVersion: 11;
+};
+export type Contract11CommandHelpResult = Omit<Contract10CommandHelpResult, "cliContractVersion" | "commands"> & {
+    readonly cliContractVersion: 11;
+    readonly commands: readonly Contract11CommandDescriptor[];
+};
+export declare const CONTRACT11_COMMAND_REGISTRY: readonly Contract11CommandDescriptor[];
+export declare function getContract11CommandDiscovery(query: CommandHelpQuery): Contract11CommandHelpResult;
+export declare function contract11CommandHelpResultToJson(value: Contract11CommandHelpResult): Readonly<Record<string, unknown>>;
+export declare function contract11CommandDescriptorToJson(value: Contract11CommandDescriptor): Readonly<Record<string, unknown>>;
+export declare function contract11CommandRegistryToJson(): readonly Readonly<Record<string, unknown>>[];
+export declare function serializeContract11CommandHelpResult(value: Contract11CommandHelpResult): string;
+export declare function renderContract11CommandHelpResult(value: Contract11CommandHelpResult): string;
+//# sourceMappingURL=contract11-discovery.d.ts.map

package/dist/command/contract11-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract11-discovery.d.ts","sourceRoot":"","sources":["../../src/command/contract11-discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAA0B,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAML,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EACjC,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAAC,2BAA2B,EAAE,iBAAiB,CAAC,GAAG;IAC/F,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC;CAC9B,CAAC;AACF,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAAC,2BAA2B,EAAE,oBAAoB,GAAG,UAAU,CAAC,GAAG;IAC/G,QAAQ,CAAC,kBAAkB,EAAE,EAAE,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,2BAA2B,EAAE,CAAC;CAC3D,CAAC;AA2DF,eAAO,MAAM,2BAA2B,EAAE,SAAS,2BAA2B,EA0B5E,CAAC;AAoBH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,gBAAgB,GAAG,2BAA2B,CAiBlG;AACD,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,2BAA2B,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEvH;AACD,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,2BAA2B,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEvH;AACD,wBAAgB,+BAA+B,IAAI,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAE9F;AACD,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAE/F;AACD,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAE5F"}

package/dist/command/contract11-discovery.js

@@ -0,0 +1,129 @@
+import { TOOL_VERSION } from "../version.js";
+import { CONTRACT10_COMMAND_REGISTRY, getContract10CommandDiscovery, contract10CommandDescriptorToJson, contract10CommandHelpResultToJson, renderContract10CommandHelpResult, } from "./contract10-discovery.js";
+const createTemplate = CONTRACT10_COMMAND_REGISTRY.find(({ operation }) => operation === "task.add");
+const readTemplate = CONTRACT10_COMMAND_REGISTRY.find(({ operation }) => operation === "project.show");
+if (createTemplate === undefined || readTemplate === undefined)
+    throw new Error("Contract 11 templates are unavailable");
+const mutationCommandTemplate = createTemplate;
+const readCommandTemplate = readTemplate;
+function option(name, valueType, required = false, repeatable = false, enumValues = []) {
+    return Object.freeze({
+        name, kind: "value", valueType, required, repeatable, defaultValue: null,
+        enumValues: Object.freeze([...enumValues]), conflicts: Object.freeze([]), requires: Object.freeze([]),
+        sharedGroup: null, description: null,
+        spelling: Object.freeze({ cli: `--${name}`, dsl: null, json: name.replaceAll("-", "_") }),
+    });
+}
+function flag(name) {
+    return Object.freeze({ ...option(name, "boolean"), kind: "flag", valueType: null, defaultValue: false });
+}
+const format = option("format", "output-format", false, false, ["text", "json"]);
+const mutationOptions = Object.freeze([
+    flag("preview"), flag("diff"),
+    Object.freeze({ ...option("output", "path"), conflicts: Object.freeze(["in-place"]) }),
+    Object.freeze({ ...flag("in-place"), conflicts: Object.freeze(["output"]) }),
+    option("expected-digest", "sha256-digest"), format,
+]);
+function operand(name, position, valueType) {
+    return Object.freeze({ name, position, valueType, required: true });
+}
+function reviewCommand(action, summary, options, example) {
+    const read = action === "review-list" || action === "review-show";
+    const template = read ? readCommandTemplate : mutationCommandTemplate;
+    return Object.freeze({
+        ...template,
+        contractVersion: 11,
+        path: Object.freeze(["plan", action]),
+        operation: `plan.${action}`,
+        summary,
+        operands: Object.freeze([
+            operand("document", 0, "path-or-stdin"),
+            ...(action === "review-list" ? [] : [operand("request-id", 1, "identifier")]),
+            ...(action === "review-request" ? [operand("task-id", 2, "identifier")] : []),
+        ]),
+        options: Object.freeze(options),
+        input: "document",
+        output: Object.freeze({ formats: Object.freeze(["text", "json"]), payload: read ? "result" : "candidate-document", fileEffect: read ? "none" : "optional-write-or-create" }),
+        stdin: Object.freeze({ document: true, artifact: false, request: action === "review-resolve", mutuallyExclusive: action === "review-resolve" }),
+        effect: read ? "read" : "write-or-create",
+        resultSchemas: Object.freeze([read ? "Perttool.PlanReviewResult.v1" : "Perttool.PlanReviewMutationResult.v1", "Perttool.CliError.v1"]),
+        examples: Object.freeze([Object.freeze({ id: `plan.${action}`, invocation: example, summary })]),
+    });
+}
+export const CONTRACT11_COMMAND_REGISTRY = Object.freeze([
+    ...CONTRACT10_COMMAND_REGISTRY.map((descriptor) => Object.freeze({
+        ...descriptor, contractVersion: 11,
+        resultSchemas: Object.freeze(descriptor.resultSchemas.map((schema) => schema === "Perttool.NextResult.v8"
+            ? "Perttool.NextResult.v9" : schema)),
+        ...(descriptor.operation === "document.migrate" ? {
+            summary: "Prepares a complete document for Grammar 7, Grammar 8, Grammar 9, or Grammar 10.",
+            options: Object.freeze(descriptor.options.map((entry) => entry.name === "target-grammar"
+                ? Object.freeze({ ...entry, enumValues: Object.freeze(["7", "8", "9", "10"]) }) : entry)),
+        } : {}),
+    })),
+    reviewCommand("review-request", "Creates one task-bound Plan Review Request as a preview by default.", [
+        option("reason", "text", true), option("created-at", "date-time", true), option("actor", "principal", true),
+        option("locator", "text"), ...mutationOptions,
+    ], "perttool plan review-request plan.pert REVIEW_1 TASK_1 --reason 'Recheck task scope' --created-at 2026-09-29T09:00:00+09:00 --actor alice"),
+    reviewCommand("review-list", "Lists Plan Review Requests in declaration order.", [
+        option("state", "review-state", false, false, ["open", "resolved", "all"]), format,
+    ], "perttool plan review-list plan.pert --state open"),
+    reviewCommand("review-show", "Shows one Plan Review Request.", [format], "perttool plan review-show plan.pert REVIEW_1"),
+    reviewCommand("review-resolve", "Resolves one Plan Review Request with one complete candidate.", [
+        option("outcome", "review-outcome", true, false, ["plan_retained", "plan_changed"]),
+        option("resolved-at", "date-time", true), option("actor", "principal", true),
+        option("resolution-reason", "text", true), option("accepted-owner", "principal", false, true),
+        option("request", "json-path-or-stdin"), ...mutationOptions,
+    ], "perttool plan review-resolve plan.pert REVIEW_1 --outcome plan_retained --resolved-at 2026-09-29T10:00:00+09:00 --actor alice --resolution-reason 'Current plan retained'"),
+]);
+const contract10Resources = getContract10CommandDiscovery({ resource: null, action: null }).resources;
+const resources = Object.freeze([...new Set(CONTRACT11_COMMAND_REGISTRY
+        .filter(({ path }) => path.length >= 2).map(({ path }) => path[0]))].sort().map((name) => Object.freeze({
+    name,
+    summary: name === "plan" ? "Creates, inspects, and resolves task-bound Plan Review Requests."
+        : contract10Resources.find((resource) => resource.name === name)?.summary ?? `${name} commands.`,
+    actions: Object.freeze(CONTRACT11_COMMAND_REGISTRY.filter(({ path }) => path.length >= 2 && path[0] === name)
+        .map(({ path }) => path.slice(1).join(" ")).sort()),
+})));
+const byPath = new Map(CONTRACT11_COMMAND_REGISTRY.map((descriptor) => [descriptor.path.join("\0"), descriptor]));
+function diagnostic(code, message, query) {
+    return Object.freeze({ code, severity: "error", message, data: Object.freeze({ resource: query.resource, action: query.action }) });
+}
+function result(query, selectedResources, commands, diagnostics) {
+    return Object.freeze({ schemaVersion: "Perttool.CommandHelpResult.v1", cliContractVersion: 11, toolVersion: TOOL_VERSION,
+        operation: "help", ok: diagnostics.length === 0, query: Object.freeze({ ...query }),
+        resources: Object.freeze([...selectedResources]), commands: Object.freeze([...commands]), diagnostics: Object.freeze([...diagnostics]) });
+}
+export function getContract11CommandDiscovery(query) {
+    if (query.resource === null && query.action === null) {
+        return result(query, resources, CONTRACT11_COMMAND_REGISTRY, []);
+    }
+    if (query.resource === "plan") {
+        const planResource = resources.find(({ name }) => name === "plan");
+        if (query.action === null) {
+            return result(query, [planResource], CONTRACT11_COMMAND_REGISTRY.filter(({ path }) => path[0] === "plan"), []);
+        }
+        const command = byPath.get(`plan\0${query.action.replaceAll(" ", "\0")}`);
+        return command === undefined
+            ? result(query, [], [], [diagnostic("PTHLP-003", `unknown action ${query.action} for command resource plan`, query)])
+            : result(query, [planResource], [command], []);
+    }
+    const legacy = getContract10CommandDiscovery(query);
+    return result(query, legacy.resources, legacy.commands.map((descriptor) => byPath.get(descriptor.path.join("\0"))), legacy.diagnostics);
+}
+export function contract11CommandHelpResultToJson(value) {
+    return contract10CommandHelpResultToJson(value);
+}
+export function contract11CommandDescriptorToJson(value) {
+    return contract10CommandDescriptorToJson(value);
+}
+export function contract11CommandRegistryToJson() {
+    return CONTRACT11_COMMAND_REGISTRY.map(contract11CommandDescriptorToJson);
+}
+export function serializeContract11CommandHelpResult(value) {
+    return `${JSON.stringify(contract11CommandHelpResultToJson(value), null, 2)}\n`;
+}
+export function renderContract11CommandHelpResult(value) {
+    return renderContract10CommandHelpResult(value).replaceAll("CLI Contract 10", "CLI Contract 11");
+}
+//# sourceMappingURL=contract11-discovery.js.map

package/dist/command/contract11-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract11-discovery.js","sourceRoot":"","sources":["../../src/command/contract11-discovery.ts"],"names":[],"mappings":"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"}

package/dist/command/contract11-usage.d.ts

@@ -0,0 +1,24 @@
+import type { CommandOptionOccurrence, CommandUsageError } from "./usage.js";
+import { renderCommandUsageError } from "./usage.js";
+import { type Contract11CommandDescriptor } from "./contract11-discovery.js";
+export type Contract11CommandInvocationValidation = {
+    readonly ok: true;
+    readonly descriptor: Contract11CommandDescriptor;
+    readonly helpAlias: boolean;
+    readonly operands: readonly string[];
+    readonly options: readonly CommandOptionOccurrence[];
+} | {
+    readonly ok: false;
+    readonly error: CommandUsageError;
+};
+export type Contract11ValidCommandInvocation = Extract<Contract11CommandInvocationValidation, {
+    readonly ok: true;
+}>;
+export type Contract11InvalidCommandInvocation = Extract<Contract11CommandInvocationValidation, {
+    readonly ok: false;
+}>;
+export declare function validateContract11CommandInvocation(argv: readonly string[]): Contract11CommandInvocationValidation;
+export declare function serializeContract11CommandUsageError(error: CommandUsageError): string;
+export declare function contract11CommandUsageErrorToJson(error: CommandUsageError): Readonly<Record<string, unknown>>;
+export { renderCommandUsageError as renderContract11CommandUsageError };
+//# sourceMappingURL=contract11-usage.d.ts.map

package/dist/command/contract11-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract11-usage.d.ts","sourceRoot":"","sources":["../../src/command/contract11-usage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAsC,uBAAuB,EAA4C,MAAM,YAAY,CAAC;AACnI,OAAO,EAA+B,KAAK,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAG1G,MAAM,MAAM,qCAAqC,GAC7C;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,2BAA2B,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAA;CAAE,GAChM;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAC9D,MAAM,MAAM,gCAAgC,GAAG,OAAO,CAAC,qCAAqC,EAAE;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC;AACrH,MAAM,MAAM,kCAAkC,GAAG,OAAO,CAAC,qCAAqC,EAAE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC;AASxH,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,qCAAqC,CAiBlH;AACD,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAErF;AACD,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAE7G;AACD,OAAO,EAAE,uBAAuB,IAAI,iCAAiC,EAAE,CAAC"}

package/dist/command/contract11-usage.js

@@ -0,0 +1,39 @@
+import { commandUsageErrorToJsonForContract, renderCommandUsageError, validateCommandInvocationAgainstRegistry } from "./usage.js";
+import { CONTRACT11_COMMAND_REGISTRY } from "./contract11-discovery.js";
+import { validateContract10CommandInvocation } from "./contract10-usage.js";
+const genericOperations = new Set(["document.migrate", "plan.review-request", "plan.review-list", "plan.review-show", "plan.review-resolve"]);
+function conditionalError(message, token, action) {
+    return Object.freeze({ ok: false, error: Object.freeze({
+            code: "PTCLI-001", kind: "option_conflict", message, operation: `plan.${action}`,
+            token, helpTarget: Object.freeze({ resource: "plan", action }), suggestion: null,
+        }) });
+}
+export function validateContract11CommandInvocation(argv) {
+    const generic = validateCommandInvocationAgainstRegistry(argv, CONTRACT11_COMMAND_REGISTRY);
+    if (!generic.ok)
+        return generic;
+    if (generic.descriptor.operation === "plan.review-resolve") {
+        const outcome = generic.options.find(({ name }) => name === "outcome")?.value;
+        const request = generic.options.find(({ name }) => name === "request");
+        if (outcome === "plan_changed" && request === undefined) {
+            return conditionalError("plan_changed requires --request", "--request", "review-resolve");
+        }
+        if (outcome === "plan_retained" && request !== undefined) {
+            return conditionalError("plan_retained forbids --request", "--request", "review-resolve");
+        }
+    }
+    if (genericOperations.has(generic.descriptor.operation))
+        return generic;
+    const legacy = validateContract10CommandInvocation(argv);
+    if (!legacy.ok)
+        return legacy;
+    return Object.freeze({ ...legacy, descriptor: generic.descriptor });
+}
+export function serializeContract11CommandUsageError(error) {
+    return `${JSON.stringify(commandUsageErrorToJsonForContract(error, 11), null, 2)}\n`;
+}
+export function contract11CommandUsageErrorToJson(error) {
+    return commandUsageErrorToJsonForContract(error, 11);
+}
+export { renderCommandUsageError as renderContract11CommandUsageError };
+//# sourceMappingURL=contract11-usage.js.map

package/dist/command/contract11-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract11-usage.js","sourceRoot":"","sources":["../../src/command/contract11-usage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kCAAkC,EAAE,uBAAuB,EAAE,wCAAwC,EAAE,MAAM,YAAY,CAAC;AACnI,OAAO,EAAE,2BAA2B,EAAoC,MAAM,2BAA2B,CAAC;AAC1G,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAQ5E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,kBAAkB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAC9I,SAAS,gBAAgB,CAAC,OAAe,EAAE,KAAa,EAAE,MAAc;IACtE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACrD,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,MAAM,EAAE;YAChF,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI;SACjF,CAAC,EAAE,CAAC,CAAC;AACR,CAAC;AACD,MAAM,UAAU,mCAAmC,CAAC,IAAuB;IACzE,MAAM,OAAO,GAAG,wCAAwC,CAAC,IAAI,EAAE,2BAAoC,CAA0C,CAAC;IAC9I,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC;IAChC,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,KAAK,qBAAqB,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,KAAK,CAAC;QAC9E,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QACvE,IAAI,OAAO,KAAK,cAAc,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACxD,OAAO,gBAAgB,CAAC,iCAAiC,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,OAAO,KAAK,eAAe,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACzD,OAAO,gBAAgB,CAAC,iCAAiC,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IACD,IAAI,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,OAAO,CAAC;IACxE,MAAM,MAAM,GAAG,mCAAmC,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAA+C,CAAC;IACvE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAA0C,CAAC;AAC/G,CAAC;AACD,MAAM,UAAU,oCAAoC,CAAC,KAAwB;IAC3E,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,kCAAkC,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACvF,CAAC;AACD,MAAM,UAAU,iCAAiC,CAAC,KAAwB;IACxE,OAAO,kCAAkC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AACvD,CAAC;AACD,OAAO,EAAE,uBAAuB,IAAI,iCAAiC,EAAE,CAAC"}

package/dist/core/index.d.ts

@@ -3,7 +3,7 @@ export { buildResidualGraph, computeEffectiveReached } from "../analysis/graph.j
 export { analyzePrecedence } from "../analysis/precedence.js";
 export { analyzeResources } from "../analysis/resource.js";
 export { getHelp } from "../help/registry.js";
-export { contract10GuideResultToJson as guideResultToJson, getContract10Guide as getGuide, renderContract10GuideResult as renderGuideResult, serializeContract10GuideResult as serializeGuideResult, } from "../help/contract10-guide.js";
+export { contract11GuideResultToJson as guideResultToJson, getContract11Guide as getGuide, renderContract11GuideResult as renderGuideResult, serializeContract11GuideResult as serializeGuideResult, } from "../help/contract11-guide.js";
 export { auditPlanningWindowMutationCore, inspectPlanningPool, observePlanningPoolSnapshot, preflightPlanningPoolReshape, preparePlanningPoolReshapeCoreApply, } from "../planning-pool/public-core.js";
 export { PlanningReshapeTokenRegistry } from "../planning-pool/reshape-token.js";
 export { recommendationAnalysisToJson } from "../recommendation/json.js";
@@ -21,7 +21,7 @@ export type { ParseOptions } from "../parser/document-parser.js";
 export type { FormatOptions, FormatResult, } from "../formatter/source-formatter.js";
 export type { TextEdit } from "../mutation/text-edits.js";
 export type { HelpExample, HelpLevel, HelpNode, HelpResult, HelpSection, } from "../help/registry.js";
-export type { Contract10GuideResult as GuideResult, } from "../help/contract10-guide.js";
+export type { Contract11GuideResult as GuideResult, } from "../help/contract11-guide.js";
 export type { PlanningPoolReadOperation, PlanningPoolReadQuery, PlanningPoolReadResult, } from "../planning-pool/public-core.js";
 export type { PlanningObservationRequest, PlanningPoolObservationResult, } from "../planning-pool/observation-types.js";
 export type { PlanningPoolHistoricalObservationResult, } from "../planning-pool/history-types.js";

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"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"}

package/dist/core/index.js

@@ -1,9 +1,10 @@
+// R: Expose the platform-neutral Core runtime and guidance surface.
 export { formatDocument, parseDocument, validateDocument, } from "./source.js";
 export { buildResidualGraph, computeEffectiveReached } from "../analysis/graph.js";
 export { analyzePrecedence } from "../analysis/precedence.js";
 export { analyzeResources } from "../analysis/resource.js";
 export { getHelp } from "../help/registry.js";
-export { contract10GuideResultToJson as guideResultToJson, getContract10Guide as getGuide, renderContract10GuideResult as renderGuideResult, serializeContract10GuideResult as serializeGuideResult, } from "../help/contract10-guide.js";
+export { contract11GuideResultToJson as guideResultToJson, getContract11Guide as getGuide, renderContract11GuideResult as renderGuideResult, serializeContract11GuideResult as serializeGuideResult, } from "../help/contract11-guide.js";
 export { auditPlanningWindowMutationCore, inspectPlanningPool, observePlanningPoolSnapshot, preflightPlanningPoolReshape, preparePlanningPoolReshapeCoreApply, } from "../planning-pool/public-core.js";
 export { PlanningReshapeTokenRegistry } from "../planning-pool/reshape-token.js";
 export { recommendationAnalysisToJson } from "../recommendation/json.js";

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EACL,2BAA2B,IAAI,iBAAiB,EAChD,kBAAkB,IAAI,QAAQ,EAC9B,2BAA2B,IAAI,iBAAiB,EAChD,8BAA8B,IAAI,oBAAoB,GACvD,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,+BAA+B,EAC/B,mBAAmB,EACnB,2BAA2B,EAC3B,4BAA4B,EAC5B,mCAAmC,GACpC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,OAAO,EACL,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EACL,2BAA2B,IAAI,iBAAiB,EAChD,kBAAkB,IAAI,QAAQ,EAC9B,2BAA2B,IAAI,iBAAiB,EAChD,8BAA8B,IAAI,oBAAoB,GACvD,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,+BAA+B,EAC/B,mBAAmB,EACnB,2BAA2B,EAC3B,4BAA4B,EAC5B,mCAAmC,GACpC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACjF,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,gCAAgC,CAAC"}

package/dist/help/contract11-guide.d.ts

@@ -0,0 +1,10 @@
+import { type Contract10GuideResult } from "./contract10-guide.js";
+import type { HelpLevel } from "./registry.js";
+export interface Contract11GuideResult extends Omit<Contract10GuideResult, "cliContractVersion"> {
+    readonly cliContractVersion: 11;
+}
+export declare function getContract11Guide(topicId: string | null, level: HelpLevel): Contract11GuideResult;
+export declare function contract11GuideResultToJson(value: Contract11GuideResult): Readonly<Record<string, unknown>>;
+export declare function serializeContract11GuideResult(value: Contract11GuideResult): string;
+export declare function renderContract11GuideResult(value: Contract11GuideResult): string;
+//# sourceMappingURL=contract11-guide.d.ts.map

package/dist/help/contract11-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract11-guide.d.ts","sourceRoot":"","sources":["../../src/help/contract11-guide.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,qBAAqB,EAAE,oBAAoB,CAAC;IAC9F,QAAQ,CAAC,kBAAkB,EAAE,EAAE,CAAC;CACjC;AAkCD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,qBAAqB,CAwBlG;AACD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAE3G;AACD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAEnF;AACD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAEhF"}

package/dist/help/contract11-guide.js

@@ -0,0 +1,73 @@
+// R: Explain the active Contract 11 Plan Review workflow and its authority boundaries.
+import { TOOL_VERSION } from "../version.js";
+import { getContract10Guide } from "./contract10-guide.js";
+import { guideResultToJson, renderGuideResult } from "./guide.js";
+const topic = Object.freeze({
+    id: "plan-review", title: "Plan Review Requests",
+    summary: "Record a bounded task-linked review, advise review before new downstream work, and resolve by retaining or changing the plan.",
+});
+const sections = Object.freeze([
+    Object.freeze({ id: "continuation", title: "Active work and local safety", body: "An open Plan Review Request strongly advises review before new downstream work. It does not change readiness, recommendation, or start authority. Already active work may continue, and a bounded local safety action may protect current work without claiming that the review is resolved." }),
+    Object.freeze({ id: "review", title: "Review before a decision", body: "Create a task-bound request with an explicit reason, actor, and time. Inspect open requests and their Plan Review basis. A request records the need for review; it does not itself change the task plan, certify the plan, or accept an outcome." }),
+    Object.freeze({ id: "resolution", title: "Retain or change the plan", body: "Resolve with plan_retained when the reviewed plan stands. Resolve with plan_changed only with one closed Contract 11 batch request containing the actual plan change. The tool composes and validates one final candidate; the resolution and change are one atomic write. The recorded request digest identifies the normalized request, not its correctness." }),
+    Object.freeze({ id: "other-authority", title: "Independent authorities", body: "Plan Review, conditional Plan Assurance, Milestone Outcome Acceptance, and mutation authority answer different questions. Resolving a request does not reseal a plan, accept a milestone outcome, or supply governance delegates. A plan change must pass its own assurance, acceptance, governance, history, and persistence gates." }),
+]);
+const syntax = Object.freeze([
+    "perttool plan review-request DOCUMENT REQUEST_ID TASK_ID --reason TEXT --created-at DATE_TIME --actor PRINCIPAL [--locator TEXT]",
+    "perttool plan review-list DOCUMENT [--state open|resolved|all]",
+    "perttool plan review-show DOCUMENT REQUEST_ID",
+    "perttool plan review-resolve DOCUMENT REQUEST_ID --outcome plan_retained|plan_changed --resolved-at DATE_TIME --actor PRINCIPAL --resolution-reason TEXT [--accepted-owner PRINCIPAL]... [--request JSON_PATH_OR_STDIN]",
+    "Create and resolve: [--preview] [--diff] [--output PATH | --in-place] [--expected-digest SHA256] [--format text|json]",
+]);
+const examples = Object.freeze([
+    Object.freeze({ id: "open", title: "Record a review request", text: "perttool plan review-request plan.pert REVIEW_1 TASK_1 --reason 'Recheck task scope' --created-at 2026-09-29T09:00:00+09:00 --actor alice --diff" }),
+    Object.freeze({ id: "inspect", title: "Inspect open requests", text: "perttool plan review-list plan.pert --state open --format json" }),
+    Object.freeze({ id: "retain", title: "Resolve with the plan retained", text: "perttool plan review-resolve plan.pert REVIEW_1 --outcome plan_retained --resolved-at 2026-09-29T10:00:00+09:00 --actor alice --resolution-reason 'Current plan retained' --diff" }),
+]);
+function planReviewGuide(level) {
+    return Object.freeze({ schemaVersion: "Perttool.GuideResult.v1", cliContractVersion: 11,
+        toolVersion: TOOL_VERSION, operation: "guide", ok: true, topicId: topic.id, level,
+        title: topic.title, summary: topic.summary,
+        sections: level === "index" ? Object.freeze([]) : sections,
+        syntax: level === "index" ? Object.freeze([]) : syntax,
+        examples: level === "detail" ? examples : Object.freeze([]),
+        related: level === "index" ? Object.freeze([]) : Object.freeze(["plan-assurance", "milestone-acceptance", "editing", "next"]),
+        topics: Object.freeze([]), diagnostics: Object.freeze([]),
+    });
+}
+export function getContract11Guide(topicId, level) {
+    if (topicId === topic.id)
+        return planReviewGuide(level);
+    const base = getContract10Guide(topicId, level);
+    const nextIdentity = topicId === "next" || topicId === "analysis.temporal";
+    const current = nextIdentity ? Object.freeze({
+        ...base,
+        summary: base.summary.replaceAll("NextResult.v8", "NextResult.v9"),
+        sections: Object.freeze(base.sections.map((section) => Object.freeze({
+            ...section,
+            body: section.body.replaceAll("NextResult.v8", "NextResult.v9").replaceAll("NextResult v8", "NextResult v9"),
+        }))),
+    }) : topicId === "editing" ? Object.freeze({
+        ...base,
+        sections: Object.freeze(base.sections.map((section) => Object.freeze({
+            ...section, body: section.body.replaceAll("current Contract 10 candidate", "current Contract 11 candidate"),
+        }))),
+    }) : base;
+    return Object.freeze({ ...current, cliContractVersion: 11,
+        topics: topicId === null ? Object.freeze([
+            ...current.topics.map((entry) => entry.id === "next"
+                ? Object.freeze({ ...entry, summary: entry.summary.replaceAll("NextResult.v8", "NextResult.v9") })
+                : entry),
+            topic,
+        ]) : current.topics });
+}
+export function contract11GuideResultToJson(value) {
+    return guideResultToJson(value);
+}
+export function serializeContract11GuideResult(value) {
+    return `${JSON.stringify(contract11GuideResultToJson(value))}\n`;
+}
+export function renderContract11GuideResult(value) {
+    return renderGuideResult(value);
+}
+//# sourceMappingURL=contract11-guide.js.map

package/dist/help/contract11-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract11-guide.js","sourceRoot":"","sources":["../../src/help/contract11-guide.ts"],"names":[],"mappings":"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"}

package/dist/history/project-history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-history.d.ts","sourceRoot":"","sources":["../../src/history/project-history.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-history.d.ts","sourceRoot":"","sources":["../../src/history/project-history.ts"],"names":[],"mappings":"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"}

package/dist/history/project-history.js

@@ -1,3 +1,4 @@
+import { provesHistoryUnitConversion } from "./unit-conversion-proof.js";
 import { sha256DigestUtf8 } from "../model/sha256.js";
 import { reduceTaskLifecycle, } from "../actuals/lifecycle.js";
 import { projectActualsSourceModel, } from "../actuals/source.js";
@@ -258,6 +259,7 @@ function parseSnapshot(snapshot, validateSource) {
         return {
             parsed: {
                 snapshot,
+                document: null,
                 documentId: null,
                 grammarVersion: null,
                 tasks: new Map(),
@@ -309,6 +311,7 @@ function parseSnapshot(snapshot, validateSource) {
     return {
         parsed: {
             snapshot,
+            document: checked.document,
             documentId: checked.documentId,
             grammarVersion: checked.grammarVersion,
             tasks,
@@ -716,6 +719,8 @@ export function inspectProjectHistoryWithValidator(probe, request, validateSourc
     const replacedTaskIds = new Set();
     const allTaskIds = new Set();
     const plannedByCommit = new Map();
+    let previousDocument = null;
+    let previousEvents = [];
     let previousTasks = new Map();
     let previousEventIds = new Set();
     let previousSourceDigest = null;
@@ -727,10 +732,13 @@ export function inspectProjectHistoryWithValidator(probe, request, validateSourc
         causes.push(...parsedSnapshot.causes);
         if (parsedSnapshot.parsed === null) {
             transitionContinuityKnown = false;
+            previousDocument = null;
+            previousEvents = [];
             previousEventIds = new Set();
             continue;
         }
         const parsed = parsedSnapshot.parsed;
+        const unitConversion = provesHistoryUnitConversion(previousDocument, parsed.document, previousEvents, parsed.events, (event) => payloadDigest({ ...eventProjection(event), plannedValue: null }));
         if (parsed.documentId !== null)
             documentId = parsed.documentId;
         if (parsed.grammarVersion !== null) {
@@ -783,6 +791,11 @@ export function inspectProjectHistoryWithValidator(probe, request, validateSourc
                     removalCommitId: null,
                 });
             }
+            else if (unitConversion && existing.removalCommitId === null &&
+                !conflictedEventIds.has(event.id)) {
+                eventMap.set(event.id, { ...existing, event, projection,
+                    payloadDigest: digest, lastSeenCommitId: snapshot.commitId });
+            }
             else if (existing.payloadDigest !== digest ||
                 existing.removalCommitId !== null) {
                 conflictedEventIds.add(event.id);
@@ -829,6 +842,8 @@ export function inspectProjectHistoryWithValidator(probe, request, validateSourc
                 evidenceClass: "git_recorded_transition",
             }));
         }
+        previousDocument = parsed.document;
+        previousEvents = parsed.events;
         previousTasks = new Map(parsed.tasks);
         previousEventIds = new Set(currentEventsById.keys());
         previousSourceDigest = snapshot.sourceDigest;