nubos-pilot 0.5.3 → 0.5.5

package/agents/np-plan-checker.md

@@ -89,6 +89,7 @@ Run each dimension below; for every failure, emit one finding using the matching
 - Every `<task>` MUST have `id="M<NNN>-S<NNN>-T<NNNN>"` matching the enclosing slice (milestone and slice numbers must agree with the file path). Mismatch → `broken-dependency`.
 - Missing `depends_on`, `wave`, or `tier` attribute on the opening `<task>` tag → the scaffolder will drop it. Emit `fake-promotion-trigger` with a message telling the planner which task is missing which attribute.
 - `wave="<N>"` should equal the slice's S-number (e.g. S002 → wave="2"). Mismatch is a soft finding (`fake-promotion-trigger`).
+- **Task numbering restarts per slice.** Inside each `S<NNN>-PLAN.md`, the task IDs MUST start at `T0001` and increment contiguously (`T0001, T0002, …`). Counter that continues across slices (e.g. `S002` starting at `T0002` because `S001` used `T0001`) → `broken-dependency` with `target: S<NNN>-PLAN.md task <n>` and a message naming the expected vs. observed T-number. Gaps (`T0001, T0003`) are the same finding.
 
 ### Dimension 7: Nyquist Coverage Annotation
 

package/agents/np-planner.md

@@ -216,7 +216,7 @@ If any check fails, fix before returning. Plan-checker will catch what you miss,
 
 Inside each `S<NNN>-PLAN.md`, every `<task>` tag MUST have these four attributes on the opening tag:
 
-- `id="M<NNN>-S<NNN>-T<NNNN>"` — full-id, e.g. `id="M001-S001-T0001"`. Milestone 3 digits, slice 3 digits, task **4 digits**.
+- `id="M<NNN>-S<NNN>-T<NNNN>"` — full-id, e.g. `id="M001-S001-T0001"`. Milestone 3 digits, slice 3 digits, task **4 digits**. **Task numbering restarts at `T0001` inside every slice.** The first task of `S002` is `M<NNN>-S002-T0001`, the first task of `S003` is `M<NNN>-S003-T0001`. Tasks within a slice run `T0001, T0002, T0003, …` without gaps. Never continue the counter across slices (`S001-T0001, S002-T0002` is wrong — it must be `S001-T0001, S002-T0001`).
 - `depends_on="<id>[,<id>...]"` — comma-separated predecessor task full-ids, or empty string `""`. Must only reference tasks in **earlier slices** (cross-slice forward deps) or be empty (intra-slice tasks are implicitly parallel, never serial).
 - `wave="<N>"` — integer equal to the slice number. For S001 use `wave="1"`, for S002 use `wave="2"`, etc.
 - `tier="<haiku|sonnet|opus>"` — executor tier, picks the model via resolve-model.
