@lamentis/naome 1.0.0 → 1.0.2

package/Cargo.lock

@@ -76,7 +76,7 @@ checksum = "f8ca58f447f06ed17d5fc4043ce1b10dd205e060fb3ce5b979b8ed8e59ff3f79"
 
 [[package]]
 name = "naome-cli"
-version = "1.0.0"
+version = "1.0.2"
 dependencies = [
  "naome-core",
  "serde_json",
@@ -84,7 +84,7 @@ dependencies = [
 
 [[package]]
 name = "naome-core"
-version = "1.0.0"
+version = "1.0.2"
 dependencies = [
  "serde",
  "serde_json",

package/README.md

@@ -1,6 +1,20 @@
-# naome
+# NAOME
 
 [![npm version](https://img.shields.io/npm/v/@lamentis/naome.svg)](https://www.npmjs.com/package/@lamentis/naome)
 [![license: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 
-NAOME gives coding agents a deterministic repository harness: it installs project intake docs, task admission and proof gates, Rust-backed next-step decisions, harness health checks, and Git guardrails so an agent can learn a repo before changing it and prove work before committing; install it with `npm install -g @lamentis/naome`, run `naome sync` in the target repository, then paste the printed first-run prompt into your agent.
+NAOME gives coding agents a deterministic repository harness: project intake, task admission, proof gates, Rust-backed next-step decisions, health checks, and Git guardrails so an agent learns a repo before changing it and proves work before committing.
+
+Install:
+
+```sh
+npm install -g @lamentis/naome
+```
+
+Set up a repository:
+
+```sh
+naome sync
+```
+
+Then paste the printed first-run prompt into your coding agent. Use `naome status`, `naome next`, and `naome commit` to inspect state, choose the next safe action, and baseline completed work.

package/bin/naome-node.js

@@ -34,6 +34,7 @@ let machineOwnedPaths = [];
 let projectOwnedPaths = [];
 let localOnlyMachineOwnedPaths = [];
 let localOnlyGitIgnoreEntries = [];
+let localOnlyGitExcludeEntries = [];
 let localOnlyGitUntrackPaths = [];
 
 const executableMachineOwnedPaths = new Set([
@@ -363,12 +364,14 @@ function loadInstallPlan() {
   assertInstallPlanArray("projectOwned");
   assertInstallPlanArray("localOnlyMachineOwned");
   assertInstallPlanArray("gitignoreEntries");
+  assertInstallPlanArray("gitExcludeEntries");
   assertInstallPlanArray("gitUntrackPaths");
 
   machineOwnedPaths = installPlan.machineOwned;
   projectOwnedPaths = installPlan.projectOwned;
   localOnlyMachineOwnedPaths = installPlan.localOnlyMachineOwned;
   localOnlyGitIgnoreEntries = installPlan.gitignoreEntries;
+  localOnlyGitExcludeEntries = installPlan.gitExcludeEntries;
   localOnlyGitUntrackPaths = installPlan.gitUntrackPaths;
 
   return installPlan;
@@ -820,11 +823,19 @@ function ensureNaomeIgnore() {
 }
 
 function ensureLocalOnlySourceControlBoundary() {
-  ensureLocalOnlyGitIgnore();
+  if (!isInsideGitWorkTree()) {
+    ensureLocalOnlyGitIgnoreFallback();
+    skipped.push("local git exclude");
+    skipped.push("local-only git index cleanup");
+    return;
+  }
+
+  cleanupLegacyLocalOnlyGitIgnore();
+  ensureLocalOnlyGitExclude();
   untrackLocalOnlyGitPaths();
 }
 
-function ensureLocalOnlyGitIgnore() {
+function ensureLocalOnlyGitIgnoreFallback() {
   const relativePath = ".gitignore";
   const targetPath = join(targetRoot, relativePath);
 
@@ -841,7 +852,7 @@ function ensureLocalOnlyGitIgnore() {
 
   const content = existsSync(targetPath) ? readFileSync(targetPath, "utf8") : "";
   const existingLines = new Set(content.split(/\r?\n/).map((line) => line.trim()));
-  const missingEntries = localOnlyGitIgnoreEntries.filter((entry) => !existingLines.has(entry));
+  const missingEntries = legacyLocalOnlyGitIgnoreEntries().filter((entry) => !existingLines.has(entry));
 
   if (missingEntries.length === 0) {
     skipped.push(relativePath);
@@ -857,6 +868,110 @@ function ensureLocalOnlyGitIgnore() {
   }
 }
 
+function cleanupLegacyLocalOnlyGitIgnore() {
+  const relativePath = ".gitignore";
+  const targetPath = join(targetRoot, relativePath);
+
+  if (!existsSync(targetPath)) {
+    skipped.push(relativePath);
+    return;
+  }
+
+  if (hasSymlinkInTargetPath(relativePath)) {
+    printError("NAOME cannot clean up .gitignore safely.");
+    console.error(".gitignore must be a regular file or must not exist.");
+    process.exit(1);
+  }
+
+  if (!lstatSync(targetPath).isFile()) {
+    printError("NAOME cannot update .gitignore because that path is not a file.");
+    process.exit(1);
+  }
+
+  const content = readFileSync(targetPath, "utf8");
+  const legacyEntries = new Set(legacyLocalOnlyGitIgnoreEntries());
+  const nextContent = cleanBlankLines(content
+    .split(/\r?\n/)
+    .filter((line) => !legacyEntries.has(line.trim()))
+    .join("\n"));
+
+  if (nextContent === content) {
+    skipped.push(relativePath);
+    return;
+  }
+
+  if (nextContent.trim().length === 0) {
+    unlinkSync(targetPath);
+  } else {
+    writeFileSync(targetPath, nextContent);
+  }
+  updated.push(relativePath);
+}
+
+function ensureLocalOnlyGitExclude() {
+  if (!isInsideGitWorkTree()) {
+    skipped.push("local git exclude");
+    return;
+  }
+
+  const gitDirResult = spawnSync("git", ["rev-parse", "--absolute-git-dir"], {
+    cwd: targetRoot,
+    encoding: "utf8",
+  });
+
+  if (gitDirResult.status !== 0 || !gitDirResult.stdout.trim()) {
+    skipped.push("local git exclude");
+    unsafeSkipped.push("local git exclude");
+    return;
+  }
+
+  const excludePath = join(gitDirResult.stdout.trim(), "info", "exclude");
+  mkdirSync(dirname(excludePath), { recursive: true });
+
+  if (existsSync(excludePath) && !lstatSync(excludePath).isFile()) {
+    printError("NAOME cannot update local git exclude because that path is not a file.");
+    process.exit(1);
+  }
+
+  const content = existsSync(excludePath) ? readFileSync(excludePath, "utf8") : "";
+  const existingLines = new Set(content.split(/\r?\n/).map((line) => line.trim()));
+  const missingEntries = localOnlyGitExcludeEntries.filter((entry) => !existingLines.has(entry));
+
+  if (missingEntries.length === 0) {
+    skipped.push(".git/info/exclude");
+    return;
+  }
+
+  const nextContent = `${content.trimEnd()}${content.trimEnd() ? "\n\n" : ""}${missingEntries.join("\n")}\n`;
+  writeFileSync(excludePath, nextContent);
+  updated.push(".git/info/exclude");
+}
+
+function legacyLocalOnlyGitIgnoreEntries() {
+  return [
+    "# NAOME local machine-owned harness files.",
+    ".naome/archive/",
+    ".naome/bin/naome-rust*",
+    ...localOnlyMachineOwnedPaths,
+    ...localOnlyGitIgnoreEntries,
+  ];
+}
+
+function cleanBlankLines(content) {
+  const lines = content.split(/\r?\n/);
+  const cleaned = [];
+
+  for (const line of lines) {
+    if (line.trim() === "" && cleaned.at(-1)?.trim() === "") {
+      continue;
+    }
+    cleaned.push(line);
+  }
+
+  const trimmed = cleaned.join("\n").trimEnd();
+  return trimmed ? `${trimmed}\n` : "";
+}
+
 function untrackLocalOnlyGitPaths() {
   if (!isInsideGitWorkTree()) {
     skipped.push("local-only git index cleanup");

package/crates/naome-cli/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "naome-cli"
-version = "1.0.0"
+version = "1.0.2"
 edition.workspace = true
 license.workspace = true
 repository.workspace = true

package/crates/naome-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "naome-core"
-version = "1.0.0"
+version = "1.0.2"
 edition.workspace = true
 license.workspace = true
 repository.workspace = true

package/crates/naome-core/src/install_plan.rs

@@ -56,16 +56,18 @@ pub struct InstallPlan {
     pub project_owned: Vec<&'static str>,
     pub local_only_machine_owned: Vec<&'static str>,
     pub gitignore_entries: Vec<&'static str>,
+    pub git_exclude_entries: Vec<&'static str>,
     pub git_untrack_paths: Vec<&'static str>,
 }
 
 pub fn install_plan(harness_version: impl Into<String>) -> InstallPlan {
-    let mut gitignore_entries = vec![
+    let gitignore_entries = Vec::new();
+    let mut git_exclude_entries = vec![
         "# NAOME local machine-owned harness files.",
         ".naome/archive/",
         ".naome/bin/naome-rust*",
     ];
-    gitignore_entries.extend_from_slice(LOCAL_ONLY_MACHINE_OWNED_PATHS);
+    git_exclude_entries.extend_from_slice(LOCAL_ONLY_MACHINE_OWNED_PATHS);
 
     let mut git_untrack_paths = LOCAL_ONLY_MACHINE_OWNED_PATHS.to_vec();
     git_untrack_paths.extend_from_slice(LOCAL_NATIVE_BINARY_PATHS);
@@ -77,6 +79,7 @@ pub fn install_plan(harness_version: impl Into<String>) -> InstallPlan {
         project_owned: PROJECT_OWNED_PATHS.to_vec(),
         local_only_machine_owned: LOCAL_ONLY_MACHINE_OWNED_PATHS.to_vec(),
         gitignore_entries,
+        git_exclude_entries,
         git_untrack_paths,
     }
 }

package/crates/naome-core/tests/install_plan.rs

@@ -21,13 +21,14 @@ fn install_plan_marks_machine_docs_and_bins_local_only() {
 }
 
 #[test]
-fn install_plan_includes_gitignore_and_untrack_policy() {
+fn install_plan_includes_git_exclude_and_untrack_policy() {
     let plan = install_plan("1.0.0");
 
-    assert!(plan.gitignore_entries.contains(&".naome/archive/"));
-    assert!(plan.gitignore_entries.contains(&".naome/bin/naome-rust*"));
+    assert!(plan.gitignore_entries.is_empty());
+    assert!(plan.git_exclude_entries.contains(&".naome/archive/"));
+    assert!(plan.git_exclude_entries.contains(&".naome/bin/naome-rust*"));
     assert!(plan
-        .gitignore_entries
+        .git_exclude_entries
         .contains(&".naome/bin/check-harness-health.js"));
     assert!(plan.git_untrack_paths.contains(&".naome/archive"));
     assert!(plan.git_untrack_paths.contains(&".naome/bin/naome-rust"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lamentis/naome",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Native-first CLI for the NAOME agent harness.",
   "license": "MIT",
   "type": "module",

package/templates/naome-root/.naome/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "naome",
-  "harnessVersion": "1.0.0",
+  "harnessVersion": "1.0.2",
   "profile": "standard",
   "installedAt": null,
   "machineOwned": [

package/templates/naome-root/.naome/upgrade-state.json

@@ -1,7 +1,7 @@
 {
   "status": "complete",
   "fromVersion": null,
-  "toVersion": "1.0.0",
+  "toVersion": "1.0.2",
   "pending": [],
   "completed": []
 }