@lumenflow/cli 3.17.5 → 3.17.7

package/dist/init-docs-scaffolder.js

@@ -0,0 +1,96 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file init-docs-scaffolder.ts
+ * WU-2399: Extracted from init.ts -- documentation generation and framework overlay logic.
+ *
+ * Responsible for:
+ * - Full docs scaffolding (WU dirs, templates, backlog, status)
+ * - Agent onboarding docs
+ * - Claude skills
+ * - Framework overlay files
+ */
+import * as path from 'node:path';
+import { createError, ErrorCodes } from '@lumenflow/core';
+import { processTemplate, loadTemplate, createFile, createDirectory } from './init-scaffolding.js';
+import { BACKLOG_TEMPLATE, STATUS_TEMPLATE, WU_TEMPLATE_YAML, FRAMEWORK_HINT_TEMPLATE, FRAMEWORK_OVERLAY_TEMPLATE, WU_LIFECYCLE_SKILL_TEMPLATE, WORKTREE_DISCIPLINE_SKILL_TEMPLATE, LUMENFLOW_GATES_SKILL_TEMPLATE, } from './init-templates.js';
+import { SCAFFOLDED_ONBOARDING_TEMPLATE_PATHS } from './onboarding-template-paths.js';
+/**
+ * Normalize a framework name into display + slug
+ */
+export function normalizeFrameworkName(framework) {
+    const name = framework.trim();
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, '-')
+        // Remove leading dashes and trailing dashes separately (explicit precedence)
+        .replace(/^-+/, '')
+        .replace(/-+$/, '');
+    if (!slug) {
+        throw createError(ErrorCodes.INVALID_ARGUMENT, `Invalid framework name: "${framework}"`);
+    }
+    return { name, slug };
+}
+/**
+ * WU-1083: Scaffold agent onboarding documentation
+ * WU-1300: Added starting-prompt.md
+ * WU-1309: Added onboarding docs scaffold with dynamic docs path resolution
+ */
+export async function scaffoldAgentOnboardingDocs(targetDir, options, result, tokens) {
+    // WU-1309: Use dynamic onboarding path from tokens
+    const onboardingDir = path.join(targetDir, tokens.DOCS_ONBOARDING_PATH);
+    await createDirectory(onboardingDir, result, targetDir);
+    for (const [outputFile, templatePath] of Object.entries(SCAFFOLDED_ONBOARDING_TEMPLATE_PATHS)) {
+        await createFile(path.join(onboardingDir, outputFile), processTemplate(loadTemplate(templatePath), tokens), options.force, result, targetDir);
+    }
+}
+/**
+ * WU-1083: Scaffold Claude skills
+ */
+export async function scaffoldClaudeSkills(targetDir, options, result, tokens) {
+    const skillsDir = path.join(targetDir, '.claude', 'skills');
+    // wu-lifecycle skill
+    const wuLifecycleDir = path.join(skillsDir, 'wu-lifecycle');
+    await createDirectory(wuLifecycleDir, result, targetDir);
+    await createFile(path.join(wuLifecycleDir, 'SKILL.md'), processTemplate(WU_LIFECYCLE_SKILL_TEMPLATE, tokens), true, result, targetDir);
+    // worktree-discipline skill
+    const worktreeDir = path.join(skillsDir, 'worktree-discipline');
+    await createDirectory(worktreeDir, result, targetDir);
+    await createFile(path.join(worktreeDir, 'SKILL.md'), processTemplate(WORKTREE_DISCIPLINE_SKILL_TEMPLATE, tokens), true, result, targetDir);
+    // lumenflow-gates skill
+    const gatesDir = path.join(skillsDir, 'lumenflow-gates');
+    await createDirectory(gatesDir, result, targetDir);
+    await createFile(path.join(gatesDir, 'SKILL.md'), processTemplate(LUMENFLOW_GATES_SKILL_TEMPLATE, tokens), true, result, targetDir);
+}
+export async function scaffoldFullDocs(targetDir, options, result, tokens) {
+    // WU-1309: Use config-derived docs paths from tokens (computed in scaffoldProject)
+    const wuDir = path.join(targetDir, tokens.DOCS_WU_DIR_PATH);
+    const templatesDir = path.join(targetDir, tokens.DOCS_TEMPLATES_DIR_PATH);
+    await createDirectory(wuDir, result, targetDir);
+    await createDirectory(templatesDir, result, targetDir);
+    await createFile(path.join(wuDir, '.gitkeep'), '', options.force, result, targetDir);
+    await createFile(path.join(targetDir, tokens.DOCS_BACKLOG_PATH), BACKLOG_TEMPLATE, true, result, targetDir);
+    await createFile(path.join(targetDir, tokens.DOCS_STATUS_PATH), STATUS_TEMPLATE, true, result, targetDir);
+    await createFile(path.join(templatesDir, 'wu-template.yaml'), processTemplate(WU_TEMPLATE_YAML, tokens), true, result, targetDir);
+    // WU-1083: Scaffold agent onboarding docs with --full
+    await scaffoldAgentOnboardingDocs(targetDir, options, result, tokens);
+}
+/** Framework hint file name constant */
+const FRAMEWORK_HINT_FILE = '.lumenflow.framework.yaml';
+export async function scaffoldFrameworkOverlay(targetDir, options, result, tokens) {
+    if (!options.framework) {
+        return;
+    }
+    const { name, slug } = normalizeFrameworkName(options.framework);
+    const frameworkTokens = {
+        ...tokens,
+        FRAMEWORK_NAME: name,
+        FRAMEWORK_SLUG: slug,
+    };
+    await createFile(path.join(targetDir, FRAMEWORK_HINT_FILE), processTemplate(FRAMEWORK_HINT_TEMPLATE, frameworkTokens), options.force, result, targetDir);
+    // WU-1309: Use dynamic operations path from tokens
+    const overlayDir = path.join(targetDir, tokens.DOCS_OPERATIONS_PATH, '_frameworks', slug);
+    await createDirectory(overlayDir, result, targetDir);
+    await createFile(path.join(overlayDir, 'README.md'), processTemplate(FRAMEWORK_OVERLAY_TEMPLATE, frameworkTokens), options.force, result, targetDir);
+}
+//# sourceMappingURL=init-docs-scaffolder.js.map

