@nestos/kanban 0.0.0-stage → 0.5.2

package/dist/discovery.js

@@ -0,0 +1,377 @@
+import {
+  discoveryState,
+  identity,
+  positive,
+  requireValue,
+  text
+} from "./chunk-3LEIHB7Y.js";
+import "./chunk-X4UHZX6F.js";
+import {
+  KanbanError,
+  KanbanScanNotStartedError,
+  randomUUID
+} from "./chunk-M35X5PHO.js";
+import "./chunk-3JYLJPE5.js";
+
+// src/scan-context.ts
+function scanContext(board, state, sessions, options, runId) {
+  requireValue(state.board.revision === board.revision, "SCAN_BOARD_CHANGED");
+  const archived = state.archiveIndex ?? [];
+  const input = {
+    runId,
+    executorId: options.executor.identity,
+    board: { ...board, items: [] },
+    sessions,
+    connection: structuredClone(options.policy.connection),
+    projectContext: { totalRecords: state.records?.filter((record) => record.status === "confirmed").length ?? 0, omittedRecords: state.records?.filter((record) => record.status === "confirmed").length ?? 0, excludedRecords: state.records?.filter((record) => record.status !== "confirmed").length ?? 0, records: [] },
+    context: {
+      totalItems: board.items.length,
+      omittedItems: board.items.length,
+      archivedTotal: archived.length,
+      archivedItems: []
+    }
+  };
+  const bytes = () => new TextEncoder().encode(JSON.stringify(input)).length;
+  requireValue(bytes() <= options.policy.maxInputBytes, "SCAN_INPUT_LIMIT");
+  const sessionIds = new Set(sessions.map((s) => s.session.id));
+  addRecords(input, state, sessionIds, bytes, options.policy.maxInputBytes);
+  const content = sessions.flatMap((s) => s.messages.map((m) => m.text.toLowerCase())).join("\n");
+  const ordered = [...board.items].sort((a, b) => score(a, sessionIds, content) - score(b, sessionIds, content) || (a.planning?.priority ?? 2) - (b.planning?.priority ?? 2) || a.id.localeCompare(b.id));
+  for (const item of ordered) {
+    if (input.board.items.length >= 50) break;
+    input.board.items.push(item);
+    input.context.omittedItems--;
+    if (bytes() > options.policy.maxInputBytes) {
+      input.board.items.pop();
+      input.context.omittedItems++;
+    }
+  }
+  const history = [...archived].sort((a, b) => Number(b.sessionIds.some((id) => sessionIds.has(id))) - Number(a.sessionIds.some((id) => sessionIds.has(id))) || (b.closedAt ?? b.updatedAt) - (a.closedAt ?? a.updatedAt));
+  for (const item of history.slice(0, 20)) {
+    input.context.archivedItems.push(item);
+    if (bytes() > options.policy.maxInputBytes) input.context.archivedItems.pop();
+  }
+  return structuredClone(input);
+}
+function addRecords(input, state, sessionIds, bytes, maxBytes) {
+  const records = (state.records ?? []).filter((record) => record.status === "confirmed").sort((a, b) => Number(b.kind === "decision") - Number(a.kind === "decision") || Number(b.sources.some((source) => sessionIds.has(source.sessionId))) - Number(a.sources.some((source) => sessionIds.has(source.sessionId))) || b.createdAt - a.createdAt);
+  for (const record of records.slice(0, 10)) {
+    input.projectContext.records.push(record);
+    input.projectContext.omittedRecords--;
+    if (bytes() > maxBytes) {
+      input.projectContext.records.pop();
+      input.projectContext.omittedRecords++;
+    }
+  }
+}
+function score(item, sessions, content) {
+  if (item.sources?.some((source) => sessions.has(source.sessionId)) || content.includes(item.title.toLowerCase())) return 0;
+  if (item.status === "claimed" || item.status === "review") return 1;
+  if (item.status === "open") return 2;
+  return item.status === "completed" || item.status === "cancelled" ? 4 : 3;
+}
+
+// src/discovery.ts
+function createKanbanDiscovery(options) {
+  return new Discovery(options);
+}
+var Discovery = class {
+  constructor(options) {
+    this.options = options;
+    this.now = options.now ?? Date.now;
+    this.id = options.id ?? randomUUID;
+    this.token = this.id();
+    for (const value of [options.policy.idleMs, options.policy.maxSessions, options.policy.maxInputBytes, options.policy.leaseMs]) positive(value);
+    identity(options.policy.connection.connectionId);
+  }
+  now;
+  id;
+  token;
+  active;
+  stopping = false;
+  resets = /* @__PURE__ */ new Set();
+  stage = "prepare";
+  scan = () => {
+    if (this.stopping) return Promise.reject(new KanbanError("SERVICE_STOPPING"));
+    if (this.active) return this.active;
+    const operationId = this.id(), started = this.now();
+    this.active = this.run().catch(async (error) => {
+      if (error instanceof KanbanError && ["SOURCE_CHANGED", "SCAN_BOARD_CHANGED", "REVISION_CONFLICT"].includes(error.code)) {
+        await this.settleInvalidatedRun();
+        await this.update("invalidate", (state) => {
+          if (state.pending?.token === this.token) {
+            state.lastRun = { runId: state.pending.runId, outcome: "invalidated", at: this.now(), code: error.code };
+            delete state.pending;
+          }
+        });
+      }
+      throw error;
+    }).then(() => this.log(operationId, started, "success"), (error) => {
+      this.log(operationId, started, "failure", errorCode(error));
+      throw error;
+    }).finally(() => {
+      this.active = void 0;
+    });
+    return this.active;
+  };
+  tick = () => this.scan();
+  async quiesce() {
+    this.stopping = true;
+    await Promise.allSettled([this.active, ...this.resets]);
+  }
+  dispose = () => this.quiesce();
+  reset = (runId) => {
+    if (this.stopping) return Promise.reject(new KanbanError("SERVICE_STOPPING"));
+    const work = this.resetRun(runId).finally(() => {
+      this.resets.delete(work);
+    });
+    this.resets.add(work);
+    return work;
+  };
+  async resetRun(runId) {
+    const pending = discoveryState(await this.options.store.read(this.options.boardId))?.pending;
+    requireValue(pending?.runId === runId, "SCAN_CHANGED");
+    await this.options.authorize("commit", pending.input);
+    requireValue(pending.token === this.token || pending.leaseUntil <= this.now(), "SCAN_BUSY");
+    if (pending.executionStarted && !pending.executionSettled) requireValue(await this.options.executor.settled?.(pending.input), "SCAN_EXECUTION_UNSETTLED");
+    await this.update("reset", (state) => {
+      requireValue(state.pending?.runId === runId && state.pending.token === pending.token, "SCAN_CHANGED");
+      state.lastRun = { runId, outcome: "invalidated", at: this.now(), code: "SCAN_MANUAL_RESET" };
+      delete state.pending;
+    });
+  }
+  async run() {
+    await this.options.authorize("read");
+    const board = await this.options.service.read(this.options.boardId);
+    requireValue(matchesScope(board.scope, this.options.source), "SOURCE_PROJECT_MISMATCH");
+    requireValue(this.options.source.kind === this.options.policy.connection.kind || this.options.policy.connection.allowContentTransfer, "CONTENT_TRANSFER_NOT_ALLOWED");
+    const stored = await this.options.store.read(board.id);
+    let pending = discoveryState(stored)?.pending;
+    if (pending && pending.token !== this.token && pending.leaseUntil > this.now()) return;
+    if (!pending) {
+      const sessions = await this.collect();
+      if (!sessions.length) return;
+      const current = await this.options.store.read(board.id);
+      requireValue(current, "BOARD_NOT_FOUND");
+      const input = scanContext(board, current, sessions, this.options, this.id());
+      requireValue(new TextEncoder().encode(JSON.stringify(input)).length <= this.options.policy.maxInputBytes, "SCAN_INPUT_LIMIT");
+      pending = { runId: input.runId, autoCreate: this.options.policy.autoCreate && (input.projectContext?.omittedRecords ?? 0) === 0 && input.context.omittedItems === 0 && input.context.archivedItems.length === input.context.archivedTotal, token: this.token, leaseUntil: this.now() + this.options.policy.leaseMs, input };
+    }
+    const selected = pending;
+    await this.update("claim", (state) => {
+      requireValue(!state.pending || state.pending.token === this.token || state.pending.leaseUntil <= this.now(), "SCAN_BUSY");
+      if (state.pending) requireValue(state.pending.runId === selected.runId, "SCAN_CHANGED");
+      const restoring = selected.token !== this.token;
+      state.pending = { ...selected, ...restoring ? { request: void 0 } : {}, token: this.token, leaseUntil: this.now() + this.options.policy.leaseMs };
+    });
+    await this.process();
+  }
+  async collect() {
+    this.stage = "source.list";
+    const sessions = await this.options.source.list(this.options.policy.includeArchived);
+    for (const session of sessions) {
+      identity(session.id);
+      requireValue(typeof session.revision === "string" && session.revision.length > 0 && session.revision.length <= 16e3, "INVALID_SOURCE_REVISION");
+    }
+    requireValue(new Set(sessions.map((s) => s.id)).size === sessions.length, "DUPLICATE_SOURCE_SESSION");
+    await this.observe(sessions);
+    const state = discoveryState(await this.options.store.read(this.options.boardId));
+    const result = [];
+    let bytes = 0;
+    for (const session of sessions.sort((a, b) => (a.updatedAt ?? 0) - (b.updatedAt ?? 0) || a.id.localeCompare(b.id))) {
+      if (!this.eligible(session, state)) continue;
+      const current = await this.options.source.inspect(session.id);
+      if (!this.eligible(current, state) || current.revision !== session.revision) continue;
+      this.stage = "source.read";
+      const text2 = await this.readCandidate(current, Math.floor(this.options.policy.maxInputBytes * 0.7) - bytes);
+      if (!text2) continue;
+      requireValue(text2.session.id === current.id && text2.session.revision === current.revision, "SOURCE_CHANGED");
+      if (!text2.complete) continue;
+      const size = new TextEncoder().encode(JSON.stringify(text2)).length;
+      if (bytes + size > this.options.policy.maxInputBytes * 0.7) break;
+      bytes += size;
+      result.push(text2);
+      if (result.length >= this.options.policy.maxSessions) break;
+    }
+    return result;
+  }
+  async readCandidate(session, maxBytes) {
+    const started = this.now();
+    try {
+      const result = await this.options.source.read(session, maxBytes);
+      if (!result.complete) this.log(this.id(), started, "failure", "SOURCE_PROVENANCE_UNKNOWN", session.id);
+      return result;
+    } catch (error) {
+      const code = errorCode(error);
+      if (!["SCAN_INPUT_LIMIT", "SOURCE_CHANGED", "HARNESS_DIGEST_CHANGED"].includes(code)) throw error;
+      this.log(this.id(), started, "failure", code, session.id);
+      return null;
+    }
+  }
+  eligible(session, state) {
+    const quiet = state.observations?.[session.id];
+    return !session.scannerOwned && (this.options.policy.includeArchived || !session.archived) && session.activity === "idle" && session.updatedAt !== null && session.updatedAt <= this.now() && quiet?.revision === session.revision && this.now() - quiet.idleSince >= this.options.policy.idleMs && state.checkpoints[session.id] !== session.revision;
+  }
+  async observe(sessions) {
+    await this.update("observe", (state) => {
+      state.observations ??= {};
+      for (const session of sessions) {
+        if (session.activity !== "idle" || session.scannerOwned) {
+          delete state.observations[session.id];
+          continue;
+        }
+        const old = state.observations[session.id];
+        if (old?.revision !== session.revision) state.observations[session.id] = { revision: session.revision, idleSince: this.now() };
+      }
+    });
+  }
+  async process() {
+    let pending = discoveryState(await this.options.store.read(this.options.boardId)).pending;
+    requireValue(pending.input.executorId === this.options.executor.identity, "SCANNER_EXECUTOR_CHANGED");
+    await this.checkSources(pending.input);
+    if (!pending.changes) {
+      await this.options.authorize("execute", pending.input);
+      this.stage = "analyzer.execute";
+      await this.updateOwned("execute", (state) => {
+        state.pending.executionStarted = true;
+      });
+      const output = await this.execute(pending.input), result = Array.isArray(output) ? { changes: output } : output;
+      await this.updateOwned("settled", (state) => {
+        state.pending.executionSettled = true;
+      });
+      validateChanges(result.changes, pending.input);
+      validateRecords(result.records ?? [], pending.input, result.changes);
+      await this.updateOwned("result", (state) => {
+        state.pending.changes = result.changes;
+        state.pending.records = result.records;
+      });
+    }
+    pending = discoveryState(await this.options.store.read(this.options.boardId)).pending;
+    await this.options.authorize("commit", pending.input);
+    await this.checkSources(pending.input);
+    if (!pending.request) {
+      const board = await this.options.service.read(this.options.boardId);
+      requireValue(board.revision === pending.input.board.revision, "SCAN_BOARD_CHANGED");
+      const request = {
+        operationId: `discovery:${pending.runId}`,
+        expectedRevision: board.revision,
+        command: { type: "apply-discovery", batch: {
+          runId: pending.runId,
+          leaseToken: this.token,
+          changes: pending.changes,
+          ...pending.records ? { records: pending.records } : {},
+          autoCreate: pending.autoCreate,
+          checkpoints: pending.input.sessions.map((s) => ({ sessionId: s.session.id, revision: s.session.revision }))
+        } }
+      };
+      await this.updateOwned("prepare", (state) => {
+        state.pending.request = request;
+      });
+      pending.request = request;
+    }
+    this.stage = "board.commit";
+    await this.options.service.execute(this.options.boardId, pending.request);
+  }
+  async execute(input) {
+    try {
+      return await this.options.executor.run(structuredClone(input));
+    } catch (error) {
+      if (error instanceof KanbanScanNotStartedError) await this.updateOwned("not-started", (state) => {
+        state.pending.executionSettled = true;
+      });
+      throw error;
+    }
+  }
+  async settleInvalidatedRun() {
+    const pending = discoveryState(await this.options.store.read(this.options.boardId))?.pending;
+    if (!pending || pending.token !== this.token || !pending.executionStarted || pending.executionSettled) return;
+    requireValue(await this.options.executor.settled?.(pending.input), "SCAN_EXECUTION_UNSETTLED");
+  }
+  async checkSources(input) {
+    for (const source of input.sessions) {
+      const current = await this.options.source.inspect(source.session.id);
+      requireValue(current.revision === source.session.revision && current.activity === "idle" && !current.scannerOwned, "SOURCE_CHANGED");
+    }
+  }
+  async updateOwned(stage, mutate) {
+    await this.update(stage, (state) => {
+      requireValue(state.pending?.token === this.token && state.pending.leaseUntil > this.now(), "SCAN_LEASE_EXPIRED");
+      mutate(state);
+    });
+  }
+  async update(stage, mutate) {
+    const operation = this.id();
+    await this.options.store.update(this.options.boardId, operation, `discovery:${stage}:${operation}`, (state) => {
+      requireValue(state, "BOARD_NOT_FOUND");
+      state.discovery ??= { checkpoints: {} };
+      mutate(state.discovery);
+      return state;
+    });
+  }
+  log(operationId, started, result, code, sessionId) {
+    try {
+      this.options.log({ operationId, boardId: this.options.boardId, sessionId, stage: `discovery.${this.stage}`, result, code, durationMs: this.now() - started });
+    } catch {
+    }
+  }
+};
+function validateChanges(changes, input) {
+  requireValue(Array.isArray(changes) && changes.length <= 50, "SCAN_CHANGE_LIMIT");
+  const ids = /* @__PURE__ */ new Set();
+  for (const change of changes) {
+    requireValue(change && ["create", "update", "link"].includes(change.action) && !ids.has(change.itemId), "INVALID_CHANGE");
+    ids.add(change.itemId);
+    identity(change.itemId);
+    if (change.action !== "create") requireValue(input.board.items.some((i) => i.id === change.itemId), "UNKNOWN_CONTEXT_ITEM");
+    text(change.title);
+    text(change.responsibility);
+    text(change.acceptance);
+    requireValue(change.eligibleAgentIds === void 0 || Array.isArray(change.eligibleAgentIds), "INVALID_ELIGIBILITY");
+    change.eligibleAgentIds?.forEach(identity);
+    requireValue(change.eligiblePrincipals === void 0 || Array.isArray(change.eligiblePrincipals), "INVALID_ELIGIBILITY");
+    requireValue(Array.isArray(change.sources) && change.sources.length > 0 && change.sources.length <= 100 && change.sources.some((s) => s.role === "user"), "USER_EVIDENCE_REQUIRED");
+    for (const ref of change.sources) {
+      const source = input.sessions.find((s) => s.session.id === ref.sessionId && s.session.revision === ref.revision);
+      requireValue(source?.messages.some((m) => m.id === ref.messageId && m.role === ref.role), "INVALID_SOURCE_REFERENCE");
+    }
+  }
+}
+function validateRecords(records, input, changes) {
+  requireValue(Array.isArray(records) && records.length <= 20, "SCAN_RECORD_LIMIT");
+  const ids = /* @__PURE__ */ new Set();
+  for (const record of records) {
+    identity(record.id);
+    requireValue(!ids.has(record.id), "INVALID_RECORD_ID");
+    ids.add(record.id);
+    text(record.title);
+    text(record.content);
+    requireValue(["log", "decision"].includes(record.kind), "INVALID_RECORD_KIND");
+    if (record.kind === "decision") text(record.rationale ?? "");
+    requireValue(Array.isArray(record.itemIds) && record.itemIds.every((id) => input.board.items.some((item) => item.id === id) || changes.some((change) => change.action === "create" && change.itemId === id)), "UNKNOWN_CONTEXT_ITEM");
+    if (record.supersedes) requireValue(input.projectContext?.records.some((old) => old.id === record.supersedes && old.kind === "decision"), "UNKNOWN_CONTEXT_RECORD");
+    requireValue(Array.isArray(record.sources) && record.sources.length > 0 && record.sources.length <= 100 && record.sources.some((source) => source.role === "user"), "USER_EVIDENCE_REQUIRED");
+    for (const ref of record.sources) {
+      const source = input.sessions.find((s) => s.session.id === ref.sessionId && s.session.revision === ref.revision);
+      requireValue(source?.messages.some((message) => message.id === ref.messageId && message.role === ref.role), "INVALID_SOURCE_REFERENCE");
+    }
+  }
+}
+function errorCode(error) {
+  const value = error;
+  const code = value?.remoteCode ?? value?.code;
+  return typeof code === "string" && /^[A-Z][A-Z0-9_]{0,79}$/.test(code) ? code : "SCAN_PORT_FAILURE";
+}
+function matchesScope(scope, source) {
+  const expected = source.scope ?? (source.projectId ? { kind: "project", projectId: source.projectId } : void 0);
+  if (!expected || scope.kind !== expected.kind) return false;
+  if (scope.kind === "system") return true;
+  if (scope.kind === "project" && expected.kind === "project") return scope.projectId === expected.projectId;
+  return scope.kind === "collection" && expected.kind === "collection" && scope.namespace === expected.namespace && scope.id === expected.id;
+}
+export {
+  KanbanScanNotStartedError,
+  scanContext as buildDiscoveryContext,
+  createKanbanDiscovery,
+  discoveryState
+};
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scan-context.ts","../src/discovery.ts"],"sourcesContent":["import type {KanbanBoard, KanbanItem, KanbanScanInput, KanbanScanText} from './contracts';\nimport type {KanbanDiscoveryOptions} from './scan-ports';\nimport type {KanbanState} from './ports';\nimport {requireValue} from './rules';\n\n/** A bounded working set, with explicit omitted counts instead of pretending full coverage. */\nexport function scanContext(board: KanbanBoard, state: KanbanState, sessions: KanbanScanText[], options: KanbanDiscoveryOptions, runId: string): KanbanScanInput {\n    requireValue(state.board.revision === board.revision, 'SCAN_BOARD_CHANGED');\n    const archived = state.archiveIndex ?? [];\n    const input: KanbanScanInput = {runId, executorId: options.executor.identity, board: {...board, items: []}, sessions,\n        connection: structuredClone(options.policy.connection), projectContext: {totalRecords: state.records?.filter(record => record.status === 'confirmed').length ?? 0, omittedRecords: state.records?.filter(record => record.status === 'confirmed').length ?? 0, excludedRecords: state.records?.filter(record => record.status !== 'confirmed').length ?? 0, records: []}, context: {totalItems: board.items.length, omittedItems: board.items.length,\n            archivedTotal: archived.length, archivedItems: []}};\n    const bytes = () => new TextEncoder().encode(JSON.stringify(input)).length;\n    requireValue(bytes() <= options.policy.maxInputBytes, 'SCAN_INPUT_LIMIT');\n    const sessionIds = new Set(sessions.map(s => s.session.id));\n    addRecords(input, state, sessionIds, bytes, options.policy.maxInputBytes);\n    const content = sessions.flatMap(s => s.messages.map(m => m.text.toLowerCase())).join('\\n');\n    const ordered = [...board.items].sort((a, b) => score(a, sessionIds, content) - score(b, sessionIds, content)\n        || (a.planning?.priority ?? 2) - (b.planning?.priority ?? 2) || a.id.localeCompare(b.id));\n    for (const item of ordered) {\n        if (input.board.items.length >= 50) break;\n        input.board.items.push(item); input.context!.omittedItems--;\n        if (bytes() > options.policy.maxInputBytes) {input.board.items.pop(); input.context!.omittedItems++;}\n    }\n    const history = [...archived].sort((a, b) => Number(b.sessionIds.some(id => sessionIds.has(id))) - Number(a.sessionIds.some(id => sessionIds.has(id)))\n        || (b.closedAt ?? b.updatedAt) - (a.closedAt ?? a.updatedAt));\n    for (const item of history.slice(0, 20)) {\n        input.context!.archivedItems.push(item);\n        if (bytes() > options.policy.maxInputBytes) input.context!.archivedItems.pop();\n    }\n    return structuredClone(input);\n}\nfunction addRecords(input: KanbanScanInput, state: KanbanState, sessionIds: Set<string>, bytes: () => number, maxBytes: number): void {\n    const records = (state.records ?? []).filter(record => record.status === 'confirmed').sort((a, b) => Number(b.kind === 'decision') - Number(a.kind === 'decision')\n        || Number(b.sources.some(source => sessionIds.has(source.sessionId))) - Number(a.sources.some(source => sessionIds.has(source.sessionId))) || b.createdAt - a.createdAt);\n    for (const record of records.slice(0, 10)) {\n        input.projectContext!.records.push(record); input.projectContext!.omittedRecords--;\n        if (bytes() > maxBytes) {input.projectContext!.records.pop(); input.projectContext!.omittedRecords++;}\n    }\n}\n\nfunction score(item: KanbanItem, sessions: Set<string>, content: string): number {\n    if (item.sources?.some(source => sessions.has(source.sessionId)) || content.includes(item.title.toLowerCase())) return 0;\n    if (item.status === 'claimed' || item.status === 'review') return 1;\n    if (item.status === 'open') return 2;\n    return item.status === 'completed' || item.status === 'cancelled' ? 4 : 3;\n}\n","import {discoveryState} from './discovery-state';\nimport {randomUUID} from './utils';\nimport type {KanbanDiscoveryChange, KanbanRequest, KanbanScanInput, KanbanScanSession, KanbanScanText} from './contracts';\nimport {KanbanError, KanbanScanNotStartedError} from './ports';\nimport type {KanbanDiscoveryOptions, KanbanDiscoveryState} from './scan-ports';\nimport {scanContext} from './scan-context';\nimport {identity, positive, requireValue, text as validateText} from './rules';\n\nexport interface KanbanDiscoveryHandle {scan(): Promise<void>; tick(): Promise<void>; reset(runId: string): Promise<void>; quiesce(): Promise<void>; dispose(): Promise<void>}\nexport function createKanbanDiscovery(options: KanbanDiscoveryOptions): KanbanDiscoveryHandle {return new Discovery(options);}\nclass Discovery {\n    private readonly now;\n    private readonly id;\n    private readonly token;\n    private active?: Promise<void>;\n    private stopping = false;\n    private readonly resets = new Set<Promise<void>>();\n    private stage = 'prepare';\n    constructor(private readonly options: KanbanDiscoveryOptions) {\n        this.now = options.now ?? Date.now; this.id = options.id ?? randomUUID; this.token = this.id();\n        for (const value of [options.policy.idleMs, options.policy.maxSessions, options.policy.maxInputBytes, options.policy.leaseMs]) positive(value);\n        identity(options.policy.connection.connectionId);\n    }\n    scan = (): Promise<void> => {\n        if (this.stopping) return Promise.reject(new KanbanError('SERVICE_STOPPING'));\n        if (this.active) return this.active;\n        const operationId = this.id(), started = this.now();\n        this.active = this.run().catch(async error => {\n            if (error instanceof KanbanError && ['SOURCE_CHANGED', 'SCAN_BOARD_CHANGED', 'REVISION_CONFLICT'].includes(error.code)) {\n                await this.settleInvalidatedRun();\n                await this.update('invalidate', state => {if (state.pending?.token === this.token) {\n                    state.lastRun = {runId: state.pending.runId, outcome: 'invalidated', at: this.now(), code: error.code}; delete state.pending;\n                }});\n            }\n            throw error;\n        }).then(() => this.log(operationId, started, 'success'), error => {\n            this.log(operationId, started, 'failure', errorCode(error)); throw error;\n        }).finally(() => {this.active = undefined;});\n        return this.active;\n    };\n    tick = (): Promise<void> => this.scan();\n    async quiesce(): Promise<void> {\n        this.stopping = true;\n        await Promise.allSettled([this.active, ...this.resets]);\n    }\n    dispose = (): Promise<void> => this.quiesce();\n    reset = (runId: string): Promise<void> => {\n        if (this.stopping) return Promise.reject(new KanbanError('SERVICE_STOPPING'));\n        const work = this.resetRun(runId).finally(() => {this.resets.delete(work);});\n        this.resets.add(work); return work;\n    };\n    private async resetRun(runId: string): Promise<void> {\n        const pending = discoveryState(await this.options.store.read(this.options.boardId))?.pending;\n        requireValue(pending?.runId === runId, 'SCAN_CHANGED');\n        await this.options.authorize('commit', pending.input);\n        requireValue(pending.token === this.token || pending.leaseUntil <= this.now(), 'SCAN_BUSY');\n        if (pending.executionStarted && !pending.executionSettled) requireValue(await this.options.executor.settled?.(pending.input), 'SCAN_EXECUTION_UNSETTLED');\n        await this.update('reset', state => {\n            requireValue(state.pending?.runId === runId && state.pending.token === pending.token, 'SCAN_CHANGED');\n            state.lastRun = {runId, outcome: 'invalidated', at: this.now(), code: 'SCAN_MANUAL_RESET'}; delete state.pending;\n        });\n    }\n    private async run(): Promise<void> {\n        await this.options.authorize('read');\n        const board = await this.options.service.read(this.options.boardId);\n        requireValue(matchesScope(board.scope, this.options.source), 'SOURCE_PROJECT_MISMATCH');\n        requireValue(this.options.source.kind === this.options.policy.connection.kind || this.options.policy.connection.allowContentTransfer, 'CONTENT_TRANSFER_NOT_ALLOWED');\n        const stored = await this.options.store.read(board.id);\n        let pending = discoveryState(stored)?.pending;\n        if (pending && pending.token !== this.token && pending.leaseUntil > this.now()) return;\n        if (!pending) {\n            const sessions = await this.collect(); if (!sessions.length) return;\n            const current = await this.options.store.read(board.id); requireValue(current, 'BOARD_NOT_FOUND');\n            const input = scanContext(board, current, sessions, this.options, this.id());\n            requireValue(new TextEncoder().encode(JSON.stringify(input)).length <= this.options.policy.maxInputBytes, 'SCAN_INPUT_LIMIT');\n            pending = {runId: input.runId, autoCreate: this.options.policy.autoCreate && (input.projectContext?.omittedRecords ?? 0) === 0 && input.context!.omittedItems === 0 && input.context!.archivedItems.length === input.context!.archivedTotal, token: this.token, leaseUntil: this.now() + this.options.policy.leaseMs, input};\n        }\n        const selected = pending;\n        await this.update('claim', state => {\n            requireValue(!state.pending || state.pending.token === this.token || state.pending.leaseUntil <= this.now(), 'SCAN_BUSY');\n            if (state.pending) requireValue(state.pending.runId === selected.runId, 'SCAN_CHANGED');\n            const restoring = selected.token !== this.token;\n            state.pending = {...selected, ...(restoring ? {request: undefined} : {}), token: this.token, leaseUntil: this.now() + this.options.policy.leaseMs};\n        });\n        await this.process();\n    }\n    private async collect(): Promise<KanbanScanText[]> {\n        this.stage = 'source.list';\n        const sessions = await this.options.source.list(this.options.policy.includeArchived);\n        for (const session of sessions) {\n            identity(session.id); requireValue(typeof session.revision === 'string' && session.revision.length > 0 && session.revision.length <= 16000, 'INVALID_SOURCE_REVISION');\n        }\n        requireValue(new Set(sessions.map(s => s.id)).size === sessions.length, 'DUPLICATE_SOURCE_SESSION');\n        await this.observe(sessions);\n        const state = discoveryState(await this.options.store.read(this.options.boardId))!;\n        const result: KanbanScanText[] = []; let bytes = 0;\n        for (const session of sessions.sort((a, b) => (a.updatedAt ?? 0) - (b.updatedAt ?? 0) || a.id.localeCompare(b.id))) {\n            if (!this.eligible(session, state)) continue;\n            const current = await this.options.source.inspect(session.id);\n            if (!this.eligible(current, state) || current.revision !== session.revision) continue;\n            this.stage = 'source.read';\n            const text = await this.readCandidate(current, Math.floor(this.options.policy.maxInputBytes * 0.7) - bytes);\n            if (!text) continue;\n            requireValue(text.session.id === current.id && text.session.revision === current.revision, 'SOURCE_CHANGED');\n            if (!text.complete) continue;\n            const size = new TextEncoder().encode(JSON.stringify(text)).length;\n            if (bytes + size > this.options.policy.maxInputBytes * 0.7) break;\n            bytes += size; result.push(text); if (result.length >= this.options.policy.maxSessions) break;\n        }\n        return result;\n    }\n    private async readCandidate(session: KanbanScanSession, maxBytes: number): Promise<KanbanScanText | null> {\n        const started = this.now();\n        try {\n            const result = await this.options.source.read(session, maxBytes);\n            if (!result.complete) this.log(this.id(), started, 'failure', 'SOURCE_PROVENANCE_UNKNOWN', session.id);\n            return result;\n        } catch (error) {\n            const code = errorCode(error);\n            if (!['SCAN_INPUT_LIMIT', 'SOURCE_CHANGED', 'HARNESS_DIGEST_CHANGED'].includes(code)) throw error;\n            this.log(this.id(), started, 'failure', code, session.id); return null;\n        }\n    }\n    private eligible(session: KanbanScanSession, state: KanbanDiscoveryState): boolean {\n        const quiet = state.observations?.[session.id];\n        return !session.scannerOwned && (this.options.policy.includeArchived || !session.archived)\n            && session.activity === 'idle' && session.updatedAt !== null && session.updatedAt <= this.now()\n            && quiet?.revision === session.revision && this.now() - quiet.idleSince >= this.options.policy.idleMs\n            && state.checkpoints[session.id] !== session.revision;\n    }\n    private async observe(sessions: KanbanScanSession[]): Promise<void> {\n        await this.update('observe', state => {\n            state.observations ??= {};\n            for (const session of sessions) {\n                if (session.activity !== 'idle' || session.scannerOwned) {delete state.observations[session.id]; continue;}\n                const old = state.observations[session.id];\n                if (old?.revision !== session.revision) state.observations[session.id] = {revision: session.revision, idleSince: this.now()};\n            }\n        });\n    }\n    private async process(): Promise<void> {\n        let pending = discoveryState(await this.options.store.read(this.options.boardId))!.pending!;\n        requireValue(pending.input.executorId === this.options.executor.identity, 'SCANNER_EXECUTOR_CHANGED');\n        await this.checkSources(pending.input);\n        if (!pending.changes) {\n            await this.options.authorize('execute', pending.input);\n            this.stage = 'analyzer.execute';\n            await this.updateOwned('execute', state => {state.pending!.executionStarted = true;});\n            const output = await this.execute(pending.input), result = Array.isArray(output) ? {changes: output} : output;\n            await this.updateOwned('settled', state => {state.pending!.executionSettled = true;});\n            validateChanges(result.changes, pending.input); validateRecords(result.records ?? [], pending.input, result.changes);\n            await this.updateOwned('result', state => {state.pending!.changes = result.changes; state.pending!.records = result.records;});\n        }\n        pending = discoveryState(await this.options.store.read(this.options.boardId))!.pending!;\n        await this.options.authorize('commit', pending.input); await this.checkSources(pending.input);\n        if (!pending.request) {\n            const board = await this.options.service.read(this.options.boardId);\n            requireValue(board.revision === pending.input.board.revision, 'SCAN_BOARD_CHANGED');\n            const request: KanbanRequest = {operationId: `discovery:${pending.runId}`, expectedRevision: board.revision,\n                command: {type: 'apply-discovery', batch: {runId: pending.runId, leaseToken: this.token, changes: pending.changes!, ...(pending.records ? {records: pending.records} : {}), autoCreate: pending.autoCreate,\n                    checkpoints: pending.input.sessions.map(s => ({sessionId: s.session.id, revision: s.session.revision}))}}};\n            await this.updateOwned('prepare', state => {state.pending!.request = request;});\n            pending.request = request;\n        }\n        this.stage = 'board.commit';\n        await this.options.service.execute(this.options.boardId, pending.request);\n    }\n    private async execute(input: KanbanScanInput): Promise<KanbanDiscoveryChange[] | import('./contracts').KanbanDiscoveryResult> {\n        try {return await this.options.executor.run(structuredClone(input));}\n        catch (error) {\n            if (error instanceof KanbanScanNotStartedError) await this.updateOwned('not-started', state => {state.pending!.executionSettled = true;});\n            throw error;\n        }\n    }\n    private async settleInvalidatedRun(): Promise<void> {\n        const pending = discoveryState(await this.options.store.read(this.options.boardId))?.pending;\n        if (!pending || pending.token !== this.token || !pending.executionStarted || pending.executionSettled) return;\n        requireValue(await this.options.executor.settled?.(pending.input), 'SCAN_EXECUTION_UNSETTLED');\n    }\n    private async checkSources(input: KanbanScanInput): Promise<void> {\n        for (const source of input.sessions) {\n            const current = await this.options.source.inspect(source.session.id);\n            requireValue(current.revision === source.session.revision && current.activity === 'idle' && !current.scannerOwned, 'SOURCE_CHANGED');\n        }\n    }\n    private async updateOwned(stage: string, mutate: (state: KanbanDiscoveryState) => void): Promise<void> {\n        await this.update(stage, state => {\n            requireValue(state.pending?.token === this.token && state.pending.leaseUntil > this.now(), 'SCAN_LEASE_EXPIRED'); mutate(state);\n        });\n    }\n    private async update(stage: string, mutate: (state: KanbanDiscoveryState) => void): Promise<void> {\n        const operation = this.id();\n        await this.options.store.update(this.options.boardId, operation, `discovery:${stage}:${operation}`, state => {\n            requireValue(state, 'BOARD_NOT_FOUND'); state.discovery ??= {checkpoints: {}}; mutate(state.discovery as KanbanDiscoveryState); return state;\n        });\n    }\n    private log(operationId: string, started: number, result: 'success' | 'failure', code?: string, sessionId?: string): void {\n        try {this.options.log({operationId, boardId: this.options.boardId, sessionId, stage: `discovery.${this.stage}`, result, code, durationMs: this.now() - started});}\n        catch { /* Diagnostics cannot affect durable execution. */ }\n    }\n}\nfunction validateChanges(changes: KanbanDiscoveryChange[], input: KanbanScanInput): void {\n    requireValue(Array.isArray(changes) && changes.length <= 50, 'SCAN_CHANGE_LIMIT');\n    const ids = new Set<string>();\n    for (const change of changes) {\n        requireValue(change && ['create', 'update', 'link'].includes(change.action) && !ids.has(change.itemId), 'INVALID_CHANGE'); ids.add(change.itemId); identity(change.itemId);\n        if (change.action !== 'create') requireValue(input.board.items.some(i => i.id === change.itemId), 'UNKNOWN_CONTEXT_ITEM');\n        validateText(change.title); validateText(change.responsibility); validateText(change.acceptance);\n        requireValue(change.eligibleAgentIds === undefined || Array.isArray(change.eligibleAgentIds), 'INVALID_ELIGIBILITY');\n        change.eligibleAgentIds?.forEach(identity);\n        requireValue(change.eligiblePrincipals === undefined || Array.isArray(change.eligiblePrincipals), 'INVALID_ELIGIBILITY');\n        requireValue(Array.isArray(change.sources) && change.sources.length > 0 && change.sources.length <= 100 && change.sources.some(s => s.role === 'user'), 'USER_EVIDENCE_REQUIRED');\n        for (const ref of change.sources) {\n            const source = input.sessions.find(s => s.session.id === ref.sessionId && s.session.revision === ref.revision);\n            requireValue(source?.messages.some(m => m.id === ref.messageId && m.role === ref.role), 'INVALID_SOURCE_REFERENCE');\n        }\n    }\n}\n\nfunction validateRecords(records: import('./contracts').KanbanRecordInput[], input: KanbanScanInput, changes: KanbanDiscoveryChange[]): void {\n    requireValue(Array.isArray(records) && records.length <= 20, 'SCAN_RECORD_LIMIT');\n    const ids = new Set<string>();\n    for (const record of records) {\n        identity(record.id); requireValue(!ids.has(record.id), 'INVALID_RECORD_ID'); ids.add(record.id);\n        validateText(record.title); validateText(record.content);\n        requireValue(['log', 'decision'].includes(record.kind), 'INVALID_RECORD_KIND');\n        if (record.kind === 'decision') validateText(record.rationale ?? '');\n        requireValue(Array.isArray(record.itemIds) && record.itemIds.every(id => input.board.items.some(item => item.id === id) || changes.some(change => change.action === 'create' && change.itemId === id)), 'UNKNOWN_CONTEXT_ITEM');\n        if (record.supersedes) requireValue(input.projectContext?.records.some(old => old.id === record.supersedes && old.kind === 'decision'), 'UNKNOWN_CONTEXT_RECORD');\n        requireValue(Array.isArray(record.sources) && record.sources.length > 0 && record.sources.length <= 100\n            && record.sources.some(source => source.role === 'user'), 'USER_EVIDENCE_REQUIRED');\n        for (const ref of record.sources) {\n            const source = input.sessions.find(s => s.session.id === ref.sessionId && s.session.revision === ref.revision);\n            requireValue(source?.messages.some(message => message.id === ref.messageId && message.role === ref.role), 'INVALID_SOURCE_REFERENCE');\n        }\n    }\n}\n\nfunction errorCode(error: unknown): string {\n    const value = error as {code?: unknown; remoteCode?: unknown};\n    const code = value?.remoteCode ?? value?.code;\n    return typeof code === 'string' && /^[A-Z][A-Z0-9_]{0,79}$/.test(code) ? code : 'SCAN_PORT_FAILURE';\n}\n\nfunction matchesScope(scope: import('./contracts').KanbanBoard['scope'], source: import('./scan-ports').KanbanScanSource): boolean {\n    const expected = source.scope ?? (source.projectId ? {kind: 'project' as const, projectId: source.projectId} : undefined);\n    if (!expected || scope.kind !== expected.kind) return false;\n    if (scope.kind === 'system') return true;\n    if (scope.kind === 'project' && expected.kind === 'project') return scope.projectId === expected.projectId;\n    return scope.kind === 'collection' && expected.kind === 'collection' && scope.namespace === expected.namespace && scope.id === expected.id;\n}\n"],"mappings":"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","names":["text"]}

