@wrongstack/tui 0.303.0 → 0.305.1

package/dist/kanban-audit.d.ts

@@ -3,10 +3,17 @@
  *
  * Mirrors the WebUI's `packages/webui/src/lib/kanban-cleaner.ts` but
  * lives in the TUI package so we don't have to thread `@wrongstack/webui`
- * (which depends on React) into a server-side TUI pipeline. The two
- * implementations intentionally share the same audit-code vocabulary
- * (10 codes) and severity levels (`error`, `warning`) so a board audited
- * from either surface produces the same findings.
+ * (which depends on React) into a server-side TUI pipeline.
+ *
+ * The two implementations must produce the same verdicts for the same board.
+ * That claim used to be a comment; it is now enforced by
+ * `packages/cli/tests/kanban-cleaner-parity.test.ts`, which runs a shared
+ * corpus through both and compares the `taskId:code:severity` triples. Only
+ * three differences are deliberate, and all three are API shape rather than
+ * verdict: this file also accepts `liveAgentIdentities`, returns eight extra
+ * summary fields the WebUI's `KanbanCleanerAlert` fills from queue health, and
+ * exports `summarizeAuditHeadline` / `topAuditIssues` for the panel badge.
+ * Messages may differ; codes and severities may not.
  *
  * The output of `auditKanbanBoard()` feeds the TUI panel header badge so
  * users see Cleaner warnings inline — mirroring the WebUI's
@@ -14,7 +21,13 @@
  */
 import type { KanbanBoard } from '@wrongstack/kanban';
 export type KanbanAuditSeverity = 'error' | 'warning';
