jiva-core 0.2.2 → 0.3.1

package/dist/personas/skill-loader.js

@@ -0,0 +1,144 @@
+/**
+ * Skill loader - parses SKILL.md files with YAML frontmatter
+ * Implements progressive disclosure: L1 (metadata) → L2 (body) → L3 (references)
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as yaml from 'yaml';
+import { validateSkillMetadata, validateFrontmatterKeys, validateSkillBodyLength, normalizeFrontmatter, } from './validator.js';
+import { logger } from '../utils/logger.js';
+const FRONTMATTER_REGEX = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
+/**
+ * Parse SKILL.md file and extract frontmatter + body
+ */
+export async function parseSkillFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const match = content.match(FRONTMATTER_REGEX);
+        if (!match) {
+            throw new Error(`No YAML frontmatter found in ${filePath}. Skills must have --- delimited frontmatter.`);
+        }
+        const [, frontmatterStr, body] = match;
+        // Parse YAML frontmatter
+        let rawFrontmatter;
+        try {
+            rawFrontmatter = yaml.parse(frontmatterStr);
+        }
+        catch (error) {
+            throw new Error(`Invalid YAML in ${filePath}: ${error instanceof Error ? error.message : error}`);
+        }
+        // Validate frontmatter keys
+        const keyErrors = validateFrontmatterKeys(rawFrontmatter);
+        if (keyErrors.length > 0) {
+            logger.warn(`Skill ${filePath} has validation warnings:`, keyErrors);
+        }
+        // Normalize and validate metadata
+        const metadata = normalizeFrontmatter(rawFrontmatter);
+        const metadataErrors = validateSkillMetadata(metadata);
+        if (metadataErrors.length > 0) {
+            throw new Error(`Skill metadata validation failed for ${filePath}:\n` +
+                metadataErrors.map((e) => `  - ${e.field}: ${e.message}`).join('\n'));
+        }
+        // Validate body length (warning only)
+        const bodyErrors = validateSkillBodyLength(body);
+        if (bodyErrors.length > 0) {
+            logger.warn(`Skill ${metadata.name}:`, bodyErrors[0].message);
+        }
+        return { metadata, body: body.trim(), fullContent: content };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`SKILL.md not found at ${filePath}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Discover all skills in a directory (L1 only - metadata)
+ * Each subdirectory with a SKILL.md is a skill
+ */
+export async function discoverSkills(skillsDir, personaName) {
+    const skills = [];
+    try {
+        const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const skillPath = path.join(skillsDir, entry.name);
+            const skillFilePath = path.join(skillPath, 'SKILL.md');
+            try {
+                // Check if SKILL.md exists
+                await fs.access(skillFilePath);
+                // Parse L1 only (metadata)
+                const { metadata } = await parseSkillFile(skillFilePath);
+                skills.push({
+                    metadata,
+                    path: skillPath,
+                    loaded: false, // L2 not yet loaded
+                    personaName,
+                });
+                logger.debug(`Discovered skill: ${personaName}:${metadata.name}`);
+            }
+            catch (error) {
+                // Skip directories without valid SKILL.md
+                logger.debug(`Skipping ${skillPath}: ${error instanceof Error ? error.message : error}`);
+            }
+        }
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            // Skills directory doesn't exist - that's ok
+            return [];
+        }
+        throw error;
+    }
+    return skills;
+}
+/**
+ * Load L2 (full SKILL.md body) for a skill
+ */
+export async function loadSkillContent(skill) {
+    if (skill.loaded)
+        return;
+    const skillFilePath = path.join(skill.path, 'SKILL.md');
+    const { fullContent } = await parseSkillFile(skillFilePath);
+    skill.content = fullContent;
+    skill.loaded = true;
+    logger.debug(`Loaded L2 content for skill: ${skill.personaName}:${skill.metadata.name}`);
+}
+/**
+ * Get path to a skill resource (L3 - references, scripts, assets)
+ */
+export function getSkillResourcePath(skill, resourceType, filename) {
+    return path.join(skill.path, resourceType, filename);
+}
+/**
+ * Check if a skill has a specific resource
+ */
+export async function hasSkillResource(skill, resourceType, filename) {
+    const resourcePath = getSkillResourcePath(skill, resourceType, filename);
+    try {
+        await fs.access(resourcePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * List all resources of a type in a skill
+ */
+export async function listSkillResources(skill, resourceType) {
+    const resourceDir = path.join(skill.path, resourceType);
+    try {
+        const entries = await fs.readdir(resourceDir, { withFileTypes: true });
+        return entries.filter((e) => e.isFile()).map((e) => e.name);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=skill-loader.js.map

package/dist/personas/skill-loader.js.map

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

package/dist/personas/skill-packager.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Skill packaging and installation utilities
+ * Handles .skill files (ZIP archives) and directory structures
+ */
+/**
+ * Package a skill directory into a .skill file (ZIP archive)
+ */
+export declare function packageSkill(skillDir: string, outputPath?: string): Promise<string>;
+/**
+ * Install a .skill file into a persona's skills directory
+ */
+export declare function installSkillFile(skillFile: string, personaName: string, personaPath?: string): Promise<string>;
+/**
+ * Uninstall a skill from a persona
+ */
+export declare function uninstallSkill(skillName: string, personaName: string, personaPath?: string): Promise<void>;
+/**
+ * Create a new empty skill directory structure
+ */
+export declare function createSkill(skillName: string, outputDir: string, options?: {
+    description?: string;
+    license?: string;
+    author?: string;
+}): Promise<string>;
+//# sourceMappingURL=skill-packager.d.ts.map

package/dist/personas/skill-packager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-packager.d.ts","sourceRoot":"","sources":["../../src/personas/skill-packager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAgEjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAmFjB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GACL,OAAO,CAAC,MAAM,CAAC,CA6EjB"}

package/dist/personas/skill-packager.js

@@ -0,0 +1,233 @@
+/**
+ * Skill packaging and installation utilities
+ * Handles .skill files (ZIP archives) and directory structures
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import { createReadStream, createWriteStream } from 'fs';
+import { pipeline } from 'stream/promises';
+import archiver from 'archiver';
+import unzipper from 'unzipper';
+import { parseSkillFile } from './skill-loader.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Package a skill directory into a .skill file (ZIP archive)
+ */
+export async function packageSkill(skillDir, outputPath) {
+    // Validate that this is a skill directory
+    const skillMdPath = path.join(skillDir, 'SKILL.md');
+    try {
+        await fs.access(skillMdPath);
+    }
+    catch {
+        throw new Error(`Not a valid skill directory: ${skillDir} (missing SKILL.md)`);
+    }
+    // Parse skill to get name
+    const { metadata } = await parseSkillFile(skillMdPath);
+    const skillName = metadata.name;
+    // Determine output path
+    const finalOutputPath = outputPath || path.join(process.cwd(), `${skillName}.skill`);
+    // Create archive
+    const output = createWriteStream(finalOutputPath);
+    const archive = archiver('zip', { zlib: { level: 9 } });
+    archive.on('warning', (err) => {
+        if (err.code === 'ENOENT') {
+            logger.warn('Archive warning:', err);
+        }
+        else {
+            throw err;
+        }
+    });
+    archive.on('error', (err) => {
+        throw err;
+    });
+    archive.pipe(output);
+    // Add skill directory to archive
+    // Exclude common development files
+    archive.glob('**/*', {
+        cwd: skillDir,
+        ignore: [
+            '**/node_modules/**',
+            '**/__pycache__/**',
+            '**/evals/**',
+            '**/.git/**',
+            '**/.DS_Store',
+            '**/Thumbs.db',
+            '**/*.pyc',
+            '**/.env',
+            '**/.venv/**',
+        ],
+    }, { prefix: path.basename(skillDir) });
+    await archive.finalize();
+    return new Promise((resolve, reject) => {
+        output.on('close', () => {
+            logger.info(`Packaged skill: ${finalOutputPath} (${archive.pointer()} bytes)`);
+            resolve(finalOutputPath);
+        });
+        output.on('error', reject);
+    });
+}
+/**
+ * Install a .skill file into a persona's skills directory
+ */
+export async function installSkillFile(skillFile, personaName, personaPath) {
+    // Verify file exists
+    try {
+        await fs.access(skillFile);
+    }
+    catch {
+        throw new Error(`Skill file not found: ${skillFile}`);
+    }
+    // Determine target persona path
+    let targetPersonaPath;
+    if (personaPath) {
+        targetPersonaPath = personaPath;
+    }
+    else {
+        // Install to user-level persona
+        const home = os.homedir();
+        targetPersonaPath = path.join(home, '.jiva', 'personas', personaName);
+    }
+    const skillsDir = path.join(targetPersonaPath, 'skills');
+    // Ensure skills directory exists
+    await fs.mkdir(skillsDir, { recursive: true });
+    // Create temporary extraction directory
+    const tempDir = path.join(os.tmpdir(), `jiva-skill-${Date.now()}`);
+    await fs.mkdir(tempDir, { recursive: true });
+    try {
+        // Extract to temp directory
+        await pipeline(createReadStream(skillFile), unzipper.Extract({ path: tempDir }));
+        // Find the skill directory (should be the only top-level directory)
+        const entries = await fs.readdir(tempDir, { withFileTypes: true });
+        const skillDirs = entries.filter((e) => e.isDirectory());
+        if (skillDirs.length === 0) {
+            throw new Error('Invalid .skill file: no skill directory found');
+        }
+        if (skillDirs.length > 1) {
+            throw new Error('Invalid .skill file: multiple top-level directories found');
+        }
+        const extractedSkillDir = path.join(tempDir, skillDirs[0].name);
+        // Validate it's a proper skill
+        const skillMdPath = path.join(extractedSkillDir, 'SKILL.md');
+        const { metadata } = await parseSkillFile(skillMdPath);
+        // Move to final location
+        const finalSkillPath = path.join(skillsDir, metadata.name);
+        // Check if skill already exists
+        try {
+            await fs.access(finalSkillPath);
+            throw new Error(`Skill ${metadata.name} already exists in ${personaName}. Remove it first or use --force.`);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+        // Move skill to final location
+        await fs.rename(extractedSkillDir, finalSkillPath);
+        logger.info(`Installed skill: ${metadata.name} → ${personaName} (${finalSkillPath})`);
+        return finalSkillPath;
+    }
+    finally {
+        // Cleanup temp directory
+        try {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+        catch (error) {
+            logger.warn(`Failed to cleanup temp directory: ${tempDir}`);
+        }
+    }
+}
+/**
+ * Uninstall a skill from a persona
+ */
+export async function uninstallSkill(skillName, personaName, personaPath) {
+    // Determine persona path
+    let targetPersonaPath;
+    if (personaPath) {
+        targetPersonaPath = personaPath;
+    }
+    else {
+        const home = os.homedir();
+        targetPersonaPath = path.join(home, '.jiva', 'personas', personaName);
+    }
+    const skillPath = path.join(targetPersonaPath, 'skills', skillName);
+    // Verify skill exists
+    try {
+        await fs.access(skillPath);
+    }
+    catch {
+        throw new Error(`Skill not found: ${skillName} in persona ${personaName}`);
+    }
+    // Remove skill directory
+    await fs.rm(skillPath, { recursive: true, force: true });
+    logger.info(`Uninstalled skill: ${skillName} from ${personaName}`);
+}
+/**
+ * Create a new empty skill directory structure
+ */
+export async function createSkill(skillName, outputDir, options = {}) {
+    const skillPath = path.join(outputDir, skillName);
+    // Check if directory already exists
+    try {
+        await fs.access(skillPath);
+        throw new Error(`Skill directory already exists: ${skillPath}`);
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+    // Create directory structure
+    await fs.mkdir(skillPath, { recursive: true });
+    await fs.mkdir(path.join(skillPath, 'scripts'), { recursive: true });
+    await fs.mkdir(path.join(skillPath, 'references'), { recursive: true });
+    await fs.mkdir(path.join(skillPath, 'assets'), { recursive: true });
+    // Create SKILL.md template
+    const skillMdContent = `---
+name: ${skillName}
+description: >
+  ${options.description || 'Add a detailed description here that explains when this skill should be used.'}
+  List all trigger phrases and keywords that would indicate this skill is relevant.
+${options.license ? `license: ${options.license}\n` : ''}${options.author
+        ? `metadata:\n  author: ${options.author}\n  version: 1.0.0\n`
+        : ''}---
+
+# ${skillName.split('-').map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(' ')}
+
+## Overview
+One-liner of what this skill does.
+
+## Workflow
+Step-by-step instructions the agent follows:
+
+1. First, do this
+2. Then do that
+3. Finally, output in this format
+
+## Resources
+- Use \`scripts/example.sh\` for basic operations
+- Read \`references/api.md\` when integrating with external services
+- Refer to \`assets/template.txt\` for output formatting
+`;
+    await fs.writeFile(path.join(skillPath, 'SKILL.md'), skillMdContent);
+    // Create example script
+    const exampleScript = `#!/bin/bash
+# Example script for ${skillName}
+# Add your script logic here
+echo "Hello from ${skillName}"
+`;
+    await fs.writeFile(path.join(skillPath, 'scripts', 'example.sh'), exampleScript);
+    await fs.chmod(path.join(skillPath, 'scripts', 'example.sh'), 0o755);
+    // Create example reference
+    const exampleReference = `# ${skillName} Reference
+
+Add detailed documentation, API references, or other reference material here.
+
+This content is loaded on-demand (L3) when the agent needs it during execution.
+`;
+    await fs.writeFile(path.join(skillPath, 'references', 'api.md'), exampleReference);
+    logger.info(`Created skill: ${skillPath}`);
+    return skillPath;
+}
+//# sourceMappingURL=skill-packager.js.map