package/dist/execution-bridge-fpCnH6z5.d.cts

@@ -0,0 +1,52 @@
+import { T as KanbanService, I as KanbanPrincipal, r as KanbanDispatch, w as KanbanItem, d as KanbanArtifactRef, u as KanbanExternalReference, s as KanbanEstimate } from './planning-CHrOqQ6b.cjs';
+import { IFileSystem } from '@nestos/vfs-core';
+
+interface KanbanExecutionObservation {
+    controlCapabilities?: {
+        pause: 'boundary' | 'none';
+        resume: boolean;
+    };
+    executionSessionId?: string;
+    outcome: 'running' | 'unknown' | 'succeeded' | 'failed' | 'cancelled';
+    outputs?: KanbanArtifactRef[];
+    code?: string;
+}
+interface KanbanExecutionPort {
+    prepareContinuation?(dispatch: KanbanDispatch, item: KanbanItem, previousRequest: unknown): Promise<unknown>;
+    /** Persistable request; preparing cannot submit agent work. */
+    prepare(dispatch: KanbanDispatch, item: KanbanItem): Promise<unknown>;
+    start(request: unknown): Promise<KanbanExecutionObservation>;
+    /** Observe the original admission only. Missing receipts mean unknown. */
+    inspect(request: unknown): Promise<KanbanExecutionObservation>;
+}
+interface KanbanExecutionBridgeOptions {
+    fs: IFileSystem;
+    directory: string;
+    boardId: string;
+    service: KanbanService;
+    worker(principal: KanbanPrincipal): Promise<KanbanService>;
+    executor: KanbanExecutionPort;
+    authorize(stage: 'prepare' | 'start' | 'inspect', dispatch: KanbanDispatch): Promise<void>;
+    log(input: {
+        operationId: string;
+        stage: string;
+        result: 'success' | 'failure';
+        code?: string;
+        retryAfterMs?: number;
+        durationMs: number;
+    }): void;
+    executionReference?(sessionId: string, dispatchId: string): KanbanExternalReference;
+    subscribe?(wake: () => void): () => void;
+    now?: () => number;
+    autoDispatch?: boolean | (() => Promise<boolean>);
+    shutdownTimeoutMs?: number;
+    estimate?(item: KanbanItem, principal: KanbanPrincipal): Promise<KanbanEstimate | undefined>;
+}
+/** The host owns execution. Prepared/submitting identities survive response loss and host shutdown. */
+declare function createKanbanExecutionBridge(options: KanbanExecutionBridgeOptions): Promise<{
+    scan: () => Promise<void>;
+    tick: () => Promise<void>;
+    quiesce(): Promise<void>;
+}>;
+
+export { type KanbanExecutionBridgeOptions as K, type KanbanExecutionObservation as a, type KanbanExecutionPort as b, createKanbanExecutionBridge as c };