package/dist/init-docs-scaffolder.js.map

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

package/dist/init-package-config.js

@@ -0,0 +1,135 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file init-package-config.ts
+ * WU-2399: Extracted from init.ts -- package.json scripts, prettier config,
+ * dependency injection.
+ *
+ * Responsible for:
+ * - Generating LumenFlow scripts from the public manifest
+ * - Injecting scripts into package.json
+ * - Adding devDependencies (prettier, @lumenflow/cli)
+ * - Adding gate stub scripts
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { getPublicManifest } from './public-manifest.js';
+import { GATE_STUB_SCRIPTS, SCRIPT_ARG_OVERRIDES } from './init-templates.js';
+/**
+ * WU-1517: Prettier version to add to devDependencies.
+ * Uses caret range to allow minor/patch updates.
+ */
+export const PRETTIER_VERSION = '^3.8.0';
+/** WU-1517: Prettier package name constant */
+export const PRETTIER_PACKAGE_NAME = 'prettier';
+/**
+ * WU-1963: @lumenflow/cli version to add to devDependencies.
+ * Uses caret range to allow minor/patch updates within the major version.
+ * This ensures `pnpm wu:create`, `pnpm gates`, etc. resolve after `pnpm install`.
+ */
+export const CLI_PACKAGE_VERSION = '^3.0.0';
+/** WU-1963: CLI package name constant */
+export const CLI_PACKAGE_NAME = '@lumenflow/cli';
+/**
+ * WU-1307: LumenFlow scripts to inject into package.json
+ * WU-1342: Expanded to include essential commands
+ * WU-1433: Now derived from the public CLI manifest (WU-1432) instead of
+ * hardcoded list. Ensures all public commands are exposed and avoids drift.
+ */
+export function generateLumenflowScripts() {
+    const scripts = {};
+    const manifest = getPublicManifest();
+    for (const cmd of manifest) {
+        // Use override if defined, otherwise map to the binary name
+        scripts[cmd.name] = SCRIPT_ARG_OVERRIDES[cmd.name] ?? cmd.binName;
+    }
+    return scripts;
+}
+/**
+ * WU-1300: Inject LumenFlow scripts into package.json
+ * WU-1517: Also adds prettier devDependency
+ * WU-1518: Also adds gate stub scripts (spec:linter, lint, typecheck)
+ * WU-1747: format and format:check are now part of GATE_STUB_SCRIPTS
+ * WU-1963: Also adds @lumenflow/cli devDependency so binary scripts resolve
+ * WU-2399: Fix --force flag: when force is true, always overwrite existing values
+ * - Creates package.json if it doesn't exist
+ * - Preserves existing scripts (doesn't overwrite unless --force)
+ * - Adds missing LumenFlow scripts
+ * - Adds @lumenflow/cli to devDependencies (provides wu-create, gates, etc. binaries)
+ * - Adds prettier to devDependencies
+ * - Adds gate stub scripts for spec:linter, lint, typecheck, format, format:check
+ */
+export async function injectPackageJsonScripts(targetDir, options, result) {
+    const packageJsonPath = path.join(targetDir, 'package.json');
+    let packageJson;
+    if (fs.existsSync(packageJsonPath)) {
+        // Read existing package.json
+        const content = fs.readFileSync(packageJsonPath, 'utf-8');
+        packageJson = JSON.parse(content);
+    }
+    else {
+        // Create minimal package.json
+        packageJson = {
+            name: path.basename(targetDir),
+            version: '0.0.1',
+            private: true,
+        };
+    }
+    // Ensure scripts object exists
+    if (!packageJson.scripts || typeof packageJson.scripts !== 'object') {
+        packageJson.scripts = {};
+    }
+    const scripts = packageJson.scripts;
+    let modified = false;
+    // WU-1433: Derive scripts from public manifest (not hardcoded)
+    // WU-2399: Fix --force flag: when force is true, always overwrite existing scripts
+    const lumenflowScripts = generateLumenflowScripts();
+    for (const [scriptName, scriptCommand] of Object.entries(lumenflowScripts)) {
+        if (options.force || !(scriptName in scripts)) {
+            scripts[scriptName] = scriptCommand;
+            modified = true;
+        }
+    }
+    // WU-1518: Add gate stub scripts (spec:linter, lint, typecheck, format, format:check)
+    // WU-1747: format and format:check are now part of GATE_STUB_SCRIPTS with
+    // auto-detection of prettier availability, so they pass immediately after init.
+    // These stubs let `pnpm gates` pass on a fresh project without manual script additions.
+    // Projects replace them with real tooling when ready.
+    for (const [scriptName, scriptCommand] of Object.entries(GATE_STUB_SCRIPTS)) {
+        if (options.force) {
+            scripts[scriptName] = scriptCommand;
+            modified = true;
+        }
+        else if (!(scriptName in scripts)) {
+            scripts[scriptName] = scriptCommand;
+            modified = true;
+        }
+    }
+    // Ensure devDependencies object exists
+    if (!packageJson.devDependencies || typeof packageJson.devDependencies !== 'object') {
+        packageJson.devDependencies = {};
+    }
+    const devDeps = packageJson.devDependencies;
+    // WU-1963: Add @lumenflow/cli to devDependencies so binary scripts resolve after pnpm install
+    if (options.force || !(CLI_PACKAGE_NAME in devDeps)) {
+        if (options.force && CLI_PACKAGE_NAME in devDeps) {
+            devDeps[CLI_PACKAGE_NAME] = CLI_PACKAGE_VERSION;
+            modified = true;
+        }
+        else if (!(CLI_PACKAGE_NAME in devDeps)) {
+            devDeps[CLI_PACKAGE_NAME] = CLI_PACKAGE_VERSION;
+            modified = true;
+        }
+    }
+    // WU-1517: Add prettier to devDependencies
+    // WU-2399: Fix --force flag: when force is true, always overwrite existing version
+    if (options.force || !(PRETTIER_PACKAGE_NAME in devDeps)) {
+        devDeps[PRETTIER_PACKAGE_NAME] = PRETTIER_VERSION;
+        modified = true;
+    }
+    if (modified) {
+        fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+        result.created.push('package.json (scripts updated)');
+    }
+}
+//# sourceMappingURL=init-package-config.js.map

