@shrkcrft/inspector 0.1.0-alpha.1

package/dist/template-lint.d.ts

@@ -0,0 +1,31 @@
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export interface ITemplateLintIssue {
+    templateId: string;
+    code: string;
+    severity: 'error' | 'warning' | 'info';
+    message: string;
+    suggestion?: string;
+}
+export interface ITemplateLintResult {
+    templateId: string;
+    issues: readonly ITemplateLintIssue[];
+    passed: boolean;
+}
+export interface ITemplateLintReport {
+    results: readonly ITemplateLintResult[];
+    summary: {
+        errors: number;
+        warnings: number;
+        info: number;
+    };
+}
+export declare function lintTemplates(inspection: ISharkcraftInspection, templateIds?: readonly string[]): ITemplateLintReport;
+export interface ITemplateTestResult {
+    templateId: string;
+    passed: boolean;
+    renderedChanges: number;
+    conflicts: number;
+    errors: readonly string[];
+}
+export declare function testTemplates(inspection: ISharkcraftInspection, templateIds?: readonly string[]): readonly ITemplateTestResult[];
+//# sourceMappingURL=template-lint.d.ts.map

package/dist/template-lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-lint.d.ts","sourceRoot":"","sources":["../src/template-lint.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACtC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACxC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AAID,wBAAgB,aAAa,CAC3B,UAAU,EAAE,qBAAqB,EACjC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAC9B,mBAAmB,CAuBrB;AA4CD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,qBAAqB,EACjC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAC9B,SAAS,mBAAmB,EAAE,CAwChC"}

package/dist/template-lint.js

@@ -0,0 +1,113 @@
+import { generate, OverwriteStrategy } from '@shrkcrft/generator';
+const PLACEHOLDER_RE = /\{\{\s*(\w+)\s*\}\}/g;
+export function lintTemplates(inspection, templateIds) {
+    const all = inspection.templateRegistry.list();
+    const targets = templateIds && templateIds.length > 0
+        ? all.filter((t) => templateIds.includes(t.id))
+        : all;
+    const results = [];
+    for (const t of targets) {
+        const issues = lintOne(t);
+        results.push({
+            templateId: t.id,
+            issues,
+            passed: !issues.some((i) => i.severity === 'error'),
+        });
+    }
+    const summary = { errors: 0, warnings: 0, info: 0 };
+    for (const r of results) {
+        for (const i of r.issues) {
+            if (i.severity === 'error')
+                summary.errors += 1;
+            else if (i.severity === 'warning')
+                summary.warnings += 1;
+            else
+                summary.info += 1;
+        }
+    }
+    return { results, summary };
+}
+function lintOne(t) {
+    const issues = [];
+    if (!t.name || t.name.trim().length === 0) {
+        issues.push({ templateId: t.id, code: 'missing-name', severity: 'error', message: 'Template has no name' });
+    }
+    if (!t.description || t.description.trim().length === 0) {
+        issues.push({ templateId: t.id, code: 'missing-description', severity: 'warning', message: 'Template has no description' });
+    }
+    const vars = t.variables ?? [];
+    for (const v of vars) {
+        if (!v.description) {
+            issues.push({ templateId: t.id, code: 'undocumented-var', severity: 'info', message: `Variable "${v.name}" has no description` });
+        }
+        const hasExample = (v.examples ?? []).length > 0;
+        if (v.required && !hasExample && !v.pattern) {
+            issues.push({ templateId: t.id, code: 'required-var-no-example', severity: 'info', message: `Required variable "${v.name}" has no example or pattern` });
+        }
+    }
+    const targetStr = typeof t.targetPath === 'string' ? t.targetPath : '';
+    if (targetStr.length > 0) {
+        if (targetStr.startsWith('/') || targetStr.includes('..')) {
+            issues.push({ templateId: t.id, code: 'unsafe-target', severity: 'error', message: `targetPath escapes project root: ${targetStr}` });
+        }
+    }
+    // Placeholder leak check: collect placeholders referenced in body+target.
+    const referenced = new Set();
+    const body = typeof t.content === 'string' ? (t.content) : '';
+    for (const m of body.matchAll(PLACEHOLDER_RE))
+        referenced.add(m[1]);
+    for (const m of targetStr.matchAll(PLACEHOLDER_RE))
+        referenced.add(m[1]);
+    const known = new Set(vars.map((v) => v.name));
+    // name/className/PascalCase/etc. are auto-filled.
+    for (const auto of ['name', 'pascal', 'pascalCase', 'className', 'camel', 'camelCase', 'kebab', 'kebabCase', 'snake', 'snakeCase']) {
+        known.add(auto);
+    }
+    for (const ref of referenced) {
+        if (!known.has(ref)) {
+            issues.push({ templateId: t.id, code: 'undeclared-var', severity: 'warning', message: `Placeholder {{${ref}}} is not declared in variables[]` });
+        }
+    }
+    return issues;
+}
+export function testTemplates(inspection, templateIds) {
+    const all = inspection.templateRegistry.list();
+    const targets = templateIds && templateIds.length > 0
+        ? all.filter((t) => templateIds.includes(t.id))
+        : all;
+    const results = [];
+    for (const t of targets) {
+        const vars = t.variables ?? [];
+        const sampleVars = {};
+        for (const v of vars) {
+            sampleVars[v.name] = (v.examples?.[0]) ?? v.default ?? `sample-${v.name}`;
+        }
+        const r = generate(t, {
+            templateId: t.id,
+            name: 'sample',
+            variables: sampleVars,
+            projectRoot: inspection.projectRoot,
+            overwriteStrategy: OverwriteStrategy.Never,
+            write: false,
+        });
+        if (!r.ok) {
+            results.push({
+                templateId: t.id,
+                passed: false,
+                renderedChanges: 0,
+                conflicts: 0,
+                errors: [r.error.message],
+            });
+            continue;
+        }
+        const plan = r.value.plan;
+        results.push({
+            templateId: t.id,
+            passed: plan.changes.length > 0 && !plan.hasConflicts,
+            renderedChanges: plan.changes.length,
+            conflicts: plan.changes.filter((c) => String(c.type) === 'conflict').length,
+            errors: [],
+        });
+    }
+    return results;
+}

