@context-forge/mcp 0.8.5 → 0.9.0

package/dist/tools/introspectionTools.js

@@ -0,0 +1,276 @@
+import { z } from 'zod';
+import { FileProjectStore, ArtifactIntrospector, buildModel, mergeProjectModels, } from '@context-forge/core/node';
+import { join } from 'node:path';
+import { resolveProjectId } from './resolveProjectId.js';
+import { resolveOperationContext, resolveAllOperationPaths } from './resolveOperationPath.js';
+function errorResult(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+function jsonResult(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+/**
+ * Resolve an absolute file path from either:
+ * - filePath (absolute, takes precedence)
+ * - projectId + path (resolved via project store)
+ */
+async function resolveIntrospectionPath(args) {
+    if (args.filePath) {
+        return args.filePath;
+    }
+    if (!args.path) {
+        throw new Error('Either filePath (absolute) or projectId + path (relative) must be provided.');
+    }
+    // Use worktree-aware resolution when worktreeId is provided
+    if (args.worktreeId) {
+        const { operationPath } = await resolveOperationContext({
+            projectId: args.projectId,
+            worktreeId: args.worktreeId,
+        });
+        return join(operationPath, args.path);
+    }
+    const resolvedId = await resolveProjectId(args.projectId);
+    const store = new FileProjectStore();
+    const project = await store.getById(resolvedId);
+    if (!project) {
+        throw new Error(`Project not found: '${resolvedId}'. Use the project_list tool to see available projects.`);
+    }
+    if (!project.projectPath) {
+        throw new Error(`Project '${resolvedId}' has no projectPath configured. Set it with project_update.`);
+    }
+    return join(project.projectPath, args.path);
+}
+// Common input schema fragments
+const filePathSchema = {
+    projectId: z
+        .string()
+        .optional()
+        .describe('Project ID. Omit to resolve from CWD.'),
+    path: z
+        .string()
+        .optional()
+        .describe('Relative path from project root to the target file.'),
+    filePath: z
+        .string()
+        .optional()
+        .describe('Absolute path to the target file. Overrides projectId + path.'),
+    worktreeId: z
+        .string()
+        .optional()
+        .describe('Worktree name or ID. Omit to use project root.'),
+};
+export function registerIntrospectionTools(server) {
+    // --- introspection_slice_plan ---
+    server.registerTool('introspection_slice_plan', {
+        title: 'Parse Slice Plan',
+        description: 'Parse a slice plan document and return structured data: entries with index, name, status, ' +
+            'isChecked, plus totalSlices and completedSlices counts.',
+        inputSchema: filePathSchema,
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const resolved = await resolveIntrospectionPath(args);
+            const introspector = new ArtifactIntrospector();
+            const result = await introspector.parseSlicePlan(resolved);
+            // Filter by worktree index range if applicable
+            if (args.worktreeId) {
+                const { indexRange } = await resolveOperationContext({
+                    projectId: args.projectId,
+                    worktreeId: args.worktreeId,
+                });
+                if (indexRange) {
+                    result.entries = result.entries.filter((e) => e.index >= indexRange[0] && e.index <= indexRange[1]);
+                    result.totalSlices = result.entries.length;
+                    result.completedSlices = result.entries.filter((e) => e.isChecked).length;
+                }
+            }
+            return jsonResult(result);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${msg}`);
+        }
+    });
+    // --- introspection_tasks ---
+    server.registerTool('introspection_tasks', {
+        title: 'Parse Task File',
+        description: 'Parse a task file and return structured data: items with name and done status, ' +
+            'plus totalTasks, completedTasks, and inferredStatus.',
+        inputSchema: filePathSchema,
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const resolved = await resolveIntrospectionPath(args);
+            const introspector = new ArtifactIntrospector();
+            const result = await introspector.parseTaskFile(resolved);
+            return jsonResult(result);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${msg}`);
+        }
+    });
+    // --- introspection_frontmatter ---
+    server.registerTool('introspection_frontmatter', {
+        title: 'Parse Frontmatter',
+        description: 'Extract YAML frontmatter from a markdown file. Returns found (boolean) and data ' +
+            '(key-value pairs).',
+        inputSchema: filePathSchema,
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const resolved = await resolveIntrospectionPath(args);
+            const introspector = new ArtifactIntrospector();
+            const result = await introspector.parseFrontmatter(resolved);
+            return jsonResult(result);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${msg}`);
+        }
+    });
+    // --- introspection_documents ---
+    server.registerTool('introspection_documents', {
+        title: 'Detect Documents',
+        description: 'Detect methodology documents for a given slice index. Returns paths to sliceDesign, ' +
+            'taskFile(s), architecture, and slicePlan if they exist.',
+        inputSchema: {
+            projectId: z
+                .string()
+                .optional()
+                .describe('Project ID. Omit to resolve from CWD.'),
+            projectPath: z
+                .string()
+                .optional()
+                .describe('Absolute path to project root. Overrides projectId.'),
+            worktreeId: z
+                .string()
+                .optional()
+                .describe('Worktree name or ID. Omit to use project root.'),
+            sliceIndex: z
+                .number()
+                .describe('Numeric slice index to check (e.g., 163).'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            let resolved;
+            if (args.projectPath) {
+                resolved = args.projectPath;
+            }
+            else {
+                const ctx = await resolveOperationContext({
+                    projectId: args.projectId,
+                    worktreeId: args.worktreeId,
+                });
+                resolved = ctx.operationPath;
+            }
+            const introspector = new ArtifactIntrospector();
+            const result = await introspector.detectDocuments(resolved, args.sliceIndex);
+            return jsonResult(result);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${msg}`);
+        }
+    });
+    // --- introspection_future_work ---
+    server.registerTool('introspection_future_work', {
+        title: 'Parse Future Work',
+        description: 'Parse the Future Work section from a slice plan document. Returns items with index, ' +
+            'name, and done status.',
+        inputSchema: {
+            ...filePathSchema,
+            nextIndex: z
+                .number()
+                .optional()
+                .describe('Starting index for auto-numbering unnumbered items.'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            const resolved = await resolveIntrospectionPath(args);
+            const introspector = new ArtifactIntrospector();
+            const result = await introspector.parseFutureWork(resolved, args.nextIndex);
+            // Filter by worktree index range if applicable
+            if (args.worktreeId) {
+                const { indexRange } = await resolveOperationContext({
+                    projectId: args.projectId,
+                    worktreeId: args.worktreeId,
+                });
+                if (indexRange && result.items) {
+                    result.items = result.items.filter((item) => {
+                        if (!item.index)
+                            return true;
+                        const idx = parseInt(item.index, 10);
+                        return isNaN(idx) || (idx >= indexRange[0] && idx <= indexRange[1]);
+                    });
+                }
+            }
+            return jsonResult(result);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${msg}`);
+        }
+    });
+    // --- project_structure ---
+    server.registerTool('project_structure', {
+        title: 'Project Structure',
+        description: 'Build the full project model for a Context Forge project. Returns structured data ' +
+            'including foundation docs, project architecture, initiatives with slices and tasks, ' +
+            'future slices, quality/investigation/maintenance docs, and devlog status. ' +
+            'Equivalent to parse.py build_model() output.',
+        inputSchema: {
+            projectId: z
+                .string()
+                .optional()
+                .describe('Project ID. Omit to resolve from CWD.'),
+            worktreeId: z
+                .string()
+                .optional()
+                .describe('Worktree name or ID. Omit to use project root.'),
+            all: z
+                .boolean()
+                .optional()
+                .describe('Scan all worktree paths and aggregate results.'),
+            name: z.string().optional().describe('Override project name in output.'),
+            description: z.string().optional().describe('Override project description in output.'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async (args) => {
+        try {
+            if (args.all) {
+                const { paths } = await resolveAllOperationPaths({ projectId: args.projectId });
+                const models = (await Promise.all(paths.map((p) => buildModel(p, { name: args.name, description: args.description }).catch(() => null)))).filter((m) => m !== null);
+                if (models.length === 0) {
+                    return errorResult('No models could be built from any worktree path.');
+                }
+                return jsonResult(mergeProjectModels(models));
+            }
+            const { operationPath, indexRange } = await resolveOperationContext({
+                projectId: args.projectId,
+                worktreeId: args.worktreeId,
+            });
+            const result = await buildModel(operationPath, {
+                name: args.name,
+                description: args.description,
+            });
+            // Filter initiatives by index range
+            if (indexRange) {
+                for (const key of Object.keys(result.initiatives)) {
+                    const idx = parseInt(key, 10);
+                    if (idx < indexRange[0] || idx > indexRange[1]) {
+                        delete result.initiatives[key];
+                    }
+                }
+            }
+            return jsonResult(result);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${msg}`);
+        }
+    });
+}
+//# sourceMappingURL=introspectionTools.js.map

