@nestos/kanban 0.0.0-stage → 0.5.1

package/dist/activity.js

@@ -0,0 +1,288 @@
+import {
+  createKanbanModule
+} from "./chunk-DFTOTBGF.js";
+import "./chunk-OHQTKGQN.js";
+import "./chunk-RQP77ZTY.js";
+import {
+  candidates,
+  principal,
+  principalKey
+} from "./chunk-ATUFFNLV.js";
+import {
+  KanbanError
+} from "./chunk-G6FCDLDF.js";
+import "./chunk-O4OGAAV4.js";
+import "./chunk-5XKOCKY2.js";
+import {
+  randomUUID,
+  sha256HexSync
+} from "./chunk-TB2RZGDV.js";
+import "./chunk-QTMTBEBA.js";
+
+// 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 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 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 KanbanError("ACTIVITY_QUERY_LIMIT");
+    page = await core.query(boardId, { ...filters, limit: 200, cursor: page.nextCursor });
+    if (page.revision !== revision) throw new 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 KanbanError("CURSOR_STALE");
+  const scope = sha256HexSync(JSON.stringify({ filters, execution, limit })), signature = sha256HexSync(JSON.stringify(matching.map((row) => row.id)));
+  let start = 0;
+  if (cursor) {
+    let saved;
+    try {
+      saved = JSON.parse(cursor);
+    } catch {
+      throw new KanbanError("INVALID_CURSOR");
+    }
+    if (saved.scope !== scope) throw new KanbanError("CURSOR_SCOPE_MISMATCH");
+    if (saved.revision !== revision || saved.signature !== signature) throw new KanbanError("CURSOR_STALE");
+    start = matching.findIndex((row) => row.id === saved.after) + 1;
+    if (start < 1) throw new 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[ref.revision ?? ""];
+    const execution = dispatch?.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) => (a.createdAt ?? 0) - (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 (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[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 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 options?.source.related?.(board, item, workflow).catch((error) => {
+        const candidate = error?.code;
+        sessionsCode = candidate && /^[A-Z][A-Z0-9_]{0,79}$/.test(candidate) ? candidate : "SESSION_RELATIONS_FAILED";
+        try {
+          log({ operationId: randomUUID(), stage: "session.relations", result: "failure", code: sessionsCode, durationMs: Date.now() - started });
+        } catch {
+        }
+        return [];
+      }) : [];
+      const sessions = query.includeRelated ? await projectRelatedSessions([
+        ...sessionAssociations(item, bindings, workflow),
+        ...related ?? []
+      ], last?.id, (id) => inspect(board, id)) : void 0;
+      return {
+        current: last ? sessions?.find((row) => row.sessionId === last.id) ?? 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 = options?.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 KanbanError("EXECUTION_SESSION_UNAVAILABLE");
+      const row = await options.source.inspect(board, sessionId);
+      if (row.sessionId !== sessionId) throw new 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: row.title?.slice(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 = error?.code, code = candidate && /^[A-Z][A-Z0-9_]{0,79}$/.test(candidate) ? candidate : "SESSION_ACTIVITY_FAILED";
+      try {
+        log({ operationId: randomUUID(), sessionId, stage: "session.activity", result: "failure", code, durationMs: now() - started });
+      } catch {
+      }
+      const prior = ["EIO", "ETIMEDOUT", "ECONNRESET", "ECONNREFUSED", "SESSION_ACTIVITY_FAILED"].includes(code) ? cache.get(key) : void 0;
+      return { ...prior, sessionId, state: prior?.state ?? "unknown", stale: true, recent: false, code };
+    }
+  };
+}
+async function boardMetadata(core, boardId) {
+  const board = (await core.catalog()).find((board2) => board2.id === boardId) ?? await core.read(boardId);
+  return { ...board, items: [] };
+}
+async function validateBinding(core, options, board, command, actor, referenceSystem) {
+  if (command?.type !== "link-reference" || command.reference.system !== referenceSystem) return;
+  if (!options || !command.reference.revision) throw new KanbanError("EXECUTION_SESSION_UNAVAILABLE");
+  const item = board.items.find((item2) => item2.id === command.itemId);
+  if (!item) throw new KanbanError("ITEM_NOT_FOUND");
+  const key = principalKey(principal(actor)), coordinator = board.members?.some((member) => principalKey(member) === key && member.roles?.includes("coordinator"));
+  if (!coordinator && item.owner?.principalId !== key && !(item.owner === void 0 && candidates(board, item).some((candidate) => principalKey(candidate) === key))) throw new 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 KanbanError("EXECUTION_SESSION_LOCKED");
+  if (active && executionBindings(item.externalRefs, referenceSystem).some((ref) => ref.revision === active.id && ref.id !== command.reference.id)) throw new 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 KanbanError("EXECUTION_SESSION_UNAVAILABLE");
+}
+
+// src/activity-module.ts
+function createKanbanActivityModule(options) {
+  const { executionSessions, referenceSystem, ...core } = options;
+  let activity;
+  const service = createKanbanModule({
+    ...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 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;
+}
+export {
+  createKanbanActivityModule,
+  querySessionItems
+};
+//# sourceMappingURL=activity.js.map

package/dist/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session-activity-query.ts","../src/session-relations.ts","../src/session-activity.ts","../src/activity-module.ts"],"sourcesContent":["import {sha256HexSync} from './utils';\nimport type {KanbanService, KanbanSessionActivityQuery, KanbanSessionItemPage, KanbanSessionItemSummary} from './contracts';\nimport {KanbanError} from './ports';\n/** Filter before pagination; Session activity changes invalidate the filtered keyset. */\nexport async function querySessionItems(core: KanbanService, boardId: string, input: KanbanSessionActivityQuery,\n    project: (rows: KanbanSessionItemSummary[])=>Promise<KanbanSessionItemSummary[]>): Promise<KanbanSessionItemPage> {\n    const {execution='all',...query}=input;\n    if(!['all','running','recent','active'].includes(execution)) throw new KanbanError('INVALID_EXECUTION_FILTER');\n    if(execution==='all') {const page=await core.query(boardId,query);return {...page,items:await project(page.items)};}\n    const {cursor,limit=50,...filters}=query;\n    if(!Number.isSafeInteger(limit)||limit<1||limit>200) throw new KanbanError('INVALID_PAGE_SIZE');\n    let page=await core.query(boardId,{...filters,limit:200}), rows=[...page.items];const revision=page.revision;\n    while(page.nextCursor) {\n        if(rows.length>=10000) throw new KanbanError('ACTIVITY_QUERY_LIMIT');\n        page=await core.query(boardId,{...filters,limit:200,cursor:page.nextCursor});\n        if(page.revision!==revision) throw new KanbanError('CURSOR_STALE');rows.push(...page.items);\n    }\n    const matching=(await project(rows)).filter(row=>matchesExecution(row,execution));\n    if((await core.query(boardId,{...filters,limit:1})).revision!==revision) throw new KanbanError('CURSOR_STALE');\n    const scope=sha256HexSync(JSON.stringify({filters,execution,limit})), signature=sha256HexSync(JSON.stringify(matching.map(row=>row.id)));\n    let start=0;\n    if(cursor) {\n        let saved;try {saved=JSON.parse(cursor);} catch {throw new KanbanError('INVALID_CURSOR');}\n        if(saved.scope!==scope) throw new KanbanError('CURSOR_SCOPE_MISMATCH');\n        if(saved.revision!==revision||saved.signature!==signature) throw new KanbanError('CURSOR_STALE');\n        start=matching.findIndex(row=>row.id===saved.after)+1;if(start<1) throw new KanbanError('INVALID_CURSOR');\n    }\n    const items=matching.slice(start,start+limit);\n    return {revision,total:matching.length,items,...(start+items.length<matching.length?{nextCursor:JSON.stringify({scope,revision,signature,after:items.at(-1)!.id})}: {})};\n}\nfunction matchesExecution(row: KanbanSessionItemSummary, filter: string): boolean {\n    const session=row.execution;if(!session||session.stale) return false;\n    return filter==='running'?session.state==='running':filter==='recent'?session.recent:session.state==='running'||session.recent;\n}\n","import type {KanbanItem, KanbanExternalReference, KanbanWorkflowState, KanbanSessionAssociation, KanbanRelatedSession, KanbanSessionExecution, KanbanExecutionSession} from './contracts';\n\nexport function sessionAssociations(item: KanbanItem, bindings: KanbanExternalReference[], workflow: KanbanWorkflowState): KanbanSessionAssociation[] {\n    return [...bindings.map(ref => {\n        const dispatch = workflow.dispatches[ref.revision ?? ''];\n        const execution: KanbanSessionExecution | undefined = dispatch?.itemId === item.id ? {\n            id: dispatch.id, purpose: 'execution', dispatchId: dispatch.id, attempt: dispatch.attempt,\n            outcome: dispatch.outcome, createdAt: dispatch.preparedAt, code: dispatch.code,\n            ...(dispatch.continuation ? {previousDispatchId: dispatch.continuation.previousDispatchId} : {}),\n        } : undefined;\n        return {sessionId: ref.id, purpose: 'execution' as const, ...(execution ? {execution} : {})};\n    }), ...item.participants.filter(row => !bindings.some(ref => ref.id === row.sessionId)).map(row => ({sessionId: row.sessionId, purpose: 'discussion' as const}))];\n}\n\n/** Session identity and run identity are independent; neither activity nor a hook selects the primary. */\nexport async function projectRelatedSessions(associations: KanbanSessionAssociation[], currentId: string | undefined,\n    inspect: (id: string) => Promise<KanbanExecutionSession>): Promise<KanbanRelatedSession[]> {\n    const grouped = new Map<string, {purposes: Set<KanbanSessionAssociation['purpose']>; executions: Map<string, KanbanSessionExecution>}>();\n    for (const row of associations) {\n        let group = grouped.get(row.sessionId);\n        if (!group) grouped.set(row.sessionId, group = {purposes: new Set(), executions: new Map()});\n        group.purposes.add(row.purpose);\n        if (row.execution) group.executions.set(row.execution.id, {...group.executions.get(row.execution.id), ...row.execution});\n    }\n    const rows: KanbanRelatedSession[] = [], entries = [...grouped]; let next = 0;\n    await Promise.all(Array.from({length: Math.min(entries.length, 8)}, async () => {\n        while (next < entries.length) {\n            const [sessionId, group] = entries[next++], state = await inspect(sessionId);\n            rows.push({...state, current: sessionId === currentId, purposes: [...group.purposes].sort(),\n                executions: [...group.executions.values()].sort((a, b) => (a.createdAt ?? 0) - (b.createdAt ?? 0) || a.id.localeCompare(b.id))});\n        }\n    }));\n    return rows.sort((a, b) => Number(b.current) - Number(a.current) || a.sessionId.localeCompare(b.sessionId));\n}\n","import type {KanbanBoard, KanbanCommand, KanbanActor, KanbanService, KanbanExecutionSession, KanbanExternalReference, KanbanSessionItemSummary, KanbanWorkflowState} from './contracts';\nimport type {KanbanSessionSource} from './activity-ports';\nimport {principal,principalKey,candidates} from './identity';\nimport {KanbanError} from './ports';\nimport {querySessionItems} from './session-activity-query';\nimport {randomUUID} from './utils';\nimport {sessionAssociations, projectRelatedSessions} from './session-relations';\nexport interface KanbanSessionActivityOptions {source: KanbanSessionSource; now?:()=>number}\nexport function executionBindings(refs: KanbanExternalReference[] | undefined, referenceSystem: string) {return (refs ?? []).filter(ref=>ref.system===referenceSystem);}\nfunction currentBinding(refs: KanbanExternalReference[]|undefined, itemId:string, workflow:KanbanWorkflowState, referenceSystem: string) {\n    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];\n    if(!binding||!latest||binding.revision===latest.id) return binding;\n    return ['prepared','running','unknown','succeeded'].includes(latest.outcome)||workflow.dispatches[binding.revision ?? '']?undefined:binding;\n}\n\n/** Optional resource projection; access checks remain owned by the injected source. */\nexport function createKanbanSessionActivity(core: KanbanService, options: KanbanSessionActivityOptions | undefined, log: (event: {operationId:string;sessionId?:string;stage:string;result:'failure';code:string;durationMs:number})=>void, referenceSystem: string) {\n    const inspect=createSessionInspector(options,log);\n    const project=async(boardId:string,rows:KanbanSessionItemSummary[])=>{\n        if(!rows.some(row=>executionBindings(row.externalRefs,referenceSystem).length))return rows;\n        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)]));\n        const ids=[...new Set([...bindings.values()].flatMap(ref=>ref?[ref.id]:[]))], states=new Map<string,KanbanExecutionSession>();let next=0;\n        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));}}));\n        return rows.map(row=>{const binding=bindings.get(row.id);return {...row,...(binding?{execution:states.get(binding.id)}: {})};});\n    };\n    return {\n        queryActivity:(boardId:string,query:import('./contracts').KanbanSessionActivityQuery={})=>querySessionItems(core,boardId,query,rows=>project(boardId,rows)),\n        async executionSession(boardId:string,itemId:string, query: import('./contracts').KanbanSessionDetailQuery = {}) {\n            const started = Date.now();\n            if (!query || typeof query !== 'object' || Array.isArray(query) || Object.keys(query).some(key => key !== 'includeRelated') || query.includeRelated !== undefined && typeof query.includeRelated !== 'boolean') throw new KanbanError('INVALID_QUERY');\n            const {item}=await core.item(boardId,itemId),bindings=executionBindings(item.externalRefs,referenceSystem);\n            if(!bindings.length && !query.includeRelated)return {history:[]};\n            const [board,workflow]=await Promise.all([boardMetadata(core,boardId),core.workflow(boardId)]),last=currentBinding(item.externalRefs,itemId,workflow,referenceSystem);\n            let sessionsCode: string | undefined;\n            const related = query.includeRelated ? await options?.source.related?.(board, item, workflow).catch(error => {\n                const candidate = (error as {code?: string})?.code;\n                sessionsCode = candidate && /^[A-Z][A-Z0-9_]{0,79}$/.test(candidate) ? candidate : 'SESSION_RELATIONS_FAILED';\n                try {log({operationId: randomUUID(), stage: 'session.relations', result: 'failure', code: sessionsCode, durationMs: Date.now() - started});} catch { /* Diagnostics cannot hide known associations. */ }\n                return [];\n            }) : [];\n            const sessions = query.includeRelated ? await projectRelatedSessions([\n                ...sessionAssociations(item, bindings, workflow), ...related ?? [],\n            ], last?.id, id => inspect(board, id)) : undefined;\n            return {current:last?(sessions?.find(row=>row.sessionId===last.id) ?? await inspect(board,last.id)):undefined,\n                history:bindings.map(ref=>({sessionId:ref.id,bindingId:ref.revision,current:ref===last})).reverse(), ...(sessions ? {sessions} : {}), ...(sessionsCode ? {sessionsCode} : {})};\n        },\n        validate:(board:KanbanBoard,command:KanbanCommand|undefined,actor:KanbanActor)=>validateBinding(core,options,board,command,actor,referenceSystem),\n    };\n}\nfunction createSessionInspector(options:KanbanSessionActivityOptions|undefined,log:Parameters<typeof createKanbanSessionActivity>[2]) {\n    const now=options?.now ?? Date.now, cache=new Map<string,KanbanExecutionSession>();\n    return async(board:KanbanBoard,sessionId:string):Promise<KanbanExecutionSession>=>{\n        const started=now(),key=JSON.stringify([board.id,sessionId]);\n        try {\n            if(!options) throw new KanbanError('EXECUTION_SESSION_UNAVAILABLE');\n            const row=await options.source.inspect(board,sessionId);\n            if(row.sessionId!==sessionId) throw new KanbanError('SESSION_ACTIVITY_SCOPE_MISMATCH');\n            const stale=row.stale||row.observedAt===undefined||now()-row.observedAt>90000;\n            const value:KanbanExecutionSession={sessionId,...(typeof row.resourceId==='string'&&row.resourceId.length<=4096&&!row.resourceId.includes('\\0')?{resourceId:row.resourceId}:{}),title:row.title?.slice(0,256),state:row.state,createdAt:row.createdAt,lastActivityAt:row.lastActivityAt,observedAt:row.observedAt,stale,\n                recent:!stale&&row.lastActivityAt!==undefined&&row.lastActivityAt<=now()&&now()-row.lastActivityAt<=600000,...(row.code&&/^[A-Z][A-Z0-9_]{0,79}$/.test(row.code)?{code:row.code}:{})};\n            if(cache.size>=256) cache.delete(cache.keys().next().value!);cache.set(key,value);return value;\n        } catch(error) {\n            const candidate=(error as {code?:string})?.code,code=candidate&&/^[A-Z][A-Z0-9_]{0,79}$/.test(candidate)?candidate:'SESSION_ACTIVITY_FAILED';\n            try {log({operationId:randomUUID(),sessionId,stage:'session.activity',result:'failure',code,durationMs:now()-started});} catch { /* Observation diagnostics cannot change assignments. */ }\n            const prior=['EIO','ETIMEDOUT','ECONNRESET','ECONNREFUSED','SESSION_ACTIVITY_FAILED'].includes(code)?cache.get(key):undefined;\n            return {...prior,sessionId,state:prior?.state ?? 'unknown',stale:true,recent:false,code};\n        }\n    };\n}\nasync function boardMetadata(core: KanbanService, boardId: string): Promise<KanbanBoard> {\n    const board=(await core.catalog()).find(board=>board.id===boardId) ?? await core.read(boardId);\n    return {...board,items:[]};\n}\nasync function validateBinding(core: KanbanService, options:KanbanSessionActivityOptions|undefined, board:KanbanBoard, command:KanbanCommand|undefined, actor:KanbanActor, referenceSystem: string): Promise<void> {\n    if(command?.type!=='link-reference'||command.reference.system!==referenceSystem) return;\n    if(!options||!command.reference.revision) throw new KanbanError('EXECUTION_SESSION_UNAVAILABLE');\n    const item=board.items.find(item=>item.id===command.itemId);if(!item) throw new KanbanError('ITEM_NOT_FOUND');\n    const key=principalKey(principal(actor)), coordinator=board.members?.some(member=>principalKey(member)===key&&member.roles?.includes('coordinator'));\n    if(!coordinator&&item.owner?.principalId!==key&&!(item.owner===undefined&&candidates(board,item).some(candidate=>principalKey(candidate)===key))) throw new KanbanError('EXECUTION_SESSION_ASSIGNMENT_DENIED');\n    const active=Object.values((await core.workflow(board.id)).dispatches).filter(dispatch=>dispatch.itemId===item.id).sort((a,b)=>b.attempt-a.attempt)[0];\n    if(active&&command.reference.revision!==active.id) throw new KanbanError('EXECUTION_SESSION_LOCKED');\n    if(active&&executionBindings(item.externalRefs,referenceSystem).some(ref=>ref.revision===active.id&&ref.id!==command.reference.id)) throw new KanbanError('EXECUTION_SESSION_LOCKED');\n    if(options.source.authorizeBinding) return options.source.authorizeBinding(board,command.reference.id);\n    const state=await options.source.inspect(board,command.reference.id);\n    if(state.sessionId!==command.reference.id||state.stale) throw new KanbanError('EXECUTION_SESSION_UNAVAILABLE');\n}\n","import {createKanbanModule as createCore, type KanbanModuleHandle as CoreHandle} from './module';\nimport type {KanbanModuleOptions} from './ports';\nimport {KanbanError} from './ports';\nimport type {KanbanSessionActivityQuery, KanbanSessionItemPage, KanbanExecutionSessionDetail} from './contracts';\nimport {createKanbanSessionActivity, type KanbanSessionActivityOptions} from './session-activity';\nexport interface KanbanActivityModuleOptions extends KanbanModuleOptions {\n    executionSessions?: KanbanSessionActivityOptions;\n    referenceSystem: string;\n}\nexport interface KanbanActivityHandle extends CoreHandle {\n    queryActivity: (boardId: string, query?: KanbanSessionActivityQuery) => Promise<KanbanSessionItemPage>;\n    executionSession: (boardId: string, itemId: string, query?: import('./contracts').KanbanSessionDetailQuery) => Promise<KanbanExecutionSessionDetail>;\n}\n\n/** Application integrations stay outside the portable core. */\nexport function createKanbanActivityModule(options: KanbanActivityModuleOptions): KanbanActivityHandle {\n    const {executionSessions, referenceSystem, ...core} = options;\n    let activity: ReturnType<typeof createKanbanSessionActivity>;\n    const service=createCore({...core,\n        authorize:async input=>{await core.authorize(input);await activity.validate(input.board,input.command,input.actor);},\n    });\n    activity=createKanbanSessionActivity(service,executionSessions,core.log,referenceSystem);\n    let stopping = false;\n    const pending = new Set<Promise<unknown>>();\n    const track = <T>(run: () => Promise<T>): Promise<T> => {\n        if (stopping) return Promise.reject(new KanbanError('SERVICE_STOPPING'));\n        const work = Promise.resolve().then(run).finally(() => {pending.delete(work);});\n        pending.add(work); return work;\n    };\n    const quiesce = async () => {\n        stopping = true;\n        await Promise.allSettled([...pending]);\n        await service.quiesce();\n    };\n    return {\n        ...forwardCore(service, track),\n        queryActivity: (...args) => track(() => activity.queryActivity(...args)),\n        executionSession: (...args) => track(() => activity.executionSession(...args)),\n        related: sessionId => track(() => relatedBoards(service, referenceSystem, sessionId)),\n        quiesce, dispose: quiesce,\n    };\n}\n\nfunction forwardCore(service: CoreHandle, track: <T>(run: () => Promise<T>) => Promise<T>): Omit<CoreHandle, 'related' | 'quiesce' | 'dispose'> {\n    return {\n        create: (input) => track(() => service.create(input)),\n        read: (id) => track(() => service.read(id)),\n        list: () => track(() => service.list()),\n        catalog: () => track(() => service.catalog()),\n        execute: (id, request) => track(() => service.execute(id, request)),\n        events: (id, after, limit) => track(() => service.events(id, after, limit)),\n        query: (id, query) => track(() => service.query(id, query)),\n        item: (id, item) => track(() => service.item(id, item)),\n        overview: (id) => track(() => service.overview(id)),\n        scan: () => track(() => service.scan()),\n        workflow: (id) => track(() => service.workflow(id)),\n        resolve: (reference) => track(() => service.resolve(reference)),\n        suggest: (id, query) => track(() => service.suggest(id, query)),\n        records: (id, query) => track(() => service.records(id, query)),\n        record: (id, record) => track(() => service.record(id, record)),\n        currentPrincipal: () => track(() => service.currentPrincipal()),\n    };\n}\nasync function relatedBoards(service: CoreHandle, referenceSystem: string, sessionId: string) {\n    const boards = await service.related(sessionId);\n    for (const board of await service.catalog()) {\n        if (boards.some(old => old.id === board.id)) continue;\n        const matches = await service.query(board.id, {view: 'all', reference: {system: referenceSystem, id: sessionId}, limit: 1});\n        if (matches.total) boards.push(await service.read(board.id));\n    }\n    return boards;\n}\n"],"mappings":"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","names":["page","board","item"]}

