perttool 0.3.0 → 0.5.0

package/dist/application/target-governance-init.js

@@ -0,0 +1,195 @@
+import { digestDocumentBytes } from "../io/document-file.js";
+import { mutationDiagnostic } from "../mutation/diagnostics.js";
+import { GOVERNANCE_DIRECT_EDIT_WARNING } from "../governance/guidance.js";
+import { validateTargetGrammar4Document, validateTargetGrammar5Document, } from "../semantic/target-validator.js";
+export { GOVERNANCE_DIRECT_EDIT_WARNING };
+const requestFields = new Set([
+    "projectId",
+    "title",
+    "durationUnit",
+    "initialMilestone",
+    "initialMilestoneTitle",
+    "finish",
+    "version",
+    "asOf",
+    "velocity",
+    "initialMilestoneDeadline",
+    "goalOwner",
+    "goalDelegates",
+    "dagOwner",
+    "dagDelegates",
+]);
+const principalPattern = /^[A-Za-z][A-Za-z0-9_-]*$/;
+const previewWrite = Object.freeze({
+    mode: "preview",
+    target: null,
+    written: false,
+});
+function hasGovernance(request) {
+    return (request.goalOwner !== undefined ||
+        request.goalDelegates !== undefined ||
+        request.dagOwner !== undefined ||
+        request.dagDelegates !== undefined);
+}
+function requestError(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return "project init request is not an object";
+    }
+    const request = value;
+    if (Object.keys(request).some((field) => !requestFields.has(field))) {
+        return "project init request contains unsupported fields";
+    }
+    for (const field of [
+        "projectId",
+        "title",
+        "initialMilestone",
+        "initialMilestoneTitle",
+        "finish",
+    ]) {
+        if (typeof request[field] !== "string") {
+            return `project init request requires string field ${field}`;
+        }
+    }
+    if (request["durationUnit"] !== "day" &&
+        request["durationUnit"] !== "hour" &&
+        request["durationUnit"] !== "point") {
+        return "project init durationUnit must be day, hour, or point";
+    }
+    if (request["version"] !== undefined &&
+        (!Number.isSafeInteger(request["version"]) ||
+            request["version"] < 1 ||
+            request["version"] > 5)) {
+        return "project init version must be an integer from 1 to 5";
+    }
+    for (const field of ["asOf", "velocity", "initialMilestoneDeadline"]) {
+        if (request[field] !== undefined && typeof request[field] !== "string") {
+            return `project init ${field} must be a string when provided`;
+        }
+    }
+    for (const field of ["goalOwner", "dagOwner"]) {
+        const principal = request[field];
+        if (principal !== undefined &&
+            (typeof principal !== "string" || !principalPattern.test(principal))) {
+            return `project init ${field} must be a principal when provided`;
+        }
+    }
+    for (const field of ["goalDelegates", "dagDelegates"]) {
+        const principals = request[field];
+        if (principals !== undefined &&
+            (!Array.isArray(principals) ||
+                principals.some((principal) => typeof principal !== "string" || !principalPattern.test(principal)))) {
+            return `project init ${field} must be a principal list when provided`;
+        }
+    }
+    if (request["finish"] !== request["initialMilestone"]) {
+        return "project init finish must equal initialMilestone in initialization version 1";
+    }
+    if (request["durationUnit"] === "point" && request["velocity"] === undefined) {
+        return "project init with point durationUnit requires velocity";
+    }
+    const governance = hasGovernance(request);
+    if (governance &&
+        request["version"] !== undefined &&
+        request["version"] !== 4 &&
+        request["version"] !== 5) {
+        return "project init governance fields require version 4 or 5";
+    }
+    const version = governance ? (request["version"] ?? 4) : (request["version"] ?? 1);
+    if (request["initialMilestoneDeadline"] !== undefined &&
+        ((version !== 2 &&
+            version !== 3 &&
+            version !== 4 &&
+            version !== 5) ||
+            request["asOf"] === undefined)) {
+        return "project init initialMilestoneDeadline requires version 2, 3, 4, or 5 and asOf";
+    }
+    return undefined;
+}
+function principalList(values) {
+    return `[${values.join(", ")}]`;
+}
+function renderCandidate(request) {
+    const version = hasGovernance(request)
+        ? (request.version ?? 4)
+        : (request.version ?? 1);
+    return [
+        GOVERNANCE_DIRECT_EDIT_WARNING,
+        `project ${request.projectId}:`,
+        `  version ${version}`,
+        `  title ${JSON.stringify(request.title)}`,
+        ...(request.asOf === undefined ? [] : [`  as_of ${request.asOf}`]),
+        `  duration_unit ${request.durationUnit}`,
+        ...(request.velocity === undefined ? [] : [`  velocity ${request.velocity}`]),
+        `  finish ${request.finish}`,
+        ...(request.goalOwner === undefined
+            ? []
+            : [`  goal_owner ${request.goalOwner}`]),
+        ...(request.goalDelegates === undefined
+            ? []
+            : [`  goal_delegates ${principalList(request.goalDelegates)}`]),
+        ...(request.dagOwner === undefined
+            ? []
+            : [`  dag_owner ${request.dagOwner}`]),
+        ...(request.dagDelegates === undefined
+            ? []
+            : [`  dag_delegates ${principalList(request.dagDelegates)}`]),
+        "",
+        `milestone ${request.initialMilestone}:`,
+        `  title ${JSON.stringify(request.initialMilestoneTitle)}`,
+        "  state reached",
+        ...(request.initialMilestoneDeadline === undefined
+            ? []
+            : [`  deadline ${request.initialMilestoneDeadline}`]),
+        "",
+    ].join("\n");
+}
+export function planTargetGovernanceProjectInit(request, capability, options = {}) {
+    const error = requestError(request);
+    if (error !== undefined) {
+        return {
+            ok: false,
+            documentId: null,
+            grammarVersion: null,
+            candidateText: null,
+            candidateDigest: null,
+            edits: [],
+            write: previewWrite,
+            diagnostics: [mutationDiagnostic("PTMUT-301", error)],
+            diagnosticsTruncated: false,
+        };
+    }
+    const candidateText = renderCandidate(request);
+    const checked = capability.grammarVersion === 5
+        ? validateTargetGrammar5Document(candidateText, capability, options)
+        : validateTargetGrammar4Document(candidateText, capability, options);
+    if (!checked.ok || checked.validatedDocument === null) {
+        return {
+            ok: false,
+            documentId: checked.documentId,
+            grammarVersion: null,
+            candidateText: null,
+            candidateDigest: null,
+            edits: [],
+            write: previewWrite,
+            diagnostics: checked.diagnostics,
+            diagnosticsTruncated: checked.diagnosticsTruncated,
+        };
+    }
+    const edit = Object.freeze({
+        startOffset: 0,
+        endOffset: 0,
+        replacement: candidateText,
+    });
+    return {
+        ok: true,
+        documentId: checked.documentId,
+        grammarVersion: checked.validatedDocument.grammarVersion,
+        candidateText,
+        candidateDigest: digestDocumentBytes(Buffer.from(candidateText, "utf8")),
+        edits: Object.freeze([edit]),
+        write: previewWrite,
+        diagnostics: checked.diagnostics,
+        diagnosticsTruncated: checked.diagnosticsTruncated,
+    };
+}
+//# sourceMappingURL=target-governance-init.js.map