package/dist/tools/introspectionTools.js.map

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

package/dist/tools/projectTools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProjectTools(server: McpServer, serverVersion?: string): void;
+//# sourceMappingURL=projectTools.d.ts.map

package/dist/tools/projectTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectTools.d.ts","sourceRoot":"","sources":["../../src/tools/projectTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuCpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAySpF"}

package/dist/tools/projectTools.js

@@ -0,0 +1,264 @@
+import { z } from 'zod';
+import * as path from 'node:path';
+import { FileProjectStore, ArtifactIntrospector, WorktreeService, computeAutoSetFields } from '@context-forge/core/node';
+import { getSchema, resolveProject, WORKTREE_SCOPED_FIELDS, PROJECT_TO_WORKTREE_FIELD, buildProjectCreationDefaults } from '@context-forge/core';
+import { resolveProjectId } from './resolveProjectId.js';
+function toSummary(project) {
+    return {
+        id: project.id,
+        name: project.name,
+        fileSlice: project.fileSlice,
+        template: project.template,
+        instruction: project.instruction,
+        projectPath: project.projectPath,
+        updatedAt: project.updatedAt,
+    };
+}
+function errorResult(message) {
+    return { content: [{ type: 'text', text: message }], isError: true };
+}
+function jsonResult(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+export function registerProjectTools(server, serverVersion) {
+    // --- project_list ---
+    server.registerTool('project_list', {
+        title: 'List Projects',
+        description: 'List all configured Context Forge projects. Returns project IDs, names, current slices, and other summary fields. Use this to discover available projects before calling project_get or project_update.',
+        inputSchema: {},
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async () => {
+        try {
+            const store = new FileProjectStore();
+            const allProjects = await store.getAll();
+            const projects = allProjects.map(toSummary);
+            return jsonResult({ projects, count: projects.length });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${message}`);
+        }
+    });
+    // --- project_create ---
+    server.registerTool('project_create', {
+        title: 'Create Project',
+        description: 'Create a new Context Forge project entry with sensible defaults. Returns the same shape as project_get (full ProjectData plus introspection when projectPath is provided). Does NOT install guides, commands, or configure the IDE — those are separate operations.',
+        inputSchema: {
+            name: z.string().describe('Project display name (required)'),
+            projectPath: z.string().optional().describe('Absolute path to the project root. When omitted, the project is created without a path (can be set later via project_update).'),
+            developmentPhase: z.string().optional().describe('Initial development phase. Defaults to "Phase 0: Concept".'),
+        },
+        annotations: { destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    }, async ({ name, projectPath, developmentPhase }) => {
+        try {
+            const trimmedName = name.trim();
+            if (!trimmedName) {
+                return errorResult('Project name is required.');
+            }
+            const normalizedPath = projectPath ? path.resolve(projectPath.trim()) : undefined;
+            const store = new FileProjectStore();
+            if (normalizedPath) {
+                const existing = await store.getAll();
+                const duplicate = existing.find((p) => p.projectPath === normalizedPath);
+                if (duplicate) {
+                    return errorResult(`A project is already registered at this path: '${duplicate.name}' (ID: ${duplicate.id}). Use project_get to retrieve it.`);
+                }
+            }
+            const project = await store.create(buildProjectCreationDefaults({
+                name: trimmedName,
+                projectPath: normalizedPath,
+                developmentPhase,
+            }));
+            if (project.projectPath) {
+                try {
+                    const introspector = new ArtifactIntrospector();
+                    const introspection = await introspector.summarize(project);
+                    return jsonResult({ ...project, introspection });
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    console.error(`Introspection failed for new project ${project.id}: ${msg}`);
+                }
+            }
+            return jsonResult(project);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${message}`);
+        }
+    });
+    // --- project_get ---
+    server.registerTool('project_get', {
+        title: 'Get Project',
+        description: 'Get full details for a specific Context Forge project by ID. Returns all project fields including configuration, custom data, and timestamps. When the project has a projectPath, the response includes an `introspection` field with: slicePlan (totalSlices, completedSlices, summary), currentTasks (totalTasks, completedTasks, inferredStatus, summary), and artifacts (presence flags for slicePlan, HLD, arch, spec, currentSliceDesign, currentTaskFile). Use project_list first to find project IDs.',
+        inputSchema: {
+            id: z.string().optional().describe('Project ID (e.g., project_1739...). Omit to resolve from CWD.'),
+            worktreeId: z
+                .string()
+                .optional()
+                .describe('Worktree ID or name. When provided, returns the resolved project view with ' +
+                'worktree-scoped fields (fileSlice, fileArch, developmentPhase, etc.) reflecting ' +
+                "the worktree's values instead of the project-level values."),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ id, worktreeId }) => {
+        try {
+            const resolvedId = await resolveProjectId(id);
+            const store = new FileProjectStore();
+            const project = await resolveProject(store, resolvedId, worktreeId);
+            if (!project) {
+                return errorResult(`Project not found: '${resolvedId}'. Use the project_list tool to see available projects and their IDs.`);
+            }
+            const serverInfo = serverVersion
+                ? { serverVersion, hint: 'Call agent_quickstart for tool orientation, agent_onboard for new project setup.' }
+                : undefined;
+            // Enrich with introspection when projectPath is available
+            if (project.projectPath) {
+                try {
+                    const introspector = new ArtifactIntrospector();
+                    const introspection = await introspector.summarize(project);
+                    return jsonResult({ ...project, introspection, ...(serverInfo && { serverInfo }) });
+                }
+                catch (e) {
+                    // Graceful degradation — return project without introspection
+                    const msg = e instanceof Error ? e.message : String(e);
+                    console.error(`Introspection failed for project ${resolvedId}: ${msg}`);
+                }
+            }
+            return jsonResult({ ...project, ...(serverInfo && { serverInfo }) });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${message}`);
+        }
+    });
+    // --- project_update ---
+    server.registerTool('project_update', {
+        title: 'Update Project',
+        description: 'Update configuration fields on an existing Context Forge project. Provide the project ID and any fields to change (e.g., fileSlice, instruction, developmentPhase). Returns the full updated project. Does not delete or replace — only modifies specified fields.',
+        inputSchema: {
+            id: z.string().optional().describe('Project ID to update. Omit to resolve from CWD.'),
+            worktreeId: z.string().optional().describe('Worktree ID or name. When provided, workflow fields (fileSlice, instruction, etc.) are routed to the worktree context instead of the project.'),
+            name: z.string().optional().describe('Project display name'),
+            template: z.string().optional().describe('Template name'),
+            fileSlice: z.string().optional().describe('Current slice name'),
+            fileTasks: z.string().optional().describe('Task file name'),
+            instruction: z.string().optional().describe('Instruction type (e.g., implementation, design, review)'),
+            developmentPhase: z.string().optional().describe('Current development phase'),
+            workType: z.enum(['start', 'continue']).optional().describe('Whether starting or continuing work'),
+            dateProject: z.string().optional().describe('Project date string'),
+            projectPath: z.string().optional().describe('Absolute path to project root'),
+            fileHLD: z.string().optional().describe('Path to HLD document (relative to project root)'),
+            fileArch: z.string().optional().describe('Path to architecture document (relative to project root)'),
+            fileSlicePlan: z.string().optional().describe('Path to slice plan (relative to project root)'),
+            fileSpec: z.string().optional().describe('Path to project spec (relative to project root)'),
+            fileConcept: z.string().optional().describe('Path to concept document (relative to project root)'),
+            customData: z
+                .object({
+                recentEvents: z.string().optional(),
+                additionalNotes: z.string().optional(),
+                availableTools: z.string().optional(),
+            })
+                .optional()
+                .describe('Custom data fields for context generation'),
+        },
+        annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ id, worktreeId, ...fields }) => {
+        try {
+            const resolvedId = await resolveProjectId(id);
+            // Collect defined update fields (exclude undefined values)
+            const allUpdates = {};
+            for (const [key, value] of Object.entries(fields)) {
+                if (value !== undefined) {
+                    allUpdates[key] = value;
+                }
+            }
+            if (Object.keys(allUpdates).length === 0) {
+                return errorResult('No update fields provided. Specify at least one field to update (e.g., fileSlice, instruction, name).');
+            }
+            const store = new FileProjectStore();
+            // Check project exists
+            const existing = await store.getById(resolvedId);
+            if (!existing) {
+                return errorResult(`Project not found: '${resolvedId}'. Use the project_list tool to see available projects and their IDs.`);
+            }
+            // --- Worktree-aware field routing ---
+            if (worktreeId) {
+                const service = new WorktreeService(store);
+                let wt = await service.getWorktree(resolvedId, worktreeId);
+                if (!wt) {
+                    wt = await service.getWorktreeByName(resolvedId, worktreeId);
+                }
+                if (!wt) {
+                    return errorResult(`Worktree '${worktreeId}' not found. Use worktree_list to see available worktrees.`);
+                }
+                // Split fields into worktree-scoped and project-level
+                const worktreeUpdates = {};
+                const projectUpdates = {};
+                for (const [key, value] of Object.entries(allUpdates)) {
+                    if (WORKTREE_SCOPED_FIELDS.has(key)) {
+                        const wtKey = PROJECT_TO_WORKTREE_FIELD[key] ?? key;
+                        worktreeUpdates[wtKey] = value;
+                        // Compute auto-set fields (skip if caller explicitly provided the derived field)
+                        const autoSet = computeAutoSetFields(key, value, existing.projectPath);
+                        for (const [derivedField, derivedValue] of Object.entries(autoSet.derivedUpdates)) {
+                            if (!(derivedField in allUpdates)) {
+                                const derivedWtKey = PROJECT_TO_WORKTREE_FIELD[derivedField] ?? derivedField;
+                                worktreeUpdates[derivedWtKey] = derivedValue;
+                            }
+                        }
+                    }
+                    else {
+                        projectUpdates[key] = value;
+                    }
+                }
+                // Apply worktree updates
+                if (Object.keys(worktreeUpdates).length > 0) {
+                    await service.updateWorktree(resolvedId, wt.id, worktreeUpdates);
+                }
+                // Apply project-level updates
+                if (Object.keys(projectUpdates).length > 0) {
+                    await store.update(resolvedId, projectUpdates);
+                }
+                const updated = await store.getById(resolvedId);
+                return jsonResult({ ...updated, _worktreeUpdated: wt.id });
+            }
+            // --- Standard (non-worktree) path ---
+            const updates = { ...allUpdates };
+            const autoSetInfo = {};
+            // Compute auto-set derived fields for each updated field
+            for (const [key, value] of Object.entries(allUpdates)) {
+                const autoSet = computeAutoSetFields(key, value, existing.projectPath);
+                for (const [derivedField, derivedValue] of Object.entries(autoSet.derivedUpdates)) {
+                    // Only auto-set if caller didn't explicitly provide the derived field
+                    if (!(derivedField in allUpdates)) {
+                        updates[derivedField] = derivedValue;
+                        autoSetInfo[derivedField] = derivedValue;
+                    }
+                }
+            }
+            await store.update(resolvedId, updates);
+            // Read back updated project
+            const updated = await store.getById(resolvedId);
+            const result = { ...updated };
+            if (Object.keys(autoSetInfo).length > 0) {
+                result._autoSet = autoSetInfo;
+            }
+            return jsonResult(result);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return errorResult(`Error: ${message}`);
+        }
+    });
+    // --- project_schema ---
+    server.registerTool('project_schema', {
+        title: 'Project Schema',
+        description: 'Returns the full project data schema including field definitions, aliases, groups, and enum values. Use this to discover available fields for project_update, understand field types, and find short aliases for field names.',
+        inputSchema: {},
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async () => {
+        return jsonResult(getSchema());
+    });
+}
+//# sourceMappingURL=projectTools.js.map

package/dist/tools/projectTools.js.map

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

package/dist/tools/resolveOperationPath.d.ts

@@ -0,0 +1,28 @@
+import type { ProjectData } from '@context-forge/core';
+export interface ResolvedOperation {
+    operationPath: string;
+    indexRange?: [number, number];
+}
+/**
+ * Resolve the operation path and optional index range for a worktree-aware
+ * MCP tool call. When worktreeId is provided, looks up the worktree by
+ * ID or name and returns its path and index range.
+ *
+ * All worktrees (including default) return their indexRange for filtering.
+ * Returns no indexRange only when no worktreeId or no worktrees.
+ */
+export declare function resolveOperationContext(args: {
+    projectId?: string;
+    worktreeId?: string;
+}): Promise<ResolvedOperation>;
+/**
+ * Resolve all worktree paths for cross-worktree aggregation (--all mode).
+ * Returns deduplicated array of all paths (projectPath + worktree paths).
+ */
+export declare function resolveAllOperationPaths(args: {
+    projectId?: string;
+}): Promise<{
+    paths: string[];
+    project: ProjectData;
+}>;
+//# sourceMappingURL=resolveOperationPath.d.ts.map

package/dist/tools/resolveOperationPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveOperationPath.d.ts","sourceRoot":"","sources":["../../src/tools/resolveOperationPath.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,iBAAiB,CAAC,CAmC5B;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC,CAwBpD"}