@nestos/kanban 0.0.0-stage → 0.5.2

package/dist/runtime/index.d.cts

@@ -0,0 +1,75 @@
+import { IFileSystem } from '@nestos/vfs-core';
+import { f as KanbanAutomationCatalog, u as KanbanExternalReference, T as KanbanService, d as KanbanArtifactRef, K as KanbanActor } from '../planning-CHrOqQ6b.cjs';
+import { K as KanbanClient } from '../activity-BbC4sgKL.cjs';
+import { K as KanbanModuleOptions } from '../ports-GQy0x-RI.cjs';
+import { K as KanbanSessionSource } from '../activity-ports-Dqxa86zT.cjs';
+import { K as KanbanResourceCatalog, a as KanbanRuntimeDiagnostic } from '../ports-BeGO1VRI.cjs';
+import '../discovery-9E-LfwIw.cjs';
+
+/** A persistable adapter-owned binding. Its payload is never interpreted by Kanban. */
+interface KanbanExecutionHandle {
+    id: string;
+    data?: unknown;
+}
+interface KanbanExecutionIntent {
+    id: string;
+    purpose: 'planning' | 'work';
+    scope: {
+        boardId: string;
+        itemId: string;
+        itemRevision: number;
+    };
+    target: KanbanExternalReference;
+    context: unknown;
+    preparation?: {
+        reference: KanbanExternalReference;
+        options?: Record<string, string>;
+    };
+    previous?: KanbanExecutionHandle;
+}
+interface KanbanExecutionReceipt {
+    outcome: 'running' | 'unknown' | 'succeeded' | 'failed' | 'cancelled';
+    executionId?: string;
+    result?: unknown;
+    code?: string;
+    controlCapabilities?: {
+        pause: 'boundary' | 'none';
+        resume: boolean;
+    };
+}
+interface KanbanExecutionAdapter {
+    catalog(): Promise<KanbanAutomationCatalog>;
+    /** Prepare a binding without starting external work. The runtime persists it before submit. */
+    prepare(intent: KanbanExecutionIntent): Promise<KanbanExecutionHandle>;
+    submit(handle: KanbanExecutionHandle): Promise<KanbanExecutionReceipt>;
+    inspect(handle: KanbanExecutionHandle): Promise<KanbanExecutionReceipt>;
+    control?(handle: KanbanExecutionHandle, command: {
+        operationId: string;
+        action: 'pause' | 'resume' | 'cancel';
+    }): Promise<'accepted' | 'paused' | 'resumed' | 'cancelled' | 'unknown'>;
+}
+interface KanbanRuntimeOptions {
+    fs: IFileSystem;
+    directory?: string;
+    actor: KanbanActor;
+    authorize: KanbanModuleOptions['authorize'];
+    execution?: KanbanExecutionAdapter;
+    resources?: KanbanResourceCatalog;
+    activity?: KanbanSessionSource;
+    onCommitted?: KanbanModuleOptions['onCommitted'];
+    log?(event: KanbanRuntimeDiagnostic): void;
+}
+/** All persistence, projections, control and deletion barriers are owned by this service. */
+interface KanbanRuntime extends KanbanService, Pick<KanbanClient, 'records' | 'record' | 'runRecord' | 'recordExecutions' | 'controlRecord' | 'itemResources' | 'recordResources' | 'previewDeletion' | 'deleteBoard' | 'cancelBoard' | 'requestBoardDeletion' | 'queryActivity' | 'executionSession' | 'automationCatalog' | 'analysisStatus'> {
+    results(boardId: string, dispatchId: string): Promise<Array<{
+        reference: KanbanArtifactRef;
+        value: unknown;
+    }>>;
+    quiesce(): Promise<void>;
+    dispose(): Promise<void>;
+}
+
+/** The public instance contains semantic operations only; all coordination state is private. */
+declare function createKanbanRuntime(options: KanbanRuntimeOptions): Promise<KanbanRuntime>;
+
+export { type KanbanExecutionAdapter, type KanbanExecutionHandle, type KanbanExecutionIntent, type KanbanExecutionReceipt, KanbanResourceCatalog, type KanbanRuntime, KanbanRuntimeDiagnostic, type KanbanRuntimeOptions, createKanbanRuntime };