package/dist/application/target-governance-init.js.map

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

package/dist/application/target-governance-mutation.d.ts

@@ -0,0 +1,20 @@
+import type { GovernanceDecisionV1, GovernanceRequestInput } from "../governance/types.js";
+import type { TargetGovernanceBatchMutation, TargetGovernanceMutation } from "../mutation/target-types.js";
+import type { MutationOptions, MutationResult } from "../mutation/types.js";
+import { type AdvanceResult } from "../mutation/advance.js";
+import type { TargetGrammar4Capability } from "../parser/document-parser.js";
+export interface TargetGovernanceMutationOptions extends MutationOptions {
+    readonly governance?: GovernanceRequestInput;
+}
+export interface TargetGovernanceMutationResultV2 extends MutationResult {
+    readonly schemaVersion: "Perttool.MutationResult.v2";
+    readonly governance: GovernanceDecisionV1 | null;
+}
+export interface TargetGovernanceAdvanceResultV2 extends AdvanceResult {
+    readonly schemaVersion: "Perttool.MutationResult.v2";
+    readonly governance: GovernanceDecisionV1 | null;
+}
+export declare function planTargetGovernanceMutation(text: string, mutation: TargetGovernanceMutation, capability: TargetGrammar4Capability, options?: TargetGovernanceMutationOptions): TargetGovernanceMutationResultV2;
+export declare function planTargetGovernanceBatchMutation(text: string, mutation: TargetGovernanceBatchMutation, capability: TargetGrammar4Capability, options?: TargetGovernanceMutationOptions): TargetGovernanceMutationResultV2;
+export declare function planTargetGovernanceAdvance(text: string, capability: TargetGrammar4Capability, options?: TargetGovernanceMutationOptions): TargetGovernanceAdvanceResultV2;
+//# sourceMappingURL=target-governance-mutation.d.ts.map

