@mmnto/cli 1.101.1 → 1.102.0

package/dist/commands/shield-generated.test.js

@@ -0,0 +1,323 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { cleanTmpDir } from '../test-utils.js';
+import { buildGeneratedArtifactSection, classifyGeneratedArtifacts, DEFAULT_GENERATED_ARTIFACT_GLOBS, formatGeneratedArtifactLine, gitattributesPatternToGlob, hashDiffSection, readGitattributesGeneratedPatterns, splitDiffIntoFileSections, } from './shield-generated.js';
+// ─── Diff builders ──────────────────────────────────────
+/** A minimal modified-file (regenerated) diff section. */
+function modifiedSection(file, added = 1, removed = 1) {
+    const plus = Array.from({ length: added }, (_, i) => `+added-${i}`).join('\n');
+    const minus = Array.from({ length: removed }, (_, i) => `-removed-${i}`).join('\n');
+    return [
+        `diff --git a/${file} b/${file}`,
+        `index 1111111..2222222 100644`,
+        `--- a/${file}`,
+        `+++ b/${file}`,
+        `@@ -1,${removed} +1,${added} @@`,
+        minus,
+        plus,
+        '',
+    ].join('\n');
+}
+function addedSection(file) {
+    return [
+        `diff --git a/${file} b/${file}`,
+        `new file mode 100644`,
+        `index 0000000..3333333`,
+        `--- /dev/null`,
+        `+++ b/${file}`,
+        `@@ -0,0 +1,2 @@`,
+        `+line one`,
+        `+line two`,
+        '',
+    ].join('\n');
+}
+function deletedSection(file) {
+    return [
+        `diff --git a/${file} b/${file}`,
+        `deleted file mode 100644`,
+        `index 4444444..0000000`,
+        `--- a/${file}`,
+        `+++ /dev/null`,
+        `@@ -1,1 +0,0 @@`,
+        `-only line`,
+        '',
+    ].join('\n');
+}
+function binarySection(file) {
+    return [
+        `diff --git a/${file} b/${file}`,
+        `index 5555555..6666666 100644`,
+        `Binary files a/${file} and b/${file} differ`,
+        '',
+    ].join('\n');
+}
+// ─── splitDiffIntoFileSections ──────────────────────────
+describe('splitDiffIntoFileSections', () => {
+    it('reconstructs the input exactly when sections are joined', () => {
+        const diff = modifiedSection('src/a.ts') + modifiedSection('src/b.ts');
+        const sections = splitDiffIntoFileSections(diff);
+        expect(sections.map((s) => s.section).join('')).toBe(diff);
+    });
+    it('extracts the destination path of each section', () => {
+        const diff = modifiedSection('src/a.ts') + addedSection('dist/out.js');
+        const sections = splitDiffIntoFileSections(diff);
+        expect(sections.map((s) => s.file)).toEqual(['src/a.ts', 'dist/out.js']);
+    });
+    it('handles quoted (spaced) paths', () => {
+        const diff = [
+            'diff --git "a/my file.ts" "b/my file.ts"',
+            '--- "a/my file.ts"',
+            '+++ "b/my file.ts"',
+            '@@ -1 +1 @@',
+            '-a',
+            '+b',
+            '',
+        ].join('\n');
+        const sections = splitDiffIntoFileSections(diff);
+        expect(sections[0]?.file).toBe('my file.ts');
+    });
+    it('returns an empty array for an empty diff', () => {
+        expect(splitDiffIntoFileSections('')).toEqual([]);
+    });
+    it('parses a newline-less section (truncated diff tail) without truncating the filename', () => {
+        // GCA round on #2443: indexOf('\n') === -1 previously fed slice(0, -1),
+        // chopping the final character and breaking the $-anchored path match.
+        const sections = splitDiffIntoFileSections('diff --git a/dist/out.js b/dist/out.js');
+        expect(sections).toHaveLength(1);
+        expect(sections[0]?.file).toBe('dist/out.js');
+    });
+});
+// ─── hashDiffSection ────────────────────────────────────
+describe('hashDiffSection', () => {
+    it('is deterministic and 12 hex chars', () => {
+        const section = modifiedSection('pnpm-lock.yaml');
+        const h1 = hashDiffSection(section);
+        const h2 = hashDiffSection(section);
+        expect(h1).toBe(h2);
+        expect(h1).toMatch(/^[0-9a-f]{12}$/);
+    });
+    it('differs when the section content differs', () => {
+        expect(hashDiffSection(modifiedSection('a', 1, 1))).not.toBe(hashDiffSection(modifiedSection('a', 2, 1)));
+    });
+});
+// ─── classifyGeneratedArtifacts ─────────────────────────
+describe('classifyGeneratedArtifacts', () => {
+    it('leaves the diff and files byte-identical when nothing matches', () => {
+        const diff = modifiedSection('src/foo.ts') + modifiedSection('src/bar.ts');
+        const changedFiles = ['src/foo.ts', 'src/bar.ts'];
+        const result = classifyGeneratedArtifacts({ diff, changedFiles });
+        expect(result.keptDiff).toBe(diff);
+        expect(result.keptFiles).toEqual(changedFiles);
+        expect(result.artifactFiles).toEqual([]);
+        expect(result.summaries).toEqual([]);
+    });
+    it('classifies a lockfile, strips its bytes, and keeps a summary', () => {
+        const diff = modifiedSection('pnpm-lock.yaml', 42, 13) + modifiedSection('src/foo.ts');
+        const changedFiles = ['pnpm-lock.yaml', 'src/foo.ts'];
+        const result = classifyGeneratedArtifacts({ diff, changedFiles });
+        expect(result.artifactFiles).toEqual(['pnpm-lock.yaml']);
+        expect(result.keptFiles).toEqual(['src/foo.ts']);
+        // The lockfile bytes are gone from the kept diff; the code file remains.
+        expect(result.keptDiff).not.toContain('pnpm-lock.yaml');
+        expect(result.keptDiff).toContain('src/foo.ts');
+        const summary = result.summaries[0];
+        expect(summary?.file).toBe('pnpm-lock.yaml');
+        expect(summary?.shape).toBe('regenerated');
+        expect(summary?.addedLines).toBe(42);
+        expect(summary?.removedLines).toBe(13);
+        expect(summary?.binary).toBe(false);
+        expect(summary?.hash).toMatch(/^[0-9a-f]{12}$/);
+    });
+    it('classifies nested build output (**/dist/**) and *.wasm and compiled-rules.json', () => {
+        const files = [
+            'packages/cli/dist/index.js',
+            'src/pkg.wasm',
+            '.totem/compiled-rules.json',
+            'src/keep.ts',
+        ];
+        const diff = files.map((f) => modifiedSection(f)).join('');
+        const result = classifyGeneratedArtifacts({ diff, changedFiles: files });
+        expect(result.artifactFiles.sort()).toEqual(['.totem/compiled-rules.json', 'packages/cli/dist/index.js', 'src/pkg.wasm'].sort());
+        expect(result.keptFiles).toEqual(['src/keep.ts']);
+    });
+    it('detects added / deleted / regenerated change shapes', () => {
+        const diff = addedSection('dist/new.js') + deletedSection('dist/old.js') + modifiedSection('dist/mod.js');
+        const changedFiles = ['dist/new.js', 'dist/old.js', 'dist/mod.js'];
+        const result = classifyGeneratedArtifacts({ diff, changedFiles });
+        const byFile = Object.fromEntries(result.summaries.map((s) => [s.file, s.shape]));
+        expect(byFile['dist/new.js']).toBe('added');
+        expect(byFile['dist/old.js']).toBe('deleted');
+        expect(byFile['dist/mod.js']).toBe('regenerated');
+    });
+    it('counts hunk content beginning with ++/-- (e.g. `+++i;`) and still skips the `+++ `/`--- ` headers', () => {
+        // GCA round on #2443: a bare `+++` prefix check swallowed real added lines
+        // like C's `++i;` (rendered `+++i;` in a hunk). Headers always carry a
+        // space (`+++ b/...`, `+++ /dev/null`) — that is the discriminator.
+        const section = [
+            'diff --git a/dist/gen.c b/dist/gen.c',
+            'index 1111111..2222222 100644',
+            '--- a/dist/gen.c',
+            '+++ b/dist/gen.c',
+            '@@ -1,2 +1,2 @@',
+            '---x;',
+            '+++i;',
+            '',
+        ].join('\n');
+        const result = classifyGeneratedArtifacts({
+            diff: section,
+            changedFiles: ['dist/gen.c'],
+            generatedGlobs: [...DEFAULT_GENERATED_ARTIFACT_GLOBS],
+            excludeGlobs: [],
+        });
+        expect(result.summaries).toHaveLength(1);
+        expect(result.summaries[0]?.addedLines).toBe(1);
+        expect(result.summaries[0]?.removedLines).toBe(1);
+    });
+    it('marks a binary artifact and reports no line counts', () => {
+        const diff = binarySection('src/pkg.wasm');
+        const result = classifyGeneratedArtifacts({ diff, changedFiles: ['src/pkg.wasm'] });
+        const summary = result.summaries[0];
+        expect(summary?.binary).toBe(true);
+        expect(summary?.addedLines).toBe(0);
+        expect(summary?.removedLines).toBe(0);
+    });
+    it('honors an un-mark (exclude) glob — a matched default is NOT generated', () => {
+        const diff = modifiedSection('pnpm-lock.yaml');
+        const result = classifyGeneratedArtifacts({
+            diff,
+            changedFiles: ['pnpm-lock.yaml'],
+            excludeGlobs: ['**/pnpm-lock.yaml'],
+        });
+        expect(result.artifactFiles).toEqual([]);
+        expect(result.keptDiff).toBe(diff);
+    });
+    it('honors an added generated glob passed by the caller', () => {
+        const diff = modifiedSection('dashboards/report.html');
+        const result = classifyGeneratedArtifacts({
+            diff,
+            changedFiles: ['dashboards/report.html'],
+            generatedGlobs: [...DEFAULT_GENERATED_ARTIFACT_GLOBS, '**/dashboards/**'],
+        });
+        expect(result.artifactFiles).toEqual(['dashboards/report.html']);
+    });
+    it('produces an all-generated (empty kept diff) result', () => {
+        const diff = modifiedSection('pnpm-lock.yaml') + modifiedSection('yarn.lock');
+        const result = classifyGeneratedArtifacts({
+            diff,
+            changedFiles: ['pnpm-lock.yaml', 'yarn.lock'],
+        });
+        expect(result.keptDiff.trim()).toBe('');
+        expect(result.keptFiles).toEqual([]);
+        expect(result.summaries).toHaveLength(2);
+    });
+});
+// ─── gitattributesPatternToGlob ─────────────────────────
+describe('gitattributesPatternToGlob', () => {
+    it('strips a leading root-anchor slash', () => {
+        expect(gitattributesPatternToGlob('/dist/bundle.js')).toBe('dist/bundle.js');
+    });
+    it('expands a trailing directory slash to a recursive glob', () => {
+        expect(gitattributesPatternToGlob('generated/')).toBe('generated/**');
+    });
+    it('passes a bare extension pattern through unchanged', () => {
+        expect(gitattributesPatternToGlob('*.lock')).toBe('*.lock');
+    });
+});
+// ─── readGitattributesGeneratedPatterns ─────────────────
+describe('readGitattributesGeneratedPatterns', () => {
+    let dir;
+    afterEach(() => {
+        cleanTmpDir(dir);
+        dir = undefined;
+    });
+    it('returns empty pattern lists when .gitattributes is absent', () => {
+        dir = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-gitattr-'));
+        expect(readGitattributesGeneratedPatterns(dir)).toEqual({ generated: [], notGenerated: [] });
+    });
+    it('parses generated (true) and un-mark (false) markers, skipping comments', () => {
+        dir = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-gitattr-'));
+        fs.writeFileSync(path.join(dir, '.gitattributes'), [
+            '# a comment',
+            'dashboards/** linguist-generated',
+            'src/vendor.js linguist-generated=true',
+            'src/hand-written.min.js linguist-generated=false',
+            'legacy/build.js -linguist-generated',
+            '*.ts text',
+            '',
+        ].join('\n'), 'utf-8');
+        const result = readGitattributesGeneratedPatterns(dir);
+        expect(result.generated).toContain('dashboards/**');
+        expect(result.generated).toContain('src/vendor.js');
+        expect(result.notGenerated).toContain('src/hand-written.min.js');
+        expect(result.notGenerated).toContain('legacy/build.js');
+        // A non-generated attribute line contributes nothing.
+        expect(result.generated).not.toContain('*.ts');
+    });
+    it('wires .gitattributes patterns end-to-end through classification', () => {
+        dir = fs.mkdtempSync(path.join(os.tmpdir(), 'totem-gitattr-'));
+        fs.writeFileSync(path.join(dir, '.gitattributes'), 
+        // Un-mark a default match AND add a repo-specific generated dir.
+        ['**/pnpm-lock.yaml linguist-generated=false', 'dashboards/ linguist-generated', ''].join('\n'), 'utf-8');
+        const gitattr = readGitattributesGeneratedPatterns(dir);
+        const diff = modifiedSection('pnpm-lock.yaml') + modifiedSection('dashboards/x.html');
+        const result = classifyGeneratedArtifacts({
+            diff,
+            changedFiles: ['pnpm-lock.yaml', 'dashboards/x.html'],
+            generatedGlobs: [...DEFAULT_GENERATED_ARTIFACT_GLOBS, ...gitattr.generated],
+            excludeGlobs: gitattr.notGenerated,
+        });
+        // pnpm-lock.yaml un-marked → kept; dashboards/ added → excluded.
+        expect(result.keptFiles).toContain('pnpm-lock.yaml');
+        expect(result.artifactFiles).toEqual(['dashboards/x.html']);
+    });
+});
+// ─── rendering ──────────────────────────────────────────
+describe('formatGeneratedArtifactLine', () => {
+    it('renders shape, size delta, and hash', () => {
+        const line = formatGeneratedArtifactLine({
+            file: 'pnpm-lock.yaml',
+            shape: 'regenerated',
+            addedLines: 42,
+            removedLines: 13,
+            binary: false,
+            hash: 'abcdef012345',
+        });
+        expect(line).toBe('- pnpm-lock.yaml — regenerated, +42/-13 lines, hash abcdef012345');
+    });
+    it('renders "binary" instead of line counts for a binary artifact', () => {
+        const line = formatGeneratedArtifactLine({
+            file: 'src/pkg.wasm',
+            shape: 'regenerated',
+            addedLines: 0,
+            removedLines: 0,
+            binary: true,
+            hash: 'abcdef012345',
+        });
+        expect(line).toContain('binary');
+        expect(line).not.toContain('lines');
+    });
+});
+describe('buildGeneratedArtifactSection', () => {
+    it('returns an empty string when there are no artifacts', () => {
+        expect(buildGeneratedArtifactSection([])).toBe('');
+    });
+    it('labels the block as a summary, not diff content (#2329 guard)', () => {
+        const section = buildGeneratedArtifactSection([
+            {
+                file: 'pnpm-lock.yaml',
+                shape: 'regenerated',
+                addedLines: 1,
+                removedLines: 1,
+                binary: false,
+                hash: 'abcdef012345',
+            },
+        ]);
+        expect(section).toContain('EXCLUDED GENERATED ARTIFACTS');
+        expect(section).toContain('NOT DIFF CONTENT');
+        expect(section).toContain('<generated_artifacts_summary>');
+        expect(section).toContain('- pnpm-lock.yaml — regenerated');
+    });
+});
+//# sourceMappingURL=shield-generated.test.js.map

