perttool 0.4.0 → 0.5.1

package/dist/application/target-actuals-analysis.js

@@ -0,0 +1,250 @@
+import { createHash } from "node:crypto";
+import { projectActualsSourceModel, workEventsForTask, } from "../actuals/source.js";
+import { reduceTaskLifecycle, taskStatus, validateStoredLifecycleState, } from "../actuals/lifecycle.js";
+import { evaluateTemporalDeadlines, } from "../analysis/temporal-deadline.js";
+import { analyzeTemporalPrecedenceSchedule, } from "../analysis/temporal-precedence.js";
+import { analyzeTemporalResourceSchedule, } from "../analysis/temporal-resource.js";
+import { compareStableStrings, limitDiagnostics, normalizeMaxDiagnostics, sortDiagnostics, } from "../model/diagnostics.js";
+import { validateTargetGrammar5Document, } from "../semantic/target-validator.js";
+import { analyzeValidatedDocument, } from "./analyze.js";
+import { selectNextTasksFromAnalysis, } from "./next.js";
+import { projectTargetNextTemporalTasks, projectTargetTemporalSchedule, TARGET_TEMPORAL_INTERFACE_IDENTITY, } from "./target-temporal-analysis.js";
+import { projectTargetTemporalInputs, } from "./target-temporal-input.js";
+export const TARGET_ACTUALS_ANALYSIS_RESULT_SCHEMA_VERSION = "Perttool.AnalysisResult.v4";
+export const TARGET_ACTUALS_NEXT_RESULT_SCHEMA_VERSION = "Perttool.NextResult.v5";
+function failure(checked, additionalDiagnostics = [], maximum = normalizeMaxDiagnostics(undefined)) {
+    const limited = limitDiagnostics(sortDiagnostics([...checked.diagnostics, ...additionalDiagnostics]), maximum);
+    return Object.freeze({
+        schemaVersion: TARGET_ACTUALS_ANALYSIS_RESULT_SCHEMA_VERSION,
+        ok: false,
+        documentId: checked.documentId,
+        grammarVersion: checked.grammarVersion,
+        base: null,
+        taskActuals: Object.freeze([]),
+        precedence: null,
+        resource: null,
+        temporal: null,
+        diagnostics: limited.diagnostics,
+        diagnosticsTruncated: checked.diagnosticsTruncated || limited.truncated,
+    });
+}
+function projectField(field, statusProjection) {
+    return field.name !== "status" || field.value !== "suspended"
+        ? field
+        : Object.freeze({
+            ...field,
+            rawValue: statusProjection,
+            value: statusProjection,
+        });
+}
+function projectTask(declaration, statusProjection) {
+    return Object.freeze({
+        ...declaration,
+        kind: declaration.kind,
+        fields: Object.freeze(declaration.fields.map((field) => projectField(field, statusProjection))),
+    });
+}
+function projectAnalysisDocument(validated, statusProjection) {
+    return Object.freeze({
+        text: validated.document.text,
+        declarations: Object.freeze(validated.document.declarations
+            .filter(({ kind }) => kind !== "work_event")
+            .map((declaration) => projectTask(declaration, statusProjection))),
+        trivia: validated.document.trivia,
+    });
+}
+function projectValidatedDocument(validated, statusProjection) {
+    return Object.freeze({
+        ...validated,
+        document: projectAnalysisDocument(validated, statusProjection),
+    });
+}
+function taskActuals(validated) {
+    const model = projectActualsSourceModel(validated);
+    return Object.freeze(validated.document.declarations
+        .filter(({ kind }) => kind === "task")
+        .sort((left, right) => compareStableStrings(left.id, right.id))
+        .map((task) => {
+        const reduction = reduceTaskLifecycle(workEventsForTask(model, task.id));
+        if (!reduction.ok) {
+            throw new Error(`validated lifecycle reduction failed for ${task.id}`);
+        }
+        return Object.freeze({
+            taskId: task.id,
+            status: taskStatus(task),
+            coverage: reduction.coverage,
+        });
+    }));
+}
+function suspensionCondition(suspendedTaskIds) {
+    return Object.freeze({
+        conditionalOnSuspensionsResumed: suspendedTaskIds.length > 0,
+        suspendedTaskIds,
+    });
+}
+export function analyzeTargetActualsDocument(text, capability, options = {}) {
+    const maximum = normalizeMaxDiagnostics(options.maxDiagnostics);
+    const checked = validateTargetGrammar5Document(text, capability, { maxDiagnostics: maximum });
+    if (!checked.ok || checked.validatedDocument === null) {
+        return failure(checked, [], maximum);
+    }
+    const lifecycleDiagnostics = validateStoredLifecycleState(checked.validatedDocument);
+    if (lifecycleDiagnostics.length > 0) {
+        return failure(checked, lifecycleDiagnostics, maximum);
+    }
+    const suspendedTaskIds = Object.freeze(checked.validatedDocument.document.declarations
+        .filter((declaration) => declaration.kind === "task" &&
+        taskStatus(declaration) === "suspended")
+        .map(({ id }) => id)
+        .sort(compareStableStrings));
+    const condition = suspensionCondition(suspendedTaskIds);
+    const projected = projectValidatedDocument(checked.validatedDocument, "planned");
+    const base = analyzeValidatedDocument(projected.document, checked.documentId, checked.diagnostics, checked.diagnosticsTruncated, options);
+    if (!base.ok) {
+        return Object.freeze({
+            schemaVersion: TARGET_ACTUALS_ANALYSIS_RESULT_SCHEMA_VERSION,
+            ok: false,
+            documentId: checked.documentId,
+            grammarVersion: checked.grammarVersion,
+            base,
+            taskActuals: Object.freeze([]),
+            precedence: null,
+            resource: null,
+            temporal: null,
+            diagnostics: base.diagnostics,
+            diagnosticsTruncated: base.diagnosticsTruncated,
+        });
+    }
+    const inputs = projectTargetTemporalInputs(projected);
+    const temporalPrecedence = analyzeTemporalPrecedenceSchedule(projected, inputs);
+    const temporalResource = analyzeTemporalResourceSchedule(projected, inputs, {
+        ...(options.capacityOverrides === undefined
+            ? {}
+            : { capacityOverrides: options.capacityOverrides }),
+        ...(options.maxPaths === undefined
+            ? {}
+            : { maxPaths: options.maxPaths }),
+    });
+    const deadlineEvaluations = evaluateTemporalDeadlines(projected, inputs, temporalPrecedence, temporalResource);
+    const temporal = Object.freeze({
+        interface: TARGET_TEMPORAL_INTERFACE_IDENTITY,
+        calendar: inputs.calendar,
+        deadline: Object.freeze({
+            id: "perttool.deadline-evaluation",
+            version: 1,
+        }),
+        anchor: inputs.anchor,
+        precedence: Object.freeze({
+            ...projectTargetTemporalSchedule(projected, inputs, temporalPrecedence, "precedence"),
+            ...condition,
+        }),
+        resource: Object.freeze({
+            ...projectTargetTemporalSchedule(projected, inputs, temporalResource, "resource"),
+            ...condition,
+        }),
+        deadlineEvaluations: Object.freeze(deadlineEvaluations.map((evaluation) => Object.freeze({ ...evaluation, ...condition }))),
+    });
+    return Object.freeze({
+        schemaVersion: TARGET_ACTUALS_ANALYSIS_RESULT_SCHEMA_VERSION,
+        ok: true,
+        documentId: checked.documentId,
+        grammarVersion: checked.grammarVersion,
+        base,
+        taskActuals: taskActuals(checked.validatedDocument),
+        precedence: base.precedence === null
+            ? null
+            : Object.freeze({ ...base.precedence, ...condition }),
+        resource: base.resource === null
+            ? null
+            : Object.freeze({ ...base.resource, ...condition }),
+        temporal,
+        diagnostics: base.diagnostics,
+        diagnosticsTruncated: base.diagnosticsTruncated,
+    });
+}
+function digest(text) {
+    return `sha256:${createHash("sha256").update(text, "utf8").digest("hex")}`;
+}
+export function selectTargetActualsTasks(text, capability, options = {}) {
+    const analyzed = analyzeTargetActualsDocument(text, capability, options);
+    if (!analyzed.ok || analyzed.base === null || analyzed.temporal === null) {
+        return analyzed;
+    }
+    const checked = validateTargetGrammar5Document(text, capability, options);
+    if (!checked.ok || checked.validatedDocument === null) {
+        return failure(checked);
+    }
+    const suspendedTaskIds = analyzed.precedence?.suspendedTaskIds ??
+        analyzed.resource?.suspendedTaskIds ??
+        Object.freeze([]);
+    const suspended = new Set(suspendedTaskIds);
+    const classificationDocument = projectAnalysisDocument(checked.validatedDocument, "blocked");
+    const selected = selectNextTasksFromAnalysis(Object.freeze({
+        ...analyzed.base,
+        document: classificationDocument,
+    }), options.sourceDigest ?? digest(text), options);
+    if (!selected.ok || selected.recommendation === null) {
+        return Object.freeze({
+            ...analyzed,
+            ok: false,
+            diagnostics: selected.diagnostics,
+            diagnosticsTruncated: selected.diagnosticsTruncated,
+        });
+    }
+    const tasks = Object.freeze(selected.tasks.map((task) => suspended.has(task.id)
+        ? Object.freeze({
+            ...task,
+            status: "suspended",
+            classification: "suspended",
+            runnableNow: false,
+            resourceRejections: Object.freeze([]),
+        })
+        : task));
+    const ids = (classification) => tasks
+        .filter((task) => task.classification === classification)
+        .map(({ id }) => id);
+    const inputs = projectTargetTemporalInputs(checked.validatedDocument);
+    const temporalTasks = projectTargetNextTemporalTasks(checked.validatedDocument, inputs, analyzed.temporal);
+    const eligibilityById = new Map(temporalTasks.map((task) => [task.taskId, task.timeEligibility.state]));
+    const temporalIds = (state) => temporalTasks
+        .filter((task) => task.timeEligibility.state === state)
+        .map(({ taskId }) => taskId);
+    const recommended = selected.recommendation.recommendedTaskIds;
+    const recommendedFor = (state) => recommended.filter((id) => eligibilityById.get(id) === state);
+    return Object.freeze({
+        ...selected,
+        schemaVersion: TARGET_ACTUALS_NEXT_RESULT_SCHEMA_VERSION,
+        grammarVersion: checked.validatedDocument.grammarVersion,
+        document: checked.validatedDocument.document,
+        groups: Object.freeze({
+            active: ids("active"),
+            ready: ids("ready"),
+            runnableNow: tasks
+                .filter((task) => task.runnableNow &&
+                eligibilityById.get(task.id) === "eligible")
+                .map(({ id }) => id),
+            blockedNow: ids("blocked_now"),
+            upcoming: ids("upcoming"),
+            suspended: ids("suspended"),
+        }),
+        tasks,
+        temporal: Object.freeze({
+            authority: Object.freeze({
+                policy: "recommendation_v1_plus_release_gate",
+                recommendationAlgorithm: Object.freeze({
+                    id: selected.recommendation.algorithm.id,
+                    version: selected.recommendation.algorithm.version,
+                }),
+                deadlineFactsUsedForRanking: false,
+                timeEligibleTaskIds: Object.freeze(temporalIds("eligible")),
+                timeIneligibleTaskIds: Object.freeze(temporalIds("not_yet_eligible")),
+                timeEligibilityUnavailableTaskIds: Object.freeze(temporalIds("unavailable")),
+                startableRecommendedTaskIds: Object.freeze(recommendedFor("eligible")),
+                delayedRecommendedTaskIds: Object.freeze(recommendedFor("not_yet_eligible")),
+                unavailableRecommendedTaskIds: Object.freeze(recommendedFor("unavailable")),
+            }),
+            tasks: temporalTasks,
+        }),
+    });
+}
+//# sourceMappingURL=target-actuals-analysis.js.map

