@a5c-ai/adapters-gateway 5.1.1-staging.52898ebfc24f

package/dist/kanban/lib/config-loader.js

@@ -0,0 +1,166 @@
+import { promises as fs } from "fs";
+import path from "path";
+import os from "os";
+/** Return true when err represents a "file/directory not found" filesystem error. */
+export function isNotFoundError(err) {
+    if (!(err instanceof Error))
+        return false;
+    const code = err.code;
+    return code === "ENOENT" || code === "ENOTDIR" || err.message.includes("ENOENT");
+}
+const DEFAULT_REGISTRY_PATH = path.join(os.homedir(), ".a5c", "kanban.json");
+function getRegistryPath() {
+    if (process.env.KANBAN_REGISTRY) {
+        return process.env.KANBAN_REGISTRY;
+    }
+    return DEFAULT_REGISTRY_PATH;
+}
+async function loadRegistryFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const parsed = JSON.parse(content);
+        const sources = Array.isArray(parsed.sources)
+            ? parsed.sources.map((s) => ({
+                path: String(s.path || ""),
+                depth: typeof s.depth === "number" ? s.depth : 2,
+                label: s.label ? String(s.label) : undefined,
+            }))
+            : [];
+        return {
+            sources,
+            pollInterval: typeof parsed.pollInterval === "number" ? parsed.pollInterval : undefined,
+            theme: parsed.theme === "dark" || parsed.theme === "light" ? parsed.theme : undefined,
+            staleThresholdMs: typeof parsed.staleThresholdMs === "number" ? parsed.staleThresholdMs : undefined,
+            recentCompletionWindowMs: typeof parsed.recentCompletionWindowMs === "number" ? parsed.recentCompletionWindowMs : undefined,
+            retentionDays: typeof parsed.retentionDays === "number" ? parsed.retentionDays : undefined,
+            hiddenProjects: Array.isArray(parsed.hiddenProjects) ? parsed.hiddenProjects.filter((s) => typeof s === "string") : undefined,
+        };
+    }
+    catch (err) {
+        if (isNotFoundError(err)) {
+            return null;
+        }
+        throw err;
+    }
+}
+let cachedConfig = null;
+let cacheTime = 0;
+const CACHE_TTL = 10000; // 10s
+// Invalidate the config cache (called after POST /api/config writes new values)
+export function invalidateConfigCache() {
+    cachedConfig = null;
+    cacheTime = 0;
+}
+// Write config to the kanban registry file (~/.a5c/kanban.json by default).
+export async function writeConfig(data) {
+    const registryPath = getRegistryPath();
+    const dir = path.dirname(registryPath);
+    await fs.mkdir(dir, { recursive: true });
+    // Read existing file to preserve any extra fields
+    let existing = {};
+    try {
+        const content = await fs.readFile(registryPath, "utf-8");
+        existing = JSON.parse(content);
+    }
+    catch (err) {
+        // Expected when writing config for the first time; warn if the file exists but is unreadable
+        if (!isNotFoundError(err)) {
+            console.warn(`[config] Failed to read existing config at ${registryPath} before merge:`, err);
+        }
+    }
+    const merged = {
+        ...existing,
+        sources: data.sources,
+        ...(data.pollInterval !== undefined ? { pollInterval: data.pollInterval } : {}),
+        ...(data.theme !== undefined ? { theme: data.theme } : {}),
+        ...(data.staleThresholdMs !== undefined ? { staleThresholdMs: data.staleThresholdMs } : {}),
+        ...(data.recentCompletionWindowMs !== undefined ? { recentCompletionWindowMs: data.recentCompletionWindowMs } : {}),
+        ...(data.retentionDays !== undefined ? { retentionDays: data.retentionDays } : {}),
+        ...(data.hiddenProjects !== undefined ? { hiddenProjects: data.hiddenProjects } : {}),
+    };
+    await fs.writeFile(registryPath, JSON.stringify(merged, null, 2) + "\n", "utf-8");
+}
+async function loadRegistry() {
+    try {
+        const registryPath = getRegistryPath();
+        const primary = await loadRegistryFile(registryPath);
+        if (primary) {
+            return primary;
+        }
+        return { sources: [] };
+    }
+    catch (err) {
+        if (!isNotFoundError(err)) {
+            console.warn(`[config] Failed to load registry from ${getRegistryPath()} — using defaults:`, err);
+        }
+        return { sources: [] };
+    }
+}
+function getDefaultSources() {
+    const sources = [];
+    // CLI flag via KANBAN_WATCH_DIR (set by src/cli.ts — defaults to user's cwd)
+    const cliWatchDir = process.env.KANBAN_WATCH_DIR;
+    if (cliWatchDir) {
+        sources.push({ path: cliWatchDir, depth: 3, label: "cli" });
+    }
+    // WATCH_DIR env (backwards-compatible single dir)
+    if (process.env.WATCH_DIR) {
+        sources.push({ path: process.env.WATCH_DIR, depth: 0, label: "env" });
+    }
+    // WATCH_DIRS env (comma-separated)
+    if (process.env.WATCH_DIRS) {
+        for (const dir of process.env.WATCH_DIRS.split(",")) {
+            const trimmed = dir.trim();
+            if (trimmed)
+                sources.push({ path: trimmed, depth: 2 });
+        }
+    }
+    // Default: parent of cwd — users typically run from inside a project dir
+    // but want to observe ALL sibling projects in the parent folder
+    if (sources.length === 0) {
+        sources.push({
+            path: path.resolve(process.cwd(), ".."),
+            depth: 3,
+            label: "parent",
+        });
+    }
+    return sources;
+}
+export async function getConfig() {
+    const now = Date.now();
+    if (cachedConfig && now - cacheTime < CACHE_TTL) {
+        return cachedConfig;
+    }
+    const registry = await loadRegistry();
+    const defaultSources = getDefaultSources();
+    // Merge: registry sources take priority, defaults as fallback
+    // Deduplicate sources by normalized path to prevent duplicate discovery
+    const rawSources = registry.sources.length > 0 ? registry.sources : defaultSources;
+    const seen = new Set();
+    const sources = rawSources.filter((s) => {
+        const normalized = path.resolve(s.path);
+        if (seen.has(normalized))
+            return false;
+        seen.add(normalized);
+        return true;
+    });
+    // Priority: registry file > env vars > defaults
+    const envPollInterval = process.env.KANBAN_POLL_INTERVAL || process.env.POLL_INTERVAL;
+    const envTheme = process.env.KANBAN_DEFAULT_THEME || process.env.THEME;
+    const envStaleThreshold = process.env.KANBAN_STALE_THRESHOLD_MS;
+    const envRecentWindow = process.env.KANBAN_RECENT_WINDOW_MS;
+    const envRetentionDays = process.env.KANBAN_RETENTION_DAYS;
+    cachedConfig = {
+        sources,
+        port: parseInt(process.env.KANBAN_PORT || process.env.PORT || "4800", 10),
+        pollInterval: registry.pollInterval ?? (envPollInterval ? parseInt(envPollInterval, 10) : 2000),
+        theme: registry.theme ?? (envTheme === "dark" || envTheme === "light" ? envTheme : "dark"),
+        staleThresholdMs: registry.staleThresholdMs ?? (envStaleThreshold ? parseInt(envStaleThreshold, 10) : 3600000),
+        recentCompletionWindowMs: registry.recentCompletionWindowMs ?? (envRecentWindow ? parseInt(envRecentWindow, 10) : 14400000),
+        retentionDays: registry.retentionDays ?? (envRetentionDays ? parseInt(envRetentionDays, 10) : 30),
+        hiddenProjects: registry.hiddenProjects ?? [],
+    };
+    cacheTime = now;
+    return cachedConfig;
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/kanban/lib/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../../src/kanban/lib/config-loader.ts"],"names":[],"mappings":"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"}

package/dist/kanban/lib/config.d.ts

@@ -0,0 +1,3 @@
+export { isNotFoundError, type WatchSource, type KanbanConfig, type ObserverConfig, invalidateConfigCache, writeConfig, getConfig, } from "./config-loader.js";
+export { type DiscoveredRun, invalidateDiscoveryCache, discoverAllRunDirs, discoverAllRunsParentDirs, } from "./source-discovery.js";
+export { findRunDir } from "./path-resolver.js";

package/dist/kanban/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/kanban/lib/config.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,qBAAqB,EACrB,WAAW,EACX,SAAS,GACV,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,aAAa,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/kanban/lib/config.js

@@ -0,0 +1,6 @@
+// Thin re-export facade — preserves backward compatibility for all existing
+// import sites while the actual logic lives in focused modules.
+export { isNotFoundError, invalidateConfigCache, writeConfig, getConfig, } from "./config-loader.js";
+export { invalidateDiscoveryCache, discoverAllRunDirs, discoverAllRunsParentDirs, } from "./source-discovery.js";
+export { findRunDir } from "./path-resolver.js";
+//# sourceMappingURL=config.js.map

package/dist/kanban/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/kanban/lib/config.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,gEAAgE;AAEhE,OAAO,EACL,eAAe,EAIf,qBAAqB,EACrB,WAAW,EACX,SAAS,GACV,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAEL,wBAAwB,EACxB,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/kanban/lib/create-global-registry.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Generic globalThis registry factory.
+ *
+ * Provides type-safe, HMR-resilient accessors for global state.  Each caller
+ * supplies its own registry-map interface and namespace key so multiple
+ * registries (kanban, observer, etc.) can coexist without collision.
+ *
+ * CANONICAL SOURCE: packages/adapters/webui/src/lib/create-global-registry.ts
+ * Keep this copy in sync.
+ */
+/**
+ * Create a set of typed accessors for a `globalThis`-backed registry.
+ *
+ * @typeParam TMap - Interface mapping string keys to their concrete types.
+ * @param namespaceKey - The key on `globalThis` used to store the registry
+ *                       (e.g. `"__kanban_registry__"` or `"__observer_registry__"`).
+ */
+export declare function createGlobalRegistry<TMap extends object>(namespaceKey: string): {
+    /**
+     * Return an HMR-safe global value, lazily initialising it via `factory`
+     * on first access.
+     */
+    getGlobal<K extends keyof TMap & string>(key: K, factory: () => TMap[K]): TMap[K];
+    /** Clear a single key from the global registry. */
+    clearGlobal<K extends keyof TMap & string>(key: K): void;
+    /** Clear the entire global registry. */
+    clearAllGlobals(): void;
+};

package/dist/kanban/lib/create-global-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-global-registry.d.ts","sourceRoot":"","sources":["../../../src/kanban/lib/create-global-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,SAAS,MAAM,EACtD,YAAY,EAAE,MAAM;IAalB;;;OAGG;cACO,CAAC,SAAS,MAAM,IAAI,GAAG,MAAM,OAChC,CAAC,WACG,MAAM,IAAI,CAAC,CAAC,CAAC,GACrB,IAAI,CAAC,CAAC,CAAC;IAQV,mDAAmD;gBACvC,CAAC,SAAS,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI;IAQxD,wCAAwC;uBACrB,IAAI;EAK1B"}

package/dist/kanban/lib/create-global-registry.js

@@ -0,0 +1,53 @@
+/**
+ * Generic globalThis registry factory.
+ *
+ * Provides type-safe, HMR-resilient accessors for global state.  Each caller
+ * supplies its own registry-map interface and namespace key so multiple
+ * registries (kanban, observer, etc.) can coexist without collision.
+ *
+ * CANONICAL SOURCE: packages/adapters/webui/src/lib/create-global-registry.ts
+ * Keep this copy in sync.
+ */
+/**
+ * Create a set of typed accessors for a `globalThis`-backed registry.
+ *
+ * @typeParam TMap - Interface mapping string keys to their concrete types.
+ * @param namespaceKey - The key on `globalThis` used to store the registry
+ *                       (e.g. `"__kanban_registry__"` or `"__observer_registry__"`).
+ */
+export function createGlobalRegistry(namespaceKey) {
+    function registryRef() {
+        const g = globalThis;
+        if (!g[namespaceKey]) {
+            g[namespaceKey] = {};
+        }
+        return g[namespaceKey];
+    }
+    return {
+        /**
+         * Return an HMR-safe global value, lazily initialising it via `factory`
+         * on first access.
+         */
+        getGlobal(key, factory) {
+            const registry = registryRef();
+            if (registry[key] === undefined) {
+                registry[key] = factory();
+            }
+            return registry[key];
+        },
+        /** Clear a single key from the global registry. */
+        clearGlobal(key) {
+            const g = globalThis;
+            const registry = g[namespaceKey];
+            if (registry) {
+                delete registry[key];
+            }
+        },
+        /** Clear the entire global registry. */
+        clearAllGlobals() {
+            const g = globalThis;
+            g[namespaceKey] = undefined;
+        },
+    };
+}
+//# sourceMappingURL=create-global-registry.js.map

package/dist/kanban/lib/create-global-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-global-registry.js","sourceRoot":"","sources":["../../../src/kanban/lib/create-global-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,YAAoB;IAIpB,SAAS,WAAW;QAClB,MAAM,CAAC,GAAG,UAAqC,CAAC;QAChD,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;YACrB,CAAC,CAAC,YAAY,CAAC,GAAG,EAAgB,CAAC;QACrC,CAAC;QACD,OAAO,CAAC,CAAC,YAAY,CAAe,CAAC;IACvC,CAAC;IAED,OAAO;QACL;;;WAGG;QACH,SAAS,CACP,GAAM,EACN,OAAsB;YAEtB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;YAC/B,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBAChC,QAAQ,CAAC,GAAG,CAAC,GAAG,OAAO,EAAE,CAAC;YAC5B,CAAC;YACD,OAAO,QAAQ,CAAC,GAAG,CAAY,CAAC;QAClC,CAAC;QAED,mDAAmD;QACnD,WAAW,CAAgC,GAAM;YAC/C,MAAM,CAAC,GAAG,UAAqC,CAAC;YAChD,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,CAA2B,CAAC;YAC3D,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAED,wCAAwC;QACxC,eAAe;YACb,MAAM,CAAC,GAAG,UAAqC,CAAC;YAChD,CAAC,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/kanban/lib/dispatch-context-audit.d.ts

@@ -0,0 +1,12 @@
+import type { KanbanBacklogSnapshot, KanbanDispatchContextExecutionEnvelope } from "@a5c-ai/comm-adapter/kanban";
+export interface DispatchContextAuditRecord {
+    readonly issueId: string;
+    readonly issueKey: string;
+    readonly issueTitle: string;
+    readonly runIds: readonly string[];
+    readonly sessionIds: readonly string[];
+    readonly lastDispatchedAt?: string;
+    readonly executionContext: KanbanDispatchContextExecutionEnvelope;
+}
+export declare function findDispatchContextAuditsByRunId(snapshot: KanbanBacklogSnapshot | null | undefined, runId: string): DispatchContextAuditRecord[];
+export declare function findDispatchContextAuditsBySessionId(snapshot: KanbanBacklogSnapshot | null | undefined, sessionId: string): DispatchContextAuditRecord[];

package/dist/kanban/lib/dispatch-context-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-context-audit.d.ts","sourceRoot":"","sources":["../../../src/kanban/lib/dispatch-context-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,sCAAsC,EAEvC,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,sCAAsC,CAAC;CACnE;AA4BD,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,EAClD,KAAK,EAAE,MAAM,GACZ,0BAA0B,EAAE,CAW9B;AAED,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,EAClD,SAAS,EAAE,MAAM,GAChB,0BAA0B,EAAE,CAW9B"}

package/dist/kanban/lib/dispatch-context-audit.js

@@ -0,0 +1,44 @@
+function compareAuditRecords(left, right) {
+    const leftTimestamp = Date.parse(left.lastDispatchedAt ?? "");
+    const rightTimestamp = Date.parse(right.lastDispatchedAt ?? "");
+    return ((Number.isFinite(rightTimestamp) ? rightTimestamp : 0) - (Number.isFinite(leftTimestamp) ? leftTimestamp : 0) ||
+        right.runIds.length - left.runIds.length ||
+        left.issueKey.localeCompare(right.issueKey));
+}
+function toAuditRecord(issue) {
+    if (!issue.dispatch.executionContext) {
+        return null;
+    }
+    return {
+        issueId: issue.id,
+        issueKey: issue.key,
+        issueTitle: issue.title,
+        runIds: issue.dispatch.runIds,
+        sessionIds: issue.dispatch.sessionIds,
+        lastDispatchedAt: issue.dispatch.lastDispatchedAt,
+        executionContext: issue.dispatch.executionContext,
+    };
+}
+export function findDispatchContextAuditsByRunId(snapshot, runId) {
+    if (!snapshot || !runId) {
+        return [];
+    }
+    return snapshot.issues
+        .flatMap((issue) => {
+        const audit = toAuditRecord(issue);
+        return audit && audit.runIds.includes(runId) ? [audit] : [];
+    })
+        .sort(compareAuditRecords);
+}
+export function findDispatchContextAuditsBySessionId(snapshot, sessionId) {
+    if (!snapshot || !sessionId) {
+        return [];
+    }
+    return snapshot.issues
+        .flatMap((issue) => {
+        const audit = toAuditRecord(issue);
+        return audit && audit.sessionIds.includes(sessionId) ? [audit] : [];
+    })
+        .sort(compareAuditRecords);
+}
+//# sourceMappingURL=dispatch-context-audit.js.map

package/dist/kanban/lib/dispatch-context-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-context-audit.js","sourceRoot":"","sources":["../../../src/kanban/lib/dispatch-context-audit.ts"],"names":[],"mappings":"AAgBA,SAAS,mBAAmB,CAAC,IAAgC,EAAE,KAAiC;IAC9F,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IAChE,OAAO,CACL,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7G,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM;QACxC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAC5C,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAkB;IACvC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,EAAE;QACjB,QAAQ,EAAE,KAAK,CAAC,GAAG;QACnB,UAAU,EAAE,KAAK,CAAC,KAAK;QACvB,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;QAC7B,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU;QACrC,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,gBAAgB;QACjD,gBAAgB,EAAE,KAAK,CAAC,QAAQ,CAAC,gBAAgB;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,QAAkD,EAClD,KAAa;IAEb,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM;SACnB,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,CAAC,CAAC;SACD,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,QAAkD,EAClD,SAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM;SACnB,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACnC,OAAO,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,CAAC,CAAC;SACD,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAC/B,CAAC"}

package/dist/kanban/lib/error-handler.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Centralized error handling utilities.
+ *
+ * - `AppError` – typed error with HTTP status and machine-readable code.
+ * - `normalizeError` – converts any thrown value (Error, string, object,
+ *   undefined, etc.) into a consistent `{ message, code, status }` shape
+ *   safe for API responses (never leaks stack traces).
+ */
+export declare class AppError extends Error {
+    readonly code: string;
+    readonly status: number;
+    constructor(message: string, code: string, status: number);
+}
+export interface NormalizedError {
+    message: string;
+    code: string;
+    status: number;
+}
+/**
+ * Convert any thrown value into a consistent error shape.
+ *
+ * - `AppError` → preserves code & status.
+ * - Standard `Error` → maps common system errors (ENOENT, EACCES, ENOTDIR)
+ *   to appropriate HTTP status codes; defaults to 500.
+ * - `string` → wraps as 500 internal error.
+ * - Anything else (null, undefined, number, object) → generic 500.
+ */
+export declare function normalizeError(err: unknown): NormalizedError;

package/dist/kanban/lib/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/kanban/lib/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAS1D;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAoC5D"}

package/dist/kanban/lib/error-handler.js

@@ -0,0 +1,61 @@
+/**
+ * Centralized error handling utilities.
+ *
+ * - `AppError` – typed error with HTTP status and machine-readable code.
+ * - `normalizeError` – converts any thrown value (Error, string, object,
+ *   undefined, etc.) into a consistent `{ message, code, status }` shape
+ *   safe for API responses (never leaks stack traces).
+ */
+export class AppError extends Error {
+    code;
+    status;
+    constructor(message, code, status) {
+        super(message);
+        this.name = "AppError";
+        this.code = code;
+        this.status = status;
+        // Fix prototype chain for instanceof checks (TS class extending Error)
+        Object.setPrototypeOf(this, AppError.prototype);
+    }
+}
+/**
+ * Convert any thrown value into a consistent error shape.
+ *
+ * - `AppError` → preserves code & status.
+ * - Standard `Error` → maps common system errors (ENOENT, EACCES, ENOTDIR)
+ *   to appropriate HTTP status codes; defaults to 500.
+ * - `string` → wraps as 500 internal error.
+ * - Anything else (null, undefined, number, object) → generic 500.
+ */
+export function normalizeError(err) {
+    // Already a well-typed AppError
+    if (err instanceof AppError) {
+        return { message: err.message, code: err.code, status: err.status };
+    }
+    // Standard Error (or subclass)
+    if (err instanceof Error) {
+        const nodeErr = err;
+        // Map common Node.js filesystem error codes
+        if (nodeErr.code === "ENOENT") {
+            return { message: "Resource not found", code: "NOT_FOUND", status: 404 };
+        }
+        if (nodeErr.code === "EACCES" || nodeErr.code === "EPERM") {
+            return { message: "Permission denied", code: "PERMISSION_DENIED", status: 403 };
+        }
+        if (nodeErr.code === "ENOTDIR" || nodeErr.code === "EISDIR") {
+            return { message: "Invalid resource path", code: "INVALID_PATH", status: 400 };
+        }
+        // SyntaxError from JSON.parse
+        if (err instanceof SyntaxError) {
+            return { message: "Failed to parse data", code: "PARSE_ERROR", status: 400 };
+        }
+        return { message: err.message || "Internal server error", code: "INTERNAL_ERROR", status: 500 };
+    }
+    // Plain string throw
+    if (typeof err === "string") {
+        return { message: err, code: "INTERNAL_ERROR", status: 500 };
+    }
+    // Anything else (null, undefined, number, object without Error prototype)
+    return { message: "An unexpected error occurred", code: "UNKNOWN_ERROR", status: 500 };
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/kanban/lib/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../../src/kanban/lib/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAS;IACb,MAAM,CAAS;IAExB,YAAY,OAAe,EAAE,IAAY,EAAE,MAAc;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,uEAAuE;QACvE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACF;AAQD;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,gCAAgC;IAChC,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;IACtE,CAAC;IAED,+BAA+B;IAC/B,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,GAA4B,CAAC;QAE7C,4CAA4C;QAC5C,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAC3E,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1D,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAClF,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5D,OAAO,EAAE,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QACjF,CAAC;QAED,8BAA8B;QAC9B,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC/B,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAC/E,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,uBAAuB,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAClG,CAAC;IAED,qBAAqB;IACrB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC/D,CAAC;IAED,0EAA0E;IAC1E,OAAO,EAAE,OAAO,EAAE,8BAA8B,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACzF,CAAC"}

package/dist/kanban/lib/global-registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Typed GlobalRegistry for the kanban (adapters gateway) namespace.
+ *
+ * Built on the generic {@link createGlobalRegistry} factory to avoid
+ * duplicating accessor logic across packages.
+ *
+ * CANONICAL REGISTRY MAP: packages/adapters/webui/src/lib/global-registry.ts
+ * This file mirrors the same GlobalRegistryMap and namespace key.
+ */
+import type { EventEmitter } from "events";
+import type { FSWatcher } from "fs";
+/**
+ * Maps each globalThis key to its concrete runtime type.
+ *
+ * Every module that needs HMR-safe global state registers its key + type here
+ * so the accessor can enforce type safety without `any` casts.
+ */
+export interface GlobalRegistryMap {
+    /** run-cache.ts — Map of runDir to CacheEntry */
+    __kanban_run_cache__: Map<string, unknown>;
+    /** watcher.ts — shared EventEmitter for watcher change events */
+    __kanban_watcher_events__: EventEmitter;
+    /** watcher.ts — active FSWatcher instances + debounce timers */
+    __kanban_watchers__: {
+        activeWatchers: Map<string, FSWatcher>;
+        debounceTimers: Map<string, NodeJS.Timeout>;
+        rescanTimer: NodeJS.Timeout | null;
+    };
+    /** server-init.ts — shared EventEmitter for SSE server events */
+    __kanban_server_events__: EventEmitter;
+    /** server-init.ts — leading-edge debounce state for SSE broadcasts */
+    __kanban_sse_debounce__: {
+        pendingRunDirs: Set<string>;
+        timer: ReturnType<typeof setTimeout> | null;
+        windowOpen: boolean;
+    };
+    /** server-init.ts — initialization state (singleton guard) */
+    __kanban_init__: {
+        initialized: boolean;
+        initPromise: Promise<void> | null;
+        cleanup: (() => void) | null;
+    };
+}
+declare global {
+    var __kanban_registry__: Partial<GlobalRegistryMap> | undefined;
+}
+export declare const getGlobal: <K extends "__kanban_run_cache__" | "__kanban_watcher_events__" | "__kanban_watchers__" | "__kanban_server_events__" | "__kanban_sse_debounce__" | "__kanban_init__">(key: K, factory: () => GlobalRegistryMap[K]) => GlobalRegistryMap[K];
+export declare const clearGlobal: <K extends "__kanban_run_cache__" | "__kanban_watcher_events__" | "__kanban_watchers__" | "__kanban_server_events__" | "__kanban_sse_debounce__" | "__kanban_init__">(key: K) => void;
+export declare const clearAllGlobals: () => void;

package/dist/kanban/lib/global-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-registry.d.ts","sourceRoot":"","sources":["../../../src/kanban/lib/global-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAQpC;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C,iEAAiE;IACjE,yBAAyB,EAAE,YAAY,CAAC;IAExC,gEAAgE;IAChE,mBAAmB,EAAE;QACnB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACvC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5C,WAAW,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;KACpC,CAAC;IAEF,iEAAiE;IACjE,wBAAwB,EAAE,YAAY,CAAC;IAEvC,sEAAsE;IACtE,uBAAuB,EAAE;QACvB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;QAC5C,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IAEF,8DAA8D;IAC9D,eAAe,EAAE;QACf,WAAW,EAAE,OAAO,CAAC;QACrB,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAClC,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;KAC9B,CAAC;CACH;AAMD,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,mBAAmB,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAAC;CACjE;AAQD,eAAO,MAAM,SAAS,4OAAqB,CAAC;AAC5C,eAAO,MAAM,WAAW,uLAAuB,CAAC;AAChD,eAAO,MAAM,eAAe,YAA2B,CAAC"}

package/dist/kanban/lib/global-registry.js

@@ -0,0 +1,18 @@
+/**
+ * Typed GlobalRegistry for the kanban (adapters gateway) namespace.
+ *
+ * Built on the generic {@link createGlobalRegistry} factory to avoid
+ * duplicating accessor logic across packages.
+ *
+ * CANONICAL REGISTRY MAP: packages/adapters/webui/src/lib/global-registry.ts
+ * This file mirrors the same GlobalRegistryMap and namespace key.
+ */
+import { createGlobalRegistry } from "./create-global-registry.js";
+// ---------------------------------------------------------------------------
+// 3. Typed accessors — the only public API.
+// ---------------------------------------------------------------------------
+const registry = createGlobalRegistry("__kanban_registry__");
+export const getGlobal = registry.getGlobal;
+export const clearGlobal = registry.clearGlobal;
+export const clearAllGlobals = registry.clearAllGlobals;
+//# sourceMappingURL=global-registry.js.map

package/dist/kanban/lib/global-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-registry.js","sourceRoot":"","sources":["../../../src/kanban/lib/global-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAsDnE,8EAA8E;AAC9E,4CAA4C;AAC5C,8EAA8E;AAE9E,MAAM,QAAQ,GAAG,oBAAoB,CAAoB,qBAAqB,CAAC,CAAC;AAEhF,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC"}

package/dist/kanban/lib/parser.d.ts

@@ -0,0 +1,36 @@
+import type { Run, JournalEvent, TaskDetail, RunDigest } from "../types/index.js";
+/** Result of an incremental journal parse. */
+export interface IncrementalJournalResult {
+    events: JournalEvent[];
+    /** Number of JSON files in the journal directory after this parse. */
+    fileCount: number;
+}
+export declare function parseJournalDir(journalPath: string): Promise<JournalEvent[]>;
+/**
+ * Incrementally parse a journal directory.
+ *
+ * When `previousEvents` and `previousFileCount` are supplied the function
+ * skips files that were already parsed in a previous call.  If the
+ * directory now has *fewer* files than `previousFileCount` (truncation /
+ * rotation) the journal is re-read from scratch.
+ *
+ * @param journalPath          Path to the journal directory.
+ * @param previousEvents       Events returned by a prior call (used as base for merge).
+ * @param previousFileCount    Number of JSON files that existed during the prior call.
+ * @returns Merged events array (sorted by seq) and the current file count.
+ */
+export declare function parseJournalDirIncremental(journalPath: string, previousEvents?: JournalEvent[], previousFileCount?: number): Promise<IncrementalJournalResult>;
+/** Options for incremental run parsing. */
+export interface IncrementalRunOptions {
+    previousEvents?: JournalEvent[];
+    previousFileCount?: number;
+}
+/** Extended Run result that includes the journal file count for caching. */
+export interface ParseRunResult extends Run {
+    /** Number of journal files parsed — used by the cache layer for incremental reads. */
+    _journalFileCount: number;
+}
+export declare function parseRunDir(runPath: string, incremental?: IncrementalRunOptions): Promise<ParseRunResult>;
+export declare function parseTaskDetail(runPath: string, effectId: string): Promise<TaskDetail | null>;
+export declare function getRunDigest(runPath: string): Promise<RunDigest>;
+export declare function getRunIds(runsPath: string): Promise<string[]>;

package/dist/kanban/lib/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/kanban/lib/parser.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,GAAG,EAEH,YAAY,EAEZ,UAAU,EAEV,SAAS,EAIV,MAAM,mBAAmB,CAAC;AA+F3B,8CAA8C;AAC9C,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,YAAY,EAAE,EAC/B,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,wBAAwB,CAAC,CAmEnC;AAED,2CAA2C;AAC3C,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAe,SAAQ,GAAG;IACzC,sFAAsF;IACtF,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,qBAAqB,GAClC,OAAO,CAAC,cAAc,CAAC,CA6NzB;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAqG5B;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAmKtE;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnE"}