@nestos/kanban 0.0.0-stage → 0.5.2

package/dist/chunk-DINLR6E6.cjs

@@ -0,0 +1,443 @@
+"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 _class;
+
+
+
+
+
+
+
+
+
+
+var _chunkEYTVC2H5cjs = require('./chunk-EYTVC2H5.cjs');
+
+
+
+
+
+
+
+
+
+var _chunkRBOER6EWcjs = require('./chunk-RBOER6EW.cjs');
+
+
+var _chunk7KDOTBRXcjs = require('./chunk-7KDOTBRX.cjs');
+
+
+
+var _chunkRSH6QSECcjs = require('./chunk-RSH6QSEC.cjs');
+
+
+
+var _chunkAOHQCX7Kcjs = require('./chunk-AOHQCX7K.cjs');
+
+// src/references.ts
+async function resolveReference(reference, store, read) {
+  _chunkRBOER6EWcjs.requireValue.call(void 0, typeof reference === "string" && reference.length <= 100, "INVALID_REFERENCE");
+  const match = /^KB-([1-9]\d*)(?:#([1-9]\d*)|\/(L|D)-([1-9]\d*))?$/i.exec(reference.trim());
+  _chunkRBOER6EWcjs.requireValue.call(void 0, match && [match[1], match[2], match[4]].every((value) => value === void 0 || Number.isSafeInteger(Number(value))), "INVALID_REFERENCE");
+  const id = await _optionalChain([store, 'access', _ => _.boardId, 'optionalCall', _2 => _2(Number(match[1]))]);
+  _chunkRBOER6EWcjs.requireValue.call(void 0, id, "REFERENCE_NOT_FOUND");
+  const view = await read(id), board = view.state.board;
+  _chunkRBOER6EWcjs.requireValue.call(void 0, board.number === Number(match[1]), "INVALID_NUMBERING");
+  const target = { boardId: id, scope: board.scope, reference: _chunk7KDOTBRXcjs.kanbanReference.call(void 0, board) };
+  if (match[2]) {
+    const item = [...view.items, ..._nullishCoalesce(view.state.archiveIndex, () => ( []))].find((item2) => item2.number === Number(match[2]));
+    _chunkRBOER6EWcjs.requireValue.call(void 0, item, "REFERENCE_NOT_FOUND");
+    target.itemId = item.id;
+    target.reference = _chunk7KDOTBRXcjs.kanbanReference.call(void 0, board, item);
+  } else if (match[3]) {
+    const record = view.records.find((record2) => record2.kind === (match[3].toUpperCase() === "L" ? "log" : "decision") && record2.number === Number(match[4]));
+    _chunkRBOER6EWcjs.requireValue.call(void 0, record, "REFERENCE_NOT_FOUND");
+    target.recordId = record.id;
+    target.reference = _chunk7KDOTBRXcjs.kanbanReference.call(void 0, board, record);
+  }
+  return target;
+}
+
+// src/suggestions.ts
+function validateSuggestionQuery(query) {
+  _chunkRBOER6EWcjs.requireValue.call(void 0, query && ["item", "parent", "dependency", "area", "milestone", "decision", "session"].includes(query.kind), "INVALID_SUGGESTION_KIND");
+  _chunkRBOER6EWcjs.requireValue.call(void 0, query.search === void 0 || typeof query.search === "string" && query.search.length <= 256, "INVALID_FILTER");
+  const limit = _nullishCoalesce(query.limit, () => ( 20));
+  _chunkRBOER6EWcjs.requireValue.call(void 0, Number.isSafeInteger(limit) && limit > 0 && limit <= 50, "INVALID_LIMIT");
+  if (query.excludeItemId !== void 0) _chunkRBOER6EWcjs.identity.call(void 0, query.excludeItemId);
+  if (query.excludeIds !== void 0) {
+    _chunkRBOER6EWcjs.requireValue.call(void 0, Array.isArray(query.excludeIds) && query.excludeIds.length <= 100, "INVALID_FILTER");
+    query.excludeIds.forEach(_chunkRBOER6EWcjs.identity);
+  }
+  if (query.childKind !== void 0) _chunkRBOER6EWcjs.identity.call(void 0, query.childKind);
+  return limit;
+}
+function suggestionPage(revision, rows, query) {
+  const limit = validateSuggestionQuery(query), search = _nullishCoalesce(_optionalChain([query, 'access', _3 => _3.search, 'optionalAccess', _4 => _4.trim, 'call', _5 => _5(), 'access', _6 => _6.toLocaleLowerCase, 'call', _7 => _7()]), () => ( ""));
+  const matched = rows.filter((row) => !_optionalChain([query, 'access', _8 => _8.excludeIds, 'optionalAccess', _9 => _9.includes, 'call', _10 => _10(row.id)])).filter((row) => `${row.id} ${row.label} ${_nullishCoalesce(row.detail, () => ( ""))}`.toLocaleLowerCase().includes(search)).sort((a, b) => score(a.label, search) - score(b.label, search) || a.label.localeCompare(b.label) || a.id.localeCompare(b.id));
+  return { revision, items: matched.slice(0, limit).map((row) => ({ id: row.id, label: row.label.slice(0, 256), ...row.detail ? { detail: row.detail.slice(0, 512) } : {}, ...row.status ? { status: row.status } : {}, ...row.archived !== void 0 ? { archived: row.archived } : {} })), hasMore: matched.length > limit };
+}
+var score = (label, query) => label.toLocaleLowerCase() === query ? 0 : label.toLocaleLowerCase().startsWith(query) ? 1 : 2;
+function suggestFromState(state, query, items = _chunkEYTVC2H5cjs.catalog.call(void 0, state), records = (_nullishCoalesce(state.records, () => ( []))).map(_chunkEYTVC2H5cjs.recordSummary)) {
+  validateSuggestionQuery(query);
+  if (query.kind === "area" || query.kind === "milestone") {
+    const names = [...new Set(items.map((item) => item.planning[query.kind]).filter((name) => !!name))];
+    return suggestionPage(state.board.revision, names.map((name) => ({ id: name, label: name })), query);
+  }
+  if (query.kind === "decision") return suggestionPage(state.board.revision, records.filter((record) => record.kind === "decision" && record.status === "confirmed").map((record) => ({ id: record.id, label: record.title, detail: _chunk7KDOTBRXcjs.kanbanReference.call(void 0, state.board, record) })), query);
+  if (query.kind === "session") {
+    const ids = /* @__PURE__ */ new Set([
+      ...state.board.participants.map((p) => p.sessionId),
+      ...items.flatMap((item) => item.sessionIds),
+      ...records.flatMap((record) => record.sessionIds)
+    ]);
+    return suggestionPage(state.board.revision, [...ids].map((id) => ({ id, label: id })), query);
+  }
+  const blocked = query.kind === "dependency" && query.excludeItemId ? dependents(items, query.excludeItemId) : /* @__PURE__ */ new Set();
+  const rank = query.kind === "parent" ? _chunkRBOER6EWcjs.workType.call(void 0, state.board, _nullishCoalesce(_nullishCoalesce(query.childKind, () => ( state.board.defaultWorkType)), () => ( "task"))).rank : void 0;
+  const rows = items.filter((item) => item.id !== query.excludeItemId && !blocked.has(item.id) && (query.kind !== "dependency" || item.status !== "cancelled") && (rank === void 0 || item.archivedAt === void 0 && !_chunkEYTVC2H5cjs.terminal.call(void 0, item) && _chunkRBOER6EWcjs.workType.call(void 0, state.board, item.planning.kind).rank < rank)).map((item) => ({
+    id: item.id,
+    label: item.title,
+    status: item.status,
+    archived: item.archivedAt !== void 0,
+    detail: [_chunk7KDOTBRXcjs.kanbanReference.call(void 0, state.board, item), item.planning.area, item.planning.milestone].filter(Boolean).join(" \xB7 ")
+  }));
+  return suggestionPage(state.board.revision, rows, query);
+}
+function dependents(items, id) {
+  const reverse = /* @__PURE__ */ new Map();
+  for (const item of items) for (const dependency of item.planning.dependencies) reverse.set(dependency, [..._nullishCoalesce(reverse.get(dependency), () => ( [])), item.id]);
+  const result = /* @__PURE__ */ new Set([id]), pending = [id];
+  while (pending.length) for (const next of _nullishCoalesce(reverse.get(pending.pop()), () => ( []))) if (!result.has(next)) {
+    result.add(next);
+    pending.push(next);
+  }
+  return result;
+}
+
+// src/queries.ts
+function queryItems(state, query = {}, all = _chunkEYTVC2H5cjs.catalog.call(void 0, state), now = Date.now()) {
+  const { cursor, limit = 50, ...filters } = query;
+  _chunkRBOER6EWcjs.requireValue.call(void 0, Number.isSafeInteger(limit) && limit >= 1 && limit <= 200, "INVALID_PAGE_SIZE");
+  _chunkRBOER6EWcjs.requireValue.call(void 0, ["ready", "backlog", "in-progress", "review", "closed", "proposed", "archive", "all"].includes(_nullishCoalesce(query.view, () => ( "ready"))), "INVALID_VIEW");
+  for (const field of ["area", "milestone", "parentId", "kind", "sessionId", "search"]) if (filters[field] !== void 0) _chunkRBOER6EWcjs.requireValue.call(void 0, typeof filters[field] === "string" && filters[field].length <= 256, "INVALID_FILTER");
+  if (filters.reference) _chunkRBOER6EWcjs.requireValue.call(void 0, typeof filters.reference.system === "string" && typeof filters.reference.id === "string" && filters.reference.system.length <= 256 && filters.reference.id.length <= 256, "INVALID_REFERENCE_FILTER");
+  const fingerprint = JSON.stringify(Object.fromEntries(Object.entries({ ...filters, view: _nullishCoalesce(filters.view, () => ( "ready")) }).sort(([a], [b]) => a.localeCompare(b)))), revision = state.board.revision;
+  all = all.map((item) => ({ ...item, task: _chunkAOHQCX7Kcjs.projectKanbanTask.call(void 0, item, state.workflow, now, all) }));
+  const matches = all.filter((item) => matchesQuery(item, filters, state.board)).sort(filters.view === "archive" ? (a, b) => (_nullishCoalesce(b.archivedAt, () => ( 0))) - (_nullishCoalesce(a.archivedAt, () => ( 0))) || a.id.localeCompare(b.id) : order);
+  let start = 0;
+  if (cursor) {
+    _chunkRBOER6EWcjs.requireValue.call(void 0, typeof cursor === "string" && cursor.length <= 4e3, "INVALID_CURSOR");
+    let decoded;
+    try {
+      decoded = JSON.parse(cursor);
+    } catch (e) {
+      _chunkRBOER6EWcjs.requireValue.call(void 0, false, "INVALID_CURSOR");
+    }
+    _chunkRBOER6EWcjs.requireValue.call(void 0, decoded && decoded.filter === fingerprint, "CURSOR_SCOPE_MISMATCH");
+    _chunkRBOER6EWcjs.requireValue.call(void 0, decoded.revision === revision, "CURSOR_STALE");
+    start = matches.findIndex((i) => i.id === decoded.after) + 1;
+    _chunkRBOER6EWcjs.requireValue.call(void 0, start > 0, "INVALID_CURSOR");
+  }
+  const progress = progressByParent(state, all);
+  const items = matches.slice(start, start + limit).map((item) => ({ ...item, ...progress.has(item.id) ? { progress: progress.get(item.id) } : {} }));
+  return { revision, total: matches.length, items, ...start + items.length < matches.length ? {
+    nextCursor: JSON.stringify({ revision, after: items.at(-1).id, filter: fingerprint })
+  } : {} };
+}
+function order(a, b) {
+  return a.planning.priority - b.planning.priority || a.createdAt - b.createdAt || a.id.localeCompare(b.id);
+}
+function matchesQuery(item, query, board) {
+  if (item.deletedAt !== void 0 && !query.includeDeleted) return false;
+  if (query.phase && _optionalChain([item, 'access', _11 => _11.task, 'optionalAccess', _12 => _12.phase]) !== query.phase) return false;
+  if (!matchesView(item, _nullishCoalesce(query.view, () => ( "ready")))) return false;
+  for (const field of ["area", "milestone", "parentId", "kind"]) if (query[field] !== void 0 && item.planning[field] !== query[field]) return false;
+  if (query.reference && !_optionalChain([item, 'access', _13 => _13.externalRefs, 'optionalAccess', _14 => _14.some, 'call', _15 => _15((r) => r.system === query.reference.system && r.id === query.reference.id)])) return false;
+  if (query.sessionId && !item.sessionIds.includes(query.sessionId)) return false;
+  if (query.search && !`${_chunk7KDOTBRXcjs.kanbanReference.call(void 0, board, item)} ${item.id} ${item.title} ${_nullishCoalesce(item.planning.area, () => ( ""))}`.toLowerCase().includes(query.search.toLowerCase())) return false;
+  return true;
+}
+function matchesView(item, view) {
+  if (view === "archive") return item.archivedAt !== void 0;
+  if (view === "all") return true;
+  if (item.archivedAt !== void 0) return false;
+  if (view === "in-progress") return item.status === "claimed" || item.status === "review";
+  if (view === "closed") return _chunkEYTVC2H5cjs.terminal.call(void 0, item);
+  return item.status === { ready: "open", backlog: "backlog", review: "review", proposed: "proposed" }[view];
+}
+function overview(state, now, items = state.board.items.map(_chunkEYTVC2H5cjs.summary)) {
+  items = items.filter((item) => item.deletedAt === void 0);
+  const count = (status) => items.filter((i) => i.status === status).length;
+  const age = state.board.policy.backlogReviewMs;
+  return {
+    revision: state.board.revision,
+    visible: items.length,
+    active: items.filter((i) => !_chunkEYTVC2H5cjs.terminal.call(void 0, i)).length,
+    archived: _nullishCoalesce(_optionalChain([state, 'access', _16 => _16.archiveIndex, 'optionalAccess', _17 => _17.length]), () => ( 0)),
+    ready: count("open"),
+    inProgress: count("claimed") + count("review"),
+    backlog: count("backlog"),
+    proposed: count("proposed"),
+    closed: count("completed") + count("cancelled"),
+    dueForReview: age ? items.filter((i) => i.status === "backlog" && now - i.updatedAt >= age).length : 0,
+    limits: _chunkEYTVC2H5cjs.limits.call(void 0, state)
+  };
+}
+function progressByParent(state, all) {
+  const byId = new Map(all.map((i) => [i.id, i]));
+  const result = /* @__PURE__ */ new Map();
+  for (const item of all.filter((i) => _chunkRBOER6EWcjs.executable.call(void 0, state.board, i))) {
+    let parent = item.planning.parentId;
+    const seen = /* @__PURE__ */ new Set();
+    while (parent && !seen.has(parent)) {
+      seen.add(parent);
+      const progress = _nullishCoalesce(result.get(parent), () => ( { total: 0, completed: 0, cancelled: 0, inProgress: 0 }));
+      progress.total++;
+      if (item.status === "completed") progress.completed++;
+      if (item.status === "cancelled") progress.cancelled++;
+      if (item.status === "claimed" || item.status === "review") progress.inProgress++;
+      result.set(parent, progress);
+      parent = _optionalChain([byId, 'access', _18 => _18.get, 'call', _19 => _19(parent), 'optionalAccess', _20 => _20.planning, 'access', _21 => _21.parentId]);
+    }
+  }
+  return result;
+}
+
+// src/module.ts
+function createKanbanModule(options) {
+  return new KanbanModule(options);
+}
+var KanbanModule = (_class = class {
+  constructor(options) {;_class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this);_class.prototype.__init4.call(this);_class.prototype.__init5.call(this);_class.prototype.__init6.call(this);_class.prototype.__init7.call(this);_class.prototype.__init8.call(this);_class.prototype.__init9.call(this);_class.prototype.__init10.call(this);_class.prototype.__init11.call(this);_class.prototype.__init12.call(this);_class.prototype.__init13.call(this);_class.prototype.__init14.call(this);_class.prototype.__init15.call(this);_class.prototype.__init16.call(this);_class.prototype.__init17.call(this);_class.prototype.__init18.call(this);_class.prototype.__init19.call(this);
+    this.options = options;
+    this.now = _nullishCoalesce(options.now, () => ( Date.now));
+    this.id = _nullishCoalesce(options.id, () => ( _chunkRSH6QSECcjs.randomUUID));
+    this.actor = _chunkRBOER6EWcjs.normalizeActor.call(void 0, options.actor);
+  }
+  __init() {this.stopping = false}
+  __init2() {this.pending = /* @__PURE__ */ new Set()}
+  async quiesce() {
+    this.stopping = true;
+    await Promise.allSettled([...this.pending]);
+  }
+  async dispose() {
+    await this.quiesce();
+  }
+  
+  
+  
+  __init3() {this.workflow = (boardId) => this.guard(this.id(), boardId, "workflow", async () => structuredClone(await _asyncNullishCoalesce((await this.readView(boardId)).state.workflow, async () => ( { plans: {}, dispatches: {}, ready: [], completedPlans: [] }))))}
+  __init4() {this.resolve = (reference) => this.guard(this.id(), void 0, "resolve", () => resolveReference(reference, this.options.store, (id) => this.readView(id)))}
+  __init5() {this.suggest = (boardId, query) => this.guard(this.id(), boardId, "suggest", async () => {
+    const snapshot = structuredClone(query), limit = validateSuggestionQuery(snapshot), view = await this.readView(boardId), state = view.state;
+    const suggestions = () => suggestFromState(state, snapshot, [...view.items, ..._nullishCoalesce(state.archiveIndex, () => ( []))], view.records);
+    if (!this.options.suggestions) return suggestions();
+    const rows = await this.options.suggestions(structuredClone(state.board), snapshot.kind, _nullishCoalesce(_optionalChain([snapshot, 'access', _50 => _50.search, 'optionalAccess', _51 => _51.trim, 'call', _52 => _52()]), () => ( "")), limit + 1);
+    if (rows === void 0) return suggestions();
+    const known = suggestions().items.filter((row) => !rows.some((entry) => entry.id === row.id));
+    return suggestionPage(state.board.revision, [...rows, ...known], snapshot);
+  })}
+  __init6() {this.records = (boardId, query) => this.guard(this.id(), boardId, "records", async () => {
+    const view = await this.readView(boardId);
+    return structuredClone(_chunkEYTVC2H5cjs.queryRecords.call(void 0, view.state, query, view.records));
+  })}
+  __init7() {this.record = (boardId, recordId) => this.guard(this.id(), boardId, "record", async () => {
+    _chunkRBOER6EWcjs.identity.call(void 0, recordId);
+    const record = await _asyncOptionalChain([(await this.readState(boardId)), 'access', async _53 => _53.records, 'optionalAccess', async _54 => _54.find, 'call', async _55 => _55((record2) => record2.id === recordId)]);
+    _chunkRBOER6EWcjs.requireValue.call(void 0, record, "RECORD_NOT_FOUND");
+    return structuredClone(record);
+  })}
+  __init8() {this.currentPrincipal = async () => structuredClone(_chunkRBOER6EWcjs.principal.call(void 0, this.actor))}
+  __init9() {this.create = (input) => {
+    const snapshot = structuredClone(input);
+    return this.guard(this.id(), snapshot.id, "create", async () => {
+      const initial = _chunkEYTVC2H5cjs.createBoardState.call(void 0, snapshot, this.actor, this.now()), board = initial.board;
+      await this.authorize(board, "create");
+      const state = await this.options.store.update(board.id, `create:${board.id}`, JSON.stringify({ snapshot, actor: this.actor }), (previous) => {
+        _chunkRBOER6EWcjs.requireValue.call(void 0, !previous, "BOARD_EXISTS");
+        return initial;
+      });
+      return structuredClone(state.board);
+    });
+  }}
+  __init10() {this.read = (boardId) => this.guard(
+    this.id(),
+    boardId,
+    "read",
+    async () => structuredClone((await this.readState(boardId)).board)
+  )}
+  __init11() {this.catalog = () => this.guard(this.id(), void 0, "catalog", async () => {
+    const boards = [];
+    for (const id of await this.options.store.ids()) {
+      try {
+        const view = await this.readView(id);
+        if (view.state.board.deletedAt !== void 0) continue;
+        boards.push({ ...view.state.board, executionPhase: _chunkAOHQCX7Kcjs.boardControlPhase.call(void 0, { ...view.state.board, items: view.items }), items: view.items.filter((item) => item.deletedAt === void 0).map(({ id: id2, title, number }) => ({ id: id2, title, ...number === void 0 ? {} : { number } })) });
+      } catch (error) {
+        if (!(error instanceof _chunkRSH6QSECcjs.KanbanError) || error.code !== "FORBIDDEN") throw error;
+      }
+    }
+    return structuredClone(boards);
+  })}
+  __init12() {this.list = () => this.guard(this.id(), void 0, "list", async () => {
+    const boards = [];
+    for (const boardId of await this.options.store.ids()) {
+      try {
+        const board = (await this.readState(boardId)).board;
+        if (board.deletedAt === void 0) boards.push(structuredClone(board));
+      } catch (error) {
+        if (!(error instanceof _chunkRSH6QSECcjs.KanbanError) || error.code !== "FORBIDDEN") throw error;
+      }
+    }
+    return boards;
+  })}
+  __init13() {this.execute = (boardId, input) => this.guard(input.operationId, boardId, `execute:${input.command.type}`, async () => {
+    const request = structuredClone(input);
+    _chunkRBOER6EWcjs.identity.call(void 0, request.operationId);
+    const state = await this.readState(boardId);
+    await this.authorize(state.board, request.command.type, request.command);
+    _chunkRBOER6EWcjs.requireValue.call(void 0, state.board.deletedAt === void 0, "BOARD_DELETED");
+    if (request.command.type === "delete-board") await _optionalChain([this, 'access', _56 => _56.options, 'access', _57 => _57.verifyDeletion, 'optionalCall', _58 => _58(structuredClone(state.board))]);
+    await _optionalChain([this, 'access', _59 => _59.options, 'access', _60 => _60.verifyLifecycle, 'optionalCall', _61 => _61(structuredClone(state.board), request.command)]);
+    await this.verifyRelease(state.board, request.command);
+    const verifyStage = request.command.type === "observe-execution" && request.command.outcome === "succeeded" ? "observe" : request.command.type === "accept-execution" && request.command.accept ? "accept" : void 0;
+    if (verifyStage && "dispatchId" in request.command) {
+      const dispatch = _optionalChain([state, 'access', _62 => _62.workflow, 'optionalAccess', _63 => _63.dispatches, 'access', _64 => _64[request.command.dispatchId]]);
+      _chunkRBOER6EWcjs.requireValue.call(void 0, dispatch, "DISPATCH_NOT_FOUND");
+      const outputs = request.command.type === "observe-execution" ? request.command.outputs : dispatch.outputs;
+      if (_optionalChain([outputs, 'optionalAccess', _65 => _65.length])) _chunkRBOER6EWcjs.requireValue.call(void 0, await _optionalChain([this, 'access', _66 => _66.options, 'access', _67 => _67.verifyOutputs, 'optionalCall', _68 => _68({
+        stage: verifyStage,
+        board: state.board,
+        itemId: dispatch.itemId,
+        dispatchId: dispatch.id,
+        outputs: structuredClone(outputs)
+      })]), "OUTPUT_VERIFICATION_REQUIRED");
+    }
+    const restore = request.command.type === "restore-item" ? await this.options.store.archived(boardId, request.command.itemId) : void 0;
+    const result = await this.options.store.update(boardId, request.operationId, JSON.stringify({ actor: this.actor, request }), (current) => {
+      _chunkRBOER6EWcjs.requireValue.call(void 0, current && current.board.revision === state.board.revision, "REVISION_CONFLICT");
+      _chunkRBOER6EWcjs.requireValue.call(void 0, current.board.revision === request.expectedRevision, "REVISION_CONFLICT");
+      if (restore) current.restore = restore;
+      return _chunkEYTVC2H5cjs.reduce.call(void 0, current, request.command, this.actor, request.operationId, this.now(), this.id());
+    });
+    await this.publishNotifications(boardId, request.operationId);
+    return structuredClone(result.board);
+  })}
+  __init14() {this.events = (boardId, after = 0, limit = 100) => this.guard(this.id(), boardId, "events", async () => {
+    _chunkRBOER6EWcjs.requireValue.call(void 0, Number.isSafeInteger(after) && after >= 0 && Number.isSafeInteger(limit) && limit > 0 && limit <= 500, "INVALID_CURSOR");
+    const { state } = await this.readView(boardId);
+    return this.options.store.events(boardId, after, limit, state.sequence);
+  })}
+  __init15() {this.query = (boardId, query) => this.guard(this.id(), boardId, "query", async () => {
+    const view = await this.readView(boardId);
+    return structuredClone(queryItems(view.state, query, [...view.items, ..._nullishCoalesce(view.state.archiveIndex, () => ( []))], this.now()));
+  })}
+  __init16() {this.overview = (boardId) => this.guard(this.id(), boardId, "overview", async () => {
+    const view = await this.readView(boardId);
+    return overview(view.state, this.now(), view.items);
+  })}
+  __init17() {this.item = (boardId, itemId) => this.guard(this.id(), boardId, "item", async () => {
+    _chunkRBOER6EWcjs.identity.call(void 0, itemId);
+    const state = await this.readState(boardId), item = state.board.items.find((i) => i.id === itemId);
+    if (item) return { item: structuredClone(item), task: _chunkAOHQCX7Kcjs.projectKanbanTask.call(void 0, item, state.workflow, this.now(), [...state.board.items, ..._nullishCoalesce(state.archiveIndex, () => ( []))]) };
+    _chunkRBOER6EWcjs.requireValue.call(void 0, _optionalChain([state, 'access', _69 => _69.archiveIndex, 'optionalAccess', _70 => _70.some, 'call', _71 => _71((i) => i.id === itemId)]), "ITEM_NOT_FOUND");
+    const record = await this.options.store.archived(boardId, itemId);
+    _chunkRBOER6EWcjs.requireValue.call(void 0, record, "REVISION_CONFLICT");
+    return { item: structuredClone(record.item), task: _chunkAOHQCX7Kcjs.projectKanbanTask.call(void 0, record.item, state.workflow, this.now(), state.archiveIndex), archive: { archivedAt: record.archivedAt, reason: record.reason } };
+  })}
+  __init18() {this.related = (sessionId) => this.guard(this.id(), void 0, "related", async () => {
+    _chunkRBOER6EWcjs.identity.call(void 0, sessionId);
+    const result = [];
+    for (const board of await this.list()) {
+      const state = await this.readState(board.id);
+      if (_chunkEYTVC2H5cjs.related.call(void 0, board).includes(sessionId) || _optionalChain([state, 'access', _72 => _72.records, 'optionalAccess', _73 => _73.some, 'call', _74 => _74((record) => record.sources.some((source) => source.sessionId === sessionId))]) || _optionalChain([state, 'access', _75 => _75.archiveIndex, 'optionalAccess', _76 => _76.some, 'call', _77 => _77((i) => i.sessionIds.includes(sessionId))])) result.push(board);
+    }
+    return result;
+  })}
+  __init19() {this.scan = () => this.guard(this.id(), void 0, "scan", async () => {
+    const errors = [];
+    for (const id of await this.options.store.ids()) {
+      try {
+        const board = (await this.readState(id)).board;
+        if (board.deletedAt !== void 0) {
+          await this.publishNotifications(id, this.id());
+          continue;
+        }
+        await this.execute(board.id, { operationId: this.id(), expectedRevision: board.revision, command: { type: "scan" } });
+      } catch (error) {
+        if (!(error instanceof _chunkRSH6QSECcjs.KanbanError) || !["REVISION_CONFLICT", "FORBIDDEN"].includes(error.code)) errors.push(error);
+      }
+    }
+    if (errors.length) throw new AggregateError(errors, "KANBAN_SCAN_FAILED");
+  })}
+  async verifyRelease(board, command) {
+    if (command.type !== "release-item") return;
+    const item = board.items.find((i) => i.id === command.itemId);
+    _chunkRBOER6EWcjs.requireValue.call(void 0, _optionalChain([item, 'optionalAccess', _78 => _78.owner]) && item.owner.token === command.token, "OWNER_MISMATCH");
+    const own = _chunkRBOER6EWcjs.sameOwner.call(void 0, item.owner, this.actor), actor = _chunkRBOER6EWcjs.principal.call(void 0, this.actor);
+    const coordinator = _optionalChain([board, 'access', _79 => _79.members, 'optionalAccess', _80 => _80.some, 'call', _81 => _81((m) => _chunkRBOER6EWcjs.principalKey.call(void 0, m) === _chunkRBOER6EWcjs.principalKey.call(void 0, actor) && _optionalChain([m, 'access', _82 => _82.roles, 'optionalAccess', _83 => _83.includes, 'call', _84 => _84("coordinator")]))]);
+    _chunkRBOER6EWcjs.requireValue.call(void 0, own || coordinator, "OWNER_MISMATCH");
+    if (!(own && actor.kind === "human")) _chunkRBOER6EWcjs.requireValue.call(void 0, await _optionalChain([this, 'access', _85 => _85.options, 'access', _86 => _86.verifyRelease, 'optionalCall', _87 => _87({ actor: this.actor, board: structuredClone(board), item: structuredClone(item) })]), "EXECUTION_NOT_SETTLED");
+  }
+  async publishNotifications(boardId, operationId) {
+    if (!this.options.onCommitted) return;
+    const started = this.now();
+    try {
+      await this.options.onCommitted(boardId, this, this.now());
+      this.log(operationId, boardId, "notify", started, "success");
+    } catch (error) {
+      this.log(operationId, boardId, "notify", started, "failure", safeCode(error, "NOTIFICATION_PROJECTION_FAILED"));
+    }
+  }
+  async readView(boardId) {
+    _chunkRBOER6EWcjs.identity.call(void 0, boardId);
+    if (!this.options.store.view) return _chunkEYTVC2H5cjs.viewFromState.call(void 0, await this.readState(boardId));
+    const view = await this.options.store.view(boardId);
+    _chunkRBOER6EWcjs.requireValue.call(void 0, view, "BOARD_NOT_FOUND");
+    await this.authorize(view.state.board, "read");
+    return view;
+  }
+  async readState(boardId) {
+    _chunkRBOER6EWcjs.identity.call(void 0, boardId);
+    const state = await this.options.store.read(boardId);
+    _chunkRBOER6EWcjs.requireValue.call(void 0, state, "BOARD_NOT_FOUND");
+    await this.authorize(state.board, "read");
+    return state;
+  }
+  authorize(board, action, command) {
+    return this.options.authorize({ actor: structuredClone(this.actor), board: structuredClone(board), action, command: structuredClone(command) });
+  }
+  async guard(operationId, boardId, stage, run) {
+    const start = this.now();
+    if (this.stopping) {
+      this.log(operationId, boardId, stage, start, "failure", "SERVICE_STOPPING");
+      throw new (0, _chunkRSH6QSECcjs.KanbanError)("SERVICE_STOPPING");
+    }
+    const operation = Promise.resolve().then(run);
+    this.pending.add(operation);
+    try {
+      const result = await operation;
+      this.log(operationId, boardId, stage, start, "success");
+      return result;
+    } catch (error) {
+      this.log(operationId, boardId, stage, start, "failure", safeCode(error, "PORT_FAILURE"));
+      throw error;
+    } finally {
+      this.pending.delete(operation);
+    }
+  }
+  log(operationId, boardId, stage, start, result, code) {
+    try {
+      this.options.log({ operationId, boardId, stage, result, code, durationMs: this.now() - start });
+    } catch (e2) {
+    }
+  }
+}, _class);
+function safeCode(error, fallback) {
+  const code = _optionalChain([error, 'optionalAccess', _88 => _88.code]);
+  return typeof code === "string" && /^[A-Z][A-Z0-9_]{0,79}$/.test(code) ? code : fallback;
+}
+
+
+
+exports.createKanbanModule = createKanbanModule;
+//# sourceMappingURL=chunk-DINLR6E6.cjs.map

