nubos-pilot 0.5.0 → 0.5.2

package/bin/install.js

@@ -64,10 +64,25 @@ function _autoAskUser(spec) {
   });
 }
 
-const MANAGED_BLOCK_INNER =
-  'This project uses [nubos-pilot](https://github.com/nubos/nubos-pilot)'
-  + ' for planning and execution.\n\nRun `npx nubos-pilot doctor`'
-  + ' to check install integrity.';
+const LANG_DIRECTIVES = {
+  de: 'Sprache: **Deutsch.** Jede nubos-pilot Slash-Command-Ausgabe, jede Frage an den User und jedes Statusupdate in allen `/np:*` Workflows ist auf Deutsch zu schreiben — inklusive Fehlermeldungen und Klärungsfragen. Nur Code, Bash-Kommandos, Tool-Outputs und Commit-Messages bleiben wie sie sind.',
+  en: 'Language: **English.** All `/np:*` slash-command output, askuser prompts and status updates respond in English.',
+};
+
+function _langDirective(responseLanguage) {
+  const lang = String(responseLanguage || 'en').toLowerCase();
+  if (LANG_DIRECTIVES[lang]) return LANG_DIRECTIVES[lang];
+  return 'Language: respond in the ISO-639 language `' + lang + '` for all `/np:*` slash-command output, askuser prompts and status updates.';
+}
+
+function _managedBlockInner(responseLanguage) {
+  return (
+    'This project uses [nubos-pilot](https://github.com/nubos/nubos-pilot)'
+    + ' for planning and execution.\n\n'
+    + _langDirective(responseLanguage)
+    + '\n\nRun `npx nubos-pilot doctor` to check install integrity.'
+  );
+}
 
 const VALID_AGENTS = registryMod.listRuntimeIds();
 const VALID_SCOPES = ['local', 'global'];
@@ -139,6 +154,25 @@ function _opencodeManifestPrefix(scope) {
     : OPENCODE_MANIFEST_PREFIX;
 }
 
+function _writeToolsShim(projectRoot) {
+  const shimDir = path.join(projectRoot, STATE_SUBPATH, 'bin');
+  const shimPath = path.join(shimDir, 'np-tools.cjs');
+  const target = path.resolve(__dirname, '..', 'np-tools.cjs');
+  const body = '#!/usr/bin/env node\n'
+    + "'use strict';\n"
+    + 'const fs = require(\'node:fs\');\n'
+    + 'const TARGET = ' + JSON.stringify(target) + ';\n'
+    + 'if (!fs.existsSync(TARGET)) {\n'
+    + '  process.stderr.write("nubos-pilot: tool binary fehlt unter " + TARGET + "\\nFix: npx nubos-pilot@latest update\\n");\n'
+    + '  process.exit(1);\n'
+    + '}\n'
+    + 'require(TARGET).main();\n';
+  fs.mkdirSync(shimDir, { recursive: true });
+  atomicWriteFileSync(shimPath, body);
+  try { fs.chmodSync(shimPath, 0o755); } catch {}
+  return shimPath;
+}
+
 function _stateDirFor(projectRoot) {
   return path.join(projectRoot, STATE_SUBPATH);
 }
@@ -254,37 +288,48 @@ const DEFAULT_CLAUDE_MD = '# CLAUDE.md\n\n'
   + 'Project guidance for Claude Code. Add project-specific instructions above the'
   + ' managed block — `npx nubos-pilot` only rewrites the block between the markers.\n';
 
