agent-trajectories 0.5.3 → 0.5.5

package/dist/{index-Bw0Jk4zO.d.ts → index-DiSIfGXl.d.ts}

@@ -10,28 +10,34 @@ import { z } from 'zod';
 /**
  * Supported task source systems
  */
-type TaskSourceSystem = "beads" | "github" | "linear" | "jira" | "plain" | string;
+type TaskSourceSystem =
+  | "beads"
+  | "github"
+  | "linear"
+  | "jira"
+  | "plain"
+  | string;
 /**
  * Reference to an external task/issue
  */
 interface TaskSource {
-    /** The task management system (e.g., 'github', 'linear') */
-    system: TaskSourceSystem;
-    /** The external ID (e.g., 'GH#123', 'ENG-456') */
-    id: string;
-    /** Optional URL to the external task */
-    url?: string;
+  /** The task management system (e.g., 'github', 'linear') */
+  system: TaskSourceSystem;
+  /** The external ID (e.g., 'GH#123', 'ENG-456') */
+  id: string;
+  /** Optional URL to the external task */
+  url?: string;
 }
 /**
  * Task reference - either standalone or linked to external system
  */
 interface TaskReference {
-    /** Human-readable task title */
-    title: string;
-    /** Optional description */
-    description?: string;
-    /** Optional link to external task system */
-    source?: TaskSource;
+  /** Human-readable task title */
+  title: string;
+  /** Optional description */
+  description?: string;
+  /** Optional link to external task system */
+  source?: TaskSource;
 }
 /**
  * Trajectory status
@@ -40,7 +46,18 @@ type TrajectoryStatus = "active" | "completed" | "abandoned";
 /**
  * Event types that can be recorded in a trajectory
  */
-type TrajectoryEventType = "prompt" | "thinking" | "tool_call" | "tool_result" | "message_sent" | "message_received" | "decision" | "finding" | "reflection" | "note" | "error";
+type TrajectoryEventType =
+  | "prompt"
+  | "thinking"
+  | "tool_call"
+  | "tool_result"
+  | "message_sent"
+  | "message_received"
+  | "decision"
+  | "finding"
+  | "reflection"
+  | "note"
+  | "error";
 /**
  * Significance level for events
  */
@@ -49,246 +66,249 @@ type EventSignificance = "low" | "medium" | "high" | "critical";
  * A single event in the trajectory timeline
  */
 interface TrajectoryEvent {
-    /** Unix timestamp in milliseconds */
-    ts: number;
-    /** Type of event */
-    type: TrajectoryEventType;
-    /** Human-readable summary of the event */
-    content: string;
-    /** Full raw data (optional, for debugging) */
-    raw?: unknown;
-    /** Importance level */
-    significance?: EventSignificance;
-    /** Confidence level for this event (0-1) */
-    confidence?: number;
-    /** User-defined tags */
-    tags?: string[];
+  /** Unix timestamp in milliseconds */
+  ts: number;
+  /** Type of event */
+  type: TrajectoryEventType;
+  /** Human-readable summary of the event */
+  content: string;
+  /** Full raw data (optional, for debugging) */
+  raw?: unknown;
+  /** Importance level */
+  significance?: EventSignificance;
+  /** Confidence level for this event (0-1) */
+  confidence?: number;
+  /** User-defined tags */
+  tags?: string[];
 }
 /**
  * An alternative option that was considered
  */
 interface Alternative {
-    /** The alternative option */
-    option: string;
-    /** Why this alternative was not chosen */
-    reason?: string;
+  /** The alternative option */
+  option: string;
+  /** Why this alternative was not chosen */
+  reason?: string;
 }
 /**
  * A structured decision record
  */
 interface Decision {
-    /** What was the choice/question? */
-    question: string;
-    /** What was chosen */
-    chosen: string;
-    /** What alternatives were considered */
-    alternatives: Alternative[];
-    /** Why this choice was made */
-    reasoning: string;
-    /** Confidence in this decision (0-1) */
-    confidence?: number;
+  /** What was the choice/question? */
+  question: string;
+  /** What was chosen */
+  chosen: string;
+  /** What alternatives were considered */
+  alternatives: Alternative[];
+  /** Why this choice was made */
+  reasoning: string;
+  /** Confidence in this decision (0-1) */
+  confidence?: number;
 }
 /**
  * Finding category types
  */