package/dist/test-definitions.d.ts

@@ -0,0 +1,41 @@
+export interface IContextTest {
+    id: string;
+    task: string;
+    mustInclude?: readonly string[];
+    mustNotInclude?: readonly string[];
+    maxTokens?: number;
+}
+export declare function defineContextTest<T extends IContextTest>(t: T): T;
+export interface IAgentContractTest {
+    id: string;
+    task: string;
+    expectedPipeline?: string;
+    expectedTemplates?: readonly string[];
+    expectedRules?: readonly string[];
+    expectedForbiddenActions?: readonly string[];
+    expectedVerificationCommands?: readonly string[];
+    /**
+     * Additional expectations that fail the test when the ranker /
+     * search drifts. Each field is independent; missing fields are treated
+     * as "no expectation".
+     */
+    expectedHelpers?: readonly string[];
+    expectedPlaybooks?: readonly string[];
+    expectedPolicies?: readonly string[];
+    expectedConstructs?: readonly string[];
+    expectedCommands?: readonly string[];
+    expectedKnowledge?: readonly string[];
+    /**
+     * Minimum confidence the packet must surface (interpreted by callers).
+     * Currently advisory — present so packs can declare intent. Not enforced
+     * by the default runner.
+     */
+    minConfidence?: 'high' | 'medium' | 'low';
+    /**
+     * Ids that must NOT appear in the packet's relevant lists (templates,
+     * rules, helpers, etc.). Catches ranker drift toward irrelevant entries.
+     */
+    mustNotInclude?: readonly string[];
+}
+export declare function defineAgentContractTest<T extends IAgentContractTest>(t: T): T;
+//# sourceMappingURL=test-definitions.d.ts.map

package/dist/test-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-definitions.d.ts","sourceRoot":"","sources":["../src/test-definitions.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAEjE;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,wBAAwB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,4BAA4B,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD;;;;OAIG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC1C;;;OAGG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,kBAAkB,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAE7E"}

package/dist/test-definitions.js

@@ -0,0 +1,6 @@
+export function defineContextTest(t) {
+    return t;
+}
+export function defineAgentContractTest(t) {
+    return t;
+}

