perttool 0.11.1 → 0.12.0

package/dist/plan-review/format.js

@@ -0,0 +1,54 @@
+// R: Format Plan Review declarations while preserving the surrounding source.
+import { canonicalizeEventDateTimeSourceToken } from "../model/calendar.js";
+import { formatValidatedSource } from "../mutation/validated-source.js";
+import { formatPlanningPoolSource } from "../planning-pool/format.js";
+import { PLANNING_POOL_SOURCE_CAPABILITY } from "../planning-pool/source.js";
+import { parseQuotedString } from "../temporal-schedule/source-values.js";
+import { planReviewBaseText, planReviewFields, scanPlanReviewDeclarationBlocks, } from "./source-lexical.js";
+import { parsePlanReviewSource, PLAN_REVIEW_SOURCE_CAPABILITY, } from "./source.js";
+function lineEdit(line, replacement) {
+    return Object.freeze({
+        startOffset: line.start,
+        endOffset: line.contentEnd,
+        replacement,
+    });
+}
+function canonicalValue(field) {
+    if (["reason", "locator", "resolution_reason"].includes(field.name)) {
+        const value = parseQuotedString(field.rawValue);
+        return value === null ? null : JSON.stringify(value);
+    }
+    if (field.name === "created_at" || field.name === "resolved_at") {
+        return canonicalizeEventDateTimeSourceToken(field.rawValue);
+    }
+    return field.rawValue;
+}
+function planReviewOwnedEdits(text) {
+    const edits = [];
+    for (const block of scanPlanReviewDeclarationBlocks(text)) {
+        for (const field of planReviewFields(block)) {
+            const value = canonicalValue(field);
+            const replacement = value === null ? null : `  ${field.name} ${value}`;
+            if (replacement !== null && replacement !== field.line.text) {
+                edits.push(lineEdit(field.line, replacement));
+            }
+        }
+    }
+    return Object.freeze(edits);
+}
+function lowerOwnedEdits(text) {
+    const blocks = scanPlanReviewDeclarationBlocks(text);
+    const lowerText = planReviewBaseText(text, blocks);
+    const formatted = formatPlanningPoolSource(lowerText, PLANNING_POOL_SOURCE_CAPABILITY);
+    if (!formatted.ok) {
+        throw new Error("validated Grammar 10 base failed Grammar 9 formatting");
+    }
+    return formatted.edits;
+}
+export function formatPlanReviewSource(text, capability, options = {}) {
+    if (capability !== PLAN_REVIEW_SOURCE_CAPABILITY) {
+        throw new TypeError("the target Grammar 10 Plan Review source capability is required");
+    }
+    return formatValidatedSource(text, (candidate) => parsePlanReviewSource(candidate, capability, options), () => [...lowerOwnedEdits(text), ...planReviewOwnedEdits(text)], "Grammar 10 Plan Review formatter", "Grammar 10 Plan Review formatter produced an invalid candidate");
+}
+//# sourceMappingURL=format.js.map

package/dist/plan-review/format.js.map

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

package/dist/plan-review/lifecycle.d.ts

@@ -0,0 +1,11 @@
+import type { Diagnostic } from "../model/diagnostics.js";
+export interface PlanReviewLifecycleAssessment {
+    readonly ok: boolean;
+    readonly removedTaskIds: readonly string[];
+    readonly removedRequestIds: readonly string[];
+    readonly blockingRequestIds: readonly string[];
+    readonly diagnostics: readonly Diagnostic[];
+}
+/** Inspect a complete final candidate. The caller must also validate its full Grammar 10 source. */
+export declare function assessPlanReviewTaskLifecycle(inputText: string, candidateText: string, mode: "ordinary" | "advance"): PlanReviewLifecycleAssessment;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/plan-review/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/plan-review/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAa1D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAiDD,oGAAoG;AACpG,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,UAAU,GAAG,SAAS,GAC3B,6BAA6B,CA2C/B"}

package/dist/plan-review/lifecycle.js

