@shrkcrft/inspector 0.1.0-alpha.2

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

@@ -0,0 +1,19 @@
+import { LanguageId } from './language-id.js';
+export declare const POLYGLOT_TEST_IMPACT_SCHEMA = "sharkcraft.polyglot-test-impact/v1";
+export interface IPolyglotImpactedTest {
+    sourceFile: string;
+    language: LanguageId;
+    predictedTests: readonly string[];
+    reason: string;
+}
+export interface IPolyglotTestImpact {
+    schema: typeof POLYGLOT_TEST_IMPACT_SCHEMA;
+    generatedAt: string;
+    projectRoot: string;
+    impacted: readonly IPolyglotImpactedTest[];
+    missingTests: readonly string[];
+    notes: readonly string[];
+}
+export declare function computePolyglotTestImpact(projectRoot: string, changedFiles: readonly string[]): IPolyglotTestImpact;
+export declare function renderPolyglotTestImpactText(r: IPolyglotTestImpact): string;
+//# sourceMappingURL=test-impact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-impact.d.ts","sourceRoot":"","sources":["../../src/languages/test-impact.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,eAAO,MAAM,2BAA2B,uCAAuC,CAAC;AAEhF,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,UAAU,CAAC;IACrB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,2BAA2B,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3C,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAwED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,SAAS,MAAM,EAAE,GAC9B,mBAAmB,CAoDrB;AAED,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAmB3E"}

package/dist/languages/test-impact.js

