nubos-pilot 0.5.3 → 0.5.4

package/bin/np-tools/_commands.cjs

@@ -44,6 +44,7 @@ const COMMANDS = [
   { name: 'commit',          category: 'Utility', description: 'Atomic git commit wrapper with gitignore-guard' },
   { name: 'config-get',      category: 'Utility', description: 'Read value from .nubos-pilot/config.json by dotted key path' },
   { name: 'lang-directive',  category: 'Utility', description: 'Print workflow language directive from config.response_language (SSOT)' },
+  { name: 'text-mode',       category: 'Utility', description: 'Print whether text mode is active (config.workflow.text_mode ∨ CLAUDECODE)' },
   { name: 'generate-slug',   category: 'Utility', description: 'Slugify text via lib/layout.cjs.slugify' },
   { name: 'stats',           category: 'Utility', description: 'Aggregated project stats (roadmap + STATE + git + metrics JSON shape)' },
 

package/bin/np-tools/add-tests.cjs

@@ -5,6 +5,7 @@ const { NubosPilotError, atomicWriteFileSync, withFileLock } = require('../../li
 const { getPhase } = require('../../lib/roadmap.cjs');
 const layout = require('../../lib/layout.cjs');
 const { parseVerificationMd, milestoneVerificationPath } = require('../../lib/verify.cjs');
+const textMode = require('../../lib/text-mode.cjs');
 
 const BEGIN_MARKER = '// >>> np:add-tests begin';
 const END_MARKER = '// <<< np:add-tests end';
@@ -138,6 +139,7 @@ function run(args, ctx) {
       const mNum = _validateMilestoneArg(list[1]);
       const target = _resolveTestTarget(mNum, cwd);
       const { passes, skips, verification_path } = _loadCases(mNum, cwd);
+      const tmDetail = textMode.resolveTextModeDetail(cwd);
       const payload = {
         _workflow: 'add-tests',
         milestone: mNum,
@@ -146,6 +148,8 @@ function run(args, ctx) {
         verification_path,
         pass_cases: passes,
         skip_cases: skips,
+        text_mode: tmDetail.enabled,
+        text_mode_source: tmDetail.source,
       };
       stdout.write(JSON.stringify(payload, null, 2));
       return payload;

package/bin/np-tools/add-todo.cjs

@@ -3,6 +3,7 @@ const path = require('node:path');
 
 const { projectStateDir, NubosPilotError } = require('../../lib/core.cjs');
 const { slugify } = require('../../lib/layout.cjs');
+const textMode = require('../../lib/text-mode.cjs');
 
 const MAX_DESCRIPTION_LENGTH = 500;
 
@@ -54,6 +55,7 @@ function _buildPayload(description, cwd) {
   }
   const todos_dir_exists = fs.existsSync(todosDir);
   const state_path = path.join(stateDir, 'STATE.md');
+  const tmDetail = textMode.resolveTextModeDetail(cwd);
   return {
     _workflow: 'add-todo',
     commit_docs: true,
@@ -66,6 +68,8 @@ function _buildPayload(description, cwd) {
     todos_dir_exists,
     todo_count,
     state_path,
+    text_mode: tmDetail.enabled,
+    text_mode_source: tmDetail.source,
     todos: [],
   };
 }

package/bin/np-tools/discuss-phase.cjs

@@ -8,6 +8,7 @@ const crypto = require('node:crypto');
 const { NubosPilotError, projectStateDir } = require('../../lib/core.cjs');
 const { getPhase } = require('../../lib/roadmap.cjs');
 const layout = require('../../lib/layout.cjs');
+const textMode = require('../../lib/text-mode.cjs');
 
 const INLINE_THRESHOLD_BYTES = 16 * 1024;
 
@@ -96,6 +97,8 @@ function run(args, ctx) {
   const has_context = fs.existsSync(contextPath);
   const has_milestone_dir = fs.existsSync(milestoneDir);
 
+  const tmDetail = textMode.resolveTextModeDetail(cwd);
+
   const payload = {
     _workflow: 'discuss-phase',
     milestone: mNum,
@@ -109,6 +112,8 @@ function run(args, ctx) {
     requirements: Array.isArray(def.requirements) ? def.requirements : [],
     success_criteria: Array.isArray(def.success_criteria) ? def.success_criteria : [],
     mode: flags.assumptions ? 'assumptions' : 'adaptive',
+    text_mode: tmDetail.enabled,
+    text_mode_source: tmDetail.source,
     agent_skills: _agentSkills(),
   };
 

package/bin/np-tools/discuss-phase.test.cjs

@@ -7,6 +7,20 @@ const { makeSandbox, seedRoadmapYaml, cleanupAll } =
   require('../../tests/helpers/fixture.cjs');
 const subcmd = require('./discuss-phase.cjs');
 
+function _clearClaudeEnv() {
+  const saved = {};
+  for (const k of ['CLAUDECODE', 'CLAUDE_CODE_ENTRYPOINT']) {
+    saved[k] = process.env[k];
+    delete process.env[k];
+  }
+  return () => {
+    for (const [k, v] of Object.entries(saved)) {
+      if (v === undefined) delete process.env[k];
+      else process.env[k] = v;
+    }
+  };
+}
+
 function _baseRoadmap() {
   return {
     schema_version: 1,
@@ -42,24 +56,67 @@ function _captureStdout() {
 afterEach(cleanupAll);
 
 test('DP-1: run(["3"]) on valid milestone returns JSON payload with expected shape', () => {
-  const sandbox = makeSandbox();
-  seedRoadmapYaml(sandbox, _baseRoadmap());
-  const cap = _captureStdout();
-  subcmd.run(['3'], { cwd: sandbox, stdout: cap.stub });
-  const raw = cap.get().trim();
-  assert.ok(!raw.startsWith('@file:'));
-  const payload = JSON.parse(raw);
-  assert.equal(payload.milestone, 3);
-  assert.equal(payload.milestone_id, 'M003');
-  assert.ok(payload.milestone_dir.endsWith(path.join('.nubos-pilot', 'milestones', 'M003')));
-  assert.ok(payload.milestone_context_path.endsWith(path.join('M003', 'M003-CONTEXT.md')));
-  assert.equal(payload.milestone_name, 'Observability');
-  assert.equal(payload.has_context, false);
-  assert.equal(payload.has_milestone_dir, false);
-  assert.equal(payload.goal, 'Ship structured logging + metrics');
-  assert.deepEqual(payload.requirements, ['OBS-01']);
-  assert.ok('agent_skills' in payload);
-  assert.equal(payload.mode, 'adaptive');
+  const restore = _clearClaudeEnv();
+  try {
+    const sandbox = makeSandbox();
+    seedRoadmapYaml(sandbox, _baseRoadmap());
+    const cap = _captureStdout();
+    subcmd.run(['3'], { cwd: sandbox, stdout: cap.stub });
+    const raw = cap.get().trim();
+    assert.ok(!raw.startsWith('@file:'));
+    const payload = JSON.parse(raw);
+    assert.equal(payload.milestone, 3);
+    assert.equal(payload.milestone_id, 'M003');
+    assert.ok(payload.milestone_dir.endsWith(path.join('.nubos-pilot', 'milestones', 'M003')));
+    assert.ok(payload.milestone_context_path.endsWith(path.join('M003', 'M003-CONTEXT.md')));
+    assert.equal(payload.milestone_name, 'Observability');
+    assert.equal(payload.has_context, false);
+    assert.equal(payload.has_milestone_dir, false);
+    assert.equal(payload.goal, 'Ship structured logging + metrics');
+    assert.deepEqual(payload.requirements, ['OBS-01']);
+    assert.ok('agent_skills' in payload);
+    assert.equal(payload.mode, 'adaptive');
+    assert.equal(payload.text_mode, false);
+    assert.equal(payload.text_mode_source, 'default');
+  } finally {
+    restore();
+  }
+});
+
+test('DP-1b: CLAUDECODE=1 sets text_mode=true with runtime source', () => {
+  const restore = _clearClaudeEnv();
+  try {
+    process.env.CLAUDECODE = '1';
+    const sandbox = makeSandbox();
+    seedRoadmapYaml(sandbox, _baseRoadmap());
+    const cap = _captureStdout();
+    subcmd.run(['3'], { cwd: sandbox, stdout: cap.stub });
+    const payload = JSON.parse(cap.get().trim());
+    assert.equal(payload.text_mode, true);
+    assert.equal(payload.text_mode_source, 'runtime');
+  } finally {
+    restore();
+  }
+});
+
+test('DP-1c: config workflow.text_mode=false wins over CLAUDECODE', () => {
+  const restore = _clearClaudeEnv();
+  try {
+    process.env.CLAUDECODE = '1';
+    const sandbox = makeSandbox();
+    seedRoadmapYaml(sandbox, _baseRoadmap());
+    fs.writeFileSync(
+      path.join(sandbox, '.nubos-pilot', 'config.json'),
+      JSON.stringify({ workflow: { text_mode: false } }),
+    );
+    const cap = _captureStdout();
+    subcmd.run(['3'], { cwd: sandbox, stdout: cap.stub });
+    const payload = JSON.parse(cap.get().trim());
+    assert.equal(payload.text_mode, false);
+    assert.equal(payload.text_mode_source, 'config');
+  } finally {
+    restore();
+  }
 });
 
 test('DP-2: run(["nonexistent"]) throws discuss-invalid-phase-arg', () => {

package/bin/np-tools/discuss-project.cjs

@@ -4,6 +4,7 @@ const path = require('node:path');
 const { NubosPilotError, atomicWriteFileSync } = require('../../lib/core.cjs');
 const { scan } = require('../../lib/workspace-scan.cjs');
 const { workspaceGitInfo } = require('../../lib/git.cjs');
+const textMode = require('../../lib/text-mode.cjs');
 
 const TEMPLATES_DIR = path.join(__dirname, '..', '..', 'templates');
 const PLACEHOLDER_RE = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/g;
@@ -98,6 +99,8 @@ function _emitPlan(projectRoot, flags, stdout) {
 
   const scanContext = _scanContextFor(projectRoot);
 
+  const tmDetail = textMode.resolveTextModeDetail(projectRoot);
+
   stdout.write(JSON.stringify({
     mode: 'plan',
     sub_mode: mode,
@@ -107,6 +110,8 @@ function _emitPlan(projectRoot, flags, stdout) {
     questions: _grayAreas(),
     required_fields: REQUIRED_FIELDS,
     requirements_md_path: path.join(projectRoot, '.nubos-pilot', 'REQUIREMENTS.md'),
+    text_mode: tmDetail.enabled,
+    text_mode_source: tmDetail.source,
   }, null, 2));
 }
 

package/bin/np-tools/execute-milestone.cjs

@@ -13,6 +13,7 @@ const layout = require('../../lib/layout.cjs');
 const { getPhase } = require('../../lib/roadmap.cjs');
 const { extractFrontmatter } = require('../../lib/frontmatter.cjs');
 const { getAgentSkills } = require('../../lib/agents.cjs');
+const textMode = require('../../lib/text-mode.cjs');
 
 const INLINE_THRESHOLD_BYTES = 16 * 1024;
 
@@ -119,6 +120,8 @@ function _initPayload(mNum, cwd) {
       tasks,
     });
   }
+  const tmDetail = textMode.resolveTextModeDetail(cwd);
+
   return {
     _workflow: 'execute-milestone',
     milestone: mNum,
@@ -132,6 +135,8 @@ function _initPayload(mNum, cwd) {
     total_tasks: totalTasks,
     slice_count: slices.length,
     executor_tier: 'sonnet',
+    text_mode: tmDetail.enabled,
+    text_mode_source: tmDetail.source,
     agent_skills: { executor: _safeSkills('np-executor', cwd) },
   };
 }

package/bin/np-tools/new-milestone.cjs

@@ -13,6 +13,7 @@ const {
 const { parseRoadmap } = require('../../lib/roadmap.cjs');
 const { mutateState } = require('../../lib/state.cjs');
 const layout = require('../../lib/layout.cjs');
+const textMode = require('../../lib/text-mode.cjs');
 
 const TEMPLATES_DIR = path.join(__dirname, '..', '..', 'templates', 'milestone');
 const PLACEHOLDER_RE = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/g;
@@ -49,9 +50,12 @@ function _emit(stdout, payload) {
   stdout.write(JSON.stringify(payload, null, 2));
 }
 
-function _interviewPayload() {
+function _interviewPayload(cwd) {
+  const tmDetail = textMode.resolveTextModeDetail(cwd);
   return {
     mode: 'interview',
+    text_mode: tmDetail.enabled,
+    text_mode_source: tmDetail.source,
     questions: [
       { key: 'milestone_name', type: 'input',
         question: 'Milestone name (e.g. "Auth & Basic UI")?' },
@@ -282,7 +286,7 @@ function run(args, ctx) {
     return;
   }
 
-  _emit(stdout, _interviewPayload());
+  _emit(stdout, _interviewPayload(cwd));
 }
 
 module.exports = { run, _interviewPayload };

package/bin/np-tools/new-project.cjs

@@ -10,6 +10,7 @@ const {
 } = require('../../lib/core.cjs');
 const { writeState } = require('../../lib/state.cjs');
 const layout = require('../../lib/layout.cjs');
+const textMode = require('../../lib/text-mode.cjs');
 
 const TEMPLATES_DIR = path.join(__dirname, '..', '..', 'templates');
 const PLACEHOLDER_RE = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/g;
@@ -42,9 +43,12 @@ function _todayIso() {
   return new Date().toISOString().slice(0, 10);
 }
 
-function _interviewPayload() {
+function _interviewPayload(cwd) {
+  const tmDetail = textMode.resolveTextModeDetail(cwd);
   return {
     mode: 'interview',
+    text_mode: tmDetail.enabled,
+    text_mode_source: tmDetail.source,
     questions: [
       { key: 'project_name', type: 'input',
         question: 'Project name?' },
@@ -286,7 +290,7 @@ function run(args, ctx) {
     return;
   }
 
-  _emit(stdout, _interviewPayload());
+  _emit(stdout, _interviewPayload(cwd));
 }
 
 module.exports = { run, _interviewPayload, _slugify };

package/bin/np-tools/plan-milestone.cjs

@@ -14,6 +14,7 @@ const {
 const layout = require('../../lib/layout.cjs');
 const { getPhase } = require('../../lib/roadmap.cjs');
 const { getAgentSkills } = require('../../lib/agents.cjs');
+const textMode = require('../../lib/text-mode.cjs');
 
 const INLINE_THRESHOLD_BYTES = 16 * 1024;
 
@@ -104,6 +105,8 @@ function _initPayload(mNum, cwd) {
     };
   });
 
+  const tmDetail = textMode.resolveTextModeDetail(cwd);
+
   return {
     _workflow: 'plan-milestone',
     milestone: mNum,
@@ -122,6 +125,8 @@ function _initPayload(mNum, cwd) {
     existing_slices: sliceStatus,
     planner_tier: 'opus',
     checker_tier: 'opus',
+    text_mode: tmDetail.enabled,
+    text_mode_source: tmDetail.source,
     agent_skills: {
       'np-planner': _safeSkills('np-planner', cwd),
       'np-plan-checker': _safeSkills('np-plan-checker', cwd),

package/bin/np-tools/research-phase.cjs

@@ -7,6 +7,7 @@ const crypto = require('node:crypto');
 
 const { NubosPilotError, projectStateDir } = require('../../lib/core.cjs');
 const layout = require('../../lib/layout.cjs');
+const textMode = require('../../lib/text-mode.cjs');
 
 const INLINE_THRESHOLD_BYTES = 16 * 1024;
 
@@ -107,6 +108,8 @@ function run(args, ctx) {
     };
   });
 
+  const tmDetail = textMode.resolveTextModeDetail(cwd);
+
   const payload = {
     _workflow: 'research-phase',
     milestone: mNum,
@@ -118,6 +121,8 @@ function run(args, ctx) {
     has_research,
     slice_research: sliceResearch,
     tools_available: _toolsAvailable(),
+    text_mode: tmDetail.enabled,
+    text_mode_source: tmDetail.source,
     agent_skills: _agentSkills(cwd),
   };
   _emit(payload, stdout, cwd);

package/bin/np-tools/resume-work.cjs

@@ -4,6 +4,7 @@ const { NubosPilotError } = require('../../lib/core.cjs');
 const { readState } = require('../../lib/state.cjs');
 const { readCheckpoint, listCheckpoints } = require('../../lib/checkpoint.cjs');
 const { TASK_ID_RE } = require('../../lib/tasks.cjs');
+const textMode = require('../../lib/text-mode.cjs');
 
 function _safeReadState(cwd) {
   try { return readState(cwd); } catch { return null; }
@@ -69,6 +70,10 @@ function run(_args, ctx) {
     };
   }
 
+  const tmDetail = textMode.resolveTextModeDetail(cwd);
+  payload.text_mode = tmDetail.enabled;
+  payload.text_mode_source = tmDetail.source;
+
   stdout.write(JSON.stringify(payload));
   return payload;
 }

package/bin/np-tools/text-mode.cjs

@@ -0,0 +1,56 @@
+'use strict';
+
+const { resolveTextModeDetail } = require('../../lib/text-mode.cjs');
+
+function _usage() {
+  return 'Usage:\n  np-tools.cjs text-mode [--json]';
+}
+
+function _emitError(err, stderr) {
+  const code = err && err.name === 'NubosPilotError' ? err.code : 'text-mode-internal-error';
+  const message = (err && err.message) || String(err);
+  const details = (err && err.details) || null;
+  stderr.write(JSON.stringify({ code, message, details }) + '\n');
+}
+
+function run(argv, ctx) {
+  const context = ctx || {};
+  const cwd = context.cwd || process.cwd();
+  const stdout = context.stdout || process.stdout;
+  const stderr = context.stderr || process.stderr;
+  const args = Array.isArray(argv) ? argv.slice() : [];
+
+  let wantJson = false;
+  for (const a of args) {
+    if (a === '--json') { wantJson = true; continue; }
+    if (a === '-h' || a === '--help') {
+      stdout.write(_usage() + '\n');
+      return 0;
+    }
+    stderr.write(JSON.stringify({
+      code: 'text-mode-unknown-arg',
+      message: 'Unknown argument: ' + a,
+      details: { arg: a },
+    }) + '\n');
+    return 1;
+  }
+
+  try {
+    const detail = resolveTextModeDetail(cwd);
+    if (wantJson) {
+      stdout.write(JSON.stringify(detail) + '\n');
+    } else {
+      stdout.write(String(detail.enabled) + '\n');
+    }
+    return 0;
+  } catch (err) {
+    _emitError(err, stderr);
+    return 1;
+  }
+}
+
+module.exports = { run };
+
+if (require.main === module) {
+  process.exit(run(process.argv.slice(2)));
+}

package/bin/np-tools/text-mode.test.cjs

@@ -0,0 +1,132 @@
+'use strict';
+
+const { test } = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+
+const subcmd = require('./text-mode.cjs');
+
+function _mkSandbox() {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'np-text-mode-cli-'));
+  fs.mkdirSync(path.join(dir, '.nubos-pilot'), { recursive: true });
+  return dir;
+}
+
+function _captureIO() {
+  const out = [];
+  const err = [];
+  return {
+    stdout: { write: (s) => { out.push(String(s)); return true; } },
+    stderr: { write: (s) => { err.push(String(s)); return true; } },
+    stdoutText: () => out.join(''),
+    stderrText: () => err.join(''),
+  };
+}
+
+function _clearClaudeEnv() {
+  const saved = {};
+  for (const k of ['CLAUDECODE', 'CLAUDE_CODE_ENTRYPOINT']) {
+    saved[k] = process.env[k];
+    delete process.env[k];
+  }
+  return () => {
+    for (const [k, v] of Object.entries(saved)) {
+      if (v === undefined) delete process.env[k];
+      else process.env[k] = v;
+    }
+  };
+}
+
+test('text-mode CLI: default without config and without Claude env prints "false"', () => {
+  const restore = _clearClaudeEnv();
+  try {
+    const dir = _mkSandbox();
+    try {
+      const io = _captureIO();
+      const rc = subcmd.run([], { cwd: dir, stdout: io.stdout, stderr: io.stderr });
+      assert.equal(rc, 0);
+      assert.equal(io.stdoutText().trim(), 'false');
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  } finally {
+    restore();
+  }
+});
+
+test('text-mode CLI: CLAUDECODE=1 prints "true"', () => {
+  const restore = _clearClaudeEnv();
+  try {
+    process.env.CLAUDECODE = '1';
+    const dir = _mkSandbox();
+    try {
+      const io = _captureIO();
+      const rc = subcmd.run([], { cwd: dir, stdout: io.stdout, stderr: io.stderr });
+      assert.equal(rc, 0);
+      assert.equal(io.stdoutText().trim(), 'true');
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  } finally {
+    restore();
+  }
+});
+
+test('text-mode CLI: --json emits detail object', () => {
+  const restore = _clearClaudeEnv();
+  try {
+    process.env.CLAUDECODE = '1';
+    const dir = _mkSandbox();
+    try {
+      const io = _captureIO();
+      const rc = subcmd.run(['--json'], { cwd: dir, stdout: io.stdout, stderr: io.stderr });
+      assert.equal(rc, 0);
+      const payload = JSON.parse(io.stdoutText().trim());
+      assert.equal(payload.enabled, true);
+      assert.equal(payload.source, 'runtime');
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  } finally {
+    restore();
+  }
+});
+
+test('text-mode CLI: config workflow.text_mode=false wins over CLAUDECODE', () => {
+  const restore = _clearClaudeEnv();
+  try {
+    process.env.CLAUDECODE = '1';
+    const dir = _mkSandbox();
+    try {
+      fs.writeFileSync(
+        path.join(dir, '.nubos-pilot', 'config.json'),
+        JSON.stringify({ workflow: { text_mode: false } }),
+      );
+      const io = _captureIO();
+      const rc = subcmd.run(['--json'], { cwd: dir, stdout: io.stdout, stderr: io.stderr });
+      assert.equal(rc, 0);
+      const payload = JSON.parse(io.stdoutText().trim());
+      assert.equal(payload.enabled, false);
+      assert.equal(payload.source, 'config');
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  } finally {
+    restore();
+  }
+});
+
+test('text-mode CLI: unknown flag exits 1 with structured error', () => {
+  const dir = _mkSandbox();
+  try {
+    const io = _captureIO();
+    const rc = subcmd.run(['--wat'], { cwd: dir, stdout: io.stdout, stderr: io.stderr });
+    assert.equal(rc, 1);
+    const payload = JSON.parse(io.stderrText().trim());
+    assert.equal(payload.code, 'text-mode-unknown-arg');
+  } finally {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+});

package/bin/np-tools/verify-work.cjs

@@ -19,6 +19,7 @@ const {
   milestoneVerificationPath,
 } = require('../../lib/verify.cjs');
 const { getAgentSkills } = require('../../lib/agents.cjs');
+const textMode = require('../../lib/text-mode.cjs');
 
 const INLINE_THRESHOLD_BYTES = 16 * 1024;
 const _VALID_SC_STATUSES = new Set(['Pass', 'Fail', 'Defer', 'Pending']);
@@ -90,6 +91,8 @@ function _initPayload(mNum, cwd) {
     };
   });
 
+  const tmDetail = textMode.resolveTextModeDetail(cwd);
+
   return {
     _workflow: 'verify-work',
     milestone: mNum,
@@ -101,6 +104,8 @@ function _initPayload(mNum, cwd) {
     verification_path: verificationPath,
     slice_uat: sliceUat,
     verifier_tier: 'sonnet',
+    text_mode: tmDetail.enabled,
+    text_mode_source: tmDetail.source,
     agent_skills: { verifier: _safeSkills('np-verifier', cwd) },
   };
 }

package/lib/runtime/claude.cjs

@@ -1,4 +1,9 @@
-const { _readOneLine, _parseAnswer, _hasReadlineImplForTests } = require('./_readline.cjs');
+const {
+  _readOneLine,
+  _parseAnswer,
+  _hasReadlineImplForTests,
+  askUserReadline,
+} = require('./_readline.cjs');
 const { NubosPilotError } = require('../core.cjs');
 
 function _emitClaudeMarkerBlock({ type, question, options, def }) {
@@ -19,7 +24,10 @@ async function askUser(spec) {
   const options = spec && spec.options;
   const def = spec ? spec.default : undefined;
   const hasTTY = !!process.stdin.isTTY;
-  if (!hasTTY && !_hasReadlineImplForTests()) {
+  if (hasTTY) {
+    return askUserReadline({ type, question, options, def });
+  }
+  if (!_hasReadlineImplForTests()) {
     if (def !== undefined && def !== null) {
       return { value: def, source: 'default' };
     }

package/lib/runtime/claude.test.cjs

@@ -118,6 +118,34 @@ test('claude-adapter: askUser without TTY and without default throws askuser-no-
   }
 });
 
+test('claude-adapter: askUser with TTY stdin uses readline UI, no marker block', async () => {
+  const originalIsTTY = process.stdin.isTTY;
+  _setReadlineImplForTests(async () => '2');
+  const originalStderrWrite = process.stderr.write.bind(process.stderr);
+  const stderrChunks = [];
+  process.stderr.write = (chunk) => { stderrChunks.push(String(chunk)); return true; };
+  try {
+    Object.defineProperty(process.stdin, 'isTTY', { value: true, configurable: true });
+    const { val, out } = await captureStdout(() =>
+      claude.askUser({ type: 'select', question: 'Q', options: ['A', 'B', 'C'] })
+    );
+    assert.ok(!/<!-- askUser v1 -->/.test(out),
+      'must not emit marker block when stdin is TTY');
+    assert.equal(val.source, 'readline');
+    assert.equal(val.value, 'B');
+    const stderrJoined = stderrChunks.join('');
+    assert.match(stderrJoined, /Q/, 'readline UI should render the question on stderr');
+  } finally {
+    process.stderr.write = originalStderrWrite;
+    _setReadlineImplForTests(null);
+    if (originalIsTTY === undefined) {
+      delete process.stdin.isTTY;
+    } else {
+      Object.defineProperty(process.stdin, 'isTTY', { value: originalIsTTY, configurable: true });
+    }
+  }
+});
+
 test('claude-adapter: askUser without TTY but with default returns default', async () => {
   const originalIsTTY = process.stdin.isTTY;
   try {

package/lib/text-mode.cjs

@@ -0,0 +1,79 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { findProjectRoot, NubosPilotError } = require('./core.cjs');
+
+const DEFAULT_TEXT_MODE = false;
+const CLAUDE_ENV_KEYS = ['CLAUDECODE', 'CLAUDE_CODE_ENTRYPOINT'];
+
+function _coerceBool(raw) {
+  if (raw === true || raw === false) return raw;
+  if (raw == null) return null;
+  const s = String(raw).trim().toLowerCase();
+  if (s === 'true' || s === '1' || s === 'yes' || s === 'on') return true;
+  if (s === 'false' || s === '0' || s === 'no' || s === 'off') return false;
+  return null;
+}
+
+function readConfigTextMode(cwd) {
+  let root;
+  try {
+    root = findProjectRoot(cwd || process.cwd());
+  } catch (err) {
+    if (err && err.code === 'not-in-project') return null;
+    throw err;
+  }
+  const p = path.join(root, '.nubos-pilot', 'config.json');
+  if (!fs.existsSync(p)) return null;
+  let parsed;
+  try {
+    parsed = JSON.parse(fs.readFileSync(p, 'utf-8'));
+  } catch (err) {
+    throw new NubosPilotError('text-mode-config-parse-error', 'config.json invalid JSON', { cause: err && err.message });
+  }
+  if (!parsed || typeof parsed !== 'object') return null;
+  const workflow = parsed.workflow;
+  if (!workflow || typeof workflow !== 'object') return null;
+  if (!Object.prototype.hasOwnProperty.call(workflow, 'text_mode')) return null;
+  const coerced = _coerceBool(workflow.text_mode);
+  return coerced;
+}
+
+function detectRuntimeTextMode(env) {
+  const source = env || process.env;
+  for (const key of CLAUDE_ENV_KEYS) {
+    const v = source[key];
+    if (v != null && String(v) !== '' && String(v) !== '0' && String(v).toLowerCase() !== 'false') {
+      return true;
+    }
+  }
+  return false;
+}
+
+function resolveTextMode(cwd, env) {
+  const fromConfig = readConfigTextMode(cwd);
+  if (fromConfig !== null) return fromConfig;
+  if (detectRuntimeTextMode(env)) return true;
+  return DEFAULT_TEXT_MODE;
+}
+
+function resolveTextModeDetail(cwd, env) {
+  const fromConfig = readConfigTextMode(cwd);
+  if (fromConfig !== null) {
+    return { enabled: fromConfig, source: 'config' };
+  }
+  if (detectRuntimeTextMode(env)) {
+    return { enabled: true, source: 'runtime' };
+  }
+  return { enabled: DEFAULT_TEXT_MODE, source: 'default' };
+}
+
+module.exports = {
+  DEFAULT_TEXT_MODE,
+  CLAUDE_ENV_KEYS,
+  readConfigTextMode,
+  detectRuntimeTextMode,
+  resolveTextMode,
+  resolveTextModeDetail,
+};

package/lib/text-mode.test.cjs

@@ -0,0 +1,139 @@
+'use strict';
+
+const { test } = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+
+const tm = require('./text-mode.cjs');
+
+function _mkSandbox() {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'np-textmode-'));
+  fs.mkdirSync(path.join(dir, '.nubos-pilot'), { recursive: true });
+  return dir;
+}
+
+function _writeConfig(dir, obj) {
+  fs.writeFileSync(path.join(dir, '.nubos-pilot', 'config.json'), JSON.stringify(obj, null, 2));
+}
+
+test('text-mode: default without config or runtime env is false', () => {
+  const dir = _mkSandbox();
+  try {
+    assert.equal(tm.resolveTextMode(dir, {}), false);
+    const detail = tm.resolveTextModeDetail(dir, {});
+    assert.deepEqual(detail, { enabled: false, source: 'default' });
+  } finally {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('text-mode: CLAUDECODE=1 in env flips default to true', () => {
+  const dir = _mkSandbox();
+  try {
+    assert.equal(tm.resolveTextMode(dir, { CLAUDECODE: '1' }), true);
+    const detail = tm.resolveTextModeDetail(dir, { CLAUDECODE: '1' });
+    assert.deepEqual(detail, { enabled: true, source: 'runtime' });
+  } finally {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('text-mode: CLAUDE_CODE_ENTRYPOINT non-empty flips to true', () => {
+  const dir = _mkSandbox();
+  try {
+    assert.equal(tm.resolveTextMode(dir, { CLAUDE_CODE_ENTRYPOINT: 'cli' }), true);
+  } finally {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('text-mode: env value "0" or "false" does not flip', () => {
+  const dir = _mkSandbox();
+  try {
+    assert.equal(tm.resolveTextMode(dir, { CLAUDECODE: '0' }), false);
+    assert.equal(tm.resolveTextMode(dir, { CLAUDECODE: 'false' }), false);
+    assert.equal(tm.resolveTextMode(dir, { CLAUDECODE: '' }), false);
+  } finally {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('text-mode: config workflow.text_mode=true wins over absent runtime', () => {
+  const dir = _mkSandbox();
+  try {
+    _writeConfig(dir, { workflow: { text_mode: true } });
+    assert.equal(tm.resolveTextMode(dir, {}), true);
+    assert.deepEqual(tm.resolveTextModeDetail(dir, {}), { enabled: true, source: 'config' });
+  } finally {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('text-mode: config workflow.text_mode=false overrides CLAUDECODE runtime', () => {
+  const dir = _mkSandbox();
+  try {
+    _writeConfig(dir, { workflow: { text_mode: false } });
+    assert.equal(tm.resolveTextMode(dir, { CLAUDECODE: '1' }), false);
+    assert.deepEqual(
+      tm.resolveTextModeDetail(dir, { CLAUDECODE: '1' }),
+      { enabled: false, source: 'config' },
+    );
+  } finally {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('text-mode: config workflow.text_mode="true" string coerced to boolean', () => {
+  const dir = _mkSandbox();
+  try {
+    _writeConfig(dir, { workflow: { text_mode: 'true' } });
+    assert.equal(tm.resolveTextMode(dir, {}), true);
+    _writeConfig(dir, { workflow: { text_mode: '0' } });
+    assert.equal(tm.resolveTextMode(dir, { CLAUDECODE: '1' }), false);
+  } finally {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('text-mode: config missing workflow.text_mode falls through to runtime detection', () => {
+  const dir = _mkSandbox();
+  try {
+    _writeConfig(dir, { response_language: 'de' });
+    assert.equal(tm.resolveTextMode(dir, { CLAUDECODE: '1' }), true);
+    assert.equal(tm.resolveTextMode(dir, {}), false);
+  } finally {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('text-mode: readConfigTextMode returns null outside project root', () => {
+  const outside = fs.mkdtempSync(path.join(os.tmpdir(), 'np-outside-'));
+  try {
+    assert.equal(tm.readConfigTextMode(outside), null);
+    assert.equal(tm.resolveTextMode(outside, {}), false);
+  } finally {
+    fs.rmSync(outside, { recursive: true, force: true });
+  }
+});
+
+test('text-mode: readConfigTextMode throws on invalid JSON', () => {
+  const dir = _mkSandbox();
+  try {
+    fs.writeFileSync(path.join(dir, '.nubos-pilot', 'config.json'), '{not json');
+    assert.throws(
+      () => tm.readConfigTextMode(dir),
+      (err) => err && err.code === 'text-mode-config-parse-error',
+    );
+  } finally {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('text-mode: detectRuntimeTextMode honors multiple env keys', () => {
+  assert.equal(tm.detectRuntimeTextMode({ CLAUDECODE: '1' }), true);
+  assert.equal(tm.detectRuntimeTextMode({ CLAUDE_CODE_ENTRYPOINT: 'cli' }), true);
+  assert.equal(tm.detectRuntimeTextMode({ OTHER: '1' }), false);
+  assert.equal(tm.detectRuntimeTextMode({}), false);
+});

package/np-tools.cjs

@@ -46,6 +46,7 @@ const topLevelCommands = {
   'resolve-model':  require('./bin/np-tools/resolve-model.cjs'),
   'stats':          require('./bin/np-tools/stats.cjs'),
   'lang-directive': require('./bin/np-tools/lang-directive.cjs'),
+  'text-mode':      require('./bin/np-tools/text-mode.cjs'),
 };
 
 const THRESHOLD = 16 * 1024;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nubos-pilot",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "AI-driven planning and execution tool for code projects",
   "homepage": "https://github.com/Nubos-AI/nubos-pilot",
   "repository": {

package/workflows/add-todo.md

@@ -41,11 +41,16 @@ TODO_PATH="${PENDING_DIR}/${DATE}-${SLUG}.md"
 ```
 
 Extract from init JSON: `commit_docs`, `date`, `timestamp`, `slug`,
-`todo_count`, `todos_dir_exists`, `pending_dir`, `state_path`. The
-init handler sanitises the slug through `lib/layout.cjs.slugify`
-(strips to `[a-z0-9-]` only; filename-injection mitigation) and
-validates the description length (<= 500 chars) before any filesystem
-write occurs.
+`todo_count`, `todos_dir_exists`, `pending_dir`, `state_path`,
+`text_mode`, `text_mode_source`. The init handler sanitises the slug
+through `lib/layout.cjs.slugify` (strips to `[a-z0-9-]` only;
+filename-injection mitigation) and validates the description length
+(<= 500 chars) before any filesystem write occurs.
+
+**Text-mode routing.** If `text_mode == true`, skip every `np-tools.cjs askuser`
+call below and render questions as plain-text numbered lists in the main
+chat. Auto-enabled in Claude Code (CLAUDECODE=1); opt-in via
+`.nubos-pilot/config.json` → `workflow.text_mode`.
 
 ## Create Pending Dir
 

package/workflows/discuss-phase.md

@@ -32,7 +32,24 @@ conflict — the config is the single source of truth.
 
 Parse JSON for: `milestone`, `milestone_id`, `milestone_dir`, `milestone_name`,
 `milestone_context_path`, `has_context`, `has_milestone_dir`, `goal`,
-`requirements`, `agent_skills`, `mode`.
+`requirements`, `agent_skills`, `mode`, `text_mode`, `text_mode_source`.
+
+**Text-mode routing (SSOT = INIT payload).** If `text_mode` is `true`, do
+**not** shell out to `np-tools.cjs askuser` for any prompt in this workflow.
+Present every question inline as a plain-text numbered list and wait for the
+user's reply in the main chat. This is the correct path whenever:
+
+- `text_mode_source == "runtime"` → Claude Code Bash has no TTY and cannot
+  forward interactive menu selections; the askuser marker-block protocol
+  never completes.
+- `text_mode_source == "config"` → the user explicitly opted into text mode
+  via `.nubos-pilot/config.json` → `workflow.text_mode`.
+
+When text mode is active, skip every `node .nubos-pilot/bin/np-tools.cjs
+askuser …` block below and substitute the plain-text equivalent. Collect the
+answers from the user's reply, then proceed to the next step as normal. The
+rest of the workflow (validation, canonical-ref accumulation, template
+render, commit) is unchanged.
 
 If the user passed `--assumptions`, route to
 `workflows/discuss-phase-assumptions.md` and exit this workflow.
@@ -125,30 +142,33 @@ Capture the idea in a "Deferred Ideas" section. Don't lose it, don't act on it.
 ## Answer Validation
 
 <answer_validation>
-**IMPORTANT: Answer validation** — After every interactive prompt, check the
-exit code and the response:
+**Routing decision (made once at Initialize):** If INIT payload
+`text_mode == true`, skip every `np-tools.cjs askuser` call in this workflow
+and use plain-text numbered lists in the main chat instead. The
+`text_mode_source` field (`runtime` / `config` / `default`) tells you why
+text mode is active — it is informational only and does not change behavior.
+
+**When text_mode is false and askuser is used — per-prompt validation:**
 1. If `askuser` exits with structured error `askuser-no-tty` (exit code 1,
-   stderr JSON with `"code":"askuser-no-tty"`), **skip retry** and fall back
-   immediately to the plain-text numbered list described below — the runtime
-   cannot prompt interactively in this session.
+   stderr JSON with `"code":"askuser-no-tty"`), that means the runtime
+   detection missed something; **skip retry** and treat the remainder of the
+   workflow as text-mode (plain-text numbered lists).
 2. If the response is empty or whitespace-only (exit 0 but no value), retry
    the question once with the same parameters.
 3. If still empty, present the options as a plain-text numbered list and ask
    the user to type their choice number.
 Never proceed with an empty answer.
 
-**Text mode (`workflow.text_mode: true` in config or `--text` flag):**
-When text mode is active, **do not use `np-tools.cjs askuser` at all**.
-Instead, present every question as a plain-text numbered list and ask the
-user to type their choice number. This is required for Claude Code remote
-sessions (`/rc` mode) where the Claude App cannot forward TUI menu selections
-back to the host.
-
-Enable text mode:
-- Per-session: pass `--text` flag
-- Per-project: `np-tools.cjs config-set workflow.text_mode true`
+**Enable text mode:**
+- Auto-detected: any Claude Code session (`CLAUDECODE=1` /
+  `CLAUDE_CODE_ENTRYPOINT` set) — default behavior, no user action needed.
+- Opt-in per project: set `workflow.text_mode: true` in
+  `.nubos-pilot/config.json`.
+- Opt-out per project: set `workflow.text_mode: false` in
+  `.nubos-pilot/config.json` (overrides runtime detection).
 
-Text mode applies to ALL workflows in the session, not just discuss-phase.
+Text mode applies to ALL workflows that emit `text_mode` in their INIT
+payload, not just discuss-phase.
 </answer_validation>
 
 ## Process

package/workflows/execute-phase.md

@@ -30,7 +30,13 @@ into every np-executor spawn prompt as a system-level rule so task summaries
 and checkpoint notes follow the project language. This supersedes any
 directive in CLAUDE.md managed block.
 
-Parse JSON for: `milestone`, `milestone_id`, `milestone_dir`, `waves[]` (each with `wave` (= slice number), `slice_id`, `slice_full_id`, `slice_dir`, `tasks[]`), `total_tasks`, `slice_count`, `executor_tier`, `agent_skills`.
+Parse JSON for: `milestone`, `milestone_id`, `milestone_dir`, `waves[]` (each with `wave` (= slice number), `slice_id`, `slice_full_id`, `slice_dir`, `tasks[]`), `total_tasks`, `slice_count`, `executor_tier`, `text_mode`, `text_mode_source`, `agent_skills`.
+
+**Text-mode routing.** If `text_mode == true`, skip every `np-tools.cjs askuser`
+call below (including the orphan-checkpoint and empty-milestone prompts)
+and render the options as a plain-text numbered list in the main chat.
+Auto-enabled in Claude Code (CLAUDECODE=1); opt-in via
+`.nubos-pilot/config.json` → `workflow.text_mode`.
 
 `PLAN_ID` is iterated per slice as `${milestone_id}-${slice_id}` (e.g. `M001-S001`). `TASK_ID` is iterated from each slice's `tasks[]` (e.g. `M001-S001-T0001`).
 

package/workflows/new-milestone.md

@@ -62,6 +62,12 @@ if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 user-facing output, and any prose written into milestone artefacts (YAML
 keys, IDs, and identifiers stay canonical English). Supersedes CLAUDE.md.
 
+**Text-mode routing.** If INIT payload `text_mode == true`, skip every
+`np-tools.cjs askuser` call below and render each question as a plain-text
+prompt in the main chat; collect the answer inline. Auto-enabled in Claude
+Code (CLAUDECODE=1); opt-in via `.nubos-pilot/config.json` →
+`workflow.text_mode`.
+
 Payload: three questions — `milestone_name`, `milestone_goal`, `create_req_prefix` (confirm).
 
 ## Interview

package/workflows/new-project.md

@@ -117,6 +117,12 @@ user-facing output, and any narrative prose written into PROJECT.md /
 REQUIREMENTS.md (field names and YAML keys stay canonical English).
 Supersedes CLAUDE.md.
 
+**Text-mode routing.** If INIT payload `text_mode == true`, skip every
+`np-tools.cjs askuser` call below and render each question as a plain-text
+prompt in the main chat; collect the user's answer inline and move on.
+Auto-enabled in Claude Code (CLAUDECODE=1); opt-in via
+`.nubos-pilot/config.json` → `workflow.text_mode`.
+
 ```bash
 ANS_PROJECT_NAME=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{"type":"input","prompt":"Project name?"}')
 ANS_CORE_VALUE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{"type":"input","prompt":"Core value — one sentence that must stay true if everything else fails?"}')

package/workflows/note.md

@@ -52,6 +52,17 @@ into `$TEXT`. Empty text after stripping is an error — there is no
 `list` or `promote` subcommand here (deferred to a future
 capture-management plan).
 
+**Text-mode routing.** Resolve once at the start:
+
+```bash
+TEXT_MODE=$(node .nubos-pilot/bin/np-tools.cjs text-mode 2>/dev/null || echo false)
+```
+
+If `$TEXT_MODE == "true"`, skip every `np-tools.cjs askuser` call below and
+render questions as plain-text numbered lists in the main chat. Auto-enabled
+in Claude Code (CLAUDECODE=1); opt-in via `.nubos-pilot/config.json` →
+`workflow.text_mode`.
+
 ## Compute Paths
 
 Scope branching is explicit (T-10-05-02 mitigation + Pitfall 10

package/workflows/plan-phase.md

@@ -86,7 +86,12 @@ askuser prompts, status updates, and any narrative text the spawned planner
 or plan-checker subagents emit. Pass `$LANG_DIRECTIVE` into their spawn
 prompts as a system-level rule. This supersedes any directive in CLAUDE.md.
 
-Parse JSON for: `milestone`, `milestone_id`, `milestone_dir`, `milestone_context_path`, `milestone_roadmap_path`, `milestone_meta_path`, `name`, `goal`, `requirements`, `success_criteria`, `has_context`, `has_roadmap`, `has_meta`, `existing_slices[]`, `planner_tier`, `checker_tier`, `agent_skills`.
+Parse JSON for: `milestone`, `milestone_id`, `milestone_dir`, `milestone_context_path`, `milestone_roadmap_path`, `milestone_meta_path`, `name`, `goal`, `requirements`, `success_criteria`, `has_context`, `has_roadmap`, `has_meta`, `existing_slices[]`, `planner_tier`, `checker_tier`, `text_mode`, `text_mode_source`, `agent_skills`.
+
+**Text-mode routing.** If `text_mode == true`, skip every `np-tools.cjs askuser`
+call below and present questions as plain-text numbered lists in the main
+chat. Auto-enabled in Claude Code (CLAUDECODE=1); opt-in per-project via
+`.nubos-pilot/config.json` → `workflow.text_mode`.
 
 `PLAN_ID` and `TASK_ID` default to `${milestone_id}-plan` / `${milestone_id}-planner-run` for the metrics records.
 

package/workflows/research-phase.md

@@ -107,6 +107,11 @@ project language. This supersedes CLAUDE.md.
 `RUNTIME` is resolved once here and reused by the metrics-record call at the
 researcher spawn site (Step 4) per D-06 workflow-writer pattern.
 
+**Text-mode routing.** If `text_mode == true` in the payload below, skip every
+`np-tools.cjs askuser` call in this workflow and render questions as
+plain-text numbered lists in the main chat. Auto-enabled in Claude Code
+(CLAUDECODE=1); opt-in via `.nubos-pilot/config.json` → `workflow.text_mode`.
+
 The payload shape:
 
 ```json

package/workflows/resume-work.md

@@ -24,6 +24,11 @@ askuser prompts. When spawning the np-executor to continue a checkpoint,
 pass `$LANG_DIRECTIVE` into the spawn prompt so resumed task summaries
 follow the project language. Supersedes CLAUDE.md.
 
+**Text-mode routing.** If INIT payload `text_mode == true`, skip every
+`np-tools.cjs askuser` call below and render prompts as plain-text numbered
+lists in the main chat. Auto-enabled in Claude Code (CLAUDECODE=1); opt-in
+via `.nubos-pilot/config.json` → `workflow.text_mode`.
+
 ## Execution
 
 ### status: resume

package/workflows/session-report.md

@@ -56,6 +56,17 @@ sections (summary, highlights, notable events) and any askuser prompts.
 Task IDs, milestone IDs, commit SHAs, metrics keys, and file paths stay
 canonical English. Supersedes CLAUDE.md.
 
+**Text-mode routing.** Resolve once:
+
+```bash
+TEXT_MODE=$(node .nubos-pilot/bin/np-tools.cjs text-mode 2>/dev/null || echo false)
+```
+
+If `$TEXT_MODE == "true"`, skip every `np-tools.cjs askuser` call below and
+render questions as plain-text numbered lists in the main chat. Auto-enabled
+in Claude Code (CLAUDECODE=1); opt-in via `.nubos-pilot/config.json` →
+`workflow.text_mode`.
+
 The filename format is `YYYY-MM-DDTHHMM-session-report.md` (D-17 —
 4-char HHMM, no seconds, local time) so reports sort
 lexicographically by invocation order.

package/workflows/validate-phase.md

@@ -31,7 +31,12 @@ prompts, and pass it into the np-nyquist-auditor spawn prompt so gap-fill
 narrative follows the project language. Test IDs, file paths, and canonical
 field names stay English. Supersedes CLAUDE.md.
 
-Parse JSON for: `milestone`, `milestone_id`, `milestone_dir`, `milestone_name`, `slice_uat`.
+Parse JSON for: `milestone`, `milestone_id`, `milestone_dir`, `milestone_name`, `slice_uat`, `text_mode`, `text_mode_source`.
+
+**Text-mode routing.** If `text_mode == true`, skip every `np-tools.cjs askuser`
+call in this workflow and render options as plain-text numbered lists in
+the main chat. Auto-enabled in Claude Code (CLAUDECODE=1); opt-in via
+`.nubos-pilot/config.json` → `workflow.text_mode`.
 
 ```bash
 MILESTONE_ID=$(echo "$INIT" | jq -r '.milestone_id')

package/workflows/verify-work.md

@@ -29,7 +29,13 @@ prose (Pass/Fail findings, root-cause notes) follows the project language.
 Test-case IDs, file paths, and stack traces stay canonical. Supersedes
 CLAUDE.md.
 
-Parse: `milestone`, `milestone_id`, `milestone_dir`, `milestone_name`, `success_criteria`, `draft_results`, `verification_path`, `slice_uat`, `verifier_tier`, `agent_skills`.
+Parse: `milestone`, `milestone_id`, `milestone_dir`, `milestone_name`, `success_criteria`, `draft_results`, `verification_path`, `slice_uat`, `verifier_tier`, `text_mode`, `text_mode_source`, `agent_skills`.
+
+**Text-mode routing.** If `text_mode == true`, skip every `np-tools.cjs askuser`
+call below (including the Pass-2 `needs_user_confirm` gate) and render the
+options as a plain-text numbered list in the main chat. Auto-enabled in
+Claude Code (CLAUDECODE=1); opt-in via `.nubos-pilot/config.json` →
+`workflow.text_mode`.
 
 ## Pass 1 — verifier agent