@plusplusoneplusplus/coc 1.0.0

package/node_modules/@plusplusoneplusplus/forge/dist/tasks/task-prompt-builder.js

@@ -0,0 +1,380 @@
+"use strict";
+/**
+ * Task Prompt Builder
+ *
+ * Pure-Node prompt-building functions for AI task generation.
+ * Extracted from the VS Code extension's ai-task-commands.ts for reuse
+ * in CLI tools and the CoC server without any VS Code dependencies.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+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.AUTO_FOLDER_SENTINEL = void 0;
+exports.buildCreateTaskPrompt = buildCreateTaskPrompt;
+exports.buildCreateTaskPromptWithName = buildCreateTaskPromptWithName;
+exports.buildCreateFromFeaturePrompt = buildCreateFromFeaturePrompt;
+exports.applyDeepModePrefix = applyDeepModePrefix;
+exports.buildDeepModePrompt = buildDeepModePrompt;
+exports.gatherFeatureContext = gatherFeatureContext;
+exports.parseCreatedFilePath = parseCreatedFilePath;
+exports.buildPlanGenerationSystemPrompt = buildPlanGenerationSystemPrompt;
+exports.buildAutoFolderLocationBlock = buildAutoFolderLocationBlock;
+exports.cleanAIResponse = cleanAIResponse;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const path_utils_1 = require("../utils/path-utils");
+const related_items_loader_1 = require("./related-items-loader");
+/** Sentinel value indicating the AI should choose the target subfolder automatically. */
+exports.AUTO_FOLDER_SENTINEL = '__auto__';
+// ============================================================================
+// Content truncation limit
+// ============================================================================
+/** Maximum character length for plan/spec content before truncation */
+const MAX_CONTENT_LENGTH = 2000;
+// ============================================================================
+// Prompt Builders
+// ============================================================================
+/**
+ * Returns the IMPORTANT block shared by all task-prompt functions.
+ *
+ * @param targetPath     - Forward-slash path already normalised by caller.
+ * @param filenameLines  - Zero or more bullet lines describing the expected filename.
+ * @param extraLines     - Additional numbered items appended after the location block.
+ */
+function buildImportantSection(targetPath, filenameLines, extraLines) {
+    const filenamePart = filenameLines.length > 0
+        ? '\n' + filenameLines.join('\n')
+        : '';
+    const extraPart = extraLines && extraLines.length > 0
+        ? '\n' + extraLines.map((line, i) => `${i + 2}. ${line}`).join('\n')
+        : '';
+    return `**IMPORTANT: Output Location Requirement**
+1. You MUST save the file to this EXACT directory: ${targetPath}${filenamePart}
+- Do NOT save to any other location
+- Do NOT use your session state or any other directory${extraPart}`;
+}
+/**
+ * Build prompt for creating a task from scratch (no name provided).
+ */
+function buildCreateTaskPrompt(description, targetPath) {
+    targetPath = (0, path_utils_1.toForwardSlashes)(targetPath);
+    const important = buildImportantSection(targetPath, ['- Create a single .plan.md file'], ['You MUST NOT implement the task, you are only responsible for creating the plan file.']);
+    return `Can you draft a plan given user's ask: ${description}
+
+${important}`;
+}
+/**
+ * Build prompt for creating a task with a specific name.
+ * If name is empty/undefined, prompts AI to generate a filename.
+ * If autoFolderContext is provided, replaces the fixed save-path block with
+ * folder-selection instructions so the AI picks or creates the best subfolder.
+ */
+function buildCreateTaskPromptWithName(name, description, targetPath, autoFolderContext) {
+    targetPath = (0, path_utils_1.toForwardSlashes)(targetPath);
+    const descriptionPart = description
+        ? `\n\nDescription: ${description}`
+        : '';
+    // --- Auto-folder mode ---
+    if (autoFolderContext) {
+        const tasksRoot = (0, path_utils_1.toForwardSlashes)(autoFolderContext.tasksRoot);
+        const filtered = autoFolderContext.existingFolders
+            .filter(f => f !== 'archive' && !f.startsWith('archive/'));
+        const folderList = filtered.length > 0
+            ? filtered.join(', ')
+            : '(none yet)';
+        if (name && name.trim()) {
+            const descLine = description ? `\n${description}` : '';
+            return `Create a task plan document for: ${name}${descLine}
+
+<rule>
+Save location: ${tasksRoot}/<chosen-folder>/${name}.plan.md
+Folder options: ${folderList}
+Rules: pick the most relevant folder or create a new one (kebab-case, ≤3 words); do not save to the tasks root directly.
+</rule>`;
+        }
+        else {
+            const desc = description || '(General task)';
+            return `Create a task plan document for: ${desc}
+
+<rule>
+Save location: ${tasksRoot}/<chosen-folder>/<descriptive-name>.plan.md
+Folder options: ${folderList}
+Rules: pick the most relevant folder or create a new one (kebab-case, ≤3 words); do not save to the tasks root directly.
+</rule>`;
+        }
+    }
+    // --- Fixed-path mode ---
+    if (name && name.trim()) {
+        const filenameLines = [
+            `- Full file path: ${targetPath}/${name}.plan.md`,
+            `- The file MUST be created at: ${targetPath}/${name}.plan.md`,
+        ];
+        const important = buildImportantSection(targetPath, filenameLines);
+        return `Create a task document for: ${name}${descriptionPart}
+
+Generate a comprehensive markdown task document with:
+- Clear title and description
+- Acceptance criteria
+- Subtasks (if applicable)
+- Notes section
+
+${important}`;
+    }
+    else {
+        const filenameLines = [
+            `- Example: ${targetPath}/your-generated-name.plan.md`,
+            `- The file MUST be created directly under: ${targetPath}/`,
+        ];
+        const important = buildImportantSection(targetPath, filenameLines);
+        return `Create a task document based on this description:${descriptionPart || '\n\n(General task)'}
+
+Generate a comprehensive markdown task document with:
+- Clear title and description
+- Acceptance criteria
+- Subtasks (if applicable)
+- Notes section
+
+Choose an appropriate filename based on the task content.
+The filename should be in kebab-case, descriptive, and end with .plan.md (e.g., "oauth2-authentication.plan.md").
+
+${important}`;
+    }
+}
+/**
+ * Build prompt for creating a task from feature context.
+ *
+ * @param context - The selected feature context
+ * @param focus - Task focus/description
+ * @param name - Optional task name for the filename
+ * @param targetPath - Target directory path
+ */
+function buildCreateFromFeaturePrompt(context, focus, name, targetPath) {
+    targetPath = (0, path_utils_1.toForwardSlashes)(targetPath);
+    let contextText = '';
+    if (context.description) {
+        contextText += `Feature Description:\n${context.description}\n\n`;
+    }
+    if (context.planContent) {
+        const planText = context.planContent.length > MAX_CONTENT_LENGTH
+            ? context.planContent.substring(0, MAX_CONTENT_LENGTH) + '\n...(truncated)'
+            : context.planContent;
+        contextText += `Plan Document:\n${planText}\n\n`;
+    }
+    if (context.specContent) {
+        const specText = context.specContent.length > MAX_CONTENT_LENGTH
+            ? context.specContent.substring(0, MAX_CONTENT_LENGTH) + '\n...(truncated)'
+            : context.specContent;
+        contextText += `Spec Document:\n${specText}\n\n`;
+    }
+    if (context.relatedFiles && context.relatedFiles.length > 0) {
+        contextText += `Related Source Files:\n${context.relatedFiles.slice(0, 20).join('\n')}\n\n`;
+    }
+    const filenameLines = name && name.trim()
+        ? [
+            `- Full file path: ${targetPath}/${name}.plan.md`,
+            `- The file MUST be created at: ${targetPath}/${name}.plan.md`,
+        ]
+        : [
+            `- The file should be a .plan.md file (e.g., "${targetPath}/feature-plan.plan.md")`,
+            `- Choose an appropriate filename based on the task content`,
+            `- The filename should be in kebab-case, descriptive, and end with .plan.md`,
+            `- The file MUST be created directly under: ${targetPath}/`,
+        ];
+    const important = buildImportantSection(targetPath, filenameLines);
+    return `Can you draft a plan given User's ask: ${focus || 'Create an implementation task'}
+
+Context:
+${contextText}
+
+${important}`;
+}
+/**
+ * Prepend the go-deep skill instruction to any prompt.
+ * Idempotent: if the prompt already starts with the go-deep prefix, it is returned unchanged.
+ */
+function applyDeepModePrefix(prompt) {
+    const prefix = 'Use go-deep skill when available.';
+    if (prompt.startsWith(prefix)) {
+        return prompt;
+    }
+    return `${prefix}\n\n${prompt}`;
+}
+/**
+ * Build prompt for deep mode task creation.
+ * Prepends instruction to use go-deep skill.
+ */
+function buildDeepModePrompt(context, focus, name, targetPath, _workspaceRoot) {
+    const basePrompt = buildCreateFromFeaturePrompt(context, focus, name, targetPath);
+    return applyDeepModePrefix(basePrompt);
+}
+/**
+ * Gather context from a feature folder (related.yaml, plan.md, spec.md).
+ * Pure Node.js — no VS Code dependencies.
+ */
+async function gatherFeatureContext(folderPath, _workspaceRoot) {
+    const context = { hasContent: false };
+    // Load related.yaml if exists
+    const relatedItems = await (0, related_items_loader_1.loadRelatedItems)(folderPath);
+    if (relatedItems) {
+        context.description = relatedItems.description;
+        context.relatedFiles = relatedItems.items
+            .filter(item => item.type === 'file' && item.path)
+            .map(item => item.path);
+        context.relatedCommits = relatedItems.items
+            .filter(item => item.type === 'commit' && item.hash)
+            .map(item => `${item.hash.substring(0, 7)}: ${item.name}`);
+        context.hasContent = true;
+    }
+    // Read plan.md if exists
+    const planPath = path.join(folderPath, 'plan.md');
+    if (fs.existsSync(planPath)) {
+        context.planContent = await fs.promises.readFile(planPath, 'utf-8');
+        context.hasContent = true;
+    }
+    // Read spec.md if exists
+    const specPath = path.join(folderPath, 'spec.md');
+    if (fs.existsSync(specPath)) {
+        context.specContent = await fs.promises.readFile(specPath, 'utf-8');
+        context.hasContent = true;
+    }
+    // Also check for files with common doc patterns
+    const files = await fs.promises.readdir(folderPath).catch(() => []);
+    for (const file of files) {
+        if (!context.planContent && file.endsWith('.plan.md')) {
+            const filePath = path.join(folderPath, file);
+            context.planContent = await fs.promises.readFile(filePath, 'utf-8');
+            context.hasContent = true;
+        }
+        if (!context.specContent && file.endsWith('.spec.md')) {
+            const filePath = path.join(folderPath, file);
+            context.specContent = await fs.promises.readFile(filePath, 'utf-8');
+            context.hasContent = true;
+        }
+    }
+    return context;
+}
+/**
+ * Parse created file path from AI response.
+ * Looks for markdown file paths in the response text.
+ *
+ * @param response - AI response text
+ * @param targetFolder - Expected target folder for path matching
+ * @returns Absolute file path if found and exists, otherwise undefined
+ */
+function parseCreatedFilePath(response, targetFolder) {
+    if (!response) {
+        return undefined;
+    }
+    const patterns = [
+        // Absolute paths mentioned after create/write verbs
+        /(?:created|wrote|saved|generated)[^`\n]*?([/\\][^\s`"']+\.md)/gi,
+        // Paths in backticks
+        /`([^`]+\.md)`/g,
+        // Any .md path that includes the target folder
+        new RegExp(`(${targetFolder.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[^\\s\`"']+\\.md)`, 'gi'),
+    ];
+    for (const pattern of patterns) {
+        const matches = response.matchAll(pattern);
+        for (const match of matches) {
+            const filePath = match[1];
+            if (filePath && fs.existsSync(filePath)) {
+                return filePath;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Build a system prompt for plan generation that instructs the AI on:
+ * - Output location and file naming conventions
+ * - Plan document structure
+ * - Constraints (plan only, do not implement)
+ *
+ * Returns a system prompt string to be passed via `systemMessage` with `mode: 'append'`.
+ */
+function buildPlanGenerationSystemPrompt(options) {
+    const { autoFolder, tasksRoot, existingFolders } = options;
+    const targetPath = (0, path_utils_1.toForwardSlashes)(options.targetPath);
+    const locationBlock = autoFolder && tasksRoot
+        ? buildAutoFolderLocationBlock((0, path_utils_1.toForwardSlashes)(tasksRoot), existingFolders || [])
+        : buildFixedLocationBlock(targetPath);
+    return `You are a plan generator. Your sole responsibility is to produce a single .plan.md file.
+
+## Output Rules
+${locationBlock}
+- File names MUST be kebab-case and end with \`.plan.md\` (e.g. \`oauth2-authentication.plan.md\`).
+- You MUST NOT implement the plan. Only create the plan document.
+- Do NOT save files to your session state or any directory other than the specified target.
+
+## Plan Document Structure
+The plan file should include:
+- A clear title (H1)
+- Problem statement and proposed approach
+- Acceptance criteria
+- Subtasks broken into actionable items
+- Notes or open questions (if any)`;
+}
+function buildFixedLocationBlock(targetPath) {
+    return `- Save the file to this EXACT directory: \`${targetPath}\``;
+}
+function buildAutoFolderLocationBlock(tasksRoot, existingFolders) {
+    const filtered = existingFolders.filter(f => f !== 'archive' && !f.startsWith('archive/'));
+    const folderList = filtered.length > 0 ? filtered.join(', ') : '(none yet)';
+    return `- Save location: \`${tasksRoot}/<chosen-folder>/<descriptive-name>.plan.md\`
+- Existing folder options: ${folderList}
+- Pick the most relevant folder or create a new one (kebab-case, ≤3 words); do not save to the tasks root directly.
+- Do NOT save to \`.copilot/session-state/\`, your session workspace, or any temporary directory.`;
+}
+/**
+ * Clean AI response — strip code fences if present.
+ */
+function cleanAIResponse(response) {
+    let cleaned = response.trim();
+    if (cleaned.startsWith('```markdown')) {
+        cleaned = cleaned.substring('```markdown'.length);
+    }
+    else if (cleaned.startsWith('```md')) {
+        cleaned = cleaned.substring('```md'.length);
+    }
+    else if (cleaned.startsWith('```')) {
+        cleaned = cleaned.substring(3);
+    }
+    if (cleaned.endsWith('```')) {
+        cleaned = cleaned.substring(0, cleaned.length - 3);
+    }
+    return cleaned.trim();
+}
+//# sourceMappingURL=task-prompt-builder.js.map

package/node_modules/@plusplusoneplusplus/forge/dist/tasks/task-prompt-builder.js.map

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

package/node_modules/@plusplusoneplusplus/forge/dist/tasks/task-scanner.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Task scanning and grouping utilities extracted from the VS Code extension's TaskManager.
+ * Pure Node.js functions with no VS Code dependencies.
+ */
+import { Task, TaskDocument, TaskDocumentGroup, TaskFolder } from './types';
+/** Name of the undo-stack file written alongside the tasks root. */
+export declare const ARCHIVE_UNDO_FILE = ".archive-undo.json";
+/**
+ * Check if a filename is a context/documentation file that should be excluded from task scanning.
+ */
+export declare function isContextFile(fileName: string): boolean;
+/**
+ * Recursively walk a directory and return flat Task[] for each .md file found.
+ * Skips the 'archive' folder when isArchived is false.
+ */
+export declare function scanTasksRecursively(dirPath: string, relativePath: string, isArchived: boolean): Task[];
+/**
+ * Recursively walk a directory and return flat TaskDocument[] for each .md file found.
+ * Additionally parses baseName and docType via parseFileName.
+ * Skips the 'archive' folder when isArchived is false.
+ */
+export declare function scanDocumentsRecursively(dirPath: string, relativePath: string, isArchived: boolean): TaskDocument[];
+/**
+ * Recursively scan directories to build folder structure (including empty folders).
+ * Populates folderMap and parentFolder.children.
+ * Skips the 'archive' folder when isArchived is false.
+ */
+export declare function scanFoldersRecursively(dirPath: string, relativePath: string, isArchived: boolean, folderMap: Map<string, TaskFolder>, parentFolder: TaskFolder): void;
+/**
+ * Scan a single directory for context/documentation .md files (non-recursive).
+ * Returns TaskDocument[] for files that match isContextFile().
+ */
+export declare function scanContextDocumentsInFolder(dirPath: string, relativePath: string, isArchived: boolean): TaskDocument[];
+/**
+ * Group documents by composite key: baseName|archived/active|relativePath.
+ * Documents sharing a key with count > 1 become a TaskDocumentGroup; singletons go to singles.
+ */
+export declare function groupTaskDocuments(documents: TaskDocument[]): {
+    groups: TaskDocumentGroup[];
+    singles: TaskDocument[];
+};
+/**
+ * Build a hierarchical TaskFolder tree from documents.
+ * Scans directories for folder structure, creates intermediate folders for document paths,
+ * and assigns groups and singles to their respective folders.
+ *
+ * @returns The root TaskFolder and folderMap (for post-processing such as loading related items).
+ */
+export declare function buildTaskFolderHierarchy(rootPath: string, documents: TaskDocument[], scanArchive: boolean, archivePath?: string): {
+    root: TaskFolder;
+    folderMap: Map<string, TaskFolder>;
+};
+//# sourceMappingURL=task-scanner.d.ts.map

package/node_modules/@plusplusoneplusplus/forge/dist/tasks/task-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-scanner.d.ts","sourceRoot":"","sources":["../../src/tasks/task-scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI5E,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AActD;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,EAAE,CAqCvG;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,YAAY,EAAE,CAwCnH;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAClC,YAAY,EAAE,UAAU,GACzB,IAAI,CA2CN;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,YAAY,EAAE,CAiCvH;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG;IAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,CAgCtH;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,YAAY,EAAE,EACzB,WAAW,EAAE,OAAO,EACpB,WAAW,CAAC,EAAE,MAAM,GACrB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAAE,CA2F1D"}