@kontextmind/kxm 0.7.89 → 0.7.91

package/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "kxm",
       "source": "./plugins/kxm",
       "description": "Durable workflows, peer agents, and kxm tui",
-      "version": "0.7.89",
+      "version": "0.7.91",
       "category": "development",
       "tags": ["kxm", "multi-agent", "workflows", "mcp"]
     }

package/CHANGELOG.md

@@ -174,6 +174,17 @@ All notable user-facing changes are documented here. The project follows [Semant
 
 ### Fixed
 
+- **`kxm memory sync` no longer writes this repository's agent policy into other
+  projects.** A missing `CLAUDE.md` or `GEMINI.md` used to be created from a header
+  copied from KXM's own instruction files — the planner/architecture-critic role, the
+  Grok writer rotation, and Tracking admission rules — so every project that ran sync
+  inherited another project's development policy. Sync now touches only the
+  `AGENTS.md`, `CLAUDE.md` and `GEMINI.md` a project already has, replaces or appends
+  just the `<!-- kxm:memory:start -->`…`<!-- kxm:memory:end -->` block, reports
+  `updated`, `unchanged` and `missing` files, and exits non-zero without writing when
+  none exist. The block is placed at the end of a file that has no markers yet, rather
+  than before a `## Do not` heading that only this repository uses.
+
 - **Release version surfaces cover workspace packages:** a merged PR no longer
   breaks the release pipeline. `scripts/kxm-bump-version.mjs` now writes the
   version into every package manifest under `packages/`, using the same package

package/docs/configuration.md

@@ -303,6 +303,7 @@ The current hub command groups are `agent`, `session`, `workflow`, `gate`, `hub`
 | `kxm improve` | Bucket `.kxm/logs/telemetry.jsonl` events into a proposed-only improvement report; does not read the workflow journal |
 | `kxm context get \| recall \| state \| episode \| promote \| explain \| wiki-compile \| wiki-lint` | Context operating system: role-aware packets, metadata search, temporal state, episodes, evidence-backed lineage (`explain`), wiki compile/lint |
 | `kxm skills` | Governed skill candidate lifecycle |
+| `kxm memory sync` | Regenerate the read-only project-memory block — authored facts from `.kxm/memory/` only — between `<!-- kxm:memory:start -->` and `<!-- kxm:memory:end -->` in whichever of `AGENTS.md`, `CLAUDE.md` and `GEMINI.md` already exist in the current directory. Text outside the markers is never rewritten; a file without markers gets the block appended. Missing files are reported as `missing` and **not created** — which harness a project uses is its own choice — and with none present sync exits 1 without writing. `--json` reports `updated`, `unchanged` and `missing` |
 
 Improvement telemetry is classified as `project` whenever a project or workflow identity is present, and as `cli` for unscoped operator behavior. Set `KXM_IMPROVE_TARGET=cli` or `KXM_IMPROVE_TARGET=project` only when an operator needs to override that generic classification; this changes report bucketing, not workflow state.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontextmind/kxm",
-  "version": "0.7.89",
+  "version": "0.7.91",
   "description": "KXM local-first multi-agent orchestration and operator dashboard",
   "type": "module",
   "author": "KontextMind",

package/plugins/kxm/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "kxm",
   "displayName": "KXM",
-  "version": "0.7.89",
+  "version": "0.7.91",
   "description": "Headless multi-agent orchestration, durable workflows, and a live operator dashboard for Pi and Claude Code",
   "author": {
     "name": "KontextMind",

package/plugins/kxm/dist/cli.js

@@ -33617,34 +33617,20 @@ function formatHarnessMemoryBlock(records) {
   contentLines.push(MEMORY_MARKER_END);
   return contentLines.join("\n");
 }
-function updateHarnessDocument(filePath, block, defaultHeader, dryRun = false) {
-  let original = "";
-  if (existsSync26(filePath)) {
-    original = readFileSync24(filePath, "utf8");
-  }
-  let updated = "";
+var HARNESS_INSTRUCTION_FILES = ["AGENTS.md", "CLAUDE.md", "GEMINI.md"];
+function updateHarnessDocument(filePath, block, dryRun = false) {
+  const original = readFileSync24(filePath, "utf8");
+  let updated;
   if (original.includes(MEMORY_MARKER_START) && original.includes(MEMORY_MARKER_END)) {
     const startIdx = original.indexOf(MEMORY_MARKER_START);
     const endIdx = original.indexOf(MEMORY_MARKER_END) + MEMORY_MARKER_END.length;
     updated = original.slice(0, startIdx) + block + original.slice(endIdx);
-  } else if (original.length > 0) {
-    const doNotIdx = original.indexOf("## Do not");
-    if (doNotIdx !== -1) {
-      updated = `${original.slice(0, doNotIdx).trimEnd()}
-
-${block}
-
-${original.slice(doNotIdx)}`;
-    } else {
-      updated = `${original.trimEnd()}
-
-${block}
-`;
-    }
   } else {
-    updated = `${defaultHeader.trimEnd()}
+    const head = original.trimEnd();
+    updated = head ? `${head}
 
 ${block}
+` : `${block}
 `;
   }
   if (updated !== original) {
@@ -33655,51 +33641,20 @@ ${block}
 }
 function syncHarnessMemory(repoRoot, options = {}) {
   const root = resolve22(repoRoot);
-  const records = loadAuthoredMemory(root);
-  const block = formatHarnessMemoryBlock(records);
-  const updated = [];
-  const created = [];
-  const agentsPath = join28(root, "AGENTS.md");
-  const agentsHeader = "# AGENTS\n\nFollow project instructions.\n";
-  const agentsExisted = existsSync26(agentsPath);
-  if (updateHarnessDocument(agentsPath, block, agentsHeader, options.dryRun)) {
-    if (agentsExisted) updated.push("AGENTS.md");
-    else created.push("AGENTS.md");
-  }
-  const claudePath = join28(root, "CLAUDE.md");
-  const claudeHeader = `# KXM (Claude)
-
-Follow [\`AGENTS.md\`](AGENTS.md). Official phase tracking:
-[\`plans/implementation-plan.md\`](plans/implementation-plan.md#tracking-working-tree-not-a-release).
-
-You are the **planner / architecture critic** unless the human explicitly asks
-you to implement. Default writer is native Grok CLI (\`grok --model grok-4.6\`) \u2014 a starting
-rotation, not a sole writer. If \`grok\` is logged out, never bill Grok through another harness;
-use a relief route Tracking **admits**, or stop and name the limits hit. Your reviews are
-artifacts, not hub \`peer-reply\` evidence.
-`;
-  const claudeExisted = existsSync26(claudePath);
-  if (updateHarnessDocument(claudePath, block, claudeHeader, options.dryRun)) {
-    if (claudeExisted) updated.push("CLAUDE.md");
-    else created.push("CLAUDE.md");
+  const present = HARNESS_INSTRUCTION_FILES.filter((name) => existsSync26(join28(root, name)));
+  const missing = HARNESS_INSTRUCTION_FILES.filter((name) => !present.includes(name));
+  if (present.length === 0) {
+    throw new Error(
+      `none of ${HARNESS_INSTRUCTION_FILES.join(", ")} exists in ${root}; sync updates the instruction files a project already has and does not create them`
+    );
   }
-  const geminiPath = join28(root, "GEMINI.md");
-  const geminiHeader = `# KXM (Gemini / Antigravity)
-
-Follow [\`AGENTS.md\`](AGENTS.md). Official phase tracking:
-[\`plans/implementation-plan.md\`](plans/implementation-plan.md#tracking-working-tree-not-a-release).
-
-Google goes through the \`antigravity\` **Pi provider** (Tracking \u2192 Decided,
-2026-09-15); \`agy\` stays a harness catalog/helper entry, not the admission path.
-Current admissions come from Tracking and \`kxm harness list\`. Starting rotation
-remains Grok.
-`;
-  const geminiExisted = existsSync26(geminiPath);
-  if (updateHarnessDocument(geminiPath, block, geminiHeader, options.dryRun)) {
-    if (geminiExisted) updated.push("GEMINI.md");
-    else created.push("GEMINI.md");
+  const block = formatHarnessMemoryBlock(loadAuthoredMemory(root));
+  const updated = [];
+  const unchanged = [];
+  for (const name of present) {
+    (updateHarnessDocument(join28(root, name), block, options.dryRun) ? updated : unchanged).push(name);
   }
-  return { updated, created };
+  return { updated, unchanged, missing };
 }
 
 // plugins/kxm/src/skills.ts
@@ -34460,16 +34415,22 @@ async function cmdMemorySync(runtime) {
       printPlan(
         runtime,
         { command: "memory sync", ...result },
-        [...result.created, ...result.updated].map((file) => ({ action: "write", target: join31(runtime.cwd, file) })),
-        "regenerate project memory blocks in AGENTS.md, CLAUDE.md, and GEMINI.md"
+        result.updated.map((file) => ({ action: "write", target: join31(runtime.cwd, file) })),
+        "regenerate the project memory block in the instruction files this project already has"
       );
       return 0;
     }
+    const lines = [
+      ...result.updated.length > 0 ? [`updated: ${result.updated.join(", ")}`] : [],
+      ...result.unchanged.length > 0 ? [`unchanged: ${result.unchanged.join(", ")}`] : [],
+      ...result.missing.length > 0 ? [`not present, not created: ${result.missing.join(", ")}`] : []
+    ];
     print(
       runtime.io,
       runtime.json,
       { ok: true, command: "memory sync", ...result },
-      `Synced project memory across AGENTS.md, CLAUDE.md, and GEMINI.md`
+      `Synced project memory
+${lines.join("\n")}`
     );
     return 0;
   } catch (error) {
@@ -48574,7 +48535,7 @@ function createProgram(ctx, result) {
   addGlobalOptions(memory.command("note").description("Record an evidence-based memory candidate (promoted via PR)")).argument("<fact>", "Summary of the observed fact or learning").option("--scope <scope>", "Scope: agent, project, run, or operator (default: project)").option("--kind <kind>", "Kind: decision, architecture, convention, policy, learning (default: learning)").option("--body <text>", "Detailed markdown context for the fact").action(async function memoryNoteAction(fact, options) {
     result.code = await cmdMemoryNote(runtimeFrom(ctx, this), fact, options);
   });
-  addGlobalOptions(memory.command("sync").description("Regenerate memory projection blocks across AGENTS.md, CLAUDE.md, and GEMINI.md")).action(async function memorySyncAction() {
+  addGlobalOptions(memory.command("sync").description("Regenerate the memory block in whichever of AGENTS.md, CLAUDE.md, and GEMINI.md exist; never creates them")).action(async function memorySyncAction() {
     result.code = await cmdMemorySync(runtimeFrom(ctx, this));
   });
   const routing = addGlobalOptions(program2.command("routing").description("Model/harness routing telemetry and behavioral comparisons"));

package/plugins/kxm/dist/mcp-server.js

@@ -17182,7 +17182,7 @@ async function deliverInboxNotification(messageId, delivered, notify) {
 }
 
 // plugins/kxm/src/mcp-server.ts
-var VERSION = "0.7.89";
+var VERSION = "0.7.91";
 var inbox = /* @__PURE__ */ new Map();
 var notifiedInbox = /* @__PURE__ */ new Set();
 var meshClient;

package/plugins/kxm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-plugin",
-  "version": "0.7.89",
+  "version": "0.7.91",
   "private": true,
   "type": "module",
   "engines": {

package/plugins/kxm/skills/kxm-context-memory/SKILL.md

@@ -38,7 +38,7 @@ kxm context state my-project "configuration.authority" --json
 |---|---|---|
 | `kxm memory brief` | Read active project memory facts | `--json` |
 | `kxm memory note <fact>` | Record a candidate for reviewed promotion | `--scope`, `--kind`, `--body`, `--json` |
-| `kxm memory sync` | Regenerate harness instruction memory projections | `--json` |
+| `kxm memory sync` | Regenerate the memory block in existing `AGENTS.md`, `CLAUDE.md`, `GEMINI.md` | `--json` |
 
 Scopes are `agent`, `project`, `run`, or `operator`. Kinds are `decision`,
 `architecture`, `convention`, `policy`, or `learning`. Scope and kind labels
@@ -51,6 +51,12 @@ never elevate the candidate's authority.
 4. Regenerate projections only as an authorized write, inspect their diff,
    and run the existing verification gate.
 
+`kxm memory sync` rewrites only the text between `<!-- kxm:memory:start -->`
+and `<!-- kxm:memory:end -->` (appending that block when a file has none) and
+never creates an instruction file. If the project has none of the three, sync
+refuses; create the file your harness reads yourself rather than expecting KXM
+to author it.
+
 Do not invent search, save, delete, list, or clear subcommands under memory.
 Use context retrieval for discovery and reviewed authored changes for
 corrections, respecting provenance and historical records.

package/plugins/kxm/src/cli/context-skills.ts

@@ -398,16 +398,21 @@ export async function cmdMemorySync(runtime: Runtime): Promise<number> {
       printPlan(
         runtime,
         { command: "memory sync", ...result },
-        [...result.created, ...result.updated].map((file) => ({ action: "write", target: join(runtime.cwd, file) })),
-        "regenerate project memory blocks in AGENTS.md, CLAUDE.md, and GEMINI.md",
+        result.updated.map((file) => ({ action: "write", target: join(runtime.cwd, file) })),
+        "regenerate the project memory block in the instruction files this project already has",
       );
       return 0;
     }
+    const lines = [
+      ...(result.updated.length > 0 ? [`updated: ${result.updated.join(", ")}`] : []),
+      ...(result.unchanged.length > 0 ? [`unchanged: ${result.unchanged.join(", ")}`] : []),
+      ...(result.missing.length > 0 ? [`not present, not created: ${result.missing.join(", ")}`] : []),
+    ];
     print(
       runtime.io,
       runtime.json,
       { ok: true, command: "memory sync", ...result },
-      `Synced project memory across AGENTS.md, CLAUDE.md, and GEMINI.md`,
+      `Synced project memory\n${lines.join("\n")}`,
     );
     return 0;
   } catch (error) {

package/plugins/kxm/src/cli.ts

@@ -1040,7 +1040,7 @@ function createProgram(ctx: CliContext, result: { code: number }): Command {
     .action(async function memoryNoteAction(this: Command, fact: string, options: { scope?: string; kind?: string; body?: string }) {
       result.code = await cmdMemoryNote(runtimeFrom(ctx, this), fact, options);
     });
-  addGlobalOptions(memory.command("sync").description("Regenerate memory projection blocks across AGENTS.md, CLAUDE.md, and GEMINI.md"))
+  addGlobalOptions(memory.command("sync").description("Regenerate the memory block in whichever of AGENTS.md, CLAUDE.md, and GEMINI.md exist; never creates them"))
     .action(async function memorySyncAction(this: Command) {
       result.code = await cmdMemorySync(runtimeFrom(ctx, this));
     });

package/plugins/kxm/src/mcp-server.ts

@@ -8,7 +8,7 @@ import { AGENT_COMMANDS_MAP, enforceToolPolicy, getMcpTools, reconcileInbox } fr
 import { deliverInboxNotification } from "./inbox.ts";
 import type { HubEvent, MessageRecord } from "./protocol.ts";
 
-const VERSION = "0.7.89";
+const VERSION = "0.7.91";
 const inbox = new Map<string, MessageRecord>();
 const notifiedInbox = new Set<string>();
 let meshClient: HubClient | undefined;

package/plugins/kxm/src/memory.ts

@@ -318,28 +318,24 @@ export function formatHarnessMemoryBlock(records: MemoryRecord[]): string {
   return contentLines.join("\n");
 }
 
-/** Returns whether the projection block changed the file; `dryRun` answers without writing. */
-export function updateHarnessDocument(filePath: string, block: string, defaultHeader: string, dryRun = false): boolean {
-  let original = "";
-  if (existsSync(filePath)) {
-    original = readFileSync(filePath, "utf8");
-  }
-
-  let updated = "";
+/** Instruction files `kxm memory sync` projects memory into. Sync never creates one:
+ * which harness a project uses is the project's choice, and a file KXM wrote would
+ * carry KXM's words instead of the project's. */
+const HARNESS_INSTRUCTION_FILES = ["AGENTS.md", "CLAUDE.md", "GEMINI.md"] as const;
+
+/** Replace the marker-delimited block, or append one when the file has none. Nothing
+ * outside the markers is rewritten. Returns whether the block changed the file; `dryRun`
+ * answers without writing. */
+export function updateHarnessDocument(filePath: string, block: string, dryRun = false): boolean {
+  const original = readFileSync(filePath, "utf8");
+  let updated: string;
   if (original.includes(MEMORY_MARKER_START) && original.includes(MEMORY_MARKER_END)) {
     const startIdx = original.indexOf(MEMORY_MARKER_START);
     const endIdx = original.indexOf(MEMORY_MARKER_END) + MEMORY_MARKER_END.length;
     updated = original.slice(0, startIdx) + block + original.slice(endIdx);
-  } else if (original.length > 0) {
-    // If "## Do not" exists, insert before it; else append to end
-    const doNotIdx = original.indexOf("## Do not");
-    if (doNotIdx !== -1) {
-      updated = `${original.slice(0, doNotIdx).trimEnd()}\n\n${block}\n\n${original.slice(doNotIdx)}`;
-    } else {
-      updated = `${original.trimEnd()}\n\n${block}\n`;
-    }
   } else {
-    updated = `${defaultHeader.trimEnd()}\n\n${block}\n`;
+    const head = original.trimEnd();
+    updated = head ? `${head}\n\n${block}\n` : `${block}\n`;
   }
 
   if (updated !== original) {
@@ -349,40 +345,24 @@ export function updateHarnessDocument(filePath: string, block: string, defaultHe
   return false;
 }
 
-export function syncHarnessMemory(repoRoot: string, options: { dryRun?: boolean } = {}): { updated: string[]; created: string[] } {
+export function syncHarnessMemory(
+  repoRoot: string,
+  options: { dryRun?: boolean } = {},
+): { updated: string[]; unchanged: string[]; missing: string[] } {
   const root = resolve(repoRoot);
-  const records = loadAuthoredMemory(root);
-  const block = formatHarnessMemoryBlock(records);
-
-  const updated: string[] = [];
-  const created: string[] = [];
-
-  // 1. AGENTS.md
-  const agentsPath = join(root, "AGENTS.md");
-  const agentsHeader = "# AGENTS\n\nFollow project instructions.\n";
-  const agentsExisted = existsSync(agentsPath);
-  if (updateHarnessDocument(agentsPath, block, agentsHeader, options.dryRun)) {
-    if (agentsExisted) updated.push("AGENTS.md");
-    else created.push("AGENTS.md");
-  }
-
-  // 2. CLAUDE.md
-  const claudePath = join(root, "CLAUDE.md");
-  const claudeHeader = `# KXM (Claude)\n\nFollow [\`AGENTS.md\`](AGENTS.md). Official phase tracking:\n[\`plans/implementation-plan.md\`](plans/implementation-plan.md#tracking-working-tree-not-a-release).\n\nYou are the **planner / architecture critic** unless the human explicitly asks\nyou to implement. Default writer is native Grok CLI (\`grok --model grok-4.6\`) — a starting\nrotation, not a sole writer. If \`grok\` is logged out, never bill Grok through another harness;\nuse a relief route Tracking **admits**, or stop and name the limits hit. Your reviews are\nartifacts, not hub \`peer-reply\` evidence.\n`;
-  const claudeExisted = existsSync(claudePath);
-  if (updateHarnessDocument(claudePath, block, claudeHeader, options.dryRun)) {
-    if (claudeExisted) updated.push("CLAUDE.md");
-    else created.push("CLAUDE.md");
+  const present = HARNESS_INSTRUCTION_FILES.filter((name) => existsSync(join(root, name)));
+  const missing = HARNESS_INSTRUCTION_FILES.filter((name) => !present.includes(name));
+  if (present.length === 0) {
+    throw new Error(
+      `none of ${HARNESS_INSTRUCTION_FILES.join(", ")} exists in ${root}; sync updates the instruction files a project already has and does not create them`,
+    );
   }
 
-  // 3. GEMINI.md
-  const geminiPath = join(root, "GEMINI.md");
-  const geminiHeader = `# KXM (Gemini / Antigravity)\n\nFollow [\`AGENTS.md\`](AGENTS.md). Official phase tracking:\n[\`plans/implementation-plan.md\`](plans/implementation-plan.md#tracking-working-tree-not-a-release).\n\nGoogle goes through the \`antigravity\` **Pi provider** (Tracking \u2192 Decided,\n2026-09-15); \`agy\` stays a harness catalog/helper entry, not the admission path.\nCurrent admissions come from Tracking and \`kxm harness list\`. Starting rotation\nremains Grok.\n`;
-  const geminiExisted = existsSync(geminiPath);
-  if (updateHarnessDocument(geminiPath, block, geminiHeader, options.dryRun)) {
-    if (geminiExisted) updated.push("GEMINI.md");
-    else created.push("GEMINI.md");
+  const block = formatHarnessMemoryBlock(loadAuthoredMemory(root));
+  const updated: string[] = [];
+  const unchanged: string[] = [];
+  for (const name of present) {
+    (updateHarnessDocument(join(root, name), block, options.dryRun) ? updated : unchanged).push(name);
   }
-
-  return { updated, created };
+  return { updated, unchanged, missing };
 }