@nestos/kanban 0.0.0-stage → 0.5.2

package/dist/storage.d.ts

@@ -0,0 +1,71 @@
+import { K as KanbanBodyStore } from './store-DgdrPCV9.js';
+export { S as SeqKanbanStore } from './store-DgdrPCV9.js';
+import { e as KanbanStore, b as KanbanReadView, d as KanbanState, K as KanbanModuleOptions } from './ports-B0McVg7B.js';
+import { t as KanbanEvent, c as KanbanArchivedItem } from './planning-CHrOqQ6b.js';
+import { K as KanbanContent } from './content-hLH5BNud.js';
+import '@nestos/vfs-core';
+import './discovery-D60yrjej.js';
+
+/** A transport snapshot is pinned to one revision; unknown writes must not be replayed. */
+interface KanbanSeqSnapshot {
+    revision: string | null;
+    entries: Array<{
+        key: string;
+        value: unknown;
+    }>;
+}
+type KanbanSeqChange = {
+    action: 'set';
+    key: string;
+    value: string;
+} | {
+    action: 'delete';
+    key: string;
+};
+interface KanbanSeqClient {
+    query(path: string, query: {
+        keys: string[];
+        expectedRevision?: string;
+    }): Promise<KanbanSeqSnapshot>;
+    transaction(path: string, expectedRevision: string | null, changes: KanbanSeqChange[]): Promise<unknown>;
+    readBody?(path: string, hash: string): Promise<ArrayBuffer | null>;
+    writeBody?(path: string, hash: string, bytes: ArrayBuffer): Promise<void>;
+}
+
+/** The project export and its authorization are frozen in the injected HTTP client. */
+declare class ConditionalKanbanStore implements KanbanStore {
+    private readonly client;
+    private readonly prepareDirectory;
+    private readonly path;
+    private readonly bodies?;
+    constructor(client: Pick<KanbanSeqClient, 'query' | 'transaction'> & Partial<Pick<KanbanSeqClient, 'readBody' | 'writeBody'>>, prepareDirectory: () => Promise<void>, path?: string, bodies?: KanbanBodyStore | undefined);
+    private select;
+    boardId(number: number): Promise<string | null>;
+    ids(): Promise<string[]>;
+    view(id: string): Promise<KanbanReadView | null>;
+    read(id: string): Promise<KanbanState | null>;
+    private loadRows;
+    private queryRevision;
+    events(id: string, after: number, limit: number, through: number): Promise<KanbanEvent[]>;
+    archived(board: string, item: string): Promise<KanbanArchivedItem | null>;
+    private numberBoard;
+    update(id: string, operationId: string, fingerprint: string, change: (state: KanbanState | null) => KanbanState): Promise<KanbanState>;
+}
+
+interface KanbanContentOptions extends KanbanModuleOptions {
+    content: KanbanContent;
+    operationId: string;
+    fillMissing?: boolean;
+    missingReferences?: 'reject' | 'detach';
+}
+declare function inspectKanbanContent(store: KanbanStore, content: KanbanContent): Promise<{
+    version: number;
+    complete: boolean;
+}>;
+/** Authorized bootstrap/import: domain changes and the installed version commit together. */
+declare function installKanbanContent(options: KanbanContentOptions): Promise<{
+    changed: boolean;
+    created: number;
+}>;
+
+export { ConditionalKanbanStore, KanbanBodyStore, type KanbanContentOptions, type KanbanSeqChange, type KanbanSeqClient, type KanbanSeqSnapshot, KanbanStore, inspectKanbanContent, installKanbanContent };

package/dist/storage.js

