@opensip-tools/contracts 1.0.9 → 1.0.10

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @opensip-tools/contracts@1.0.9 build /home/runner/work/opensip-tools/opensip-tools/packages/contracts
+> @opensip-tools/contracts@1.0.10 build /home/runner/work/opensip-tools/opensip-tools/packages/contracts
 > tsc
 

package/.turbo/turbo-test.log

@@ -1,16 +1,16 @@
 
-> @opensip-tools/contracts@1.0.9 test /home/runner/work/opensip-tools/opensip-tools/packages/contracts
+> @opensip-tools/contracts@1.0.10 test /home/runner/work/opensip-tools/opensip-tools/packages/contracts
 > vitest run --passWithNoTests
 
 
  RUN  v2.1.9 /home/runner/work/opensip-tools/opensip-tools/packages/contracts
 
- ✓ src/__tests__/exit-codes.test.ts (14 tests) 37ms
- ✓ src/__tests__/dashboard.test.ts (8 tests) 44ms
- ✓ src/__tests__/store.test.ts (23 tests) 221ms
+ ✓ src/__tests__/exit-codes.test.ts (14 tests) 58ms
+ ✓ src/__tests__/dashboard.test.ts (8 tests) 36ms
+ ✓ src/__tests__/store.test.ts (23 tests) 250ms
 
  Test Files  3 passed (3)
       Tests  45 passed (45)
-   Start at  22:05:50
-   Duration  3.42s (transform 1.39s, setup 0ms, collect 2.22s, tests 302ms, environment 1ms, prepare 1.31s)
+   Start at  00:26:54
+   Duration  4.07s (transform 1.71s, setup 0ms, collect 2.64s, tests 345ms, environment 1ms, prepare 1.90s)
 

package/.turbo/turbo-typecheck.log

@@ -1,4 +1,4 @@
 
-> @opensip-tools/contracts@1.0.9 typecheck /home/runner/work/opensip-tools/opensip-tools/packages/contracts
+> @opensip-tools/contracts@1.0.10 typecheck /home/runner/work/opensip-tools/opensip-tools/packages/contracts
 > tsc --noEmit
 

package/dist/index.d.ts

@@ -15,7 +15,7 @@ export type { CliArgs, FitOptions, InitOptions, ToolOptions, } from './types.js'
 export type { CliOutput, CheckOutput, FindingOutput, TableRow, SummaryOptions, CommandResult, ClearDoneResult, FitDoneResult, SimDoneResult, ListChecksResult, ListRecipesResult, HistoryResult, DashboardResult, InitResult, ExperimentalResult, PluginResult, HelpResult, ErrorResult, } from './types.js';
 export { EXIT_CODES, getErrorSuggestion } from './exit-codes.js';
 export type { ErrorSuggestion } from './exit-codes.js';
-export { TOOLS_HOME, configurePersistencePaths, saveSession, loadSessions, loadLatestSession, countSessions, clearAllSessions, clearSessionsOlderThan, getStoreDir, getReportsDir, generateSessionId, sanitizeForFilename, } from './persistence/store.js';
+export { configurePersistencePaths, saveSession, loadSessions, loadLatestSession, countSessions, clearAllSessions, clearSessionsOlderThan, getStoreDir, getReportsDir, generateSessionId, sanitizeForFilename, } from './persistence/store.js';
 export type { StoredSession, CheckCatalogEntry, RecipeCatalogEntry, } from './persistence/store.js';
 export { generateDashboardHtml } from './persistence/dashboard/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,YAAY,EACV,OAAO,EACP,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,SAAS,EACT,WAAW,EACX,aAAa,EACb,QAAQ,EACR,cAAc,EACd,aAAa,EACb,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,EACL,UAAU,EACV,yBAAyB,EACzB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,YAAY,EACV,OAAO,EACP,UAAU,EACV,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,SAAS,EACT,WAAW,EACX,aAAa,EACb,QAAQ,EACR,cAAc,EACd,aAAa,EACb,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,EACL,yBAAyB,EACzB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/index.js

@@ -14,7 +14,7 @@
 // Exit codes + error suggestion helper
 export { EXIT_CODES, getErrorSuggestion } from './exit-codes.js';
 // Session persistence
