@nestos/kanban 0.0.0-stage → 0.5.2

package/dist/chunk-3LEIHB7Y.js

@@ -0,0 +1,221 @@
+import {
+  DEFAULT_KANBAN_WORK_TYPES,
+  executableWorkItem
+} from "./chunk-X4UHZX6F.js";
+import {
+  KanbanError
+} from "./chunk-M35X5PHO.js";
+
+// src/discovery-state.ts
+function discoveryState(state) {
+  return state?.discovery;
+}
+
+// src/configuration.ts
+function policy(input = {}) {
+  return {
+    claimTimeoutMs: 864e5,
+    leaseMs: 6e5,
+    progressTimeoutMs: 36e5,
+    transferTimeoutMs: 18e5,
+    maxComplexity: 10,
+    maxWorkUnits: 100,
+    maxDurationMs: 288e5,
+    escalationSessionIds: [],
+    ...input
+  };
+}
+function workTypes(board) {
+  return board.workTypes ?? DEFAULT_KANBAN_WORK_TYPES;
+}
+function workType(board, id) {
+  const found = workTypes(board).find((type) => type.id === id);
+  requireValue(found, "UNKNOWN_WORK_TYPE");
+  return found;
+}
+function executable(board, item) {
+  workType(board, item.planning?.kind ?? board.defaultWorkType ?? "task");
+  return executableWorkItem(board, item);
+}
+function validateConfiguration(board) {
+  const types = workTypes(board);
+  requireValue(types.length > 0 && types.length <= 20, "WORK_TYPE_LIMIT");
+  requireValue(new Set(types.map((t) => t.id)).size === types.length, "DUPLICATE_WORK_TYPE");
+  for (const type of types) {
+    identity(type.id);
+    text(type.label);
+    requireValue(Number.isInteger(type.rank) && type.rank >= 0 && type.rank <= 9 && typeof type.executable === "boolean", "INVALID_WORK_TYPE");
+  }
+  workType(board, board.defaultWorkType ?? "task");
+  const members = roster(board);
+  requireValue(members.length > 0, "MEMBER_ROSTER_REQUIRED");
+  requireValue(new Set(members.map(principalKey)).size === members.length, "DUPLICATE_MEMBER");
+  for (const member of members) {
+    identity(member.id);
+    requireValue(["agent", "human", "service"].includes(member.kind), "INVALID_PRINCIPAL");
+  }
+  for (const member of board.members ?? []) {
+    text(member.responsibility);
+    requireValue(!member.roles || member.roles.every((r) => ["worker", "reviewer", "coordinator"].includes(r)), "INVALID_MEMBER_ROLE");
+  }
+  validateColumns(board);
+  for (const [kind, value] of Object.entries(board.notifications?.rules ?? {}))
+    requireValue(/^[a-z][a-z0-9.-]{0,79}$/.test(kind) && ["info", "error", "none"].includes(value), "INVALID_NOTIFICATION_RULE");
+}
+function validateColumns(board) {
+  if (!board.columns) return;
+  const states = board.columns.flatMap((c) => c.states);
+  requireValue(states.length === 7 && new Set(states).size === 7 && ["proposed", "backlog", "open", "claimed", "review", "completed", "cancelled"].every((s) => states.includes(s)), "INVALID_COLUMNS");
+  requireValue(new Set(board.columns.map((c) => c.id)).size === board.columns.length, "DUPLICATE_COLUMN");
+  for (const column of board.columns) {
+    identity(column.id);
+    text(column.label);
+    requireValue(column.states.length > 0, "EMPTY_COLUMN");
+  }
+}
+
+// src/rules.ts
+function requireValue(condition, code) {
+  if (!condition) throw new KanbanError(code);
+}
+function text(value) {
+  requireValue(typeof value === "string" && value.trim().length > 0 && value.length <= 8e3, "INVALID_TEXT");
+}
+function identity(value) {
+  requireValue(typeof value === "string" && value.length > 0 && value.length <= 256 && !["__proto__", "prototype", "constructor"].includes(value), "INVALID_ID");
+}
+function positive(value) {
+  requireValue(Number.isFinite(value) && value > 0, "INVALID_THRESHOLD");
+}
+function validateEstimate(estimate) {
+  positive(estimate.complexity);
+  positive(estimate.workUnits);
+  positive(estimate.durationMs);
+  requireValue(["low", "medium", "high"].includes(estimate.confidence), "INVALID_CONFIDENCE");
+}
+function validateBoard(board) {
+  identity(board.id);
+  text(board.title);
+  requireValue(["system", "project", "collection"].includes(board.scope.kind), "INVALID_SCOPE");
+  if (board.scope.kind === "project") identity(board.scope.projectId);
+  if (board.scope.kind === "collection") {
+    identity(board.scope.namespace);
+    identity(board.scope.id);
+  }
+  validateConfiguration(board);
+  for (const agent of board.agents ?? []) {
+    identity(agent.agentId);
+    text(agent.responsibility);
+  }
+  requireValue(new Set((board.agents ?? []).map((a) => a.agentId)).size === (board.agents ?? []).length, "DUPLICATE_AGENT");
+  const p = board.policy;
+  for (const value of [p.maxReady, p.maxInProgress, p.maxInProgressPerAgent, p.maxInProgressPerAssignee]) if (value !== void 0) requireValue(Number.isSafeInteger(value) && value > 0, "INVALID_LIMIT");
+  requireValue(p.maxInProgressPerAgent === void 0 || p.maxInProgressPerAssignee === void 0 || p.maxInProgressPerAgent === p.maxInProgressPerAssignee, "POLICY_LIMIT_CONFLICT");
+  for (const value of [p.archiveAfterMs, p.backlogReviewMs]) if (value !== void 0) positive(value);
+  for (const value of [
+    p.claimTimeoutMs,
+    p.leaseMs,
+    p.progressTimeoutMs,
+    p.transferTimeoutMs,
+    p.maxComplexity,
+    p.maxWorkUnits,
+    p.maxDurationMs
+  ]) positive(value);
+  requireValue(Array.isArray(p.escalationSessionIds), "INVALID_ESCALATION_TARGETS");
+  requireValue(p.review === void 0 || ["independent", "assignee"].includes(p.review), "INVALID_REVIEW_POLICY");
+  requireValue(p.requireEstimate === void 0 || typeof p.requireEstimate === "boolean", "INVALID_ESTIMATE_POLICY");
+  p.escalationSessionIds.forEach(identity);
+}
+function participant(list, sessionId, agentId, role, subscribed, now) {
+  identity(sessionId);
+  requireValue(["creator", "owner", "consultant", "reviewer", "observer", "escalation"].includes(role), "INVALID_ROLE");
+  let entry = list.find((value) => value.sessionId === sessionId);
+  if (!entry) {
+    entry = { sessionId, agentId, roles: [], subscribed, joinedAt: now };
+    list.push(entry);
+  }
+  if (entry.agentId && agentId) requireValue(entry.agentId === agentId, "SESSION_AGENT_CONFLICT");
+  entry.agentId ??= agentId;
+  if (!entry.roles.includes(role)) entry.roles.push(role);
+  entry.subscribed = subscribed;
+}
+function owned(item, actor, token, now) {
+  requireValue(item.status === "claimed", "ITEM_NOT_RUNNING");
+  requireValue(item.owner && sameOwner(item.owner, actor) && item.owner.token === token, "OWNER_MISMATCH");
+  requireValue(item.owner.leaseUntil > now, "LEASE_EXPIRED");
+}
+
+// src/identity.ts
+function principal(actor) {
+  const kind = actor.kind ?? "agent", id = kind === "agent" ? actor.agentId ?? actor.id : actor.id;
+  requireValue(["agent", "human", "service"].includes(kind) && id, "INVALID_ACTOR");
+  identity(id);
+  if (kind === "agent") {
+    requireValue(!actor.agentId || !actor.id || actor.agentId === actor.id, "ACTOR_ID_MISMATCH");
+    if (actor.sessionId !== void 0) identity(actor.sessionId);
+    if (actor.taskId !== void 0) identity(actor.taskId);
+  }
+  return { kind, id };
+}
+function principalKey(value) {
+  return JSON.stringify([value.kind, value.id]);
+}
+function assigneeKey(value) {
+  return value.principalId ?? principalKey({ kind: "agent", id: value.agentId });
+}
+function sameOwner(owner, actor) {
+  const value = principal(actor);
+  return assigneeKey(owner) === principalKey(value) && (value.kind !== "agent" || owner.sessionId === actor.sessionId && owner.taskId === actor.taskId);
+}
+function roster(board) {
+  return [...(board.agents ?? []).map((a) => ({ kind: "agent", id: a.agentId })), ...board.members ?? []];
+}
+function candidates(board, item) {
+  if (item.eligibleAgentIds === void 0 && item.eligiblePrincipals === void 0)
+    return [
+      ...(board.agents ?? []).map((a) => ({ kind: "agent", id: a.agentId })),
+      ...(board.members ?? []).filter((m) => !m.roles || m.roles.includes("worker"))
+    ];
+  return [...(item.eligibleAgentIds ?? []).map((id) => ({ kind: "agent", id })), ...item.eligiblePrincipals ?? []];
+}
+function eligible(board, item, actor) {
+  const key = principalKey(principal(actor));
+  requireValue(candidates(board, item).some((p) => principalKey(p) === key), actor.kind && actor.kind !== "agent" ? "ASSIGNEE_NOT_ELIGIBLE" : "AGENT_NOT_ELIGIBLE");
+}
+function validateCandidates(board, item, executable2) {
+  const allowed = new Set(roster(board).map(principalKey)), values = candidates(board, item);
+  requireValue(!executable2 || values.length > 0, "ELIGIBLE_ASSIGNEES_REQUIRED");
+  for (const value of values) {
+    identity(value.id);
+    requireValue(["agent", "human", "service"].includes(value.kind), "INVALID_PRINCIPAL");
+    requireValue(allowed.has(principalKey(value)), value.kind === "agent" ? "AGENT_NOT_REGISTERED" : "ASSIGNEE_NOT_REGISTERED");
+  }
+}
+function normalizeActor(actor) {
+  const value = principal(actor);
+  return value.kind === "agent" ? { agentId: value.id, sessionId: actor.sessionId, taskId: actor.taskId } : { kind: value.kind, id: value.id };
+}
+
+export {
+  principal,
+  principalKey,
+  assigneeKey,
+  sameOwner,
+  candidates,
+  eligible,
+  validateCandidates,
+  normalizeActor,
+  policy,
+  workType,
+  executable,
+  requireValue,
+  text,
+  identity,
+  positive,
+  validateEstimate,
+  validateBoard,
+  participant,
+  owned,
+  discoveryState
+};
+//# sourceMappingURL=chunk-3LEIHB7Y.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/discovery-state.ts","../src/configuration.ts","../src/rules.ts","../src/identity.ts"],"sourcesContent":["import type {KanbanDiscoveryState} from './scan-ports';\n\nexport function discoveryState(state: {discovery?: unknown} | null | undefined): KanbanDiscoveryState | undefined {\n    return state?.discovery as KanbanDiscoveryState | undefined;\n}\n","import {DEFAULT_KANBAN_WORK_TYPES, executableWorkItem} from './contracts';\nimport type {KanbanBoard, KanbanPolicy, KanbanWorkType} from './contracts';\nimport {identity, requireValue, text} from './rules';\nimport {principalKey, roster} from './identity';\n\nexport function policy(input: Partial<KanbanPolicy> = {}): KanbanPolicy {\n    return {claimTimeoutMs: 86400000, leaseMs: 600000, progressTimeoutMs: 3600000, transferTimeoutMs: 1800000,\n        maxComplexity: 10, maxWorkUnits: 100, maxDurationMs: 28800000, escalationSessionIds: [], ...input};\n}\nexport function workTypes(board: KanbanBoard): readonly KanbanWorkType[] {return board.workTypes ?? DEFAULT_KANBAN_WORK_TYPES;}\nexport function workType(board: KanbanBoard, id: string): KanbanWorkType {\n    const found = workTypes(board).find(type => type.id === id); requireValue(found, 'UNKNOWN_WORK_TYPE'); return found;\n}\nexport function executable(board: KanbanBoard, item: {planning?: {kind: string; execution?: 'direct'|'children'}}): boolean {\n    workType(board, item.planning?.kind ?? board.defaultWorkType ?? 'task');\n    return executableWorkItem(board,item);\n}\nexport function validateConfiguration(board: KanbanBoard): void {\n    const types = workTypes(board); requireValue(types.length > 0 && types.length <= 20, 'WORK_TYPE_LIMIT');\n    requireValue(new Set(types.map(t => t.id)).size === types.length, 'DUPLICATE_WORK_TYPE');\n    for (const type of types) {\n        identity(type.id); text(type.label); requireValue(Number.isInteger(type.rank) && type.rank >= 0 && type.rank <= 9 && typeof type.executable === 'boolean', 'INVALID_WORK_TYPE');\n    }\n    workType(board, board.defaultWorkType ?? 'task');\n    const members = roster(board); requireValue(members.length > 0, 'MEMBER_ROSTER_REQUIRED');\n    requireValue(new Set(members.map(principalKey)).size === members.length, 'DUPLICATE_MEMBER');\n    for (const member of members) {identity(member.id); requireValue(['agent', 'human', 'service'].includes(member.kind), 'INVALID_PRINCIPAL');}\n    for (const member of board.members ?? []) {\n        text(member.responsibility); requireValue(!member.roles || member.roles.every(r => ['worker', 'reviewer', 'coordinator'].includes(r)), 'INVALID_MEMBER_ROLE');\n    }\n    validateColumns(board);\n    for (const [kind, value] of Object.entries(board.notifications?.rules ?? {}))\n        requireValue(/^[a-z][a-z0-9.-]{0,79}$/.test(kind) && ['info', 'error', 'none'].includes(value), 'INVALID_NOTIFICATION_RULE');\n}\nfunction validateColumns(board: KanbanBoard): void {\n    if (!board.columns) return;\n    const states = board.columns.flatMap(c => c.states);\n    requireValue(states.length === 7 && new Set(states).size === 7 && ['proposed', 'backlog', 'open', 'claimed', 'review', 'completed', 'cancelled'].every(s => states.includes(s as never)), 'INVALID_COLUMNS');\n    requireValue(new Set(board.columns.map(c => c.id)).size === board.columns.length, 'DUPLICATE_COLUMN');\n    for (const column of board.columns) {identity(column.id); text(column.label); requireValue(column.states.length > 0, 'EMPTY_COLUMN');}\n}\n","import type { KanbanActor, KanbanBoard, KanbanEstimate, KanbanItem, KanbanParticipant } from './contracts';\nimport {validateConfiguration} from './configuration';\nimport {sameOwner} from './identity';\nimport { KanbanError } from './ports';\n\nexport function requireValue(condition: unknown, code: string): asserts condition {\n    if (!condition) throw new KanbanError(code);\n}\nexport function text(value: string): void { requireValue(typeof value === 'string' && value.trim().length > 0 && value.length <= 8000, 'INVALID_TEXT'); }\nexport function identity(value: string): void { requireValue(typeof value === 'string' && value.length > 0 && value.length <= 256 && !['__proto__', 'prototype', 'constructor'].includes(value), 'INVALID_ID'); }\nexport function positive(value: number): void { requireValue(Number.isFinite(value) && value > 0, 'INVALID_THRESHOLD'); }\nexport function validateEstimate(estimate: KanbanEstimate): void {\n    positive(estimate.complexity); positive(estimate.workUnits); positive(estimate.durationMs);\n    requireValue(['low', 'medium', 'high'].includes(estimate.confidence), 'INVALID_CONFIDENCE');\n}\nexport function validateBoard(board: KanbanBoard): void {\n    identity(board.id); text(board.title);\n    requireValue(['system', 'project', 'collection'].includes(board.scope.kind), 'INVALID_SCOPE');\n    if (board.scope.kind === 'project') identity(board.scope.projectId);\n    if (board.scope.kind === 'collection') {identity(board.scope.namespace); identity(board.scope.id);}\n    validateConfiguration(board);\n    for (const agent of board.agents ?? []) { identity(agent.agentId); text(agent.responsibility); }\n    requireValue(new Set((board.agents ?? []).map(a => a.agentId)).size === (board.agents ?? []).length, 'DUPLICATE_AGENT');\n    const p = board.policy;\n    for (const value of [p.maxReady, p.maxInProgress, p.maxInProgressPerAgent, p.maxInProgressPerAssignee]) if (value !== undefined) requireValue(Number.isSafeInteger(value) && value > 0, 'INVALID_LIMIT');\n    requireValue(p.maxInProgressPerAgent === undefined || p.maxInProgressPerAssignee === undefined || p.maxInProgressPerAgent === p.maxInProgressPerAssignee, 'POLICY_LIMIT_CONFLICT');\n    for (const value of [p.archiveAfterMs, p.backlogReviewMs]) if (value !== undefined) positive(value);\n    for (const value of [p.claimTimeoutMs, p.leaseMs, p.progressTimeoutMs, p.transferTimeoutMs,\n        p.maxComplexity, p.maxWorkUnits, p.maxDurationMs]) positive(value);\n    requireValue(Array.isArray(p.escalationSessionIds), 'INVALID_ESCALATION_TARGETS');\n    requireValue(p.review === undefined || ['independent', 'assignee'].includes(p.review), 'INVALID_REVIEW_POLICY');\n    requireValue(p.requireEstimate === undefined || typeof p.requireEstimate === 'boolean', 'INVALID_ESTIMATE_POLICY');\n    p.escalationSessionIds.forEach(identity);\n}\nexport function participant(list: KanbanParticipant[], sessionId: string, agentId: string | undefined,\n    role: KanbanParticipant['roles'][number], subscribed: boolean, now: number): void {\n    identity(sessionId);\n    requireValue(['creator', 'owner', 'consultant', 'reviewer', 'observer', 'escalation'].includes(role), 'INVALID_ROLE');\n    let entry = list.find(value => value.sessionId === sessionId);\n    if (!entry) { entry = { sessionId, agentId, roles: [], subscribed, joinedAt: now }; list.push(entry); }\n    if (entry.agentId && agentId) requireValue(entry.agentId === agentId, 'SESSION_AGENT_CONFLICT');\n    entry.agentId ??= agentId;\n    if (!entry.roles.includes(role)) entry.roles.push(role);\n    entry.subscribed = subscribed;\n}\nexport function owned(item: KanbanItem, actor: KanbanActor, token: string, now: number): void {\n    requireValue(item.status === 'claimed', 'ITEM_NOT_RUNNING');\n    requireValue(item.owner && sameOwner(item.owner, actor) && item.owner.token === token, 'OWNER_MISMATCH');\n    requireValue(item.owner.leaseUntil > now, 'LEASE_EXPIRED');\n}\n","import type {KanbanActor, KanbanAssignment, KanbanBoard, KanbanItem, KanbanPrincipal} from './contracts';\nimport {identity, requireValue} from './rules';\n\nexport function principal(actor: KanbanActor): KanbanPrincipal {\n    const kind = actor.kind ?? 'agent', id = kind === 'agent' ? actor.agentId ?? actor.id : actor.id;\n    requireValue(['agent', 'human', 'service'].includes(kind) && id, 'INVALID_ACTOR'); identity(id);\n    if (kind === 'agent') {requireValue(!actor.agentId || !actor.id || actor.agentId === actor.id, 'ACTOR_ID_MISMATCH'); if (actor.sessionId !== undefined) identity(actor.sessionId); if (actor.taskId !== undefined) identity(actor.taskId);}\n    return {kind, id};\n}\nexport function principalKey(value: KanbanPrincipal): string {return JSON.stringify([value.kind, value.id]);}\nexport function assigneeKey(value: KanbanAssignment): string {\n    return value.principalId ?? principalKey({kind: 'agent', id: value.agentId!});\n}\nexport function sameOwner(owner: KanbanAssignment, actor: KanbanActor): boolean {\n    const value = principal(actor);\n    return assigneeKey(owner) === principalKey(value) && (value.kind !== 'agent' || owner.sessionId === actor.sessionId && owner.taskId === actor.taskId);\n}\nexport function roster(board: KanbanBoard): KanbanPrincipal[] {\n    return [...(board.agents ?? []).map(a => ({kind: 'agent' as const, id: a.agentId})), ...(board.members ?? [])];\n}\nexport function candidates(board: KanbanBoard, item: KanbanItem): KanbanPrincipal[] {\n    if (item.eligibleAgentIds === undefined && item.eligiblePrincipals === undefined)\n        return [...(board.agents ?? []).map(a => ({kind: 'agent' as const, id: a.agentId})),\n            ...(board.members ?? []).filter(m => !m.roles || m.roles.includes('worker'))];\n    return [...(item.eligibleAgentIds ?? []).map(id => ({kind: 'agent' as const, id})), ...(item.eligiblePrincipals ?? [])];\n}\nexport function eligible(board: KanbanBoard, item: KanbanItem, actor: KanbanActor): void {\n    const key = principalKey(principal(actor));\n    requireValue(candidates(board, item).some(p => principalKey(p) === key), actor.kind && actor.kind !== 'agent' ? 'ASSIGNEE_NOT_ELIGIBLE' : 'AGENT_NOT_ELIGIBLE');\n}\nexport function validateCandidates(board: KanbanBoard, item: KanbanItem, executable: boolean): void {\n    const allowed = new Set(roster(board).map(principalKey)), values = candidates(board, item);\n    requireValue(!executable || values.length > 0, 'ELIGIBLE_ASSIGNEES_REQUIRED');\n    for (const value of values) {\n        identity(value.id); requireValue(['agent', 'human', 'service'].includes(value.kind), 'INVALID_PRINCIPAL');\n        requireValue(allowed.has(principalKey(value)), value.kind === 'agent' ? 'AGENT_NOT_REGISTERED' : 'ASSIGNEE_NOT_REGISTERED');\n    }\n}\n\nexport function normalizeActor(actor: KanbanActor): KanbanActor {\n    const value = principal(actor);\n    return value.kind === 'agent' ? {agentId: value.id, sessionId: actor.sessionId, taskId: actor.taskId}\n        : {kind: value.kind, id: value.id};\n}\n"],"mappings":"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","names":["executable"]}

