flanders 0.6.1 → 0.8.0

package/lib/ui/formatters.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SEPARATOR_GLYPH = exports.RESET = exports.ORANGE = exports.DIM = exports.BLUE = exports.GREEN = exports.MAGENTA = exports.YELLOW = exports.CYAN = void 0;
+exports.SEPARATOR_GLYPH = exports.RESET = exports.ORANGE = exports.DIM = exports.BLUE = exports.RED = exports.GREEN = exports.MAGENTA = exports.YELLOW = exports.CYAN = void 0;
 exports.colorize = colorize;
 exports.stripAnsi = stripAnsi;
 exports.renderSegments = renderSegments;
+exports.segmentsWidth = segmentsWidth;
 exports.renderSegmentsToWidth = renderSegmentsToWidth;
 exports.formatCountdown = formatCountdown;
+exports.formatCompactCountdown = formatCompactCountdown;
 exports.formatDateTime = formatDateTime;
 exports.truncateToWidth = truncateToWidth;
 exports.formatTokens = formatTokens;
@@ -17,11 +19,13 @@ exports.formatSnapshotMetrics = formatSnapshotMetrics;
 exports.formatSnapshotBlock = formatSnapshotBlock;
 exports.formatReviewingFooter = formatReviewingFooter;
 exports.formatWorkingFooter = formatWorkingFooter;
+exports.formatTerminalFooter = formatTerminalFooter;
 exports.formatWaitingFooter = formatWaitingFooter;
 exports.CYAN = "\x1b[36m";
 exports.YELLOW = "\x1b[33m";
 exports.MAGENTA = "\x1b[35m";
 exports.GREEN = "\x1b[32m";
+exports.RED = "\x1b[31m";
 exports.BLUE = "\x1b[34m";
 exports.DIM = "\x1b[2m";
 exports.ORANGE = "\x1b[38;5;208m";
@@ -45,11 +49,14 @@ function renderSegments(segments) {
     }
     return result;
 }
