domain-driver 0.2.0 → 0.3.1

package/README.md

@@ -209,6 +209,28 @@ Server-side repositories throw a clear not-implemented error until you wire your
 
 ---
 
+## Updating
+
+Every command checks the registry at most once a day and, when a newer release exists, prints one line after its output:
+
+```
+ℹ️  domain-driver 0.3.0 is available (you have 0.2.0). Run: domain-driver update
+```
+
+```bash
+domain-driver update            # detects how it was installed, runs your package manager, refreshes the guidance
+domain-driver update --dry-run  # show the command it would run
+domain-driver update --check    # only report whether a newer version exists
+```
+
+Local installs use the package manager the project uses (npm, pnpm, yarn, or bun, from the `packageManager` field or the lockfile). Global installs use `npm install -g`. Running through `npx` needs no update: `npx domain-driver@latest` always fetches the newest.
+
+The check is skipped in CI (any `CI` value other than empty, `0`, or `false`), when output is not a terminal, when `DOMAIN_DRIVER_NO_UPDATE_CHECK` is set (same value rule), or when `NO_UPDATE_NOTIFIER` is set to anything.
+
+The cache lives in `~/.cache/domain-driver` (or `$XDG_CACHE_HOME/domain-driver`); `DOMAIN_DRIVER_CACHE_DIR` overrides it.
+
+---
+
 ## Upgrading from 0.1.0
 
 Every layer command now takes a single `<feature>/<Name>` target instead of separate feature and name arguments, for example `make:schema users User` becomes `make:schema users/User`. `make:feature users -a` still works and names the entity `Users`; write `users/User` if you want a different entity name.
@@ -217,7 +239,7 @@ Every layer command now takes a single `<feature>/<Name>` target instead of sepa
 
 ## Requirements
 
-- Node.js 18+
+- Node.js 20+
 
 ---
 

package/dist/cli.js