@@ -257,7 +257,16 @@ Create `LoginForm.tsx` with email + password inputs. Wire it to the
 </tasks>
 ```
 
-Note both tasks have `depends_on=""` — they're in the same slice and run in parallel. If `T0002` truly needs `T0001` first, move `T0002` into a new slice `S002` and write `depends_on="M001-S001-T0001" wave="2"`.
+Note both tasks have `depends_on=""` — they're in the same slice and run in parallel. If `T0002` truly needs `T0001` first, move `T0002` into a new slice `S002` and renumber it to `T0001` — each slice owns its own task counter:
+
+```
+<task id="M001-S002-T0001" depends_on="M001-S001-T0001" wave="2" tier="sonnet">
+  <name>Use login handler in session flow</name>
+  ...
+</task>
+```
+
+The cross-slice dep `M001-S001-T0001` flows forward (S001 → S002); the new task is `T0001` of S002, not `T0003`.
 </task_format>
 
 <tooling_conventions>

package/bin/install.js

@@ -663,6 +663,12 @@ function _runUninstallLocked(projectRoot) {
 
 async function main() {
   const rawArgs = process.argv.slice(2);
+  if (rawArgs.includes('--version') || rawArgs.includes('-v')) {
+    let version = '0.0.0';
+    try { version = String(require('../package.json').version || '0.0.0'); } catch {}
+    process.stdout.write(version + '\n');
+    return;
+  }
   const { flags, rest } = parseInstallFlags(rawArgs);
   const sub = rest[0];
   const cwd = process.cwd();

package/bin/np-tools/_commands.cjs

@@ -44,8 +44,10 @@ 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)' },
+  { name: 'detect-runtime',  category: 'Utility', description: 'Print detected runtime id (claude, codex, gemini, …) — reads config.json ∨ env ∨ default' },
 
   { name: 'thread',           category: 'Utility', description: 'Cross-session thread CRUD (create/resume under .nubos-pilot/threads/)' },
   { name: 'session-report',   category: 'Utility', description: 'Generate session report from metrics since .last-session pointer' },

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/detect-runtime.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+const { detect } = require('../../lib/runtime/index.cjs');
+
+function run(argv, ctx) {
+  const context = ctx || {};
+  const cwd = context.cwd || process.cwd();
+  const stdout = context.stdout || process.stdout;
+  const args = Array.isArray(argv) ? argv.slice() : [];
+  const result = detect({ cwd });
+  if (args.includes('--json')) {
+    stdout.write(JSON.stringify(result) + '\n');
+  } else {
+    stdout.write(result.runtime + '\n');
+  }
+  return 0;
+}
+
+module.exports = { run };
+
+if (require.main === module) {
+  const code = run(process.argv.slice(2));
+  if (typeof code === 'number' && code !== 0) process.exit(code);
+}

package/bin/np-tools/detect-runtime.test.cjs

@@ -0,0 +1,47 @@
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const { test } = require('node:test');
+const assert = require('node:assert/strict');
+const { Writable } = require('node:stream');
+
+const cli = require('./detect-runtime.cjs');
+
+function makeSink() {
+  const chunks = [];
+  const w = new Writable({
+    write(chunk, _enc, cb) { chunks.push(chunk); cb(); },
+  });
+  w.toString = () => Buffer.concat(chunks.map((c) => Buffer.isBuffer(c) ? c : Buffer.from(String(c)))).toString('utf-8');
+  return w;
+}
+
+function makeSandbox(runtime) {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'np-detect-rt-'));
+  fs.mkdirSync(path.join(root, '.nubos-pilot'), { recursive: true });
+  if (runtime) {
+    fs.writeFileSync(
+      path.join(root, '.nubos-pilot', 'config.json'),
+      JSON.stringify({ runtime, runtime_source: 'config' }),
+    );
+  }
+  return root;
+}
+
+test('detect-runtime: reads runtime from .nubos-pilot/config.json', () => {
+  const sb = makeSandbox('gemini');
+  const stdout = makeSink();
+  const code = cli.run([], { cwd: sb, stdout });
+  assert.equal(code, 0);
+  assert.equal(stdout.toString().trim(), 'gemini');
+});
+
+test('detect-runtime --json emits {runtime, source}', () => {
+  const sb = makeSandbox('codex');
+  const stdout = makeSink();
+  const code = cli.run(['--json'], { cwd: sb, stdout });
+  assert.equal(code, 0);
+  const parsed = JSON.parse(stdout.toString());
+  assert.equal(parsed.runtime, 'codex');
+  assert.ok(parsed.source);
+});

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/stats.cjs

@@ -1,14 +1,78 @@
+const fs = require('node:fs');
 const path = require('node:path');
 const { execFileSync } = require('node:child_process');
 const { NubosPilotError, findProjectRoot } = require('../../lib/core.cjs');
 const { parseRoadmap } = require('../../lib/roadmap.cjs');
 const { readState } = require('../../lib/state.cjs');
 const { aggregatePhase } = require('../../lib/metrics-aggregate.cjs');
+const { extractFrontmatter } = require('../../lib/frontmatter.cjs');
+const layout = require('../../lib/layout.cjs');
 
-const SCHEMA_VERSION = 1;
+const SCHEMA_VERSION = 2;
 
 function _usage() {
-  return 'Usage:\n  np-tools.cjs stats json';
+  return 'Usage:\n  np-tools.cjs stats json\n  np-tools.cjs stats bar';
+}
+
+function _percent(num, den) {
+  if (!den || den <= 0) return 0;
+  return Math.min(100, Math.round((num / den) * 100));
+}
+
+function _taskStatus(planPath) {
+  try {
+    const raw = fs.readFileSync(planPath, 'utf-8');
+    const { frontmatter } = extractFrontmatter(raw);
+    return frontmatter && typeof frontmatter.status === 'string'
+      ? frontmatter.status : null;
+  } catch {
+    return null;
+  }
+}
+
+function _collectTaskAndSliceStats(cwd) {
+  let tasksTotal = 0;
+  let tasksComplete = 0;
+  let slicesTotal = 0;
+  let slicesComplete = 0;
+  const milestones = layout.listMilestones(cwd);
+  for (const m of milestones) {
+    const slices = layout.listSlices(m.number, cwd);
+    for (const s of slices) {
+      slicesTotal += 1;
+      const tasks = layout.listTasks(m.number, s.number, cwd);
+      if (tasks.length === 0) continue;
+      let doneInSlice = 0;
+      for (const t of tasks) {
+        if (!fs.existsSync(t.plan_path)) continue;
+        tasksTotal += 1;
+        if (_taskStatus(t.plan_path) === 'done') {
+          tasksComplete += 1;
+          doneInSlice += 1;
+        }
+      }
+      if (doneInSlice === tasks.length && tasks.length > 0) slicesComplete += 1;
+    }
+  }
+  return {
+    tasks: {
+      total: tasksTotal,
+      complete: tasksComplete,
+      percent: _percent(tasksComplete, tasksTotal),
+    },
+    slices: {
+      total: slicesTotal,
+      complete: slicesComplete,
+      percent: _percent(slicesComplete, slicesTotal),
+    },
+  };
+}
+
+function _renderBar(label, percent, width) {
+  const w = Math.max(4, Math.min(60, width || 24));
+  const filled = Math.round((percent / 100) * w);
+  const bar = '█'.repeat(filled) + '░'.repeat(w - filled);
+  return label + ' [' + bar + '] ' + String(percent).padStart(3, ' ') + '%';
 }
 
 function _emitError(err, stderr) {
@@ -81,7 +145,8 @@ async function _buildStats(cwd) {
     plansTotal += ph.plans_total;
     plansComplete += ph.plans_complete;
   }
-  const percent = plansTotal > 0 ? Math.round((plansComplete / plansTotal) * 100) : 0;
+  const percent = _percent(plansComplete, plansTotal);
+  const fs_progress = _collectTaskAndSliceStats(useCwd);
   let lastActivity = null;
   try {
     const st = readState(useCwd);
@@ -108,6 +173,8 @@ async function _buildStats(cwd) {
     plans_total: plansTotal,
     plans_complete: plansComplete,
     percent,
+    tasks: fs_progress.tasks,
+    slices: fs_progress.slices,
     git,
     last_activity: lastActivity,
     metrics_by_phase,
@@ -121,7 +188,7 @@ async function run(argv, ctx) {
   const stderr = context.stderr || process.stderr;
   const args = Array.isArray(argv) ? argv.slice() : [];
   const sub = args.shift();
-  if (sub !== 'json') {
+  if (sub !== 'json' && sub !== 'bar') {
     stderr.write(_usage() + '\n');
     return 1;
   }
@@ -133,6 +200,11 @@ async function run(argv, ctx) {
   }
   try {
     const out = await _buildStats(cwd);
+    if (sub === 'bar') {
+      stdout.write(_renderBar('Tasks ', out.tasks.percent) + '  (' + out.tasks.complete + '/' + out.tasks.total + ')\n');
+      stdout.write(_renderBar('Slices', out.slices.percent) + '  (' + out.slices.complete + '/' + out.slices.total + ')\n');
+      return 0;
+    }
     stdout.write(JSON.stringify(out, null, 2) + '\n');
     return 0;
   } catch (err) {
@@ -141,7 +213,7 @@ async function run(argv, ctx) {
   }
 }
 
-module.exports = { run, _buildStats, _collectPhases, _milestoneEntry };
+module.exports = { run, _buildStats, _collectPhases, _milestoneEntry, _collectTaskAndSliceStats, _renderBar };
 
 if (require.main === module) {
   run(process.argv.slice(2)).then((code) => process.exit(code)).catch((err) => {