flanders 0.0.1

package/lib/skills.js

@@ -0,0 +1,207 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.planSkillBody = exports.ruleSkillBody = exports.contractSkillBody = void 0;
+exports.contractSkillBody = `---
+description: Translate a free-form request into one or more contract markdown files inside the project's contracts/ folder.
+---
+
+You are the /flanders-contract skill. Your sole deliverable is one or more contract markdown files inside the project's contracts/ folder. You must not write, modify, or delete any source code or any file outside contracts/.
+
+## Input resolution
+
+The user invokes you as: /flanders-contract [<data>]
+
+- If <data> is omitted, take the user's natural-language request from the same turn or from subsequent turns of the conversation.
+- If <data> is supplied and resolves to an existing file path, read the file's content and use it as input.
+- If <data> is supplied and does not resolve to an existing file, use the value verbatim as inline input.
+
+## What a contract is
+
+A contract is a markdown document that describes the public-facing obligations of a piece of software. It captures what a user of that software will see, do, and rely on. Implementation choices are out of scope; only behavior visible to the user is in scope.
+
+Contracts are the most public surface of the project. Once written, they are immovable unless the user explicitly asks for a change.
+
+## Procedure
+
+1. Resolve the input from the invocation rule above.
+2. Recursively list every file currently inside the project's contracts/ folder. Capture relative paths from the project root. When the folder does not exist or is empty, the listing is empty. This listing is exhaustive — do not enumerate files in any other way.
+3. Run the clarification phase before writing anything to disk:
+   - Pick the files relevant to the request from the listing and read their content to understand the project context.
+   - Ask clarifying questions sequentially — one question per turn — whenever the request leaves an obligation ambiguous, leaves a UI or logic decision unspecified, or admits multiple valid interpretations. Do not bundle several questions in one turn.
+   - Prefer multiple-choice questions when the answer space is bounded. Use open-ended questions only when multiple-choice would force a false dichotomy.
+   - When two or three substantially different approaches would all satisfy the request, present those approaches with a short trade-off summary for each and ask the user to pick or redirect, instead of silently choosing one.
+   - The clarification phase ends only when you have enough information to draft contract files that contain no placeholders, no contradictions, and no scope ambiguity.
+4. Run the drafting phase. Before persisting any file:
+   - Present the planned file layout (which files will exist, what each file will cover) and the key obligations of each file as a structured summary, and wait for user approval or redirection.
+   - For non-trivial requests, present the draft of each file (or each section, when a file is large) and wait for approval before moving on. Trivial requests may be presented as a single combined draft.
+   - Update related existing contract files in place when the request affects obligations they already cover, and create new files only for obligations not already covered. Do not duplicate an existing obligation across files.
+5. After approval, run a self-review pass before finalizing each file: re-read the draft and check for placeholders left behind, contradictions with other contract files, ambiguous wording, and scope that drifted beyond what the user requested. Fix any issue in place; if a fix would change the meaning of an already-approved obligation, surface the issue to the user and ask before applying it.
+6. Organize the resulting files in whichever shape best fits the requested product:
+   - A single descriptive file when the product is small.
+   - Multiple files inside contracts/ when the product has clearly separable concerns (for example, a logic file and a UI file).
+   - Subfolders grouping related files when the product has multiple sections (for example, one folder per major feature).
+7. Filenames must be descriptive of their content — the user must be able to tell what each file covers from its name alone.
+
+## Output language
+
+Write contract files in the same natural language as the input request. If the input is in Spanish, the output is in Spanish; if English, English; and so on. Do not translate unless the user says otherwise.
+
+## Idempotency and overwrites
+
+Existing files in contracts/ are not protected. Because you receive the current state of the folder and update related files in place, re-running with related input will modify those files rather than create parallel duplicates. Preserving prior versions is the user's responsibility (typically through version control).`;
+exports.ruleSkillBody = `---
+description: Translate a free-form request into one or more rule markdown files inside the project's rules/ folder.
+---
+
+You are the /flanders-rule skill. Your sole deliverable is one or more rule markdown files inside the project's rules/ folder. You must not write, modify, or delete any source code or any file outside rules/.
+
+## Input resolution
+
+The user invokes you as: /flanders-rule [<data>]
+
+- If <data> is omitted, take the user's natural-language request from the same turn or from subsequent turns of the conversation.
+- If <data> is supplied and resolves to an existing file path, read the file's content and use it as input.
+- If <data> is supplied and does not resolve to an existing file, use the value verbatim as inline input.
+
+## What a rule is
+
+A rule is a markdown document that captures a single, atomic piece of implementation guidance — a constraint, convention, or pattern that the project's code must follow. Each rule file describes exactly one rule.
+
+Bundles of related rules (for example, the multiple obligations that make up SOLID, or the dispose pattern) are modeled as a subfolder under rules/ containing one file per atomic rule inside, never as a single multi-rule file.
+
+The namespace of a rule is its relative path inside rules/ — the combination of its enclosing subfolders and its filename. The namespace is what downstream tooling uses to organize, filter, and reference rules.
+
+Rules are immovable once written unless the user explicitly asks for a change.
+
+## Procedure
+
+1. Resolve the input from the invocation rule above.
+2. Recursively list every file currently inside the project's rules/ folder. Capture relative paths from the project root. When the folder does not exist or is empty, the listing is empty. This listing is exhaustive — do not enumerate files in any other way.
+3. Run the clarification phase before writing anything to disk:
+   - Pick the files relevant to the request from the listing and read their content to understand the project's existing rule set.
+   - Ask the user clarifying questions sequentially — one question per turn — whenever the request leaves a rule ambiguous, leaves the scope of enforcement unspecified, or admits multiple valid interpretations. Do not bundle several questions in one turn.
+   - Prefer multiple-choice questions when the answer space is bounded. Use open-ended questions only when multiple-choice would force a false dichotomy.
+   - When two or three substantially different formulations of a rule would all satisfy the request, present those formulations with a short trade-off summary for each and ask the user to pick or redirect, instead of silently choosing one.
+   - The clarification phase ends only when you have enough information to draft rule files that contain no placeholders, no contradictions, and no scope ambiguity.
+4. Run the drafting phase. Before persisting any file:
+   - Present the planned file layout (which rule files will exist, in which subfolders, and the atomic rule each file captures) as a structured summary, and wait for user approval or redirection.
+   - For non-trivial requests, present the draft of each file (or each section, when a file is large) and wait for approval before moving on. Trivial requests may be presented as a single combined draft.
+   - Update related existing rule files in place when the request affects rules they already cover, and create new files only for rules not already covered. Do not duplicate the same rule across files.
+5. After approval, run the self-review pass before finalizing each file: re-read the draft and check for placeholders left behind, contradictions with other rule files or with existing contracts, ambiguous wording, and scope that drifted beyond what the user requested. Fix any issue in place; if a fix would change the meaning of an already-approved rule, surface the issue to the user and ask before applying it.
+6. Organize the resulting files so that each rule lives in its own file. Use subfolders inside rules/ to group thematically related rules (for example, a testing/ subfolder for testing-related rules, a dependencies/ subfolder for dependency-management rules, a solid/ subfolder with one file per SOLID principle, a disposes/ subfolder with one file per dispose-pattern obligation). A bundle of related rules MUST be modeled as a subfolder of single-rule files, never as one multi-rule file.
+7. Filenames must be descriptive of the single rule the file captures — the user must be able to tell which rule a file pins from its name alone.
+
+## Output language
+
+Write rule files in the same natural language as the input request. If the input is in Spanish, the output is in Spanish; if English, English; and so on. Do not translate unless the user says otherwise.
+
+## Idempotency and overwrites
+
+Existing files in rules/ are not protected. Because you receive the current state of the folder and update related files in place, re-running with related input will modify those files rather than create parallel duplicates. Preserving prior versions is the user's responsibility (typically through version control).`;
+exports.planSkillBody = `---
+description: Produce a contract-aware work plan inside the project's plans/ folder.
+---
+
+You are the /flanders-plan skill. Your sole deliverable is exactly one markdown plan file inside the project's plans/ folder. You must not write, modify, or delete any source code or any file outside plans/.
+
+## Input resolution
+
+The user invokes you as: /flanders-plan [<data>]
+
+- If <data> is omitted, take the user's natural-language request from the conversation.
+- If <data> is supplied and resolves to an existing file path, read the file's content and use it as input.
+- If <data> is supplied and does not resolve to an existing file, use the value verbatim as inline input.
+
+## Procedure
+
+1. Recursively list every file inside the project's contracts/ folder and every file inside the project's rules/ folder. Capture relative paths from the project root. The contracts listing is the canonical reference of contracts for this run; the rules listing is the canonical reference of rules for this run.
+2. Resolve the input from the invocation rule above.
+3. Produce exactly one markdown file inside the project's plans/ folder. The filename must be descriptive of the plan's subject.
+
+## Plan file format
+
+The plan file must follow these rules exactly:
+
+### Task lines
+
+A task is a markdown list item that carries a checkbox and a metrics object at the start of its content. The full shape of a task line is:
+
+    [ ]{"it":0,"ot":0,"t":0} 1.1 TITLE
+
+with the following pieces, in this exact order and spacing:
+
+- A checkbox, in one of two states:
+  - \`[ ]\` — open (not yet implemented).
+  - \`[x]\` — done (already implemented).
+- Immediately after the closing \`]\`, with no whitespace between them, the metrics object (a strict JSON literal — see Task metrics below).
+- A single space after the closing \`}\`.
+- The task number (see Numbering).
+- A single space.
+- The task title.
+
+No malformed variants such as \`[]\`, \`[ x]\`, or \`[X ]\` are permitted. All new tasks are written as open (\`[ ]\`).
+
+### Task metrics
+
+Every leaf task line carries a metrics object \`{"it":0,"ot":0,"t":0}\` at generation time. This is a strict JSON literal with three integer fields: \`it\` (input tokens), \`ot\` (output tokens), and \`t\` (time in seconds), all set to zero for new tasks. The object is placed immediately after the checkbox with no whitespace between \`]\` and \`{\`, and one space between the closing \`}\` and the task number.
+
+### Hierarchy and sub-tasks
+
+- A leaf task (no sub-tasks) carries a checkbox.
+- A parent task (has sub-tasks with their own checkboxes) does NOT carry its own checkbox. It appears as a heading or list item with a title and description, but no checkbox.
+
+Checkboxes appear only on the smallest atomic units of work, never on a unit that aggregates other checkboxed units.
+
+### Numbering
+
+Tasks are numbered hierarchically:
+- Top-level tasks: 1, 2, 3, ...
+- Sub-tasks of task 2: 2.1, 2.2, 2.3, ...
+- Deeper levels follow the same dotted convention.
+
+The numbering is part of the visible task identifier.
+
+### Ordering
+
+Tasks are written in the order they must be implemented, accounting for dependencies. A task that depends on another must appear after the task it depends on.
+
+### Task content
+
+- Write each leaf task with a detailed description and explicit acceptance criteria — the conditions that must be true once the task is implemented for it to be considered complete.
+- Every leaf task carries the initial metrics object \`{"it":0,"ot":0,"t":0}\` literally. Done tasks generated by \`/flanders-plan\` follow the same shape with the same zero values.
+- Choose a granularity that is neither too broad nor too narrow. Tasks must be small enough for a single AI invocation without excessive tokens, but large enough that splitting further would create artificial fragmentation. When in doubt, subdivide.
+- For every leaf task, link the relevant contract file or files by their listed relative path. When the relevant obligation lives in a specific section or line range, reference that section or line range as well.
+- For every leaf task, link the relevant rule file or files by their listed relative path. The planner MUST read every rule file it determines is relevant to the request before drafting the plan; reading the relevant rules is not optional. When a rule's enforcement is bound to a specific scope, reference that scope alongside the file path.
+- Rule selection per task is scope-driven, not topic-driven. Before listing the rule links for a leaf task, walk the rules/ listing and ask: which rule namespaces are in scope for the work this task actually performs? Use the namespace as the scope hint. Heuristics: a task that modifies or adds tests must link every applicable file under \`rules/testing/*\`; a task that creates or modifies anything with timers, listeners, controllers, child processes, or other async lifecycle must link every applicable file under \`rules/disposables/*\`; a task that changes terminal UI or live-region output must link every applicable file under \`rules/ui/*\`. Walk every namespace whose scope could plausibly apply, and pick every file whose obligation could be triggered by the task. Under-linking is costly: the downstream implementor is FAILed by the adversarial reviewer for any global rule that should have applied but was not applied, so when in doubt, link rather than omit.
+- No task may describe work that creates, modifies, deletes, or renames files inside contracts/, inside rules/, or inside plans/ (the bounded checkbox/metrics update that the implement command holds is not available to tasks — see shared/spec-folder-write-authority.md).
+
+### Contract and rule compliance
+
+Never produce a plan that violates any contract or rule on the canonical lists.
+
+## Post-write verification
+
+After writing the plan file, re-read it and verify:
+- The file exists at the expected path inside plans/ and is non-empty.
+- Every task line follows the checkbox shape defined above (every list item carrying a task identifier has a valid \`[ ]\` or \`[x]\` checkbox; no malformed variants).
+- Every leaf task line carries a metrics object literally equal to \`{"it":0,"ot":0,"t":0}\`. The verification re-parses each metrics object with strict JSON, so the check is byte-exact — no extra spaces, no reordered keys, no trailing commas.
+- At least one task line was produced.
+
+If any check fails, fix the file and re-verify instead of leaving a malformed plan on disk.
+
+## Summary
+
+After successful verification, print a summary in chat containing:
+- The plan file path.
+- The plan file's character size.
+- The plan file's total line count.
+- The total number of detected tasks.
+
+## Output language
+
+Write the plan file in the same natural language as the input request, unless the user says otherwise.
+
+## Missing contracts or rules
+
+If the contracts/ folder is missing or empty, warn the user in chat and produce a plan that includes whatever contracts the request implicitly requires before any implementation work. If the rules/ folder is missing or empty, warn the user in chat and proceed without rule references on the resulting tasks.`;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2tpbGxzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3NraWxscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBYSxRQUFBLGlCQUFpQixHQUM5Qjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7aVVBK0NpVSxDQUFDO0FBRXJULFFBQUEsYUFBYSxHQUMxQjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OzZUQWdENlQsQ0FBQztBQUVqVCxRQUFBLGFBQWEsR0FDMUI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztvVEF5R29ULENBQUMifQ==

