perttool 0.4.0 → 0.5.1

package/dist/command/actuals-discovery.js

@@ -0,0 +1,328 @@
+import { TOOL_VERSION } from "../version.js";
+import { TARGET_GOVERNANCE_COMMAND_REGISTRY, getTargetGovernanceCommandDiscovery, renderTargetGovernanceCommandHelpResult, serializeTargetGovernanceCommandHelpResult, targetGovernanceCommandDescriptorToJson, targetGovernanceCommandHelpResultToJson, } from "./target-governance-discovery.js";
+function valueOption(name, valueType, config = {}) {
+    return Object.freeze({
+        name,
+        kind: "value",
+        valueType,
+        required: config.required ?? false,
+        repeatable: config.repeatable ?? false,
+        defaultValue: null,
+        enumValues: Object.freeze([...(config.enumValues ?? [])]),
+        conflicts: Object.freeze([]),
+        requires: Object.freeze([]),
+        sharedGroup: config.sharedGroup ?? null,
+        description: config.description ?? null,
+        spelling: Object.freeze({
+            cli: `--${name}`,
+            dsl: null,
+            json: name.replaceAll("-", "_"),
+        }),
+    });
+}
+const governanceOptions = Object.freeze([
+    valueOption("actor", "principal-id", {
+        sharedGroup: "governance",
+        description: "Caller principal evaluated against the pre-change owner and delegates.",
+    }),
+    valueOption("accepted-by-owner", "principal-id", {
+        repeatable: true,
+        sharedGroup: "governance",
+        description: "Caller assertion that the named effective owner was consulted.",
+    }),
+]);
+function contract6Schemas(schemas) {
+    return Object.freeze(schemas.map((schema) => schema === "Perttool.CheckResult.v2"
+        ? "Perttool.CheckResult.v3"
+        : schema === "Perttool.AnalysisResult.v3"
+            ? "Perttool.AnalysisResult.v4"
+            : schema === "Perttool.NextResult.v4"
+                ? "Perttool.NextResult.v5"
+                : schema === "Perttool.MutationResult.v2"
+                    ? "Perttool.MutationResult.v3"
+                    : schema === "Perttool.UnitMigrationResult.v2"
+                        ? "Perttool.UnitMigrationResult.v3"
+                        : schema));
+}
+function contract6Descriptor(descriptor) {
+    const lifecycleFinish = descriptor.operation === "task.finish";
+    const lifecycleOptions = lifecycleFinish
+        ? [
+            valueOption("at", "date-time"),
+            valueOption("event-id", "identifier"),
+            valueOption("active-time", "hours"),
+            valueOption("effort", "person-hours"),
+            ...governanceOptions,
+        ]
+        : [];
+    const projectionIndex = descriptor.options.findIndex(({ sharedGroup }) => sharedGroup === "preview" ||
+        sharedGroup === "write" ||
+        sharedGroup === "diagnostics" ||
+        sharedGroup === "result");
+    const options = lifecycleOptions.length === 0
+        ? descriptor.options
+        : Object.freeze(projectionIndex < 0
+            ? [...descriptor.options, ...lifecycleOptions]
+            : [
+                ...descriptor.options.slice(0, projectionIndex),
+                ...lifecycleOptions,
+                ...descriptor.options.slice(projectionIndex),
+            ]);
+    return Object.freeze({
+        ...descriptor,
+        contractVersion: 6,
+        options,
+        resultSchemas: contract6Schemas(descriptor.resultSchemas),
+    });
+}
+const base = TARGET_GOVERNANCE_COMMAND_REGISTRY.map(contract6Descriptor);
+const finish = base.find(({ operation }) => operation === "task.finish");
+const projectShow = base.find(({ operation }) => operation === "project.show");
+const help = base.find(({ operation }) => operation === "help");
+if (finish === undefined || projectShow === undefined || help === undefined) {
+    throw new Error("Contract 6 descriptor bases are unavailable");
+}
+const finishBase = finish;
+const projectShowBase = projectShow;
+const helpBase = help;
+const schemaDescriptor = Object.freeze({
+    ...helpBase,
+    path: Object.freeze(["schema"]),
+    operation: "schema",
+    summary: "Lists and resolves bundled JSON Schema artifacts.",
+    operands: Object.freeze([
+        Object.freeze({
+            name: "schema-id",
+            valueType: "schema-id",
+            required: false,
+            position: 0,
+        }),
+    ]),
+    resultSchemas: Object.freeze([
+        "Perttool.SchemaResult.v1",
+        "Perttool.CliError.v1",
+    ]),
+    exitStatuses: Object.freeze([
+        Object.freeze({
+            code: 0,
+            meaning: "Successful JSON Schema lookup.",
+        }),
+        Object.freeze({
+            code: 1,
+            meaning: "Unknown JSON Schema identity.",
+        }),
+        Object.freeze({
+            code: 2,
+            meaning: "CLI usage error.",
+        }),
+        Object.freeze({
+            code: 70,
+            meaning: "Internal invariant or programmer error.",
+        }),
+    ]),
+    examples: Object.freeze([
+        Object.freeze({
+            id: "catalog",
+            invocation: "perttool schema --format json",
+            summary: "Return the complete bundled result-schema catalog.",
+        }),
+        Object.freeze({
+            id: "result",
+            invocation: "perttool schema Perttool.NextResult.v5 --format json",
+            summary: "Return one bundled JSON Schema artifact.",
+        }),
+    ]),
+});
+function lifecycleDescriptor(action) {
+    const domainOptions = [
+        valueOption("at", "date-time", { required: true }),
+        valueOption("event-id", "identifier"),
+        ...(action === "suspend"
+            ? [valueOption("reason", "text")]
+            : []),
+        ...governanceOptions,
+    ];
+    const projectionOptions = finishBase.options.filter(({ sharedGroup, name }) => sharedGroup !== "governance" &&
+        name !== "at" &&
+        name !== "event-id" &&
+        name !== "active-time" &&
+        name !== "effort");
+    return Object.freeze({
+        ...finishBase,
+        path: Object.freeze(["task", action]),
+        operation: `task.${action}`,
+        summary: action === "start"
+            ? "Previews starting one task with explicit evidence."
+            : action === "suspend"
+                ? "Previews suspending one active task with explicit evidence."
+                : "Previews resuming one suspended task with explicit evidence.",
+        options: Object.freeze([...domainOptions, ...projectionOptions]),
+        resultSchemas: Object.freeze([
+            "Perttool.MutationResult.v3",
+            "Perttool.CliError.v1",
+        ]),
+        examples: Object.freeze([
+            Object.freeze({
+                id: action,
+                invocation: `perttool task ${action} plan.pert BUILD --at 2026-07-29T09:00:00+09:00 --diff`,
+                summary: `Preview task ${action} with an explicit event time.`,
+            }),
+        ]),
+    });
+}
+const fileOperand = Object.freeze({
+    name: "file",
+    valueType: "path",
+    required: true,
+    position: 0,
+});
+function readDescriptor(action) {
+    const observation = action === "observe-velocity";
+    const projectionOptions = projectShowBase.options.filter(({ sharedGroup }) => sharedGroup === "diagnostics" || sharedGroup === "result");
+    return Object.freeze({
+        ...projectShowBase,
+        path: Object.freeze(["project", action]),
+        operation: `project.${action}`,
+        summary: observation
+            ? "Observes exact project performance without changing declared velocity."
+            : "Reconstructs task actuals from first-parent Git history.",
+        operands: Object.freeze([fileOperand]),
+        options: Object.freeze([
+            valueOption("rev", "git-revision"),
+            valueOption("task", "task-id", { repeatable: true }),
+            ...(observation
+                ? [
+                    valueOption("evidence", "evidence-class", {
+                        enumValues: ["declared", "git-recorded", "all"],
+                    }),
+                ]
+                : []),
+            ...projectionOptions,
+        ]),
+        stdin: Object.freeze({
+            document: false,
+            artifact: false,
+            request: false,
+            mutuallyExclusive: false,
+        }),
+        resultSchemas: Object.freeze([
+            observation
+                ? "Perttool.VelocityObservationResult.v1"
+                : "Perttool.ProjectHistoryResult.v1",
+            "Perttool.CliError.v1",
+        ]),
+        examples: Object.freeze([
+            Object.freeze({
+                id: action,
+                invocation: `perttool project ${action} plan.pert --task BUILD --format json`,
+                summary: observation
+                    ? "Observe declared actuals for one task."
+                    : "Inspect first-parent history for one task.",
+            }),
+        ]),
+    });
+}
+export const ACTUALS_COMMAND_REGISTRY = Object.freeze(base.flatMap((descriptor) => {
+    if (descriptor.operation === "help") {
+        return [descriptor, schemaDescriptor];
+    }
+    if (descriptor.operation === "project.show") {
+        return [
+            descriptor,
+            readDescriptor("history"),
+            readDescriptor("observe-velocity"),
+        ];
+    }
+    if (descriptor.operation === "task.finish") {
+        return [
+            lifecycleDescriptor("start"),
+            lifecycleDescriptor("suspend"),
+            lifecycleDescriptor("resume"),
+            descriptor,
+        ];
+    }
+    return [descriptor];
+}));
+const baseCatalog = getTargetGovernanceCommandDiscovery({
+    resource: null,
+    action: null,
+});
+if (!baseCatalog.ok) {
+    throw new Error("Contract 5 command catalog is unavailable");
+}
+const resourceSummaries = Object.freeze(baseCatalog.resources.map((resource) => Object.freeze({
+    ...resource,
+    actions: Object.freeze(ACTUALS_COMMAND_REGISTRY
+        .filter(({ path }) => path.length === 2 && path[0] === resource.name)
+        .map(({ path }) => path[1])
+        .sort()),
+})));
+const commandsByPath = new Map(ACTUALS_COMMAND_REGISTRY.map((descriptor) => [
+    descriptor.path.join("\0"),
+    descriptor,
+]));
+function helpDiagnostic(code, message, query) {
+    return Object.freeze({
+        code,
+        severity: "error",
+        message,
+        data: Object.freeze({
+            resource: query.resource,
+            action: query.action,
+        }),
+    });
+}
+function helpResult(query, resources, commands, diagnostics) {
+    return Object.freeze({
+        schemaVersion: "Perttool.CommandHelpResult.v1",
+        cliContractVersion: 6,
+        toolVersion: TOOL_VERSION,
+        operation: "help",
+        ok: diagnostics.length === 0,
+        query: Object.freeze({ ...query }),
+        resources: Object.freeze([...resources]),
+        commands: Object.freeze([...commands]),
+        diagnostics: Object.freeze([...diagnostics]),
+    });
+}
+export function getActualsCommandDiscovery(query) {
+    if (query.resource === null) {
+        return query.action === null
+            ? helpResult(query, resourceSummaries, ACTUALS_COMMAND_REGISTRY, [])
+            : helpResult(query, [], [], [helpDiagnostic("PTHLP-002", "a command action requires a resource", query)]);
+    }
+    if (query.action === null) {
+        const topLevel = commandsByPath.get(query.resource);
+        if (topLevel !== undefined && topLevel.path.length === 1) {
+            return helpResult(query, [], [topLevel], []);
+        }
+        const resource = resourceSummaries.find(({ name }) => name === query.resource);
+        return resource === undefined
+            ? helpResult(query, [], [], [helpDiagnostic("PTHLP-002", `unknown command resource or top-level command: ${query.resource}`, query)])
+            : helpResult(query, [resource], ACTUALS_COMMAND_REGISTRY.filter(({ path }) => path.length === 2 && path[0] === query.resource), []);
+    }
+    const resource = resourceSummaries.find(({ name }) => name === query.resource);
+    if (resource === undefined) {
+        return helpResult(query, [], [], [helpDiagnostic("PTHLP-002", `unknown command resource: ${query.resource}`, query)]);
+    }
+    const command = commandsByPath.get(`${query.resource}\0${query.action}`);
+    return command === undefined
+        ? helpResult(query, [], [], [helpDiagnostic("PTHLP-003", `unknown action ${query.action} for command resource ${query.resource}`, query)])
+        : helpResult(query, [resource], [command], []);
+}
+export function actualsCommandDescriptorToJson(descriptor) {
+    return targetGovernanceCommandDescriptorToJson(descriptor);
+}
+export function actualsCommandRegistryToJson() {
+    return ACTUALS_COMMAND_REGISTRY.map(actualsCommandDescriptorToJson);
+}
+export function serializeActualsCommandHelpResult(value) {
+    return serializeTargetGovernanceCommandHelpResult(value);
+}
+export function actualsCommandHelpResultToJson(value) {
+    return targetGovernanceCommandHelpResultToJson(value);
+}
+export function renderActualsCommandHelpResult(value) {
+    return renderTargetGovernanceCommandHelpResult(value).replace("perttool command catalog (CLI Contract 5)", "perttool command catalog (CLI Contract 6)");
+}
+//# sourceMappingURL=actuals-discovery.js.map

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

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

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

