@codacy/verity-cli 0.33.2 → 0.33.3

package/CHANGELOG.md

@@ -64,6 +64,32 @@ installs are untouched.
   which is the ordinary case for someone whose first Verity install *is* the
   plugin.
 
+## [0.33.3] — 2026-09-24
+
+**The knowledge seed runs once per project, not once per checkout.**
+
+- **`verity memory seed` and the analyze auto-seed no longer re-seed a project
+  that is already seeded.** The old "already seeded" check looked for a file the
+  server never writes (`domain/project-overview.md`; nodes are named
+  `n{seq}-{slug}.md`), so it never matched, and an empty, not-yet-pulled
+  `.verity/memory/` in a fresh clone or worktree read as "never seeded". Every
+  new checkout posted the whole batch again and the server recorded every copy.
+  One project reached 13,497 nodes, 11,214 of them copies of 38 seed titles, and
+  every analyze for it died on request size (HTTP 546, VRT-243). The CLI now
+  checks the frontmatter of what is on disk, then asks the server which seed
+  titles the project has, and posts only the titles that are missing — so a
+  seed that only half landed is completed, and a seeded project is never
+  re-posted.
+- **The server refuses to record the same seed twice.** Posting a seed node whose
+  title and body the project already carries returns the existing node
+  (`200`, `deduplicated: true`) instead of minting another. This holds for old
+  CLIs, cleared markers and parallel worktrees alike. A seed whose body changed
+  (the README was edited) is still a new node, and an archived seed can be
+  recorded again.
+- `verity memory seed` reports nodes that already existed apart from nodes it
+  created, and `--force` re-materializes the existing nodes locally rather than
+  duplicating them.
+
 ## [0.33.2] — 2026-09-23
 
 **Which build is gating, said out loud.**

package/bin/verity.js