package/dist/chunk-DINLR6E6.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/li/share/prj/x1/libraries/kanban/dist/chunk-DINLR6E6.cjs","../src/references.ts","../src/suggestions.ts","../src/queries.ts","../src/module.ts"],"names":["item","record"],"mappings":"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","file":"/home/li/share/prj/x1/libraries/kanban/dist/chunk-DINLR6E6.cjs","sourcesContent":[null,"import {kanbanReference, type KanbanReferenceTarget} from './contracts';\nimport type {KanbanReadView, KanbanStore} from './ports';\nimport {requireValue} from './rules';\n\nexport async function resolveReference(reference: string, store: KanbanStore, read: (id: string) => Promise<KanbanReadView>): Promise<KanbanReferenceTarget> {\n    requireValue(typeof reference === 'string' && reference.length <= 100, 'INVALID_REFERENCE');\n    const match = /^KB-([1-9]\\d*)(?:#([1-9]\\d*)|\\/(L|D)-([1-9]\\d*))?$/i.exec(reference.trim());\n    requireValue(match && [match[1], match[2], match[4]].every(value => value === undefined || Number.isSafeInteger(Number(value))), 'INVALID_REFERENCE');\n    const id = await store.boardId?.(Number(match[1])); requireValue(id, 'REFERENCE_NOT_FOUND');\n    const view = await read(id), board = view.state.board;\n    requireValue(board.number === Number(match[1]), 'INVALID_NUMBERING');\n    const target: KanbanReferenceTarget = {boardId: id, scope: board.scope, reference: kanbanReference(board)};\n    if (match[2]) {\n        const item = [...view.items, ...(view.state.archiveIndex ?? [])].find(item => item.number === Number(match[2]));\n        requireValue(item, 'REFERENCE_NOT_FOUND'); target.itemId = item.id; target.reference = kanbanReference(board, item);\n    } else if (match[3]) {\n        const record = view.records.find(record => record.kind === (match[3].toUpperCase() === 'L' ? 'log' : 'decision') && record.number === Number(match[4]));\n        requireValue(record, 'REFERENCE_NOT_FOUND'); target.recordId = record.id; target.reference = kanbanReference(board, record);\n    }\n    return target;\n}\n","import {kanbanReference} from './contracts';\nimport type {KanbanSuggestion, KanbanSuggestionPage, KanbanSuggestionQuery} from './contracts';\nimport type {KanbanState} from './ports';\nimport {recordSummary} from './project-records';\nimport {catalog, terminal} from './planning';\nimport {workType} from './configuration';\nimport {identity, requireValue} from './rules';\n\nexport function validateSuggestionQuery(query: KanbanSuggestionQuery): number {\n    requireValue(query && ['item', 'parent', 'dependency', 'area', 'milestone', 'decision', 'session'].includes(query.kind), 'INVALID_SUGGESTION_KIND');\n    requireValue(query.search === undefined || typeof query.search === 'string' && query.search.length <= 256, 'INVALID_FILTER');\n    const limit = query.limit ?? 20; requireValue(Number.isSafeInteger(limit) && limit > 0 && limit <= 50, 'INVALID_LIMIT');\n    if (query.excludeItemId !== undefined) identity(query.excludeItemId);\n    if (query.excludeIds !== undefined) {requireValue(Array.isArray(query.excludeIds) && query.excludeIds.length <= 100, 'INVALID_FILTER'); query.excludeIds.forEach(identity);}\n    if (query.childKind !== undefined) identity(query.childKind);\n    return limit;\n}\nexport function suggestionPage(revision: number, rows: KanbanSuggestion[], query: KanbanSuggestionQuery): KanbanSuggestionPage {\n    const limit = validateSuggestionQuery(query), search = query.search?.trim().toLocaleLowerCase() ?? '';\n    const matched = rows.filter(row => !query.excludeIds?.includes(row.id)).filter(row => `${row.id} ${row.label} ${row.detail ?? ''}`.toLocaleLowerCase().includes(search))\n        .sort((a, b) => score(a.label, search) - score(b.label, search) || a.label.localeCompare(b.label) || a.id.localeCompare(b.id));\n    return {revision, items: matched.slice(0, limit).map(row => ({id: row.id, label: row.label.slice(0, 256), ...(row.detail ? {detail: row.detail.slice(0, 512)} : {}), ...(row.status ? {status: row.status} : {}), ...(row.archived !== undefined ? {archived: row.archived} : {})})), hasMore: matched.length > limit};\n}\nconst score = (label: string, query: string) => label.toLocaleLowerCase() === query ? 0 : label.toLocaleLowerCase().startsWith(query) ? 1 : 2;\nexport function suggestFromState(state: KanbanState, query: KanbanSuggestionQuery, items = catalog(state), records = (state.records ?? []).map(recordSummary)): KanbanSuggestionPage {\n    validateSuggestionQuery(query);\n    if (query.kind === 'area' || query.kind === 'milestone') {\n        const names = [...new Set(items.map(item => item.planning[query.kind as 'area' | 'milestone']).filter((name): name is string => !!name))];\n        return suggestionPage(state.board.revision, names.map(name => ({id: name, label: name})), query);\n    }\n    if (query.kind === 'decision') return suggestionPage(state.board.revision, records\n        .filter(record => record.kind === 'decision' && record.status === 'confirmed').map(record => ({id: record.id, label: record.title, detail: kanbanReference(state.board, record)})), query);\n    if (query.kind === 'session') {\n        const ids = new Set([...state.board.participants.map(p => p.sessionId), ...items.flatMap(item => item.sessionIds),\n            ...records.flatMap(record => record.sessionIds)]);\n        return suggestionPage(state.board.revision, [...ids].map(id => ({id, label: id})), query);\n    }\n    const blocked = query.kind === 'dependency' && query.excludeItemId ? dependents(items, query.excludeItemId) : new Set<string>();\n    const rank = query.kind === 'parent' ? workType(state.board, query.childKind ?? state.board.defaultWorkType ?? 'task').rank : undefined;\n    const rows = items.filter(item => item.id !== query.excludeItemId && !blocked.has(item.id)\n        && (query.kind !== 'dependency' || item.status !== 'cancelled')\n        && (rank === undefined || item.archivedAt === undefined && !terminal(item) && workType(state.board, item.planning.kind).rank < rank))\n        .map(item => ({id: item.id, label: item.title, status: item.status, archived: item.archivedAt !== undefined,\n            detail: [kanbanReference(state.board, item), item.planning.area, item.planning.milestone].filter(Boolean).join(' · ')}));\n    return suggestionPage(state.board.revision, rows, query);\n}\nfunction dependents(items: import('./contracts').KanbanItemSummary[], id: string): Set<string> {\n    const reverse = new Map<string, string[]>();\n    for (const item of items) for (const dependency of item.planning.dependencies) reverse.set(dependency, [...(reverse.get(dependency) ?? []), item.id]);\n    const result = new Set([id]), pending = [id];\n    while (pending.length) for (const next of reverse.get(pending.pop()!) ?? []) if (!result.has(next)) {result.add(next); pending.push(next);}\n    return result;\n}\n","import {projectKanbanTask} from './contracts/task-projection';\nimport {kanbanReference} from './contracts';\nimport type {KanbanItemPage, KanbanItemQuery, KanbanItemSummary, KanbanOverview} from './contracts';\nimport type {KanbanState} from './ports';\nimport {requireValue} from './rules';\nimport {executable} from './configuration';\nimport {catalog, limits, summary, terminal} from './planning';\n\nexport function queryItems(state: KanbanState, query: KanbanItemQuery = {}, all = catalog(state), now = Date.now()): KanbanItemPage {\n    const {cursor, limit = 50, ...filters} = query;\n    requireValue(Number.isSafeInteger(limit) && limit >= 1 && limit <= 200, 'INVALID_PAGE_SIZE');\n    requireValue(['ready', 'backlog', 'in-progress', 'review', 'closed', 'proposed', 'archive', 'all'].includes(query.view ?? 'ready'), 'INVALID_VIEW');\n    for (const field of ['area', 'milestone', 'parentId', 'kind', 'sessionId', 'search'] as const) if (filters[field] !== undefined) requireValue(typeof filters[field] === 'string' && filters[field]!.length <= 256, 'INVALID_FILTER');\n    if (filters.reference) requireValue(typeof filters.reference.system === 'string' && typeof filters.reference.id === 'string' && filters.reference.system.length <= 256 && filters.reference.id.length <= 256, 'INVALID_REFERENCE_FILTER');\n    const fingerprint = JSON.stringify(Object.fromEntries(Object.entries({...filters, view: filters.view ?? 'ready'}).sort(([a], [b]) => a.localeCompare(b)))), revision = state.board.revision;\n    all = all.map(item => ({...item, task: projectKanbanTask(item, state.workflow, now, all)}));\n    const matches = all.filter(item => matchesQuery(item, filters, state.board)).sort(filters.view === 'archive'\n        ? (a, b) => (b.archivedAt ?? 0) - (a.archivedAt ?? 0) || a.id.localeCompare(b.id) : order);\n    let start = 0;\n    if (cursor) {\n        requireValue(typeof cursor === 'string' && cursor.length <= 4000, 'INVALID_CURSOR');\n        let decoded: {revision: number; after: string; filter: string};\n        try {decoded = JSON.parse(cursor);} catch {requireValue(false, 'INVALID_CURSOR');}\n        requireValue(decoded && decoded.filter === fingerprint, 'CURSOR_SCOPE_MISMATCH');\n        requireValue(decoded.revision === revision, 'CURSOR_STALE');\n        start = matches.findIndex(i => i.id === decoded.after) + 1; requireValue(start > 0, 'INVALID_CURSOR');\n    }\n    const progress = progressByParent(state, all);\n    const items = matches.slice(start, start + limit).map(item => ({...item, ...(progress.has(item.id) ? {progress: progress.get(item.id)} : {})}));\n    return {revision, total: matches.length, items, ...(start + items.length < matches.length ? {\n        nextCursor: JSON.stringify({revision, after: items.at(-1)!.id, filter: fingerprint}),\n    } : {})};\n}\nfunction order(a: KanbanItemSummary, b: KanbanItemSummary): number {\n    return a.planning.priority - b.planning.priority || a.createdAt - b.createdAt || a.id.localeCompare(b.id);\n}\nfunction matchesQuery(item: KanbanItemSummary, query: Omit<KanbanItemQuery, 'cursor' | 'limit'>, board: KanbanState['board']): boolean {\n    if (item.deletedAt !== undefined && !query.includeDeleted) return false;\n    if (query.phase && item.task?.phase !== query.phase) return false;\n    if (!matchesView(item, query.view ?? 'ready')) return false;\n    for (const field of ['area', 'milestone', 'parentId', 'kind'] as const) if (query[field] !== undefined && item.planning[field] !== query[field]) return false;\n    if (query.reference && !item.externalRefs?.some(r => r.system === query.reference!.system && r.id === query.reference!.id)) return false;\n    if (query.sessionId && !item.sessionIds.includes(query.sessionId)) return false;\n    if (query.search && !`${kanbanReference(board, item)} ${item.id} ${item.title} ${item.planning.area ?? ''}`.toLowerCase().includes(query.search.toLowerCase())) return false;\n    return true;\n}\nfunction matchesView(item: KanbanItemSummary, view: KanbanItemQuery['view']): boolean {\n    if (view === 'archive') return item.archivedAt !== undefined;\n    if (view === 'all') return true;\n    if (item.archivedAt !== undefined) return false;\n    if (view === 'in-progress') return item.status === 'claimed' || item.status === 'review';\n    if (view === 'closed') return terminal(item);\n    return item.status === ({ready: 'open', backlog: 'backlog', review: 'review', proposed: 'proposed'} as Record<string, string>)[view!];\n}\nexport function overview(state: KanbanState, now: number, items = state.board.items.map(summary)): KanbanOverview {\n    items = items.filter(item => item.deletedAt === undefined);\n    const count = (status: string) => items.filter(i => i.status === status).length;\n    const age = state.board.policy.backlogReviewMs;\n    return {revision: state.board.revision, visible: items.length, active: items.filter(i => !terminal(i)).length, archived: state.archiveIndex?.length ?? 0, ready: count('open'),\n        inProgress: count('claimed') + count('review'), backlog: count('backlog'), proposed: count('proposed'),\n        closed: count('completed') + count('cancelled'), dueForReview: age ? items.filter(i => i.status === 'backlog' && now - i.updatedAt >= age).length : 0,\n        limits: limits(state)};\n}\n\nfunction progressByParent(state: KanbanState, all: KanbanItemSummary[]): Map<string, NonNullable<KanbanItemSummary['progress']>> {\n    const byId = new Map(all.map(i => [i.id, i]));\n    const result = new Map<string, NonNullable<KanbanItemSummary['progress']>>();\n    for (const item of all.filter(i => executable(state.board, i))) {\n        let parent = item.planning.parentId; const seen = new Set<string>();\n        while (parent && !seen.has(parent)) {\n            seen.add(parent); const progress = result.get(parent) ?? {total: 0, completed: 0, cancelled: 0, inProgress: 0};\n            progress.total++; if (item.status === 'completed') progress.completed++; if (item.status === 'cancelled') progress.cancelled++;\n            if (item.status === 'claimed' || item.status === 'review') progress.inProgress++;\n            result.set(parent, progress); parent = byId.get(parent)?.planning.parentId;\n        }\n    }\n    return result;\n}\n","import {boardControlPhase} from './contracts/board-control';\nimport {projectKanbanTask} from './contracts/task-projection';\nimport {resolveReference} from './references';\nimport {suggestFromState, suggestionPage, validateSuggestionQuery} from './suggestions';\nimport {queryRecords} from './project-records';\nimport { randomUUID } from './utils';\nimport type { KanbanBoard, KanbanRequest, KanbanService, KanbanItemQuery, KanbanBoardInput } from './contracts';\nimport { KanbanError, type KanbanModuleOptions, type KanbanState } from './ports';\nimport { identity, requireValue } from './rules';\nimport {createBoardState} from './board';\nimport {normalizeActor, principal, principalKey, sameOwner} from './identity';\nimport {queryItems, overview} from './queries';\nimport {viewFromState} from './storage-codec';\nimport { reduce, related } from './reducer';\n\n/** Optional host-owned service; no timer or model calls are started implicitly. */\nexport function createKanbanModule(options: KanbanModuleOptions): KanbanModuleHandle { return new KanbanModule(options); }\nexport interface KanbanModuleHandle extends KanbanService {quiesce(): Promise<void>; dispose(): Promise<void>}\nclass KanbanModule implements KanbanService {\n    private stopping = false;\n    private readonly pending = new Set<Promise<unknown>>();\n    async quiesce(): Promise<void> {this.stopping = true; await Promise.allSettled([...this.pending]);}\n    async dispose(): Promise<void> {await this.quiesce();}\n    private readonly now;\n    private readonly id;\n    private readonly actor;\n    constructor(private readonly options: KanbanModuleOptions) {\n        this.now = options.now ?? Date.now; this.id = options.id ?? randomUUID;\n        this.actor = normalizeActor(options.actor);\n    }\n    workflow = (boardId: string) => this.guard(this.id(), boardId, 'workflow', async () => structuredClone((await this.readView(boardId)).state.workflow ?? {plans:{},dispatches:{},ready:[],completedPlans:[]}));\n    resolve = (reference: string) => this.guard(this.id(), undefined, 'resolve', () => resolveReference(reference, this.options.store, id => this.readView(id)));\n    suggest = (boardId: string, query: import('./contracts').KanbanSuggestionQuery) => this.guard(this.id(), boardId, 'suggest', async () => {\n        const snapshot = structuredClone(query), limit = validateSuggestionQuery(snapshot), view = await this.readView(boardId), state = view.state;\n        const suggestions = () => suggestFromState(state, snapshot, [...view.items, ...(state.archiveIndex ?? [])], view.records);\n        if (!this.options.suggestions) return suggestions();\n        const rows = await this.options.suggestions(structuredClone(state.board), snapshot.kind, snapshot.search?.trim() ?? '', limit + 1);\n        if (rows === undefined) return suggestions();\n        const known = suggestions().items.filter(row => !rows.some(entry => entry.id === row.id));\n        return suggestionPage(state.board.revision, [...rows, ...known], snapshot);\n    });\n    records = (boardId: string, query?: import('./contracts').KanbanRecordQuery) => this.guard(this.id(), boardId, 'records', async () => {const view = await this.readView(boardId); return structuredClone(queryRecords(view.state, query, view.records));});\n    record = (boardId: string, recordId: string) => this.guard(this.id(), boardId, 'record', async () => {\n        identity(recordId); const record = (await this.readState(boardId)).records?.find(record => record.id === recordId);\n        requireValue(record, 'RECORD_NOT_FOUND'); return structuredClone(record);\n    });\n    currentPrincipal = async () => structuredClone(principal(this.actor));\n    create = (input: KanbanBoardInput): Promise<KanbanBoard> => {\n        const snapshot = structuredClone(input);\n        return this.guard(this.id(), snapshot.id, 'create', async () => {\n            const initial = createBoardState(snapshot, this.actor, this.now()), board = initial.board;\n            await this.authorize(board, 'create');\n            const state = await this.options.store.update(board.id, `create:${board.id}`, JSON.stringify({ snapshot, actor: this.actor }), previous => {\n                requireValue(!previous, 'BOARD_EXISTS'); return initial;\n            });\n            return structuredClone(state.board);\n        });\n    };\n    read = (boardId: string): Promise<KanbanBoard> => this.guard(this.id(), boardId, 'read',\n        async () => structuredClone((await this.readState(boardId)).board));\n    catalog = () => this.guard(this.id(), undefined, 'catalog', async () => {\n        const boards: import('./contracts').KanbanBoardSummary[] = [];\n        for (const id of await this.options.store.ids()) {\n            try {const view = await this.readView(id); if (view.state.board.deletedAt !== undefined) continue; boards.push({...view.state.board, executionPhase: boardControlPhase({...view.state.board, items: view.items}), items: view.items.filter(item => item.deletedAt === undefined).map(({id, title, number}) => ({id, title, ...(number === undefined ? {} : {number})}))});}\n            catch (error) {if (!(error instanceof KanbanError) || error.code !== 'FORBIDDEN') throw error;}\n        }\n        return structuredClone(boards);\n    });\n    list = (): Promise<KanbanBoard[]> => this.guard(this.id(), undefined, 'list', async () => {\n        const boards: KanbanBoard[] = [];\n        for (const boardId of await this.options.store.ids()) {\n            try { const board = (await this.readState(boardId)).board; if (board.deletedAt === undefined) boards.push(structuredClone(board)); }\n            catch (error) { if (!(error instanceof KanbanError) || error.code !== 'FORBIDDEN') throw error; }\n        }\n        return boards;\n    });\n    execute = (boardId: string, input: KanbanRequest): Promise<KanbanBoard> => this.guard(input.operationId, boardId, `execute:${input.command.type}`, async () => {\n        const request = structuredClone(input); identity(request.operationId);\n        const state = await this.readState(boardId);\n        await this.authorize(state.board, request.command.type, request.command);\n        requireValue(state.board.deletedAt === undefined, 'BOARD_DELETED');\n        if (request.command.type === 'delete-board') await this.options.verifyDeletion?.(structuredClone(state.board));\n        await this.options.verifyLifecycle?.(structuredClone(state.board), request.command);\n        await this.verifyRelease(state.board, request.command);\n        const verifyStage = request.command.type === 'observe-execution' && request.command.outcome === 'succeeded' ? 'observe'\n            : request.command.type === 'accept-execution' && request.command.accept ? 'accept' : undefined;\n        if (verifyStage && 'dispatchId' in request.command) {\n            const dispatch = state.workflow?.dispatches[request.command.dispatchId]; requireValue(dispatch, 'DISPATCH_NOT_FOUND');\n            const outputs = request.command.type === 'observe-execution' ? request.command.outputs : dispatch.outputs;\n            if (outputs?.length) requireValue(await this.options.verifyOutputs?.({stage: verifyStage, board: state.board, itemId: dispatch.itemId,\n                dispatchId: dispatch.id, outputs: structuredClone(outputs)}), 'OUTPUT_VERIFICATION_REQUIRED');\n        }\n        const restore = request.command.type === 'restore-item' ? await this.options.store.archived(boardId, request.command.itemId) : undefined;\n        const result = await this.options.store.update(boardId, request.operationId, JSON.stringify({ actor: this.actor, request }), current => {\n            requireValue(current && current.board.revision === state.board.revision, 'REVISION_CONFLICT');\n            requireValue(current.board.revision === request.expectedRevision, 'REVISION_CONFLICT');\n            if (restore) current.restore = restore;\n            return reduce(current, request.command, this.actor, request.operationId, this.now(), this.id());\n        });\n        await this.publishNotifications(boardId, request.operationId);\n        return structuredClone(result.board);\n    });\n    events = (boardId: string, after = 0, limit = 100) => this.guard(this.id(), boardId, 'events', async () => {\n        requireValue(Number.isSafeInteger(after) && after >= 0 && Number.isSafeInteger(limit) && limit > 0 && limit <= 500, 'INVALID_CURSOR');\n        const {state} = await this.readView(boardId);\n        return this.options.store.events(boardId, after, limit, state.sequence);\n    });\n    query = (boardId: string, query?: KanbanItemQuery) => this.guard(this.id(), boardId, 'query', async () => {const view = await this.readView(boardId); return structuredClone(queryItems(view.state, query, [...view.items, ...(view.state.archiveIndex ?? [])], this.now()));});\n    overview = (boardId: string) => this.guard(this.id(), boardId, 'overview', async () => {const view = await this.readView(boardId); return overview(view.state, this.now(), view.items);});\n    item = (boardId: string, itemId: string) => this.guard(this.id(), boardId, 'item', async () => {\n        identity(itemId); const state = await this.readState(boardId), item = state.board.items.find(i => i.id === itemId);\n        if (item) return {item: structuredClone(item),task:projectKanbanTask(item,state.workflow,this.now(),[...state.board.items,...state.archiveIndex??[]])};\n        requireValue(state.archiveIndex?.some(i => i.id === itemId), 'ITEM_NOT_FOUND');\n        const record = await this.options.store.archived(boardId, itemId); requireValue(record, 'REVISION_CONFLICT');\n        return {item: structuredClone(record.item), task:projectKanbanTask(record.item,state.workflow,this.now(),state.archiveIndex), archive: {archivedAt: record.archivedAt, reason: record.reason}};\n    });\n    related = (sessionId: string): Promise<KanbanBoard[]> => this.guard(this.id(), undefined, 'related', async () => {\n        identity(sessionId); const result: KanbanBoard[] = [];\n        for (const board of await this.list()) {\n            const state = await this.readState(board.id);\n            if (related(board).includes(sessionId) || state.records?.some(record => record.sources.some(source => source.sessionId === sessionId)) || state.archiveIndex?.some(i => i.sessionIds.includes(sessionId))) result.push(board);\n        }\n        return result;\n    });\n    scan = (): Promise<void> => this.guard(this.id(), undefined, 'scan', async () => {\n        const errors: unknown[] = [];\n        for (const id of await this.options.store.ids()) {\n            try {\n                const board = (await this.readState(id)).board;\n                if (board.deletedAt !== undefined) {await this.publishNotifications(id,this.id()); continue;}\n                await this.execute(board.id, { operationId: this.id(), expectedRevision: board.revision, command: { type: 'scan' } });\n            }\n            catch (error) {\n                if (!(error instanceof KanbanError) || !['REVISION_CONFLICT','FORBIDDEN'].includes(error.code)) errors.push(error);\n            }\n        }\n        if (errors.length) throw new AggregateError(errors, 'KANBAN_SCAN_FAILED');\n    });\n    private async verifyRelease(board: KanbanBoard, command: KanbanRequest['command']): Promise<void> {\n        if (command.type !== 'release-item') return;\n        const item = board.items.find(i => i.id === command.itemId); requireValue(item?.owner && item.owner.token === command.token, 'OWNER_MISMATCH');\n        const own = sameOwner(item.owner, this.actor), actor = principal(this.actor);\n        const coordinator = board.members?.some(m => principalKey(m) === principalKey(actor) && m.roles?.includes('coordinator'));\n        requireValue(own || coordinator, 'OWNER_MISMATCH');\n        if (!(own && actor.kind === 'human')) requireValue(await this.options.verifyRelease?.({actor: this.actor, board: structuredClone(board), item: structuredClone(item)}), 'EXECUTION_NOT_SETTLED');\n    }\n    private async publishNotifications(boardId: string, operationId: string): Promise<void> {\n        if (!this.options.onCommitted) return;\n        const started = this.now();\n        try {await this.options.onCommitted(boardId, this, this.now()); this.log(operationId, boardId, 'notify', started, 'success');}\n        catch (error) {this.log(operationId, boardId, 'notify', started, 'failure', safeCode(error, 'NOTIFICATION_PROJECTION_FAILED'));}\n    }\n    private async readView(boardId: string) {\n        identity(boardId);\n        if (!this.options.store.view) return viewFromState(await this.readState(boardId));\n        const view = await this.options.store.view(boardId); requireValue(view, 'BOARD_NOT_FOUND');\n        await this.authorize(view.state.board, 'read'); return view;\n    }\n    private async readState(boardId: string): Promise<KanbanState> {\n        identity(boardId); const state = await this.options.store.read(boardId); requireValue(state, 'BOARD_NOT_FOUND');\n        await this.authorize(state.board, 'read'); return state;\n    }\n    private authorize(board: KanbanBoard, action: Parameters<KanbanModuleOptions['authorize']>[0]['action'], command?: KanbanRequest['command']) {\n        return this.options.authorize({ actor: structuredClone(this.actor), board: structuredClone(board), action, command: structuredClone(command) });\n    }\n    private async guard<T>(operationId: string, boardId: string | undefined, stage: string, run: () => Promise<T>): Promise<T> {\n        const start = this.now();\n        if (this.stopping) {this.log(operationId,boardId,stage,start,'failure','SERVICE_STOPPING'); throw new KanbanError('SERVICE_STOPPING');}\n        const operation = Promise.resolve().then(run); this.pending.add(operation);\n        try { const result = await operation; this.log(operationId, boardId, stage, start, 'success'); return result; }\n        catch (error) {\n            this.log(operationId, boardId, stage, start, 'failure', safeCode(error, 'PORT_FAILURE')); throw error;\n        } finally {this.pending.delete(operation);}\n    }\n    private log(operationId: string, boardId: string | undefined, stage: string, start: number, result: 'success' | 'failure', code?: string): void {\n        try { this.options.log({ operationId, boardId, stage, result, code, durationMs: this.now() - start }); }\n        catch { /* Diagnostics cannot undo a commit. */ }\n    }\n}\n\nfunction safeCode(error: unknown, fallback: string): string {\n    const code = (error as {code?: unknown})?.code;\n    return typeof code === 'string' && /^[A-Z][A-Z0-9_]{0,79}$/.test(code) ? code : fallback;\n}\n"]}