@nestos/kanban 0.0.0-stage → 0.5.2

package/dist/activity-Czlan5xW.d.ts

@@ -0,0 +1,258 @@
+import { u as KanbanExternalReference, y as KanbanItemQuery, x as KanbanItemPage, z as KanbanItemSummary, r as KanbanDispatch, T as KanbanService, v as KanbanFixSession, f as KanbanAutomationCatalog, b as KanbanAnalysisStatus } from './planning-CHrOqQ6b.js';
+
+/** Hosts resolve opaque resources and execute records; the library owns no project policy. */
+interface KanbanRecordResource {
+    reference: KanbanExternalReference;
+    label: string;
+}
+interface KanbanItemResourceCatalog {
+    resources: KanbanRecordResource[];
+    selected?: KanbanExternalReference;
+    required?: boolean;
+    readonly?: boolean;
+}
+interface KanbanRecordExecution {
+    id: string;
+    recordId: string;
+    recordRevision: number;
+    boardId: string;
+    rootItemId?: string;
+    itemIds?: string[];
+    state: 'preparing' | 'running' | 'blocked' | 'review' | 'completed' | 'failed' | 'cancelling' | 'cancelled' | 'pausing' | 'paused' | 'resuming' | 'unknown';
+    createdAt: number;
+    updatedAt: number;
+    code?: string;
+}
+interface KanbanRecordRunRequest {
+    operationId: string;
+    recordId: string;
+    expectedRevision: number;
+    placement?: 'current-board' | 'new-board';
+}
+
+/** Host-owned execution resources; the coordination library does not interpret their backend. */
+interface KanbanWorkResource {
+    id: string;
+    kind: string;
+    title: string;
+    location: string;
+    version: string;
+    ownership?: 'current' | 'other' | 'unknown';
+    state: 'associated' | 'in-use' | 'retained' | 'cleanup-ready' | 'cleaned' | 'unknown';
+    reasons: string[];
+    properties: Array<{
+        label: string;
+        value: string;
+    }>;
+    canCleanup: boolean;
+}
+interface KanbanWorkResourceQuery {
+    inspect?: boolean;
+}
+interface KanbanWorkResourceCleanup {
+    operationId: string;
+    itemId: string;
+    resourceId: string;
+    version: string;
+}
+
+interface KanbanOperationChoice {
+    id: string;
+    label: string;
+    detail?: string;
+}
+interface KanbanOperationField {
+    id: string;
+    label: string;
+    choices: KanbanOperationChoice[];
+    selected?: string;
+}
+/** Host-owned operations; the portable view does not interpret deployment or Git policy. */
+interface KanbanItemOperation {
+    id: string;
+    label: string;
+    state: 'unavailable' | 'ready' | 'running' | 'unknown' | 'succeeded' | 'failed' | 'waiting-confirmation';
+    enabled: boolean;
+    code?: string;
+    reason?: string;
+    runId?: string;
+    sessionId?: string;
+    summary?: string;
+    fields?: KanbanOperationField[];
+    confirmation?: string;
+    configurable?: boolean;
+    binding?: KanbanExternalReference;
+    openSessionOnRun?: boolean;
+}
+interface KanbanItemOperations {
+    revision: string;
+    operations: KanbanItemOperation[];
+    targets?: Array<{
+        label: string;
+        reference: KanbanExternalReference;
+    }>;
+}
+interface KanbanItemOperationRequest {
+    operationId: string;
+    itemId: string;
+    action: string;
+    expectedRevision: string;
+    selections?: Record<string, string>;
+    confirmed?: boolean;
+}
+interface KanbanItemOperationBinding {
+    operationId: string;
+    itemId: string;
+    action: string;
+    expectedRevision: string;
+    target: KanbanExternalReference;
+}
+
+interface KanbanDeletionPreview {
+    boardId: string;
+    title: string;
+    revision: number;
+    version: string;
+    blockers: Array<{
+        code: string;
+        itemId?: string;
+        sessionId?: string;
+    }>;
+    pendingItems: number;
+    pendingDeletion?: {
+        operationId: string;
+        mode: 'drain' | 'cancel';
+        phase: 'waiting' | 'ready' | 'blocked';
+        code?: string;
+    };
+    /** Display labels for items referenced by blockers and resources. */
+    itemTitles?: Record<string, string>;
+    resources: Array<{
+        itemId: string;
+        resource: KanbanWorkResource;
+    }>;
+}
+interface KanbanDeletionRequest {
+    operationId: string;
+    version: string;
+    expectedRevision: number;
+    cleanup: boolean;
+}
+
+type KanbanSessionPhase = 'running' | 'queued' | 'waiting' | 'waiting-input' | 'waiting-approval' | 'paused' | 'idle' | 'completed' | 'failed' | 'cancelled' | 'unknown';
+interface KanbanExecutionSession {
+    sessionId: string;
+    resourceId?: string;
+    title?: string;
+    state: KanbanSessionPhase;
+    createdAt?: number;
+    lastActivityAt?: number;
+    observedAt?: number;
+    stale: boolean;
+    recent: boolean;
+    code?: string;
+}
+interface KanbanSessionActivityQuery extends KanbanItemQuery {
+    execution?: 'all' | 'running' | 'recent' | 'active';
+}
+interface KanbanSessionItemSummary extends KanbanItemSummary {
+    execution?: KanbanExecutionSession;
+}
+interface KanbanSessionItemPage extends Omit<KanbanItemPage, 'items'> {
+    items: KanbanSessionItemSummary[];
+}
+type KanbanSessionPurpose = 'execution' | 'planning' | 'fix' | 'finalization' | 'discussion';
+/** A run belongs to a Session; continuing it does not create another Session. */
+interface KanbanSessionExecution {
+    id: string;
+    purpose: KanbanSessionPurpose;
+    dispatchId?: string;
+    attempt?: number;
+    previousDispatchId?: string;
+    roundId?: string;
+    turnId?: string;
+    state?: KanbanSessionPhase;
+    outcome?: KanbanDispatch['outcome'];
+    createdAt?: number;
+    completedAt?: number;
+    code?: string;
+    resources?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+interface KanbanSessionAssociation {
+    sessionId: string;
+    purpose: KanbanSessionPurpose;
+    execution?: KanbanSessionExecution;
+}
+interface KanbanRelatedSession extends KanbanExecutionSession {
+    current: boolean;
+    purposes: KanbanSessionPurpose[];
+    executions: KanbanSessionExecution[];
+}
+interface KanbanSessionDetailQuery {
+    includeRelated?: boolean;
+}
+interface KanbanExecutionSessionDetail {
+    continuation?: {
+        previousDispatchId: string;
+    };
+    current?: KanbanExecutionSession;
+    history: Array<{
+        sessionId: string;
+        bindingId?: string;
+        current: boolean;
+    }>;
+    /** Loaded explicitly so activity polling never enumerates historical Sessions. */
+    sessions?: KanbanRelatedSession[];
+    sessionsCode?: string;
+}
+/** Transport-facing service with optional authorized resource activity. */
+interface KanbanClient extends KanbanService {
+    cancelBoard?(boardId: string, request: {
+        operationId: string;
+        expectedRevision: number;
+    }): Promise<void>;
+    requestBoardDeletion?(boardId: string, request: KanbanDeletionRequest & {
+        mode: 'drain' | 'cancel';
+    }): Promise<void>;
+    previewDeletion?(boardId: string): Promise<KanbanDeletionPreview>;
+    deleteBoard?(boardId: string, request: KanbanDeletionRequest): Promise<void>;
+    itemOperations?(boardId: string, itemId: string): Promise<KanbanItemOperations>;
+    runItemOperation?(boardId: string, request: KanbanItemOperationRequest): Promise<KanbanItemOperations>;
+    bindItemOperation?(boardId: string, request: KanbanItemOperationBinding): Promise<KanbanItemOperations>;
+    workResources?(boardId: string, itemId: string, query?: KanbanWorkResourceQuery): Promise<KanbanWorkResource[]>;
+    cleanupWorkResource?(boardId: string, request: KanbanWorkResourceCleanup): Promise<KanbanWorkResource>;
+    replyTask?(boardId: string, request: {
+        itemId: string;
+        attemptId: string;
+        replyTo: string;
+        operationId: string;
+        content: string;
+    }): Promise<void>;
+    taskFixes?(boardId: string, itemId: string): Promise<KanbanFixSession[]>;
+    cancelFix?(boardId: string, request: {
+        fixId: string;
+        operationId: string;
+    }): Promise<KanbanFixSession>;
+    controlRecord?(boardId: string, request: {
+        recordId: string;
+        operationId: string;
+        action: 'pause' | 'resume' | 'cancel';
+    }): Promise<void>;
+    fixTask?(boardId: string, request: {
+        itemId: string;
+        operationId: string;
+    }): Promise<KanbanFixSession>;
+    itemResources?(boardId: string, parentId?: string): Promise<KanbanItemResourceCatalog>;
+    recordResources?(): Promise<KanbanRecordResource[]>;
+    runRecord?(boardId: string, request: KanbanRecordRunRequest): Promise<KanbanRecordExecution>;
+    recordExecutions?(boardId: string, recordId: string): Promise<KanbanRecordExecution[]>;
+    automationCatalog?(): Promise<KanbanAutomationCatalog>;
+    analysisStatus?(boardId: string, itemId: string): Promise<KanbanAnalysisStatus | null>;
+    queryActivity?(boardId: string, query?: KanbanSessionActivityQuery): Promise<KanbanSessionItemPage>;
+    executionSession?(boardId: string, itemId: string, query?: KanbanSessionDetailQuery): Promise<KanbanExecutionSessionDetail>;
+}
+
+export type { KanbanClient as K, KanbanDeletionPreview as a, KanbanDeletionRequest as b, KanbanExecutionSession as c, KanbanExecutionSessionDetail as d, KanbanItemOperation as e, KanbanItemOperationBinding as f, KanbanItemOperationRequest as g, KanbanItemOperations as h, KanbanItemResourceCatalog as i, KanbanOperationChoice as j, KanbanOperationField as k, KanbanRecordExecution as l, KanbanRecordResource as m, KanbanRecordRunRequest as n, KanbanRelatedSession as o, KanbanSessionActivityQuery as p, KanbanSessionAssociation as q, KanbanSessionDetailQuery as r, KanbanSessionExecution as s, KanbanSessionItemPage as t, KanbanSessionItemSummary as u, KanbanSessionPhase as v, KanbanSessionPurpose as w, KanbanWorkResource as x, KanbanWorkResourceCleanup as y, KanbanWorkResourceQuery as z };

package/dist/activity-module-DaO1Rry0.d.cts

@@ -0,0 +1,22 @@
+import { p as KanbanSessionActivityQuery, t as KanbanSessionItemPage, r as KanbanSessionDetailQuery, d as KanbanExecutionSessionDetail } from './activity-BbC4sgKL.cjs';
+import { K as KanbanModuleHandle } from './module-Ca9L3qCn.cjs';
+import { K as KanbanModuleOptions } from './ports-GQy0x-RI.cjs';
+import { K as KanbanSessionSource } from './activity-ports-Dqxa86zT.cjs';
+
+interface KanbanSessionActivityOptions {
+    source: KanbanSessionSource;
+    now?: () => number;
+}
+
+interface KanbanActivityModuleOptions extends KanbanModuleOptions {
+    executionSessions?: KanbanSessionActivityOptions;
+    referenceSystem: string;
+}
+interface KanbanActivityHandle extends KanbanModuleHandle {
+    queryActivity: (boardId: string, query?: KanbanSessionActivityQuery) => Promise<KanbanSessionItemPage>;
+    executionSession: (boardId: string, itemId: string, query?: KanbanSessionDetailQuery) => Promise<KanbanExecutionSessionDetail>;
+}
+/** Application integrations stay outside the portable core. */
+declare function createKanbanActivityModule(options: KanbanActivityModuleOptions): KanbanActivityHandle;
+
+export { type KanbanActivityHandle as K, type KanbanActivityModuleOptions as a, type KanbanSessionActivityOptions as b, createKanbanActivityModule as c };

package/dist/activity-module-T22wliZu.d.ts

@@ -0,0 +1,22 @@
+import { p as KanbanSessionActivityQuery, t as KanbanSessionItemPage, r as KanbanSessionDetailQuery, d as KanbanExecutionSessionDetail } from './activity-Czlan5xW.js';
+import { K as KanbanModuleHandle } from './module-CYfE7YhM.js';
+import { K as KanbanModuleOptions } from './ports-B0McVg7B.js';
+import { K as KanbanSessionSource } from './activity-ports-cxfrelaL.js';
+
+interface KanbanSessionActivityOptions {
+    source: KanbanSessionSource;
+    now?: () => number;
+}
+
+interface KanbanActivityModuleOptions extends KanbanModuleOptions {
+    executionSessions?: KanbanSessionActivityOptions;
+    referenceSystem: string;
+}
+interface KanbanActivityHandle extends KanbanModuleHandle {
+    queryActivity: (boardId: string, query?: KanbanSessionActivityQuery) => Promise<KanbanSessionItemPage>;
+    executionSession: (boardId: string, itemId: string, query?: KanbanSessionDetailQuery) => Promise<KanbanExecutionSessionDetail>;
+}
+/** Application integrations stay outside the portable core. */
+declare function createKanbanActivityModule(options: KanbanActivityModuleOptions): KanbanActivityHandle;
+
+export { type KanbanActivityHandle as K, type KanbanActivityModuleOptions as a, type KanbanSessionActivityOptions as b, createKanbanActivityModule as c };

package/dist/activity-ports-Dqxa86zT.d.cts

@@ -0,0 +1,12 @@
+import { j as KanbanBoard, w as KanbanItem, a7 as KanbanWorkflowState } from './planning-CHrOqQ6b.cjs';
+import { q as KanbanSessionAssociation, c as KanbanExecutionSession } from './activity-BbC4sgKL.cjs';
+
+interface KanbanSessionSource {
+    /** Cold, authorized relations only; never submit or restore execution while listing. */
+    related?(board: KanbanBoard, item: KanbanItem, workflow: KanbanWorkflowState): Promise<KanbanSessionAssociation[]>;
+    authorizeBinding?(board: KanbanBoard, sessionId: string): Promise<void>;
+    /** Must check access within the supplied board's user/project and authority. */
+    inspect(board: KanbanBoard, sessionId: string): Promise<Omit<KanbanExecutionSession, 'recent'>>;
+}
+
+export type { KanbanSessionSource as K };

package/dist/activity-ports-cxfrelaL.d.ts

@@ -0,0 +1,12 @@
+import { j as KanbanBoard, w as KanbanItem, a7 as KanbanWorkflowState } from './planning-CHrOqQ6b.js';
+import { q as KanbanSessionAssociation, c as KanbanExecutionSession } from './activity-Czlan5xW.js';
+
+interface KanbanSessionSource {
+    /** Cold, authorized relations only; never submit or restore execution while listing. */
+    related?(board: KanbanBoard, item: KanbanItem, workflow: KanbanWorkflowState): Promise<KanbanSessionAssociation[]>;
+    authorizeBinding?(board: KanbanBoard, sessionId: string): Promise<void>;
+    /** Must check access within the supplied board's user/project and authority. */
+    inspect(board: KanbanBoard, sessionId: string): Promise<Omit<KanbanExecutionSession, 'recent'>>;
+}
+
+export type { KanbanSessionSource as K };

package/dist/activity.cjs

@@ -0,0 +1,16 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunk5Q7WB63Acjs = require('./chunk-5Q7WB63A.cjs');
+require('./chunk-DINLR6E6.cjs');
+require('./chunk-EYTVC2H5.cjs');
+require('./chunk-4XF6LQSU.cjs');
+require('./chunk-RBOER6EW.cjs');
+require('./chunk-7KDOTBRX.cjs');
+require('./chunk-RSH6QSEC.cjs');
+require('./chunk-AOHQCX7K.cjs');
+
+
+
+exports.createKanbanActivityModule = _chunk5Q7WB63Acjs.createKanbanActivityModule; exports.querySessionItems = _chunk5Q7WB63Acjs.querySessionItems;
+//# sourceMappingURL=activity.cjs.map

package/dist/activity.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/li/share/prj/x1/libraries/kanban/dist/activity.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACF,mJAAC","file":"/home/li/share/prj/x1/libraries/kanban/dist/activity.cjs"}

package/dist/activity.d.cts

@@ -0,0 +1,12 @@
+export { K as KanbanActivityHandle, a as KanbanActivityModuleOptions, b as KanbanSessionActivityOptions, c as createKanbanActivityModule } from './activity-module-DaO1Rry0.cjs';
+export { K as KanbanSessionSource } from './activity-ports-Dqxa86zT.cjs';
+import { T as KanbanService } from './planning-CHrOqQ6b.cjs';
+import { p as KanbanSessionActivityQuery, u as KanbanSessionItemSummary, t as KanbanSessionItemPage } from './activity-BbC4sgKL.cjs';
+import './module-Ca9L3qCn.cjs';
+import './ports-GQy0x-RI.cjs';
+import './discovery-9E-LfwIw.cjs';
+
+/** Filter before pagination; Session activity changes invalidate the filtered keyset. */
+declare function querySessionItems(core: KanbanService, boardId: string, input: KanbanSessionActivityQuery, project: (rows: KanbanSessionItemSummary[]) => Promise<KanbanSessionItemSummary[]>): Promise<KanbanSessionItemPage>;
+
+export { querySessionItems };

package/dist/activity.d.ts

@@ -0,0 +1,12 @@
+export { K as KanbanActivityHandle, a as KanbanActivityModuleOptions, b as KanbanSessionActivityOptions, c as createKanbanActivityModule } from './activity-module-T22wliZu.js';
+export { K as KanbanSessionSource } from './activity-ports-cxfrelaL.js';
+import { T as KanbanService } from './planning-CHrOqQ6b.js';
+import { p as KanbanSessionActivityQuery, u as KanbanSessionItemSummary, t as KanbanSessionItemPage } from './activity-Czlan5xW.js';
+import './module-CYfE7YhM.js';
+import './ports-B0McVg7B.js';
+import './discovery-D60yrjej.js';
+
+/** Filter before pagination; Session activity changes invalidate the filtered keyset. */
+declare function querySessionItems(core: KanbanService, boardId: string, input: KanbanSessionActivityQuery, project: (rows: KanbanSessionItemSummary[]) => Promise<KanbanSessionItemSummary[]>): Promise<KanbanSessionItemPage>;
+
+export { querySessionItems };

package/dist/activity.js

@@ -0,0 +1,16 @@
+import {
+  createKanbanActivityModule,
+  querySessionItems
+} from "./chunk-FNO5K3A7.js";
+import "./chunk-KH3WF3K4.js";
+import "./chunk-XKDZHAUE.js";
+import "./chunk-RQP77ZTY.js";
+import "./chunk-3LEIHB7Y.js";
+import "./chunk-X4UHZX6F.js";
+import "./chunk-M35X5PHO.js";
+import "./chunk-3JYLJPE5.js";
+export {
+  createKanbanActivityModule,
+  querySessionItems
+};
+//# sourceMappingURL=activity.js.map

package/dist/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-3JYLJPE5.js

@@ -0,0 +1,95 @@
+// src/contracts/board-control.ts
+function boardAllowsStart(board, item) {
+  return !board.lifecycle && !board.executionControl?.paused && (board.executionControl?.mode !== "manual" || item?.launch?.requestedAt !== void 0);
+}
+function boardControlPhase(board) {
+  if (board.lifecycle) return board.lifecycle.intent === "delete" ? "waiting-deletion" : board.lifecycle.phase === "ready" ? "cancelled" : "cancelling";
+  const policy = board.executionControl;
+  const controls = Object.entries(policy?.controls ?? {}).flatMap(([id, controlId]) => {
+    const item = board.items.find((item2) => item2.id === id);
+    return item && !["completed", "cancelled", "review"].includes(item.status) && item.control?.id === controlId ? [item.control] : [];
+  });
+  if (controls.some((control) => control?.state === "failed" || control?.state === "unknown")) return "error";
+  if (controls.some((control) => control?.state === "requested" || control?.state === "accepted")) return policy?.paused ? "pausing" : "resuming";
+  return policy?.paused ? "paused" : policy?.mode ?? "automatic";
+}
+
+// src/contracts/task-projection.ts
+var TASK_START_DELAY_MS = 3e5;
+function taskStartAt(item) {
+  return item.launch?.startAt ?? item.createdAt + TASK_START_DELAY_MS;
+}
+function taskEditing(item, now) {
+  return (item.launch?.editing?.expiresAt ?? 0) > now;
+}
+function taskDue(item, now) {
+  return !taskEditing(item, now) && !item.blocked && (!item.control || item.control.action === "resume" && item.control.state === "resumed") && (item.launch?.requestedAt !== void 0 || item.launch?.mode !== "manual" && taskStartAt(item) <= now);
+}
+function projectKanbanTask(item, workflow, now = Date.now(), all = []) {
+  const dispatch = Object.values(workflow?.dispatches ?? {}).filter((d) => d.itemId === item.id).sort((a, b) => b.attempt - a.attempt)[0];
+  const fact = terminalFact(item) ?? controlFact(item) ?? issueFact(item, dispatch) ?? failureFact(item, dispatch) ?? executionFact(item, dispatch) ?? waitingFact(item, now, all);
+  const extra = [];
+  if (!["completed", "cancelled"].includes(item.status) && item.control?.action !== "cancel") {
+    if (!fact.actions?.includes("cancel")) extra.push("cancel");
+    if (item.status !== "review" && !fact.actions?.includes("pause") && !fact.actions?.includes("resume") && (dispatch?.controlCapabilities?.pause === "boundary" || !dispatch)) extra.push("pause");
+  }
+  return {
+    ...fact,
+    startAt: taskStartAt(item),
+    dispatchId: dispatch?.id,
+    sessionId: dispatch?.executionSessionId,
+    actions: item.deletedAt === void 0 ? [...fact.actions ?? [], ...extra, ...dispatch || item.launch?.admittedAt !== void 0 || ["claimed", "review", "completed"].includes(item.status) ? ["fix"] : [], ...dispatch?.executionSessionId ? ["open-session"] : []] : []
+  };
+}
+function terminalFact(item) {
+  if (item.status === "completed" || item.status === "cancelled") return { phase: item.status, actions: ["delete"] };
+  if (item.control?.action === "cancel") return { phase: item.control.state === "failed" ? "error" : item.control.state === "unknown" ? "unknown" : "cancelling", reason: item.control.code, actions: item.control.state === "failed" ? ["cancel"] : [] };
+  if (item.status === "review") return { phase: "review", actions: ["review"] };
+}
+function issueFact(item, dispatch) {
+  const issue = item.issues?.find((i) => !i.resolvedBy && (!dispatch || i.attemptId === dispatch.id));
+  if (issue) return { phase: issue.type === "clarification" ? "waiting-input" : "error", reason: issue.id, actions: ["resolve"] };
+}
+function controlFact(item) {
+  const control = item.control;
+  if (!control) return;
+  const reason = control.code;
+  if (control.state === "unknown") return { phase: "unknown", reason };
+  if (control.state === "failed") return { phase: "error", reason, actions: ["resume"] };
+  if (control.action === "pause") return { phase: control.state === "paused" ? "paused" : "pausing", reason, actions: ["resume"] };
+  if (["requested", "accepted"].includes(control.state)) return { phase: "resuming", reason };
+}
+function failureFact(item, dispatch) {
+  if (dispatch?.outcome === "unknown" || item.analysis?.state === "unknown") return { phase: "unknown", reason: dispatch?.code ?? item.analysis?.code };
+  if (dispatch && ["failed", "cancelled", "rejected"].includes(dispatch.outcome)) return { phase: "error", reason: dispatch.code ?? dispatch.outcome };
+  if (item.analysis?.state === "failed") return { phase: "error", reason: item.analysis.code };
+}
+function executionFact(item, dispatch) {
+  if (item.blocked) return { phase: item.blocked.reason === "WORKSPACE_INPUT_REQUIRED" ? "waiting-input" : "error", reason: item.blocked.reason };
+  if (dispatch?.outcome === "prepared") return { phase: "preparing" };
+  if (dispatch?.outcome === "running" || item.status === "claimed") return { phase: "running", actions: dispatch?.controlCapabilities?.pause === "boundary" ? ["pause"] : [] };
+}
+function waitingFact(item, now, all) {
+  const analysis = analysisFact(item);
+  if (analysis) return analysis;
+  const dependency = item.planning?.dependencies.find((id) => all.find((i) => i.id === id)?.status !== "completed");
+  if (dependency) return { phase: "waiting-dependency", reason: "DEPENDENCY_UNFINISHED:" + dependency, actions: item.launch?.admittedAt === void 0 ? ["edit", "cancel"] : [] };
+  if (taskEditing(item, now)) return { phase: "waiting-start", reason: "EDIT_LEASE_ACTIVE" };
+  if (item.launch?.admittedAt !== void 0) return { phase: "queued" };
+  return { phase: "waiting-start", reason: item.launch?.mode === "manual" ? "MANUAL_START_REQUIRED" : taskDue(item, now) ? "ADMISSION_PENDING" : "START_AT_PENDING", actions: ["run", "edit", "pause", "cancel"] };
+}
+function analysisFact(item) {
+  if (item.analysis?.state === "clarification") return { phase: "waiting-input", reason: item.analysis.reason };
+  if (item.analysis?.state === "analyzing") return { phase: "analyzing" };
+}
+
+export {
+  boardAllowsStart,
+  boardControlPhase,
+  TASK_START_DELAY_MS,
+  taskStartAt,
+  taskEditing,
+  taskDue,
+  projectKanbanTask
+};
+//# sourceMappingURL=chunk-3JYLJPE5.js.map

package/dist/chunk-3JYLJPE5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contracts/board-control.ts","../src/contracts/task-projection.ts"],"sourcesContent":["import type {KanbanBoard, KanbanItem} from './contracts';\n\nexport interface KanbanBoardControl {\n    mode: 'automatic' | 'manual'; paused: boolean;\n    controls: Record<string, string>;\n}\n/** Manual mode still honors an explicit per-task run request. */\nexport function boardAllowsStart(board: Pick<KanbanBoard, 'executionControl' | 'lifecycle'>, item?: Pick<KanbanItem, 'launch'>): boolean {\n    return !board.lifecycle && !board.executionControl?.paused && (board.executionControl?.mode !== 'manual' || item?.launch?.requestedAt !== undefined);\n}\nexport function boardControlPhase(board: Pick<KanbanBoard, 'executionControl' | 'lifecycle'> & {items: Array<Pick<KanbanItem, 'id' | 'status' | 'control'>>}): 'automatic' | 'manual' | 'pausing' | 'paused' | 'resuming' | 'error' | 'cancelling' | 'cancelled' | 'waiting-deletion' {\n    if (board.lifecycle) return board.lifecycle.intent === 'delete' ? 'waiting-deletion' : board.lifecycle.phase === 'ready' ? 'cancelled' : 'cancelling';\n    const policy = board.executionControl;\n    const controls = Object.entries(policy?.controls ?? {}).flatMap(([id, controlId]) => {\n        const item = board.items.find(item => item.id === id);\n        return item && !['completed', 'cancelled', 'review'].includes(item.status) && item.control?.id === controlId ? [item.control] : [];\n    });\n    if (controls.some(control => control?.state === 'failed' || control?.state === 'unknown')) return 'error';\n    if (controls.some(control => control?.state === 'requested' || control?.state === 'accepted')) return policy?.paused ? 'pausing' : 'resuming';\n    return policy?.paused ? 'paused' : policy?.mode ?? 'automatic';\n}\n","import type {KanbanDispatch,KanbanItem,KanbanItemSummary,KanbanWorkflowState,KanbanTaskProjection,KanbanTaskPhase} from './index';\n\ntype Item=Pick<KanbanItem,'deletedAt'|'id'|'status'|'createdAt'|'launch'|'analysis'|'control'|'issues'|'blocked'|'externalRefs'|'planning'>;\ntype Fact={phase:KanbanTaskPhase;reason?:string;actions?:KanbanTaskProjection['actions']};\nexport const TASK_START_DELAY_MS=300000;\nexport function taskStartAt(item:Pick<Item,'createdAt'|'launch'>):number {return item.launch?.startAt??item.createdAt+TASK_START_DELAY_MS;}\nexport function taskEditing(item:Pick<Item,'launch'>,now:number):boolean {return (item.launch?.editing?.expiresAt??0)>now;}\nexport function taskDue(item:Item,now:number):boolean {\n    return !taskEditing(item,now)&&!item.blocked&&(!item.control || item.control.action === 'resume' && item.control.state === 'resumed')\n        &&(item.launch?.requestedAt!==undefined||item.launch?.mode!=='manual'&&taskStartAt(item)<=now);\n}\n/** Ordered evidence projection shared by storage queries, CLI and UI. Session idle never proves acceptance. */\nexport function projectKanbanTask(item:Item,workflow?:KanbanWorkflowState,now=Date.now(),all:Array<Pick<KanbanItemSummary,'id'|'status'>>=[]):KanbanTaskProjection {\n    const dispatch=Object.values(workflow?.dispatches??{}).filter(d=>d.itemId===item.id).sort((a,b)=>b.attempt-a.attempt)[0];\n    const fact=terminalFact(item)??controlFact(item)??issueFact(item,dispatch)??failureFact(item,dispatch)??executionFact(item,dispatch)??waitingFact(item,now,all);\n    const extra: KanbanTaskProjection['actions'] = [];\n    if (!['completed','cancelled'].includes(item.status) && item.control?.action !== 'cancel') {\n        if (!fact.actions?.includes('cancel')) extra.push('cancel');\n        if (item.status !== 'review' && !fact.actions?.includes('pause') && !fact.actions?.includes('resume') && (dispatch?.controlCapabilities?.pause === 'boundary' || !dispatch)) extra.push('pause');\n    }\n    return {...fact,startAt:taskStartAt(item),dispatchId:dispatch?.id,sessionId:dispatch?.executionSessionId,\n        actions:item.deletedAt === undefined ? [...fact.actions??[],...extra,...(dispatch||item.launch?.admittedAt!==undefined||['claimed','review','completed'].includes(item.status)?['fix' as const]:[]),...(dispatch?.executionSessionId?['open-session' as const]:[])] : []};\n}\nfunction terminalFact(item:Item):Fact|undefined {\n    if(item.status==='completed'||item.status==='cancelled')return {phase:item.status,actions:['delete']};\n    if(item.control?.action==='cancel')return {phase:item.control.state==='failed'?'error':item.control.state==='unknown'?'unknown':'cancelling',reason:item.control.code,actions:item.control.state==='failed'?['cancel']:[]};\n    if(item.status==='review')return {phase:'review',actions:['review']};\n}\nfunction issueFact(item:Item,dispatch?:KanbanDispatch):Fact|undefined {\n    const issue=item.issues?.find(i=>!i.resolvedBy&&(!dispatch||i.attemptId===dispatch.id));\n    if(issue)return {phase:issue.type==='clarification'?'waiting-input':'error',reason:issue.id,actions:['resolve']};\n}\nfunction controlFact(item:Item):Fact|undefined {\n    const control=item.control;if(!control)return;\n    const reason=control.code;\n    if(control.state==='unknown')return {phase:'unknown',reason};\n    if(control.state==='failed')return {phase:'error',reason,actions:['resume']};\n    if(control.action==='pause')return {phase:control.state==='paused'?'paused':'pausing',reason,actions:['resume']};\n    if(['requested','accepted'].includes(control.state))return {phase:'resuming',reason};\n}\nfunction failureFact(item:Item,dispatch?:KanbanDispatch):Fact|undefined {\n    if(dispatch?.outcome==='unknown'||item.analysis?.state==='unknown')return {phase:'unknown',reason:dispatch?.code??item.analysis?.code};\n    if(dispatch&&['failed','cancelled','rejected'].includes(dispatch.outcome))return {phase:'error',reason:dispatch.code??dispatch.outcome};\n    if(item.analysis?.state==='failed')return {phase:'error',reason:item.analysis.code};\n}\nfunction executionFact(item:Item,dispatch?:KanbanDispatch):Fact|undefined {\n    if(item.blocked)return {phase:item.blocked.reason==='WORKSPACE_INPUT_REQUIRED'?'waiting-input':'error',reason:item.blocked.reason};\n    if(dispatch?.outcome==='prepared')return {phase:'preparing'};\n    if(dispatch?.outcome==='running'||item.status==='claimed')return {phase:'running',actions:dispatch?.controlCapabilities?.pause==='boundary'?['pause']:[]};\n}\nfunction waitingFact(item:Item,now:number,all:Array<Pick<KanbanItemSummary,'id'|'status'>>):Fact {\n    const analysis=analysisFact(item);if(analysis)return analysis;\n    const dependency=item.planning?.dependencies.find(id=>all.find(i=>i.id===id)?.status!=='completed');\n    if(dependency)return {phase:'waiting-dependency',reason:'DEPENDENCY_UNFINISHED:'+dependency,actions:item.launch?.admittedAt===undefined?['edit','cancel']:[]};\n    if(taskEditing(item,now))return {phase:'waiting-start',reason:'EDIT_LEASE_ACTIVE'};\n    if(item.launch?.admittedAt!==undefined)return {phase:'queued'};\n    return {phase:'waiting-start',reason:item.launch?.mode==='manual'?'MANUAL_START_REQUIRED':taskDue(item,now)?'ADMISSION_PENDING':'START_AT_PENDING',actions:['run','edit','pause','cancel']};\n}\nfunction analysisFact(item:Item):Fact|undefined {\n    if(item.analysis?.state==='clarification')return {phase:'waiting-input',reason:item.analysis.reason};\n    if(item.analysis?.state==='analyzing')return {phase:'analyzing'};\n}\n"],"mappings":"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","names":["item"]}