package/dist/runtime/index.d.ts

@@ -0,0 +1,75 @@
+import { IFileSystem } from '@nestos/vfs-core';
+import { f as KanbanAutomationCatalog, u as KanbanExternalReference, T as KanbanService, d as KanbanArtifactRef, K as KanbanActor } from '../planning-CHrOqQ6b.js';
+import { K as KanbanClient } from '../activity-Czlan5xW.js';
+import { K as KanbanModuleOptions } from '../ports-B0McVg7B.js';
+import { K as KanbanSessionSource } from '../activity-ports-cxfrelaL.js';
+import { K as KanbanResourceCatalog, a as KanbanRuntimeDiagnostic } from '../ports-ykGiNUSx.js';
+import '../discovery-D60yrjej.js';
+
+/** A persistable adapter-owned binding. Its payload is never interpreted by Kanban. */
+interface KanbanExecutionHandle {
+    id: string;
+    data?: unknown;
+}
+interface KanbanExecutionIntent {
+    id: string;
+    purpose: 'planning' | 'work';
+    scope: {
+        boardId: string;
+        itemId: string;
+        itemRevision: number;
+    };
+    target: KanbanExternalReference;
+    context: unknown;
+    preparation?: {
+        reference: KanbanExternalReference;
+        options?: Record<string, string>;
+    };
+    previous?: KanbanExecutionHandle;
+}
+interface KanbanExecutionReceipt {
+    outcome: 'running' | 'unknown' | 'succeeded' | 'failed' | 'cancelled';
+    executionId?: string;
+    result?: unknown;
+    code?: string;
+    controlCapabilities?: {
+        pause: 'boundary' | 'none';
+        resume: boolean;
+    };
+}
+interface KanbanExecutionAdapter {
+    catalog(): Promise<KanbanAutomationCatalog>;
+    /** Prepare a binding without starting external work. The runtime persists it before submit. */
+    prepare(intent: KanbanExecutionIntent): Promise<KanbanExecutionHandle>;
+    submit(handle: KanbanExecutionHandle): Promise<KanbanExecutionReceipt>;
+    inspect(handle: KanbanExecutionHandle): Promise<KanbanExecutionReceipt>;
+    control?(handle: KanbanExecutionHandle, command: {
+        operationId: string;
+        action: 'pause' | 'resume' | 'cancel';
+    }): Promise<'accepted' | 'paused' | 'resumed' | 'cancelled' | 'unknown'>;
+}
+interface KanbanRuntimeOptions {
+    fs: IFileSystem;
+    directory?: string;
+    actor: KanbanActor;
+    authorize: KanbanModuleOptions['authorize'];
+    execution?: KanbanExecutionAdapter;
+    resources?: KanbanResourceCatalog;
+    activity?: KanbanSessionSource;
+    onCommitted?: KanbanModuleOptions['onCommitted'];
+    log?(event: KanbanRuntimeDiagnostic): void;
+}
+/** All persistence, projections, control and deletion barriers are owned by this service. */
+interface KanbanRuntime extends KanbanService, Pick<KanbanClient, 'records' | 'record' | 'runRecord' | 'recordExecutions' | 'controlRecord' | 'itemResources' | 'recordResources' | 'previewDeletion' | 'deleteBoard' | 'cancelBoard' | 'requestBoardDeletion' | 'queryActivity' | 'executionSession' | 'automationCatalog' | 'analysisStatus'> {
+    results(boardId: string, dispatchId: string): Promise<Array<{
+        reference: KanbanArtifactRef;
+        value: unknown;
+    }>>;
+    quiesce(): Promise<void>;
+    dispose(): Promise<void>;
+}
+
+/** The public instance contains semantic operations only; all coordination state is private. */
+declare function createKanbanRuntime(options: KanbanRuntimeOptions): Promise<KanbanRuntime>;
+
+export { type KanbanExecutionAdapter, type KanbanExecutionHandle, type KanbanExecutionIntent, type KanbanExecutionReceipt, KanbanResourceCatalog, type KanbanRuntime, KanbanRuntimeDiagnostic, type KanbanRuntimeOptions, createKanbanRuntime };