package/dist/chunk-2YFPV5GF.cjs

@@ -0,0 +1,16 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/ports.ts
+var KanbanError = class extends Error {
+  constructor(code) {
+    super(code);
+    this.code = code;
+    this.name = "KanbanError";
+  }
+};
+var KanbanScanNotStartedError = class extends KanbanError {
+};
+
+
+
+
+exports.KanbanError = KanbanError; exports.KanbanScanNotStartedError = KanbanScanNotStartedError;
+//# sourceMappingURL=chunk-2YFPV5GF.cjs.map

package/dist/chunk-2YFPV5GF.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/li/share/prj/x1/release/local-libraries/work/1ca933a0-6fe7-4e9c-b13b-76d7f318e0fb/source/libraries/kanban/dist/chunk-2YFPV5GF.cjs","../src/ports.ts"],"names":[],"mappings":"AAAA;AC8CO,IAAM,YAAA,EAAN,MAAA,QAA0B,MAAM;AAAA,EACnC,WAAA,CAAqB,IAAA,EAAc;AAAE,IAAA,KAAA,CAAM,IAAI,CAAA;AAA1B,IAAA,IAAA,CAAA,KAAA,EAAA,IAAA;AAA6B,IAAA,IAAA,CAAK,KAAA,EAAO,aAAA;AAAA,EAAe;AACjF,CAAA;AAEO,IAAM,0BAAA,EAAN,MAAA,QAAwC,YAAY;AAAC,CAAA;ADxC5D;AACA;AACE;AACA;AACF,iGAAC","file":"/home/li/share/prj/x1/release/local-libraries/work/1ca933a0-6fe7-4e9c-b13b-76d7f318e0fb/source/libraries/kanban/dist/chunk-2YFPV5GF.cjs","sourcesContent":[null,"import type { KanbanActor, KanbanBoard, KanbanCommand, KanbanEvent, KanbanArchivedItem, KanbanItemSummary } from './contracts';\n\nexport interface KanbanState {\n    workflow?: import('./contracts').KanbanWorkflowState;\n    numbering?: {item: number; log: number; decision: number};\n    presetVersions?: Record<string, number>;\n    records?: import('./contracts').KanbanProjectRecord[];\n    discovery?: import('./scan-ports').KanbanDiscoveryState;\n    archiveIndex?: KanbanItemSummary[];\n    archiveWrites?: Array<{id: string; value: KanbanArchivedItem | null}>;\n    restore?: KanbanArchivedItem;\n    schema: 1; board: KanbanBoard; sequence: number; events: KanbanEvent[]; escalations: string[];\n}\nexport interface KanbanReadView {\n    /** Board metadata and summary indexes; no item/record bodies. */\n    state: KanbanState;\n    items: import('./contracts').KanbanItemSummary[];\n    records: import('./contracts').KanbanRecordSummary[];\n}\nexport interface KanbanStore {\n    boardId?(number: number): Promise<string | null>;\n    view?(id: string): Promise<KanbanReadView | null>;\n    ids(): Promise<string[]>;\n    archived(boardId: string, itemId: string): Promise<KanbanArchivedItem | null>;\n    events(id: string, after: number, limit: number, through: number): Promise<KanbanEvent[]>;\n    read(id: string): Promise<KanbanState | null>;\n    update(id: string, operationId: string, fingerprint: string,\n        change: (state: KanbanState | null) => KanbanState): Promise<KanbanState>;\n}\nexport interface KanbanModuleOptions {\n    /** Host supplies metadata within the authorized user's/project's session scope. */\n    suggestions?(board: KanbanBoard, kind: import('./contracts').KanbanSuggestionKind, search: string, limit: number): Promise<import('./contracts').KanbanSuggestion[] | undefined>;\n    verifyOutputs?(input: {stage?: 'observe' | 'accept'; board: KanbanBoard; itemId: string; dispatchId?: string; outputs: import('./contracts').KanbanArtifactRef[]}): Promise<boolean>;\n    onCommitted?(boardId: string, service: import('./contracts').KanbanService, now: number): Promise<void>;\n    store: KanbanStore;\n    /** Trusted identity resolved by the host, never from command payloads. */\n    actor: KanbanActor;\n    /** Must validate project access, delegated authority and session registration. */\n    authorize(input: { actor: KanbanActor; board: KanbanBoard; action: 'create' | 'read' | 'install-content' | KanbanCommand['type']; command?: KanbanCommand }): Promise<void>;\n    /** Confirm an automated owner has settled before releasing responsibility. */\n    verifyDeletion?(board: KanbanBoard): Promise<void>;\n    verifyRelease?(input: {actor: KanbanActor; board: KanbanBoard; item: import('./contracts').KanbanItem}): Promise<boolean>;\n    now?: () => number;\n    id?: () => string;\n    log(event: { operationId: string; boardId?: string; sessionId?: string; stage: string; result: 'success' | 'failure'; code?: string; durationMs: number }): void;\n}\nexport class KanbanError extends Error {\n    constructor(readonly code: string) { super(code); this.name = 'KanbanError'; }\n}\n\nexport class KanbanScanNotStartedError extends KanbanError {}\n"]}