package/dist/application/target-governance-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-governance-mutation.d.ts","sourceRoot":"","sources":["../../src/application/target-governance-mutation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAOhC,OAAO,KAAK,EACV,6BAA6B,EAC7B,wBAAwB,EACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAU7E,MAAM,WAAW,+BAAgC,SAAQ,eAAe;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,sBAAsB,CAAC;CAC9C;AAED,MAAM,WAAW,gCAAiC,SAAQ,cAAc;IACtE,QAAQ,CAAC,aAAa,EAAE,4BAA4B,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,+BACf,SAAQ,aAAa;IACrB,QAAQ,CAAC,aAAa,EAAE,4BAA4B,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAClD;AA8JD,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,wBAAwB,EAClC,UAAU,EAAE,wBAAwB,EACpC,OAAO,GAAE,+BAAoC,GAC5C,gCAAgC,CAiClC;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,6BAA6B,EACvC,UAAU,EAAE,wBAAwB,EACpC,OAAO,GAAE,+BAAoC,GAC5C,gCAAgC,CAiClC;AA8BD,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,wBAAwB,EACpC,OAAO,GAAE,+BAAoC,GAC5C,+BAA+B,CAoCjC"}

package/dist/application/target-governance-mutation.js

@@ -0,0 +1,175 @@
+import { createHash } from "node:crypto";
+import { classifyGovernanceScopes, evaluateGovernanceAuthority, governanceDenialDiagnostic, normalizeGovernanceRequest, } from "../governance/authority.js";
+import { governanceSourceSnapshot } from "../governance/source.js";
+import { limitDiagnostics, normalizeMaxDiagnostics, sortDiagnostics, } from "../model/diagnostics.js";
+import { planValidatedAdvance, } from "../mutation/advance.js";
+import { validateTargetGrammar4Document, } from "../semantic/target-validator.js";
+import { planTargetGrammar4BatchMutation, planTargetGrammar4Mutation, } from "./target-mutate.js";
+function digest(text) {
+    return `sha256:${createHash("sha256").update(text, "utf8").digest("hex")}`;
+}
+function mutationOptions(options) {
+    return {
+        ...(options.maxDiagnostics === undefined
+            ? {}
+            : { maxDiagnostics: options.maxDiagnostics }),
+        ...(options.originalLabel === undefined
+            ? {}
+            : { originalLabel: options.originalLabel }),
+        ...(options.updatedLabel === undefined
+            ? {}
+            : { updatedLabel: options.updatedLabel }),
+    };
+}
+function validOriginal(text, capability, maximum) {
+    const checked = validateTargetGrammar4Document(text, capability, { maxDiagnostics: maximum });
+    if (!checked.ok || checked.validatedDocument === null)
+        return null;
+    return {
+        validated: checked.validatedDocument,
+        documentId: checked.documentId,
+        diagnostics: checked.diagnostics,
+        diagnosticsTruncated: checked.diagnosticsTruncated,
+    };
+}
+function requestFailure(text, original, diagnostic, maximum) {
+    const limited = limitDiagnostics(sortDiagnostics([...original.diagnostics, diagnostic]), maximum);
+    return Object.freeze({
+        schemaVersion: "Perttool.MutationResult.v2",
+        ok: false,
+        documentId: original.documentId,
+        changed: false,
+        originalDigest: digest(text),
+        updatedDigest: null,
+        updatedText: null,
+        diff: null,
+        edits: Object.freeze([]),
+        governance: null,
+        diagnostics: limited.diagnostics,
+        diagnosticsTruncated: original.diagnosticsTruncated || limited.truncated,
+    });
+}
+function governedResult(original, base, capability, options) {
+    if (!base.ok ||
+        base.updatedText === null ||
+        base.updatedDigest === null) {
+        return Object.freeze({
+            ...base,
+            schemaVersion: "Perttool.MutationResult.v2",
+            governance: null,
+        });
+    }
+    const normalized = normalizeGovernanceRequest(options.governance);
+    if (!normalized.ok) {
+        throw new Error("governance request must be normalized before candidate planning");
+    }
+    const candidate = validateTargetGrammar4Document(base.updatedText, capability, options.maxDiagnostics === undefined
+        ? {}
+        : { maxDiagnostics: options.maxDiagnostics });
+    if (!candidate.ok || candidate.validatedDocument === null) {
+        throw new Error("governance candidate lost target validation");
+    }
+    const snapshot = governanceSourceSnapshot(original.validated, base.originalDigest);
+    const scopes = classifyGovernanceScopes(original.validated.document, candidate.validatedDocument.document);
+    const governance = evaluateGovernanceAuthority(snapshot, scopes, normalized.request);
+    const denial = governanceDenialDiagnostic(governance);
+    if (denial === null) {
+        return Object.freeze({
+            ...base,
+            schemaVersion: "Perttool.MutationResult.v2",
+            governance,
+        });
+    }
+    const maximum = normalizeMaxDiagnostics(options.maxDiagnostics);
+    const limited = limitDiagnostics(sortDiagnostics([...base.diagnostics, denial]), maximum);
+    return Object.freeze({
+        ...base,
+        schemaVersion: "Perttool.MutationResult.v2",
+        ok: false,
+        governance,
+        diagnostics: limited.diagnostics,
+        diagnosticsTruncated: base.diagnosticsTruncated || limited.truncated,
+    });
+}
+function invalidOriginalResult(result) {
+    return Object.freeze({
+        ...result,
+        schemaVersion: "Perttool.MutationResult.v2",
+        governance: null,
+    });
+}
+export function planTargetGovernanceMutation(text, mutation, capability, options = {}) {
+    const maximum = normalizeMaxDiagnostics(options.maxDiagnostics);
+    const original = validOriginal(text, capability, maximum);
+    const baseOptions = mutationOptions(options);
+    if (original === null) {
+        return invalidOriginalResult(planTargetGrammar4Mutation(text, mutation, capability, baseOptions));
+    }
+    const normalized = normalizeGovernanceRequest(options.governance);
+    if (!normalized.ok) {
+        return requestFailure(text, original, normalized.diagnostics[0], maximum);
+    }
+    const base = planTargetGrammar4Mutation(text, mutation, capability, baseOptions);
+    return governedResult(original, base, capability, {
+        ...options,
+        governance: normalized.request,
+    });
+}
+export function planTargetGovernanceBatchMutation(text, mutation, capability, options = {}) {
+    const maximum = normalizeMaxDiagnostics(options.maxDiagnostics);
+    const original = validOriginal(text, capability, maximum);
+    const baseOptions = mutationOptions(options);
+    if (original === null) {
+        return invalidOriginalResult(planTargetGrammar4BatchMutation(text, mutation, capability, baseOptions));
+    }
+    const normalized = normalizeGovernanceRequest(options.governance);
+    if (!normalized.ok) {
+        return requestFailure(text, original, normalized.diagnostics[0], maximum);
+    }
+    const base = planTargetGrammar4BatchMutation(text, mutation, capability, baseOptions);
+    return governedResult(original, base, capability, {
+        ...options,
+        governance: normalized.request,
+    });
+}
+function targetAdvanceValidator(capability) {
+    return (text, maxDiagnostics) => {
+        const checked = validateTargetGrammar4Document(text, capability, { maxDiagnostics });
+        return {
+            ok: checked.ok,
+            document: checked.document,
+            documentId: checked.documentId,
+            diagnostics: checked.diagnostics,
+            diagnosticsTruncated: checked.diagnosticsTruncated,
+        };
+    };
+}
+function invalidAdvanceRequest(failure) {
+    return Object.freeze({
+        ...failure,
+        advance: null,
+    });
+}
+export function planTargetGovernanceAdvance(text, capability, options = {}) {
+    const maximum = normalizeMaxDiagnostics(options.maxDiagnostics);
+    const original = validOriginal(text, capability, maximum);
+    const baseOptions = mutationOptions(options);
+    if (original === null) {
+        const base = planValidatedAdvance(text, targetAdvanceValidator(capability), baseOptions);
+        return Object.freeze({
+            ...base,
+            schemaVersion: "Perttool.MutationResult.v2",
+            governance: null,
+        });
+    }
+    const normalized = normalizeGovernanceRequest(options.governance);
+    if (!normalized.ok) {
+        return invalidAdvanceRequest(requestFailure(text, original, normalized.diagnostics[0], maximum));
+    }
+    const base = planValidatedAdvance(text, targetAdvanceValidator(capability), baseOptions);
+    return governedResult(original, base, capability, {
+        ...options,
+        governance: normalized.request,
+    });
+}
+//# sourceMappingURL=target-governance-mutation.js.map

