@nurix/etna 0.17.0 → 0.17.1

package/bin/etna.js

@@ -1,11 +1,14 @@
 #!/usr/bin/env node
 // packages/cli/bin/etna.js
-// `npx @nurix/etna <harness-name>` — copy a Nurix harness into the current
-// directory. Drops the harness's CLAUDE.md at the project root and copies its
-// skills, agents, rules, and scripts into <project>/.claude/. No marketplace,
-// no plugin enablement — files live in the project, version-controlled and
-// editable per project. Re-run `etna` to refresh. Harnesses are addressed by
-// their harness/<folder> name; several harnesses may share one plugin.
+// `npx @nurix/etna [harness-name]` — copy a Nurix harness into the current
+// directory. Given a name it installs straight away; with no name (in a TTY) it
+// prompts you to pick one. Drops the harness's CLAUDE.md + project-root config
+// files (.prettierrc.json, .vscode/settings.json, …) at the project root, and
+// copies its skills, agents, rules, scripts, and hooks into <project>/.claude/.
+// No marketplace, no plugin enablement — files live in the project,
+// version-controlled and editable per project. Re-run `etna` to refresh.
+// Harnesses are addressed by their harness/<folder> name; several harnesses may
+// share one plugin.
 
 import {
     existsSync,
@@ -20,6 +23,7 @@ import {
 } from 'node:fs';
 import { join, dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import * as p from '@clack/prompts';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkgRoot = resolve(__dirname, '..');
@@ -31,29 +35,37 @@ const dataDir = join(pkgRoot, 'data');
 // the settings merge reads it from the bundle, not the project copy).
 const PLUGIN_SUBDIRS = ['skills', 'agents', 'rules', 'scripts', 'hooks'];
 
-function usage() {
-    const idx = loadHarnessIndex();
-    console.log(`\nUsage: npx @nurix/etna <harness-name>\n`);
-    const entries = Object.entries(idx.harnesses || {});
-    if (entries.length) {
-        console.log(`Available harnesses:`);
-        for (const [folder, plugin] of entries) {
-            console.log(`  ${folder}${plugin && plugin !== folder ? ` (plugin: ${plugin})` : ''}`);
-        }
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+// True when both stdin and stdout are a terminal — clack prompts can't resolve
+// otherwise (CI, piped stdin), so the no-arg pick must fall back to an error.
+function isInteractive() {
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+
+// Boxed list of installable harnesses, for --help and the non-interactive no-arg path.
+function printHarnessList(harnesses) {
+    const entries = Object.entries(harnesses);
+    if (!entries.length) {
+        p.log.warn('No harnesses are bundled. Run `npm run build:data` from the package root.');
+        return;
     }
-    console.log();
+    const lines = entries.map(
+        ([folder, plugin]) => `${folder}${plugin && plugin !== folder ? `  (plugin: ${plugin})` : ''}`,
+    );
+    p.note(lines.join('\n'), 'Available harnesses');
 }
 
 function loadHarnessIndex() {
     const path = join(dataDir, 'harness-index.json');
     if (!existsSync(path)) {
-        die(`harness-index.json missing — run \`npm run build:data\` from the package root.`);
+        die('harness-index.json missing — run `npm run build:data` from the package root.');
     }
     return JSON.parse(readFileSync(path, 'utf8'));
 }
 
 function die(msg, code = 1) {
-    console.error(`error: ${msg}`);
+    p.log.error(msg);
     process.exit(code);
 }
 
@@ -204,22 +216,47 @@ function mergeHooks(targetDir, bundledHooksJson) {
     return added;
 }
 
-async function main(args) {
-    if (args.includes('-h') || args.includes('--help') || args.length === 0) {
-        usage();
-        process.exit(args.length === 0 ? 1 : 0);
+// Resolve the harness to install: the positional arg, or — in a TTY — an interactive
+// pick. Returns the chosen folder name, or null if the user cancels / can't be prompted.
+async function resolveHarnessName(positional, harnesses) {
+    const names = Object.keys(harnesses);
+    if (positional) {
+        if (!harnesses[positional]) {
+            p.log.error(`Unknown harness '${positional}'.`);
+            printHarnessList(harnesses);
+            p.outro('Pick one of the harnesses above.');
+            process.exit(1);
+        }
+        return positional;
     }
-
-    const harnessName = args[0];
-    const idx = loadHarnessIndex();
-    const harnesses = idx.harnesses || {};
-    if (!harnesses[harnessName]) {
-        die(
-            `Unknown harness '${harnessName}'. Available: ${Object.keys(harnesses).join(', ') || '(none)'}`,
-        );
+    if (!isInteractive()) {
+        p.log.error('No harness specified, and not running in an interactive terminal.');
+        printHarnessList(harnesses);
+        p.outro('Re-run as `npx @nurix/etna <harness-name>`.');
+        process.exit(1);
     }
-    const harnessFolder = harnessName;
+    const choice = await p.select({
+        message: 'Which harness do you want to install here?',
+        options: names.map((folder) => {
+            const plugin = harnesses[folder];
+            return {
+                value: folder,
+                label: folder,
+                hint: plugin && plugin !== folder ? `plugin: ${plugin}` : undefined,
+            };
+        }),
+    });
+    if (p.isCancel(choice)) {
+        p.cancel('Cancelled — nothing installed.');
+        return null;
+    }
+    return choice;
+}
 
+// Copy one harness's bundled payload into the current directory. All file ops run
+// inside a spinner; the per-item detail + any warnings are emitted after it stops.
+async function installHarness(harnessName, harnesses) {
+    const harnessFolder = harnessName;
     const bundledHarnessDir = join(dataDir, 'harnesses', harnessFolder);
     const bundledClaudeMd = join(bundledHarnessDir, 'CLAUDE.md');
     if (!existsSync(bundledClaudeMd)) {
@@ -229,8 +266,8 @@ async function main(args) {
     const targetDir = process.cwd();
     const claudeMdDest = join(targetDir, 'CLAUDE.md');
 
-    // Read the bundled epoch marker up front so the install banner can name the
-    // harness version; the file itself is copied into the project further down.
+    // Bundled epoch marker — names the version for the banner and carries the
+    // `files` list (project-root config shipped outside the plugin route).
     const bundledHarnessJson = join(bundledHarnessDir, 'harness.json');
     const harnessMeta = existsSync(bundledHarnessJson) ? readJson(bundledHarnessJson) : {};
     const versionTag = harnessMeta.version ? ` v${harnessMeta.version}` : '';
@@ -238,31 +275,35 @@ async function main(args) {
     // harnesses may share it. Used only for legacy marketplace-entry cleanup.
     const pluginName = harnessMeta.name || harnesses[harnessName] || harnessName;
 
-    console.log(`\nInstalling ${harnessName}${versionTag} into ${targetDir}`);
+    const spin = p.spinner();
+    spin.start(`Installing ${harnessName}${versionTag} into ${targetDir}`);
 
-    const claudeBackup = backupIfExists(claudeMdDest);
-    if (claudeBackup) console.log(`  backed up existing CLAUDE.md → ${claudeBackup}`);
-
-    // CLAUDE.md ships frontmatter-free (the harness's metadata lives in its index.md and the
-    // plugin's definition.md), so it installs as a verbatim copy — no stripping.
-    // Tracks the categories actually present in this harness, for the closing
-    // summary — so a harness that ships no skills or hooks reads as an explicit,
-    // honest list rather than a silently missing line.
     const installed = [];
-
+    const notices = [];
+    const warnings = [];
+
+    // CLAUDE.md ships frontmatter-free, so it installs as a verbatim copy — no stripping.
+    // It's harness-owned and overwritten in place. If the project is a git repo the old copy
+    // is recoverable from history, so we skip the backup; if it isn't, there's no safety net,
+    // so we back it up and tell the user. (Backup applies to CLAUDE.md only.)
+    const claudeExisted = existsSync(claudeMdDest) || isSymlink(claudeMdDest);
+    const projectHasGit = existsSync(join(targetDir, '.git'));
+    if (claudeExisted) {
+        if (projectHasGit) {
+            notices.push('Overwrote existing CLAUDE.md (tracked by git — `git checkout CLAUDE.md` to restore).');
+        } else {
+            const claudeBackup = backupIfExists(claudeMdDest);
+            warnings.push(
+                `No .git here, so no version-control safety net — backed up existing CLAUDE.md → ${claudeBackup}`,
+            );
+        }
+    }
     cpSync(bundledClaudeMd, claudeMdDest, { force: true });
-    console.log(`  installed CLAUDE.md → ${claudeMdDest}`);
-    installed.push('CLAUDE.md');
+    installed.push('CLAUDE.md → ./');
 
     for (const sub of PLUGIN_SUBDIRS) {
-        const count = copyHarnessSubdir(
-            join(bundledHarnessDir, sub),
-            join(targetDir, '.claude', sub),
-        );
-        if (count > 0) {
-            console.log(`  copied ${count} ${sub} → ${targetDir}/.claude/${sub}/`);
-            installed.push(`${count} ${sub}`);
-        }
+        const count = copyHarnessSubdir(join(bundledHarnessDir, sub), join(targetDir, '.claude', sub));
+        if (count > 0) installed.push(`${count} ${sub} → .claude/${sub}/`);
     }
 
     // Copy the epoch marker so harness-manager can resolve the installed epoch.
@@ -270,33 +311,73 @@ async function main(args) {
         const harnessJsonDest = join(targetDir, '.claude', 'harness.json');
         mkdirSync(dirname(harnessJsonDest), { recursive: true });
         cpSync(bundledHarnessJson, harnessJsonDest, { force: true });
-        const tag = [harnessMeta.version && `v${harnessMeta.version}`, harnessMeta.epoch && `epoch ${harnessMeta.epoch}`]
-            .filter(Boolean)
-            .join(', ');
-        console.log(`  installed harness.json → ${harnessJsonDest}${tag ? ` (${tag})` : ''}`);
+    }
+
+    // Verbatim project-root files bundled outside the plugin route (.prettierrc.json,
+    // .vscode/settings.json, …), listed in harness.json's `files`. They land at the project
+    // root at their relative path — NOT under .claude/ — and overwrite unconditionally with no
+    // backup: the harness owns this config, and re-running etna refreshes it.
+    for (const rel of harnessMeta.files || []) {
+        const src = join(bundledHarnessDir, rel);
+        if (!existsSync(src)) continue;
+        const dest = join(targetDir, rel);
+        mkdirSync(dirname(dest), { recursive: true });
+        cpSync(src, dest, { recursive: true, force: true });
+        installed.push(`${rel} → ./${rel}`);
     }
 
     // Retire hooks earlier epochs shipped before merging, so the additive merge
     // never resurrects an entry pointing at a script this bundle no longer carries.
-    const retiredHooks = retireOldHooks(targetDir);
-    for (const r of retiredHooks) console.log(`  removed ${r}`);
+    for (const r of retireOldHooks(targetDir)) notices.push(`removed ${r}`);
 
     // Merge the bundle's hooks.json into the project's settings.json (idempotent).
     const added = mergeHooks(targetDir, join(bundledHarnessDir, 'hooks', 'hooks.json'));
-    if (added > 0) {
-        console.log(`  merged ${added} hook(s) → ${targetDir}/.claude/settings.json`);
+    if (added > 0) installed.push(`${added} hook(s) → .claude/settings.json`);
+
+    for (const entry of migrateFromPluginInstall(targetDir, pluginName)) {
+        notices.push(`removed stale ${entry}`);
     }
 
-    const migrated = migrateFromPluginInstall(targetDir, pluginName);
-    for (const entry of migrated) console.log(`  removed stale ${entry}`);
+    spin.stop(`Installed ${harnessName}${versionTag}`);
+
+    p.note(installed.join('\n'), 'Written');
+    for (const notice of notices) p.log.info(notice);
+    for (const warning of warnings) p.log.warn(warning);
 
-    console.log(`\nDone — ${harnessName}${versionTag} installed: ${installed.join(', ')}.`);
-    console.log(
-        `Open Claude Code in ${targetDir}. Re-run \`npx @nurix/etna ${harnessName}\` anytime to refresh harness content.\n`,
+    p.outro(
+        `${harnessName}${versionTag} ready in ${targetDir}. ` +
+            `Re-run \`npx @nurix/etna ${harnessName}\` anytime to refresh harness content.`,
     );
 }
 
+async function main(args) {
+    const idx = loadHarnessIndex();
+    const harnesses = idx.harnesses || {};
+
+    if (args.includes('-h') || args.includes('--help')) {
+        p.intro('@nurix/etna — Nurix harness installer');
+        p.log.message('Usage: npx @nurix/etna [harness-name]');
+        printHarnessList(harnesses);
+        p.outro('Run with a name to install, or with no name to pick interactively.');
+        return;
+    }
+
+    const positional = args.find((a) => !a.startsWith('-'));
+
+    p.intro('@nurix/etna — Nurix harness installer');
+
+    const boot = p.spinner();
+    boot.start('Starting up');
+    await sleep(2000);
+    boot.stop('Ready');
+
+    const harnessName = await resolveHarnessName(positional, harnesses);
+    if (!harnessName) return; // user cancelled the interactive pick
+
+    await installHarness(harnessName, harnesses);
+}
+
 main(process.argv.slice(2)).catch((e) => {
-    console.error(e?.stack || e);
+    p.log.error(e?.stack || String(e));
     process.exit(1);
 });

package/data/harness-index.json

@@ -1,5 +1,5 @@
 {
-    "fingerprint": "b51d4ebd2a1e",
+    "fingerprint": "50dc8734b7ee",
     "harnesses": {
         "code": "code-fable",
         "code-fable": "code-fable",

package/data/harnesses/code/.prettierignore

@@ -0,0 +1,12 @@
+# Dependencies & build output
+node_modules
+dist
+build
+
+# Lockfiles
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+
+# Harness-managed agent/skill definitions (installed under .claude/)
+.claude

package/data/harnesses/code/.prettierrc.json

@@ -0,0 +1,3 @@
+{
+  "proseWrap": "never"
+}

package/data/harnesses/code/.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+  // Markdown: Prettier unwraps prose to one logical line per paragraph
+  // (see .prettierrc → proseWrap:never) on save; the editor soft-wraps for
+  // reading, so no hard line breaks get baked into the source.
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": true,
+    "editor.wordWrap": "on"
+  }
+}

package/data/harnesses/code/harness.json

@@ -3,5 +3,10 @@
   "name": "code-fable",
   "version": "0.17.0",
   "epoch": 14,
-  "digest": "adc67e13b079"
+  "files": [
+    ".prettierrc.json",
+    ".prettierignore",
+    ".vscode/settings.json"
+  ],
+  "digest": "da02e3f9ca11"
 }

package/data/harnesses/code-fable/.prettierignore

@@ -0,0 +1,12 @@
+# Dependencies & build output
+node_modules
+dist
+build
+
+# Lockfiles
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+
+# Harness-managed agent/skill definitions (installed under .claude/)
+.claude

package/data/harnesses/code-fable/.prettierrc.json

@@ -0,0 +1,3 @@
+{
+  "proseWrap": "never"
+}

package/data/harnesses/code-fable/.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+  // Markdown: Prettier unwraps prose to one logical line per paragraph
+  // (see .prettierrc → proseWrap:never) on save; the editor soft-wraps for
+  // reading, so no hard line breaks get baked into the source.
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": true,
+    "editor.wordWrap": "on"
+  }
+}

package/data/harnesses/code-fable/harness.json

@@ -3,5 +3,10 @@
   "name": "code-fable",
   "version": "0.17.0",
   "epoch": 14,
-  "digest": "6e3420a69727"
+  "files": [
+    ".prettierrc.json",
+    ".prettierignore",
+    ".vscode/settings.json"
+  ],
+  "digest": "c62c79b3aff1"
 }

package/data/harnesses/discover/.prettierignore

@@ -0,0 +1,12 @@
+# Dependencies & build output
+node_modules
+dist
+build
+
+# Lockfiles
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+
+# Harness-managed agent/skill definitions (installed under .claude/)
+.claude

package/data/harnesses/discover/.prettierrc.json

@@ -0,0 +1,3 @@
+{
+  "proseWrap": "never"
+}

package/data/harnesses/discover/.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+  // Markdown: Prettier unwraps prose to one logical line per paragraph
+  // (see .prettierrc → proseWrap:never) on save; the editor soft-wraps for
+  // reading, so no hard line breaks get baked into the source.
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": true,
+    "editor.wordWrap": "on"
+  }
+}

package/data/harnesses/discover/harness.json

@@ -3,5 +3,10 @@
   "name": "discover",
   "version": "0.1.7",
   "epoch": null,
-  "digest": "459be63d0534"
+  "files": [
+    ".prettierrc.json",
+    ".prettierignore",
+    ".vscode/settings.json"
+  ],
+  "digest": "bd18173c697a"
 }

package/data/harnesses/hr/.prettierignore

@@ -0,0 +1,12 @@
+# Dependencies & build output
+node_modules
+dist
+build
+
+# Lockfiles
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+
+# Harness-managed agent/skill definitions (installed under .claude/)
+.claude

package/data/harnesses/hr/.prettierrc.json

@@ -0,0 +1,3 @@
+{
+  "proseWrap": "never"
+}

package/data/harnesses/hr/.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+  // Markdown: Prettier unwraps prose to one logical line per paragraph
+  // (see .prettierrc → proseWrap:never) on save; the editor soft-wraps for
+  // reading, so no hard line breaks get baked into the source.
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": true,
+    "editor.wordWrap": "on"
+  }
+}

package/data/harnesses/hr/harness.json

@@ -3,5 +3,10 @@
   "name": "hr",
   "version": "0.1.1",
   "epoch": null,
-  "digest": "dfc7c529bbec"
+  "files": [
+    ".prettierrc.json",
+    ".prettierignore",
+    ".vscode/settings.json"
+  ],
+  "digest": "95bc2ce3024d"
 }

package/data/harnesses/kb-agi/.prettierignore

@@ -0,0 +1,12 @@
+# Dependencies & build output
+node_modules
+dist
+build
+
+# Lockfiles
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+
+# Harness-managed agent/skill definitions (installed under .claude/)
+.claude

package/data/harnesses/kb-agi/.prettierrc.json

@@ -0,0 +1,3 @@
+{
+  "proseWrap": "never"
+}

package/data/harnesses/kb-agi/.vscode/settings.json

@@ -0,0 +1,10 @@
+{
+  // Markdown: Prettier unwraps prose to one logical line per paragraph
+  // (see .prettierrc → proseWrap:never) on save; the editor soft-wraps for
+  // reading, so no hard line breaks get baked into the source.
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode",
+    "editor.formatOnSave": true,
+    "editor.wordWrap": "on"
+  }
+}

package/data/harnesses/kb-agi/harness.json

@@ -3,5 +3,10 @@
   "name": "kb-agi",
   "version": "0.10.1",
   "epoch": null,
-  "digest": "856a9f4e297a"
+  "files": [
+    ".prettierrc.json",
+    ".prettierignore",
+    ".vscode/settings.json"
+  ],
+  "digest": "25e1cb993a7f"
 }

package/package.json

@@ -1,11 +1,14 @@
 {
     "name": "@nurix/etna",
-    "version": "0.17.0",
+    "version": "0.17.1",
     "description": "Bootstrap a project with a Nurix harness — copies the harness's CLAUDE.md, skills, agents, rules, and hooks directly into the project from a bundled payload (no marketplace fetch, no network).",
     "type": "module",
     "bin": {
         "etna": "bin/etna.js"
     },
+    "dependencies": {
+        "@clack/prompts": "^0.11.0"
+    },
     "files": [
         "bin/",
         "data/",