@@ -0,0 +1,22 @@
+import type { GovernanceRequestInput } from "../governance/types.js";
+import type { CommandOptionOccurrence, CommandUsageError } from "./usage.js";
+import { renderCommandUsageError } from "./usage.js";
+import { type ActualsCommandDescriptor } from "./actuals-discovery.js";
+export interface ActualsValidCommandInvocation {
+    readonly ok: true;
+    readonly descriptor: ActualsCommandDescriptor;
+    readonly helpAlias: boolean;
+    readonly operands: readonly string[];
+    readonly options: readonly CommandOptionOccurrence[];
+}
+export interface ActualsInvalidCommandInvocation {
+    readonly ok: false;
+    readonly error: CommandUsageError;
+}
+export type ActualsCommandInvocationValidation = ActualsValidCommandInvocation | ActualsInvalidCommandInvocation;
+export declare function validateActualsCommandInvocation(argv: readonly string[]): ActualsCommandInvocationValidation;
+export declare function governanceRequestFromActualsInvocation(invocation: ActualsValidCommandInvocation): GovernanceRequestInput;
+export declare function actualsCommandUsageErrorToJson(error: CommandUsageError): Readonly<Record<string, unknown>>;
+export declare function serializeActualsCommandUsageError(error: CommandUsageError): string;
+export { renderCommandUsageError as renderActualsCommandUsageError };
+//# sourceMappingURL=actuals-usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actuals-usage.d.ts","sourceRoot":"","sources":["../../src/command/actuals-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAGV,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEL,uBAAuB,EAExB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAYhC,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC;AAED,MAAM,MAAM,kCAAkC,GAC1C,6BAA6B,GAC7B,+BAA+B,CAAC;AAoIpC,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,kCAAkC,CAYpC;AAED,wBAAgB,sCAAsC,CACpD,UAAU,EAAE,6BAA6B,GACxC,sBAAsB,CAwBxB;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,iBAAiB,GACvB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEnC;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,iBAAiB,GACvB,MAAM,CAER;AAED,OAAO,EAAE,uBAAuB,IAAI,8BAA8B,EAAE,CAAC"}