-function renderSegmentsToWidth(segments, cols) {
-    let plainLen = 0;
+function segmentsWidth(segments) {
+    let width = 0;
     for (const seg of segments)
-        plainLen += seg.text.length;
-    if (plainLen <= cols)
+        width += seg.text.length;
+    return width;
+}
+function renderSegmentsToWidth(segments, cols) {
+    if (segmentsWidth(segments) <= cols)
         return renderSegments(segments);
     let result = "";
     let remaining = Math.max(0, cols - 1);
@@ -68,21 +75,41 @@ function renderSegmentsToWidth(segments, cols) {
     result += "…";
     return result;
 }
-function formatCountdown(remainingMs) {
+function decomposeCountdown(remainingMs) {
     const totalMinutes = Math.max(1, Math.ceil(remainingMs / 60000));
     if (totalMinutes >= 24 * 60) {
         const days = Math.floor(totalMinutes / (24 * 60));
         const remainder = totalMinutes - days * 24 * 60;
         const hours = Math.floor(remainder / 60);
         const minutes = remainder % 60;
-        return `${days} days, ${hours} hours, ${minutes} minutes`;
+        return { tier: "days", days, hours, minutes };
     }
     if (totalMinutes >= 60) {
         const hours = Math.floor(totalMinutes / 60);
         const minutes = totalMinutes % 60;
+        return { tier: "hours", days: 0, hours, minutes };
+    }
+    return { tier: "minutes", days: 0, hours: 0, minutes: totalMinutes };
+}
+function formatCountdown(remainingMs) {
+    const { tier, days, hours, minutes } = decomposeCountdown(remainingMs);
+    if (tier === "days") {
+        return `${days} days, ${hours} hours, ${minutes} minutes`;
+    }
+    if (tier === "hours") {
         return `${hours} hours ${minutes} minutes`;
     }
-    return `${totalMinutes} minutes`;
+    return `${minutes} minutes`;
+}
+function formatCompactCountdown(remainingMs) {
+    const { tier, days, hours, minutes } = decomposeCountdown(remainingMs);
+    if (tier === "days") {
+        return `${days}d${hours}h${minutes}m`;
+    }
+    if (tier === "hours") {
+        return `${hours}h${minutes}m`;
+    }
+    return `${minutes}m`;
 }
 function formatDateTime(date) {
     const pad = (n) => String(n).padStart(2, "0");
@@ -192,10 +219,7 @@ function formatMetricsLine(task, plan, cols) {
         fullSegments.push({ text: "  " }, { text: "│", color: exports.DIM }, { text: "  " });
     if (plan)
         fullSegments.push(...buildPairFullSegments("plan", pTok, pTime));
-    let fullPlainLen = 0;
-    for (const seg of fullSegments)
-        fullPlainLen += seg.text.length;
-    if (fullPlainLen <= cols)
+    if (segmentsWidth(fullSegments) <= cols)
         return renderSegments(fullSegments);
     const compactSegments = [];
     if (task)
@@ -204,10 +228,7 @@ function formatMetricsLine(task, plan, cols) {
         compactSegments.push({ text: "│", color: exports.DIM });
     if (plan)
         compactSegments.push(...buildPairCompactSegments("p:", pTok, pTime));
-    let compactPlainLen = 0;
-    for (const seg of compactSegments)
-        compactPlainLen += seg.text.length;
-    if (compactPlainLen <= cols)
+    if (segmentsWidth(compactSegments) <= cols)
         return renderSegments(compactSegments);
     return renderSegmentsToWidth(compactSegments, cols);
 }
@@ -235,36 +256,40 @@ function reviewerEntryDescriptor(model, effort) {
     const effortToken = effort === "" ? "default" : effort;
     return `(${modelToken} ${effortToken})`;
 }
-function buildReviewingFullText(reviewers) {
-    let line = "review: ";
-    for (let i = 0; i < reviewers.length; i++) {
-        const r = reviewers[i];
-        if (i > 0)
-            line += ", ";
-        line += `${r.tool} ${reviewerEntryDescriptor(r.model, r.effort)}: ${r.state}`;
+function reviewerStateText(r, nowMs) {
+    if (r.state === "waiting" && r.endTime != null) {
+        return `waiting ${formatCompactCountdown(Math.max(0, r.endTime - nowMs))}`;
     }
-    return line;
+    return r.state;
 }
-function buildReviewingCompactText(reviewers) {
-    let line = "review: ";
+function reviewerEntryColor(state) {
+    if (state === "pass")
+        return exports.GREEN;
+    if (state === "fail")
+        return exports.RED;
+    return exports.ORANGE;
+}
+function buildReviewingSegments(frame, reviewers, nowMs, compact) {
+    const segments = [{ text: `${frame} review: `, color: exports.ORANGE }];
     for (let i = 0; i < reviewers.length; i++) {
         const r = reviewers[i];
         if (i > 0)
-            line += ", ";
-        line += `${r.tool}: ${r.state}`;
+            segments.push({ text: ", ", color: exports.ORANGE });
+        const descriptor = compact ? "" : ` ${reviewerEntryDescriptor(r.model, r.effort)}`;
+        segments.push({ text: `${r.tool}${descriptor}: ${reviewerStateText(r, nowMs)}`, color: reviewerEntryColor(r.state) });
     }
-    return line;
+    return segments;
 }
-function formatReviewingFooter(reviewers, cols) {
-    const fullText = buildReviewingFullText(reviewers);
-    if (fullText.length <= cols) {
-        return renderSegments([{ text: fullText, color: exports.ORANGE }]);
+function formatReviewingFooter(frame, reviewers, cols, nowMs) {
+    const full = buildReviewingSegments(frame, reviewers, nowMs, false);
+    if (segmentsWidth(full) <= cols) {
+        return renderSegments(full);
     }
-    const compactText = buildReviewingCompactText(reviewers);
-    if (compactText.length <= cols) {
-        return renderSegments([{ text: compactText, color: exports.ORANGE }]);
+    const compact = buildReviewingSegments(frame, reviewers, nowMs, true);
+    if (segmentsWidth(compact) <= cols) {
+        return renderSegments(compact);
     }
-    return renderSegmentsToWidth([{ text: compactText, color: exports.ORANGE }], cols);
+    return renderSegmentsToWidth(compact, cols);
 }
 function fitOrangeFooterLine(text, cols) {
     if (text.length <= cols) {
@@ -272,8 +297,11 @@ function fitOrangeFooterLine(text, cols) {
     }
     return renderSegmentsToWidth([{ text, color: exports.ORANGE }], cols);
 }
-function formatWorkingFooter(frame, cols) {
-    return fitOrangeFooterLine(`${frame} Working`, cols);
+function formatWorkingFooter(frame, label, cols) {
+    return fitOrangeFooterLine(`${frame} ${label}`, cols);
+}
+function formatTerminalFooter(label, cols) {
+    return fitOrangeFooterLine(label, cols);
 }
 function formatWaitingFooter(heading, dateTime, countdown, cols) {
     return fitOrangeFooterLine(`${heading} — ${dateTime} — ${countdown}`, cols);

package/lib/voiceVariants.d.ts

@@ -0,0 +1,15 @@
+import type { RandomContext } from "./contexts";
+export declare const workingPool: readonly string[];
+export declare const successPool: readonly string[];
+export declare const hardStopPool: readonly string[];
+export declare const interruptionPool: readonly string[];
+export declare const failurePool: readonly string[];
+export declare const tasksCompletedPool: readonly string[];
+export declare const allTasksCompletedPool: readonly string[];
+export declare const terminalPools: {
+    Done: readonly string[];
+    "Hard stop": readonly string[];
+    Interrupted: readonly string[];
+    Failed: readonly string[];
+};
+export declare function pickVariant(pool: readonly string[], random: RandomContext, exclude?: string): string;

package/lib/voiceVariants.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.terminalPools = exports.allTasksCompletedPool = exports.tasksCompletedPool = exports.failurePool = exports.interruptionPool = exports.hardStopPool = exports.successPool = exports.workingPool = void 0;
+exports.pickVariant = pickVariant;
+exports.workingPool = [
+    "Workin'-diddly",
+    "Toilin' away",
+    "Okely-workin'",
+    "Pluggin' away",
+    "Diddly-doin'",
+    "Beaverin' away",
+    "Tinkerin'-diddly",
+    "Hammerin' away",
+    "Whittlin' away",
+    "Doodly-doin'",
+    "Scribblin'-diddly",
+    "Codin'-aroo",
+    "Buildin'-diddly",
+    "Fixin'-diddly",
+    "Noodlin' away",
+    "Tappity-tappin'",
+    "Diddly-dabblin'",
+    "Plowin' ahead",
+    "Chuggin' along",
+    "Pressin' on-aroo",
+    "Diligent-diddly",
+    "Steady-diddly",
+    "Crunchin'-diddly",
+    "Diddly-developin'",
+    "Wranglin' code",
+    "Pokin' at it",
+    "Diddly-debuggin'",
+    "Cookin'-diddly",
+    "Trundlin' along",
+    "Diddly-draftin'",
+    "Bustlin'-aroo",
+    "Hummin' along",
+    "Choppin'-diddly",
+    "Sweatin'-diddly",
+    "Diddly-deliverin'",
+    "Craftin'-aroo",
+    "Workin'-aroo",
+    "Toilin'-diddly",
+    "Diddly-drudgin'",
+    "Gettin' it done",
+    "Grindin'-diddly",
+    "Diddly-graftin'",
+    "Peggin' away",
+    "Diddly-doodlin'",
+    "Crankin'-diddly",
+    "Hustlin'-diddly",
+    "Diddly-diggin'",
+    "Pluggin'-diddly",
+    "Tappin' keys",
+    "Dilly-workin'",
+];
+exports.successPool = [
+    "Done-diddly",
+    "Done-diddly-done",
+    "All wrapped up, neighbor",
+    "Okely-dokely — done",
+    "Done-aroo",
+    "Hi-diddly-done",
+    "All done, neighborino",
+    "Done and done-diddly",
+    "That's a wrap, neighbor",
+    "Mission accomplished-diddly",
+];
+exports.hardStopPool = [
+    "Whoopsie, hard stop",
+    "Dilly of a pickle — hard stop",
+    "Hard stop, neighbor",
+    "Hard stop-aroo",
+    "Well, heck — hard stop",
+    "Hard stop-diddly",
+    "Fiddlesticks — hard stop",
+    "Gotta call it — hard stop",
+    "Pumpin' the brakes — hard stop",
+    "Hard stop, neighborino",
+];
+exports.interruptionPool = [
+    "Interrupted-aroo",
+    "Well, heck — interrupted",
+    "Interrupted, neighbor",
+    "Stopped short-diddly",
+    "Cut off-aroo",
+    "Hold the phone — interrupted",
+    "Interrupted-diddly",
+    "Toodle-oo — interrupted",
+    "Interrupted, neighborino",
+    "Halted-aroo",
+];
+exports.failurePool = [
+    "Aw, fiddlesticks — failed",
+    "Dad-gummit — failed",
+    "Failed, neighbor",
+    "Failed-aroo",
+    "Gosh-darn it — failed",
+    "Heavens to Betsy — failed",
+    "Failed-diddly",
+    "Well, shucks — failed",
+    "That's a no-go — failed",
+    "Failed, neighborino",
+];
+exports.tasksCompletedPool = [
+    "tasks completed — nothin' to do-diddly-do, neighbor!",
+    "all done already, neighbor — okely-dokely!",
+    "nothin' left to do here, neighbor!",
+    "tasks completed — already shipshape, neighborino!",
+    "nothin' to do-diddly-do — all set, neighbor!",
+    "tasks completed — couldn't be tidier, neighbor!",
+    "all squared away already — okely-dokely!",
+    "nothin' doin' here — all done, neighbor!",
+    "tasks completed — easy-peasy, neighborino!",
+    "all wrapped up already, neighbor — toodle-oo!",
+];
+exports.allTasksCompletedPool = [
+    "all tasks completed — okely-dokely-doo, neighbor!",
+    "all tasks completed — hi-diddly-done, neighbor!",
+    "every last task done-diddly-done, neighbor!",
+    "all tasks completed — that's a wrap, neighborino!",
+    "all tasks completed — mission accomplished-diddly!",
+    "all tasks done and dusted, neighbor — okely-dokely!",
+    "all tasks completed — nailed it-aroo, neighbor!",
+    "every task done-diddly-done — toodle-oo, neighbor!",
+    "all tasks completed — what a humdinger, neighbor!",
+    "all tasks completed — done and done, neighborino!",
+];
+exports.terminalPools = {
+    "Done": exports.successPool,
+    "Hard stop": exports.hardStopPool,
+    "Interrupted": exports.interruptionPool,
+    "Failed": exports.failurePool,
+};
+function pickVariant(pool, random, exclude) {
+    const candidates = exclude !== undefined && pool.length > 1
+        ? pool.filter(variant => variant !== exclude)
+        : pool;
+    const index = Math.floor(random.random() * candidates.length);
+    return candidates[index];
+}

package/lib/workspace/FlandersConfig.d.ts

@@ -16,12 +16,13 @@ type ReadArgs = Readonly<{
     projectRoot: string;
     homeDir: string;
 }>;
-type WriteArgs = Readonly<{
+type ScopedConfigArgs = ReadArgs & Readonly<{
     scope: "project" | "global";
-    projectRoot: string;
-    homeDir: string;
+}>;
+type WriteArgs = ScopedConfigArgs & Readonly<{
     config: FlandersConfig;
 }>;
 export declare function read(fs: FsContext, args: ReadArgs): Promise<FlandersConfig | null>;
+export declare function readScope(fs: FsContext, args: ScopedConfigArgs): Promise<FlandersConfig | null>;
 export declare function write(fs: FsContext, args: WriteArgs): Promise<string>;
 export {};

package/lib/workspace/FlandersConfig.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.read = read;
+exports.readScope = readScope;
 exports.write = write;
 const fsUtils_1 = require("../system/fsUtils");
 const CONFIG_PATH = ".flanders/config.json";
 const CONFIG_DIR = ".flanders";
+const ALLOWED_TOP_LEVEL_KEYS = ["worker", "reviewers", "minimumReviews"];
 function configPath(base) {
     return (0, fsUtils_1.joinPath)(base, CONFIG_PATH);
 }
@@ -42,6 +44,11 @@ function validate(raw, filePath) {
     if (typeof minimumReviews !== "number" || !Number.isInteger(minimumReviews) || minimumReviews < 1 || minimumReviews > reviewers.length) {
         throw new Error(`Malformed config at ${filePath}: field "minimumReviews" must be an integer in [1, ${reviewers.length}]`);
     }
+    for (const key of Object.keys(obj)) {
+        if (!ALLOWED_TOP_LEVEL_KEYS.includes(key)) {
+            throw new Error(`Malformed config at ${filePath}: unexpected top-level key "${key}"`);
+        }
+    }
     return raw;
 }
 function validateRole(role, name, filePath) {
@@ -85,6 +92,17 @@ async function read(fs, args) {
     }
     return null;
 }
+async function readScope(fs, args) {
+    const base = args.scope === "project" ? args.projectRoot : args.homeDir;
+    const target = configPath(base);
+    try {
+        const content = await fs.readFile(target);
+        return validate(JSON.parse(content), target);
+    }
+    catch {
+        return null;
+    }
+}
 async function write(fs, args) {
     const base = args.scope === "project" ? args.projectRoot : args.homeDir;
     const dir = configDir(base);

package/lib/workspace/Workspace.d.ts

@@ -4,6 +4,7 @@ export type WorkspacePaths = Readonly<{
     buildScript: string;
     testScript: string;
     errorLog: string;
+    specFile: string;
     prepLog(taskIndex: number): string;
     workerLog(iter: number): string;
     buildLog(iter: number): string;
@@ -11,6 +12,7 @@ export type WorkspacePaths = Readonly<{
     reviewerLog(iter: number): string;
     reviewerOutputLog(iter: number, reviewerIndex: number): string;
     reviewerErrorLog(reviewerIndex: number): string;
+    reviewerSpecFile(reviewerIndex: number): string;
 }>;
 export interface PlatformContext {
     isWindows(): boolean;

package/lib/workspace/Workspace.js

@@ -44,13 +44,15 @@ class Workspace {
             buildScript: (0, fsUtils_1.joinPath)(root, isWindows ? "build.bat" : "build.sh"),
             testScript: (0, fsUtils_1.joinPath)(root, isWindows ? "test.bat" : "test.sh"),
             errorLog: (0, fsUtils_1.joinPath)(root, "error.log"),
+            specFile: (0, fsUtils_1.joinPath)(root, "spec.md"),
             prepLog(taskIndex) { return (0, fsUtils_1.joinPath)(root, `prep.${taskIndex}.log`); },
             workerLog(iter) { return (0, fsUtils_1.joinPath)(root, `worker.${iter}.log`); },
             buildLog(iter) { return (0, fsUtils_1.joinPath)(root, `build.${iter}.log`); },
             testLog(iter) { return (0, fsUtils_1.joinPath)(root, `test.${iter}.log`); },
             reviewerLog(iter) { return (0, fsUtils_1.joinPath)(root, `reviewer.${iter}.log`); },
             reviewerOutputLog(iter, reviewerIndex) { return (0, fsUtils_1.joinPath)(root, `reviewer.${iter}.${reviewerIndex}.log`); },
-            reviewerErrorLog(reviewerIndex) { return (0, fsUtils_1.joinPath)(reviewerRoots[reviewerIndex - 1], "error.log"); }
+            reviewerErrorLog(reviewerIndex) { return (0, fsUtils_1.joinPath)(reviewerRoots[reviewerIndex - 1], "error.log"); },
+            reviewerSpecFile(reviewerIndex) { return (0, fsUtils_1.joinPath)(reviewerRoots[reviewerIndex - 1], "spec.md"); }
         };
     }
     async errorLogExists() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flanders",
-  "version": "0.6.1",
+  "version": "0.8.0",
   "description": "Flanders never breaks a rule",
   "main": "lib/",
   "types": "lib/types",