@@ -0,0 +1,208 @@
+"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.defaultCliDeps = defaultCliDeps;
+exports.createProgram = createProgram;
+// src/cli.ts
+const commander_1 = require("commander");
+const os = __importStar(require("os"));
+const action_1 = require("./commands/action");
+const component_1 = require("./commands/component");
+const container_1 = require("./commands/container");
+const controller_1 = require("./commands/controller");
+const feature_1 = require("./commands/feature");
+const hints_1 = require("./commands/hints");
+const hook_1 = require("./commands/hook");
+const repository_1 = require("./commands/repository");
+const schema_1 = require("./commands/schema");
+const service_1 = require("./commands/service");
+const sides_1 = require("./commands/sides");
+const target_1 = require("./commands/target");
+const types_1 = require("./commands/types");
+const update_1 = require("./commands/update");
+const init_1 = require("./init/init");
+const detect_1 = require("./stack/detect");
+const types_2 = require("./stack/types");
+const actions_1 = require("./templates/actions");
+const check_1 = require("./update/check");
+const registry_1 = require("./update/registry");
+const version_1 = require("./update/version");
+const SKIP_DETECTION = new Set(['init', 'update']);
+function defaultCliDeps() {
+    return {
+        env: process.env,
+        isTTY: process.stdout.isTTY === true,
+        homedir: os.homedir(),
+        now: Date.now,
+        fetchImpl: registry_1.nodeFetch,
+        current: (0, version_1.currentVersion)(),
+        updateDeps: update_1.defaultUpdateDeps,
+        log: (line) => console.log(line),
+    };
+}
+function createProgram(deps) {
+    const program = new commander_1.Command();
+    program
+        .name('domain-driver')
+        .description('CLI scaffolding tool for domain-driven feature folders in Next.js, React, Node, and NestJS projects')
+        .version(deps.current)
+        .option('--stack <name>', `Override stack detection (${types_2.STACK_NAMES.join(', ')})`);
+    let pendingNotice = Promise.resolve(null);
+    program.hook('preAction', (_thisCommand, actionCommand) => {
+        const name = actionCommand.name();
+        if ((0, check_1.shouldCheck)(deps.env, deps.isTTY, name)) {
+            pendingNotice = (0, check_1.checkForUpdate)({
+                env: deps.env,
+                homedir: deps.homedir,
+                now: deps.now,
+                fetchImpl: deps.fetchImpl,
+                current: deps.current,
+            });
+        }
+        if (SKIP_DETECTION.has(name))
+            return;
+        const { stack } = program.opts();
+        deps.log((0, detect_1.describeStack)((0, detect_1.detectStack)(stack)));
+    });
+    program.hook('postAction', async () => {
+        const notice = await pendingNotice;
+        if (notice !== null)
+            deps.log(notice);
+    });
+    program
+        .command('make:feature <target>')
+        .description('Scaffold a feature folder for the detected stack (<feature> or <feature>/<Entity>)')
+        .option('-a, --all', 'Scaffold all files inside each folder')
+        .action(async (target, options) => {
+        const { feature, entity } = (0, target_1.parseFeatureTarget)(target);
+        await (0, feature_1.makeFeature)(feature, options.all ?? false, entity ?? undefined);
+    });
+    program
+        .command('make:component <target>')
+        .description('Scaffold a component inside an existing feature (<feature>/<Name>)')
+        .argument('[type]', 'Component type: client or server', 'client')
+        .action((target, type) => {
+        const { feature, name } = (0, target_1.parseTarget)(target);
+        (0, component_1.makeComponent)(feature, name, (0, component_1.parseComponentType)(type));
+    });
+    program
+        .command('make:container <target>')
+        .description('Scaffold a smart container component inside an existing feature (<feature>/<Name>)')
+        .action((target) => {
+        const { feature, name } = (0, target_1.parseTarget)(target);
+        (0, container_1.makeContainer)(feature, name);
+    });
+    program
+        .command('make:hook <target>')
+        .description('Scaffold a custom hook inside an existing feature (<feature>/<useName>)')
+        .action((target) => {
+        const { feature, name } = (0, target_1.parseTarget)(target);
+        (0, hook_1.makeHook)(feature, name);
+    });
+    program
+        .command('make:service <target>')
+        .description('Scaffold single-responsibility service files inside an existing feature (<feature>/<Entity>)')
+        .option('--side <side>', 'client, server, or both', 'both')
+        .action((target, options) => {
+        const { feature, name } = (0, target_1.parseTarget)(target);
+        const wrote = (0, service_1.makeService)(feature, name, (0, sides_1.parseSide)(options.side));
+        if (wrote)
+            (0, hints_1.hintRegisterInModule)(feature, (0, hints_1.standardClassNames)(name, 'Service'));
+    });
+    program
+        .command('make:repository <target>')
+        .description('Scaffold single-responsibility repository files inside an existing feature (<feature>/<Entity>)')
+        .option('--side <side>', 'client, server, or both', 'both')
+        .action((target, options) => {
+        const { feature, name } = (0, target_1.parseTarget)(target);
+        const wrote = (0, repository_1.makeRepository)(feature, name, (0, sides_1.parseSide)(options.side));
+        if (wrote)
+            (0, hints_1.hintRegisterInModule)(feature, (0, hints_1.standardClassNames)(name, 'Repository'));
+    });
+    program
+        .command('make:controller <target>')
+        .description('Scaffold single-responsibility controllers or route handlers inside an existing feature (<feature>/<Entity>)')
+        .action((target) => {
+        const { feature, name } = (0, target_1.parseTarget)(target);
+        const wrote = (0, controller_1.makeController)(feature, name);
+        if (wrote)
+            (0, hints_1.hintRegisterInModule)(feature, (0, hints_1.standardClassNames)(name, 'Controller'));
+    });
+    program
+        .command('make:action <target> <action>')
+        .description('Scaffold a bespoke action as its own service, repository, and controller (<feature>/<Entity> <actionName>)')
+        .option('--with-input', 'The action takes a request body validated by a Zod schema', false)
+        .option('--returns <kind>', 'list, one, or void', 'list')
+        .action((target, action, options) => {
+        const { feature, name } = (0, target_1.parseTarget)(target);
+        const returns = (0, action_1.parseReturns)(options.returns);
+        const wrote = (0, action_1.makeAction)(feature, name, action, { withInput: options.withInput, returns });
+        if (wrote) {
+            const { pascal } = (0, actions_1.actionCase)(action);
+            (0, hints_1.hintRegisterInModule)(feature, [`${pascal}Controller`, `${pascal}Service`, `${pascal}Repository`], `list ${pascal}Controller before Show${name}Controller in controllers`);
+        }
+    });
+    program
+        .command('make:schema <target>')
+        .description('Scaffold Zod schemas (and Nest DTOs) for create and update operations (<feature>/<Entity>)')
+        .action((target) => {
+        const { feature, name } = (0, target_1.parseTarget)(target);
+        (0, schema_1.makeSchema)(feature, name);
+    });
+    program
+        .command('make:types <target>')
+        .description('Scaffold a types file inside an existing feature (<feature>/<Entity>)')
+        .action((target) => {
+        const { feature, name } = (0, target_1.parseTarget)(target);
+        (0, types_1.makeTypes)(feature, name);
+    });
+    program
+        .command('init')
+        .description('Write agent guidance into this project: AGENTS.md, CLAUDE.md, and .claude/skills/domain-driver/SKILL.md')
+        .action(() => {
+        for (const result of (0, init_1.runInit)(process.cwd())) {
+            console.log(`${init_1.INIT_ICONS[result.status]} ${result.file} ${result.status}`);
+        }
+    });
+    program
+        .command('update')
+        .description('Update domain-driver with your package manager, then refresh the agent guidance')
+        .option('--dry-run', 'Print the command without running it', false)
+        .option('--check', 'Only report whether a newer version exists', false)
+        .action(async (options) => {
+        await (0, update_1.runUpdate)(options, deps.updateDeps());
+    });
+    return program;
+}