package/dist/execution-bridge-rk0uVy_n.d.ts

@@ -0,0 +1,52 @@
+import { T as KanbanService, I as KanbanPrincipal, r as KanbanDispatch, w as KanbanItem, d as KanbanArtifactRef, u as KanbanExternalReference, s as KanbanEstimate } from './planning-CHrOqQ6b.js';
+import { IFileSystem } from '@nestos/vfs-core';
+
+interface KanbanExecutionObservation {
+    controlCapabilities?: {
+        pause: 'boundary' | 'none';
+        resume: boolean;
+    };
+    executionSessionId?: string;
+    outcome: 'running' | 'unknown' | 'succeeded' | 'failed' | 'cancelled';
+    outputs?: KanbanArtifactRef[];
+    code?: string;
+}
+interface KanbanExecutionPort {
+    prepareContinuation?(dispatch: KanbanDispatch, item: KanbanItem, previousRequest: unknown): Promise<unknown>;
+    /** Persistable request; preparing cannot submit agent work. */
+    prepare(dispatch: KanbanDispatch, item: KanbanItem): Promise<unknown>;
+    start(request: unknown): Promise<KanbanExecutionObservation>;
+    /** Observe the original admission only. Missing receipts mean unknown. */
+    inspect(request: unknown): Promise<KanbanExecutionObservation>;
+}
+interface KanbanExecutionBridgeOptions {
+    fs: IFileSystem;
+    directory: string;
+    boardId: string;
+    service: KanbanService;
+    worker(principal: KanbanPrincipal): Promise<KanbanService>;
+    executor: KanbanExecutionPort;
+    authorize(stage: 'prepare' | 'start' | 'inspect', dispatch: KanbanDispatch): Promise<void>;
+    log(input: {
+        operationId: string;
+        stage: string;
+        result: 'success' | 'failure';
+        code?: string;
+        retryAfterMs?: number;
+        durationMs: number;
+    }): void;
+    executionReference?(sessionId: string, dispatchId: string): KanbanExternalReference;
+    subscribe?(wake: () => void): () => void;
+    now?: () => number;
+    autoDispatch?: boolean | (() => Promise<boolean>);
+    shutdownTimeoutMs?: number;
+    estimate?(item: KanbanItem, principal: KanbanPrincipal): Promise<KanbanEstimate | undefined>;
+}
+/** The host owns execution. Prepared/submitting identities survive response loss and host shutdown. */
+declare function createKanbanExecutionBridge(options: KanbanExecutionBridgeOptions): Promise<{
+    scan: () => Promise<void>;
+    tick: () => Promise<void>;
+    quiesce(): Promise<void>;
+}>;
+
+export { type KanbanExecutionBridgeOptions as K, type KanbanExecutionObservation as a, type KanbanExecutionPort as b, createKanbanExecutionBridge as c };