package/dist/personas/skill-packager.js.map

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

package/dist/personas/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Type definitions for Jiva Skills and Personas (Plugins)
+ *
+ * 100% compatible with Claude's Skills/Plugins system
+ */
+/**
+ * Skill metadata from YAML frontmatter (L1 - always loaded)
+ */
+export interface SkillMetadata {
+    /** Skill name: kebab-case, max 64 chars, no leading/trailing/consecutive hyphens */
+    name: string;
+    /** Description: max 1024 chars, no angle brackets. This is the TRIGGER for routing. */
+    description: string;
+    /** Optional license identifier (e.g., MIT, Apache-2.0) */
+    license?: string;
+    /** Optional compatibility notes (max 500 chars) */
+    compatibility?: string;
+    /** Optional list of allowed tools this skill can use */
+    allowedTools?: string[];
+    /** Optional arbitrary metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Full skill with path and loading state
+ */
+export interface Skill {
+    /** Skill metadata from frontmatter */
+    metadata: SkillMetadata;
+    /** Absolute path to the skill directory */
+    path: string;
+    /** Whether L2 (SKILL.md body) has been loaded */
+    loaded: boolean;
+    /** Full SKILL.md content (undefined until L2 load) */
+    content?: string;
+    /** Parent persona name (for namespacing) */
+    personaName: string;
+}
+/**
+ * Plugin/Persona manifest (.claude-plugin/plugin.json)
+ */
+export interface PersonaManifest {
+    /** Persona name: kebab-case identifier */
+    name: string;
+    /** Short description of persona capabilities */
+    description: string;
+    /** Semantic version (e.g., "1.0.0") */
+    version: string;
+    /** Author information */
+    author?: {
+        name: string;
+        email?: string;
+        url?: string;
+    };
+    /** License identifier */
+    license?: string;
+    /** Homepage or repository URL */
+    homepage?: string;
+    /** Minimum required Jiva version */
+    jivaVersion?: string;
+}
+/**
+ * Command definition (user-invoked via slash commands)
+ */
+export interface PersonaCommand {
+    /** Command name */
+    name: string;
+    /** Full path to command definition markdown */
+    path: string;
+    /** Command description */
+    description?: string;
+}
+/**
+ * Agent definition (spawned as subagents)
+ */
+export interface PersonaAgent {
+    /** Agent name */
+    name: string;
+    /** Full path to agent definition markdown */
+    path: string;
+    /** Agent description */
+    description?: string;
+}
+/**
+ * Hook definition (event handlers)
+ */
+export interface PersonaHook {
+    /** Event name (e.g., "beforeMessage", "afterResponse") */
+    event: string;
+    /** Hook handler script path */
+    handler: string;
+    /** Hook priority (higher = runs first) */
+    priority?: number;
+}
+/**
+ * Full persona with all components loaded
+ */
+export interface Persona {
+    /** Persona manifest */
+    manifest: PersonaManifest;
+    /** Root directory path */
+    path: string;
+    /** All discovered skills (L1 metadata only initially) */
+    skills: Skill[];
+    /** All discovered commands */
+    commands: PersonaCommand[];
+    /** All discovered agents */
+    agents: PersonaAgent[];
+    /** All discovered hooks */
+    hooks: PersonaHook[];
+    /** MCP server configurations from .mcp.json */
+    mcpServers?: Record<string, any>;
+    /** Whether persona is currently active */
+    active: boolean;
+}
+/**
+ * Skill validation error
+ */
+export interface SkillValidationError {
+    field: string;
+    message: string;
+    value?: any;
+}
+/**
+ * Skill package metadata (.skill file)
+ */
+export interface SkillPackageMetadata {
+    name: string;
+    version: string;
+    description: string;
+    author?: string;
+    license?: string;
+    dependencies?: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/personas/types.d.ts.map

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

package/dist/personas/types.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for Jiva Skills and Personas (Plugins)
+ *
+ * 100% compatible with Claude's Skills/Plugins system
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/personas/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/personas/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/personas/validator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Skill and Persona validation logic
+ * Enforces frontmatter rules as specified in the implementation guide
+ */
+import { SkillMetadata, SkillValidationError } from './types.js';
+/**
+ * Validate skill metadata from frontmatter
+ */
+export declare function validateSkillMetadata(metadata: Partial<SkillMetadata>): SkillValidationError[];
+/**
+ * Validate that only allowed frontmatter keys are present
+ */
+export declare function validateFrontmatterKeys(frontmatter: Record<string, any>): SkillValidationError[];
+/**
+ * Validate SKILL.md body length (L2 should be < 500 lines)
+ */
+export declare function validateSkillBodyLength(content: string): SkillValidationError[];
+/**
+ * Normalize frontmatter keys (handle kebab-case variants)
+ */
+export declare function normalizeFrontmatter(frontmatter: Record<string, any>): SkillMetadata;
+//# sourceMappingURL=validator.d.ts.map

package/dist/personas/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/personas/validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAiBjE;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,GAC/B,oBAAoB,EAAE,CAmFxB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,oBAAoB,EAAE,CAehG;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAa/E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa,CASpF"}