@bluewombat/runtime 0.10.0 → 0.11.1

package/dist/operator/incident-dossier.d.ts

@@ -0,0 +1,154 @@
+import type { FeatureAggregate, TicketAggregate } from "@bluewombat/work-ledger";
+import type { HostInvocation } from "../config/types.js";
+import type { SystemFacts } from "./incident-system.js";
+/**
+ * What `mason incident` hands to whoever has to understand a stop.
+ *
+ * The WorkLedger says that something stopped and, in a sentence, why. The
+ * journal says who answered what, in order. The streams and transcripts hold
+ * what the checks and the agents said. Reading all of them to find one stop is
+ * the work this does once, with no judgement: it never decides why the work
+ * stopped, it puts the facts side by side and says which ones it could not find.
+ */
+export declare const INCIDENT_SCHEMA = "bluewombat.incident/1";
+/** `none`: the subject is not stopped, and the page shows its last refusal if it had one. */
+export type Layer = "unit" | "assembly" | "submitted" | "merging" | "feature" | "none" | "unknown";
+export type TicketRow = {
+    key: string;
+    title?: string;
+    state: string;
+    attempts_used: number;
+    reference?: string;
+    featureTest?: boolean;
+    blocked_by?: string[];
+    done_at?: string;
+    escalation?: {
+        kind: string;
+        report?: string;
+    };
+};
+export type TimelineRow = {
+    at: string;
+    event: string;
+    id?: string;
+    attempt?: number;
+    gate_id?: string;
+    verdict?: string;
+    detail?: string;
+};
+export type StreamRow = {
+    path: string;
+    id?: string;
+    gate_id?: string;
+    attempt?: number;
+    bytes?: number;
+    exists: boolean;
+    /** The end of what the stream said, for the check that refused. */
+    excerpt?: string;
+};
+export type TranscriptRow = {
+    path: string;
+    title?: string;
+    slot?: string;
+    started?: string;
+    ended?: string;
+    duration?: string;
+    exit?: string;
+    /** `MASON_VERDICT:` or `MASON_BLOCKED:` line, when the agent ended on one. */
+    marker?: string;
+    /** The end of what the agent said. */
+    final_message?: string;
+};
+export type GateConfigRow = {
+    section: string;
+    id: string;
+    argv: string[];
+    timeoutMs?: number;
+    skipWhen?: string;
+};
+export type Dossier = {
+    schema: typeof INCIDENT_SCHEMA;
+    generated_at: string;
+    subject: {
+        key: string;
+        kind: "ticket" | "feature";
+        project: string;
+        title?: string;
+        state: string;
+        source?: string;
+        /** The first lines of what was asked. */
+        intention: string;
+        blocked_by?: string[];
+    };
+    stop: {
+        layer: Layer;
+        /** In the ledger's own words. */
+        report?: string;
+        /** What refused it: a Gate's id or a role, as the ledger or the journal named it. */
+        refused_by?: string;
+        at?: string;
+        id?: string;
+        attempt?: number;
+        gate?: {
+            id: string;
+            verdict: string;
+            report: string;
+            at: string;
+        };
+        agent?: {
+            id: string;
+            attempt?: number;
+            failure: string;
+            at: string;
+        };
+        /** Where each field above came from, so a reader knows what to trust. */
+        sources: string[];
+    };
+    history: {
+        /** Earlier stops of this subject, then this one, in the journal. */
+        escalations: number;
+        resumes: number;
+    };
+    budgets: {
+        attempts_used?: number;
+        refusals?: number;
+        parked_refusals?: number;
+        realigns?: number;
+    };
+    parent?: {
+        key: string;
+        kind: "feature";
+        state: string;
+        title?: string;
+        tickets: TicketRow[];
+    };
+    tickets?: TicketRow[];
+    gate_config?: GateConfigRow[];
+    /** Versions, and what the configuration switched on. */
+    system?: SystemFacts;
+    timeline: TimelineRow[];
+    artifacts: {
+        streams: StreamRow[];
+        transcripts: TranscriptRow[];
+    };
+    /** What could not be found. A reader must not read an absence as a "no". */
+    gaps: string[];
+};
+export type JournalLine = Record<string, unknown>;
+export type DossierInput = {
+    subject: TicketAggregate | FeatureAggregate;
+    /** The Tickets of a Feature, or of the Feature a Ticket belongs to. */
+    tickets: TicketAggregate[];
+    parent?: FeatureAggregate;
+    journal: JournalLine[];
+    invocation?: HostInvocation;
+    streamsDir?: string;
+    transcriptsDir?: string;
+    system?: SystemFacts;
+    now: Date;
+};
+export declare function isFeature(subject: TicketAggregate | FeatureAggregate): subject is FeatureAggregate;
+export declare function buildDossier(input: DossierInput): Dossier;
+/** The dossier as a page to read: the facts first, the detail after. */
+export declare function renderDossier(dossier: Dossier): string;
+//# sourceMappingURL=incident-dossier.d.ts.map

package/dist/operator/incident-dossier.d.ts.map

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