package/dist/commands/shield-generated.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shield-generated.test.js","sourceRoot":"","sources":["../../src/commands/shield-generated.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/shield.d.ts

@@ -9,16 +9,38 @@ interface RetrievedContext {
     lessons: SearchResult[];
 }
 export declare function buildFileContext(changedFiles: string[], cwd: string, maxLines: number, maxChars: number): Promise<string>;
-export declare function assemblePrompt(diff: string, changedFiles: string[], context: RetrievedContext, systemPrompt: string, smartHints?: string[], fileContext?: string): string;
-export declare function assembleStructuralPrompt(diff: string, changedFiles: string[], systemPrompt: string, smartHints?: string[], fileContext?: string): string;
+export declare function assemblePrompt(diff: string, changedFiles: string[], context: RetrievedContext, systemPrompt: string, smartHints?: string[], fileContext?: string, generatedArtifactSummary?: string): string;
+export declare function assembleStructuralPrompt(diff: string, changedFiles: string[], systemPrompt: string, smartHints?: string[], fileContext?: string, generatedArtifactSummary?: string): string;
 export declare function parseVerdict(content: string): {
     pass: boolean;
     reason: string;
 } | null;
+export type StructuredVerdictExtractionLayer = 'xml' | 'fence' | 'bare-json';
+export type StructuredVerdictExtractionFailureCause = 'empty-output' | 'no-candidate' | 'invalid-json' | 'schema-invalid';
+export interface StructuredVerdictExtractionAttempt {
+    layer: StructuredVerdictExtractionLayer;
+    cause: Extract<StructuredVerdictExtractionFailureCause, 'invalid-json' | 'schema-invalid'>;
+    /** Bounded validation summaries; candidate/output text is never retained here. */
+    issues?: string[];
+}
+export type StructuredVerdictExtractionResult = {
+    ok: true;
+    verdict: ShieldStructuredVerdict;
+    layer: StructuredVerdictExtractionLayer;
+} | {
+    ok: false;
+    cause: StructuredVerdictExtractionFailureCause;
+    attempts: StructuredVerdictExtractionAttempt[];
+};
+/**
+ * Three-layer JSON extraction with bounded, candidate-free failure diagnostics.
+ * A schema-invalid candidate takes precedence over malformed candidates because
+ * it is the most semantically advanced failure reached by the cascade.
+ */
+export declare function extractStructuredVerdictDetailed(content: string): StructuredVerdictExtractionResult;
 /**
- * Three-layer JSON extraction from LLM plain-text response.
- * Layer 1: XML tags, Layer 2: markdown code fences, Layer 3: bare JSON.
- * Returns null if all layers fail (caller falls back to V1 regex parseVerdict).
+ * Compatibility wrapper for callers that only need the parsed verdict.
+ * Returns null when all XML, fenced, and bare-JSON layers fail.
  */
 export declare function extractStructuredVerdict(content: string): ShieldStructuredVerdict | null;
 /**

package/dist/commands/shield.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shield.d.ts","sourceRoot":"","sources":["../../src/commands/shield.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shield.d.ts","sourceRoot":"","sources":["../../src/commands/shield.ts"],"names":[],"mappings":"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"}

package/dist/commands/shield.js

@@ -64,7 +64,7 @@ export async function buildFileContext(changedFiles, cwd, maxLines, maxChars) {
     return `\n=== FILE CONTEXT (unchanged code for reference) ===\n${entries.join('\n\n')}`;
 }
 // ─── Prompt assembly ────────────────────────────────────
-export function assemblePrompt(diff, changedFiles, context, systemPrompt, smartHints, fileContext) {
+export function assemblePrompt(diff, changedFiles, context, systemPrompt, smartHints, fileContext, generatedArtifactSummary) {
     const sections = [systemPrompt];
     // Diff section
     sections.push('=== DIFF ===');
@@ -76,6 +76,11 @@ export function assemblePrompt(diff, changedFiles, context, systemPrompt, smartH
     else {
         sections.push(wrapXml('git_diff', diff));
     }
+    // Excluded generated-artifact summary (mmnto-ai/totem#2398) — bytes excluded,
+    // signal preserved. Clearly labelled as a summary, not diff content (#2329).
+    if (generatedArtifactSummary) {
+        sections.push(generatedArtifactSummary);
+    }
     // File context — full source for small changed files
     if (fileContext) {
         sections.push(fileContext);
@@ -108,7 +113,7 @@ export function assemblePrompt(diff, changedFiles, context, systemPrompt, smartH
     return sections.join('\n');
 }
 // ─── Structural prompt assembly ──────────────────────────
-export function assembleStructuralPrompt(diff, changedFiles, systemPrompt, smartHints, fileContext) {
+export function assembleStructuralPrompt(diff, changedFiles, systemPrompt, smartHints, fileContext, generatedArtifactSummary) {
     const sections = [systemPrompt];
     sections.push('=== DIFF ===');
     if (changedFiles.length > 0) {
@@ -121,6 +126,11 @@ export function assembleStructuralPrompt(diff, changedFiles, systemPrompt, smart
     else {
         sections.push(wrapXml('git_diff', diff));
     }
+    // Excluded generated-artifact summary (mmnto-ai/totem#2398) — bytes excluded,
+    // signal preserved. Clearly labelled as a summary, not diff content (#2329).
+    if (generatedArtifactSummary) {
+        sections.push(generatedArtifactSummary);
+    }
     // File context — full source for small changed files
     if (fileContext) {
         sections.push(fileContext);
@@ -142,54 +152,84 @@ export function parseVerdict(content) {
         return null;
     return { pass: match[1] === 'PASS', reason: match[2].trim() };
 }
-// ─── V2 Structured verdict parsing ───────────────────
+const MAX_EXTRACTION_ISSUES = 4;
+const MAX_EXTRACTION_ISSUE_CHARS = 160;
+function summarizeValidationIssues(issues) {
+    return issues.slice(0, MAX_EXTRACTION_ISSUES).map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join('.') : '<root>';
+        return `${path}: ${issue.code}`.slice(0, MAX_EXTRACTION_ISSUE_CHARS);
+    });
+}
+function tryStructuredVerdictCandidate(layer, candidate) {
+    let parsed;
+    try {
+        parsed = JSON.parse(candidate);
+        // totem-context: malformed candidates are expected during the extraction cascade and are converted into the typed invalid-json result below.
+    }
+    catch {
+        return { ok: false, attempt: { layer, cause: 'invalid-json' } };
+    }
+    const result = ShieldStructuredVerdictSchema.safeParse(parsed);
+    if (result.success)
+        return { ok: true, verdict: result.data, layer };
+    return {
+        ok: false,
+        attempt: {
+            layer,
+            cause: 'schema-invalid',
+            issues: summarizeValidationIssues(result.error.issues),
+        },
+    };
+}
 /**
- * Three-layer JSON extraction from LLM plain-text response.
- * Layer 1: XML tags, Layer 2: markdown code fences, Layer 3: bare JSON.
- * Returns null if all layers fail (caller falls back to V1 regex parseVerdict).
+ * Three-layer JSON extraction with bounded, candidate-free failure diagnostics.
+ * A schema-invalid candidate takes precedence over malformed candidates because
+ * it is the most semantically advanced failure reached by the cascade.
  */
