@shrkcrft/inspector 0.1.0-alpha.2

package/dist/boundaries-changed-only.js

@@ -0,0 +1,97 @@
+/**
+ * Changed-only boundary filter.
+ *
+ * The boundary engine itself is unchanged. This module takes the raw
+ * violations list from `evaluateBoundaries` (or the polyglot equivalent) +
+ * a set of changed files, and returns:
+ *   - includedViolations:   violations whose origin file *or* the file that
+ *                           introduces the import edge is in the changed set.
+ *   - ignoredLegacyCount:   violations filtered out because no changed file
+ *                           touches them.
+ *   - ignoredLegacyByRule:  ignored counts grouped by ruleId.
+ *   - changedFiles:         the resolved changed-file set (project-relative).
+ *
+ * The engine never changes the violation contents — only filters.
+ */
+import { resolve } from 'node:path';
+import { getChangedFiles } from "./git-helpers.js";
+export var ChangedScopeMode;
+(function (ChangedScopeMode) {
+    ChangedScopeMode["ChangedOnly"] = "changed-only";
+    ChangedScopeMode["Since"] = "since";
+    ChangedScopeMode["Staged"] = "staged";
+    ChangedScopeMode["Files"] = "files";
+})(ChangedScopeMode || (ChangedScopeMode = {}));
+function normalisePath(input, projectRoot) {
+    if (!input)
+        return input;
+    if (input.startsWith('/') || /^[A-Za-z]:[\\/]/.test(input)) {
+        const rel = resolve(input).replace(resolve(projectRoot), '').replace(/^[\\/]+/, '');
+        return rel.split(/[\\/]/).join('/');
+    }
+    return input.split(/[\\/]/).join('/');
+}
+export function resolveChangedFiles(opts) {
+    if (opts.files && opts.files.length > 0) {
+        return {
+            mode: ChangedScopeMode.Files,
+            files: opts.files.map((f) => normalisePath(f, opts.projectRoot)),
+        };
+    }
+    if (opts.staged) {
+        const out = getChangedFiles(opts.projectRoot, { staged: true });
+        return { mode: ChangedScopeMode.Staged, files: out };
+    }
+    if (opts.since !== undefined && opts.since.length > 0) {
+        const out = getChangedFiles(opts.projectRoot, { since: opts.since });
+        return { mode: ChangedScopeMode.Since, files: out };
+    }
+    // default: working tree + unstaged
+    const out = getChangedFiles(opts.projectRoot, { includeWorktree: true });
+    return { mode: ChangedScopeMode.ChangedOnly, files: out };
+}
+export function filterViolationsToChangedScope(violations, opts) {
+    const { mode, files } = resolveChangedFiles(opts);
+    const changedSet = new Set(files.map((f) => f.split(/[\\/]/).join('/')));
+    const included = [];
+    const ignoredByRule = {};
+    for (const v of violations) {
+        const candidate = v.file ?? v.fromFile ?? '';
+        const norm = normalisePath(candidate, opts.projectRoot);
+        if (changedSet.has(norm)) {
+            included.push(v);
+            continue;
+        }
+        // Allow callers to pass changed-file paths with prefix differences.
+        // Lightweight fuzzy match: a violation file ending with /<changed>
+        // counts as introduced by that change too (rare path-tail case).
+        const matched = [...changedSet].some((cf) => cf.length > 0 && (norm === cf || norm.endsWith('/' + cf)));
+        if (matched) {
+            included.push(v);
+            continue;
+        }
+        ignoredByRule[v.ruleId] = (ignoredByRule[v.ruleId] ?? 0) + 1;
+    }
+    let ignoredLegacyCount = 0;
+    for (const v of Object.values(ignoredByRule))
+        ignoredLegacyCount += v;
+    return {
+        mode,
+        changedFiles: files,
+        includedViolations: included,
+        ignoredLegacyCount,
+        ignoredLegacyByRule: ignoredByRule,
+    };
+}
+export function buildChangedBoundaryReport(violations, opts) {
+    const filtered = filterViolationsToChangedScope(violations, opts);
+    return {
+        schema: 'sharkcraft.changed-boundary-report/v1',
+        mode: filtered.mode,
+        changedFiles: filtered.changedFiles,
+        totalViolations: violations.length,
+        includedViolations: filtered.includedViolations,
+        ignoredLegacyCount: filtered.ignoredLegacyCount,
+        ignoredLegacyByRule: filtered.ignoredLegacyByRule,
+    };
+}

package/dist/boundary-suggestions.d.ts

@@ -0,0 +1,20 @@
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export interface IBoundaryFixSuggestion {
+    ruleId: string;
+    file: string;
+    line: number;
+    importSpecifier: string;
+    suggestions: readonly string[];
+    relatedRule?: string;
+    relatedPathConvention?: string;
+}
+export interface IBoundaryViolationInput {
+    ruleId: string;
+    file: string;
+    line: number;
+    importSpecifier: string;
+    /** Already-known suggestedFix from boundary rule, if any. */
+    suggestedFix?: string;
+}
+export declare function suggestBoundaryFixes(inspection: ISharkcraftInspection, violations: readonly IBoundaryViolationInput[]): IBoundaryFixSuggestion[];
+//# sourceMappingURL=boundary-suggestions.d.ts.map

package/dist/boundary-suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-suggestions.d.ts","sourceRoot":"","sources":["../src/boundary-suggestions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,qBAAqB,EACjC,UAAU,EAAE,SAAS,uBAAuB,EAAE,GAC7C,sBAAsB,EAAE,CA4D1B"}

package/dist/boundary-suggestions.js

