pi-minimal 0.1.0 → 0.2.1

package/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  - package-ecosystem: "" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

package/.github/workflows/publish.yml

@@ -1,29 +1,193 @@
 name: Publish
 
+# Publishes automatically when the version in package.json changes on main:
+# verifies the build, tags vX.Y.Z, creates a GitHub Release (CHANGELOG section +
+# auto-generated notes), records a deployment to the "npm" environment, and
+# publishes to npm via trusted publishing (OIDC; no token). Pushes that do not
+# change the version are a no-op.
+#
+# This file name is registered with npm as the trusted publisher for pi-minimal.
+# Renaming it breaks publishing until npm's trusted-publisher config is updated.
+
 on:
-  release:
-    types: [published]
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: publish
+  cancel-in-progress: false
 
 permissions:
-  contents: read
+  contents: write
+  deployments: write
   id-token: write
+  pull-requests: read
 
 jobs:
-  publish:
+  detect:
+    name: Detect version change
     runs-on: ubuntu-latest
-    environment: npm
+    outputs:
+      publish: ${{ steps.check.outputs.publish }}
+      tag_exists: ${{ steps.check.outputs.tag_exists }}
+      version: ${{ steps.check.outputs.version }}
+      tag: ${{ steps.check.outputs.tag }}
+      previous_tag: ${{ steps.check.outputs.previous_tag }}
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - uses: actions/setup-node@v4
         with:
           node-version: 22.19.0
-          registry-url: https://registry.npmjs.org
-          cache: npm
-      - run: npm ci
-      - run: npm run lint
-      - run: npm test
-      - run: npm run build
-      - run: git diff --exit-code -- dist
-      - run: npm publish --access public
+      - id: check
         env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -euo pipefail
