aspectcode 0.2.0

package/dist/commands/init.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * `aspectcode init` — create an `aspectcode.json` config file.
+ */
+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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInit = runInit;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const config_1 = require("../config");
+const cli_1 = require("../cli");
+const logger_1 = require("../logger");
+const settings_1 = require("./settings");
+const watch_1 = require("./watch");
+async function runInit(ctx, deps = {}) {
+    const { root, flags, log } = ctx;
+    (0, settings_1.printAspectCodeBanner)(log);
+    const dest = (0, config_1.configPath)(root);
+    // Guard: config already exists
+    const existing = (0, config_1.loadConfig)(root);
+    if (existing && !flags.force) {
+        log.warn(`${config_1.CONFIG_FILE_NAME} already exists. Use ${logger_1.fmt.bold('--force')} to overwrite.`);
+        return { exitCode: cli_1.ExitCode.OK };
+    }
+    const config = await resolveInitConfig(flags);
+    const content = JSON.stringify(config, null, 2) + '\n';
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.writeFileSync(dest, content, 'utf-8');
+    log.success(`Created ${logger_1.fmt.cyan(config_1.CONFIG_FILE_NAME)}`);
+    log.info('');
+    log.info(`  Next step: run ${logger_1.fmt.bold('aspectcode generate')} to build the knowledge base.`);
+    log.info(`  Edit ${logger_1.fmt.cyan(config_1.CONFIG_FILE_NAME)} to customise output and exclusions.`);
+    if (!flags.quiet && isInteractiveTty()) {
+        const startWatchNow = await askYesNo('Start watch now?', false);
+        if (startWatchNow) {
+            const watchRunner = deps.runWatchFn ?? watch_1.runWatch;
+            return await watchRunner({ root, flags, config, log, positionals: [] });
+        }
+    }
+    return { exitCode: cli_1.ExitCode.OK };
+}
+async function resolveInitConfig(flags) {
+    const defaults = (0, config_1.defaultConfig)();
+    if (flags.quiet || !isInteractiveTty()) {
+        return defaults;
+    }
+    const updateRate = await selectUpdateRate(defaults.updateRate ?? 'onChange');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const outDirAnswer = (await ask(rl, 'Where should generated files be written? (leave blank for workspace root): ')).trim();
+        const outDir = outDirAnswer || undefined;
+        const excludeAnswer = await ask(rl, 'Any paths to exclude from analysis? (comma-separated, leave blank for none): ');
+        const exclude = parseExcludeList(excludeAnswer);
+        return {
+            ...defaults,
+            updateRate,
+            ...(outDir ? { outDir } : {}),
+            ...(exclude.length > 0 ? { exclude } : {}),
+        };
+    }
+    finally {
+        rl.close();
+    }
+}
+function ask(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(answer));
+    });
+}
+async function askYesNo(question, defaultValue) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const defaultHint = defaultValue ? '[Y/n]' : '[y/N]';
+    try {
+        const answer = (await ask(rl, `${question} ${defaultHint} `)).trim().toLowerCase();
+        if (!answer) {
+            return defaultValue;
+        }
+        return answer === 'y' || answer === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+async function selectUpdateRate(defaultRate) {
+    const options = ['onChange', 'idle', 'manual'];
+    const fallback = defaultRate === 'manual' || defaultRate === 'idle' || defaultRate === 'onChange'
+        ? defaultRate
+        : 'onChange';
+    const selected = await selectWithArrowKeys('Update rate (arrow keys + Enter):', options, options.indexOf(fallback) >= 0 ? options.indexOf(fallback) : 0);
+    return selected;
+}
+async function selectWithArrowKeys(prompt, options, initialIndex) {
+    if (options.length === 0) {
+        throw new Error('selectWithArrowKeys requires at least one option');
+    }
+    if (!isInteractiveTty()) {
+        const boundedIndex = Math.min(Math.max(initialIndex, 0), options.length - 1);
+        return options[boundedIndex];
+    }
+    const input = process.stdin;
+    const output = process.stdout;
+    let index = Math.min(Math.max(initialIndex, 0), options.length - 1);
+    let renderedLines = 0;
+    const render = () => {
+        if (renderedLines > 0) {
+            readline.moveCursor(output, 0, -renderedLines);
+            readline.cursorTo(output, 0);
+            readline.clearScreenDown(output);
+        }
+        const lines = [
+            `${prompt} ${logger_1.fmt.dim('(↑/↓ then Enter)')}`,
+            ...options.map((option, optionIndex) => {
+                const marker = optionIndex === index ? logger_1.fmt.cyan('❯') : ' ';
+                return `${marker} ${option}`;
+            }),
+        ];
+        output.write(lines.join('\n') + '\n');
+        renderedLines = lines.length;
+    };
+    return await new Promise((resolve, reject) => {
+        const previousRawMode = input.isRaw === true;
+        const cleanup = () => {
+            input.off('keypress', onKeypress);
+            if (typeof input.setRawMode === 'function') {
+                input.setRawMode(previousRawMode);
+            }
+            input.pause();
+            readline.cursorTo(output, 0);
+            readline.clearScreenDown(output);
+            output.write(`${prompt} ${logger_1.fmt.cyan(options[index])}\n`);
+        };
+        const onKeypress = (_str, key) => {
+            if (key.name === 'up') {
+                index = index > 0 ? index - 1 : options.length - 1;
+                render();
+                return;
+            }
+            if (key.name === 'down') {
+                index = index < options.length - 1 ? index + 1 : 0;
+                render();
+                return;
+            }
+            if (key.name === 'return' || key.name === 'enter') {
+                cleanup();
+                resolve(options[index]);
+                return;
+            }
+            if (key.ctrl && key.name === 'c') {
+                cleanup();
+                reject(new Error('Cancelled by user'));
+            }
+        };
+        readline.emitKeypressEvents(input);
+        if (typeof input.setRawMode === 'function') {
+            input.setRawMode(true);
+        }
+        input.resume();
+        input.on('keypress', onKeypress);
+        render();
+    });
+}
+function isInteractiveTty() {
+    return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}
+function parseExcludeList(input) {
+    return input
+        .split(',')
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0);
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/settings.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `aspectcode` settings commands.
+ */
+import type { CommandContext, CommandResult } from '../cli';
+import type { Logger } from '../logger';
+export declare function printAspectCodeBanner(log: Logger): void;
+export declare function runShowConfig(ctx: CommandContext): Promise<CommandResult>;
+export declare function runSetUpdateRate(ctx: CommandContext, value: string): Promise<CommandResult>;
+export declare function runSetOutDir(ctx: CommandContext, value: string): Promise<CommandResult>;
+export declare function runClearOutDir(ctx: CommandContext): Promise<CommandResult>;
+export declare function runAddExclude(ctx: CommandContext, value: string): Promise<CommandResult>;
+export declare function runRemoveExclude(ctx: CommandContext, value: string): Promise<CommandResult>;
+//# sourceMappingURL=settings.d.ts.map

package/dist/commands/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/commands/settings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAY,cAAc,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAkBxC,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAcvD;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,aAAa,CAAC,CAsBxB;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC,CAexB;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC,CASxB;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,aAAa,CAAC,CAIxB;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC,CAaxB;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC,CAcxB"}

package/dist/commands/settings.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * `aspectcode` settings commands.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printAspectCodeBanner = printAspectCodeBanner;
+exports.runShowConfig = runShowConfig;
+exports.runSetUpdateRate = runSetUpdateRate;
+exports.runSetOutDir = runSetOutDir;
+exports.runClearOutDir = runClearOutDir;
+exports.runAddExclude = runAddExclude;
+exports.runRemoveExclude = runRemoveExclude;
+const cli_1 = require("../cli");
+const config_1 = require("../config");
+const logger_1 = require("../logger");
+function printAspectCodeBanner(log) {
+    const lines = [
+        '  ___   ____  ____  _____ ____ _____    ____ ___  ____  _____',
+        ' / _ \\ / ___||  _ \\| ____/ ___|_   _|  / ___/ _ \\|  _ \\| ____|',
+        '| | | |\\___ \\| |_) |  _|| |     | |   | |  | | | | | | |  _|',
+        '| |_| | ___) |  __/| |__| |___  | |   | |__| |_| | |_| | |___',
+        ' \\___/ |____/|_|   |_____\\____| |_|    \\____\\___/|____/|_____|',
+        '                         ASPECT CODE',
+    ];
+    for (const line of lines) {
+        log.info(logger_1.fmt.blue(line));
+    }
+    log.blank();
+}
+async function runShowConfig(ctx) {
+    const { root, flags, log } = ctx;
+    const command = 'show-config';
+    try {
+        const current = (0, config_1.loadRawConfig)(root) ?? {};
+        const displayConfig = withCanonicalUpdateRate(current);
+        if (flags.json) {
+            emitJson({
+                ok: true,
+                command,
+                config: displayConfig,
+            });
+        }
+        else {
+            log.info(JSON.stringify(displayConfig, null, 2));
+        }
+        return { exitCode: cli_1.ExitCode.OK };
+    }
+    catch (error) {
+        return outputError(command, flags, log, error);
+    }
+}
+async function runSetUpdateRate(ctx, value) {
+    const parsed = parseUpdateRate(value);
+    if (!parsed) {
+        return outputUsageError('set-update-rate', ctx.flags, ctx.log, `Invalid update rate: ${logger_1.fmt.bold(value)}. Expected manual|onChange|idle.`);
+    }
+    return runSettingsMutation(ctx, 'set-update-rate', ['updateRate', 'autoRegenerateKb'], (cfg) => {
+        cfg.updateRate = parsed;
+        delete cfg.autoRegenerateKb;
+    });
+}
+async function runSetOutDir(ctx, value) {
+    const outDir = value.trim();
+    if (!outDir) {
+        return outputUsageError('set-out-dir', ctx.flags, ctx.log, `${logger_1.fmt.bold('set-out-dir')} requires a non-empty path value.`);
+    }
+    return runSettingsMutation(ctx, 'set-out-dir', ['outDir'], (cfg) => {
+        cfg.outDir = outDir;
+    });
+}
+async function runClearOutDir(ctx) {
+    return runSettingsMutation(ctx, 'clear-out-dir', ['outDir'], (cfg) => {
+        delete cfg.outDir;
+    });
+}
+async function runAddExclude(ctx, value) {
+    const excludePath = value.trim();
+    if (!excludePath) {
+        return outputUsageError('add-exclude', ctx.flags, ctx.log, `${logger_1.fmt.bold('add-exclude')} requires a non-empty path value.`);
+    }
+    return runSettingsMutation(ctx, 'add-exclude', ['exclude'], (cfg) => {
+        const list = normalizeExcludeList(cfg.exclude);
+        if (!list.includes(excludePath)) {
+            list.push(excludePath);
+        }
+        cfg.exclude = list;
+    });
+}
+async function runRemoveExclude(ctx, value) {
+    const excludePath = value.trim();
+    if (!excludePath) {
+        return outputUsageError('remove-exclude', ctx.flags, ctx.log, `${logger_1.fmt.bold('remove-exclude')} requires a non-empty path value.`);
+    }
+    return runSettingsMutation(ctx, 'remove-exclude', ['exclude'], (cfg) => {
+        const list = normalizeExcludeList(cfg.exclude).filter((entry) => entry !== excludePath);
+        if (list.length > 0) {
+            cfg.exclude = list;
+        }
+        else {
+            delete cfg.exclude;
+        }
+    });
+}
+// ── Shared mutation runner ───────────────────────────────────
+/**
+ * Generic helper for settings mutation commands.
+ *
+ * Encapsulates the try/catch + load → mutate → save → output pattern
+ * shared by all mutation commands.
+ */
+function runSettingsMutation(ctx, command, changed, mutate) {
+    const { root, flags, log } = ctx;
+    try {
+        const nextConfig = updateRawConfig(root, mutate);
+        return outputSuccess(command, flags, log, nextConfig, changed);
+    }
+    catch (error) {
+        return outputError(command, flags, log, error);
+    }
+}
+function updateRawConfig(root, apply) {
+    const nextConfig = { ...((0, config_1.loadRawConfig)(root) ?? {}) };
+    apply(nextConfig);
+    (0, config_1.saveRawConfig)(root, nextConfig);
+    return nextConfig;
+}
+function withCanonicalUpdateRate(config) {
+    if (config.updateRate || !config.autoRegenerateKb) {
+        return { ...config };
+    }
+    let mapped;
+    if (config.autoRegenerateKb === 'off') {
+        mapped = 'manual';
+    }
+    else if (config.autoRegenerateKb === 'onSave') {
+        mapped = 'onChange';
+    }
+    else if (config.autoRegenerateKb === 'idle') {
+        mapped = 'idle';
+    }
+    if (!mapped) {
+        return { ...config };
+    }
+    return {
+        ...config,
+        updateRate: mapped,
+    };
+}
+function parseUpdateRate(value) {
+    const normalized = value.trim();
+    if (normalized === 'manual' || normalized === 'onChange' || normalized === 'idle') {
+        return normalized;
+    }
+    return undefined;
+}
+function normalizeExcludeList(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((item) => typeof item === 'string');
+}
+function outputSuccess(command, flags, log, config, changed) {
+    if (flags.json) {
+        const payload = { ok: true, command, config, changed };
+        emitJson(payload);
+    }
+    else {
+        log.success(`Updated ${logger_1.fmt.cyan('aspectcode.json')} via ${logger_1.fmt.bold(command)}.`);
+    }
+    return { exitCode: cli_1.ExitCode.OK };
+}
+function outputUsageError(command, flags, log, message) {
+    if (flags.json) {
+        const payload = { ok: false, command, error: message };
+        emitJson(payload);
+    }
+    else {
+        log.error(message);
+    }
+    return { exitCode: cli_1.ExitCode.USAGE };
+}
+function outputError(command, flags, log, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (flags.json) {
+        const payload = { ok: false, command, error: message };
+        emitJson(payload);
+    }
+    else {
+        log.error(message);
+    }
+    return { exitCode: cli_1.ExitCode.ERROR };
+}
+function emitJson(payload) {
+    console.log(JSON.stringify(payload, null, 2));
+}
+//# sourceMappingURL=settings.js.map

package/dist/commands/settings.js.map

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

package/dist/commands/watch.d.ts

@@ -0,0 +1,6 @@
+import type { CliFlags, CommandContext, CommandResult } from '../cli';
+import type { AspectCodeConfig } from '../config';
+export type WatchMode = 'manual' | 'onChange' | 'idle';
+export declare function resolveWatchMode(flags: CliFlags, config: AspectCodeConfig | undefined): WatchMode;
+export declare function runWatch(ctx: CommandContext): Promise<CommandResult>;
+//# sourceMappingURL=watch.d.ts.map

package/dist/commands/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAIlD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;AAuBvD,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,gBAAgB,GAAG,SAAS,GACnC,SAAS,CAEX;AAYD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA2H1E"}

package/dist/commands/watch.js

@@ -0,0 +1,181 @@
+"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 () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveWatchMode = resolveWatchMode;
+exports.runWatch = runWatch;
+const path = __importStar(require("path"));
+const core_1 = require("@aspectcode/core");
+const cli_1 = require("../cli");
+const logger_1 = require("../logger");
+const generate_1 = require("./generate");
+const ON_CHANGE_DEBOUNCE_MS = 2000;
+const IDLE_DEBOUNCE_MS = 30000;
+const IGNORED_SEGMENTS = [
+    '/node_modules/',
+    '/.git/',
+    '/.aspect/',
+    '/dist/',
+    '/build/',
+    '/target/',
+    '/coverage/',
+    '/.next/',
+    '/__pycache__/',
+    '/.venv/',
+    '/venv/',
+    '/.pytest_cache/',
+    '/.mypy_cache/',
+    '/.tox/',
+    '/htmlcov/',
+];
+function resolveWatchMode(flags, config) {
+    return flags.mode ?? config?.updateRate ?? 'onChange';
+}
+function isSupportedSourceFile(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return core_1.SUPPORTED_EXTENSIONS.includes(ext);
+}
+function isIgnoredPath(filePath) {
+    const normalized = filePath.replace(/\\/g, '/').toLowerCase();
+    return IGNORED_SEGMENTS.some((seg) => normalized.includes(seg));
+}
+async function runWatch(ctx) {
+    const { root, flags, config, log } = ctx;
+    const chokidarModule = await Promise.resolve().then(() => __importStar(require('chokidar')));
+    // Handle both ESM default export and CJS module shapes
+    const chokidar = chokidarModule.default ?? chokidarModule;
+    const mode = resolveWatchMode(flags, config);
+    const exts = core_1.SUPPORTED_EXTENSIONS.map((ext) => ext.slice(1)).join(',');
+    log.info(`Workspace: ${logger_1.fmt.cyan(root)}`);
+    log.info(`Mode:      ${logger_1.fmt.cyan(mode)}`);
+    log.info(`Watching:  ${logger_1.fmt.dim(`**/*.{${exts}}`)}`);
+    log.info(logger_1.fmt.dim('No initial run. Waiting for file changes...'));
+    log.blank();
+    const watcher = chokidar.watch('.', {
+        cwd: root,
+        ignoreInitial: true,
+        awaitWriteFinish: {
+            stabilityThreshold: 200,
+            pollInterval: 100,
+        },
+        ignored: (watchedPath) => {
+            const abs = path.resolve(root, watchedPath);
+            return isIgnoredPath(abs);
+        },
+    });
+    let timer;
+    let running = false;
+    let pending = false;
+    let stopped = false;
+    const triggerGenerate = async (reason) => {
+        if (stopped)
+            return;
+        if (running) {
+            pending = true;
+            log.debug(`[watch] generation already in progress; queued (${reason})`);
+            return;
+        }
+        running = true;
+        try {
+            log.info(`${logger_1.fmt.bold('watch')} trigger: ${reason}`);
+            await (0, generate_1.runGenerate)({ root, flags: { ...flags, listConnections: false, json: false }, config, log, positionals: [] });
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            log.error(`watch regeneration failed: ${msg}`);
+        }
+        finally {
+            running = false;
+            if (pending && !stopped) {
+                pending = false;
+                void triggerGenerate('queued changes');
+            }
+        }
+    };
+    const scheduleOnChange = (reason) => {
+        if (mode === 'manual') {
+            log.debug(`[watch] change detected (${reason}) but mode=manual`);
+            return;
+        }
+        if (timer) {
+            clearTimeout(timer);
+        }
+        const delay = mode === 'idle' ? IDLE_DEBOUNCE_MS : ON_CHANGE_DEBOUNCE_MS;
+        timer = setTimeout(() => {
+            timer = undefined;
+            void triggerGenerate(reason);
+        }, delay);
+    };
+    const onFsEvent = (eventType, eventPath) => {
+        const abs = path.resolve(root, eventPath);
+        if (!isSupportedSourceFile(abs) || isIgnoredPath(abs)) {
+            return;
+        }
+        scheduleOnChange(`${eventType}: ${eventPath.replace(/\\/g, '/')}`);
+    };
+    watcher.on('add', (p) => onFsEvent('add', p));
+    watcher.on('change', (p) => onFsEvent('change', p));
+    watcher.on('unlink', (p) => onFsEvent('unlink', p));
+    watcher.on('error', (e) => {
+        log.error(`watcher error: ${String(e)}`);
+    });
+    await new Promise((resolve) => {
+        watcher.once('ready', () => resolve());
+    });
+    log.info(logger_1.fmt.dim('Watcher ready.'));
+    return await new Promise((resolve) => {
+        const shutdown = async (signal) => {
+            if (stopped)
+                return;
+            stopped = true;
+            if (timer) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+            log.blank();
+            log.info(logger_1.fmt.dim(`Stopping watch (${signal})...`));
+            await watcher.close();
+            resolve({ exitCode: cli_1.ExitCode.OK });
+        };
+        const onSigInt = () => {
+            void shutdown('SIGINT');
+        };
+        const onSigTerm = () => {
+            void shutdown('SIGTERM');
+        };
+        process.once('SIGINT', onSigInt);
+        process.once('SIGTERM', onSigTerm);
+    });
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

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