package/dist/application/target-governance-mutation.js.map

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

package/dist/application/target-governance-project.d.ts

@@ -0,0 +1,34 @@
+import type { Diagnostic } from "../model/diagnostics.js";
+import { type TargetCalendarValue } from "../model/target-calendar.js";
+import { type DeclaredGovernance, type EffectiveGovernance } from "../governance/source.js";
+import type { TargetGrammar4Capability, TargetGrammar5Capability } from "../parser/document-parser.js";
+import { type TargetValidationOptions } from "../semantic/target-validator.js";
+import type { ProjectMetadataDurationUnit } from "./project.js";
+export interface TargetGovernanceProjectMetadata {
+    readonly id: string;
+    readonly version: 1 | 2 | 3 | 4 | 5;
+    readonly title: string;
+    readonly description: string | null;
+    readonly asOf: TargetCalendarValue | null;
+    readonly durationUnit: ProjectMetadataDurationUnit;
+    readonly velocity: string | null;
+    readonly finish: string;
+    readonly finishDeadline: TargetCalendarValue | null;
+    readonly governance: {
+        readonly sourceContractVersion: 1;
+        readonly declared: DeclaredGovernance;
+        readonly effective: EffectiveGovernance;
+    };
+    readonly criticalEpsilon: string | null;
+    readonly targetDuration: string | null;
+}
+export interface TargetGovernanceProjectMetadataResult {
+    readonly ok: boolean;
+    readonly documentId: string | null;
+    readonly grammarVersion: 1 | 2 | 3 | 4 | 5 | null;
+    readonly project: TargetGovernanceProjectMetadata | null;
+    readonly diagnostics: readonly Diagnostic[];
+    readonly diagnosticsTruncated: boolean;
+}
+export declare function getTargetGovernanceProjectMetadata(text: string, capability: TargetGrammar4Capability | TargetGrammar5Capability, options?: TargetValidationOptions): TargetGovernanceProjectMetadataResult;
+//# sourceMappingURL=target-governance-project.d.ts.map