@@ -22159,7 +22159,7 @@ function channelSilence(input) {
 // src/lib/cli-version.ts
 function cliVersion() {
   try {
-    return true ? "0.33.2" : "dev";
+    return true ? "0.33.3" : "dev";
   } catch {
     return "dev";
   }
@@ -23870,6 +23870,73 @@ _Seeded from CLAUDE.md. Edit or archive if outdated._`,
 }
 
 // src/lib/seed-runner.ts
+var NODE_DIRS = ["decisions", "quality", "security", "intent", "gotchas", "patterns", "domain", "integrations"];
+function normalizeTitle(title) {
+  return title.trim().replace(/\s+/g, " ").toLowerCase();
+}
+async function localSeedTitles(memoryDir3 = MEMORY_DIR) {
+  const titles = /* @__PURE__ */ new Set();
+  for (const dir of NODE_DIRS) {
+    const full = (0, import_node_path32.join)(memoryDir3, dir);
+    if (!(0, import_node_fs42.existsSync)(full)) continue;
+    let files;
+    try {
+      files = await (0, import_promises15.readdir)(full);
+    } catch {
+      continue;
+    }
+    for (const file of files) {
+      if (!file.endsWith(".md")) continue;
+      let content;
+      try {
+        content = await (0, import_promises15.readFile)((0, import_node_path32.join)(full, file), "utf-8");
+      } catch {
+        continue;
+      }
+      if (!isSeedNodeMarkdown(content)) continue;
+      const title = pickFrontmatterTitle(content);
+      if (title) titles.add(normalizeTitle(title));
+    }
+  }
+  return titles;
+}
+function frontmatterOf(content) {
+  if (!content.startsWith("---")) return null;
+  const end = content.indexOf("\n---", 3);
+  return end === -1 ? content : content.slice(0, end);
+}
+function isSeedNodeMarkdown(content) {
+  const frontmatter = frontmatterOf(content);
+  return frontmatter !== null && /^created_by:\s*["']?seed["']?\s*$/m.test(frontmatter);
+}
+function pickFrontmatterTitle(content) {
+  const frontmatter = frontmatterOf(content);
+  const match = frontmatter?.match(/^title:[ \t]*(.*)$/m);
+  if (!match) return null;
+  const raw = match[1].trim();
+  if (raw.startsWith('"')) {
+    try {
+      return String(JSON.parse(raw));
+    } catch {
+      return raw.slice(1, raw.endsWith('"') ? -1 : void 0).replace(/\\"/g, '"');
+    }
+  }
+  return raw;
+}
+async function serverSeedTitles(opts) {
+  const res = await apiRequest({
+    method: "GET",
+    path: "/compound/memory/nodes?created_by=seed&status=active&limit=100",
+    serviceUrl: opts.serviceUrl,
+    token: opts.token,
+    verbose: opts.verbose,
+    cmd: "memory_seed"
+  });
+  if (!res.ok || !Array.isArray(res.data.nodes)) return null;
+  const titles = /* @__PURE__ */ new Set();
+  for (const n of res.data.nodes) if (typeof n?.title === "string") titles.add(normalizeTitle(n.title));
+  return titles;
+}
 function renderNodeMarkdown(candidate, nodeId, createdAt) {
   const fm = [
     "---",
@@ -23894,14 +23961,14 @@ function renderNodeMarkdown(candidate, nodeId, createdAt) {
 }
 async function runSeed(opts) {
   if (!(0, import_node_fs42.existsSync)(STANDARD_FILE)) {
-    return { created: 0, failed: 0, skipped: "no_standard", candidates: [] };
+    return { created: 0, existing: 0, failed: 0, skipped: "no_standard", candidates: [] };
   }
   let standardDoc;
   try {
     const raw = await (0, import_promises15.readFile)(STANDARD_FILE, "utf-8");
     standardDoc = (0, import_yaml4.parse)(raw);
   } catch {
-    return { created: 0, failed: 0, skipped: "no_standard", candidates: [] };
+    return { created: 0, existing: 0, failed: 0, skipped: "no_standard", candidates: [] };
   }
   const knowledgeSpec = standardDoc.knowledge_spec ?? {};
   let readmeContent;
@@ -23934,19 +24001,33 @@ async function runSeed(opts) {
     claudeMdContent
   });
   if (candidates2.length === 0) {
-    return { created: 0, failed: 0, skipped: "no_candidates", candidates: [] };
+    return { created: 0, existing: 0, failed: 0, skipped: "no_candidates", candidates: [] };
   }
-  const overviewPath = (0, import_node_path32.join)(MEMORY_DIR, "domain", "project-overview.md");
-  if ((0, import_node_fs42.existsSync)(overviewPath) && !opts.force) {
-    return { created: 0, failed: 0, skipped: "already_seeded", candidates: candidates2 };
+  let toPost = candidates2;
+  if (!opts.force) {
+    const local = await localSeedTitles();
+    toPost = toPost.filter((c) => !local.has(normalizeTitle(c.title)));
+    if (toPost.length === 0) {
+      return { created: 0, existing: 0, failed: 0, skipped: "already_seeded", candidates: candidates2 };
+    }
+    if (!opts.dryRun) {
+      const remote = await serverSeedTitles(opts);
+      if (remote) {
+        toPost = toPost.filter((c) => !remote.has(normalizeTitle(c.title)));
+        if (toPost.length === 0) {
+          return { created: 0, existing: 0, failed: 0, skipped: "already_seeded", candidates: candidates2 };
+        }
+      }
+    }
   }
   if (opts.dryRun) {
-    return { created: 0, failed: 0, skipped: null, candidates: candidates2 };
+    return { created: 0, existing: 0, failed: 0, skipped: null, candidates: candidates2 };
   }
   const createdAt = (/* @__PURE__ */ new Date()).toISOString();
   let created = 0;
+  let existing = 0;
   let failed = 0;
-  for (const c of candidates2) {
+  for (const c of toPost) {
     const res = await apiRequest({
       method: "POST",
       path: "/compound/memory/nodes",
@@ -23978,17 +24059,26 @@ async function runSeed(opts) {
       failed++;
       continue;
     }
+    const deduplicated = res.data.deduplicated === true;
+    if (deduplicated && (0, import_node_fs42.existsSync)(targetPath)) {
+      existing++;
+      continue;
+    }
+    const content = typeof res.data.content === "string" && res.data.content.length > 0 ? res.data.content : renderNodeMarkdown(c, nodeId, createdAt);
     try {
       await (0, import_promises15.mkdir)((0, import_node_path32.dirname)(targetPath), { recursive: true });
-      await (0, import_promises15.writeFile)(targetPath, renderNodeMarkdown(c, nodeId, createdAt));
-      created++;
-      opts.onCreated?.(nodeId, filePathRel, c);
+      await (0, import_promises15.writeFile)(targetPath, content);
+      if (deduplicated) existing++;
+      else {
+        created++;
+        opts.onCreated?.(nodeId, filePathRel, c);
+      }
     } catch (err) {
       opts.onFailed?.(c, `Server accepted "${c.title}" but couldn't write local file: ${err.message}`);
       failed++;
     }
   }
