ai-prompt-guide-mcp 1.0.0

package/dist/tools/schemas/view-subagent-task-schemas.js

@@ -0,0 +1,65 @@
+/**
+ * Schema definitions for view_subagent_task tool
+ */
+/**
+ * Schema constants for view_subagent_task tool
+ */
+export const VIEW_SUBAGENT_TASK_CONSTANTS = {
+    MAX_TASKS: 10, // Limit for multiple task viewing
+};
+/**
+ * Helper functions for task validation
+ */
+export function normalizeTask(task) {
+    return task.startsWith('#') ? task : `#${task}`;
+}
+export function parseTasks(task) {
+    if (Array.isArray(task)) {
+        return task.map(normalizeTask);
+    }
+    return [normalizeTask(task)];
+}
+export function validateTaskCount(tasks) {
+    return tasks.length > 0 && tasks.length <= VIEW_SUBAGENT_TASK_CONSTANTS.MAX_TASKS;
+}
+/**
+ * Get the input schema for view_subagent_task tool
+ */
+export function getViewSubagentTaskSchema() {
+    return {
+        type: 'object',
+        properties: {
+            document: {
+                type: 'string',
+                description: `Document path with optional task slug(s) for subagent tasks in /docs/ namespace.
+
+⚠️ IMPORTANT: This tool is for subagent tasks ONLY. For coordinator tasks, use view_coordinator_task instead.
+
+TWO MODES:
+1. Overview: "/docs/project/tasks.md"
+   → Returns list of ALL tasks with slug, title, and status (no content)
+   → Use for browsing available tasks in a document
+
+2. Detail: "/docs/project/tasks.md#implement-auth"
+   → Returns FULL task content for the specified task
+   → Supports multiple tasks: "/docs/api/tasks.md#task1,task2,task3"
+   → Use for viewing specific task details
+
+DOCUMENT FORMAT:
+- Must be in /docs/ namespace: "/docs/{namespace}/{doc}.md"
+- Supports hierarchical namespace structure
+- Document parameter is REQUIRED (unlike coordinator version)
+
+Examples:
+- Subagent overview: "/docs/api/tasks.md" → All tasks (titles + status only)
+- Subagent detail: "/docs/api/tasks.md#implement-auth" → Full task content
+- Multiple tasks: "/docs/api/tasks.md#task1,task2" → Multiple full contents
+
+NOTE: Coordinator tasks should use view_coordinator_task tool instead.`,
+            },
+        },
+        required: ['document'],
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=view-subagent-task-schemas.js.map

package/dist/tools/schemas/view-subagent-task-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-subagent-task-schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas/view-subagent-task-schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,SAAS,EAAE,EAAE,EAAG,kCAAkC;CAC1C,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAe;IAC/C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,4BAA4B,CAAC,SAAS,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;uEAwBkD;aAChE;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC"}

package/dist/tools/schemas/view-task-schemas.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Schema definitions for view_task tool
+ */
+export interface ViewTaskInputSchema {
+    type: 'object';
+    properties: {
+        document: {
+            type: 'string';
+            description: string;
+        };
+    };
+    required: ['document'];
+    additionalProperties: false;
+}
+/**
+ * Schema constants for view_task tool
+ */
+export declare const VIEW_TASK_CONSTANTS: {
+    readonly MAX_TASKS: 10;
+};
+/**
+ * Helper functions for task validation
+ */
+export declare function normalizeTask(task: string): string;
+export declare function parseTasks(task: string | string[]): string[];
+export declare function validateTaskCount(tasks: string[]): boolean;
+/**
+ * Get the input schema for view_task tool
+ */
+export declare function getViewTaskSchema(): ViewTaskInputSchema;
+//# sourceMappingURL=view-task-schemas.d.ts.map

package/dist/tools/schemas/view-task-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-task-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/view-task-schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACV,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,CAAC,UAAU,CAAC,CAAC;IACvB,oBAAoB,EAAE,KAAK,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;CAEtB,CAAC;AAEX;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAK5D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAE1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,mBAAmB,CAiCvD"}

package/dist/tools/schemas/view-task-schemas.js

@@ -0,0 +1,62 @@
+/**
+ * Schema definitions for view_task tool
+ */
+/**
+ * Schema constants for view_task tool
+ */
+export const VIEW_TASK_CONSTANTS = {
+    MAX_TASKS: 10, // Limit for multiple task viewing
+};
+/**
+ * Helper functions for task validation
+ */
+export function normalizeTask(task) {
+    return task.startsWith('#') ? task : `#${task}`;
+}
+export function parseTasks(task) {
+    if (Array.isArray(task)) {
+        return task.map(normalizeTask);
+    }
+    return [normalizeTask(task)];
+}
+export function validateTaskCount(tasks) {
+    return tasks.length > 0 && tasks.length <= VIEW_TASK_CONSTANTS.MAX_TASKS;
+}
+/**
+ * Get the input schema for view_task tool
+ */
+export function getViewTaskSchema() {
+    return {
+        type: 'object',
+        properties: {
+            document: {
+                type: 'string',
+                description: `Document path with optional task slug(s). Works for BOTH coordinator and subagent tasks.
+
+TWO MODES:
+1. Overview: "/docs/project/tasks.md" or "/coordinator/active.md"
+   → Returns list of ALL tasks with slug, title, and status (no content)
+   → Use for browsing available tasks in a document
+
+2. Detail: "/docs/project/tasks.md#implement-auth" or "/coordinator/active.md#phase-1"
+   → Returns FULL task content for the specified task
+   → Supports multiple tasks: "/docs/api/tasks.md#task1,task2,task3"
+   → Use for viewing specific task details
+
+TASK TYPES:
+- Coordinator tasks: "/coordinator/active.md" (sequential project orchestration)
+- Subagent tasks: "/docs/{namespace}/{doc}.md" (ad-hoc task management)
+
+Examples:
+- Coordinator overview: "/coordinator/active.md" → All coordinator tasks
+- Coordinator detail: "/coordinator/active.md#phase-1" → Full coordinator task
+- Subagent overview: "/docs/api/tasks.md" → All subagent tasks in doc
+- Subagent detail: "/docs/api/tasks.md#implement-auth" → Full subagent task
+- Multiple tasks: "/docs/api/tasks.md#task1,task2" → Multiple full contents`,
+            },
+        },
+        required: ['document'],
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=view-task-schemas.js.map

package/dist/tools/schemas/view-task-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-task-schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas/view-task-schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,EAAE,EAAG,kCAAkC;CAC1C,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAuB;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAe;IAC/C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,mBAAmB,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;4EAqBuD;aACrE;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC"}

package/dist/tools/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Tool-related type definitions for the Spec-Docs MCP server
+ *
+ * This module defines the core interfaces and types used throughout the MCP tool system,
+ * ensuring compliance with the Model Context Protocol specification while providing
+ * type safety and clear contracts for tool implementations.
+ */
+/**
+ * Tool definition interface matching MCP specification
+ *
+ * Defines the structure for MCP tool definitions, including metadata and input schema.
+ * This interface ensures all tools conform to the MCP protocol requirements while
+ * providing flexibility for tool-specific parameters and validation.
+ *
+ * @example Basic tool definition
+ * ```typescript
+ * const viewDocumentTool: ToolDefinition = {
+ *   name: 'view_document',
+ *   description: 'View document content with analysis and statistics',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       document: {
+ *         type: 'string',
+ *         description: 'Document path to view'
+ *       }
+ *     },
+ *     required: ['document'],
+ *     additionalProperties: false
+ *   }
+ * };
+ * ```
+ *
+ * @example Tool with complex schema
+ * ```typescript
+ * const sectionTool: ToolDefinition = {
+ *   name: 'section',
+ *   description: 'Comprehensive section management with unified operations',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       document: { type: 'string', description: 'Document path' },
+ *       section: { type: 'string', description: 'Section slug' },
+ *       operation: {
+ *         type: 'string',
+ *         enum: ['replace', 'append', 'prepend', 'insert_before', 'insert_after', 'append_child', 'remove'],
+ *         description: 'Operation to perform'
+ *       },
+ *       content: { type: 'string', description: 'Section content' }
+ *     },
+ *     required: ['document', 'section'],
+ *     additionalProperties: false
+ *   }
+ * };
+ * ```
+ *
+ * @example Progressive discovery tool
+ * ```typescript
+ * // Stage 0: Minimal schema
+ * const createDocumentStage0: ToolDefinition = {
+ *   name: 'create_document',
+ *   description: 'Create new specification document with progressive guidance',
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       namespace: { type: 'string', description: 'Document namespace (e.g., "api/specs")' }
+ *     },
+ *     required: ['namespace'],
+ *     additionalProperties: false
+ *   }
+ * };
+ *
+ * // Later stages reveal additional parameters based on session state
+ * ```
+ *
+ * @see {@link https://modelcontextprotocol.io/docs/concepts/tools} MCP Tools Specification
+ * @see {@link https://json-schema.org/draft/2020-12/schema} JSON Schema Specification
+ */
+export interface ToolDefinition {
+    /** Unique tool identifier following MCP naming conventions */
+    name: string;
+    /** Human-readable tool description for MCP clients */
+    description: string;
+    /** JSON Schema defining valid input parameters */
+    inputSchema: {
+        /** Schema type, always 'object' for MCP tools */
+        type: 'object';
+        /** Property definitions for tool parameters */
+        properties?: Record<string, unknown>;
+        /** Array of required property names */
+        required?: string[];
+        /** Whether additional properties beyond those defined are allowed */
+        additionalProperties?: boolean;
+        /** Alternative schema definitions for conditional validation */
+        oneOf?: unknown[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IAEpB,kDAAkD;IAClD,WAAW,EAAE;QACX,iDAAiD;QACjD,IAAI,EAAE,QAAQ,CAAC;QAEf,+CAA+C;QAC/C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAErC,uCAAuC;QACvC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QAEpB,qEAAqE;QACrE,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAE/B,gEAAgE;QAChE,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;KACnB,CAAC;CACH"}

package/dist/tools/types.js

@@ -0,0 +1,9 @@
+/**
+ * Tool-related type definitions for the Spec-Docs MCP server
+ *
+ * This module defines the core interfaces and types used throughout the MCP tool system,
+ * ensuring compliance with the Model Context Protocol specification while providing
+ * type safety and clear contracts for tool implementations.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tools-manager.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tools manager - compatibility re-export layer
+ *
+ * This file maintains backward compatibility while the actual implementation
+ * has been modularized into separate files under src/session/, src/tools/, and src/shared/
+ */
+export { getVisibleTools, executeTool } from './tools/index.js';
+//# sourceMappingURL=tools-manager.d.ts.map

package/dist/tools-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-manager.d.ts","sourceRoot":"","sources":["../src/tools-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/tools-manager.js

@@ -0,0 +1,9 @@
+/**
+ * Tools manager - compatibility re-export layer
+ *
+ * This file maintains backward compatibility while the actual implementation
+ * has been modularized into separate files under src/session/, src/tools/, and src/shared/
+ */
+// Tool exports (for MCP server usage)
+export { getVisibleTools, executeTool } from './tools/index.js';
+//# sourceMappingURL=tools-manager.js.map

package/dist/tools-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-manager.js","sourceRoot":"","sources":["../src/tools-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sCAAsC;AACtC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types/core.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Core type definitions for the Spec-Docs MCP server
+ */
+import type { HEADING_DEPTHS, INSERT_MODES } from '../constants/defaults.js';
+/** Valid heading depths */
+export type HeadingDepth = typeof HEADING_DEPTHS[number];
+/** Valid insert modes for creating sections */
+export type InsertMode = typeof INSERT_MODES[number];
+/** File snapshot with content and modification time */
+export interface FileSnapshot {
+    readonly content: string;
+    readonly mtimeMs: number;
+}
+/** Heading information with hierarchy */
+export interface Heading {
+    readonly index: number;
+    readonly depth: HeadingDepth;
+    readonly title: string;
+    readonly slug: string;
+    readonly parentIndex: number | null;
+}
+/** Table of Contents node */
+export interface TocNode {
+    readonly title: string;
+    readonly slug: string;
+    readonly depth: HeadingDepth;
+    readonly children: readonly TocNode[];
+}
+/** Error with additional context */
+export interface SpecDocsError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown>;
+}
+/** Configuration for the MCP server */
+export interface ServerConfig {
+    readonly serverName: string;
+    readonly serverVersion: string;
+    readonly logLevel: string;
+    readonly workspaceBasePath: string;
+    readonly workflowsBasePath: string;
+    readonly guidesBasePath: string;
+    readonly docsBasePath: string;
+    readonly archivedBasePath: string;
+    readonly coordinatorBasePath: string;
+    readonly maxFileSize: number;
+    readonly maxFilesPerOperation: number;
+    readonly rateLimitRequestsPerMinute: number;
+    readonly rateLimitBurstSize: number;
+    readonly enableFileSafetyChecks: boolean;
+    readonly enableMtimePrecondition: boolean;
+    readonly referenceExtractionDepth: number;
+}
+/** Logger interface */
+export interface Logger {
+    error(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+}
+/** Project configuration from .mcp-config.json */
+export interface ProjectConfig {
+    readonly env: {
+        readonly MCP_WORKSPACE_PATH?: string;
+        readonly WORKFLOWS_BASE_PATH?: string;
+        readonly GUIDES_BASE_PATH?: string;
+        readonly DOCS_BASE_PATH?: string;
+        readonly ARCHIVED_BASE_PATH?: string;
+        readonly COORDINATOR_BASE_PATH?: string;
+    };
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/types/core.d.ts.map

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

package/dist/types/core.js

@@ -0,0 +1,5 @@
+/**
+ * Core type definitions for the Spec-Docs MCP server
+ */
+export {};
+//# sourceMappingURL=core.js.map

package/dist/types/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Type exports for the Spec-Docs MCP server
+ */
+export type { HeadingDepth, InsertMode, FileSnapshot, Heading, TocNode, SpecDocsError, ServerConfig, Logger, ProjectConfig, } from './core.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,OAAO,EACP,OAAO,EACP,aAAa,EACb,YAAY,EACZ,MAAM,EACN,aAAa,GACd,MAAM,WAAW,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Type exports for the Spec-Docs MCP server
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/linking.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Type definitions for the Document Linking System
+ */
+/**
+ * Parsed link reference with structural information
+ */
+export interface ParsedLink {
+    /** Type of link reference */
+    type: 'cross-doc' | 'within-doc' | 'external';
+    /** Full document path (for cross-doc links) */
+    document?: string;
+    /** Hierarchical section slug (for section links) */
+    section?: string;
+    /** Original link text as provided */
+    raw: string;
+}
+/**
+ * Link validation result with detailed feedback
+ */
+export interface LinkValidation {
+    /** Whether the link is valid and accessible */
+    valid: boolean;
+    /** Whether the referenced document exists */
+    documentExists?: boolean;
+    /** Whether the referenced section exists (if specified) */
+    sectionExists?: boolean;
+    /** Error message if validation failed */
+    error?: string;
+    /** Suggested correction or alternative if available */
+    suggestion?: string;
+}
+/**
+ * Hierarchical slug structure with path components
+ */
+export interface HierarchicalSlug {
+    /** Complete slug path (e.g., "api/authentication/jwt-tokens") */
+    full: string;
+    /** Split components of the slug path */
+    parts: string[];
+    /** Nesting level (depth) of the slug */
+    depth: number;
+    /** Parent slug path (undefined for top-level) */
+    parent?: string;
+}
+/**
+ * Link context information for automatic loading
+ */
+export interface LinkContext {
+    /** Primary document being edited */
+    primaryDocument: string;
+    /** Current section being modified */
+    currentSection?: string;
+    /** Linked documents with relevant content */
+    linkedDocuments: unknown[];
+    /** Suggested related documents */
+    suggestions: unknown[];
+}
+/**
+ * Options for link resolution and validation
+ */
+export interface LinkOptions {
+    /** Maximum depth for context loading */
+    maxDepth?: number;
+    /** Whether to include suggested links */
+    includeSuggestions?: boolean;
+    /** Whether to validate existence during parsing */
+    validateExistence?: boolean;
+    /** Base path for resolving relative links */
+    basePath?: string;
+}
+/**
+ * Result of link resolution with full context
+ */
+export interface LinkResolution {
+    /** Parsed link structure */
+    parsed: ParsedLink;
+    /** Validation result */
+    validation: LinkValidation;
+    /** Resolved absolute path */
+    resolvedPath: string;
+    /** Loaded context (if requested) */
+    context?: LinkContext;
+}
+/**
+ * Slug path manipulation result
+ */
+export interface SlugPathOperation {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Resulting slug path */
+    result?: string;
+    /** Error message if operation failed */
+    error?: string;
+    /** Additional context about the operation */
+    context?: Record<string, unknown>;
+}
+//# sourceMappingURL=linking.d.ts.map

package/dist/types/linking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linking.d.ts","sourceRoot":"","sources":["../../src/types/linking.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;IAC9C,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,KAAK,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,kCAAkC;IAClC,WAAW,EAAE,OAAO,EAAE,CAAC;CACxB;AAKD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,wBAAwB;IACxB,UAAU,EAAE,cAAc,CAAC;IAC3B,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/types/linking.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the Document Linking System
+ */
+export {};
+//# sourceMappingURL=linking.js.map

package/dist/types/linking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linking.js","sourceRoot":"","sources":["../../src/types/linking.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/__tests__/path-handler.archive.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * TDD tests for archive path generation with /archived/docs/ prefix
+ *
+ * These tests verify that documents archive to /archived/docs/ to preserve source context
+ * and distinguish documents from coordinator tasks in archives.
+ */
+export {};
+//# sourceMappingURL=path-handler.archive.test.d.ts.map

package/dist/utils/__tests__/path-handler.archive.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-handler.archive.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/path-handler.archive.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}