@loom-framework/core 0.1.0-alpha.13 → 0.1.0-alpha.131

package/dist/cli/commands/skill.js

@@ -0,0 +1,186 @@
+/**
+ * loom skill - Skill management commands
+ *
+ * loom skill list           - Scan .claude/skills/ directory, list all skills
+ * loom skill validate [name] - Validate SKILL.md frontmatter and references
+ */
+import chalk from 'chalk';
+import { promises as fs } from 'fs';
+import path from 'path';
+import { resolveProjectRoot } from '../utils.js';
+export function registerSkillCommand(program) {
+    const skill = program
+        .command('skill')
+        .description('Skill management commands');
+    // loom skill list
+    skill
+        .command('list')
+        .description('List all skills in the project')
+        .action(async () => {
+        try {
+            const projectRoot = await resolveProjectRoot();
+            const skillsDir = path.join(projectRoot, '.claude', 'skills');
+            let entries;
+            try {
+                entries = await fs.readdir(skillsDir);
+            }
+            catch {
+                console.log(chalk.yellow('No skills directory found.'));
+                console.log(chalk.dim('  Run `loom generate skill <name>` to create one.'));
+                return;
+            }
+            const skillDirs = entries.filter(async (entry) => {
+                const stat = await fs.stat(path.join(skillsDir, entry));
+                return stat.isDirectory();
+            });
+            const validSkillDirs = [];
+            for (const entry of entries) {
+                const entryPath = path.join(skillsDir, entry);
+                try {
+                    const stat = await fs.stat(entryPath);
+                    if (stat.isDirectory()) {
+                        validSkillDirs.push(entry);
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+            if (validSkillDirs.length === 0) {
+                console.log(chalk.yellow('No skills found.'));
+                console.log(chalk.dim('  Run `loom generate skill <name>` to create one.'));
+                return;
+            }
+            console.log(chalk.bold(`Skills (${validSkillDirs.length}):`));
+            console.log();
+            for (const dirName of validSkillDirs) {
+                const skillMdPath = path.join(skillsDir, dirName, 'SKILL.md');
+                let hasSkillMd = false;
+                try {
+                    await fs.access(skillMdPath);
+                    hasSkillMd = true;
+                }
+                catch {
+                    // No SKILL.md
+                }
+                const marker = hasSkillMd ? chalk.green('✓') : chalk.red('✗');
+                console.log(`  ${marker} ${chalk.cyan(dirName)}`);
+                if (!hasSkillMd) {
+                    console.log(chalk.dim(`      Missing SKILL.md`));
+                }
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red('Failed to list skills:'), message);
+            process.exit(1);
+        }
+    });
+    // loom skill validate [name]
+    skill
+        .command('validate [name]')
+        .description('Validate skill SKILL.md frontmatter and references')
+        .action(async (name) => {
+        try {
+            const projectRoot = await resolveProjectRoot();
+            const skillsDir = path.join(projectRoot, '.claude', 'skills');
+            if (name) {
+                // Validate specific skill
+                await validateSkill(skillsDir, name);
+            }
+            else {
+                // Validate all skills
+                let entries;
+                try {
+                    entries = await fs.readdir(skillsDir);
+                }
+                catch {
+                    console.log(chalk.yellow('No skills directory found.'));
+                    return;
+                }
+                const dirs = [];
+                for (const entry of entries) {
+                    try {
+                        const stat = await fs.stat(path.join(skillsDir, entry));
+                        if (stat.isDirectory())
+                            dirs.push(entry);
+                    }
+                    catch {
+                        continue;
+                    }
+                }
+                if (dirs.length === 0) {
+                    console.log(chalk.yellow('No skills to validate.'));
+                    return;
+                }
+                let allValid = true;
+                for (const dir of dirs) {
+                    const valid = await validateSkill(skillsDir, dir);
+                    if (!valid)
+                        allValid = false;
+                }
+                if (!allValid) {
+                    process.exit(1);
+                }
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red('Validation failed:'), message);
+            process.exit(1);
+        }
+    });
+}
+/**
+ * Validate a single skill directory
+ */
+async function validateSkill(skillsDir, name) {
+    const skillDir = path.join(skillsDir, name);
+    const errors = [];
+    // Check SKILL.md exists
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    try {
+        const content = await fs.readFile(skillMdPath, 'utf-8');
+        // Check frontmatter exists
+        if (!content.startsWith('---')) {
+            errors.push('SKILL.md is missing frontmatter (must start with ---)');
+        }
+        else {
+            const frontmatterEnd = content.indexOf('---', 3);
+            if (frontmatterEnd === -1) {
+                errors.push('SKILL.md has unclosed frontmatter');
+            }
+            else {
+                const frontmatter = content.slice(3, frontmatterEnd).trim();
+                // Check for required frontmatter fields
+                if (!frontmatter.includes('name:')) {
+                    errors.push('SKILL.md frontmatter missing "name" field');
+                }
+                if (!frontmatter.includes('version:')) {
+                    errors.push('SKILL.md frontmatter missing "version" field');
+                }
+            }
+        }
+    }
+    catch {
+        errors.push('SKILL.md not found');
+    }
+    // Check references/ directory exists
+    const referencesDir = path.join(skillDir, 'references');
+    try {
+        await fs.access(referencesDir);
+    }
+    catch {
+        errors.push('references/ directory not found');
+    }
+    if (errors.length > 0) {
+        console.log(chalk.red(`  ✗ ${name}`));
+        for (const error of errors) {
+            console.log(chalk.dim(`      - ${error}`));
+        }
+        return false;
+    }
+    console.log(chalk.green(`  ✓ ${name}`));
+    return true;
+}
+//# sourceMappingURL=skill.js.map

package/dist/cli/commands/skill.js.map

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

package/dist/cli/generators/capability-generator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Capability Generator
+ *
+ * Core innovation: One schema definition → Skill + CLI data access
+ *
+ * From loom.config.ts model definitions, generates:
+ * 1. SKILL.md — guided instructions for AI to write natural language (only on first run, never overwritten)
+ * 2. references/models.md — auto-generated structural content (always overwritten on generate)
+ * 3. references/data-semantics.md — AI-driven semantic guidance (always overwritten on generate)
+ *
+ * Template files live in builtin-skills/app-skill/ — static content is defined there,
+ * dynamic content (model tables, AI buttons) is filled in by code.
+ */
+import type { LoomConfig } from '../../types.js';
+export interface GenerateResult {
+    /** Path to the generated skill directory */
+    skillDir: string;
+    /** Path to the SKILL.md file */
+    skillPromptFile: string;
+    /** Path to the references/models.md file */
+    modelsFile: string;
+    /** Path to the references/data-semantics.md file */
+    dataSemanticsFile: string;
+    filesWritten: string[];
+}
+/**
+ * Generate all capabilities from config.
+ *
+ * Three-file strategy:
+ * - SKILL.md: natural language content (only created if not exists, never overwritten)
+ * - references/models.md: structural content (always regenerated)
+ * - references/data-semantics.md: semantic guidance (always regenerated)
+ */
+export declare function generateCapabilities(projectRoot: string, config: LoomConfig): Promise<GenerateResult>;
+//# sourceMappingURL=capability-generator.d.ts.map

package/dist/cli/generators/capability-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-generator.d.ts","sourceRoot":"","sources":["../../../src/cli/generators/capability-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAe,UAAU,EAAmB,MAAM,gBAAgB,CAAC;AA2D/E,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,cAAc,CAAC,CA+CzB"}

package/dist/cli/generators/capability-generator.js

@@ -0,0 +1,115 @@
+/**
+ * Capability Generator
+ *
+ * Core innovation: One schema definition → Skill + CLI data access
+ *
+ * From loom.config.ts model definitions, generates:
+ * 1. SKILL.md — guided instructions for AI to write natural language (only on first run, never overwritten)
+ * 2. references/models.md — auto-generated structural content (always overwritten on generate)
+ * 3. references/data-semantics.md — AI-driven semantic guidance (always overwritten on generate)
+ *
+ * Template files live in builtin-skills/app-skill/ — static content is defined there,
+ * dynamic content (model tables, AI buttons) is filled in by code.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// From dist/ → go up to package root → builtin-skills/app-skill/
+const TEMPLATES_DIR = path.resolve(__dirname, '../../../builtin-skills/app-skill');
+// ── Template Loading ──
+async function loadTemplate(relativePath) {
+    return fs.readFile(path.join(TEMPLATES_DIR, relativePath), 'utf-8');
+}
+// ── Dynamic Content Builders ──
+/**
+ * Build a markdown table row for a model field
+ */
+function fieldTableRow(f) {
+    const req = f.required ? 'yes' : 'no';
+    const enums = f.enum ? ` (${f.enum.join('/')})` : '';
+    const def = f.default !== undefined ? ` [default: ${JSON.stringify(f.default)}]` : '';
+    const desc = (f.description || '') + enums + def;
+    return `| ${f.name} | ${f.type} | ${req} | ${desc} |`;
+}
+/**
+ * Build the Data Models section content
+ */
+function buildDataModelsSection(models) {
+    return models.map(model => {
+        const header = `### ${model.name}${model.description ? ` — ${model.description}` : ''}`;
+        const tableHeader = '| Field | Type | Required | Description |';
+        const tableSep = '|-------|------|----------|-------------|';
+        const tableRows = model.fields.map(fieldTableRow).join('\n');
+        return `${header}\n\n${tableHeader}\n${tableSep}\n${tableRows}`;
+    }).join('\n\n');
+}
+/**
+ * Build the AI Buttons section content (or empty string if none)
+ */
+function buildAiButtonsSection(aiButtons) {
+    if (!aiButtons || aiButtons.length === 0)
+        return '';
+    return `## AI Buttons\n\n${aiButtons.map(btn => {
+        const placement = btn.placement ? ` (available on: ${btn.placement})` : ' (available on all pages)';
+        return `- **${btn.id}** ("${btn.label}"): \`${btn.prompt}\`${placement}`;
+    }).join('\n')}`;
+}
+/**
+ * Build the model names line for data-semantics.md (or empty string if only one model)
+ */
+function buildModelNamesLine(models) {
+    if (models.length <= 1)
+        return '';
+    return `\nModels in this project: ${models.map(m => `\`${m.name}\``).join(', ')}.`;
+}
+/**
+ * Generate all capabilities from config.
+ *
+ * Three-file strategy:
+ * - SKILL.md: natural language content (only created if not exists, never overwritten)
+ * - references/models.md: structural content (always regenerated)
+ * - references/data-semantics.md: semantic guidance (always regenerated)
+ */
+export async function generateCapabilities(projectRoot, config) {
+    const projectName = config.project.name;
+    const models = config.data.models;
+    const skillDir = path.join(projectRoot, '.claude', 'skills', projectName);
+    const skillPromptFile = path.join(skillDir, 'SKILL.md');
+    const referencesDir = path.join(skillDir, 'references');
+    const modelsFile = path.join(referencesDir, 'models.md');
+    const dataSemanticsFile = path.join(referencesDir, 'data-semantics.md');
+    const filesWritten = [];
+    // Create skill directory structure
+    await fs.mkdir(referencesDir, { recursive: true });
+    // Load templates in parallel
+    const [skillTemplate, modelsTemplate, semanticsTemplate] = await Promise.all([
+        loadTemplate('SKILL.md'),
+        loadTemplate('references/models.md'),
+        loadTemplate('references/data-semantics.md'),
+    ]);
+    // SKILL.md: apply variable substitution, only write if not exists
+    const skillExists = await fs.access(skillPromptFile).then(() => true, () => false);
+    if (!skillExists) {
+        const skillContent = skillTemplate
+            .replace(/\{\{projectName\}\}/g, projectName);
+        await fs.writeFile(skillPromptFile, skillContent, 'utf-8');
+        filesWritten.push(skillPromptFile);
+    }
+    // references/models.md: fill dynamic sections into template
+    const dataModelsSection = buildDataModelsSection(models);
+    const aiButtonsSection = buildAiButtonsSection(config.aiButtons);
+    const modelsContent = modelsTemplate
+        .replace('<!-- DATA_MODELS -->', dataModelsSection)
+        .replace('<!-- AI_BUTTONS -->', aiButtonsSection ? '\n' + aiButtonsSection + '\n' : '');
+    await fs.writeFile(modelsFile, modelsContent, 'utf-8');
+    filesWritten.push(modelsFile);
+    // references/data-semantics.md: fill model names line into template
+    const modelNamesLine = buildModelNamesLine(models);
+    const semanticsContent = semanticsTemplate
+        .replace('<!-- MODEL_NAMES -->', modelNamesLine);
+    await fs.writeFile(dataSemanticsFile, semanticsContent, 'utf-8');
+    filesWritten.push(dataSemanticsFile);
+    return { skillDir, skillPromptFile, modelsFile, dataSemanticsFile, filesWritten };
+}
+//# sourceMappingURL=capability-generator.js.map

package/dist/cli/generators/capability-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-generator.js","sourceRoot":"","sources":["../../../src/cli/generators/capability-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAGpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,iEAAiE;AACjE,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,mCAAmC,CAAC,CAAC;AAEnF,yBAAyB;AAEzB,KAAK,UAAU,YAAY,CAAC,YAAoB;IAC9C,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,iCAAiC;AAEjC;;GAEG;AACH,SAAS,aAAa,CAAC,CAAkB;IACvC,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC;IACjD,OAAO,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,MAAqB;IACnD,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QACxB,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACxF,MAAM,WAAW,GAAG,2CAA2C,CAAC;QAChE,MAAM,QAAQ,GAAG,2CAA2C,CAAC;QAC7D,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,GAAG,MAAM,OAAO,WAAW,KAAK,QAAQ,KAAK,SAAS,EAAE,CAAC;IAClE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,SAAkC;IAC/D,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpD,OAAO,oBAAoB,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAC7C,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,2BAA2B,CAAC;QACpG,OAAO,OAAO,GAAG,CAAC,EAAE,QAAQ,GAAG,CAAC,KAAK,SAAS,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,MAAqB;IAChD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,6BAA6B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACrF,CAAC;AAgBD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,MAAkB;IAElB,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;IAElC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC1E,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACzD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;IACxE,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,mCAAmC;IACnC,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEnD,6BAA6B;IAC7B,MAAM,CAAC,aAAa,EAAE,cAAc,EAAE,iBAAiB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3E,YAAY,CAAC,UAAU,CAAC;QACxB,YAAY,CAAC,sBAAsB,CAAC;QACpC,YAAY,CAAC,8BAA8B,CAAC;KAC7C,CAAC,CAAC;IAEH,kEAAkE;IAClE,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IACnF,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,YAAY,GAAG,aAAa;aAC/B,OAAO,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC;QAChD,MAAM,EAAE,CAAC,SAAS,CAAC,eAAe,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QAC3D,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACrC,CAAC;IAED,4DAA4D;IAC5D,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,gBAAgB,GAAG,qBAAqB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,aAAa,GAAG,cAAc;SACjC,OAAO,CAAC,sBAAsB,EAAE,iBAAiB,CAAC;SAClD,OAAO,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,GAAG,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1F,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IACvD,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE9B,oEAAoE;IACpE,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,iBAAiB;SACvC,OAAO,CAAC,sBAAsB,EAAE,cAAc,CAAC,CAAC;IACnD,MAAM,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACjE,YAAY,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAErC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC;AACpF,CAAC"}

package/dist/cli/helpers/app-tsx-wiring.d.ts

@@ -0,0 +1,21 @@
+/**
+ * App.tsx wiring utilities - shared between generate-page and generate-dashboard
+ *
+ * Surgically modifies App.tsx to add imports, navItems, and switch cases.
+ * Nav labels use t() calls, so i18n keys are registered via registerMessages.
+ */
+/**
+ * Auto-wire App.tsx: add import, navItem, and switch case for a new page.
+ * Returns true if successful, false if App.tsx structure is unexpected.
+ */
+export declare function wireAppTsxAutomatic(projectRoot: string, pascalName: string, navKey: string, navLabel: string, options?: {
+    insertAtTop?: boolean;
+    navLabelEn?: string;
+}): Promise<boolean>;
+/**
+ * Auto-wire the SkillManagementPage into App.tsx.
+ * Called once when the first CRUD page is generated.
+ * Returns true if successful, false if already wired or structure is unexpected.
+ */
+export declare function wireSkillManagementPage(projectRoot: string): Promise<boolean>;
+//# sourceMappingURL=app-tsx-wiring.d.ts.map

package/dist/cli/helpers/app-tsx-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-tsx-wiring.d.ts","sourceRoot":"","sources":["../../../src/cli/helpers/app-tsx-wiring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,OAAO,CAAC,CAyHlB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwDnF"}

package/dist/cli/helpers/app-tsx-wiring.js

@@ -0,0 +1,187 @@
+/**
+ * App.tsx wiring utilities - shared between generate-page and generate-dashboard
+ *
+ * Surgically modifies App.tsx to add imports, navItems, and switch cases.
+ * Nav labels use t() calls, so i18n keys are registered via registerMessages.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+/**
+ * Auto-wire App.tsx: add import, navItem, and switch case for a new page.
+ * Returns true if successful, false if App.tsx structure is unexpected.
+ */
+export async function wireAppTsxAutomatic(projectRoot, pascalName, navKey, navLabel, options) {
+    const appPath = path.join(projectRoot, 'frontend', 'src', 'App.tsx');
+    let content;
+    try {
+        content = await fs.readFile(appPath, 'utf-8');
+    }
+    catch {
+        return false;
+    }
+    // Check if this page is already wired (avoid duplicates)
+    if (content.includes(`from './components/pages/${pascalName}'`) || content.includes(`<${pascalName}Page`)) {
+        return false;
+    }
+    // Also check if navItem with same key already exists
+    if (content.includes(`key: '${navKey}'`)) {
+        return false;
+    }
+    let modified = content;
+    // 1. Add import after the last import line
+    const importLine = `import ${pascalName}Page from './components/pages/${pascalName}';`;
+    const lastImportEnd = modified.lastIndexOf('\n', modified.indexOf('\nexport'));
+    if (lastImportEnd === -1)
+        return false;
+    modified = modified.slice(0, lastImportEnd + 1) + importLine + '\n' + modified.slice(lastImportEnd + 1);
+    // 1b. Ensure registerMessages is imported from frontend-antd
+    if (!modified.includes('registerMessages')) {
+        modified = modified.replace(/\}\s*from\s*'@loom-framework\/frontend-antd';/, ", registerMessages } from '@loom-framework/frontend-antd';");
+    }
+    // 1c. Register nav i18n keys
+    const navLabelEn = options?.navLabelEn || navLabel;
+    const registerLine = `registerMessages('zh-CN', { 'nav.${navKey}': '${navLabel}' });\nregisterMessages('en-US', { 'nav.${navKey}': '${navLabelEn}' });`;
+    // Insert registerMessages calls after the last import line
+    const afterImports = modified.indexOf('\nexport') !== -1
+        ? modified.lastIndexOf('\n', modified.indexOf('\nexport'))
+        : lastImportEnd;
+    modified = modified.slice(0, afterImports + 1) + registerLine + '\n' + modified.slice(afterImports + 1);
+    // 2. Add navItem
+    const navItemLine = `  { key: '${navKey}', label: t('nav.${navKey}') },`;
+    if (options?.insertAtTop) {
+        // Insert at the beginning of the navItems array (Dashboard first)
+        const navArrayMatch = modified.match(/const navItems\s*=\s*\[\n*/);
+        if (!navArrayMatch)
+            return false;
+        const insertPos = navArrayMatch.index + navArrayMatch[0].length;
+        modified = modified.slice(0, insertPos) + navItemLine + '\n' + modified.slice(insertPos);
+    }
+    else {
+        // Insert before skill-management navItem if present, otherwise before the comment placeholder or closing bracket
+        const skillNavIdx = modified.indexOf("{ key: 'skill-management'");
+        if (skillNavIdx !== -1) {
+            // Insert before the skill-management navItem line so it stays at the bottom
+            const lineStart = modified.lastIndexOf('\n', skillNavIdx) + 1;
+            modified = modified.slice(0, lineStart) + navItemLine + '\n' + modified.slice(lineStart);
+        }
+        else {
+            const navItemsEnd = modified.indexOf('// Add nav items');
+            if (navItemsEnd !== -1) {
+                // Insert before the comment placeholder
+                const lineStart = modified.lastIndexOf('\n', navItemsEnd) + 1;
+                modified = modified.slice(0, lineStart) + navItemLine + '\n' + modified.slice(lineStart);
+            }
+            else {
+                // Fallback: find the closing ] of navItems array
+                const navArrayMatch = modified.match(/const navItems\s*=\s*\[/);
+                if (!navArrayMatch)
+                    return false;
+                const arrayStart = navArrayMatch.index + navArrayMatch[0].length;
+                // Find the matching ]
+                let depth = 1;
+                let pos = arrayStart;
+                while (pos < modified.length && depth > 0) {
+                    if (modified[pos] === '[')
+                        depth++;
+                    else if (modified[pos] === ']')
+                        depth--;
+                    pos++;
+                }
+                const closingBracket = pos - 1;
+                modified = modified.slice(0, closingBracket) + navItemLine + '\n' + modified.slice(closingBracket);
+            }
+        }
+    }
+    // 3. Add switch case — before skill-management case if present, otherwise before default
+    const caseLine = `      case '${navKey}': return <${pascalName}Page />;`;
+    const skillCaseIdx = modified.indexOf("case 'skill-management':");
+    const insertAnchor = skillCaseIdx !== -1 ? skillCaseIdx : modified.indexOf('default:');
+    if (insertAnchor === -1)
+        return false;
+    const insertLineStart = modified.lastIndexOf('\n', insertAnchor) + 1;
+    modified = modified.slice(0, insertLineStart) + caseLine + '\n' + modified.slice(insertLineStart);
+    // 4. Add breadcrumb mapping — before the comment placeholder or closing brace
+    const breadcrumbLine = `  '${navKey}': [{ title: t('nav.${navKey}') }],`;
+    const breadcrumbCommentIdx = modified.indexOf('// Add breadcrumb mappings');
+    if (breadcrumbCommentIdx !== -1) {
+        const lineStart = modified.lastIndexOf('\n', breadcrumbCommentIdx) + 1;
+        modified = modified.slice(0, lineStart) + breadcrumbLine + '\n' + modified.slice(lineStart);
+    }
+    // 5. Ensure breadcrumbsMap prop on AppShell (migrate from old breadcrumbs= if present)
+    if (modified.includes('<AppShell')) {
+        // Migrate old prop format: breadcrumbs={breadcrumbMap[selectedKey]} → breadcrumbsMap={breadcrumbMap}
+        if (modified.includes('breadcrumbs={breadcrumbMap[selectedKey]}')) {
+            modified = modified.replace('breadcrumbs={breadcrumbMap[selectedKey]}', 'breadcrumbsMap={breadcrumbMap}');
+        }
+        else if (!modified.includes('breadcrumbsMap=')) {
+            modified = modified.replace('onNavClick={setSelectedKey}', 'onNavClick={setSelectedKey}\n      breadcrumbsMap={breadcrumbMap}');
+        }
+    }
+    // 6. Ensure baseUrl="" on AppShell (prevent /api/v1/api/v1 double prefix)
+    if (modified.includes('<AppShell') && !modified.includes('baseUrl=')) {
+        modified = modified.replace('<AppShell', '<AppShell\n      baseUrl=""');
+    }
+    await fs.writeFile(appPath, modified, 'utf-8');
+    return true;
+}
+/**
+ * Auto-wire the SkillManagementPage into App.tsx.
+ * Called once when the first CRUD page is generated.
+ * Returns true if successful, false if already wired or structure is unexpected.
+ */
+export async function wireSkillManagementPage(projectRoot) {
+    const appPath = path.join(projectRoot, 'frontend', 'src', 'App.tsx');
+    let content;
+    try {
+        content = await fs.readFile(appPath, 'utf-8');
+    }
+    catch {
+        return false;
+    }
+    // Check if already wired (avoid duplicates)
+    if (content.includes('SkillManagementPage')) {
+        return false;
+    }
+    let modified = content;
+    // 1. Add import after the last import line
+    const importLine = `import { SkillManagementPage } from '@loom-framework/frontend-antd';`;
+    const lastImportEnd = modified.lastIndexOf('\n', modified.indexOf('\nexport'));
+    if (lastImportEnd === -1)
+        return false;
+    modified = modified.slice(0, lastImportEnd + 1) + importLine + '\n' + modified.slice(lastImportEnd + 1);
+    // 1b. Register skill-management nav i18n keys
+    const registerLine = `registerMessages('zh-CN', { 'nav.skill-management': '技能管理' });\nregisterMessages('en-US', { 'nav.skill-management': 'Skill Management' });`;
+    const afterImports = modified.indexOf('\nexport') !== -1
+        ? modified.lastIndexOf('\n', modified.indexOf('\nexport'))
+        : lastImportEnd;
+    modified = modified.slice(0, afterImports + 1) + registerLine + '\n' + modified.slice(afterImports + 1);
+    // 2. Add navItem — always at the end of the array so it stays below all model pages
+    const navItemLine = `  { key: 'skill-management', label: t('nav.skill-management') },`;
+    const navArrayMatch = modified.match(/const navItems\s*=\s*\[/);
+    if (!navArrayMatch)
+        return false;
+    const arrayStart = navArrayMatch.index + navArrayMatch[0].length;
+    let depth = 1;
+    let pos = arrayStart;
+    while (pos < modified.length && depth > 0) {
+        if (modified[pos] === '[')
+            depth++;
+        else if (modified[pos] === ']')
+            depth--;
+        pos++;
+    }
+    const closingBracket = pos - 1;
+    // Insert before the line containing the closing bracket
+    const lineStart = modified.lastIndexOf('\n', closingBracket) + 1;
+    modified = modified.slice(0, lineStart) + navItemLine + '\n' + modified.slice(lineStart);
+    // 3. Add switch case before default
+    const caseLine = `      case 'skill-management': return <SkillManagementPage />;`;
+    const defaultCase = modified.indexOf('default:');
+    if (defaultCase === -1)
+        return false;
+    const defaultLineStart = modified.lastIndexOf('\n', defaultCase) + 1;
+    modified = modified.slice(0, defaultLineStart) + caseLine + '\n' + modified.slice(defaultLineStart);
+    await fs.writeFile(appPath, modified, 'utf-8');
+    return true;
+}
+//# sourceMappingURL=app-tsx-wiring.js.map

package/dist/cli/helpers/app-tsx-wiring.js.map

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

package/dist/cli/helpers/backup.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Backup helper - copies existing files to .loom/backup/ before --force overwrite
+ *
+ * Backup directory structure:
+ *   .loom/backup/2026-04-16T14-30-25/XXX.tsx
+ *   .loom/backup/2026-04-16T14-30-25/DashboardPage.tsx
+ */
+/**
+ * Backup a file before overwriting it with --force.
+ * Copies the file to .loom/backup/<timestamp>/<filename>.
+ * No-op if the file doesn't exist.
+ *
+ * @returns The backup path if backup was created, null if file didn't exist
+ */
+export declare function backupFile(projectRoot: string, filePath: string): Promise<string | null>;
+//# sourceMappingURL=backup.d.ts.map

package/dist/cli/helpers/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../../src/cli/helpers/backup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqB9F"}

package/dist/cli/helpers/backup.js

@@ -0,0 +1,37 @@
+/**
+ * Backup helper - copies existing files to .loom/backup/ before --force overwrite
+ *
+ * Backup directory structure:
+ *   .loom/backup/2026-04-16T14-30-25/XXX.tsx
+ *   .loom/backup/2026-04-16T14-30-25/DashboardPage.tsx
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+/**
+ * Backup a file before overwriting it with --force.
+ * Copies the file to .loom/backup/<timestamp>/<filename>.
+ * No-op if the file doesn't exist.
+ *
+ * @returns The backup path if backup was created, null if file didn't exist
+ */
+export async function backupFile(projectRoot, filePath) {
+    let content;
+    try {
+        content = await fs.readFile(filePath, 'utf-8');
+    }
+    catch {
+        // File doesn't exist, no backup needed
+        return null;
+    }
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupDir = path.join(projectRoot, '.loom', 'backup', timestamp);
+    await fs.mkdir(backupDir, { recursive: true });
+    const fileName = path.basename(filePath);
+    const backupPath = path.join(backupDir, fileName);
+    await fs.writeFile(backupPath, content, 'utf-8');
+    const relativePath = path.relative(projectRoot, backupPath);
+    console.log(chalk.dim(`  Backup: ${relativePath}`));
+    return backupPath;
+}
+//# sourceMappingURL=backup.js.map