@cleocode/contracts 2026.4.0 → 2026.4.2

package/dist/results.d.ts

@@ -9,98 +9,149 @@
 import type { TaskRecord } from './task-record.js';
 /** Task summary counts used in dashboard and stats views. */
 export interface TaskSummary {
+    /** Number of tasks in `pending` status. */
     pending: number;
+    /** Number of tasks in `active` status. */
     active: number;
+    /** Number of tasks in `blocked` status. */
     blocked: number;
+    /** Number of tasks in `done` status. */
     done: number;
+    /** Number of tasks in `cancelled` status. */
     cancelled: number;
+    /** Total non-archived tasks (pending + active + blocked + done + cancelled). */
     total: number;
+    /** Number of archived tasks. */
     archived: number;
+    /** Grand total including archived tasks. */
     grandTotal: number;
 }
 /** Label frequency entry. */
 export interface LabelCount {
+    /** Label string value. */
     label: string;
+    /** Number of tasks tagged with this label. */
     count: number;
 }
 /** Dashboard result from system.dash query. */
 export interface DashboardResult {
+    /** Project name. */
     project: string;
+    /** Currently active phase slug, or `null` if no phase is active. */
     currentPhase: string | null;
+    /** Aggregate task status counts. */
     summary: TaskSummary;
+    /** Current task work focus state. */
     taskWork: {
         currentTask: string | null;
         task: TaskRecord | null;
     };
+    /** Currently active session ID, or `null`. */
     activeSession: string | null;
+    /** High-priority tasks requiring attention. */
     highPriority: {
         count: number;
         tasks: TaskRecord[];
     };
+    /** Blocked tasks that need unblocking. */
     blockedTasks: {
         count: number;
         limit: number;
         tasks: TaskRecord[];
     };
+    /** Recently completed tasks. */
     recentCompletions: TaskRecord[];
+    /** Most frequently used labels with counts. */
     topLabels: LabelCount[];
 }
 /** Current state counts used in stats results. */
 export interface StatsCurrentState {
+    /** Number of tasks in `pending` status. */
     pending: number;
+    /** Number of tasks in `active` status. */
     active: number;
+    /** Number of tasks in `done` status. */
     done: number;
+    /** Number of tasks in `blocked` status. */
     blocked: number;
+    /** Number of tasks in `cancelled` status. */
     cancelled: number;
+    /** Total active (non-done, non-cancelled) tasks. */
     totalActive: number;
+    /** Number of archived tasks. */
     archived: number;
+    /** Grand total including archived tasks. */
     grandTotal: number;
 }
 /** Completion metrics for a given time period. */
 export interface StatsCompletionMetrics {
+    /** Number of days in the measurement period. */
     periodDays: number;
+    /** Tasks completed within the period. */
     completedInPeriod: number;
+    /** Tasks created within the period. */
     createdInPeriod: number;
+    /** Completion rate as a ratio (0.0 to 1.0). */
     completionRate: number;
 }
 /** Activity metrics for a given time period. */
 export interface StatsActivityMetrics {
+    /** Tasks created within the period. */
     createdInPeriod: number;
+    /** Tasks completed within the period. */
     completedInPeriod: number;
+    /** Tasks archived within the period. */
     archivedInPeriod: number;
 }
 /** All-time cumulative statistics. */
 export interface StatsAllTime {
+    /** Total tasks ever created. */
     totalCreated: number;
+    /** Total tasks ever completed. */
     totalCompleted: number;
+    /** Total tasks ever cancelled. */
     totalCancelled: number;
+    /** Total tasks ever archived. */
     totalArchived: number;
+    /** Archived tasks that were in `done` status when archived. */
     archivedCompleted: number;
 }
 /** Cycle time statistics. */
 export interface StatsCycleTimes {
+    /** Average days from creation to completion, or `null` if no samples. */
     averageDays: number | null;
+    /** Number of completed tasks used to compute the average. */
     samples: number;
 }
 /** Stats result from system.stats query. */
 export interface StatsResult {
+    /** Current task status distribution. */
     currentState: StatsCurrentState;
+    /** Task count grouped by priority level. */
     byPriority: Record<string, number>;
+    /** Task count grouped by task type. */
     byType: Record<string, number>;
+    /** Task count grouped by phase slug. */
     byPhase: Record<string, number>;
+    /** Completion throughput for the measurement period. */
     completionMetrics: StatsCompletionMetrics;
+    /** Creation/completion/archive activity for the period. */
     activityMetrics: StatsActivityMetrics;
+    /** Cumulative all-time statistics. */
     allTime: StatsAllTime;
+    /** Average time from task creation to completion. */
     cycleTimes: StatsCycleTimes;
 }
 /** Log query result from system.log query. */
 export interface LogQueryResult {
+    /** Audit log entries matching the query. */
     entries: Array<{
         operation: string;
         taskId?: string;
         timestamp: string;
         [key: string]: unknown;
     }>;
+    /** Pagination metadata for the query result. */
     pagination: {
         total: number;
         offset: number;
@@ -110,13 +161,21 @@ export interface LogQueryResult {
 }
 /** Context monitoring data from system.context query. */
 export interface ContextResult {
+    /** Whether context monitoring is available for the current provider. */
     available: boolean;
+    /** Human-readable context usage status (e.g. `"healthy"`, `"warning"`). */
     status: string;
+    /** Context usage as a percentage (0-100). */
     percentage: number;
+    /** Estimated current token count. */
     currentTokens: number;
+    /** Maximum token capacity for the provider. */
     maxTokens: number;
+    /** ISO 8601 timestamp of the last context measurement. */
     timestamp: string | null;
+    /** Whether the context data is stale (older than threshold). */
     stale: boolean;
+    /** Per-session context usage breakdown. */
     sessions: Array<{
         file: string;
         sessionId: string | null;
@@ -127,15 +186,22 @@ export interface ContextResult {
 }
 /** Sequence counter data from system.sequence query. */
 export interface SequenceResult {
+    /** Current sequence counter value. */
     counter: number;
+    /** Last task ID generated. */
     lastId: string;
+    /** Integrity checksum of the sequence state. */
     checksum: string;
+    /** Next task ID that will be generated. */
     nextId: string;
 }
 /** Compact task reference used across analysis and dependency results. */
 export interface TaskRef {
+    /** Task identifier. */
     id: string;
+    /** Task title. */
     title: string;
+    /** Current task status string. */
     status: string;
 }
 /** Task reference with optional priority (used in orchestrator/HITL contexts). */
@@ -144,28 +210,42 @@ export type TaskRefPriority = Pick<TaskRef, 'id' | 'title'> & {
 };
 /** Task with leverage score for prioritization. */
 export interface LeveragedTask {
+    /** Task identifier. */
     id: string;
+    /** Task title. */
     title: string;
+    /** Leverage score (higher = more impactful to work on). */
     leverage: number;
+    /**
+     * Explanation of why this task has high leverage.
+     * @defaultValue undefined
+     */
     reason?: string;
 }
 /** Bottleneck task — blocks other tasks. */
 export interface BottleneckTask {
+    /** Task identifier. */
     id: string;
+    /** Task title. */
     title: string;
+    /** Number of other tasks blocked by this task. */
     blocksCount: number;
 }
 /** Task analysis result from tasks.analyze. */
 export interface TaskAnalysisResult {
+    /** Top recommended task to work on next, or `null` if none available. */
     recommended: (LeveragedTask & {
         reason: string;
     }) | null;
+    /** Tasks that block the most other tasks. */
     bottlenecks: BottleneckTask[];
+    /** Tasks grouped by priority tier. */
     tiers: {
         critical: LeveragedTask[];
         high: LeveragedTask[];
         normal: LeveragedTask[];
     };
+    /** Aggregate analysis metrics. */
     metrics: {
         totalTasks: number;
         actionable: number;
@@ -175,14 +255,23 @@ export interface TaskAnalysisResult {
 }
 /** Single task dependency result from tasks.deps. */
 export interface TaskDepsResult {
+    /** ID of the task whose dependencies were analyzed. */
     taskId: string;
+    /** Tasks that this task depends on. */
     dependsOn: TaskRef[];
+    /** Tasks that depend on this task. */
     dependedOnBy: TaskRef[];
+    /** Dependency IDs that reference non-existent tasks. */
     unresolvedDeps: string[];
+    /** Whether all dependencies are in a terminal status. */
     allDepsReady: boolean;
 }
 /** Completion result — unblocked tasks after completing a task. */
 export interface CompleteTaskUnblocked {
+    /**
+     * Tasks that became unblocked as a result of the completion.
+     * @defaultValue undefined
+     */
     unblockedTasks?: TaskRef[];
 }
 //# sourceMappingURL=results.d.ts.map

package/dist/results.d.ts.map

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

package/dist/session.d.ts

@@ -10,55 +10,126 @@ import type { SessionStatus } from './status-registry.js';
 export type { SessionStatus };
 /** Session scope JSON blob shape. */
 export interface SessionScope {
+    /** Scope type (e.g. `"global"`, `"epic"`, `"task"`, `"custom"`). */
     type: string;
+    /**
+     * Epic ID when scope type is `"epic"`.
+     * @defaultValue undefined
+     */
     epicId?: string;
+    /**
+     * Root task ID when scope is narrowed to a subtree.
+     * @defaultValue undefined
+     */
     rootTaskId?: string;
+    /**
+     * Whether to include descendant tasks of the root task.
+     * @defaultValue undefined
+     */
     includeDescendants?: boolean;
+    /**
+     * Phase slug to filter tasks by.
+     * @defaultValue undefined
+     */
     phaseFilter?: string | null;
+    /**
+     * Label filter to narrow the scope to specific labels.
+     * @defaultValue undefined
+     */
     labelFilter?: string[] | null;
+    /**
+     * Maximum hierarchy depth to include.
+     * @defaultValue undefined
+     */
     maxDepth?: number | null;
+    /**
+     * Explicit task IDs to include regardless of other filters.
+     * @defaultValue undefined
+     */
     explicitTaskIds?: string[] | null;
+    /**
+     * Task IDs to exclude from the scope.
+     * @defaultValue undefined
+     */
     excludeTaskIds?: string[] | null;
+    /**
+     * Task IDs computed from the scope definition at resolution time.
+     * @defaultValue undefined
+     */
     computedTaskIds?: string[];
+    /**
+     * ISO 8601 timestamp of when computed task IDs were last resolved.
+     * @defaultValue undefined
+     */
     computedAt?: string;
 }
 /** Session statistics. */
 export interface SessionStats {
+    /** Number of tasks completed during this session. */
     tasksCompleted: number;
+    /** Number of new tasks created during this session. */
     tasksCreated: number;
+    /** Number of task updates performed during this session. */
     tasksUpdated: number;
+    /** Number of times the focus task was changed. */
     focusChanges: number;
+    /** Total minutes the session was in active status. */
     totalActiveMinutes: number;
+    /** Number of times the session was suspended and resumed. */
     suspendCount: number;
 }
 /** Active task work state within a session. */
 export interface SessionTaskWork {
+    /** ID of the task currently being worked on, or `null` if none. */
     taskId: string | null;
+    /** ISO 8601 timestamp of when the current task was set, or `null`. */
     setAt: string | null;
 }
 /** Session domain type — plain interface aligned with Drizzle sessions table. */
 export interface Session {
+    /** Unique session identifier (e.g. `"ses_20260401..."`) . */
     id: string;
+    /** Human-readable session name. */
     name: string;
+    /** Current session lifecycle status. */
     status: SessionStatus;
+    /** Scope definition controlling which tasks are visible. */
     scope: SessionScope;
+    /** Active task work state within the session. */
     taskWork: SessionTaskWork;
+    /** ISO 8601 timestamp of when the session started. */
     startedAt: string;
+    /** ISO 8601 timestamp of when the session ended. @defaultValue undefined */
     endedAt?: string;
+    /** Agent identifier that owns this session. @defaultValue undefined */
     agent?: string;
+    /** Timestamped notes appended during the session. @defaultValue undefined */
     notes?: string[];
+    /** IDs of tasks completed during this session. @defaultValue undefined */
     tasksCompleted?: string[];
+    /** IDs of tasks created during this session. @defaultValue undefined */
     tasksCreated?: string[];
+    /** Serialized handoff JSON for session continuity. @defaultValue undefined */
     handoffJson?: string | null;
+    /** ID of the session that preceded this one. @defaultValue undefined */
     previousSessionId?: string | null;
+    /** ID of the session that follows this one. @defaultValue undefined */
     nextSessionId?: string | null;
+    /** Provider-specific agent identifier string. @defaultValue undefined */
     agentIdentifier?: string | null;
+    /** ISO 8601 timestamp of when the handoff was consumed. @defaultValue undefined */
     handoffConsumedAt?: string | null;
+    /** Agent that consumed the handoff. @defaultValue undefined */
     handoffConsumedBy?: string | null;
+    /** Serialized debrief JSON from session end. @defaultValue undefined */
     debriefJson?: string | null;
+    /** Aggregate session statistics. @defaultValue undefined */
     stats?: SessionStats;
+    /** Number of times this session has been resumed. @defaultValue undefined */
     resumeCount?: number;
+    /** Whether this session is in grade/evaluation mode. @defaultValue undefined */
     gradeMode?: boolean;
+    /** ID of the provider adapter used for this session. @defaultValue undefined */
     providerId?: string | null;
 }
 /**
@@ -68,7 +139,9 @@ export interface Session {
  * provided for consumers that expect it at the top level of the result.
  */
 export interface SessionStartResult {
+    /** The newly created or resumed session. */
     session: Session;
+    /** Convenience alias for `session.id`. */
     sessionId: string;
 }
 /**
@@ -76,6 +149,11 @@ export interface SessionStartResult {
  *
  * Provides discoverable query methods for common session lookups.
  * Does NOT change the DataAccessor interface — consumers create views from Session[].
+ *
+ * @remarks
+ * SessionView is a read-only collection wrapper that provides convenience
+ * methods for filtering, searching, and sorting sessions. It does not own
+ * the data and performs no mutations on the underlying array.
  */
 export declare class SessionView {
     private readonly _sessions;

package/dist/session.d.ts.map

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

package/dist/session.js

@@ -11,6 +11,11 @@
  *
  * Provides discoverable query methods for common session lookups.
  * Does NOT change the DataAccessor interface — consumers create views from Session[].
+ *
+ * @remarks
+ * SessionView is a read-only collection wrapper that provides convenience
+ * methods for filtering, searching, and sorting sessions. It does not own
+ * the data and performs no mutations on the underlying array.
  */
 export class SessionView {
     _sessions;

package/dist/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0EH;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IACL,SAAS,CAAY;IAEtC,YAAY,QAAmB;QAC7B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,MAAM,CAAC,IAAI,CAAC,QAAmB;QAC7B,OAAO,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,2CAA2C;IAC3C,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,kDAAkD;IAClD,UAAU;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,4BAA4B;IAC5B,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,+CAA+C;IAC/C,cAAc,CAAC,GAAG,QAAyB;QACzC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,QAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,mEAAmE;IACnE,WAAW,CAAC,IAAY,EAAE,UAAmB;QAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACjC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACzC,IAAI,UAAU,IAAI,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU;gBAAE,OAAO,KAAK,CAAC;YACnE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,UAAU,CAAC,KAA8B,EAAE,UAAU,GAAG,IAAI;QAC1D,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACjD,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,UAAU;QACR,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAClD,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,4DAA4D;IAC5D,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,gCAAgC;IAChC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC3C,CAAC;CACF"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmJH;;;;;;;;;;GAUG;AACH,MAAM,OAAO,WAAW;IACL,SAAS,CAAY;IAEtC,YAAY,QAAmB;QAC7B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAED,iDAAiD;IACjD,MAAM,CAAC,IAAI,CAAC,QAAmB;QAC7B,OAAO,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,2CAA2C;IAC3C,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,kDAAkD;IAClD,UAAU;QACR,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,4BAA4B;IAC5B,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,+CAA+C;IAC/C,cAAc,CAAC,GAAG,QAAyB;QACzC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,QAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,mEAAmE;IACnE,WAAW,CAAC,IAAY,EAAE,UAAmB;QAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACjC,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YACzC,IAAI,UAAU,IAAI,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU;gBAAE,OAAO,KAAK,CAAC;YACnE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,UAAU,CAAC,KAA8B,EAAE,UAAU,GAAG,IAAI;QAC1D,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACjD,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,UAAU;QACR,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAClD,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,4DAA4D;IAC5D,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,gCAAgC;IAChC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC3C,CAAC;CACF"}

package/dist/status-registry.d.ts

@@ -6,7 +6,7 @@
  *
  * Dependency direction:
  *   status-registry.ts → schema.ts, types/task.ts, validation/engine.ts,
- *                         mcp/lib/security.ts, dispatch/lib/security.ts, ...
+ *                         dispatch/lib/security.ts, ...
  */
 export declare const TASK_STATUSES: readonly ["pending", "active", "blocked", "done", "cancelled", "archived"];
 export declare const SESSION_STATUSES: readonly ["active", "ended", "orphaned", "suspended"];

package/dist/status-registry.js

@@ -6,7 +6,7 @@
  *
  * Dependency direction:
  *   status-registry.ts → schema.ts, types/task.ts, validation/engine.ts,
- *                         mcp/lib/security.ts, dispatch/lib/security.ts, ...
+ *                         dispatch/lib/security.ts, ...
  */
 // === WORKFLOW NAMESPACE ===
 // Statuses for entities representing work being performed.