clud-bug 0.6.18 → 0.6.19

package/lib/agents-md.js

@@ -86,6 +86,35 @@ export function upsertBlock(content, block) {
   return `${content}${sep}${block}\n`;
 }
 
+// 0.0.I.1 (v0.6.X): true if `content` has Claude Code's `@AGENTS.md`
+// @-import — the canonical AGENTS.md content gets eager-loaded.
+//
+// Matches at start-of-line (a literal `@AGENTS.md` mentioned in prose
+// won't fire; only the import directive does). Allows trailing space
+// (some editors trim it; some don't) and optional newline terminator.
+export function hasAgentsMdImport(content) {
+  if (typeof content !== 'string') return false;
+  return /^@AGENTS\.md\s*$/m.test(content);
+}
+
+// 0.0.I.1: strip a clud-bug block (markers + body) AND the blank line
+// that precedes it, if any. Used when an @AGENTS.md import is detected
+// — the AGENTS.md content covers the block, so keeping it in CLAUDE.md
+// (or any tool stub) is duplication.
+//
+// Returns the cleaned content. If no block exists, returns content
+// unchanged. Idempotent.
+export function removeBlock(content) {
+  if (typeof content !== 'string') return content;
+  // Strip the block. Match \n+ before the marker so we also eat the
+  // preceding blank line — otherwise we'd leave a "stub line + blank
+  // + block" structure as "stub line + blank line".
+  const re = new RegExp(
+    `\\n*${escapeRe(START_MARKER)}[\\s\\S]*?${escapeRe(END_MARKER)}\\n?`,
+  );
+  return content.replace(re, '');
+}
+
 function escapeRe(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
@@ -116,7 +145,7 @@ export async function applyToRepo(cwd, blockOpts = {}) {
     const full = join(cwd, path);
     if (!(await fileExists(full))) continue;
     const prior = await readFile(full, 'utf8');
-    const next = upsertBlock(prior, block);
+    const next = nextContentFor(prior, block);
     if (next !== prior) {
       await writeFile(full, next);
       touched.push(path);
@@ -132,7 +161,7 @@ export async function applyToRepo(cwd, blockOpts = {}) {
       if (!name.endsWith('.md')) continue;
       const full = join(cursorRulesDir, name);
       const prior = await readFile(full, 'utf8');
-      const next = upsertBlock(prior, block);
+      const next = nextContentFor(prior, block);
       if (next !== prior) {
         await writeFile(full, next);
         touched.push(`.cursor/rules/${name}`);
@@ -143,6 +172,18 @@ export async function applyToRepo(cwd, blockOpts = {}) {
   return { touched, created };
 }
 
+// 0.0.I.1: decide what content a TOUCH_IF_PRESENT file should have.
+// If it already imports AGENTS.md via Claude Code's @-syntax, skip the
+// block entirely (and clean up any pre-existing block — the content is
+// duplicated via @-import, so the AGENTS.md block is the only authority).
+// Otherwise, upsert as before.
+//
+// AGENTS.md itself is NOT routed through here — it always gets the
+// block (it's the canonical source).
+function nextContentFor(prior, block) {
+  return hasAgentsMdImport(prior) ? removeBlock(prior) : upsertBlock(prior, block);
+}
+
 function seedFile(name) {
   // When AGENTS.md doesn't exist (no logmind, no prior tooling), seed with a
   // minimal canonical header so the clud-bug block has context.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clud-bug",
-  "version": "0.6.18",
+  "version": "0.6.19",
   "description": "Skill-driven Claude PR review. Ship a brand-voice skill, get brand reviews. Each finding cites the skill that motivated it. CLI installs the workflow + a baseline kit; add more from skills.sh.",
   "homepage": "https://cludbug.dev",
   "bugs": "https://github.com/thrillmade/clud-bug/issues",

package/templates/workflow-py.yml.tmpl

@@ -156,6 +156,6 @@ jobs:
       # Strict-mode gate — composite action; see workflow.yml.tmpl for design notes.
       - name: Strict mode — fail check on critical findings
         if: success()
-        uses: thrillmade/clud-bug/.github/actions/strict-mode-gate@v0.6.18
+        uses: thrillmade/clud-bug/.github/actions/strict-mode-gate@v0.6.19
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}

package/templates/workflow-ts.yml.tmpl

@@ -156,6 +156,6 @@ jobs:
       # Strict-mode gate — composite action; see workflow.yml.tmpl for design notes.
       - name: Strict mode — fail check on critical findings
         if: success()
-        uses: thrillmade/clud-bug/.github/actions/strict-mode-gate@v0.6.18
+        uses: thrillmade/clud-bug/.github/actions/strict-mode-gate@v0.6.19
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}

package/templates/workflow.yml.tmpl

@@ -247,6 +247,6 @@ jobs:
       # Letting the action's own failure fail the check is louder and right.
       - name: Strict mode — fail check on critical findings
         if: success()
-        uses: thrillmade/clud-bug/.github/actions/strict-mode-gate@v0.6.18
+        uses: thrillmade/clud-bug/.github/actions/strict-mode-gate@v0.6.19
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}