perttool 0.4.0 → 0.5.1

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

@@ -0,0 +1,112 @@
+import { type ActualsCoverage } from "../actuals/lifecycle.js";
+import { type Diagnostic } from "../model/diagnostics.js";
+import type { WorkEventKind } from "../model/syntax.js";
+import { type TargetCalendarValue } from "../model/target-calendar.js";
+import type { GitHistoryProbeResult } from "./git-probe.js";
+import type { TargetGrammar5Capability } from "../parser/document-parser.js";
+export declare const PROJECT_HISTORY_MODEL_VERSION: 1;
+export type ProjectHistoryStatus = "complete" | "incomplete" | "unavailable";
+export type ProjectHistoryCauseId = "no_repository" | "no_head" | "unknown_revision" | "untracked_target" | "ambiguous_path" | "shallow_boundary" | "unsupported_rename" | "unsupported_source_version" | "task_identity_replaced" | "event_payload_changed" | "duplicate_event_identity" | "head_changed" | "target_changed";
+export type ActualsCauseId = "missing_start" | "missing_finish" | "open_suspension" | "missing_baseline" | "active_time_absent" | "effort_absent" | "history_incomplete" | "history_unavailable";
+export type RecordedTaskState = "absent" | "planned" | "active" | "blocked" | "suspended" | "done";
+export interface HistoryRequest {
+    readonly taskIds?: readonly string[];
+}
+export interface ProjectHistoryCause {
+    readonly cause: ProjectHistoryCauseId;
+    readonly commitId: string | null;
+    readonly taskId: string | null;
+    readonly eventId: string | null;
+}
+export interface ActualsCause {
+    readonly cause: ActualsCauseId;
+    readonly commitId: string | null;
+    readonly taskId: string | null;
+    readonly eventId: string | null;
+}
+export type ActualQuantityUnit = "day" | "hour" | "point" | "person_hour";
+export interface ActualQuantity {
+    readonly numerator: string;
+    readonly denominator: string;
+    readonly unit: ActualQuantityUnit;
+    readonly display: string;
+}
+export interface WorkEventProjection {
+    readonly modelVersion: 1;
+    readonly id: string;
+    readonly taskId: string;
+    readonly kind: WorkEventKind;
+    readonly occurredAt: TargetCalendarValue;
+    readonly plannedValue: ActualQuantity | null;
+    readonly activeTime: ActualQuantity | null;
+    readonly effort: ActualQuantity | null;
+    readonly reason: string | null;
+}
+export interface WorkEventHistory {
+    readonly event: WorkEventProjection;
+    readonly evidenceClass: "declared_actual";
+    readonly firstSeenCommitId: string;
+    readonly lastSeenCommitId: string;
+    readonly removalCommitId: string | null;
+    readonly payloadDigest: string;
+}
+export interface GitRecordedTransition {
+    readonly taskId: string;
+    readonly fromState: RecordedTaskState;
+    readonly toState: RecordedTaskState;
+    readonly commitId: string;
+    readonly recordedAt: TargetCalendarValue | null;
+    readonly sourceDigest: string;
+    readonly evidenceClass: "git_recorded_transition";
+}
+export interface SuspensionInterval {
+    readonly suspendEventId: string;
+    readonly resumeEventId: string | null;
+    readonly start: TargetCalendarValue;
+    readonly finish: TargetCalendarValue | null;
+    readonly duration: ActualQuantity | null;
+}
+export interface TaskActualSummary {
+    readonly taskId: string;
+    readonly coverage: ActualsCoverage;
+    readonly eventIds: readonly string[];
+    readonly firstStart: TargetCalendarValue | null;
+    readonly lastFinish: TargetCalendarValue | null;
+    readonly suspensionIntervals: readonly SuspensionInterval[];
+    readonly cycleTime: ActualQuantity | null;
+    readonly derivedActiveTime: ActualQuantity | null;
+    readonly explicitActiveTime: ActualQuantity | null;
+    readonly effort: ActualQuantity | null;
+    readonly plannedValue: ActualQuantity | null;
+    readonly baselineSource: "start_baseline" | "finish_snapshot" | null;
+    readonly baselineEventId: string | null;
+    readonly baselineCommitId: string | null;
+    readonly qualifiers: readonly string[];
+    readonly unavailableCauses: readonly ActualsCause[];
+}
+export interface ProjectHistoryMetadata {
+    readonly id: "perttool.project-history";
+    readonly version: 1;
+    readonly status: ProjectHistoryStatus;
+    readonly traversal: "first_parent";
+    readonly repositorySnapshotId: string | null;
+    readonly repositoryRelativePath: string | null;
+    readonly requestedRevision: string;
+    readonly resolvedRevision: string | null;
+    readonly sourceDigest: string | null;
+    readonly inspectedCommitIds: readonly string[];
+    readonly unavailableCauses: readonly ProjectHistoryCause[];
+}
+export interface ProjectHistoryCoreResult {
+    readonly ok: boolean;
+    readonly modelVersion: typeof PROJECT_HISTORY_MODEL_VERSION;
+    readonly documentId: string | null;
+    readonly grammarVersion: 1 | 2 | 3 | 4 | 5 | null;
+    readonly history: ProjectHistoryMetadata;
+    readonly events: readonly WorkEventHistory[];
+    readonly gitRecordedTransitions: readonly GitRecordedTransition[];
+    readonly tasks: readonly TaskActualSummary[];
+    readonly diagnostics: readonly Diagnostic[];
+}
+export declare function inspectProjectHistory(probe: GitHistoryProbeResult, request: HistoryRequest, capability: TargetGrammar5Capability): ProjectHistoryCoreResult;
+//# sourceMappingURL=project-history.d.ts.map

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

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