@lenne.tech/cli 1.10.0 → 1.11.1

package/docs/lt.config.md

@@ -52,7 +52,7 @@ Configuration files are searched from the **current directory up to the root** (
 ### Example: Monorepo Structure
 
 ```
-/home/user/
+$HOME/
 ├── lt.config.json          # Global defaults
 └── projects/
     └── my-monorepo/
@@ -64,10 +64,10 @@ Configuration files are searched from the **current directory up to the root** (
                 └── lt.config.yaml  # App-specific settings
 ```
 
-When running `lt server module` in `/home/user/projects/my-monorepo/projects/api/`:
-1. `/home/user/lt.config.json` is loaded first
-2. `/home/user/projects/my-monorepo/lt.config.json` is merged (overrides parent)
-3. `/home/user/projects/my-monorepo/projects/api/lt.config.json` is merged (overrides all)
+When running `lt server module` in `$HOME/projects/my-monorepo/projects/api/`:
+1. `$HOME/lt.config.json` is loaded first
+2. `$HOME/projects/my-monorepo/lt.config.json` is merged (overrides parent)
+3. `$HOME/projects/my-monorepo/projects/api/lt.config.json` is merged (overrides all)
 
 ## Configuration Structure
 
@@ -571,6 +571,8 @@ Creates a new fullstack workspace with API and frontend.
 | `commands.fullstack.frontendBranch` | `string` | - | Branch of frontend starter to use (ng-base-starter or nuxt-base-starter) |
 | `commands.fullstack.frontendCopy` | `string` | - | Path to local frontend template directory to copy instead of cloning |
 | `commands.fullstack.frontendLink` | `string` | - | Path to local frontend template directory to symlink (fastest, changes affect original) |
+| `commands.fullstack.frameworkMode` | `'npm'` \| `'vendor'` | `'npm'` | Backend framework consumption mode (npm dependency vs. vendored core in `src/core/`) |
+| `commands.fullstack.frontendFrameworkMode` | `'npm'` \| `'vendor'` | `'npm'` | Frontend framework consumption mode (npm dependency vs. vendored module in `app/core/`) |
 | `commands.fullstack.git` | `boolean` | - | Push initial commit to remote repository (git is always initialized with `dev` branch) |
 | `commands.fullstack.gitLink` | `string` | - | Git remote repository URL (required when `git` is true) |
 
@@ -1075,7 +1077,7 @@ meta:
 
 Set a value to `null` to remove it from parent configurations and use the default:
 
-**Parent config (`/home/user/lt.config.json`):**
+**Parent config (`$HOME/lt.config.json`):**
 ```json
 {
   "commands": {
@@ -1088,7 +1090,7 @@ Set a value to `null` to remove it from parent configurations and use the defaul
 }
 ```
 
-**Child config (`/home/user/project/lt.config.json`):**
+**Child config (`$HOME/project/lt.config.json`):**
 ```json
 {
   "commands": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lenne.tech/cli",
-  "version": "1.10.0",
+  "version": "1.11.1",
   "description": "lenne.Tech CLI: lt",
   "keywords": [
     "lenne.Tech",
@@ -26,6 +26,7 @@
     "copy-templates": "npx shx cp -R ./src/templates ./build/templates && npx shx cp -R ./src/config ./build/config",
     "coverage": "jest --coverage",
     "test:vendor-init": "bash scripts/test-vendor-init.sh",
+    "test:frontend-vendor-init": "bash scripts/test-frontend-vendor-init.sh",
     "format": "prettier --write 'src/**/*.{js,ts,tsx,json}' '!src/templates/**/*'",
     "lint": "eslint './src/**/*.{ts,js,vue}'",
     "lint:fix": "eslint './src/**/*.{ts,js,vue}' --fix",

package/build/templates/vendor-scripts/check-vendor-freshness.mjs

@@ -1,131 +0,0 @@
-#!/usr/bin/env node
-// Check whether the vendored @lenne.tech/nest-server core is up-to-date with the
-// latest upstream release. Non-blocking: prints a warning when outdated, but always
-// exits 0 so that `check` / `check:fix` pipelines continue.
-//
-// Reads:
-//   projects/api/src/core/VENDOR.md  →  baseline version (e.g. "11.24.1")
-//
-// Fetches:
-//   https://registry.npmjs.org/@lenne.tech/nest-server/latest  →  latest published version
-//
-// Outputs:
-//   - Up-to-date   → stdout: "✓ vendored nest-server core is up-to-date (vX.Y.Z)"
-//   - Outdated     → stderr: "⚠ vendored nest-server core is X.Y.Z, latest is A.B.C"
-//   - Offline/err  → stderr: warn + exit 0 (never fail)
-
-import { readFileSync, existsSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-import https from 'node:https';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const VENDOR_MD = join(__dirname, '..', '..', 'src', 'core', 'VENDOR.md');
-
-// ANSI color codes (no external deps)
-const C = {
-  reset: '\x1b[0m',
-  yellow: '\x1b[33m',
-  green: '\x1b[32m',
-  dim: '\x1b[2m',
-};
-
-function warnAndExit(msg) {
-  process.stderr.write(`${C.yellow}⚠ ${msg}${C.reset}\n`);
-  process.exit(0);
-}
-
-function ok(msg) {
-  process.stdout.write(`${C.green}✓ ${msg}${C.reset}\n`);
-  process.exit(0);
-}
-
-// 1. Locate VENDOR.md
-if (!existsSync(VENDOR_MD)) {
-  warnAndExit(
-    `vendor-freshness: VENDOR.md not found at ${VENDOR_MD}. ` +
-      `Is this project vendored? Skipping check.`,
-  );
-}
-
-// 2. Parse baseline version from VENDOR.md
-let baselineVersion;
-try {
-  const content = readFileSync(VENDOR_MD, 'utf-8');
-  // Match: "**Baseline-Version:** 11.24.1" or "Baseline-Version: 11.24.1"
-  const match = content.match(/Baseline-Version[:*\s]+([\d.]+[\w.-]*)/);
-  if (!match) {
-    warnAndExit(`vendor-freshness: could not parse Baseline-Version from ${VENDOR_MD}`);
-  }
-  baselineVersion = match[1];
-} catch (err) {
-  warnAndExit(`vendor-freshness: failed to read ${VENDOR_MD}: ${err.message}`);
-}
-
-// 3. Fetch latest from npm registry (offline-tolerant)
-function fetchLatest() {
-  return new Promise((resolve) => {
-    const req = https.get(
-      'https://registry.npmjs.org/@lenne.tech/nest-server/latest',
-      { timeout: 5000 },
-      (res) => {
-        if (res.statusCode !== 200) {
-          resolve(null);
-          return;
-        }
-        let body = '';
-        res.on('data', (chunk) => (body += chunk));
-        res.on('end', () => {
-          try {
-            const json = JSON.parse(body);
-            resolve(json.version || null);
-          } catch {
-            resolve(null);
-          }
-        });
-      },
-    );
-    req.on('error', () => resolve(null));
-    req.on('timeout', () => {
-      req.destroy();
-      resolve(null);
-    });
-  });
-}
-
-const latestVersion = await fetchLatest();
-
-if (!latestVersion) {
-  warnAndExit(
-    `vendor-freshness: could not reach npm registry. ` +
-      `Current baseline: ${baselineVersion}. Check skipped.`,
-  );
-}
-
-// 4. semver compare (simple lexical sort works for X.Y.Z)
-function parseSemver(v) {
-  const parts = v.split('.').map((p) => parseInt(p, 10));
-  return [parts[0] || 0, parts[1] || 0, parts[2] || 0];
-}
-
-const [bMaj, bMin, bPatch] = parseSemver(baselineVersion);
-const [lMaj, lMin, lPatch] = parseSemver(latestVersion);
-
-const baselineNum = bMaj * 1e6 + bMin * 1e3 + bPatch;
-const latestNum = lMaj * 1e6 + lMin * 1e3 + lPatch;
-
-if (baselineNum === latestNum) {
-  ok(`vendored nest-server core is up-to-date (v${baselineVersion})`);
-} else if (baselineNum < latestNum) {
-  const msg =
-    `vendored nest-server core is v${baselineVersion}, ` +
-    `latest upstream is v${latestVersion}\n` +
-    `${C.dim}  Run /lt-dev:backend:update-nest-server-core to sync${C.reset}`;
-  warnAndExit(msg);
-} else {
-  // baseline > latest: weird but not fatal
-  warnAndExit(
-    `vendored nest-server core is v${baselineVersion} (ahead of npm latest v${latestVersion}). ` +
-      `Possibly tracking an unreleased branch.`,
-  );
-}

package/build/templates/vendor-scripts/propose-upstream-pr.ts

@@ -1,269 +0,0 @@
-/**
- * Diff-generator for the `lt-dev:nest-server-core-contributor` agent.
- *
- * Analyzes local git commits that touched projects/api/src/core/ since the
- * vendoring baseline, emits per-commit patch files and a human-readable
- * candidate list. Filters out cosmetic commits (format, style, lint:fix).
- * Does NOT cherry-pick or open any PR — that's the contributor agent's job.
- *
- * Usage:
- *   pnpm run vendor:propose-upstream
- *   (or: ts-node scripts/vendor/propose-upstream-pr.ts [--since <sha>])
- *
- * Output directory: scripts/vendor/upstream-candidates/<timestamp>/
- *   - local-commits.json: structured metadata for every commit
- *   - local-diffs/<commit-sha>.patch: per-commit patch file
- *   - summary.md: human-readable candidate list
- */
-
-import { execSync } from 'node:child_process';
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-
-const PROJECT_ROOT = join(__dirname, '..', '..');
-const VENDOR_DIR = join(PROJECT_ROOT, 'src', 'core');
-const VENDOR_MD = join(VENDOR_DIR, 'VENDOR.md');
-const OUTPUT_BASE = join(PROJECT_ROOT, 'scripts', 'vendor', 'upstream-candidates');
-
-const MONOREPO_ROOT = join(PROJECT_ROOT, '..', '..');
-
-function die(msg: string): never {
-  process.stderr.write(`ERROR: ${msg}\n`);
-  process.exit(1);
-}
-
-function sh(cmd: string, opts: { cwd?: string; allowFailure?: boolean } = {}): string {
-  try {
-    return execSync(cmd, {
-      cwd: opts.cwd ?? MONOREPO_ROOT,
-      encoding: 'utf-8',
-      stdio: ['ignore', 'pipe', 'pipe'],
-    });
-  } catch (err: unknown) {
-    if (opts.allowFailure) {
-      const e = err as { stdout?: string };
-      return e.stdout ?? '';
-    }
-    throw err;
-  }
-}
-
-// Cosmetic message patterns (case-insensitive)
-const COSMETIC_PATTERNS = [
-  /^chore.*format/i,
-  /^style:/i,
-  /^chore.*oxfmt/i,
-  /^chore.*prettier/i,
-  /^chore.*lint:fix/i,
-  /^chore.*linting/i,
-  /^chore.*apply project formatting/i,
-  /^chore.*re-?format/i,
-];
-
-interface CommitInfo {
-  sha: string;
-  shortSha: string;
-  subject: string;
-  author: string;
-  date: string;
-  files: string[];
-  isCosmetic: boolean;
-  cosmeticReason: string | null;
-}
-
-// 1. Parse arguments
-const args = process.argv.slice(2);
-let sinceRef: string | null = null;
-
-for (let i = 0; i < args.length; i++) {
-  if (args[i] === '--since' && i + 1 < args.length) {
-    sinceRef = args[++i];
-  }
-}
-
-// 2. Verify vendored state
-if (!existsSync(VENDOR_MD)) {
-  die(`VENDOR.md not found at ${VENDOR_MD}. Not a vendored project.`);
-}
-
-const vendorContent = readFileSync(VENDOR_MD, 'utf-8');
-const baselineVersionMatch = vendorContent.match(/Baseline-Version[:*\s]+([\d.]+[\w.-]*)/);
-const baselineVersion = baselineVersionMatch?.[1] ?? 'unknown';
-
-// 3. Determine starting point for git log
-if (!sinceRef) {
-  // Find the commit that added VENDOR.md — that's the vendoring commit
-  sinceRef = sh(
-    `git log --diff-filter=A --format="%H" -- projects/api/src/core/VENDOR.md | tail -1`,
-  ).trim();
-  if (!sinceRef) {
-    die(
-      'Could not find the commit that added VENDOR.md. Pass --since <sha> manually.',
-    );
-  }
-}
-
-// 4. Collect all commits since that ref that touched src/core/
-const gitLog = sh(
-  `git log --format="%H%x09%s%x09%an%x09%aI" ${sinceRef}..HEAD -- projects/api/src/core/`,
-).trim();
-
-if (!gitLog) {
-  process.stdout.write(
-    `No local commits found since ${sinceRef.substring(0, 8)} touching src/core/. Nothing to propose.\n`,
-  );
-  process.exit(0);
-}
-
-const commits: CommitInfo[] = gitLog
-  .split('\n')
-  .filter((line) => line.trim())
-  .map((line) => {
-    const [sha, subject, author, date] = line.split('\t');
-    const filesOutput = sh(
-      `git show --pretty="" --name-only ${sha} -- projects/api/src/core/`,
-    ).trim();
-    const files = filesOutput ? filesOutput.split('\n') : [];
-
-    // Cosmetic check by message pattern
-    let isCosmetic = false;
-    let cosmeticReason: string | null = null;
-    for (const pat of COSMETIC_PATTERNS) {
-      if (pat.test(subject)) {
-        isCosmetic = true;
-        cosmeticReason = `commit-message matches ${pat.source}`;
-        break;
-      }
-    }
-
-    // Additional cosmetic check: if diff has only whitespace/formatting changes
-    if (!isCosmetic) {
-      const diff = sh(`git show --format="" ${sha} -- projects/api/src/core/`);
-      // Normalize: drop all whitespace, quote style, trailing commas
-      const normalized = diff
-        .split('\n')
-        .filter((l) => l.startsWith('+') || l.startsWith('-'))
-        .filter((l) => !l.startsWith('+++') && !l.startsWith('---'))
-        .map((l) => l.slice(1).replace(/\s+/g, '').replace(/['"`]/g, '').replace(/,$/, ''))
-        .filter((l) => l.length > 0);
-
-      // Count +/- with the same normalized content — if they cancel out, it's cosmetic
-      const plus = normalized.filter((_, i) => diff.split('\n').filter((l) => l.startsWith('+') && !l.startsWith('+++'))[i]);
-      // Simpler heuristic: if normalized plus == normalized minus, it's cosmetic
-      const plusLines = diff.split('\n').filter((l) => l.startsWith('+') && !l.startsWith('+++')).map((l) => l.slice(1).replace(/\s+/g, ''));
-      const minusLines = diff.split('\n').filter((l) => l.startsWith('-') && !l.startsWith('---')).map((l) => l.slice(1).replace(/\s+/g, ''));
-      const plusSet = new Set(plusLines);
-      const minusSet = new Set(minusLines);
-      const plusOnlyCount = [...plusSet].filter((l) => !minusSet.has(l) && l.length > 0).length;
-      const minusOnlyCount = [...minusSet].filter((l) => !plusSet.has(l) && l.length > 0).length;
-      if (plusOnlyCount === 0 && minusOnlyCount === 0 && plusLines.length > 0) {
-        isCosmetic = true;
-        cosmeticReason = 'normalized diff is empty (whitespace/quotes only)';
-      }
-    }
-
-    return {
-      sha,
-      shortSha: sha.substring(0, 8),
-      subject,
-      author,
-      date,
-      files,
-      isCosmetic,
-      cosmeticReason,
-    };
-  });
-
-// 5. Write output
-const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-const outputDir = join(OUTPUT_BASE, timestamp);
-const diffsDir = join(outputDir, 'local-diffs');
-mkdirSync(diffsDir, { recursive: true });
-
-// Save JSON
-writeFileSync(
-  join(outputDir, 'local-commits.json'),
-  JSON.stringify(
-    {
-      baselineVersion,
-      sinceRef,
-      generated: new Date().toISOString(),
-      total: commits.length,
-      cosmetic: commits.filter((c) => c.isCosmetic).length,
-      substantial: commits.filter((c) => !c.isCosmetic).length,
-      commits,
-    },
-    null,
-    2,
-  ),
-);
-
-// Save per-commit patch files (only substantial ones)
-for (const commit of commits.filter((c) => !c.isCosmetic)) {
-  const patch = sh(`git show ${commit.sha} -- projects/api/src/core/`);
-  writeFileSync(join(diffsDir, `${commit.shortSha}.patch`), patch);
-}
-
-// Save summary
-const substantialCommits = commits.filter((c) => !c.isCosmetic);
-const cosmeticCommits = commits.filter((c) => c.isCosmetic);
-
-const summary = `# Upstream-PR Candidates
-
-**Baseline version:** ${baselineVersion}
-**Since commit:** ${sinceRef.substring(0, 8)}
-**Generated:** ${new Date().toISOString()}
-
-## Statistics
-
-- Total commits touching \`src/core/\`: ${commits.length}
-- Filtered as cosmetic: ${cosmeticCommits.length}
-- **Substantial (candidate pool):** ${substantialCommits.length}
-
-## Substantial Commits (need manual categorization by the contributor agent)
-
-${
-  substantialCommits.length === 0
-    ? '_No substantial local changes. Nothing to contribute._'
-    : substantialCommits
-        .map(
-          (c) =>
-            `### \`${c.shortSha}\` — ${c.subject}\n\n` +
-            `- **Author:** ${c.author}\n` +
-            `- **Date:** ${c.date}\n` +
-            `- **Files:** ${c.files.length}\n` +
-            c.files.map((f) => `  - ${f}`).join('\n') +
-            `\n- **Patch:** \`local-diffs/${c.shortSha}.patch\`\n`,
-        )
-        .join('\n')
-}
-
-## Filtered Cosmetic Commits
-
-${
-  cosmeticCommits.length === 0
-    ? '_(none)_'
-    : cosmeticCommits
-        .map((c) => `- \`${c.shortSha}\` — ${c.subject} _(${c.cosmeticReason})_`)
-        .join('\n')
-}
-
-## Next Steps
-
-Run the contributor agent:
-\`\`\`
-/lt-dev:backend:contribute-nest-server-core
-\`\`\`
-
-It will:
-1. Categorize each substantial commit (upstream-candidate / project-specific / unclear)
-2. Check upstream HEAD for duplicates
-3. Prepare candidate branches in a local upstream clone with reverse flatten-fix
-4. Generate PR-body drafts for human review
-5. Present a final list with \`gh pr create\` commands ready to run
-`;
-
-writeFileSync(join(outputDir, 'summary.md'), summary);
-
-process.stdout.write(`\nDone. Review:\n`);
-process.stdout.write(`  cat ${outputDir}/summary.md\n`);