@chaim-tools/chaim 0.1.0

package/dist/index.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const generate_1 = require("./commands/generate");
+const validate_1 = require("./commands/validate");
+const doctor_1 = require("./commands/doctor");
+const init_1 = require("./commands/init");
+const clean_1 = require("./commands/clean");
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * ==========================
+ * Planned Commands (Roadmap)
+ * ==========================
+ * These are intentionally commented out until implemented.
+ * See docs/CLI_ROADMAP.md and src/planned-commands.ts.
+ *
+ * To enable a command:
+ * 1. Uncomment the import statement
+ * 2. Uncomment the registration call below
+ * 3. Implement the command logic in the stub file
+ * 4. Update status in planned-commands.ts and CLI_ROADMAP.md
+ */
+// ─── TIER 0: Must Have ───────────────────────────────────────────────────────
+// import { registerAuthLoginCommand } from './commands/auth/login';
+// import { registerAuthWhoamiCommand } from './commands/auth/whoami';
+// import { registerAuthLogoutCommand } from './commands/auth/logout';
+// ─── TIER 1: Core Productivity ───────────────────────────────────────────────
+// import { registerConfigureCommand } from './commands/configure';
+// import { registerAppsLinkCommand } from './commands/apps/link';
+// ─── TIER 3: Nice to Have ────────────────────────────────────────────────────
+// import { registerAuthRefreshCommand } from './commands/auth/refresh';
+// import { registerAppsListCommand } from './commands/apps/list';
+// import { registerConfigShowCommand } from './commands/config/show';
+const program = new commander_1.Command();
+program
+    .name('chaim')
+    .description('Schema-driven code generation tool for DynamoDB')
+    .version('0.1.0');
+program
+    .command('generate')
+    .description('Generate SDK code from LOCAL snapshot (reads from OS cache)')
+    .requiredOption('--package <packageName>', 'Package name (e.g., com.mycompany.myapp.model for Java)')
+    .option('-l, --language <language>', 'Target language for code generation (default: java)')
+    .option('--output <outputDir>', 'Output directory', './src/main/java')
+    .option('--stack <stackName>', 'Filter by CDK stack name (optional)')
+    .option('--snapshot-dir <path>', 'Override snapshot directory (default: OS cache)')
+    .option('--skip-checks', 'Skip environment and schema validation checks')
+    .action(generate_1.generateCommand);
+program
+    .command('validate')
+    .description('Validate a .bprint schema file')
+    .argument('<schemaFile>', 'Schema file to validate')
+    .action(validate_1.validateCommand);
+program
+    .command('doctor')
+    .description('Check system environment and dependencies')
+    .action(doctor_1.doctorCommand);
+program
+    .command('init')
+    .description('Verify and install all prerequisites')
+    .option('--install', 'Install missing dependencies automatically')
+    .option('--verify-only', 'Verify prerequisites only (no installation)')
+    .option('--region <region>', 'AWS region for CDK bootstrap', 'us-east-1')
+    .action(init_1.initCommand);
+program
+    .command('clean')
+    .description('Clean snapshot cache (prune old or stack-specific snapshots)')
+    .option('--stack <stackName>', 'Clean snapshots for specific stack')
+    .option('--all', 'Clean all snapshots')
+    .option('--older-than <days>', 'Clean snapshots older than N days', parseInt)
+    .option('--dry-run', 'Show what would be deleted without deleting')
+    .option('--verbose', 'Show detailed output')
+    .action(clean_1.cleanCommand);
+/**
+ * ==========================
+ * Planned Command Registration
+ * ==========================
+ * Uncomment the corresponding import above and the registration call below
+ * when implementing each command.
+ */
+// ─── TIER 0: Must Have ───────────────────────────────────────────────────────
+// registerAuthLoginCommand(program);
+// registerAuthWhoamiCommand(program);
+// registerAuthLogoutCommand(program);
+// ─── TIER 1: Core Productivity ───────────────────────────────────────────────
+// registerConfigureCommand(program);
+// registerAppsLinkCommand(program);
+// ─── TIER 3: Nice to Have ────────────────────────────────────────────────────
+// registerAuthRefreshCommand(program);
+// registerAppsListCommand(program);
+// registerConfigShowCommand(program);
+// Show help if no command provided
+if (process.argv.length <= 2) {
+    console.log(chalk_1.default.blue('Chaim CLI v0.1.0'));
+    console.log('Usage: chaim <command> [options]');
+    console.log('');
+    console.log(chalk_1.default.yellow('Prerequisite: Run "cdk synth" or "cdk deploy" in your CDK project first'));
+    console.log('');
+    console.log('Commands:');
+    console.log('  init      - Verify and install all prerequisites');
+    console.log('  generate  - Generate SDK code from CDK snapshot (default: java)');
+    console.log('  validate  - Validate a .bprint schema file');
+    console.log('  doctor    - Check system environment and dependencies');
+    console.log('  clean     - Clean snapshot cache (remove old or stale snapshots)');
+    console.log('');
+    console.log('Use \'chaim <command> --help\' for more information');
+    process.exit(0);
+}
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAEA,yCAAoC;AACpC,kDAAsD;AACtD,kDAAsD;AACtD,8CAAkD;AAClD,0CAA8C;AAC9C,4CAAgD;AAChD,kDAA0B;AAE1B;;;;;;;;;;;;GAYG;AAEH,gFAAgF;AAChF,oEAAoE;AACpE,sEAAsE;AACtE,sEAAsE;AAEtE,gFAAgF;AAChF,mEAAmE;AACnE,kEAAkE;AAElE,gFAAgF;AAChF,wEAAwE;AACxE,kEAAkE;AAClE,sEAAsE;AAEtE,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,iDAAiD,CAAC;KAC9D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,6DAA6D,CAAC;KAC1E,cAAc,CAAC,yBAAyB,EAAE,yDAAyD,CAAC;KACpG,MAAM,CAAC,2BAA2B,EAAE,qDAAqD,CAAC;KAC1F,MAAM,CAAC,sBAAsB,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;KACrE,MAAM,CAAC,qBAAqB,EAAE,qCAAqC,CAAC;KACpE,MAAM,CAAC,uBAAuB,EAAE,iDAAiD,CAAC;KAClF,MAAM,CAAC,eAAe,EAAE,+CAA+C,CAAC;KACxE,MAAM,CAAC,0BAAe,CAAC,CAAC;AAE3B,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,gCAAgC,CAAC;KAC7C,QAAQ,CAAC,cAAc,EAAE,yBAAyB,CAAC;KACnD,MAAM,CAAC,0BAAe,CAAC,CAAC;AAE3B,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,sBAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,sCAAsC,CAAC;KACnD,MAAM,CAAC,WAAW,EAAE,4CAA4C,CAAC;KACjE,MAAM,CAAC,eAAe,EAAE,6CAA6C,CAAC;KACtE,MAAM,CAAC,mBAAmB,EAAE,8BAA8B,EAAE,WAAW,CAAC;KACxE,MAAM,CAAC,kBAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,8DAA8D,CAAC;KAC3E,MAAM,CAAC,qBAAqB,EAAE,oCAAoC,CAAC;KACnE,MAAM,CAAC,OAAO,EAAE,qBAAqB,CAAC;KACtC,MAAM,CAAC,qBAAqB,EAAE,mCAAmC,EAAE,QAAQ,CAAC;KAC5E,MAAM,CAAC,WAAW,EAAE,6CAA6C,CAAC;KAClE,MAAM,CAAC,WAAW,EAAE,sBAAsB,CAAC;KAC3C,MAAM,CAAC,oBAAY,CAAC,CAAC;AAExB;;;;;;GAMG;AAEH,gFAAgF;AAChF,qCAAqC;AACrC,sCAAsC;AACtC,sCAAsC;AAEtC,gFAAgF;AAChF,qCAAqC;AACrC,oCAAoC;AAEpC,gFAAgF;AAChF,uCAAuC;AACvC,oCAAoC;AACpC,sCAAsC;AAEtC,mCAAmC;AACnC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,EAAE;IAC5B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,yEAAyE,CAAC,CAAC,CAAC;IACrG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CACjB;AAED,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/planned-commands.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Planned Commands Registry
+ *
+ * This module provides a single source of truth for all CLI commands,
+ * both implemented and planned. It serves as a typed roadmap for
+ * development and can be used to generate documentation or CLI help.
+ *
+ * See also: docs/CLI_ROADMAP.md
+ */
+/**
+ * Priority tier for command implementation
+ */
+export type CommandTier = 'TIER_0' | 'TIER_1' | 'TIER_2' | 'TIER_3';
+/**
+ * Implementation status of a command
+ */
+export type CommandStatus = 'PLANNED' | 'STUB' | 'IMPLEMENTED';
+/**
+ * Specification for a planned or implemented CLI command
+ */
+export interface PlannedCommandSpec {
+    /** Unique identifier (e.g., "auth.login") */
+    id: string;
+    /** Command path as typed by user (e.g., "auth login") */
+    commandPath: string;
+    /** Priority tier */
+    tier: CommandTier;
+    /** One-line summary */
+    summary: string;
+    /** Detailed intent notes */
+    intentNotes: string[];
+    /** Current implementation status */
+    status: CommandStatus;
+}
+/**
+ * All planned and implemented commands in priority order
+ */
+export declare const PLANNED_COMMANDS: PlannedCommandSpec[];
+/**
+ * Get commands by tier
+ */
+export declare function getCommandsByTier(tier: CommandTier): PlannedCommandSpec[];
+/**
+ * Get commands by status
+ */
+export declare function getCommandsByStatus(status: CommandStatus): PlannedCommandSpec[];
+/**
+ * Get a command by ID
+ */
+export declare function getCommandById(id: string): PlannedCommandSpec | undefined;
+//# sourceMappingURL=planned-commands.d.ts.map

