@runcore-sh/runcore 0.1.2

package/dist/queue/grooming.js

@@ -0,0 +1,269 @@
+/**
+ * Periodic local backlog grooming — finds vague items, stale tasks,
+ * auto-promotes ready backlog items to todo, and nudges the user
+ * when attention is needed.
+ *
+ * Extracted from the former sync timer; runs on a simple interval
+ * with no external API dependencies.
+ */
+import { readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { logActivity } from "../activity/log.js";
+import { pushNotification } from "../goals/notifications.js";
+import { createLogger } from "../utils/logger.js";
+import { onGroomingComplete } from "../services/training.js";
+import { resolveEnv } from "../instance.js";
+const log = createLogger("queue");
+const DEFAULT_GROOM_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+const COMPACT_THRESHOLD = 200;
+/** Max backlog items to promote per grooming cycle (prevents flood). */
+const MAX_PROMOTIONS_PER_CYCLE = 3;
+const GROOM_STATE_FILE = join(resolveEnv("BRAIN_DIR") ?? join(process.cwd(), "brain"), "operations", ".grooming-last-nudge");
+let timer = null;
+let activeStore = null;
+// Dedup: only log/nudge when the set of findings changes
+let lastLoggedFindings = "";
+let lastNudgedItems = "";
+function loadGroomState() {
+    try {
+        const raw = readFileSync(GROOM_STATE_FILE, "utf-8").trim();
+        if (raw) {
+            lastNudgedItems = raw;
+            lastLoggedFindings = raw;
+        }
+    }
+    catch { /* first run */ }
+}
+function persistGroomState(key) {
+    try {
+        writeFileSync(GROOM_STATE_FILE, key, "utf-8");
+    }
+    catch { /* best-effort */ }
+}
+/**
+ * Check if a backlog item is ready to be promoted to todo.
+ * Returns null if not ready, or the reasons it qualifies.
+ *
+ * Ready means:
+ * - Has a clear, actionable description (file paths, action verbs, sufficient length)
+ *   OR has been groomed via exchanges (comments/specs added)
+ * - Not blocked on human decisions (no NEEDS_HUMAN markers)
+ * - Not using ambiguous placeholder language
+ */
+function evaluateReadiness(task) {
+    if (task.state !== "backlog")
+        return null;
+    const desc = task.description || "";
+    const titleAndDesc = `${task.title} ${desc}`;
+    const reasons = [];
+    // Disqualifiers — these prevent promotion regardless of other signals
+    const exchanges = task.exchanges ?? [];
+    const blockedOnHuman = exchanges.some((ex) => ex.body.includes("[NEEDS_HUMAN]") ||
+        (ex.body.includes("Blocked") && ex.body.includes("needs human input")));
+    if (blockedOnHuman)
+        return null;
+    // Ambiguous language that signals the item isn't specced yet
+    const ambiguousPatterns = /\b(?:TBD|TBC|figure out|decide later|maybe|somehow|not sure|need to discuss)\b/i;
+    if (ambiguousPatterns.test(titleAndDesc))
+        return null;
+    // Positive signals — accumulate reasons
+    const hasFilePaths = /(?:src\/|brain\/|public\/|\.ts|\.js|\.md|\.json|\.yaml|\.yml)/.test(titleAndDesc);
+    if (hasFilePaths)
+        reasons.push("references specific files");
+    const hasActionVerbs = /\b(?:implement|add|create|fix|update|remove|refactor|extract|replace|move|rename|wire|connect|integrate)\b/i.test(titleAndDesc);
+    if (hasActionVerbs)
+        reasons.push("has action verbs");
+    const hasAcceptanceCriteria = /\b(?:acceptance|criteria|deliverable|must|should|when .+ then|endpoint|route|component|function|class|module)\b/i.test(desc);
+    if (hasAcceptanceCriteria)
+        reasons.push("has acceptance criteria");
+    const hasExchanges = exchanges.length > 0;
+    if (hasExchanges)
+        reasons.push("has spec comments");
+    const hasSubstantialDesc = desc.length >= 80;
+    if (hasSubstantialDesc)
+        reasons.push("detailed description");
+    // Decision: need at least 2 positive signals to promote
+    if (reasons.length >= 2) {
+        return { task, reasons };
+    }
+    return null;
+}
+/**
+ * Scan backlog items and promote ready ones to todo.
+ * Returns the list of promoted tasks with reasons.
+ */
+async function promoteReadyBacklogItems(store, tasks) {
+    const backlogItems = tasks.filter((t) => t.state === "backlog");
+    const promoted = [];
+    for (const task of backlogItems) {
+        if (promoted.length >= MAX_PROMOTIONS_PER_CYCLE)
+            break;
+        const result = evaluateReadiness(task);
+        if (result) {
+            await store.update(task.id, { state: "todo" });
+            promoted.push(result);
+            log.info(`Promoted ${task.identifier} → todo: ${result.reasons.join(", ")}`);
+        }
+    }
+    return promoted;
+}
+/**
+ * Periodic grooming check: find backlog items that lack specs or are stale.
+ * Logs a notification so the human or Core chat can act on it.
+ */
+async function runGroomingCheck(store) {
+    const tasks = await store.list();
+    const now = Date.now();
+    // Find backlog/todo items that are genuinely vague — no meaningful description.
+    // Items with exchanges (comments/specs) are considered groomed even if the
+    // original description is short, since specs often arrive as comments.
+    const vagueItems = tasks.filter((t) => {
+        if (t.state !== "backlog" && t.state !== "todo")
+            return false;
+        const desc = t.description || "";
+        const hasExchanges = (t.exchanges?.length ?? 0) > 0;
+        // If someone has commented/specced it, it's been groomed
+        if (hasExchanges)
+            return false;
+        // Short description with no detail signals = vague
+        const hasFilePaths = /(?:src\/|brain\/|public\/|\.ts|\.js|\.md)/.test(desc);
+        const hasActionableDetail = /(?:acceptance|criteria|deliverable|must|should|implement|add|create|fix|update|remove|when|endpoint|route|component)/i.test(desc);
+        return desc.length < 80 && !hasFilePaths && !hasActionableDetail;
+    });
+    // Find in_progress items that have been stale for > 24 hours
+    const staleInProgress = tasks.filter((t) => {
+        if (t.state !== "in_progress")
+            return false;
+        const updated = new Date(t.updatedAt).getTime();
+        return (now - updated) > 24 * 60 * 60 * 1000;
+    });
+    // Find items with stale assignees (assigned but not updated in > 2 hours — agent likely crashed)
+    const staleAssigned = tasks.filter((t) => {
+        if (!t.assignee || t.state === "done" || t.state === "cancelled")
+            return false;
+        const updated = new Date(t.updatedAt).getTime();
+        return (now - updated) > 2 * 60 * 60 * 1000;
+    });
+    // Clear stale assignees so tasks can be re-picked
+    for (const task of staleAssigned) {
+        await store.update(task.id, { assignee: null });
+    }
+    // Auto-promote ready backlog items → todo
+    const promoted = await promoteReadyBacklogItems(store, tasks);
+    // Find items with pending human questions (agent left [NEEDS_HUMAN] blocks)
+    const needsHumanInput = [];
+    for (const task of tasks) {
+        if (task.state === "done" || task.state === "cancelled")
+            continue;
+        const exchanges = task.exchanges ?? [];
+        const hasQuestion = exchanges.some((ex) => ex.body.includes("Blocked") && ex.body.includes("needs human input"));
+        if (hasQuestion)
+            needsHumanInput.push(task.identifier);
+    }
+    // Cap identifier lists at 10 to keep log messages readable
+    const cap = (ids, max = 10) => ids.length <= max ? ids.join(", ") : `${ids.slice(0, max).join(", ")} +${ids.length - max} more`;
+    const parts = [];
+    if (needsHumanInput.length > 0) {
+        parts.push(`${needsHumanInput.length} items blocked on human input (${cap(needsHumanInput)})`);
+    }
+    if (vagueItems.length > 0) {
+        parts.push(`${vagueItems.length} backlog items need specs (${cap(vagueItems.map((t) => t.identifier))})`);
+    }
+    if (staleInProgress.length > 0) {
+        parts.push(`${staleInProgress.length} items stale in In Progress (${cap(staleInProgress.map((t) => t.identifier))})`);
+    }
+    if (staleAssigned.length > 0) {
+        parts.push(`cleared ${staleAssigned.length} stale assignees (${cap(staleAssigned.map((t) => t.identifier))})`);
+    }
+    if (promoted.length > 0) {
+        const promotedSummary = promoted.map((p) => `${p.task.identifier} (${p.reasons.join(", ")})`);
+        parts.push(`promoted ${promoted.length} backlog → todo: ${cap(promotedSummary)}`);
+    }
+    // Only log when findings change — prevents the insight engine from
+    // seeing the same grooming entry every 5 minutes and escalating it
+    const findingsKey = parts.sort().join("|");
+    if (parts.length > 0 && findingsKey !== lastLoggedFindings) {
+        lastLoggedFindings = findingsKey;
+        logActivity({
+            source: "board",
+            summary: `Grooming: ${parts.join("; ")}`,
+        });
+    }
+    // Auto-compact if JSONL has too many lines (prevents bloat from append-only writes)
+    try {
+        const lines = await store.lineCount();
+        if (lines > COMPACT_THRESHOLD) {
+            const { before, after } = await store.compact();
+            logActivity({ source: "board", summary: `Queue compacted: ${lines} lines → ${after} lines` });
+        }
+    }
+    catch {
+        // Compaction failure is non-critical
+    }
+    // Notify when items are promoted — the autonomous planner can now pick them up
+    if (promoted.length > 0) {
+        const names = promoted.map((p) => `${p.task.identifier}: ${p.task.title}`).join(", ");
+        pushNotification({
+            timestamp: new Date().toISOString(),
+            source: "board",
+            message: `Auto-promoted ${promoted.length} backlog item(s) to todo: ${names}`,
+        });
+    }
+    // Nudge the user in chat if there are items needing grooming
+    const nudgeIds = [...needsHumanInput, ...vagueItems.map((t) => t.identifier)];
+    const nudgeKey = nudgeIds.sort().join(",");
+    if (nudgeIds.length > 0 && nudgeKey !== lastNudgedItems) {
+        lastNudgedItems = nudgeKey;
+        persistGroomState(nudgeKey);
+        const lines = [];
+        if (needsHumanInput.length > 0)
+            lines.push(`${needsHumanInput.length} blocked on your input: ${cap(needsHumanInput)}`);
+        if (vagueItems.length > 0)
+            lines.push(`${vagueItems.length} need specs before I can work on them: ${cap(vagueItems.map((t) => t.identifier))}`);
+        pushNotification({
+            timestamp: new Date().toISOString(),
+            source: "board",
+            message: `Backlog grooming needed:\n${lines.join("\n")}\nWant to groom these together?`,
+        });
+    }
+    // Training: observe board craft after grooming (fire-and-forget)
+    onGroomingComplete(tasks).catch(() => { });
+}
+/**
+ * Start the periodic grooming timer. Idempotent — calling twice is a no-op.
+ */
+export function startGroomingTimer(store, intervalMs = DEFAULT_GROOM_INTERVAL_MS) {
+    if (timer)
+        return;
+    activeStore = store;
+    loadGroomState();
+    // Run first check after a short delay, then on interval
+    setTimeout(async () => {
+        try {
+            await runGroomingCheck(store);
+        }
+        catch (err) {
+            log.warn(`Grooming check failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }, 10_000);
+    timer = setInterval(async () => {
+        if (!activeStore)
+            return;
+        try {
+            await runGroomingCheck(activeStore);
+        }
+        catch (err) {
+            log.warn(`Grooming check failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }, intervalMs);
+    log.info(`Grooming timer started: every ${Math.round(intervalMs / 60_000)} min`);
+}
+/** Stop the grooming timer. */
+export function stopGroomingTimer() {
+    if (timer) {
+        clearInterval(timer);
+        timer = null;
+    }
+    activeStore = null;
+}
+//# sourceMappingURL=grooming.js.map

package/dist/queue/grooming.js.map

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

package/dist/queue/provider.d.ts

@@ -0,0 +1,50 @@
+/**
+ * QueueBoardProvider — implements BoardProvider using the local QueueStore.
+ * Always available (offline-safe). Local JSONL is the sole source of truth.
+ */
+import type { BoardProvider, BoardIssue, BoardTeam, BoardState, BoardUser } from "../board/types.js";
+import { QueueStore, ProjectStore } from "./store.js";
+export declare class QueueBoardProvider implements BoardProvider {
+    readonly name: string;
+    private readonly store;
+    private readonly projects;
+    private onProjectlessTask?;
+    constructor(brainDir: string);
+    /** Register a callback for when a task is created without a project (escalation). */
+    setOnProjectlessTask(fn: (identifier: string, title: string) => void): void;
+    /** Expose the store for exchange-aware operations beyond BoardProvider. */
+    getStore(): QueueStore;
+    /** Expose the project store for project CRUD from server routes. */
+    getProjectStore(): ProjectStore;
+    isAvailable(): boolean;
+    getMe(): Promise<BoardUser | null>;
+    getTeams(): Promise<BoardTeam[]>;
+    getTeamStates(_teamId: string): Promise<BoardState[]>;
+    listIssues(opts?: {
+        teamId?: string;
+        stateType?: string;
+        limit?: number;
+        excludeAssigned?: boolean;
+        project?: string;
+    }): Promise<BoardIssue[]>;
+    createIssue(title: string, opts?: {
+        description?: string;
+        teamId?: string;
+        assigneeId?: string;
+        priority?: number;
+        labelIds?: string[];
+        project?: string;
+        origin?: "chat" | "agent" | "autonomous" | "external";
+        originSessionId?: string;
+    }): Promise<BoardIssue | null>;
+    updateIssue(id: string, opts: {
+        title?: string;
+        stateId?: string;
+        assigneeId?: string;
+        priority?: number;
+    }): Promise<BoardIssue | null>;
+    addComment(issueId: string, body: string): Promise<boolean>;
+    findByIdentifier(identifier: string): Promise<BoardIssue | null>;
+    getDoneStateId(_teamId: string): Promise<string>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/queue/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/queue/provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,SAAS,EACT,UAAU,EACV,SAAS,EACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA6BtD,qBAAa,kBAAmB,YAAW,aAAa;IACtD,QAAQ,CAAC,IAAI,SAAgC;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,iBAAiB,CAAC,CAA8C;gBAE5D,QAAQ,EAAE,MAAM;IAK5B,qFAAqF;IACrF,oBAAoB,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI3E,2EAA2E;IAC3E,QAAQ,IAAI,UAAU;IAItB,oEAAoE;IACpE,eAAe,IAAI,YAAY;IAI/B,WAAW,IAAI,OAAO;IAIhB,KAAK,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIlC,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAIhC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIrD,UAAU,CAAC,IAAI,CAAC,EAAE;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA2BnB,WAAW,CACf,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QACL,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,CAAC;QACtD,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,GACA,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAkBvB,WAAW,CACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE;QACJ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GACA,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAcvB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3D,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAKhE,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAGvD"}

package/dist/queue/provider.js

@@ -0,0 +1,131 @@
+/**
+ * QueueBoardProvider — implements BoardProvider using the local QueueStore.
+ * Always available (offline-safe). Local JSONL is the sole source of truth.
+ */
+import { QueueStore, ProjectStore } from "./store.js";
+import { QUEUE_STATES, stateDisplayName } from "./types.js";
+import { createLogger } from "../utils/logger.js";
+import { getInstanceName } from "../instance.js";
+const log = createLogger("queue.provider");
+const LOCAL_TEAM = { id: "local", name: getInstanceName(), key: getInstanceName().toUpperCase() };
+function taskToIssue(task) {
+    return {
+        id: task.id ?? "unknown",
+        identifier: task.identifier ?? `${getInstanceName().toUpperCase()}-?`,
+        title: task.title ?? "(untitled)",
+        state: stateDisplayName(task.state),
+        priority: task.priority ?? 0,
+        assignee: task.assignee ?? null,
+        project: task.project,
+        url: "", // local tasks have no URL
+    };
+}
+/** Map a BoardState id (from QUEUE_STATES) to a QueueTaskState. */
+function stateIdToQueueState(stateId) {
+    const found = QUEUE_STATES.find((s) => s.id === stateId);
+    return found?.queueState ?? null;
+}
+export class QueueBoardProvider {
+    name = `${getInstanceName()} Queue`;
+    store;
+    projects;
+    onProjectlessTask;
+    constructor(brainDir) {
+        this.projects = new ProjectStore(brainDir);
+        this.store = new QueueStore(brainDir, this.projects);
+    }
+    /** Register a callback for when a task is created without a project (escalation). */
+    setOnProjectlessTask(fn) {
+        this.onProjectlessTask = fn;
+    }
+    /** Expose the store for exchange-aware operations beyond BoardProvider. */
+    getStore() {
+        return this.store;
+    }
+    /** Expose the project store for project CRUD from server routes. */
+    getProjectStore() {
+        return this.projects;
+    }
+    isAvailable() {
+        return true; // Always available — local file
+    }
+    async getMe() {
+        return { id: getInstanceName().toLowerCase(), name: getInstanceName(), email: "", displayName: getInstanceName() };
+    }
+    async getTeams() {
+        return [LOCAL_TEAM];
+    }
+    async getTeamStates(_teamId) {
+        return QUEUE_STATES.map(({ queueState: _, ...bs }) => bs);
+    }
+    async listIssues(opts) {
+        let tasks = await this.store.list();
+        if (opts?.stateType) {
+            const matching = QUEUE_STATES.filter((s) => s.type === opts.stateType);
+            const matchingStates = new Set(matching.map((s) => s.queueState));
+            tasks = tasks.filter((t) => matchingStates.has(t.state));
+        }
+        // Filter by project
+        if (opts?.project) {
+            tasks = tasks.filter((t) => t.project === opts.project);
+        }
+        // Filter out tasks already assigned to an agent (prevents duplicate pickup)
+        if (opts?.excludeAssigned) {
+            tasks = tasks.filter((t) => !t.assignee);
+        }
+        if (opts?.limit) {
+            tasks = tasks.slice(0, opts.limit);
+        }
+        log.debug("listIssues", { stateType: opts?.stateType, project: opts?.project, limit: opts?.limit, excludeAssigned: opts?.excludeAssigned, resultCount: tasks.length });
+        return tasks.map(taskToIssue);
+    }
+    async createIssue(title, opts) {
+        const task = await this.store.create({
+            title,
+            description: opts?.description,
+            priority: opts?.priority,
+            assignee: opts?.assigneeId ?? null,
+            project: opts?.project,
+            origin: opts?.origin,
+            originSessionId: opts?.originSessionId,
+        });
+        const issue = taskToIssue(task);
+        // Trigger escalation for projectless tasks
+        if (!task.project && this.onProjectlessTask) {
+            this.onProjectlessTask(issue.identifier, issue.title);
+        }
+        return issue;
+    }
+    async updateIssue(id, opts) {
+        const changes = {};
+        if (opts.title)
+            changes.title = opts.title;
+        if (opts.priority !== undefined)
+            changes.priority = opts.priority;
+        if (opts.assigneeId !== undefined)
+            changes.assignee = opts.assigneeId;
+        if (opts.stateId) {
+            const qs = stateIdToQueueState(opts.stateId);
+            if (qs)
+                changes.state = qs;
+        }
+        const updated = await this.store.update(id, changes);
+        return updated ? taskToIssue(updated) : null;
+    }
+    async addComment(issueId, body) {
+        const ex = await this.store.addExchange(issueId, {
+            author: getInstanceName(),
+            body,
+            source: "chat",
+        });
+        return ex !== null;
+    }
+    async findByIdentifier(identifier) {
+        const task = await this.store.getByIdentifier(identifier);
+        return task ? taskToIssue(task) : null;
+    }
+    async getDoneStateId(_teamId) {
+        return "done";
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/queue/provider.js.map

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

package/dist/queue/store.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Queue store — append-only JSONL persistence for QueueTask.
+ * Follows src/memory/file-backed.ts pattern.
+ * All tasks encrypted at rest via brain-io.
+ *
+ * File: brain/operations/queue.jsonl
+ * Update strategy: append full updated task. On load, last occurrence per id wins.
+ */
+import type { QueueTask, QueueExchange, QueueTaskState, QueueProject } from "./types.js";
+export declare class ProjectStore {
+    private readonly filePath;
+    private cache;
+    constructor(brainDir: string);
+    /** Load projects from disk. Seeds defaults if file missing. */
+    load(): Promise<QueueProject[]>;
+    private save;
+    list(): Promise<QueueProject[]>;
+    get(id: string): Promise<QueueProject | undefined>;
+    getByPrefix(prefix: string): Promise<QueueProject | undefined>;
+    create(project: Omit<QueueProject, "id">): Promise<QueueProject>;
+    update(id: string, changes: Partial<Pick<QueueProject, "name" | "description">>): Promise<QueueProject | null>;
+    delete(id: string): Promise<boolean>;
+}
+export declare class QueueStore {
+    private readonly filePath;
+    private readonly projectStore;
+    private cache;
+    private lastMtime;
+    private lastStaleCheckMs;
+    private nextNums;
+    private onStateTransition?;
+    constructor(brainDir: string, projectStore?: ProjectStore);
+    /** Expose project store for external use. */
+    getProjectStore(): ProjectStore;
+    /** Register a callback fired when a task's state changes. */
+    setOnStateTransition(fn: (task: QueueTask, from: string, to: string) => void): void;
+    /** Ensure the file exists with a schema header. */
+    private ensureFile;
+    /** Load file and build in-memory cache. Called once on first access (or on reload). */
+    private load;
+    /** If the file was modified externally since last load, clear cache and reload.
+     *  Skips the stat() call if checked within the last 5s — avoids redundant I/O
+     *  when the autonomous loop calls list() multiple times in the same cycle. */
+    private checkStale;
+    /** Append a task object to the JSONL file. */
+    private append;
+    /** List all active (non-archived) tasks. */
+    list(): Promise<QueueTask[]>;
+    /** Get a task by internal id. */
+    get(id: string): Promise<QueueTask | null>;
+    /** Get a task by human-readable identifier (e.g. "DASH-3"). */
+    getByIdentifier(identifier: string): Promise<QueueTask | null>;
+    /** Create a new task. Returns the created task. */
+    create(opts: {
+        title: string;
+        description?: string;
+        state?: QueueTaskState;
+        priority?: number;
+        assignee?: string | null;
+        project?: string;
+        origin?: "chat" | "agent" | "autonomous" | "external";
+        originSessionId?: string;
+    }): Promise<QueueTask>;
+    /** Update an existing task. Appends the full updated object only if something meaningful changed. */
+    update(id: string, changes: Partial<Pick<QueueTask, "title" | "description" | "state" | "priority" | "assignee" | "project" | "agentTaskId">>): Promise<QueueTask | null>;
+    /** Archive a task (soft-delete). */
+    archive(id: string): Promise<boolean>;
+    /** Add an exchange (comment/interaction) to a task. */
+    addExchange(taskId: string, exchange: Omit<QueueExchange, "id" | "timestamp">): Promise<QueueExchange | null>;
+    /** Get all exchanges for a task. */
+    getExchanges(taskId: string): Promise<QueueExchange[]>;
+    /** Return the total count of active tasks. */
+    count(): Promise<number>;
+    /**
+     * Compact the JSONL file — rewrite with only the latest version of each task.
+     * Eliminates stale duplicate lines from append-only updates.
+     * Safe to call at any time; rebuilds from in-memory cache.
+     */
+    compact(): Promise<{
+        before: number;
+        after: number;
+    }>;
+    /** Return the raw line count of the JSONL file. */
+    lineCount(): Promise<number>;
+    /**
+     * Detect and repair identifier collisions — different tasks sharing the same identifier.
+     * For each collision group, the earliest-created task keeps its identifier;
+     * later tasks are reassigned to the next available number for that prefix.
+     * Returns a list of reassignments made.
+     */
+    repairCollisions(): Promise<Array<{
+        taskId: string;
+        oldIdentifier: string;
+        newIdentifier: string;
+    }>>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/queue/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/queue/store.ts"],"names":[],"mappings":"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"}