@@ -0,0 +1,51 @@
+export function suggestBoundaryFixes(inspection, violations) {
+    const out = [];
+    const paths = inspection.pathService.list();
+    const rules = inspection.ruleService.list();
+    for (const v of violations) {
+        const suggestions = [];
+        if (v.suggestedFix)
+            suggestions.push(v.suggestedFix);
+        // 1) Suggest the package's public entrypoint if the import dives into internals.
+        if (v.importSpecifier.startsWith('@') && v.importSpecifier.includes('/src/')) {
+            suggestions.push(`Import from the package's public entrypoint instead of a deep ${v.importSpecifier} path.`);
+        }
+        if (v.importSpecifier.includes('/dist/')) {
+            suggestions.push(`Avoid importing from /dist/; import the package by name.`);
+        }
+        if (v.importSpecifier.startsWith('../') && v.file.includes('/packages/')) {
+            suggestions.push(`Use the absolute package name ("@shrkcrft/<package>") instead of a relative ${v.importSpecifier} across package boundaries.`);
+        }
+        // 2) Adapter / layer fix hints based on common segments.
+        if (/\/adapter[s]?\//.test(v.file)) {
+            suggestions.push('Adapter files should depend on contracts only; introduce or use an interface in the adjacent contract package.');
+        }
+        // 3) Move-file suggestion when target file appears mis-located.
+        if (/\/(ui|dashboard|web)\//.test(v.file) && /\/(server|api|core)\//.test(v.importSpecifier)) {
+            suggestions.push('UI code should not import server/core directly — consider exposing an API client interface and moving this consumer to a shared adapter.');
+        }
+        // 4) Path-convention hint.
+        const path = paths.find((p) => v.file.includes(p.id) || v.file.includes(p.title));
+        if (path) {
+            suggestions.push(`Path convention "${path.id}" applies — check ${path.title} for the canonical location.`);
+        }
+        // 5) Related rule lookup.
+        const relatedRule = rules.find((r) => r.id === v.ruleId);
+        const item = {
+            ruleId: v.ruleId,
+            file: v.file,
+            line: v.line,
+            importSpecifier: v.importSpecifier,
+            suggestions: dedup(suggestions),
+        };
+        if (relatedRule)
+            item.relatedRule = relatedRule.id;
+        if (path)
+            item.relatedPathConvention = path.id;
+        out.push(item);
+    }
+    return out;
+}
+function dedup(xs) {
+    return [...new Set(xs.filter((s) => s && s.trim().length > 0))];
+}

package/dist/bundle-diff.d.ts

@@ -0,0 +1,98 @@
+import { type IFeatureBundle } from './feature-bundle.js';
+export declare const BUNDLE_DIFF_SCHEMA = "sharkcraft.bundle-diff/v1";
+export type BundleDiffFormat = 'text' | 'markdown' | 'html' | 'json';
+export interface IBundleDiffPlanChange {
+    name: string;
+    change: 'status' | 'targets' | 'template' | 'variables' | 'review' | 'missing-variables';
+    from: unknown;
+    to: unknown;
+}
+export interface IBundleDiffRename {
+    from: string;
+    to: string;
+    confidence: number;
+    reasons: readonly string[];
+}
+export interface IBundleDiffReport {
+    schema: typeof BUNDLE_DIFF_SCHEMA;
+    generatedAt: string;
+    aId: string;
+    bId: string;
+    metadataChanges: {
+        task: {
+            from: string;
+            to: string;
+        } | null;
+        status: {
+            from: string;
+            to: string;
+        } | null;
+        riskLevel: {
+            from: string;
+            to: string;
+        } | null;
+        nextAction: {
+            from: string | null;
+            to: string | null;
+        } | null;
+    };
+    addedPlans: readonly string[];
+    removedPlans: readonly string[];
+    changedPlans: readonly IBundleDiffPlanChange[];
+    /** Probable renamed plans (taken out of addedPlans/removedPlans). */
+    renamedPlans: readonly IBundleDiffRename[];
+    /** Medium-confidence rename candidates (left in add/remove). */
+    possibleRenames: readonly IBundleDiffRename[];
+    dependencies: {
+        added: readonly {
+            from: string;
+            to: string;
+            reason: string;
+        }[];
+        removed: readonly {
+            from: string;
+            to: string;
+            reason: string;
+        }[];
+    };
+    planGroups: {
+        added: readonly string[];
+        removed: readonly string[];
+        changed: readonly {
+            id: string;
+            addedPlans: string[];
+            removedPlans: string[];
+        }[];
+    };
+    validations: {
+        added: readonly {
+            startedAt: string;
+            passed: boolean;
+        }[];
+        removed: readonly {
+            startedAt: string;
+            passed: boolean;
+        }[];
+    };
+    affectedFiles: {
+        added: readonly string[];
+        removed: readonly string[];
+    };
+    warnings: readonly string[];
+    summary: {
+        totalChanges: number;
+        addedPlans: number;
+        removedPlans: number;
+        changedPlans: number;
+        renamedPlans: number;
+    };
+}
+export declare function buildBundleDiff(a: IFeatureBundle, b: IFeatureBundle): IBundleDiffReport;
+export declare function buildBundleDiffFromIds(cwd: string, aId: string, bId: string): IBundleDiffReport | {
+    error: string;
+};
+export declare function renderBundleDiffText(diff: IBundleDiffReport): string;
+export declare function renderBundleDiffMarkdown(diff: IBundleDiffReport): string;
+export declare function renderBundleDiffHtml(diff: IBundleDiffReport): string;
+export declare function renderBundleDiff(diff: IBundleDiffReport, format: BundleDiffFormat): string;
+//# sourceMappingURL=bundle-diff.d.ts.map

package/dist/bundle-diff.d.ts.map

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