package/dist/command/actuals-usage.js

@@ -0,0 +1,122 @@
+import { commandUsageErrorToJsonForContract, renderCommandUsageError, validateCommandInvocationAgainstRegistry, } from "./usage.js";
+import { ACTUALS_COMMAND_REGISTRY, } from "./actuals-discovery.js";
+const principalPattern = /^[A-Za-z][A-Za-z0-9_-]*$/;
+const principalListPattern = /^\[[ \t]*(?:[A-Za-z][A-Za-z0-9_-]*(?:[ \t]*,[ \t]*[A-Za-z][A-Za-z0-9_-]*)*)?[ \t]*\]$/;
+const projectGovernanceOptionNames = new Set([
+    "goal-owner",
+    "goal-delegates",
+    "dag-owner",
+    "dag-delegates",
+]);
+function helpTarget(descriptor) {
+    return descriptor.path.length === 1
+        ? Object.freeze({
+            resource: descriptor.path[0],
+            action: null,
+        })
+        : Object.freeze({
+            resource: descriptor.path[0],
+            action: descriptor.path[1],
+        });
+}
+function invalid(descriptor, kind, message, token) {
+    return {
+        ok: false,
+        error: Object.freeze({
+            code: "PTCLI-001",
+            kind,
+            message,
+            operation: descriptor.operation,
+            token,
+            helpTarget: helpTarget(descriptor),
+            suggestion: null,
+        }),
+    };
+}
+function principalList(value) {
+    if (!principalListPattern.test(value))
+        return null;
+    const interior = value.slice(1, -1).trim();
+    if (interior === "")
+        return Object.freeze([]);
+    const principals = interior.split(",").map((item) => item.trim());
+    return new Set(principals).size === principals.length
+        ? Object.freeze(principals)
+        : null;
+}
+function validateValues(invocation) {
+    const optionByName = new Map(invocation.descriptor.options.map((option) => [
+        option.name,
+        option,
+    ]));
+    const occurrencesByName = new Map();
+    const seenAcceptedOwners = new Set();
+    for (const occurrence of invocation.options) {
+        const entries = occurrencesByName.get(occurrence.name) ?? [];
+        entries.push(occurrence);
+        occurrencesByName.set(occurrence.name, entries);
+        const descriptor = optionByName.get(occurrence.name);
+        if (descriptor === undefined || occurrence.value === null)
+            continue;
+        if (descriptor.valueType === "principal-id" &&
+            !principalPattern.test(occurrence.value)) {
+            return invalid(invocation.descriptor, "invalid_option_value", `option --${occurrence.name} requires an ASCII principal ID`, occurrence.value);
+        }
+        if (occurrence.name === "accepted-by-owner") {
+            if (seenAcceptedOwners.has(occurrence.value)) {
+                return invalid(invocation.descriptor, "duplicate_option", `option --accepted-by-owner repeats principal ${occurrence.value}`, occurrence.value);
+            }
+            seenAcceptedOwners.add(occurrence.value);
+        }
+        if (descriptor.valueType === "principal-list" &&
+            principalList(occurrence.value) === null) {
+            return invalid(invocation.descriptor, "invalid_option_value", `option --${occurrence.name} requires a duplicate-free bracketed principal list`, occurrence.value);
+        }
+    }
+    if (invocation.descriptor.operation === "project.init" &&
+        invocation.options.some(({ name }) => projectGovernanceOptionNames.has(name))) {
+        const version = occurrencesByName.get("version")?.[0];
+        if (version !== undefined &&
+            version.value !== "4" &&
+            version.value !== "5") {
+            return invalid(invocation.descriptor, "option_conflict", "project init governance options conflict with an explicit version other than 4 or 5", version.value);
+        }
+    }
+    const selectedTasks = occurrencesByName.get("task")?.map(({ value }) => value) ?? [];
+    if (new Set(selectedTasks).size !== selectedTasks.length) {
+        return invalid(invocation.descriptor, "duplicate_option", "option --task repeats a task ID", selectedTasks.find((value, index) => selectedTasks.indexOf(value) !== index) ?? null);
+    }
+    return invocation;
+}
+export function validateActualsCommandInvocation(argv) {
+    const validation = validateCommandInvocationAgainstRegistry(argv, ACTUALS_COMMAND_REGISTRY);
+    if (!validation.ok)
+        return validation;
+    return validateValues({
+        ...validation,
+        descriptor: validation.descriptor,
+    });
+}
+export function governanceRequestFromActualsInvocation(invocation) {
+    if (!invocation.descriptor.options.some(({ sharedGroup }) => sharedGroup === "governance")) {
+        throw new TypeError(`${invocation.descriptor.operation} has no governance assertion group`);
+    }
+    const actor = invocation.options.find(({ name }) => name === "actor")?.value ?? null;
+    const acceptedByOwner = invocation.options
+        .filter(({ name }) => name === "accepted-by-owner")
+        .map(({ value }) => value);
+    const persist = invocation.options.some(({ name }) => name === "write" || name === "out");
+    return Object.freeze({
+        intent: persist ? "persist" : "preview",
+        actor,
+        acceptedByOwner: Object.freeze(acceptedByOwner),
+    });
+}
+export function actualsCommandUsageErrorToJson(error) {
+    return commandUsageErrorToJsonForContract(error, 6);
+}
+export function serializeActualsCommandUsageError(error) {
+    return `${JSON.stringify(actualsCommandUsageErrorToJson(error), null, 2)}\n`;
+}
+export { renderCommandUsageError as renderActualsCommandUsageError };
+//# sourceMappingURL=actuals-usage.js.map

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

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

