pulseed 0.5.4 → 0.6.0

package/dist/runtime/store/postmortem-report.d.ts

@@ -0,0 +1,485 @@
+import { z } from "zod";
+import { type RuntimeStorePaths } from "./runtime-paths.js";
+export declare const RuntimePostmortemScopeSchema: z.ZodEffects<z.ZodObject<{
+    goal_id: z.ZodOptional<z.ZodString>;
+    run_id: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    goal_id?: string | undefined;
+    run_id?: string | undefined;
+}, {
+    goal_id?: string | undefined;
+    run_id?: string | undefined;
+}>, {
+    goal_id?: string | undefined;
+    run_id?: string | undefined;
+}, {
+    goal_id?: string | undefined;
+    run_id?: string | undefined;
+}>;
+export type RuntimePostmortemScope = z.infer<typeof RuntimePostmortemScopeSchema>;
+export declare const RuntimePostmortemEvidenceRefSchema: z.ZodObject<{
+    kind: z.ZodString;
+    ref: z.ZodString;
+    observed_at: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: string;
+    ref: string;
+    observed_at?: string | undefined;
+    summary?: string | undefined;
+}, {
+    kind: string;
+    ref: string;
+    observed_at?: string | undefined;
+    summary?: string | undefined;
+}>;
+export type RuntimePostmortemEvidenceRef = z.infer<typeof RuntimePostmortemEvidenceRefSchema>;
+export declare const RuntimePostmortemReportSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<"runtime-postmortem-v1">;
+    postmortem_id: z.ZodString;
+    generated_at: z.ZodString;
+    scope: z.ZodEffects<z.ZodObject<{
+        goal_id: z.ZodOptional<z.ZodString>;
+        run_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        goal_id?: string | undefined;
+        run_id?: string | undefined;
+    }, {
+        goal_id?: string | undefined;
+        run_id?: string | undefined;
+    }>, {
+        goal_id?: string | undefined;
+        run_id?: string | undefined;
+    }, {
+        goal_id?: string | undefined;
+        run_id?: string | undefined;
+    }>;
+    final_status: z.ZodString;
+    trigger: z.ZodEnum<["completion", "pause", "finalization", "operator_request"]>;
+    artifact_paths: z.ZodObject<{
+        json_path: z.ZodString;
+        markdown_path: z.ZodString;
+        state_relative_json_path: z.ZodString;
+        state_relative_markdown_path: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        json_path: string;
+        markdown_path: string;
+        state_relative_json_path: string;
+        state_relative_markdown_path: string;
+    }, {
+        json_path: string;
+        markdown_path: string;
+        state_relative_json_path: string;
+        state_relative_markdown_path: string;
+    }>;
+    timeline: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        occurred_at: z.ZodString;
+        kind: z.ZodString;
+        summary: z.ZodString;
+        evidence_refs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            ref: z.ZodString;
+            observed_at: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }, {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        kind: string;
+        summary: string;
+        occurred_at: string;
+        evidence_refs: {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }[];
+    }, {
+        kind: string;
+        summary: string;
+        occurred_at: string;
+        evidence_refs?: {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }[] | undefined;
+    }>, "many">>;
+    metric_timeline: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        metric_key: z.ZodString;
+        direction: z.ZodEnum<["maximize", "minimize"]>;
+        trend: z.ZodString;
+        latest_value: z.ZodNumber;
+        best_value: z.ZodNumber;
+        observation_count: z.ZodNumber;
+        source_refs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            ref: z.ZodString;
+            observed_at: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }, {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }>, "many">>;
+        summary: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        direction: "maximize" | "minimize";
+        summary: string;
+        trend: string;
+        observation_count: number;
+        source_refs: {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }[];
+        metric_key: string;
+        latest_value: number;
+        best_value: number;
+    }, {
+        direction: "maximize" | "minimize";
+        summary: string;
+        trend: string;
+        observation_count: number;
+        metric_key: string;
+        latest_value: number;
+        best_value: number;
+        source_refs?: {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }[] | undefined;
+    }>, "many">>;
+    candidate_decisions: z.ZodObject<{
+        lineages: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+        selection_summary: z.ZodUnknown;
+        recommended_portfolio: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+        near_misses: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+        failed_lineages: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        lineages: unknown[];
+        recommended_portfolio: unknown[];
+        near_misses: unknown[];
+        failed_lineages: unknown[];
+        selection_summary?: unknown;
+    }, {
+        lineages?: unknown[] | undefined;
+        selection_summary?: unknown;
+        recommended_portfolio?: unknown[] | undefined;
+        near_misses?: unknown[] | undefined;
+        failed_lineages?: unknown[] | undefined;
+    }>;
+    final_outputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        state_relative_path: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        kind: z.ZodOptional<z.ZodString>;
+        retention_class: z.ZodOptional<z.ZodString>;
+        evidence_entry_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        manifest_id: z.ZodOptional<z.ZodString>;
+        sha256: z.ZodOptional<z.ZodString>;
+        observed_at: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        evidence_entry_ids: string[];
+        path?: string | undefined;
+        kind?: string | undefined;
+        observed_at?: string | undefined;
+        url?: string | undefined;
+        sha256?: string | undefined;
+        state_relative_path?: string | undefined;
+        retention_class?: string | undefined;
+        manifest_id?: string | undefined;
+    }, {
+        label: string;
+        path?: string | undefined;
+        kind?: string | undefined;
+        observed_at?: string | undefined;
+        url?: string | undefined;
+        sha256?: string | undefined;
+        state_relative_path?: string | undefined;
+        retention_class?: string | undefined;
+        manifest_id?: string | undefined;
+        evidence_entry_ids?: string[] | undefined;
+    }>, "many">>;
+    evaluator_gaps: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+    handoffs: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+    manifests: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+    budgets: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+    experiment_queues: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+    follow_up_actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        rationale: z.ZodString;
+        evidence_refs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            ref: z.ZodString;
+            observed_at: z.ZodOptional<z.ZodString>;
+            summary: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }, {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }>, "many">>;
+        approval_required: z.ZodDefault<z.ZodBoolean>;
+        auto_create: z.ZodDefault<z.ZodLiteral<false>>;
+    }, "strict", z.ZodTypeAny, {
+        approval_required: boolean;
+        title: string;
+        rationale: string;
+        evidence_refs: {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }[];
+        auto_create: false;
+    }, {
+        title: string;
+        rationale: string;
+        approval_required?: boolean | undefined;
+        evidence_refs?: {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }[] | undefined;
+        auto_create?: false | undefined;
+    }>, "many">>;
+    evidence_refs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        ref: z.ZodString;
+        observed_at: z.ZodOptional<z.ZodString>;
+        summary: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        kind: string;
+        ref: string;
+        observed_at?: string | undefined;
+        summary?: string | undefined;
+    }, {
+        kind: string;
+        ref: string;
+        observed_at?: string | undefined;
+        summary?: string | undefined;
+    }>, "many">>;
+    warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    trigger: "finalization" | "pause" | "completion" | "operator_request";
+    generated_at: string;
+    schema_version: "runtime-postmortem-v1";
+    budgets: unknown[];
+    scope: {
+        goal_id?: string | undefined;
+        run_id?: string | undefined;
+    };
+    evidence_refs: {
+        kind: string;
+        ref: string;
+        observed_at?: string | undefined;
+        summary?: string | undefined;
+    }[];
+    warnings: string[];
+    manifests: unknown[];
+    timeline: {
+        kind: string;
+        summary: string;
+        occurred_at: string;
+        evidence_refs: {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }[];
+    }[];
+    postmortem_id: string;
+    final_status: string;
+    artifact_paths: {
+        json_path: string;
+        markdown_path: string;
+        state_relative_json_path: string;
+        state_relative_markdown_path: string;
+    };
+    metric_timeline: {
+        direction: "maximize" | "minimize";
+        summary: string;
+        trend: string;
+        observation_count: number;
+        source_refs: {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }[];
+        metric_key: string;
+        latest_value: number;
+        best_value: number;
+    }[];
+    candidate_decisions: {
+        lineages: unknown[];
+        recommended_portfolio: unknown[];
+        near_misses: unknown[];
+        failed_lineages: unknown[];
+        selection_summary?: unknown;
+    };
+    final_outputs: {
+        label: string;
+        evidence_entry_ids: string[];
+        path?: string | undefined;
+        kind?: string | undefined;
+        observed_at?: string | undefined;
+        url?: string | undefined;
+        sha256?: string | undefined;
+        state_relative_path?: string | undefined;
+        retention_class?: string | undefined;
+        manifest_id?: string | undefined;
+    }[];
+    evaluator_gaps: unknown[];
+    handoffs: unknown[];
+    experiment_queues: unknown[];
+    follow_up_actions: {
+        approval_required: boolean;
+        title: string;
+        rationale: string;
+        evidence_refs: {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }[];
+        auto_create: false;
+    }[];
+}, {
+    trigger: "finalization" | "pause" | "completion" | "operator_request";
+    generated_at: string;
+    schema_version: "runtime-postmortem-v1";
+    scope: {
+        goal_id?: string | undefined;
+        run_id?: string | undefined;
+    };
+    postmortem_id: string;
+    final_status: string;
+    artifact_paths: {
+        json_path: string;
+        markdown_path: string;
+        state_relative_json_path: string;
+        state_relative_markdown_path: string;
+    };
+    candidate_decisions: {
+        lineages?: unknown[] | undefined;
+        selection_summary?: unknown;
+        recommended_portfolio?: unknown[] | undefined;
+        near_misses?: unknown[] | undefined;
+        failed_lineages?: unknown[] | undefined;
+    };
+    budgets?: unknown[] | undefined;
+    evidence_refs?: {
+        kind: string;
+        ref: string;
+        observed_at?: string | undefined;
+        summary?: string | undefined;
+    }[] | undefined;
+    warnings?: string[] | undefined;
+    manifests?: unknown[] | undefined;
+    timeline?: {
+        kind: string;
+        summary: string;
+        occurred_at: string;
+        evidence_refs?: {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    metric_timeline?: {
+        direction: "maximize" | "minimize";
+        summary: string;
+        trend: string;
+        observation_count: number;
+        metric_key: string;
+        latest_value: number;
+        best_value: number;
+        source_refs?: {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    final_outputs?: {
+        label: string;
+        path?: string | undefined;
+        kind?: string | undefined;
+        observed_at?: string | undefined;
+        url?: string | undefined;
+        sha256?: string | undefined;
+        state_relative_path?: string | undefined;
+        retention_class?: string | undefined;
+        manifest_id?: string | undefined;
+        evidence_entry_ids?: string[] | undefined;
+    }[] | undefined;
+    evaluator_gaps?: unknown[] | undefined;
+    handoffs?: unknown[] | undefined;
+    experiment_queues?: unknown[] | undefined;
+    follow_up_actions?: {
+        title: string;
+        rationale: string;
+        approval_required?: boolean | undefined;
+        evidence_refs?: {
+            kind: string;
+            ref: string;
+            observed_at?: string | undefined;
+            summary?: string | undefined;
+        }[] | undefined;
+        auto_create?: false | undefined;
+    }[] | undefined;
+}>;
+export type RuntimePostmortemReport = z.infer<typeof RuntimePostmortemReportSchema>;
+export interface RuntimePostmortemGenerateInput {
+    goalId?: string;
+    runId?: string;
+    finalStatus?: string;
+    trigger?: RuntimePostmortemReport["trigger"];
+}
+export declare class RuntimePostmortemReportStore {
+    private readonly paths;
+    constructor(runtimeRootOrPaths?: string | RuntimeStorePaths);
+    generate(input: RuntimePostmortemGenerateInput): Promise<RuntimePostmortemReport>;
+    load(postmortemId: string): Promise<RuntimePostmortemReport | null>;
+    latestFor(input: {
+        goalId?: string;
+        runId?: string;
+    }): Promise<RuntimePostmortemReport | null>;
+    markdownFor(report: RuntimePostmortemReport): string;
+    private readEvidence;
+    private readManifests;
+    private readHandoffs;
+    private readBudgets;
+    private readExperimentQueues;
+    private reportPaths;
+    private writeReport;
+    private appendEvidenceEntry;
+}
+//# sourceMappingURL=postmortem-report.d.ts.map

package/dist/runtime/store/postmortem-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postmortem-report.d.ts","sourceRoot":"","sources":["../../../src/runtime/store/postmortem-report.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAe5B,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;EAKvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;EAKpC,CAAC;AACZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAE9F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8D/B,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,MAAM,WAAW,8BAA8B;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;CAC9C;AAED,qBAAa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;gBAE9B,kBAAkB,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAMrD,QAAQ,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAwDjF,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAUnE,SAAS,CAAC,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAQpG,WAAW,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM;YAItC,YAAY;YAkBZ,aAAa;YAuBb,YAAY;YAMZ,WAAW;YAMX,oBAAoB;IAMlC,OAAO,CAAC,WAAW;YAUL,WAAW;YAQX,mBAAmB;CAmClC"}