package/dist/application/target-actuals-analysis.js.map

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

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

@@ -0,0 +1,28 @@
+import { type ActualsCoverage, type FinishActualsMutation, type LifecycleMutation, type TaskLifecycleState } from "../actuals/lifecycle.js";
+import { type ActualWorkEvent } from "../actuals/source.js";
+import type { GovernanceDecisionV1, GovernanceRequestInput } from "../governance/types.js";
+import type { MutationOptions, MutationResult } from "../mutation/types.js";
+import type { TargetGrammar5Capability } from "../parser/document-parser.js";
+export interface TargetActualsMutationOptions extends MutationOptions {
+    readonly governance?: GovernanceRequestInput;
+}
+export interface ActualsLifecycleResult {
+    readonly modelVersion: 1;
+    readonly taskId: string;
+    readonly fromState: TaskLifecycleState;
+    readonly toState: "active" | "suspended" | "done";
+    readonly event: ActualWorkEvent;
+    readonly coverage: Exclude<ActualsCoverage, "unavailable" | "unrecorded">;
+}
+export type FinishActualsLifecycleResult = ActualsLifecycleResult & {
+    readonly toState: "done";
+    readonly coverage: Extract<ActualsCoverage, "complete" | "finish_only">;
+};
+export interface TargetActualsMutationResultV3 extends MutationResult {
+    readonly schemaVersion: "Perttool.MutationResult.v3";
+    readonly governance: GovernanceDecisionV1 | null;
+    readonly lifecycle: ActualsLifecycleResult | null;
+}
+export declare function planTargetLifecycleMutation(text: string, mutation: LifecycleMutation, capability: TargetGrammar5Capability, options?: TargetActualsMutationOptions): TargetActualsMutationResultV3;
+export declare function planTargetFinishActualsMutation(text: string, mutation: FinishActualsMutation, capability: TargetGrammar5Capability, options?: TargetActualsMutationOptions): TargetActualsMutationResultV3;
+//# sourceMappingURL=target-actuals-mutation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"target-actuals-mutation.d.ts","sourceRoot":"","sources":["../../src/application/target-actuals-mutation.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EAEtB,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAuChC,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AAMtC,MAAM,WAAW,4BAA6B,SAAQ,eAAe;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,sBAAsB,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,EAAE,aAAa,GAAG,YAAY,CAAC,CAAC;CAC3E;AAED,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,EAAE,UAAU,GAAG,aAAa,CAAC,CAAC;CACzE,CAAC;AAEF,MAAM,WAAW,6BAA8B,SAAQ,cAAc;IACnE,QAAQ,CAAC,aAAa,EAAE,4BAA4B,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAC;CACnD;AAueD,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,wBAAwB,EACpC,OAAO,GAAE,4BAAiC,GACzC,6BAA6B,CA4I/B;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,qBAAqB,EAC/B,UAAU,EAAE,wBAAwB,EACpC,OAAO,GAAE,4BAAiC,GACzC,6BAA6B,CAE/B"}