package/dist/commands/update.js

@@ -0,0 +1,148 @@
+"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.defaultUpdateDeps = defaultUpdateDeps;
+exports.runUpdate = runUpdate;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const check_1 = require("../update/check");
+const install_mode_1 = require("../update/install-mode");
+const package_manager_1 = require("../update/package-manager");
+const registry_1 = require("../update/registry");
+const version_1 = require("../update/version");
+const NPX_MESSAGE = 'Nothing to update: you are running domain-driver through npx, which fetches the requested version each time. Use: npx domain-driver@latest <command>';
+const REFRESH_FAILED = 'ℹ️  Guidance refresh failed; run: domain-driver init';
+function unknownInstallMessage(root) {
+    return (`Could not tell how domain-driver was installed: ${path.join(root, 'package.json')} exists but does not depend on domain-driver ` +
+        '(this happens in hoisted workspaces). Run the update yourself in the package that depends on it, ' +
+        'for example: npm install domain-driver@latest -w <workspace>');
+}
+function safeRealpath(target) {
+    try {
+        return fs.realpathSync(target);
+    }
+    catch {
+        return target;
+    }
+}
+function defaultUpdateDeps() {
+    return {
+        env: process.env,
+        homedir: os.homedir(),
+        now: Date.now,
+        fetchImpl: registry_1.nodeFetch,
+        current: (0, version_1.currentVersion)(),
+        binPath: safeRealpath(process.argv[1] ?? ''),
+        cwd: process.cwd(),
+        readFile: (filePath) => fs.readFileSync(filePath, 'utf-8'),
+        exists: (filePath) => fs.existsSync(filePath),
+        spawn: (command, args, cwd) => {
+            const result = (0, child_process_1.spawnSync)(command, [...args], { stdio: 'inherit', cwd, shell: process.platform === 'win32' });
+            return { status: result.status, error: result.error };
+        },
+        execPath: process.execPath,
+        log: (line) => console.log(line),
+    };
+}
+async function runUpdate(options, deps) {
+    const install = (0, install_mode_1.detectInstallMode)(deps.binPath, deps.readFile);
+    if (install.mode === 'npx') {
+        deps.log(NPX_MESSAGE);
+        return;
+    }
+    if (install.mode === 'unknown') {
+        const message = unknownInstallMessage(install.root ?? deps.cwd);
+        deps.log(message);
+        throw new Error(message);
+    }
+    const command = commandFor(install, deps);
+    if (options.dryRun) {
+        deps.log(install.root === null ? `Would run: ${command.display}` : `Would run: ${command.display} in ${install.root}`);
+        return;
+    }
+    const latest = await (0, check_1.latestVersion)({
+        env: deps.env,
+        homedir: deps.homedir,
+        now: deps.now,
+        fetchImpl: deps.fetchImpl,
+        current: deps.current,
+        force: true,
+    });
+    if (latest !== null && !(0, version_1.isNewer)(latest, deps.current)) {
+        deps.log(`domain-driver ${deps.current} is already the latest version.`);
+        return;
+    }
+    if (options.check) {
+        deps.log(latest === null ? 'Could not reach the registry to check for updates.' : (0, check_1.formatNotice)(latest, deps.current));
+        return;
+    }
+    if (latest === null)
+        deps.log('Could not reach the registry; updating to @latest anyway.');
+    runInstall(command, install, deps);
+    deps.log(`✅ domain-driver updated to ${latest ?? '@latest'}`);
+    refreshGuidance(install, deps);
+}
+function commandFor(install, deps) {
+    if (install.mode === 'local' && install.root !== null) {
+        return (0, package_manager_1.updateCommand)('local', (0, package_manager_1.detectPackageManager)(install.root, { readFile: deps.readFile, exists: deps.exists }));
+    }
+    return (0, package_manager_1.updateCommand)('global', 'npm');
+}
+function runInstall(command, install, deps) {
+    const cwd = install.root ?? deps.cwd;
+    const result = deps.spawn(command.command, command.args, cwd);
+    if (result.error === undefined && result.status === 0)
+        return;
+    const code = result.status ?? 'error';
+    const sudo = install.mode === 'global' ? ' (you may need sudo)' : '';
+    throw new Error(`Update failed (exit ${code}). Run it yourself: ${command.display}${sudo}`);
+}
+// The freshly installed package is run in a new process: this one already has the old modules loaded.
+function refreshGuidance(install, deps) {
+    const root = install.mode === 'local' ? install.root : deps.exists(path.join(deps.cwd, 'package.json')) ? deps.cwd : null;
+    if (root === null)
+        return;
+    const result = deps.spawn(deps.execPath, [installedEntry(install, root, deps), 'init'], root);
+    if (result.error !== undefined || result.status !== 0)
+        deps.log(REFRESH_FAILED);
+}
+function installedEntry(install, root, deps) {
+    if (install.mode !== 'local')
+        return deps.binPath;
+    const entry = path.join(root, 'node_modules', 'domain-driver', 'dist', 'index.js');
+    return deps.exists(entry) ? entry : deps.binPath;
+}