-type FindingCategory = "bug" | "pattern" | "optimization" | "security" | "documentation" | "dependency" | "other";
+type FindingCategory =
+  | "bug"
+  | "pattern"
+  | "optimization"
+  | "security"
+  | "documentation"
+  | "dependency"
+  | "other";
 /**
  * A structured finding record - captures discoveries made during exploration
  */
 interface Finding {
-    /** What was found */
-    what: string;
-    /** Where it was found (file path, component, etc.) */
-    where: string;
-    /** Why this finding is significant */
-    significance: string;
-    /** Category of the finding */
-    category: FindingCategory;
-    /** Suggested action or follow-up */
-    suggestedAction?: string;
-    /** Confidence in this finding (0-1) */
-    confidence?: number;
+  /** What was found */
+  what: string;
+  /** Where it was found (file path, component, etc.) */
+  where: string;
+  /** Why this finding is significant */
+  significance: string;
+  /** Category of the finding */
+  category: FindingCategory;
+  /** Suggested action or follow-up */
+  suggestedAction?: string;
+  /** Confidence in this finding (0-1) */
+  confidence?: number;
 }
 /**
  * Agent participation record
  */
 interface AgentParticipation {
-    /** Agent identifier */
-    name: string;
-    /** Role in the trajectory */
-    role: "lead" | "contributor" | "reviewer";
-    /** When the agent joined */
-    joinedAt: string;
-    /** When the agent left (if applicable) */
-    leftAt?: string;
+  /** Agent identifier */
+  name: string;
+  /** Role in the trajectory */
+  role: "lead" | "contributor" | "reviewer";
+  /** When the agent joined */
+  joinedAt: string;
+  /** When the agent left (if applicable) */
+  leftAt?: string;
 }
 /**
  * A chapter represents a logical phase of work
  */
 interface Chapter {
-    /** Unique chapter ID */
-    id: string;
-    /** Chapter title (e.g., "Initial exploration", "Implementation") */
-    title: string;
-    /** Which agent is working in this chapter */
-    agentName: string;
-    /** When the chapter started (ISO timestamp) */
-    startedAt: string;
-    /** When the chapter ended (ISO timestamp, undefined if current) */
-    endedAt?: string;
-    /** Events that occurred in this chapter */
-    events: TrajectoryEvent[];
+  /** Unique chapter ID */
+  id: string;
+  /** Chapter title (e.g., "Initial exploration", "Implementation") */
+  title: string;
+  /** Which agent is working in this chapter */
+  agentName: string;
+  /** When the chapter started (ISO timestamp) */
+  startedAt: string;
+  /** When the chapter ended (ISO timestamp, undefined if current) */
+  endedAt?: string;
+  /** Events that occurred in this chapter */
+  events: TrajectoryEvent[];
 }
 /**
  * Retrospective reflection on the completed work
  */
 interface Retrospective {
-    /** Brief summary of what was accomplished */
-    summary: string;
-    /** How the work was approached */
-    approach: string;
-    /** Key decisions made during the work */
-    decisions?: Decision[];
-    /** What was unexpectedly difficult */
-    challenges?: string[];
-    /** What was learned */
-    learnings?: string[];
-    /** Suggestions for improvement */
-    suggestions?: string[];
-    /** Agent's confidence in the solution (0-1) */
-    confidence: number;
-    /** Total time spent (human-readable) */
-    timeSpent?: string;
+  /** Brief summary of what was accomplished */
+  summary: string;
+  /** How the work was approached */
+  approach: string;
+  /** Key decisions made during the work */
+  decisions?: Decision[];
+  /** What was unexpectedly difficult */
+  challenges?: string[];
+  /** What was learned */
+  learnings?: string[];
+  /** Suggestions for improvement */
+  suggestions?: string[];
+  /** Agent's confidence in the solution (0-1) */
+  confidence: number;
+  /** Total time spent (human-readable) */
+  timeSpent?: string;
 }
 /**
  * The main Trajectory type - represents the complete record of work on a task
  */
 interface Trajectory {
-    /** Unique trajectory ID (format: traj_xxxxxxxxxxxx) */
-    id: string;
-    /** Schema version for forward compatibility */
-    version: 1;
-    /** The task being worked on */
-    task: TaskReference;
-    /** Current status */
-    status: TrajectoryStatus;
-    /** When work started (ISO timestamp) */
-    startedAt: string;
-    /** When work completed (ISO timestamp) */
-    completedAt?: string;
-    /** Agents who participated */
-    agents: AgentParticipation[];
-    /** Logical phases of work */
-    chapters: Chapter[];
-    /** Final reflection (only on completion) */
-    retrospective?: Retrospective;
-    /** Git commits produced */
-    commits: string[];
-    /** Files that were modified */
-    filesChanged: string[];
-    /** Project identifier */
-    projectId: string;
-    /** Opaque id set by the workflow runner via TRAJECTORIES_WORKFLOW_ID env var. Lets trail compact --workflow <id> collate all trajectories from a single workflow run. */
-    workflowId?: string;
-    /** User-defined tags */
-    tags: string[];
-    /** Trace information for code attribution */
-    _trace?: TrajectoryTraceRef;
+  /** Unique trajectory ID (format: traj_xxxxxxxxxxxx) */
+  id: string;
+  /** Schema version for forward compatibility */
+  version: 1;
+  /** The task being worked on */
+  task: TaskReference;
+  /** Current status */
+  status: TrajectoryStatus;
+  /** When work started (ISO timestamp) */
+  startedAt: string;
+  /** When work completed (ISO timestamp) */
+  completedAt?: string;
+  /** Agents who participated */
+  agents: AgentParticipation[];
+  /** Logical phases of work */
+  chapters: Chapter[];
+  /** Final reflection (only on completion) */
+  retrospective?: Retrospective;
+  /** Git commits produced */
+  commits: string[];
+  /** Files that were modified */
+  filesChanged: string[];
+  /** Project identifier */
+  projectId: string;
+  /** User-defined tags */
+  tags: string[];
+  /** Trace information for code attribution */
+  _trace?: TrajectoryTraceRef;
 }
 /**
  * Summary of a trajectory for listing/indexing
  */
 interface TrajectorySummary {
-    id: string;
-    title: string;
-    status: TrajectoryStatus;
-    startedAt: string;
-    completedAt?: string;
-    confidence?: number;
-    chapterCount: number;
-    decisionCount: number;
+  id: string;
+  title: string;
+  status: TrajectoryStatus;
+  startedAt: string;
+  completedAt?: string;
+  confidence?: number;
+  chapterCount: number;
+  decisionCount: number;
 }
 /**
  * Input for creating a new trajectory
  */
 interface CreateTrajectoryInput {
-    /** Task title */
-    title: string;
-    /** Optional task description */
-    description?: string;
-    /** Optional external task reference */
-    source?: TaskSource;
-    /** Optional project ID (defaults to cwd) */
-    projectId?: string;
-    /** Opaque id set by the workflow runner via TRAJECTORIES_WORKFLOW_ID env var. Lets trail compact --workflow <id> collate all trajectories from a single workflow run. */
-    workflowId?: string;
-    /** Optional initial tags */
-    tags?: string[];
+  /** Task title */
+  title: string;
+  /** Optional task description */
+  description?: string;
+  /** Optional external task reference */
+  source?: TaskSource;
+  /** Optional project ID (defaults to cwd) */
+  projectId?: string;
+  /** Optional initial tags */
+  tags?: string[];
 }
 /**
  * Input for adding a chapter
  */
 interface AddChapterInput {
-    /** Chapter title */
-    title: string;
-    /** Agent name */
-    agentName: string;
+  /** Chapter title */
+  title: string;
+  /** Agent name */
+  agentName: string;
 }
 /**
  * Input for adding an event
  */
 interface AddEventInput {
-    /** Event type */
-    type: TrajectoryEventType;
-    /** Human-readable content */
-    content: string;
-    /** Optional raw data */
-    raw?: unknown;
-    /** Optional significance */
-    significance?: EventSignificance;
-    /** Optional tags */
-    tags?: string[];
+  /** Event type */
+  type: TrajectoryEventType;
+  /** Human-readable content */
+  content: string;
+  /** Optional raw data */
+  raw?: unknown;
+  /** Optional significance */
+  significance?: EventSignificance;
+  /** Optional tags */
+  tags?: string[];
 }
 /**
  * Input for completing a trajectory
  */
 interface CompleteTrajectoryInput {
-    summary: string;
-    approach: string;
-    decisions?: Decision[];
-    challenges?: string[];
-    learnings?: string[];
-    suggestions?: string[];
-    confidence: number;
+  summary: string;
+  approach: string;
+  decisions?: Decision[];
+  challenges?: string[];
+  learnings?: string[];
+  suggestions?: string[];
+  confidence: number;
 }
 /**
  * Query options for listing trajectories
  */
 interface TrajectoryQuery {
-    /** Filter by status */
-    status?: TrajectoryStatus;
-    /** Filter by date range */
-    since?: string;
-    until?: string;
-    /** Maximum results */
-    limit?: number;
-    /** Offset for pagination */
-    offset?: number;
-    /** Sort field */
-    sortBy?: "startedAt" | "completedAt" | "title";
-    /** Sort direction */
-    sortOrder?: "asc" | "desc";
+  /** Filter by status */
+  status?: TrajectoryStatus;
+  /** Filter by date range */
+  since?: string;
+  until?: string;
+  /** Maximum results */
+  limit?: number;
+  /** Offset for pagination */
+  offset?: number;
+  /** Sort field */
+  sortBy?: "startedAt" | "completedAt" | "title";
+  /** Sort direction */
+  sortOrder?: "asc" | "desc";
 }
 /**
  * Reference to trace information within a trajectory
  */
 interface TrajectoryTraceRef {
-    /** Git ref (commit hash) when trace started */
-    startRef: string;
-    /** Git ref (commit hash) when trace ended */
-    endRef?: string;
-    /** ID of the associated trace record */
-    traceId?: string;
+  /** Git ref (commit hash) when trace started */
+  startRef: string;
+  /** Git ref (commit hash) when trace ended */
+  endRef?: string;
+  /** ID of the associated trace record */
+  traceId?: string;
 }
 
 /**
@@ -889,6 +909,19 @@ declare function abandonTrajectory(trajectory: Trajectory, reason?: string): Tra
  * Active trajectories go in active/, completed in completed/YYYY-MM/.
  */
 
