@dotcontext/mcp 0.9.0

package/dist/services/semantic/types.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Semantic analysis types for codebase understanding
+ */
+export type SymbolKind = 'class' | 'interface' | 'function' | 'type' | 'variable' | 'enum' | 'method';
+export interface SymbolLocation {
+    file: string;
+    line: number;
+    column: number;
+}
+export interface ParameterInfo {
+    name: string;
+    type?: string;
+    optional?: boolean;
+    defaultValue?: string;
+}
+export interface ExtractedSymbol {
+    name: string;
+    kind: SymbolKind;
+    location: SymbolLocation;
+    exported: boolean;
+    documentation?: string;
+    extends?: string;
+    implements?: string[];
+    parameters?: ParameterInfo[];
+    returnType?: string;
+    members?: ExtractedSymbol[];
+    typeInfo?: TypeInfo;
+    references?: ReferenceLocation[];
+    implementations?: ReferenceLocation[];
+}
+export interface ImportInfo {
+    source: string;
+    specifiers: string[];
+    isDefault: boolean;
+    isNamespace: boolean;
+    alias?: string;
+}
+export interface ExportInfo {
+    name: string;
+    isDefault: boolean;
+    isReExport: boolean;
+    originalSource?: string;
+}
+export interface FileAnalysis {
+    filePath: string;
+    symbols: ExtractedSymbol[];
+    imports: ImportInfo[];
+    exports: ExportInfo[];
+    language: string;
+}
+export interface ArchitectureLayer {
+    name: string;
+    description: string;
+    directories: string[];
+    symbols: ExtractedSymbol[];
+    dependsOn: string[];
+}
+export interface DetectedPattern {
+    name: string;
+    confidence: number;
+    locations: Array<{
+        file: string;
+        symbol: string;
+    }>;
+    description: string;
+}
+/**
+ * Functional pattern types for Q&A topic detection
+ * These patterns indicate functional capabilities in the codebase
+ */
+export type FunctionalPatternType = 'auth' | 'database' | 'api' | 'cache' | 'queue' | 'websocket' | 'logging' | 'validation' | 'error-handling' | 'testing';
+export interface FunctionalPattern {
+    type: FunctionalPatternType;
+    confidence: number;
+    indicators: PatternIndicator[];
+    description: string;
+}
+export interface PatternIndicator {
+    file: string;
+    symbol?: string;
+    line?: number;
+    reason: string;
+}
+export interface DetectedFunctionalPatterns {
+    hasAuthPattern: boolean;
+    hasDatabasePattern: boolean;
+    hasApiPattern: boolean;
+    hasCachePattern: boolean;
+    hasQueuePattern: boolean;
+    hasWebSocketPattern: boolean;
+    hasLoggingPattern: boolean;
+    hasValidationPattern: boolean;
+    hasErrorHandlingPattern: boolean;
+    hasTestingPattern: boolean;
+    patterns: FunctionalPattern[];
+}
+/**
+ * Flow tracing types for understanding execution paths
+ */
+export interface FlowNode {
+    file: string;
+    symbol: string;
+    line: number;
+    type: 'entry' | 'call' | 'return' | 'branch';
+}
+export interface FlowEdge {
+    from: FlowNode;
+    to: FlowNode;
+    label?: string;
+}
+export interface ExecutionFlow {
+    entryPoint: FlowNode;
+    nodes: FlowNode[];
+    edges: FlowEdge[];
+    mermaidDiagram: string;
+}
+export interface DependencyInfo {
+    graph: Map<string, string[]>;
+    reverseGraph: Map<string, string[]>;
+}
+export interface ArchitectureInfo {
+    layers: ArchitectureLayer[];
+    patterns: DetectedPattern[];
+    entryPoints: string[];
+    publicAPI: ExtractedSymbol[];
+}
+export interface SemanticStats {
+    totalFiles: number;
+    totalSymbols: number;
+    languageBreakdown: Record<string, number>;
+    analysisTimeMs: number;
+}
+export interface SemanticContext {
+    symbols: {
+        classes: ExtractedSymbol[];
+        interfaces: ExtractedSymbol[];
+        functions: ExtractedSymbol[];
+        types: ExtractedSymbol[];
+        enums: ExtractedSymbol[];
+    };
+    dependencies: DependencyInfo;
+    architecture: ArchitectureInfo;
+    stats: SemanticStats;
+}
+export interface TypeInfo {
+    name: string;
+    fullType: string;
+    documentation?: string;
+}
+export interface ReferenceLocation {
+    file: string;
+    line: number;
+    column: number;
+    context?: string;
+}
+export interface AnalyzerOptions {
+    useLSP?: boolean;
+    languages?: string[];
+    exclude?: string[];
+    include?: string[];
+    maxFiles?: number;
+    cacheEnabled?: boolean;
+}
+export interface LSPServerConfig {
+    command: string;
+    args: string[];
+    rootPatterns?: string[];
+}
+export type SupportedLanguage = 'typescript' | 'javascript' | 'python';
+export declare const LANGUAGE_EXTENSIONS: Record<string, SupportedLanguage>;
+export declare const DEFAULT_EXCLUDE_PATTERNS: string[];
+//# sourceMappingURL=types.d.ts.map