package/dist/test-impact.d.ts

@@ -0,0 +1,30 @@
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export declare const TEST_IMPACT_SCHEMA = "sharkcraft.test-impact/v1";
+export interface ITestImpactInput {
+    task?: string;
+    files?: readonly string[];
+}
+export interface ITestImpact {
+    schema: typeof TEST_IMPACT_SCHEMA;
+    task: string;
+    inputFiles: readonly string[];
+    likelyTestFiles: readonly string[];
+    missingTestFiles: readonly string[];
+    testCommands: readonly string[];
+    /** Minimum commands to gain coverage for the inferred test files. */
+    minimalCommands: readonly string[];
+    /** Full workspace test commands. */
+    fullCommands: readonly string[];
+    verificationCommands: readonly string[];
+    /** Per-workspace-package suggestions, when detectable. */
+    packageCommands: readonly {
+        packageName: string;
+        commands: readonly string[];
+    }[];
+    riskAreas: readonly string[];
+    confidence: number;
+    explanation: string;
+}
+export declare function analyzeTestImpact(inspection: ISharkcraftInspection, input: ITestImpactInput): ITestImpact;
+export declare function suggestTestPathFor(file: string): string;
+//# sourceMappingURL=test-impact.d.ts.map

package/dist/test-impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-impact.d.ts","sourceRoot":"","sources":["../src/test-impact.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,kBAAkB,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,qEAAqE;IACrE,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,oCAAoC;IACpC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,0DAA0D;IAC1D,eAAe,EAAE,SAAS;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;IACjF,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAiCD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,gBAAgB,GACtB,WAAW,CAyEb;AAoDD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvD"}

package/dist/test-impact.js