package/dist/index.js

@@ -2,139 +2,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 // src/index.ts
-const commander_1 = require("commander");
-const action_1 = require("./commands/action");
-const component_1 = require("./commands/component");
-const container_1 = require("./commands/container");
-const controller_1 = require("./commands/controller");
-const feature_1 = require("./commands/feature");
-const hints_1 = require("./commands/hints");
-const hook_1 = require("./commands/hook");
-const repository_1 = require("./commands/repository");
-const schema_1 = require("./commands/schema");
-const service_1 = require("./commands/service");
-const sides_1 = require("./commands/sides");
-const target_1 = require("./commands/target");
-const types_1 = require("./commands/types");
-const init_1 = require("./init/init");
-const detect_1 = require("./stack/detect");
-const types_2 = require("./stack/types");
-const actions_1 = require("./templates/actions");
-const program = new commander_1.Command();
-program
-    .name('domain-driver')
-    .description('CLI scaffolding tool for domain-driven feature folders in Next.js, React, Node, and NestJS projects')
-    .version('0.2.0')
-    .option('--stack <name>', `Override stack detection (${types_2.STACK_NAMES.join(', ')})`);
-program.hook('preAction', (_thisCommand, actionCommand) => {
-    if (actionCommand.name() === 'init')
-        return;
-    const { stack } = program.opts();
-    console.log((0, detect_1.describeStack)((0, detect_1.detectStack)(stack)));
-});
-program
-    .command('make:feature <target>')
-    .description('Scaffold a feature folder for the detected stack (<feature> or <feature>/<Entity>)')
-    .option('-a, --all', 'Scaffold all files inside each folder')
-    .action(async (target, options) => {
-    const { feature, entity } = (0, target_1.parseFeatureTarget)(target);
-    await (0, feature_1.makeFeature)(feature, options.all ?? false, entity ?? undefined);
-});
-program
-    .command('make:component <target>')
-    .description('Scaffold a component inside an existing feature (<feature>/<Name>)')
-    .argument('[type]', 'Component type: client or server', 'client')
-    .action((target, type) => {
-    const { feature, name } = (0, target_1.parseTarget)(target);
-    (0, component_1.makeComponent)(feature, name, (0, component_1.parseComponentType)(type));
-});
-program
-    .command('make:container <target>')
-    .description('Scaffold a smart container component inside an existing feature (<feature>/<Name>)')
-    .action((target) => {
-    const { feature, name } = (0, target_1.parseTarget)(target);
-    (0, container_1.makeContainer)(feature, name);
-});
-program
-    .command('make:hook <target>')
-    .description('Scaffold a custom hook inside an existing feature (<feature>/<useName>)')
-    .action((target) => {
-    const { feature, name } = (0, target_1.parseTarget)(target);
-    (0, hook_1.makeHook)(feature, name);
-});
-program
-    .command('make:service <target>')
-    .description('Scaffold single-responsibility service files inside an existing feature (<feature>/<Entity>)')
-    .option('--side <side>', 'client, server, or both', 'both')
-    .action((target, options) => {
-    const { feature, name } = (0, target_1.parseTarget)(target);
-    const wrote = (0, service_1.makeService)(feature, name, (0, sides_1.parseSide)(options.side));
-    if (wrote)
-        (0, hints_1.hintRegisterInModule)(feature, (0, hints_1.standardClassNames)(name, 'Service'));
-});
-program
-    .command('make:repository <target>')
-    .description('Scaffold single-responsibility repository files inside an existing feature (<feature>/<Entity>)')
-    .option('--side <side>', 'client, server, or both', 'both')
-    .action((target, options) => {
-    const { feature, name } = (0, target_1.parseTarget)(target);
-    const wrote = (0, repository_1.makeRepository)(feature, name, (0, sides_1.parseSide)(options.side));
-    if (wrote)
-        (0, hints_1.hintRegisterInModule)(feature, (0, hints_1.standardClassNames)(name, 'Repository'));
-});
-program
-    .command('make:controller <target>')
-    .description('Scaffold single-responsibility controllers or route handlers inside an existing feature (<feature>/<Entity>)')
-    .action((target) => {
-    const { feature, name } = (0, target_1.parseTarget)(target);
-    const wrote = (0, controller_1.makeController)(feature, name);
-    if (wrote)
-        (0, hints_1.hintRegisterInModule)(feature, (0, hints_1.standardClassNames)(name, 'Controller'));
-});
-program
-    .command('make:action <target> <action>')
-    .description('Scaffold a bespoke action as its own service, repository, and controller (<feature>/<Entity> <actionName>)')
-    .option('--with-input', 'The action takes a request body validated by a Zod schema', false)
-    .option('--returns <kind>', 'list, one, or void', 'list')
-    .action((target, action, options) => {
-    const { feature, name } = (0, target_1.parseTarget)(target);
-    const returns = (0, action_1.parseReturns)(options.returns);
-    const wrote = (0, action_1.makeAction)(feature, name, action, { withInput: options.withInput, returns });
-    if (wrote) {
-        const { pascal } = (0, actions_1.actionCase)(action);
-        (0, hints_1.hintRegisterInModule)(feature, [`${pascal}Controller`, `${pascal}Service`, `${pascal}Repository`], `list ${pascal}Controller before Show${name}Controller in controllers`);
-    }
-});
-program
-    .command('make:schema <target>')
-    .description('Scaffold Zod schemas (and Nest DTOs) for create and update operations (<feature>/<Entity>)')
-    .action((target) => {
-    const { feature, name } = (0, target_1.parseTarget)(target);
-    (0, schema_1.makeSchema)(feature, name);
-});
-program
-    .command('make:types <target>')
-    .description('Scaffold a types file inside an existing feature (<feature>/<Entity>)')
-    .action((target) => {
-    const { feature, name } = (0, target_1.parseTarget)(target);
-    (0, types_1.makeTypes)(feature, name);
-});
-const INIT_ICONS = Object.freeze({
-    created: '✅',
-    updated: '✅',
-    unchanged: 'ℹ️ ',
-});
-program
-    .command('init')
-    .description('Write agent guidance into this project: AGENTS.md, CLAUDE.md, and .claude/skills/domain-driver/SKILL.md')
-    .action(() => {
-    for (const result of (0, init_1.runInit)(process.cwd())) {
-        console.log(`${INIT_ICONS[result.status]} ${result.file} ${result.status}`);
-    }
-});
+const cli_1 = require("./cli");
 function fail(error) {
     const message = error instanceof Error ? error.message : 'Unknown error';
     console.error(`❌ ${message}`);
     process.exit(1);
 }
