@shrkcrft/inspector 0.1.0-alpha.1

package/dist/repo-memory.d.ts

@@ -0,0 +1,95 @@
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export declare const REPO_MEMORY_SCHEMA = "sharkcraft.memory/v1";
+export interface IMemoryFileEntry {
+    path: string;
+    touchCount: number;
+    conflictCount: number;
+    failedValidationCount: number;
+    warningCount: number;
+}
+export interface IMemoryDiagnosticEntry {
+    code: string;
+    count: number;
+    lastSeen?: string;
+}
+export interface IMemoryPlaybookEntry {
+    id: string;
+    successCount: number;
+    failureCount: number;
+}
+export interface IMemoryConstructEntry {
+    id: string;
+    weight: number;
+    lastSeen?: string;
+}
+export interface ILanguageHotspot {
+    language: string;
+    fileCount: number;
+    totalWeight: number;
+    topFiles: readonly string[];
+}
+export interface ILanguageRiskTrendEntry {
+    language: string;
+    trend: 'rising' | 'stable' | 'falling' | 'unknown';
+    weight: number;
+}
+export interface IRepositoryMemoryIndex {
+    schema: typeof REPO_MEMORY_SCHEMA;
+    generatedAt: string;
+    projectRoot: string;
+    sourceCount: number;
+    scannedDirs: readonly string[];
+    files: readonly IMemoryFileEntry[];
+    diagnostics: readonly IMemoryDiagnosticEntry[];
+    plansWithConflicts: readonly string[];
+    boundaryViolationsRecurring: readonly string[];
+    policyViolationsRecurring: readonly string[];
+    releaseBlockers: readonly string[];
+    packIssues: readonly string[];
+    failedValidationCommands: readonly string[];
+    slowValidationCommands: readonly {
+        command: string;
+        durationMs: number;
+    }[];
+    recentTaskTypes: readonly string[];
+    playbooks: readonly IMemoryPlaybookEntry[];
+    highRiskConstructs: readonly IMemoryConstructEntry[];
+    warnings: readonly string[];
+    notes: readonly string[];
+    /** Language-aware tagging. */
+    languageByFile?: Readonly<Record<string, string>>;
+    riskyFilesByLanguage?: Readonly<Record<string, readonly string[]>>;
+    diagnosticsByLanguage?: Readonly<Record<string, readonly string[]>>;
+    boundaryViolationsByLanguage?: Readonly<Record<string, readonly string[]>>;
+    validationFailuresByLanguage?: Readonly<Record<string, readonly string[]>>;
+    planConflictsByLanguage?: Readonly<Record<string, readonly string[]>>;
+    languageHotspots?: readonly ILanguageHotspot[];
+    languageRiskTrend?: readonly ILanguageRiskTrendEntry[];
+}
+export interface IMemoryRiskReport {
+    schema: typeof REPO_MEMORY_SCHEMA;
+    task: string;
+    generatedAt: string;
+    recommendation: 'no-memory' | 'no-overlap' | 'overlap-weak' | 'overlap-strong';
+    matchedFiles: readonly IMemoryFileEntry[];
+    matchedDiagnostics: readonly IMemoryDiagnosticEntry[];
+    matchedConstructs: readonly IMemoryConstructEntry[];
+    notes: readonly string[];
+}
+export declare function buildRepositoryMemory(inspection: ISharkcraftInspection): Promise<IRepositoryMemoryIndex>;
+export declare function memoryIndexPath(projectRoot: string): string;
+export declare function memoryDir(projectRoot: string): string;
+export declare function saveRepositoryMemory(projectRoot: string, index: IRepositoryMemoryIndex): string;
+export declare function loadRepositoryMemory(projectRoot: string): IRepositoryMemoryIndex | null;
+export interface IResetMemoryResult {
+    dryRun: boolean;
+    removed: readonly string[];
+    notRemoved: readonly string[];
+}
+export declare function resetRepositoryMemory(projectRoot: string, opts: {
+    dryRun: boolean;
+}): IResetMemoryResult;
+export declare function memoryRiskForTask(index: IRepositoryMemoryIndex | null, task: string): IMemoryRiskReport;
+export declare function renderMemoryReportText(index: IRepositoryMemoryIndex): string;
+export declare function renderMemoryRiskText(r: IMemoryRiskReport): string;
+//# sourceMappingURL=repo-memory.d.ts.map

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

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