+/**
+ * Aggregated counts emitted by reconcileIndex for observability. Exposed
+ * on the return value so tests and callers can assert on counts without
+ * parsing log output.
+ */
+interface ReconcileSummary {
+    scanned: number;
+    added: number;
+    alreadyIndexed: number;
+    skippedMalformedJson: number;
+    skippedSchemaViolation: number;
+    skippedIoError: number;
+}
 /**
  * File system storage adapter
  */
@@ -904,9 +937,34 @@ declare class FileStorage implements StorageAdapter {
      */
     initialize(): Promise<void>;
     /**
-     * Save a trajectory
+     * Scan active/ and completed/ recursively and add any trajectory files
+     * missing from the index. Existing entries are preserved — reconcile
+     * only adds, never removes.
+     *
+     * Handles three on-disk layouts in completed/:
+     *   - flat:      completed/{id}.json         (legacy workforce data)
+     *   - monthly:   completed/YYYY-MM/{id}.json (current save() writes)
+     *   - nested:    completed/.../{id}.json     (defensive — any depth)
+     *
+     * Returns a ReconcileSummary so tests and CLI wrappers can observe
+     * outcomes without parsing logs. Only writes the index if anything was
+     * added.
      */
-    save(trajectory: Trajectory): Promise<void>;
+    reconcileIndex(): Promise<ReconcileSummary>;
+    /**
+     * Recursively collect all .json file paths under `dir` into `out`.
+     * Silently treats a missing directory as empty.
+     */
+    private walkJsonFilesInto;
+    /**
+     * Save a trajectory.
+     *
+     * Validates the input against the trajectory schema before touching
+     * disk. Closes the historical read/write asymmetry where save() would
+     * happily write data that the reader then rejected, producing files
+     * that could never be loaded back.
+     */
+    save(input: Trajectory): Promise<void>;
     /**
      * Get a trajectory by ID
      */
@@ -933,7 +991,19 @@ declare class FileStorage implements StorageAdapter {
      * Close storage (no-op for file storage)
      */
     close(): Promise<void>;
+    /**
+     * Read a trajectory file and return a tagged result so callers can
+     * distinguish missing files, malformed JSON, and schema violations.
+     *
+     * Does NOT log. Callers choose whether to warn, swallow, or throw.
+     */
     private readTrajectoryFile;
+    /**
+     * Convenience wrapper for callers that only care whether they got a
+     * trajectory. Returns null for any failure and writes nothing to the
+     * console — so nothing leaks into test output or the CLI spinner.
+     */
+    private readTrajectoryOrNull;
     private loadIndex;
     private saveIndex;
     private updateIndex;
@@ -1028,17 +1098,17 @@ declare const TrajectorySchema: z.ZodObject<{
     completedAt: z.ZodOptional<z.ZodString>;
     agents: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
-        role: z.ZodEnum<["lead", "contributor", "reviewer"]>;
+        role: z.ZodString;
         joinedAt: z.ZodString;
         leftAt: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        role: "lead" | "contributor" | "reviewer";
+        role: string;
         joinedAt: string;
         leftAt?: string | undefined;
     }, {
         name: string;
-        role: "lead" | "contributor" | "reviewer";
+        role: string;
         joinedAt: string;
         leftAt?: string | undefined;
     }>, "many">;
@@ -1050,7 +1120,7 @@ declare const TrajectorySchema: z.ZodObject<{
         endedAt: z.ZodOptional<z.ZodString>;
         events: z.ZodArray<z.ZodObject<{
             ts: z.ZodNumber;
-            type: z.ZodUnion<[z.ZodLiteral<"prompt">, z.ZodLiteral<"thinking">, z.ZodLiteral<"tool_call">, z.ZodLiteral<"tool_result">, z.ZodLiteral<"message_sent">, z.ZodLiteral<"message_received">, z.ZodLiteral<"decision">, z.ZodLiteral<"finding">, z.ZodLiteral<"reflection">, z.ZodLiteral<"note">, z.ZodLiteral<"error">, z.ZodString]>;
+            type: z.ZodUnion<[z.ZodLiteral<"prompt">, z.ZodLiteral<"thinking">, z.ZodLiteral<"tool_call">, z.ZodLiteral<"tool_result">, z.ZodLiteral<"message_sent">, z.ZodLiteral<"message_received">, z.ZodLiteral<"decision">, z.ZodLiteral<"finding">, z.ZodLiteral<"reflection">, z.ZodLiteral<"note">, z.ZodLiteral<"error">, z.ZodLiteral<"completion-evidence">, z.ZodLiteral<"completion-marker">, z.ZodString]>;
             content: z.ZodString;
             raw: z.ZodOptional<z.ZodUnknown>;
             significance: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "critical"]>>;
@@ -1183,11 +1253,11 @@ declare const TrajectorySchema: z.ZodObject<{
         suggestions?: string[] | undefined;
         timeSpent?: string | undefined;
     }>>;
-    commits: z.ZodArray<z.ZodString, "many">;
-    filesChanged: z.ZodArray<z.ZodString, "many">;
-    projectId: z.ZodString;
+    commits: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    filesChanged: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    projectId: z.ZodOptional<z.ZodString>;
     workflowId: z.ZodOptional<z.ZodString>;
-    tags: z.ZodArray<z.ZodString, "many">;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     _trace: z.ZodOptional<z.ZodObject<{
         startRef: z.ZodString;
         endRef: z.ZodOptional<z.ZodString>;
@@ -1218,7 +1288,7 @@ declare const TrajectorySchema: z.ZodObject<{
     };
     agents: {
         name: string;
-        role: "lead" | "contributor" | "reviewer";
+        role: string;
         joinedAt: string;
         leftAt?: string | undefined;
     }[];
@@ -1240,7 +1310,6 @@ declare const TrajectorySchema: z.ZodObject<{
     }[];
     commits: string[];
     filesChanged: string[];
-    projectId: string;
     completedAt?: string | undefined;
     retrospective?: {
         confidence: number;
@@ -1261,6 +1330,7 @@ declare const TrajectorySchema: z.ZodObject<{
         suggestions?: string[] | undefined;
         timeSpent?: string | undefined;
     } | undefined;
+    projectId?: string | undefined;
     workflowId?: string | undefined;
     _trace?: {
         startRef: string;
@@ -1270,7 +1340,6 @@ declare const TrajectorySchema: z.ZodObject<{
 }, {
     status: "active" | "completed" | "abandoned";
     id: string;
-    tags: string[];
     startedAt: string;
     version: 1;
     task: {
@@ -1284,7 +1353,7 @@ declare const TrajectorySchema: z.ZodObject<{
     };
     agents: {
         name: string;
-        role: "lead" | "contributor" | "reviewer";
+        role: string;
         joinedAt: string;
         leftAt?: string | undefined;
     }[];
@@ -1304,9 +1373,7 @@ declare const TrajectorySchema: z.ZodObject<{
         }[];
         endedAt?: string | undefined;
     }[];
-    commits: string[];
-    filesChanged: string[];
-    projectId: string;
+    tags?: string[] | undefined;
     completedAt?: string | undefined;
     retrospective?: {
         confidence: number;
@@ -1327,6 +1394,9 @@ declare const TrajectorySchema: z.ZodObject<{
         suggestions?: string[] | undefined;
         timeSpent?: string | undefined;
     } | undefined;
+    commits?: string[] | undefined;
+    filesChanged?: string[] | undefined;
+    projectId?: string | undefined;
     workflowId?: string | undefined;
     _trace?: {
         startRef: string;
@@ -1486,7 +1556,7 @@ declare function validateCompleteInput(data: unknown): {
  */
 declare const TrajectoryEventSchema: z.ZodObject<{
     ts: z.ZodNumber;
-    type: z.ZodUnion<[z.ZodLiteral<"prompt">, z.ZodLiteral<"thinking">, z.ZodLiteral<"tool_call">, z.ZodLiteral<"tool_result">, z.ZodLiteral<"message_sent">, z.ZodLiteral<"message_received">, z.ZodLiteral<"decision">, z.ZodLiteral<"finding">, z.ZodLiteral<"reflection">, z.ZodLiteral<"note">, z.ZodLiteral<"error">, z.ZodString]>;
+    type: z.ZodUnion<[z.ZodLiteral<"prompt">, z.ZodLiteral<"thinking">, z.ZodLiteral<"tool_call">, z.ZodLiteral<"tool_result">, z.ZodLiteral<"message_sent">, z.ZodLiteral<"message_received">, z.ZodLiteral<"decision">, z.ZodLiteral<"finding">, z.ZodLiteral<"reflection">, z.ZodLiteral<"note">, z.ZodLiteral<"error">, z.ZodLiteral<"completion-evidence">, z.ZodLiteral<"completion-marker">, z.ZodString]>;
     content: z.ZodString;
     raw: z.ZodOptional<z.ZodUnknown>;
     significance: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "critical"]>>;
@@ -1521,7 +1591,7 @@ declare const ChapterSchema: z.ZodObject<{
     endedAt: z.ZodOptional<z.ZodString>;
     events: z.ZodArray<z.ZodObject<{
         ts: z.ZodNumber;
-        type: z.ZodUnion<[z.ZodLiteral<"prompt">, z.ZodLiteral<"thinking">, z.ZodLiteral<"tool_call">, z.ZodLiteral<"tool_result">, z.ZodLiteral<"message_sent">, z.ZodLiteral<"message_received">, z.ZodLiteral<"decision">, z.ZodLiteral<"finding">, z.ZodLiteral<"reflection">, z.ZodLiteral<"note">, z.ZodLiteral<"error">, z.ZodString]>;
+        type: z.ZodUnion<[z.ZodLiteral<"prompt">, z.ZodLiteral<"thinking">, z.ZodLiteral<"tool_call">, z.ZodLiteral<"tool_result">, z.ZodLiteral<"message_sent">, z.ZodLiteral<"message_received">, z.ZodLiteral<"decision">, z.ZodLiteral<"finding">, z.ZodLiteral<"reflection">, z.ZodLiteral<"note">, z.ZodLiteral<"error">, z.ZodLiteral<"completion-evidence">, z.ZodLiteral<"completion-marker">, z.ZodString]>;
         content: z.ZodString;
         raw: z.ZodOptional<z.ZodUnknown>;
         significance: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "critical"]>>;