agent-bober 0.11.6 → 0.15.0

package/dist/incident/types.d.ts

@@ -0,0 +1,335 @@
+/**
+ * Incident artifact type definitions (Sprint 19).
+ *
+ * All types are derived from zod schemas via z.infer — never written by hand
+ * to avoid schema/type drift. Follow the pattern established in src/config/schema.ts.
+ *
+ * Schema locks (do NOT change without updating the corresponding skill):
+ * - ObservationEntry: 5 fields locked by skills/bober.diagnose/SKILL.md lines 74-82.
+ * - RunbookExecutionEntry: 7 camelCase fields locked by skills/bober.runbook/SKILL.md line 208.
+ * - ChangeEntry.inverse: REQUIRED at zod level (not optional) — Sprint 21 rollback
+ *   awareness depends on every change having an inverse declared at write time.
+ */
+import { z } from "zod";
+export type IncidentId = string;
+export declare const IncidentArtifactKindSchema: z.ZodEnum<["timeline", "observation", "hypothesis", "action", "change", "runbook-execution", "diagnosis", "postmortem"]>;
+export type IncidentArtifactKind = z.infer<typeof IncidentArtifactKindSchema>;
+export declare const TimelineEventSchema: z.ZodObject<{
+    /** ISO-8601 timestamp. */
+    timestamp: z.ZodString;
+    /** Machine-readable event kind, e.g. 'incident_created', 'action_taken'. */
+    eventKind: z.ZodString;
+    /** Which system produced this event. */
+    source: z.ZodEnum<["diagnoser", "deployer", "human", "observability", "system"]>;
+    /** Human-readable summary of what happened. */
+    summary: z.ZodString;
+    /** Optional relative path to the detail artifact (e.g. actions.jsonl). */
+    refPath: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source: "observability" | "human" | "diagnoser" | "deployer" | "system";
+    timestamp: string;
+    summary: string;
+    eventKind: string;
+    refPath?: string | undefined;
+}, {
+    source: "observability" | "human" | "diagnoser" | "deployer" | "system";
+    timestamp: string;
+    summary: string;
+    eventKind: string;
+    refPath?: string | undefined;
+}>;
+export type TimelineEvent = z.infer<typeof TimelineEventSchema>;
+export declare const ObservationEntrySchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    /** Diagnosis phase: 1–4. */
+    phase: z.ZodNumber;
+    observation: z.ZodString;
+    source: z.ZodString;
+    verified: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    timestamp: string;
+    phase: number;
+    observation: string;
+    verified: boolean;
+}, {
+    source: string;
+    timestamp: string;
+    phase: number;
+    observation: string;
+    verified: boolean;
+}>;
+export type ObservationEntry = z.infer<typeof ObservationEntrySchema>;
+export declare const ActionEntrySchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    action: z.ZodString;
+    blastRadius: z.ZodEnum<["safe", "risky"]>;
+    requiresApproval: z.ZodBoolean;
+    rationale: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    action: string;
+    blastRadius: "safe" | "risky";
+    requiresApproval: boolean;
+    rationale?: string | undefined;
+}, {
+    timestamp: string;
+    action: string;
+    blastRadius: "safe" | "risky";
+    requiresApproval: boolean;
+    rationale?: string | undefined;
+}>;
+export type ActionEntry = z.infer<typeof ActionEntrySchema>;
+export declare const ChangeEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    executedAt: z.ZodString;
+    description: z.ZodString;
+    /** REQUIRED. Describes how to undo this change. */
+    inverse: z.ZodObject<{
+        description: z.ZodString;
+        command: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        command?: string | undefined;
+    }, {
+        description: string;
+        command?: string | undefined;
+    }>;
+    status: z.ZodEnum<["pending", "executed", "rolled-back", "rolled-back-failed", "failed"]>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    status: "failed" | "pending" | "executed" | "rolled-back" | "rolled-back-failed";
+    description: string;
+    id: string;
+    executedAt: string;
+    inverse: {
+        description: string;
+        command?: string | undefined;
+    };
+}, {
+    type: string;
+    status: "failed" | "pending" | "executed" | "rolled-back" | "rolled-back-failed";
+    description: string;
+    id: string;
+    executedAt: string;
+    inverse: {
+        description: string;
+        command?: string | undefined;
+    };
+}>;
+export type ChangeEntry = z.infer<typeof ChangeEntrySchema>;
+export declare const RunbookExecutionEntrySchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    runbookName: z.ZodString;
+    stepNumber: z.ZodNumber;
+    status: z.ZodEnum<["precondition_failed", "checkpoint_rejected", "execution_failed", "postcondition_failed_no_rollback", "rollback_failed", "recovered_via_rollback", "success"]>;
+    preconditionResult: z.ZodEnum<["pass", "fail", "not_run"]>;
+    postconditionResult: z.ZodEnum<["pass", "fail", "not_run"]>;
+    rollbackTriggered: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    status: "success" | "precondition_failed" | "checkpoint_rejected" | "execution_failed" | "postcondition_failed_no_rollback" | "rollback_failed" | "recovered_via_rollback";
+    timestamp: string;
+    runbookName: string;
+    stepNumber: number;
+    preconditionResult: "pass" | "fail" | "not_run";
+    postconditionResult: "pass" | "fail" | "not_run";
+    rollbackTriggered?: boolean | undefined;
+}, {
+    status: "success" | "precondition_failed" | "checkpoint_rejected" | "execution_failed" | "postcondition_failed_no_rollback" | "rollback_failed" | "recovered_via_rollback";
+    timestamp: string;
+    runbookName: string;
+    stepNumber: number;
+    preconditionResult: "pass" | "fail" | "not_run";
+    postconditionResult: "pass" | "fail" | "not_run";
+    rollbackTriggered?: boolean | undefined;
+}>;
+export type RunbookExecutionEntry = z.infer<typeof RunbookExecutionEntrySchema>;
+export declare const IncidentStatusSchema: z.ZodEnum<["investigating", "remediating", "monitoring", "resolved", "aborted"]>;
+export type IncidentStatus = z.infer<typeof IncidentStatusSchema>;
+/**
+ * Allowed phase transitions for the incident state machine (Sprint 24).
+ * Keys are the FROM phase; values are the array of allowed TO phases.
+ *
+ * The re-open path (resolved → investigating) requires an explicit `reason`
+ * — see transitionPhase() in src/incident/orchestrator.ts.
+ *
+ * `aborted` is terminal: it appears as a value in many keys (any phase may
+ * abort) but never as a key — there are no transitions out of aborted.
+ */
+export declare const STATUS_TRANSITIONS: Readonly<Record<IncidentStatus, readonly IncidentStatus[]>>;
+/** Convenience alias — orchestrator.ts uses 'phase' nomenclature; storage uses 'status'. */
+export type IncidentPhase = IncidentStatus;
+/**
+ * Snapshot of the VerifyResult that authorized the 'resolved' transition.
+ * Either verified=true OR an overrideToken with a non-empty reason. Sprint 22.
+ */
+export declare const IncidentResolutionEvidenceSchema: z.ZodObject<{
+    verified: z.ZodBoolean;
+    observedValue: z.ZodOptional<z.ZodNumber>;
+    sampledAt: z.ZodOptional<z.ZodString>;
+    evidencePath: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    hint: z.ZodOptional<z.ZodString>;
+    /** Set when transition was authorized via overrideToken. */
+    override: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodString;
+        at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        reason: string;
+    }, {
+        at: string;
+        reason: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    verified: boolean;
+    reason?: string | undefined;
+    hint?: string | undefined;
+    observedValue?: number | undefined;
+    sampledAt?: string | undefined;
+    evidencePath?: string | undefined;
+    override?: {
+        at: string;
+        reason: string;
+    } | undefined;
+}, {
+    verified: boolean;
+    reason?: string | undefined;
+    hint?: string | undefined;
+    observedValue?: number | undefined;
+    sampledAt?: string | undefined;
+    evidencePath?: string | undefined;
+    override?: {
+        at: string;
+        reason: string;
+    } | undefined;
+}>;
+export type IncidentResolutionEvidence = z.infer<typeof IncidentResolutionEvidenceSchema>;
+export declare const IncidentMetadataSchema: z.ZodObject<{
+    incidentId: z.ZodString;
+    symptom: z.ZodString;
+    createdAt: z.ZodString;
+    status: z.ZodEnum<["investigating", "remediating", "monitoring", "resolved", "aborted"]>;
+    severity: z.ZodOptional<z.ZodEnum<["S1", "S2", "S3", "S4"]>>;
+    resolvedAt: z.ZodOptional<z.ZodString>;
+    resolutionCriteria: z.ZodOptional<z.ZodString>;
+    resolutionEvidence: z.ZodOptional<z.ZodObject<{
+        verified: z.ZodBoolean;
+        observedValue: z.ZodOptional<z.ZodNumber>;
+        sampledAt: z.ZodOptional<z.ZodString>;
+        evidencePath: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+        hint: z.ZodOptional<z.ZodString>;
+        /** Set when transition was authorized via overrideToken. */
+        override: z.ZodOptional<z.ZodObject<{
+            reason: z.ZodString;
+            at: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            at: string;
+            reason: string;
+        }, {
+            at: string;
+            reason: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        verified: boolean;
+        reason?: string | undefined;
+        hint?: string | undefined;
+        observedValue?: number | undefined;
+        sampledAt?: string | undefined;
+        evidencePath?: string | undefined;
+        override?: {
+            at: string;
+            reason: string;
+        } | undefined;
+    }, {
+        verified: boolean;
+        reason?: string | undefined;
+        hint?: string | undefined;
+        observedValue?: number | undefined;
+        sampledAt?: string | undefined;
+        evidencePath?: string | undefined;
+        override?: {
+            at: string;
+            reason: string;
+        } | undefined;
+    }>>;
+    postmortemPath: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "aborted" | "investigating" | "remediating" | "monitoring" | "resolved";
+    createdAt: string;
+    incidentId: string;
+    symptom: string;
+    resolvedAt?: string | undefined;
+    severity?: "S1" | "S2" | "S3" | "S4" | undefined;
+    resolutionCriteria?: string | undefined;
+    resolutionEvidence?: {
+        verified: boolean;
+        reason?: string | undefined;
+        hint?: string | undefined;
+        observedValue?: number | undefined;
+        sampledAt?: string | undefined;
+        evidencePath?: string | undefined;
+        override?: {
+            at: string;
+            reason: string;
+        } | undefined;
+    } | undefined;
+    postmortemPath?: string | undefined;
+}, {
+    status: "aborted" | "investigating" | "remediating" | "monitoring" | "resolved";
+    createdAt: string;
+    incidentId: string;
+    symptom: string;
+    resolvedAt?: string | undefined;
+    severity?: "S1" | "S2" | "S3" | "S4" | undefined;
+    resolutionCriteria?: string | undefined;
+    resolutionEvidence?: {
+        verified: boolean;
+        reason?: string | undefined;
+        hint?: string | undefined;
+        observedValue?: number | undefined;
+        sampledAt?: string | undefined;
+        evidencePath?: string | undefined;
+        override?: {
+            at: string;
+            reason: string;
+        } | undefined;
+    } | undefined;
+    postmortemPath?: string | undefined;
+}>;
+export type IncidentMetadata = z.infer<typeof IncidentMetadataSchema>;
+export interface IncidentSummary {
+    incidentId: string;
+    symptom: string;
+    createdAt: string;
+    status: IncidentStatus;
+    resolvedAt?: string;
+}
+export declare const PostmortemResultSchema: z.ZodObject<{
+    /** Absolute path to the written postmortem.md */
+    path: z.ZodString;
+    /** The full markdown content (caller can stream to stdout for CLI show) */
+    content: z.ZodString;
+    /** Number of secret-like strings redacted from artifacts during synthesis */
+    redactionCount: z.ZodNumber;
+    /** True if 5-Whys synthesis produced fewer than 3 deterministic levels */
+    shallowWarning: z.ZodBoolean;
+    /** Number of inline citations in the generated markdown */
+    citationCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    content: string;
+    redactionCount: number;
+    shallowWarning: boolean;
+    citationCount: number;
+}, {
+    path: string;
+    content: string;
+    redactionCount: number;
+    shallowWarning: boolean;
+    citationCount: number;
+}>;
+export type PostmortemResult = z.infer<typeof PostmortemResultSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/incident/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/incident/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAIhC,eAAO,MAAM,0BAA0B,0HASrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAI9E,eAAO,MAAM,mBAAmB;IAC9B,0BAA0B;;IAE1B,4EAA4E;;IAE5E,wCAAwC;;IAExC,+CAA+C;;IAE/C,0EAA0E;;;;;;;;;;;;;;EAE1E,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAKhE,eAAO,MAAM,sBAAsB;;IAEjC,4BAA4B;;;;;;;;;;;;;;;;;EAK5B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D,eAAO,MAAM,iBAAiB;;;;;IAK5B,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMnD,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;EAgBtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAIhF,eAAO,MAAM,oBAAoB,kFAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,SAAS,cAAc,EAAE,CAAC,CAMjF,CAAC;AAEX,4FAA4F;AAC5F,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,gCAAgC;;;;;;;IAO3C,4DAA4D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK5D,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;QARjC,4DAA4D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB5D,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAKtE,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,eAAO,MAAM,sBAAsB;IACjC,iDAAiD;;IAEjD,2EAA2E;;IAE3E,6EAA6E;;IAE7E,0EAA0E;;IAE1E,2DAA2D;;;;;;;;;;;;;;EAE3D,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/incident/types.js

@@ -0,0 +1,158 @@
+/**
+ * Incident artifact type definitions (Sprint 19).
+ *
+ * All types are derived from zod schemas via z.infer — never written by hand
+ * to avoid schema/type drift. Follow the pattern established in src/config/schema.ts.
+ *
+ * Schema locks (do NOT change without updating the corresponding skill):
+ * - ObservationEntry: 5 fields locked by skills/bober.diagnose/SKILL.md lines 74-82.
+ * - RunbookExecutionEntry: 7 camelCase fields locked by skills/bober.runbook/SKILL.md line 208.
+ * - ChangeEntry.inverse: REQUIRED at zod level (not optional) — Sprint 21 rollback
+ *   awareness depends on every change having an inverse declared at write time.
+ */
+import { z } from "zod";
+// ── IncidentArtifactKind ───────────────────────────────────────────────────────
+export const IncidentArtifactKindSchema = z.enum([
+    "timeline",
+    "observation",
+    "hypothesis",
+    "action",
+    "change",
+    "runbook-execution",
+    "diagnosis",
+    "postmortem",
+]);
+// ── TimelineEvent ──────────────────────────────────────────────────────────────
+export const TimelineEventSchema = z.object({
+    /** ISO-8601 timestamp. */
+    timestamp: z.string(),
+    /** Machine-readable event kind, e.g. 'incident_created', 'action_taken'. */
+    eventKind: z.string(),
+    /** Which system produced this event. */
+    source: z.enum(["diagnoser", "deployer", "human", "observability", "system"]),
+    /** Human-readable summary of what happened. */
+    summary: z.string(),
+    /** Optional relative path to the detail artifact (e.g. actions.jsonl). */
+    refPath: z.string().optional(),
+});
+// ── ObservationEntry ───────────────────────────────────────────────────────────
+// Shape locked by skills/bober.diagnose/SKILL.md lines 74-82 (5 fields).
+export const ObservationEntrySchema = z.object({
+    timestamp: z.string(),
+    /** Diagnosis phase: 1–4. */
+    phase: z.number().int().min(1).max(4),
+    observation: z.string(),
+    source: z.string(),
+    verified: z.boolean(),
+});
+// ── ActionEntry ────────────────────────────────────────────────────────────────
+export const ActionEntrySchema = z.object({
+    timestamp: z.string(),
+    action: z.string(),
+    blastRadius: z.enum(["safe", "risky"]),
+    requiresApproval: z.boolean(),
+    rationale: z.string().optional(),
+});
+// ── ChangeEntry ────────────────────────────────────────────────────────────────
+// inverse is REQUIRED — NOT .optional(). Sprint 21 rollback awareness relies on
+// every change having a declared inverse at write time.
+export const ChangeEntrySchema = z.object({
+    id: z.string(),
+    type: z.string(),
+    executedAt: z.string(),
+    description: z.string(),
+    /** REQUIRED. Describes how to undo this change. */
+    inverse: z.object({
+        description: z.string(),
+        command: z.string().optional(),
+    }),
+    status: z.enum(["pending", "executed", "rolled-back", "rolled-back-failed", "failed"]),
+});
+// ── RunbookExecutionEntry ──────────────────────────────────────────────────────
+// 7 camelCase fields locked by skills/bober.runbook/SKILL.md line 208.
+// Do NOT rename fields (e.g. step_number vs stepNumber causes schema drift).
+export const RunbookExecutionEntrySchema = z.object({
+    timestamp: z.string(),
+    runbookName: z.string(),
+    stepNumber: z.number().int().min(1),
+    status: z.enum([
+        "precondition_failed",
+        "checkpoint_rejected",
+        "execution_failed",
+        "postcondition_failed_no_rollback",
+        "rollback_failed",
+        "recovered_via_rollback",
+        "success",
+    ]),
+    preconditionResult: z.enum(["pass", "fail", "not_run"]),
+    postconditionResult: z.enum(["pass", "fail", "not_run"]),
+    rollbackTriggered: z.boolean().optional(),
+});
+// ── IncidentStatus / IncidentMetadata ─────────────────────────────────────────
+export const IncidentStatusSchema = z.enum([
+    "investigating",
+    "remediating",
+    "monitoring",
+    "resolved",
+    "aborted",
+]);
+/**
+ * Allowed phase transitions for the incident state machine (Sprint 24).
+ * Keys are the FROM phase; values are the array of allowed TO phases.
+ *
+ * The re-open path (resolved → investigating) requires an explicit `reason`
+ * — see transitionPhase() in src/incident/orchestrator.ts.
+ *
+ * `aborted` is terminal: it appears as a value in many keys (any phase may
+ * abort) but never as a key — there are no transitions out of aborted.
+ */
+export const STATUS_TRANSITIONS = {
+    investigating: ["remediating", "resolved", "aborted"],
+    remediating: ["monitoring", "investigating", "aborted"], // self-loop or back to invest. on rollback
+    monitoring: ["resolved", "investigating", "aborted"], // verifyResolution fail → back to invest.
+    resolved: ["investigating"], // re-open path; reason REQUIRED
+    aborted: [], // terminal
+};
+/**
+ * Snapshot of the VerifyResult that authorized the 'resolved' transition.
+ * Either verified=true OR an overrideToken with a non-empty reason. Sprint 22.
+ */
+export const IncidentResolutionEvidenceSchema = z.object({
+    verified: z.boolean(),
+    observedValue: z.number().optional(),
+    sampledAt: z.string().optional(),
+    evidencePath: z.string().optional(),
+    reason: z.string().optional(),
+    hint: z.string().optional(),
+    /** Set when transition was authorized via overrideToken. */
+    override: z.object({
+        reason: z.string().min(1, "override reason is required"),
+        at: z.string(),
+    }).optional(),
+});
+export const IncidentMetadataSchema = z.object({
+    incidentId: z.string(),
+    symptom: z.string(),
+    createdAt: z.string(),
+    status: IncidentStatusSchema,
+    severity: z.enum(["S1", "S2", "S3", "S4"]).optional(), // ← Sprint 24
+    resolvedAt: z.string().optional(),
+    resolutionCriteria: z.string().optional(),
+    resolutionEvidence: IncidentResolutionEvidenceSchema.optional(), // ← Sprint 22
+    postmortemPath: z.string().optional(),
+});
+// ── PostmortemResult (Sprint 23) ───────────────────────────────────────────────
+// Return type of generatePostmortem() in src/incident/postmortem.ts.
+export const PostmortemResultSchema = z.object({
+    /** Absolute path to the written postmortem.md */
+    path: z.string(),
+    /** The full markdown content (caller can stream to stdout for CLI show) */
+    content: z.string(),
+    /** Number of secret-like strings redacted from artifacts during synthesis */
+    redactionCount: z.number().int().min(0),
+    /** True if 5-Whys synthesis produced fewer than 3 deterministic levels */
+    shallowWarning: z.boolean(),
+    /** Number of inline citations in the generated markdown */
+    citationCount: z.number().int().min(0),
+});
+//# sourceMappingURL=types.js.map

package/dist/incident/types.js.map

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

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { type BoberConfig, type ProjectMode, type Stack, type ModelChoice, type EvalStrategy, type EvalStrategyType, StackSchema, ProjectModeSchema, createDefaultConfig, } from "./config/schema.js";
 export { loadConfig, configExists } from "./config/loader.js";
 export { getDefaults, getPresetNames } from "./config/defaults.js";
-export { type SprintContract, type SuccessCriterion, type ContractStatus, createContract, updateContractStatus, } from "./contracts/sprint-contract.js";
-export { type PlanSpec, type FeatureSpec, createSpec, } from "./contracts/spec.js";
+export { type SprintContract, type SuccessCriterion, type ContractStatus, type VerificationMethod, type EstimatedDuration, type ContractPrecisionIssue, MIN_CRITERION_DESCRIPTION_LENGTH, MIN_DEFINITION_OF_DONE_LENGTH, BANNED_VAGUE_PHRASES, createContract, updateContractStatus, findPrecisionIssues, isContractPrecise, } from "./contracts/sprint-contract.js";
+export { type PlanSpec, type FeatureSpec, type Priority, type EstimatedComplexity, type PlanSpecStatus, type PlanSpecMode, type ClarificationCategory, type ClarificationOption, type ClarificationQuestion, type ResolvedClarification, type CreateSpecOptions, AMBIGUITY_BLOCK_THRESHOLD, createSpec, hasOpenClarifications, getOpenClarifications, isPipelineReady, resolveClarification, } from "./contracts/spec.js";
 export { type EvalResult, type EvalDetail, type CriterionResult, type Regression, type GeneratorFeedbackItem, type SprintEvaluation as ContractSprintEvaluation, aggregateResults, formatFeedback, } from "./contracts/eval-result.js";
 export { type ContextHandoff, type Decision, type ProjectContext, createHandoff, serializeHandoff, summarizeOlderSprints, } from "./orchestrator/context-handoff.js";
 export { runPlanner } from "./orchestrator/planner-agent.js";
@@ -12,7 +12,7 @@ export { runCurator, type SprintBriefing, } from "./orchestrator/curator-agent.j
 export { runPipeline, type PipelineResult, } from "./orchestrator/pipeline.js";
 export { resolveModel } from "./orchestrator/model-resolver.js";
 export { loadAgentDefinition, clearAgentCache, type AgentDefinition, } from "./orchestrator/agent-loader.js";
-export { buildToolSet, type ToolSet, type AgentRole, } from "./orchestrator/tools/index.js";
+export { buildToolSet, resolveRoleTools, getGraphState, getGraphDeps, ROLE_TOOLS, type ToolSet, type AgentRole, type GraphState, } from "./orchestrator/tools/index.js";
 export { runAgenticLoop, type AgenticLoopParams, type AgenticLoopResult, } from "./orchestrator/agentic-loop.js";
 export { EvaluatorRegistry, createDefaultRegistry, runEvaluation, type EvaluationRunResult, } from "./evaluators/registry.js";
 export type { EvaluatorPlugin, EvaluatorFactory, EvalContext, } from "./evaluators/plugin-interface.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -3,8 +3,8 @@ export { StackSchema, ProjectModeSchema, createDefaultConfig, } from "./config/s
 export { loadConfig, configExists } from "./config/loader.js";
 export { getDefaults, getPresetNames } from "./config/defaults.js";
 // ── Contracts ──────────────────────────────────────────────────────
-export { createContract, updateContractStatus, } from "./contracts/sprint-contract.js";
-export { createSpec, } from "./contracts/spec.js";
+export { MIN_CRITERION_DESCRIPTION_LENGTH, MIN_DEFINITION_OF_DONE_LENGTH, BANNED_VAGUE_PHRASES, createContract, updateContractStatus, findPrecisionIssues, isContractPrecise, } from "./contracts/sprint-contract.js";
+export { AMBIGUITY_BLOCK_THRESHOLD, createSpec, hasOpenClarifications, getOpenClarifications, isPipelineReady, resolveClarification, } from "./contracts/spec.js";
 export { aggregateResults, formatFeedback, } from "./contracts/eval-result.js";
 // ── Orchestrator ───────────────────────────────────────────────────
 export { createHandoff, serializeHandoff, summarizeOlderSprints, } from "./orchestrator/context-handoff.js";
@@ -15,7 +15,7 @@ export { runCurator, } from "./orchestrator/curator-agent.js";
 export { runPipeline, } from "./orchestrator/pipeline.js";
 export { resolveModel } from "./orchestrator/model-resolver.js";
 export { loadAgentDefinition, clearAgentCache, } from "./orchestrator/agent-loader.js";
-export { buildToolSet, } from "./orchestrator/tools/index.js";
+export { buildToolSet, resolveRoleTools, getGraphState, getGraphDeps, ROLE_TOOLS, } from "./orchestrator/tools/index.js";
 export { runAgenticLoop, } from "./orchestrator/agentic-loop.js";
 // ── Evaluators ─────────────────────────────────────────────────────
 export { EvaluatorRegistry, createDefaultRegistry, runEvaluation, } from "./evaluators/registry.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAOL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEnE,sEAAsE;AAEtE,OAAO,EAIL,cAAc,EACd,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAGL,UAAU,GACX,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAOL,gBAAgB,EAChB,cAAc,GACf,MAAM,4BAA4B,CAAC;AAEpC,sEAAsE;AAEtE,OAAO,EAIL,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EACL,YAAY,GAEb,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,EACL,UAAU,GAEX,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,WAAW,GAEZ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,OAAO,EACL,mBAAmB,EACnB,eAAe,GAEhB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,YAAY,GAGb,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,cAAc,GAGf,MAAM,gCAAgC,CAAC;AAExC,sEAAsE;AAEtE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GAEd,MAAM,0BAA0B,CAAC;AAQlC,sEAAsE;AAEtE,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,EACT,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAC;AAoB1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAqB,MAAM,wBAAwB,CAAC;AAEzF,sEAAsE;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,uEAAuE;AAEvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,wEAAwE;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAOL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEnE,sEAAsE;AAEtE,OAAO,EAOL,gCAAgC,EAChC,6BAA6B,EAC7B,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAYL,yBAAyB,EACzB,UAAU,EACV,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAOL,gBAAgB,EAChB,cAAc,GACf,MAAM,4BAA4B,CAAC;AAEpC,sEAAsE;AAEtE,OAAO,EAIL,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,EACL,YAAY,GAEb,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,EACL,UAAU,GAEX,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,WAAW,GAEZ,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,OAAO,EACL,mBAAmB,EACnB,eAAe,GAEhB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,GAIX,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,cAAc,GAGf,MAAM,gCAAgC,CAAC;AAExC,sEAAsE;AAEtE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GAEd,MAAM,0BAA0B,CAAC;AAQlC,sEAAsE;AAEtE,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,SAAS,EACT,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,kBAAkB,CAAC;AAoB1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAqB,MAAM,wBAAwB,CAAC;AAEzF,sEAAsE;AAEtE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,uEAAuE;AAEvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,wEAAwE;AAExE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/mcp/event-stream.d.ts

@@ -0,0 +1,46 @@
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare class EventStreamManager {
+    private readonly server;
+    private readonly projectRoot;
+    private readonly defaultQueueBound;
+    private subscriptions;
+    /** FileWatch entries keyed by absolute path. */
+    private fileWatches;
+    /**
+     * Map from subscriptionId → set of watched file paths.
+     * Used to release watches on unsubscribe.
+     */
+    private subFiles;
+    /** Telemetry date-poll interval (detects date roll-overs). */
+    private telemetryPollTimer;
+    /** Current date string (YYYY-MM-DD) used to detect roll-over. */
+    private currentTelemetryDate;
+    constructor(server: Server, projectRoot: string, defaultQueueBound?: number);
+    subscribe(runId: string, opts?: {
+        since?: string;
+        queueBound?: number;
+    }): Promise<{
+        subscriptionId: string;
+        status: "subscribed";
+        startedAt: string;
+    }>;
+    unsubscribe(subscriptionId: string): {
+        ok: boolean;
+    };
+    shutdown(): void;
+    private openWatch;
+    private createWatcher;
+    private createParentWatcher;
+    private releaseWatch;
+    private fileExists;
+    private onFileEvent;
+    private readFromOffset;
+    private backfill;
+    private deliver;
+    private flush;
+    private ensureTelemetryPoller;
+    private checkTelemetryDateRollover;
+}
+export declare function initEventStream(server: Server, projectRoot: string, queueBound?: number): EventStreamManager;
+export declare function getEventStream(): EventStreamManager;
+//# sourceMappingURL=event-stream.d.ts.map

package/dist/mcp/event-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-stream.d.ts","sourceRoot":"","sources":["../../src/mcp/event-stream.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAqDxE,qBAAa,kBAAkB;IAe3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAhBpC,OAAO,CAAC,aAAa,CAAmC;IACxD,gDAAgD;IAChD,OAAO,CAAC,WAAW,CAAgC;IACnD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAkC;IAClD,8DAA8D;IAC9D,OAAO,CAAC,kBAAkB,CAA+C;IACzE,iEAAiE;IACjE,OAAO,CAAC,oBAAoB,CAAyC;gBAGlD,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,iBAAiB,SAAO;IAKrC,SAAS,CACb,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GACjD,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAqC/E,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE;IAepD,QAAQ,IAAI,IAAI;YAiBF,SAAS;IA4DvB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,YAAY;YAYN,UAAU;YASV,WAAW;IAmDzB,OAAO,CAAC,cAAc;YAqBR,QAAQ;IAkCtB,OAAO,CAAC,OAAO;YAcD,KAAK;IAqCnB,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,0BAA0B;CAmBnC;AAMD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,kBAAkB,CAGpB;AAED,wBAAgB,cAAc,IAAI,kBAAkB,CAOnD"}