package/dist/formatter/source-formatter.d.ts

@@ -1,6 +1,6 @@
 import { type CheckOptions } from "../application/check.js";
 import type { Diagnostic } from "../model/diagnostics.js";
-import type { DeclarationKind, DocumentNode } from "../model/syntax.js";
+import type { DeclarationKind, DocumentNode, TargetDeclarationKind } from "../model/syntax.js";
 import { type TextEdit } from "../mutation/text-edits.js";
 export type { TextEdit } from "../mutation/text-edits.js";
 export interface FormatOptions extends CheckOptions {
@@ -16,13 +16,13 @@ export interface FormatResult {
 }
 export interface FormatValidation {
     readonly ok: boolean;
-    readonly document: DocumentNode | null;
+    readonly document: DocumentNode<TargetDeclarationKind> | null;
     readonly documentId: string | null;
     readonly diagnostics: readonly Diagnostic[];
     readonly diagnosticsTruncated: boolean;
 }
 export interface SourceFormatProfile {
-    readonly fieldOrder: Readonly<Record<DeclarationKind, readonly string[]>>;
+    readonly fieldOrder: Readonly<Record<DeclarationKind, readonly string[]>> & Partial<Readonly<Record<"work_event", readonly string[]>>>;
 }
 export declare function formatValidatedSource(text: string, checked: FormatValidation, validateCandidate: (candidate: string) => FormatValidation, profile: SourceFormatProfile): FormatResult;
 export declare function formatDocument(text: string, options?: FormatOptions): FormatResult;

package/dist/formatter/source-formatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-formatter.d.ts","sourceRoot":"","sources":["../../src/formatter/source-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAI1D,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EAOb,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,aAAc,SAAQ,YAAY;CAAG;AAEtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CAC3E;AAyKD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,EACzB,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,gBAAgB,EAC1D,OAAO,EAAE,mBAAmB,GAC3B,YAAY,CAoHd;AAgBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,CAOtF"}
+{"version":3,"file":"source-formatter.d.ts","sourceRoot":"","sources":["../../src/formatter/source-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAU1D,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EASZ,qBAAqB,EAEtB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,aAAc,SAAQ,YAAY;CAAG;AAEtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EACjB,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,GAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;CAChE;AAqOD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,EACzB,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,gBAAgB,EAC1D,OAAO,EAAE,mBAAmB,GAC3B,YAAY,CAsHd;AAgBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,YAAY,CAOtF"}

package/dist/formatter/source-formatter.js

@@ -1,6 +1,9 @@
 import { checkDocument } from "../application/check.js";
-import { TARGET_GRAMMAR_4_DECLARATION_FIELD_ORDER, } from "../model/declaration-fields.js";
+import { canonicalizeEventDateTimeSourceToken, } from "../model/calendar.js";
+import { canonicalizeExactPersonHoursSourceToken, } from "../model/exact-person-hours-source.js";
+import { TARGET_GRAMMAR_5_DECLARATION_FIELD_ORDER, } from "../model/declaration-fields.js";
 import { serializeExactDurationSource, } from "../model/exact-duration-source.js";
+import { rational } from "../model/rational.js";
 import { applyTextEdits, normalizeTextEdits, } from "../mutation/text-edits.js";
 const bareTagPattern = /^[A-Za-z][A-Za-z0-9_-]*$/;
 function splitPhysicalLines(text) {
@@ -80,6 +83,34 @@ function isDurationFractionValue(value) {
 function isExactDurationValue(value) {
     return isDurationValue(value) || isDurationFractionValue(value);
 }
+function isPersonHoursValue(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "digits" in value &&
+        typeof value.digits === "bigint" &&
+        "scale" in value &&
+        typeof value.scale === "number" &&
+        "suffix" in value &&
+        value.suffix === "ph");
+}
+function isPersonHoursFractionValue(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "numerator" in value &&
+        typeof value.numerator === "bigint" &&
+        "denominator" in value &&
+        typeof value.denominator === "bigint" &&
+        value.denominator > 0n &&
+        "suffix" in value &&
+        value.suffix === "ph");
+}
+function canonicalPersonHours(value) {
+    const canonical = canonicalizeExactPersonHoursSourceToken(value.text);
+    if (canonical === null) {
+        throw new Error("validated person-hours value is not canonicalizable");
+    }
+    return canonical;
+}
 function isVelocityValue(value) {
     return (typeof value === "object" &&
         value !== null &&
@@ -94,14 +125,31 @@ function canonicalFieldValue(field) {
     if (["title", "description", "owner", "source", "blocked_reason", "reason"].includes(field.name)) {
         return typeof field.value === "string" ? JSON.stringify(field.value) : undefined;
     }
-    if (["version", "capacity", "priority"].includes(field.name)) {
+    if (["version", "capacity", "priority", "model"].includes(field.name)) {
         return typeof field.value === "number" ? String(field.value) : undefined;
     }
-    if (["duration", "critical_epsilon", "target_duration", "optimistic", "most_likely", "pessimistic"].includes(field.name)) {
+    if ([
+        "duration",
+        "critical_epsilon",
+        "target_duration",
+        "optimistic",
+        "most_likely",
+        "pessimistic",
+        "planned_value",
+        "active_time",
+    ].includes(field.name)) {
         return isExactDurationValue(field.value)
             ? canonicalDuration(field.value)
             : undefined;
     }
+    if (field.name === "effort" &&
+        (isPersonHoursValue(field.value) ||
+            isPersonHoursFractionValue(field.value))) {
+        return canonicalPersonHours(field.value);
+    }
+    if (field.name === "occurred_at" && typeof field.rawValue === "string") {
+        return canonicalizeEventDateTimeSourceToken(field.rawValue) ?? undefined;
+    }
     if (field.name === "velocity") {
         return isVelocityValue(field.value)
             ? `${canonicalDuration(field.value.points)}/${canonicalDuration(field.value.period)}`
@@ -155,7 +203,7 @@ export function formatValidatedSource(text, checked, validateCandidate, profile)
     const lineEnding = majorLineEnding(text);
     const edits = [];
     for (const declaration of checked.document.declarations) {
-        const knownFields = new Set(profile.fieldOrder[declaration.kind]);
+        const knownFields = new Set(profile.fieldOrder[declaration.kind] ?? []);
         pushEdit(edits, text, {
             startOffset: declaration.headerSpan.start.offset,
             endOffset: declaration.headerSpan.end.offset,
@@ -258,6 +306,6 @@ function activeValidation(text, options) {
     };
 }
 export function formatDocument(text, options = {}) {
-    return formatValidatedSource(text, activeValidation(text, options), (candidate) => activeValidation(candidate, options), { fieldOrder: TARGET_GRAMMAR_4_DECLARATION_FIELD_ORDER });
+    return formatValidatedSource(text, activeValidation(text, options), (candidate) => activeValidation(candidate, options), { fieldOrder: TARGET_GRAMMAR_5_DECLARATION_FIELD_ORDER });
 }
 //# sourceMappingURL=source-formatter.js.map