-export function extractStructuredVerdict(content) {
-    // Layer 1 — XML tags (primary)
+export function extractStructuredVerdictDetailed(content) {
+    if (content.trim().length === 0)
+        return { ok: false, cause: 'empty-output', attempts: [] };
+    const attempts = [];
+    const tryCandidate = (layer, candidate) => {
+        const result = tryStructuredVerdictCandidate(layer, candidate);
+        if (result.ok)
+            return result.verdict;
+        attempts.push(result.attempt);
+        return null;
+    };
     const xmlMatch = content.match(/<shield_verdict>([\s\S]*?)<\/shield_verdict>/);
     if (xmlMatch) {
-        try {
-            const parsed = JSON.parse(xmlMatch[1]);
-            const result = ShieldStructuredVerdictSchema.safeParse(parsed);
-            if (result.success)
-                return result.data;
-        }
-        catch {
-            // Move to next layer
-        }
+        const verdict = tryCandidate('xml', xmlMatch[1]);
+        if (verdict)
+            return { ok: true, verdict, layer: 'xml' };
     }
-    // Layer 2 — Markdown code fences (fallback)
     const fenceMatch = content.match(/(?:```|~~~)(?:json)?\s*\n([\s\S]*?)\n\s*(?:```|~~~)/);
     if (fenceMatch) {
-        try {
-            const parsed = JSON.parse(fenceMatch[1]);
-            const result = ShieldStructuredVerdictSchema.safeParse(parsed);
-            if (result.success)
-                return result.data;
-        }
-        catch {
-            // Move to next layer
-        }
+        const verdict = tryCandidate('fence', fenceMatch[1]);
+        if (verdict)
+            return { ok: true, verdict, layer: 'fence' };
     }
-    // Layer 3 — Bare JSON (last resort, guarded by "findings" keyword)
     const firstBrace = content.indexOf('{');
     const lastBrace = content.lastIndexOf('}');
     if (firstBrace !== -1 && lastBrace > firstBrace && content.includes('"findings"')) {
-        try {
-            const parsed = JSON.parse(content.slice(firstBrace, lastBrace + 1));
-            const result = ShieldStructuredVerdictSchema.safeParse(parsed);
-            if (result.success)
-                return result.data;
-        }
-        catch {
-            // All layers exhausted
-        }
-    }
-    return null;
+        const verdict = tryCandidate('bare-json', content.slice(firstBrace, lastBrace + 1));
+        if (verdict)
+            return { ok: true, verdict, layer: 'bare-json' };
+    }
+    if (attempts.length === 0)
+        return { ok: false, cause: 'no-candidate', attempts };
+    const cause = attempts.some((attempt) => attempt.cause === 'schema-invalid')
+        ? 'schema-invalid'
+        : 'invalid-json';
+    return { ok: false, cause, attempts };
+}
+/**
+ * Compatibility wrapper for callers that only need the parsed verdict.
+ * Returns null when all XML, fenced, and bare-JSON layers fail.
+ */
+export function extractStructuredVerdict(content) {
+    const result = extractStructuredVerdictDetailed(content);
+    return result.ok ? result.verdict : null;
 }
 /**
  * Deterministic pass/fail based on findings.
@@ -898,6 +938,7 @@ export async function shieldCommand(options) {
     const { filterDiffByPatterns, getDiffForReview } = await import('../git.js');
     const { classifyChangedFiles } = await import('./shield-classify.js');
     const { extractShieldContextAnnotations, extractShieldHints } = await import('./shield-hints.js');
+    const { DEFAULT_GENERATED_ARTIFACT_GLOBS, buildGeneratedArtifactSection, classifyGeneratedArtifacts, formatGeneratedArtifactLine, readGitattributesGeneratedPatterns, } = await import('./shield-generated.js');
     // mmnto-ai/totem#1714: --estimate is the deterministic-rule pre-flight
     // path. Reject incompatible flag combinations BEFORE any other
     // validation (e.g. the --override length check below) so the user-
@@ -1047,6 +1088,40 @@ export async function shieldCommand(options) {
             selectorForm: diffResult.selectorForm,
         };
     }
+    // Stage 0.5: Exclude generated-artifact BYTES from the synthesis input
+    // (mmnto-ai/totem#2398). Generated artifacts (lockfiles, compiled-rules.json,
+    // dist/**, *.wasm, regenerated dashboards) burn review-context tokens on bytes
+    // no reviewer should read. Classify them by default (seeded globs + honor
+    // `.gitattributes` `linguist-generated`), strip their diff sections, and inject
+    // a per-file SUMMARY instead of a silent drop — path, change shape, size delta,
+    // semantic hash — so the "this regenerated" signal survives without the bytes.
+    let generatedArtifactSummary;
+    {
+        const gitattr = readGitattributesGeneratedPatterns(cwd);
+        const generated = classifyGeneratedArtifacts({
+            diff,
+            changedFiles,
+            generatedGlobs: [...DEFAULT_GENERATED_ARTIFACT_GLOBS, ...gitattr.generated],
+            excludeGlobs: gitattr.notGenerated,
+        });
+        if (generated.summaries.length > 0) {
+            log.info(DISPLAY_TAG, `Excluded ${generated.summaries.length} generated-artifact file(s) from the review payload (summarized, not dropped):`);
+            for (const summary of generated.summaries) {
+                log.dim(DISPLAY_TAG, formatGeneratedArtifactLine(summary));
+            }
+            diff = generated.keptDiff;
+            changedFiles = generated.keptFiles;
+            generatedArtifactSummary = buildGeneratedArtifactSection(generated.summaries);
+            // All changed files were generated artifacts — nothing left to review.
+            // Deterministic PASS: the summary was already surfaced above (never a
+            // silent skip). The artifacts' correctness is a gate concern, not the LLM's.
+            if (!diff.trim()) {
+                log.info(DISPLAY_TAG, 'Deterministic fast-path: all changed files are generated artifacts');
+                await writeReviewedContentHash(cwd, config.totemDir, configRoot, config.review.sourceExtensions);
+                return;
+            }
+        }
+    }
     // Stage 1: Classify files — fast-path for non-code-only diffs
     const classification = classifyChangedFiles(changedFiles);
     if (classification.allNonCode) {
@@ -1109,7 +1184,7 @@ export async function shieldCommand(options) {
     if (options.mode === 'structural') {
         log.info(DISPLAY_TAG, 'Running structural review (context-blind, no Totem knowledge)...');
         const systemPrompt = getSystemPrompt('shield-structural', STRUCTURAL_SYSTEM_PROMPT_V2, cwd, config.totemDir);
-        const prompt = assembleStructuralPrompt(filteredDiff, filteredFiles, systemPrompt, smartHints, fileContext);
+        const prompt = assembleStructuralPrompt(filteredDiff, filteredFiles, systemPrompt, smartHints, fileContext, generatedArtifactSummary);
         log.dim(DISPLAY_TAG, `Prompt: ${(prompt.length / 1024).toFixed(0)}KB`);
         const content = await runOrchestrator({
             prompt,
@@ -1152,7 +1227,7 @@ export async function shieldCommand(options) {
     if (codeBlindGuard.banner)
         log.warn(DISPLAY_TAG, codeBlindGuard.banner);
     // Assemble prompt — use filtered diff/files for LLM review
-    const prompt = assemblePrompt(filteredDiff, filteredFiles, context, codeBlindGuard.systemPrompt, smartHints, fileContext);
+    const prompt = assemblePrompt(filteredDiff, filteredFiles, context, codeBlindGuard.systemPrompt, smartHints, fileContext, generatedArtifactSummary);
     log.dim(DISPLAY_TAG, `Prompt: ${(prompt.length / 1024).toFixed(0)}KB`);
     // Grounded run artifact (mmnto-ai/totem#2100): always-on for the standard
     // review verdict path — every run is a future eval fixture. Per-item