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

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

@@ -0,0 +1,84 @@
+/** Skill ZIP archive parsing and creation utilities */
+import path from 'node:path';
+import AdmZip from 'adm-zip';
+import { parseFrontmatter, isValidSkillName, isTextFile } from './skill-parser.js';
+/**
+ * Parse a zip archive buffer and extract skill structure.
+ */
+export function parseZipArchive(buffer) {
+    const zip = new AdmZip(buffer);
+    const entries = zip.getEntries();
+    // Collect valid file entries
+    const validEntries = entries.filter((entry) => {
+        if (entry.isDirectory)
+            return false;
+        const entryPath = entry.entryName;
+        // Skip macOS metadata
+        if (entryPath.startsWith('__MACOSX/'))
+            return false;
+        // Skip .DS_Store and hidden files in root
+        const parts = entryPath.split('/');
+        if (parts.some((p) => p.startsWith('.') && p !== '.gitkeep' && p !== '.gitignore'))
+            return false;
+        return true;
+    });
+    if (validEntries.length === 0) {
+        throw new Error('压缩包中没有任何有效文件');
+    }
+    // Detect common top-level directory prefix
+    let prefix = '';
+    const firstEntry = validEntries[0].entryName;
+    const slashIdx = firstEntry.indexOf('/');
+    if (slashIdx > 0) {
+        const candidate = firstEntry.substring(0, slashIdx + 1);
+        if (validEntries.every((e) => e.entryName.startsWith(candidate))) {
+            prefix = candidate;
+        }
+    }
+    // Strip prefix and collect files
+    const allFiles = [];
+    for (const entry of validEntries) {
+        let relPath = entry.entryName;
+        if (prefix && relPath.startsWith(prefix)) {
+            relPath = relPath.substring(prefix.length);
+        }
+        // Skip if empty after stripping prefix
+        if (!relPath)
+            continue;
+        // Only keep text files
+        if (!isTextFile(relPath))
+            continue;
+        const content = entry.getData().toString('utf-8');
+        allFiles.push({ path: relPath, content });
+    }
+    // Find SKILL.md
+    const skillMdEntry = allFiles.find((f) => f.path === 'SKILL.md');
+    if (!skillMdEntry) {
+        throw new Error('压缩包中未找到 SKILL.md 文件');
+    }
+    // Check for duplicate SKILL.md in subdirectories
+    const skillMdCount = allFiles.filter((f) => path.basename(f.path) === 'SKILL.md').length;
+    if (skillMdCount > 1) {
+        throw new Error('压缩包中包含多个 SKILL.md 文件，请确保只有一个');
+    }
+    // Extract skill name from frontmatter or directory name
+    const { metadata } = parseFrontmatter(skillMdEntry.content);
+    let skillName = metadata.name;
+    if (!skillName || typeof skillName !== 'string') {
+        // Fallback to directory name from prefix
+        if (prefix) {
+            skillName = prefix.replace(/\/$/, '');
+        }
+        else {
+            throw new Error('无法确定 Skill 名称，请在 SKILL.md 的 frontmatter 中指定 name 字段');
+        }
+    }
+    // Validate skill name
+    if (!isValidSkillName(skillName)) {
+        throw new Error(`Skill 名称 "${skillName}" 不合法，只能包含字母、数字、中划线和下划线，且以字母开头`);
+    }
+    // Separate SKILL.md from other files
+    const files = allFiles.filter((f) => f.path !== 'SKILL.md');
+    return { skillName, skillMd: skillMdEntry.content, files };
+}
+//# sourceMappingURL=skill-archive.js.map

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

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

package/dist/backend/services/skill-parser.d.ts

