@lenne.tech/cli 1.28.0 → 1.29.0

package/build/commands/fullstack/convert-mode.js

@@ -9,9 +9,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.help = void 0;
 const path_1 = require("path");
 const framework_detection_1 = require("../../lib/framework-detection");
 const frontend_framework_detection_1 = require("../../lib/frontend-framework-detection");
+const vendor_claude_md_1 = require("../../lib/vendor-claude-md");
 /**
  * Convert both backend and frontend of a fullstack monorepo between
  * npm mode and vendor mode in a single command.
@@ -26,6 +28,71 @@ const frontend_framework_detection_1 = require("../../lib/frontend-framework-det
  * Orchestrates `lt server convert-mode` + `lt frontend convert-mode` with
  * auto-detection of `projects/api/` and `projects/app/` subdirectories.
  */
+exports.help = {
+    description: 'Convert fullstack monorepo (backend + frontend) between npm and vendor modes',
+    name: 'convert-mode',
+    options: [
+        {
+            description: 'Target mode',
+            flag: '--to',
+            required: true,
+            type: 'string',
+            values: ['vendor', 'npm'],
+        },
+        {
+            description: 'Backend upstream branch/tag (only with --to vendor, e.g. "11.24.3")',
+            flag: '--framework-upstream-branch',
+            required: false,
+            type: 'string',
+        },
+        {
+            description: 'Frontend upstream branch/tag (only with --to vendor, e.g. "1.5.3")',
+            flag: '--frontend-framework-upstream-branch',
+            required: false,
+            type: 'string',
+        },
+        {
+            description: 'Backend version to install (only with --to npm, default: from VENDOR.md baseline)',
+            flag: '--framework-version',
+            required: false,
+            type: 'string',
+        },
+        {
+            description: 'Frontend version to install (only with --to npm, default: from VENDOR.md baseline)',
+            flag: '--frontend-framework-version',
+            required: false,
+            type: 'string',
+        },
+        {
+            default: false,
+            description: 'Skip backend conversion',
+            flag: '--skip-backend',
+            required: false,
+            type: 'boolean',
+        },
+        {
+            default: false,
+            description: 'Skip frontend conversion',
+            flag: '--skip-frontend',
+            required: false,
+            type: 'boolean',
+        },
+        {
+            default: false,
+            description: 'Show the resolved plan without making any changes',
+            flag: '--dry-run',
+            required: false,
+            type: 'boolean',
+        },
+        {
+            default: false,
+            description: 'Skip confirmation prompt',
+            flag: '--noConfirm',
+            required: false,
+            type: 'boolean',
+        },
+    ],
+};
 const ConvertModeCommand = {
     description: 'Convert fullstack monorepo between npm and vendor modes',
     hidden: false,
@@ -33,71 +100,7 @@ const ConvertModeCommand = {
     run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
         const { filesystem, frontendHelper, parameters, print: { colors, error, info, spin, success, warning }, prompt: { confirm }, server, } = toolbox;
         // Handle --help-json flag
-        if (toolbox.tools.helpJson({
-            description: 'Convert fullstack monorepo (backend + frontend) between npm and vendor modes',
-            name: 'convert-mode',
-            options: [
-                {
-                    description: 'Target mode',
-                    flag: '--to',
-                    required: true,
-                    type: 'string',
-                    values: ['vendor', 'npm'],
-                },
-                {
-                    description: 'Backend upstream branch/tag (only with --to vendor, e.g. "11.24.3")',
-                    flag: '--framework-upstream-branch',
-                    required: false,
-                    type: 'string',
-                },
-                {
-                    description: 'Frontend upstream branch/tag (only with --to vendor, e.g. "1.5.3")',
-                    flag: '--frontend-framework-upstream-branch',
-                    required: false,
-                    type: 'string',
-                },
-                {
-                    description: 'Backend version to install (only with --to npm, default: from VENDOR.md baseline)',
-                    flag: '--framework-version',
-                    required: false,
-                    type: 'string',
-                },
-                {
-                    description: 'Frontend version to install (only with --to npm, default: from VENDOR.md baseline)',
-                    flag: '--frontend-framework-version',
-                    required: false,
-                    type: 'string',
-                },
-                {
-                    default: false,
-                    description: 'Skip backend conversion',
-                    flag: '--skip-backend',
-                    required: false,
-                    type: 'boolean',
-                },
-                {
-                    default: false,
-                    description: 'Skip frontend conversion',
-                    flag: '--skip-frontend',
-                    required: false,
-                    type: 'boolean',
-                },
-                {
-                    default: false,
-                    description: 'Show the resolved plan without making any changes',
-                    flag: '--dry-run',
-                    required: false,
-                    type: 'boolean',
-                },
-                {
-                    default: false,
-                    description: 'Skip confirmation prompt',
-                    flag: '--noConfirm',
-                    required: false,
-                    type: 'boolean',
-                },
-            ],
-        })) {
+        if (toolbox.tools.helpJson(exports.help)) {
             return;
         }
         const targetMode = parameters.options.to;
@@ -348,6 +351,23 @@ const ConvertModeCommand = {
         }
         info('');
         success('All conversions completed successfully.');
+        // ── Sync vendor notice blocks, including the monorepo root CLAUDE.md ───
+        // The per-subproject CLAUDE.md blocks are written by the server/frontend
+        // converters; this additionally maintains the workspace root CLAUDE.md —
+        // the entry point Claude reads first — and keeps everything idempotent.
+        const backendVendorNow = backendDir ? (0, framework_detection_1.detectFrameworkMode)(backendDir) === 'vendor' : false;
+        const frontendVendorNow = frontendDir ? (0, frontend_framework_detection_1.detectFrontendFrameworkMode)(frontendDir) === 'vendor' : false;
+        const changedClaudeMd = (0, vendor_claude_md_1.healVendorClaudeMd)(filesystem, {
+            apiDir: backendDir,
+            appDir: frontendDir,
+            backendVendor: backendVendorNow,
+            frontendVendor: frontendVendorNow,
+            workspaceRoot: cwd,
+        });
+        if (changedClaudeMd.length > 0) {
+            info('');
+            success(`Synced vendor notice in ${changedClaudeMd.length} CLAUDE.md file(s) (incl. monorepo root).`);
+        }
         info('');
         info(colors.bold('Next steps:'));
         info('  1. Run: pnpm install  (from monorepo root)');

package/build/commands/fullstack/init.js

@@ -18,6 +18,7 @@ const dev_migrate_helper_1 = require("../../lib/dev-migrate-helper");
 const dev_project_1 = require("../../lib/dev-project");
 const hoist_workspace_pnpm_config_1 = require("../../lib/hoist-workspace-pnpm-config");
 const package_name_1 = require("../../lib/package-name");
+const vendor_claude_md_1 = require("../../lib/vendor-claude-md");
 const workspace_integration_1 = require("../../lib/workspace-integration");
 const add_api_1 = __importDefault(require("./add-api"));
 const add_app_1 = __importDefault(require("./add-app"));
@@ -641,6 +642,17 @@ const NewCommand = {
             if (!experimental && isNuxt && filesystem.isDirectory(`${projectDir}/projects/app`)) {
                 yield toolbox.apiMode.formatProject(`${projectDir}/projects/app`);
             }
+            // Sync the vendor-mode notice blocks across all CLAUDE.md files,
+            // including the monorepo root — so a freshly scaffolded vendor project
+            // tells Claude (and humans) how to update/contribute the vendored core
+            // from the very first commit. Idempotent / no-op for npm-mode projects.
+            (0, vendor_claude_md_1.healVendorClaudeMd)(filesystem, {
+                apiDir: `${projectDir}/projects/api`,
+                appDir: `${projectDir}/projects/app`,
+                backendVendor: frameworkMode === 'vendor',
+                frontendVendor: frontendFrameworkMode === 'vendor',
+                workspaceRoot: projectDir,
+            });
             // Create initial commit after everything is set up
             try {
                 yield system.run(`cd ${projectDir} && git add . && git commit -m "Initial commit"`);

package/build/commands/fullstack/update.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const path_1 = require("path");
 const framework_detection_1 = require("../../lib/framework-detection");
 const frontend_framework_detection_1 = require("../../lib/frontend-framework-detection");
+const vendor_claude_md_1 = require("../../lib/vendor-claude-md");
 /**
  * Update a fullstack workspace — mode-aware.
  *
@@ -161,6 +162,29 @@ const NewCommand = {
                 info('');
             }
         }
+        // ── Self-heal: sync the vendor-mode notice blocks in all CLAUDE.md ────
+        //
+        // `lt fullstack update` doubles as a doc-sync: it (re)writes the vendor
+        // notice blocks so pre-existing or drifted projects gain the correct
+        // pointers — backend `projects/api/CLAUDE.md`, frontend
+        // `projects/app/CLAUDE.md`, and the monorepo root `CLAUDE.md` (the entry
+        // point Claude reads first). Idempotent: a no-op when already correct.
+        const frontendModeForHeal = appDir ? (0, frontend_framework_detection_1.detectFrontendFrameworkMode)(appDir) : undefined;
+        const isWorkspace = apiDir !== cwd || (!!appDir && appDir !== cwd);
+        const changedClaudeMd = (0, vendor_claude_md_1.healVendorClaudeMd)(filesystem, {
+            apiDir,
+            appDir,
+            backendVendor: mode === 'vendor',
+            frontendVendor: frontendModeForHeal === 'vendor',
+            workspaceRoot: isWorkspace ? cwd : undefined,
+        });
+        if (changedClaudeMd.length > 0) {
+            info('');
+            success(`  Synced vendor notice in ${changedClaudeMd.length} CLAUDE.md file(s):`);
+            for (const changedPath of changedClaudeMd) {
+                info(`    ${changedPath}`);
+            }
+        }
         info('');
         info(colors.bold('For a comprehensive update of everything, use:'));
         info('');

package/build/commands/server/add-property.js

@@ -12,6 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.help = void 0;
 const path_1 = require("path");
 const ts_morph_1 = require("ts-morph");
 const framework_detection_1 = require("../../lib/framework-detection");
@@ -20,6 +21,46 @@ const object_1 = __importDefault(require("./object"));
 /**
  * Add property to module or object
  */
+exports.help = {
+    aliases: ['ap'],
+    configuration: 'commands.server.addProp.*',
+    description: 'Add property to module/object',
+    name: 'addProp',
+    options: [
+        {
+            description: 'Target type to update',
+            flag: '--type',
+            required: true,
+            type: 'string',
+            values: ['Module', 'Object'],
+        },
+        { description: 'Name of the module or object to update', flag: '--element', required: true, type: 'string' },
+        {
+            default: false,
+            description: 'Skip lint fix after update',
+            flag: '--skipLint',
+            required: false,
+            type: 'boolean',
+        },
+    ],
+    propertyFlags: {
+        attributes: [
+            { description: 'Property name', name: 'name', type: 'string' },
+            {
+                description: 'Property type',
+                name: 'type',
+                type: 'string',
+                values: ['string', 'number', 'boolean', 'bigint', 'Date', 'ObjectId', 'Json'],
+            },
+            { description: 'Optional field', name: 'nullable', type: 'boolean' },
+            { description: 'Array of this type', name: 'array', type: 'boolean' },
+            { description: 'Enum type reference', name: 'enum', type: 'string' },
+            { description: 'Embedded object/schema reference', name: 'schema', type: 'string' },
+            { description: 'Reference module for ObjectId fields', name: 'reference', type: 'string' },
+        ],
+        pattern: '--prop-<attribute>-<index>',
+    },
+};
 const NewCommand = {
     alias: ['ap'],
     description: 'Add property to module/object',
@@ -32,46 +73,7 @@ const NewCommand = {
         // Retrieve the tools we need
         const { config, filesystem, parameters, print: { divider, error, info, spin, success }, prompt: { ask, confirm }, server, strings: { pascalCase }, system, } = toolbox;
         // Handle --help-json flag
-        if (toolbox.tools.helpJson({
-            aliases: ['ap'],
-            configuration: 'commands.server.addProp.*',
-            description: 'Add property to module/object',
-            name: 'addProp',
-            options: [
-                {
-                    description: 'Target type to update',
-                    flag: '--type',
-                    required: true,
-                    type: 'string',
-                    values: ['Module', 'Object'],
-                },
-                { description: 'Name of the module or object to update', flag: '--element', required: true, type: 'string' },
-                {
-                    default: false,
-                    description: 'Skip lint fix after update',
-                    flag: '--skipLint',
-                    required: false,
-                    type: 'boolean',
-                },
-            ],
-            propertyFlags: {
-                attributes: [
-                    { description: 'Property name', name: 'name', type: 'string' },
-                    {
-                        description: 'Property type',
-                        name: 'type',
-                        type: 'string',
-                        values: ['string', 'number', 'boolean', 'bigint', 'Date', 'ObjectId', 'Json'],
-                    },
-                    { description: 'Optional field', name: 'nullable', type: 'boolean' },
-                    { description: 'Array of this type', name: 'array', type: 'boolean' },
-                    { description: 'Enum type reference', name: 'enum', type: 'string' },
-                    { description: 'Embedded object/schema reference', name: 'schema', type: 'string' },
-                    { description: 'Reference module for ObjectId fields', name: 'reference', type: 'string' },
-                ],
-                pattern: '--prop-<attribute>-<index>',
-            },
-        })) {
+        if (toolbox.tools.helpJson(exports.help)) {
             return;
         }
         const argProps = Object.keys(toolbox.parameters.options || {}).filter((key) => key.startsWith('prop'));

package/build/commands/server/convert-mode.js

@@ -9,6 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.help = void 0;
 const framework_detection_1 = require("../../lib/framework-detection");
 /**
  * Convert an existing API project between npm mode and vendor mode.
@@ -17,6 +18,45 @@ const framework_detection_1 = require("../../lib/framework-detection");
  *   lt server convert-mode --to vendor [--upstream-branch 11.24.2]
  *   lt server convert-mode --to npm [--version 11.24.2]
  */
+exports.help = {
+    description: 'Convert API project between npm and vendor framework modes',
+    name: 'convert-mode',
+    options: [
+        {
+            description: 'Target mode',
+            flag: '--to',
+            required: true,
+            type: 'string',
+            values: ['vendor', 'npm'],
+        },
+        {
+            description: 'Upstream branch/tag to vendor from (only with --to vendor)',
+            flag: '--upstream-branch',
+            required: false,
+            type: 'string',
+        },
+        {
+            description: 'nest-server version to install (only with --to npm, default: from VENDOR.md baseline)',
+            flag: '--version',
+            required: false,
+            type: 'string',
+        },
+        {
+            default: false,
+            description: 'Skip confirmation prompt',
+            flag: '--noConfirm',
+            required: false,
+            type: 'boolean',
+        },
+        {
+            default: false,
+            description: 'Show the resolved plan without making any changes',
+            flag: '--dry-run',
+            required: false,
+            type: 'boolean',
+        },
+    ],
+};
 const ConvertModeCommand = {
     description: 'Convert API project between npm and vendor framework modes',
     hidden: false,
@@ -24,45 +64,7 @@ const ConvertModeCommand = {
     run: (toolbox) => __awaiter(void 0, void 0, void 0, function* () {
         const { filesystem, parameters, print: { error, info, spin, success, warning }, prompt: { confirm }, server, } = toolbox;
         // Handle --help-json flag
-        if (toolbox.tools.helpJson({
-            description: 'Convert API project between npm and vendor framework modes',
-            name: 'convert-mode',
-            options: [
-                {
-                    description: 'Target mode',
-                    flag: '--to',
-                    required: true,
-                    type: 'string',
-                    values: ['vendor', 'npm'],
-                },
-                {
-                    description: 'Upstream branch/tag to vendor from (only with --to vendor)',
-                    flag: '--upstream-branch',
-                    required: false,
-                    type: 'string',
-                },
-                {
-                    description: 'nest-server version to install (only with --to npm, default: from VENDOR.md baseline)',
-                    flag: '--version',
-                    required: false,
-                    type: 'string',
-                },
-                {
-                    default: false,
-                    description: 'Skip confirmation prompt',
-                    flag: '--noConfirm',
-                    required: false,
-                    type: 'boolean',
-                },
-                {
-                    default: false,
-                    description: 'Show the resolved plan without making any changes',
-                    flag: '--dry-run',
-                    required: false,
-                    type: 'boolean',
-                },
-            ],
-        })) {
+        if (toolbox.tools.helpJson(exports.help)) {
             return;
         }
         const targetMode = parameters.options.to;

package/build/commands/server/create.js

@@ -9,10 +9,74 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.help = void 0;
 const workspace_integration_1 = require("../../lib/workspace-integration");
 /**
  * Create a new server
  */
+exports.help = {
+    aliases: ['c'],
+    configuration: 'commands.server.create.*',
+    description: 'Create new server',
+    name: 'create',
+    options: [
+        { description: 'Server name', flag: '--name', required: true, type: 'string' },
+        {
+            description: 'API mode',
+            flag: '--api-mode',
+            required: false,
+            type: 'string',
+            values: ['Rest', 'GraphQL', 'Both'],
+        },
+        { description: 'Project description', flag: '--description', required: false, type: 'string' },
+        { description: 'Project author', flag: '--author', required: false, type: 'string' },
+        { description: 'Initialize git repository', flag: '--git', required: false, type: 'boolean' },
+        { description: 'Git branch to clone from', flag: '--branch', required: false, type: 'string' },
+        { description: 'Copy from local path instead of cloning', flag: '--copy', required: false, type: 'string' },
+        { description: 'Symlink to local path instead of cloning', flag: '--link', required: false, type: 'string' },
+        {
+            description: 'Backend framework consumption mode',
+            flag: '--framework-mode',
+            required: false,
+            type: 'string',
+            values: ['npm', 'vendor'],
+        },
+        {
+            description: 'Upstream nest-server branch/tag to vendor (with --framework-mode vendor)',
+            flag: '--framework-upstream-branch',
+            required: false,
+            type: 'string',
+        },
+        {
+            default: false,
+            description: 'Use experimental nest-base template (Bun + Prisma + Postgres)',
+            flag: '--next',
+            required: false,
+            type: 'boolean',
+        },
+        {
+            default: false,
+            description: 'Print resolved plan and exit without making any changes',
+            flag: '--dry-run',
+            required: false,
+            type: 'boolean',
+        },
+        {
+            default: false,
+            description: 'Override the workspace-detection abort under --noConfirm',
+            flag: '--force',
+            required: false,
+            type: 'boolean',
+        },
+        {
+            default: false,
+            description: 'Skip all interactive prompts',
+            flag: '--noConfirm',
+            required: false,
+            type: 'boolean',
+        },
+    ],
+};
 const NewCommand = {
     alias: ['c'],
     description: 'Create new server',
@@ -23,69 +87,7 @@ const NewCommand = {
         // Retrieve the tools we need
         const { config, filesystem, git, helper, meta, parameters, print: { error, info, spin, success }, prompt: { ask, confirm }, server, strings: { kebabCase }, system, } = toolbox;
         // Handle --help-json flag
-        if (toolbox.tools.helpJson({
-            aliases: ['c'],
-            configuration: 'commands.server.create.*',
-            description: 'Create new server',
-            name: 'create',
-            options: [
-                { description: 'Server name', flag: '--name', required: true, type: 'string' },
-                {
-                    description: 'API mode',
-                    flag: '--api-mode',
-                    required: false,
-                    type: 'string',
-                    values: ['Rest', 'GraphQL', 'Both'],
-                },
-                { description: 'Project description', flag: '--description', required: false, type: 'string' },
-                { description: 'Project author', flag: '--author', required: false, type: 'string' },
-                { description: 'Initialize git repository', flag: '--git', required: false, type: 'boolean' },
-                { description: 'Git branch to clone from', flag: '--branch', required: false, type: 'string' },
-                { description: 'Copy from local path instead of cloning', flag: '--copy', required: false, type: 'string' },
-                { description: 'Symlink to local path instead of cloning', flag: '--link', required: false, type: 'string' },
-                {
-                    description: 'Backend framework consumption mode',
-                    flag: '--framework-mode',
-                    required: false,
-                    type: 'string',
-                    values: ['npm', 'vendor'],
-                },
-                {
-                    description: 'Upstream nest-server branch/tag to vendor (with --framework-mode vendor)',
-                    flag: '--framework-upstream-branch',
-                    required: false,
-                    type: 'string',
-                },
-                {
-                    default: false,
-                    description: 'Use experimental nest-base template (Bun + Prisma + Postgres)',
-                    flag: '--next',
-                    required: false,
-                    type: 'boolean',
-                },
-                {
-                    default: false,
-                    description: 'Print resolved plan and exit without making any changes',
-                    flag: '--dry-run',
-                    required: false,
-                    type: 'boolean',
-                },
-                {
-                    default: false,
-                    description: 'Override the workspace-detection abort under --noConfirm',
-                    flag: '--force',
-                    required: false,
-                    type: 'boolean',
-                },
-                {
-                    default: false,
-                    description: 'Skip all interactive prompts',
-                    flag: '--noConfirm',
-                    required: false,
-                    type: 'boolean',
-                },
-            ],
-        })) {
+        if (toolbox.tools.helpJson(exports.help)) {
             return;
         }
         // Load configuration