@shrkcrft/inspector 0.1.0-alpha.2

package/dist/apply-dispatch-trace.d.ts.map

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

package/dist/apply-dispatch-trace.js

@@ -0,0 +1,283 @@
+export const APPLY_DISPATCH_TRACE_SCHEMA = 'sharkcraft.apply-dispatch-trace/v1';
+export var DispatchKind;
+(function (DispatchKind) {
+    DispatchKind["Template"] = "template";
+    DispatchKind["Helper"] = "helper";
+    DispatchKind["PluginLifecycle"] = "plugin-lifecycle";
+    DispatchKind["RegistrationHint"] = "registration-hint";
+    DispatchKind["Synthetic"] = "synthetic";
+    DispatchKind["Unknown"] = "unknown";
+})(DispatchKind || (DispatchKind = {}));
+const TEMPLATE_PREFIX_HELPER = '__helper__';
+const TEMPLATE_PREFIX_PLUGIN_LIFECYCLE = '__plugin-lifecycle__';
+const TEMPLATE_PREFIX_REGISTRATION_HINT = '__registration-hint__';
+function classifyTemplate(templateId) {
+    if (templateId.startsWith(TEMPLATE_PREFIX_HELPER)) {
+        return {
+            kind: DispatchKind.Helper,
+            source: 'registry/helper',
+            handler: '@shrkcrft/inspector/helper-registry + @shrkcrft/generator/synthetic-plan.evaluateSavedPlanInPlace',
+        };
+    }
+    if (templateId.startsWith(TEMPLATE_PREFIX_PLUGIN_LIFECYCLE)) {
+        return {
+            kind: DispatchKind.PluginLifecycle,
+            source: 'registry/plugin-lifecycle-profile',
+            handler: '@shrkcrft/inspector/plugin-lifecycle + @shrkcrft/generator/synthetic-plan.evaluateSavedPlanInPlace',
+        };
+    }
+    if (templateId.startsWith(TEMPLATE_PREFIX_REGISTRATION_HINT)) {
+        return {
+            kind: DispatchKind.RegistrationHint,
+            source: 'registry/registration-hint',
+            handler: '@shrkcrft/inspector/registration-hint-registry + @shrkcrft/generator/synthetic-plan.evaluateSavedPlanInPlace',
+        };
+    }
+    if (templateId.startsWith('__')) {
+        return {
+            kind: DispatchKind.Synthetic,
+            source: 'synthetic',
+            handler: '@shrkcrft/generator/synthetic-plan.evaluateSavedPlanInPlace',
+        };
+    }
+    return {
+        kind: DispatchKind.Template,
+        source: 'registry/template',
+        handler: '@shrkcrft/templates + @shrkcrft/generator/generator-engine.generate',
+    };
+}
+function countFileOps(plan) {
+    const counts = {
+        create: 0,
+        update: 0,
+        append: 0,
+        insertBefore: 0,
+        insertAfter: 0,
+        replace: 0,
+        exportLine: 0,
+        skip: 0,
+        conflict: 0,
+    };
+    let total = 0;
+    const opKinds = new Set();
+    for (const change of plan.expectedChanges ?? []) {
+        total += 1;
+        const opKind = change.operation?.kind;
+        if (opKind)
+            opKinds.add(opKind);
+        const type = change.type;
+        switch (type) {
+            case 'create':
+                counts['create'] += 1;
+                break;
+            case 'update':
+                counts['update'] += 1;
+                break;
+            case 'append':
+                counts['append'] += 1;
+                break;
+            case 'insert-before':
+                counts['insertBefore'] += 1;
+                break;
+            case 'insert-after':
+                counts['insertAfter'] += 1;
+                break;
+            case 'replace':
+                counts['replace'] += 1;
+                break;
+            case 'export':
+                counts['exportLine'] += 1;
+                break;
+            case 'skip':
+                counts['skip'] += 1;
+                break;
+            case 'conflict':
+                counts['conflict'] += 1;
+                break;
+            default:
+                // unknown — leave counts as-is
+                break;
+        }
+    }
+    return {
+        counts: counts,
+        total,
+        opKinds: [...opKinds].sort(),
+    };
+}
+function countFolderOps(ops) {
+    let renameFolder = 0;
+    let deleteFolder = 0;
+    for (const op of ops) {
+        if (op.kind === 'rename-folder')
+            renameFolder += 1;
+        else if (op.kind === 'delete-folder')
+            deleteFolder += 1;
+    }
+    return { counts: { renameFolder, deleteFolder }, total: ops.length };
+}
+export function buildApplyDispatchTrace(options) {
+    const { plan, inspection, dryRun, allowFolderOps, allowDeleteFolder, verifySignature, diverged } = options;
+    const synthetic = plan.templateId.startsWith('__');
+    const classification = classifyTemplate(plan.templateId);
+    const fileOps = countFileOps(plan);
+    const folderOps = countFolderOps(plan.folderOps ?? []);
+    const folderOpCount = folderOps.total;
+    const deleteCount = folderOps.counts.deleteFolder;
+    // Signature inference: we don't actually verify here; we just describe
+    // what `--verify-signature` would emit. The full status is reported by
+    // the apply CLI at run time.
+    const signatureStatus = verifySignature
+        ? plan.signature
+            ? 'verified'
+            : 'unsigned'
+        : 'not-checked';
+    const safetyGates = [];
+    const requiredFlags = [];
+    const blockReasons = [];
+    // 1) Signature gate.
+    if (verifySignature) {
+        if (plan.signature) {
+            safetyGates.push({ id: 'signature', status: 'will-pass' });
+        }
+        else {
+            safetyGates.push({
+                id: 'signature',
+                status: 'will-block',
+                detail: 'plan is unsigned; --verify-signature will refuse',
+            });
+            blockReasons.push('unsigned plan with --verify-signature');
+        }
+    }
+    else {
+        safetyGates.push({ id: 'signature', status: 'not-checked' });
+    }
+    // 2) Divergence gate.
+    if (diverged) {
+        safetyGates.push({
+            id: 'divergence',
+            status: 'requires-flag',
+            detail: 'plan diverged; --allow-divergent required',
+        });
+        requiredFlags.push('--allow-divergent');
+    }
+    else {
+        safetyGates.push({ id: 'divergence', status: 'will-pass' });
+    }
+    // 3) Folder-op gates.
+    if (folderOpCount > 0) {
+        if (!allowFolderOps) {
+            safetyGates.push({
+                id: 'folder-ops-allow-flag',
+                status: 'requires-flag',
+                detail: `${folderOpCount} folder op(s) need --allow-folder-ops`,
+            });
+            requiredFlags.push('--allow-folder-ops');
+        }
+        else {
+            safetyGates.push({ id: 'folder-ops-allow-flag', status: 'will-pass' });
+        }
+        if (deleteCount > 0 && !allowDeleteFolder) {
+            safetyGates.push({
+                id: 'delete-folder-allow-flag',
+                status: 'requires-flag',
+                detail: `${deleteCount} delete-folder op(s) also need --allow-delete-folder`,
+            });
+            requiredFlags.push('--allow-delete-folder');
+        }
+        else if (deleteCount > 0) {
+            safetyGates.push({ id: 'delete-folder-allow-flag', status: 'will-pass' });
+        }
+        // The actual unsafe-ops gate runs at apply time; we surface as
+        // not-checked here so callers know there is more to verify.
+        safetyGates.push({
+            id: 'folder-ops-safety',
+            status: 'not-checked',
+            detail: 'unsafe-op detection requires reading live disk; runs at apply',
+        });
+    }
+    // 4) Contract gate (optional).
+    if (options.contractGate === 'fail') {
+        safetyGates.push({
+            id: 'contract-gate',
+            status: 'will-block',
+            detail: 'contract gate fails — needs approval',
+        });
+        blockReasons.push('contract gate failure');
+    }
+    else if (options.contractGate === 'pass') {
+        safetyGates.push({ id: 'contract-gate', status: 'will-pass' });
+    }
+    let finalAction;
+    if (dryRun)
+        finalAction = 'dry-run';
+    else if (blockReasons.length > 0)
+        finalAction = 'blocked';
+    else
+        finalAction = 'would-apply';
+    // For template plans, verify the template actually exists in the
+    // registry. If it doesn't, mark as unknown so the trace is honest.
+    let resolvedKind = classification.kind;
+    let resolvedSource = classification.source;
+    let resolvedHandler = classification.handler;
+    if (classification.kind === DispatchKind.Template) {
+        const template = inspection.templateRegistry?.get?.(plan.templateId);
+        if (!template) {
+            resolvedKind = DispatchKind.Unknown;
+            resolvedSource = 'unknown';
+            resolvedHandler = 'template missing from registry';
+            blockReasons.push(`template "${plan.templateId}" not registered`);
+            if (finalAction === 'would-apply')
+                finalAction = 'blocked';
+        }
+    }
+    const trace = {
+        schema: APPLY_DISPATCH_TRACE_SCHEMA,
+        templateId: plan.templateId,
+        dispatchKind: resolvedKind,
+        source: resolvedSource,
+        handler: resolvedHandler,
+        synthetic,
+        totalFileOps: fileOps.total,
+        totalFolderOps: folderOpCount,
+        fileOpCounts: fileOps.counts,
+        folderOpCounts: folderOps.counts,
+        plannedOperationKinds: fileOps.opKinds,
+        signatureStatus,
+        ...(plan.signature?.signedAt ? {} : {}),
+        safetyGates,
+        requiredFlags,
+        finalAction,
+        blockReasons,
+    };
+    return trace;
+}
+export function renderApplyDispatchTraceText(trace) {
+    const lines = [];
+    lines.push('=== Apply dispatch trace ===');
+    lines.push(`  schema           ${trace.schema}`);
+    lines.push(`  templateId       ${trace.templateId}`);
+    lines.push(`  dispatchKind     ${trace.dispatchKind}${trace.synthetic ? ' (synthetic)' : ''}`);
+    lines.push(`  source           ${trace.source}`);
+    lines.push(`  handler          ${trace.handler}`);
+    lines.push(`  fileOps          ${trace.totalFileOps}`);
+    lines.push(`  folderOps        ${trace.totalFolderOps}`);
+    if (trace.plannedOperationKinds.length > 0) {
+        lines.push(`  plan operations  ${trace.plannedOperationKinds.join(', ')}`);
+    }
+    lines.push(`  signature        ${trace.signatureStatus}`);
+    if (trace.requiredFlags.length > 0) {
+        lines.push(`  requires         ${trace.requiredFlags.join(' ')}`);
+    }
+    lines.push(`  finalAction      ${trace.finalAction}`);
+    if (trace.blockReasons.length > 0) {
+        lines.push('  blockReasons:');
+        for (const r of trace.blockReasons)
+            lines.push(`    • ${r}`);
+    }
+    lines.push('  safety gates:');
+    for (const g of trace.safetyGates) {
+        lines.push(`    ${g.id.padEnd(28)} ${g.status}${g.detail ? '  (' + g.detail + ')' : ''}`);
+    }
+    return lines.join('\n') + '\n';
+}

