nubos-pilot 0.7.2 → 0.8.0

package/agents/np-executor.md

@@ -20,6 +20,7 @@ If the prompt contains a `<files_to_read>` block, you MUST use the `Read` tool t
 - Invoke commit-helper ONLY after verification passes.
 - Never invoke `git` directly — always through the `np-tools.cjs` wrapper so the D-25 gitignore-guard runs.
 - One task per spawn. One commit per task (D-03).
+- If the spawn prompt contains a `Use the following Nubos skills:` line (injected by `/np:execute-phase` for UI/frontend tasks), load each named skill from `.claude/skills/<skill>/SKILL.md` BEFORE editing source. Apply each skill's quality bar; verification must pass against the skill's rules, not just the test command.
 </role>
 
 ## Inputs

package/bin/install.js

@@ -58,6 +58,7 @@ const SOURCE_OPENCODE_DIR = path.join(__dirname, '..', 'templates', 'opencode',
 const OPENCODE_JSON_TEMPLATE = path.join(__dirname, '..', 'templates', 'opencode', 'opencode.json');
 const SOURCE_WORKFLOWS_DIR = path.join(__dirname, '..', 'workflows');
 const SOURCE_AGENTS_DIR = path.join(__dirname, '..', 'agents');
+const SOURCE_SKILLS_DIR = path.join(__dirname, '..', 'skills');
 
 function _autoAskUser(spec) {
   return Promise.resolve({
@@ -382,6 +383,7 @@ async function _runInstallLocked(ctx) {
     projectRoot,
     workflowsDir: SOURCE_WORKFLOWS_DIR,
     agentsDir: SOURCE_AGENTS_DIR,
+    skillsDir: SOURCE_SKILLS_DIR,
   });
   const assetEntries = runtimeAssetsMod.manifestEntriesForPlans(assetPlans);
   for (const k of Object.keys(assetEntries)) {

package/bin/np-tools/_commands.cjs

@@ -1,77 +1,111 @@
 const COMMANDS = [
-  { name: 'state',    category: 'Utility', description: 'Print the current project state snapshot' },
-  { name: 'help',     category: 'Utility', description: 'List available commands' },
-  { name: 'init',     category: 'Utility', description: 'Dispatcher init payload for workflows' },
+  { name: 'state',    category: 'Utility', description: 'Print the current project state snapshot', description_de: 'Gibt aktuellen Projekt-State-Snapshot aus' },
+  { name: 'help',     category: 'Utility', description: 'List available commands', description_de: 'Listet verfügbare Commands auf' },
+  { name: 'init',     category: 'Utility', description: 'Dispatcher init payload for workflows', description_de: 'Dispatcher-Init-Payload für Workflows' },
 
-  { name: 'discuss-project',     category: 'Planning', description: 'Adaptive project-context interview (writes PROJECT.md decisions)' },
-  { name: 'discuss-phase',       category: 'Planning', description: 'Adaptive milestone-context interview (writes M<NNN>-CONTEXT.md)' },
-  { name: 'research-phase',      category: 'Planning', description: 'Milestone-level research (WebFetch + MCP; offline fallback)' },
-  { name: 'plan-milestone',      category: 'Planning', description: 'Plan a milestone: scaffolds slices + tasks' },
-  { name: 'new-project',         category: 'Planning', description: 'Greenfield project init (PROJECT.md + REQUIREMENTS.md + M001 milestone)' },
-  { name: 'new-milestone',       category: 'Planning', description: 'Append a new milestone (M<NNN>) to an existing project' },
-  { name: 'propose-milestones',  category: 'Planning', description: 'Re-plan all not-yet-done milestones: AI proposes add/update/remove from PROJECT.md + REQUIREMENTS.md' },
-  { name: 'agent-skills',        category: 'Planning', description: 'Print agent_skills config for a given subagent' },
+  { name: 'discuss-project',     category: 'Planning', description: 'Adaptive project-context interview (writes PROJECT.md decisions)', description_de: 'Adaptives Projekt-Kontext-Interview (schreibt PROJECT.md-Entscheidungen)' },
+  { name: 'discuss-phase',       category: 'Planning', description: 'Adaptive milestone-context interview (writes M<NNN>-CONTEXT.md)', description_de: 'Adaptives Milestone-Kontext-Interview (schreibt M<NNN>-CONTEXT.md)' },
+  { name: 'research-phase',      category: 'Planning', description: 'Milestone-level research (WebFetch + MCP; offline fallback)', description_de: 'Milestone-Recherche (WebFetch + MCP; Offline-Fallback)' },
+  { name: 'plan-milestone',      category: 'Planning', description: 'Plan a milestone: scaffolds slices + tasks', description_de: 'Plant einen Milestone: erzeugt Slices + Tasks' },
+  { name: 'new-project',         category: 'Planning', description: 'Greenfield project init (PROJECT.md + REQUIREMENTS.md + M001 milestone)', description_de: 'Greenfield-Projekt-Init (PROJECT.md + REQUIREMENTS.md + M001-Milestone)' },
+  { name: 'new-milestone',       category: 'Planning', description: 'Append a new milestone (M<NNN>) to an existing project', description_de: 'Hängt einen neuen Milestone (M<NNN>) an ein bestehendes Projekt an' },
+  { name: 'propose-milestones',  category: 'Planning', description: 'Re-plan all not-yet-done milestones: AI proposes add/update/remove from PROJECT.md + REQUIREMENTS.md', description_de: 'Plant offene Milestones neu: KI schlägt add/update/remove aus PROJECT.md + REQUIREMENTS.md vor' },
+  { name: 'agent-skills',        category: 'Planning', description: 'Print agent_skills config for a given subagent', description_de: 'Gibt agent_skills-Konfiguration für einen Subagent aus' },
 
-  { name: 'execute-milestone',   category: 'Execution', description: 'Wave-based milestone execution — slice by slice, tasks parallel within a slice' },
-  { name: 'commit-task',         category: 'Execution', description: 'Atomic per-task git commit via lib/git.cjs' },
-  { name: 'checkpoint',          category: 'Execution', description: 'Per-task crash-safety checkpoint CRUD (start/transition/touch/show)' },
-  { name: 'verify-work',         category: 'Execution', description: 'Two-pass goal-backward verification (milestone-level VERIFICATION.md)' },
-  { name: 'add-tests',           category: 'Execution', description: 'Persist VERIFICATION Pass-cases as node:test UAT (Sentinel-preserving)' },
-  { name: 'pause-work',          category: 'Execution', description: 'Stamp STATE.session.stopped_at + resume_file for explicit handoff' },
-  { name: 'resume-work',         category: 'Execution', description: 'Classify session state (resume | orphan | clean) from STATE + checkpoints' },
+  { name: 'execute-milestone',   category: 'Execution', description: 'Wave-based milestone execution — slice by slice, tasks parallel within a slice', description_de: 'Wave-basierte Milestone-Ausführung — Slice für Slice, Tasks parallel innerhalb einer Slice' },
+  { name: 'commit-task',         category: 'Execution', description: 'Atomic per-task git commit via lib/git.cjs', description_de: 'Atomarer Per-Task-Git-Commit über lib/git.cjs' },
+  { name: 'checkpoint',          category: 'Execution', description: 'Per-task crash-safety checkpoint CRUD (start/transition/touch/show)', description_de: 'Per-Task-Checkpoint-CRUD für Crash-Safety (start/transition/touch/show)' },
+  { name: 'verify-work',         category: 'Execution', description: 'Two-pass goal-backward verification (milestone-level VERIFICATION.md)', description_de: 'Zweistufige Goal-Backward-Verifikation (Milestone-Ebene VERIFICATION.md)' },
+  { name: 'add-tests',           category: 'Execution', description: 'Persist VERIFICATION Pass-cases as node:test UAT (Sentinel-preserving)', description_de: 'Persistiert VERIFICATION-Pass-Cases als node:test-UAT (Sentinel-erhaltend)' },
+  { name: 'pause-work',          category: 'Execution', description: 'Stamp STATE.session.stopped_at + resume_file for explicit handoff', description_de: 'Setzt STATE.session.stopped_at + resume_file für expliziten Handoff' },
+  { name: 'resume-work',         category: 'Execution', description: 'Classify session state (resume | orphan | clean) from STATE + checkpoints', description_de: 'Klassifiziert Session-Zustand (resume | orphan | clean) aus STATE + Checkpoints' },
 
-  { name: 'skip',                category: 'Execution', description: 'Mark task status skipped (lifecycle CRUD)' },
-  { name: 'park',                category: 'Execution', description: 'Mark task status parked (lifecycle CRUD)' },
-  { name: 'unpark',              category: 'Execution', description: 'Return a parked task to pending (lifecycle CRUD)' },
+  { name: 'skip',                category: 'Execution', description: 'Mark task status skipped (lifecycle CRUD)', description_de: 'Markiert Task als skipped (Lifecycle-CRUD)' },
+  { name: 'park',                category: 'Execution', description: 'Mark task status parked (lifecycle CRUD)', description_de: 'Markiert Task als parked (Lifecycle-CRUD)' },
+  { name: 'unpark',              category: 'Execution', description: 'Return a parked task to pending (lifecycle CRUD)', description_de: 'Setzt parked Task zurück auf pending (Lifecycle-CRUD)' },
 
-  { name: 'undo',                category: 'Execution', description: 'Revert every task commit of a milestone or slice via git revert (no history rewrite)' },
-  { name: 'undo-task',           category: 'Execution', description: 'Revert a single task commit and reset task status to pending' },
-  { name: 'reset-slice',         category: 'Execution', description: 'Discard in-flight task: restore working tree from HEAD, drop checkpoint, clear STATE.current_task' },
+  { name: 'undo',                category: 'Execution', description: 'Revert every task commit of a milestone or slice via git revert (no history rewrite)', description_de: 'Revertiert alle Task-Commits eines Milestones oder einer Slice via git revert (kein History-Rewrite)' },
+  { name: 'undo-task',           category: 'Execution', description: 'Revert a single task commit and reset task status to pending', description_de: 'Revertiert einen einzelnen Task-Commit und setzt Task-Status auf pending zurück' },
+  { name: 'reset-slice',         category: 'Execution', description: 'Discard in-flight task: restore working tree from HEAD, drop checkpoint, clear STATE.current_task', description_de: 'Verwirft laufenden Task: stellt Working-Tree von HEAD wieder her, löscht Checkpoint, leert STATE.current_task' },
 
-  { name: 'doctor',              category: 'Install', description: '5-check install-integrity scan (--fix for auto-safe fixes)' },
-  { name: 'scan-codebase',       category: 'Install', description: 'Initial deep codebase inventory → .nubos-pilot/codebase/ skill docs' },
-  { name: 'update-docs',         category: 'Install', description: 'Refresh stale module docs after code changes' },
+  { name: 'doctor',              category: 'Install', description: '5-check install-integrity scan (--fix for auto-safe fixes)', description_de: '5-Check-Install-Integritäts-Scan (--fix für auto-sichere Fixes)' },
+  { name: 'scan-codebase',       category: 'Install', description: 'Initial deep codebase inventory → .nubos-pilot/codebase/ skill docs', description_de: 'Initiale tiefe Codebase-Inventur → .nubos-pilot/codebase/ Skill-Docs' },
+  { name: 'update-docs',         category: 'Install', description: 'Refresh stale module docs after code changes', description_de: 'Aktualisiert veraltete Modul-Docs nach Code-Änderungen' },
 
-  { name: 'resolve-model',       category: 'Utility', description: 'Resolve agent/tier to model alias or id (Tier×Profile matrix)' },
-  { name: 'metrics',             category: 'Utility', description: 'Record JSONL metrics entry (record | now | start-timestamp | end-timestamp)' },
+  { name: 'resolve-model',       category: 'Utility', description: 'Resolve agent/tier to model alias or id (Tier×Profile matrix)', description_de: 'Löst Agent/Tier zu Model-Alias oder -ID auf (Tier×Profile-Matrix)' },
+  { name: 'metrics',             category: 'Utility', description: 'Record JSONL metrics entry (record | now | start-timestamp | end-timestamp)', description_de: 'Schreibt JSONL-Metrics-Eintrag (record | now | start-timestamp | end-timestamp)' },
 
-  { name: 'validate-phase',      category: 'Review',  description: 'Nyquist validation gap-fill via np-nyquist-auditor' },
+  { name: 'validate-phase',      category: 'Review',  description: 'Nyquist validation gap-fill via np-nyquist-auditor', description_de: 'Nyquist-Validierungs-Gap-Fill über np-nyquist-auditor' },
 
-  { name: 'add-todo',            category: 'Capture', description: 'Capture a pending todo to .nubos-pilot/todos/pending/ + increment STATE count' },
-  { name: 'note',                category: 'Capture', description: 'Capture a free-form note (project default, --global writes to ~/.nubos-pilot/notes/)' },
-  { name: 'add-backlog',         category: 'Capture', description: 'Append backlog item to ROADMAP.md' },
+  { name: 'add-todo',            category: 'Capture', description: 'Capture a pending todo to .nubos-pilot/todos/pending/ + increment STATE count', description_de: 'Erfasst pending Todo nach .nubos-pilot/todos/pending/ + erhöht STATE-Counter' },
+  { name: 'note',                category: 'Capture', description: 'Capture a free-form note (project default, --global writes to ~/.nubos-pilot/notes/)', description_de: 'Erfasst freiformige Notiz (Projekt-Default, --global schreibt nach ~/.nubos-pilot/notes/)' },
+  { name: 'add-backlog',         category: 'Capture', description: 'Append backlog item to ROADMAP.md', description_de: 'Hängt Backlog-Eintrag an ROADMAP.md an' },
 
-  { name: 'askuser',         category: 'Utility', description: 'Capability-layer prompt wrapper (reads spec JSON, returns chosen label)' },
-  { 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: 'template-path',   category: 'Utility', description: 'Print absolute path to a package-shipped template by name (e.g. VALIDATION, milestone/CONTEXT)' },
-  { name: 'update-phase-meta', category: 'Planning', description: 'Update roadmap.yaml phase fields (name/goal/requirements/success_criteria) via JSON patch' },
-  { name: 'phase-meta',        category: 'Planning', description: 'Read roadmap.yaml phase fields as JSON (supports --field NAME and --length for arrays)' },
-  { name: 'state-dir',         category: 'Utility',  description: 'Print project-state directory (.nubos-pilot) or a validated subdir via --subdir NAME' },
-  { name: 'render-template',   category: 'Utility',  description: 'Render a shipped template by name with --vars JSON (or --vars-file PATH)' },
-  { name: 'render-todo',       category: 'Utility',  description: 'Render slice TODO.md rollup (checkbox view of task statuses) for a slice full-id' },
-  { name: 'handoff-write',     category: 'Capture',  description: 'Write an agent-to-agent handoff note (milestone-scoped by default, global without --milestone)' },
-  { name: 'handoff-read',      category: 'Capture',  description: 'Read a single handoff by id (returns frontmatter + body as JSON)' },
-  { name: 'handoff-list',      category: 'Capture',  description: 'List handoffs (JSON array); filter with --for AGENT, --milestone M<NNN>, --status STATUS, --global' },
-  { name: 'handoff-status',    category: 'Capture',  description: 'Update a handoff status (open|read|acted|archived)' },
-  { name: 'worktree-create',   category: 'Execution', description: 'Create an isolated git worktree for a slice (branch np/<mid>-<sid> off current HEAD) under .nubos-pilot/worktrees/' },
-  { name: 'worktree-remove',   category: 'Execution', description: 'Remove a slice worktree + delete its branch (--force / --keep-branch)' },
-  { name: 'worktree-list',     category: 'Execution', description: 'List all nubos-pilot-managed slice worktrees (np/<mid>-<sid> only) as JSON' },
-  { name: 'worktree-ff-merge', category: 'Execution', description: 'Fast-forward merge a slice branch back to its base (fails hard on non-FF)' },
-  { name: 'dashboard',         category: 'Utility',   description: 'One-shot console dashboard of milestones, slices, and tasks. Read-only; flags: --json, --no-color' },
-  { name: 'thread-resume',     category: 'Utility',  description: 'Bump a thread markdown on resume (status OPEN→IN_PROGRESS, refresh last_resumed) via atomic write' },
-  { name: 'state-incr',        category: 'Capture',  description: 'Increment a whitelisted STATE.md counter (e.g. pending_todos) under withFileLock' },
+  { name: 'askuser',         category: 'Utility', description: 'Capability-layer prompt wrapper (reads spec JSON, returns chosen label)', description_de: 'Capability-Layer-Prompt-Wrapper (liest Spec-JSON, gibt gewähltes Label zurück)' },
+  { name: 'commit',          category: 'Utility', description: 'Atomic git commit wrapper with gitignore-guard', description_de: 'Atomarer Git-Commit-Wrapper mit Gitignore-Guard' },
+  { name: 'config-get',      category: 'Utility', description: 'Read value from .nubos-pilot/config.json by dotted key path', description_de: 'Liest Wert aus .nubos-pilot/config.json über Dotted-Key-Pfad' },
+  { name: 'lang-directive',  category: 'Utility', description: 'Print workflow language directive from config.response_language (SSOT)', description_de: 'Gibt Workflow-Sprachdirektive aus config.response_language aus (SSOT)' },
+  { name: 'text-mode',       category: 'Utility', description: 'Print whether text mode is active (config.workflow.text_mode ∨ CLAUDECODE)', description_de: 'Gibt aus, ob Text-Mode aktiv ist (config.workflow.text_mode ∨ CLAUDECODE)' },
+  { name: 'generate-slug',   category: 'Utility', description: 'Slugify text via lib/layout.cjs.slugify', description_de: 'Slugifiziert Text über lib/layout.cjs.slugify' },
+  { name: 'stats',           category: 'Utility', description: 'Aggregated project stats — json | bar | markdown (markdown labels follow config.response_language)', description_de: 'Aggregierte Projekt-Stats — json | bar | markdown (markdown-Labels folgen config.response_language)' },
+  { name: 'detect-runtime',  category: 'Utility', description: 'Print detected runtime id (claude, codex, gemini, …) — reads config.json ∨ env ∨ default', description_de: 'Gibt erkannte Runtime-ID aus (claude, codex, gemini, …) — liest config.json ∨ env ∨ Default' },
+  { name: 'template-path',   category: 'Utility', description: 'Print absolute path to a package-shipped template by name (e.g. VALIDATION, milestone/CONTEXT)', description_de: 'Gibt absoluten Pfad zu paketmitgeliefertem Template per Name aus (z.B. VALIDATION, milestone/CONTEXT)' },
+  { name: 'update-phase-meta', category: 'Planning', description: 'Update roadmap.yaml phase fields (name/goal/requirements/success_criteria) via JSON patch', description_de: 'Aktualisiert roadmap.yaml-Phase-Felder (name/goal/requirements/success_criteria) via JSON-Patch' },
+  { name: 'phase-meta',        category: 'Planning', description: 'Read roadmap.yaml phase fields as JSON (supports --field NAME and --length for arrays)', description_de: 'Liest roadmap.yaml-Phase-Felder als JSON (unterstützt --field NAME und --length für Arrays)' },
+  { name: 'state-dir',         category: 'Utility',  description: 'Print project-state directory (.nubos-pilot) or a validated subdir via --subdir NAME', description_de: 'Gibt Projekt-State-Verzeichnis (.nubos-pilot) oder validiertes Subdir per --subdir NAME aus' },
+  { name: 'render-template',   category: 'Utility',  description: 'Render a shipped template by name with --vars JSON (or --vars-file PATH)', description_de: 'Rendert mitgeliefertes Template per Name mit --vars JSON (oder --vars-file PATH)' },
+  { name: 'render-todo',       category: 'Utility',  description: 'Render slice TODO.md rollup (checkbox view of task statuses) for a slice full-id', description_de: 'Rendert Slice-TODO.md-Rollup (Checkbox-Ansicht der Task-Status) für eine Slice-Full-ID' },
+  { name: 'handoff-write',     category: 'Capture',  description: 'Write an agent-to-agent handoff note (milestone-scoped by default, global without --milestone)', description_de: 'Schreibt Agent-zu-Agent-Handoff-Notiz (Milestone-scoped per Default, global ohne --milestone)' },
+  { name: 'handoff-read',      category: 'Capture',  description: 'Read a single handoff by id (returns frontmatter + body as JSON)', description_de: 'Liest einzelnen Handoff per ID (gibt Frontmatter + Body als JSON zurück)' },
+  { name: 'handoff-list',      category: 'Capture',  description: 'List handoffs (JSON array); filter with --for AGENT, --milestone M<NNN>, --status STATUS, --global', description_de: 'Listet Handoffs (JSON-Array); filtert mit --for AGENT, --milestone M<NNN>, --status STATUS, --global' },
+  { name: 'handoff-status',    category: 'Capture',  description: 'Update a handoff status (open|read|acted|archived)', description_de: 'Aktualisiert Handoff-Status (open|read|acted|archived)' },
+  { name: 'worktree-create',   category: 'Execution', description: 'Create an isolated git worktree for a slice (branch np/<mid>-<sid> off current HEAD) under .nubos-pilot/worktrees/', description_de: 'Erstellt isoliertes Git-Worktree für eine Slice (Branch np/<mid>-<sid> vom aktuellen HEAD) unter .nubos-pilot/worktrees/' },
+  { name: 'worktree-remove',   category: 'Execution', description: 'Remove a slice worktree + delete its branch (--force / --keep-branch)', description_de: 'Entfernt Slice-Worktree + löscht zugehörigen Branch (--force / --keep-branch)' },
+  { name: 'worktree-list',     category: 'Execution', description: 'List all nubos-pilot-managed slice worktrees (np/<mid>-<sid> only) as JSON', description_de: 'Listet alle nubos-pilot-verwalteten Slice-Worktrees (nur np/<mid>-<sid>) als JSON' },
+  { name: 'worktree-ff-merge', category: 'Execution', description: 'Fast-forward merge a slice branch back to its base (fails hard on non-FF)', description_de: 'Fast-Forward-Merge eines Slice-Branches zurück auf Base (bricht hart ab bei non-FF)' },
+  { name: 'dashboard',         category: 'Utility',   description: 'One-shot console dashboard of milestones, slices, and tasks. Read-only; flags: --json, --no-color', description_de: 'Einmaliges Konsolen-Dashboard für Milestones, Slices und Tasks. Read-only; Flags: --json, --no-color' },
+  { name: 'thread-resume',     category: 'Utility',  description: 'Bump a thread markdown on resume (status OPEN→IN_PROGRESS, refresh last_resumed) via atomic write', description_de: 'Bumpt Thread-Markdown beim Resume (Status OPEN→IN_PROGRESS, aktualisiert last_resumed) via atomic write' },
+  { name: 'state-incr',        category: 'Capture',  description: 'Increment a whitelisted STATE.md counter (e.g. pending_todos) under withFileLock', description_de: 'Erhöht whitelisteten STATE.md-Counter (z.B. pending_todos) unter withFileLock' },
 
-  { name: 'thread',           category: 'Utility', description: 'Cross-session thread CRUD (create/resume under .nubos-pilot/threads/)' },
-  { name: 'session-aggregate',     category: 'Utility', description: 'Aggregate session metrics under withFileLock; reads pointer .last-session unless --since overrides' },
-  { name: 'session-pointer-write', category: 'Utility', description: 'Atomic write of .nubos-pilot/reports/.last-session under withFileLock (ISO-8601 UTC)' },
-  { name: 'workspace-scan',        category: 'Install', description: 'Scan a workspace and emit inventory JSON (full result or --summary shape for /np:new-project)' },
-  { name: 'cleanup',          category: 'Utility', description: 'Archive completed milestones to .nubos-pilot/archive/v<X.Y>/' },
+  { name: 'thread',           category: 'Utility', description: 'Cross-session thread CRUD (create/resume under .nubos-pilot/threads/)', description_de: 'Cross-Session-Thread-CRUD (create/resume unter .nubos-pilot/threads/)' },
+  { name: 'session-aggregate',     category: 'Utility', description: 'Aggregate session metrics under withFileLock; reads pointer .last-session unless --since overrides', description_de: 'Aggregiert Session-Metriken unter withFileLock; liest Pointer .last-session, außer --since überschreibt' },
+  { name: 'session-pointer-write', category: 'Utility', description: 'Atomic write of .nubos-pilot/reports/.last-session under withFileLock (ISO-8601 UTC)', description_de: 'Atomares Schreiben von .nubos-pilot/reports/.last-session unter withFileLock (ISO-8601 UTC)' },
+  { name: 'workspace-scan',        category: 'Install', description: 'Scan a workspace and emit inventory JSON (full result or --summary shape for /np:new-project)', description_de: 'Scannt einen Workspace und liefert Inventar-JSON (volles Ergebnis oder --summary-Shape für /np:new-project)' },
+  { name: 'cleanup',          category: 'Utility', description: 'Archive completed milestones to .nubos-pilot/archive/v<X.Y>/', description_de: 'Archiviert abgeschlossene Milestones nach .nubos-pilot/archive/v<X.Y>/' },
 ];
 
-module.exports = { COMMANDS };
+const CATEGORY_LABELS = Object.freeze({
+  en: {
+    Utility:   'Utility',
+    Planning:  'Planning',
+    Execution: 'Execution',
+    Install:   'Install',
+    Review:    'Review',
+    Capture:   'Capture',
+  },
+  de: {
+    Utility:   'Werkzeuge',
+    Planning:  'Planung',
+    Execution: 'Ausführung',
+    Install:   'Installation',
+    Review:    'Review',
+    Capture:   'Erfassung',
+  },
+});
+
+function categoryLabel(category, language) {
+  const lang = (language === 'de') ? 'de' : 'en';
+  const map = CATEGORY_LABELS[lang] || CATEGORY_LABELS.en;
+  return map[category] || category;
+}
+
+function localizedCommands(language) {
+  const useDe = language === 'de';
+  return COMMANDS.map((c) => ({
+    name: c.name,
+    category: c.category,
+    description: useDe && c.description_de ? c.description_de : c.description,
+  }));
+}
+
+module.exports = { COMMANDS, CATEGORY_LABELS, categoryLabel, localizedCommands };

package/bin/np-tools/dashboard.cjs

@@ -1,12 +1,17 @@
 'use strict';
 
 const { collectSnapshot, renderSnapshot } = require('../../lib/dashboard.cjs');
+const { resolveLanguage, normalizeLanguage } = require('../../lib/language.cjs');
 
 function _parseArgs(args) {
-  const out = { json: false, noColor: false };
-  for (const a of args) {
-    if (a === '--json')     out.json = true;
+  const out = { json: false, noColor: false, lang: null };
+  const list = Array.isArray(args) ? args : [];
+  for (let i = 0; i < list.length; i++) {
+    const a = list[i];
+    if (a === '--json')          out.json = true;
     else if (a === '--no-color') out.noColor = true;
+    else if (a === '--lang')     out.lang = list[++i] || null;
+    else if (a.startsWith('--lang=')) out.lang = a.slice('--lang='.length);
   }
   return out;
 }
@@ -15,7 +20,7 @@ function run(args, opts) {
   const o = opts || {};
   const cwd = o.cwd || process.cwd();
   const stdout = o.stdout || process.stdout;
-  const parsed = _parseArgs(Array.isArray(args) ? args : []);
+  const parsed = _parseArgs(args);
 
   const snap = collectSnapshot(cwd);
   if (parsed.json) {
@@ -23,7 +28,8 @@ function run(args, opts) {
     return 0;
   }
   const useColor = !parsed.noColor && Boolean(stdout.isTTY);
-  stdout.write(renderSnapshot(snap, { color: useColor }) + '\n');
+  const language = parsed.lang ? normalizeLanguage(parsed.lang) : resolveLanguage(cwd);
+  stdout.write(renderSnapshot(snap, { color: useColor, language }) + '\n');
   return 0;
 }
 

package/bin/np-tools/dashboard.test.cjs

@@ -0,0 +1,80 @@
+'use strict';
+
+const { test, after } = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+
+const subcmd = require('./dashboard.cjs');
+
+const _roots = [];
+
+function _sandbox(configLanguage) {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'np-dashboard-cli-'));
+  fs.mkdirSync(path.join(root, '.nubos-pilot'), { recursive: true });
+  if (configLanguage !== undefined) {
+    fs.writeFileSync(
+      path.join(root, '.nubos-pilot', 'config.json'),
+      JSON.stringify({ response_language: configLanguage }),
+      'utf-8',
+    );
+  }
+  _roots.push(root);
+  return root;
+}
+
+function _capture() {
+  let buf = '';
+  return { stub: { write: (s) => { buf += s; }, isTTY: false }, get: () => buf };
+}
+
+after(() => {
+  while (_roots.length) {
+    const r = _roots.pop();
+    try { fs.rmSync(r, { recursive: true, force: true }); } catch {}
+  }
+});
+
+test('CLI-DB-1: parses --lang flag (space form)', () => {
+  const parsed = subcmd._parseArgs(['--lang', 'de']);
+  assert.equal(parsed.lang, 'de');
+});
+
+test('CLI-DB-2: parses --lang=xx flag (equals form)', () => {
+  const parsed = subcmd._parseArgs(['--lang=de']);
+  assert.equal(parsed.lang, 'de');
+});
+
+test('CLI-DB-3: dashboard reads response_language from config.json', () => {
+  const root = _sandbox('de');
+  const cap = _capture();
+  const code = subcmd.run([], { cwd: root, stdout: cap.stub });
+  assert.equal(code, 0);
+  assert.match(cap.get(), /Noch keine Milestones/);
+});
+
+test('CLI-DB-4: --lang overrides config language', () => {
+  const root = _sandbox('de');
+  const cap = _capture();
+  const code = subcmd.run(['--lang', 'en'], { cwd: root, stdout: cap.stub });
+  assert.equal(code, 0);
+  assert.match(cap.get(), /No milestones yet/);
+});
+
+test('CLI-DB-5: missing config falls back to English', () => {
+  const root = _sandbox();
+  const cap = _capture();
+  const code = subcmd.run([], { cwd: root, stdout: cap.stub });
+  assert.equal(code, 0);
+  assert.match(cap.get(), /No milestones yet/);
+});
+
+test('CLI-DB-6: --json snapshot stays language-neutral', () => {
+  const root = _sandbox('de');
+  const cap = _capture();
+  const code = subcmd.run(['--json'], { cwd: root, stdout: cap.stub });
+  assert.equal(code, 0);
+  const parsed = JSON.parse(cap.get());
+  assert.deepEqual(Object.keys(parsed), ['milestones']);
+});

package/bin/np-tools/help.cjs

@@ -1,6 +1,7 @@
-const { COMMANDS } = require('./_commands.cjs');
+const { COMMANDS, localizedCommands, categoryLabel } = require('./_commands.cjs');
+const { resolveLanguage } = require('../../lib/language.cjs');
 
-function _renderText(commands) {
+function _renderText(commands, language) {
   const byCat = new Map();
   for (const c of commands) {
     if (!byCat.has(c.category)) byCat.set(c.category, []);
@@ -8,7 +9,7 @@ function _renderText(commands) {
   }
   const lines = [];
   for (const [cat, items] of byCat) {
-    lines.push(cat);
+    lines.push(categoryLabel(cat, language));
     for (const c of items) {
       lines.push('  ' + c.name.padEnd(10) + c.description);
     }
@@ -17,12 +18,20 @@ function _renderText(commands) {
   return lines.join('\n').replace(/\n+$/, '\n');
 }
 
-function run(args) {
+function _resolveLangForCwd(cwd) {
+  try { return resolveLanguage(cwd || process.cwd()); }
+  catch { return 'en'; }
+}
+
+function run(args, ctx) {
   const list = Array.isArray(args) ? args : [];
+  const cwd = (ctx && ctx.cwd) || process.cwd();
+  const language = _resolveLangForCwd(cwd);
+  const cmds = localizedCommands(language);
   if (list.includes('--json')) {
-    return { commands: COMMANDS.slice() };
+    return { commands: cmds };
   }
-  return { text: _renderText(COMMANDS) };
+  return { text: _renderText(cmds, language) };
 }
 
-module.exports = { run };
+module.exports = { run, _renderText };

package/bin/np-tools/help.test.cjs

@@ -1,8 +1,24 @@
 const test = require('node:test');
 const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
 
 const helpCmd = require('./help.cjs');
 
+function _sandbox(language) {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'np-help-'));
+  fs.mkdirSync(path.join(root, '.nubos-pilot'), { recursive: true });
+  if (language !== undefined) {
+    fs.writeFileSync(
+      path.join(root, '.nubos-pilot', 'config.json'),
+      JSON.stringify({ response_language: language }),
+      'utf-8',
+    );
+  }
+  return root;
+}
+
 test('HELP-CMD-1: run([]) returns rendered text grouped by category with base command names', () => {
   const out = helpCmd.run([]);
   assert.ok(out && typeof out.text === 'string');
@@ -25,3 +41,50 @@ test('HELP-CMD-2: run([--json]) returns { commands: [...] } with all registered
     assert.ok(typeof c.description === 'string' && c.description.length > 0);
   }
 });
+
+test('HELP-L1: text render uses German category labels when config.response_language=de', () => {
+  const root = _sandbox('de');
+  try {
+    const out = helpCmd.run([], { cwd: root });
+    assert.match(out.text, /^Werkzeuge\b/m);
+    assert.match(out.text, /^Planung\b/m);
+    assert.match(out.text, /^Ausführung\b/m);
+    assert.equal(/^Utility\b/m.test(out.text), false, 'must not show English category in de mode');
+  } finally {
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+});
+
+test('HELP-L2: text render uses German command descriptions when config language=de', () => {
+  const root = _sandbox('de');
+  try {
+    const out = helpCmd.run([], { cwd: root });
+    assert.match(out.text, /Listet verfügbare Commands auf/);
+    assert.match(out.text, /Gibt aktuellen Projekt-State-Snapshot aus/);
+  } finally {
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+});
+
+test('HELP-L3: --json descriptions are localized but category stays canonical English key', () => {
+  const root = _sandbox('de');
+  try {
+    const out = helpCmd.run(['--json'], { cwd: root });
+    const help = out.commands.find((c) => c.name === 'help');
+    assert.equal(help.description, 'Listet verfügbare Commands auf');
+    assert.equal(help.category, 'Utility', 'category stays English so consumers can switch on it');
+  } finally {
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+});
+
+test('HELP-L4: missing config falls back to English', () => {
+  const root = _sandbox();
+  try {
+    const out = helpCmd.run([], { cwd: root });
+    assert.match(out.text, /^Utility\b/m);
+    assert.match(out.text, /List available commands/);
+  } finally {
+    fs.rmSync(root, { recursive: true, force: true });
+  }
+});

package/bin/np-tools/stats.cjs

@@ -6,12 +6,50 @@ 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 { resolveLanguage } = require('../../lib/language.cjs');
 const layout = require('../../lib/layout.cjs');
 
 const SCHEMA_VERSION = 2;
 
+const MD_LABELS = Object.freeze({
+  en: {
+    title: '## Project Stats',
+    milestone: '**Milestone:**',
+    progress: '**Progress:**',
+    plans: 'plans',
+    last_activity: '**Last activity:**',
+    commits: '**Commits:**',
+    started: '**Project started:**',
+    phases_h: '### Phases',
+    metrics_h: '### Metrics by Phase',
+    cols_phases: '| Phase | Name | Plans | Completed | Status | % |',
+    sep_phases:  '|-------|------|-------|-----------|--------|---|',
+    cols_metrics: '| Phase | Records | Tokens In | Tokens Out | Avg Opus ms | Avg Sonnet ms | Avg Haiku ms | Errors |',
+    sep_metrics:  '|-------|---------|-----------|------------|-------------|---------------|--------------|--------|',
+  },
+  de: {
+    title: '## Projekt-Stats',
+    milestone: '**Milestone:**',
+    progress: '**Fortschritt:**',
+    plans: 'Pläne',
+    last_activity: '**Letzte Aktivität:**',
+    commits: '**Commits:**',
+    started: '**Projekt-Start:**',
+    phases_h: '### Phasen',
+    metrics_h: '### Metriken pro Phase',
+    cols_phases: '| Phase | Name | Pläne | Fertig | Status | % |',
+    sep_phases:  '|-------|------|-------|--------|--------|---|',
+    cols_metrics: '| Phase | Records | Tokens In | Tokens Out | Ø Opus ms | Ø Sonnet ms | Ø Haiku ms | Fehler |',
+    sep_metrics:  '|-------|---------|-----------|------------|-----------|-------------|------------|--------|',
+  },
+});
+
+function _mdLabelsFor(language) {
+  return MD_LABELS[language === 'de' ? 'de' : 'en'];
+}
+
 function _usage() {
-  return 'Usage:\n  np-tools.cjs stats json\n  np-tools.cjs stats bar';
+  return 'Usage:\n  np-tools.cjs stats json\n  np-tools.cjs stats bar\n  np-tools.cjs stats markdown';
 }
 
 function _percent(num, den) {
@@ -181,6 +219,55 @@ async function _buildStats(cwd) {
   };
 }
 
+function _fmt(v) {
+  if (v === null || v === undefined) return '—';
+  if (typeof v === 'number') return v.toLocaleString();
+  return String(v);
+}
+
+function _renderMarkdown(stats, language) {
+  const L = _mdLabelsFor(language);
+  const filled = Math.round((stats.percent || 0) / 5);
+  const bar = '█'.repeat(filled) + '░'.repeat(20 - filled);
+  const lines = [];
+  lines.push(L.title);
+  lines.push('');
+  lines.push(L.milestone + ' ' + _fmt(stats.milestone && stats.milestone.version) + ' — ' + _fmt(stats.milestone && stats.milestone.name));
+  lines.push(L.progress + ' [' + bar + '] ' + (stats.percent || 0) + '% (' + stats.plans_complete + '/' + stats.plans_total + ' ' + L.plans + ')');
+  lines.push(L.last_activity + ' ' + _fmt(stats.last_activity));
+  lines.push(L.commits + ' ' + _fmt(stats.git && stats.git.commits));
+  lines.push(L.started + ' ' + _fmt(stats.git && stats.git.first_commit_at));
+  lines.push('');
+  lines.push(L.phases_h);
+  lines.push('');
+  lines.push(L.cols_phases);
+  lines.push(L.sep_phases);
+  for (const ph of (stats.phases || [])) {
+    const pct = ph.plans_total > 0 ? Math.round(ph.plans_complete / ph.plans_total * 100) : 0;
+    lines.push('| ' + ph.number + ' | ' + ph.name + ' | ' + ph.plans_total + ' | ' + ph.plans_complete + ' | ' + ph.status + ' | ' + pct + '% |');
+  }
+  lines.push('');
+  lines.push(L.metrics_h);
+  lines.push('');
+  lines.push(L.cols_metrics);
+  lines.push(L.sep_metrics);
+  for (const ph of (stats.phases || [])) {
+    const m = (stats.metrics_by_phase || {})[ph.number];
+    if (!m || m.record_count === 0) {
+      lines.push('| ' + ph.number + ' | — | — | — | — | — | — | — |');
+      continue;
+    }
+    const t = m.avg_duration_ms_by_tier || {};
+    lines.push('| ' + ph.number + ' | ' + m.record_count + ' | ' + _fmt(m.total_tokens_in) + ' | ' + _fmt(m.total_tokens_out) + ' | ' + _fmt(t.opus) + ' | ' + _fmt(t.sonnet) + ' | ' + _fmt(t.haiku) + ' | ' + m.error_count + ' |');
+  }
+  return lines.join('\n') + '\n';
+}
+
+function _resolveLangForCwd(cwd) {
+  try { return resolveLanguage(cwd || process.cwd()); }
+  catch { return 'en'; }
+}
+
 async function run(argv, ctx) {
   const context = ctx || {};
   const cwd = context.cwd || process.cwd();
@@ -188,7 +275,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' && sub !== 'bar') {
+  if (sub !== 'json' && sub !== 'bar' && sub !== 'markdown') {
     stderr.write(_usage() + '\n');
     return 1;
   }
@@ -205,6 +292,15 @@ async function run(argv, ctx) {
       stdout.write(_renderBar('Slices', out.slices.percent) + '  (' + out.slices.complete + '/' + out.slices.total + ')\n');
       return 0;
     }
+    if (sub === 'markdown') {
+      let lang = null;
+      const langIdx = args.indexOf('--lang');
+      if (langIdx >= 0 && args[langIdx + 1]) lang = args[langIdx + 1];
+      else for (const a of args) if (a.startsWith('--lang=')) lang = a.slice('--lang='.length);
+      const language = lang || _resolveLangForCwd(cwd);
+      stdout.write(_renderMarkdown(out, language));
+      return 0;
+    }
     stdout.write(JSON.stringify(out, null, 2) + '\n');
     return 0;
   } catch (err) {
@@ -213,7 +309,7 @@ async function run(argv, ctx) {
   }
 }
 
-module.exports = { run, _buildStats, _collectPhases, _milestoneEntry, _collectTaskAndSliceStats, _renderBar };
+module.exports = { run, _buildStats, _collectPhases, _milestoneEntry, _collectTaskAndSliceStats, _renderBar, _renderMarkdown, MD_LABELS };
 
 if (require.main === module) {
   run(process.argv.slice(2)).then((code) => process.exit(code)).catch((err) => {