@@ -0,0 +1,173 @@
+import { existsSync, readFileSync } from 'node:fs';
+import * as nodePath from 'node:path';
+export const TEST_IMPACT_SCHEMA = 'sharkcraft.test-impact/v1';
+const TEST_PATTERNS = [
+    (f) => /\.(spec|test)\.[jt]sx?$/.test(f) ? f : null,
+    (f) => f.replace(/^src\//, 'tests/').replace(/\.(ts|tsx|js|jsx)$/, '.spec.$1'),
+    (f) => f.replace(/^src\//, 'tests/').replace(/\.(ts|tsx|js|jsx)$/, '.test.$1'),
+    (f) => f.replace(/\.([tj]s)$/, '.spec.$1'),
+    (f) => f.replace(/\.([tj]s)$/, '.test.$1'),
+    (f) => f.replace(/\.tsx$/, '.test.tsx'),
+    (f) => f.replace(/\.tsx$/, '.spec.tsx'),
+    (f) => {
+        const parsed = nodePath.parse(f);
+        if (!parsed.name)
+            return null;
+        return nodePath.join(parsed.dir, '__tests__', `${parsed.name}.test${parsed.ext}`);
+    },
+    (f) => {
+        const parsed = nodePath.parse(f);
+        if (!parsed.name)
+            return null;
+        return nodePath.join(parsed.dir, '__tests__', `${parsed.name}.spec${parsed.ext}`);
+    },
+];
+function readPackageScripts(cwd) {
+    const pkg = nodePath.join(cwd, 'package.json');
+    if (!existsSync(pkg))
+        return {};
+    try {
+        return JSON.parse(readFileSync(pkg, 'utf8'))
+            .scripts ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+export function analyzeTestImpact(inspection, input) {
+    const files = uniqueStrings(input.files ?? []);
+    const task = input.task ?? files.join(' ');
+    const likely = new Set();
+    const missing = new Set();
+    for (const f of files) {
+        const candidates = [];
+        for (const fn of TEST_PATTERNS) {
+            const c = fn(f);
+            if (c)
+                candidates.push(c);
+        }
+        let any = false;
+        for (const c of candidates) {
+            if (existsSync(nodePath.join(inspection.projectRoot, c))) {
+                likely.add(c);
+                any = true;
+            }
+        }
+        if (!any) {
+            // Pick the most idiomatic candidate as the expected location.
+            const expected = candidates[0] ?? f.replace(/\.(ts|tsx|js|jsx)$/, '.spec.$1');
+            missing.add(expected);
+        }
+    }
+    const scripts = readPackageScripts(inspection.projectRoot);
+    const fullCommands = [];
+    for (const k of ['test', 'test:unit', 'test:int', 'test:e2e']) {
+        if (scripts[k])
+            fullCommands.push(`bun run ${k}`);
+    }
+    if (fullCommands.length === 0)
+        fullCommands.push('bun test');
+    // Minimal commands: target the specific test files we found on disk.
+    const minimalCommands = [];
+    if (likely.size > 0) {
+        minimalCommands.push(`bun test ${[...likely].sort().join(' ')}`);
+    }
+    else if (files.length > 0) {
+        // Nothing to target — fall back to the full suite.
+        minimalCommands.push(...fullCommands);
+    }
+    const packageCommands = detectWorkspacePackageCommands(inspection.projectRoot, files);
+    const testCommands = uniqueStrings([...minimalCommands, ...fullCommands]);
+    const verificationCommands = uniqueStrings([
+        ...testCommands,
+        'bun x tsc -p tsconfig.base.json --noEmit',
+        'shrk check boundaries',
+    ]);
+    const riskAreas = [];
+    if (missing.size > 0)
+        riskAreas.push('missing-tests');
+    if (likely.size === 0 && files.length > 0)
+        riskAreas.push('no-tests-found');
+    const confidence = files.length === 0 ? 0 : Math.min(100, Math.round((likely.size / files.length) * 100));
+    return {
+        schema: TEST_IMPACT_SCHEMA,
+        task,
+        inputFiles: files,
+        likelyTestFiles: [...likely].sort(),
+        missingTestFiles: [...missing].sort(),
+        testCommands,
+        minimalCommands,
+        fullCommands,
+        packageCommands,
+        verificationCommands,
+        riskAreas,
+        confidence,
+        explanation: `${likely.size}/${files.length} input file(s) have an existing test on disk.`,
+    };
+}
+function detectWorkspacePackageCommands(projectRoot, files) {
+    if (files.length === 0)
+        return [];
+    const pkgPath = nodePath.join(projectRoot, 'package.json');
+    if (!existsSync(pkgPath))
+        return [];
+    let workspaces = [];
+    try {
+        const json = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        if (Array.isArray(json.workspaces))
+            workspaces = json.workspaces;
+        else
+            workspaces = json.workspaces?.packages ?? [];
+    }
+    catch {
+        return [];
+    }
+    // Identify touched packages by prefix.
+    const touched = new Map();
+    for (const pattern of workspaces) {
+        const dir = pattern.replace(/\/\*?$/, '');
+        for (const f of files) {
+            if (!f.startsWith(dir + '/'))
+                continue;
+            // Find the immediate package dir.
+            const rest = f.slice(dir.length + 1);
+            const pkgDirName = rest.split('/')[0];
+            if (!pkgDirName)
+                continue;
+            const pkgRoot = nodePath.join(projectRoot, dir, pkgDirName);
+            const pkgFile = nodePath.join(pkgRoot, 'package.json');
+            if (!existsSync(pkgFile))
+                continue;
+            if (touched.has(pkgRoot))
+                continue;
+            try {
+                const pj = JSON.parse(readFileSync(pkgFile, 'utf8'));
+                const name = pj.name ?? pkgDirName;
+                const commands = [];
+                if (pj.scripts?.['test'])
+                    commands.push(`bun --filter ${name} test`);
+                if (pj.scripts?.['test:unit'])
+                    commands.push(`bun --filter ${name} run test:unit`);
+                if (commands.length === 0)
+                    commands.push(`bun test ${pkgRoot}`);
+                touched.set(pkgRoot, { packageName: name, commands });
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+    return [...touched.values()];
+}
+export function suggestTestPathFor(file) {
+    // Most idiomatic suggestion for "where should this test live?".
+    if (/\.tsx$/.test(file))
+        return file.replace(/\.tsx$/, '.test.tsx');
+    if (file.startsWith('src/')) {
+        return file.replace(/^src\//, 'tests/').replace(/\.([tj]s)$/, '.spec.$1');
+    }
+    return file.replace(/\.([tj]s)$/, '.spec.$1');
+}
+function uniqueStrings(xs) {
+    return [...new Set(xs)];
+}

package/dist/test-runner.d.ts

@@ -0,0 +1,87 @@
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+import { type IAgentContractTest, type IContextTest } from './test-definitions.js';
+/**
+ * Pre-loaded registry id snapshots used to evaluate strict agent-test
+ * expectations. The sync `runAgentContractTest` is best-effort; callers
+ * should `loadAgentContractRegistries` once and pass the result for
+ * accurate policy/construct membership checks.
+ */
+export interface IAgentContractRegistries {
+    helpers: ReadonlySet<string>;
+    playbooks: ReadonlySet<string>;
+    policies: ReadonlySet<string>;
+    constructs: ReadonlySet<string>;
+    commands: ReadonlySet<string>;
+    knowledge: ReadonlySet<string>;
+}
+export interface IContextTestDiagnostic {
+    /** The missing or unexpected id. */
+    id: string;
+    /** Whether the entry exists in the project at all (it just didn't make the context). */
+    existsInRegistry: boolean;
+    /** Top-ranked alternatives the ranker chose instead, with reasons. */
+    topAlternatives?: {
+        id: string;
+        score: number;
+        reasons: readonly string[];
+    }[];
+    /** Concrete suggestions to make this test pass. */
+    suggestions: readonly string[];
+}
+export interface IContextTestResult {
+    id: string;
+    task: string;
+    passed: boolean;
+    presentInclude: readonly string[];
+    missingInclude: readonly string[];
+    unexpectedInclude: readonly string[];
+    totalTokens: number;
+    maxTokens: number;
+    failureSummary?: string;
+    /** Per-missing/unexpected-id diagnostic notes. Only populated on failures. */
+    diagnostics?: readonly IContextTestDiagnostic[];
+}
+export interface IAgentContractMissingDiagnostic {
+    id: string;
+    /** Which expectation slot the id was missing from. */
+    kind: 'template' | 'rule' | 'pipeline' | 'forbidden-action' | 'verification-command' | 'helper' | 'playbook' | 'policy' | 'construct' | 'command' | 'knowledge' | 'must-not-include';
+    existsInRegistry: boolean;
+    suggestions: readonly string[];
+}
+export interface IAgentContractTestResult {
+    id: string;
+    task: string;
+    passed: boolean;
+    expectedPipeline?: string;
+    actualPipelines?: readonly string[];
+    missingTemplates?: readonly string[];
+    missingRules?: readonly string[];
+    missingForbiddenActions?: readonly string[];
+    missingVerificationCommands?: readonly string[];
+    /** Strict expectation field results. */
+    missingHelpers?: readonly string[];
+    missingPlaybooks?: readonly string[];
+    missingPolicies?: readonly string[];
+    missingConstructs?: readonly string[];
+    missingCommands?: readonly string[];
+    missingKnowledge?: readonly string[];
+    /** Ids that should NOT have been surfaced but were. */
+    unexpectedlyIncluded?: readonly string[];
+    failureSummary?: string;
+    diagnostics?: readonly IAgentContractMissingDiagnostic[];
+}
+/**
+ * Load context tests from local sharkcraft config + any pack contributions.
+ */
+export declare function loadContextTests(inspection: ISharkcraftInspection): Promise<IContextTest[]>;
+export declare function loadAgentContractTests(inspection: ISharkcraftInspection): Promise<IAgentContractTest[]>;
+export declare function runContextTest(inspection: ISharkcraftInspection, test: IContextTest): IContextTestResult;
+export declare function runAgentContractTest(inspection: ISharkcraftInspection, test: IAgentContractTest, registries?: IAgentContractRegistries): IAgentContractTestResult;
+/**
+ * Async pre-loader for agent-contract test registries. Reads local
+ * sharkcraft/policies.ts, sharkcraft/constructs.ts, sharkcraft/playbooks/
+ * (and pack contributions where present). Result is sync-friendly so the
+ * runner can stay sync.
+ */
+export declare function loadAgentContractRegistries(inspection: ISharkcraftInspection): Promise<IAgentContractRegistries>;
+//# sourceMappingURL=test-runner.d.ts.map

package/dist/test-runner.d.ts.map

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