jiva-core 0.2.2 → 0.3.1

package/dist/personas/persona-loader.js

@@ -0,0 +1,246 @@
+/**
+ * Persona (Plugin) loader - discovers and loads complete personas
+ * Handles skills, commands, agents, hooks, and MCP server configurations
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import { discoverSkills } from './skill-loader.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Default persona search paths (user-level and project-level)
+ */
+export function getDefaultPersonaPaths() {
+    const home = os.homedir();
+    return [
+        path.join(home, '.jiva', 'personas'), // User-level
+        path.join(process.cwd(), '.jiva', 'personas'), // Project-level
+    ];
+}
+/**
+ * Find the plugin manifest file (checks both .jiva-plugin and .claude-plugin)
+ */
+async function findPluginManifest(personaPath) {
+    // Prefer .jiva-plugin but fall back to .claude-plugin for compatibility
+    const jivaManifest = path.join(personaPath, '.jiva-plugin', 'plugin.json');
+    const claudeManifest = path.join(personaPath, '.claude-plugin', 'plugin.json');
+    try {
+        await fs.access(jivaManifest);
+        return jivaManifest;
+    }
+    catch {
+        // Fall back to .claude-plugin
+        await fs.access(claudeManifest);
+        return claudeManifest;
+    }
+}
+/**
+ * Load persona manifest from .jiva-plugin/plugin.json or .claude-plugin/plugin.json
+ */
+export async function loadPersonaManifest(manifestPath) {
+    try {
+        const content = await fs.readFile(manifestPath, 'utf-8');
+        const manifest = JSON.parse(content);
+        // Validate required fields
+        if (!manifest.name) {
+            throw new Error('Persona manifest missing required field: name');
+        }
+        if (!manifest.description) {
+            throw new Error('Persona manifest missing required field: description');
+        }
+        if (!manifest.version) {
+            throw new Error('Persona manifest missing required field: version');
+        }
+        return manifest;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new Error(`Persona manifest not found at ${manifestPath}`);
+        }
+        if (error instanceof SyntaxError) {
+            throw new Error(`Invalid JSON in persona manifest ${manifestPath}: ${error.message}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Discover commands in a persona's commands/ directory
+ */
+async function discoverCommands(personaPath) {
+    const commandsDir = path.join(personaPath, 'commands');
+    const commands = [];
+    try {
+        const entries = await fs.readdir(commandsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile() && entry.name.endsWith('.md')) {
+                const commandName = entry.name.replace('.md', '');
+                commands.push({
+                    name: commandName,
+                    path: path.join(commandsDir, entry.name),
+                });
+            }
+        }
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+    return commands;
+}
+/**
+ * Discover agents in a persona's agents/ directory
+ */
+async function discoverAgents(personaPath) {
+    const agentsDir = path.join(personaPath, 'agents');
+    const agents = [];
+    try {
+        const entries = await fs.readdir(agentsDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile() && entry.name.endsWith('.md')) {
+                const agentName = entry.name.replace('.md', '');
+                agents.push({
+                    name: agentName,
+                    path: path.join(agentsDir, entry.name),
+                });
+            }
+        }
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+    return agents;
+}
+/**
+ * Load hooks from a persona's hooks/hooks.json
+ */
+async function loadHooks(personaPath) {
+    const hooksFile = path.join(personaPath, 'hooks', 'hooks.json');
+    try {
+        const content = await fs.readFile(hooksFile, 'utf-8');
+        const hooksData = JSON.parse(content);
+        if (!Array.isArray(hooksData)) {
+            throw new Error('hooks.json must contain an array of hook definitions');
+        }
+        return hooksData;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return []; // No hooks file - that's ok
+        }
+        throw error;
+    }
+}
+/**
+ * Load MCP server configurations from a persona's .mcp.json
+ */
+async function loadMCPServers(personaPath) {
+    const mcpFile = path.join(personaPath, '.mcp.json');
+    try {
+        const content = await fs.readFile(mcpFile, 'utf-8');
+        const mcpData = JSON.parse(content);
+        // Support both { "mcpServers": {...} } and direct {...} formats
+        if (mcpData.mcpServers) {
+            logger.debug(`Loaded ${Object.keys(mcpData.mcpServers).length} MCP servers from ${mcpFile}`);
+            return mcpData.mcpServers;
+        }
+        logger.debug(`Loaded ${Object.keys(mcpData).length} MCP servers from ${mcpFile}`);
+        return mcpData;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            logger.debug(`No MCP config file at ${mcpFile}`);
+            return {}; // No MCP config - that's ok
+        }
+        logger.error(`Error loading MCP servers from ${mcpFile}: ${error}`);
+        throw error;
+    }
+}
+/**
+ * Load a single persona from its directory
+ */
+export async function loadPersona(personaPath) {
+    const manifestPath = await findPluginManifest(personaPath);
+    const manifest = await loadPersonaManifest(manifestPath);
+    // Discover all components
+    const [skills, commands, agents, hooks, mcpServers] = await Promise.all([
+        discoverSkills(path.join(personaPath, 'skills'), manifest.name),
+        discoverCommands(personaPath),
+        discoverAgents(personaPath),
+        loadHooks(personaPath),
+        loadMCPServers(personaPath),
+    ]);
+    const mcpServerCount = Object.keys(mcpServers).length;
+    logger.info(`Loaded persona: ${manifest.name} v${manifest.version} ` +
+        `(${skills.length} skills, ${commands.length} commands, ${agents.length} agents, ` +
+        `${hooks.length} hooks, ${mcpServerCount} MCP servers)`);
+    return {
+        manifest,
+        path: personaPath,
+        skills,
+        commands,
+        agents,
+        hooks,
+        mcpServers,
+        active: false,
+    };
+}
+/**
+ * Discover all personas in a directory
+ */
+export async function discoverPersonasInPath(basePath) {
+    const personas = [];
+    try {
+        const entries = await fs.readdir(basePath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const personaPath = path.join(basePath, entry.name);
+            try {
+                // Check if this is a valid persona directory (has plugin manifest)
+                await findPluginManifest(personaPath);
+                const persona = await loadPersona(personaPath);
+                personas.push(persona);
+            }
+            catch (error) {
+                // Skip invalid persona directories
+                logger.debug(`Skipping ${personaPath}: ${error instanceof Error ? error.message : error}`);
+            }
+        }
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            // Directory doesn't exist - that's ok
+            return [];
+        }
+        throw error;
+    }
+    return personas;
+}
+/**
+ * Discover all personas from default search paths
+ */
+export async function discoverAllPersonas(additionalPaths = []) {
+    const searchPaths = [...getDefaultPersonaPaths(), ...additionalPaths];
+    const allPersonas = [];
+    const personaMap = new Map();
+    // Scan all paths, later sources override earlier ones
+    for (const searchPath of searchPaths) {
+        const personas = await discoverPersonasInPath(searchPath);
+        for (const persona of personas) {
+            personaMap.set(persona.manifest.name, persona);
+        }
+    }
+    allPersonas.push(...personaMap.values());
+    logger.info(`Discovered ${allPersonas.length} personas from ${searchPaths.length} search paths`);
+    return allPersonas;
+}
+/**
+ * Find a persona by name from discovered personas
+ */
+export function findPersona(personas, name) {
+    return personas.find((p) => p.manifest.name === name);
+}
+//# sourceMappingURL=persona-loader.js.map

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

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

package/dist/personas/persona-manager.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Persona Manager - Central controller for persona lifecycle and skill routing
+ * Handles discovery, activation, and integration with the agent system
+ */
+import { Persona, Skill } from './types.js';
+export declare class PersonaManager {
+    private personas;
+    private activePersona;
+    private additionalSearchPaths;
+    private configManager;
+    constructor(additionalPaths?: string[]);
+    /**
+     * Initialize the persona manager by discovering all available personas
+     */
+    initialize(): Promise<void>;
+    /**
+     * Refresh persona list (re-scan directories)
+     */
+    refresh(): Promise<void>;
+    /**
+     * Get all discovered personas
+     */
+    getPersonas(): Persona[];
+    /**
+     * Get the currently active persona
+     */
+    getActivePersona(): Persona | null;
+    /**
+     * Activate a persona by name
+     */
+    activatePersona(name: string): boolean;
+    /**
+     * Deactivate the current persona
+     */
+    deactivatePersona(): void;
+    /**
+     * Get all skills from the active persona (L1 metadata only)
+     */
+    getActiveSkills(): Skill[];
+    /**
+     * Get all skills from all personas (for global skill search)
+     */
+    getAllSkills(): Skill[];
+    /**
+     * Find a skill by name in the active persona
+     */
+    findSkill(skillName: string): Skill | undefined;
+    /**
+     * Load L2 content for a skill (called by agent when skill is selected)
+     */
+    loadSkill(skillName: string): Promise<Skill | null>;
+    /**
+     * Generate the <available_skills> XML block for agent system prompt
+     * This is L1 - just metadata for routing
+     */
+    generateSkillsPromptBlock(): string;
+    /**
+     * Generate persona context for system prompt
+     */
+    generatePersonaPromptBlock(): string;
+    /**
+     * Get full system prompt addition (persona + skills)
+     */
+    getSystemPromptAddition(): string;
+    /**
+     * Check if a persona is installed
+     */
+    hasPersona(name: string): boolean;
+    /**
+     * Get persona info by name
+     */
+    getPersona(name: string): Persona | undefined;
+    /**
+     * Get MCP servers from active persona
+     */
+    getPersonaMCPServers(): Record<string, any>;
+    /**
+     * Escape XML special characters
+     */
+    private escapeXml;
+}
+//# sourceMappingURL=persona-manager.d.ts.map

package/dist/personas/persona-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-manager.d.ts","sourceRoot":"","sources":["../../src/personas/persona-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAU5C,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,qBAAqB,CAAgB;IAC7C,OAAO,CAAC,aAAa,CAAgB;gBAEzB,eAAe,GAAE,MAAM,EAAO;IAK1C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;OAEG;IACH,WAAW,IAAI,OAAO,EAAE;IAIxB;;OAEG;IACH,gBAAgB,IAAI,OAAO,GAAG,IAAI;IAIlC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IA4BtC;;OAEG;IACH,iBAAiB,IAAI,IAAI;IASzB;;OAEG;IACH,eAAe,IAAI,KAAK,EAAE;IAI1B;;OAEG;IACH,YAAY,IAAI,KAAK,EAAE;IAIvB;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAI/C;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAgBzD;;;OAGG;IACH,yBAAyB,IAAI,MAAM;IAsBnC;;OAEG;IACH,0BAA0B,IAAI,MAAM;IAgBpC;;OAEG;IACH,uBAAuB,IAAI,MAAM;IAmBjC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI7C;;OAEG;IACH,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI3C;;OAEG;IACH,OAAO,CAAC,SAAS;CAQlB"}

package/dist/personas/persona-manager.js

@@ -0,0 +1,211 @@
+/**
+ * Persona Manager - Central controller for persona lifecycle and skill routing
+ * Handles discovery, activation, and integration with the agent system
+ */
+import { discoverAllPersonas, findPersona, getDefaultPersonaPaths, } from './persona-loader.js';
+import { loadSkillContent } from './skill-loader.js';
+import { logger } from '../utils/logger.js';
+import { ConfigManager } from '../core/config.js';
+export class PersonaManager {
+    personas = [];
+    activePersona = null;
+    additionalSearchPaths = [];
+    configManager;
+    constructor(additionalPaths = []) {
+        this.additionalSearchPaths = additionalPaths;
+        this.configManager = ConfigManager.getInstance();
+    }
+    /**
+     * Initialize the persona manager by discovering all available personas
+     */
+    async initialize() {
+        logger.info('Initializing Persona Manager...');
+        this.personas = await discoverAllPersonas(this.additionalSearchPaths);
+        if (this.personas.length === 0) {
+            logger.info('No personas found in search paths:', getDefaultPersonaPaths());
+        }
+        else {
+            logger.info(`Initialized with ${this.personas.length} personas:`, this.personas.map((p) => p.manifest.name).join(', '));
+            // Restore active persona from config
+            const savedPersonaName = this.configManager.getActivePersona();
+            if (savedPersonaName) {
+                const success = this.activatePersona(savedPersonaName);
+                if (success) {
+                    logger.info(`Restored active persona: ${savedPersonaName}`);
+                }
+                else {
+                    logger.warn(`Saved persona '${savedPersonaName}' not found, clearing config`);
+                    this.configManager.setActivePersona(null);
+                }
+            }
+        }
+    }
+    /**
+     * Refresh persona list (re-scan directories)
+     */
+    async refresh() {
+        await this.initialize();
+    }
+    /**
+     * Get all discovered personas
+     */
+    getPersonas() {
+        return this.personas;
+    }
+    /**
+     * Get the currently active persona
+     */
+    getActivePersona() {
+        return this.activePersona;
+    }
+    /**
+     * Activate a persona by name
+     */
+    activatePersona(name) {
+        const persona = findPersona(this.personas, name);
+        if (!persona) {
+            logger.warn(`Persona not found: ${name}`);
+            return false;
+        }
+        // Deactivate current persona if any
+        if (this.activePersona) {
+            this.activePersona.active = false;
+        }
+        this.activePersona = persona;
+        persona.active = true;
+        // Persist to config
+        this.configManager.setActivePersona(persona.manifest.name);
+        const mcpServerCount = persona.mcpServers ? Object.keys(persona.mcpServers).length : 0;
+        logger.info(`Activated persona: ${persona.manifest.name} ` +
+            `(${persona.skills.length} skills, ${mcpServerCount} MCP servers)`);
+        return true;
+    }
+    /**
+     * Deactivate the current persona
+     */
+    deactivatePersona() {
+        if (this.activePersona) {
+            this.activePersona.active = false;
+            logger.info(`Deactivated persona: ${this.activePersona.manifest.name}`);
+            this.activePersona = null;
+            this.configManager.setActivePersona(null);
+        }
+    }
+    /**
+     * Get all skills from the active persona (L1 metadata only)
+     */
+    getActiveSkills() {
+        return this.activePersona?.skills || [];
+    }
+    /**
+     * Get all skills from all personas (for global skill search)
+     */
+    getAllSkills() {
+        return this.personas.flatMap((p) => p.skills);
+    }
+    /**
+     * Find a skill by name in the active persona
+     */
+    findSkill(skillName) {
+        return this.activePersona?.skills.find((s) => s.metadata.name === skillName);
+    }
+    /**
+     * Load L2 content for a skill (called by agent when skill is selected)
+     */
+    async loadSkill(skillName) {
+        const skill = this.findSkill(skillName);
+        if (!skill) {
+            logger.warn(`Skill not found: ${skillName}`);
+            return null;
+        }
+        if (!skill.loaded) {
+            await loadSkillContent(skill);
+            logger.info(`Loaded skill content: ${skill.personaName}:${skill.metadata.name}`);
+        }
+        return skill;
+    }
+    /**
+     * Generate the <available_skills> XML block for agent system prompt
+     * This is L1 - just metadata for routing
+     */
+    generateSkillsPromptBlock() {
+        const skills = this.getActiveSkills();
+        if (skills.length === 0) {
+            return '';
+        }
+        const skillsXml = skills
+            .map((skill) => `<skill>
+  <name>${this.escapeXml(skill.metadata.name)}</name>
+  <description>${this.escapeXml(skill.metadata.description)}</description>
+  <location>${this.escapeXml(skill.path)}/SKILL.md</location>
+</skill>`)
+            .join('\n');
+        return `<available_skills>
+${skillsXml}
+</available_skills>`;
+    }
+    /**
+     * Generate persona context for system prompt
+     */
+    generatePersonaPromptBlock() {
+        if (!this.activePersona) {
+            return '';
+        }
+        const persona = this.activePersona;
+        return `<active_persona>
+  <name>${this.escapeXml(persona.manifest.name)}</name>
+  <description>${this.escapeXml(persona.manifest.description)}</description>
+  <version>${persona.manifest.version}</version>
+  <skills_count>${persona.skills.length}</skills_count>
+  <commands_count>${persona.commands.length}</commands_count>
+</active_persona>`;
+    }
+    /**
+     * Get full system prompt addition (persona + skills)
+     */
+    getSystemPromptAddition() {
+        if (!this.activePersona) {
+            return '';
+        }
+        const personaBlock = this.generatePersonaPromptBlock();
+        const skillsBlock = this.generateSkillsPromptBlock();
+        if (!skillsBlock) {
+            return personaBlock;
+        }
+        return `${personaBlock}
+
+${skillsBlock}
+
+When a user's request matches a skill description, read that skill's SKILL.md file using the view tool to get detailed instructions. Skills use progressive disclosure - only load what you need when you need it.`;
+    }
+    /**
+     * Check if a persona is installed
+     */
+    hasPersona(name) {
+        return this.personas.some((p) => p.manifest.name === name);
+    }
+    /**
+     * Get persona info by name
+     */
+    getPersona(name) {
+        return findPersona(this.personas, name);
+    }
+    /**
+     * Get MCP servers from active persona
+     */
+    getPersonaMCPServers() {
+        return this.activePersona?.mcpServers || {};
+    }
+    /**
+     * Escape XML special characters
+     */
+    escapeXml(text) {
+        return text
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&apos;');
+    }
+}
+//# sourceMappingURL=persona-manager.js.map

package/dist/personas/persona-manager.js.map

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

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

@@ -0,0 +1,35 @@
+/**
+ * Skill loader - parses SKILL.md files with YAML frontmatter
+ * Implements progressive disclosure: L1 (metadata) → L2 (body) → L3 (references)
+ */
+import { Skill, SkillMetadata } from './types.js';
+/**
+ * Parse SKILL.md file and extract frontmatter + body
+ */
+export declare function parseSkillFile(filePath: string): Promise<{
+    metadata: SkillMetadata;
+    body: string;
+    fullContent: string;
+}>;
+/**
+ * Discover all skills in a directory (L1 only - metadata)
+ * Each subdirectory with a SKILL.md is a skill
+ */
+export declare function discoverSkills(skillsDir: string, personaName: string): Promise<Skill[]>;
+/**
+ * Load L2 (full SKILL.md body) for a skill
+ */
+export declare function loadSkillContent(skill: Skill): Promise<void>;
+/**
+ * Get path to a skill resource (L3 - references, scripts, assets)
+ */
+export declare function getSkillResourcePath(skill: Skill, resourceType: 'scripts' | 'references' | 'assets', filename: string): string;
+/**
+ * Check if a skill has a specific resource
+ */
+export declare function hasSkillResource(skill: Skill, resourceType: 'scripts' | 'references' | 'assets', filename: string): Promise<boolean>;
+/**
+ * List all resources of a type in a skill
+ */
+export declare function listSkillResources(skill: Skill, resourceType: 'scripts' | 'references' | 'assets'): Promise<string[]>;
+//# sourceMappingURL=skill-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/personas/skill-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAWlD;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAiDzE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,KAAK,EAAE,CAAC,CAyClB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,GAAG,YAAY,GAAG,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9H;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,SAAS,GAAG,YAAY,GAAG,QAAQ,EACjD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,SAAS,GAAG,YAAY,GAAG,QAAQ,GAChD,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB"}