package/dist/services/semantic/types.d.ts.map

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

package/dist/services/semantic/types.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Semantic analysis types for codebase understanding
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_EXCLUDE_PATTERNS = exports.LANGUAGE_EXTENSIONS = void 0;
+exports.LANGUAGE_EXTENSIONS = {
+    '.ts': 'typescript',
+    '.tsx': 'typescript',
+    '.js': 'javascript',
+    '.jsx': 'javascript',
+    '.mjs': 'javascript',
+    '.cjs': 'javascript',
+    '.py': 'python',
+    '.pyw': 'python',
+    '.pyi': 'python',
+};
+exports.DEFAULT_EXCLUDE_PATTERNS = [
+    'node_modules',
+    'dist',
+    'build',
+    '.git',
+    'vendor',
+    '__pycache__',
+    '.next',
+    '.nuxt',
+    'coverage',
+    '.cache',
+    'target',
+    'venv',
+    '.venv',
+];
+//# sourceMappingURL=types.js.map

package/dist/services/semantic/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/semantic/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA4MU,QAAA,mBAAmB,GAAsC;IACpE,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEW,QAAA,wBAAwB,GAAG;IACtC,cAAc;IACd,MAAM;IACN,OAAO;IACP,MAAM;IACN,QAAQ;IACR,aAAa;IACb,OAAO;IACP,OAAO;IACP,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,OAAO;CACR,CAAC"}

package/dist/services/shared/contentTypeRegistry.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Content Type Registry
+ *
+ * Extensible registry for managing different content types in .context/
+ * This enables easy addition of new content types (prompts, workflows, etc.)
+ * without modifying core export/import logic.
+ */
+/**
+ * Content type definition
+ */
+export interface ContentType {
+    /** Unique identifier (e.g., 'docs', 'agents', 'skills') */
+    id: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Path relative to .context/ */
+    contextPath: string;
+    /** File pattern for discovery (glob pattern) */
+    filePattern: string;
+    /** Index file name (e.g., 'README.md' for docs) */
+    indexFile?: string;
+    /** Description of this content type */
+    description: string;
+    /** Whether this content type supports export */
+    supportsExport: boolean;
+    /** Whether this content type supports import */
+    supportsImport: boolean;
+}
+/**
+ * Registry of all content types
+ */
+export declare const CONTENT_TYPE_REGISTRY: ContentType[];
+/**
+ * Get a content type by ID
+ */
+export declare function getContentType(id: string): ContentType | undefined;
+/**
+ * Get all content types that support export
+ */
+export declare function getExportableContentTypes(): ContentType[];
+/**
+ * Get all content types that support import
+ */
+export declare function getImportableContentTypes(): ContentType[];
+/**
+ * Get content type IDs
+ */
+export declare function getContentTypeIds(): string[];
+/**
+ * Check if a content type exists
+ */
+export declare function hasContentType(id: string): boolean;
+/**
+ * Register a new content type (for future extensibility)
+ * Note: This mutates the registry. Use with caution.
+ */
+export declare function registerContentType(contentType: ContentType): void;
+/**
+ * Get the context path for a content type
+ */
+export declare function getContextPath(id: string): string | undefined;
+/**
+ * Get the index file for a content type (if any)
+ */
+export declare function getIndexFile(id: string): string | undefined;
+//# sourceMappingURL=contentTypeRegistry.d.ts.map

