npm - @opensip-tools/contracts - Versions diffs - 1.0.4 - Mend

@opensip-tools/contracts 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (86) hide show

package/.turbo/turbo-build.log +4 -0
package/.turbo/turbo-typecheck.log +4 -0
package/LICENSE +21 -0
package/dist/__tests__/dashboard.test.d.ts +2 -0
package/dist/__tests__/dashboard.test.d.ts.map +1 -0
package/dist/__tests__/dashboard.test.js +85 -0
package/dist/__tests__/dashboard.test.js.map +1 -0
package/dist/__tests__/exit-codes.test.d.ts +2 -0
package/dist/__tests__/exit-codes.test.d.ts.map +1 -0
package/dist/__tests__/exit-codes.test.js +73 -0
package/dist/__tests__/exit-codes.test.js.map +1 -0
package/dist/__tests__/store.test.d.ts +2 -0
package/dist/__tests__/store.test.d.ts.map +1 -0
package/dist/__tests__/store.test.js +169 -0
package/dist/__tests__/store.test.js.map +1 -0
package/dist/exit-codes.d.ts +14 -0
package/dist/exit-codes.d.ts.map +1 -0
package/dist/exit-codes.js +61 -0
package/dist/exit-codes.js.map +1 -0
package/dist/index.d.ts +21 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +20 -0
package/dist/index.js.map +1 -0
package/dist/persistence/dashboard/checks.d.ts +7 -0
package/dist/persistence/dashboard/checks.d.ts.map +1 -0
package/dist/persistence/dashboard/checks.js +279 -0
package/dist/persistence/dashboard/checks.js.map +1 -0
package/dist/persistence/dashboard/css.d.ts +6 -0
package/dist/persistence/dashboard/css.d.ts.map +1 -0
package/dist/persistence/dashboard/css.js +141 -0
package/dist/persistence/dashboard/css.js.map +1 -0
package/dist/persistence/dashboard/generator.d.ts +9 -0
package/dist/persistence/dashboard/generator.d.ts.map +1 -0
package/dist/persistence/dashboard/generator.js +79 -0
package/dist/persistence/dashboard/generator.js.map +1 -0
package/dist/persistence/dashboard/index.d.ts +5 -0
package/dist/persistence/dashboard/index.d.ts.map +1 -0
package/dist/persistence/dashboard/index.js +5 -0
package/dist/persistence/dashboard/index.js.map +1 -0
package/dist/persistence/dashboard/overview.d.ts +6 -0
package/dist/persistence/dashboard/overview.d.ts.map +1 -0
package/dist/persistence/dashboard/overview.js +65 -0
package/dist/persistence/dashboard/overview.js.map +1 -0
package/dist/persistence/dashboard/recipes.d.ts +6 -0
package/dist/persistence/dashboard/recipes.d.ts.map +1 -0
package/dist/persistence/dashboard/recipes.js +68 -0
package/dist/persistence/dashboard/recipes.js.map +1 -0
package/dist/persistence/dashboard/sessions.d.ts +6 -0
package/dist/persistence/dashboard/sessions.d.ts.map +1 -0
package/dist/persistence/dashboard/sessions.js +205 -0
package/dist/persistence/dashboard/sessions.js.map +1 -0
package/dist/persistence/dashboard/shared.d.ts +6 -0
package/dist/persistence/dashboard/shared.d.ts.map +1 -0
package/dist/persistence/dashboard/shared.js +211 -0
package/dist/persistence/dashboard/shared.js.map +1 -0
package/dist/persistence/dashboard/tool-tabs.d.ts +6 -0
package/dist/persistence/dashboard/tool-tabs.d.ts.map +1 -0
package/dist/persistence/dashboard/tool-tabs.js +102 -0
package/dist/persistence/dashboard/tool-tabs.js.map +1 -0
package/dist/persistence/store.d.ts +103 -0
package/dist/persistence/store.d.ts.map +1 -0
package/dist/persistence/store.js +156 -0
package/dist/persistence/store.js.map +1 -0
package/dist/types.d.ts +279 -0
package/dist/types.d.ts.map +1 -0
package/dist/types.js +2 -0
package/dist/types.js.map +1 -0
package/package.json +35 -0
package/src/__tests__/dashboard.test.ts +102 -0
package/src/__tests__/exit-codes.test.ts +87 -0
package/src/__tests__/store.test.ts +213 -0
package/src/exit-codes.ts +74 -0
package/src/index.ts +71 -0
package/src/persistence/dashboard/checks.ts +279 -0
package/src/persistence/dashboard/css.ts +141 -0
package/src/persistence/dashboard/generator.ts +89 -0
package/src/persistence/dashboard/index.ts +5 -0
package/src/persistence/dashboard/overview.ts +65 -0
package/src/persistence/dashboard/recipes.ts +68 -0
package/src/persistence/dashboard/sessions.ts +205 -0
package/src/persistence/dashboard/shared.ts +211 -0
package/src/persistence/dashboard/tool-tabs.ts +102 -0
package/src/persistence/store.ts +233 -0
package/src/types.ts +306 -0
package/tsconfig.json +8 -0
package/vitest.config.ts +16 -0