package/dist/apply-gate-result.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Structured apply gate result.
+ *
+ * `shrk apply --contract` returns nonzero when blocked but the JSON
+ * output does not distinguish *why* (gate failure vs. signature vs. conflict
+ * vs. divergence). CI can branch on the human-readable text but not on a
+ * stable field. This module defines `IApplyGateResult` so JSON consumers can
+ * branch deterministically.
+ */
+export declare const APPLY_GATE_RESULT_SCHEMA = "sharkcraft.apply-gate/v1";
+export declare enum ApplyExitCategory {
+    Ok = "ok",
+    BlockedContractGate = "blocked-contract-gate",
+    BlockedSignature = "blocked-signature",
+    BlockedConflict = "blocked-conflict",
+    BlockedDivergence = "blocked-divergence",
+    BlockedPolicy = "blocked-policy",
+    BlockedBoundary = "blocked-boundary",
+    BlockedValidation = "blocked-validation",
+    /** Folder operation requires explicit allow flag(s). */
+    BlockedFolderOpAllowFlag = "blocked-folder-op-allow-flag",
+    /** Folder operation path is unsafe (refused before any FS touch). */
+    BlockedFolderOpUnsafe = "blocked-folder-op-unsafe",
+    InvalidInput = "invalid-input"
+}
+export interface IApplyContractGateFailure {
+    id: string;
+    status: string;
+    detail?: string;
+}
+export interface IApplySignatureStatus {
+    status: string;
+    message?: string;
+}
+export interface IApplyGateResult {
+    schema: typeof APPLY_GATE_RESULT_SCHEMA;
+    generatedAt: string;
+    ok: boolean;
+    exitCategory: ApplyExitCategory;
+    contractGateFailures?: readonly IApplyContractGateFailure[];
+    signatureStatus?: IApplySignatureStatus;
+    suggestedNextCommand?: string;
+    notes?: readonly string[];
+}
+export declare function buildApplyGateResult(input: {
+    exitCategory: ApplyExitCategory;
+    contractGateFailures?: readonly IApplyContractGateFailure[];
+    signatureStatus?: IApplySignatureStatus;
+    suggestedNextCommand?: string;
+    notes?: readonly string[];
+}): IApplyGateResult;
+//# sourceMappingURL=apply-gate-result.d.ts.map