package/dist/services/shared/contentTypeRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentTypeRegistry.d.ts","sourceRoot":"","sources":["../../../src/services/shared/contentTypeRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,EA+C9C,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,WAAW,EAAE,CAEzD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,WAAW,EAAE,CAEzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAKlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE3D"}

package/dist/services/shared/contentTypeRegistry.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * Content Type Registry
+ *
+ * Extensible registry for managing different content types in .context/
+ * This enables easy addition of new content types (prompts, workflows, etc.)
+ * without modifying core export/import logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTENT_TYPE_REGISTRY = void 0;
+exports.getContentType = getContentType;
+exports.getExportableContentTypes = getExportableContentTypes;
+exports.getImportableContentTypes = getImportableContentTypes;
+exports.getContentTypeIds = getContentTypeIds;
+exports.hasContentType = hasContentType;
+exports.registerContentType = registerContentType;
+exports.getContextPath = getContextPath;
+exports.getIndexFile = getIndexFile;
+/**
+ * Registry of all content types
+ */
+exports.CONTENT_TYPE_REGISTRY = [
+    {
+        id: 'docs',
+        displayName: 'Documentation',
+        contextPath: '.context/docs',
+        filePattern: '**/*.md',
+        indexFile: 'README.md',
+        description: 'Project documentation, rules, and guidelines',
+        supportsExport: true,
+        supportsImport: true,
+    },
+    {
+        id: 'agents',
+        displayName: 'Agents',
+        contextPath: '.context/agents',
+        filePattern: '**/*.md',
+        description: 'AI agent playbooks and configurations',
+        supportsExport: true,
+        supportsImport: true,
+    },
+    {
+        id: 'skills',
+        displayName: 'Skills',
+        contextPath: '.context/skills',
+        filePattern: '**/SKILL.md',
+        description: 'On-demand expertise and task-specific instructions',
+        supportsExport: true,
+        supportsImport: true,
+    },
+    {
+        id: 'plans',
+        displayName: 'Plans',
+        contextPath: '.context/plans',
+        filePattern: '**/*.md',
+        description: 'Implementation plans and task breakdowns',
+        supportsExport: false,
+        supportsImport: false,
+    },
+    {
+        id: 'sensors',
+        displayName: 'Harness Sensors',
+        contextPath: '.context/harness',
+        filePattern: 'sensors.json',
+        description: 'Project-specific harness sensor catalog and quality checks',
+        supportsExport: false,
+        supportsImport: false,
+    },
+];
+/**
+ * Get a content type by ID
+ */
+function getContentType(id) {
+    return exports.CONTENT_TYPE_REGISTRY.find(ct => ct.id === id);
+}
+/**
+ * Get all content types that support export
+ */
+function getExportableContentTypes() {
+    return exports.CONTENT_TYPE_REGISTRY.filter(ct => ct.supportsExport);
+}
+/**
+ * Get all content types that support import
+ */
+function getImportableContentTypes() {
+    return exports.CONTENT_TYPE_REGISTRY.filter(ct => ct.supportsImport);
+}
+/**
+ * Get content type IDs
+ */
+function getContentTypeIds() {
+    return exports.CONTENT_TYPE_REGISTRY.map(ct => ct.id);
+}
+/**
+ * Check if a content type exists
+ */
+function hasContentType(id) {
+    return exports.CONTENT_TYPE_REGISTRY.some(ct => ct.id === id);
+}
+/**
+ * Register a new content type (for future extensibility)
+ * Note: This mutates the registry. Use with caution.
+ */
+function registerContentType(contentType) {
+    if (hasContentType(contentType.id)) {
+        throw new Error(`Content type '${contentType.id}' already exists`);
+    }
+    exports.CONTENT_TYPE_REGISTRY.push(contentType);
+}
+/**
+ * Get the context path for a content type
+ */
+function getContextPath(id) {
+    return getContentType(id)?.contextPath;
+}
+/**
+ * Get the index file for a content type (if any)
+ */
+function getIndexFile(id) {
+    return getContentType(id)?.indexFile;
+}
+//# sourceMappingURL=contentTypeRegistry.js.map