-export { TOOLS_HOME, configurePersistencePaths, saveSession, loadSessions, loadLatestSession, countSessions, clearAllSessions, clearSessionsOlderThan, getStoreDir, getReportsDir, generateSessionId, sanitizeForFilename, } from './persistence/store.js';
+export { configurePersistencePaths, saveSession, loadSessions, loadLatestSession, countSessions, clearAllSessions, clearSessionsOlderThan, getStoreDir, getReportsDir, generateSessionId, sanitizeForFilename, } from './persistence/store.js';
 // Dashboard HTML generator
 export { generateDashboardHtml } from './persistence/dashboard/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgCH,uCAAuC;AACvC,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGjE,sBAAsB;AACtB,OAAO,EACL,UAAU,EACV,yBAAyB,EACzB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAOhC,2BAA2B;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAgCH,uCAAuC;AACvC,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGjE,sBAAsB;AACtB,OAAO,EACL,yBAAyB,EACzB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAOhC,2BAA2B;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/persistence/store.d.ts

@@ -6,11 +6,12 @@
  * `{timestamp}-{tool}-{recipe}.json`.
  *
  * The CLI bootstrap calls `configurePersistencePaths(projectPaths)`
- * once on startup with paths from `resolveProjectPaths(cwd)`. Until
- * that call, the module falls back to a user-global location
- * (`~/.opensip-tools/`) so any caller who imports persistence helpers
- * before the CLI's preAction hook still gets a valid path. The
- * fallback is also exercised by tests that don't bootstrap a CLI.
+ * once on startup with paths from `resolveProjectPaths(cwd)`. Any
+ * persistence call made before that throws — there is no implicit
+ * fallback. This guarantees that user-global state (`~/.opensip-tools/`)
+ * only ever contains config.yml, which makes `opensip-tools uninstall`
+ * a precise operation. Tests must call `configurePersistencePaths`
+ * with a temp dir in their setup.
  */
 import type { ProjectPaths } from '@opensip-tools/core';
 export interface StoredSession {
@@ -67,13 +68,6 @@ export interface RecipeCatalogEntry {
     readonly mode: string;
     readonly timeout: number;
 }
-/**
- * Fallback path: user-global `~/.opensip-tools/`, used by tests and
- * any code path that imports persistence helpers before the CLI has
- * called `configurePersistencePaths`. New code should not rely on
- * this fallback — call `configurePersistencePaths` first.
- */
-export declare const TOOLS_HOME: string;
 /**
  * Configure where this module writes sessions and reports. Called
  * once by the CLI bootstrap with the project paths. Idempotent and

package/dist/persistence/store.d.ts.map

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

package/dist/persistence/store.js

@@ -6,27 +6,20 @@
  * `{timestamp}-{tool}-{recipe}.json`.
  *
  * The CLI bootstrap calls `configurePersistencePaths(projectPaths)`
- * once on startup with paths from `resolveProjectPaths(cwd)`. Until
- * that call, the module falls back to a user-global location
- * (`~/.opensip-tools/`) so any caller who imports persistence helpers
- * before the CLI's preAction hook still gets a valid path. The
- * fallback is also exercised by tests that don't bootstrap a CLI.
+ * once on startup with paths from `resolveProjectPaths(cwd)`. Any
+ * persistence call made before that throws — there is no implicit
+ * fallback. This guarantees that user-global state (`~/.opensip-tools/`)
+ * only ever contains config.yml, which makes `opensip-tools uninstall`
+ * a precise operation. Tests must call `configurePersistencePaths`
+ * with a temp dir in their setup.
  */
 import { randomUUID } from 'node:crypto';
 import { mkdirSync, readFileSync, readdirSync, writeFileSync, unlinkSync } from 'node:fs';
-import { homedir } from 'node:os';
 import { basename, join } from 'node:path';
 import { logger } from '@opensip-tools/core';
-/**
- * Fallback path: user-global `~/.opensip-tools/`, used by tests and
- * any code path that imports persistence helpers before the CLI has
- * called `configurePersistencePaths`. New code should not rely on
- * this fallback — call `configurePersistencePaths` first.
- */
-export const TOOLS_HOME = join(homedir(), '.opensip-tools');
 /** Mutable per-process state — set by `configurePersistencePaths`. */
-let storeDir = join(TOOLS_HOME, 'sessions');
-let reportsDir = join(TOOLS_HOME, 'reports');
+let storeDir = null;
+let reportsDir = null;
 const MAX_SESSIONS = 100;
 /**
  * Configure where this module writes sessions and reports. Called
@@ -37,6 +30,18 @@ export function configurePersistencePaths(paths) {
     storeDir = paths.sessionsDir;
     reportsDir = paths.reportsDir;
 }
+function requireStoreDir() {
+    if (storeDir === null) {
+        throw new Error('Persistence not configured. Call configurePersistencePaths() before using session APIs.');
+    }
+    return storeDir;
+}
+function requireReportsDir() {
+    if (reportsDir === null) {
+        throw new Error('Persistence not configured. Call configurePersistencePaths() before using report APIs.');
+    }
+    return reportsDir;
+}
 /** Ensure directory exists — mkdirSync with recursive is idempotent */
 function ensureDir(dir) {
     mkdirSync(dir, { recursive: true });
@@ -47,38 +52,42 @@ export function sanitizeForFilename(s) {
 }
 /** Save a session result to disk */
 export function saveSession(session) {
-    ensureDir(storeDir);
+    const dir = requireStoreDir();
+    ensureDir(dir);
     const safeRecipe = session.recipe ? `-${sanitizeForFilename(session.recipe)}` : '';
     const filename = `${session.timestamp.replaceAll(/[:.]/g, '-')}-${session.tool}${safeRecipe}.json`;
     // Ensure filename stays within the sessions directory
-    const filepath = join(storeDir, basename(filename));
+    const filepath = join(dir, basename(filename));
     writeFileSync(filepath, JSON.stringify(session, null, 2), 'utf8');
     pruneOldSessions();
     return filepath;
 }
 /** Count session files in the store directory */
 export function countSessions() {
-    ensureDir(storeDir);
-    return readdirSync(storeDir).filter(f => f.endsWith('.json')).length;
+    const dir = requireStoreDir();
+    ensureDir(dir);
+    return readdirSync(dir).filter(f => f.endsWith('.json')).length;
 }
 /** Delete all sessions. Returns the number of files deleted. */
 export function clearAllSessions() {
-    ensureDir(storeDir);
-    const files = readdirSync(storeDir).filter(f => f.endsWith('.json'));
+    const dir = requireStoreDir();
+    ensureDir(dir);
+    const files = readdirSync(dir).filter(f => f.endsWith('.json'));
     for (const file of files) {
-        unlinkSync(join(storeDir, file));
+        unlinkSync(join(dir, file));
     }
     return files.length;
 }
 /** Delete sessions older than the given number of days. Returns the number of files deleted. */
 export function clearSessionsOlderThan(days) {
-    ensureDir(storeDir);
+    const dir = requireStoreDir();
+    ensureDir(dir);
     const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
-    const files = readdirSync(storeDir).filter(f => f.endsWith('.json'));
+    const files = readdirSync(dir).filter(f => f.endsWith('.json'));
     let deleted = 0;
     for (const file of files) {
         try {
-            const filepath = join(storeDir, file);
+            const filepath = join(dir, file);
             const raw = readFileSync(filepath, 'utf8');
             const session = JSON.parse(raw);
             if (session.timestamp) {
@@ -97,8 +106,9 @@ export function clearSessionsOlderThan(days) {
 }
 /** Load all sessions, newest first. Optional limit to avoid reading everything. */
 export function loadSessions(limit) {
-    ensureDir(storeDir);
-    const files = readdirSync(storeDir)
+    const dir = requireStoreDir();
+    ensureDir(dir);
+    const files = readdirSync(dir)
         .filter(f => f.endsWith('.json'))
         .sort()
         // eslint-disable-next-line unicorn/no-array-reverse -- target ES2022; Array#toReversed is ES2023 and not in the lib
@@ -107,7 +117,7 @@ export function loadSessions(limit) {
     const sessions = [];
     for (const file of toRead) {
         try {
-            const raw = readFileSync(join(storeDir, file), 'utf8');
+            const raw = readFileSync(join(dir, file), 'utf8');
             sessions.push(JSON.parse(raw));
         }
         catch {
@@ -124,7 +134,8 @@ export function loadLatestSession() {
 }
 /** Prune sessions beyond the max count */
 function pruneOldSessions() {
-    const files = readdirSync(storeDir)
+    const dir = requireStoreDir();
+    const files = readdirSync(dir)
         .filter(f => f.endsWith('.json'))
         .sort()
         // eslint-disable-next-line unicorn/no-array-reverse -- target ES2022; Array#toReversed is ES2023 and not in the lib
@@ -133,7 +144,7 @@ function pruneOldSessions() {
         return;
     for (const file of files.slice(MAX_SESSIONS)) {
         try {
-            unlinkSync(join(storeDir, file));
+            unlinkSync(join(dir, file));
         }
         catch {
             // Best effort
@@ -142,12 +153,13 @@ function pruneOldSessions() {
 }
 /** Get the store directory path */
 export function getStoreDir() {
-    return storeDir;
+    return requireStoreDir();
 }
 /** Get the reports directory path, creating it if needed */
 export function getReportsDir() {
-    ensureDir(reportsDir);
-    return reportsDir;
+    const dir = requireReportsDir();
+    ensureDir(dir);
+    return dir;
 }
 /** Generate a unique session ID */
 export function generateSessionId() {

package/dist/persistence/store.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensip-tools/contracts",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "license": "MIT",
   "description": "Shared contract types for OpenSIP Tools — CliOutput / CommandResult shapes, exit codes, session persistence",
   "repository": {
@@ -19,7 +19,7 @@
     ".": "./dist/index.js"
   },
   "dependencies": {
-    "@opensip-tools/core": "1.0.9"
+    "@opensip-tools/core": "1.0.10"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/index.ts

@@ -48,7 +48,6 @@ export type { ErrorSuggestion } from './exit-codes.js';
 
 // Session persistence
 export {
-  TOOLS_HOME,
   configurePersistencePaths,
   saveSession,
   loadSessions,

package/src/persistence/store.ts

@@ -6,16 +6,16 @@
  * `{timestamp}-{tool}-{recipe}.json`.
  *
  * The CLI bootstrap calls `configurePersistencePaths(projectPaths)`
- * once on startup with paths from `resolveProjectPaths(cwd)`. Until
- * that call, the module falls back to a user-global location
- * (`~/.opensip-tools/`) so any caller who imports persistence helpers
- * before the CLI's preAction hook still gets a valid path. The
- * fallback is also exercised by tests that don't bootstrap a CLI.
+ * once on startup with paths from `resolveProjectPaths(cwd)`. Any
+ * persistence call made before that throws — there is no implicit
+ * fallback. This guarantees that user-global state (`~/.opensip-tools/`)
+ * only ever contains config.yml, which makes `opensip-tools uninstall`
+ * a precise operation. Tests must call `configurePersistencePaths`
+ * with a temp dir in their setup.
  */
 
 import { randomUUID } from 'node:crypto';
 import { mkdirSync, readFileSync, readdirSync, writeFileSync, unlinkSync } from 'node:fs';
-import { homedir } from 'node:os';
 import { basename, join } from 'node:path';
 
 import { logger } from '@opensip-tools/core';
@@ -79,17 +79,9 @@ export interface RecipeCatalogEntry {
   readonly timeout: number;
 }
 
-/**
- * Fallback path: user-global `~/.opensip-tools/`, used by tests and
- * any code path that imports persistence helpers before the CLI has
- * called `configurePersistencePaths`. New code should not rely on
- * this fallback — call `configurePersistencePaths` first.
- */
-export const TOOLS_HOME = join(homedir(), '.opensip-tools');
-
 /** Mutable per-process state — set by `configurePersistencePaths`. */
-let storeDir: string = join(TOOLS_HOME, 'sessions');
-let reportsDir: string = join(TOOLS_HOME, 'reports');
+let storeDir: string | null = null;
+let reportsDir: string | null = null;
 const MAX_SESSIONS = 100;
 
 /**
@@ -102,6 +94,20 @@ export function configurePersistencePaths(paths: Pick<ProjectPaths, 'sessionsDir
   reportsDir = paths.reportsDir;
 }
 
+function requireStoreDir(): string {
+  if (storeDir === null) {
+    throw new Error('Persistence not configured. Call configurePersistencePaths() before using session APIs.');
+  }
+  return storeDir;
+}
+
+function requireReportsDir(): string {
+  if (reportsDir === null) {
+    throw new Error('Persistence not configured. Call configurePersistencePaths() before using report APIs.');
+  }
+  return reportsDir;
+}
+
 /** Ensure directory exists — mkdirSync with recursive is idempotent */
 function ensureDir(dir: string): void {
   mkdirSync(dir, { recursive: true });
@@ -114,11 +120,12 @@ export function sanitizeForFilename(s: string): string {
 
 /** Save a session result to disk */
 export function saveSession(session: StoredSession): string {
-  ensureDir(storeDir);
+  const dir = requireStoreDir();
+  ensureDir(dir);
   const safeRecipe = session.recipe ? `-${sanitizeForFilename(session.recipe)}` : '';
   const filename = `${session.timestamp.replaceAll(/[:.]/g, '-')}-${session.tool}${safeRecipe}.json`;
   // Ensure filename stays within the sessions directory
-  const filepath = join(storeDir, basename(filename));
+  const filepath = join(dir, basename(filename));
   writeFileSync(filepath, JSON.stringify(session, null, 2), 'utf8');
 
   pruneOldSessions();
@@ -127,30 +134,33 @@ export function saveSession(session: StoredSession): string {
 
 /** Count session files in the store directory */
 export function countSessions(): number {
-  ensureDir(storeDir);
-  return readdirSync(storeDir).filter(f => f.endsWith('.json')).length;
+  const dir = requireStoreDir();
+  ensureDir(dir);
+  return readdirSync(dir).filter(f => f.endsWith('.json')).length;
 }
 
 /** Delete all sessions. Returns the number of files deleted. */
 export function clearAllSessions(): number {
-  ensureDir(storeDir);
-  const files = readdirSync(storeDir).filter(f => f.endsWith('.json'));
+  const dir = requireStoreDir();
+  ensureDir(dir);
+  const files = readdirSync(dir).filter(f => f.endsWith('.json'));
   for (const file of files) {
-    unlinkSync(join(storeDir, file));
+    unlinkSync(join(dir, file));
   }
   return files.length;
 }
 
 /** Delete sessions older than the given number of days. Returns the number of files deleted. */
 export function clearSessionsOlderThan(days: number): number {
-  ensureDir(storeDir);
+  const dir = requireStoreDir();
+  ensureDir(dir);
   const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
-  const files = readdirSync(storeDir).filter(f => f.endsWith('.json'));
+  const files = readdirSync(dir).filter(f => f.endsWith('.json'));
   let deleted = 0;
 
   for (const file of files) {
     try {
-      const filepath = join(storeDir, file);
+      const filepath = join(dir, file);
       const raw = readFileSync(filepath, 'utf8');
       const session = JSON.parse(raw) as { timestamp?: string };
       if (session.timestamp) {
@@ -170,8 +180,9 @@ export function clearSessionsOlderThan(days: number): number {
 
 /** Load all sessions, newest first. Optional limit to avoid reading everything. */
 export function loadSessions(limit?: number): StoredSession[] {
-  ensureDir(storeDir);
-  const files = readdirSync(storeDir)
+  const dir = requireStoreDir();
+  ensureDir(dir);
+  const files = readdirSync(dir)
     .filter(f => f.endsWith('.json'))
     .sort()
     // eslint-disable-next-line unicorn/no-array-reverse -- target ES2022; Array#toReversed is ES2023 and not in the lib
@@ -181,7 +192,7 @@ export function loadSessions(limit?: number): StoredSession[] {
   const sessions: StoredSession[] = [];
   for (const file of toRead) {
     try {
-      const raw = readFileSync(join(storeDir, file), 'utf8');
+      const raw = readFileSync(join(dir, file), 'utf8');
       sessions.push(JSON.parse(raw) as StoredSession);
     } catch {
       // Warn about corrupted files — don't crash
@@ -199,7 +210,8 @@ export function loadLatestSession(): StoredSession | null {
 
 /** Prune sessions beyond the max count */
 function pruneOldSessions(): void {
-  const files = readdirSync(storeDir)
+  const dir = requireStoreDir();
+  const files = readdirSync(dir)
     .filter(f => f.endsWith('.json'))
     .sort()
     // eslint-disable-next-line unicorn/no-array-reverse -- target ES2022; Array#toReversed is ES2023 and not in the lib
@@ -209,7 +221,7 @@ function pruneOldSessions(): void {
 
   for (const file of files.slice(MAX_SESSIONS)) {
     try {
-      unlinkSync(join(storeDir, file));
+      unlinkSync(join(dir, file));
     } catch {
       // Best effort
     }
@@ -218,13 +230,14 @@ function pruneOldSessions(): void {
 
 /** Get the store directory path */
 export function getStoreDir(): string {
-  return storeDir;
+  return requireStoreDir();
 }
 
 /** Get the reports directory path, creating it if needed */
 export function getReportsDir(): string {
-  ensureDir(reportsDir);
-  return reportsDir;
+  const dir = requireReportsDir();
+  ensureDir(dir);
+  return dir;
 }
 
 /** Generate a unique session ID */