-function _rewriteManagedMarkdown(projectRoot, runtimes) {
+function _rewriteManagedMarkdown(projectRoot, runtimes, responseLanguage) {
+  const innerMd = _managedBlockInner(responseLanguage);
   const claudePath = path.join(projectRoot, 'CLAUDE.md');
-  const agentsPath = path.join(projectRoot, 'AGENTS.md');
-  const geminiPath = path.join(projectRoot, 'GEMINI.md');
   const claudeBase = fs.existsSync(claudePath)
     ? fs.readFileSync(claudePath, 'utf-8')
     : DEFAULT_CLAUDE_MD;
-  const claudeNext = managedBlockMod.rewriteBlock(claudeBase, MANAGED_BLOCK_INNER);
-  atomicWriteFileSync(claudePath, claudeNext);
-
-  const agentsBase = fs.existsSync(agentsPath)
-    ? fs.readFileSync(agentsPath, 'utf-8')
-    : agentsMdMod.generateAgentsMd(claudeNext, 'codex');
-  atomicWriteFileSync(agentsPath, managedBlockMod.rewriteBlock(agentsBase, MANAGED_BLOCK_INNER));
-
-  const geminiBase = fs.existsSync(geminiPath)
-    ? fs.readFileSync(geminiPath, 'utf-8')
-    : agentsMdMod.generateAgentsMd(claudeNext, 'gemini');
-  atomicWriteFileSync(geminiPath, managedBlockMod.rewriteBlock(geminiBase, MANAGED_BLOCK_INNER));
+  const claudeRendered = managedBlockMod.rewriteBlock(claudeBase, innerMd);
 
-  const extras = (runtimes || []).filter((id) => !LEGACY_AGENTS.has(id));
-  for (const id of extras) {
+  const ids = Array.isArray(runtimes) && runtimes.length ? runtimes : ['claude'];
+  const written = new Set();
+  for (const id of ids) {
+    if (id === 'opencode') continue;
     const meta = registryMod.getRuntimeMeta(id);
     if (!meta) continue;
     const targetPath = registryMod.runtimeAgentsPath(meta, 'local', projectRoot);
+    if (written.has(targetPath)) continue;
+    written.add(targetPath);
+
+    if (id === 'claude' && path.resolve(targetPath) === path.resolve(claudePath)) {
+      fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+      atomicWriteFileSync(targetPath, claudeRendered);
+      continue;
+    }
+
     const base = fs.existsSync(targetPath)
       ? fs.readFileSync(targetPath, 'utf-8')
-      : agentsMdMod.generateAgentsMd(claudeNext, 'codex');
-    const next = managedBlockMod.rewriteBlock(base, MANAGED_BLOCK_INNER);
+      : agentsMdMod.generateAgentsMd(claudeRendered, id === 'gemini' ? 'gemini' : 'codex');
     fs.mkdirSync(path.dirname(targetPath), { recursive: true });
-    atomicWriteFileSync(targetPath, next);
+    atomicWriteFileSync(targetPath, managedBlockMod.rewriteBlock(base, innerMd));
+  }
+
+  const stalePaths = [claudePath, path.join(projectRoot, 'AGENTS.md'), path.join(projectRoot, 'GEMINI.md')];
+  for (const p of stalePaths) {
+    if (written.has(p)) continue;
+    if (!fs.existsSync(p)) continue;
+    const current = fs.readFileSync(p, 'utf-8');
+    const stripped = managedBlockMod.stripBlock(current);
+    if (stripped.trim().length === 0) {
+      try { fs.unlinkSync(p); } catch {}
+    } else if (stripped !== current) {
+      atomicWriteFileSync(p, stripped);
+    }
   }
 }
 
@@ -464,7 +509,8 @@ async function _runInstallLocked(ctx) {
   }
 
   const selectedRuntimes = (initConfig && initConfig.runtimes) || (initConfig ? [initConfig.runtime] : []);
-  _rewriteManagedMarkdown(projectRoot, selectedRuntimes);
+  const responseLanguage = initConfig && initConfig.response_language;
+  _rewriteManagedMarkdown(projectRoot, selectedRuntimes, responseLanguage);
 
   if (assetPlans.length) {
     runtimeAssetsMod.writeRuntimeAssets(assetPlans);
@@ -474,6 +520,10 @@ async function _runInstallLocked(ctx) {
     runtimeAssetsMod.removeStaleAssets(assetStale, resolvedScope, projectRoot);
   }
 
+  try { _writeToolsShim(projectRoot); } catch (err) {
+    console.error(yellow + '  [shim] np-tools shim skipped: ' + (err && err.message) + reset);
+  }
+
   if (initConfig && initConfig.mcp && !dryRun) {
     try {
       const mcpWriter = require('../lib/install/mcp-writer.cjs');
@@ -631,8 +681,10 @@ async function main() {
       return await runInstall({ cwd, mode: detectMode(cwd), flags });
     case '--dry-run':
       return await runInstall({ cwd, mode: detectMode(cwd), dryRun: true, flags });
-    case 'update':
-      return await runInstall({ cwd, mode: 'update', flags });
+    case 'update': {
+      const detected = detectMode(cwd);
+      return await runInstall({ cwd, mode: detected === 'init' ? 'init' : 'update', flags });
+    }
     case 'uninstall':
       return await runUninstall({ cwd, args: rest.slice(1) });
     case 'doctor': {

package/package.json

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

package/workflows/add-tests.md

@@ -17,7 +17,7 @@ sentinels survive regeneration.
 
 ```bash
 PHASE="$1"
-INIT=$(node np-tools.cjs init add-tests "$PHASE")
+INIT=$(node .nubos-pilot/bin/np-tools.cjs init add-tests "$PHASE")
 ```
 
 Parse: `phase`, `target_path`, `verification_path`, `pass_cases[]`,
@@ -29,7 +29,7 @@ Parse: `phase`, `target_path`, `verification_path`, `pass_cases[]`,
 Emit/merge the Sentinel block:
 
 ```bash
-node np-tools.cjs init add-tests emit "$PHASE"
+node .nubos-pilot/bin/np-tools.cjs init add-tests emit "$PHASE"
 ```
 
 Smoke-run the generated file to catch syntax errors early:

package/workflows/add-todo.md

@@ -18,7 +18,7 @@ metrics record. The `workflow-missing-metrics` lint in
 `bin/check-workflows.cjs` only fires on `Task(` / `Spawn agent=` sites,
 so CRUD-only workflows are exempt (Pitfall 9 resolution from
 Plan 10-05). All interactive prompts route through
-`node np-tools.cjs askuser --json` per INST-03.
+`node .nubos-pilot/bin/np-tools.cjs askuser --json` per INST-03.
 
 ## Initialize
 
@@ -29,7 +29,7 @@ if [[ -z "$DESCRIPTION" ]]; then
   exit 2
 fi
 
-INIT=$(node np-tools.cjs init add-todo "$DESCRIPTION")
+INIT=$(node .nubos-pilot/bin/np-tools.cjs init add-todo "$DESCRIPTION")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 
 SLUG=$(echo "$INIT" | jq -r '.slug')
@@ -64,7 +64,7 @@ skip (keep both), or rename-with-counter (append `-2`, `-3`, etc.).
 
 ```bash
 if [[ -f "$TODO_PATH" ]]; then
-  CHOICE=$(node np-tools.cjs askuser --json '{
+  CHOICE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{
     "type": "select",
     "header": "Duplicate todo",
     "question": "A todo already exists at '"${TODO_PATH}"'. What would you like to do?",
@@ -135,12 +135,12 @@ frontmatter. The lock serialises concurrent writers (two parallel
 
 ## Commit
 
-Route through `node np-tools.cjs commit` so
+Route through `node .nubos-pilot/bin/np-tools.cjs commit` so
 `lib/git.cjs.assertCommittablePaths()` validates the paths before
 `git add` (path-traversal guard from Plan 10-01-T04).
 
 ```bash
-node np-tools.cjs commit "docs(10): add todo — ${SLUG}" --files "$TODO_PATH" "$STATE_PATH"
+node .nubos-pilot/bin/np-tools.cjs commit "docs(10): add todo — ${SLUG}" --files "$TODO_PATH" "$STATE_PATH"
 ```
 
 Both the new todo file and STATE.md land in a single atomic commit per
@@ -167,16 +167,16 @@ Use /np:next to surface this todo in the next-step picker.
   (D-20 single-writer lock; T-10-05-06 mitigation).
 - Use the `Write` tool for the new markdown file — never a bash
   heredoc or `echo >`.
-- Route the final commit through `node np-tools.cjs commit` so
+- Route the final commit through `node .nubos-pilot/bin/np-tools.cjs commit` so
   `lib/git.cjs.assertCommittablePaths()` runs the gitignore-guard.
-- Derive the slug via `node np-tools.cjs init add-todo` (filename
+- Derive the slug via `node .nubos-pilot/bin/np-tools.cjs init add-todo` (filename
   sanitisation, T-10-05-01 mitigation) — not via ad-hoc `sed`.
 - Commit todo file + STATE.md together as a single atomic unit.
 
 **Don't:**
 - Invoke host-specific prompt tools directly (the BARE_ASKUSER lint in
   `bin/check-workflows.cjs` blocks them) — always route through
-  `node np-tools.cjs askuser --json '…'`.
+  `node .nubos-pilot/bin/np-tools.cjs askuser --json '…'`.
 - Read STATE.md via raw filesystem calls (DIRECT_READ lint blocks
   those patterns) — let `mutateState` handle the lock.
 - Add a `metrics record` block. There is no Task/Spawn site in this

package/workflows/discuss-phase.md

@@ -19,7 +19,7 @@ workflow delivers PLAN-01 and nothing beyond it.
 ## Initialize
 
 ```bash
-INIT=$(node np-tools.cjs init discuss-phase "$PHASE")
+INIT=$(node .nubos-pilot/bin/np-tools.cjs init discuss-phase "$PHASE")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 
@@ -146,7 +146,7 @@ Text mode applies to ALL workflows in the session, not just discuss-phase.
 If `has_context` is `true`, ask the user how to proceed:
 
 ```bash
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "select",
   "prompt": "Milestone '"$MILESTONE_ID"' already has a CONTEXT.md. What do you want to do?",
   "options": [
@@ -184,7 +184,7 @@ user expects (users sometimes discover the roadmap goal is stale before
 discussion starts):
 
 ```bash
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "confirm",
   "prompt": "ROADMAP goal for phase '"$PHASE"': \"'"$GOAL"'\". Still accurate?",
   "default": true
@@ -195,7 +195,7 @@ If the user says `no`, capture the refined goal with a free-text input call
 and record it for the `<domain>` section of CONTEXT.md:
 
 ```bash
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "input",
   "prompt": "Refined goal for phase '"$PHASE"':"
 }'
@@ -208,7 +208,7 @@ generic UI/UX labels — specific decisions like "Session handling", "Error
 responses", "Multi-device policy"). Present them via a multi-select:
 
 ```bash
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "multiselect",
   "prompt": "Which areas do you want to discuss for '"$PHASE_NAME"'?",
   "options": [
@@ -233,20 +233,20 @@ Per area, the recommended flow is:
 
 ```bash
 # Decision question (typed as select when options exist)
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "select",
   "prompt": "For <area>: <specific decision>?",
   "options": ["<choice A>", "<choice B>", "<choice C>"]
 }'
 
 # Follow-up free-text capture when the user picks "Other" or needs nuance
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "input",
   "prompt": "Anything specific about <area> downstream agents must know?"
 }'
 
 # Continuation gate
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "select",
   "prompt": "More questions about <area>, or move on?",
   "options": ["More questions", "Next area"]
@@ -256,7 +256,7 @@ node np-tools.cjs askuser --json '{
 After all selected areas are covered:
 
 ```bash
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "select",
   "prompt": "We have discussed <areas>. Anything else before we write CONTEXT.md?",
   "options": ["Explore more gray areas", "I am ready for CONTEXT.md"]
@@ -277,35 +277,35 @@ Collect short free-text inputs for the remaining required sections before
 rendering:
 
 ```bash
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "input",
   "prompt": "Canonical refs (paths to ADRs/specs/docs downstream agents must read) — comma separated or \"none\":"
 }'
 ```
 
 ```bash
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "input",
   "prompt": "Reusable code / existing assets relevant to this phase — or \"none\":"
 }'
 ```
 
 ```bash
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "input",
   "prompt": "Specific references (\"I want it like X\" moments) — or \"none\":"
 }'
 ```
 
 ```bash
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "input",
   "prompt": "Deferred ideas (things we noted but belong in later phases) — or \"none\":"
 }'
 ```
 
 ```bash
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "input",
   "prompt": "Claude\u2019s Discretion — areas where you want Claude to decide without asking:"
 }'
@@ -356,7 +356,7 @@ that error. Fix the template or the accumulator, don't mask the failure.
 ### Step 7: Commit respecting config.commit_docs
 
 ```bash
-COMMIT_DOCS=$(node np-tools.cjs config-get workflow.commit_docs 2>/dev/null || echo "true")
+COMMIT_DOCS=$(node .nubos-pilot/bin/np-tools.cjs config-get workflow.commit_docs 2>/dev/null || echo "true")
 if [[ "$COMMIT_DOCS" == "true" ]]; then
   git add "$CONTEXT_PATH"
   git commit -m "docs($MILESTONE_ID): capture milestone context"
@@ -369,7 +369,7 @@ opting into manual commit gating.
 ### Step 8: Confirm and next steps
 
 ```bash
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "confirm",
   "prompt": "CONTEXT.md written at '"$CONTEXT_PATH"'. Run np:plan-phase '"$PHASE"' now?",
   "default": true

package/workflows/discuss-project.md

@@ -51,7 +51,7 @@ Never:
 ## Single-Call Init
 
 ```bash
-INIT=$(node np-tools.cjs init discuss-project ${BOOTSTRAP:+--bootstrap})
+INIT=$(node .nubos-pilot/bin/np-tools.cjs init discuss-project ${BOOTSTRAP:+--bootstrap})
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 
@@ -134,7 +134,7 @@ REQ_FILE=$(mktemp -t np-proposed-reqs-XXXXXX.json)
 ANSWERS=$(mktemp -t np-discuss-project-answers.XXXXXX.json)
 # Write the six answer fields as JSON
 
-node np-tools.cjs init discuss-project --apply "$ANSWERS" \
+node .nubos-pilot/bin/np-tools.cjs init discuss-project --apply "$ANSWERS" \
   ${BOOTSTRAP:+--bootstrap} \
   ${REQ_FILE:+--proposed-requirements "$REQ_FILE"}
 ```
@@ -145,7 +145,7 @@ and appends a "Proposed" block to REQUIREMENTS.md. Both writes are atomic.
 ### Step 5: Commit respecting config.commit_docs
 
 ```bash
-COMMIT_DOCS=$(node np-tools.cjs config-get workflow.commit_docs 2>/dev/null || echo "true")
+COMMIT_DOCS=$(node .nubos-pilot/bin/np-tools.cjs config-get workflow.commit_docs 2>/dev/null || echo "true")
 if [[ "$COMMIT_DOCS" == "true" ]]; then
   git add .nubos-pilot/PROJECT.md .nubos-pilot/REQUIREMENTS.md 2>/dev/null || true
   git commit -m "docs: np:discuss-project ${BOOTSTRAP:+bootstrap}${BOOTSTRAP:-refresh}" 2>/dev/null || true

package/workflows/doctor.md

@@ -12,5 +12,5 @@ Use `--fix` to apply auto-safe fixes; anything touching user files outside the
 manifest will prompt via `askUser()` (SC-5).
 
 ```bash
-node np-tools.cjs doctor "$@"
+node .nubos-pilot/bin/np-tools.cjs doctor "$@"
 ```

package/workflows/execute-phase.md

@@ -7,7 +7,7 @@ argument-hint: <milestone-number>
 # /np:execute-phase
 
 <objective>
-Execute every slice of a milestone in wave order: slice S001 first (all its tasks in parallel), then S002, etc. Per task: start a checkpoint, spawn `agents/np-executor.md` (sonnet), verify, and invoke `node np-tools.cjs commit-task <task-full-id>` for the atomic commit. All git operations route through lib/git.cjs — agents NEVER call `git` directly (ADR-0004, CLAUDE.md §Git operations).
+Execute every slice of a milestone in wave order: slice S001 first (all its tasks in parallel), then S002, etc. Per task: start a checkpoint, spawn `agents/np-executor.md` (sonnet), verify, and invoke `node .nubos-pilot/bin/np-tools.cjs commit-task <task-full-id>` for the atomic commit. All git operations route through lib/git.cjs — agents NEVER call `git` directly (ADR-0004, CLAUDE.md §Git operations).
 
 **Wave semantics:** one slice == one wave. Tasks in a slice have no intra-slice deps (they're parallel-safe by planner contract). Cross-slice deps flow forward only: a task in S002 may depend on a task in S001.
 </objective>
@@ -16,9 +16,9 @@ Execute every slice of a milestone in wave order: slice S001 first (all its task
 
 ```bash
 PHASE="$1"
-INIT=$(node np-tools.cjs init execute-milestone "$PHASE")
+INIT=$(node .nubos-pilot/bin/np-tools.cjs init execute-milestone "$PHASE")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-AGENT_SKILLS_EXECUTOR=$(node np-tools.cjs agent-skills executor 2>/dev/null)
+AGENT_SKILLS_EXECUTOR=$(node .nubos-pilot/bin/np-tools.cjs agent-skills executor 2>/dev/null)
 RUNTIME=$(node -e "console.log(require('./lib/runtime/index.cjs').detect().runtime)")
 ```
 
@@ -31,10 +31,10 @@ Parse JSON for: `milestone`, `milestone_id`, `milestone_dir`, `waves[]` (each wi
 Detect stale checkpoints from a prior run before starting new work:
 
 ```bash
-RESUME=$(node np-tools.cjs init resume-work)
+RESUME=$(node .nubos-pilot/bin/np-tools.cjs init resume-work)
 RESUME_STATUS=$(echo "$RESUME" | node -e "process.stdin.on('data', d => console.log(JSON.parse(d).status))")
 if [ "$RESUME_STATUS" = "orphan" ]; then
-  CHOICE=$(node np-tools.cjs askuser --json '{
+  CHOICE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{
     "type": "select",
     "header": "Verwaiste Checkpoints gefunden",
     "question": "Vor dem Milestone-Start wurden Checkpoint-Dateien ohne passenden STATE.current_task gefunden. Was tun?",
@@ -87,13 +87,13 @@ for WAVE_INDEX in 0 1 2 ...; do
   # message (multiple Agent tool use blocks in one send).
   for TASK_ID in $TASK_IDS; do
     # IN PARALLEL:
-    node np-tools.cjs checkpoint start "$TASK_ID" --phase "$PHASE" --plan "$SLICE_FULL_ID" --wave "$((WAVE_INDEX+1))"
+    node .nubos-pilot/bin/np-tools.cjs checkpoint start "$TASK_ID" --phase "$PHASE" --plan "$SLICE_FULL_ID" --wave "$((WAVE_INDEX+1))"
 
-    TASK_JSON=$(node np-tools.cjs init execute-milestone execute-task "$PHASE" "$TASK_ID")
+    TASK_JSON=$(node .nubos-pilot/bin/np-tools.cjs init execute-milestone execute-task "$PHASE" "$TASK_ID")
     if [[ "$TASK_JSON" == @file:* ]]; then TASK_JSON=$(cat "${TASK_JSON#@file:}"); fi
 
-    EXECUTOR_START=$(node np-tools.cjs metrics start-timestamp)
-    EXECUTOR_MODEL=$(node np-tools.cjs resolve-model executor --profile frontier)
+    EXECUTOR_START=$(node .nubos-pilot/bin/np-tools.cjs metrics start-timestamp)
+    EXECUTOR_MODEL=$(node .nubos-pilot/bin/np-tools.cjs resolve-model executor --profile frontier)
 
     # Spawn agents/np-executor.md (tier: sonnet, model resolved as $EXECUTOR_MODEL)
     # with a <files_to_read> block containing: the task plan file, the slice
@@ -101,15 +101,15 @@ for WAVE_INDEX in 0 1 2 ...; do
     # Executor edits EXACTLY the paths in files_modified (D-04 — no scope
     # expansion), runs <verify> commands, then invokes commit-task:
 
-    node np-tools.cjs checkpoint transition "$TASK_ID" verifying
-    node np-tools.cjs checkpoint transition "$TASK_ID" pre-commit
-    node np-tools.cjs commit-task "$TASK_ID"
+    node .nubos-pilot/bin/np-tools.cjs checkpoint transition "$TASK_ID" verifying
+    node .nubos-pilot/bin/np-tools.cjs checkpoint transition "$TASK_ID" pre-commit
+    node .nubos-pilot/bin/np-tools.cjs commit-task "$TASK_ID"
     COMMIT_STATUS=$?
 
-    EXECUTOR_END=$(node np-tools.cjs metrics end-timestamp)
+    EXECUTOR_END=$(node .nubos-pilot/bin/np-tools.cjs metrics end-timestamp)
     EXECUTOR_STATUS=ok
     [ "$COMMIT_STATUS" -ne 0 ] && EXECUTOR_STATUS=error
-    node np-tools.cjs metrics record \
+    node .nubos-pilot/bin/np-tools.cjs metrics record \
       --agent np-executor --tier sonnet --resolved-model "$EXECUTOR_MODEL" \
       --phase "$PHASE" --plan "$SLICE_FULL_ID" --task "$TASK_ID" \
       --started "$EXECUTOR_START" --ended "$EXECUTOR_END" \
@@ -135,7 +135,7 @@ After every slice completes, point the operator at `/np:validate-phase $PHASE` t
 - Move to next slice **only after** every task in the current slice is committed.
 - Start one checkpoint per task before spawning the executor agent.
 - Spawn `agents/np-executor.md` once per task with only that task's `files_modified` in scope.
-- Route every commit through `node np-tools.cjs commit-task` so `assertCommittablePaths` (D-25) runs.
+- Route every commit through `node .nubos-pilot/bin/np-tools.cjs commit-task` so `assertCommittablePaths` (D-25) runs.
 - Hard-stop the wave when `commit-task` returns a non-zero exit.
 
 **Don't:**

package/workflows/help.md

@@ -10,5 +10,5 @@ List every available `np-tools.cjs` command grouped by category. Pass `--json`
 for programmatic consumption.
 
 ```bash
-node np-tools.cjs help
+node .nubos-pilot/bin/np-tools.cjs help
 ```

package/workflows/new-milestone.md

@@ -52,7 +52,7 @@ The subcommand raises `project-not-initialized` anyway, but the shell check give
 ## Single-Call Init
 
 ```bash
-INIT=$(node np-tools.cjs init new-milestone)
+INIT=$(node .nubos-pilot/bin/np-tools.cjs init new-milestone)
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 
@@ -63,9 +63,9 @@ Payload: three questions — `milestone_name`, `milestone_goal`, `create_req_pre
 Three questions through `np-tools.cjs askuser`. No runtime-native question tool is permitted anywhere in this file.
 
 ```bash
-ANS_MS_NAME=$(node np-tools.cjs askuser --json '{"type":"input","prompt":"Milestone name (e.g. Auth & Basic UI)?"}')
-ANS_MS_GOAL=$(node np-tools.cjs askuser --json '{"type":"input","prompt":"Milestone goal (one sentence)?"}')
-ANS_REQ_PREFIX=$(node np-tools.cjs askuser --json '{"type":"confirm","prompt":"Create a new Requirements section for this milestone?","default":false}')
+ANS_MS_NAME=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{"type":"input","prompt":"Milestone name (e.g. Auth & Basic UI)?"}')
+ANS_MS_GOAL=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{"type":"input","prompt":"Milestone goal (one sentence)?"}')
+ANS_REQ_PREFIX=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{"type":"confirm","prompt":"Create a new Requirements section for this milestone?","default":false}')
 ```
 
 <answer_validation>
@@ -89,7 +89,7 @@ node -e '
   fs.writeFileSync(process.env.ANSWERS, JSON.stringify(payload));
 ' ANS_MS_NAME="$ANS_MS_NAME" ANS_MS_GOAL="$ANS_MS_GOAL" ANS_REQ_PREFIX="$ANS_REQ_PREFIX" ANSWERS="$ANSWERS"
 
-node np-tools.cjs init new-milestone --apply "$ANSWERS"
+node .nubos-pilot/bin/np-tools.cjs init new-milestone --apply "$ANSWERS"
 ```
 
 On success the subcommand emits:
@@ -117,7 +117,7 @@ belongs in a separate workflow that the user invokes explicitly.
 ## Optional Commit
 
 ```bash
-if [ "$(node np-tools.cjs config-get workflow.commit_docs 2>/dev/null)" = "true" ]; then
+if [ "$(node .nubos-pilot/bin/np-tools.cjs config-get workflow.commit_docs 2>/dev/null)" = "true" ]; then
   git add .nubos-pilot/
   git commit -m "chore: np:new-milestone add $ANS_MS_NAME"
 fi

package/workflows/new-project.md

@@ -106,16 +106,16 @@ Use the scan to propose:
 The 5 structural questions. All prompts go through the askuser gateway.
 
 ```bash
-INIT=$(node np-tools.cjs init new-project)
+INIT=$(node .nubos-pilot/bin/np-tools.cjs init new-project)
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 
 ```bash
-ANS_PROJECT_NAME=$(node np-tools.cjs askuser --json '{"type":"input","prompt":"Project name?"}')
-ANS_CORE_VALUE=$(node np-tools.cjs askuser --json '{"type":"input","prompt":"Core value — one sentence that must stay true if everything else fails?"}')
-ANS_CONSTRAINTS=$(node np-tools.cjs askuser --json '{"type":"input","prompt":"Primary constraints (comma-separated)?"}')
-ANS_FIRST_MS=$(node np-tools.cjs askuser --json '{"type":"input","prompt":"First milestone name?"}')
-ANS_FIRST_PHASE=$(node np-tools.cjs askuser --json '{"type":"input","prompt":"First phase name?"}')
+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?"}')
+ANS_CONSTRAINTS=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{"type":"input","prompt":"Primary constraints (comma-separated)?"}')
+ANS_FIRST_MS=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{"type":"input","prompt":"First milestone name?"}')
+ANS_FIRST_PHASE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{"type":"input","prompt":"First phase name?"}')
 ```
 
 When Phase 0 produced a suggestion, include it as the prompt default in
@@ -143,7 +143,7 @@ node -e '
   ANS_CONSTRAINTS="$ANS_CONSTRAINTS" ANS_FIRST_MS="$ANS_FIRST_MS" \
   ANS_FIRST_PHASE="$ANS_FIRST_PHASE"
 
-node np-tools.cjs init new-project --apply "$ANSWERS"
+node .nubos-pilot/bin/np-tools.cjs init new-project --apply "$ANSWERS"
 ```
 
 The six discovery-related PROJECT.md fields (`project_description`,
@@ -155,12 +155,12 @@ The six discovery-related PROJECT.md fields (`project_description`,
 
 ```bash
 set +e
-node np-tools.cjs init new-project --apply "$ANSWERS"
+node .nubos-pilot/bin/np-tools.cjs init new-project --apply "$ANSWERS"
 APPLY_STATUS=$?
 set -e
 
 if [ "$APPLY_STATUS" -ne 0 ]; then
-  CHOICE=$(node np-tools.cjs askuser --json '{
+  CHOICE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{
     "type": "select",
     "prompt": "Project already initialized. Choose:",
     "options": [
@@ -171,7 +171,7 @@ if [ "$APPLY_STATUS" -ne 0 ]; then
   case "$CHOICE" in
     *destructive*|*Delete*)
       rm -rf ./.nubos-pilot
-      node np-tools.cjs init new-project --apply "$ANSWERS"
+      node .nubos-pilot/bin/np-tools.cjs init new-project --apply "$ANSWERS"
       ;;
     *)
       exit 1
@@ -208,7 +208,7 @@ If Phase 0 reported `file_count > 0` with code files (not only manifests
 and docs), offer to run the initial scan now:
 
 ```bash
-RUN_SCAN=$(node np-tools.cjs askuser --json '{
+RUN_SCAN=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "confirm",
   "prompt": "Run initial codebase scan now (np:scan-codebase)?",
   "default": true
@@ -224,7 +224,7 @@ Empty workspaces skip this cleanly.
 ## Optional Commit
 
 ```bash
-if [ "$(node np-tools.cjs config-get workflow.commit_docs 2>/dev/null)" = "true" ]; then
+if [ "$(node .nubos-pilot/bin/np-tools.cjs config-get workflow.commit_docs 2>/dev/null)" = "true" ]; then
   git add .nubos-pilot/
   git commit -m "chore: np:new-project scaffold + discovery"
 fi

package/workflows/note.md

@@ -26,7 +26,7 @@ metrics record. The `workflow-missing-metrics` lint in
 `bin/check-workflows.cjs` only fires on `Task(` / `Spawn agent=` sites,
 so CRUD-only workflows are exempt (Pitfall 9 resolution from
 Plan 10-05). Interactive prompts route through
-`node np-tools.cjs askuser --json` per INST-03.
+`node .nubos-pilot/bin/np-tools.cjs askuser --json` per INST-03.
 
 ## Initialize
 
@@ -68,7 +68,7 @@ fi
 mkdir -p "$NOTES_DIR"
 DATE=$(date +%Y-%m-%d)
 TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-SLUG=$(node np-tools.cjs generate-slug "$TEXT" --raw)
+SLUG=$(node .nubos-pilot/bin/np-tools.cjs generate-slug "$TEXT" --raw)
 if [[ -z "$SLUG" ]]; then
   echo "Error: note text produced no slug-safe characters." >&2
   exit 1
@@ -76,7 +76,7 @@ fi
 NOTE_PATH="${NOTES_DIR}/${DATE}-${SLUG}.md"
 ```
 
-Slug generation is delegated to `node np-tools.cjs generate-slug`
+Slug generation is delegated to `node .nubos-pilot/bin/np-tools.cjs generate-slug`
 (which wraps `lib/layout.cjs.slugify`) — the same filename-safety
 rails used by every capture workflow (only `[a-z0-9-]` enter the
 filename).
@@ -90,7 +90,7 @@ file.
 
 ```bash
 if [[ -f "$NOTE_PATH" ]]; then
-  CHOICE=$(node np-tools.cjs askuser --json '{
+  CHOICE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{
     "type": "select",
     "header": "Duplicate note",
     "question": "A note already exists at '"${NOTE_PATH}"'. What would you like to do?",
@@ -148,7 +148,7 @@ for that distinction.
 
 ```bash
 if [[ "$SCOPE" == "project" ]]; then
-  node np-tools.cjs commit "docs(10): add note — ${SLUG}" --files "$NOTE_PATH"
+  node .nubos-pilot/bin/np-tools.cjs commit "docs(10): add note — ${SLUG}" --files "$NOTE_PATH"
 else
   echo "Global note written to $NOTE_PATH (not committed — lives outside any project)." >&2
 fi
@@ -177,9 +177,9 @@ Note saved ($SCOPE): $NOTE_PATH
 - For global scope, bypass `lib/core.cjs.findProjectRoot` completely
   (Pitfall 10) so the workflow works from any cwd, including non-repo
   directories.
-- Derive the slug via `node np-tools.cjs generate-slug` so only
+- Derive the slug via `node .nubos-pilot/bin/np-tools.cjs generate-slug` so only
   `[a-z0-9-]` enter the filename.
-- Route the project-scope commit through `node np-tools.cjs commit`
+- Route the project-scope commit through `node .nubos-pilot/bin/np-tools.cjs commit`
   for `lib/git.cjs.assertCommittablePaths()` validation.
 
 **Don't:**
@@ -191,7 +191,7 @@ Note saved ($SCOPE): $NOTE_PATH
   (T-10-05-03 defence-in-depth).
 - Invoke host-specific prompt tools directly (the BARE_ASKUSER lint
   in `bin/check-workflows.cjs` blocks them) — always route through
-  `node np-tools.cjs askuser --json '…'`.
+  `node .nubos-pilot/bin/np-tools.cjs askuser --json '…'`.
 - Mutate STATE.md. Notes are lighter-weight than todos; there is no
   pending-note counter. If you need STATE semantics, use
   `/np:add-todo` instead.
@@ -216,7 +216,7 @@ Note saved ($SCOPE): $NOTE_PATH
       path (Pitfall 10 mitigation — bypasses findProjectRoot).
 - [ ] Project-scope directory resolved via
       `lib/core.cjs.projectStateDir`.
-- [ ] Slug produced via `node np-tools.cjs generate-slug` (only
+- [ ] Slug produced via `node .nubos-pilot/bin/np-tools.cjs generate-slug` (only
       `[a-z0-9-]` enter filename).
 - [ ] Duplicate collisions resolved via `askuser` Pattern S-3
       (Re-run / View / Skip / Append-timestamp).

package/workflows/park.md

@@ -21,7 +21,7 @@ if [ -z "$TASK_ID" ]; then
   echo "Usage: /np:park <task-id>" >&2
   exit 1
 fi
-node np-tools.cjs park "$TASK_ID"
+node .nubos-pilot/bin/np-tools.cjs park "$TASK_ID"
 ```
 
 ## Scope Guardrail

package/workflows/pause-work.md

@@ -15,7 +15,7 @@ progress.
 ## Execution
 
 ```bash
-node np-tools.cjs init pause-work
+node .nubos-pilot/bin/np-tools.cjs init pause-work
 ```
 
 Output is a small JSON payload `{ ok, stopped_at, resume_file }`. The

package/workflows/plan-phase.md

@@ -62,7 +62,7 @@ When `--repromote` is set, skip every gate and the verification loop. Read every
 
 ```bash
 if [[ "$REPROMOTE_FLAG" == "1" ]]; then
-  SCAFFOLD_JSON=$(node np-tools.cjs init plan-milestone scaffold-all-tasks "$PHASE")
+  SCAFFOLD_JSON=$(node .nubos-pilot/bin/np-tools.cjs init plan-milestone scaffold-all-tasks "$PHASE")
   if [[ "$SCAFFOLD_JSON" == @file:* ]]; then SCAFFOLD_JSON=$(cat "${SCAFFOLD_JSON#@file:}"); fi
   echo "repromote: $SCAFFOLD_JSON" >&2
   exit 0
@@ -72,10 +72,10 @@ fi
 ### Read milestone state
 
 ```bash
-INIT=$(node np-tools.cjs init plan-milestone init "$PHASE")
+INIT=$(node .nubos-pilot/bin/np-tools.cjs init plan-milestone init "$PHASE")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-AGENT_SKILLS_PLANNER=$(node np-tools.cjs agent-skills planner 2>/dev/null)
-AGENT_SKILLS_CHECKER=$(node np-tools.cjs agent-skills plan-checker 2>/dev/null)
+AGENT_SKILLS_PLANNER=$(node .nubos-pilot/bin/np-tools.cjs agent-skills planner 2>/dev/null)
+AGENT_SKILLS_CHECKER=$(node .nubos-pilot/bin/np-tools.cjs agent-skills plan-checker 2>/dev/null)
 RUNTIME=$(node -e "console.log(require('./lib/runtime/index.cjs').detect().runtime)")
 ```
 
@@ -90,7 +90,7 @@ Parse JSON for: `milestone`, `milestone_id`, `milestone_dir`, `milestone_context
 If `has_context == false`:
 
 ```bash
-CHOICE=$(node np-tools.cjs askuser --json '{
+CHOICE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "select",
   "header": "Missing M'"$PHASE"'-CONTEXT.md",
   "question": "Milestone CONTEXT.md is not present. Continue?",
@@ -124,7 +124,7 @@ fi
 If any slice has a `has_plan == true`:
 
 ```bash
-CHOICE=$(node np-tools.cjs askuser --json '{
+CHOICE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "select",
   "header": "Milestone already planned",
   "question": "One or more slices already have S<NNN>-PLAN.md. Overwrite?",
@@ -137,11 +137,11 @@ CHOICE=$(node np-tools.cjs askuser --json '{
 case "$CHOICE" in
   "Abort") exit 0 ;;
   "Repromote")
-    node np-tools.cjs init plan-milestone scaffold-all-tasks "$PHASE" >&2
+    node .nubos-pilot/bin/np-tools.cjs init plan-milestone scaffold-all-tasks "$PHASE" >&2
     exit 0
     ;;
   "Overwrite")
-    node np-tools.cjs init plan-milestone abort "$PHASE"
+    node .nubos-pilot/bin/np-tools.cjs init plan-milestone abort "$PHASE"
     ;;
 esac
 ```
@@ -179,13 +179,13 @@ for ITER in 1 2; do
   [ "$ITER" = "2" ] && MODE="revise"
 
   # --- Spawn planner ---
-  PLANNER_START=$(node np-tools.cjs metrics start-timestamp)
-  PLANNER_MODEL=$(node np-tools.cjs resolve-model planner --profile frontier)
+  PLANNER_START=$(node .nubos-pilot/bin/np-tools.cjs metrics start-timestamp)
+  PLANNER_MODEL=$(node .nubos-pilot/bin/np-tools.cjs resolve-model planner --profile frontier)
   # Spawn agent=np-planner tier=opus model=$PLANNER_MODEL mode=$MODE milestone=$PHASE
   #   milestone_dir=$milestone_dir goal=$goal requirements=$requirements
   #   prior_findings=$LAST_FINDINGS agent_skills=$AGENT_SKILLS_PLANNER
-  PLANNER_END=$(node np-tools.cjs metrics end-timestamp)
-  node np-tools.cjs metrics record \
+  PLANNER_END=$(node .nubos-pilot/bin/np-tools.cjs metrics end-timestamp)
+  node .nubos-pilot/bin/np-tools.cjs metrics record \
     --agent np-planner --tier opus --resolved-model "$PLANNER_MODEL" \
     --phase "$PHASE" --plan "${milestone_id}-plan" --task "${milestone_id}-planner-run" \
     --started "$PLANNER_START" --ended "$PLANNER_END" \
@@ -193,13 +193,13 @@ for ITER in 1 2; do
     --retry-count 0 --status ok --runtime "$RUNTIME"
 
   # --- Spawn plan-checker ---
-  CHECKER_START=$(node np-tools.cjs metrics start-timestamp)
-  CHECKER_MODEL=$(node np-tools.cjs resolve-model plan-checker --profile frontier)
+  CHECKER_START=$(node .nubos-pilot/bin/np-tools.cjs metrics start-timestamp)
+  CHECKER_MODEL=$(node .nubos-pilot/bin/np-tools.cjs resolve-model plan-checker --profile frontier)
   # Spawn agent=np-plan-checker tier=opus model=$CHECKER_MODEL milestone=$PHASE
   #   milestone_dir=$milestone_dir agent_skills=$AGENT_SKILLS_CHECKER
   # Checker writes YAML verdict; orchestrator converts to JSON.
-  CHECKER_END=$(node np-tools.cjs metrics end-timestamp)
-  node np-tools.cjs metrics record \
+  CHECKER_END=$(node .nubos-pilot/bin/np-tools.cjs metrics end-timestamp)
+  node .nubos-pilot/bin/np-tools.cjs metrics record \
     --agent np-plan-checker --tier opus --resolved-model "$CHECKER_MODEL" \
     --phase "$PHASE" --plan "${milestone_id}-plan" --task "${milestone_id}-planner-run" \
     --started "$CHECKER_START" --ended "$CHECKER_END" \
@@ -220,7 +220,7 @@ for ITER in 1 2; do
   LAST_FINDINGS="$VERDICT_JSON_PATH"
 
   if [ "$ITER" = "2" ]; then
-    CHOICE=$(node np-tools.cjs askuser --json '{
+    CHOICE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{
       "type": "select",
       "header": "Plan-Checker Stall",
       "question": "Plan-Checker hat 2 Iterationen lang Fail gemeldet. Was tun?",
@@ -232,12 +232,12 @@ for ITER in 1 2; do
     }')
     case "$CHOICE" in
       "Abort"*)
-        node np-tools.cjs init plan-milestone abort "$PHASE"
+        node .nubos-pilot/bin/np-tools.cjs init plan-milestone abort "$PHASE"
         exit 1
         ;;
       "Plan mit Warnings"*) break ;;
       "Manuell editieren"*)
-        node np-tools.cjs askuser --json '{"type":"input","question":"Edit slice plans in your editor, then press Enter to re-check."}'
+        node .nubos-pilot/bin/np-tools.cjs askuser --json '{"type":"input","question":"Edit slice plans in your editor, then press Enter to re-check."}'
         break
         ;;
     esac
@@ -250,7 +250,7 @@ done
 After a successful verification (or "commit-with-warnings"), scaffold every `<task>` block into its own directory + files:
 
 ```bash
-SCAFFOLD_JSON=$(node np-tools.cjs init plan-milestone scaffold-all-tasks "$PHASE")
+SCAFFOLD_JSON=$(node .nubos-pilot/bin/np-tools.cjs init plan-milestone scaffold-all-tasks "$PHASE")
 if [[ "$SCAFFOLD_JSON" == @file:* ]]; then SCAFFOLD_JSON=$(cat "${SCAFFOLD_JSON#@file:}"); fi
 echo "scaffold-all-tasks → $SCAFFOLD_JSON" >&2
 ```

package/workflows/research-phase.md

@@ -65,7 +65,7 @@ Before exiting, confirm:
 3. If the user declined the offline-confirm prompt, RESEARCH.md was NOT
    written (D-23) and the abort message surfaced verbatim.
 
-All confirmations route through `node np-tools.cjs askuser --json '{...}'`.
+All confirmations route through `node .nubos-pilot/bin/np-tools.cjs askuser --json '{...}'`.
 Never a bare prompt-tool invocation — Phase-3 D-03 rename rule
 enforced by `bin/check-workflows.cjs` (the guard rejects any line that
 mentions the forbidden Claude-Code prompt-tool identifier outside a
@@ -87,12 +87,12 @@ fi
 ## Step 1: Single-Call Init
 
 All phase context is gathered in one call to
-`node np-tools.cjs init research-phase <N>`. The subcommand returns a JSON
+`node .nubos-pilot/bin/np-tools.cjs init research-phase <N>`. The subcommand returns a JSON
 payload; larger payloads are written to a tmp file and referenced via
 `@file:<path>`.
 
 ```bash
-INIT=$(node np-tools.cjs init research-phase "$PHASE")
+INIT=$(node .nubos-pilot/bin/np-tools.cjs init research-phase "$PHASE")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 RUNTIME=$(node -e "console.log(require('./lib/runtime/index.cjs').detect().runtime)")
 ```
@@ -146,7 +146,7 @@ than silently clobbering the existing file.
 
 ```bash
 if [[ "$HAS_RESEARCH" == "true" ]]; then
-  node np-tools.cjs askuser --json '{
+  node .nubos-pilot/bin/np-tools.cjs askuser --json '{
     "type": "select",
     "prompt": "RESEARCH.md already exists for this phase. How do you want to proceed?",
     "options": ["Overwrite", "Append-update", "Abort"]
@@ -168,7 +168,7 @@ external docs. Route the verbatim D-21 German confirm prompt through
 ```bash
 MODE=online
 if [[ "$WEBFETCH_AVAILABLE" == "false" && "$CONTEXT7_AVAILABLE" == "false" ]]; then
-  CONFIRM=$(node np-tools.cjs askuser --json '{"type":"confirm","question":"Kein Web-/Context7-Zugriff verfügbar — mit lokalen Quellen (Repo + Prior-Phase-CONTEXT.md) fortfahren?"}')
+  CONFIRM=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{"type":"confirm","question":"Kein Web-/Context7-Zugriff verfügbar — mit lokalen Quellen (Repo + Prior-Phase-CONTEXT.md) fortfahren?"}')
   if [[ "$CONFIRM" != "yes" && "$CONFIRM" != "true" ]]; then
     echo "Research aborted. Run \`np:plan-phase $PHASE --skip-research\` to proceed without research."
     exit 0
@@ -196,8 +196,8 @@ pattern). An empty `$RESEARCHER_MODEL` string signals the runtime adapter to
 omit the `model:` parameter at spawn (Phase 8 D-22 inherit-pattern).
 
 ```bash
-RESEARCHER_START=$(node np-tools.cjs metrics start-timestamp)
-RESEARCHER_MODEL=$(node np-tools.cjs resolve-model researcher --profile balanced)
+RESEARCHER_START=$(node .nubos-pilot/bin/np-tools.cjs metrics start-timestamp)
+RESEARCHER_MODEL=$(node .nubos-pilot/bin/np-tools.cjs resolve-model researcher --profile balanced)
 ```
 
 ```text
@@ -211,8 +211,8 @@ usage-capture — Phase 10 will enrich this via runtime-adapter support per
 RESEARCH §A5).
 
 ```bash
-RESEARCHER_END=$(node np-tools.cjs metrics end-timestamp)
-node np-tools.cjs metrics record \
+RESEARCHER_END=$(node .nubos-pilot/bin/np-tools.cjs metrics end-timestamp)
+node .nubos-pilot/bin/np-tools.cjs metrics record \
   --agent np-researcher --tier sonnet --resolved-model "$RESEARCHER_MODEL" \
   --phase "$PHASE" --plan "$PLAN_ID" --task "$TASK_ID" \
   --started "$RESEARCHER_START" --ended "$RESEARCHER_END" \
@@ -264,7 +264,7 @@ Classify the researcher's structured-return block:
   research-skipped (`--skip-research` path in `/np:plan-phase`).
 
 ```bash
-node np-tools.cjs askuser --json '{
+node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "select",
   "prompt": "Research artifact written. What next?",
   "options": ["Plan phase", "Review RESEARCH.md", "Done"]

package/workflows/reset-slice.md

@@ -32,7 +32,7 @@ No argument required. If `STATE.current_task` is null **and** no explicit id was
 ## Apply
 
 ```bash
-RESULT=$(node np-tools.cjs reset-slice ${1:+"$1"})
+RESULT=$(node .nubos-pilot/bin/np-tools.cjs reset-slice ${1:+"$1"})
 echo "$RESULT" | jq .
 ```
 

package/workflows/resume-work.md

@@ -13,7 +13,7 @@ on each accordingly.
 ## Initialize
 
 ```bash
-INIT=$(node np-tools.cjs init resume-work)
+INIT=$(node .nubos-pilot/bin/np-tools.cjs init resume-work)
 STATUS=$(echo "$INIT" | node -e "process.stdin.on('data', d => console.log(JSON.parse(d).status))")
 ```
 
@@ -29,7 +29,7 @@ STATE.current_task matches an in-progress checkpoint. Spawn
 if [ "$STATUS" = "resume" ]; then
   TASK_ID=$(echo "$INIT" | node -e "process.stdin.on('data', d => console.log(JSON.parse(d).task_id))")
   # Hand the task payload + checkpoint to agents/np-executor.md; on completion
-  # the agent invokes `node np-tools.cjs commit-task "$TASK_ID"` as usual.
+  # the agent invokes `node .nubos-pilot/bin/np-tools.cjs commit-task "$TASK_ID"` as usual.
   echo "Resuming task $TASK_ID via agents/np-executor.md …"
 fi
 ```
@@ -40,7 +40,7 @@ Checkpoints exist but none match `STATE.current_task`:
 
 ```bash
 if [ "$STATUS" = "orphan" ]; then
-  CHOICE=$(node np-tools.cjs askuser --json '{
+  CHOICE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{
     "type": "select",
     "header": "Verwaiste Checkpoints",
     "question": "Es existieren Checkpoint-Dateien, aber STATE.current_task passt nicht. Wie vorgehen?",

package/workflows/scan-codebase.md

@@ -60,7 +60,7 @@ end.
 Scan, group, write manifest + stubs, emit module-facts in one call:
 
 ```bash
-PLAN=$(node np-tools.cjs scan-codebase --project-name "$PROJECT_NAME")
+PLAN=$(node .nubos-pilot/bin/np-tools.cjs scan-codebase --project-name "$PROJECT_NAME")
 if [[ "$PLAN" == @file:* ]]; then PLAN=$(cat "${PLAN#@file:}"); fi
 ```
 
@@ -110,7 +110,7 @@ chance to pause with Ctrl-C. Never eat interrupt signals.
 ### Step 3: Apply prose per module
 
 ```bash
-node np-tools.cjs scan-codebase --apply-prose \
+node .nubos-pilot/bin/np-tools.cjs scan-codebase --apply-prose \
   --module "$MODULE_ID" \
   --prose-file "$PROSE_FILE"
 ```

package/workflows/session-report.md

@@ -149,11 +149,11 @@ truncated file.
 ## Commit
 
 Both the new report and the updated pointer land in a single atomic
-docs commit per ADR-0004. Route through `node np-tools.cjs commit`
+docs commit per ADR-0004. Route through `node .nubos-pilot/bin/np-tools.cjs commit`
 so `lib/git.cjs.assertCommittablePaths()` validates the paths.
 
 ```bash
-node np-tools.cjs commit "docs(10): add session report — ${LOCAL_FILENAME_TS}" \
+node .nubos-pilot/bin/np-tools.cjs commit "docs(10): add session report — ${LOCAL_FILENAME_TS}" \
   --files "$REPORT_PATH" "$POINTER"
 ```
 
@@ -191,7 +191,7 @@ Session report: $REPORT_PATH
   between the two would skip a session.
 - Invoke host-specific prompt tools directly (the BARE_ASKUSER lint
   in `bin/check-workflows.cjs` blocks them) — route through
-  `node np-tools.cjs askuser --json '…'`.
+  `node .nubos-pilot/bin/np-tools.cjs askuser --json '…'`.
 - Add a `metrics record` block. No Task/Spawn site; Pitfall 9 /
   `workflow-missing-metrics` is exempt.
 </scope_guardrail>

package/workflows/skip.md

@@ -21,7 +21,7 @@ if [ -z "$TASK_ID" ]; then
   echo "Usage: /np:skip <task-id>" >&2
   exit 1
 fi
-node np-tools.cjs skip "$TASK_ID"
+node .nubos-pilot/bin/np-tools.cjs skip "$TASK_ID"
 ```
 
 ## Scope Guardrail

package/workflows/state.md

@@ -3,5 +3,5 @@
 Print a JSON snapshot of the current STATE.md frontmatter.
 
 ```bash
-node np-tools.cjs state
+node .nubos-pilot/bin/np-tools.cjs state
 ```

package/workflows/stats.md

@@ -1,6 +1,6 @@
 ---
 command: np:stats
-description: Stats output — phases-table (name/plans/completed/status/%) + metrics aggregation (tokens-in/out per phase, avg duration by tier, retry_count_sum, error_rate). Consumes node np-tools.cjs stats json. Null-token runtimes render as `—` (Phase 9 D-09). Read-only — no commits, no STATE mutation.
+description: Stats output — phases-table (name/plans/completed/status/%) + metrics aggregation (tokens-in/out per phase, avg duration by tier, retry_count_sum, error_rate). Consumes node .nubos-pilot/bin/np-tools.cjs stats json. Null-token runtimes render as `—` (Phase 9 D-09). Read-only — no commits, no STATE mutation.
 argument-hint: [json]
 ---
 
@@ -23,7 +23,7 @@ metrics record. Pitfall 9 / `workflow-missing-metrics` is exempt.
 ## Initialize
 
 ```bash
-STATS_JSON=$(node np-tools.cjs stats json)
+STATS_JSON=$(node .nubos-pilot/bin/np-tools.cjs stats json)
 if [[ -z "$STATS_JSON" ]]; then
   echo "No stats available (empty project?)" >&2
   exit 0
@@ -115,7 +115,7 @@ and is rendered by the agent CLI.
 
 <scope_guardrail>
 **Do:**
-- Consume `node np-tools.cjs stats json` — trust its
+- Consume `node .nubos-pilot/bin/np-tools.cjs stats json` — trust its
   `schema_version: 1` output shape (Plan 10-01-T04 contract).
 - Render `tokens_in` / `tokens_out` as `—` when null (Phase 9 D-09
   non-claude runtimes; D-15 hybrid-output decision).
@@ -131,7 +131,7 @@ and is rendered by the agent CLI.
 - Add a git commit — there is nothing to commit.
 - Invoke host-specific prompt tools directly (the BARE_ASKUSER lint
   in `bin/check-workflows.cjs` blocks them) — route through
-  `node np-tools.cjs askuser --json '…'` if prompts are ever added.
+  `node .nubos-pilot/bin/np-tools.cjs askuser --json '…'` if prompts are ever added.
 - Add a `metrics record` block. No Task/Spawn site; Pitfall 9 /
   `workflow-missing-metrics` is exempt.
 </scope_guardrail>
@@ -144,7 +144,7 @@ and is rendered by the agent CLI.
 
 ## Success Criteria
 
-- [ ] Data sourced exclusively from `node np-tools.cjs stats json`
+- [ ] Data sourced exclusively from `node .nubos-pilot/bin/np-tools.cjs stats json`
       (Plan 10-01-T04) — no inline JSONL parsing.
 - [ ] Null `tokens_in` / `tokens_out` render as `—` (D-09 / D-15).
 - [ ] Progress bar is a 20-char block-string (ADR-0002).

package/workflows/thread.md

@@ -30,7 +30,7 @@ if [[ -z "$SLUG_ARG" ]]; then
   echo "Usage: /np:thread <slug-or-title>" >&2
   exit 2
 fi
-SLUG=$(node np-tools.cjs generate-slug "$SLUG_ARG" --raw)
+SLUG=$(node .nubos-pilot/bin/np-tools.cjs generate-slug "$SLUG_ARG" --raw)
 if [[ -z "$SLUG" ]]; then
   echo "Error: argument produced no slug-safe characters." >&2
   exit 1
@@ -90,13 +90,13 @@ last_resumed: <TODAY>
 - *(what the next session should do first)*
 ```
 
-Route the commit through `node np-tools.cjs commit` so
+Route the commit through `node .nubos-pilot/bin/np-tools.cjs commit` so
 `lib/git.cjs.assertCommittablePaths()` validates the path before
 `git add` (path-traversal guard from Plan 10-01-T04).
 
 ```bash
 if [[ "$MODE" == "create" ]]; then
-  node np-tools.cjs commit "docs(10): create thread — ${SLUG}" --files "$THREAD_PATH"
+  node .nubos-pilot/bin/np-tools.cjs commit "docs(10): create thread — ${SLUG}" --files "$THREAD_PATH"
   echo "Thread created: $THREAD_PATH"
   echo ""
   echo "Resume anytime with: /np:thread ${SLUG}"
@@ -167,13 +167,13 @@ Echo `Thread <MODE>d: <THREAD_PATH>` with slug/mode/today to stdout.
   command in this adapted port).
 - Use `lib/core.cjs.atomicWriteFileSync` for any in-place rewrite
   (ADR-0004 crash-safety).
-- Route the create-branch commit through `node np-tools.cjs commit`.
+- Route the create-branch commit through `node .nubos-pilot/bin/np-tools.cjs commit`.
 
 **Don't:**
 - Commit `last_resumed`-only updates. Resume is commit-free.
 - Invoke host-specific prompt tools directly (the BARE_ASKUSER lint
   in `bin/check-workflows.cjs` blocks them) — route through
-  `node np-tools.cjs askuser --json '…'`.
+  `node .nubos-pilot/bin/np-tools.cjs askuser --json '…'`.
 - Bypass `atomicWriteFileSync` — rename pair is the invariant.
 - Add a `metrics record` block. No Task/Spawn site here; Pitfall 9 /
   `workflow-missing-metrics` is exempt.

package/workflows/undo-task.md

@@ -29,7 +29,7 @@ fi
 ## Apply
 
 ```bash
-RESULT=$(node np-tools.cjs undo-task "$TASK_ID")
+RESULT=$(node .nubos-pilot/bin/np-tools.cjs undo-task "$TASK_ID")
 echo "$RESULT" | jq .
 ```
 

package/workflows/undo.md

@@ -37,7 +37,7 @@ fi
 ## Apply
 
 ```bash
-RESULT=$(node np-tools.cjs undo "$PREFIX")
+RESULT=$(node .nubos-pilot/bin/np-tools.cjs undo "$PREFIX")
 echo "$RESULT" | jq .
 ```
 

package/workflows/unpark.md

@@ -21,7 +21,7 @@ if [ -z "$TASK_ID" ]; then
   echo "Usage: /np:unpark <task-id>" >&2
   exit 1
 fi
-node np-tools.cjs unpark "$TASK_ID"
+node .nubos-pilot/bin/np-tools.cjs unpark "$TASK_ID"
 ```
 
 ## Scope Guardrail

package/workflows/update-docs.md

@@ -51,7 +51,7 @@ If `.doc-index.json` is missing, fall back to a full rescan via
 ## Single-Call Init
 
 ```bash
-PLAN=$(node np-tools.cjs update-docs)
+PLAN=$(node .nubos-pilot/bin/np-tools.cjs update-docs)
 if [[ "$PLAN" == @file:* ]]; then PLAN=$(cat "${PLAN#@file:}"); fi
 ```
 
@@ -84,7 +84,7 @@ For each module in `stale_modules ++ added_modules`:
 
 ```bash
 # Build prompt from facts, dispatch agent, capture JSON to $PROSE_FILE
-node np-tools.cjs update-docs --apply-prose \
+node .nubos-pilot/bin/np-tools.cjs update-docs --apply-prose \
   --module "$MODULE_ID" \
   --prose-file "$PROSE_FILE"
 ```

package/workflows/validate-phase.md

@@ -19,7 +19,7 @@ if [[ -z "$PHASE" ]]; then
   exit 2
 fi
 
-INIT=$(node np-tools.cjs init verify-work "$PHASE")
+INIT=$(node .nubos-pilot/bin/np-tools.cjs init verify-work "$PHASE")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 RUNTIME=$(node -e "console.log(require('./lib/runtime/index.cjs').detect().runtime)")
 ```
@@ -60,7 +60,7 @@ If a prior audit is present, let the user choose Re-run / View / Skip. The templ
 ```bash
 RERUN="false"
 if [[ -f "$VALIDATION_PATH" ]]; then
-  CHOICE=$(node np-tools.cjs askuser --json '{
+  CHOICE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{
     "type": "select",
     "header": "Existing VALIDATION.md",
     "question": "VALIDATION.md already exists for milestone '"$MILESTONE_ID"'. What would you like to do?",
@@ -105,8 +105,8 @@ fi
 The auditor reads `REQUIREMENTS.md`, filters to the milestone's declared requirement IDs (from `roadmap.yaml milestones[].requirements`), and scans every task PLAN.md frontmatter `requirements:` field plus every slice's SUMMARY.md for cross-reference coverage. It then inspects test files for each requirement ID.
 
 ```bash
-START=$(node np-tools.cjs metrics start-timestamp)
-MODEL=$(node np-tools.cjs resolve-model np-nyquist-auditor --profile frontier)
+START=$(node .nubos-pilot/bin/np-tools.cjs metrics start-timestamp)
+MODEL=$(node .nubos-pilot/bin/np-tools.cjs resolve-model np-nyquist-auditor --profile frontier)
 
 # Build the read list from the init payload:
 SLICE_PLANS=$(find "$MILESTONE_DIR/slices" -maxdepth 2 -name 'S*-PLAN.md' 2>/dev/null)
@@ -120,8 +120,8 @@ TASK_SUMMARIES=$(find "$MILESTONE_DIR/slices" -path '*/tasks/*/T*-SUMMARY.md' 2>
 #   output: $VALIDATION_PATH with per-requirement Nyquist scoring
 #           (COVERED / UNDER_SAMPLED / UNCOVERED), using templates/VALIDATION.md as skeleton.
 
-END=$(node np-tools.cjs metrics end-timestamp)
-node np-tools.cjs metrics record \
+END=$(node .nubos-pilot/bin/np-tools.cjs metrics end-timestamp)
+node .nubos-pilot/bin/np-tools.cjs metrics record \
   --agent np-nyquist-auditor --tier haiku --resolved-model "$MODEL" \
   --phase "$PHASE" --plan "$PLAN_ID" --task "$TASK_ID" \
   --started "$START" --ended "$END" \
@@ -133,7 +133,7 @@ node np-tools.cjs metrics record \
 
 ```bash
 if [[ ! -f "$VALIDATION_PATH" ]]; then
-  CHOICE=$(node np-tools.cjs askuser --json '{
+  CHOICE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{
     "type": "select",
     "header": "VALIDATION.md missing",
     "question": "np-nyquist-auditor did not write VALIDATION.md. What would you like to do?",
@@ -149,7 +149,7 @@ fi
 ## Commit
 
 ```bash
-node np-tools.cjs commit "docs(${MILESTONE_ID}): add validation audit report" --files "$VALIDATION_PATH"
+node .nubos-pilot/bin/np-tools.cjs commit "docs(${MILESTONE_ID}): add validation audit report" --files "$VALIDATION_PATH"
 ```
 
 One atomic docs commit per ADR-0004. The commit helper routes through `lib/git.cjs.assertCommittablePaths` (gitignore-guard) before staging.

package/workflows/verify-work.md

@@ -16,9 +16,9 @@ Slice-level acceptance (UAT) is validated separately by `/np:validate-phase <N>`
 
 ```bash
 PHASE="$1"
-INIT=$(node np-tools.cjs init verify-work "$PHASE")
+INIT=$(node .nubos-pilot/bin/np-tools.cjs init verify-work "$PHASE")
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-AGENT_SKILLS_VERIFIER=$(node np-tools.cjs agent-skills verifier 2>/dev/null)
+AGENT_SKILLS_VERIFIER=$(node .nubos-pilot/bin/np-tools.cjs agent-skills verifier 2>/dev/null)
 ```
 
 Parse: `milestone`, `milestone_id`, `milestone_dir`, `milestone_name`, `success_criteria`, `draft_results`, `verification_path`, `slice_uat`, `verifier_tier`, `agent_skills`.
@@ -35,7 +35,7 @@ The agent emits a structured verdict per SC: Pass | Fail | Needs-User-Confirm |
 Persist the deterministic draft:
 
 ```bash
-node np-tools.cjs init verify-work emit-draft "$PHASE"
+node .nubos-pilot/bin/np-tools.cjs init verify-work emit-draft "$PHASE"
 ```
 
 ## Pass 2 — user-driven gate for needs_user_confirm
@@ -44,7 +44,7 @@ For each result flagged `needs_user_confirm` by Pass 1, ask the user:
 
 ```bash
 # Example — iterated by the workflow over each needs_user_confirm SC.
-CHOICE=$(node np-tools.cjs askuser --json '{
+CHOICE=$(node .nubos-pilot/bin/np-tools.cjs askuser --json '{
   "type": "select",
   "header": "SC-3: UX feels responsive",
   "question": "Ist dieses Kriterium erfüllt?",
@@ -55,7 +55,7 @@ CHOICE=$(node np-tools.cjs askuser --json '{
     {"label": "Re-investigate", "description": "Brauche mehr Evidence — spawn Verifier nochmal."}
   ]
 }')
-node np-tools.cjs init verify-work record-sc "$PHASE" "SC-3" "$CHOICE"
+node .nubos-pilot/bin/np-tools.cjs init verify-work record-sc "$PHASE" "SC-3" "$CHOICE"
 ```
 
 ## Hard-stop on Fail