package/dist/application/target-governance-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-governance-project.d.ts","sourceRoot":"","sources":["../../src/application/target-governance-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,2BAA2B,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,qBAAqB,EAAE,CAAC,CAAC;QAClC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;QACtC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;KACzC,CAAC;IACF,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,+BAA+B,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAcD,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,wBAAwB,GAAG,wBAAwB,EAC/D,OAAO,GAAE,uBAA4B,GACpC,qCAAqC,CAmFvC"}

package/dist/application/target-governance-project.js

@@ -0,0 +1,82 @@
+import { fieldNamed } from "../model/syntax.js";
+import { projectDeclaredCalendarValue, } from "../model/target-calendar.js";
+import { governanceMetadataFromDocument, } from "../governance/source.js";
+import { validateTargetGrammar4Document, validateTargetGrammar5Document, } from "../semantic/target-validator.js";
+function optionalString(value) {
+    return typeof value === "string" ? value : null;
+}
+function optionalLiteral(value) {
+    return value !== null &&
+        typeof value === "object" &&
+        typeof value.text === "string"
+        ? value.text
+        : null;
+}
+export function getTargetGovernanceProjectMetadata(text, capability, options = {}) {
+    const checked = capability.grammarVersion === 5
+        ? validateTargetGrammar5Document(text, capability, options)
+        : validateTargetGrammar4Document(text, capability, options);
+    const declaration = checked.validatedDocument?.document.declarations.find(({ kind }) => kind === "project");
+    if (!checked.ok ||
+        checked.validatedDocument === null ||
+        declaration === undefined) {
+        return {
+            ok: false,
+            documentId: checked.documentId,
+            grammarVersion: null,
+            project: null,
+            diagnostics: checked.diagnostics,
+            diagnosticsTruncated: checked.diagnosticsTruncated,
+        };
+    }
+    const title = fieldNamed(declaration, "title")?.value;
+    const durationUnit = fieldNamed(declaration, "duration_unit")?.value;
+    const finish = fieldNamed(declaration, "finish")?.value;
+    if (typeof title !== "string" ||
+        (durationUnit !== "day" &&
+            durationUnit !== "hour" &&
+            durationUnit !== "point") ||
+        typeof finish !== "string") {
+        throw new Error("valid target project document is missing required metadata");
+    }
+    const asOfField = fieldNamed(declaration, "as_of");
+    const asOf = asOfField === undefined
+        ? null
+        : projectDeclaredCalendarValue(asOfField.value);
+    const finishDeclaration = checked.validatedDocument.document.declarations.find(({ kind, id }) => kind === "milestone" && id === finish);
+    const finishDeadlineField = finishDeclaration === undefined
+        ? undefined
+        : fieldNamed(finishDeclaration, "deadline");
+    const finishDeadline = finishDeadlineField === undefined
+        ? null
+        : projectDeclaredCalendarValue(finishDeadlineField.value);
+    if ((asOfField !== undefined && asOf === null) ||
+        (finishDeadlineField !== undefined && finishDeadline === null)) {
+        throw new Error("valid target project document has unprojectable calendar metadata");
+    }
+    return {
+        ok: true,
+        documentId: checked.documentId,
+        grammarVersion: checked.validatedDocument.grammarVersion,
+        project: Object.freeze({
+            id: declaration.id,
+            version: checked.validatedDocument.grammarVersion,
+            title,
+            description: optionalString(fieldNamed(declaration, "description")?.value),
+            asOf,
+            durationUnit,
+            velocity: optionalLiteral(fieldNamed(declaration, "velocity")?.value),
+            finish,
+            finishDeadline,
+            governance: Object.freeze({
+                sourceContractVersion: 1,
+                ...governanceMetadataFromDocument(checked.validatedDocument.document),
+            }),
+            criticalEpsilon: optionalLiteral(fieldNamed(declaration, "critical_epsilon")?.value),
+            targetDuration: optionalLiteral(fieldNamed(declaration, "target_duration")?.value),
+        }),
+        diagnostics: checked.diagnostics,
+        diagnosticsTruncated: checked.diagnosticsTruncated,
+    };
+}
+//# sourceMappingURL=target-governance-project.js.map

