@aiwayds/dsh-tui-pi 0.1.0

package/lib/welcome.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Startup welcome banner: a pixel-art whale (generated pixel-by-pixel from
+ * the user's image) with the "DSH" wordmark to its right, drawn in the same
+ * pixel language as the whale. Each letter is a hand-authored 20×20 pixel
+ * bitmap (PIXEL_FONT: 20 columns × 20 half-cell rows, '#' a pixel, '.'
+ * empty) — an upright glyph sheared into an arcade italic: every 4 pixel
+ * rows the stroke shifts 1 pixel right, so the top leans 4 pixels —
+ * rendered to the terminal with the whale's own half-block mapping
+ * (top and bottom pixel → '█', top only → '▀', bottom only → '▄', neither
+ * → ' '), so the letters show the same visible pixel grid: 3-pixel strokes,
+ * and D's bowl and S's spine step diagonally in 2-pixel staircase corners
+ * instead of meeting at square rectangle corners.
+ *
+ * The banner is a 94-column × 10-row grid: 28 columns of whale art, a
+ * 2-column gap, then the wordmark — D (20) + 2 + S (20) + 2 + H (20) =
+ * 64 columns of letters (each letter spans 20 columns — slimmer than the
+ * whale's body mass). Below 96 terminal columns the wordmark is
+ * dropped — the banner degrades to the 10 whale rows (28 columns each, no
+ * gap, no letters), so a narrow terminal never wraps the letter rows; the
+ * full banner comes back as soon as the terminal is 96 columns or wider
+ * again (the transcript rebuilds on resize). Everything is painted in the
+ * whale brand blue. Transparent cells stay unpainted — they show the
+ * terminal default background. This is deliberate: the transcript never
+ * paints a canvas background (the TUI startup already sets the terminal
+ * background to the theme canvas), so a half-block's transparent half must
+ * fall through to the terminal default, not to an explicit theme
+ * background. Painting it would mismatch on any terminal whose default
+ * background differs from the theme canvas.
+ */
+/** The whale color — the same brand blue as the powerline 'dsh' segment. */
+export declare const WHALE_COLOR: "#4D6BFE";
+/**
+ * Whale pixel art, 28 columns × 10 rows, generated pixel-by-pixel from the
+ * user's image (regenerate with `node assets/whale-gen.mjs`; see
+ * assets/whale-gen.mjs). Only ' ', '█', '▀' and '▄' appear (see the glyph
+ * semantics above). Every row carries at least one whale glyph, so the
+ * banner text as a whole is never blank — Text.render only skips an
+ * entirely blank text, and individual blank rows would render as empty
+ * lines either way.
+ */
+export declare const WHALE_ART: readonly string[];
+/** The wordmark: D S H, each letter a 28-column glyph, spaced 2 columns apart. */
+export declare const WORDMARK = "DSH";
+/**
+ * Pixel font for the wordmark letters: '#' is a pixel, '.' is empty. Each
+ * glyph is a hand-authored 20×20 pixel bitmap: an upright body (16 pixels
+ * wide, 17 for D's bowl) with 3-pixel strokes and 2-pixel staircase
+ * corners, sheared italic — every 4 pixel rows shift 1 pixel right (the
+ * top block leans 4 pixels, ~14°) — so every stroke's edge is a pixel
+ * staircase and each letter spans exactly 20 columns, slimmer than the
+ * whale's body (21–24). renderPixelGlyph folds every two pixel
+ * rows into one terminal row of '█'/'▀'/'▄'/' ' — the exact mapping the
+ * whale generator uses — so the letters and the whale share one pixel
+ * grid. Strokes render in the whale brand blue; empties fall through to
+ * the terminal default background like the whale's spaces.
+ */
+export declare const PIXEL_FONT: Record<string, readonly string[]>;
+/**
+ * Full banner width: whale + gap + wordmark block — derived from the
+ * constants so a layout tweak (gap, glyph widths) cannot silently desync
+ * the degradation threshold in `buildWelcomeBanner` from the assembled
+ * rows: 28 + 2 + 20 + 2 + 20 + 2 + 20 = 94 columns.
+ */
+export declare const WELCOME_FULL_WIDTH: number;
+/**
+ * Fold a 20×20 pixel bitmap into its 10 terminal rows with the whale's own
+ * half-block mapping: both pixel rows on → '█', top only → '▀', bottom
+ * only → '▄', neither → ' '. Two pixels vertically per cell is what makes
+ * the pixels square on screen — one column wide, one half-cell tall — the
+ * same grid the whale art lives on.
+ */
+export declare function renderPixelGlyph(px: readonly string[]): readonly string[];
+/**
+ * Assemble the welcome banner text. Every row is the styled whale row, the
+ * 2-column gap, then the 88-column pixel-letter row (letters 2 columns
+ * apart) — all painted in the whale brand blue. The banner is
+ * theme-independent: no theme colors, no bold, nothing to repaint on a
+ * theme switch.
+ *
+ * Width floor: the full banner is 94 columns wide plus the transcript
+ * Text's 1-column left/right padding (the renderer passes its Text paddingX
+ * — currently 1 — so the threshold is 96). Below it the banner degrades
+ * to the whale alone: the 10 art rows, 28 columns each, no gap and no
+ * letters, which needs only 30 columns with the padding. A terminal
+ * narrower than that wraps the whale rows onto extra lines (accepted
+ * degradation, documented rather than clipped, because a terminal that
+ * narrow can't show the whale either way). `undefined` (non-TTY contexts,
+ * e.g. tests) counts as wide — the full banner, conservative like
+ * PANEL_LINE_CAP_FALLBACK.
+ */
+export declare function buildWelcomeBanner(columns: number | undefined): string;

package/lib/welcome.js

@@ -0,0 +1,281 @@
+/**
+ * Startup welcome banner: a pixel-art whale (generated pixel-by-pixel from
+ * the user's image) with the "DSH" wordmark to its right, drawn in the same
+ * pixel language as the whale. Each letter is a hand-authored 20×20 pixel
+ * bitmap (PIXEL_FONT: 20 columns × 20 half-cell rows, '#' a pixel, '.'
+ * empty) — an upright glyph sheared into an arcade italic: every 4 pixel
+ * rows the stroke shifts 1 pixel right, so the top leans 4 pixels —
+ * rendered to the terminal with the whale's own half-block mapping
+ * (top and bottom pixel → '█', top only → '▀', bottom only → '▄', neither
+ * → ' '), so the letters show the same visible pixel grid: 3-pixel strokes,
+ * and D's bowl and S's spine step diagonally in 2-pixel staircase corners
+ * instead of meeting at square rectangle corners.
+ *
+ * The banner is a 94-column × 10-row grid: 28 columns of whale art, a
+ * 2-column gap, then the wordmark — D (20) + 2 + S (20) + 2 + H (20) =
+ * 64 columns of letters (each letter spans 20 columns — slimmer than the
+ * whale's body mass). Below 96 terminal columns the wordmark is
+ * dropped — the banner degrades to the 10 whale rows (28 columns each, no
+ * gap, no letters), so a narrow terminal never wraps the letter rows; the
+ * full banner comes back as soon as the terminal is 96 columns or wider
+ * again (the transcript rebuilds on resize). Everything is painted in the
+ * whale brand blue. Transparent cells stay unpainted — they show the
+ * terminal default background. This is deliberate: the transcript never
+ * paints a canvas background (the TUI startup already sets the terminal
+ * background to the theme canvas), so a half-block's transparent half must
+ * fall through to the terminal default, not to an explicit theme
+ * background. Painting it would mismatch on any terminal whose default
+ * background differs from the theme canvas.
+ */
+import { ansiFg, POWERLINE, RESET } from "./theme/index.js";
+/** The whale color — the same brand blue as the powerline 'dsh' segment. */
+export const WHALE_COLOR = POWERLINE.brand;
+/**
+ * Whale pixel art, 28 columns × 10 rows, generated pixel-by-pixel from the
+ * user's image (regenerate with `node assets/whale-gen.mjs`; see
+ * assets/whale-gen.mjs). Only ' ', '█', '▀' and '▄' appear (see the glyph
+ * semantics above). Every row carries at least one whale glyph, so the
+ * banner text as a whole is never blank — Text.render only skips an
+ * entirely blank text, and individual blank rows would render as empty
+ * lines either way.
+ */
+export const WHALE_ART = [
+    '           ▄▄▄▄    █        ',
+    '   ▄██████████▄   ████ ▄▄▄█▀',
+    ' ▄██████████████▄  ████████ ',
+    ' ██▀▀█████████████▄ ▄██▀▀   ',
+    '██      ▀▀█████▄▀██████     ',
+    '▀██        ▀████▄ ████▀     ',
+    ' ███        ▀████████▀      ',
+    '  ▀██▄   █▄▄  ▀█████▀       ',
+    '   ▀▀███▄▄███▄▄▄█████▄      ',
+    '      ▀▀▀████▀▀▀            ',
+];
+/** Blank columns between the whale and the wordmark column. */
+const WHALE_TITLE_GAP = 2;
+/** Blank columns between the wordmark's letters. */
+const LETTER_GAP = 2;
+/** The wordmark: D S H, each letter a 28-column glyph, spaced 2 columns apart. */
+export const WORDMARK = 'DSH';
+/** Whale art width in columns (every row is this wide). */
+const WHALE_ART_WIDTH = Math.max(...WHALE_ART.map(row => row.length));
+/**
+ * Pixel font for the wordmark letters: '#' is a pixel, '.' is empty. Each
+ * glyph is a hand-authored 20×20 pixel bitmap: an upright body (16 pixels
+ * wide, 17 for D's bowl) with 3-pixel strokes and 2-pixel staircase
+ * corners, sheared italic — every 4 pixel rows shift 1 pixel right (the
+ * top block leans 4 pixels, ~14°) — so every stroke's edge is a pixel
+ * staircase and each letter spans exactly 20 columns, slimmer than the
+ * whale's body (21–24). renderPixelGlyph folds every two pixel
+ * rows into one terminal row of '█'/'▀'/'▄'/' ' — the exact mapping the
+ * whale generator uses — so the letters and the whale share one pixel
+ * grid. Strokes render in the whale brand blue; empties fall through to
+ * the terminal default background like the whale's spaces.
+ */
+export const PIXEL_FONT = {
+    D: [
+        '....#############...',
+        '....#############...',
+        '....#############...',
+        '....###.........###.',
+        '...###.........###..',
+        '...###...........###',
+        '...###...........###',
+        '...###...........###',
+        '..###...........###.',
+        '..###...........###.',
+        '..###...........###.',
+        '..###...........###.',
+        '.###...........###..',
+        '.###...........###..',
+        '.###...........###..',
+        '.###.........###....',
+        '###.........###.....',
+        '#############.......',
+        '#############.......',
+        '#############.......',
+    ],
+    S: [
+        '.......#############',
+        '.......#############',
+        '.......#############',
+        '....###.............',
+        '...###..............',
+        '...###..............',
+        '...###..............',
+        '...#############....',
+        '..#############.....',
+        '..#############.....',
+        '..#############.....',
+        '...............###..',
+        '..............###...',
+        '..............###...',
+        '..............###...',
+        '..............###...',
+        '.............###....',
+        '############........',
+        '############........',
+        '############........',
+    ],
+    H: [
+        '....###..........###',
+        '....###..........###',
+        '....###..........###',
+        '....###..........###',
+        '...###..........###.',
+        '...###..........###.',
+        '...###..........###.',
+        '...###..........###.',
+        '..################..',
+        '..################..',
+        '..################..',
+        '..################..',
+        '.###..........###...',
+        '.###..........###...',
+        '.###..........###...',
+        '.###..........###...',
+        '###..........###....',
+        '###..........###....',
+        '###..........###....',
+        '###..........###....',
+    ],
+};
+// Load-time validation: a wordmark letter without a font glyph, or a glyph
+// that cannot fold into the whale's 10 terminal rows, is a programming
+// error — fail at module load, not at some later resize when the full
+// banner is first assembled (a narrow terminal would defer the crash into
+// the resize handler).
+for (const ch of WORDMARK) {
+    if (ch !== ' ' && PIXEL_FONT[ch] === undefined) {
+        throw new Error(`PIXEL_FONT lacks glyph for '${ch}' in WORDMARK`);
+    }
+}
+for (const [ch, glyph] of Object.entries(PIXEL_FONT)) {
+    if (glyph.length !== 2 * WHALE_ART.length) {
+        throw new Error(`PIXEL_FONT['${ch}'] has ${glyph.length} pixel rows — need ${2 * WHALE_ART.length} (two per banner row)`);
+    }
+    const widths = [...new Set(glyph.map(row => row.length))];
+    if (widths.length !== 1) {
+        throw new Error(`PIXEL_FONT['${ch}'] has ragged pixel rows: widths ${widths.join(', ')}`);
+    }
+}
+/**
+ * The wordmark letters' total width in columns — the glyphs' widths
+ * summed: 20 (D) + 20 (S) + 20 (H) = 60. The 2-column gaps between
+ * letters are added separately in WELCOME_FULL_WIDTH (2 gaps × 2 columns
+ * → the wordmark block spans 64).
+ */
+const WORDMARK_WIDTH = [...WORDMARK].reduce((width, ch) => width + (ch === ' ' ? 1 : PIXEL_FONT[ch][0].length), 0);
+/**
+ * Full banner width: whale + gap + wordmark block — derived from the
+ * constants so a layout tweak (gap, glyph widths) cannot silently desync
+ * the degradation threshold in `buildWelcomeBanner` from the assembled
+ * rows: 28 + 2 + 20 + 2 + 20 + 2 + 20 = 94 columns.
+ */
+export const WELCOME_FULL_WIDTH = WHALE_ART_WIDTH + WHALE_TITLE_GAP + WORDMARK_WIDTH + LETTER_GAP * (WORDMARK.length - 1);
+/**
+ * Fold a 20×20 pixel bitmap into its 10 terminal rows with the whale's own
+ * half-block mapping: both pixel rows on → '█', top only → '▀', bottom
+ * only → '▄', neither → ' '. Two pixels vertically per cell is what makes
+ * the pixels square on screen — one column wide, one half-cell tall — the
+ * same grid the whale art lives on.
+ */
+export function renderPixelGlyph(px) {
+    const rows = [];
+    for (let i = 0; i < px.length / 2; i++) {
+        let row = '';
+        for (let c = 0; c < px[0].length; c++) {
+            const top = px[2 * i][c] === '#';
+            const bottom = px[2 * i + 1][c] === '#';
+            row += top && bottom ? '█' : top ? '▀' : bottom ? '▄' : ' ';
+        }
+        rows.push(row);
+    }
+    return rows;
+}
+/**
+ * Lay out the wordmark's 10 letter rows, 64 columns each: the D, S and H
+ * glyphs with a 2-column gap between letters (20 + 2 + 20 + 2 + 20
+ * columns). The pixel bitmaps are folded by renderPixelGlyph into the same
+ * '█'/'▀'/'▄'/' ' glyphs the whale uses, so the rows paint exactly like
+ * whale rows (see the header note). Wordmark glyph coverage and shape are
+ * validated at module load.
+ */
+function wordmarkRows() {
+    const glyphRows = [...WORDMARK].map(ch => renderPixelGlyph(PIXEL_FONT[ch]));
+    const rows = Array.from({ length: WHALE_ART.length }, () => '');
+    for (let i = 0; i < glyphRows.length; i++) {
+        for (let r = 0; r < rows.length; r++) {
+            rows[r] += glyphRows[i][r];
+            if (i < glyphRows.length - 1)
+                rows[r] += ' '.repeat(LETTER_GAP);
+        }
+    }
+    return rows;
+}
+/**
+ * Paint one consecutive run of brand-blue glyphs as a single SGR span,
+ * RESET at the end. Runs are painted in the whale blue only — half-block
+ * glyphs ('▀'/'▄') are never given a background, so their transparent half
+ * shows the terminal default background (see the header note).
+ */
+function paintWhaleRun(run) {
+    return ansiFg(WHALE_COLOR) + run + RESET;
+}
+/**
+ * Paint one row's consecutive runs of non-space glyphs as whale-blue spans,
+ * RESET after each. The spaces between runs stay unstyled (transparent,
+ * terminal background). Used for whale rows and the wordmark's letter rows
+ * alike.
+ */
+function paintRowRuns(row) {
+    let styled = '';
+    let run = '';
+    for (const ch of row) {
+        if (ch === ' ') {
+            if (run !== '') {
+                styled += paintWhaleRun(run);
+                run = '';
+            }
+            styled += ' ';
+        }
+        else {
+            run += ch;
+        }
+    }
+    if (run !== '')
+        styled += paintWhaleRun(run);
+    return styled;
+}
+/**
+ * Assemble the welcome banner text. Every row is the styled whale row, the
+ * 2-column gap, then the 88-column pixel-letter row (letters 2 columns
+ * apart) — all painted in the whale brand blue. The banner is
+ * theme-independent: no theme colors, no bold, nothing to repaint on a
+ * theme switch.
+ *
+ * Width floor: the full banner is 94 columns wide plus the transcript
+ * Text's 1-column left/right padding (the renderer passes its Text paddingX
+ * — currently 1 — so the threshold is 96). Below it the banner degrades
+ * to the whale alone: the 10 art rows, 28 columns each, no gap and no
+ * letters, which needs only 30 columns with the padding. A terminal
+ * narrower than that wraps the whale rows onto extra lines (accepted
+ * degradation, documented rather than clipped, because a terminal that
+ * narrow can't show the whale either way). `undefined` (non-TTY contexts,
+ * e.g. tests) counts as wide — the full banner, conservative like
+ * PANEL_LINE_CAP_FALLBACK.
+ */
+export function buildWelcomeBanner(columns) {
+    // 2 = the transcript Text's paddingX on each side (messages.ts renders the
+    // banner with `new Text(..., 1, 0)`).
+    if (columns !== undefined && columns < WELCOME_FULL_WIDTH + 2) {
+        // Narrow terminal: whale-only, the 10 art rows (28 columns each) — no
+        // gap, no letters. Wraps only below the 30-column floor.
+        return WHALE_ART.map(row => paintRowRuns(row)).join('\n');
+    }
+    const letters = wordmarkRows();
+    return WHALE_ART.map((row, r) => {
+        return paintRowRuns(row) + ' '.repeat(WHALE_TITLE_GAP + WHALE_ART_WIDTH - row.length) + paintRowRuns(letters[r]);
+    }).join('\n');
+}
+//# sourceMappingURL=welcome.js.map

package/lib/welcome.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@aiwayds/dsh-tui-pi",
+  "version": "0.1.0",
+  "description": "pi-style terminal UI for DeepSeek Harness (dsh) — pi-tui look & feel, dsh slash commands, GitHub light/dark themes, powerline footer",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "bin": {
+    "dsh-tui-pi": "bin/dsh-tui-pi"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "files": [
+    "lib",
+    "bin",
+    "cordis.patch.yml",
+    "patches",
+    "pnpm-workspace.yaml",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc --noEmit -p tsconfig.json",
+    "pretest": "npm run build",
+    "test": "node --test test/*.test.mjs"
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-client-schema-form": "0.1.0-rc.6",
+    "@earendil-works/pi-tui": "0.84.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "3.18.1",
+    "@types/node": "^24.0.0",
+    "typescript": "~5.9.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "author": "fan56",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/patches/@earendil-works__pi-tui.patch

@@ -0,0 +1,72 @@
+diff --git a/dist/components/editor.js b/dist/components/editor.js
+index 4786b46932b65785cfbd2304610ca77ccead910a..e0e4e39c3be8e5d4d828621ad2d3d8768984add8 100644
+--- a/dist/components/editor.js
++++ b/dist/components/editor.js
+@@ -463,14 +463,20 @@ export class Editor {
+         else {
+             result.push(horizontal.repeat(width));
+         }
+-        // Add autocomplete list if active
++        // Add autocomplete list if active — inside a full box (┌─┐ rows)
+         if (this.autocompleteState && this.autocompleteList) {
+-            const autocompleteResult = this.autocompleteList.render(contentWidth);
++            const boxInnerWidth = Math.max(1, contentWidth - 2);
++            const autocompleteResult = this.autocompleteList.render(boxInnerWidth);
++            result.push(`${leftPadding}${this.borderColor(`┌${"─".repeat(boxInnerWidth)}┐`)}${rightPadding}`);
+             for (const line of autocompleteResult) {
+                 const lineWidth = visibleWidth(line);
+-                const linePadding = " ".repeat(Math.max(0, contentWidth - lineWidth));
+-                result.push(`${leftPadding}${line}${linePadding}${rightPadding}`);
++                const linePadding = " ".repeat(Math.max(0, boxInnerWidth - lineWidth));
++                // Strip trailing RESETs so the row's own backdrop SGR bleeds
++                // into the padding and the right side border (solid interior);
++                // the reset before rightPadding keeps the editor margin clear.
++                result.push(`${leftPadding}│${line.replace(/(?:\x1b\[0m)+$/, "")}${linePadding}│\x1b[0m${rightPadding}`);
+             }
++            result.push(`${leftPadding}${this.borderColor(`└${"─".repeat(boxInnerWidth)}┘`)}${rightPadding}`);
+         }
+         return result;
+     }
+diff --git a/dist/components/select-list.d.ts b/dist/components/select-list.d.ts
+index d507de4ebff8e7fbaacd089677099c63b4dfff6c..4b8a374cd1db0544a11082f8008f73f8eb8d7ede 100644
+--- a/dist/components/select-list.d.ts
++++ b/dist/components/select-list.d.ts
+@@ -10,6 +10,8 @@ export interface SelectListTheme {
+     description: (text: string) => string;
+     scrollInfo: (text: string) => string;
+     noMatch: (text: string) => string;
++    /** Style hook for unselected rows (plain rows render without any theme call upstream). */
++    unselectedText?: (text: string) => string;
+ }
+ export interface SelectListTruncatePrimaryContext {
+     text: string;
+diff --git a/dist/components/select-list.js b/dist/components/select-list.js
+index 2e9231150951c3d3f3e13ac8ae8d623f06d38d5d..d5c8859ecd08fe4eccdc3cfca8ac7a3226f8fcb5 100644
+--- a/dist/components/select-list.js
++++ b/dist/components/select-list.js
+@@ -101,18 +101,21 @@ export class SelectList {
+             if (remainingWidth > MIN_DESCRIPTION_WIDTH) {
+                 const truncatedDesc = truncateToWidth(descriptionSingleLine, remainingWidth, "");
+                 if (isSelected) {
+-                    return this.theme.selectedText(`${prefix}${truncatedValue}${spacing}${truncatedDesc}`);
++                    // selectedPrefix is otherwise dead in renderItem: style the
++                    // arrow accent, then the row text (concatenated, not nested —
++                    // nesting would let the prefix's RESETs clear the row style).
++                    return this.theme.selectedPrefix("") + this.theme.selectedText(`${truncatedValue}${spacing}${truncatedDesc}`);
+                 }
+                 const descText = this.theme.description(spacing + truncatedDesc);
+-                return prefix + truncatedValue + descText;
++                return (this.theme.unselectedText ?? ((t) => t))(prefix + truncatedValue) + descText;
+             }
+         }
+         const maxWidth = width - prefixWidth - 2;
+         const truncatedValue = this.truncatePrimary(item, isSelected, maxWidth, maxWidth);
+         if (isSelected) {
+-            return this.theme.selectedText(`${prefix}${truncatedValue}`);
++            return this.theme.selectedPrefix("") + this.theme.selectedText(`${truncatedValue}`);
+         }
+-        return prefix + truncatedValue;
++        return (this.theme.unselectedText ?? ((t) => t))(prefix + truncatedValue);
+     }
+     getPrimaryColumnWidth() {
+         const { min, max } = this.getPrimaryColumnBounds();

package/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+patchedDependencies:
+  '@earendil-works/pi-tui': patches/@earendil-works__pi-tui.patch

package/templates/APPEND_SYSTEM.md

@@ -0,0 +1,34 @@
+# APPEND_SYSTEM.md — Orchestrator identity
+
+## Identity: I am an orchestrator, not an executor
+The user defines my core identity as an **orchestrator**: I analyze tasks,
+break them into plans, dispatch sub-agents and consolidate results — I do
+not perform concrete operations myself.
+
+## Core rules
+
+1. All research work must be done through sub-agents.
+2. Forbidden:
+   - Running tests sequentially in the conversation, silently reading files,
+     or analyzing code on my own.
+   - Using execution tools directly (read/write/search/bash/edit), unless a
+     sub-agent cannot do the job.
+   - Suggesting the user do things manually.
+3. Tasks must pass through verify/review agents. Without review, a task must
+   not be marked "completed".
+4. Never assume "the problem is known".
+5. Never guess — every claim must be backed by evidence.
+
+## Execution workflow
+
+1. **Analyze**: understand the request, identify the task boundaries.
+2. **Create todos**: break the task into executable subtasks.
+3. **Dispatch sub-agents**: dispatch sub-agents in parallel.
+4. **Verify**: check the results returned by the sub-agents.
+5. **Consolidate**: integrate the results and report to the user.
+
+---
+
+> **Remember**: my value lies in orchestration and decisions, not execution.
+> Let sub-agents do the concrete work; I focus on analysis, planning and
+> quality control.