@zigrivers/scaffold 3.28.0 → 3.29.0

package/dist/knowledge-freshness/audit-apply.test.js

@@ -0,0 +1,482 @@
+import { describe, it, expect } from 'vitest';
+import { applyVerdictToEntry } from './audit-apply.js';
+describe('applyVerdictToEntry', () => {
+    const baseEntry = `---
+name: x
+description: y
+topics: []
+volatility: fast-moving
+last-reviewed: null
+sources:
+  - url: https://x
+    hash: 'old'
+---
+
+## Summary
+
+## Deep Guidance
+
+Old content.
+`;
+    // Covers `baseEntry`'s single source so the round-2 F-002 guard (refuse to
+    // advance last-reviewed when the verdict does not cover every declared
+    // source) does not fire on tests that focus on heading or frontmatter
+    // behavior rather than source-coverage behavior.
+    const baseEntryChecked = [
+        { url: 'https://x', retrieved_at: '2026-05-24', content_hash: 'sha256:new', summary: '' },
+    ];
+    it('updates last-reviewed to verdict.audit_date', () => {
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'current', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [], preserve_warnings: [],
+        };
+        const out = applyVerdictToEntry(baseEntry, verdict);
+        // yaml.dump with JSON_SCHEMA emits the date unquoted (e.g. `last-reviewed: 2026-05-24`)
+        // — match that, since JSON_SCHEMA is what audit-apply uses to avoid Date-coercion (F-001).
+        expect(out).toContain('last-reviewed: 2026-05-24');
+    });
+    it('applies an insert kind by appending new text after the targeted section', () => {
+        const entry = `---
+name: x
+description: y
+topics: []
+---
+
+## Summary
+
+## OWASP Top 10
+
+The 2021 list.
+
+## Deep Guidance
+
+keep me
+`;
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'major-drift', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [
+                { location: '## OWASP Top 10', kind: 'insert',
+                    rationale: '', new_text: '> 2025 edition adds A11 Software Supply Chain Failures.' },
+            ],
+            preserve_warnings: [],
+        };
+        const out = applyVerdictToEntry(entry, verdict);
+        expect(out).toContain('## OWASP Top 10');
+        expect(out).toContain('The 2021 list.');
+        expect(out).toContain('2025 edition adds A11');
+        expect(out).toContain('## Deep Guidance');
+        expect(out).toContain('keep me');
+        // The insert must land between the OWASP section and the next H2,
+        // not after the entire file.
+        const idxOwasp = out.indexOf('## OWASP Top 10');
+        const idxInsert = out.indexOf('2025 edition');
+        const idxDeepGuidance = out.indexOf('## Deep Guidance');
+        expect(idxOwasp).toBeLessThan(idxInsert);
+        expect(idxInsert).toBeLessThan(idxDeepGuidance);
+    });
+    it('applies a replace proposed_change targeting "## Deep Guidance"', () => {
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'major-drift', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [
+                { location: '## Deep Guidance', kind: 'replace',
+                    rationale: '', new_text: '## Deep Guidance\n\nNew content with [source](https://x).\n' },
+            ],
+            preserve_warnings: [],
+        };
+        const out = applyVerdictToEntry(baseEntry, verdict);
+        expect(out).toContain('New content with');
+        expect(out).not.toContain('Old content.');
+    });
+    it('preserves the "## Deep Guidance" heading if a proposed_change tries to delete it', () => {
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'major-drift', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [
+                { location: '## Deep Guidance', kind: 'delete', rationale: '' },
+            ],
+            preserve_warnings: [],
+        };
+        expect(() => applyVerdictToEntry(baseEntry, verdict)).toThrow(/Deep Guidance/);
+    });
+    it('throws when a proposed_change.location does not match a heading (no silent last-reviewed advance)', () => {
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'major-drift', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [
+                { location: '## Nonexistent Heading', kind: 'replace',
+                    rationale: '', new_text: '## Nonexistent Heading\n\nx' },
+            ],
+            preserve_warnings: [],
+        };
+        expect(() => applyVerdictToEntry(baseEntry, verdict)).toThrow(/did not match/);
+    });
+    it('coverage is anchor-aware: two same-base sources with different anchors must both be checked', () => {
+        // Round-5 F-002: an entry with two sources at the same base URL but
+        // different anchors must require BOTH anchors in verdict.sources_checked.
+        // Without this, an audit that only fetched #a would falsely satisfy
+        // coverage for both #a and #b.
+        const entry = `---
+name: x
+description: y
+topics: []
+sources:
+  - url: https://x
+    anchor: '#a'
+    hash: 'old-a'
+  - url: https://x
+    anchor: '#b'
+    hash: 'old-b'
+---
+
+## Deep Guidance
+
+body
+`;
+        const verdictPartial = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'current',
+            sources_checked: [
+                { url: 'https://x#a', retrieved_at: '2026-05-24', content_hash: 'sha256:1', summary: '' },
+                // #b NOT checked
+            ],
+            findings: [], proposed_changes: [], preserve_warnings: [],
+        };
+        expect(() => applyVerdictToEntry(entry, verdictPartial)).toThrow(/missing entry source "https:\/\/x#b"/);
+        // Full coverage → passes.
+        const verdictFull = {
+            ...verdictPartial,
+            sources_checked: [
+                { url: 'https://x#a', retrieved_at: '2026-05-24', content_hash: 'sha256:1', summary: '' },
+                { url: 'https://x#b', retrieved_at: '2026-05-24', content_hash: 'sha256:2', summary: '' },
+            ],
+        };
+        expect(() => applyVerdictToEntry(entry, verdictFull)).not.toThrow();
+    });
+    it('does NOT advance last-reviewed on a superseded verdict (body still references old edition)', () => {
+        // MMR corroboration on Task 9 dry-run flagged: a "superseded" verdict
+        // typically only adds an edition-staleness notice — the body still claims
+        // the old taxonomy. Advancing last-reviewed would mark a known-stale
+        // entry as fresh, skipping it from the prefilter until cadence expires.
+        // Apply should preserve last-reviewed: null (or the prior value) so a
+        // human can re-review and produce a follow-up audit with `current` or
+        // `major-drift`.
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'superseded',
+            sources_checked: baseEntryChecked,
+            findings: [], proposed_changes: [
+                { location: '## Summary', kind: 'replace',
+                    rationale: '', new_text: '## Summary\n\n> Edition notice: …' },
+            ], preserve_warnings: [],
+        };
+        const out = applyVerdictToEntry(baseEntry, verdict);
+        // The notice is added, source hash updates, but last-reviewed stays null.
+        expect(out).toContain('Edition notice');
+        expect(out).toMatch(/last-reviewed:\s*null/);
+        expect(out).not.toContain('last-reviewed: 2026-05-24');
+    });
+    it('refuses to advance last-reviewed when sources_checked is missing a declared source', () => {
+        // Round-2 F-002: a malformed/ungrounded verdict whose `sources_checked`
+        // does not cover every declared frontmatter source must throw BEFORE
+        // last-reviewed is updated. Otherwise the prefilter would skip the entry
+        // until cadence expires, leaving the un-checked source stale.
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'current',
+            // Empty: doesn't cover baseEntry's `https://x` source.
+            sources_checked: [],
+            findings: [], proposed_changes: [], preserve_warnings: [],
+        };
+        expect(() => applyVerdictToEntry(baseEntry, verdict)).toThrow(/missing entry source/);
+    });
+    it('rejects an H3 (### …) location — Phase 1 supports H2 only', () => {
+        const entry = `---
+name: x
+description: y
+topics: []
+sources:
+  - url: https://x
+    hash: 'old'
+---
+
+## Deep Guidance
+
+### Some Subsection
+
+content
+`;
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'major-drift', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [
+                { location: '### Some Subsection', kind: 'replace',
+                    rationale: '', new_text: '### Some Subsection\n\nnew content' },
+            ],
+            preserve_warnings: [],
+        };
+        // H3 location → findHeading() returns null → applyVerdictToEntry throws
+        // BEFORE any disk edit. Verifies the Phase 1 "H2 only" contract.
+        expect(() => applyVerdictToEntry(entry, verdict)).toThrow(/did not match/);
+    });
+    it('rejects an H1 (# …) location — only "## " is a valid target', () => {
+        const entry = `---
+name: x
+description: y
+topics: []
+sources:
+  - url: https://x
+    hash: 'old'
+---
+
+# Some H1
+
+## Deep Guidance
+
+x
+`;
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'major-drift', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [
+                { location: '# Some H1', kind: 'replace',
+                    rationale: '', new_text: '# Some H1\n\nnew' },
+            ],
+            preserve_warnings: [],
+        };
+        expect(() => applyVerdictToEntry(entry, verdict)).toThrow(/did not match/);
+    });
+    it('applies a delete kind by removing the targeted section', () => {
+        const entry = `---
+name: x
+description: y
+topics: []
+---
+
+## Summary
+
+## Deprecated Section
+
+old stuff here
+
+## Deep Guidance
+
+keep me
+`;
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'major-drift', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [
+                { location: '## Deprecated Section', kind: 'delete', rationale: '' },
+            ],
+            preserve_warnings: [],
+        };
+        const out = applyVerdictToEntry(entry, verdict);
+        expect(out).not.toContain('Deprecated Section');
+        expect(out).not.toContain('old stuff here');
+        expect(out).toContain('## Deep Guidance');
+        expect(out).toContain('keep me');
+    });
+    it('preserves literal "$1" in new_text (no replace-string interpolation)', () => {
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'major-drift', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [
+                { location: '## Deep Guidance', kind: 'replace',
+                    rationale: '', new_text: '## Deep Guidance\n\nCost: $1 per request, $20/month plan.' },
+            ],
+            preserve_warnings: [],
+        };
+        const out = applyVerdictToEntry(baseEntry, verdict);
+        expect(out).toContain('Cost: $1 per request, $20/month plan.');
+    });
+    it('throws when minor-drift or current verdicts carry proposed_changes', () => {
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'minor-drift', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [
+                { location: '## Deep Guidance', kind: 'replace',
+                    rationale: '', new_text: '## Deep Guidance\n\nNew.' },
+            ],
+            preserve_warnings: [],
+        };
+        expect(() => applyVerdictToEntry(baseEntry, verdict)).toThrow(/must have no proposed_changes/);
+    });
+    it('matches sources by normalized URL so anchors do not block hash updates', () => {
+        const entry = `---
+name: x
+description: y
+topics: []
+sources:
+  - url: https://example.org/spec
+    hash: 'old'
+---
+
+## Deep Guidance
+
+x
+`;
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'current',
+            sources_checked: [
+                // Verdict's URL has an anchor; frontmatter's doesn't. Apply should still match.
+                { url: 'https://example.org/spec#section-2', retrieved_at: '2026-05-24',
+                    content_hash: 'sha256:new', summary: '' },
+            ],
+            findings: [], proposed_changes: [], preserve_warnings: [],
+        };
+        const out = applyVerdictToEntry(entry, verdict);
+        // yaml.dump quoting under JSON_SCHEMA is value-dependent; match by content.
+        expect(out).toMatch(/hash:\s*['"]?sha256:new['"]?/);
+        // Old hash must be absent in any quoting — leaving the stale value behind
+        // is the bug we're guarding against.
+        expect(out).not.toMatch(/hash:\s*['"]?old['"]?/);
+    });
+    it('prefers caller-supplied trustedHashes over LLM-claimed content_hash', () => {
+        const entry = `---
+name: x
+description: y
+topics: []
+sources:
+  - url: https://example.org/spec
+    hash: 'old'
+---
+
+## Deep Guidance
+
+x
+`;
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'current',
+            sources_checked: [
+                { url: 'https://example.org/spec', retrieved_at: '2026-05-24',
+                    content_hash: 'sha256:llm-claimed-untrusted', summary: '' },
+            ],
+            findings: [], proposed_changes: [], preserve_warnings: [],
+        };
+        const trustedHashes = new Map([['https://example.org/spec', 'sha256:deterministic']]);
+        const out = applyVerdictToEntry(entry, verdict, { trustedHashes });
+        expect(out).toMatch(/hash:\s*['"]?sha256:deterministic['"]?/);
+        expect(out).not.toContain('llm-claimed-untrusted');
+    });
+    it('throws when trustedHashes is supplied but is missing a verdict source URL', () => {
+        const entry = `---
+name: x
+description: y
+topics: []
+sources:
+  - url: https://example.org/spec
+    hash: 'old'
+---
+
+## Deep Guidance
+
+x
+`;
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'current',
+            sources_checked: [
+                { url: 'https://example.org/spec', retrieved_at: '2026-05-24',
+                    content_hash: 'sha256:llm', summary: '' },
+            ],
+            findings: [], proposed_changes: [], preserve_warnings: [],
+        };
+        // Supply trustedHashes but omit the URL → strict mode: throw rather than
+        // silently fall back to the LLM-claimed hash.
+        const trustedHashes = new Map();
+        expect(() => applyVerdictToEntry(entry, verdict, { trustedHashes })).toThrow(/trustedHashes/);
+    });
+    it('stops the targeted section at an H1 boundary, not just at the next H2', () => {
+        // Knowledge entries rarely have H1s (titles live in frontmatter) but if
+        // one ever appears, an H2 region must end at the H1 — not swallow it.
+        const entry = `---
+name: x
+description: y
+topics: []
+---
+
+## Old Section
+
+old content
+
+# Stray H1 inside the body
+
+other content
+
+## Deep Guidance
+
+keep me
+`;
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'major-drift', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [
+                { location: '## Old Section', kind: 'delete', rationale: '' },
+            ],
+            preserve_warnings: [],
+        };
+        const out = applyVerdictToEntry(entry, verdict);
+        expect(out).not.toContain('## Old Section');
+        expect(out).not.toContain('old content');
+        expect(out).toContain('# Stray H1 inside the body');
+        expect(out).toContain('other content');
+        expect(out).toContain('## Deep Guidance');
+        expect(out).toContain('keep me');
+    });
+    it('rejects near-miss heading replacements that would break extractDeepGuidance()', () => {
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'major-drift', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [
+                // "## Deep Guidance (Updated)" starts with "## Deep Guidance" but is
+                // NOT the exact heading the assembly engine matches. Must throw.
+                { location: '## Deep Guidance', kind: 'replace',
+                    rationale: '', new_text: '## Deep Guidance (Updated)\n\nbody' },
+            ],
+            preserve_warnings: [],
+        };
+        expect(() => applyVerdictToEntry(baseEntry, verdict)).toThrow(/must equal "## Deep Guidance" exactly/);
+    });
+    it('protects "## Summary" the same way it protects "## Deep Guidance"', () => {
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'major-drift', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [
+                { location: '## Summary', kind: 'delete', rationale: '' },
+            ],
+            preserve_warnings: [],
+        };
+        expect(() => applyVerdictToEntry(baseEntry, verdict)).toThrow(/Summary/);
+    });
+    it('parses unquoted ISO dates in existing entries correctly (no Date coercion)', () => {
+        const entryWithUnquotedDate = `---
+name: x
+description: y
+topics: []
+last-reviewed: 2026-04-01
+sources:
+  - url: https://x
+    hash: 'old'
+---
+
+## Deep Guidance
+
+Old content.
+`;
+        const verdict = {
+            entry_name: 'x', audit_date: '2026-05-24', model: 'claude-opus-4-7',
+            verdict: 'current', sources_checked: baseEntryChecked, findings: [],
+            proposed_changes: [], preserve_warnings: [],
+        };
+        const out = applyVerdictToEntry(entryWithUnquotedDate, verdict);
+        // The new date is set, and it serializes as a string (not [object Object]).
+        expect(out).toContain('last-reviewed: 2026-05-24');
+        expect(out).not.toContain('[object Object]');
+    });
+});
+//# sourceMappingURL=audit-apply.test.js.map

