@plusplusoneplusplus/coc 1.0.0

package/node_modules/@plusplusoneplusplus/forge/dist/skills/skill-installer.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * Skill installer for copying skills from sources to the workspace
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installSkills = installSkills;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const utils_1 = require("../utils");
+const logger_1 = require("../logger");
+const github_api_utils_1 = require("./github-api-utils");
+/**
+ * Check if gh CLI is available
+ */
+async function isGhCliAvailable() {
+    try {
+        await (0, utils_1.execAsync)('gh --version');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Install selected skills to the target directory
+ * @param skills Skills to install
+ * @param source Source information
+ * @param installPath Target installation path
+ * @param handleConflict Callback to handle skill conflicts (returns true to replace)
+ * @returns Installation result
+ */
+async function installSkills(skills, source, installPath, handleConflict) {
+    const logger = (0, logger_1.getLogger)();
+    const result = {
+        installed: 0,
+        skipped: 0,
+        failed: 0,
+        details: []
+    };
+    (0, utils_1.ensureDirectoryExists)(installPath);
+    for (const skill of skills) {
+        const targetPath = path.join(installPath, skill.name);
+        let detail;
+        try {
+            if ((0, utils_1.safeExists)(targetPath)) {
+                const shouldReplace = await handleConflict(skill.name);
+                if (!shouldReplace) {
+                    detail = {
+                        name: skill.name,
+                        success: true,
+                        action: 'skipped',
+                        reason: 'User declined to replace existing skill'
+                    };
+                    result.skipped++;
+                    result.details.push(detail);
+                    continue;
+                }
+                fs.rmSync(targetPath, { recursive: true, force: true });
+            }
+            if (source.type === 'github' && source.github) {
+                await installFromGitHub(source.github, skill.path, targetPath);
+            }
+            else if (source.type === 'local' && source.localPath) {
+                await installFromLocal(skill.path, targetPath);
+            }
+            else {
+                throw new Error('Invalid source configuration');
+            }
+            detail = {
+                name: skill.name,
+                success: true,
+                action: skill.alreadyExists ? 'replaced' : 'installed'
+            };
+            result.installed++;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            logger.error(logger_1.LogCategory.GENERAL, `Failed to install skill ${skill.name}`, err);
+            detail = {
+                name: skill.name,
+                success: false,
+                action: 'failed',
+                reason: err.message
+            };
+            result.failed++;
+        }
+        result.details.push(detail);
+    }
+    return result;
+}
+/**
+ * Install a skill from GitHub
+ * Tries HTTP first (works for all public repos with no setup).
+ * Falls back to gh CLI only if HTTP fails (e.g. private repo).
+ */
+async function installFromGitHub(github, skillPath, targetPath) {
+    try {
+        await installFromGitHubWithHttp(github, skillPath, targetPath);
+    }
+    catch (httpErr) {
+        const useGhCli = await isGhCliAvailable();
+        if (!useGhCli)
+            throw httpErr;
+        await installFromGitHubWithGhCli(github, skillPath, targetPath);
+    }
+}
+/**
+ * Install a skill from GitHub using gh CLI
+ */
+async function installFromGitHubWithGhCli(github, skillPath, targetPath) {
+    const logger = (0, logger_1.getLogger)();
+    (0, utils_1.ensureDirectoryExists)(targetPath);
+    const listCmd = `gh api repos/${github.owner}/${github.repo}/contents/${skillPath}?ref=${github.branch}`;
+    const { stdout } = await (0, utils_1.execAsync)(listCmd);
+    const parsed = (0, github_api_utils_1.parseGitHubApiResponse)(stdout);
+    if (!parsed) {
+        throw new Error('Failed to parse GitHub API response');
+    }
+    const items = Array.isArray(parsed) ? parsed : [parsed];
+    for (const item of items) {
+        const itemTargetPath = path.join(targetPath, item.name);
+        if (item.type === 'dir') {
+            const subPath = skillPath ? `${skillPath}/${item.name}` : item.name;
+            await installFromGitHubWithGhCli(github, subPath, itemTargetPath);
+        }
+        else if (item.type === 'file') {
+            if (item.download_url) {
+                const content = await (0, utils_1.httpDownload)(item.download_url);
+                (0, utils_1.safeWriteFile)(itemTargetPath, content);
+                logger.debug(logger_1.LogCategory.GENERAL, `Downloaded: ${item.name}`);
+            }
+            else if (item.content) {
+                const content = Buffer.from(item.content, 'base64').toString('utf-8');
+                (0, utils_1.safeWriteFile)(itemTargetPath, content);
+                logger.debug(logger_1.LogCategory.GENERAL, `Wrote: ${item.name}`);
+            }
+        }
+    }
+}
+/**
+ * Install a skill from GitHub using native HTTP
+ */
+async function installFromGitHubWithHttp(github, skillPath, targetPath) {
+    const logger = (0, logger_1.getLogger)();
+    (0, utils_1.ensureDirectoryExists)(targetPath);
+    const apiUrl = `https://api.github.com/repos/${github.owner}/${github.repo}/contents/${skillPath}?ref=${github.branch}`;
+    const parsed = await (0, utils_1.httpGetJson)(apiUrl);
+    const items = Array.isArray(parsed) ? parsed : [parsed];
+    for (const item of items) {
+        const itemTargetPath = path.join(targetPath, item.name);
+        if (item.type === 'dir') {
+            const subPath = skillPath ? `${skillPath}/${item.name}` : item.name;
+            await installFromGitHubWithHttp(github, subPath, itemTargetPath);
+        }
+        else if (item.type === 'file') {
+            if (item.download_url) {
+                const content = await (0, utils_1.httpDownload)(item.download_url);
+                (0, utils_1.safeWriteFile)(itemTargetPath, content);
+                logger.debug(logger_1.LogCategory.GENERAL, `Downloaded: ${item.name}`);
+            }
+            else if (item.content) {
+                const content = Buffer.from(item.content, 'base64').toString('utf-8');
+                (0, utils_1.safeWriteFile)(itemTargetPath, content);
+                logger.debug(logger_1.LogCategory.GENERAL, `Wrote: ${item.name}`);
+            }
+        }
+    }
+}
+/**
+ * Install a skill from local filesystem
+ */
+async function installFromLocal(sourcePath, targetPath) {
+    const logger = (0, logger_1.getLogger)();
+    (0, utils_1.ensureDirectoryExists)(targetPath);
+    const readResult = (0, utils_1.safeReadDir)(sourcePath);
+    if (!readResult.success || !readResult.data) {
+        throw new Error(`Failed to read source directory: ${sourcePath}`);
+    }
+    for (const item of readResult.data) {
+        const itemSourcePath = path.join(sourcePath, item);
+        const itemTargetPath = path.join(targetPath, item);
+        const statsResult = (0, utils_1.safeStats)(itemSourcePath);
+        if (!statsResult.success || !statsResult.data) {
+            continue;
+        }
+        if (statsResult.data.isDirectory()) {
+            await installFromLocal(itemSourcePath, itemTargetPath);
+        }
+        else if (statsResult.data.isFile()) {
+            const copyResult = (0, utils_1.safeCopyFile)(itemSourcePath, itemTargetPath);
+            if (!copyResult.success) {
+                throw new Error(`Failed to copy file ${item}: ${copyResult.error}`);
+            }
+            logger.debug(logger_1.LogCategory.GENERAL, `Copied: ${item}`);
+        }
+    }
+}
+//# sourceMappingURL=skill-installer.js.map

package/node_modules/@plusplusoneplusplus/forge/dist/skills/skill-installer.js.map

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

package/node_modules/@plusplusoneplusplus/forge/dist/skills/skill-resolver.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Skill Resolver
+ *
+ * Resolves and loads skill prompts from the .github/skills/ directory.
+ * Skills are organized as directories containing a SKILL.md file.
+ *
+ * Skill Structure:
+ * .github/skills/
+ * ├── go-deep/
+ * │   └── SKILL.md              # THE prompt/skill definition (required)
+ * ├── summarizer/
+ * │   └── SKILL.md
+ *
+ * Resolution: skill: "go-deep" → .github/skills/go-deep/SKILL.md
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import { PipelineCoreError } from '../errors';
+export declare const DEFAULT_SKILLS_DIRECTORY = ".github/skills";
+/**
+ * Standard skill filename within a skill directory (required)
+ */
+export declare const SKILL_PROMPT_FILENAME = "SKILL.md";
+/**
+ * Error thrown for skill resolution issues
+ */
+export declare class SkillResolverError extends PipelineCoreError {
+    /** Name of the skill that failed to resolve */
+    readonly skillName: string;
+    /** Path that was searched */
+    readonly searchedPath?: string;
+    constructor(message: string, skillName: string, searchedPath?: string);
+}
+/**
+ * Result of skill resolution
+ */
+export interface SkillResolutionResult {
+    /** The resolved prompt content (frontmatter stripped) */
+    content: string;
+    /** The absolute path to the skill's SKILL.md */
+    resolvedPath: string;
+    /** The skill directory path */
+    skillDirectory: string;
+    /** Whether frontmatter was stripped from the prompt */
+    hadFrontmatter: boolean;
+    /** Skill metadata from SKILL.md frontmatter */
+    metadata?: SkillMetadata;
+}
+/**
+ * Skill metadata parsed from SKILL.md frontmatter
+ */
+export interface SkillMetadata {
+    /** Skill name (from frontmatter or directory name) */
+    name?: string;
+    /** Skill description */
+    description?: string;
+    /** Skill version */
+    version?: string;
+    /** Expected input variables */
+    variables?: string[];
+    /** Expected output fields */
+    output?: string[];
+    /** Raw metadata content */
+    raw?: string;
+}
+/**
+ * Get the skills directory path
+ *
+ * @param workspaceRoot The workspace root directory
+ * @param customPath Optional custom skills directory path (relative or absolute)
+ * @returns Absolute path to the skills directory
+ */
+export declare function getSkillsDirectory(workspaceRoot: string, customPath?: string): string;
+/**
+ * Get the path to a specific skill's directory
+ *
+ * @param skillName Name of the skill
+ * @param workspaceRoot The workspace root directory
+ * @param customSkillsPath Optional custom skills directory path
+ * @returns Absolute path to the skill directory
+ */
+export declare function getSkillDirectory(skillName: string, workspaceRoot: string, customSkillsPath?: string): string;
+/**
+ * Get the path to a skill's SKILL.md file
+ *
+ * @param skillName Name of the skill
+ * @param workspaceRoot The workspace root directory
+ * @param customSkillsPath Optional custom skills directory path
+ * @returns Absolute path to the skill's SKILL.md file
+ */
+export declare function getSkillPromptPath(skillName: string, workspaceRoot: string, customSkillsPath?: string): string;
+/**
+ * Check if a skill exists
+ *
+ * @param skillName Name of the skill
+ * @param workspaceRoot The workspace root directory
+ * @param customSkillsPath Optional custom skills directory path
+ * @returns True if the skill's SKILL.md exists
+ */
+export declare function skillExists(skillName: string, workspaceRoot: string, customSkillsPath?: string): boolean;
+/**
+ * List all available skills
+ *
+ * @param workspaceRoot The workspace root directory
+ * @param customSkillsPath Optional custom skills directory path
+ * @returns Array of skill names
+ */
+export declare function listSkills(workspaceRoot: string, customSkillsPath?: string): string[];
+/**
+ * Resolve and load a skill's prompt
+ *
+ * This is the main API for loading skill prompts.
+ *
+ * @param skillName Name of the skill (e.g., "go-deep")
+ * @param workspaceRoot The workspace root directory
+ * @param customSkillsPath Optional custom skills directory path
+ * @returns Prompt content string (frontmatter stripped)
+ * @throws SkillResolverError if skill not found or empty
+ *
+ * @example
+ * // Load a skill prompt
+ * const prompt = await resolveSkill('go-deep', '/path/to/workspace');
+ */
+export declare function resolveSkill(skillName: string, workspaceRoot: string, customSkillsPath?: string): Promise<string>;
+/**
+ * Resolve and load a skill's prompt synchronously
+ *
+ * @param skillName Name of the skill
+ * @param workspaceRoot The workspace root directory
+ * @param customSkillsPath Optional custom skills directory path
+ * @returns Prompt content string (frontmatter stripped)
+ * @throws SkillResolverError if skill not found or empty
+ */
+export declare function resolveSkillSync(skillName: string, workspaceRoot: string, customSkillsPath?: string): string;
+/**
+ * Resolve and load a skill with full details
+ *
+ * @param skillName Name of the skill
+ * @param workspaceRoot The workspace root directory
+ * @param customSkillsPath Optional custom skills directory path
+ * @returns Full resolution result with content, paths, and metadata
+ * @throws SkillResolverError if skill not found or empty
+ */
+export declare function resolveSkillWithDetails(skillName: string, workspaceRoot: string, customSkillsPath?: string): Promise<SkillResolutionResult>;
+/**
+ * Resolve and load a skill with full details synchronously
+ */
+export declare function resolveSkillWithDetailsSync(skillName: string, workspaceRoot: string, customSkillsPath?: string): SkillResolutionResult;
+/**
+ * Validate that a skill can be resolved (for config validation)
+ *
+ * @param skillName Name of the skill
+ * @param workspaceRoot The workspace root directory
+ * @param customSkillsPath Optional custom skills directory path
+ * @returns Validation result with error message if invalid
+ */
+export declare function validateSkill(skillName: string, workspaceRoot: string, customSkillsPath?: string): {
+    valid: boolean;
+    error?: string;
+    skillPath?: string;
+};
+//# sourceMappingURL=skill-resolver.d.ts.map

package/node_modules/@plusplusoneplusplus/forge/dist/skills/skill-resolver.d.ts.map

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