@nurix/etna 0.20.26 → 0.20.28

package/lib/install/plan.mjs

@@ -21,11 +21,13 @@
 //           project's living copy, never refreshed and never pruned.
 //   merge — folded into whatever the project already has, key by key. Only `.claude/settings.json`,
 //           which carries the user's own hooks and permissions beside the harness's.
+//   mount — the gitignored harness (`isMountedPath`), written here and at session start by `mount.mjs`.
 
 import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
 import { join, relative, sep } from 'node:path';
 import { buildCodexAdapter } from '../codex/agents-md.mjs';
 import { toCodexCommand } from '../codex/hooks.mjs';
+import { isMountedPath, hasWorkerConfig, DEFAULT_ORIGIN } from './mount.mjs';
 
 // Subfolders bundled inside each harness payload that map 1:1 onto <project>/.claude/<name>/.
 // Order matches Claude Code's own folder layout. hooks/ carries the hook scripts + lib/ (and
@@ -166,30 +168,7 @@ function codexHooks(bundleDir) {
 const CAPABILITY_RULES = { 'cloudflare.md': targetHasWorkerConfig };
 
 function targetHasWorkerConfig(targetDir) {
-  const names = ['wrangler.jsonc', 'wrangler.toml'];
-  if (names.some((n) => existsSync(join(targetDir, n)))) return true;
-  let entries = [];
-  try {
-    entries = readdirSync(targetDir, { withFileTypes: true });
-  } catch {
-    return false;
-  }
-  for (const e of entries) {
-    if (!e.isDirectory() || e.name === 'node_modules' || e.name.startsWith('.')) continue;
-    if (names.some((n) => existsSync(join(targetDir, e.name, n)))) return true;
-    // one more level: packages/*/wrangler.jsonc — the common monorepo shape
-    let sub = [];
-    try {
-      sub = readdirSync(join(targetDir, e.name), { withFileTypes: true });
-    } catch {
-      continue;
-    }
-    for (const s of sub) {
-      if (!s.isDirectory() || s.name === 'node_modules' || s.name.startsWith('.')) continue;
-      if (names.some((n) => existsSync(join(targetDir, e.name, s.name, n)))) return true;
-    }
-  }
-  return false;
+  return hasWorkerConfig(targetDir);
 }
 
 // A rule the target's capabilities exclude. No targetDir (payload verification, byte-identity
@@ -209,19 +188,32 @@ function ruleExcluded(sub, rel, targetDir) {
 //
 // Read from the target, never from the bundle. An absent or unreadable marker returns nothing and
 // the manifest default stands.
+// `mount.origin` and `mount.track` are consumer-owned the same way.
 function consumerOwnedMarkerKeys(targetDir) {
   if (!targetDir) return {};
   try {
     const prior = JSON.parse(readFileSync(join(targetDir, '.claude', 'harness.json'), 'utf8'));
-    return typeof prior.docsRoot === 'string' && prior.docsRoot.trim()
-      ? { docsRoot: prior.docsRoot.trim() }
-      : {};
+    const keys = {};
+    if (typeof prior.docsRoot === 'string' && prior.docsRoot.trim()) keys.docsRoot = prior.docsRoot.trim();
+    const mount = prior.mount && typeof prior.mount === 'object' ? prior.mount : {};
+    if (typeof mount.origin === 'string' && mount.origin.trim()) keys.origin = mount.origin.trim();
+    if (mount.track === 'latest' || mount.track === 'pinned') keys.track = mount.track;
+    return keys;
   } catch (e) {
     return {};
   }
 }
 
-export function planHarnessFiles(bundleDir, targetDir = null) {
+// The marker's `mount` block: the CLI's flags, else the consumer's value, else the bundle's, else the defaults.
+function markerMount(meta, prior, override = {}) {
+  const bundled = meta.mount && typeof meta.mount === 'object' ? meta.mount : {};
+  return {
+    origin: override.origin || prior.origin || bundled.origin || DEFAULT_ORIGIN,
+    track: override.track || prior.track || bundled.track || 'latest',
+  };
+}
+
+export function planHarnessFiles(bundleDir, targetDir = null, options = {}) {
   const claudeMdPath = join(bundleDir, 'CLAUDE.md');
   if (!existsSync(claudeMdPath)) {
     throw new Error(`Bundled CLAUDE.md missing at ${claudeMdPath}. Rebuild package data.`);
@@ -300,9 +292,11 @@ export function planHarnessFiles(bundleDir, targetDir = null) {
   const markerPath = join(bundleDir, 'harness.json');
   const meta = existsSync(markerPath) ? JSON.parse(readFileSync(markerPath, 'utf8')) : {};
   if (existsSync(markerPath)) {
+    const { origin, track, ...prior } = consumerOwnedMarkerKeys(targetDir);
+    const mount = markerMount(meta, { origin, track }, options.mount);
     files.push({
       path: '.claude/harness.json',
-      content: asJson({ ...meta, ...consumerOwnedMarkerKeys(targetDir), owned }),
+      content: asJson({ ...meta, ...prior, mount, owned }),
       policy: 'own',
     });
   }
@@ -318,6 +312,7 @@ export function planHarnessFiles(bundleDir, targetDir = null) {
   // Sorted so the plan is byte-stable across machines — readdir order is not guaranteed, and an
   // unstable order would make two identical builds look different to anything comparing them.
   files.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+  for (const file of files) if (file.policy === 'own' && isMountedPath(file.path)) file.policy = 'mount';
 
   const seen = new Set();
   for (const file of files) {

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@nurix/etna",
-  "version": "0.20.26",
-  "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).",
+  "version": "0.20.28",
+  "description": "Bootstrap a project with a Nurix harness — writes the committed contract (CLAUDE.md, AGENTS.md, .claude/harness.json, settings.json, the mount hook) and mounts the harness itself, gitignored, from a bundled payload; sessions keep it current from the CDN.",
   "type": "module",
   "bin": {
     "etna": "bin/etna.js"
   },
+  "exports": {
+    "./mount": "./lib/install/mount.mjs"
+  },
   "dependencies": {
     "@clack/prompts": "^0.11.0"
   },
@@ -43,5 +46,5 @@
     "agent",
     "plugin"
   ],
-  "etnaFingerprint": "9db89d92a35b"
+  "etnaFingerprint": "47047f5258d8"
 }