package/dist/apply-gate-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-gate-result.d.ts","sourceRoot":"","sources":["../src/apply-gate-result.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAEnE,oBAAY,iBAAiB;IAC3B,EAAE,OAAO;IACT,mBAAmB,0BAA0B;IAC7C,gBAAgB,sBAAsB;IACtC,eAAe,qBAAqB;IACpC,iBAAiB,uBAAuB;IACxC,aAAa,mBAAmB;IAChC,eAAe,qBAAqB;IACpC,iBAAiB,uBAAuB;IACxC,wDAAwD;IACxD,wBAAwB,iCAAiC;IACzD,qEAAqE;IACrE,qBAAqB,6BAA6B;IAClD,YAAY,kBAAkB;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,wBAAwB,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,EAAE,iBAAiB,CAAC;IAChC,oBAAoB,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,YAAY,EAAE,iBAAiB,CAAC;IAChC,oBAAoB,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,GAAG,gBAAgB,CAcnB"}

package/dist/apply-gate-result.js

@@ -0,0 +1,44 @@
+/**
+ * Structured apply gate result.
+ *
+ * `shrk apply --contract` returns nonzero when blocked but the JSON
+ * output does not distinguish *why* (gate failure vs. signature vs. conflict
+ * vs. divergence). CI can branch on the human-readable text but not on a
+ * stable field. This module defines `IApplyGateResult` so JSON consumers can
+ * branch deterministically.
+ */
+export const APPLY_GATE_RESULT_SCHEMA = 'sharkcraft.apply-gate/v1';
+export var ApplyExitCategory;
+(function (ApplyExitCategory) {
+    ApplyExitCategory["Ok"] = "ok";
+    ApplyExitCategory["BlockedContractGate"] = "blocked-contract-gate";
+    ApplyExitCategory["BlockedSignature"] = "blocked-signature";
+    ApplyExitCategory["BlockedConflict"] = "blocked-conflict";
+    ApplyExitCategory["BlockedDivergence"] = "blocked-divergence";
+    ApplyExitCategory["BlockedPolicy"] = "blocked-policy";
+    ApplyExitCategory["BlockedBoundary"] = "blocked-boundary";
+    ApplyExitCategory["BlockedValidation"] = "blocked-validation";
+    /** Folder operation requires explicit allow flag(s). */
+    ApplyExitCategory["BlockedFolderOpAllowFlag"] = "blocked-folder-op-allow-flag";
+    /** Folder operation path is unsafe (refused before any FS touch). */
+    ApplyExitCategory["BlockedFolderOpUnsafe"] = "blocked-folder-op-unsafe";
+    ApplyExitCategory["InvalidInput"] = "invalid-input";
+})(ApplyExitCategory || (ApplyExitCategory = {}));
+export function buildApplyGateResult(input) {
+    const out = {
+        schema: APPLY_GATE_RESULT_SCHEMA,
+        generatedAt: new Date().toISOString(),
+        ok: input.exitCategory === ApplyExitCategory.Ok,
+        exitCategory: input.exitCategory,
+    };
+    if (input.contractGateFailures && input.contractGateFailures.length > 0) {
+        out.contractGateFailures = input.contractGateFailures;
+    }
+    if (input.signatureStatus)
+        out.signatureStatus = input.signatureStatus;
+    if (input.suggestedNextCommand)
+        out.suggestedNextCommand = input.suggestedNextCommand;
+    if (input.notes && input.notes.length > 0)
+        out.notes = input.notes;
+    return out;
+}

