@forwardimpact/libwiki 0.2.18 → 0.2.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/libwiki",
-  "version": "0.2.18",
+  "version": "0.2.20",
   "description": "Wiki lifecycle primitives — stable memory for agent teams so coordination persists across sessions.",
   "keywords": [
     "wiki",
@@ -50,7 +50,7 @@
     "@forwardimpact/libeval": "^0.1.49",
     "@forwardimpact/libpreflight": "^0.1.0",
     "@forwardimpact/libutil": "^0.1.0",
-    "@forwardimpact/libxmr": "^1.1.0"
+    "@forwardimpact/libxmr": "^2.0.0"
   },
   "devDependencies": {
     "@forwardimpact/libmock": "^0.1.0"

package/src/commands/claim.js

@@ -22,7 +22,9 @@ async function pushWiki(wikiSync, runtime, message) {
   if (!wikiSync) return;
   try {
     await wikiSync.inheritIdentity();
-    const result = await wikiSync.commitAndPush(message);
+    // claim/release contract is a 1-line MEMORY.md change; the pathspec keeps
+    // foreign uncommitted files from parallel writers out of the commit.
+    const result = await wikiSync.commitAndPush(message, ["MEMORY.md"]);
     if (result.pushed)
       runtime.proc.stdout.write("push: committed and pushed\n");
   } catch (err) {

package/src/commands/fix.js

@@ -48,9 +48,10 @@ function invariantContract(findings) {
 }
 
 /**
- * The opening task: the findings, the invariant contract, and the two things
- * the rule hints don't cover — where trimmed history goes, and to prefer a
- * single Write.
+ * The opening task: the findings, the invariant contract, and the things the
+ * rule hints don't cover — where trimmed history goes (only existing
+ * weekly-log files; rotation owns minting new ones), and to prefer a single
+ * Write.
  */
 function composeTask(findings, wikiRoot, projectRoot) {
   return [
@@ -62,9 +63,13 @@ function composeTask(findings, wikiRoot, projectRoot) {
     `by breaking another:`,
     ...invariantContract(findings),
     ``,
-    `Move history out of an over-budget summary into the agent's weekly-log`,
-    `file (wiki/<agent>-YYYY-Www.md), never a new summary section. Prefer a`,
-    `single Write over many Edits.`,
+    `Move history out of an over-budget summary into the agent's existing`,
+    `weekly-log file or its current part (wiki/<agent>-YYYY-Www[-partN].md) —`,
+    `never a new summary section, and never a new file: rotation tooling owns`,
+    `when part files are created, so do not mint filenames yourself. If the`,
+    `trimmed narrative already exists in the weekly log, replace it in the`,
+    `summary with a pointer to that file instead of copying it anywhere.`,
+    `Prefer a single Write over many Edits.`,
   ].join("\n");
 }
 

package/src/wiki-sync.js

@@ -102,9 +102,13 @@ export class WikiSync {
     }
   }
 
-  /** Whether the wiki working tree has no uncommitted changes. */
-  async isClean() {
-    const r = await this.#git.status({ cwd: this.#wikiDir });
+  /**
+   * Whether the wiki working tree has no uncommitted changes, optionally
+   * limited to `paths`.
+   * @param {string[]} [paths] - Pathspecs to scope the check to.
+   */
+  async isClean(paths) {
+    const r = await this.#git.status({ cwd: this.#wikiDir, paths });
     return r.stdout.trim() === "";
   }
 
@@ -119,14 +123,27 @@ export class WikiSync {
   }
 
   /**
-   * Stage and commit any working-tree changes, then fetch, rebase on
+   * Stage and commit working-tree changes, then fetch, rebase on
    * origin/master (falling back to a merge with -X ours if the rebase fails),
    * and push if HEAD is ahead of origin/master. The commit gate and the push
    * gate are independent so a clean tree with local commits still pushes.
+   *
+   * Without `paths` the commit sweeps the whole tree (`fit-wiki push`
+   * contract). With `paths` the commit is pathspec-scoped so foreign residue
+   * from parallel writers in the shared workspace is never swept in; the
+   * rebase and merge fallback then run with --autostash because that residue
+   * stays uncommitted in the tree.
+   *
+   * @param {string} message - The commit message.
+   * @param {string[]} [paths] - Pathspecs limiting what gets committed.
    */
-  async commitAndPush(message) {
-    if (!(await this.isClean())) {
-      await this.#git.commitAll(message, { cwd: this.#wikiDir });
+  async commitAndPush(message, paths) {
+    if (!(await this.isClean(paths))) {
+      if (paths?.length) {
+        await this.#git.commitPaths(message, paths, { cwd: this.#wikiDir });
+      } else {
+        await this.#git.commitAll(message, { cwd: this.#wikiDir });
+      }
     }
     if (!(await this.#hasCommitsAhead())) {
       return { pushed: false, reason: "clean" };
@@ -134,12 +151,14 @@ export class WikiSync {
     await this.fetch();
     const rebase = await this.#git.rebase("origin/master", {
       cwd: this.#wikiDir,
+      autostash: true,
     });
     if (rebase.exitCode !== 0) {
       await this.#git.rebaseAbort({ cwd: this.#wikiDir });
       await this.#git.mergeOursStrategy({
         cwd: this.#wikiDir,
         ref: "origin/master",
+        autostash: true,
       });
     }
     // Resolve auth first so a misconfigured `resolveToken` still surfaces; the