@hivehub/rulebook 1.2.0

package/dist/core/logger.js

@@ -0,0 +1,289 @@
+import { writeFile, existsSync, mkdirSync, readdir, unlink } from 'fs';
+import { promisify } from 'util';
+import { join } from 'path';
+const writeFileAsync = promisify(writeFile);
+const readdirAsync = promisify(readdir);
+const unlinkAsync = promisify(unlink);
+const LOGS_DIR = 'openspec/logs';
+const MAX_LOG_AGE_DAYS = 30;
+export class Logger {
+    logsPath;
+    currentLogFile;
+    logBuffer = [];
+    bufferSize = 10;
+    flushInterval = null;
+    constructor(projectRoot) {
+        this.logsPath = join(projectRoot, LOGS_DIR);
+        this.currentLogFile = join(this.logsPath, this.generateLogFileName());
+        this.initializeLogging();
+    }
+    /**
+     * Initialize logging directory and start flush interval
+     */
+    async initializeLogging() {
+        if (!existsSync(this.logsPath)) {
+            mkdirSync(this.logsPath, { recursive: true });
+        }
+        // Start periodic flush
+        this.flushInterval = setInterval(() => {
+            this.flush();
+        }, 5000); // Flush every 5 seconds
+        // Clean old logs on startup
+        await this.cleanOldLogs();
+    }
+    /**
+     * Generate log file name with timestamp
+     */
+    generateLogFileName() {
+        const now = new Date();
+        const timestamp = now.toISOString().replace(/[:.]/g, '-').slice(0, 19);
+        return `agent-${timestamp}.log`;
+    }
+    /**
+     * Log a message
+     */
+    log(level, message, context, taskId, duration) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            context,
+            taskId,
+            duration,
+        };
+        this.logBuffer.push(entry);
+        // Flush if buffer is full
+        if (this.logBuffer.length >= this.bufferSize) {
+            this.flush();
+        }
+    }
+    /**
+     * Log debug message
+     */
+    debug(message, context, taskId) {
+        this.log('debug', message, context, taskId);
+    }
+    /**
+     * Log info message
+     */
+    info(message, context, taskId) {
+        this.log('info', message, context, taskId);
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, context, taskId) {
+        this.log('warn', message, context, taskId);
+    }
+    /**
+     * Log error message
+     */
+    error(message, context, taskId) {
+        this.log('error', message, context, taskId);
+    }
+    /**
+     * Log task start
+     */
+    taskStart(taskId, taskTitle) {
+        this.info(`Task started: ${taskTitle}`, { taskId, action: 'start' }, taskId);
+    }
+    /**
+     * Log task completion
+     */
+    taskComplete(taskId, taskTitle, duration) {
+        this.info(`Task completed: ${taskTitle}`, { taskId, action: 'complete', duration }, taskId);
+    }
+    /**
+     * Log task failure
+     */
+    taskFailed(taskId, taskTitle, error, duration) {
+        this.error(`Task failed: ${taskTitle}`, { taskId, action: 'failed', error, duration }, taskId);
+    }
+    /**
+     * Log CLI command execution
+     */
+    cliCommand(command, tool, taskId) {
+        this.debug(`CLI command: ${command}`, { tool, command }, taskId);
+    }
+    /**
+     * Log CLI response
+     */
+    cliResponse(tool, response, duration, taskId) {
+        this.debug(`CLI response from ${tool}`, { tool, responseLength: response.length, duration }, taskId);
+    }
+    /**
+     * Log test execution
+     */
+    testExecution(testType, result, duration, taskId) {
+        this.info(`Test ${testType}: ${result}`, { testType, result, duration }, taskId);
+    }
+    /**
+     * Log coverage check
+     */
+    coverageCheck(percentage, threshold, taskId) {
+        const status = percentage >= threshold ? 'passed' : 'failed';
+        this.info(`Coverage check: ${status}`, { percentage, threshold, status }, taskId);
+    }
+    /**
+     * Flush log buffer to file
+     */
+    async flush() {
+        if (this.logBuffer.length === 0) {
+            return;
+        }
+        try {
+            const entries = [...this.logBuffer];
+            this.logBuffer = [];
+            const logContent = entries.map((entry) => JSON.stringify(entry)).join('\n') + '\n';
+            await writeFileAsync(this.currentLogFile, logContent, { flag: 'a' });
+        }
+        catch (error) {
+            console.error('Failed to flush logs:', error);
+        }
+    }
+    /**
+     * Force flush and close logger
+     */
+    async close() {
+        if (this.flushInterval) {
+            clearInterval(this.flushInterval);
+            this.flushInterval = null;
+        }
+        await this.flush();
+    }
+    /**
+     * Clean old log files
+     */
+    async cleanOldLogs() {
+        try {
+            const files = await readdirAsync(this.logsPath);
+            const cutoffDate = new Date();
+            cutoffDate.setDate(cutoffDate.getDate() - MAX_LOG_AGE_DAYS);
+            for (const file of files) {
+                if (file.startsWith('agent-') && file.endsWith('.log')) {
+                    const filePath = join(this.logsPath, file);
+                    const stats = await import('fs').then((fs) => fs.promises.stat(filePath));
+                    if (stats.mtime < cutoffDate) {
+                        await unlinkAsync(filePath);
+                        this.info(`Cleaned old log file: ${file}`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            this.error('Failed to clean old logs', { error: String(error) });
+        }
+    }
+    /**
+     * Get recent log entries
+     */
+    async getRecentLogs(limit = 100) {
+        try {
+            const files = await readdirAsync(this.logsPath);
+            const logFiles = files
+                .filter((file) => file.startsWith('agent-') && file.endsWith('.log'))
+                .sort()
+                .reverse(); // Most recent first
+            const entries = [];
+            for (const file of logFiles) {
+                if (entries.length >= limit)
+                    break;
+                const filePath = join(this.logsPath, file);
+                const content = await import('fs').then((fs) => fs.promises.readFile(filePath, 'utf-8'));
+                const lines = content
+                    .trim()
+                    .split('\n')
+                    .filter((line) => line.trim());
+                for (const line of lines) {
+                    if (entries.length >= limit)
+                        break;
+                    try {
+                        const entry = JSON.parse(line);
+                        entries.push(entry);
+                    }
+                    catch {
+                        // Skip malformed entries
+                    }
+                }
+            }
+            return entries.slice(0, limit);
+        }
+        catch (error) {
+            this.error('Failed to get recent logs', { error: String(error) });
+            return [];
+        }
+    }
+    /**
+     * Get logs for specific task
+     */
+    async getTaskLogs(taskId) {
+        const recentLogs = await this.getRecentLogs(1000);
+        return recentLogs.filter((entry) => entry.taskId === taskId);
+    }
+    /**
+     * Get logs by level
+     */
+    async getLogsByLevel(level, limit = 100) {
+        const recentLogs = await this.getRecentLogs(limit * 2);
+        return recentLogs.filter((entry) => entry.level === level).slice(0, limit);
+    }
+    /**
+     * Get error logs
+     */
+    async getErrorLogs(limit = 50) {
+        return this.getLogsByLevel('error', limit);
+    }
+    /**
+     * Generate log summary
+     */
+    async getLogSummary() {
+        const recentLogs = await this.getRecentLogs(1000);
+        const summary = {
+            totalEntries: recentLogs.length,
+            byLevel: {},
+            recentErrors: 0,
+            oldestEntry: undefined,
+            newestEntry: undefined,
+        };
+        for (const entry of recentLogs) {
+            summary.byLevel[entry.level] = (summary.byLevel[entry.level] || 0) + 1;
+            if (entry.level === 'error') {
+                summary.recentErrors++;
+            }
+            if (!summary.oldestEntry || entry.timestamp < summary.oldestEntry) {
+                summary.oldestEntry = entry.timestamp;
+            }
+            if (!summary.newestEntry || entry.timestamp > summary.newestEntry) {
+                summary.newestEntry = entry.timestamp;
+            }
+        }
+        return summary;
+    }
+}
+/**
+ * Create a new Logger instance
+ */
+export function createLogger(projectRoot) {
+    return new Logger(projectRoot);
+}
+/**
+ * Global logger instance
+ */
+let globalLogger = null;
+/**
+ * Initialize global logger
+ */
+export function initializeLogger(projectRoot) {
+    globalLogger = new Logger(projectRoot);
+    return globalLogger;
+}
+/**
+ * Get global logger instance
+ */
+export function getLogger() {
+    if (!globalLogger) {
+        throw new Error('Logger not initialized. Call initializeLogger() first.');
+    }
+    return globalLogger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

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

package/dist/core/merger.d.ts

@@ -0,0 +1,6 @@
+import type { ExistingAgentsInfo, ProjectConfig } from '../types.js';
+export declare function mergeAgents(existing: ExistingAgentsInfo, config: ProjectConfig): Promise<string>;
+export declare function mergeLanguageRules(existing: ExistingAgentsInfo, language: string): Promise<string>;
+export declare function mergeModuleRules(existing: ExistingAgentsInfo, module: string): Promise<string>;
+export declare function mergeFullAgents(existing: ExistingAgentsInfo, config: ProjectConfig, projectRoot?: string): Promise<string>;
+//# sourceMappingURL=merger.d.ts.map

package/dist/core/merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merger.d.ts","sourceRoot":"","sources":["../../src/core/merger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAc,MAAM,aAAa,CAAC;AAQjF,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,aAAa,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CA0DjB"}

package/dist/core/merger.js

@@ -0,0 +1,131 @@
+import { generateAgentsContent, generateLanguageRules, generateModuleRules } from './generator.js';
+import { hasEmbeddedTemplates, migrateEmbeddedTemplates, replaceEmbeddedWithReferences, } from './migrator.js';
+export async function mergeAgents(existing, config) {
+    const lines = existing.content.split('\n');
+    const rulebookBlock = existing.blocks.find((b) => b.name === 'RULEBOOK');
+    // Generate new RULEBOOK content
+    const newRulebookContent = await generateAgentsContent(config);
+    if (rulebookBlock) {
+        // Replace existing RULEBOOK block
+        const beforeBlock = lines.slice(0, rulebookBlock.startLine).join('\n');
+        const afterBlock = lines.slice(rulebookBlock.endLine + 1).join('\n');
+        return [beforeBlock, newRulebookContent, afterBlock].join('\n').trim() + '\n';
+    }
+    else {
+        // Insert RULEBOOK at the beginning
+        return [newRulebookContent, '', existing.content].join('\n').trim() + '\n';
+    }
+}
+export async function mergeLanguageRules(existing, language) {
+    const lines = existing.content.split('\n');
+    const blockName = language.toUpperCase();
+    const languageBlock = existing.blocks.find((b) => b.name === blockName);
+    const newLanguageContent = await generateLanguageRules(language);
+    if (languageBlock) {
+        // Replace existing language block
+        const beforeBlock = lines.slice(0, languageBlock.startLine).join('\n');
+        const afterBlock = lines.slice(languageBlock.endLine + 1).join('\n');
+        return [beforeBlock, newLanguageContent, afterBlock].join('\n').trim() + '\n';
+    }
+    else {
+        // Append language block at the end
+        return [existing.content, '', newLanguageContent].join('\n').trim() + '\n';
+    }
+}
+export async function mergeModuleRules(existing, module) {
+    const lines = existing.content.split('\n');
+    const blockName = module.toUpperCase();
+    const moduleBlock = existing.blocks.find((b) => b.name === blockName);
+    const newModuleContent = await generateModuleRules(module);
+    if (moduleBlock) {
+        // Replace existing module block
+        const beforeBlock = lines.slice(0, moduleBlock.startLine).join('\n');
+        const afterBlock = lines.slice(moduleBlock.endLine + 1).join('\n');
+        return [beforeBlock, newModuleContent, afterBlock].join('\n').trim() + '\n';
+    }
+    else {
+        // Append module block at the end
+        return [existing.content, '', newModuleContent].join('\n').trim() + '\n';
+    }
+}
+export async function mergeFullAgents(existing, config, projectRoot) {
+    // Check if we need to migrate from embedded to modular
+    const needsMigration = hasEmbeddedTemplates(existing) && config.modular !== false;
+    if (needsMigration && projectRoot) {
+        // Migrate embedded templates to /rulebook/ directory
+        await migrateEmbeddedTemplates(existing, config, projectRoot);
+        // Generate new modular AGENTS.md with references
+        // This replaces the entire content with modular format
+        return await replaceEmbeddedWithReferences(config, projectRoot);
+    }
+    // Legacy merge behavior (for non-modular mode or when migration not needed)
+    let content = existing.content;
+    let currentExisting = { ...existing };
+    // Merge RULEBOOK section
+    content = await mergeAgents(currentExisting, config);
+    // Update existing info for next merge
+    currentExisting = {
+        ...currentExisting,
+        content,
+        blocks: parseBlocks(content),
+    };
+    // If modular mode, use generateModularAgents instead of merging blocks
+    if (config.modular !== false && projectRoot) {
+        const { generateModularAgents } = await import('./generator.js');
+        return await generateModularAgents(config, projectRoot);
+    }
+    // Legacy: Merge language rules (embedded)
+    for (const language of config.languages) {
+        content = await mergeLanguageRules(currentExisting, language);
+        // Update existing info for next merge
+        currentExisting = {
+            ...currentExisting,
+            content,
+            blocks: parseBlocks(content),
+        };
+    }
+    // Legacy: Merge module rules (embedded)
+    for (const module of config.modules) {
+        content = await mergeModuleRules(currentExisting, module);
+        // Update existing info for next merge
+        currentExisting = {
+            ...currentExisting,
+            content,
+            blocks: parseBlocks(content),
+        };
+    }
+    return content;
+}
+// Helper function to parse blocks
+function parseBlocks(content) {
+    const blocks = [];
+    const lines = content.split('\n');
+    let currentBlock = null;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const startMatch = line.match(/<!--\s*([A-Z_]+):START\s*-->/);
+        const endMatch = line.match(/<!--\s*([A-Z_]+):END\s*-->/);
+        if (startMatch) {
+            currentBlock = {
+                name: startMatch[1],
+                startLine: i,
+                content: [line],
+            };
+        }
+        else if (endMatch && currentBlock) {
+            currentBlock.content.push(line);
+            blocks.push({
+                name: currentBlock.name,
+                startLine: currentBlock.startLine,
+                endLine: i,
+                content: currentBlock.content.join('\n'),
+            });
+            currentBlock = null;
+        }
+        else if (currentBlock) {
+            currentBlock.content.push(line);
+        }
+    }
+    return blocks;
+}
+//# sourceMappingURL=merger.js.map

package/dist/core/merger.js.map

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

package/dist/core/migrator.d.ts

@@ -0,0 +1,19 @@
+import type { ExistingAgentsInfo, ProjectConfig } from '../types.js';
+/**
+ * Detect if AGENTS.md contains embedded templates (legacy mode)
+ */
+export declare function hasEmbeddedTemplates(existing: ExistingAgentsInfo): boolean;
+/**
+ * Extract embedded template content and write to /rulebook/ directory
+ */
+export declare function migrateEmbeddedTemplates(existing: ExistingAgentsInfo, config: ProjectConfig, projectRoot: string): Promise<{
+    extractedLanguages: string[];
+    extractedModules: string[];
+    extractedFrameworks: string[];
+}>;
+/**
+ * Replace embedded templates with references in AGENTS.md
+ * Uses generateModularAgents to ensure consistent format
+ */
+export declare function replaceEmbeddedWithReferences(config: ProjectConfig, projectRoot: string): Promise<string>;
+//# sourceMappingURL=migrator.d.ts.map

package/dist/core/migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../../src/core/migrator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQrE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAoB1E;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IACT,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC,CA4ED;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/core/migrator.js

@@ -0,0 +1,102 @@
+import path from 'path';
+import { writeFile, ensureDir } from '../utils/file-system.js';
+import { generateLanguageRules, generateModuleRules, generateFrameworkRules, generateModularAgents, } from './generator.js';
+/**
+ * Detect if AGENTS.md contains embedded templates (legacy mode)
+ */
+export function hasEmbeddedTemplates(existing) {
+    if (!existing.content)
+        return false;
+    // Check for embedded language blocks (e.g., <!-- TYPESCRIPT:START -->)
+    const embeddedLanguagePattern = /<!--\s*(TYPESCRIPT|RUST|PYTHON|JAVASCRIPT|GO|JAVA|ELIXIR|CSHARP|PHP|SWIFT|KOTLIN|CPP|C|SOLIDITY|ZIG|ERLANG|DART|RUBY|SCALA|R|HASKELL|JULIA|LUA|ADA|SAS|LISP|OBJECTIVEC|SQL):START\s*-->/i;
+    // Check for embedded module blocks (e.g., <!-- OPENSPEC:START -->)
+    const embeddedModulePattern = /<!--\s*(VECTORIZER|SYNAP|CONTEXT7|GITHUB|PLAYWRIGHT|SUPABASE|NOTION|ATLASSIAN|SERENA|FIGMA|GRAFANA|AGENT_AUTOMATION):START\s*-->/i;
+    // Check for embedded framework blocks (e.g., <!-- REACT:START -->)
+    const embeddedFrameworkPattern = /<!--\s*(NESTJS|SPRING|LARAVEL|ANGULAR|REACT|VUE|NUXT|NEXTJS|DJANGO|RAILS|FLASK|SYMFONY|ZEND|JQUERY|REACTNATIVE|FLUTTER|ELECTRON):START\s*-->/i;
+    return (embeddedLanguagePattern.test(existing.content) ||
+        embeddedModulePattern.test(existing.content) ||
+        embeddedFrameworkPattern.test(existing.content));
+}
+/**
+ * Extract embedded template content and write to /rulebook/ directory
+ */
+export async function migrateEmbeddedTemplates(existing, config, projectRoot) {
+    const rulebookDir = config.rulebookDir || 'rulebook';
+    const rulebookPath = path.join(projectRoot, rulebookDir);
+    await ensureDir(rulebookPath);
+    // Note: If files already exist, they will be overwritten
+    // This is intentional for migration - existing modular files take precedence
+    const extractedLanguages = [];
+    const extractedModules = [];
+    const extractedFrameworks = [];
+    if (!existing.content) {
+        return { extractedLanguages, extractedModules, extractedFrameworks };
+    }
+    // Extract language blocks
+    for (const language of config.languages) {
+        const blockName = language.toUpperCase();
+        const languageBlock = existing.blocks.find((b) => b.name === blockName);
+        if (languageBlock && languageBlock.content) {
+            // Write extracted content to /rulebook/[LANG].md
+            const filePath = path.join(rulebookPath, `${blockName}.md`);
+            await writeFile(filePath, languageBlock.content);
+            extractedLanguages.push(language);
+        }
+        else {
+            // Generate new template if not found
+            const langRules = await generateLanguageRules(language);
+            const filePath = path.join(rulebookPath, `${blockName}.md`);
+            await writeFile(filePath, langRules);
+            extractedLanguages.push(language);
+        }
+    }
+    // Extract module blocks
+    for (const module of config.modules) {
+        const blockName = module.toUpperCase();
+        const moduleBlock = existing.blocks.find((b) => b.name === blockName);
+        if (moduleBlock && moduleBlock.content) {
+            // Write extracted content to /rulebook/[MODULE].md
+            const filePath = path.join(rulebookPath, `${blockName}.md`);
+            await writeFile(filePath, moduleBlock.content);
+            extractedModules.push(module);
+        }
+        else {
+            // Generate new template if not found
+            const moduleRules = await generateModuleRules(module);
+            const filePath = path.join(rulebookPath, `${blockName}.md`);
+            await writeFile(filePath, moduleRules);
+            extractedModules.push(module);
+        }
+    }
+    // Extract framework blocks
+    if (config.frameworks) {
+        for (const framework of config.frameworks) {
+            const blockName = framework.toUpperCase();
+            const frameworkBlock = existing.blocks.find((b) => b.name === blockName);
+            if (frameworkBlock && frameworkBlock.content) {
+                // Write extracted content to /rulebook/[FRAMEWORK].md
+                const filePath = path.join(rulebookPath, `${blockName}.md`);
+                await writeFile(filePath, frameworkBlock.content);
+                extractedFrameworks.push(framework);
+            }
+            else {
+                // Generate new template if not found
+                const frameworkRules = await generateFrameworkRules(framework);
+                const filePath = path.join(rulebookPath, `${blockName}.md`);
+                await writeFile(filePath, frameworkRules);
+                extractedFrameworks.push(framework);
+            }
+        }
+    }
+    return { extractedLanguages, extractedModules, extractedFrameworks };
+}
+/**
+ * Replace embedded templates with references in AGENTS.md
+ * Uses generateModularAgents to ensure consistent format
+ */
+export async function replaceEmbeddedWithReferences(config, projectRoot) {
+    // Use generateModularAgents to get the proper format with references
+    // This ensures consistency and handles all the reference generation
+    return await generateModularAgents(config, projectRoot);
+}
+//# sourceMappingURL=migrator.js.map

package/dist/core/migrator.js.map

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

package/dist/core/minimal-scaffolder.d.ts

@@ -0,0 +1,8 @@
+interface MinimalScaffoldOptions {
+    projectName?: string;
+    description?: string;
+    license?: string;
+}
+export declare function scaffoldMinimalProject(projectDir: string, options?: MinimalScaffoldOptions): Promise<string[]>;
+export {};
+//# sourceMappingURL=minimal-scaffolder.d.ts.map

package/dist/core/minimal-scaffolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimal-scaffolder.d.ts","sourceRoot":"","sources":["../../src/core/minimal-scaffolder.ts"],"names":[],"mappings":"AAIA,UAAU,sBAAsB;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,EAAE,CAAC,CAwDnB"}

package/dist/core/minimal-scaffolder.js

@@ -0,0 +1,51 @@
+import path from 'path';
+import { ensureDir, fileExists, writeFile } from '../utils/file-system.js';
+import { generateDocsStructure } from './docs-generator.js';
+export async function scaffoldMinimalProject(projectDir, options = {}) {
+    const generated = [];
+    const projectName = options.projectName || path.basename(projectDir);
+    const description = options.description || `${projectName} project bootstrapped with Rulebook minimal mode.`;
+    const licenseName = options.license || 'MIT';
+    // Generate concise docs structure and root README (minimal mode)
+    const docsFiles = await generateDocsStructure({
+        projectName,
+        description,
+        author: 'Project Team',
+        license: licenseName,
+    }, projectDir, 'minimal');
+    generated.push(...docsFiles);
+    // Ensure LICENSE exists (Apache-2.0 by default)
+    const licensePath = path.join(projectDir, 'LICENSE');
+    if (!(await fileExists(licensePath))) {
+        const licenseContent = `Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright ${new Date().getFullYear()} ${projectName}
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+`;
+        await writeFile(licensePath, licenseContent);
+        generated.push(licensePath);
+    }
+    // Ensure tests directory exists with placeholder
+    const testsDir = path.join(projectDir, 'tests');
+    await ensureDir(testsDir);
+    const placeholderTest = path.join(testsDir, '.gitkeep');
+    if (!(await fileExists(placeholderTest))) {
+        await writeFile(placeholderTest, '');
+        generated.push(placeholderTest);
+    }
+    return Array.from(new Set(generated));
+}
+//# sourceMappingURL=minimal-scaffolder.js.map