@@ -0,0 +1,157 @@
+/**
+ * Polyglot test impact.
+ *
+ * Given a set of changed source files, predict the per-language test files
+ * that should run. Deterministic naming conventions per language.
+ */
+import { existsSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { LanguageId } from "./language-id.js";
+export const POLYGLOT_TEST_IMPACT_SCHEMA = 'sharkcraft.polyglot-test-impact/v1';
+function classifyExtension(file) {
+    if (file.endsWith('.java'))
+        return LanguageId.Java;
+    if (file.endsWith('.cs'))
+        return LanguageId.CSharp;
+    if (file.endsWith('.py'))
+        return LanguageId.Python;
+    if (file.endsWith('.go'))
+        return LanguageId.Go;
+    if (file.endsWith('.rs'))
+        return LanguageId.Rust;
+    if (file.endsWith('.ts') || file.endsWith('.tsx'))
+        return LanguageId.TypeScript;
+    if (file.endsWith('.js') || file.endsWith('.jsx'))
+        return LanguageId.JavaScript;
+    return LanguageId.Unknown;
+}
+function predictJava(file) {
+    const out = new Set();
+    const inMain = file.replace('/main/java/', '/test/java/');
+    if (inMain !== file) {
+        out.add(inMain.replace(/\.java$/, 'Test.java'));
+        out.add(inMain.replace(/\.java$/, 'Tests.java'));
+        out.add(inMain.replace(/\.java$/, 'IT.java'));
+    }
+    else {
+        out.add(file.replace(/\.java$/, 'Test.java'));
+    }
+    return [...out];
+}
+function predictCSharp(file) {
+    const dir = nodePath.dirname(file);
+    const base = nodePath.basename(file, '.cs');
+    const candidates = [];
+    candidates.push(nodePath.join(dir, `${base}Tests.cs`));
+    candidates.push(nodePath.join(dir, `${base}Test.cs`));
+    // Mirror to a sibling `*.Tests` project — covers both `/src/` (mid-path)
+    // and `src/` (root-relative) layouts.
+    if (file.includes('/src/'))
+        candidates.push(file.replace(/\/src\//, '/tests/').replace(/\.cs$/, 'Tests.cs'));
+    if (file.startsWith('src/'))
+        candidates.push('tests/' + file.slice('src/'.length).replace(/\.cs$/, 'Tests.cs'));
+    return candidates;
+}
+function predictPython(file) {
+    const dir = nodePath.dirname(file);
+    const base = nodePath.basename(file, '.py');
+    return [
+        nodePath.join(dir, `test_${base}.py`),
+        nodePath.join(dir, `${base}_test.py`),
+        file.replace(/\/src\//, '/tests/').replace(/\/([^/]+)\.py$/, '/test_$1.py'),
+        nodePath.join('tests', `test_${base}.py`),
+    ];
+}
+function predictGo(file) {
+    return [file.replace(/\.go$/, '_test.go')];
+}
+function predictRust(file) {
+    const out = [];
+    // Inline `#[cfg(test)] mod tests {}` lives in the file itself — flag it.
+    out.push(file);
+    // Mirror to `tests/<basename>.rs` for integration tests.
+    const base = nodePath.basename(file, '.rs');
+    out.push(nodePath.join('tests', `${base}.rs`));
+    return out;
+}
+function predictTs(file) {
+    const out = [];
+    out.push(file.replace(/\.tsx?$/, '.test.ts'));
+    out.push(file.replace(/\.tsx?$/, '.spec.ts'));
+    out.push(file.replace(/\/src\//, '/__tests__/').replace(/\.tsx?$/, '.test.ts'));
+    return out;
+}
+export function computePolyglotTestImpact(projectRoot, changedFiles) {
+    const impacted = [];
+    const missing = [];
+    for (const raw of changedFiles) {
+        const rel = raw.startsWith('/') ? nodePath.relative(projectRoot, raw) : raw;
+        const lang = classifyExtension(rel);
+        let predicted;
+        let reason;
+        switch (lang) {
+            case LanguageId.Java:
+                predicted = predictJava(rel);
+                reason = 'src/main/java → src/test/java; *Test / *Tests / *IT.';
+                break;
+            case LanguageId.CSharp:
+                predicted = predictCSharp(rel);
+                reason = 'FooTests.cs / FooTest.cs; sibling Tests project.';
+                break;
+            case LanguageId.Python:
+                predicted = predictPython(rel);
+                reason = 'test_*.py / *_test.py; tests/ mirror.';
+                break;
+            case LanguageId.Go:
+                predicted = predictGo(rel);
+                reason = 'foo.go → foo_test.go.';
+                break;
+            case LanguageId.Rust:
+                predicted = predictRust(rel);
+                reason = 'inline #[cfg(test)] + tests/ integration.';
+                break;
+            case LanguageId.TypeScript:
+            case LanguageId.JavaScript:
+                predicted = predictTs(rel);
+                reason = '.test.ts / .spec.ts companion.';
+                break;
+            default:
+                predicted = [];
+                reason = `No prediction rule for ${lang}.`;
+        }
+        impacted.push({ sourceFile: rel, language: lang, predictedTests: predicted, reason });
+        const anyExists = predicted.some((t) => existsSync(nodePath.join(projectRoot, t)));
+        if (predicted.length > 0 && !anyExists && lang !== LanguageId.Unknown) {
+            missing.push(rel);
+        }
+    }
+    return {
+        schema: POLYGLOT_TEST_IMPACT_SCHEMA,
+        generatedAt: new Date().toISOString(),
+        projectRoot,
+        impacted,
+        missingTests: missing,
+        notes: ['Predictions are deterministic and naive; they do not run tests.'],
+    };
+}
+export function renderPolyglotTestImpactText(r) {
+    let out = `=== Polyglot test impact ===\n`;
+    out += `  project root   ${r.projectRoot}\n`;
+    out += `  changed files  ${r.impacted.length}\n`;
+    out += `  missing tests  ${r.missingTests.length}\n\n`;
+    for (const i of r.impacted) {
+        out += `[${i.language}] ${i.sourceFile}\n`;
+        out += `  reason: ${i.reason}\n`;
+        for (const t of i.predictedTests) {
+            const exists = existsSync(nodePath.join(r.projectRoot, t)) ? '✓' : ' ';
+            out += `  ${exists}  ${t}\n`;
+        }
+        out += `\n`;
+    }
+    if (r.missingTests.length > 0) {
+        out += `Missing tests for:\n`;
+        for (const m of r.missingTests)
+            out += `  • ${m}\n`;
+    }
+    return out;
+}

package/dist/loader-diagnostics.d.ts

@@ -0,0 +1,40 @@
+import type { LoaderAssetKind, LoaderAssetStatus } from './inspector-cache.js';
+export type LoaderOrigin = 'local-config' | 'pack-manifest';
+export interface ILoaderDiagnostic {
+    filePath: string;
+    kind: LoaderAssetKind;
+    origin: LoaderOrigin;
+    packName?: string;
+    elapsedMs: number;
+    status: LoaderAssetStatus | 'cached-skip';
+    /** Number of items extracted (entries/templates/etc). */
+    count: number;
+    warningCount: number;
+    errorMessage?: string;
+    /** When status === 'cached-skip', this is the cached pre-existing status. */
+    cachedStatus?: LoaderAssetStatus;
+    /** Whether this load hit the in-memory import dedup. */
+    deduped: boolean;
+    /** Whether the file exceeded the large-file threshold. */
+    largeFile: boolean;
+    /** File size in bytes, when known. */
+    sizeBytes?: number;
+    /** Whether the elapsed time crossed the slow threshold. */
+    slow: boolean;
+    /** Suggested next command for the user to debug this. */
+    suggestedNextCommand?: string;
+}
+export declare const DEFAULT_SLOW_LOADER_THRESHOLD_MS = 1500;
+export declare const LARGE_FILE_THRESHOLD_BYTES: number;
+export declare function formatLoaderDiagnosticLine(d: ILoaderDiagnostic): string;
+export declare function summarizeLoaderDiagnostics(diagnostics: readonly ILoaderDiagnostic[]): {
+    totalLoaders: number;
+    totalElapsedMs: number;
+    failed: number;
+    timedOut: number;
+    cachedSkips: number;
+    deduped: number;
+    largeFiles: number;
+    slowLoaders: number;
+};
+//# sourceMappingURL=loader-diagnostics.d.ts.map

package/dist/loader-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-diagnostics.d.ts","sourceRoot":"","sources":["../src/loader-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,eAAe,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAAC;IAC1C,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,IAAI,EAAE,OAAO,CAAC;IACd,yDAAyD;IACzD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,gCAAgC,OAAO,CAAC;AACrD,eAAO,MAAM,0BAA0B,QAAa,CAAC;AAErD,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAQvE;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,GAAG;IACrF,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CA2BA"}

package/dist/loader-diagnostics.js

@@ -0,0 +1,49 @@
+export const DEFAULT_SLOW_LOADER_THRESHOLD_MS = 1500;
+export const LARGE_FILE_THRESHOLD_BYTES = 256 * 1024;
+export function formatLoaderDiagnosticLine(d) {
+    const flags = [];
+    if (d.deduped)
+        flags.push('deduped');
+    if (d.largeFile)
+        flags.push('large');
+    if (d.slow)
+        flags.push('slow');
+    if (d.status === 'cached-skip')
+        flags.push(`cached:${d.cachedStatus ?? 'n/a'}`);
+    const flagStr = flags.length ? ` [${flags.join(', ')}]` : '';
+    return `  ${d.kind.padEnd(10)} ${d.status.padEnd(12)} ${d.elapsedMs.toString().padStart(5)}ms  count=${d.count}${flagStr}  ${d.filePath}`;
+}
+export function summarizeLoaderDiagnostics(diagnostics) {
+    let totalElapsedMs = 0;
+    let failed = 0;
+    let timedOut = 0;
+    let cachedSkips = 0;
+    let deduped = 0;
+    let largeFiles = 0;
+    let slowLoaders = 0;
+    for (const d of diagnostics) {
+        totalElapsedMs += d.elapsedMs;
+        if (d.status === 'failed')
+            failed += 1;
+        else if (d.status === 'timeout')
+            timedOut += 1;
+        else if (d.status === 'cached-skip')
+            cachedSkips += 1;
+        if (d.deduped)
+            deduped += 1;
+        if (d.largeFile)
+            largeFiles += 1;
+        if (d.slow)
+            slowLoaders += 1;
+    }
+    return {
+        totalLoaders: diagnostics.length,
+        totalElapsedMs,
+        failed,
+        timedOut,
+        cachedSkips,
+        deduped,
+        largeFiles,
+        slowLoaders,
+    };
+}

package/dist/memory-diff.d.ts

@@ -0,0 +1,60 @@
+import { type IMemoryDiagnosticEntry, type IMemoryFileEntry, type IRepositoryMemoryIndex } from './repo-memory.js';
+export declare const MEMORY_DIFF_SCHEMA = "sharkcraft.memory-diff/v1";
+export declare enum MemoryRiskTrend {
+    Improving = "improving",
+    Stable = "stable",
+    Worsening = "worsening",
+    Unknown = "unknown"
+}
+export interface IMemoryFileDelta {
+    path: string;
+    beforeScore: number;
+    afterScore: number;
+    delta: number;
+}
+export interface IMemoryDiagnosticDelta {
+    code: string;
+    beforeCount: number;
+    afterCount: number;
+    delta: number;
+}
+export interface IMemoryDiffReport {
+    schema: typeof MEMORY_DIFF_SCHEMA;
+    generatedAt: string;
+    hasPrevious: boolean;
+    riskTrend: MemoryRiskTrend;
+    beforeGeneratedAt?: string;
+    afterGeneratedAt: string;
+    totalScoreBefore: number;
+    totalScoreAfter: number;
+    totalScoreDelta: number;
+    newRiskyFiles: readonly IMemoryFileEntry[];
+    resolvedRiskyFiles: readonly IMemoryFileEntry[];
+    worseningFiles: readonly IMemoryFileDelta[];
+    improvingFiles: readonly IMemoryFileDelta[];
+    newRecurringDiagnostics: readonly IMemoryDiagnosticEntry[];
+    resolvedDiagnostics: readonly IMemoryDiagnosticEntry[];
+    diagnosticDeltas: readonly IMemoryDiagnosticDelta[];
+    newPlanConflicts: readonly string[];
+    newFailedValidationCommands: readonly string[];
+    newRecurringBoundaryViolations: readonly string[];
+    newRecurringPolicyViolations: readonly string[];
+    newPackIssues: readonly string[];
+    changedTopConstructs: readonly {
+        id: string;
+        beforeWeight: number;
+        afterWeight: number;
+        delta: number;
+    }[];
+    suggestedActions: readonly string[];
+    notes: readonly string[];
+}
+export declare function diffMemoryIndex(before: IRepositoryMemoryIndex | null, after: IRepositoryMemoryIndex): IMemoryDiffReport;
+export declare function memoryHistoryDir(projectRoot: string): string;
+export declare function writeMemorySnapshot(projectRoot: string, index: IRepositoryMemoryIndex): string;
+export declare function listMemorySnapshots(projectRoot: string): string[];
+export declare function loadMemorySnapshot(file: string): IRepositoryMemoryIndex | null;
+export declare function latestMemorySnapshot(projectRoot: string): IRepositoryMemoryIndex | null;
+export declare function renderMemoryDiffText(d: IMemoryDiffReport): string;
+export declare function renderMemoryDiffMarkdown(d: IMemoryDiffReport): string;
+//# sourceMappingURL=memory-diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-diff.d.ts","sourceRoot":"","sources":["../src/memory-diff.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC5B,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,kBAAkB,8BAA8B,CAAC;AAE9D,oBAAY,eAAe;IACzB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,kBAAkB,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,eAAe,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3C,kBAAkB,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,cAAc,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C,cAAc,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C,uBAAuB,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3D,mBAAmB,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACvD,gBAAgB,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACpD,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,2BAA2B,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,8BAA8B,EAAE,SAAS,MAAM,EAAE,CAAC;IAClD,4BAA4B,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,oBAAoB,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1G,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAWD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,sBAAsB,GAAG,IAAI,EACrC,KAAK,EAAE,sBAAsB,GAC5B,iBAAiB,CA8InB;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAO9F;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOjE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAO9E;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAIvF;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CA+CjE;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAgCrE"}

package/dist/memory-diff.js

@@ -0,0 +1,302 @@
+/**
+ * Memory diff + drift.
+ *
+ * Compare two `IRepositoryMemoryIndex` snapshots to surface what got worse,
+ * what got better, and overall trend. Pure local, no network.
+ *
+ * History storage lives under `.sharkcraft/memory/history/<ts>-memory.json`.
+ * `shrk memory build --write-snapshot` writes one each time.
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { memoryDir, } from "./repo-memory.js";
+export const MEMORY_DIFF_SCHEMA = 'sharkcraft.memory-diff/v1';
+export var MemoryRiskTrend;
+(function (MemoryRiskTrend) {
+    MemoryRiskTrend["Improving"] = "improving";
+    MemoryRiskTrend["Stable"] = "stable";
+    MemoryRiskTrend["Worsening"] = "worsening";
+    MemoryRiskTrend["Unknown"] = "unknown";
+})(MemoryRiskTrend || (MemoryRiskTrend = {}));
+function scoreFile(f) {
+    return f.touchCount + f.conflictCount * 4 + f.failedValidationCount * 3 + f.warningCount;
+}
+function diffArrayOnly(after, before) {
+    const set = new Set(before);
+    return after.filter((x) => !set.has(x));
+}
+export function diffMemoryIndex(before, after) {
+    if (!before) {
+        return {
+            schema: MEMORY_DIFF_SCHEMA,
+            generatedAt: new Date().toISOString(),
+            hasPrevious: false,
+            riskTrend: MemoryRiskTrend.Unknown,
+            afterGeneratedAt: after.generatedAt,
+            totalScoreBefore: 0,
+            totalScoreAfter: after.files.reduce((sum, f) => sum + scoreFile(f), 0),
+            totalScoreDelta: after.files.reduce((sum, f) => sum + scoreFile(f), 0),
+            newRiskyFiles: after.files.slice(0, 20),
+            resolvedRiskyFiles: [],
+            worseningFiles: [],
+            improvingFiles: [],
+            newRecurringDiagnostics: after.diagnostics.slice(0, 20),
+            resolvedDiagnostics: [],
+            diagnosticDeltas: [],
+            newPlanConflicts: [...after.plansWithConflicts],
+            newFailedValidationCommands: [...after.failedValidationCommands],
+            newRecurringBoundaryViolations: [...after.boundaryViolationsRecurring],
+            newRecurringPolicyViolations: [...after.policyViolationsRecurring],
+            newPackIssues: [...after.packIssues],
+            changedTopConstructs: [],
+            suggestedActions: [
+                'No previous snapshot — run `shrk memory build --write-snapshot` regularly to enable drift tracking.',
+            ],
+            notes: ['No previous memory snapshot available.'],
+        };
+    }
+    const beforeByPath = new Map(before.files.map((f) => [f.path, f]));
+    const afterByPath = new Map(after.files.map((f) => [f.path, f]));
+    const newRiskyFiles = [];
+    const resolvedRiskyFiles = [];
+    const worseningFiles = [];
+    const improvingFiles = [];
+    for (const f of after.files) {
+        const prev = beforeByPath.get(f.path);
+        if (!prev) {
+            newRiskyFiles.push(f);
+            continue;
+        }
+        const beforeScore = scoreFile(prev);
+        const afterScore = scoreFile(f);
+        if (afterScore > beforeScore) {
+            worseningFiles.push({ path: f.path, beforeScore, afterScore, delta: afterScore - beforeScore });
+        }
+        else if (afterScore < beforeScore) {
+            improvingFiles.push({ path: f.path, beforeScore, afterScore, delta: afterScore - beforeScore });
+        }
+    }
+    for (const f of before.files) {
+        if (!afterByPath.has(f.path))
+            resolvedRiskyFiles.push(f);
+    }
+    const beforeDiag = new Map(before.diagnostics.map((d) => [d.code, d]));
+    const afterDiag = new Map(after.diagnostics.map((d) => [d.code, d]));
+    const newRecurringDiagnostics = [];
+    const resolvedDiagnostics = [];
+    const diagnosticDeltas = [];
+    for (const d of after.diagnostics) {
+        const prev = beforeDiag.get(d.code);
+        if (!prev)
+            newRecurringDiagnostics.push(d);
+        else if (prev.count !== d.count)
+            diagnosticDeltas.push({ code: d.code, beforeCount: prev.count, afterCount: d.count, delta: d.count - prev.count });
+    }
+    for (const d of before.diagnostics) {
+        if (!afterDiag.has(d.code))
+            resolvedDiagnostics.push(d);
+    }
+    const newPlanConflicts = diffArrayOnly(after.plansWithConflicts, before.plansWithConflicts);
+    const newFailedValidationCommands = diffArrayOnly(after.failedValidationCommands, before.failedValidationCommands);
+    const newRecurringBoundaryViolations = diffArrayOnly(after.boundaryViolationsRecurring, before.boundaryViolationsRecurring);
+    const newRecurringPolicyViolations = diffArrayOnly(after.policyViolationsRecurring, before.policyViolationsRecurring);
+    const newPackIssues = diffArrayOnly(after.packIssues, before.packIssues);
+    const beforeConstructs = new Map(before.highRiskConstructs.map((c) => [c.id, c.weight]));
+    const changedTopConstructs = [];
+    for (const c of after.highRiskConstructs) {
+        const prev = beforeConstructs.get(c.id) ?? 0;
+        if (prev !== c.weight)
+            changedTopConstructs.push({ id: c.id, beforeWeight: prev, afterWeight: c.weight, delta: c.weight - prev });
+    }
+    const totalScoreBefore = before.files.reduce((sum, f) => sum + scoreFile(f), 0);
+    const totalScoreAfter = after.files.reduce((sum, f) => sum + scoreFile(f), 0);
+    const totalScoreDelta = totalScoreAfter - totalScoreBefore;
+    // Trend: weighted by both file score and new diagnostics/conflicts.
+    const worseSignals = newRiskyFiles.length * 2 +
+        worseningFiles.length +
+        newRecurringDiagnostics.length * 2 +
+        newPlanConflicts.length * 3 +
+        newRecurringBoundaryViolations.length * 2 +
+        newRecurringPolicyViolations.length * 2 +
+        Math.max(0, totalScoreDelta);
+    const betterSignals = resolvedRiskyFiles.length * 2 +
+        improvingFiles.length +
+        resolvedDiagnostics.length * 2 +
+        Math.max(0, -totalScoreDelta);
+    let riskTrend = MemoryRiskTrend.Stable;
+    if (worseSignals > betterSignals * 1.5 && worseSignals > 2)
+        riskTrend = MemoryRiskTrend.Worsening;
+    else if (betterSignals > worseSignals * 1.5 && betterSignals > 2)
+        riskTrend = MemoryRiskTrend.Improving;
+    const suggestedActions = [];
+    if (newRiskyFiles.length > 0)
+        suggestedActions.push(`Review newly risky files: ${newRiskyFiles.slice(0, 3).map((f) => f.path).join(', ')}.`);
+    if (newPlanConflicts.length > 0)
+        suggestedActions.push(`Inspect ${newPlanConflicts.length} new plan(s) with conflicts.`);
+    if (newRecurringBoundaryViolations.length > 0)
+        suggestedActions.push(`New recurring boundary violations: ${newRecurringBoundaryViolations.join(', ')}.`);
+    if (newRecurringPolicyViolations.length > 0)
+        suggestedActions.push(`New recurring policy violations: ${newRecurringPolicyViolations.join(', ')}.`);
+    if (newPackIssues.length > 0)
+        suggestedActions.push(`Pack issues regressed: ${newPackIssues.join(', ')}.`);
+    if (riskTrend === MemoryRiskTrend.Worsening)
+        suggestedActions.push('Trend worsening — consider scheduling cleanup or freezing risky changes.');
+    return {
+        schema: MEMORY_DIFF_SCHEMA,
+        generatedAt: new Date().toISOString(),
+        hasPrevious: true,
+        riskTrend,
+        beforeGeneratedAt: before.generatedAt,
+        afterGeneratedAt: after.generatedAt,
+        totalScoreBefore,
+        totalScoreAfter,
+        totalScoreDelta,
+        newRiskyFiles: newRiskyFiles.slice(0, 30),
+        resolvedRiskyFiles: resolvedRiskyFiles.slice(0, 30),
+        worseningFiles: worseningFiles.sort((a, b) => b.delta - a.delta).slice(0, 30),
+        improvingFiles: improvingFiles.sort((a, b) => a.delta - b.delta).slice(0, 30),
+        newRecurringDiagnostics: newRecurringDiagnostics.slice(0, 30),
+        resolvedDiagnostics: resolvedDiagnostics.slice(0, 30),
+        diagnosticDeltas: diagnosticDeltas.sort((a, b) => Math.abs(b.delta) - Math.abs(a.delta)).slice(0, 30),
+        newPlanConflicts,
+        newFailedValidationCommands,
+        newRecurringBoundaryViolations,
+        newRecurringPolicyViolations,
+        newPackIssues,
+        changedTopConstructs: changedTopConstructs.sort((a, b) => Math.abs(b.delta) - Math.abs(a.delta)).slice(0, 30),
+        suggestedActions,
+        notes: [],
+    };
+}
+export function memoryHistoryDir(projectRoot) {
+    return nodePath.join(memoryDir(projectRoot), 'history');
+}
+export function writeMemorySnapshot(projectRoot, index) {
+    const dir = memoryHistoryDir(projectRoot);
+    mkdirSync(dir, { recursive: true });
+    const stamp = (index.generatedAt || new Date().toISOString()).replace(/[:.]/g, '-');
+    const file = nodePath.join(dir, `${stamp}-memory.json`);
+    writeFileSync(file, JSON.stringify(index, null, 2) + '\n', 'utf8');
+    return file;
+}
+export function listMemorySnapshots(projectRoot) {
+    const dir = memoryHistoryDir(projectRoot);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((f) => f.endsWith('-memory.json'))
+        .map((f) => nodePath.join(dir, f))
+        .sort();
+}
+export function loadMemorySnapshot(file) {
+    if (!existsSync(file))
+        return null;
+    try {
+        return JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function latestMemorySnapshot(projectRoot) {
+    const list = listMemorySnapshots(projectRoot);
+    if (list.length === 0)
+        return null;
+    return loadMemorySnapshot(list[list.length - 1]);
+}
+export function renderMemoryDiffText(d) {
+    let out = `=== Memory diff ===\n`;
+    out += `  trend            ${d.riskTrend}\n`;
+    out += `  before generated ${d.beforeGeneratedAt ?? '(none)'}\n`;
+    out += `  after generated  ${d.afterGeneratedAt}\n`;
+    out += `  score before     ${d.totalScoreBefore}\n`;
+    out += `  score after      ${d.totalScoreAfter}  (Δ ${d.totalScoreDelta >= 0 ? '+' : ''}${d.totalScoreDelta})\n\n`;
+    if (d.newRiskyFiles.length) {
+        out += `Newly risky files:\n`;
+        for (const f of d.newRiskyFiles.slice(0, 10))
+            out += `  + ${f.path} (touches=${f.touchCount}, conflicts=${f.conflictCount})\n`;
+        out += `\n`;
+    }
+    if (d.resolvedRiskyFiles.length) {
+        out += `Resolved risky files:\n`;
+        for (const f of d.resolvedRiskyFiles.slice(0, 10))
+            out += `  - ${f.path}\n`;
+        out += `\n`;
+    }
+    if (d.worseningFiles.length) {
+        out += `Worsening files:\n`;
+        for (const f of d.worseningFiles.slice(0, 10))
+            out += `  ↑ ${f.path}  ${f.beforeScore} → ${f.afterScore} (+${f.delta})\n`;
+        out += `\n`;
+    }
+    if (d.improvingFiles.length) {
+        out += `Improving files:\n`;
+        for (const f of d.improvingFiles.slice(0, 10))
+            out += `  ↓ ${f.path}  ${f.beforeScore} → ${f.afterScore} (${f.delta})\n`;
+        out += `\n`;
+    }
+    if (d.newRecurringDiagnostics.length) {
+        out += `New recurring diagnostics: ${d.newRecurringDiagnostics.map((x) => x.code).join(', ')}\n\n`;
+    }
+    if (d.resolvedDiagnostics.length) {
+        out += `Resolved diagnostics: ${d.resolvedDiagnostics.map((x) => x.code).join(', ')}\n\n`;
+    }
+    if (d.newPlanConflicts.length)
+        out += `New plan conflicts: ${d.newPlanConflicts.length}\n\n`;
+    if (d.newRecurringBoundaryViolations.length)
+        out += `New recurring boundary violations: ${d.newRecurringBoundaryViolations.join(', ')}\n\n`;
+    if (d.newRecurringPolicyViolations.length)
+        out += `New recurring policy violations: ${d.newRecurringPolicyViolations.join(', ')}\n\n`;
+    if (d.newPackIssues.length)
+        out += `New pack issues: ${d.newPackIssues.join(', ')}\n\n`;
+    if (d.suggestedActions.length) {
+        out += `Suggested actions:\n`;
+        for (const a of d.suggestedActions)
+            out += `  • ${a}\n`;
+        out += `\n`;
+    }
+    if (d.notes.length) {
+        out += `Notes:\n`;
+        for (const n of d.notes)
+            out += `  • ${n}\n`;
+    }
+    return out;
+}
+export function renderMemoryDiffMarkdown(d) {
+    let out = `# Memory diff\n\n`;
+    out += `- **trend**: ${d.riskTrend}\n`;
+    out += `- **before generated**: ${d.beforeGeneratedAt ?? '(none)'}\n`;
+    out += `- **after generated**: ${d.afterGeneratedAt}\n`;
+    out += `- **score**: ${d.totalScoreBefore} → ${d.totalScoreAfter} (Δ ${d.totalScoreDelta >= 0 ? '+' : ''}${d.totalScoreDelta})\n\n`;
+    if (d.newRiskyFiles.length) {
+        out += `## Newly risky files\n`;
+        for (const f of d.newRiskyFiles.slice(0, 15))
+            out += `- \`${f.path}\` — touches ${f.touchCount}, conflicts ${f.conflictCount}\n`;
+        out += `\n`;
+    }
+    if (d.resolvedRiskyFiles.length) {
+        out += `## Resolved risky files\n`;
+        for (const f of d.resolvedRiskyFiles.slice(0, 15))
+            out += `- \`${f.path}\`\n`;
+        out += `\n`;
+    }
+    if (d.worseningFiles.length) {
+        out += `## Worsening files\n| File | Before | After | Δ |\n| --- | --- | --- | --- |\n`;
+        for (const f of d.worseningFiles.slice(0, 15))
+            out += `| \`${f.path}\` | ${f.beforeScore} | ${f.afterScore} | +${f.delta} |\n`;
+        out += `\n`;
+    }
+    if (d.improvingFiles.length) {
+        out += `## Improving files\n| File | Before | After | Δ |\n| --- | --- | --- | --- |\n`;
+        for (const f of d.improvingFiles.slice(0, 15))
+            out += `| \`${f.path}\` | ${f.beforeScore} | ${f.afterScore} | ${f.delta} |\n`;
+        out += `\n`;
+    }
+    if (d.suggestedActions.length) {
+        out += `## Suggested actions\n`;
+        for (const a of d.suggestedActions)
+            out += `- ${a}\n`;
+        out += `\n`;
+    }
+    return out;
+}

package/dist/migration-profile-registry.d.ts

@@ -0,0 +1,26 @@
+import { type IMigrationProfile } from './migration-readiness.js';
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export declare const MIGRATION_PROFILE_REGISTRY_SCHEMA = "sharkcraft.migration-profile-registry/v1";
+export declare enum MigrationProfileSource {
+    Local = "local",
+    Pack = "pack"
+}
+export interface IMigrationProfileEntry {
+    readonly profile: IMigrationProfile;
+    readonly source: MigrationProfileSource;
+    readonly packageName?: string;
+    readonly sourceFile: string;
+}
+export interface IMigrationProfileRegistryIssue {
+    readonly severity: 'info' | 'warning' | 'error';
+    readonly code: string;
+    readonly message: string;
+    readonly profileId?: string;
+    readonly source?: string;
+}
+export declare function loadMigrationProfiles(inspection: ISharkcraftInspection): Promise<{
+    entries: readonly IMigrationProfileEntry[];
+    issues: readonly IMigrationProfileRegistryIssue[];
+}>;
+export declare function listMigrationProfilesFromPacks(inspection: ISharkcraftInspection): Promise<readonly IMigrationProfile[]>;
+//# sourceMappingURL=migration-profile-registry.d.ts.map

package/dist/migration-profile-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-profile-registry.d.ts","sourceRoot":"","sources":["../src/migration-profile-registry.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,iCAAiC,6CAA6C,CAAC;AAE5F,oBAAY,sBAAsB;IAChC,KAAK,UAAU;IACf,IAAI,SAAS;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAkCD,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC;IACT,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC3C,MAAM,EAAE,SAAS,8BAA8B,EAAE,CAAC;CACnD,CAAC,CAkFD;AAED,wBAAsB,8BAA8B,CAClD,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAGvC"}