pi-harness-runtime 0.9.2 → 0.9.5

package/packages/autonomous-refactor/src/planner.ts

@@ -0,0 +1,99 @@
+/**
+ * Autonomous Refactor — Planning Engine (RFC-0092)
+ */
+
+import type {
+	RefactorFinding,
+	RefactorPlan,
+	RefactorConfig,
+	RiskLevel,
+} from "./types.js";
+import { DEFAULT_CONFIG } from "./types.js";
+import { calculatePriority } from "./detector.js";
+
+export function createPlan(
+	findings: RefactorFinding[],
+	config?: Partial<RefactorConfig>,
+): RefactorPlan {
+	const cfg = { ...DEFAULT_CONFIG, ...config } as Required<RefactorConfig>;
+
+	const riskOrder: Record<RiskLevel, number> = {
+		low: 0,
+		medium: 1,
+		high: 2,
+		critical: 3,
+	};
+	const threshold = riskOrder[cfg.riskThreshold];
+
+	const filtered = findings.filter((f) => riskOrder[f.risk] <= threshold);
+	const sorted = [...filtered].sort(
+		(a, b) => calculatePriority(b) - calculatePriority(a),
+	);
+	const limited = sorted.slice(0, cfg.maxFindings);
+
+	const blockers: string[] = [];
+	if (cfg.preserveBehavior) {
+		blockers.push("All changes must preserve existing behavior");
+	}
+
+	const avgRisk =
+		limited.reduce((sum, f) => {
+			const riskMap: Record<RiskLevel, number> = {
+				low: 5,
+				medium: 15,
+				high: 30,
+				critical: 50,
+			};
+			return sum + (riskMap[f.risk] ?? 0);
+		}, 0) / Math.max(limited.length, 1);
+
+	return {
+		id: `plan-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+		findings: limited,
+		priorityOrder: limited.map((f) => f.id),
+		estimatedImpact: {
+			complexityReduction: Math.min(avgRisk, 40),
+			maintainabilityImprovement: avgRisk * 0.8,
+			riskExposure: avgRisk * 0.6,
+		},
+		blockers,
+	};
+}
+
+export function filterByRisk(
+	findings: RefactorFinding[],
+	maxRisk: RiskLevel,
+): RefactorFinding[] {
+	const riskOrder: Record<RiskLevel, number> = {
+		low: 0,
+		medium: 1,
+		high: 2,
+		critical: 3,
+	};
+	const threshold = riskOrder[maxRisk];
+	return findings.filter((f) => riskOrder[f.risk] <= threshold);
+}
+
+export function groupByFile(
+	findings: RefactorFinding[],
+): Map<string, RefactorFinding[]> {
+	const groups = new Map<string, RefactorFinding[]>();
+	for (const f of findings) {
+		const existing = groups.get(f.file) ?? [];
+		existing.push(f);
+		groups.set(f.file, existing);
+	}
+	return groups;
+}
+
+export function groupByType(
+	findings: RefactorFinding[],
+): Map<RefactorFinding["type"], RefactorFinding[]> {
+	const groups = new Map<RefactorFinding["type"], RefactorFinding[]>();
+	for (const f of findings) {
+		const existing = groups.get(f.type) ?? [];
+		existing.push(f);
+		groups.set(f.type, existing);
+	}
+	return groups;
+}

package/packages/autonomous-refactor/src/types.ts

@@ -0,0 +1,57 @@
+/**
+ * Autonomous Refactor — Types (RFC-0092)
+ */
+
+export type RefactorType =
+	| "extract-method"
+	| "inline-method"
+	| "rename-variable"
+	| "move-function"
+	| "extract-interface"
+	| "replace-loop-pipeline"
+	| "introduce-null-object"
+	| "extract-superclass"
+	| "simplify-conditional"
+	| "replace-magic-literal";
+
+export type RiskLevel = "low" | "medium" | "high" | "critical";
+
+export interface RefactorFinding {
+	id: string;
+	type: RefactorType;
+	file: string;
+	location: { line: number; column: number };
+	description: string;
+	risk: RiskLevel;
+	confidence: number;
+	suggestedFix?: string;
+	rationale?: string[];
+}
+
+export interface RefactorPlan {
+	id: string;
+	findings: RefactorFinding[];
+	priorityOrder: string[];
+	estimatedImpact: {
+		complexityReduction: number;
+		maintainabilityImprovement: number;
+		riskExposure: number;
+	};
+	blockers: string[];
+}
+
+export interface RefactorConfig {
+	maxFindings: number;
+	riskThreshold: RiskLevel;
+	autoApply: boolean;
+	requireReviewAbove: RiskLevel;
+	preserveBehavior: boolean;
+}
+
+export const DEFAULT_CONFIG: Required<RefactorConfig> = {
+	maxFindings: 50,
+	riskThreshold: "medium",
+	autoApply: false,
+	requireReviewAbove: "high",
+	preserveBehavior: true,
+};

package/packages/autonomous-refactor/test/refactor.test.ts

@@ -0,0 +1,202 @@
+/**
+ * Autonomous Refactor Tests (RFC-0092)
+ */
+
+import { describe, it, expect } from "bun:test";
+import {
+	detectRefactorings,
+	assessRisk,
+	calculatePriority,
+	createPlan,
+	filterByRisk,
+	groupByFile,
+	groupByType,
+} from "../src/index.js";
+import type { RefactorFinding } from "../src/index.js";
+
+const makeFinding = (
+	overrides?: Partial<RefactorFinding>,
+): RefactorFinding => ({
+	id: `f${Math.random().toString(36).slice(2)}`,
+	type: "extract-method",
+	file: "src/test.ts",
+	location: { line: 10, column: 1 },
+	description: "Test finding",
+	risk: "low",
+	confidence: 0.7,
+	...overrides,
+});
+
+describe("detectRefactorings", () => {
+	it("detects magic literals", () => {
+		const files = [{ path: "src/test.ts", content: "const timeout = 5000;" }];
+		const findings = detectRefactorings(files);
+		expect(findings.some((f) => f.type === "replace-magic-literal")).toBe(true);
+	});
+
+	it("detects long functions", () => {
+		const lines = ["function longFunc() {"];
+		for (let i = 0; i < 38; i++) lines.push("  const x = " + i + ";");
+		lines.push("}");
+		const files = [{ path: "src/test.ts", content: lines.join("\n") }];
+		const findings = detectRefactorings(files);
+		expect(findings.some((f) => f.type === "extract-method")).toBe(true);
+	});
+
+	it("detects nested conditionals", () => {
+		const content = [
+			"if (a) {",
+			"  if (b) {",
+			"    if (c) {",
+			"      if (d) { console.log(1); }",
+			"    }",
+			"  }",
+			"}",
+		].join("\n");
+		const files = [{ path: "src/test.ts", content }];
+		const findings = detectRefactorings(files);
+		expect(findings.some((f) => f.type === "simplify-conditional")).toBe(true);
+	});
+
+	it("returns empty for clean code", () => {
+		const files = [
+			{
+				path: "src/test.ts",
+				content: "const x = 1;\nconst y = 2;\nconst sum = x + y;",
+			},
+		];
+		const findings = detectRefactorings(files);
+		expect(findings.length).toBeLessThanOrEqual(3);
+	});
+
+	it("limits magic literal findings per file", () => {
+		const lines = Array.from({ length: 20 }, (_, i) => `const val${i} = 999;`);
+		const files = [{ path: "src/test.ts", content: lines.join("\n") }];
+		const findings = detectRefactorings(files);
+		expect(
+			findings.filter((f) => f.type === "replace-magic-literal").length,
+		).toBeLessThanOrEqual(5);
+	});
+});
+
+describe("assessRisk", () => {
+	it("returns finding risk", () => {
+		expect(assessRisk(makeFinding({ risk: "high" }))).toBe("high");
+	});
+});
+
+describe("calculatePriority", () => {
+	it("higher for high-confidence", () => {
+		const high = makeFinding({ confidence: 0.9, risk: "low" });
+		const low = makeFinding({ confidence: 0.3, risk: "low" });
+		expect(calculatePriority(high)).toBeGreaterThan(calculatePriority(low));
+	});
+
+	it("higher for high-risk at same confidence", () => {
+		const critical = makeFinding({ confidence: 0.5, risk: "critical" });
+		const low = makeFinding({ confidence: 0.5, risk: "low" });
+		expect(calculatePriority(critical)).toBeGreaterThan(calculatePriority(low));
+	});
+
+	it("returns value between 0 and 1", () => {
+		const p = calculatePriority(
+			makeFinding({ confidence: 0.7, risk: "medium" }),
+		);
+		expect(p).toBeGreaterThanOrEqual(0);
+		expect(p).toBeLessThanOrEqual(1);
+	});
+});
+
+describe("createPlan", () => {
+	it("creates plan with findings", () => {
+		const findings = [makeFinding({ id: "f1" }), makeFinding({ id: "f2" })];
+		const plan = createPlan(findings);
+		expect(plan.findings).toHaveLength(2);
+		expect(plan.priorityOrder).toContain("f1");
+		expect(plan.priorityOrder).toContain("f2");
+	});
+
+	it("limits to maxFindings", () => {
+		const findings = Array.from({ length: 100 }, (_, i) =>
+			makeFinding({ id: `f${i}`, confidence: 1 - i / 100 }),
+		);
+		const plan = createPlan(findings, { maxFindings: 20 });
+		expect(plan.findings.length).toBeLessThanOrEqual(20);
+	});
+
+	it("filters by risk threshold", () => {
+		const findings = [
+			makeFinding({ id: "low", risk: "low" }),
+			makeFinding({ id: "high", risk: "high" }),
+			makeFinding({ id: "critical", risk: "critical" }),
+		];
+		const plan = createPlan(findings, { riskThreshold: "medium" });
+		expect(plan.findings.some((f) => f.id === "low")).toBe(true);
+		expect(plan.findings.some((f) => f.id === "high")).toBe(false);
+		expect(plan.findings.some((f) => f.id === "critical")).toBe(false);
+	});
+
+	it("includes blockers when preserveBehavior", () => {
+		const plan = createPlan([], { preserveBehavior: true });
+		expect(plan.blockers.length).toBeGreaterThan(0);
+	});
+
+	it("estimates positive impact", () => {
+		const findings = [
+			makeFinding({ risk: "medium" }),
+			makeFinding({ risk: "high" }),
+		];
+		const plan = createPlan(findings);
+		expect(plan.estimatedImpact.complexityReduction).toBeGreaterThan(0);
+	});
+});
+
+describe("filterByRisk", () => {
+	it("keeps low and medium when threshold is medium", () => {
+		const findings = [
+			makeFinding({ id: "low", risk: "low" }),
+			makeFinding({ id: "medium", risk: "medium" }),
+			makeFinding({ id: "high", risk: "high" }),
+		];
+		const filtered = filterByRisk(findings, "medium");
+		expect(filtered.map((f) => f.id)).toEqual(["low", "medium"]);
+	});
+
+	it("returns all when threshold is critical", () => {
+		const findings = [
+			makeFinding({ risk: "low" }),
+			makeFinding({ risk: "critical" }),
+		];
+		expect(filterByRisk(findings, "critical")).toHaveLength(2);
+	});
+});
+
+describe("groupByFile", () => {
+	it("groups findings by file", () => {
+		const findings = [
+			makeFinding({ id: "f1", file: "src/a.ts" }),
+			makeFinding({ id: "f2", file: "src/a.ts" }),
+			makeFinding({ id: "f3", file: "src/b.ts" }),
+		];
+		const groups = groupByFile(findings);
+		expect(groups.get("src/a.ts")).toHaveLength(2);
+		expect(groups.get("src/b.ts")).toHaveLength(1);
+	});
+
+	it("handles empty array", () => {
+		expect(groupByFile([]).size).toBe(0);
+	});
+});
+
+describe("groupByType", () => {
+	it("groups by type", () => {
+		const findings = [
+			makeFinding({ id: "f1", type: "extract-method" }),
+			makeFinding({ id: "f2", type: "extract-method" }),
+			makeFinding({ id: "f3", type: "rename-variable" }),
+		];
+		const groups = groupByType(findings);
+		expect(groups.get("extract-method")).toHaveLength(2);
+		expect(groups.get("rename-variable")).toHaveLength(1);
+	});
+});

package/packages/autonomous-refactor/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": { "outDir": "dist", "rootDir": "src" },
+  "include": ["src/**/*"]
+}

package/packages/cache-strategy/dist/cache.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Cache Strategy — Core (RFC-0022)
+ */
+import type { CacheConfig, CacheStats, InvalidationResult, TagGroup } from "./types.js";
+export declare class CacheStrategy<T = unknown> {
+    private entries;
+    private config;
+    private hitCount;
+    private missCount;
+    private evictCount;
+    private tagIndex;
+    constructor(config: CacheConfig);
+    set(key: string, value: T, ttlMs?: number, tags?: string[]): void;
+    get(key: string): T | undefined;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    invalidateByTag(tag: string): InvalidationResult;
+    invalidateByPattern(pattern: RegExp): InvalidationResult;
+    stats(): CacheStats;
+    resetStats(): void;
+    getTagGroups(): TagGroup[];
+    size(): number;
+    keys(): string[];
+    private isExpired;
+    private enforceMaxSize;
+    private evictLRU;
+    private evictLFU;
+    private evictTTL;
+}
+//# sourceMappingURL=cache.d.ts.map

package/packages/cache-strategy/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,WAAW,EAEX,UAAU,EACV,kBAAkB,EAElB,QAAQ,EACR,MAAM,YAAY,CAAC;AAEpB,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO;IACrC,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAkC;IAElD,YAAY,MAAM,EAAE,WAAW,EAO9B;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAkBhE;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAe9B;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQxB;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW3B;IAED,KAAK,IAAI,IAAI,CAGZ;IAED,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAS/C;IAED,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CASvD;IAED,KAAK,IAAI,UAAU,CAUlB;IAED,UAAU,IAAI,IAAI,CAIjB;IAED,YAAY,IAAI,QAAQ,EAAE,CAMzB;IAED,IAAI,IAAI,MAAM,CAEb;IAED,IAAI,IAAI,MAAM,EAAE,CAEf;IAED,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,QAAQ;CAYhB"}

package/packages/cache-strategy/dist/cache.js

@@ -0,0 +1,195 @@
+/**
+ * Cache Strategy — Core (RFC-0022)
+ */
+export class CacheStrategy {
+    entries = new Map();
+    config;
+    hitCount = 0;
+    missCount = 0;
+    evictCount = 0;
+    tagIndex = new Map();
+    constructor(config) {
+        this.config = {
+            strategy: config.strategy ?? "lru",
+            defaultTtlMs: config.defaultTtlMs ?? 300_000,
+            maxSize: config.maxSize ?? 1000,
+            onEvict: config.onEvict ?? (() => { }),
+        };
+    }
+    set(key, value, ttlMs, tags) {
+        const now = Date.now();
+        this.entries.set(key, {
+            key,
+            value,
+            createdAt: now,
+            accessedAt: now,
+            hits: 0,
+            ttl: ttlMs ?? this.config.defaultTtlMs,
+            tags,
+        });
+        if (tags) {
+            for (const tag of tags) {
+                if (!this.tagIndex.has(tag))
+                    this.tagIndex.set(tag, new Set());
+                this.tagIndex.get(tag).add(key);
+            }
+        }
+        this.enforceMaxSize();
+    }
+    get(key) {
+        const entry = this.entries.get(key);
+        if (!entry) {
+            this.missCount++;
+            return undefined;
+        }
+        if (this.isExpired(entry)) {
+            this.delete(key);
+            this.missCount++;
+            return undefined;
+        }
+        entry.accessedAt = Date.now();
+        entry.hits++;
+        this.hitCount++;
+        return entry.value;
+    }
+    has(key) {
+        const entry = this.entries.get(key);
+        if (!entry)
+            return false;
+        if (this.isExpired(entry)) {
+            this.delete(key);
+            return false;
+        }
+        return true;
+    }
+    delete(key) {
+        const entry = this.entries.get(key);
+        if (!entry)
+            return false;
+        if (entry.tags) {
+            for (const tag of entry.tags) {
+                this.tagIndex.get(tag)?.delete(key);
+            }
+        }
+        this.config.onEvict(key, entry);
+        this.evictCount++;
+        return this.entries.delete(key);
+    }
+    clear() {
+        this.entries.clear();
+        this.tagIndex.clear();
+    }
+    invalidateByTag(tag) {
+        const keys = this.tagIndex.get(tag);
+        if (!keys)
+            return { invalidated: 0, remaining: this.entries.size };
+        const count = keys.size;
+        for (const k of keys) {
+            this.delete(k);
+        }
+        this.tagIndex.delete(tag);
+        return { invalidated: count, remaining: this.entries.size };
+    }
+    invalidateByPattern(pattern) {
+        let count = 0;
+        for (const key of this.entries.keys()) {
+            if (pattern.test(key)) {
+                this.delete(key);
+                count++;
+            }
+        }
+        return { invalidated: count, remaining: this.entries.size };
+    }
+    stats() {
+        return {
+            hits: this.hitCount,
+            misses: this.missCount,
+            evictions: this.evictCount,
+            size: this.entries.size,
+            hitRate: this.hitCount + this.missCount > 0
+                ? this.hitCount / (this.hitCount + this.missCount)
+                : 0,
+        };
+    }
+    resetStats() {
+        this.hitCount = 0;
+        this.missCount = 0;
+        this.evictCount = 0;
+    }
+    getTagGroups() {
+        const groups = [];
+        for (const [tag, keys] of this.tagIndex) {
+            groups.push({ tag, keys: [...keys] });
+        }
+        return groups;
+    }
+    size() {
+        return this.entries.size;
+    }
+    keys() {
+        return [...this.entries.keys()];
+    }
+    isExpired(entry) {
+        if (!entry.ttl)
+            return false;
+        return Date.now() - entry.createdAt > entry.ttl;
+    }
+    enforceMaxSize() {
+        if (this.entries.size <= (this.config.maxSize ?? Infinity))
+            return;
+        switch (this.config.strategy) {
+            case "lru":
+                this.evictLRU();
+                break;
+            case "lfu":
+                this.evictLFU();
+                break;
+            case "ttl":
+                this.evictTTL();
+                break;
+            default: {
+                const first = this.entries.keys().next().value;
+                if (first)
+                    this.delete(first);
+            }
+        }
+    }
+    evictLRU() {
+        let oldest;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.entries) {
+            if (entry.accessedAt < oldestTime) {
+                oldestTime = entry.accessedAt;
+                oldest = key;
+            }
+        }
+        if (oldest)
+            this.delete(oldest);
+    }
+    evictLFU() {
+        let lowest;
+        let lowestHits = Infinity;
+        for (const [key, entry] of this.entries) {
+            if (entry.hits < lowestHits) {
+                lowestHits = entry.hits;
+                lowest = key;
+            }
+        }
+        if (lowest)
+            this.delete(lowest);
+    }
+    evictTTL() {
+        let oldest;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.entries) {
+            const age = Date.now() - entry.createdAt;
+            if (age > oldestTime) {
+                oldestTime = age;
+                oldest = key;
+            }
+        }
+        if (oldest)
+            this.delete(oldest);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/packages/cache-strategy/dist/cache.js.map

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

package/packages/cache-strategy/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Cache Strategy — Main Entry (RFC-0022)
+ */
+export { CacheStrategy } from "./cache.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/cache-strategy/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,mBAAmB,YAAY,CAAC"}

package/packages/cache-strategy/dist/index.js

@@ -0,0 +1,5 @@
+/**
+ * Cache Strategy — Main Entry (RFC-0022)
+ */
+export { CacheStrategy } from "./cache.js";
+//# sourceMappingURL=index.js.map

package/packages/cache-strategy/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/packages/cache-strategy/dist/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Cache Strategy — Types (RFC-0022)
+ */
+export type InvalidationStrategy = "ttl" | "lru" | "lfu" | "manual" | "tag-based";
+export interface CacheEntry<T = unknown> {
+    key: string;
+    value: T;
+    createdAt: number;
+    accessedAt: number;
+    hits: number;
+    ttl?: number;
+    tags?: string[];
+}
+export interface CacheConfig {
+    strategy: InvalidationStrategy;
+    defaultTtlMs?: number;
+    maxSize?: number;
+    onEvict?: (key: string, entry: CacheEntry) => void;
+}
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    size: number;
+    hitRate: number;
+}
+export interface InvalidationResult {
+    invalidated: number;
+    remaining: number;
+}
+export interface TagGroup {
+    tag: string;
+    keys: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/cache-strategy/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;AAElF,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;CACf"}

package/packages/cache-strategy/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Cache Strategy — Types (RFC-0022)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/cache-strategy/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}