@@ -0,0 +1,21 @@
+import {
+  ConditionalKanbanStore,
+  inspectKanbanContent,
+  installKanbanContent
+} from "./chunk-J3EAIVA3.js";
+import {
+  SeqKanbanStore
+} from "./chunk-AHHEGTUA.js";
+import "./chunk-XKDZHAUE.js";
+import "./chunk-RQP77ZTY.js";
+import "./chunk-3LEIHB7Y.js";
+import "./chunk-X4UHZX6F.js";
+import "./chunk-M35X5PHO.js";
+import "./chunk-3JYLJPE5.js";
+export {
+  ConditionalKanbanStore,
+  SeqKanbanStore,
+  inspectKanbanContent,
+  installKanbanContent
+};
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/store-DPwHzGiz.d.cts

@@ -0,0 +1,28 @@
+import { e as KanbanStore, b as KanbanReadView, d as KanbanState } from './ports-GQy0x-RI.cjs';
+import { t as KanbanEvent, c as KanbanArchivedItem } from './planning-CHrOqQ6b.cjs';
+import { IFileSystem } from '@nestos/vfs-core';
+
+interface KanbanBodyStore {
+    read(sha256: string): Promise<ArrayBuffer | null>;
+    write(sha256: string, bytes: ArrayBuffer): Promise<void>;
+}
+
+/** One user-scoped journal, with atomic board/index/receipt commits. */
+declare class SeqKanbanStore implements KanbanStore {
+    private readonly fs;
+    private readonly path;
+    private readonly bodies;
+    private constructor();
+    static open(fs: IFileSystem, directory?: string, bodies?: KanbanBodyStore): Promise<SeqKanbanStore>;
+    boardId(number: number): Promise<string | null>;
+    ids(): Promise<string[]>;
+    events(id: string, after: number, limit: number, through: number): Promise<KanbanEvent[]>;
+    archived(boardId: string, itemId: string): Promise<KanbanArchivedItem | null>;
+    private load;
+    view(id: string): Promise<KanbanReadView | null>;
+    read(id: string): Promise<KanbanState | null>;
+    update(id: string, operationId: string, fingerprint: string, change: (state: KanbanState | null) => KanbanState): Promise<KanbanState>;
+    private persist;
+}
+
+export { type KanbanBodyStore as K, SeqKanbanStore as S };

package/dist/store-DgdrPCV9.d.ts

@@ -0,0 +1,28 @@
+import { e as KanbanStore, b as KanbanReadView, d as KanbanState } from './ports-B0McVg7B.js';
+import { t as KanbanEvent, c as KanbanArchivedItem } from './planning-CHrOqQ6b.js';
+import { IFileSystem } from '@nestos/vfs-core';
+
+interface KanbanBodyStore {
+    read(sha256: string): Promise<ArrayBuffer | null>;
+    write(sha256: string, bytes: ArrayBuffer): Promise<void>;
+}
+
+/** One user-scoped journal, with atomic board/index/receipt commits. */
+declare class SeqKanbanStore implements KanbanStore {
+    private readonly fs;
+    private readonly path;
+    private readonly bodies;
+    private constructor();
+    static open(fs: IFileSystem, directory?: string, bodies?: KanbanBodyStore): Promise<SeqKanbanStore>;
+    boardId(number: number): Promise<string | null>;
+    ids(): Promise<string[]>;
+    events(id: string, after: number, limit: number, through: number): Promise<KanbanEvent[]>;
+    archived(boardId: string, itemId: string): Promise<KanbanArchivedItem | null>;
+    private load;
+    view(id: string): Promise<KanbanReadView | null>;
+    read(id: string): Promise<KanbanState | null>;
+    update(id: string, operationId: string, fingerprint: string, change: (state: KanbanState | null) => KanbanState): Promise<KanbanState>;
+    private persist;
+}
+
+export { type KanbanBodyStore as K, SeqKanbanStore as S };

package/dist/task-projection-CSorlMws.d.ts