package/src/__tests__/dashboard.test.ts ADDED Viewed

@@ -0,0 +1,102 @@
+import { describe, expect, it } from 'vitest';
+import { generateDashboardHtml } from '../persistence/dashboard/generator.js';
+import type { CheckCatalogEntry, RecipeCatalogEntry, StoredSession } from '../persistence/store.js';
+function makeSession(overrides: Partial<StoredSession> = {}): StoredSession {
+  return {
+    id: 'sess-1',
+    tool: 'fit',
+    timestamp: new Date().toISOString(),
+    cwd: '/proj',
+    score: 92,
+    passed: true,
+    summary: { total: 10, passed: 9, failed: 1, errors: 0, warnings: 0 },
+    checks: [],
+    durationMs: 100,
+    ...overrides,
+  };
+}
+const checkCatalog: CheckCatalogEntry[] = [
+  {
+    slug: 'no-console-log',
+    name: 'No console.log',
+    icon: '🚫',
+    description: 'Forbids console.log in production',
+    tags: ['quality'],
+    confidence: 'high',
+    source: 'built-in',
+  },
+];
+const recipeCatalog: RecipeCatalogEntry[] = [
+  {
+    name: 'default',
+    displayName: 'Default',
+    description: 'All checks',
+    tags: [],
+    selectorType: 'all',
+    mode: 'parallel',
+    timeout: 30_000,
+  },
+];
+describe('generateDashboardHtml', () => {
+  it('produces a complete HTML5 document', () => {
+    const html = generateDashboardHtml([makeSession()]);
+    expect(html).toContain('<!DOCTYPE html>');
+    expect(html).toContain('</html>');
+  });
+  it('inlines the latest session score in the document title', () => {
+    const html = generateDashboardHtml([makeSession({ score: 85 })]);
+    expect(html).toContain('Pass Rate: 85%');
+  });
+  it('omits the score from the title when there are no sessions', () => {
+    const html = generateDashboardHtml([]);
+    expect(html).toMatch(/<title>OpenSIP Tools<\/title>/);
+  });
+  it('inlines session, check catalog, and recipe catalog as JS data', () => {
+    const html = generateDashboardHtml(
+      [makeSession({ id: 'special-session-id' })],
+      checkCatalog,
+      recipeCatalog,
+    );
+    expect(html).toContain('special-session-id');
+    expect(html).toContain('no-console-log');
+    expect(html).toContain('default');
+  });
+  it('escapes < and > in inlined JSON to prevent script injection', () => {
+    // A session whose cwd contains a fake </script> tag must not break out
+    const evil = makeSession({ cwd: '</script><script>alert(1)</script>' });
+    const html = generateDashboardHtml([evil]);
+    expect(html).not.toMatch(/<\/script>\s*<script>alert\(1\)/);
+    expect(html).toContain(String.raw`</script>`);
+  });
+  it('renders all three tab panels (overview, fitness, simulation)', () => {
+    const html = generateDashboardHtml([]);
+    expect(html).toContain('id="panel-overview"');
+    expect(html).toContain('id="panel-fitness"');
+    expect(html).toContain('id="panel-simulation"');
+  });
+  it('includes inline CSS', () => {
+    const html = generateDashboardHtml([]);
+    expect(html).toMatch(/<style>[\s\S]+?<\/style>/);
+  });
+  it('partitions sessions into fit vs sim arrays in the page script', () => {
+    const html = generateDashboardHtml([
+      makeSession({ id: 'fit-1', tool: 'fit' }),
+      makeSession({ id: 'sim-1', tool: 'sim' }),
+    ]);
+    expect(html).toContain("sessions.filter(s => s.tool === 'fit')");
+    expect(html).toContain("sessions.filter(s => s.tool === 'sim')");
+  });
+});