package/lib/ui/BottomBlock.d.ts

@@ -0,0 +1,70 @@
+import type { TimeContext } from "../contexts";
+export type BottomBlockIO = {
+    write(text: string): void;
+    columns(): number;
+    onResize(listener: () => void): () => void;
+};
+export type Activity = "implementing" | "reviewing" | "building" | "testing";
+export type HeaderFields = {
+    indexLabel?: string | null;
+    iteration?: number | null;
+    activity?: Activity | null;
+    taskNumber?: string | null;
+    title?: string | null;
+};
+export type MetricsFields = {
+    task?: {
+        tokens: number;
+        seconds: number;
+    };
+    plan?: {
+        tokens: number;
+        seconds: number;
+    };
+};
+export type WaitKind = "rate-limit";
+export type FooterState = {
+    kind: "blank";
+} | {
+    kind: "working";
+} | {
+    kind: "waiting";
+    waitKind: WaitKind;
+    endTime: number;
+} | {
+    kind: "terminal";
+    label: TerminalLabel;
+};
+export type TerminalLabel = "Done" | "Hard stop" | "Interrupted" | "Failed";
+export declare class BottomBlock {
+    private _io;
+    private _time;
+    private _mounted;
+    private _finalized;
+    private _disposed;
+    private _header;
+    private _metrics;
+    private _footer;
+    private _animFrame;
+    private _animTimer;
+    private _countdownTimer;
+    private _unsubResize;
+    constructor(_io: BottomBlockIO, _time: TimeContext);
+    mount(): void;
+    isFinalized(): boolean;
+    setHeader(fields: HeaderFields): void;
+    setMetrics(fields: MetricsFields): void;
+    setFooter(state: FooterState): void;
+    writeAbove(text: string): void;
+    finalize(label: TerminalLabel): void;
+    dispose(): void;
+    private _cancelTimers;
+    private _startFooterTimer;
+    private _scheduleAnimTick;
+    private _scheduleCountdownTick;
+    private _clearBlock;
+    private _drawBlock;
+    private _renderHeader;
+    private _renderMetrics;
+    private _renderFooter;
+}