package/dist/init-package-config.js.map

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

package/dist/init-safety-scripts.js

@@ -0,0 +1,129 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file init-safety-scripts.ts
+ * WU-2399: Extracted from init.ts -- husky/git hooks, pre-commit setup,
+ * gitignore/prettierignore scaffolding.
+ *
+ * Responsible for:
+ * - Scaffolding .gitignore with LumenFlow exclusions
+ * - Scaffolding .prettierignore
+ * - Scaffolding scripts/safe-git wrapper
+ * - Scaffolding .husky/pre-commit hook
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createFile, createExecutableScript, loadTemplate } from './init-scaffolding.js';
+import { GITIGNORE_TEMPLATE, REQUIRED_GITIGNORE_EXCLUSIONS, PRETTIERIGNORE_TEMPLATE, SAFE_GIT_TEMPLATE, PRE_COMMIT_TEMPLATE, } from './init-templates.js';
+/** Gitignore file name constant to avoid duplicate string lint error */
+const GITIGNORE_FILE_NAME = '.gitignore';
+/** Prettierignore file name constant to avoid duplicate string lint error */
+const PRETTIERIGNORE_FILE_NAME = '.prettierignore';
+/** WU-1408: Safety script path constants */
+const SCRIPTS_DIR = 'scripts';
+const SAFE_GIT_FILE = 'safe-git';
+const HUSKY_DIR = '.husky';
+const PRE_COMMIT_FILE = 'pre-commit';
+const SAFE_GIT_TEMPLATE_PATH = 'core/scripts/safe-git.template';
+const PRE_COMMIT_TEMPLATE_PATH = 'core/.husky/pre-commit.template';
+/**
+ * WU-1171: Determine file mode from options
+ */
+export function getFileMode(options) {
+    if (options.force) {
+        return 'force';
+    }
+    if (options.merge) {
+        return 'merge';
+    }
+    return 'skip';
+}
+/**
+ * WU-1342: Scaffold .gitignore file with LumenFlow exclusions
+ * Supports merge mode to add exclusions to existing .gitignore
+ * WU-2399: Fixed gitignore matching to parse lines and ignore comments
+ */
+export async function scaffoldGitignore(targetDir, options, result) {
+    const gitignorePath = path.join(targetDir, GITIGNORE_FILE_NAME);
+    const fileMode = getFileMode(options);
+    // WU-1965: Auto-merge lumenflow entries when .gitignore exists, regardless of mode.
+    // Previously only merge mode triggered merging; skip mode would skip the entire file,
+    // risking accidental commits of .lumenflow/telemetry, worktrees, etc.
+    if ((fileMode === 'merge' || fileMode === 'skip') && fs.existsSync(gitignorePath)) {
+        // Merge mode or skip mode with existing file: append LumenFlow exclusions if not already present
+        const existingContent = fs.readFileSync(gitignorePath, 'utf-8');
+        const linesToAdd = [];
+        // WU-2399: Parse gitignore lines properly -- strip comments and blank lines,
+        // compare against trimmed non-comment lines only. The old `existingContent.includes(pattern)`
+        // would false-positive match comments like "# ignore node_modules".
+        const existingNonCommentLines = new Set(existingContent
+            .split('\n')
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0 && !l.startsWith('#')));
+        // WU-1969: Use shared constant so merge path and full template cannot drift
+        for (const { pattern, line } of REQUIRED_GITIGNORE_EXCLUSIONS) {
+            if (!existingNonCommentLines.has(pattern) && !existingNonCommentLines.has(line)) {
+                linesToAdd.push(line);
+            }
+        }
+        if (linesToAdd.length > 0) {
+            const separator = existingContent.endsWith('\n') ? '' : '\n';
+            const lumenflowBlock = `${separator}
+# LumenFlow (auto-added)
+${linesToAdd.join('\n')}
+`;
+            fs.writeFileSync(gitignorePath, existingContent + lumenflowBlock);
+            result.merged = result.merged ?? [];
+            result.merged.push(GITIGNORE_FILE_NAME);
+        }
+        else {
+            result.skipped.push(GITIGNORE_FILE_NAME);
+        }
+        return;
+    }
+    // Force mode or file doesn't exist: write full template
+    await createFile(gitignorePath, GITIGNORE_TEMPLATE, fileMode, result, targetDir);
+}
+/**
+ * WU-1517: Scaffold .prettierignore file with sane defaults
+ * This is a core file scaffolded in all modes (full and minimal)
+ * because it's required for format:check gate to pass.
+ */
+export async function scaffoldPrettierignore(targetDir, options, result) {
+    const prettierignorePath = path.join(targetDir, PRETTIERIGNORE_FILE_NAME);
+    const fileMode = getFileMode(options);
+    await createFile(prettierignorePath, PRETTIERIGNORE_TEMPLATE, fileMode, result, targetDir);
+}
+/**
+ * WU-1408: Scaffold safety scripts (safe-git wrapper and pre-commit hook)
+ * These are core safety components needed for LumenFlow enforcement:
+ * - scripts/safe-git: Blocks dangerous git operations (e.g., manual worktree remove)
+ * - .husky/pre-commit: Blocks direct commits to main/master, enforces WU workflow
+ *
+ * Both scripts are scaffolded in all modes (full and minimal) because they are
+ * required for lumenflow-doctor to pass.
+ */
+export async function scaffoldSafetyScripts(targetDir, options, result) {
+    const fileMode = getFileMode(options);
+    // Scaffold scripts/safe-git
+    const safeGitPath = path.join(targetDir, SCRIPTS_DIR, SAFE_GIT_FILE);
+    try {
+        const safeGitTemplate = loadTemplate(SAFE_GIT_TEMPLATE_PATH);
+        await createExecutableScript(safeGitPath, safeGitTemplate, fileMode, result, targetDir);
+    }
+    catch {
+        // Fallback to hardcoded template if template file not found
+        await createExecutableScript(safeGitPath, SAFE_GIT_TEMPLATE, fileMode, result, targetDir);
+    }
+    // Scaffold .husky/pre-commit
+    const preCommitPath = path.join(targetDir, HUSKY_DIR, PRE_COMMIT_FILE);
+    try {
+        const preCommitTemplate = loadTemplate(PRE_COMMIT_TEMPLATE_PATH);
+        await createExecutableScript(preCommitPath, preCommitTemplate, fileMode, result, targetDir);
+    }
+    catch {
+        // Fallback to hardcoded template if template file not found
+        await createExecutableScript(preCommitPath, PRE_COMMIT_TEMPLATE, fileMode, result, targetDir);
+    }
+}
+//# sourceMappingURL=init-safety-scripts.js.map

package/dist/init-safety-scripts.js.map

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