package/dist/application/target-governance-project.js.map

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

package/dist/application/target-governance-projection.d.ts

@@ -0,0 +1,18 @@
+import type { TargetGovernanceProjectMetadata, TargetGovernanceProjectMetadataResult } from "./target-governance-project.js";
+import type { TargetGovernanceAdvanceResultV2, TargetGovernanceMutationResultV2 } from "./target-governance-mutation.js";
+import type { GovernanceDecisionV1 } from "../governance/types.js";
+export declare const TARGET_GOVERNANCE_CLI_CONTRACT_VERSION: 5;
+export declare const TARGET_GOVERNANCE_PROJECT_RESULT_SCHEMA_VERSION: "Perttool.ProjectResult.v3";
+export declare const TARGET_GOVERNANCE_MUTATION_RESULT_SCHEMA_VERSION: "Perttool.MutationResult.v2";
+export interface TargetGovernanceWriteProjection {
+    readonly mode: "preview" | "in_place" | "out";
+    readonly target: string | null;
+    readonly written: boolean;
+}
+export declare const TARGET_GOVERNANCE_PREVIEW_WRITE: TargetGovernanceWriteProjection;
+export declare function targetGovernanceProjectResultToJson(result: TargetGovernanceProjectMetadataResult, source: string, sourceDigest: string, ok?: boolean): Readonly<Record<string, unknown>>;
+export declare function renderTargetGovernanceProjectText(project: TargetGovernanceProjectMetadata): string;
+export declare function targetGovernanceDecisionToJson(decision: GovernanceDecisionV1): Readonly<Record<string, unknown>>;
+export declare function targetGovernanceMutationResultToJson(result: TargetGovernanceMutationResultV2 | TargetGovernanceAdvanceResultV2, operation: string, source: string, write?: TargetGovernanceWriteProjection): Readonly<Record<string, unknown>>;
+export declare function renderTargetGovernanceDecision(decision: GovernanceDecisionV1): string;
+//# sourceMappingURL=target-governance-projection.d.ts.map

package/dist/application/target-governance-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-governance-projection.d.ts","sourceRoot":"","sources":["../../src/application/target-governance-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,+BAA+B,EAC/B,qCAAqC,EACtC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,+BAA+B,EAC/B,gCAAgC,EACjC,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,wBAAwB,CAAC;AAMhC,eAAO,MAAM,sCAAsC,EAAG,CAAU,CAAC;AACjE,eAAO,MAAM,+CAA+C,EAC1D,2BAAoC,CAAC;AACvC,eAAO,MAAM,gDAAgD,EAC3D,4BAAqC,CAAC;AAExC,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,+BAA+B,EAAE,+BAK1C,CAAC;AA8GL,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,qCAAqC,EAC7C,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,EAAE,UAAY,GACb,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAenC;AAgBD,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,+BAA+B,GACvC,MAAM,CAqBR;AAiBD,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,oBAAoB,GAC7B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkBnC;AA+CD,wBAAgB,oCAAoC,CAClD,MAAM,EACF,gCAAgC,GAChC,+BAA+B,EACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,+BAC0B,GAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAqBnC;AAMD,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,oBAAoB,GAC7B,MAAM,CAUR"}