package/src/__tests__/exit-codes.test.ts ADDED Viewed

@@ -0,0 +1,87 @@
+import { describe, expect, it } from 'vitest';
+import { EXIT_CODES, getErrorSuggestion } from '../exit-codes.js';
+describe('EXIT_CODES', () => {
+  it('exposes the documented set', () => {
+    expect(EXIT_CODES).toEqual({
+      SUCCESS: 0,
+      RUNTIME_ERROR: 1,
+      CONFIGURATION_ERROR: 2,
+      CHECK_NOT_FOUND: 3,
+      REPORT_FAILED: 4,
+    });
+  });
+});
+describe('getErrorSuggestion', () => {
+  it('returns null when no pattern matches', () => {
+    expect(getErrorSuggestion(new Error('something else entirely'))).toBeNull();
+  });
+  it('handles non-Error inputs', () => {
+    expect(getErrorSuggestion('just a string')).toBeNull();
+    expect(getErrorSuggestion(undefined)).toBeNull();
+  });
+  it('classifies "Check not found: <slug>" with the slug surfaced', () => {
+    const out = getErrorSuggestion(new Error('Check not found: foo-check'));
+    expect(out?.exitCode).toBe(EXIT_CODES.CHECK_NOT_FOUND);
+    expect(out?.message).toContain('foo-check');
+  });
+  it('classifies "not found: <slug>" without the "Check" prefix', () => {
+    const out = getErrorSuggestion(new Error('Recipe not found: my-recipe'));
+    expect(out?.exitCode).toBe(EXIT_CODES.CHECK_NOT_FOUND);
+    expect(out?.message).toContain('my-recipe');
+  });
+  it('falls back to "unknown" when slug cannot be extracted', () => {
+    const out = getErrorSuggestion(new Error('not found'));
+    expect(out?.message).toContain('unknown');
+  });
+  it('classifies "Unknown recipe ..." as configuration error', () => {
+    const out = getErrorSuggestion(new Error('Unknown recipe foo'));
+    expect(out?.exitCode).toBe(EXIT_CODES.CONFIGURATION_ERROR);
+    expect(out?.action).toContain('--recipes');
+  });
+  it('classifies opensip-tools.config.yml errors', () => {
+    const out = getErrorSuggestion(new Error('Failed to parse opensip-tools.config.yml'));
+    expect(out?.exitCode).toBe(EXIT_CODES.CONFIGURATION_ERROR);
+  });
+  it('classifies YAML errors as configuration', () => {
+    const out = getErrorSuggestion(new Error('Bad YAML at line 3'));
+    expect(out?.exitCode).toBe(EXIT_CODES.CONFIGURATION_ERROR);
+  });
+  it('classifies generic config errors', () => {
+    const out = getErrorSuggestion(new Error('config invalid'));
+    expect(out?.exitCode).toBe(EXIT_CODES.CONFIGURATION_ERROR);
+  });
+  it('classifies EACCES as a runtime permission error', () => {
+    const out = getErrorSuggestion(new Error('EACCES: permission denied reading /etc'));
+    expect(out?.exitCode).toBe(EXIT_CODES.RUNTIME_ERROR);
+    expect(out?.action).toContain('permissions');
+  });
+  it('classifies "No checks registered" as runtime error with check-pack guidance', () => {
+    const out = getErrorSuggestion(new Error('No checks registered'));
+    expect(out?.exitCode).toBe(EXIT_CODES.RUNTIME_ERROR);
+    expect(out?.action).toContain('checks-*');
+  });
+  it('classifies "No checks to run" similarly', () => {
+    const out = getErrorSuggestion(new Error('No checks to run'));
+    expect(out?.exitCode).toBe(EXIT_CODES.RUNTIME_ERROR);
+  });
+  it('classifies fetch/network errors as REPORT_FAILED', () => {
+    expect(getErrorSuggestion(new Error('fetch failed'))?.exitCode).toBe(EXIT_CODES.REPORT_FAILED);
+    expect(getErrorSuggestion(new Error('ECONNREFUSED'))?.exitCode).toBe(EXIT_CODES.REPORT_FAILED);
+    expect(getErrorSuggestion(new Error('network unreachable'))?.exitCode).toBe(EXIT_CODES.REPORT_FAILED);
+  });
+});