@@ -0,0 +1,11 @@
+import { w as KanbanItem, a7 as KanbanWorkflowState, z as KanbanItemSummary, a1 as KanbanTaskProjection } from './planning-CHrOqQ6b.js';
+
+type Item = Pick<KanbanItem, 'deletedAt' | 'id' | 'status' | 'createdAt' | 'launch' | 'analysis' | 'control' | 'issues' | 'blocked' | 'externalRefs' | 'planning'>;
+declare const TASK_START_DELAY_MS = 300000;
+declare function taskStartAt(item: Pick<Item, 'createdAt' | 'launch'>): number;
+declare function taskEditing(item: Pick<Item, 'launch'>, now: number): boolean;
+declare function taskDue(item: Item, now: number): boolean;
+/** Ordered evidence projection shared by storage queries, CLI and UI. Session idle never proves acceptance. */
+declare function projectKanbanTask(item: Item, workflow?: KanbanWorkflowState, now?: number, all?: Array<Pick<KanbanItemSummary, 'id' | 'status'>>): KanbanTaskProjection;
+
+export { TASK_START_DELAY_MS as T, taskEditing as a, taskStartAt as b, projectKanbanTask as p, taskDue as t };

package/dist/task-projection-DKKB_ueb.d.cts

@@ -0,0 +1,11 @@
+import { w as KanbanItem, a7 as KanbanWorkflowState, z as KanbanItemSummary, a1 as KanbanTaskProjection } from './planning-CHrOqQ6b.cjs';
+
+type Item = Pick<KanbanItem, 'deletedAt' | 'id' | 'status' | 'createdAt' | 'launch' | 'analysis' | 'control' | 'issues' | 'blocked' | 'externalRefs' | 'planning'>;
+declare const TASK_START_DELAY_MS = 300000;
+declare function taskStartAt(item: Pick<Item, 'createdAt' | 'launch'>): number;
+declare function taskEditing(item: Pick<Item, 'launch'>, now: number): boolean;
+declare function taskDue(item: Item, now: number): boolean;
+/** Ordered evidence projection shared by storage queries, CLI and UI. Session idle never proves acceptance. */
+declare function projectKanbanTask(item: Item, workflow?: KanbanWorkflowState, now?: number, all?: Array<Pick<KanbanItemSummary, 'id' | 'status'>>): KanbanTaskProjection;
+
+export { TASK_START_DELAY_MS as T, taskEditing as a, taskStartAt as b, projectKanbanTask as p, taskDue as t };

package/examples/standalone.ts

@@ -0,0 +1,22 @@
+import {createVFS, MemoryBackend} from '@nestos/vfs-core';
+import {createKanban, SeqKanbanStore} from '@nestos/kanban';
+
+const {manager} = await createVFS({rootBackend: new MemoryBackend()});
+const store = await SeqKanbanStore.open(await manager.openFileSystem('/'));
+// The demo trusts its single in-memory user. Production hosts enforce authorization here.
+const api = createKanban({store, actor: {kind: 'human', id: 'owner'}, authorize: async () => {}});
+try {
+    await api.boards.create({id: 'research', title: 'Research', scope: {kind: 'system'},
+        members: [{kind: 'human', id: 'owner', responsibility: 'Research'}],
+        policy: {requireEstimate: false, review: 'assignee'}});
+    await api.execute('research', {operationId: 'create', expectedRevision: (await api.boards.get('research')).revision,
+        command: {type: 'create-item', stage: 'open', item: {id: 'experiment', title: 'Experiment', responsibility: 'Collect evidence', acceptance: 'Evidence recorded'}}});
+    await api.execute('research', {operationId: 'claim', expectedRevision: (await api.boards.get('research')).revision,
+        command: {type: 'claim', itemId: 'experiment'}});
+    const item = (await api.items.get('research', 'experiment')).item;
+    await api.execute('research', {operationId: 'submit', expectedRevision: (await api.boards.get('research')).revision,
+        command: {type: 'submit', itemId: item.id, token: item.owner!.token, resultRef: 'lab:evidence'}});
+    const delivered = (await api.items.get('research', 'experiment')).item;
+    if (delivered.status !== 'completed') throw new Error('Expected a completed item');
+    console.log(JSON.stringify({id: delivered.id, status: delivered.status}));
+} finally {await api.dispose(); await manager.dispose();}