-export type KanbanAuditIssueCode = 'missing-description' | 'missing-assignee' | 'missing-due-date' | 'missing-labels' | 'missing-subtasks' | 'missing-success-criteria' | 'skipped-lifecycle-state' | 'abandoned-running-task' | 'stale-running-task' | 'stale-review';
+/**
+ * The audit vocabulary, as a runtime value so the parity test can compare the
+ * two implementations' code sets instead of trusting that both type unions
+ * were edited together.
+ */
+export declare const ALL_AUDIT_CODES: readonly ['abandoned-running-task', 'board-oversized', 'missing-assignee', 'missing-description', 'missing-due-date', 'missing-labels', 'missing-subtasks', 'missing-success-criteria', 'skipped-lifecycle-state', 'stale-review', 'stale-running-task'];
+export type KanbanAuditIssueCode = (typeof ALL_AUDIT_CODES)[number];
 export interface KanbanAuditIssue {
     id: string;
     taskId: string;

package/dist/kanban-slash.d.ts

@@ -6,7 +6,7 @@
  *
  *   /kanban                          — open the project kanban panel
  *   /kanban create <title>               — create a new board, then open the panel
- *   /kanban add <title> [--column X]     — add a task to the active board
+ *   /kanban add <title> [--column X] [--desc <text>] — add a task to the active board (managed boards require --desc)
  *   /kanban use <boardId|title|tag>      — open the kanban panel on a specific board
  *   /kanban boards                       — list every board in the project
  *   /kanban health                       — show kanban queue health summary
@@ -19,7 +19,7 @@
  * is the text-first equivalent for when the panel is closed.
  */
 import type { SlashCommand } from '@wrongstack/core/types';
-import type { KanbanBoundaryAccess, KanbanBoundaryPolicy, KanbanBoundarySelectorKind, KanbanBoardSummary, KanbanQueueHealth } from '@wrongstack/kanban';
+import type { KanbanBoardSummary, KanbanBoundaryAccess, KanbanBoundaryPolicy, KanbanBoundarySelectorKind, KanbanQueueHealth } from '@wrongstack/kanban';
 import { type KanbanAuditSummary } from './kanban-audit.js';
 /**
  * Result of resolving the board that an `add` operation should target.
@@ -34,6 +34,12 @@ export interface KanbanAddTarget {
     boardTitle: string;
     /** Column that the task will be placed in. Defaults to the first column. */
     columnId: string;
+    /**
+     * Whether the board enforces the managed Kanban Agent lifecycle. Managed
+     * boards require new cards to be created in the Backlog column and with a
+     * description, so callers route the user accordingly.
+     */
+    managed: boolean;
 }
 export interface KanbanSlashDeps {
     /**
@@ -78,6 +84,7 @@ export type ParsedKanbanArgs = {
     kind: 'add';
     title: string;
     column: string | null;
+    description?: string | undefined;
 } | {
     kind: 'use';
     query: string;

package/dist/theme.d.ts

@@ -10,6 +10,8 @@ export declare const pastel: Readonly<{
     readonly white: '#cdd6f4';
     readonly gray: '#7f849c';
     readonly grey: '#7f849c';
+    readonly grayBright: '#a6adc8';
+    readonly greyBright: '#a6adc8';
     readonly blackBright: '#585b70';
     readonly redBright: '#eba0ac';
     readonly greenBright: '#b8e8b0';
@@ -40,6 +42,8 @@ export declare const catppuccin: Readonly<{
     readonly white: '#cdd6f4';
     readonly gray: '#7f849c';
     readonly grey: '#7f849c';
+    readonly grayBright: '#a6adc8';
+    readonly greyBright: '#a6adc8';
     readonly blackBright: '#585b70';
     readonly redBright: '#eba0ac';
     readonly greenBright: '#b8e8b0';
@@ -55,11 +59,34 @@ export declare const catppuccin: Readonly<{
     readonly subtext0: '#a6adc8';
     readonly flamingo: '#f2cdcd';
 }>;
+/** The distinct things `highlightLine` can color. */
+export type SyntaxRole = 'keyword' | 'string' | 'comment' | 'commentOnWash' | 'number' | 'literal' | 'property' | 'variable' | 'command' | 'flag' | 'decorator' | 'diffAdd' | 'diffDel' | 'diffMeta';
+export type SyntaxPalette = Record<SyntaxRole, string>;
 /**
- * Resolve a color value to its pastel equivalent. Known ANSI names map to the
- * {@link pastel} hex; hex/rgb strings and unknown values (e.g. Ink's `'dim'`)
- * pass through unchanged. `undefined` stays `undefined` so callers can spread
- * it without forcing a color.
+ * Resolve one syntax role against a palette. A preset may pin any role
+ * explicitly via its optional `syntax` field (e.g. a scheme whose strings are
+ * orange rather than green); otherwise the role borrows the token named in
+ * {@link SYNTAX_TOKEN}. O(1) and allocation-free — this runs once per token
+ * per rendered line.
+ */
+export declare function resolveSyntaxColor(role: SyntaxRole, palette?: Theme): string;
+/** Materialize the full syntax palette for a theme. Used by tests and tooling. */
+export declare function resolveSyntaxPalette(palette?: Theme): SyntaxPalette;
+/**
+ * Resolve a color value to a concrete color.
+ *
+ * Three cases, in order:
+ *  - `syntax.<role>` resolves against the ACTIVE theme, so highlighting
+ *    follows `/theme` (see {@link resolveSyntaxColor}).
+ *  - A known ANSI name maps to its {@link pastel} hex. This map is frozen and
+ *    theme-independent by design — it is the floor for the ~177 call sites
+ *    that still pass bare names like `color="red"`.
+ *  - Anything else (hex, rgb, Ink's `'dim'`, an unknown name) passes through.
+ *
+ * `undefined` stays `undefined` so callers can spread it without forcing a
+ * color. NOTE: an unknown name that reaches Ink is silently DROPPED by chalk —
+ * the token renders with no color at all. Never emit a name that isn't
+ * resolvable here.
  */
 export declare function softColor(color?: string): string | undefined;
 /**
@@ -154,6 +181,14 @@ export interface Theme {
      */
     diffAddBg: string;
     diffDelBg: string;
+    /**
+     * Per-preset syntax-highlight overrides. OPTIONAL and normally omitted —
+     * every role has a sensible default derived from the tokens above (see
+     * `SYNTAX_TOKEN`), so a preset only pins a role when its scheme genuinely
+     * disagrees. Example: VS Code Dark+ colors strings orange, not green, so
+     * `dark-plus` pins `string`.
+     */
+    syntax?: Partial<SyntaxPalette> | undefined;
 }
 export declare const theme: Theme;
 /**

package/dist/ui-contracts.d.ts

@@ -126,6 +126,7 @@ export interface ToolPickerItem {
     owner: string;
     category: string;
     enabled: boolean;
+    exposure: 'direct' | 'lazy' | 'disabled';
     mutating: boolean;
     permission: string;
     descMode: 'extend' | 'simple';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrongstack/tui",
-  "version": "0.303.0",
+  "version": "0.305.1",
   "license": "MIT",
   "description": "WrongStack terminal UI: Ink-based interactive renderer with history, pickers, and slash menus.",
   "repository": {
@@ -29,12 +29,12 @@
     "ink": "7.1.1",
     "react": "^19.2.8",
     "string-width": "8.2.2",
-    "@wrongstack/kanban": "0.303.0",
-    "@wrongstack/core": "0.303.0",
-    "@wrongstack/sdd": "0.303.0",
-    "@wrongstack/runtime": "0.303.0",
-    "@wrongstack/sage": "0.303.0",
-    "@wrongstack/tools": "0.303.0"
+    "@wrongstack/core": "0.305.1",
+    "@wrongstack/runtime": "0.305.1",
+    "@wrongstack/kanban": "0.305.1",
+    "@wrongstack/sdd": "0.305.1",
+    "@wrongstack/sage": "0.305.1",
+    "@wrongstack/tools": "0.305.1"
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",