@agenit/cli 1.1.1 → 1.3.4

package/CHANGELOG.md

@@ -3,6 +3,375 @@
 All notable changes to `@agenit/cli` are documented here. The project
 follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.4] - 2026-05-09
+
+_Auto-generated entry. Edit CHANGELOG.md directly before
+the next release to curate this section._
+
+### Changed
+
+- Merge pull request #66 from muhammed-eldabea:fix/publish-repo-url (c9fce29)
+- fix(release): point package.json at the AgenIT repo for npm provenance (29ae4f3)
+
+## [1.3.3] - 2026-05-09
+
+_Auto-generated entry. Edit CHANGELOG.md directly before
+the next release to curate this section._
+
+### Changed
+
+- Merge pull request #65 from muhammed-eldabea/feat/right-rail-soul-codedigest (2d68ea4)
+- fix(repl): cycle focused job with Tab/Enter (Ctrl-J → key.return on Unix) (2263b19)
+- fix(rail): job-tray compact mode hid freshly-started jobs (d6d80ff)
+- fix(init): seed .flow/tools and .specify/memory/constitution.md (d87537a)
+- feat(repl): add Ctrl-U / Ctrl-D backlog scroll for Mac compact keyboards (b0aa9da)
+- feat(repl): scroll chat backlog with PgUp / PgDn (e955dbc)
+- fix(repl): bottom-anchor entries to a row budget to stop bleed-through (9aca93e)
+- fix(repl): word-wrap chat bubbles to bubble inner width (557ca5d)
+- fix(repl): chat bubbles size correctly to multi-line content (a273ab8)
+- fix(repl): write \r\n after rmcup so the shell prompt redraws on exit (cfcb1c6)
+- feat(repl): bordered chat bubbles for user / agent / system / error (86efadd)
+- fix(repl): single-line compact widgets so all four fit short terminals (f840bf7)
+- fix(repl): bound body row to terminal height, pin chat input at bottom (f03c7b1)
+- fix(repl): clear alt screen on resize to evict stale cells (e26907c)
+- fix(repl): run inside alternate screen buffer to fix resize-stacking (80b0c54)
+- fix(repl): chat in middle column + non-collapsing widget titles (4602787)
+- fix(repl): bordered widget frames + status-toned borders on the right rail (af75b12)
+- chore(release): bump @agenit/cli to 1.2.0 (2465b56)
+- feat(repl): add PINNED @-files section to the side rail (46a4dfa)
+- feat(repl): restyle ActivityStrip with chip vocabulary (feea7bb)
+- feat(repl): restyle StatusBar with branded logo + stat pills (0109db2)
+- feat(repl): add soul + codedigest sections to right rail (6f25ac0)
+- feat: enhance job detail panel with live reasoning display and adjust right rail width for better readability (680e820)
+- fix: improve tag resolution logic in release workflow for better validation (38cf4b4)
+- feat: enhance plan approval modal with scrolling and rendering improvements (d22cb9a)
+
+## [1.3.2] - 2026-05-09
+
+### Fixed
+
+- **Ctrl-J never cycled to the next focused job.** On Unix terminals
+  Ctrl-J generates LF (`\n`) — the same byte as Enter — and Ink
+  reports it as `key.return`, not `key.ctrl && ch === "j"`. So the
+  cycle handler never fired; the keystroke fell through, the panel
+  closed (or the empty-input submit ran), and "d" leaked into the
+  input field on the next user keypress. Tab and Enter now also
+  cycle when a job is already focused (the panel replaces the input
+  field, so Enter has no other meaning there); Ctrl-J is preserved
+  for terminals that do report it correctly. Footer hint updated to
+  `Tab / Enter to cycle to next job`.
+
+## [1.3.1] - 2026-05-09
+
+### Fixed
+
+- **Job Tray widget hides freshly-started jobs.** The compact-mode
+  summary line only listed `jobs[0].snapshot.label`, so when the
+  always-running `soul-keeper` daemon held the top slot, a `/goal start`
+  the user just kicked off was counted ("2 running") but invisible by
+  name. The summary now lists every job's `kind: label` joined by
+  middle-dots and adds a `Ctrl-] expand · Ctrl-G focus` hint at the
+  end (truncated to fit one row).
+
+## [1.3.0] - 2026-05-09
+
+### Fixed
+
+- **`/goal start` no longer dies with ENOENT on plan.md.** `agenit init`
+  was seeding `.gemini/skills/` and `.gemini/settings.json` but not
+  `.flow/tools/` or `.specify/memory/constitution.md`. The skill files
+  reference both — speckit-specify shells out to
+  `.flow/tools/speckit_native.py`, speckit-plan reads
+  `.specify/memory/constitution.md` on step 2 — so the skills installed
+  into a project but their runtime dependencies didn't, and the
+  pipeline died downstream when `plan-via-speckit` ENOENT'd on the
+  `plan.md` the skill never wrote (because the model was busy
+  thrashing for the missing tool/constitution and never reached
+  `write_file`).
+  `seedGeminiAssets` now also recursively copies `.flow/tools/*` from
+  flowHome and seeds a default `constitution.md` if the target lacks
+  one. Tool copies overwrite (CLI ships truth); constitution preserves
+  user edits across re-init.
+
+### Changed
+
+- **`agenit init` output adds two lines** reporting tool count and
+  constitution status, so users can confirm the bootstrap is complete
+  before running `/goal start`.
+
+## [1.2.13] - 2026-05-09
+
+### Changed
+
+- **Ctrl-U / Ctrl-D scroll the chat backlog (Mac-friendly).** Mac
+  compact keyboards don't have dedicated PgUp / PgDn keys — they
+  require Fn+Up / Fn+Down, which is awkward in a terminal. Ctrl-U
+  (older) and Ctrl-D (newer) follow the vim / less / tmux convention
+  and work on every keyboard. PgUp / PgDn still work for users with
+  full keyboards. Help banner and scroll hints updated to lead with
+  Ctrl-U / Ctrl-D.
+
+## [1.2.12] - 2026-05-09
+
+### Added
+
+- **PgUp / PgDn scroll the chat backlog.** The `↑ N earlier messages
+  above` hint was a dead end — there was no way to actually view those
+  older entries. PgUp now shifts the visible window backward through
+  history one entry at a time; PgDn shifts forward. The scroll offset
+  auto-resets to the bottom whenever a new entry arrives so users
+  always see the reply to the prompt they just sent. A `↓ N newer
+  message{s} below` hint surfaces at the bottom of the chat area when
+  scrollback is engaged. Help banner updated.
+
+## [1.2.11] - 2026-05-09
+
+### Fixed
+
+- **Long chat backlogs no longer bleed past the viewport.** When the
+  cumulative height of all entries exceeded the chat column's available
+  rows, Ink rendered them past the bottom of the viewport — producing
+  bleed-through artifacts (old chars from a prior frame staying on
+  cells the new frame didn't repaint, e.g. `cycle jobsory` instead of
+  `cycle jobs`). The entries window now uses a row budget instead of a
+  fixed count of 12: each entry's wrapped row count is measured via
+  the same `wordWrap` helper used for rendering, then we walk newest →
+  oldest and keep entries until the budget is hit, anchoring the latest
+  reply to the bottom. The `↑ N earlier` hint covers the rest. The
+  budget accounts for the activity strip, job strip, busy spinner,
+  expanded reasoning card, and picker dynamically.
+
+## [1.2.10] - 2026-05-09
+
+### Fixed
+
+- **Chat bubbles now contain wrapped text on narrow terminals.** When
+  an agent reply contained lines longer than the chat column, Ink
+  would word-wrap them visually but Yoga only counted the logical
+  lines toward the bubble's height — so the box clipped the bottom
+  rows of long answers. `MultilineText` now pre-wraps text at the
+  bubble's inner width (`cols − sideRail − rightRail − bubble chrome`)
+  using an ANSI-aware tokenizer, so each `<Text>` child equals exactly
+  one visual row and the box sizes correctly. Wide terminals were
+  unaffected because nothing wrapped; the bug was width-dependent.
+
+## [1.2.9] - 2026-05-09
+
+### Fixed
+
+- **Chat bubbles now contain multi-line content correctly.** The
+  agent's `/goal status` response (and any other multi-line markdown
+  reply) was overflowing past the bubble's bottom border because Ink
+  doesn't always count `\n` characters within a single `<Text>`
+  toward the parent Box's auto-height — especially when the string
+  carries ANSI escapes from `renderMarkdown`. EntryView now splits
+  each entry's text into one `<Text>` per line via a new
+  `MultilineText` helper; Ink counts children rather than
+  newline-characters, so the box sizes to N rows reliably.
+
+## [1.2.8] - 2026-05-09
+
+### Fixed
+
+- **Shell prompt now redraws after `/exit`.** The rmcup escape on
+  alt-screen exit restores the cursor to where it was when alt-screen
+  was entered — typically right after the `agenit\n` the user typed
+  to launch us, on a logically-blank line. zsh and bash only redraw
+  their prompt when the cursor is on a fresh line, so the user was
+  left staring at a blank line until they pressed Enter. The exit
+  hook now writes `\r\n` after rmcup to advance to a fresh line, so
+  the shell's prompt renders naturally on `/exit` / Ctrl-C / SIGTERM.
+
+## [1.2.7] - 2026-05-09
+
+### Changed
+
+- **Chat messages now render as bordered bubbles** — each entry
+  (user, agent, system, error) is wrapped in a rounded `<Box>` with
+  a status-toned border and a uppercase role badge inside the frame:
+  `● YOU` (blue), `● AGENT` (mint), `● SYSTEM` (amber), `● ERROR`
+  (red). Matches the right-rail widget vocabulary so the whole UI
+  reads as one consistent surface.
+
+## [1.2.6] - 2026-05-09
+
+UX patch — all four rail widgets fit even in short terminals.
+
+### Changed
+
+- **Compact mode is now a single body line per widget.** Each rail
+  widget renders as a 4-row card (frame top + title + 1 line + frame
+  bottom) with a status-toned dot in the title. The marginTop above
+  the frame goes to 0 in compact mode so widgets sit flush. Total
+  rail height: 16 rows for four widgets — fits in ≥ 18-row terminals.
+  Press Ctrl-] to expand any widget back to full detail.
+  - JOB TRAY compact: `N {status} · top-job kind: label`
+  - SOUL compact: `block heads · N entries`
+  - CODEDIGEST compact: `N chunks · built T · M recent`
+  - THINKING compact: last reasoning line only
+- `overflow="hidden"` added to the body row so any widget content
+  beyond the row's bounded height clips at the boundary instead of
+  bleeding into adjacent renders.
+
+## [1.2.5] - 2026-05-09
+
+UX patch on top of 1.2.4 — anchors the chat input at the bottom of
+the middle column and bounds rail widget height so chat is always
+visible.
+
+### Changed
+
+- **Body row is now bounded to the terminal height** (`rows`). The
+  middle column uses `justifyContent="space-between"` to pin chat
+  input + reasoning + activity at the bottom and let the entries
+  area flex-grow above. Resolves the bug where extending the
+  terminal vertically pushed the chat input below the visible area.
+- **Soul widget compact mode shows 1 block × 1 bullet only** — was 2
+  blocks × 3 bullets, which could overflow the rail height. Other
+  blocks surface as `+N more blocks · Ctrl-] to expand`. Full mode
+  (Ctrl-]) shows all blocks with up to 8 bullets each.
+
+### Fixed
+
+- **Soul bullet wrap-tails bleeding into the side rail are gone.**
+  Each `SoulRow` element now wraps its `<Text>` in an explicit
+  `<Box width={width}>` so Ink is forced to constrain the text to
+  the rail's column. Without the explicit width, Ink could fall
+  back to the text's natural length and wrap onto the next visual
+  line — visible as fragments like `ion code wi…`, `Clever embe…`,
+  `e. ASIL sco…` appearing in the side rail.
+
+## [1.2.4] - 2026-05-09
+
+UX patch on top of 1.2.3.
+
+### Fixed
+
+- **Resize artifacts cleared on every resize event.** Even inside the
+  alt screen, Ink only repaints cells the new frame visits — cells
+  the old frame wrote to that the new frame doesn't revisit kept
+  their old content. Visible as wrap-tail fragments from the right
+  rail (`ion code wi…`, `Clever embe…`, `ASIL sco…`) appearing in
+  the side rail's column after a narrow-to-wide or wide-to-narrow
+  resize. The resize handler in `App.tsx` now writes `\x1b[2J\x1b[H`
+  (clear screen + cursor home) before updating cols/rows state, so
+  Ink's next paint starts from a blank buffer.
+
+## [1.2.3] - 2026-05-09
+
+UX patch on top of 1.2.2 — fixes terminal-resize re-rendering and
+restores a clean exit experience.
+
+### Fixed
+
+- **Terminal resize no longer stacks stale layouts in scrollback.**
+  The REPL now runs inside the terminal's alternate screen buffer
+  (smcup / rmcup), the same mode `vim` / `htop` / `less` use. Resize,
+  re-render, and modal transitions all happen on a fresh buffer; the
+  original terminal state is restored on every exit path (clean exit,
+  Ctrl-C, SIGTERM, SIGHUP). Trade-off: the conversation isn't visible
+  in scrollback after `/exit`, but it persists to the session file
+  on disk — `agenit resume` recovers the transcript.
+
+## [1.2.2] - 2026-05-09
+
+UX patch on top of 1.2.1.
+
+### Changed
+
+- **Chat lives in the middle column now.** Previous renders put the
+  goal banner, user prompts, and agent responses into Ink's
+  `<Static>` (which renders into terminal scrollback above the
+  layout), so the middle column between the rails was empty. Entries
+  now render inside `main` between the StatusBar and the input,
+  capped to the last 12 messages so the layout stays bounded. A
+  dim `↑ N earlier messages above` hint surfaces when older entries
+  are off-screen. Trade-off: terminal scrollback no longer holds a
+  pristine copy of the conversation — but the layout matches the
+  three-pane workbench design.
+
+### Fixed
+
+- Widget titles (`JOB TRAY`, `SOUL`, `CODEDIGEST`, `THINKING`) no
+  longer collapse on short or narrow terminals. `WidgetFrame`
+  declares `flexShrink={0}` on itself, the title row, and the
+  subtitle row so Ink can't evict them when the rail's bounded
+  height is smaller than the natural content height. The fix
+  resolves the `1 runningY` row-collision artifact where
+  `JOB TRAY` was being squeezed into the subtitle row and only
+  the trailing `Y` survived.
+
+## [1.2.1] - 2026-05-09
+
+UX patch on top of 1.2.0 — fixes the right-rail rendering issues
+spotted on a 56-col rail where the title and subtitle of each
+section collided onto the same row.
+
+### Fixed
+
+- Each rail section is now wrapped in a single bordered `WidgetFrame`
+  with a status-toned border (idle=blue, running=green, stopped=red)
+  rather than relying on per-card borders alone. The section title
+  and subtitle live inside that frame on separate rows — the
+  letter-spacing trick that was producing `T R A Y` collisions has
+  been removed.
+- Job tray, codedigest, and thinking widgets compute their own status
+  tone from their data: jobs running / jobs errored, codedigest
+  index missing / recently searched, reasoning fresh / stale.
+- Goal-kind job rows now get a full progress bar with percentage and
+  an elapsed-time line so the goal widget reads as a primary surface.
+  Other job kinds keep the compact two-line layout.
+
+## [1.2.0] - 2026-05-09
+
+A minor bump for a redesign pass on the rail chrome: the right rail
+now carries soul, codedigest, and reasoning sections alongside the
+job tray; the top status bar gets stat pills; the side rail carries
+recent `@`-paths under the V-Model view.
+
+### Added
+
+- **Right rail** — three new sections beyond the existing job tray:
+  `SOUL` (per-block cards from `.flow/soul.md`, refreshed every 2s),
+  `CODEDIGEST` (chunk count + last-build freshness + language pills +
+  recent searches with top-hit location), and `THINKING` (tail of the
+  live reasoning stream). Folding is mode-driven: compact by default,
+  full when widened.
+- **Resizable right rail** — width now scales proportionally with the
+  terminal (`clamp(36, 30%·cols, 56)` default) instead of jumping
+  between fixed tiers. `Ctrl-]` toggles a wider mode
+  (`clamp(48, 42%·cols, 80)`) that keeps the chat visible — the
+  inline counterpart to the full-screen `Ctrl-J` / `Ctrl-G` modal.
+- **Status bar restyle** — branded `agenIT flow` logo with the IT
+  highlighted in the design's signal red, a project context pill
+  (`[ ● project · ⎇ branch ]`), and right-aligned bracket pills for
+  YOLO / MODEL / STAGE.
+- **ActivityStrip chips** — skill / agent / tool counts now render as
+  bracket pills with per-kind tool color coding (write=red,
+  read=muted, shell=amber).
+- **PINNED side-rail section** — the side rail now keeps a 5-deep
+  list of `@`-paths the user referenced in their last few prompts.
+  Long paths ellipsize from the left so the basename is preserved.
+- `/codedigest search` results are recorded into an in-memory ring
+  buffer (capacity 10) so the rail can show what was searched without
+  changing the `@flow/codedigest` API.
+
+### Changed
+
+- `RightRail` no longer guards on `tuiState.backgroundJobs.length > 0`
+  — it renders whenever any of jobs / soul / codedigest / reasoning
+  has content. Empty terminals (no project, no jobs) still drop to
+  a clean chat view.
+- `pickRightRailMode` simplified from four tiers (wide/narrow/strip/
+  hidden) to three (rail/strip/hidden); width is computed by the new
+  `rightRailColumns(cols, expanded)` helper.
+
+### Removed
+
+- Old `JobCard` and `solveJobLayout` per-card vertical-flex allocator
+  — superseded by the section-host design where each section bounds
+  its own content. `JobStrip` (narrow-mode fallback) is unchanged.
+
 ## [1.1.1] - 2026-05-08
 
 A patch bump on top of 1.1.0 covering the rebuild after the