@loom-framework/core 0.1.0-alpha.19 → 0.1.0-alpha.190

package/dist/backend/services/skill-service.js

@@ -0,0 +1,265 @@
+/** Skill business logic — filesystem operations independent of Fastify */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import AdmZip from 'adm-zip';
+import { parseFrontmatter, scanDirFiles, safeResolve, isValidSkillName } from './skill-parser.js';
+import { parseZipArchive } from './skill-archive.js';
+// ── Service functions ──
+/**
+ * Ensure the skills directory exists.
+ */
+async function ensureSkillsDir(skillsDir) {
+    await fs.mkdir(skillsDir, { recursive: true });
+}
+/**
+ * List all skills with metadata.
+ */
+export async function listSkills(skillsDir) {
+    await ensureSkillsDir(skillsDir);
+    let entries;
+    try {
+        entries = await fs.readdir(skillsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const skills = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const skillDir = path.join(skillsDir, entry.name);
+        const skillMdPath = path.join(skillDir, 'SKILL.md');
+        let metadata = {};
+        try {
+            const content = await fs.readFile(skillMdPath, 'utf-8');
+            metadata = parseFrontmatter(content).metadata;
+        }
+        catch {
+            // SKILL.md doesn't exist or is unreadable
+        }
+        // Scan subdirectories dynamically (any folder name, not just 'references')
+        let subDirs = [];
+        try {
+            const dirEntries = await fs.readdir(skillDir, { withFileTypes: true });
+            subDirs = dirEntries.filter((e) => e.isDirectory()).map((e) => e.name);
+        }
+        catch {
+            // ignore
+        }
+        skills.push({ name: entry.name, metadata, subDirs });
+    }
+    return skills;
+}
+/**
+ * Get detailed information about a single skill.
+ */
+export async function getSkillDetail(skillsDir, skillName) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists)
+        return null;
+    let skillMd = '';
+    let metadata = {};
+    try {
+        skillMd = await fs.readFile(path.join(skillDir, 'SKILL.md'), 'utf-8');
+        metadata = parseFrontmatter(skillMd).metadata;
+    }
+    catch {
+        // SKILL.md doesn't exist
+    }
+    // Dynamically scan all files in subdirectories
+    const allFiles = await scanDirFiles(skillDir, skillDir);
+    const files = allFiles.map((p) => ({
+        name: path.basename(p),
+        path: p,
+    }));
+    return { name: skillName, metadata, skillMd, files };
+}
+/**
+ * Create a new skill directory with SKILL.md and optional files.
+ * Returns the created skill info, or throws on conflict / invalid name.
+ */
+export async function createSkill(skillsDir, body) {
+    const { name, skillMd, references, scripts: scriptFiles, files: archiveFiles } = body;
+    if (!isValidSkillName(name)) {
+        return { created: false, status: 400, error: 'Invalid skill name. Use alphanumeric, hyphens, and underscores only.' };
+    }
+    const skillDir = path.join(skillsDir, name);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (exists) {
+        return { created: false, status: 409, error: `Skill "${name}" already exists` };
+    }
+    await fs.mkdir(skillDir, { recursive: true });
+    const contentToWrite = skillMd || `---
+name: ${name}
+description: ''
+version: 1.0.0
+---
+
+# ${name}
+
+## Overview
+
+[Describe what this skill does]
+
+## Usage Scenarios
+
+- "User prompt" → [what the skill does]
+`;
+    await fs.writeFile(path.join(skillDir, 'SKILL.md'), contentToWrite, 'utf-8');
+    if (references && references.length > 0) {
+        const refDir = path.join(skillDir, 'references');
+        await fs.mkdir(refDir, { recursive: true });
+        for (const ref of references) {
+            const safePath = safeResolve(refDir, ref.name);
+            if (safePath) {
+                await fs.mkdir(path.dirname(safePath), { recursive: true });
+                await fs.writeFile(safePath, ref.content, 'utf-8');
+            }
+        }
+    }
+    if (scriptFiles && scriptFiles.length > 0) {
+        const scriptsDir = path.join(skillDir, 'scripts');
+        await fs.mkdir(scriptsDir, { recursive: true });
+        for (const script of scriptFiles) {
+            const safePath = safeResolve(scriptsDir, script.name);
+            if (safePath) {
+                await fs.mkdir(path.dirname(safePath), { recursive: true });
+                await fs.writeFile(safePath, script.content, 'utf-8');
+            }
+        }
+    }
+    if (archiveFiles && archiveFiles.length > 0) {
+        for (const file of archiveFiles) {
+            const safePath = safeResolve(skillDir, file.path);
+            if (safePath) {
+                await fs.mkdir(path.dirname(safePath), { recursive: true });
+                await fs.writeFile(safePath, file.content, 'utf-8');
+            }
+        }
+    }
+    const metadata = parseFrontmatter(contentToWrite).metadata;
+    return { created: true, info: { name, metadata, subDirs: [] } };
+}
+/**
+ * Delete a skill directory.
+ */
+export async function deleteSkill(skillsDir, skillName) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists) {
+        return { ok: false, status: 404, error: `Skill "${skillName}" not found` };
+    }
+    await fs.rm(skillDir, { recursive: true, force: true });
+    return { ok: true };
+}
+/**
+ * Read a file within a skill directory.
+ */
+export async function getSkillFile(skillsDir, skillName, filePath) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists) {
+        return { ok: false, status: 404, error: `Skill "${skillName}" not found` };
+    }
+    const resolvedPath = safeResolve(skillDir, filePath);
+    if (!resolvedPath) {
+        return { ok: false, status: 400, error: 'Invalid file path' };
+    }
+    const fileExists = await fs.access(resolvedPath).then(() => true, () => false);
+    if (!fileExists) {
+        return { ok: false, status: 404, error: `File "${filePath}" not found` };
+    }
+    try {
+        const content = await fs.readFile(resolvedPath, 'utf-8');
+        return { ok: true, content, path: filePath };
+    }
+    catch (err) {
+        return { ok: false, status: 500, error: `Failed to read file: ${err}` };
+    }
+}
+/**
+ * Upload/replace a file in a skill directory.
+ */
+export async function uploadSkillFile(skillsDir, skillName, filename, content) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists) {
+        return { ok: false, status: 404, error: `Skill "${skillName}" not found` };
+    }
+    const resolvedPath = safeResolve(skillDir, filename);
+    if (!resolvedPath) {
+        return { ok: false, status: 400, error: 'Invalid file path' };
+    }
+    await fs.mkdir(path.dirname(resolvedPath), { recursive: true });
+    await fs.writeFile(resolvedPath, content, 'utf-8');
+    return { ok: true, path: filename };
+}
+/**
+ * Create a ZIP archive of a skill directory.
+ */
+export async function createSkillArchive(skillsDir, skillName) {
+    const skillDir = path.join(skillsDir, skillName);
+    const exists = await fs.access(skillDir).then(() => true, () => false);
+    if (!exists) {
+        return { ok: false, status: 404, error: `Skill "${skillName}" not found` };
+    }
+    const zip = new AdmZip();
+    // Add SKILL.md
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    try {
+        const skillMd = await fs.readFile(skillMdPath, 'utf-8');
+        zip.addFile('SKILL.md', Buffer.from(skillMd, 'utf-8'));
+    }
+    catch {
+        // SKILL.md doesn't exist, skip
+    }
+    // Add all other files, preserving directory structure
+    const allFiles = await scanDirFiles(skillDir, skillDir);
+    for (const filePath of allFiles) {
+        if (filePath === 'SKILL.md')
+            continue;
+        const resolvedPath = safeResolve(skillDir, filePath);
+        if (!resolvedPath)
+            continue;
+        try {
+            const content = await fs.readFile(resolvedPath);
+            // Store under skillName/ prefix for proper extraction
+            zip.addFile(`${skillName}/${filePath}`, content);
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    // Also put SKILL.md under the prefix
+    zip.deleteFile('SKILL.md');
+    try {
+        const skillMd = await fs.readFile(skillMdPath, 'utf-8');
+        zip.addFile(`${skillName}/SKILL.md`, Buffer.from(skillMd, 'utf-8'));
+    }
+    catch {
+        // skip
+    }
+    return { ok: true, buffer: zip.toBuffer() };
+}
+/**
+ * Parse a base64-encoded ZIP archive and extract skill structure.
+ */
+export function parseSkillArchive(base64Data) {
+    let buffer;
+    try {
+        buffer = Buffer.from(base64Data, 'base64');
+    }
+    catch {
+        return { ok: false, status: 400, error: '无效的 base64 编码' };
+    }
+    try {
+        const result = parseZipArchive(buffer);
+        return { ok: true, data: result };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : '解析压缩包失败';
+        return { ok: false, status: 400, error: msg };
+    }
+}
+//# sourceMappingURL=skill-service.js.map

package/dist/backend/services/skill-service.js.map

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

package/dist/bin.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Loom CLI - Entry Point
+ *
+ * Project scaffolding, development, data operations, skill management
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/dist/bin.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Loom CLI - Entry Point
+ *
+ * Project scaffolding, development, data operations, skill management
+ */
+import { run } from './cli/index.js';
+run().catch((err) => {
+    console.error(err.message || err);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAErC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/capability-generator.d.ts

@@ -1,20 +1,35 @@
 /**
  * Capability Generator
  *
- * Core innovation: One schema definition → MCP Server + CLI commands
+ * Core innovation: One schema definition → Skill + CLI data access
  *
  * From loom.config.ts model definitions, generates:
- * 1. MCP Server (.loom/mcp-server/) - structured data CRUD tools
- * 2. CLI data commands (cli/commands/data/) - dev/debug data access
- * 3. MCP config (.loom/mcp.json) - Claude Code MCP registration
+ * 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 {
-    mcpServerDir: string;
+    /** 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
+ * 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/capability-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability-generator.d.ts","sourceRoot":"","sources":["../src/capability-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAe,UAAU,EAAmB,MAAM,YAAY,CAAC;AA6N3E,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,cAAc,CAAC,CA+EzB"}
+{"version":3,"file":"capability-generator.d.ts","sourceRoot":"","sources":["../src/capability-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAe,UAAU,EAAmB,MAAM,YAAY,CAAC;AA2D3E,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"}