package/dist/chunk-4XF6LQSU.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/execution-observation.ts
+function executionObservationChanged(current, next) {
+  return current.outcome !== next.outcome || current.code !== next.code || JSON.stringify(_nullishCoalesce(current.outputs, () => ( []))) !== JSON.stringify(_nullishCoalesce(next.outputs, () => ( []))) || next.executionSessionId !== void 0 && current.executionSessionId !== next.executionSessionId || next.controlCapabilities !== void 0 && JSON.stringify(current.controlCapabilities) !== JSON.stringify(next.controlCapabilities);
+}
+
+
+
+exports.executionObservationChanged = executionObservationChanged;
+//# sourceMappingURL=chunk-4XF6LQSU.cjs.map

package/dist/chunk-4XF6LQSU.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/li/share/prj/x1/libraries/kanban/dist/chunk-4XF6LQSU.cjs","../src/execution-observation.ts"],"names":[],"mappings":"AAAA;ACIO,SAAS,2BAAA,CAA4B,OAAA,EAAsB,IAAA,EAA4B;AAC1F,EAAA,OAAO,OAAA,CAAQ,QAAA,IAAY,IAAA,CAAK,QAAA,GAAW,OAAA,CAAQ,KAAA,IAAS,IAAA,CAAK,KAAA,GAC1D,IAAA,CAAK,SAAA,kBAAU,OAAA,CAAQ,OAAA,UAAW,CAAC,GAAC,EAAA,IAAM,IAAA,CAAK,SAAA,kBAAU,IAAA,CAAK,OAAA,UAAW,CAAC,GAAC,EAAA,GAC3E,IAAA,CAAK,mBAAA,IAAuB,KAAA,EAAA,GAAa,OAAA,CAAQ,mBAAA,IAAuB,IAAA,CAAK,mBAAA,GAC7E,IAAA,CAAK,oBAAA,IAAwB,KAAA,EAAA,GAAa,IAAA,CAAK,SAAA,CAAU,OAAA,CAAQ,mBAAmB,EAAA,IAAM,IAAA,CAAK,SAAA,CAAU,IAAA,CAAK,mBAAmB,CAAA;AAC5I;ADLA;AACA;AACE;AACF,kEAAC","file":"/home/li/share/prj/x1/libraries/kanban/dist/chunk-4XF6LQSU.cjs","sourcesContent":[null,"import type {KanbanDispatch} from './contracts';\n\ntype Observation = Pick<KanbanDispatch, 'outcome' | 'code' | 'outputs' | 'executionSessionId' | 'controlCapabilities'>;\n/** A lease renewal is operational state, separate from observable execution changes. */\nexport function executionObservationChanged(current: Observation, next: Observation): boolean {\n    return current.outcome !== next.outcome || current.code !== next.code\n        || JSON.stringify(current.outputs ?? []) !== JSON.stringify(next.outputs ?? [])\n        || next.executionSessionId !== undefined && current.executionSessionId !== next.executionSessionId\n        || next.controlCapabilities !== undefined && JSON.stringify(current.controlCapabilities) !== JSON.stringify(next.controlCapabilities);\n}\n"]}