@@ -0,0 +1,41 @@
+/** Skill file parsing utilities */
+export interface SkillMetadata {
+    name?: string;
+    description?: string;
+    version?: string;
+    'allowed-tools'?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Parse YAML frontmatter from markdown content using simple regex.
+ */
+export declare function parseFrontmatter(content: string): {
+    metadata: SkillMetadata;
+    body: string;
+};
+/**
+ * Recursively scan a directory for files, returning relative paths.
+ * Excludes SKILL.md (handled separately).
+ */
+export declare function scanDirFiles(dir: string, base: string): Promise<string[]>;
+/**
+ * Safely resolve a file path within a directory. Rejects '..' traversal.
+ */
+export declare function safeResolve(baseDir: string, filePath: string): string | null;
+/**
+ * Validate skill name.
+ */
+export declare function isValidSkillName(name: string): boolean;
+/**
+ * Text file extensions that should be kept when parsing zip archives.
+ */
+export declare const TEXT_EXTENSIONS: Set<string>;
+/**
+ * Check if a file path looks like a text file based on extension.
+ */
+export declare function isTextFile(filePath: string): boolean;
+/**
+ * Get MIME type for a file extension.
+ */
+export declare function getContentType(filePath: string): string;
+//# sourceMappingURL=skill-parser.d.ts.map

package/dist/backend/services/skill-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-parser.d.ts","sourceRoot":"","sources":["../../../src/backend/services/skill-parser.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAQnC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqG3F;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkB/E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,aAK1B,CAAC;AAEH;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQpD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAevD"}

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

@@ -0,0 +1,184 @@
+/** Skill file parsing utilities */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+// ── Functions ──
+/**
+ * Parse YAML frontmatter from markdown content using simple regex.
+ */
+export function parseFrontmatter(content) {
+    // The \n before closing --- is optional to handle empty frontmatter (---\n---\nBody)
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n?---\r?\n?([\s\S]*)$/);
+    if (!match)
+        return { metadata: {}, body: content };
+    const metadataRaw = match[1];
+    const body = match[2];
+    try {
+        const metadata = {};
+        const lines = metadataRaw.split('\n');
+        let currentKey = '';
+        let currentValues = [];
+        let inArray = false;
+        let inBlock = false;
+        let blockLines = [];
+        const flushArray = () => {
+            if (inArray && currentKey) {
+                // If array items were collected, store as array; otherwise store empty string
+                metadata[currentKey] = currentValues.length > 0 ? currentValues : '';
+                inArray = false;
+                currentValues = [];
+            }
+        };
+        const flushBlock = () => {
+            if (inBlock && currentKey) {
+                metadata[currentKey] = blockLines.join('\n').trim();
+            }
+            inBlock = false;
+            blockLines = [];
+        };
+        for (const line of lines) {
+            if (inBlock) {
+                if (/^[ \t]+/.test(line) || (line === '' && blockLines.length > 0)) {
+                    blockLines.push(line.replace(/^[ \t]+/, ''));
+                    continue;
+                }
+                else {
+                    flushBlock();
+                }
+            }
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            const arrayMatch = trimmed.match(/^-\s+(.+)$/);
+            if (inArray && arrayMatch) {
+                currentValues.push(arrayMatch[1].replace(/^['"]|['"]$/g, '').trim());
+                continue;
+            }
+            if (inArray) {
+                flushArray();
+            }
+            const kvMatch = trimmed.match(/^([a-zA-Z_-][a-zA-Z0-9_-]*):\s*(.*)$/);
+            if (kvMatch) {
+                currentKey = kvMatch[1];
+                let val = kvMatch[2].trim();
+                if ((val.startsWith("'") && val.endsWith("'")) || (val.startsWith('"') && val.endsWith('"'))) {
+                    val = val.slice(1, -1);
+                }
+                if (val === '|' || val === '>') {
+                    inBlock = true;
+                    blockLines = [];
+                    continue;
+                }
+                if (val === '[') {
+                    inArray = true;
+                    currentValues = [];
+                    continue;
+                }
+                if (val.startsWith('[') && val.endsWith(']')) {
+                    metadata[currentKey] = val.slice(1, -1).split(',').map((s) => s.trim().replace(/^['"]|['"]$/g, ''));
+                    currentKey = '';
+                    continue;
+                }
+                // Empty value means multi-line array follows (YAML list syntax: "key:\n  - item")
+                if (val === '') {
+                    inArray = true;
+                    currentValues = [];
+                    continue;
+                }
+                metadata[currentKey] = val;
+                currentKey = '';
+            }
+        }
+        flushArray();
+        flushBlock();
+        return { metadata, body };
+    }
+    catch {
+        return { metadata: {}, body: content };
+    }
+}
+/**
+ * Recursively scan a directory for files, returning relative paths.
+ * Excludes SKILL.md (handled separately).
+ */
+export async function scanDirFiles(dir, base) {
+    const results = [];
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            const subFiles = await scanDirFiles(path.join(dir, entry.name), base);
+            results.push(...subFiles);
+        }
+        else {
+            const relPath = path.relative(base, path.join(dir, entry.name));
+            results.push(relPath);
+        }
+    }
+    return results;
+}
+/**
+ * Safely resolve a file path within a directory. Rejects '..' traversal.
+ */
+export function safeResolve(baseDir, filePath) {
+    if (filePath.includes('..'))
+        return null;
+    const resolved = path.resolve(baseDir, filePath);
+    if (!resolved.startsWith(baseDir))
+        return null;
+    return resolved;
+}
+/**
+ * Validate skill name.
+ */
+export function isValidSkillName(name) {
+    return /^[a-zA-Z][a-zA-Z0-9_-]*$/.test(name);
+}
+/**
+ * Text file extensions that should be kept when parsing zip archives.
+ */
+export const TEXT_EXTENSIONS = new Set([
+    '.md', '.json', '.yaml', '.yml', '.txt', '.ts', '.js', '.tsx', '.jsx',
+    '.xml', '.html', '.css', '.sh', '.py', '.rb', '.go', '.rs', '.java',
+    '.kt', '.swift', '.c', '.cpp', '.h', '.hpp', '.toml', '.ini', '.cfg',
+    '.env', '.gitignore', '.prettierrc', '.eslintrc', '.conf', '.properties',
+]);
+/**
+ * Check if a file path looks like a text file based on extension.
+ */
+export function isTextFile(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (TEXT_EXTENSIONS.has(ext))
+        return true;
+    // Files with no extension but common names
+    const basename = path.basename(filePath).toLowerCase();
+    if (['readme', 'license', 'makefile', 'dockerfile', '.gitkeep', '.gitignore'].includes(basename))
+        return true;
+    if (basename.startsWith('.git'))
+        return true;
+    return false;
+}
+/**
+ * Get MIME type for a file extension.
+ */
+export function getContentType(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const types = {
+        '.md': 'text/markdown',
+        '.txt': 'text/plain',
+        '.json': 'application/json',
+        '.xml': 'application/xml',
+        '.yaml': 'text/yaml',
+        '.yml': 'text/yaml',
+        '.ts': 'text/typescript',
+        '.js': 'text/javascript',
+        '.html': 'text/html',
+        '.css': 'text/css',
+    };
+    return types[ext] || 'text/plain';
+}
+//# sourceMappingURL=skill-parser.js.map

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

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

package/dist/backend/services/skill-service.d.ts

@@ -0,0 +1,113 @@
+/** Skill business logic — filesystem operations independent of Fastify */
+import type { SkillMetadata } from './skill-parser.js';
+import { parseZipArchive } from './skill-archive.js';
+export interface SkillInfo {
+    name: string;
+    metadata: SkillMetadata;
+    subDirs: string[];
+}
+export interface SkillDetail {
+    name: string;
+    metadata: SkillMetadata;
+    skillMd: string;
+    files: {
+        name: string;
+        path: string;
+    }[];
+}
+export interface CreateSkillBody {
+    name: string;
+    skillMd?: string;
+    references?: Array<{
+        name: string;
+        content: string;
+    }>;
+    scripts?: Array<{
+        name: string;
+        content: string;
+    }>;
+    files?: Array<{
+        path: string;
+        content: string;
+    }>;
+}
+export interface UploadFileBody {
+    filename: string;
+    content: string;
+}
+/**
+ * List all skills with metadata.
+ */
+export declare function listSkills(skillsDir: string): Promise<SkillInfo[]>;
+/**
+ * Get detailed information about a single skill.
+ */
+export declare function getSkillDetail(skillsDir: string, skillName: string): Promise<SkillDetail | null>;
+/**
+ * Create a new skill directory with SKILL.md and optional files.
+ * Returns the created skill info, or throws on conflict / invalid name.
+ */
+export declare function createSkill(skillsDir: string, body: CreateSkillBody): Promise<{
+    created: true;
+    info: SkillInfo;
+} | {
+    created: false;
+    status: number;
+    error: string;
+}>;
+/**
+ * Delete a skill directory.
+ */
+export declare function deleteSkill(skillsDir: string, skillName: string): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+}>;
+/**
+ * Read a file within a skill directory.
+ */
+export declare function getSkillFile(skillsDir: string, skillName: string, filePath: string): Promise<{
+    ok: true;
+    content: string;
+    path: string;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+}>;
+/**
+ * Upload/replace a file in a skill directory.
+ */
+export declare function uploadSkillFile(skillsDir: string, skillName: string, filename: string, content: string): Promise<{
+    ok: true;
+    path: string;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+}>;
+/**
+ * Create a ZIP archive of a skill directory.
+ */
+export declare function createSkillArchive(skillsDir: string, skillName: string): Promise<{
+    ok: true;
+    buffer: Buffer;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+}>;
+/**
+ * Parse a base64-encoded ZIP archive and extract skill structure.
+ */
+export declare function parseSkillArchive(base64Data: string): {
+    ok: true;
+    data: ReturnType<typeof parseZipArchive>;
+} | {
+    ok: false;
+    status: number;
+    error: string;
+};
+//# sourceMappingURL=skill-service.d.ts.map

package/dist/backend/services/skill-service.d.ts.map

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