package/dist/chunk-4KF7KUAI.cjs

@@ -0,0 +1,221 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return 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; }
+
+var _chunk2YFPV5GFcjs = require('./chunk-2YFPV5GF.cjs');
+
+
+
+var _chunkPSKQAFDFcjs = require('./chunk-PSKQAFDF.cjs');
+
+// src/discovery-state.ts
+function discoveryState(state) {
+  return _optionalChain([state, 'optionalAccess', _ => _.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 _nullishCoalesce(board.workTypes, () => ( _chunkPSKQAFDFcjs.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, _nullishCoalesce(_nullishCoalesce(_optionalChain([item, 'access', _2 => _2.planning, 'optionalAccess', _3 => _3.kind]), () => ( board.defaultWorkType)), () => ( "task")));
+  return _chunkPSKQAFDFcjs.executableWorkItem.call(void 0, 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, _nullishCoalesce(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 _nullishCoalesce(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(_nullishCoalesce(_optionalChain([board, 'access', _4 => _4.notifications, 'optionalAccess', _5 => _5.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 (0, _chunk2YFPV5GFcjs.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 _nullishCoalesce(board.agents, () => ( []))) {
+    identity(agent.agentId);
+    text(agent.responsibility);
+  }
+  requireValue(new Set((_nullishCoalesce(board.agents, () => ( []))).map((a) => a.agentId)).size === (_nullishCoalesce(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 = _nullishCoalesce(actor.kind, () => ( "agent")), id = kind === "agent" ? _nullishCoalesce(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 _nullishCoalesce(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 [...(_nullishCoalesce(board.agents, () => ( []))).map((a) => ({ kind: "agent", id: a.agentId })), ..._nullishCoalesce(board.members, () => ( []))];
+}
+function candidates(board, item) {
+  if (item.eligibleAgentIds === void 0 && item.eligiblePrincipals === void 0)
+    return [
+      ...(_nullishCoalesce(board.agents, () => ( []))).map((a) => ({ kind: "agent", id: a.agentId })),
+      ...(_nullishCoalesce(board.members, () => ( []))).filter((m) => !m.roles || m.roles.includes("worker"))
+    ];
+  return [...(_nullishCoalesce(item.eligibleAgentIds, () => ( []))).map((id) => ({ kind: "agent", id })), ..._nullishCoalesce(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 };
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.principal = principal; exports.principalKey = principalKey; exports.assigneeKey = assigneeKey; exports.sameOwner = sameOwner; exports.candidates = candidates; exports.eligible = eligible; exports.validateCandidates = validateCandidates; exports.normalizeActor = normalizeActor; exports.policy = policy; exports.workType = workType; exports.executable = executable; exports.requireValue = requireValue; exports.text = text; exports.identity = identity; exports.positive = positive; exports.validateEstimate = validateEstimate; exports.validateBoard = validateBoard; exports.participant = participant; exports.owned = owned; exports.discoveryState = discoveryState;
+//# sourceMappingURL=chunk-4KF7KUAI.cjs.map