Release v1.0.25

Author: oxgeneral

CHANGELOG.md

@@ -3,6 +3,19 @@
 All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
+## 1.0.25 (2026-06-28)
+
+### Bug Fixes
+
+- **TUI task wizard: reliable textarea confirmation fallback** ([#13](https://github.com/oxgeneral/ORCH/issues/13)) — `Tab` now confirms every `FormWizard` step, including multiline `Description` fields. This keeps `Enter` available for textarea newlines while giving Windows, WSL, CMD, PowerShell, Git Bash, and terminals without reliable `Ctrl+Enter` support a deterministic way to finish the step.
+- **Wizard hints updated for the new shortcut** — text/select/multiselect steps now show `Enter/Tab confirm`; textarea steps show `⌘+Enter/Tab confirm` on macOS and `Ctrl+Enter/Tab confirm` elsewhere.
+
+### Tests
+
+- Added component coverage for `Tab` confirmation in text, textarea, required textarea, and multiselect steps.
+- Added App-level coverage for creating a task with a textarea description confirmed by `Tab`.
+- Verified the fix manually in a real terminal PTY: task creation persisted the description after `Tab` confirmation.
+
 ## 1.0.24 (2026-05-19)
 
 ### New Features

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxgeneral/orch",
-  "version": "1.0.24",
+  "version": "1.0.25",
   "description": "AI agent runtime — orchestrate Claude, Cursor, Codex & OpenCode as one team. Multi-agent task automation with state machine, auto-retry, inter-agent messaging, goals and teams. Zero-config CLI + programmatic API.",
   "type": "module",
   "engines": {

package.json

@@ -42,7 +42,7 @@ const program = new Command();
 program
   .name('orchestry')
   .description('Agents Organizations — CLI orchestrator for AI agents')
-  .version('1.0.24')
+  .version('1.0.25')
   .option('--json', 'Output as JSON')
   .option('--quiet', 'Minimal output (IDs only)')
   .option('--no-color', 'Disable colors')

src/bin/cli.ts

@@ -398,8 +398,8 @@ export function FormWizard({ title, steps, onComplete, onCancel, width, height,
         // fall through to normal text handling below
       }
 
-      // Enter: submit text step
-      if (key.return) {
+      // Enter / Tab: submit text step
+      if (key.return || key.tab) {
         const val = textInput.trim();
         if (step.required && !val) { setDirty(true); return; }
         if (validationError !== null) {
@@ -434,8 +434,9 @@ export function FormWizard({ title, steps, onComplete, onCancel, width, height,
     }
 
     if (step.type === 'textarea') {
-      // Ctrl+Enter / Cmd+Enter: confirm textarea
-      if (key.return && (key.ctrl || key.meta)) {
+      // Ctrl+Enter / Cmd+Enter confirm textarea. Tab is a fallback for
+      // terminals that cannot distinguish Ctrl+Enter from plain Enter.
+      if ((key.return && (key.ctrl || key.meta)) || key.tab) {
         const val = taLines.join('\n').trim();
         if (step.required && !val) { setDirty(true); return; }
         if (validationError !== null) {
@@ -664,7 +665,7 @@ export function FormWizard({ title, steps, onComplete, onCancel, width, height,
           return;
         }
       } else {
-        // Multiselect: Space toggle, Enter confirm
+        // Multiselect: Space toggle, Enter / Tab confirm
         if (input === ' ') {
           const opt = options[clampedSelectIndex];
           if (opt) {
@@ -680,7 +681,7 @@ export function FormWizard({ title, steps, onComplete, onCancel, width, height,
           }
           return;
         }
-        if (key.return) {
+        if (key.return || key.tab) {
           const selected = Array.from(multiSelected).join(',');
           goToNextStep(selected);
           return;
@@ -728,7 +729,7 @@ export function FormWizard({ title, steps, onComplete, onCancel, width, height,
       <Box marginTop={0}>
         <Text color={tuiColors.white} bold>  {step.label}</Text>
         {step.required && <Text color={tuiColors.red}> *</Text>}
-        {!step.required && <Text color={tuiColors.dim}> (optional, {step.type === 'textarea' ? `${CMD_KEY}+Enter` : 'Enter'} to skip)</Text>}
+        {!step.required && <Text color={tuiColors.dim}> (optional, {step.type === 'textarea' ? `${CMD_KEY}+Enter/Tab` : 'Enter/Tab'} to skip)</Text>}
       </Box>
 
       {/* Step description / guidance */}
@@ -895,16 +896,16 @@ export function FormWizard({ title, steps, onComplete, onCancel, width, height,
         <Text color={tuiColors.ghost}>
           {'  '}
           {step.type === 'select'
-            ? '\u2191\u2193 select  Enter confirm'
+            ? '\u2191\u2193 select  Enter/Tab confirm'
             : step.type === 'multiselect'
-              ? '\u2191\u2193 move  Space toggle  Enter confirm'
+              ? '\u2191\u2193 move  Space toggle  Enter/Tab confirm'
               : step.type === 'textarea'
-                ? `Enter newline  ${CMD_KEY}+Enter confirm  \u2190\u2191\u2192\u2193 navigate`
+                ? `Enter newline  ${CMD_KEY}+Enter/Tab confirm  \u2190\u2191\u2192\u2193 navigate`
                 : browsingSuggestions
-                  ? '\u2191\u2193 browse  Enter select  \u2191 back to input'
+                  ? '\u2191\u2193 browse  Enter select  Tab confirm  \u2191 back to input'
                   : step.suggestions
-                    ? '\u2190\u2192 move  Enter confirm  \u2193 browse templates'
-                    : '\u2190\u2192 move  Enter confirm'}
+                    ? '\u2190\u2192 move  Enter/Tab confirm  \u2193 browse templates'
+                    : '\u2190\u2192 move  Enter/Tab confirm'}
           {onPasteImage && (step.type === 'text' || step.type === 'textarea') ? `  ${CMD_KEY}+V paste image` : ''}
           {'  Esc '}
           {currentStep > 0 ? 'back' : 'cancel'}

src/tui/components/FormWizard.tsx

@@ -758,6 +758,36 @@ describe('App', () => {
     expect(output).toContain('Created');
   });
 
+  it('creates task via wizard with textarea confirmed by Tab', async () => {
+    const state: OrchestratorState = { ...DEFAULT_STATE };
+    let createdDescription: string | undefined;
+    const onCreateTask = async (title: string, opts?: { description?: string }) => {
+      createdDescription = opts?.description;
+      return makeTask({ id: 'tsk_tab', title, description: opts?.description });
+    };
+    const { stdin, lastFrame } = render(
+      React.createElement(App, { projectName: 'test', tasks: [], state, onCreateTask }),
+    );
+
+    stdin.write('n');
+    await delay(50);
+    stdin.write('Build API');
+    await delay(50);
+    stdin.write('\r');
+    await delay(50);
+    stdin.write('\r');
+    await delay(50);
+    expect(lastFrame()!).toContain('Enter/Tab confirm');
+
+    stdin.write('Created through Tab fallback');
+    await delay(50);
+    stdin.write('\t');
+    await delay(100);
+
+    expect(createdDescription).toBe('Created through Tab fallback');
+    expect(lastFrame()!).toContain('Created');
+  });
+
   it('does not create task on Enter with empty title in wizard', async () => {
     const state: OrchestratorState = { ...DEFAULT_STATE };
     let called = false;

test/unit/tui/app.test.tsx

@@ -109,7 +109,7 @@ describe('FormWizard textarea', () => {
     await delay(50);
     const output = lastFrame()!;
     expect(output).toContain('Enter newline');
-    expect(output).toContain('Enter confirm');
+    expect(output).toContain('Enter/Tab confirm');
     expect(output).toContain('navigate');
   });
 
@@ -129,7 +129,30 @@ describe('FormWizard textarea', () => {
     await delay(50);
     const output = lastFrame()!;
     expect(output).toContain('←→ move');
-    expect(output).toContain('Enter confirm');
+    expect(output).toContain('Enter/Tab confirm');
+  });
+
+  it('Tab confirms text step without inserting a tab character', async () => {
+    const onComplete = vi.fn();
+    const onCancel = vi.fn();
+    const { stdin } = render(
+      React.createElement(FormWizard, {
+        title: 'Test',
+        steps: [{ id: 'title', label: 'Title', type: 'text' }],
+        onComplete,
+        onCancel,
+        width: 60,
+        height: 20,
+      }),
+    );
+    await delay(50);
+
+    stdin.write('Hello');
+    await delay(50);
+    stdin.write('\t');
+    await delay(50);
+
+    expect(onComplete).toHaveBeenCalledWith({ title: 'Hello' });
   });
 
   /* ── Enter adds new line (Shift+Enter also works) ── */
@@ -194,6 +217,29 @@ describe('FormWizard textarea', () => {
     expect(onComplete).toHaveBeenCalledWith({ body: 'Hello world' });
   });
 
+  it('Tab confirms textarea as fallback for terminals without Ctrl+Enter support', async () => {
+    const onComplete = vi.fn();
+    const onCancel = vi.fn();
+    const { stdin } = render(
+      React.createElement(FormWizard, {
+        title: 'Test',
+        steps: makeTextareaSteps(),
+        onComplete,
+        onCancel,
+        width: 60,
+        height: 20,
+      }),
+    );
+    await delay(50);
+
+    stdin.write('Hello from tab');
+    await delay(50);
+    stdin.write('\t');
+    await delay(50);
+
+    expect(onComplete).toHaveBeenCalledWith({ body: 'Hello from tab' });
+  });
+
   it('Ctrl+Enter confirms multiline textarea with newlines joined', async () => {
     const onComplete = vi.fn();
     const onCancel = vi.fn();
@@ -243,6 +289,27 @@ describe('FormWizard textarea', () => {
     expect(onComplete).not.toHaveBeenCalled();
   });
 
+  it('Tab on empty required textarea does not confirm', async () => {
+    const onComplete = vi.fn();
+    const onCancel = vi.fn();
+    const { stdin } = render(
+      React.createElement(FormWizard, {
+        title: 'Test',
+        steps: makeTextareaSteps({ required: true }),
+        onComplete,
+        onCancel,
+        width: 60,
+        height: 20,
+      }),
+    );
+    await delay(50);
+
+    stdin.write('\t');
+    await delay(50);
+
+    expect(onComplete).not.toHaveBeenCalled();
+  });
+
   /* ── Cursor navigation ── */
 
   it('←→ arrows move cursor in textarea', async () => {
@@ -1104,6 +1171,39 @@ describe('FormWizard inline validation', () => {
     expect(onComplete).not.toHaveBeenCalled();
   });
 
+  it('Tab confirms multiselect step with current selection', async () => {
+    const onComplete = vi.fn();
+    const { stdin, lastFrame } = render(
+      React.createElement(FormWizard, {
+        title: 'Test',
+        steps: [
+          {
+            id: 'skills',
+            label: 'Skills',
+            type: 'multiselect',
+            options: [
+              { value: 'frontend', label: 'Frontend' },
+              { value: 'backend', label: 'Backend' },
+            ],
+          },
+        ],
+        onComplete,
+        onCancel: vi.fn(),
+        width: 60,
+        height: 20,
+      }),
+    );
+    await delay(50);
+    expect(lastFrame()!).toContain('Enter/Tab confirm');
+
+    stdin.write(' ');
+    await delay(50);
+    stdin.write('\t');
+    await delay(50);
+
+    expect(onComplete).toHaveBeenCalledWith({ skills: 'frontend' });
+  });
+
   /* ── validationError reset on step navigation ── */
 
   it('validationError is reset when advancing to next step', async () => {