-  return { created, failed, skipped: null, candidates: candidates2 };
+  return { created, existing, failed, skipped: null, candidates: candidates2 };
 }
 
 // src/commands/analyze/phases/08-memory-manifest.ts
@@ -24017,12 +24107,15 @@ async function memoryManifest(run2) {
             force: false,
             dryRun: false
           });
-          if (seedResult.created > 0) {
-            (0, import_node_fs43.writeFileSync)(seedMarker, `${(/* @__PURE__ */ new Date()).toISOString()} created=${seedResult.created}
+          if (seedResult.created > 0 || seedResult.existing > 0) {
+            (0, import_node_fs43.writeFileSync)(seedMarker, `${(/* @__PURE__ */ new Date()).toISOString()} created=${seedResult.created} existing=${seedResult.existing}
 `);
-            autoSeedNotice = `Seeded ${seedResult.created} knowledge node(s) from your existing Standard (one-time).`;
+            if (seedResult.created > 0) {
+              autoSeedNotice = `Seeded ${seedResult.created} knowledge node(s) from your existing Standard (one-time).`;
+            }
             logEvent("auto_seed_ran", {
               created: seedResult.created,
+              existing: seedResult.existing,
               failed: seedResult.failed
             });
           } else if (seedResult.skipped === "already_seeded") {
@@ -28774,7 +28867,7 @@ function registerInitCommand(program2) {
         ...telemetryChoice ? { telemetry: telemetryChoice } : {},
         init: {
           completed_at: (/* @__PURE__ */ new Date()).toISOString(),
-          cli_version: true ? "0.33.2" : "dev"
+          cli_version: true ? "0.33.3" : "dev"
         }
       });
     } catch (err) {
@@ -29400,7 +29493,7 @@ function registerMemoryCommand(program2) {
       process.exit(0);
     }
     if (result.skipped === "already_seeded") {
-      printInfo("Memory graph already seeded (.verity/memory/domain/project-overview.md exists). Use --force to re-seed.");
+      printInfo("Memory graph already seeded \u2014 this project has seed nodes (locally or on the server). Use --force to re-materialize them.");
       process.exit(0);
     }
     if (opts.dryRun) {
@@ -29411,10 +29504,11 @@ function registerMemoryCommand(program2) {
       process.exit(0);
     }
     console.log("");
+    const existingNote = result.existing > 0 ? ` ${result.existing} already existed on the server and were not duplicated.` : "";
     if (result.failed === 0) {
-      printInfo(`Seeded ${result.created} knowledge node(s) from the Standard into .verity/memory/.`);
+      printInfo(`Seeded ${result.created} knowledge node(s) from the Standard into .verity/memory/.${existingNote}`);
     } else {
-      printWarn(`Seeded ${result.created} node(s); ${result.failed} failed. See messages above.`);
+      printWarn(`Seeded ${result.created} node(s); ${result.failed} failed.${existingNote} See messages above.`);
     }
     process.exit(result.failed === 0 ? 0 : 1);
   });
@@ -29696,8 +29790,8 @@ function registerTelemetryCommands(program2) {
 }
 
 // src/cli.ts
-program.name("verity").description("CLI for Verity quality gate service").version("0.33.2").option("--token <token>", "Override authentication token").option("--service-url <url>", "Override service URL").option("--verbose", "Log HTTP requests/responses to stderr").hook("preAction", async (_thisCommand, actionCommand) => {
-  installStderrLog(actionCommand.name(), process.argv.slice(2), "0.33.2");
+program.name("verity").description("CLI for Verity quality gate service").version("0.33.3").option("--token <token>", "Override authentication token").option("--service-url <url>", "Override service URL").option("--verbose", "Log HTTP requests/responses to stderr").hook("preAction", async (_thisCommand, actionCommand) => {
+  installStderrLog(actionCommand.name(), process.argv.slice(2), "0.33.3");
   setUserNamedServiceUrl(program.opts().serviceUrl);
   try {
     await foldLegacyLocalCredential();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codacy/verity-cli",
-  "version": "0.33.2",
+  "version": "0.33.3",
   "description": "CLI for Verity quality gate service",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://verity.md",