@cbnventures/nova 0.14.0 → 0.15.1

package/build/src/cli/generate/github/workflows.js

@@ -0,0 +1,464 @@
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+import { parse as parseYaml, stringify as stringifyYaml, } from 'yaml';
+import { LibNovaConfig } from '../../../lib/nova-config.js';
+import { LIB_REGEX_PATTERN_WORKFLOW_CONTEXT_EXPRESSION, LIB_REGEX_PATTERN_WORKFLOW_CONTEXT_SEPARATOR, LIB_REGEX_PATTERN_WORKFLOW_CONTEXT_WRAPPER_END, LIB_REGEX_PATTERN_WORKFLOW_CONTEXT_WRAPPER_START, LIB_REGEX_PATTERN_WORKFLOW_NAME, LIB_REGEX_PATTERN_WORKFLOW_RUN_NAME_CAPTURE, } from '../../../lib/regex.js';
+import { isProjectRoot, pathExists, renameFileWithDate, resolveTemplatePath, saveGeneratedFile, } from '../../../lib/utility.js';
+import { libWorkflowTemplatesMetadata } from '../../../lib/workflow-templates.js';
+import { Logger } from '../../../toolkit/index.js';
+export class CliGenerateGithubWorkflows {
+    static async run(options) {
+        const currentDirectory = process.cwd();
+        const isAtProjectRoot = await isProjectRoot(currentDirectory);
+        if (isAtProjectRoot !== true) {
+            process.exitCode = 1;
+            return 'cancelled';
+        }
+        const isDryRun = options['dryRun'] === true;
+        const isReplaceFile = options['replaceFile'] === true;
+        if (isDryRun === true) {
+            Logger.customize({
+                name: 'CliGenerateGithubWorkflows.run',
+                purpose: 'options',
+            }).warn('Dry run enabled. File changes will not be made in this session.');
+        }
+        if (isReplaceFile === true) {
+            const replaceFileNotice = (isDryRun === true) ? 'This option has no effect during a dry run session.' : 'Backup file will not be created.';
+            Logger.customize({
+                name: 'CliGenerateGithubWorkflows.run',
+                purpose: 'options',
+            }).warn(`Replace file enabled. ${replaceFileNotice}`);
+        }
+        const config = await new LibNovaConfig().load();
+        const workflows = config['workflows'];
+        if (workflows === undefined || workflows.length === 0) {
+            Logger.customize({
+                name: 'CliGenerateGithubWorkflows.run',
+                purpose: 'skip',
+            }).info('No workflows configured.');
+            return 'completed';
+        }
+        const templateDirectory = resolveTemplatePath(import.meta.url, 'generators/github/workflows');
+        const workflowsDirectory = join(currentDirectory, '.github', 'workflows');
+        const duplicateSet = new Set();
+        let hasDuplicateError = false;
+        for (const entry of workflows) {
+            const duplicateKey = (entry['suffix'] !== undefined) ? `${entry['template']}-${entry['suffix']}` : entry['template'];
+            if (duplicateSet.has(duplicateKey) === true) {
+                Logger.customize({
+                    name: 'CliGenerateGithubWorkflows.run',
+                    purpose: 'validate',
+                }).error(`Duplicate workflow ${chalk.cyan(`"${duplicateKey}"`)}. Each template must have a unique suffix when used multiple times.`);
+                hasDuplicateError = true;
+            }
+            duplicateSet.add(duplicateKey);
+        }
+        if (hasDuplicateError === true) {
+            process.exitCode = 1;
+            return 'cancelled';
+        }
+        if (CliGenerateGithubWorkflows.detectCircularDependsOn(workflows) === true) {
+            Logger.customize({
+                name: 'CliGenerateGithubWorkflows.run',
+                purpose: 'validate',
+            }).error('Circular depends-on references detected. Aborting.');
+            process.exitCode = 1;
+            return 'cancelled';
+        }
+        const generatedSet = new Set();
+        const outputFileNames = new Set();
+        const setupLines = [];
+        for (const workflowEntry of workflows) {
+            const entry = workflowEntry;
+            const templateName = entry['template'];
+            const metadataEntry = libWorkflowTemplatesMetadata.find((m) => m['name'] === templateName);
+            if (metadataEntry === undefined) {
+                Logger.customize({
+                    name: 'CliGenerateGithubWorkflows.run',
+                    purpose: 'validate',
+                }).error(`Unknown template ${chalk.cyan(`"${templateName}"`)}. Skipping.`);
+                continue;
+            }
+            const templateDirPath = join(templateDirectory, templateName);
+            const templateDirExists = await pathExists(templateDirPath);
+            if (templateDirExists !== true) {
+                Logger.customize({
+                    name: 'CliGenerateGithubWorkflows.run',
+                    purpose: 'validate',
+                }).error(`Template directory ${chalk.cyan(`"${templateName}"`)} not found. Skipping.`);
+                continue;
+            }
+            const missingLiterals = [];
+            for (const variableEntry of Object.entries(metadataEntry['variables'])) {
+                const variableName = variableEntry[0];
+                const variableMeta = variableEntry[1];
+                if (variableMeta['format'] === 'literal') {
+                    if (entry['settings'] === undefined || entry['settings'][variableName] === undefined) {
+                        missingLiterals.push(variableName);
+                    }
+                }
+            }
+            if (missingLiterals.length > 0) {
+                Logger.customize({
+                    name: 'CliGenerateGithubWorkflows.run',
+                    purpose: 'validate',
+                }).error(`Template ${chalk.cyan(`"${templateName}"`)} is missing required literal settings: ${missingLiterals.join(', ')}. Skipping.`);
+                continue;
+            }
+            const workflowSuffix = entry['suffix'];
+            const outputFileName = (workflowSuffix !== undefined) ? `nova-${templateName}-${workflowSuffix}.yml` : `nova-${templateName}.yml`;
+            if (outputFileNames.has(outputFileName) === true) {
+                Logger.customize({
+                    name: 'CliGenerateGithubWorkflows.run',
+                    purpose: 'validate',
+                }).error(`Duplicate output filename ${chalk.cyan(`"${outputFileName}"`)}. Skipping.`);
+                continue;
+            }
+            outputFileNames.add(outputFileName);
+            const basePath = join(templateDirPath, 'base.yml');
+            let baseContent = undefined;
+            try {
+                baseContent = await fs.readFile(basePath, 'utf-8');
+            }
+            catch {
+                Logger.customize({
+                    name: 'CliGenerateGithubWorkflows.run',
+                    purpose: 'read',
+                }).error(`Failed to read base template ${chalk.cyan(`"${templateName}/base.yml"`)}. Skipping.`);
+                continue;
+            }
+            const hasTriggers = entry['triggers'].length > 0;
+            let content = baseContent;
+            if (hasTriggers === true) {
+                const triggers = entry['triggers'];
+                let hasTriggerError = false;
+                const triggerDataList = [];
+                for (const trigger of triggers) {
+                    const triggerFileName = `${trigger}.yml`;
+                    const triggerFilePath = join(templateDirPath, 'triggers', triggerFileName);
+                    const triggerFileExists = await pathExists(triggerFilePath);
+                    if (triggerFileExists !== true) {
+                        Logger.customize({
+                            name: 'CliGenerateGithubWorkflows.run',
+                            purpose: 'validate',
+                        }).error(`Trigger file ${chalk.cyan(`"${triggerFileName}"`)} not found for template ${chalk.cyan(`"${templateName}"`)}. Skipping workflow.`);
+                        hasTriggerError = true;
+                        break;
+                    }
+                    let triggerRawContent = '';
+                    try {
+                        triggerRawContent = await fs.readFile(triggerFilePath, 'utf-8');
+                    }
+                    catch {
+                        Logger.customize({
+                            name: 'CliGenerateGithubWorkflows.run',
+                            purpose: 'read',
+                        }).error(`Failed to read trigger file ${chalk.cyan(`"${triggerFileName}"`)}. Skipping workflow.`);
+                        hasTriggerError = true;
+                        break;
+                    }
+                    const triggerParsed = parseYaml(triggerRawContent);
+                    const triggerParsedRunName = triggerParsed['run-name'];
+                    const triggerParsedPublishCondition = triggerParsed['publish-condition'];
+                    const triggerParsedTriggerBlock = triggerParsed['trigger'];
+                    const triggerParsedDependsOn = triggerParsed['depends-on'];
+                    const triggerParsedJobsCondition = triggerParsed['jobs-condition'];
+                    const triggerData = {
+                        runName: triggerParsedRunName,
+                        publishCondition: triggerParsedPublishCondition,
+                        triggerBlock: triggerParsedTriggerBlock,
+                        dependsOn: triggerParsedDependsOn,
+                        jobsCondition: triggerParsedJobsCondition,
+                    };
+                    triggerDataList.push(triggerData);
+                }
+                if (hasTriggerError === true) {
+                    continue;
+                }
+                const needsDependsOn = triggerDataList.some((triggerData) => triggerData['dependsOn'] === true);
+                if (needsDependsOn === true) {
+                    const dependsOnEntries = entry['depends-on'] ?? [];
+                    const entryLabel = (workflowSuffix !== undefined) ? `${templateName}-${workflowSuffix}` : templateName;
+                    if (dependsOnEntries.length === 0) {
+                        Logger.customize({
+                            name: 'CliGenerateGithubWorkflows.run',
+                            purpose: 'validate',
+                        }).error(`Workflow ${chalk.cyan(`"${entryLabel}"`)} uses a trigger that requires depends-on, but no depends-on value is configured. Skipping.`);
+                        continue;
+                    }
+                    const dependsOnResolvedNames = [];
+                    let hasDependsOnError = false;
+                    for (const dependsOnEntry of dependsOnEntries) {
+                        const entry2 = dependsOnEntry;
+                        const dependsOnTarget = workflows.find((w) => {
+                            const targetKey = (w['suffix'] !== undefined) ? `${w['template']}-${w['suffix']}` : w['template'];
+                            return targetKey === entry2;
+                        });
+                        if (dependsOnTarget === undefined) {
+                            Logger.customize({
+                                name: 'CliGenerateGithubWorkflows.run',
+                                purpose: 'validate',
+                            }).error(`Workflow ${chalk.cyan(`"${entryLabel}"`)} depends on ${chalk.cyan(`"${entry2}"`)} which does not exist. Skipping.`);
+                            hasDependsOnError = true;
+                            break;
+                        }
+                        const dependsOnBasePath = join(templateDirectory, dependsOnTarget['template'], 'base.yml');
+                        let dependsOnWorkflowName = '';
+                        try {
+                            const dependsOnBaseContent = await fs.readFile(dependsOnBasePath, 'utf-8');
+                            const dependsOnNameMatch = new RegExp(LIB_REGEX_PATTERN_WORKFLOW_NAME.source, 'm').exec(dependsOnBaseContent);
+                            if (dependsOnNameMatch === null || dependsOnNameMatch[1] === undefined) {
+                                throw new Error('No name field found');
+                            }
+                            const targetSuffix = dependsOnTarget['suffix'];
+                            dependsOnWorkflowName = dependsOnNameMatch[1].replaceAll('[__WORKFLOW_ID__]', (targetSuffix !== undefined) ? ` (${targetSuffix})` : '');
+                        }
+                        catch {
+                            Logger.customize({
+                                name: 'CliGenerateGithubWorkflows.run',
+                                purpose: 'read',
+                            }).error(`Failed to resolve depends-on workflow name for ${chalk.cyan(`"${entry2}"`)}. Skipping.`);
+                            hasDependsOnError = true;
+                            break;
+                        }
+                        dependsOnResolvedNames.push(dependsOnWorkflowName);
+                    }
+                    if (hasDependsOnError === true) {
+                        continue;
+                    }
+                    const dependsOnYamlArray = dependsOnResolvedNames.map((name) => `"${name}"`).join(', ');
+                    for (const triggerData of triggerDataList) {
+                        if (triggerData['dependsOn'] === true) {
+                            const triggerBlockString = JSON.stringify(triggerData['triggerBlock']);
+                            const resolvedTriggerBlock = JSON.parse(triggerBlockString.replaceAll('"[__DEPENDS_ON__]"', dependsOnYamlArray));
+                            Reflect.set(triggerData, 'triggerBlock', resolvedTriggerBlock);
+                        }
+                    }
+                }
+                const mergedTriggerBlock = {};
+                for (const triggerData of triggerDataList) {
+                    for (const triggerEntry of Object.entries(triggerData['triggerBlock'])) {
+                        Reflect.set(mergedTriggerBlock, triggerEntry[0], triggerEntry[1]);
+                    }
+                }
+                const triggerYaml = stringifyYaml(mergedTriggerBlock, {
+                    lineWidth: 0,
+                    defaultKeyType: 'PLAIN',
+                    defaultStringType: 'QUOTE_DOUBLE',
+                });
+                const indentedTriggerLines = triggerYaml.split('\n').map((line) => (line.trim() === '') ? '' : `  ${line}`);
+                const indentedTriggerYaml = indentedTriggerLines.join('\n');
+                const mergedRunName = CliGenerateGithubWorkflows.buildMergedRunName(triggerDataList);
+                const mergedPublishCondition = CliGenerateGithubWorkflows.buildMergedPublishCondition(triggerDataList);
+                const mergedJobsCondition = CliGenerateGithubWorkflows.buildMergedJobsCondition(triggerDataList);
+                const jobsConditionLine = (mergedJobsCondition !== '') ? `    if: "${mergedJobsCondition}"\n` : '';
+                content = content.replace('[__RUN_NAME__]', mergedRunName);
+                content = content.replace('[__TRIGGERS__]', indentedTriggerYaml);
+                content = content.replace('[__PUBLISH_CONDITION__]', mergedPublishCondition);
+                content = content.replace('[__JOBS_CONDITION__]\n', jobsConditionLine);
+            }
+            content = content.replaceAll('[__WORKFLOW_ID__]', (workflowSuffix !== undefined) ? ` (${workflowSuffix})` : '');
+            const substituted = CliGenerateGithubWorkflows.substituteVariables(content, metadataEntry['variables'], entry['settings']);
+            try {
+                parseYaml(substituted);
+            }
+            catch {
+                Logger.customize({
+                    name: 'CliGenerateGithubWorkflows.run',
+                    purpose: 'validate',
+                }).error(`Generated YAML for ${chalk.cyan(`"${outputFileName}"`)} is invalid. Skipping.`);
+                continue;
+            }
+            generatedSet.add(outputFileName);
+            for (const variableEntry of Object.entries(metadataEntry['variables'])) {
+                const variableName = variableEntry[0];
+                const variableMeta = variableEntry[1];
+                if (variableMeta['auto'] === true) {
+                    continue;
+                }
+                if (variableMeta['format'] === 'secret') {
+                    const resolvedName = (entry['settings'] !== undefined && entry['settings'][variableName] !== undefined) ? entry['settings'][variableName] : (variableMeta['default'] ?? variableName);
+                    setupLines.push(` - ${chalk.cyan(outputFileName)}: Secret ${chalk.yellow(resolvedName)}`);
+                }
+                if (variableMeta['format'] === 'var') {
+                    const resolvedName = (entry['settings'] !== undefined && entry['settings'][variableName] !== undefined) ? entry['settings'][variableName] : (variableMeta['default'] ?? variableName);
+                    setupLines.push(` - ${chalk.cyan(outputFileName)}: Variable ${chalk.yellow(resolvedName)}`);
+                }
+            }
+            if (isDryRun === true) {
+                const displayPath = `.github/workflows/${outputFileName}`;
+                Logger.customize({
+                    name: 'CliGenerateGithubWorkflows.run',
+                    purpose: 'dry-run',
+                }).info(`Would generate ${chalk.cyan(`"${displayPath}"`)}.`);
+                continue;
+            }
+            const targetPath = join(workflowsDirectory, outputFileName);
+            await saveGeneratedFile(targetPath, substituted, isReplaceFile);
+        }
+        if (isDryRun !== true && await pathExists(workflowsDirectory) === true) {
+            let existingEntries = [];
+            try {
+                existingEntries = await fs.readdir(workflowsDirectory, { withFileTypes: true });
+            }
+            catch {
+            }
+            for (const existingEntry of existingEntries) {
+                const entry = existingEntry;
+                if (entry.isFile() !== true) {
+                    continue;
+                }
+                const isOrphan = entry.name.startsWith('nova-') === true
+                    && entry.name.endsWith('.yml') === true
+                    && generatedSet.has(entry.name) === false;
+                const isBackup = entry.name.includes('.nova-backup.') === true;
+                if (isOrphan !== true || isBackup === true) {
+                    continue;
+                }
+                const orphanPath = join(workflowsDirectory, entry.name);
+                if (isReplaceFile === true) {
+                    await fs.unlink(orphanPath);
+                    Logger.customize({
+                        name: 'CliGenerateGithubWorkflows.run',
+                        purpose: 'cleanup',
+                    }).info(`Deleted orphan ${chalk.cyan(`"${entry.name}"`)}.`);
+                }
+                else {
+                    await renameFileWithDate(orphanPath);
+                    Logger.customize({
+                        name: 'CliGenerateGithubWorkflows.run',
+                        purpose: 'cleanup',
+                    }).info(`Backed up orphan ${chalk.cyan(`"${entry.name}"`)}.`);
+                }
+            }
+        }
+        if (setupLines.length > 0) {
+            const setupMessage = [
+                'Setup:',
+                setupLines.join('\n'),
+            ].join('\n');
+            Logger.customize({
+                name: 'CliGenerateGithubWorkflows.run',
+                purpose: 'setup',
+                padTop: 1,
+            }).info(setupMessage);
+        }
+        return 'completed';
+    }
+    static buildMergedRunName(triggerDataList) {
+        const contextExpressions = [];
+        for (const triggerData of triggerDataList) {
+            const contextMatch = triggerData['runName'].match(LIB_REGEX_PATTERN_WORKFLOW_CONTEXT_EXPRESSION);
+            if (contextMatch === null) {
+                continue;
+            }
+            const contextInner = contextMatch[1] ?? '';
+            const contextParts = contextInner.split('||').map((part) => part.trim());
+            for (const part of contextParts) {
+                if (part === '\'manually\'' || contextExpressions.includes(part) === true) {
+                    continue;
+                }
+                contextExpressions.push(part);
+            }
+        }
+        const runNameMatch = (triggerDataList[0] ?? { runName: '' })['runName'].match(LIB_REGEX_PATTERN_WORKFLOW_RUN_NAME_CAPTURE);
+        const runNamePrefix = (runNameMatch !== null && runNameMatch[1] !== undefined) ? runNameMatch[1] : '';
+        const runNameSuffix = (runNameMatch !== null && runNameMatch[2] !== undefined) ? runNameMatch[2] : '';
+        const mergedContextExpression = [
+            ...contextExpressions,
+            '\'manually\'',
+        ].join(' || ');
+        return `${runNamePrefix}\${{ ${mergedContextExpression} }}${runNameSuffix}`;
+    }
+    static buildMergedPublishCondition(triggerDataList) {
+        const nonDispatchParts = [];
+        let dispatchPart = '';
+        for (const triggerData of triggerDataList) {
+            const publishInner = triggerData['publishCondition'].replace(LIB_REGEX_PATTERN_WORKFLOW_CONTEXT_WRAPPER_START, '').replace(LIB_REGEX_PATTERN_WORKFLOW_CONTEXT_WRAPPER_END, '');
+            const publishParts = publishInner.split(LIB_REGEX_PATTERN_WORKFLOW_CONTEXT_SEPARATOR);
+            for (const part of publishParts) {
+                if (part.includes('workflow_dispatch') === true) {
+                    if (dispatchPart === '') {
+                        dispatchPart = part;
+                    }
+                    continue;
+                }
+                if (nonDispatchParts.includes(part) === false) {
+                    nonDispatchParts.push(part);
+                }
+            }
+        }
+        const allParts = [...nonDispatchParts];
+        if (dispatchPart !== '') {
+            allParts.push(dispatchPart);
+        }
+        return `\${{ ${allParts.join(' || ')} }}`;
+    }
+    static buildMergedJobsCondition(triggerDataList) {
+        for (const triggerData of triggerDataList) {
+            if (triggerData['jobsCondition'] !== undefined) {
+                const jobsConditionLine = triggerData['jobsCondition'].replace(LIB_REGEX_PATTERN_WORKFLOW_CONTEXT_WRAPPER_START, '').replace(LIB_REGEX_PATTERN_WORKFLOW_CONTEXT_WRAPPER_END, '');
+                return `\${{ ${jobsConditionLine} }}`;
+            }
+        }
+        return '';
+    }
+    static detectCircularDependsOn(workflows) {
+        for (const entry of workflows) {
+            if (entry['depends-on'] === undefined || entry['depends-on'].length === 0) {
+                continue;
+            }
+            const entryKey = (entry['suffix'] !== undefined) ? `${entry['template']}-${entry['suffix']}` : entry['template'];
+            const visited = new Set();
+            visited.add(entryKey);
+            const queue = [...entry['depends-on']];
+            while (queue.length > 0) {
+                const currentId = queue.shift();
+                if (visited.has(currentId) === true) {
+                    return true;
+                }
+                visited.add(currentId);
+                const currentEntry = workflows.find((w) => {
+                    const key = (w['suffix'] !== undefined) ? `${w['template']}-${w['suffix']}` : w['template'];
+                    return key === currentId;
+                });
+                if (currentEntry !== undefined && currentEntry['depends-on'] !== undefined) {
+                    for (const dep of currentEntry['depends-on']) {
+                        queue.push(dep);
+                    }
+                }
+            }
+        }
+        return false;
+    }
+    static substituteVariables(content, variables, settings) {
+        let result = content;
+        for (const variableEntry of Object.entries(variables)) {
+            const variableName = variableEntry[0];
+            const variableMeta = variableEntry[1];
+            const regex = new RegExp(`\\$\\{\\{\\s*(?:secrets|vars)\\.${variableName}\\s*\\}\\}`, 'g');
+            const settingValue = (settings !== undefined && settings[variableName] !== undefined) ? settings[variableName] : undefined;
+            if (variableMeta['format'] === 'secret') {
+                const resolvedName = settingValue
+                    ?? variableMeta['default']
+                    ?? variableName;
+                const replacement = `\${{ secrets.${resolvedName} }}`;
+                result = result.replace(regex, replacement);
+            }
+            if (variableMeta['format'] === 'var') {
+                const resolvedName = settingValue
+                    ?? variableMeta['default']
+                    ?? variableName;
+                const replacement = `\${{ vars.${resolvedName} }}`;
+                result = result.replace(regex, replacement);
+            }
+            if (variableMeta['format'] === 'literal') {
+                const replacement = (settingValue ?? '').replaceAll('\n', '\\n');
+                result = result.replace(regex, replacement);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=workflows.js.map

package/build/src/cli/generate/github/workflows.js.map

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

package/build/src/cli/generate/must-haves/agent-conventions.d.ts

@@ -0,0 +1,5 @@
+import type { CliGenerateMustHavesAgentConventionsRunOptions, CliGenerateMustHavesAgentConventionsRunReturns } from '../../../types/cli/generate/must-haves/agent-conventions.d.ts';
+export declare class CliGenerateMustHavesAgentConventions {
+    static run(options: CliGenerateMustHavesAgentConventionsRunOptions): CliGenerateMustHavesAgentConventionsRunReturns;
+}
+//# sourceMappingURL=agent-conventions.d.ts.map

package/build/src/cli/generate/must-haves/agent-conventions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-conventions.d.ts","sourceRoot":"","sources":["../../../../../src/cli/generate/must-haves/agent-conventions.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EASV,8CAA8C,EAE9C,8CAA8C,EAM/C,MAAM,+DAA+D,CAAC;AAUvE,qBAAa,oCAAoC;WAa3B,GAAG,CAAC,OAAO,EAAE,8CAA8C,GAAG,8CAA8C;CAgIjI"}

package/build/src/cli/generate/must-haves/agent-conventions.js

@@ -0,0 +1,114 @@
+import { promises as fs } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+import { isFileIdentical, isProjectRoot, pathExists, resolveTemplatePath, saveGeneratedFile, } from '../../../lib/utility.js';
+import { Logger } from '../../../toolkit/index.js';
+export class CliGenerateMustHavesAgentConventions {
+    static async run(options) {
+        const currentDirectory = process.cwd();
+        const isAtProjectRoot = await isProjectRoot(currentDirectory);
+        if (isAtProjectRoot !== true) {
+            process.exitCode = 1;
+            return 'cancelled';
+        }
+        const isDryRun = options['dryRun'] === true;
+        const isReplaceFile = options['replaceFile'] === true;
+        if (isDryRun === true) {
+            Logger.customize({
+                name: 'CliGenerateMustHavesAgentConventions.run',
+                purpose: 'options',
+            }).warn('Dry run enabled. File changes will not be made in this session.');
+        }
+        if (isReplaceFile === true) {
+            const replaceFileNotice = (isDryRun === true) ? 'This option has no effect during a dry run session.' : 'Backup file will not be created.';
+            Logger.customize({
+                name: 'CliGenerateMustHavesAgentConventions.run',
+                purpose: 'options',
+            }).warn(`Replace file enabled. ${replaceFileNotice}`);
+        }
+        const templateDirectory = resolveTemplatePath(import.meta.url, 'generators/must-haves/agent-conventions');
+        const rootFiles = [
+            '.cursorrules',
+            'AGENTS.md',
+            'CLAUDE.md',
+            'VISION.md',
+            'PROJECT_RULES.md',
+        ];
+        const userEditedFiles = new Set([
+            'VISION.md',
+            'PROJECT_RULES.md',
+        ]);
+        const conventionFiles = [
+            'csharp.md',
+            'css.md',
+            'docker.md',
+            'documentation.md',
+            'java.md',
+            'kotlin.md',
+            'php.md',
+            'python.md',
+            'shell.md',
+            'swift.md',
+            'typescript.md',
+            'universal.md',
+        ];
+        for (const rootFile of rootFiles) {
+            const templatePath = join(templateDirectory, rootFile);
+            const targetPath = join(currentDirectory, rootFile);
+            if (isDryRun === true) {
+                continue;
+            }
+            try {
+                const content = await fs.readFile(templatePath, 'utf-8');
+                if (userEditedFiles.has(rootFile) === true
+                    && await pathExists(targetPath) === true
+                    && (await isFileIdentical(targetPath, content)) === false) {
+                    Logger.customize({
+                        name: 'CliGenerateMustHavesAgentConventions.run',
+                        purpose: 'skip',
+                    }).warn(`${chalk.cyan(`"${rootFile}"`)} has been customized. Skipping.`);
+                    continue;
+                }
+                await saveGeneratedFile(targetPath, content, isReplaceFile);
+            }
+            catch {
+                Logger.customize({
+                    name: 'CliGenerateMustHavesAgentConventions.run',
+                    purpose: 'error',
+                }).error(`Failed to generate ${chalk.cyan(`"${rootFile}"`)}.`);
+            }
+        }
+        for (const conventionFile of conventionFiles) {
+            const templatePath = join(templateDirectory, 'conventions', conventionFile);
+            const targetPath = join(currentDirectory, 'conventions', conventionFile);
+            const displayPath = `conventions/${conventionFile}`;
+            if (isDryRun === true) {
+                continue;
+            }
+            try {
+                const content = await fs.readFile(templatePath, 'utf-8');
+                await saveGeneratedFile(targetPath, content, isReplaceFile);
+            }
+            catch {
+                Logger.customize({
+                    name: 'CliGenerateMustHavesAgentConventions.run',
+                    purpose: 'error',
+                }).error(`Failed to generate ${chalk.cyan(`"${displayPath}"`)}.`);
+            }
+        }
+        const nextStepsMessage = [
+            `Fill out ${chalk.cyan('VISION.md')} and ${chalk.cyan('PROJECT_RULES.md')} to complete your agent conventions setup.`,
+            '',
+            'For the full workshop guide, visit:',
+            'https://nova.cbnventures.io/docs/cli/generators/must-haves/agent-conventions#vision-and-rules-workshop',
+        ].join('\n');
+        Logger.customize({
+            name: 'CliGenerateMustHavesAgentConventions.run',
+            purpose: 'next-steps',
+            padTop: 1,
+            padBottom: 1,
+        }).info(nextStepsMessage);
+        return 'completed';
+    }
+}
+//# sourceMappingURL=agent-conventions.js.map

package/build/src/cli/generate/must-haves/agent-conventions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-conventions.js","sourceRoot":"","sources":["../../../../../src/cli/generate/must-haves/agent-conventions.ts"],"names":[],"mappings":"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"}

package/build/src/cli/generate/must-haves/dotenv.d.ts

@@ -0,0 +1,12 @@
+import type { CliGenerateMustHavesDotenvRunOptions, CliGenerateMustHavesDotenvRunReturns } from '../../../types/cli/generate/must-haves/dotenv.d.ts';
+export declare class CliGenerateMustHavesDotenv {
+    static run(options: CliGenerateMustHavesDotenvRunOptions): CliGenerateMustHavesDotenvRunReturns;
+    private static promptRegenerate;
+    private static parseEnvFile;
+    private static updateEnvLine;
+    private static deleteEnvLine;
+    private static addEnvLine;
+    private static promptManageMenu;
+    private static promptWithCancel;
+}
+//# sourceMappingURL=dotenv.d.ts.map