@nurix/etna 0.19.83 → 0.19.84

package/lib/codex/skills.mjs

@@ -8,13 +8,16 @@
 import { existsSync, cpSync, rmSync } from 'node:fs';
 import { join } from 'node:path';
 
-export function projectSkills({ targetDir, projectHasGit }) {
+// `snapshot: false` skips the no-git safety copy. The harness installer passes it because it has
+// already cleared .agents/skills and rewritten it from the bundle, so the directory holds only
+// bytes that install just produced — snapshotting those protects nothing and leaves .bak litter.
+export function projectSkills({ targetDir, projectHasGit, snapshot = true }) {
     const src = join(targetDir, '.claude', 'skills');
     if (!existsSync(src)) return null;
     const dest = join(targetDir, '.agents', 'skills');
     let warning = null;
     if (existsSync(dest)) {
-        if (!projectHasGit) {
+        if (!projectHasGit && snapshot) {
             const ts = new Date().toISOString().replace(/[:.]/g, '-');
             cpSync(dest, `${dest}.bak.${ts}`, { recursive: true });
             warning = 'No .git here — snapshotted existing .agents/skills/ before rebuild.';

package/lib/install/materialize.mjs

@@ -30,6 +30,7 @@ import {
 } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { planHarnessFiles, PRUNABLE_SUBDIRS, CODEX_REBUILT_DIRS } from './plan.mjs';
+import { projectSkills } from '../codex/skills.mjs';
 
 // Hook scripts shipped by earlier harness versions (the legacy memory-ledger tier) and since retired.
 // mergeHooks is additive, so an upgrade must explicitly remove both the stale settings.json
@@ -153,6 +154,27 @@ function retireOldHooks(targetDir, bundledHarnessDir) {
   return removed;
 }
 
+// Artifacts a prior install leaves behind, in the order they are cheapest to trust. `.claude/` is
+// deliberately NOT the only one: a repo that gitignores it never commits `harness.json`, so a fresh
+// CI checkout of an already-harnessed repo carries no marker there and would read as first contact
+// on EVERY roll — which seeds pristine scaffolds over the project's real docs, backs the originals
+// up as .bkp, and does it again next time, since the gitignore is what stops the marker persisting.
+// The Codex artifacts and AGENTS.md are written by the same install and are conventionally tracked,
+// so any one of them present is proof this repo has been harnessed before.
+const PRIOR_INSTALL_MARKERS = [
+  join('.claude', 'harness.json'),
+  join('.codex', 'hooks.json'),
+  join('.agents', 'skills'),
+  'AGENTS.md',
+];
+
+// First contact means "this repo has never been harnessed", which is what licenses the installer to
+// move a colliding file aside as .bkp and write the pristine seed over it. Getting it wrong in the
+// permissive direction is destructive, so any evidence of a prior install settles it.
+function isFirstContact(targetDir) {
+  return !PRIOR_INSTALL_MARKERS.some((rel) => existsSync(join(targetDir, rel)));
+}
+
 // Read the `owned` manifest the PREVIOUS install recorded in the project's harness.json.
 // Absent (first install, or pre-pruning version) ⇒ {} ⇒ nothing is pruned this round.
 function readInstalledOwned(targetDir) {
@@ -310,7 +332,7 @@ export function materializeHarness({ bundledHarnessDir, targetDir, pluginName, p
   // to the human). Git is not the distinction: history protects bytes, but the .bkp file is what
   // makes the fold duty visible to the next session. The harness is deliberately unapologetic
   // about its own process; the backup is how it stays honest about yours.
-  const firstContact = !existsSync(join(targetDir, '.claude', 'harness.json'));
+  const firstContact = isFirstContact(targetDir);
   void projectHasGit; // kept for caller compatibility; the .bkp rule does not branch on it
 
   // The Codex mirrors are rebuilt wholesale, not merged: they are byte projections of the Claude
@@ -381,6 +403,14 @@ export function materializeHarness({ bundledHarnessDir, targetDir, pluginName, p
     }
   }
 
+  // Re-project the Codex skill mirror from the INSTALLED tree, after both prunes. The write pass
+  // above only emits what the bundle ships, so a project-local skill — one installed by
+  // `--skill=<name>` and deliberately absent from `owned`, which is what makes it survive pruning —
+  // was present for Claude and missing for Codex after every roll. Ordering is load-bearing: run
+  // before the prunes and a skill this bundle dropped would be mirrored straight back.
+  const mirrored = projectSkills({ targetDir, projectHasGit, snapshot: false });
+  if (mirrored?.installed) installed.push(mirrored.installed);
+
   // Retire hooks earlier harness versions shipped, before merging, so the additive merge never
   // resurrects an entry pointing at a script this bundle no longer carries.
   for (const r of retireOldHooks(targetDir, bundledHarnessDir)) notices.push(`removed ${r}`);

package/package.json

@@ -1,46 +1,46 @@
 {
-    "name": "@nurix/etna",
-    "version": "0.19.83",
-    "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/",
-        "lib/",
-        "data/",
-        "README.md"
-    ],
-    "engines": {
-        "node": ">=18.0.0"
-    },
-    "scripts": {
-        "test": "node --test 'tests/**/*.test.mjs'",
-        "build:data": "node scripts/build-data.js",
-        "prepack": "node scripts/build-data.js",
-        "validate:codex-agents": "node lib/codex/validate-codex-agents.mjs"
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/nurixlabs/etna.git",
-        "directory": "packages/cli"
-    },
-    "homepage": "https://github.com/nurixlabs/etna/tree/dev/packages/cli",
-    "license": "UNLICENSED",
-    "publishConfig": {
-        "access": "public"
-    },
-    "keywords": [
-        "claude",
-        "claude-code",
-        "harness",
-        "nurix",
-        "agent",
-        "plugin"
-    ],
-    "etnaFingerprint": "574f23e45199"
+  "name": "@nurix/etna",
+  "version": "0.19.84",
+  "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/",
+    "lib/",
+    "data/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "test": "node --test 'tests/**/*.test.mjs'",
+    "build:data": "node scripts/build-data.js",
+    "prepack": "node scripts/build-data.js",
+    "validate:codex-agents": "node lib/codex/validate-codex-agents.mjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nurixlabs/etna.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/nurixlabs/etna/tree/dev/packages/cli",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "harness",
+    "nurix",
+    "agent",
+    "plugin"
+  ],
+  "etnaFingerprint": "574f23e45199"
 }