package/dist/planned-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planned-commands.d.ts","sourceRoot":"","sources":["../src/planned-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,oCAAoC;IACpC,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EAoKhD,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,kBAAkB,EAAE,CAEzE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,kBAAkB,EAAE,CAE/E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEzE"}

package/dist/planned-commands.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * Planned Commands Registry
+ *
+ * This module provides a single source of truth for all CLI commands,
+ * both implemented and planned. It serves as a typed roadmap for
+ * development and can be used to generate documentation or CLI help.
+ *
+ * See also: docs/CLI_ROADMAP.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCommandById = exports.getCommandsByStatus = exports.getCommandsByTier = exports.PLANNED_COMMANDS = void 0;
+/**
+ * All planned and implemented commands in priority order
+ */
+exports.PLANNED_COMMANDS = [
+    // ===================
+    // TIER 0 - Must Have
+    // ===================
+    {
+        id: 'auth.login',
+        commandPath: 'auth login',
+        tier: 'TIER_0',
+        summary: 'Authenticate a user for CLI usage',
+        intentNotes: [
+            'Initiate browser/device OAuth flow',
+            'Obtain scoped access and refresh tokens',
+            'Store tokens securely in local keychain or encrypted file',
+            'Support multiple profiles/accounts',
+        ],
+        status: 'STUB',
+    },
+    {
+        id: 'auth.whoami',
+        commandPath: 'auth whoami',
+        tier: 'TIER_0',
+        summary: 'Display current authenticated user/org context',
+        intentNotes: [
+            'Show authenticated user email/ID',
+            'Show current organization context',
+            'Show active profile/app context if set',
+            'Indicate token expiry status',
+        ],
+        status: 'STUB',
+    },
+    {
+        id: 'auth.logout',
+        commandPath: 'auth logout',
+        tier: 'TIER_0',
+        summary: 'Clear local credentials',
+        intentNotes: [
+            'Remove stored tokens from local storage',
+            'Optionally revoke tokens server-side',
+            'Support logging out specific profile or all profiles',
+        ],
+        status: 'STUB',
+    },
+    // ==========================
+    // TIER 1 - Core Productivity
+    // ==========================
+    {
+        id: 'configure',
+        commandPath: 'configure',
+        tier: 'TIER_1',
+        summary: 'Interactive setup for CLI defaults',
+        intentNotes: [
+            'Prompt for common options: appId, env, region, stack, output, javaPackage',
+            'Store in global (~/.chaim/config.json) or repo (./chaim.json) config',
+            'Validate inputs where possible',
+            'Support --global and --local flags',
+        ],
+        status: 'STUB',
+    },
+    {
+        id: 'apps.link',
+        commandPath: 'apps link',
+        tier: 'TIER_1',
+        summary: 'Associate CLI with a Chaim application',
+        intentNotes: [
+            'Accept app ID or prompt interactively',
+            'Validate user has access to the application',
+            'Cache app descriptor locally for offline use',
+            'Store link in repo config (./chaim.json)',
+        ],
+        status: 'STUB',
+    },
+    // ==========================
+    // TIER 2 - Existing Commands
+    // ==========================
+    {
+        id: 'init',
+        commandPath: 'init',
+        tier: 'TIER_2',
+        summary: 'Verify and install all prerequisites',
+        intentNotes: [
+            'Check Node.js, Java, AWS CLI, CDK CLI versions',
+            'Optionally install missing dependencies',
+            'Bootstrap CDK if needed',
+        ],
+        status: 'IMPLEMENTED',
+    },
+    {
+        id: 'generate',
+        commandPath: 'generate',
+        tier: 'TIER_2',
+        summary: 'Generate SDK from schema or CDK stack',
+        intentNotes: [
+            'Read CloudFormation stack metadata',
+            'Validate schemas using chaim-bprint-spec',
+            'Generate language-specific SDK (Java first)',
+            'Future: use defaults from config, require auth for Chaim APIs',
+        ],
+        status: 'IMPLEMENTED',
+    },
+    {
+        id: 'validate',
+        commandPath: 'validate',
+        tier: 'TIER_2',
+        summary: 'Validate a .bprint schema file',
+        intentNotes: [
+            'Parse and validate against chaim-bprint-spec',
+            'Report detailed validation errors',
+        ],
+        status: 'IMPLEMENTED',
+    },
+    {
+        id: 'doctor',
+        commandPath: 'doctor',
+        tier: 'TIER_2',
+        summary: 'Check system environment and dependencies',
+        intentNotes: [
+            'Verify Node.js, Java, AWS CLI, AWS credentials',
+            'Future: validate auth status and config files',
+        ],
+        status: 'IMPLEMENTED',
+    },
+    // =======================
+    // TIER 3 - Nice to Have
+    // =======================
+    {
+        id: 'auth.refresh',
+        commandPath: 'auth refresh',
+        tier: 'TIER_3',
+        summary: 'Manually refresh authentication tokens',
+        intentNotes: [
+            'Force refresh of access token using refresh token',
+            'Useful for debugging token issues',
+            'Rarely needed in normal flow (auto-refresh handled internally)',
+        ],
+        status: 'STUB',
+    },
+    {
+        id: 'apps.list',
+        commandPath: 'apps list',
+        tier: 'TIER_3',
+        summary: 'List applications the user can access',
+        intentNotes: [
+            'Query Chaim API for accessible applications',
+            'Display app ID, name, and access level',
+            'Support filtering and pagination',
+        ],
+        status: 'STUB',
+    },
+    {
+        id: 'config.show',
+        commandPath: 'config show',
+        tier: 'TIER_3',
+        summary: 'Print resolved configuration',
+        intentNotes: [
+            'Load global and repo config files',
+            'Show merged/resolved values',
+            'Indicate source of each value (global vs repo)',
+            'Useful for debugging configuration issues',
+        ],
+        status: 'STUB',
+    },
+];
+/**
+ * Get commands by tier
+ */
+function getCommandsByTier(tier) {
+    return exports.PLANNED_COMMANDS.filter((cmd) => cmd.tier === tier);
+}
+exports.getCommandsByTier = getCommandsByTier;
+/**
+ * Get commands by status
+ */
+function getCommandsByStatus(status) {
+    return exports.PLANNED_COMMANDS.filter((cmd) => cmd.status === status);
+}
+exports.getCommandsByStatus = getCommandsByStatus;
+/**
+ * Get a command by ID
+ */
+function getCommandById(id) {
+    return exports.PLANNED_COMMANDS.find((cmd) => cmd.id === id);
+}
+exports.getCommandById = getCommandById;
+//# sourceMappingURL=planned-commands.js.map