package/dist/runtime/index.js

@@ -0,0 +1,205 @@
+import {
+  analyzeItem,
+  assembleKanbanRuntime,
+  createKanbanAutomation,
+  defaultReferences,
+  drainBoardAnalyses,
+  scanTaskControls,
+  workContext
+} from "../chunk-FEE2YBZ7.js";
+import "../chunk-FNO5K3A7.js";
+import "../chunk-KH3WF3K4.js";
+import "../chunk-J3EAIVA3.js";
+import "../chunk-AHHEGTUA.js";
+import "../chunk-XKDZHAUE.js";
+import "../chunk-IHHDXZPZ.js";
+import "../chunk-RQP77ZTY.js";
+import {
+  requireValue
+} from "../chunk-3LEIHB7Y.js";
+import {
+  DEFAULT_KANBAN_WORK_TYPES
+} from "../chunk-X4UHZX6F.js";
+import "../chunk-M35X5PHO.js";
+import "../chunk-3JYLJPE5.js";
+
+// src/runtime/public-authorization.ts
+function runtimeAuthorization(options) {
+  return async (input) => {
+    await options.authorize(input);
+    const command = input.command;
+    if (command?.type !== "configure-automation") return;
+    if (!options.execution) {
+      requireValue(!command.settings.enabled, "AUTOMATION_UNAVAILABLE");
+      return;
+    }
+    const catalog = await options.execution.catalog(), settings = command.settings;
+    for (const reference of [settings.planner, settings.executor]) requireValue(catalog.targets.some((target) => sameReference(target.reference, reference)), "AUTOMATION_TARGET_CHANGED");
+    if (settings.preparation) requireValue(catalog.preparations?.some((target) => sameReference(target.reference, settings.preparation)), "PREPARATION_UNAVAILABLE");
+    requireValue(settings.coordinator.kind === catalog.coordinator.kind && settings.coordinator.id === catalog.coordinator.id && settings.worker.kind === catalog.worker.kind && settings.worker.id === catalog.worker.id, "AUTOMATION_PRINCIPAL_CHANGED");
+  };
+}
+function sameReference(left, right) {
+  return left.system === right.system && left.id === right.id && left.revision === right.revision;
+}
+
+// src/runtime/execution-bindings.ts
+var ExecutionBindings = class {
+  constructor(journal) {
+    this.journal = journal;
+  }
+  async save(intent, handle) {
+    requireValue(typeof handle?.id === "string" && handle.id.length > 0 && handle.id.length <= 512, "EXECUTION_HANDLE_INVALID");
+    const next = { scope: intent.scope, handle }, encoded = JSON.stringify(next);
+    requireValue(new TextEncoder().encode(encoded).byteLength <= 128 * 1024, "EXECUTION_HANDLE_TOO_LARGE");
+    const saved = await this.journal.update("execution-binding:" + intent.id, (old) => {
+      requireValue(!old || JSON.stringify(old) === encoded, "EXECUTION_BINDING_CONFLICT");
+      return old ?? next;
+    });
+    return saved.handle;
+  }
+  async get(id) {
+    return (await this.journal.get("execution-binding:" + id))?.handle;
+  }
+};
+
+// src/runtime/public-execution.ts
+function createExecutionRuntime(context, adapter, resourceSystem = defaultReferences.resource) {
+  const bindings = new ExecutionBindings(context.journal), references = { ...defaultReferences, resource: resourceSystem };
+  const prepare = async (intent) => bindings.save(intent, await adapter.prepare(intent));
+  const controls = { control: {
+    control: async (request) => {
+      const handle = await bindings.get(request.attemptId ?? request.executionId);
+      requireValue(adapter.control, "TASK_CONTROL_UNSUPPORTED");
+      requireValue(handle, "TASK_CONTROL_ROUTE_MISSING");
+      return adapter.control(handle, { operationId: request.operationId, action: request.action });
+    },
+    inspect: async (id, attempt = id) => {
+      const handle = await bindings.get(attempt);
+      if (!handle) return void 0;
+      const receipt = validateReceipt(await adapter.inspect(handle));
+      return { settled: ["succeeded", "failed", "cancelled"].includes(receipt.outcome), outcome: terminalOutcome(receipt) };
+    }
+  } };
+  const automation = createKanbanAutomation({
+    ...context,
+    directory: context.journal.directory + "/executions",
+    catalog: () => adapter.catalog(),
+    log: (event) => context.journal.diagnostic(event),
+    controls: (board, service) => scanTaskControls(controls, context.journal, board, service),
+    drain: (board, service) => drainBoardAnalyses(controls, context.journal, board, service),
+    executor: async (execution) => workExecutor(context, adapter, prepare, execution.boardId, references, execution.dependencies),
+    analyze: async (board, item, service, active) => analyzeItem(
+      {
+        journal: context.journal,
+        active,
+        log: (event) => context.journal.diagnostic(event),
+        inheritReferences: (refs) => refs.filter((ref) => [references.resource, references.decision].includes(ref.system)),
+        port: {
+          prepare: async ({ id, target }) => prepare({ id, purpose: "planning", target, ...preparation(board), scope: scope(board, item), context: {
+            ...await executionContext(context, board, item, references),
+            workTypes: board.workTypes ?? DEFAULT_KANBAN_WORK_TYPES,
+            related: board.items.map(({ id: id2, title, status, planning }) => ({ id: id2, title, status, planning }))
+          } }),
+          prepareExecution: async () => {
+          },
+          submit: async (handle) => {
+            await adapter.submit(handle);
+          },
+          inspect: async (_id, handle) => {
+            const receipt = validateReceipt(await adapter.inspect(handle));
+            return { state: receipt.outcome, output: receipt.result, code: receipt.code };
+          }
+        }
+      },
+      board,
+      item,
+      board.automation?.enabled ? board.automation.planner : void 0,
+      service
+    )
+  });
+  return { ...automation, controls };
+}
+function workExecutor(context, adapter, prepare, boardId, references, dependencies) {
+  const frozen = async (dispatch, item, previous) => {
+    const board = await context.service.read(boardId);
+    requireValue(board.automation, "AUTOMATION_UNAVAILABLE");
+    return { id: dispatch.id, handle: await prepare({
+      id: dispatch.id,
+      purpose: "work",
+      ...preparation(board),
+      scope: scope(board, item),
+      target: board.automation.executor,
+      context: { ...await executionContext(context, board, item, references), inputs: dispatch.inputs, dependencies: await dependencies(item) },
+      ...previous ? { previous } : {}
+    }) };
+  };
+  const observe = async (value, submit) => {
+    const saved = value;
+    requireValue(saved?.id && saved.handle?.id, "EXECUTION_HANDLE_INVALID");
+    const receipt = validateReceipt(await (submit ? adapter.submit(saved.handle) : adapter.inspect(saved.handle)));
+    if (receipt.outcome === "succeeded" && receipt.result === void 0) return { outcome: "unknown", code: "EXECUTION_RESULT_PENDING", executionSessionId: receipt.executionId };
+    const outputs = receipt.outcome === "succeeded" && receipt.result !== void 0 ? await context.journal.artifact(saved.id, receipt.result) : void 0;
+    return { outcome: receipt.outcome, code: receipt.code, executionSessionId: receipt.executionId, controlCapabilities: receipt.controlCapabilities, outputs };
+  };
+  return { prepare: frozen, prepareContinuation: (dispatch, item, previous) => frozen(dispatch, item, previous.handle), start: (value) => observe(value, true), inspect: (value) => observe(value, false) };
+}
+function scope(board, item) {
+  return { boardId: board.id, itemId: item.id, itemRevision: item.revision };
+}
+function terminalOutcome(receipt) {
+  return receipt.outcome === "succeeded" || receipt.outcome === "failed" || receipt.outcome === "cancelled" ? receipt.outcome : void 0;
+}
+async function executionContext(context, board, item, references) {
+  const value = await workContext(context.journal, board, item, references), decision = value.decision;
+  return { ...value, decision: decision ? { sourceBoardId: decision.sourceBoardId, recordId: decision.recordId, recordRevision: decision.recordRevision, runId: decision.runId } : null };
+}
+function validateReceipt(receipt) {
+  requireValue(receipt && ["running", "unknown", "succeeded", "failed", "cancelled"].includes(receipt.outcome), "EXECUTION_RECEIPT_INVALID");
+  requireValue(receipt.executionId === void 0 || typeof receipt.executionId === "string" && receipt.executionId.length > 0 && receipt.executionId.length <= 512, "EXECUTION_RECEIPT_INVALID");
+  requireValue(receipt.code === void 0 || typeof receipt.code === "string" && /^[A-Z][A-Z0-9_]{0,79}$/.test(receipt.code), "EXECUTION_RECEIPT_INVALID");
+  return receipt;
+}
+function preparation(board) {
+  return board.automation?.preparation ? { preparation: { reference: board.automation.preparation, options: board.automation.preparationOptions } } : {};
+}
+
+// src/runtime/public-runtime.ts
+async function createKanbanRuntime(options) {
+  let context, execution;
+  const assembled = await assembleKanbanRuntime({
+    ...options,
+    authorize: runtimeAuthorization(options),
+    log: options.log ?? (() => {
+    }),
+    referenceSystem: "kanban-execution",
+    executionSessions: options.activity ? { source: options.activity } : void 0,
+    verifyOutputs: async ({ board, itemId, dispatchId, outputs }) => {
+      if (!context || !dispatchId) return false;
+      const dispatch = (await context.service.workflow(board.id)).dispatches[dispatchId];
+      return dispatch?.itemId === itemId && context.journal.verify(outputs, dispatchId);
+    },
+    control: { control: {
+      control: (request) => execution?.controls.control.control(request) ?? Promise.resolve("unknown"),
+      inspect: (id, attempt) => execution?.controls.control.inspect?.(id, attempt) ?? Promise.resolve(void 0)
+    } },
+    extensions: (bound) => {
+      context = bound;
+      if (!options.execution) return [];
+      execution = createExecutionRuntime(bound, options.execution, options.resources?.system);
+      return [{ ...execution, capabilities: { automationCatalog: execution.automationCatalog, analysisStatus: execution.analysisStatus } }];
+    }
+  });
+  const service = assembled.service;
+  return { ...service, results: async (boardId, dispatchId) => {
+    const dispatch = (await service.workflow(boardId)).dispatches[dispatchId];
+    requireValue(dispatch, "DISPATCH_NOT_FOUND");
+    const outputs = dispatch.outputs ?? [];
+    requireValue(!outputs.length || await assembled.journal.verify(outputs, dispatchId), "ARTIFACT_INVALID");
+    return Promise.all(outputs.map(async (reference) => ({ reference, value: JSON.parse(await assembled.journal.get("artifact:" + reference.sha256)) })));
+  } };
+}
+export {
+  createKanbanRuntime
+};
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/runtime/public-authorization.ts","../../src/runtime/execution-bindings.ts","../../src/runtime/public-execution.ts","../../src/runtime/public-runtime.ts"],"sourcesContent":["import type {KanbanExternalReference} from '../contracts';\nimport type {KanbanModuleOptions} from '../ports';\nimport type {KanbanRuntimeOptions} from './public-ports';\nimport {requireValue} from '../rules';\n/** Catalog validation complements the host's current principal/resource authorization. */\nexport function runtimeAuthorization(options:KanbanRuntimeOptions):KanbanModuleOptions['authorize'] {\n    return async input=>{\n        await options.authorize(input);\n        const command=input.command;if(command?.type!=='configure-automation')return;\n        if(!options.execution){requireValue(!command.settings.enabled,'AUTOMATION_UNAVAILABLE');return;}\n        const catalog=await options.execution.catalog(),settings=command.settings;\n        for(const reference of [settings.planner,settings.executor])requireValue(catalog.targets.some(target=>sameReference(target.reference,reference)),'AUTOMATION_TARGET_CHANGED');\n        if(settings.preparation)requireValue(catalog.preparations?.some(target=>sameReference(target.reference,settings.preparation!)),'PREPARATION_UNAVAILABLE');\n        requireValue(settings.coordinator.kind===catalog.coordinator.kind&&settings.coordinator.id===catalog.coordinator.id\n            &&settings.worker.kind===catalog.worker.kind&&settings.worker.id===catalog.worker.id,'AUTOMATION_PRINCIPAL_CHANGED');\n    };\n}\nfunction sameReference(left:KanbanExternalReference,right:KanbanExternalReference):boolean {\n    return left.system===right.system&&left.id===right.id&&left.revision===right.revision;\n}\n","import type {KanbanExecutionHandle,KanbanExecutionIntent} from './public-ports';\nimport type {KanbanAutomationJournal} from './automation-journal';\nimport {requireValue} from '../rules';\ninterface Binding {scope:KanbanExecutionIntent['scope'];handle:KanbanExecutionHandle}\n/** Stable intent identities are the only index used by control and recovery. */\nexport class ExecutionBindings {\n    constructor(private readonly journal:KanbanAutomationJournal) {}\n    async save(intent:KanbanExecutionIntent,handle:KanbanExecutionHandle):Promise<KanbanExecutionHandle> {\n        requireValue(typeof handle?.id==='string'&&handle.id.length>0&&handle.id.length<=512,'EXECUTION_HANDLE_INVALID');\n        const next:Binding={scope:intent.scope,handle},encoded=JSON.stringify(next);\n        requireValue(new TextEncoder().encode(encoded).byteLength<=128*1024,'EXECUTION_HANDLE_TOO_LARGE');\n        const saved=await this.journal.update<Binding>('execution-binding:'+intent.id,old=>{\n            requireValue(!old||JSON.stringify(old)===encoded,'EXECUTION_BINDING_CONFLICT');return old??next;\n        });\n        return saved.handle;\n    }\n    async get(id:string):Promise<KanbanExecutionHandle|undefined> {\n        return (await this.journal.get<Binding>('execution-binding:'+id))?.handle;\n    }\n}\n","import type {KanbanBoard,KanbanItem} from '../contracts';\nimport {DEFAULT_KANBAN_WORK_TYPES} from '../contracts';\nimport type {KanbanExecutionPort} from '../execution';\nimport type {KanbanRuntimeContext} from './runtime-ports';\nimport type {KanbanExecutionAdapter,KanbanExecutionHandle,KanbanExecutionIntent,KanbanExecutionReceipt} from './public-ports';\nimport type {KanbanTaskControlOptions} from './control-ports';\nimport {ExecutionBindings} from './execution-bindings';\nimport {createKanbanAutomation} from './automation';\nimport {analyzeItem} from './analysis';\nimport {drainBoardAnalyses} from './board-drain';\nimport {scanTaskControls} from './task-controls';\nimport {workContext} from './work-context';\nimport {defaultReferences} from './ports';\nimport {requireValue} from '../rules';\nexport function createExecutionRuntime(context:KanbanRuntimeContext,adapter:KanbanExecutionAdapter,resourceSystem=defaultReferences.resource) {\n    const bindings=new ExecutionBindings(context.journal),references={...defaultReferences,resource:resourceSystem};\n    const prepare=async(intent:KanbanExecutionIntent)=>bindings.save(intent,await adapter.prepare(intent));\n    const controls:KanbanTaskControlOptions={control:{\n        control:async request=>{\n            const handle=await bindings.get(request.attemptId??request.executionId);\n            requireValue(adapter.control,'TASK_CONTROL_UNSUPPORTED');requireValue(handle,'TASK_CONTROL_ROUTE_MISSING');\n            return adapter.control(handle,{operationId:request.operationId,action:request.action});\n        },inspect:async(id,attempt=id)=>{\n            const handle=await bindings.get(attempt);if(!handle)return undefined;\n            const receipt=validateReceipt(await adapter.inspect(handle));\n            return {settled:['succeeded','failed','cancelled'].includes(receipt.outcome),outcome:terminalOutcome(receipt)};\n        }}};\n    const automation=createKanbanAutomation({...context,directory:context.journal.directory+'/executions',catalog:()=>adapter.catalog(),\n        log:event=>context.journal.diagnostic(event),controls:(board,service)=>scanTaskControls(controls,context.journal,board,service),\n        drain:(board,service)=>drainBoardAnalyses(controls,context.journal,board,service),\n        executor:async execution=>workExecutor(context,adapter,prepare,execution.boardId,references,execution.dependencies),\n        analyze:async(board,item,service,active)=>analyzeItem({journal:context.journal,active,log:event=>context.journal.diagnostic(event),\n            inheritReferences:refs=>refs.filter(ref=>[references.resource,references.decision].includes(ref.system)),\n            port:{prepare:async({id,target})=>prepare({id,purpose:'planning',target,...preparation(board),scope:scope(board,item),context:{...await executionContext(context,board,item,references),\n                workTypes:board.workTypes??DEFAULT_KANBAN_WORK_TYPES,related:board.items.map(({id,title,status,planning})=>({id,title,status,planning}))}}),\n                prepareExecution:async()=>{},submit:async handle=>{await adapter.submit(handle);},\n                inspect:async(_id,handle)=>{const receipt=validateReceipt(await adapter.inspect(handle));return {state:receipt.outcome,output:receipt.result,code:receipt.code};}}},\n            board,item,board.automation?.enabled?board.automation.planner:undefined,service)});\n    return {...automation,controls};\n}\nfunction workExecutor(context:KanbanRuntimeContext,adapter:KanbanExecutionAdapter,prepare:(intent:KanbanExecutionIntent)=>Promise<KanbanExecutionHandle>,boardId:string,references:typeof defaultReferences,dependencies:(item:KanbanItem)=>Promise<unknown>):KanbanExecutionPort {\n    const frozen=async(dispatch:Parameters<KanbanExecutionPort['prepare']>[0],item:KanbanItem,previous?:KanbanExecutionHandle)=>{\n        const board=await context.service.read(boardId);requireValue(board.automation,'AUTOMATION_UNAVAILABLE');\n        return {id:dispatch.id,handle:await prepare({id:dispatch.id,purpose:'work',...preparation(board),scope:scope(board,item),target:board.automation.executor,\n            context:{...await executionContext(context,board,item,references),inputs:dispatch.inputs,dependencies:await dependencies(item)},...(previous?{previous}:{})})};\n    };\n    const observe=async(value:unknown,submit:boolean)=>{\n        const saved=value as {id:string;handle:KanbanExecutionHandle};requireValue(saved?.id&&saved.handle?.id,'EXECUTION_HANDLE_INVALID');\n        const receipt=validateReceipt(await (submit?adapter.submit(saved.handle):adapter.inspect(saved.handle)));\n        if(receipt.outcome==='succeeded'&&receipt.result===undefined)return {outcome:'unknown' as const,code:'EXECUTION_RESULT_PENDING',executionSessionId:receipt.executionId};\n        const outputs=receipt.outcome==='succeeded'&&receipt.result!==undefined?await context.journal.artifact(saved.id,receipt.result):undefined;\n        return {outcome:receipt.outcome,code:receipt.code,executionSessionId:receipt.executionId,controlCapabilities:receipt.controlCapabilities,outputs};\n    };\n    return {prepare:frozen,prepareContinuation:(dispatch,item,previous)=>frozen(dispatch,item,(previous as {handle:KanbanExecutionHandle}).handle),start:value=>observe(value,true),inspect:value=>observe(value,false)};\n}\nfunction scope(board:KanbanBoard,item:KanbanItem):KanbanExecutionIntent['scope'] {return {boardId:board.id,itemId:item.id,itemRevision:item.revision};}\nfunction terminalOutcome(receipt:KanbanExecutionReceipt):'succeeded'|'failed'|'cancelled'|undefined {\n    return receipt.outcome==='succeeded'||receipt.outcome==='failed'||receipt.outcome==='cancelled'?receipt.outcome:undefined;\n}\n\nasync function executionContext(context:KanbanRuntimeContext,board:KanbanBoard,item:KanbanItem,references:typeof defaultReferences) {\n    const value=await workContext(context.journal,board,item,references),decision=value.decision;\n    return {...value,decision:decision?{sourceBoardId:decision.sourceBoardId,recordId:decision.recordId,recordRevision:decision.recordRevision,runId:decision.runId}:null};\n}\nfunction validateReceipt(receipt:KanbanExecutionReceipt):KanbanExecutionReceipt {\n    requireValue(receipt&&['running','unknown','succeeded','failed','cancelled'].includes(receipt.outcome),'EXECUTION_RECEIPT_INVALID');\n    requireValue(receipt.executionId===undefined||typeof receipt.executionId==='string'&&receipt.executionId.length>0&&receipt.executionId.length<=512,'EXECUTION_RECEIPT_INVALID');\n    requireValue(receipt.code===undefined||typeof receipt.code==='string'&&/^[A-Z][A-Z0-9_]{0,79}$/.test(receipt.code),'EXECUTION_RECEIPT_INVALID');\n    return receipt;\n}\n\nfunction preparation(board:KanbanBoard):Pick<KanbanExecutionIntent,'preparation'> {\n    return board.automation?.preparation?{preparation:{reference:board.automation.preparation,options:board.automation.preparationOptions}}:{};\n}\n","import {assembleKanbanRuntime} from './runtime';\nimport {runtimeAuthorization} from './public-authorization';\nimport {createExecutionRuntime} from './public-execution';\nimport {requireValue} from '../rules';\nimport type {KanbanRuntime,KanbanRuntimeOptions} from './public-ports';\nimport type {KanbanRuntimeContext} from './runtime-ports';\n/** The public instance contains semantic operations only; all coordination state is private. */\nexport async function createKanbanRuntime(options:KanbanRuntimeOptions):Promise<KanbanRuntime> {\n    let context:KanbanRuntimeContext|undefined,execution:ReturnType<typeof createExecutionRuntime>|undefined;\n    const assembled=await assembleKanbanRuntime({...options,authorize:runtimeAuthorization(options),log:options.log??(()=>{}),\n        referenceSystem:'kanban-execution',executionSessions:options.activity?{source:options.activity}:undefined,\n        verifyOutputs:async({board,itemId,dispatchId,outputs})=>{\n            if(!context||!dispatchId)return false;\n            const dispatch=(await context.service.workflow(board.id)).dispatches[dispatchId];\n            return dispatch?.itemId===itemId&&context.journal.verify(outputs,dispatchId);\n        },control:{control:{control:request=>execution?.controls.control.control(request)??Promise.resolve('unknown'),\n            inspect:(id,attempt)=>execution?.controls.control.inspect?.(id,attempt)??Promise.resolve(undefined)}},\n        extensions:bound=>{\n            context=bound;if(!options.execution)return [];\n            execution=createExecutionRuntime(bound,options.execution,options.resources?.system);\n            return [{...execution,capabilities:{automationCatalog:execution.automationCatalog,analysisStatus:execution.analysisStatus}}];\n        }});\n    const service=assembled.service;\n    return {...service,results:async(boardId,dispatchId)=>{\n        const dispatch=(await service.workflow(boardId)).dispatches[dispatchId];requireValue(dispatch,'DISPATCH_NOT_FOUND');\n        const outputs=dispatch.outputs??[];requireValue(!outputs.length||await assembled.journal.verify(outputs,dispatchId),'ARTIFACT_INVALID');\n        return Promise.all(outputs.map(async reference=>({reference,value:JSON.parse((await assembled.journal.get<string>('artifact:'+reference.sha256))!)})));\n    }};\n}\n"],"mappings":"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","names":["id"]}