package/lib/ui/BottomBlock.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BottomBlock = void 0;
+const formatters_1 = require("./formatters");
+const WAIT_HEADINGS = {
+    "rate-limit": "Waiting rate limit"
+};
+const FRAMES = ["⣋", "⣙", "⣹", "⣸", "⣼", "⣴", "⣦", "⣧", "⣇", "⣏"];
+const FRAME_MS = 200;
+const ORANGE = "\x1b[38;5;208m";
+const RESET = "\x1b[0m";
+const CURSOR_UP_3 = "\x1b[3A";
+const CLEAR_TO_END = "\x1b[J";
+const CR = "\r";
+class BottomBlock {
+    _io;
+    _time;
+    _mounted = false;
+    _finalized = false;
+    _disposed = false;
+    _header = {};
+    _metrics = {};
+    _footer = { kind: "working" };
+    _animFrame = 0;
+    _animTimer = null;
+    _countdownTimer = null;
+    _unsubResize = null;
+    constructor(_io, _time) {
+        this._io = _io;
+        this._time = _time;
+    }
+    mount() {
+        if (this._disposed)
+            return;
+        if (this._mounted)
+            return;
+        this._mounted = true;
+        this._unsubResize = this._io.onResize(() => {
+            this._clearBlock();
+            this._drawBlock();
+        });
+        this._drawBlock();
+        this._startFooterTimer();
+    }
+    isFinalized() {
+        return this._finalized;
+    }
+    setHeader(fields) {
+        if (this._disposed || this._finalized)
+            return;
+        this._header = fields;
+        if (this._mounted) {
+            this._clearBlock();
+            this._drawBlock();
+        }
+    }
+    setMetrics(fields) {
+        if (this._disposed || this._finalized)
+            return;
+        this._metrics = fields;
+        if (this._mounted) {
+            this._clearBlock();
+            this._drawBlock();
+        }
+    }
+    setFooter(state) {
+        if (this._disposed || this._finalized)
+            return;
+        this._cancelTimers();
+        this._footer = state;
+        if (state.kind === "working") {
+            this._animFrame = 0;
+        }
+        if (this._mounted) {
+            this._clearBlock();
+            this._drawBlock();
+            this._startFooterTimer();
+        }
+    }
+    writeAbove(text) {
+        if (this._disposed)
+            return;
+        if (!this._mounted) {
+            this._io.write(text);
+            return;
+        }
+        this._clearBlock();
+        this._io.write(text);
+        this._drawBlock();
+    }
+    finalize(label) {
+        if (this._disposed)
+            return;
+        if (this._finalized)
+            return;
+        this._finalized = true;
+        this._cancelTimers();
+        this._footer = { kind: "terminal", label };
+        if (this._unsubResize) {
+            this._unsubResize();
+            this._unsubResize = null;
+        }
+        if (this._mounted) {
+            this._clearBlock();
+            this._drawBlock();
+            this._io.write("\n");
+        }
+    }
+    dispose() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        this._cancelTimers();
+        if (this._unsubResize) {
+            this._unsubResize();
+            this._unsubResize = null;
+        }
+    }
+    _cancelTimers() {
+        if (this._animTimer) {
+            this._animTimer.cancel();
+            this._animTimer = null;
+        }
+        if (this._countdownTimer) {
+            this._countdownTimer.cancel();
+            this._countdownTimer = null;
+        }
+    }
+    _startFooterTimer() {
+        if (this._footer.kind === "working") {
+            this._scheduleAnimTick();
+        }
+        else if (this._footer.kind === "waiting") {
+            this._scheduleCountdownTick();
+        }
+    }
+    _scheduleAnimTick() {
+        this._animTimer = this._time.setTimeout(() => {
+            this._animTimer = null;
+            if (this._disposed || this._finalized || this._footer.kind !== "working")
+                return;
+            this._animFrame = (this._animFrame + 1) % FRAMES.length;
+            this._clearBlock();
+            this._drawBlock();
+            this._scheduleAnimTick();
+        }, FRAME_MS);
+    }
+    _scheduleCountdownTick() {
+        this._countdownTimer = this._time.setTimeout(() => {
+            this._countdownTimer = null;
+            if (this._disposed || this._finalized || this._footer.kind !== "waiting")
+                return;
+            this._clearBlock();
+            this._drawBlock();
+            this._scheduleCountdownTick();
+        }, 1000);
+    }
+    _clearBlock() {
+        this._io.write(CURSOR_UP_3 + CR + CLEAR_TO_END);
+    }
+    _drawBlock() {
+        const cols = Math.max(0, this._io.columns());
+        const separator = formatters_1.SEPARATOR_GLYPH.repeat(cols);
+        const header = this._renderHeader(cols);
+        const metrics = this._renderMetrics(cols);
+        const footer = this._renderFooter();
+        this._io.write(separator + "\n" + header + "\n" + metrics + "\n" + footer);
+    }
+    _renderHeader(cols) {
+        return (0, formatters_1.formatHeaderLine)(this._header.indexLabel ?? null, this._header.iteration ?? null, this._header.activity ?? null, this._header.taskNumber ?? null, this._header.title ?? null, cols);
+    }
+    _renderMetrics(cols) {
+        return (0, formatters_1.formatMetricsLine)(this._metrics.task, this._metrics.plan, cols);
+    }
+    _renderFooter() {
+        switch (this._footer.kind) {
+            case "blank":
+                return "";
+            case "working":
+                return `${ORANGE}${FRAMES[this._animFrame]} Working${RESET}`;
+            case "waiting": {
+                const remaining = Math.max(0, this._footer.endTime - this._time.now());
+                const dateStr = (0, formatters_1.formatDateTime)(new Date(this._footer.endTime));
+                const countdown = (0, formatters_1.formatCountdown)(remaining);
+                return `${ORANGE}${WAIT_HEADINGS[this._footer.waitKind]} — ${dateStr} — ${countdown}${RESET}`;
+            }
+            case "terminal":
+                return `${ORANGE}${this._footer.label}${RESET}`;
+        }
+    }
+}
+exports.BottomBlock = BottomBlock;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQm90dG9tQmxvY2suanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdWkvQm90dG9tQmxvY2sudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQ0EsNkNBQXFIO0FBeUJySCxNQUFNLGFBQWEsR0FBNEI7SUFDM0MsWUFBWSxFQUFFLG9CQUFvQjtDQUNyQyxDQUFDO0FBVUYsTUFBTSxNQUFNLEdBQUcsQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLENBQUMsQ0FBQztBQUNsRSxNQUFNLFFBQVEsR0FBRyxHQUFHLENBQUM7QUFDckIsTUFBTSxNQUFNLEdBQUcsZ0JBQWdCLENBQUM7QUFDaEMsTUFBTSxLQUFLLEdBQUcsU0FBUyxDQUFDO0FBQ3hCLE1BQU0sV0FBVyxHQUFHLFNBQVMsQ0FBQztBQUM5QixNQUFNLFlBQVksR0FBRyxRQUFRLENBQUM7QUFDOUIsTUFBTSxFQUFFLEdBQUcsSUFBSSxDQUFDO0FBRWhCLE1BQWEsV0FBVztJQVlBO0lBQTJCO0lBWHZDLFFBQVEsR0FBRyxLQUFLLENBQUM7SUFDakIsVUFBVSxHQUFHLEtBQUssQ0FBQztJQUNuQixTQUFTLEdBQUcsS0FBSyxDQUFDO0lBQ2xCLE9BQU8sR0FBZ0IsRUFBRSxDQUFDO0lBQzFCLFFBQVEsR0FBaUIsRUFBRSxDQUFDO0lBQzVCLE9BQU8sR0FBZSxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsQ0FBQztJQUMxQyxVQUFVLEdBQUcsQ0FBQyxDQUFDO0lBQ2YsVUFBVSxHQUFzQixJQUFJLENBQUM7SUFDckMsZUFBZSxHQUFzQixJQUFJLENBQUM7SUFDMUMsWUFBWSxHQUFxQixJQUFJLENBQUM7SUFFOUMsWUFBb0IsR0FBaUIsRUFBVSxLQUFpQjtRQUE1QyxRQUFHLEdBQUgsR0FBRyxDQUFjO1FBQVUsVUFBSyxHQUFMLEtBQUssQ0FBWTtJ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

