@loom-framework/core 0.1.0-alpha.14 → 0.1.0-alpha.141

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":"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"}

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

@@ -0,0 +1,22 @@
+/**
+ * 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 system-settings navigation group into App.tsx.
+ * Creates a submenu with model-management and skill-management children.
+ * Called once when the first CRUD page is generated.
+ * Returns true if successful, false if already wired or structure is unexpected.
+ */
+export declare function wireSystemSettingsPage(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,CAgIlB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqKlF"}