package/dist/services/shared/contentTypeRegistry.js.map

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

package/dist/services/shared/contextLayout.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Context Layout Registry
+ *
+ * Defines which `.context` paths are durable project knowledge and which are
+ * local runtime state that should stay out of version control.
+ */
+export type ContextLayoutClassification = 'versioned' | 'local' | 'runtime';
+export interface ContextLayoutEntry {
+    id: string;
+    path: string;
+    classification: ContextLayoutClassification;
+    trackedInGit: boolean;
+    description: string;
+}
+export declare const CONTEXT_LAYOUT_REGISTRY: ContextLayoutEntry[];
+export declare function getContextLayoutByClassification(classification: ContextLayoutClassification): ContextLayoutEntry[];
+export declare function getUntrackedContextLayoutEntries(): ContextLayoutEntry[];
+//# sourceMappingURL=contextLayout.d.ts.map

package/dist/services/shared/contextLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextLayout.d.ts","sourceRoot":"","sources":["../../../src/services/shared/contextLayout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,2BAA2B,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,2BAA2B,CAAC;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,uBAAuB,EAAE,kBAAkB,EAwHvD,CAAC;AAEF,wBAAgB,gCAAgC,CAC9C,cAAc,EAAE,2BAA2B,GAC1C,kBAAkB,EAAE,CAEtB;AAED,wBAAgB,gCAAgC,IAAI,kBAAkB,EAAE,CAEvE"}

package/dist/services/shared/contextLayout.js

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * Context Layout Registry
+ *
+ * Defines which `.context` paths are durable project knowledge and which are
+ * local runtime state that should stay out of version control.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTEXT_LAYOUT_REGISTRY = void 0;
+exports.getContextLayoutByClassification = getContextLayoutByClassification;
+exports.getUntrackedContextLayoutEntries = getUntrackedContextLayoutEntries;
+exports.CONTEXT_LAYOUT_REGISTRY = [
+    {
+        id: 'docs',
+        path: '.context/docs/**',
+        classification: 'versioned',
+        trackedInGit: true,
+        description: 'Durable project documentation and generated knowledge base content.',
+    },
+    {
+        id: 'agents',
+        path: '.context/agents/**',
+        classification: 'versioned',
+        trackedInGit: true,
+        description: 'Agent playbooks and role definitions maintained as project assets.',
+    },
+    {
+        id: 'skills',
+        path: '.context/skills/**',
+        classification: 'versioned',
+        trackedInGit: true,
+        description: 'Reusable skills and on-demand operating instructions.',
+    },
+    {
+        id: 'plans',
+        path: '.context/plans/**',
+        classification: 'local',
+        trackedInGit: false,
+        description: 'Implementation plans kept as local working artifacts unless the team explicitly decides to version them.',
+    },
+    {
+        id: 'harness-config-sensors',
+        path: '.context/harness/sensors.json',
+        classification: 'versioned',
+        trackedInGit: true,
+        description: 'Project sensor catalog generated at bootstrap and intended to be customized by the team.',
+    },
+    {
+        id: 'harness-config-policy',
+        path: '.context/harness/policy.json',
+        classification: 'versioned',
+        trackedInGit: true,
+        description: 'Harness policy rules and approval constraints treated as project configuration.',
+    },
+    {
+        id: 'context-config',
+        path: '.context/config.json',
+        classification: 'versioned',
+        trackedInGit: true,
+        description: 'Context generation configuration persisted for repeatable scaffolding.',
+    },
+    {
+        id: 'semantic-cache',
+        path: '.context/cache/semantic/**',
+        classification: 'runtime',
+        trackedInGit: false,
+        description: 'Persisted semantic snapshot cache and versioned summary sections generated from the codebase.',
+    },
+    {
+        id: 'workflow-runtime',
+        path: '.context/workflow/**',
+        classification: 'runtime',
+        trackedInGit: false,
+        description: 'Local workflow execution state, bindings, and archives.',
+    },
+    {
+        id: 'harness-sessions',
+        path: '.context/harness/sessions/**',
+        classification: 'runtime',
+        trackedInGit: false,
+        description: 'Session records for local harness execution.',
+    },
+    {
+        id: 'harness-traces',
+        path: '.context/harness/traces/**',
+        classification: 'runtime',
+        trackedInGit: false,
+        description: 'Append-only execution traces and sensor runs.',
+    },
+    {
+        id: 'harness-artifacts',
+        path: '.context/harness/artifacts/**',
+        classification: 'runtime',
+        trackedInGit: false,
+        description: 'Artifacts captured during harness sessions.',
+    },
+    {
+        id: 'harness-contracts',
+        path: '.context/harness/contracts/**',
+        classification: 'runtime',
+        trackedInGit: false,
+        description: 'Task and handoff contracts associated with local execution state.',
+    },
+    {
+        id: 'harness-workflows',
+        path: '.context/harness/workflows/**',
+        classification: 'runtime',
+        trackedInGit: false,
+        description: 'Canonical workflow runtime state materialized during execution.',
+    },
+    {
+        id: 'harness-replays',
+        path: '.context/harness/replays/**',
+        classification: 'runtime',
+        trackedInGit: false,
+        description: 'Replay artifacts derived from session execution history.',
+    },
+    {
+        id: 'harness-datasets',
+        path: '.context/harness/datasets/**',
+        classification: 'runtime',
+        trackedInGit: false,
+        description: 'Generated failure datasets and clustering output.',
+    },
+    {
+        id: 'archives',
+        path: '.context/**/archive/**',
+        classification: 'runtime',
+        trackedInGit: false,
+        description: 'Archived local state and historical runtime artifacts.',
+    },
+];
+function getContextLayoutByClassification(classification) {
+    return exports.CONTEXT_LAYOUT_REGISTRY.filter((entry) => entry.classification === classification);
+}
+function getUntrackedContextLayoutEntries() {
+    return exports.CONTEXT_LAYOUT_REGISTRY.filter((entry) => !entry.trackedInGit);
+}
+//# sourceMappingURL=contextLayout.js.map