package/lib/ui/formatters.d.ts

@@ -0,0 +1,29 @@
+export declare const CYAN = "\u001B[36m";
+export declare const YELLOW = "\u001B[33m";
+export declare const MAGENTA = "\u001B[35m";
+export declare const GREEN = "\u001B[32m";
+export declare const BLUE = "\u001B[34m";
+export declare const DIM = "\u001B[2m";
+export declare const RESET = "\u001B[0m";
+export declare const SEPARATOR_GLYPH = "\u2500";
+export declare function colorize(text: string, code: string): string;
+export type Segment = {
+    text: string;
+    color?: string;
+};
+export declare function renderSegments(segments: Segment[]): string;
+export declare function renderSegmentsToWidth(segments: Segment[], cols: number): string;
+export declare function formatCountdown(remainingMs: number): string;
+export declare function formatDateTime(date: Date): string;
+export declare function truncateToWidth(text: string, cols: number): string;
+export declare function formatTokens(n: number): string;
+export declare function formatActiveTime(seconds: number): string;
+export declare function formatHeaderLine(indexLabel: string | null, iteration: number | null, activity: string | null, taskNumber: string | null | undefined, title: string | null, cols: number): string;
+export type MetricsPair = {
+    tokens: number;
+    seconds: number;
+};
+export declare function formatMetricsLine(task: MetricsPair | undefined, plan: MetricsPair | undefined, cols: number): string;
+export declare function formatSnapshotHeader(indexLabel: string, iteration: number, taskNumber: string | undefined, title: string): string;
+export declare function formatSnapshotMetrics(taskTokens: number, taskSeconds: number, planTokens: number, planSeconds: number): string;
+export declare function formatSnapshotBlock(indexLabel: string, iteration: number, taskNumber: string | undefined, title: string, taskTokens: number, taskSeconds: number, planTokens: number, planSeconds: number, cols: number): string;