@lamentis/naome 1.4.5 → 1.4.6

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

@@ -48,7 +48,7 @@ fn compact_path_sets_and_batches_cover_completion_commit_and_route() {
         "auto_commit_completed_task_then_create_new_task"
     );
 
-    repo.git(["add", "README.md", ".naome/task-state.json"]);
+    repo.git(["add", "README.md"]);
     let commit_gate = repo.validate(TaskStateMode::CommitGate);
     assert_eq!(commit_gate.errors, Vec::<String>::new());
 }

package/installer/harness-file-ops.js

@@ -13,7 +13,7 @@ import { archiveUpgradePath, assertWritableArchivePath, hasSymlinkInTargetPath }
 import { machineFileHash } from "./native.js";
 import { printError } from "./output.js";
 
-export function ensureTemplateFile(ctx, relativePath) {
+export function ensureTemplateFile(ctx, relativePath, options = {}) {
   const sourcePath = join(ctx.templateRoot, relativePath);
   const targetPath = join(ctx.targetRoot, relativePath);
 
@@ -33,6 +33,11 @@ export function ensureTemplateFile(ctx, relativePath) {
     return;
   }
 
+  if (options.skipWhenMissing?.()) {
+    ctx.skipped.push(relativePath);
+    return;
+  }
+
   mkdirSync(dirname(targetPath), { recursive: true });
   copyFileSync(sourcePath, targetPath);
   ctx.installed.push(relativePath);

package/installer/harness-files.js

@@ -1,3 +1,6 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+
 import {
   ensureNaomeIgnore,
   ensureTemplateFile,
@@ -32,7 +35,9 @@ export function ensureRepositoryStructurePolicyFiles(ctx) {
 }
 
 export function ensureTaskControlHarnessFiles(ctx, archiveDirName) {
-  ensureTemplateFile(ctx, ".naome/task-state.json");
+  ensureTemplateFile(ctx, ".naome/task-state.json", {
+    skipWhenMissing: () => activeTaskLedgerExists(ctx),
+  });
   replaceHarnessFile(ctx, ".naome/task-contract.schema.json", archiveDirName);
   replaceHarnessFile(ctx, ".naome/bin/check-task-state.js", archiveDirName);
   replaceHarnessFile(ctx, "AGENTS.md", archiveDirName);
@@ -44,6 +49,10 @@ export function ensureTaskControlHarnessFiles(ctx, archiveDirName) {
   replaceHarnessFile(ctx, "docs/naome/upgrade.md", archiveDirName);
 }
 
+function activeTaskLedgerExists(ctx) {
+  return existsSync(join(ctx.targetRoot, ".naome", "tasks", "active.json"));
+}
+
 export function ensureHarnessHealthFiles(ctx, archiveDirName) {
   replaceHarnessFile(ctx, "AGENTS.md", archiveDirName);
   replaceHarnessFile(ctx, ".naome/package.json", archiveDirName);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lamentis/naome",
-  "version": "1.4.5",
+  "version": "1.4.6",
   "description": "Native-first CLI for the NAOME agent harness.",
   "license": "Apache-2.0",
   "type": "module",

package/templates/naome-root/.naome/bin/check-harness-health.js

@@ -15,14 +15,14 @@ const expectedMachineOwnedIntegrity = Object.freeze({
   ".naome/bin/naome.js": "sha256:8a9d9ed783981ef9750021fa30e92460283775bb4a0eacdea60b63041a9c6a05",
   ".naome/package.json": "sha256:8005a3491db7d92f36ac66369861589f9c47123d3a7c71e643fc2c06168cd45a",
   ".naome/task-contract.schema.json": "sha256:1b3b62350328d0d6d660e36d1d1baaa2b88718530db774f9ab2a9e2fcba369c8",
-  "AGENTS.md": "sha256:e8b2fc786c1c72b69ba8f2b2ffce4f459e799c7453ce9ff4a9f6448a8f9e6b4f",
-  "docs/naome/agent-workflow.md": "sha256:0be1c29adfbcd3fd73c4f904080ffc67237692fe413871a30243538c4db38ac7",
+  "AGENTS.md": "sha256:28b51a5df52c90f21b62ecc110937cb254dbedcc22a36596a873dc02adb20623",
+  "docs/naome/agent-workflow.md": "sha256:3812a065adfbcdcacae42c93e58eedb90fa9439cd4d8fe97583d6718da9cb8af",
   "docs/naome/architecture-fitness.md": "sha256:be38e0c6dea8b1ebeee3bfd4a2e4e17008829360b1b4649ef45f2ce61e7287bd",
   "docs/naome/context-economy.md": "sha256:3ed5075815ecf4ada46a5e65438769310307c35759fcd46b13dc0b96e02bebd9",
-  "docs/naome/execution.md": "sha256:bfc5d55838942ec8e3d790b59e3c634ff5bf6a2298265cef3dca9788a097eafb",
+  "docs/naome/execution.md": "sha256:3e2fc914fdfeb245f02558cf2d366f4bc20a981885f70865559d9bf4a0a68406",
   "docs/naome/first-run.md": "sha256:1466ce8c65e19a1514885f917db14e8a772350e3f6d1c03a66326963365919e1",
   "docs/naome/index.md": "sha256:cac748ed375d86d288460456fc5d606b29bd99d91148522c303d5400a083dbc5",
-  "docs/naome/task-ledger.md": "sha256:6ca7222c80079b4662fb718d3c71d686770646f1fa52b83b0e90aed1c5a1101b",
+  "docs/naome/task-ledger.md": "sha256:7749e7e9484a2ae431230bf3568d0238ced81478304208bdfb3a12953b6f0a81",
   "docs/naome/upgrade.md": "sha256:2c60f0441bbd98bd528d109b30a7ded4b0ad55d61ffb9f52edac9e93b7999cb1"
 });
 

package/templates/naome-root/.naome/bin/check-task-state.js

@@ -15,14 +15,14 @@ const expectedMachineOwnedIntegrity = Object.freeze({
   ".naome/bin/naome.js": "sha256:8a9d9ed783981ef9750021fa30e92460283775bb4a0eacdea60b63041a9c6a05",
   ".naome/package.json": "sha256:8005a3491db7d92f36ac66369861589f9c47123d3a7c71e643fc2c06168cd45a",
   ".naome/task-contract.schema.json": "sha256:1b3b62350328d0d6d660e36d1d1baaa2b88718530db774f9ab2a9e2fcba369c8",
-  "AGENTS.md": "sha256:e8b2fc786c1c72b69ba8f2b2ffce4f459e799c7453ce9ff4a9f6448a8f9e6b4f",
-  "docs/naome/agent-workflow.md": "sha256:0be1c29adfbcd3fd73c4f904080ffc67237692fe413871a30243538c4db38ac7",
+  "AGENTS.md": "sha256:28b51a5df52c90f21b62ecc110937cb254dbedcc22a36596a873dc02adb20623",
+  "docs/naome/agent-workflow.md": "sha256:3812a065adfbcdcacae42c93e58eedb90fa9439cd4d8fe97583d6718da9cb8af",
   "docs/naome/architecture-fitness.md": "sha256:be38e0c6dea8b1ebeee3bfd4a2e4e17008829360b1b4649ef45f2ce61e7287bd",
   "docs/naome/context-economy.md": "sha256:3ed5075815ecf4ada46a5e65438769310307c35759fcd46b13dc0b96e02bebd9",
-  "docs/naome/execution.md": "sha256:bfc5d55838942ec8e3d790b59e3c634ff5bf6a2298265cef3dca9788a097eafb",
+  "docs/naome/execution.md": "sha256:3e2fc914fdfeb245f02558cf2d366f4bc20a981885f70865559d9bf4a0a68406",
   "docs/naome/first-run.md": "sha256:1466ce8c65e19a1514885f917db14e8a772350e3f6d1c03a66326963365919e1",
   "docs/naome/index.md": "sha256:cac748ed375d86d288460456fc5d606b29bd99d91148522c303d5400a083dbc5",
-  "docs/naome/task-ledger.md": "sha256:6ca7222c80079b4662fb718d3c71d686770646f1fa52b83b0e90aed1c5a1101b",
+  "docs/naome/task-ledger.md": "sha256:7749e7e9484a2ae431230bf3568d0238ced81478304208bdfb3a12953b6f0a81",
   "docs/naome/upgrade.md": "sha256:2c60f0441bbd98bd528d109b30a7ded4b0ad55d61ffb9f52edac9e93b7999cb1"
 });
 

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

@@ -1,5 +1,5 @@
 {
-  "harnessVersion": "1.4.0",
+  "harnessVersion": "1.4.6",
   "installedAt": null,
   "integrity": {
     ".naome/bin/check-harness-health.js": "sha256:802d7419774981a6af1826b3882270ff8f41259d516f98c52a02b4ddc184c467",
@@ -7,14 +7,14 @@
     ".naome/bin/naome.js": "sha256:8a9d9ed783981ef9750021fa30e92460283775bb4a0eacdea60b63041a9c6a05",
     ".naome/package.json": "sha256:8005a3491db7d92f36ac66369861589f9c47123d3a7c71e643fc2c06168cd45a",
     ".naome/task-contract.schema.json": "sha256:1b3b62350328d0d6d660e36d1d1baaa2b88718530db774f9ab2a9e2fcba369c8",
-    "AGENTS.md": "sha256:e8b2fc786c1c72b69ba8f2b2ffce4f459e799c7453ce9ff4a9f6448a8f9e6b4f",
-    "docs/naome/agent-workflow.md": "sha256:0be1c29adfbcd3fd73c4f904080ffc67237692fe413871a30243538c4db38ac7",
+    "AGENTS.md": "sha256:28b51a5df52c90f21b62ecc110937cb254dbedcc22a36596a873dc02adb20623",
+    "docs/naome/agent-workflow.md": "sha256:3812a065adfbcdcacae42c93e58eedb90fa9439cd4d8fe97583d6718da9cb8af",
     "docs/naome/architecture-fitness.md": "sha256:be38e0c6dea8b1ebeee3bfd4a2e4e17008829360b1b4649ef45f2ce61e7287bd",
     "docs/naome/context-economy.md": "sha256:3ed5075815ecf4ada46a5e65438769310307c35759fcd46b13dc0b96e02bebd9",
-    "docs/naome/execution.md": "sha256:bfc5d55838942ec8e3d790b59e3c634ff5bf6a2298265cef3dca9788a097eafb",
+    "docs/naome/execution.md": "sha256:3e2fc914fdfeb245f02558cf2d366f4bc20a981885f70865559d9bf4a0a68406",
     "docs/naome/first-run.md": "sha256:1466ce8c65e19a1514885f917db14e8a772350e3f6d1c03a66326963365919e1",
     "docs/naome/index.md": "sha256:cac748ed375d86d288460456fc5d606b29bd99d91148522c303d5400a083dbc5",
-    "docs/naome/task-ledger.md": "sha256:6ca7222c80079b4662fb718d3c71d686770646f1fa52b83b0e90aed1c5a1101b",
+    "docs/naome/task-ledger.md": "sha256:7749e7e9484a2ae431230bf3568d0238ced81478304208bdfb3a12953b6f0a81",
     "docs/naome/upgrade.md": "sha256:2c60f0441bbd98bd528d109b30a7ded4b0ad55d61ffb9f52edac9e93b7999cb1"
   },
   "machineOwned": [
@@ -39,7 +39,6 @@
     ".naomeignore",
     ".naome/init-state.json",
     ".naome/manifest.json",
-    ".naome/task-state.json",
     ".naome/upgrade-state.json",
     ".naome/verification.json",
     ".naome/repository-model.json",

package/templates/naome-root/AGENTS.md

@@ -8,7 +8,9 @@ This repository uses NAOME as its coding-agent harness.
 2. Do not read paths matched by `.naomeignore`.
 3. If `.naome/bin/check-harness-health.js` is missing, run
    `naome sync --check-update` from the repository root, then restart.
-4. Read `.naome/task-state.json`.
+4. Read `.naome/task-state.json` when present; if it is missing, run
+   `node .naome/bin/naome.js task status --json` and use the derived idle or
+   ledger-backed state.
 5. Run `node .naome/bin/check-harness-health.js`.
 6. If harness health fails, stop normal feature work and repair with
    `naome update` followed by `naome sync`, or ask for the listed decision.

package/templates/naome-root/docs/naome/agent-workflow.md

@@ -125,9 +125,10 @@ Use this workflow after first-run intake is complete.
    completion proof.
 5. Record proof as compact `proofPathSets` and `proofBatches` in the local
    ledger when many checks share evidence paths. Use local per-check proof files
-   only when separate writers need them during the run. The committed release
-   artifact is `.naome/task-state.json`; include every changed in-scope path
-   reported by git in expanded proof evidence.
+   only when separate writers need them during the run. `.naome/task-state.json`
+   is a local generated compatibility projection; include every changed
+   in-scope path reported by git in expanded proof evidence, but do not commit
+   the projection.
 6. Run `node .naome/bin/naome.js task render-state --write --json` before
    external compatibility checks. Do not hand-edit the rendered projection when
    `.naome/tasks/active.json` exists.

package/templates/naome-root/docs/naome/architecture.md

@@ -12,11 +12,11 @@ Status: Uninitialized
   local runtime state, run evidence, and product source.
 - Durable project state is committed repository or package state needed to
   reinstall or reconstruct the harness.
-- `.naome/task-state.json` is the committed compact task-state projection.
+- `.naome/task-state.json` is the local generated task-state projection.
 - `.naome/tmp/` and `.naome/tasks/` are local runtime state and must not be
   committed.
 - Per-check proof files are local run evidence. Prefer compact proof batches in
-  the committed task-state projection when many release checks share the same
+  the local task-state projection when many release checks share the same
   evidence paths.
 - Prompt routing uses fenced `naome-prompt-envelope-v1` JSON envelopes as the
   deterministic routing input. Raw natural-language prompts are audit text and

package/templates/naome-root/docs/naome/execution.md

@@ -87,7 +87,7 @@ task.
 
 ## Start A Task
 
-When starting work, update `.naome/task-state.json`:
+When starting work, update the local task ledger or generated compatibility projection `.naome/task-state.json`:
 
 - set `status` to `planning`
 - set `activeTask.id` to a short kebab-case id
@@ -159,14 +159,14 @@ Compact proof batches are lossless: `proofPathSets` names shared evidence,
 explicitly on the proof or batch.
 
 Do not reset `.naome/task-state.json` to idle just to hide the completed task.
-The completed task state is part of the task baseline and should be committed
-with the task diff. The next admitted task may overwrite it after the working
-tree is clean.
+The completed task state is local runtime memory and must not be committed with
+the task diff. The next admitted task may overwrite or regenerate the local
+projection after the working tree is clean.
 
 Deleted-file proof remains valid after baseline when the file was deleted
 between `activeTask.admission.gitHead` and current `HEAD`. The checker uses
-that historical task diff after the working tree is clean, so completed task
-state can stay committed without requiring the deleted file to exist.
+that historical task diff after the working tree is clean, so local completed
+task state can remain available without requiring the deleted file to exist.
 
 If the check passes but prints a next-task admission notice, keep the final
 handoff short and use NAOME route/status `userMessage` for the next step. List

package/templates/naome-root/docs/naome/task-ledger.md

@@ -1,8 +1,8 @@
 # Task Ledger
 
 NAOME task state is moving from one mutable aggregate file to a local task
-ledger. The compatibility file `.naome/task-state.json` remains the compact
-committed projection, while `.naome/tasks/` is machine-local runtime state for
+ledger. The compatibility file `.naome/task-state.json` is a generated
+local-only projection, while `.naome/tasks/` is machine-local runtime state for
 efficient task updates.
 
 ## Layout
@@ -35,9 +35,10 @@ efficient task updates.
 
 Existing `naome.task-state.v1` and `naome.task-state.v2` files remain valid. If
 a current local ledger exists, NAOME readers build a canonical task model from
-it and render a `naome.task-state.v2` projection. If no local ledger is present,
-or an older local completed ledger lacks proof detail that the committed compact
-projection still has, readers fall back to `.naome/task-state.json`.
+it and can render a `naome.task-state.v2` projection. If neither the local
+ledger nor the projection exists, readers derive a stable idle state. If an
+older tracked completed projection has proof detail that an incomplete local
+ledger lacks, readers keep that legacy projection for backwards compatibility.
 
 Use this command when an external tool needs the compatibility file refreshed:
 
@@ -54,14 +55,17 @@ node .naome/bin/naome.js task migrate-ledger --write --json
 ```
 
 After `.naome/tasks/active.json` exists, `.naome/task-state.json` is a rendered
-compatibility projection. NAOME gates reject a stale active projection and
-report the render command instead of accepting hand-edited aggregate state.
+compatibility projection. `naome sync` adds it to `.git/info/exclude` and
+removes any tracked copy from the git index without deleting the local file.
+NAOME gates can operate from the local ledger even when the projection is
+missing.
 
 ## Conflict Policy
 
-`.naome/tasks/` is local NAOME runtime state. It is ignored, untracked by
-`naome sync`, and not task feature scope or proof evidence. Gates ignore ledger
-control files when checking whether product changes stay inside `allowedPaths`.
+`.naome/task-state.json` and `.naome/tasks/` are local NAOME runtime state.
+They are ignored, untracked by `naome sync`, and not task feature scope or proof
+evidence. Gates ignore these control files when checking whether product
+changes stay inside `allowedPaths` or which paths should be committed.
 
 The intended long-term model is:
 
@@ -81,6 +85,6 @@ instead of all competing for `.naome/task-state.json`.
 Use `node .naome/bin/naome.js workflow information --path <path> --json` before
 changing NAOME control files whose retention is unclear. Durable configuration
 and templates are restored from repository or package state.
-`.naome/task-state.json` is the committed compact task projection. `.naome/tmp/`
+`.naome/task-state.json` is the local generated task projection. `.naome/tmp/`
 and `.naome/tasks/` are local runtime state. Compact release proof batches keep
 release diffs readable without tracking per-task runtime folders.