package/dist/services/shared/contextLayout.js.map

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

package/dist/services/shared/contextRootResolver.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Simple context path resolver
+ *
+ * Creates .context in the provided path or current working directory.
+ * No upward traversal, git detection, or package.json configuration.
+ * Simpler, more predictable behavior.
+ */
+/**
+ * Resolve the .context path for a given repository path
+ * @param repoPath - The repository path (defaults to cwd)
+ * @returns Absolute path to .context directory
+ */
+export declare function resolveContextPath(repoPath?: string): string;
+/**
+ * Simple context resolution result
+ */
+export interface SimpleContextResult {
+    /** Absolute path to .context directory */
+    contextPath: string;
+    /** Absolute path to project root */
+    projectRoot: string;
+    /** Whether .context directory exists */
+    exists: boolean;
+}
+/**
+ * Resolve context information for a repository
+ * @param repoPath - The repository path (defaults to cwd)
+ * @returns Simple context resolution result
+ */
+export declare function resolveSimpleContext(repoPath?: string): Promise<SimpleContextResult>;
+/**
+ * Get the context path for a repository (simple helper)
+ * @param repoPath - The repository path (defaults to cwd)
+ * @returns Absolute path to .context directory
+ */
+export declare function getContextPath(repoPath?: string): Promise<string>;
+/**
+ * Get the project root for a repository
+ * @param repoPath - The repository path (defaults to cwd)
+ * @returns Absolute path to project root
+ */
+export declare function getProjectRoot(repoPath?: string): Promise<string>;
+/**
+ * Backwards compatibility: resolve context using old complex API
+ * This maintains compatibility with existing code while using simple resolution
+ */
+export interface ContextResolutionResult {
+    contextPath: string;
+    projectRoot: string;
+    exists: boolean;
+    isValid: boolean;
+}
+export declare function resolveContextRoot(options?: {
+    startPath?: string;
+    validate?: boolean;
+}): Promise<ContextResolutionResult>;
+//# sourceMappingURL=contextRootResolver.d.ts.map

package/dist/services/shared/contextRootResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextRootResolver.d.ts","sourceRoot":"","sources":["../../../src/services/shared/contextRootResolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAS1F;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtF;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtF;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAU/H"}