-program.parseAsync().catch(fail);
+(0, cli_1.createProgram)((0, cli_1.defaultCliDeps)()).parseAsync().catch(fail);

package/dist/init/init.js

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.INIT_ICONS = void 0;
 exports.runInit = runInit;
 const path = __importStar(require("path"));
 const fs_1 = require("../utils/fs");
@@ -58,3 +59,8 @@ function writeSkill(root) {
     (0, fs_1.writeFileSafe)(filePath, content_1.SKILL_CONTENT);
     return Object.freeze({ file: SKILL_FILE, status: existing === null ? 'created' : 'updated' });
 }
+exports.INIT_ICONS = Object.freeze({
+    created: '✅',
+    updated: '✅',
+    unchanged: 'ℹ️ ',
+});

package/dist/update/cache.js

@@ -0,0 +1,80 @@
+"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.CACHE_TTL_MS = exports.CACHE_FILE = void 0;
+exports.cacheDir = cacheDir;
+exports.readCache = readCache;
+exports.writeCache = writeCache;
+exports.isFresh = isFresh;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+exports.CACHE_FILE = 'update-check.json';
+exports.CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+function cacheDir(env, homedir) {
+    if (env.DOMAIN_DRIVER_CACHE_DIR)
+        return env.DOMAIN_DRIVER_CACHE_DIR;
+    if (env.XDG_CACHE_HOME)
+        return path.join(env.XDG_CACHE_HOME, 'domain-driver');
+    return path.join(homedir, '.cache', 'domain-driver');
+}
+function isCache(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const { latest, checkedAt } = value;
+    const latestOk = latest === null || typeof latest === 'string';
+    const checkedOk = typeof checkedAt === 'string' && !Number.isNaN(Date.parse(checkedAt));
+    return latestOk && checkedOk;
+}
+function readCache(dir) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(path.join(dir, exports.CACHE_FILE), 'utf-8'));
+        return isCache(parsed) ? Object.freeze({ latest: parsed.latest, checkedAt: parsed.checkedAt }) : null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(dir, cache) {
+    try {
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, exports.CACHE_FILE), JSON.stringify(cache));
+    }
+    catch {
+        // The cache is advisory; never fail a command over it.
+    }
+}
+function isFresh(cache, now, ttlMs = exports.CACHE_TTL_MS) {
+    return now - Date.parse(cache.checkedAt) < ttlMs;
+}

