@luckydraw/cumulus 0.18.2 → 0.19.0

package/dist/lib/templates.js

@@ -0,0 +1,102 @@
+/**
+ * Template system for project scaffolding.
+ * Creates standard directory structure and initial files from configurable templates.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const CUMULUS_DIR = path.join(os.homedir(), '.cumulus');
+const TEMPLATES_DIR = path.join(CUMULUS_DIR, 'templates');
+// ─── Default templates ───────────────────────────────────────────────────────
+const DEFAULT_TEMPLATES = {
+    default: {
+        scaffold: ['Tasks.md', 'docs/tasks/', 'docs/decisions/'],
+        alwaysInclude: ['Tasks.md'],
+        initialTasks: [],
+    },
+    'web-app': {
+        scaffold: ['Tasks.md', 'docs/tasks/', 'docs/decisions/', 'src/', 'public/'],
+        alwaysInclude: ['Tasks.md', 'README.md'],
+        initialTasks: [],
+    },
+};
+// ─── Default file contents ───────────────────────────────────────────────────
+function defaultTasksMd(projectName) {
+    return `# ${projectName} Tasks\n\n\n`;
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * List available templates (merged from config + defaults).
+ */
+export function listTemplates(configTemplates) {
+    return { ...DEFAULT_TEMPLATES, ...configTemplates };
+}
+/**
+ * Scaffold a project directory from a template.
+ */
+export async function scaffoldFromTemplate(projectPath, templateName, projectName, configTemplates) {
+    const templates = listTemplates(configTemplates);
+    const template = templates[templateName];
+    if (!template) {
+        throw new Error(`Unknown template: "${templateName}". Available: ${Object.keys(templates).join(', ')}`);
+    }
+    // Create directories and files from scaffold list
+    for (const entry of template.scaffold) {
+        const fullPath = path.join(projectPath, entry);
+        if (entry.endsWith('/')) {
+            // Directory
+            fs.mkdirSync(fullPath, { recursive: true });
+        }
+        else {
+            // File — create with default content if it doesn't exist
+            const dir = path.dirname(fullPath);
+            fs.mkdirSync(dir, { recursive: true });
+            if (!fs.existsSync(fullPath)) {
+                const content = getDefaultFileContent(entry, projectName);
+                fs.writeFileSync(fullPath, content);
+            }
+        }
+    }
+    // Copy initial task files from templates dir
+    if (template.initialTasks && template.initialTasks.length > 0) {
+        const tasksDir = path.join(projectPath, 'docs', 'tasks');
+        fs.mkdirSync(tasksDir, { recursive: true });
+        for (const taskId of template.initialTasks) {
+            // Look in ~/.cumulus/templates/tasks/ first, then bundled
+            const sourceFile = findTaskTemplate(taskId);
+            if (sourceFile) {
+                const destFile = path.join(tasksDir, `${taskId}.md`);
+                if (!fs.existsSync(destFile)) {
+                    fs.copyFileSync(sourceFile, destFile);
+                }
+            }
+        }
+    }
+}
+/**
+ * Get alwaysInclude paths for a template.
+ */
+export function getTemplateAlwaysInclude(templateName, configTemplates) {
+    const templates = listTemplates(configTemplates);
+    return templates[templateName]?.alwaysInclude ?? ['Tasks.md'];
+}
+// ─── Internal helpers ────────────────────────────────────────────────────────
+function getDefaultFileContent(filename, projectName) {
+    if (filename === 'Tasks.md')
+        return defaultTasksMd(projectName);
+    if (filename === 'README.md')
+        return `# ${projectName}\n`;
+    return '';
+}
+function findTaskTemplate(taskId) {
+    // Check user templates dir
+    const userPath = path.join(TEMPLATES_DIR, 'tasks', `${taskId}.md`);
+    if (fs.existsSync(userPath))
+        return userPath;
+    // Check global templates (macOS convention)
+    const globalPath = path.join(os.homedir(), 'Documents', '_Projects', '_Global', 'docs', 'tasks', `${taskId}.md`);
+    if (fs.existsSync(globalPath))
+        return globalPath;
+    return null;
+}
+//# sourceMappingURL=templates.js.map

package/dist/lib/templates.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luckydraw/cumulus",
-  "version": "0.18.2",
+  "version": "0.19.0",
   "description": "RLM-based CLI chat wrapper for Claude with external history context management",
   "type": "module",
   "main": "dist/index.js",