@runcore-sh/runcore 0.1.2

package/dist/services/backlogReview.js

@@ -0,0 +1,285 @@
+/**
+ * Weekly backlog review — runs every Friday to audit backlog health.
+ * Follows src/queue/timer.ts pattern: module-level state, idempotent start/stop.
+ *
+ * Reviews:
+ * - Stale items (>30 days without update)
+ * - Unspec'd items (vague descriptions, no acceptance criteria)
+ * - Completed work still in non-done states
+ * - Priority adjustments (urgent items languishing, low-priority items that aged in)
+ *
+ * DASH-59
+ */
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("backlog-review");
+import { logActivity } from "../activity/log.js";
+// ─── Config ───────────────────────────────────────────────────────────────────
+const CHECK_INTERVAL_MS = 60 * 60 * 1000; // check every hour
+const STALE_THRESHOLD_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
+const REVIEW_DAY = 5; // Friday (0=Sun, 5=Fri)
+// ─── State ────────────────────────────────────────────────────────────────────
+let timer = null;
+let activeStore = null;
+let lastReviewWeek = null; // "2026-W09" format to avoid double-runs
+let lastReport = null;
+// ─── Review logic ─────────────────────────────────────────────────────────────
+/** Priority labels for log output. */
+const PRIORITY_LABELS = {
+    0: "none",
+    1: "urgent",
+    2: "high",
+    3: "medium",
+    4: "low",
+};
+function priorityLabel(p) {
+    return PRIORITY_LABELS[p] ?? `${p}`;
+}
+/** Get ISO week string (e.g. "2026-W09") for deduplication. */
+function getISOWeek(date) {
+    const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
+    d.setUTCDate(d.getUTCDate() + 4 - (d.getUTCDay() || 7));
+    const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+    const weekNum = Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
+    return `${d.getUTCFullYear()}-W${String(weekNum).padStart(2, "0")}`;
+}
+/**
+ * Find stale backlog/todo items — not updated in >30 days.
+ */
+function findStaleItems(tasks, now) {
+    return tasks
+        .filter((t) => {
+        if (t.state !== "backlog" && t.state !== "todo" && t.state !== "triage")
+            return false;
+        const updated = new Date(t.updatedAt).getTime();
+        return (now - updated) > STALE_THRESHOLD_MS;
+    })
+        .map((t) => ({
+        identifier: t.identifier,
+        title: t.title,
+        state: t.state,
+        daysSinceUpdate: Math.floor((now - new Date(t.updatedAt).getTime()) / (24 * 60 * 60 * 1000)),
+    }))
+        .sort((a, b) => b.daysSinceUpdate - a.daysSinceUpdate);
+}
+/**
+ * Find items with vague or missing specs.
+ * Criteria: short description (<80 chars), no file paths, no acceptance criteria keywords.
+ */
+function findUnspecdItems(tasks) {
+    return tasks
+        .filter((t) => t.state === "backlog" || t.state === "todo" || t.state === "triage")
+        .reduce((acc, t) => {
+        const desc = t.description || "";
+        const reasons = [];
+        if (desc.length === 0) {
+            reasons.push("no description");
+        }
+        else if (desc.length < 80) {
+            const hasFilePaths = /(?:src\/|brain\/|public\/|\.ts|\.js|\.md)/.test(desc);
+            const hasAcceptanceCriteria = /(?:acceptance|criteria|deliverable|must|should|when|given|then)/i.test(desc);
+            if (!hasFilePaths && !hasAcceptanceCriteria) {
+                reasons.push("description too brief and lacks specs");
+            }
+        }
+        if (reasons.length > 0) {
+            acc.push({ identifier: t.identifier, title: t.title, reason: reasons.join("; ") });
+        }
+        return acc;
+    }, []);
+}
+/**
+ * Find items that appear completed but aren't marked done.
+ * Checks exchanges for completion signals.
+ */
+function findCompletedNotMarked(tasks) {
+    const completionPatterns = [
+        /(?:completed|finished|done|shipped|deployed|merged|landed)/i,
+        /(?:PR merged|pull request merged)/i,
+        /(?:✅|✔️)/,
+    ];
+    return tasks
+        .filter((t) => t.state !== "done" && t.state !== "cancelled")
+        .reduce((acc, t) => {
+        // Check recent exchanges for completion signals
+        const recentExchanges = t.exchanges.slice(-5);
+        for (const ex of recentExchanges) {
+            for (const pattern of completionPatterns) {
+                if (pattern.test(ex.body)) {
+                    acc.push({
+                        identifier: t.identifier,
+                        title: t.title,
+                        state: t.state,
+                        evidence: `Exchange by ${ex.author}: "${ex.body.slice(0, 80)}..."`,
+                    });
+                    return acc; // one match per task is enough
+                }
+            }
+        }
+        return acc;
+    }, []);
+}
+/**
+ * Suggest priority adjustments based on age and state.
+ * - Urgent/high items in backlog for >14 days → suggest downgrade
+ * - Old items (>60 days) with no priority → suggest low or cancel
+ */
+function suggestPriorityAdjustments(tasks, now) {
+    const suggestions = [];
+    const FOURTEEN_DAYS = 14 * 24 * 60 * 60 * 1000;
+    const SIXTY_DAYS = 60 * 24 * 60 * 60 * 1000;
+    for (const t of tasks) {
+        if (t.state === "done" || t.state === "cancelled")
+            continue;
+        const age = now - new Date(t.createdAt).getTime();
+        // Urgent/high items sitting in backlog for >14 days — probably not actually urgent
+        if ((t.priority === 1 || t.priority === 2) && t.state === "backlog" && age > FOURTEEN_DAYS) {
+            suggestions.push({
+                identifier: t.identifier,
+                title: t.title,
+                currentPriority: t.priority,
+                suggestedPriority: 3, // medium
+                reason: `${priorityLabel(t.priority)} priority but sitting in backlog for ${Math.floor(age / (24 * 60 * 60 * 1000))} days`,
+            });
+        }
+        // Very old items with no priority → suggest low priority to surface them
+        if (t.priority === 0 && (t.state === "backlog" || t.state === "triage") && age > SIXTY_DAYS) {
+            suggestions.push({
+                identifier: t.identifier,
+                title: t.title,
+                currentPriority: 0,
+                suggestedPriority: 4, // low
+                reason: `no priority set, ${Math.floor(age / (24 * 60 * 60 * 1000))} days old — consider prioritizing or cancelling`,
+            });
+        }
+    }
+    return suggestions;
+}
+/**
+ * Run the full weekly backlog review. Returns a structured report.
+ */
+export async function runBacklogReview(store) {
+    const tasks = await store.list();
+    const now = Date.now();
+    const report = {
+        reviewedAt: new Date().toISOString(),
+        totalBacklogItems: tasks.filter((t) => t.state === "backlog").length,
+        staleItems: findStaleItems(tasks, now),
+        unspecdItems: findUnspecdItems(tasks),
+        completedNotMarked: findCompletedNotMarked(tasks),
+        prioritySuggestions: suggestPriorityAdjustments(tasks, now),
+    };
+    // Log summary
+    const parts = [];
+    parts.push(`${report.totalBacklogItems} backlog items reviewed`);
+    if (report.staleItems.length > 0) {
+        parts.push(`${report.staleItems.length} stale (${report.staleItems.map((i) => i.identifier).join(", ")})`);
+    }
+    if (report.unspecdItems.length > 0) {
+        parts.push(`${report.unspecdItems.length} need specs (${report.unspecdItems.map((i) => i.identifier).join(", ")})`);
+    }
+    if (report.completedNotMarked.length > 0) {
+        parts.push(`${report.completedNotMarked.length} may be done (${report.completedNotMarked.map((i) => i.identifier).join(", ")})`);
+    }
+    if (report.prioritySuggestions.length > 0) {
+        parts.push(`${report.prioritySuggestions.length} priority suggestions`);
+    }
+    // Build detail text for the log
+    const detailLines = [];
+    if (report.staleItems.length > 0) {
+        detailLines.push("Stale items:");
+        for (const item of report.staleItems) {
+            detailLines.push(`  ${item.identifier}: "${item.title}" — ${item.daysSinceUpdate} days since update (${item.state})`);
+        }
+    }
+    if (report.unspecdItems.length > 0) {
+        detailLines.push("Needs specs:");
+        for (const item of report.unspecdItems) {
+            detailLines.push(`  ${item.identifier}: "${item.title}" — ${item.reason}`);
+        }
+    }
+    if (report.completedNotMarked.length > 0) {
+        detailLines.push("Possibly completed:");
+        for (const item of report.completedNotMarked) {
+            detailLines.push(`  ${item.identifier}: "${item.title}" (still ${item.state}) — ${item.evidence}`);
+        }
+    }
+    if (report.prioritySuggestions.length > 0) {
+        detailLines.push("Priority suggestions:");
+        for (const item of report.prioritySuggestions) {
+            detailLines.push(`  ${item.identifier}: "${item.title}" — ${priorityLabel(item.currentPriority)} → ${priorityLabel(item.suggestedPriority)}: ${item.reason}`);
+        }
+    }
+    logActivity({
+        source: "board",
+        summary: `Weekly backlog review: ${parts.join("; ")}`,
+        detail: detailLines.length > 0 ? detailLines.join("\n") : undefined,
+    });
+    lastReport = report;
+    return report;
+}
+// ─── Timer ────────────────────────────────────────────────────────────────────
+/**
+ * Hourly check: if it's Friday and we haven't reviewed this week, run the review.
+ */
+async function checkAndRun() {
+    if (!activeStore)
+        return;
+    const now = new Date();
+    if (now.getDay() !== REVIEW_DAY)
+        return;
+    const currentWeek = getISOWeek(now);
+    if (lastReviewWeek === currentWeek)
+        return;
+    // It's Friday and we haven't reviewed this week — run it
+    lastReviewWeek = currentWeek;
+    try {
+        await runBacklogReview(activeStore);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logActivity({ source: "board", summary: `Backlog review error: ${msg}` });
+    }
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Start the weekly backlog review timer. Idempotent.
+ * Checks hourly whether it's Friday; runs once per week.
+ */
+export function startBacklogReviewTimer(store, intervalMs) {
+    if (timer)
+        return;
+    activeStore = store;
+    const interval = intervalMs ?? CHECK_INTERVAL_MS;
+    // Check immediately on start (catches Friday restarts)
+    checkAndRun();
+    timer = setInterval(checkAndRun, interval);
+    log.info(`Backlog review: weekly on Fridays (checking every ${Math.round(interval / 60_000)} min)`);
+}
+/** Stop the backlog review timer. */
+export function stopBacklogReviewTimer() {
+    if (timer) {
+        clearInterval(timer);
+        timer = null;
+    }
+    activeStore = null;
+}
+/** Check if the backlog review timer is running. */
+export function isBacklogReviewRunning() {
+    return timer !== null;
+}
+/** Get the last review report, if any. */
+export function getLastBacklogReview() {
+    return lastReport;
+}
+/**
+ * Force an immediate backlog review (e.g. from an API endpoint or chat command).
+ * Ignores the Friday/weekly check.
+ */
+export async function triggerBacklogReview() {
+    if (!activeStore)
+        return null;
+    const report = await runBacklogReview(activeStore);
+    lastReviewWeek = getISOWeek(new Date());
+    return report;
+}
+//# sourceMappingURL=backlogReview.js.map

package/dist/services/backlogReview.js.map

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

package/dist/services/backup.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Automated brain backup service — DASH-147.
+ * Schedules periodic backups of the brain/ directory to configured storage providers.
+ * Brain files are already encrypted at rest (DASH-148), so backup is just file sync.
+ * Safe word never leaves the local machine.
+ *
+ * Recovery process: clone repo → pull backup → enter safe word → brain reconstituted.
+ */
+import { type BackupConfig } from "../settings.js";
+import type { BackupManifest, BackupResult } from "../adapters/storage/types.js";
+export type BackupProvider = "local" | "gdrive";
+export declare function startBackupTimer(): void;
+export declare function stopBackupTimer(): void;
+export declare function isBackupTimerRunning(): boolean;
+export declare function getLastBackup(): BackupManifest | null;
+export declare function getLastBackupError(): string | null;
+export declare function getActiveBackupConfig(): BackupConfig;
+/**
+ * Run a backup of the brain/ directory to all configured providers.
+ * Can be called manually or by the scheduler.
+ */
+export declare function runBackup(overrideProviders?: BackupProvider[]): Promise<BackupResult>;
+/**
+ * Restore brain/ from a backup archive.
+ * After restore, user must enter safe word to decrypt episodic files.
+ */
+export declare function restoreBackup(provider: BackupProvider, backupId: string): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+/**
+ * Verify a backup by checking manifest checksums against stored files.
+ */
+export declare function verifyBackup(provider: BackupProvider, backupId: string): Promise<{
+    ok: boolean;
+    message: string;
+    mismatches: string[];
+}>;
+/**
+ * List available backups across all configured providers.
+ */
+export declare function listBackups(provider?: BackupProvider): Promise<BackupManifest[]>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/services/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/services/backup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAkB,cAAc,EAAmB,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAQlH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;AAYhD,wBAAgB,gBAAgB,IAAI,IAAI,CAoBvC;AAED,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,aAAa,IAAI,cAAc,GAAG,IAAI,CAErD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAElD;AAED,wBAAgB,qBAAqB,IAAI,YAAY,CAEpD;AA8CD;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,iBAAiB,CAAC,EAAE,cAAc,EAAE,GACnC,OAAO,CAAC,YAAY,CAAC,CA2EvB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA+B3C;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiCjE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,cAAc,EAAE,CAAC,CAa3B"}