package/dist/architecture-map.d.ts

@@ -0,0 +1,118 @@
+import { type IRepositoryIntelligenceGraph } from './repository-intelligence.js';
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export declare const ARCHITECTURE_MAP_SCHEMA = "sharkcraft.architecture-map/v2";
+export type ArchitectureMapFormat = 'text' | 'markdown' | 'html' | 'json';
+export type ArchitectureMapInclude = 'layers' | 'constructs' | 'boundaries' | 'policies' | 'public-api' | 'tests' | 'ownership';
+export interface IArchitectureLayer {
+    id: string;
+    label: string;
+    members: readonly string[];
+}
+export interface IArchitectureRisk {
+    id: string;
+    severity: 'info' | 'warning' | 'error';
+    description: string;
+}
+export interface IArchitectureBoundaryViolation {
+    ruleId: string;
+    file: string;
+    importSpecifier: string;
+    severity: 'info' | 'warning' | 'error';
+    line: number;
+    message: string;
+}
+export interface IArchitectureHighImpactFile {
+    file: string;
+    fanIn: number;
+    fanOut: number;
+}
+export interface IArchitectureMap {
+    schema: typeof ARCHITECTURE_MAP_SCHEMA;
+    generatedAt: string;
+    projectRoot: string;
+    layers: readonly IArchitectureLayer[];
+    publicApiSurfaces: readonly string[];
+    boundaryRules: readonly string[];
+    boundaryViolations: readonly IArchitectureBoundaryViolation[];
+    boundaryViolationCounts: {
+        error: number;
+        warning: number;
+        info: number;
+    };
+    constructsByKind: readonly {
+        kind: string;
+        count: number;
+    }[];
+    packs: readonly string[];
+    testsCoverageHint: string;
+    ownershipCoverageHint: string;
+    packArchitectureRules: readonly string[];
+    highImpactFiles: readonly IArchitectureHighImpactFile[];
+    suggestedReviewCommands: readonly string[];
+    risks: readonly IArchitectureRisk[];
+    graphSummary: IRepositoryIntelligenceGraph['summaries'];
+    signalsEnabled: boolean;
+}
+export declare function buildArchitectureMap(inspection: ISharkcraftInspection, options?: {
+    include?: readonly ArchitectureMapInclude[];
+    risk?: boolean;
+    signals?: boolean;
+}): Promise<IArchitectureMap>;
+export interface IArchitectureViolationsReport {
+    schema: 'sharkcraft.architecture-violations/v1';
+    generatedAt: string;
+    total: number;
+    byRule: readonly {
+        ruleId: string;
+        count: number;
+    }[];
+    violations: readonly IArchitectureBoundaryViolation[];
+}
+export declare function buildArchitectureViolations(inspection: ISharkcraftInspection): Promise<IArchitectureViolationsReport>;
+export type ArchitectureViolationDiffClassification = 'existing-touched' | 'new-in-changed-file' | 'resolved' | 'unknown';
+export interface IArchitectureViolationDiffEntry {
+    classification: ArchitectureViolationDiffClassification;
+    violation: IArchitectureBoundaryViolation;
+}
+export interface IArchitectureViolationsDiffReport {
+    schema: 'sharkcraft.architecture-violations-diff/v1';
+    generatedAt: string;
+    baselineLoaded: boolean;
+    baselineSource?: string;
+    filesProvided: readonly string[];
+    changedFilesFromGit: boolean;
+    warnings: readonly string[];
+    totalCurrent: number;
+    totalBaseline: number;
+    entries: readonly IArchitectureViolationDiffEntry[];
+    counts: {
+        existingTouched: number;
+        newInChangedFile: number;
+        resolved: number;
+        unknown: number;
+    };
+}
+export interface IArchitectureViolationsDiffOptions {
+    /** Files to scope to (relative to projectRoot). */
+    files?: readonly string[];
+    /** Git ref to derive changed files from (e.g. `main`). */
+    since?: string;
+    /** Use only staged files. */
+    staged?: boolean;
+    /** Baseline JSON path (output of `shrk architecture violations --json`). */
+    baselineFile?: string;
+}
+export declare function buildArchitectureViolationsDiff(inspection: ISharkcraftInspection, options?: IArchitectureViolationsDiffOptions): Promise<IArchitectureViolationsDiffReport>;
+export declare function renderArchitectureViolationsDiffText(report: IArchitectureViolationsDiffReport): string;
+export declare function renderArchitectureViolationsDiffMarkdown(report: IArchitectureViolationsDiffReport): string;
+export declare function renderArchitectureViolationsDiffHtml(report: IArchitectureViolationsDiffReport): string;
+export declare function buildArchitectureArea(inspection: ISharkcraftInspection, areaId: string): Promise<{
+    schema: 'sharkcraft.architecture-area/v1';
+    area: string;
+    members: readonly string[];
+    found: boolean;
+}>;
+export declare function renderArchitectureMapText(map: IArchitectureMap): string;
+export declare function renderArchitectureMapMarkdown(map: IArchitectureMap): string;
+export declare function renderArchitectureMapHtml(map: IArchitectureMap): string;
+//# sourceMappingURL=architecture-map.d.ts.map

package/dist/architecture-map.d.ts.map

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