package/dist/chunk-5Q7WB63A.cjs

@@ -0,0 +1,282 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } async function _asyncOptionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = await fn(value); } else if (op === 'call' || op === 'optionalCall') { value = await fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkDINLR6E6cjs = require('./chunk-DINLR6E6.cjs');
+
+
+
+
+var _chunkRBOER6EWcjs = require('./chunk-RBOER6EW.cjs');
+
+
+
+
+var _chunkRSH6QSECcjs = require('./chunk-RSH6QSEC.cjs');
+
+// src/session-activity-query.ts
+async function querySessionItems(core, boardId, input, project) {
+  const { execution = "all", ...query } = input;
+  if (!["all", "running", "recent", "active"].includes(execution)) throw new (0, _chunkRSH6QSECcjs.KanbanError)("INVALID_EXECUTION_FILTER");
+  if (execution === "all") {
+    const page2 = await core.query(boardId, query);
+    return { ...page2, items: await project(page2.items) };
+  }
+  const { cursor, limit = 50, ...filters } = query;
+  if (!Number.isSafeInteger(limit) || limit < 1 || limit > 200) throw new (0, _chunkRSH6QSECcjs.KanbanError)("INVALID_PAGE_SIZE");
+  let page = await core.query(boardId, { ...filters, limit: 200 }), rows = [...page.items];
+  const revision = page.revision;
+  while (page.nextCursor) {
+    if (rows.length >= 1e4) throw new (0, _chunkRSH6QSECcjs.KanbanError)("ACTIVITY_QUERY_LIMIT");
+    page = await core.query(boardId, { ...filters, limit: 200, cursor: page.nextCursor });
+    if (page.revision !== revision) throw new (0, _chunkRSH6QSECcjs.KanbanError)("CURSOR_STALE");
+    rows.push(...page.items);
+  }
+  const matching = (await project(rows)).filter((row) => matchesExecution(row, execution));
+  if ((await core.query(boardId, { ...filters, limit: 1 })).revision !== revision) throw new (0, _chunkRSH6QSECcjs.KanbanError)("CURSOR_STALE");
+  const scope = _chunkRSH6QSECcjs.sha256HexSync.call(void 0, JSON.stringify({ filters, execution, limit })), signature = _chunkRSH6QSECcjs.sha256HexSync.call(void 0, JSON.stringify(matching.map((row) => row.id)));
+  let start = 0;
+  if (cursor) {
+    let saved;
+    try {
+      saved = JSON.parse(cursor);
+    } catch (e) {
+      throw new (0, _chunkRSH6QSECcjs.KanbanError)("INVALID_CURSOR");
+    }
+    if (saved.scope !== scope) throw new (0, _chunkRSH6QSECcjs.KanbanError)("CURSOR_SCOPE_MISMATCH");
+    if (saved.revision !== revision || saved.signature !== signature) throw new (0, _chunkRSH6QSECcjs.KanbanError)("CURSOR_STALE");
+    start = matching.findIndex((row) => row.id === saved.after) + 1;
+    if (start < 1) throw new (0, _chunkRSH6QSECcjs.KanbanError)("INVALID_CURSOR");
+  }
+  const items = matching.slice(start, start + limit);
+  return { revision, total: matching.length, items, ...start + items.length < matching.length ? { nextCursor: JSON.stringify({ scope, revision, signature, after: items.at(-1).id }) } : {} };
+}
+function matchesExecution(row, filter) {
+  const session = row.execution;
+  if (!session || session.stale) return false;
+  return filter === "running" ? session.state === "running" : filter === "recent" ? session.recent : session.state === "running" || session.recent;
+}
+
+// src/session-relations.ts
+function sessionAssociations(item, bindings, workflow) {
+  return [...bindings.map((ref) => {
+    const dispatch = workflow.dispatches[_nullishCoalesce(ref.revision, () => ( ""))];
+    const execution = _optionalChain([dispatch, 'optionalAccess', _ => _.itemId]) === item.id ? {
+      id: dispatch.id,
+      purpose: "execution",
+      dispatchId: dispatch.id,
+      attempt: dispatch.attempt,
+      outcome: dispatch.outcome,
+      createdAt: dispatch.preparedAt,
+      code: dispatch.code,
+      ...dispatch.continuation ? { previousDispatchId: dispatch.continuation.previousDispatchId } : {}
+    } : void 0;
+    return { sessionId: ref.id, purpose: "execution", ...execution ? { execution } : {} };
+  }), ...item.participants.filter((row) => !bindings.some((ref) => ref.id === row.sessionId)).map((row) => ({ sessionId: row.sessionId, purpose: "discussion" }))];
+}
+async function projectRelatedSessions(associations, currentId, inspect) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const row of associations) {
+    let group = grouped.get(row.sessionId);
+    if (!group) grouped.set(row.sessionId, group = { purposes: /* @__PURE__ */ new Set(), executions: /* @__PURE__ */ new Map() });
+    group.purposes.add(row.purpose);
+    if (row.execution) group.executions.set(row.execution.id, { ...group.executions.get(row.execution.id), ...row.execution });
+  }
+  const rows = [], entries = [...grouped];
+  let next = 0;
+  await Promise.all(Array.from({ length: Math.min(entries.length, 8) }, async () => {
+    while (next < entries.length) {
+      const [sessionId, group] = entries[next++], state = await inspect(sessionId);
+      rows.push({
+        ...state,
+        current: sessionId === currentId,
+        purposes: [...group.purposes].sort(),
+        executions: [...group.executions.values()].sort((a, b) => (_nullishCoalesce(a.createdAt, () => ( 0))) - (_nullishCoalesce(b.createdAt, () => ( 0))) || a.id.localeCompare(b.id))
+      });
+    }
+  }));
+  return rows.sort((a, b) => Number(b.current) - Number(a.current) || a.sessionId.localeCompare(b.sessionId));
+}
+
+// src/session-activity.ts
+function executionBindings(refs, referenceSystem) {
+  return (_nullishCoalesce(refs, () => ( []))).filter((ref) => ref.system === referenceSystem);
+}
+function currentBinding(refs, itemId, workflow, referenceSystem) {
+  const binding = executionBindings(refs, referenceSystem).at(-1), latest = Object.values(workflow.dispatches).filter((dispatch) => dispatch.itemId === itemId).sort((a, b) => b.attempt - a.attempt)[0];
+  if (!binding || !latest || binding.revision === latest.id) return binding;
+  return ["prepared", "running", "unknown", "succeeded"].includes(latest.outcome) || workflow.dispatches[_nullishCoalesce(binding.revision, () => ( ""))] ? void 0 : binding;
+}
+function createKanbanSessionActivity(core, options, log, referenceSystem) {
+  const inspect = createSessionInspector(options, log);
+  const project = async (boardId, rows) => {
+    if (!rows.some((row) => executionBindings(row.externalRefs, referenceSystem).length)) return rows;
+    const [board, workflow] = await Promise.all([boardMetadata(core, boardId), core.workflow(boardId)]), bindings = new Map(rows.map((row) => [row.id, currentBinding(row.externalRefs, row.id, workflow, referenceSystem)]));
+    const ids = [...new Set([...bindings.values()].flatMap((ref) => ref ? [ref.id] : []))], states = /* @__PURE__ */ new Map();
+    let next = 0;
+    await Promise.all(Array.from({ length: Math.min(ids.length, 8) }, async () => {
+      while (next < ids.length) {
+        const id = ids[next++];
+        states.set(id, await inspect(board, id));
+      }
+    }));
+    return rows.map((row) => {
+      const binding = bindings.get(row.id);
+      return { ...row, ...binding ? { execution: states.get(binding.id) } : {} };
+    });
+  };
+  return {
+    queryActivity: (boardId, query = {}) => querySessionItems(core, boardId, query, (rows) => project(boardId, rows)),
+    async executionSession(boardId, itemId, query = {}) {
+      const started = Date.now();
+      if (!query || typeof query !== "object" || Array.isArray(query) || Object.keys(query).some((key) => key !== "includeRelated") || query.includeRelated !== void 0 && typeof query.includeRelated !== "boolean") throw new (0, _chunkRSH6QSECcjs.KanbanError)("INVALID_QUERY");
+      const { item } = await core.item(boardId, itemId), bindings = executionBindings(item.externalRefs, referenceSystem);
+      if (!bindings.length && !query.includeRelated) return { history: [] };
+      const [board, workflow] = await Promise.all([boardMetadata(core, boardId), core.workflow(boardId)]), last = currentBinding(item.externalRefs, itemId, workflow, referenceSystem);
+      let sessionsCode;
+      const related = query.includeRelated ? await _optionalChain([options, 'optionalAccess', _2 => _2.source, 'access', _3 => _3.related, 'optionalCall', _4 => _4(board, item, workflow), 'access', _5 => _5.catch, 'call', _6 => _6((error) => {
+        const candidate = _optionalChain([error, 'optionalAccess', _7 => _7.code]);
+        sessionsCode = candidate && /^[A-Z][A-Z0-9_]{0,79}$/.test(candidate) ? candidate : "SESSION_RELATIONS_FAILED";
+        try {
+          log({ operationId: _chunkRSH6QSECcjs.randomUUID.call(void 0, ), stage: "session.relations", result: "failure", code: sessionsCode, durationMs: Date.now() - started });
+        } catch (e2) {
+        }
+        return [];
+      })]) : [];
+      const sessions = query.includeRelated ? await projectRelatedSessions([
+        ...sessionAssociations(item, bindings, workflow),
+        ..._nullishCoalesce(related, () => ( []))
+      ], _optionalChain([last, 'optionalAccess', _8 => _8.id]), (id) => inspect(board, id)) : void 0;
+      return {
+        current: last ? await _asyncNullishCoalesce(await _asyncOptionalChain([sessions, 'optionalAccess', async _9 => _9.find, 'call', async _10 => _10((row) => row.sessionId === last.id)]), async () => ( await inspect(board, last.id))) : void 0,
+        history: bindings.map((ref) => ({ sessionId: ref.id, bindingId: ref.revision, current: ref === last })).reverse(),
+        ...sessions ? { sessions } : {},
+        ...sessionsCode ? { sessionsCode } : {}
+      };
+    },
+    validate: (board, command, actor) => validateBinding(core, options, board, command, actor, referenceSystem)
+  };
+}
+function createSessionInspector(options, log) {
+  const now = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _11 => _11.now]), () => ( Date.now)), cache = /* @__PURE__ */ new Map();
+  return async (board, sessionId) => {
+    const started = now(), key = JSON.stringify([board.id, sessionId]);
+    try {
+      if (!options) throw new (0, _chunkRSH6QSECcjs.KanbanError)("EXECUTION_SESSION_UNAVAILABLE");
+      const row = await options.source.inspect(board, sessionId);
+      if (row.sessionId !== sessionId) throw new (0, _chunkRSH6QSECcjs.KanbanError)("SESSION_ACTIVITY_SCOPE_MISMATCH");
+      const stale = row.stale || row.observedAt === void 0 || now() - row.observedAt > 9e4;
+      const value = {
+        sessionId,
+        ...typeof row.resourceId === "string" && row.resourceId.length <= 4096 && !row.resourceId.includes("\0") ? { resourceId: row.resourceId } : {},
+        title: _optionalChain([row, 'access', _12 => _12.title, 'optionalAccess', _13 => _13.slice, 'call', _14 => _14(0, 256)]),
+        state: row.state,
+        createdAt: row.createdAt,
+        lastActivityAt: row.lastActivityAt,
+        observedAt: row.observedAt,
+        stale,
+        recent: !stale && row.lastActivityAt !== void 0 && row.lastActivityAt <= now() && now() - row.lastActivityAt <= 6e5,
+        ...row.code && /^[A-Z][A-Z0-9_]{0,79}$/.test(row.code) ? { code: row.code } : {}
+      };
+      if (cache.size >= 256) cache.delete(cache.keys().next().value);
+      cache.set(key, value);
+      return value;
+    } catch (error) {
+      const candidate = _optionalChain([error, 'optionalAccess', _15 => _15.code]), code = candidate && /^[A-Z][A-Z0-9_]{0,79}$/.test(candidate) ? candidate : "SESSION_ACTIVITY_FAILED";
+      try {
+        log({ operationId: _chunkRSH6QSECcjs.randomUUID.call(void 0, ), sessionId, stage: "session.activity", result: "failure", code, durationMs: now() - started });
+      } catch (e3) {
+      }
+      const prior = ["EIO", "ETIMEDOUT", "ECONNRESET", "ECONNREFUSED", "SESSION_ACTIVITY_FAILED"].includes(code) ? cache.get(key) : void 0;
+      return { ...prior, sessionId, state: _nullishCoalesce(_optionalChain([prior, 'optionalAccess', _16 => _16.state]), () => ( "unknown")), stale: true, recent: false, code };
+    }
+  };
+}
+async function boardMetadata(core, boardId) {
+  const board = await _asyncNullishCoalesce((await core.catalog()).find((board2) => board2.id === boardId), async () => ( await core.read(boardId)));
+  return { ...board, items: [] };
+}
+async function validateBinding(core, options, board, command, actor, referenceSystem) {
+  if (_optionalChain([command, 'optionalAccess', _17 => _17.type]) !== "link-reference" || command.reference.system !== referenceSystem) return;
+  if (!options || !command.reference.revision) throw new (0, _chunkRSH6QSECcjs.KanbanError)("EXECUTION_SESSION_UNAVAILABLE");
+  const item = board.items.find((item2) => item2.id === command.itemId);
+  if (!item) throw new (0, _chunkRSH6QSECcjs.KanbanError)("ITEM_NOT_FOUND");
+  const key = _chunkRBOER6EWcjs.principalKey.call(void 0, _chunkRBOER6EWcjs.principal.call(void 0, actor)), coordinator = _optionalChain([board, 'access', _18 => _18.members, 'optionalAccess', _19 => _19.some, 'call', _20 => _20((member) => _chunkRBOER6EWcjs.principalKey.call(void 0, member) === key && _optionalChain([member, 'access', _21 => _21.roles, 'optionalAccess', _22 => _22.includes, 'call', _23 => _23("coordinator")]))]);
+  if (!coordinator && _optionalChain([item, 'access', _24 => _24.owner, 'optionalAccess', _25 => _25.principalId]) !== key && !(item.owner === void 0 && _chunkRBOER6EWcjs.candidates.call(void 0, board, item).some((candidate) => _chunkRBOER6EWcjs.principalKey.call(void 0, candidate) === key))) throw new (0, _chunkRSH6QSECcjs.KanbanError)("EXECUTION_SESSION_ASSIGNMENT_DENIED");
+  const active = Object.values((await core.workflow(board.id)).dispatches).filter((dispatch) => dispatch.itemId === item.id).sort((a, b) => b.attempt - a.attempt)[0];
+  if (active && command.reference.revision !== active.id) throw new (0, _chunkRSH6QSECcjs.KanbanError)("EXECUTION_SESSION_LOCKED");
+  if (active && executionBindings(item.externalRefs, referenceSystem).some((ref) => ref.revision === active.id && ref.id !== command.reference.id)) throw new (0, _chunkRSH6QSECcjs.KanbanError)("EXECUTION_SESSION_LOCKED");
+  if (options.source.authorizeBinding) return options.source.authorizeBinding(board, command.reference.id);
+  const state = await options.source.inspect(board, command.reference.id);
+  if (state.sessionId !== command.reference.id || state.stale) throw new (0, _chunkRSH6QSECcjs.KanbanError)("EXECUTION_SESSION_UNAVAILABLE");
+}
+
+// src/activity-module.ts
+function createKanbanActivityModule(options) {
+  const { executionSessions, referenceSystem, ...core } = options;
+  let activity;
+  const service = _chunkDINLR6E6cjs.createKanbanModule.call(void 0, {
+    ...core,
+    authorize: async (input) => {
+      await core.authorize(input);
+      await activity.validate(input.board, input.command, input.actor);
+    }
+  });
+  activity = createKanbanSessionActivity(service, executionSessions, core.log, referenceSystem);
+  let stopping = false;
+  const pending = /* @__PURE__ */ new Set();
+  const track = (run) => {
+    if (stopping) return Promise.reject(new (0, _chunkRSH6QSECcjs.KanbanError)("SERVICE_STOPPING"));
+    const work = Promise.resolve().then(run).finally(() => {
+      pending.delete(work);
+    });
+    pending.add(work);
+    return work;
+  };
+  const quiesce = async () => {
+    stopping = true;
+    await Promise.allSettled([...pending]);
+    await service.quiesce();
+  };
+  return {
+    ...forwardCore(service, track),
+    queryActivity: (...args) => track(() => activity.queryActivity(...args)),
+    executionSession: (...args) => track(() => activity.executionSession(...args)),
+    related: (sessionId) => track(() => relatedBoards(service, referenceSystem, sessionId)),
+    quiesce,
+    dispose: quiesce
+  };
+}
+function forwardCore(service, track) {
+  return {
+    create: (input) => track(() => service.create(input)),
+    read: (id) => track(() => service.read(id)),
+    list: () => track(() => service.list()),
+    catalog: () => track(() => service.catalog()),
+    execute: (id, request) => track(() => service.execute(id, request)),
+    events: (id, after, limit) => track(() => service.events(id, after, limit)),
+    query: (id, query) => track(() => service.query(id, query)),
+    item: (id, item) => track(() => service.item(id, item)),
+    overview: (id) => track(() => service.overview(id)),
+    scan: () => track(() => service.scan()),
+    workflow: (id) => track(() => service.workflow(id)),
+    resolve: (reference) => track(() => service.resolve(reference)),
+    suggest: (id, query) => track(() => service.suggest(id, query)),
+    records: (id, query) => track(() => service.records(id, query)),
+    record: (id, record) => track(() => service.record(id, record)),
+    currentPrincipal: () => track(() => service.currentPrincipal())
+  };
+}
+async function relatedBoards(service, referenceSystem, sessionId) {
+  const boards = await service.related(sessionId);
+  for (const board of await service.catalog()) {
+    if (boards.some((old) => old.id === board.id)) continue;
+    const matches = await service.query(board.id, { view: "all", reference: { system: referenceSystem, id: sessionId }, limit: 1 });
+    if (matches.total) boards.push(await service.read(board.id));
+  }
+  return boards;
+}
+
+
+
+
+exports.querySessionItems = querySessionItems; exports.createKanbanActivityModule = createKanbanActivityModule;
+//# sourceMappingURL=chunk-5Q7WB63A.cjs.map