package/dist/planned-commands.js.map

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

package/dist/services/os-cache-paths.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Get the default base directory for Chaim snapshots based on OS.
+ * - macOS/Linux: ~/.chaim/cache/snapshots
+ * - Windows: %LOCALAPPDATA%/chaim/cache/snapshots (or homedir fallback)
+ */
+export declare function getDefaultSnapshotBaseDir(): string;
+/**
+ * Get the snapshot base directory, respecting CHAIM_SNAPSHOT_DIR override.
+ */
+export declare function getSnapshotBaseDir(): string;
+/**
+ * Ensure a directory exists, creating it recursively if needed.
+ */
+export declare function ensureDirExists(dir: string): void;
+//# sourceMappingURL=os-cache-paths.d.ts.map

package/dist/services/os-cache-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-cache-paths.d.ts","sourceRoot":"","sources":["../../src/services/os-cache-paths.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEjD"}

package/dist/services/os-cache-paths.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDirExists = exports.getSnapshotBaseDir = exports.getDefaultSnapshotBaseDir = void 0;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+/**
+ * Get the default base directory for Chaim snapshots based on OS.
+ * - macOS/Linux: ~/.chaim/cache/snapshots
+ * - Windows: %LOCALAPPDATA%/chaim/cache/snapshots (or homedir fallback)
+ */
+function getDefaultSnapshotBaseDir() {
+    if (process.platform === 'win32') {
+        const localAppData = process.env.LOCALAPPDATA ?? os.homedir();
+        return path.join(localAppData, 'chaim', 'cache', 'snapshots');
+    }
+    return path.join(os.homedir(), '.chaim', 'cache', 'snapshots');
+}
+exports.getDefaultSnapshotBaseDir = getDefaultSnapshotBaseDir;
+/**
+ * Get the snapshot base directory, respecting CHAIM_SNAPSHOT_DIR override.
+ */
+function getSnapshotBaseDir() {
+    return process.env.CHAIM_SNAPSHOT_DIR ?? getDefaultSnapshotBaseDir();
+}
+exports.getSnapshotBaseDir = getSnapshotBaseDir;
+/**
+ * Ensure a directory exists, creating it recursively if needed.
+ */
+function ensureDirExists(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+exports.ensureDirExists = ensureDirExists;
+//# sourceMappingURL=os-cache-paths.js.map

package/dist/services/os-cache-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-cache-paths.js","sourceRoot":"","sources":["../../src/services/os-cache-paths.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AAEzB;;;;GAIG;AACH,SAAgB,yBAAyB;IACvC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE;QAChC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;KAC/D;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;AACjE,CAAC;AAND,8DAMC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,yBAAyB,EAAE,CAAC;AACvE,CAAC;AAFD,gDAEC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,GAAW;IACzC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAFD,0CAEC"}

package/dist/services/snapshot-discovery.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Discovery options for filtering snapshots.
+ */
+export interface DiscoveryOptions {
+    /** Filter by CDK stack name */
+    stackName?: string;
+}
+/**
+ * Information about a discovered LOCAL snapshot file.
+ *
+ * Reflects the hierarchical path structure:
+ *   aws/{accountId}/{region}/{stackName}/{datastoreType}/{resourceId}.json
+ */
+export interface SnapshotFileInfo {
+    /** Full path to the snapshot file */
+    filePath: string;
+    /** AWS account ID (may be 'unknown') */
+    accountId: string;
+    /** AWS region (may be 'unknown') */
+    region: string;
+    /** CDK stack name */
+    stackName: string;
+    /** Data store type (dynamodb, aurora, etc.) */
+    datastoreType: string;
+    /** Resource ID from filename ({resourceName}__{entityName}[__N]) */
+    resourceId: string;
+    /** Resource name (parsed from resourceId) */
+    resourceName: string;
+    /** Entity name (parsed from resourceId) */
+    entityName: string;
+    /** Captured timestamp from payload (for sorting) */
+    capturedAt: Date;
+}
+/**
+ * Result of resolving a snapshot.
+ */
+export interface ResolvedSnapshot {
+    /** Full path to the snapshot file */
+    filePath: string;
+    /** Parsed snapshot content */
+    snapshot: any;
+    /** Stack name */
+    stackName: string;
+    /** AWS account ID */
+    accountId: string;
+    /** AWS region */
+    region: string;
+    /** Data store type */
+    datastoreType: string;
+    /** Resource name */
+    resourceName: string;
+    /** Entity name */
+    entityName: string;
+}
+/**
+ * Recursively discover all LOCAL snapshot files in the OS cache.
+ *
+ * Directory structure:
+ *   aws/{accountId}/{region}/{stackName}/{datastoreType}/{resourceId}.json
+ *
+ * @param snapshotDir - Base snapshot directory (defaults to OS cache)
+ * @param options - Discovery options for filtering
+ * @returns Array of snapshot file info, sorted by capturedAt descending (newest first)
+ */
+export declare function discoverSnapshots(snapshotDir?: string, options?: DiscoveryOptions): SnapshotFileInfo[];
+/**
+ * List all snapshot files with optional stack filtering.
+ *
+ * @param snapshotDir - Base snapshot directory (defaults to OS cache)
+ * @param stackName - Optional stack name filter
+ * @returns Array of snapshot file info, sorted by capturedAt descending (newest first)
+ */
+export declare function listSnapshots(snapshotDir?: string, stackName?: string): SnapshotFileInfo[];
+/**
+ * Get the latest snapshot matching the given options.
+ *
+ * @param snapshotDir - Base snapshot directory (defaults to OS cache)
+ * @param options - Discovery options for filtering
+ * @returns The latest snapshot file info, or undefined if none found
+ */
+export declare function getLatestSnapshot(snapshotDir?: string, options?: DiscoveryOptions): SnapshotFileInfo | undefined;
+/**
+ * Resolve which snapshot to use based on the requested options.
+ *
+ * Selection logic:
+ * 1. Find all snapshots matching filter (--stack if provided)
+ * 2. Select the newest by capturedAt
+ * 3. If none found, return undefined
+ *
+ * @param snapshotDir - Base snapshot directory (defaults to OS cache)
+ * @param stackName - Optional stack name filter
+ * @returns Resolved snapshot info, or undefined if no snapshot found
+ */
+export declare function resolveSnapshot(snapshotDir?: string, stackName?: string): ResolvedSnapshot | undefined;
+/**
+ * Resolve all snapshots matching the given options.
+ * Used for multi-entity generation.
+ *
+ * @param snapshotDir - Base snapshot directory (defaults to OS cache)
+ * @param options - Discovery options for filtering
+ * @returns Array of resolved snapshots, or empty array if none found
+ */
+export declare function resolveAllSnapshots(snapshotDir?: string, options?: DiscoveryOptions): ResolvedSnapshot[];
+/**
+ * Get the full path to the snapshot directory.
+ *
+ * @param snapshotDir - Snapshot directory (relative or absolute, or undefined for OS cache)
+ * @returns Absolute path to the snapshot directory
+ */
+export declare function getSnapshotDirPath(snapshotDir?: string): string;
+//# sourceMappingURL=snapshot-discovery.d.ts.map

package/dist/services/snapshot-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-discovery.d.ts","sourceRoot":"","sources":["../../src/services/snapshot-discovery.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,UAAU,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,EAAE,GAAG,CAAC;IACd,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAqBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,EAAE,CAuFpB;AAgBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAE1F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,GAAG,SAAS,CAG9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,WAAW,CAAC,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,gBAAgB,GAAG,SAAS,CAqB9B;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,EAAE,CAkBpB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ/D"}