+          name=$(node -p "require('./package.json').name")
+          version=$(node -p "require('./package.json').version")
+          tag="v$version"
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+          echo "tag=$tag" >> "$GITHUB_OUTPUT"
+          previous_tag=$(git tag --list 'v*' --sort=-v:refname | grep -vx "$tag" | head -n1 || true)
+          echo "previous_tag=$previous_tag" >> "$GITHUB_OUTPUT"
+
+          tag_exists=false
+          if git rev-parse -q --verify "refs/tags/$tag" >/dev/null; then tag_exists=true; fi
+          echo "tag_exists=$tag_exists" >> "$GITHUB_OUTPUT"
+
+          if npm view "$name@$version" version >/dev/null 2>&1; then
+            echo "::notice::$name@$version is already on npm; nothing to publish."
+            echo "publish=false" >> "$GITHUB_OUTPUT"; exit 0
+          fi
+          echo "publish=true" >> "$GITHUB_OUTPUT"
+          if [ "$tag_exists" = true ]; then
+            echo "::notice::$tag exists but $name@$version is not on npm; publishing (re-run)."
+          else
+            echo "::notice::New version $version detected (previous tag: ${previous_tag:-none})."
+          fi
+
+  release:
+    name: Tag, release, publish ${{ needs.detect.outputs.tag }}
+    needs: detect
+    if: needs.detect.outputs.publish == 'true'
+    runs-on: ubuntu-latest
+    environment:
+      name: npm
+      url: https://www.npmjs.com/package/pi-minimal/v/${{ needs.detect.outputs.version }}
+    env:
+      VERSION: ${{ needs.detect.outputs.version }}
+      TAG: ${{ needs.detect.outputs.tag }}
+      PREVIOUS_TAG: ${{ needs.detect.outputs.previous_tag }}
+      GH_TOKEN: ${{ github.token }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      # No registry-url here: setup-node would write an .npmrc with a placeholder
+      # NODE_AUTH_TOKEN, and npm then sends that instead of exchanging the OIDC
+      # token, which the registry rejects with a 404. Trusted publishing needs
+      # no token configured at all.
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22.19.0
+          cache: npm
+
+      - name: Verify
+        run: |
+          npm ci
+          npm run lint
+          npm run typecheck
+          npm test
+          npm run build
+          git diff --exit-code -- dist
+
+      - name: Compose release notes
+        id: notes
+        run: |
+          set -euo pipefail
+          notes=release-notes.md
+          : > "$notes"
+
+          # 1. Hand-written section from CHANGELOG.md, if present ("## [X.Y.Z] ..." until next "## ").
+          if [ -f CHANGELOG.md ]; then
+            section=$(awk -v v="$VERSION" '
+              /^## \[/ { if (found) exit; found = index($0, "[" v "]") > 0; next }
+              found && /^\[[^]]+\]: / { exit }
+              found { print }' CHANGELOG.md | sed -e '/./,$!d' -e :a -e '/^\n*$/{$d;N;ba' -e '}')
+            if [ -n "$section" ]; then
+              printf '%s\n\n' "$section" >> "$notes"
+            else
+              echo "::warning::CHANGELOG.md has no section for [$VERSION]; using generated notes only."
+            fi
+          fi
+
+          # 2. GitHub-generated notes (merged PRs / commits since the previous tag).
+          body=$(gh api -X POST "repos/${GITHUB_REPOSITORY}/releases/generate-notes" \
+            -f tag_name="$TAG" -f target_commitish="$GITHUB_SHA" \
+            ${PREVIOUS_TAG:+-f previous_tag_name="$PREVIOUS_TAG"} --jq .body)
+          printf '%s\n\n' "$body" >> "$notes"
+
+          # 3. Install footer.
+          cat >> "$notes" <<EOF
+          ---
+          **Install / upgrade**
+          \`\`\`bash
+          pi install npm:pi-minimal@$VERSION   # or: pi update --extensions
+          \`\`\`
+          EOF
+          echo "file=$notes" >> "$GITHUB_OUTPUT"
+          echo "### Release notes for $TAG" >> "$GITHUB_STEP_SUMMARY"
+          cat "$notes" >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Create tag and GitHub Release
+        run: |
+          set -euo pipefail
+          if [ "${{ needs.detect.outputs.tag_exists }}" != true ]; then
+            git config user.name "github-actions[bot]"
+            git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+            git tag -a "$TAG" -m "pi-minimal $VERSION" "$GITHUB_SHA"
+            git push origin "refs/tags/$TAG"
+          else
+            echo "Tag $TAG already exists; not re-tagging."
+          fi
+          if gh release view "$TAG" >/dev/null 2>&1; then
+            echo "Release $TAG already exists; updating notes."
+            gh release edit "$TAG" --notes-file "${{ steps.notes.outputs.file }}"
+          else
+            gh release create "$TAG" \
+              --target "$GITHUB_SHA" \
+              --title "pi-minimal $VERSION" \
+              --notes-file "${{ steps.notes.outputs.file }}" \
+              --verify-tag
+          fi
+
+      - name: Upgrade npm for trusted publishing
+        # Node 22 bundles npm 10.x; OIDC trusted publishing needs npm >= 11.5.1.
+        # npm 12 requires Node >= 22.22.2, so stay on the 11.x line for Node 22.19.
+        run: |
+          npm install -g npm@11
+          npm --version
+
+      - name: Publish to npm (trusted publishing)
+        # No NODE_AUTH_TOKEN: npm authenticates with the job's OIDC token and
+        # generates provenance automatically.
+        run: |
+          npm config get registry
+          npm whoami 2>/dev/null || echo "no token configured (expected for OIDC)"
+          npm publish --access public
+
+      - name: Attach package tarball to release
+        run: |
+          npm pack --silent
+          gh release upload "$TAG" ./pi-minimal-"$VERSION".tgz --clobber
+
+      - name: Summary
+        run: |
+          {
+            echo "### Published"
+            echo "- Release: ${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/releases/tag/$TAG"
+            echo "- npm: https://www.npmjs.com/package/pi-minimal/v/$VERSION"
+          } >> "$GITHUB_STEP_SUMMARY"

package/.github/workflows/release.yml

@@ -0,0 +1,42 @@
+name: Release (manual fallback)
+
+# Normal releases are fully automatic: bump the version in package.json on main
+# and .github/workflows/publish.yml tags, releases, and publishes via trusted
+# publishing. Use this only to re-run the npm publish for an existing release
+# when the automated path fails; it authenticates with the NPM_TOKEN secret.
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Existing release tag to publish (e.g. v0.2.0)"
+        required: true
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: npm
+      url: https://www.npmjs.com/package/pi-minimal
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.tag }}
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22.19.0
+          registry-url: https://registry.npmjs.org
+          cache: npm
+      - run: npm ci
+      - run: npm run lint
+      - run: npm test
+      - run: npm run build
+      - run: git diff --exit-code -- dist
+      - run: npm install -g npm@11
+      - run: npm publish --access public --provenance
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CHANGELOG.md

@@ -0,0 +1,63 @@
+# Changelog
+
+All notable changes to this project are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow
+[Semantic Versioning](https://semver.org/).
+
+Releases are cut automatically: when the `version` in `package.json` changes on
+`main`, the Publish workflow tags it, publishes to npm, and uses the matching
+`## [x.y.z]` section below as the top of the release notes.
+
+## [Unreleased]
+
+## [0.2.1] - 2026-10-22
+
+### Added
+- Automated releases: when `version` in `package.json` changes on `main`, the
+  Publish workflow verifies the build, tags `vX.Y.Z`, creates a GitHub Release
+  (CHANGELOG section + generated notes + package tarball), records a deployment
+  to the `npm` environment, and publishes to npm via OIDC trusted publishing.
+- `CHANGELOG.md` and a "Releasing" section in the README.
+- The Publish workflow upgrades npm to >= 11.5.1 (required for OIDC trusted
+  publishing) and is re-runnable: an existing tag whose version is missing
+  from npm is published without re-tagging.
+- `repository`, `homepage`, and `bugs` fields in `package.json`, required for
+  npm provenance verification.
+
+### Changed
+- The release-triggered publish workflow is now a manual, token-based fallback
+  (`release.yml`) for re-publishing an existing tag.
+
+## [0.2.0] - 2026-10-22
+
+### Added
+- One-line tool rows for the built-in tools with a status glyph (`◐` running,
+  `✓` ok, `✗` failed), a fixed verb column, and a right-aligned outcome
+  (`34 lines · 1.0s`, `exit 1`, `+3 −1`, `4 matches`, `2.1 KB`).
+- Failed rows show the first line of output underneath; `ctrl+o` expands the
+  full output as a `│`-ruled block.
+- A dim turn rule (`── 15:51 · 12s · 4 tools ──`) after every agent run,
+  stored as a custom entry that never enters model context.
+- `┊` gutter on thinking paragraphs.
+- Status line shows the git branch and dirty count (`⎇ main ±1`) and colours
+  the context meter amber at 70 % and red at 90 %.
+- Footer key hints appear only when idle with an empty editor; `/compact` is
+  suggested under context pressure.
+- `minimal-dark` theme shipped with the package.
+
+### Changed
+- Tool renderers are attached with `registerToolRenderer` at extension load
+  instead of re-registering the built-in tools in `session_start`, so resumed
+  transcripts render the same way as new messages.
+- Requires pi `>=1.4.0`.
+
+## [0.1.0] - 2026-09-23
+
+### Added
+- Initial release: header/footer chrome, compact tool activity rows, working
+  status line, Herdr sibling status, Gauntlet widget hiding.
+
+[Unreleased]: https://github.com/raviy06/pi-minimal/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/raviy06/pi-minimal/compare/v0.2.0...v0.2.1
+[0.2.0]: https://github.com/raviy06/pi-minimal/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/raviy06/pi-minimal/releases/tag/v0.1.0

package/README.md

@@ -5,7 +5,7 @@ A Pi coding-agent package.
 ## Requirements
 
 - Node.js `>=22.19.0`
-- Pi `>=0.84.4`
+- Pi `>=1.4.0` (uses `registerToolRenderer`, `registerEntryRenderer`, `registerMarkdownTransformer`)
 
 No other Pi extension is required. Pi supplies the peer packages used by this extension.
 
@@ -16,12 +16,27 @@ Optional integrations:
 
 ## Installation
 
+```bash
+pi install npm:pi-minimal
+```
+
+Git installation also works:
+
 ```bash
 pi install git:github.com/raviy06/pi-minimal
 ```
 
 Do not load this package beside the live `grok-chrome` extension. Disable or remove `grok-chrome` before enabling `pi-minimal`.
 
+## What it changes
+
+- **Tool rows** – every built-in tool call (`bash`, `read`, `edit`, `write`, `grep`, `find`, `ls`) renders as one line: status glyph (`◐` running, `✓` ok, `✗` failed), verb, item, and a right-aligned outcome (`34 lines · 1.0s`, `exit 1`, `+3 −1`, `4 matches`). Failed rows show the first line of output underneath; `ctrl+o` expands full output in a `│`-ruled block.
+- **Turn rule** – after each agent run a dim `── 15:51 · 12s · 4 tools ──` separator is appended (stored as a custom entry; never sent to the model).
+- **Thinking gutter** – thinking paragraphs are prefixed with `┊` so they read as secondary.
+- **Status line** – one line above the editor: model · thinking level · context meter (amber at 70 %, red at 90 %) · cwd · `⎇ branch ±dirty` · Herdr siblings.
+- **Footer** – key hints appear only when the agent is idle and the editor is empty; `/compact` is suggested under context pressure.
+- **Theme** – ships `minimal-dark`: neutral tool backgrounds, visible user-message tint, dimmer thinking text, violet headings (yellow is reserved for warnings), and code-fence lines coloured like the background so fenced code reads as a padded block. Select it in `/settings` → Theme, or set `"theme": "minimal-dark"`.
+
 ## Configuration
 
 The package loads JSON in this order:
@@ -37,3 +52,13 @@ The only supported key is `hideGauntletWidgets`. It defaults to `true`.
 ```json
 { "hideGauntletWidgets": true }
 ```
+
+## Releasing
+
+Releases are automatic. To ship a version:
+
+1. Add a `## [x.y.z] - YYYY-MM-DD` section to `CHANGELOG.md`.
+2. Bump `version` in `package.json` (and the expectation in `test/package.test.ts`), run `npm run build`, commit `dist/`.
+3. Merge to `main`.
+
+The Publish workflow (`.github/workflows/publish.yml`, npm's registered trusted publisher) detects the new version, verifies lint/typecheck/tests/build, tags `vx.y.z`, creates a GitHub Release (CHANGELOG section + auto-generated notes + package tarball), records a deployment to the `npm` environment, and publishes to npm via OIDC trusted publishing (provenance included). Pushes that do not change the version do nothing. `Release (manual fallback)` re-publishes an existing tag with the `NPM_TOKEN` secret if the automated path ever fails.

package/SECURITY.md

@@ -0,0 +1,21 @@
+# Security Policy
+
+## Supported Versions
+
+Use this section to tell people about which versions of your project are
+currently being supported with security updates.
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 5.1.x   | :white_check_mark: |
+| 5.0.x   | :x:                |
+| 4.0.x   | :white_check_mark: |
+| < 4.0   | :x:                |
+
+## Reporting a Vulnerability
+
+Use this section to tell people how to report a vulnerability.
+
+Tell them where to go, how often they can expect to get an update on a
+reported vulnerability, what to expect if the vulnerability is accepted or
+declined, etc.

package/dist/activity.js

@@ -7,6 +7,3 @@ export function rowIsRunning(context) {
         return false;
     return true;
 }
-export function activityBullet(running, frame) {
-    return running && frame === 1 ? "◇" : "◆";
-}

package/dist/cwd.js

@@ -1,7 +1,8 @@
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import path from "node:path";
 import { CHROME_MARGIN } from "./chrome.js";
-function formatCwd(cwd) {
+import { formatGitState } from "./git-state.js";
+export function formatCwd(cwd) {
     const home = process.env.HOME || process.env.USERPROFILE || "";
     if (!home)
         return cwd;
@@ -12,7 +13,7 @@ function formatCwd(cwd) {
     }
     return cwd;
 }
-function formatTokens(n) {
+export function formatTokens(n) {
     if (n < 1000)
         return String(n);
     if (n < 10000)
@@ -23,7 +24,7 @@ function formatTokens(n) {
         return `${(n / 1e6).toFixed(1)}M`;
     return `${Math.round(n / 1e6)}M`;
 }
-function modelIcon(id) {
+export function modelIcon(id) {
     const s = id.toLowerCase();
     if (s.includes("grok"))
         return "✦";
@@ -38,7 +39,7 @@ function modelIcon(id) {
         return "◈";
     return "◆";
 }
-function shortModel(id) {
+export function shortModel(id) {
     return (id.split("/").pop() || id).replace(/^claude-/, "");
 }
 function thinkingColor(level) {
@@ -48,56 +49,95 @@ function thinkingColor(level) {
         return "accent";
     return "dim";
 }
-function meter(percent, fill, empty) {
-    const n = 8;
-    const filled = Math.max(0, Math.min(n, Math.round((percent / 100) * n)));
-    return fill.repeat(filled) + empty.repeat(n - filled);
+/** Context pressure band used for the meter and percentage colour. */
+export function contextBand(pct) {
+    if (pct >= 90)
+        return "error";
+    if (pct >= 70)
+        return "warning";
+    return "accent";
 }
-function splitRow(left, right, width) {
-    let L = left;
-    let R = right;
-    while (visibleWidth(L) + 1 + visibleWidth(R) > width && visibleWidth(R) > 0) {
-        R = truncateToWidth(R, Math.max(0, visibleWidth(R) - 1), "");
+export function meter(percent, fill, empty, cells = 8) {
+    const filled = Math.max(0, Math.min(cells, Math.round((percent / 100) * cells)));
+    return fill.repeat(filled) + empty.repeat(cells - filled);
+}
+/**
+ * Fit `left` and `right` into `width`. Right-hand segments are dropped from the end first (they are
+ * the least important), then the left is truncated.
+ */
+export function splitRow(left, rightSegments, width, sep = "  ") {
+    const segments = [...rightSegments.filter((s) => visibleWidth(s) > 0)];
+    let right = segments.join(sep);
+    while (segments.length > 0 && visibleWidth(left) + 2 + visibleWidth(right) > width) {
+        segments.pop();
+        right = segments.join(sep);
     }
-    while (visibleWidth(L) + 1 + visibleWidth(R) > width && visibleWidth(L) > 0) {
-        L = truncateToWidth(L, Math.max(0, visibleWidth(L) - 1), "");
+    let L = left;
+    if (visibleWidth(L) + (right ? 2 : 0) + visibleWidth(right) > width) {
+        L = truncateToWidth(L, Math.max(0, width - (right ? 2 : 0) - visibleWidth(right)), "");
     }
-    const gap = Math.max(1, width - visibleWidth(L) - visibleWidth(R));
-    return L + " ".repeat(gap) + R;
+    const gap = right ? Math.max(2, width - visibleWidth(L) - visibleWidth(right)) : 0;
+    return L + " ".repeat(gap) + right;
+}
+function siblingColor(status) {
+    if (status === "idle" || status === "done")
+        return "success";
+    if (status === "working")
+        return "accent";
+    if (status === "blocked")
+        return "error";
+    return "muted";
 }
-export function installCwd(ctx) {
-    ctx.ui.setWidget("tw-cwd", (_tui, theme) => ({
-        invalidate() { },
-        render(width) {
-            const inner = Math.max(8, width - CHROME_MARGIN * 2);
-            const id = ctx.model?.id || "no-model";
-            const icon = theme.fg("accent", modelIcon(id));
-            const name = theme.fg("text", shortModel(id));
-            const usage = ctx.getContextUsage?.();
-            const window = usage?.contextWindow || ctx.model?.contextWindow;
-            const used = usage?.tokens;
-            let tokenStr = theme.fg("dim", "?/?");
-            let bar = theme.fg("dim", "░░░░░░░░");
-            let pctStr = theme.fg("dim", "?%");
-            if (typeof used === "number" && window) {
-                const pct = Math.max(0, Math.min(100, Math.round((used / window) * 100)));
-                tokenStr = theme.fg("dim", `${formatTokens(used)}/${formatTokens(window)}`);
-                const hot = pct >= 85;
-                bar = meter(pct, theme.fg(hot ? "warning" : "accent", "█"), theme.fg("dim", "░"));
-                pctStr = theme.fg(hot ? "warning" : "muted", `${pct}%`);
-            }
-            else if (used === null && window) {
-                tokenStr = theme.fg("dim", `?/${formatTokens(window)}`);
-            }
-            const thinking = ctx.thinkingLevel || "";
-            const think = thinking ? theme.fg(thinkingColor(thinking), thinking) : "";
-            const midot = theme.fg("dim", " · ");
-            const left = [`${icon} ${name}`, tokenStr, `${bar} ${pctStr}`, think]
-                .filter(Boolean)
-                .join(midot);
-            const right = ctx.cwd ? theme.fg("accent", formatCwd(ctx.cwd)) : "";
-            const row = splitRow(left, right, inner);
-            return [`${" ".repeat(CHROME_MARGIN)}${row}`];
-        },
-    }), { placement: "aboveEditor" });
+export function installCwd(ctx, sources) {
+    ctx.ui.setWidget("tw-cwd", (tui, theme) => {
+        const unsub = sources.onGitChange(() => tui.requestRender());
+        return {
+            dispose: unsub,
+            invalidate() { },
+            render(width) {
+                const inner = Math.max(8, width - CHROME_MARGIN * 2);
+                const id = ctx.model?.id || "no-model";
+                const icon = theme.fg("accent", modelIcon(id));
+                const name = theme.fg("text", shortModel(id));
+                const thinking = ctx.thinkingLevel || "";
+                const think = thinking ? theme.fg(thinkingColor(thinking), thinking) : "";
+                const usage = ctx.getContextUsage?.();
+                const window = usage?.contextWindow || ctx.model?.contextWindow;
+                const used = usage?.tokens;
+                let bar = theme.fg("dim", "░░░░░░░░");
+                let pctStr = theme.fg("dim", "?%");
+                let tokenStr = theme.fg("dim", "?/?");
+                if (typeof used === "number" && window) {
+                    const pct = Math.max(0, Math.min(100, Math.round((used / window) * 100)));
+                    const band = contextBand(pct);
+                    bar = meter(pct, theme.fg(band, "▓"), theme.fg("dim", "░"));
+                    pctStr = theme.fg(band === "accent" ? "muted" : band, `${pct}%`);
+                    tokenStr = theme.fg("dim", `${formatTokens(used)}/${formatTokens(window)}`);
+                }
+                else if (used === null && window) {
+                    tokenStr = theme.fg("dim", `?/${formatTokens(window)}`);
+                }
+                const midot = theme.fg("dim", " · ");
+                const model = [`${icon} ${name}`, think].filter(Boolean).join(midot);
+                const context = `${bar} ${pctStr} ${tokenStr}`;
+                const left = `${model}   ${context}`;
+                const right = [];
+                if (ctx.cwd)
+                    right.push(theme.fg("muted", formatCwd(ctx.cwd)));
+                const git = formatGitState(sources.gitState());
+                if (git.branch) {
+                    const dirty = git.dirty ? ` ${theme.fg("warning", git.dirty)}` : "";
+                    right.push(`${theme.fg("dim", "⎇")} ${theme.fg("muted", git.branch)}${dirty}`);
+                }
+                const siblings = sources.siblings();
+                if (siblings && siblings.length > 0) {
+                    right.push(siblings
+                        .map((s) => `${theme.fg("text", s.name)} ${theme.fg(siblingColor(s.status), s.status)}`)
+                        .join(theme.fg("dim", " · ")));
+                }
+                const row = splitRow(left, right, inner);
+                return [`${" ".repeat(CHROME_MARGIN)}${row}`];
+            },
+        };
+    }, { placement: "aboveEditor" });
 }

package/dist/footer.js

@@ -1,41 +1,40 @@
 import { keyHint } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { truncateToWidth } from "@earendil-works/pi-tui";
 import { CHROME_MARGIN } from "./chrome.js";
 import { formatTrackerLines } from "./tracker.js";
-function statusColor(status) {
-    if (status === "idle" || status === "done")
-        return "success";
-    if (status === "working")
-        return "accent";
-    if (status === "blocked")
-        return "error";
-    return "muted";
+/**
+ * Key hints are shown only when nothing else needs the line: idle agent, empty editor. Otherwise
+ * the footer collapses to zero lines (tracker lines excepted).
+ */
+export function footerHints(sources, hints) {
+    if (sources.busy())
+        return [];
+    if (sources.editorText().trim().length > 0)
+        return [];
+    const pct = sources.contextPct();
+    const out = [...hints];
+    if (pct !== undefined && pct >= 70)
+        out.push("/compact");
+    return out;
 }
-export function installFooter(ctx, getSiblings) {
+export function installFooter(ctx, sources) {
     ctx.ui.setFooter((tui, theme, footerData) => {
         const unsub = footerData.onBranchChange(() => tui.requestRender());
         return {
             dispose: unsub,
             invalidate() { },
             render(width) {
-                const send = keyHint("tui.input.submit", "send");
-                const think = keyHint("app.thinking.cycle", "thinking");
-                const left = [send, think].filter(Boolean).join("  ·  ");
-                const siblings = getSiblings();
-                let right = "";
-                if (siblings && siblings.length > 0) {
-                    right = siblings
-                        .map((s) => {
-                        const name = theme.fg("text", s.name);
-                        const st = theme.fg(statusColor(s.status), s.status);
-                        return `${name} ${st}`;
-                    })
-                        .join(theme.fg("dim", "  ·  "));
-                }
                 const inner = Math.max(8, width - CHROME_MARGIN * 2);
-                const pad = Math.max(1, inner - visibleWidth(left) - visibleWidth(right));
-                const line = truncateToWidth(left + " ".repeat(pad) + right, inner, "");
-                const out = [`${" ".repeat(CHROME_MARGIN)}${line}`];
+                const out = [];
+                const hints = footerHints(sources, [
+                    keyHint("tui.input.submit", "send"),
+                    keyHint("app.thinking.cycle", "thinking"),
+                    keyHint("app.tools.expand", "expand tools"),
+                ].filter(Boolean));
+                if (hints.length > 0) {
+                    const line = theme.fg("dim", hints.join("  ·  "));
+                    out.push(`${" ".repeat(CHROME_MARGIN)}${truncateToWidth(line, inner, "")}`);
+                }
                 for (const extra of formatTrackerLines(ctx, theme)) {
                     out.push(`${" ".repeat(CHROME_MARGIN)}${truncateToWidth(extra, inner, "")}`);
                 }