package/dist/execution.cjs

@@ -0,0 +1,18 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+var _chunkXBSGUVCYcjs = require('./chunk-XBSGUVCY.cjs');
+require('./chunk-4XF6LQSU.cjs');
+require('./chunk-RSH6QSEC.cjs');
+require('./chunk-AOHQCX7K.cjs');
+
+
+
+
+
+
+exports.consumeWorkMessages = _chunkXBSGUVCYcjs.consumeWorkMessages; exports.createKanbanExecutionBridge = _chunkXBSGUVCYcjs.createKanbanExecutionBridge; exports.parseWorkMessage = _chunkXBSGUVCYcjs.parseWorkMessage; exports.startKanbanMonitor = _chunkXBSGUVCYcjs.startKanbanMonitor; exports.unresolvedWorkIssues = _chunkXBSGUVCYcjs.unresolvedWorkIssues;
+//# sourceMappingURL=execution.cjs.map

package/dist/execution.cjs.map

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

package/dist/execution.d.cts

@@ -0,0 +1,42 @@
+export { K as KanbanExecutionBridgeOptions, a as KanbanExecutionObservation, b as KanbanExecutionPort, c as createKanbanExecutionBridge } from './execution-bridge-fpCnH6z5.cjs';
+import { K as KanbanClient } from './activity-BbC4sgKL.cjs';
+import { IFileSystem } from '@nestos/vfs-core';
+import './planning-CHrOqQ6b.cjs';
+
+/** Host supplies its scheduler; disposal prevents new scans and awaits in-flight work. */
+declare function startKanbanMonitor(options: {
+    service: Pick<KanbanClient, 'scan'>;
+    subscribeTick: (tick: () => void) => () => void;
+    onError: (error: unknown) => void | Promise<void>;
+    onSuccess?: () => void | Promise<void>;
+    subscribeChanges?: (tick: () => void) => () => void;
+    initialScan?: boolean;
+}): {
+    dispose(): Promise<void>;
+};
+
+interface WorkMessageScope {
+    runId: string;
+    itemId: string;
+    attemptId: string;
+}
+interface WorkMessage extends WorkMessageScope {
+    schema: 'work-message/1' | 'work-message/2';
+    id: string;
+    type: 'progress' | 'clarification' | 'error' | 'result' | 'resolved';
+    content: string;
+    replyTo?: string;
+}
+interface Journal {
+    get<T>(key: string): Promise<T | undefined>;
+    update<T>(key: string, change: (old: T | undefined) => T): Promise<T>;
+}
+/** Directory events are wakeups; immutable files plus durable receipts are authoritative. */
+declare function consumeWorkMessages(fs: IFileSystem, directory: string, scope: WorkMessageScope, journal: Journal, deliver: (message: WorkMessage) => Promise<void | {
+    pending: true;
+}>, decode: (text: string) => unknown, publishReply: (directory: string, name: string, content: string) => Promise<void>): Promise<WorkMessage[]>;
+declare function parseWorkMessage(text: string, scope: WorkMessageScope, decode: (text: string) => unknown): WorkMessage;
+/** Only explicit linked resolutions close issues; unrelated progress cannot erase them. */
+declare function unresolvedWorkIssues(messages: WorkMessage[]): WorkMessage[];
+
+export { type WorkMessage, type WorkMessageScope, consumeWorkMessages, parseWorkMessage, startKanbanMonitor, unresolvedWorkIssues };