package/package.json

@@ -1,6 +1,145 @@
 {
   "name": "@nestos/kanban",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.2",
+  "description": "Portable VFS-backed Kanban domain, coordination runtime and contracts.",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./contracts": "./src/contracts/index.ts",
+    "./storage": "./src/storage.ts",
+    "./execution": "./src/execution.ts",
+    "./discovery": "./src/discovery-entry.ts",
+    "./activity": "./src/activity.ts",
+    "./runtime": "./src/runtime/index.ts",
+    "./integration": "./src/runtime/integration.ts"
+  },
+  "scripts": {
+    "build": "tsup && node scripts/check-package.mjs",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "example": "tsx examples/standalone.ts",
+    "prepack": "pnpm build",
+    "test:package": "node scripts/check-package.mjs"
+  },
+  "peerDependencies": {
+    "@nestos/vfs-core": "^0.5.1"
+  },
+  "devDependencies": {
+    "@nestos/vfs-core": "^0.5.1",
+    "typescript": "^5.9.3",
+    "tsup": "^8.5.0",
+    "vitest": "^3.2.4",
+    "tsx": "^4.20.6"
+  },
+  "files": [
+    "dist",
+    "examples"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "main": "./dist/index.cjs",
+    "types": "./dist/index.d.ts",
+    "exports": {
+      ".": {
+        "import": {
+          "types": "./dist/index.d.ts",
+          "default": "./dist/index.js"
+        },
+        "require": {
+          "types": "./dist/index.d.cts",
+          "default": "./dist/index.cjs"
+        }
+      },
+      "./contracts": {
+        "import": {
+          "types": "./dist/contracts/index.d.ts",
+          "default": "./dist/contracts/index.js"
+        },
+        "require": {
+          "types": "./dist/contracts/index.d.cts",
+          "default": "./dist/contracts/index.cjs"
+        }
+      },
+      "./storage": {
+        "import": {
+          "types": "./dist/storage.d.ts",
+          "default": "./dist/storage.js"
+        },
+        "require": {
+          "types": "./dist/storage.d.cts",
+          "default": "./dist/storage.cjs"
+        }
+      },
+      "./execution": {
+        "import": {
+          "types": "./dist/execution.d.ts",
+          "default": "./dist/execution.js"
+        },
+        "require": {
+          "types": "./dist/execution.d.cts",
+          "default": "./dist/execution.cjs"
+        }
+      },
+      "./discovery": {
+        "import": {
+          "types": "./dist/discovery.d.ts",
+          "default": "./dist/discovery.js"
+        },
+        "require": {
+          "types": "./dist/discovery.d.cts",
+          "default": "./dist/discovery.cjs"
+        }
+      },
+      "./activity": {
+        "import": {
+          "types": "./dist/activity.d.ts",
+          "default": "./dist/activity.js"
+        },
+        "require": {
+          "types": "./dist/activity.d.cts",
+          "default": "./dist/activity.cjs"
+        }
+      },
+      "./runtime": {
+        "import": {
+          "types": "./dist/runtime/index.d.ts",
+          "default": "./dist/runtime/index.js"
+        },
+        "require": {
+          "types": "./dist/runtime/index.d.cts",
+          "default": "./dist/runtime/index.cjs"
+        }
+      },
+      "./integration": {
+        "import": {
+          "types": "./dist/runtime/integration.d.ts",
+          "default": "./dist/runtime/integration.js"
+        },
+        "require": {
+          "types": "./dist/runtime/integration.d.cts",
+          "default": "./dist/runtime/integration.cjs"
+        }
+      }
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nest-agentos/kanban.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nest-agentos/kanban/issues"
+  },
+  "homepage": "https://github.com/nest-agentos/kanban#readme",
+  "packageManager": "pnpm@10.20.0",
+  "license": "SEE LICENSE IN LICENSE",
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestos/vfs-core": {
+      "optional": true
+    }
+  }
+}