package/src/__tests__/store.test.ts ADDED Viewed

@@ -0,0 +1,213 @@
+import { mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import {
+  clearAllSessions,
+  clearSessionsOlderThan,
+  configurePersistencePaths,
+  countSessions,
+  generateSessionId,
+  getReportsDir,
+  getStoreDir,
+  loadLatestSession,
+  loadSessions,
+  sanitizeForFilename,
+  saveSession,
+  type StoredSession,
+} from '../persistence/store.js';
+let testDir: string;
+let sessionsDir: string;
+let reportsDir: string;
+function makeSession(overrides: Partial<StoredSession> = {}): StoredSession {
+  return {
+    id: 'sess-1',
+    tool: 'fit',
+    timestamp: new Date().toISOString(),
+    cwd: '/proj',
+    score: 100,
+    passed: true,
+    summary: { total: 1, passed: 1, failed: 0, errors: 0, warnings: 0 },
+    checks: [],
+    durationMs: 0,
+    ...overrides,
+  };
+}
+beforeEach(() => {
+  testDir = mkdtempSync(join(tmpdir(), 'contracts-store-'));
+  sessionsDir = join(testDir, 'sessions');
+  reportsDir = join(testDir, 'reports');
+  configurePersistencePaths({ sessionsDir, reportsDir });
+});
+afterEach(() => {
+  rmSync(testDir, { recursive: true, force: true });
+});
+describe('configurePersistencePaths', () => {
+  it('redirects getStoreDir / getReportsDir to the configured paths', () => {
+    expect(getStoreDir()).toBe(sessionsDir);
+    expect(getReportsDir()).toBe(reportsDir);
+  });
+});
+describe('sanitizeForFilename', () => {
+  it('strips path separators and special chars', () => {
+    expect(sanitizeForFilename(String.raw`a/b\c:d*e?f"g<h>i|j.k`)).not.toMatch(/[/\\:*?"<>|.]/);
+  });
+  it('collapses parent traversal', () => {
+    expect(sanitizeForFilename('../../etc/passwd')).not.toContain('..');
+  });
+});
+describe('saveSession', () => {
+  it('writes a json file under the sessions dir and returns its path', () => {
+    const path = saveSession(makeSession());
+    expect(path.startsWith(sessionsDir)).toBe(true);
+    expect(readdirSync(sessionsDir).length).toBe(1);
+  });
+  it('encodes the recipe in the filename, sanitized', () => {
+    const path = saveSession(makeSession({ recipe: 'foo/bar' }));
+    expect(path).toContain('-foo-bar');
+  });
+  it('does not include a recipe segment when recipe is absent', () => {
+    const path = saveSession(makeSession());
+    expect(path).not.toContain('-undefined');
+  });
+});
+describe('loadSessions / loadLatestSession', () => {
+  it('returns sessions in newest-first order', () => {
+    saveSession(makeSession({ id: 'first', timestamp: '2024-01-01T00:00:00.000Z' }));
+    saveSession(makeSession({ id: 'second', timestamp: '2024-06-01T00:00:00.000Z' }));
+    saveSession(makeSession({ id: 'third', timestamp: '2024-12-01T00:00:00.000Z' }));
+    const out = loadSessions();
+    expect(out.map((s) => s.id)).toEqual(['third', 'second', 'first']);
+  });
+  it('honors the limit parameter', () => {
+    saveSession(makeSession({ id: 'a', timestamp: '2024-01-01T00:00:00.000Z' }));
+    saveSession(makeSession({ id: 'b', timestamp: '2024-02-01T00:00:00.000Z' }));
+    saveSession(makeSession({ id: 'c', timestamp: '2024-03-01T00:00:00.000Z' }));
+    expect(loadSessions(2)).toHaveLength(2);
+  });
+  it('skips corrupted JSON files without crashing', () => {
+    saveSession(makeSession({ id: 'good' }));
+    mkdirSync(sessionsDir, { recursive: true });
+    writeFileSync(join(sessionsDir, '2024-99-99-fit.json'), '{not-json');
+    const out = loadSessions();
+    expect(out.map((s) => s.id)).toContain('good');
+  });
+  it('loadLatestSession returns null when no sessions exist', () => {
+    expect(loadLatestSession()).toBeNull();
+  });
+  it('loadLatestSession returns the newest session', () => {
+    saveSession(makeSession({ id: 'old', timestamp: '2024-01-01T00:00:00.000Z' }));
+    saveSession(makeSession({ id: 'new', timestamp: '2024-12-31T00:00:00.000Z' }));
+    expect(loadLatestSession()?.id).toBe('new');
+  });
+});
+describe('countSessions', () => {
+  it('returns 0 when the store is empty', () => {
+    expect(countSessions()).toBe(0);
+  });
+  it('counts only .json files', () => {
+    saveSession(makeSession());
+    writeFileSync(join(sessionsDir, 'note.txt'), 'ignored');
+    expect(countSessions()).toBe(1);
+  });
+});
+describe('clearAllSessions', () => {
+  it('removes every json file and returns the count', () => {
+    saveSession(makeSession({ id: 'a', timestamp: '2024-01-01T00:00:00.000Z' }));
+    saveSession(makeSession({ id: 'b', timestamp: '2024-02-01T00:00:00.000Z' }));
+    expect(clearAllSessions()).toBe(2);
+    expect(countSessions()).toBe(0);
+  });
+  it('returns 0 when the store is already empty', () => {
+    expect(clearAllSessions()).toBe(0);
+  });
+});
+describe('clearSessionsOlderThan', () => {
+  it('deletes sessions with timestamps older than the cutoff', () => {
+    const oldTs = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString();
+    const newTs = new Date(Date.now() - 1 * 24 * 60 * 60 * 1000).toISOString();
+    saveSession(makeSession({ id: 'old', timestamp: oldTs }));
+    saveSession(makeSession({ id: 'new', timestamp: newTs }));
+    expect(clearSessionsOlderThan(7)).toBe(1);
+    expect(countSessions()).toBe(1);
+    expect(loadLatestSession()?.id).toBe('new');
+  });
+  it('skips files with unparseable timestamps', () => {
+    mkdirSync(sessionsDir, { recursive: true });
+    writeFileSync(join(sessionsDir, 'bad.json'), JSON.stringify({ timestamp: 'not-a-date' }));
+    saveSession(makeSession({ id: 'ok', timestamp: new Date().toISOString() }));
+    // bad.json has unparseable timestamp; 'ok' is recent. None deleted.
+    expect(clearSessionsOlderThan(7)).toBe(0);
+  });
+  it('skips files with no timestamp field', () => {
+    mkdirSync(sessionsDir, { recursive: true });
+    writeFileSync(join(sessionsDir, 'no-ts.json'), JSON.stringify({}));
+    expect(clearSessionsOlderThan(7)).toBe(0);
+  });
+  it('skips unparseable JSON', () => {
+    mkdirSync(sessionsDir, { recursive: true });
+    writeFileSync(join(sessionsDir, 'broken.json'), '{');
+    expect(clearSessionsOlderThan(7)).toBe(0);
+  });
+});
+describe('saveSession pruning', () => {
+  it('keeps at most 100 sessions, pruning oldest', () => {
+    // Create 105 sessions with monotonically increasing timestamps
+    for (let i = 0; i < 105; i++) {
+      const day = String(i + 1).padStart(2, '0');
+      saveSession(makeSession({ id: `s-${i}`, timestamp: `2024-01-${day}T00:00:00.000Z` }));
+    }
+    expect(countSessions()).toBeLessThanOrEqual(100);
+  });
+});
+describe('reports dir', () => {
+  it('getReportsDir creates the directory if missing', () => {
+    rmSync(reportsDir, { recursive: true, force: true });
+    expect(getReportsDir()).toBe(reportsDir);
+    // The act of calling should have ensured the dir
+    expect(readFileSync.length).toBeGreaterThan(0); // sanity: fs is available
+  });
+});
+describe('generateSessionId', () => {
+  it('returns a UUID-shaped string', () => {
+    const id = generateSessionId();
+    expect(id).toMatch(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/);
+  });
+  it('generates unique IDs', () => {
+    const a = generateSessionId();
+    const b = generateSessionId();
+    expect(a).not.toBe(b);
+  });
+});

package/src/exit-codes.ts ADDED Viewed

@@ -0,0 +1,74 @@
+export const EXIT_CODES = {
+  SUCCESS: 0,
+  RUNTIME_ERROR: 1,
+  CONFIGURATION_ERROR: 2,
+  CHECK_NOT_FOUND: 3,
+  REPORT_FAILED: 4,
+} as const;
+export interface ErrorSuggestion {
+  message: string;
+  action?: string;
+  exitCode: number;
+}
+export function getErrorSuggestion(err: unknown): ErrorSuggestion | null {
+  const message = err instanceof Error ? err.message : String(err);
+  // Check not found
+  if (message.includes('Check not found:') || message.includes('not found')) {
+    const slug = (/Check not found: (.+)/.exec(message))?.[1] ?? (/not found: (.+)/.exec(message))?.[1];
+    return {
+      message: `Check '${slug ?? 'unknown'}' not found.`,
+      action: 'Run opensip-tools fit --list to see available checks.',
+      exitCode: EXIT_CODES.CHECK_NOT_FOUND,
+    };
+  }
+  // Recipe not found
+  if (message.includes('Unknown recipe')) {
+    return {
+      message: message,
+      action: 'Run opensip-tools fit --recipes to see available recipes.',
+      exitCode: EXIT_CODES.CONFIGURATION_ERROR,
+    };
+  }
+  // Config file error
+  if (message.includes('opensip-tools.config.yml') || message.includes('YAML') || message.includes('config')) {
+    return {
+      message: 'Configuration error.',
+      action: 'Check opensip-tools.config.yml for syntax errors.',
+      exitCode: EXIT_CODES.CONFIGURATION_ERROR,
+    };
+  }
+  // Permission denied
+  if (message.includes('EACCES') || message.includes('permission denied')) {
+    return {
+      message: 'Permission denied reading files.',
+      action: 'Check file permissions in the target directory.',
+      exitCode: EXIT_CODES.RUNTIME_ERROR,
+    };
+  }
+  // No files found
+  if (message.includes('No checks registered') || message.includes('No checks to run')) {
+    return {
+      message: 'No checks available to run.',
+      action: 'Install at least one @opensip-tools/checks-* package, or declare plugins.checkPackages in opensip-tools.config.yml.',
+      exitCode: EXIT_CODES.RUNTIME_ERROR,
+    };
+  }
+  // Network error (report-to)
+  if (message.includes('fetch') || message.includes('ECONNREFUSED') || message.includes('network')) {
+    return {
+      message: 'Network error sending report.',
+      action: 'Check the --report-to URL and your network connection.',
+      exitCode: EXIT_CODES.REPORT_FAILED,
+    };
+  }
+  return null;
+}

package/src/index.ts ADDED Viewed

@@ -0,0 +1,71 @@
+/**
+ * @opensip-tools/contracts — shared contract types.
+ *
+ * Tool packages (fitness, simulation) and the CLI entry-point both
+ * depend on this package for:
+ *   - CLI option / output / result types
+ *   - Exit code constants and error suggestions
+ *   - Session persistence (saveSession, loadSessions, dashboard generator)
+ *
+ * contracts depends only on @opensip-tools/core. Tools depend on
+ * contracts. The CLI entry-point depends on contracts and on every
+ * tool package — the dependency graph stays acyclic.
+ */
+// CLI option / argument types
+export type {
+  CliArgs,
+  FitOptions,
+  InitOptions,
+  ToolOptions,
+} from './types.js';
+// Output and result types
+export type {
+  CliOutput,
+  CheckOutput,
+  FindingOutput,
+  TableRow,
+  SummaryOptions,
+  CommandResult,
+  ClearDoneResult,
+  FitDoneResult,
+  SimDoneResult,
+  ListChecksResult,
+  ListRecipesResult,
+  HistoryResult,
+  DashboardResult,
+  InitResult,
+  ExperimentalResult,
+  PluginResult,
+  HelpResult,
+  ErrorResult,
+} from './types.js';
+// Exit codes + error suggestion helper
+export { EXIT_CODES, getErrorSuggestion } from './exit-codes.js';
+export type { ErrorSuggestion } 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 type {
+  StoredSession,
+  CheckCatalogEntry,
+  RecipeCatalogEntry,
+} from './persistence/store.js';
+// Dashboard HTML generator
+export { generateDashboardHtml } from './persistence/dashboard/index.js';