package/dist/knowledge-freshness/audit-apply.test.js.map

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

package/dist/knowledge-freshness/audit-prefilter.d.ts

@@ -0,0 +1,12 @@
+import type { KnowledgeEntry } from '../types/index.js';
+export type FetchSourceFn = (url: string) => Promise<{
+    hash: string;
+}>;
+interface Options {
+    now: Date;
+    max: number;
+    fetch: FetchSourceFn;
+}
+export declare function selectAuditCandidates(entries: KnowledgeEntry[], opts: Options): Promise<KnowledgeEntry[]>;
+export {};
+//# sourceMappingURL=audit-prefilter.d.ts.map

package/dist/knowledge-freshness/audit-prefilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-prefilter.d.ts","sourceRoot":"","sources":["../../src/knowledge-freshness/audit-prefilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAMtE,UAAU,OAAO;IAAG,GAAG,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE;AAElE,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,cAAc,EAAE,EACzB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,cAAc,EAAE,CAAC,CA2D3B"}

package/dist/knowledge-freshness/audit-prefilter.js

@@ -0,0 +1,74 @@
+const WINDOW_DAYS = {
+    'fast-moving': 14, evolving: 60, stable: 180,
+};
+export async function selectAuditCandidates(entries, opts) {
+    const candidates = [];
+    for (const e of entries) {
+        if (e.sources.length === 0)
+            continue;
+        let select = false;
+        let priority = 0;
+        if (!e.lastReviewed) {
+            select = true;
+            priority = 100;
+        }
+        else {
+            const parsed = new Date(e.lastReviewed).getTime();
+            // If lastReviewed is malformed (e.g. "2026-99-99" passed the regex but
+            // is not a real calendar date), `new Date()` yields NaN and the cadence
+            // math would silently NOT select. Treat invalid dates as "needs audit
+            // now" rather than skipping (round-3 F-002). The frontmatter validator
+            // also rejects this on CI, but the runtime guard belongs here for the
+            // case where validator and prefilter disagree.
+            const ageDays = Number.isNaN(parsed)
+                ? Number.POSITIVE_INFINITY
+                : Math.floor((opts.now.getTime() - parsed) / 86400000);
+            const window = WINDOW_DAYS[e.volatility];
+            if (ageDays > window) {
+                select = true;
+                priority = 50 + (Number.isFinite(ageDays) ? ageDays : 1000);
+            }
+            else {
+                // Round-7 F-004: fetch an entry's sources concurrently so a slow
+                // upstream doesn't extend the per-entry hash-check phase linearly.
+                // Concurrency is bounded by the small per-entry source count
+                // (typically 1-3); we don't need a global limiter at Phase 1 scale.
+                const hashedSources = await Promise.all(e.sources.map(async (s) => {
+                    if (!s.hash)
+                        return null;
+                    // Match the audit meta-prompt's fetch shape: source.url + source.anchor.
+                    const fetchUrl = s.url + (s.anchor ?? '');
+                    try {
+                        const { hash } = await opts.fetch(fetchUrl);
+                        return { stored: s.hash, fetched: hash };
+                    }
+                    catch (err) {
+                        // Fetch errors must not crash the whole cron. Treat any error
+                        // as "could not verify" — leave the entry alone this run; the
+                        // next cadence-window expiry will pick it up.
+                        console.warn(`[knowledge-freshness] fetch failed for ${fetchUrl} (entry ${e.name}): ` +
+                            err.message);
+                        return null;
+                    }
+                }));
+                for (const h of hashedSources) {
+                    if (h && h.fetched !== h.stored) {
+                        select = true;
+                        priority = 75;
+                        break;
+                    }
+                }
+            }
+        }
+        if (select)
+            candidates.push({ entry: e, priority });
+    }
+    candidates.sort((a, b) => b.priority - a.priority);
+    // Defensive: clamp max to a positive integer. Negative values would make
+    // `slice(0, -n)` return all-but-n, silently bypassing the ceiling (round-2
+    // F-003). The yargs CLI also rejects non-positive integers, but the library
+    // is callable from tests and other CLIs, so the guard belongs here too.
+    const ceiling = Number.isInteger(opts.max) && opts.max > 0 ? opts.max : 0;
+    return candidates.slice(0, ceiling).map(c => c.entry);
+}
+//# sourceMappingURL=audit-prefilter.js.map

package/dist/knowledge-freshness/audit-prefilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-prefilter.js","sourceRoot":"","sources":["../../src/knowledge-freshness/audit-prefilter.ts"],"names":[],"mappings":"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"}

package/dist/knowledge-freshness/audit-prefilter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audit-prefilter.test.d.ts.map

package/dist/knowledge-freshness/audit-prefilter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-prefilter.test.d.ts","sourceRoot":"","sources":["../../src/knowledge-freshness/audit-prefilter.test.ts"],"names":[],"mappings":""}