@loom-framework/core 0.1.0-alpha.8 → 0.1.0-alpha.81

package/dist/cli/commands/observe.js

@@ -0,0 +1,142 @@
+/**
+ * loom observe - Observability commands
+ *
+ * loom observe logs [--session <id>] [--last <duration>]
+ * loom observe metrics
+ */
+import chalk from 'chalk';
+import { promises as fs } from 'fs';
+import path from 'path';
+import { resolveProjectRoot } from '../utils.js';
+import { parseDuration } from '../helpers/duration.js';
+export function registerObserveCommand(program) {
+    const observe = program
+        .command('observe')
+        .description('Observability: logs and metrics');
+    // loom observe logs
+    observe
+        .command('logs')
+        .description('View AI interaction logs')
+        .option('--session <id>', 'Filter by session ID')
+        .option('--last <duration>', 'Filter by time range (e.g. 1h, 30m, 7d)')
+        .option('--limit <number>', 'Max number of logs to show', parseInt, 20)
+        .action(async (options) => {
+        try {
+            const projectRoot = await resolveProjectRoot();
+            const logsDir = path.join(projectRoot, '.loom', 'logs');
+            const logs = await readLogs(logsDir, {
+                session: options.session,
+                last: options.last,
+            });
+            if (logs.length === 0) {
+                console.log(chalk.dim('No interaction logs found.'));
+                return;
+            }
+            const display = logs.slice(0, options.limit);
+            for (const entry of display) {
+                const duration = chalk.dim(`${entry.duration}ms`);
+                const ts = chalk.gray(new Date(entry.timestamp).toLocaleString());
+                const session = chalk.cyan(entry.sessionId.slice(0, 16));
+                const tokens = entry.usage
+                    ? chalk.dim(`in:${entry.usage.inputTokens} out:${entry.usage.outputTokens}`)
+                    : '';
+                console.log(chalk.bold(`[${entry.messageId}]`) + ` ${ts} ${session} ${duration} ${tokens}`);
+                console.log(`  ${chalk.dim('Prompt:')} ${entry.prompt.slice(0, 100)}${entry.prompt.length > 100 ? '...' : ''}`);
+                console.log(`  ${chalk.dim('Response:')} ${entry.response.slice(0, 100)}${entry.response.length > 100 ? '...' : ''}`);
+                if (entry.error) {
+                    console.log(`  ${chalk.red('Error:')} ${entry.error}`);
+                }
+                if (entry.mcpCalls.length > 0) {
+                    console.log(`  ${chalk.dim('MCP:')} ${entry.mcpCalls.join(', ')}`);
+                }
+                if (entry.cliCalls.length > 0) {
+                    console.log(`  ${chalk.dim('CLI:')} ${entry.cliCalls.join(', ')}`);
+                }
+                console.log();
+            }
+            console.log(chalk.dim(`Showing ${display.length} of ${logs.length} logs`));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red('Failed to read logs:'), message);
+            process.exit(1);
+        }
+    });
+    // loom observe metrics
+    observe
+        .command('metrics')
+        .description('View aggregated metrics from AI interaction logs')
+        .action(async () => {
+        try {
+            const projectRoot = await resolveProjectRoot();
+            const logsDir = path.join(projectRoot, '.loom', 'logs');
+            const logs = await readLogs(logsDir);
+            if (logs.length === 0) {
+                console.log(chalk.dim('No interaction logs found. Run some AI interactions first.'));
+                return;
+            }
+            const totalInteractions = logs.length;
+            const avgResponseTime = Math.round(logs.reduce((sum, l) => sum + l.duration, 0) / totalInteractions);
+            const errorLogs = logs.filter((l) => l.error);
+            const errorRate = ((errorLogs.length / totalInteractions) * 100).toFixed(1);
+            const totalInputTokens = logs.reduce((sum, l) => sum + (l.usage?.inputTokens || 0), 0);
+            const totalOutputTokens = logs.reduce((sum, l) => sum + (l.usage?.outputTokens || 0), 0);
+            // Skill trigger counts from mcpCalls / cliCalls
+            const skillCounts = {};
+            for (const log of logs) {
+                for (const call of [...log.mcpCalls, ...log.cliCalls]) {
+                    skillCounts[call] = (skillCounts[call] || 0) + 1;
+                }
+            }
+            console.log(chalk.bold('Loom Metrics'));
+            console.log();
+            console.log(`  ${chalk.cyan('Total Interactions:')} ${totalInteractions}`);
+            console.log(`  ${chalk.cyan('Avg Response Time:')}  ${avgResponseTime}ms`);
+            console.log(`  ${chalk.cyan('Tokens Used:')}        in:${totalInputTokens} out:${totalOutputTokens}`);
+            console.log(`  ${chalk.cyan('Error Rate:')}         ${errorRate}%`);
+            if (Object.keys(skillCounts).length > 0) {
+                console.log();
+                console.log(chalk.cyan('  Tool/Skill Calls:'));
+                for (const [name, count] of Object.entries(skillCounts).sort((a, b) => b[1] - a[1])) {
+                    console.log(`    ${name}: ${count}`);
+                }
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red('Failed to compute metrics:'), message);
+            process.exit(1);
+        }
+    });
+}
+async function readLogs(logsDir, filter) {
+    try {
+        const files = await fs.readdir(logsDir);
+        const logs = [];
+        for (const file of files) {
+            if (!file.endsWith('.json'))
+                continue;
+            try {
+                const content = await fs.readFile(path.join(logsDir, file), 'utf-8');
+                const entry = JSON.parse(content);
+                if (filter?.session && entry.sessionId !== filter.session)
+                    continue;
+                if (filter?.last) {
+                    const cutoff = Date.now() - parseDuration(filter.last);
+                    if (new Date(entry.timestamp).getTime() < cutoff)
+                        continue;
+                }
+                logs.push(entry);
+            }
+            catch {
+                // Skip malformed
+            }
+        }
+        logs.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+        return logs;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=observe.js.map

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

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

package/dist/cli/commands/skill.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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 type { Command } from 'commander';
+export declare function registerSkillCommand(program: Command): void;
+//# sourceMappingURL=skill.d.ts.map

package/dist/cli/commands/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/skill.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+H3D"}

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/helpers/app-tsx-wiring.d.ts

@@ -0,0 +1,17 @@
+/**
+ * App.tsx wiring utilities - shared between generate-page and generate-dashboard
+ *
+ * Surgically modifies App.tsx to add imports, navItems, and switch cases.
+ */
+/**
+ * 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): 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;;;;GAIG;AAKH;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAkElB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiDnF"}

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

@@ -0,0 +1,132 @@
+/**
+ * App.tsx wiring utilities - shared between generate-page and generate-dashboard
+ *
+ * Surgically modifies App.tsx to add imports, navItems, and switch cases.
+ */
+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) {
+    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);
+    // 2. Add navItem (before the closing ] of navItems array)
+    const navItemLine = `  { key: '${navKey}', label: '${navLabel}' },`;
+    const navItemsEnd = modified.indexOf('// Add more 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. 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);
+    // 2. Add navItem — always at the end of the array so it stays below all model pages
+    const navItemLine = `  { key: 'skill-management', label: 'Skill 管理' },`;
+    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/duration.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Duration parsing utility - extracted for testability
+ */
+export declare function parseDuration(duration: string): number;
+//# sourceMappingURL=duration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../../src/cli/helpers/duration.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CActD"}

package/dist/cli/helpers/duration.js

@@ -0,0 +1,19 @@
+/**
+ * Duration parsing utility - extracted for testability
+ */
+export function parseDuration(duration) {
+    const match = duration.match(/^(\d+)(s|m|h|d)$/);
+    if (!match) {
+        throw new Error(`Invalid duration: ${duration}. Use format like '1h', '30m', '7d'`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    switch (unit) {
+        case 's': return value * 1000;
+        case 'm': return value * 60 * 1000;
+        case 'h': return value * 60 * 60 * 1000;
+        case 'd': return value * 24 * 60 * 60 * 1000;
+        default: throw new Error(`Unknown unit: ${unit}`);
+    }
+}
+//# sourceMappingURL=duration.js.map

package/dist/cli/helpers/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../../src/cli/helpers/duration.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,qCAAqC,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,IAAI,CAAC;QAC9B,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC;QACnC,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACxC,KAAK,GAAG,CAAC,CAAC,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAC7C,OAAO,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/cli/helpers/field-template.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Field-to-template utilities - extracted for testability
+ */
+import type { FieldDefinition, FieldType } from '../../index.js';
+/** Map FieldType to Ant Design table column render hint */
+export declare function fieldToColumnType(type: FieldType): string;
+export declare function getFieldLabel(field: FieldDefinition): string;
+/** Generate Ant Design form item for a field */
+export declare function fieldToFormItem(field: FieldDefinition, modelName: string): string;
+//# sourceMappingURL=field-template.d.ts.map

package/dist/cli/helpers/field-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-template.d.ts","sourceRoot":"","sources":["../../../src/cli/helpers/field-template.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEjE,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAYzD;AAQD,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAE5D;AAiCD,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA+CjF"}