@@ -0,0 +1,80 @@
+import { scanTemporalDeclarationBlocks } from "../temporal-schedule/source-lexical.js";
+import { planReviewFields, scanPlanReviewDeclarationBlocks, } from "./source-lexical.js";
+import { parsePlanReviewSource, PLAN_REVIEW_SOURCE_CAPABILITY, } from "./source.js";
+function declarationBytes(text, block) {
+    return text.slice(block.header.start, block.lines.at(-1)?.end ?? block.header.end);
+}
+function outcome(block) {
+    return planReviewFields(block).find(({ name }) => name === "outcome")?.rawValue ?? null;
+}
+function taskIds(text) {
+    return new Set(scanTemporalDeclarationBlocks(text)
+        .filter(({ kind }) => kind === "task").map(({ id }) => id));
+}
+function error(ids, message) {
+    return Object.freeze({
+        code: "PTREV-108",
+        severity: "error",
+        message,
+        helpTopic: "editing",
+        data: Object.freeze({ request_ids: Object.freeze([...ids]) }),
+    });
+}
+function inspectRequest(input) {
+    const { request, candidateBlock, removedTasks, mode } = input;
+    if (candidateBlock === undefined) {
+        return mode === "advance" && request.outcome !== null &&
+            removedTasks.has(request.taskId) ? "removed" : "blocked";
+    }
+    if (request.outcome === null && removedTasks.has(request.taskId) &&
+        outcome(candidateBlock) !== "plan_changed")
+        return "blocked";
+    if (mode === "ordinary" && request.outcome !== null &&
+        declarationBytes(input.inputText, input.inputBlock) !==
+            declarationBytes(input.candidateText, candidateBlock))
+        return "altered";
+    return "retained";
+}
+/** Inspect a complete final candidate. The caller must also validate its full Grammar 10 source. */
+export function assessPlanReviewTaskLifecycle(inputText, candidateText, mode) {
+    const input = parsePlanReviewSource(inputText, PLAN_REVIEW_SOURCE_CAPABILITY);
+    if (!input.ok || input.model === null) {
+        throw new TypeError("a valid Grammar 10 Plan Review input is required");
+    }
+    const currentTasks = taskIds(candidateText);
+    const removedTaskIds = [...taskIds(inputText)].filter((id) => !currentTasks.has(id));
+    const removedTasks = new Set(removedTaskIds);
+    const inputBlocks = new Map(scanPlanReviewDeclarationBlocks(inputText)
+        .map((block) => [block.id, block]));
+    const candidateBlocks = new Map(scanPlanReviewDeclarationBlocks(candidateText)
+        .map((block) => [block.id, block]));
+    const removedRequestIds = [];
+    const blockingRequestIds = [];
+    const alteredResolvedIds = [];
+    for (const request of input.model.requests) {
+        const state = inspectRequest({
+            request, inputText, candidateText,
+            inputBlock: inputBlocks.get(request.id),
+            candidateBlock: candidateBlocks.get(request.id), removedTasks, mode,
+        });
+        if (state === "removed")
+            removedRequestIds.push(request.id);
+        if (state === "blocked")
+            blockingRequestIds.push(request.id);
+        if (state === "altered")
+            alteredResolvedIds.push(request.id);
+    }
+    const diagnostics = [];
+    if (blockingRequestIds.length > 0)
+        diagnostics.push(error(blockingRequestIds, `Task removal or request deletion would orphan Plan Review request(s): ${blockingRequestIds.join(", ")}`));
+    if (alteredResolvedIds.length > 0)
+        diagnostics.push(error(alteredResolvedIds, `Ordinary mutation changed resolved Plan Review declaration(s): ${alteredResolvedIds.join(", ")}`));
+    return Object.freeze({
+        ok: diagnostics.length === 0,
+        removedTaskIds: Object.freeze(removedTaskIds),
+        removedRequestIds: Object.freeze(removedRequestIds),
+        blockingRequestIds: Object.freeze(blockingRequestIds),
+        diagnostics: Object.freeze(diagnostics),
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/plan-review/lifecycle.js.map

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

package/dist/plan-review/mutation-types.d.ts

@@ -0,0 +1,112 @@
+import type { Diagnostic } from "../model/diagnostics.js";
+import type { BatchMutation } from "../mutation/types.js";
+import type { TextEdit } from "../mutation/text-edits.js";
+import type { PlanReviewProjectionV1, PlanReviewRequestSource } from "./source-types.js";
+export declare const PLAN_REVIEW_CREATE_REQUEST_ID: "Perttool.PlanReviewCreateRequest.v1";
+export declare const PLAN_REVIEW_RESOLVE_REQUEST_ID: "Perttool.PlanReviewResolveRequest.v1";
+export declare const PLAN_REVIEW_AUTHORITY_ID: "Perttool.PlanReviewAuthorityDecision.v1";
+export interface PlanReviewCreateRequestV1 {
+    readonly schemaVersion: typeof PLAN_REVIEW_CREATE_REQUEST_ID;
+    readonly requestId: string;
+    readonly taskId: string;
+    readonly reason: string;
+    readonly createdAt: string;
+    readonly actor: string;
+    readonly locator?: string;
+}
+export interface PlanReviewResolveRequestV1 {
+    readonly schemaVersion: typeof PLAN_REVIEW_RESOLVE_REQUEST_ID;
+    readonly requestId: string;
+    readonly outcome: "plan_retained" | "plan_changed";
+    readonly resolvedAt: string;
+    readonly actor: string;
+    readonly resolutionReason: string;
+    readonly acceptedOwners?: readonly string[];
+    readonly request?: BatchMutation;
+}
+export interface NormalizedPlanReviewCreateRequestV1 extends Omit<PlanReviewCreateRequestV1, "locator"> {
+    readonly locator: string | null;
+}
+export interface NormalizedPlanReviewResolveRequestV1 extends Omit<PlanReviewResolveRequestV1, "acceptedOwners" | "request"> {
+    readonly acceptedOwners: readonly string[];
+    readonly request: BatchMutation | null;
+    readonly canonicalChangeRequest: string | null;
+    readonly changeRequestDigest: string | null;
+}
+export interface PlanReviewAuthorityDecisionV1 {
+    readonly model_version: 1;
+    readonly request_id: string;
+    readonly source_digest: string;
+    readonly candidate_digest: string;
+    readonly actor: string;
+    readonly effective_dag_owner: string;
+    readonly effective_dag_delegates: readonly string[];
+    readonly actor_direct: boolean;
+    readonly owner_confirmation_required: boolean;
+    readonly owner_confirmation_satisfied: boolean;
+    readonly authorized: boolean;
+}
+export interface PlanReviewComposedMutationResult {
+    readonly ok: boolean;
+    readonly changed: boolean;
+    readonly originalDigest: string;
+    readonly updatedDigest: string | null;
+    readonly updatedText: string | null;
+    readonly edits: readonly TextEdit[];
+    readonly diagnostics: readonly Diagnostic[];
+    readonly diagnosticsTruncated: boolean;
+    readonly [field: string]: unknown;
+}
+export interface PlanReviewMutationPlanBasis {
+    readonly status: "unchanged" | "changed";
+    readonly beforeDigest: string | null;
+    readonly afterDigest: string | null;
+}
+export interface PlanReviewMutationCoreResult {
+    readonly operation: "create" | "resolve";
+    readonly ok: boolean;
+    readonly documentId: string | null;
+    readonly changed: boolean;
+    readonly originalDigest: string;
+    readonly updatedDigest: string | null;
+    readonly updatedText: string | null;
+    readonly diff: string | null;
+    readonly edits: readonly TextEdit[];
+    readonly requestBefore: PlanReviewRequestSource | null;
+    readonly requestAfter: PlanReviewRequestSource | null;
+    readonly projectionBefore: PlanReviewProjectionV1 | null;
+    readonly projectionAfter: PlanReviewProjectionV1 | null;
+    readonly planBasis: PlanReviewMutationPlanBasis;
+    readonly planReviewAuthority: PlanReviewAuthorityDecisionV1 | null;
+    readonly composedMutation: PlanReviewComposedMutationResult | null;
+    readonly diagnostics: readonly Diagnostic[];
+    readonly diagnosticsTruncated: boolean;
+}
+export interface PlanReviewMutationOptions {
+    readonly originalLabel?: string;
+    readonly updatedLabel?: string;
+    readonly expectedDigest?: string;
+    readonly maxDiagnostics?: number;
+}
+export interface PlanReviewMutationDependencies {
+    readonly composeBatch: (text: string, request: BatchMutation, authority: Readonly<{
+        actor: string;
+        acceptedOwners: readonly string[];
+    }>) => PlanReviewComposedMutationResult;
+}
+export type PlanReviewPersistenceRequest = {
+    readonly mode: "in_place";
+    readonly target: string;
+    readonly expectedDigest?: string;
+} | {
+    readonly mode: "out";
+    readonly source: string;
+    readonly target: string;
+    readonly fileMode?: number;
+};
+export interface PlanReviewWriteProjection {
+    readonly mode: "in_place" | "out";
+    readonly target: string;
+    readonly written: boolean;
+}
+//# sourceMappingURL=mutation-types.d.ts.map

package/dist/plan-review/mutation-types.d.ts.map

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

package/dist/plan-review/mutation-types.js

@@ -0,0 +1,4 @@
+export const PLAN_REVIEW_CREATE_REQUEST_ID = "Perttool.PlanReviewCreateRequest.v1";
+export const PLAN_REVIEW_RESOLVE_REQUEST_ID = "Perttool.PlanReviewResolveRequest.v1";
+export const PLAN_REVIEW_AUTHORITY_ID = "Perttool.PlanReviewAuthorityDecision.v1";
+//# sourceMappingURL=mutation-types.js.map

package/dist/plan-review/mutation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-types.js","sourceRoot":"","sources":["../../src/plan-review/mutation-types.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,6BAA6B,GACxC,qCAA8C,CAAC;AACjD,MAAM,CAAC,MAAM,8BAA8B,GACzC,sCAA+C,CAAC;AAClD,MAAM,CAAC,MAAM,wBAAwB,GACnC,yCAAkD,CAAC"}

package/dist/plan-review/mutation.d.ts

@@ -0,0 +1,4 @@
+import type { PlanReviewMutationCoreResult, PlanReviewMutationDependencies, PlanReviewMutationOptions } from "./mutation-types.js";
+export declare function planPlanReviewCreate(text: string, input: unknown, options?: PlanReviewMutationOptions): PlanReviewMutationCoreResult;
+export declare function planPlanReviewResolve(text: string, input: unknown, options?: PlanReviewMutationOptions, dependencies?: PlanReviewMutationDependencies): PlanReviewMutationCoreResult;
+//# sourceMappingURL=mutation.d.ts.map

package/dist/plan-review/mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../src/plan-review/mutation.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAIV,4BAA4B,EAC5B,8BAA8B,EAC9B,yBAAyB,EAE1B,MAAM,qBAAqB,CAAC;AAyO7B,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,yBAA8B,GACtC,4BAA4B,CAuC9B;AA+UD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,yBAA8B,EACvC,YAAY,GAAE,8BAAoD,GACjE,4BAA4B,CA0B9B"}