package/dist/update/check.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldCheck = shouldCheck;
+exports.formatNotice = formatNotice;
+exports.latestVersion = latestVersion;
+exports.checkForUpdate = checkForUpdate;
+const cache_1 = require("./cache");
+const registry_1 = require("./registry");
+const version_1 = require("./version");
+const UNSET_VALUES = new Set(['', '0', 'false']);
+function isSet(value) {
+    return value !== undefined && !UNSET_VALUES.has(value);
+}
+function shouldCheck(env, isTTY, commandName) {
+    if (isSet(env.CI))
+        return false;
+    if (isSet(env.DOMAIN_DRIVER_NO_UPDATE_CHECK))
+        return false;
+    if (env.NO_UPDATE_NOTIFIER !== undefined)
+        return false;
+    if (!isTTY)
+        return false;
+    return commandName !== 'update';
+}
+function formatNotice(latest, current) {
+    return `ℹ️  domain-driver ${latest} is available (you have ${current}). Run: domain-driver update`;
+}
+async function latestVersion(deps) {
+    const dir = (0, cache_1.cacheDir)(deps.env, deps.homedir);
+    const cached = (0, cache_1.readCache)(dir);
+    if (!deps.force && cached !== null && (0, cache_1.isFresh)(cached, deps.now()))
+        return cached.latest;
+    const latest = await (0, registry_1.fetchLatestVersion)(deps.fetchImpl);
+    (0, cache_1.writeCache)(dir, { latest, checkedAt: new Date(deps.now()).toISOString() });
+    return latest;
+}
+async function checkForUpdate(deps) {
+    try {
+        const latest = await latestVersion(deps);
+        if (latest !== null && (0, version_1.isNewer)(latest, deps.current))
+            return formatNotice(latest, deps.current);
+        return null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/update/install-mode.js

@@ -0,0 +1,96 @@
+"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.detectInstallMode = detectInstallMode;
+const path = __importStar(require("path"));
+const MAX_ANCESTORS = 6;
+function detectInstallMode(binPath, readFile) {
+    const segments = binPath.split(path.sep);
+    const index = findInstallIndex(segments);
+    if (index === null)
+        return Object.freeze({ mode: 'global', root: null });
+    // npx unpacks into <cache>/_npx/<hash>/node_modules/domain-driver, so _npx sits three segments before the package.
+    if (segments[index - 3] === '_npx')
+        return Object.freeze({ mode: 'npx', root: null });
+    const installRoot = rootFrom(segments, index);
+    const projectRoot = findProjectRoot(installRoot, readFile);
+    if (projectRoot !== null)
+        return Object.freeze({ mode: 'local', root: projectRoot });
+    return hasPackageJson(installRoot, readFile)
+        ? Object.freeze({ mode: 'unknown', root: installRoot })
+        : Object.freeze({ mode: 'global', root: null });
+}
+function findInstallIndex(segments) {
+    for (let index = segments.length - 1; index > 0; index -= 1) {
+        if (segments[index - 1] === 'node_modules' && segments[index] === 'domain-driver')
+            return index;
+    }
+    return null;
+}
+function rootFrom(segments, index) {
+    const root = segments.slice(0, index - 1).join(path.sep);
+    return root === '' ? path.sep : root;
+}
+function findProjectRoot(start, readFile) {
+    let current = start;
+    for (let level = 0; level <= MAX_ANCESTORS; level += 1) {
+        if (dependsOnDomainDriver(current, readFile))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+    return null;
+}
+function dependsOnDomainDriver(root, readFile) {
+    try {
+        const parsed = JSON.parse(readFile(path.join(root, 'package.json')));
+        const pkg = (parsed ?? {});
+        return 'domain-driver' in (pkg.dependencies ?? {}) || 'domain-driver' in (pkg.devDependencies ?? {});
+    }
+    catch {
+        return false;
+    }
+}
+function hasPackageJson(root, readFile) {
+    try {
+        readFile(path.join(root, 'package.json'));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/update/package-manager.js

@@ -0,0 +1,99 @@
+"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.detectPackageManager = detectPackageManager;
+exports.updateCommand = updateCommand;
+const path = __importStar(require("path"));
+const PACKAGE = 'domain-driver@latest';
+function detectPackageManager(root, fsLike) {
+    const declared = declaredManager(root, fsLike);
+    if (declared !== null)
+        return declared;
+    const has = (name) => fsLike.exists(path.join(root, name));
+    if (has('bun.lock') || has('bun.lockb'))
+        return 'bun';
+    if (has('pnpm-lock.yaml'))
+        return 'pnpm';
+    if (has('yarn.lock'))
+        return yarnFlavourFromLock(root, fsLike);
+    return 'npm';
+}
+function declaredManager(root, fsLike) {
+    try {
+        const parsed = JSON.parse(fsLike.readFile(path.join(root, 'package.json')));
+        const declared = parsed?.packageManager;
+        if (typeof declared !== 'string')
+            return null;
+        const [name, version = ''] = declared.split('@');
+        if (name === 'npm' || name === 'pnpm' || name === 'bun')
+            return name;
+        if (name !== 'yarn')
+            return null;
+        if (version === '')
+            return yarnFlavourFromLock(root, fsLike);
+        return version.startsWith('1.') || version === '1' ? 'yarn-classic' : 'yarn-berry';
+    }
+    catch {
+        return null;
+    }
+}
+function yarnFlavourFromLock(root, fsLike) {
+    try {
+        const header = fsLike.readFile(path.join(root, 'yarn.lock')).split('\n').slice(0, 3).join('\n');
+        return header.includes('yarn lockfile v1') ? 'yarn-classic' : 'yarn-berry';
+    }
+    catch {
+        return 'yarn-berry';
+    }
+}
+function build(command, ...args) {
+    return Object.freeze({ command, args: Object.freeze(args), display: [command, ...args].join(' ') });
+}
+function updateCommand(mode, manager) {
+    if (mode === 'global')
+        return build('npm', 'install', '-g', PACKAGE);
+    switch (manager) {
+        case 'npm':
+            return build('npm', 'install', PACKAGE);
+        case 'pnpm':
+            return build('pnpm', 'update', PACKAGE);
+        case 'yarn-classic':
+            return build('yarn', 'upgrade', PACKAGE);
+        case 'yarn-berry':
+            return build('yarn', 'up', PACKAGE);
+        case 'bun':
+            return build('bun', 'update', PACKAGE);
+    }
+}

package/dist/update/registry.js

@@ -0,0 +1,77 @@
+"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.nodeFetch = exports.FETCH_TIMEOUT_MS = exports.DIST_TAGS_URL = void 0;
+exports.fetchLatestVersion = fetchLatestVersion;
+const http = __importStar(require("http"));
+const https = __importStar(require("https"));
+exports.DIST_TAGS_URL = 'https://registry.npmjs.org/-/package/domain-driver/dist-tags';
+exports.FETCH_TIMEOUT_MS = 1500;
+const nodeFetch = (url, init) => new Promise((resolve, reject) => {
+    const client = url.startsWith('https:') ? https : http;
+    const request = client.get(url, { signal: init?.signal, headers: { accept: 'application/json' } }, (response) => {
+        let body = '';
+        response.setEncoding('utf-8');
+        response.on('data', (chunk) => {
+            body += chunk;
+        });
+        response.on('end', () => {
+            const status = response.statusCode ?? 0;
+            resolve({ ok: status >= 200 && status < 300, status, json: async () => JSON.parse(body) });
+        });
+        response.on('error', reject);
+    });
+    request.on('socket', (socket) => socket.unref());
+    request.on('error', reject);
+});
+exports.nodeFetch = nodeFetch;
+async function fetchLatestVersion(fetchImpl = exports.nodeFetch, timeoutMs = exports.FETCH_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchImpl(exports.DIST_TAGS_URL, { signal: controller.signal });
+        if (!response.ok)
+            return null;
+        const body = await response.json();
+        const latest = body?.latest;
+        return typeof latest === 'string' ? latest : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}

package/dist/update/version.js

@@ -0,0 +1,70 @@
+"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.currentVersion = currentVersion;
+exports.parseVersion = parseVersion;
+exports.isNewer = isNewer;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const FALLBACK_VERSION = '0.0.0';
+const VERSION_PATTERN = /^(\d+)\.(\d+)\.(\d+)$/;
+const readUtf8 = (filePath) => fs.readFileSync(filePath, 'utf-8');
+function currentVersion(readFile = readUtf8) {
+    try {
+        const parsed = JSON.parse(readFile(path.join(__dirname, '..', '..', 'package.json')));
+        const version = parsed.version;
+        return typeof version === 'string' ? version : FALLBACK_VERSION;
+    }
+    catch {
+        return FALLBACK_VERSION;
+    }
+}
+function parseVersion(value) {
+    const match = VERSION_PATTERN.exec(value.trim());
+    if (!match)
+        return null;
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+function isNewer(latest, current) {
+    const next = parseVersion(latest);
+    const now = parseVersion(current);
+    if (next === null || now === null)
+        return false;
+    for (let index = 0; index < 3; index += 1) {
+        if (next[index] !== now[index])
+            return next[index] > now[index];
+    }
+    return false;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domain-driver",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "CLI scaffolding tool for domain-driven feature folders in Next.js, React, Node, and NestJS projects, with per-action files, bespoke actions, and agent guidance",
   "main": "dist/index.js",
   "bin": {
@@ -35,7 +35,7 @@
   "author": "Isaac Hatilima",
   "license": "MIT",
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "devDependencies": {
     "@types/node": "^25.4.0",