ai-prompt-guide-mcp 1.0.0

package/dist/tools/schemas/section-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/section-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,IAAI,EAAE,QAAQ,CAAC;IAEf,kEAAkE;IAClE,UAAU,EAAE;QACV;;;;;;;;;;;;;;;;;WAiBG;QACH,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ,CAAC;YACf,WAAW,EAAE,yNAAyN,CAAC;SACxO,CAAC;QAEF;;;;;WAKG;QACH,UAAU,EAAE;YACV,IAAI,EAAE,OAAO,CAAC;YACd,WAAW,EAAE,oGAAoG,CAAC;YAClH,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ,CAAC;gBACf,UAAU,EAAE;oBACV,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ,CAAC;wBACf,WAAW,EAAE,6XAA6X,CAAC;qBAC5Y,CAAC;oBACF,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ,CAAC;wBACf,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;wBAClG,WAAW,EAAE,gBAAgB,CAAC;qBAC/B,CAAC;oBACF,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ,CAAC;wBACf,WAAW,EAAE,qDAAqD,CAAC;qBACpE,CAAC;oBACF,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ,CAAC;wBACf,WAAW,EAAE,iFAAiF,CAAC;qBAChG,CAAC;iBACH,CAAC;gBACF,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;aAC/C,CAAC;SACH,CAAC;KACH,CAAC;IAEF,wEAAwE;IACxE,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAErC,0DAA0D;IAC1D,oBAAoB,EAAE,KAAK,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;CAiBpB,CAAC;AAEX;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,QAAQ,GACR,SAAS,GACT,eAAe,GACf,cAAc,GACd,cAAc,GACd,QAAQ,CAAC;AAEb;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,cAAc,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;AAEvC;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,IAAI,aAAa,CAE7E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,IAAI,eAAe,CAEjF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,IAAI,eAAe,CAEjF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAuCrD"}

package/dist/tools/schemas/section-schemas.js

@@ -0,0 +1,182 @@
+/**
+ * Schema definitions for section tool
+ *
+ * This module defines the comprehensive input validation schema for the section
+ * MCP tool, supporting unified section operations including editing existing
+ * sections, creating new sections, and deleting sections.
+ */
+/**
+ * Schema constants for section tool
+ */
+export const SECTION_CONSTANTS = {
+    OPERATIONS: {
+        // Edit existing sections
+        REPLACE: 'replace',
+        APPEND: 'append',
+        PREPEND: 'prepend',
+        // Create new sections
+        INSERT_BEFORE: 'insert_before',
+        INSERT_AFTER: 'insert_after',
+        APPEND_CHILD: 'append_child',
+        // Delete sections
+        REMOVE: 'remove',
+    },
+    EDIT_OPERATIONS: ['replace', 'append', 'prepend'],
+    CREATE_OPERATIONS: ['insert_before', 'insert_after', 'append_child'],
+    DELETE_OPERATIONS: ['remove'],
+    DEFAULT_OPERATION: 'replace',
+};
+/**
+ * Helper functions for operation validation and categorization
+ *
+ * These type guard functions provide runtime validation and categorization
+ * of section operations, enabling operation-specific logic and validation.
+ */
+/**
+ * Type guard to check if operation is an edit operation
+ *
+ * Validates that the operation modifies existing section content without
+ * creating new sections or changing document structure.
+ *
+ * @param operation - Operation string to validate
+ * @returns True if operation is replace, append, or prepend
+ *
+ * @example Operation-specific validation
+ * ```typescript
+ * function validateEditParameters(operation: string, content: string): void {
+ *   if (isEditOperation(operation)) {
+ *     if (!content || content.trim() === '') {
+ *       throw new Error('Content is required for edit operations');
+ *     }
+ *     // Edit operations don't require title
+ *   }
+ * }
+ * ```
+ *
+ * @example Conditional logic
+ * ```typescript
+ * if (isEditOperation(operation)) {
+ *   // Handle existing section modification
+ *   return await editExistingSection(document, section, content, operation);
+ * }
+ * ```
+ */
+export function isEditOperation(operation) {
+    return SECTION_CONSTANTS.EDIT_OPERATIONS.includes(operation);
+}
+/**
+ * Type guard to check if operation is a create operation
+ *
+ * Validates that the operation creates new sections in the document
+ * with proper positioning relative to existing sections.
+ *
+ * @param operation - Operation string to validate
+ * @returns True if operation is insert_before, insert_after, or append_child
+ *
+ * @example Create operation validation
+ * ```typescript
+ * function validateCreateParameters(
+ *   operation: string,
+ *   content: string,
+ *   title?: string
+ * ): void {
+ *   if (isCreateOperation(operation)) {
+ *     if (!content || content.trim() === '') {
+ *       throw new Error('Content is required for create operations');
+ *     }
+ *     if (!title || title.trim() === '') {
+ *       throw new Error('Title is required for create operations');
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @example Depth calculation for child sections
+ * ```typescript
+ * if (isCreateOperation(operation) && operation === 'append_child') {
+ *   const parentDepth = findSectionDepth(document, referenceSection);
+ *   const newDepth = parentDepth + 1;
+ *   return createSectionWithDepth(title, content, newDepth);
+ * }
+ * ```
+ */
+export function isCreateOperation(operation) {
+    return SECTION_CONSTANTS.CREATE_OPERATIONS.includes(operation);
+}
+/**
+ * Type guard to check if operation is a delete operation
+ *
+ * Validates that the operation removes sections from the document,
+ * including all subsections and related content.
+ *
+ * @param operation - Operation string to validate
+ * @returns True if operation is remove
+ *
+ * @example Delete operation handling
+ * ```typescript
+ * function validateDeleteOperation(operation: string): void {
+ *   if (isDeleteOperation(operation)) {
+ *     // Delete operations don't require content or title
+ *     console.warn('Delete operation will remove section and all subsections');
+ *   }
+ * }
+ * ```
+ *
+ * @example Confirmation workflow
+ * ```typescript
+ * if (isDeleteOperation(operation)) {
+ *   const subsections = findSubsections(document, targetSection);
+ *   if (subsections.length > 0) {
+ *     console.log(`Warning: Will also delete ${subsections.length} subsections`);
+ *   }
+ *   return await deleteSection(document, targetSection);
+ * }
+ * ```
+ */
+export function isDeleteOperation(operation) {
+    return SECTION_CONSTANTS.DELETE_OPERATIONS.includes(operation);
+}
+/**
+ * Get the input schema for section tool (bulk operations only)
+ */
+export function getSectionSchema() {
+    return {
+        type: 'object',
+        properties: {
+            document: {
+                type: 'string',
+                description: 'Document path (e.g., "/docs/specs/search-api.md"). ALWAYS required - provides default context for all operations. Individual section fields can override with full path "/other.md#slug" for multi-document operations.',
+            },
+            operations: {
+                type: 'array',
+                description: 'Array of section operations to perform. Always pass operations as an array, even for single edits.',
+                items: {
+                    type: 'object',
+                    properties: {
+                        section: {
+                            type: 'string',
+                            description: 'Section slug or full path with override support. THREE FORMATS: 1) "slug" - uses document parameter as context, 2) "#slug" - uses document parameter as context (with # prefix), 3) "/other.md#slug" - overrides document parameter for this operation. Example multi-document: document="/docs/api/auth.md" with section="/docs/api/security.md#authentication" edits security.md instead.',
+                        },
+                        operation: {
+                            type: 'string',
+                            enum: ['replace', 'append', 'prepend', 'insert_before', 'insert_after', 'append_child', 'remove'],
+                            description: 'Operation type',
+                        },
+                        content: {
+                            type: 'string',
+                            description: 'Content for the operation (empty string for remove)',
+                        },
+                        title: {
+                            type: 'string',
+                            description: 'Title for new sections (required for insert_before, insert_after, append_child)',
+                        },
+                    },
+                    required: ['section', 'operation', 'content'],
+                },
+            },
+        },
+        required: ['document', 'operations'],
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=section-schemas.js.map

package/dist/tools/schemas/section-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas/section-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkIH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,UAAU,EAAE;QACV,yBAAyB;QACzB,OAAO,EAAE,SAAS;QAClB,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,SAAS;QAClB,sBAAsB;QACtB,aAAa,EAAE,eAAe;QAC9B,YAAY,EAAE,cAAc;QAC5B,YAAY,EAAE,cAAc;QAC5B,kBAAkB;QAClB,MAAM,EAAE,QAAQ;KACjB;IACD,eAAe,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAU;IAC1D,iBAAiB,EAAE,CAAC,eAAe,EAAE,cAAc,EAAE,cAAc,CAAU;IAC7E,iBAAiB,EAAE,CAAC,QAAQ,CAAU;IACtC,iBAAiB,EAAE,SAAS;CACpB,CAAC;AAsHX;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,iBAAiB,CAAC,eAAe,CAAC,QAAQ,CAAC,SAA0B,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,iBAAiB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAA4B,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,iBAAiB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAA4B,CAAC,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yNAAyN;aACvO;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,oGAAoG;gBACjH,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,6XAA6X;yBAC3Y;wBACD,SAAS,EAAE;4BACT,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,CAAC;4BACjG,WAAW,EAAE,gBAAgB;yBAC9B;wBACD,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,qDAAqD;yBACnE;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,iFAAiF;yBAC/F;qBACF;oBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC;iBAC9C;aACF;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;QACpC,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC"}

package/dist/tools/schemas/start-coordinator-task-schemas.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Schema definitions for start_coordinator_task tool
+ *
+ * The start_coordinator_task tool signals "I'm starting work on this task" for
+ * coordinator tasks. Provides full context including main workflow (from first task),
+ * task-specific workflow, and referenced documents.
+ *
+ * COORDINATOR MODE:
+ * - Sequential only (NO #slug allowed)
+ * - Works with /coordinator/ namespace
+ * - Conditionally returns task context based on return_task_context parameter (default: false)
+ * - When returning context: includes Main-Workflow from first task + task workflow + references
+ * - Auto-finds next pending task
+ */
+export interface StartCoordinatorTaskInputSchema {
+    type: 'object';
+    properties: {
+        return_task_context: {
+            type: 'boolean';
+            description: 'Return task with full context (default: false). ⚠️ ONLY use when: resuming after context compression OR after a few subagent calls when context feels stale. DO NOT use on first task start (wastes ~1000 tokens). When true: injects Main-Workflow, task workflow, and @references.';
+        };
+    };
+    required: never[];
+    additionalProperties: false;
+}
+/**
+ * Get the input schema for start_coordinator_task tool
+ */
+export declare function getStartCoordinatorTaskSchema(): StartCoordinatorTaskInputSchema;
+//# sourceMappingURL=start-coordinator-task-schemas.d.ts.map

package/dist/tools/schemas/start-coordinator-task-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-coordinator-task-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/start-coordinator-task-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACV,mBAAmB,EAAE;YACnB,IAAI,EAAE,SAAS,CAAC;YAChB,WAAW,EAAE,sRAAsR,CAAC;SACrS,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClB,oBAAoB,EAAE,KAAK,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,+BAA+B,CAY/E"}

package/dist/tools/schemas/start-coordinator-task-schemas.js

@@ -0,0 +1,31 @@
+/**
+ * Schema definitions for start_coordinator_task tool
+ *
+ * The start_coordinator_task tool signals "I'm starting work on this task" for
+ * coordinator tasks. Provides full context including main workflow (from first task),
+ * task-specific workflow, and referenced documents.
+ *
+ * COORDINATOR MODE:
+ * - Sequential only (NO #slug allowed)
+ * - Works with /coordinator/ namespace
+ * - Conditionally returns task context based on return_task_context parameter (default: false)
+ * - When returning context: includes Main-Workflow from first task + task workflow + references
+ * - Auto-finds next pending task
+ */
+/**
+ * Get the input schema for start_coordinator_task tool
+ */
+export function getStartCoordinatorTaskSchema() {
+    return {
+        type: 'object',
+        properties: {
+            return_task_context: {
+                type: 'boolean',
+                description: 'Return task with full context (default: false). ⚠️ ONLY use when: resuming after context compression OR after a few subagent calls when context feels stale. DO NOT use on first task start (wastes ~1000 tokens). When true: injects Main-Workflow, task workflow, and @references.',
+            },
+        },
+        required: [],
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=start-coordinator-task-schemas.js.map

package/dist/tools/schemas/start-coordinator-task-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-coordinator-task-schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas/start-coordinator-task-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAcH;;GAEG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,mBAAmB,EAAE;gBACnB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,sRAAsR;aACpS;SACF;QACD,QAAQ,EAAE,EAAE;QACZ,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC"}

package/dist/tools/schemas/start-subagent-task-schemas.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Schema definitions for start_subagent_task tool
+ *
+ * The start_subagent_task tool signals "I'm starting work on this task" for
+ * subagent tasks. Provides full context including task workflow and referenced
+ * documents. This is the primary tool for initiating subagent work or resuming
+ * after context compression.
+ *
+ * SUBAGENT MODE:
+ * - REQUIRES #slug (ad-hoc mode only)
+ * - Works with /docs/ namespace
+ * - Injects task workflow only (no main workflow)
+ */
+export interface StartSubagentTaskInputSchema {
+    type: 'object';
+    properties: {
+        document: {
+            type: 'string';
+            description: string;
+        };
+    };
+    required: ['document'];
+    additionalProperties: false;
+}
+/**
+ * Get the input schema for start_subagent_task tool
+ */
+export declare function getStartSubagentTaskSchema(): StartSubagentTaskInputSchema;
+//# sourceMappingURL=start-subagent-task-schemas.d.ts.map

package/dist/tools/schemas/start-subagent-task-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-subagent-task-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/start-subagent-task-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,4BAA4B;IAC3C,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,wBAAgB,0BAA0B,IAAI,4BAA4B,CAsBzE"}

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

@@ -0,0 +1,40 @@
+/**
+ * Schema definitions for start_subagent_task tool
+ *
+ * The start_subagent_task tool signals "I'm starting work on this task" for
+ * subagent tasks. Provides full context including task workflow and referenced
+ * documents. This is the primary tool for initiating subagent work or resuming
+ * after context compression.
+ *
+ * SUBAGENT MODE:
+ * - REQUIRES #slug (ad-hoc mode only)
+ * - Works with /docs/ namespace
+ * - Injects task workflow only (no main workflow)
+ */
+/**
+ * Get the input schema for start_subagent_task tool
+ */
+export function getStartSubagentTaskSchema() {
+    return {
+        type: 'object',
+        properties: {
+            document: {
+                type: 'string',
+                description: `Document path with task slug (REQUIRED).
+
+SUBAGENT MODE (AD-HOC ONLY):
+Format: "/docs/project/tasks.md#implement-auth"
+   → Starts the specified task
+   → Injects task workflow + references
+   → Use for assigned subagent tasks
+
+⚠️ IMPORTANT: Subagent tasks REQUIRE #slug (ad-hoc mode only)!
+Example: "/docs/project/tasks.md#implement-auth"
+Must be in /docs/ namespace.`,
+            },
+        },
+        required: ['document'],
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=start-subagent-task-schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-subagent-task-schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas/start-subagent-task-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAcH;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;;;;;;;;;;6BAUQ;aACtB;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Schema definitions for start_task tool
+ *
+ * The start_task tool signals "I'm starting work on this task" and provides
+ * full context including main workflow, task workflow, and referenced documents.
+ * This is the primary tool for initiating work or resuming after context compression.
+ */
+export interface StartTaskInputSchema {
+    type: 'object';
+    properties: {
+        document: {
+            type: 'string';
+            description: string;
+        };
+    };
+    required: ['document'];
+    additionalProperties: false;
+}
+/**
+ * Get the input schema for start_task tool
+ */
+export declare function getStartTaskSchema(): StartTaskInputSchema;
+//# sourceMappingURL=start-task-schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-task-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/start-task-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,oBAAoB;IACnC,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,wBAAgB,kBAAkB,IAAI,oBAAoB,CA2BzD"}

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

@@ -0,0 +1,39 @@
+/**
+ * Schema definitions for start_task tool
+ *
+ * The start_task tool signals "I'm starting work on this task" and provides
+ * full context including main workflow, task workflow, and referenced documents.
+ * This is the primary tool for initiating work or resuming after context compression.
+ */
+/**
+ * Get the input schema for start_task tool
+ */
+export function getStartTaskSchema() {
+    return {
+        type: 'object',
+        properties: {
+            document: {
+                type: 'string',
+                description: `Document path with optional task slug.
+
+TWO MODES:
+1. Sequential: "/project/tasks.md"
+   → Starts first pending/in_progress task
+   → Injects main workflow + task workflow + references
+   → Use for systematic work through a project
+
+2. Ad-hoc: "/project/tasks.md#implement-auth"
+   → Starts ONLY the specified task
+   → Injects task workflow ONLY (no main workflow)
+   → Use when a specific task was assigned to you
+
+⚠️ IMPORTANT: If you were assigned a specific task, ALWAYS include the full path with #slug!
+Example: If assigned "#implement-auth", use "/project/tasks.md#implement-auth"
+Otherwise you will start the WRONG TASK!`,
+            },
+        },
+        required: ['document'],
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=start-task-schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-task-schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas/start-task-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;;;;;;;;;;;;;;;yCAeoB;aAClC;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,93 @@
+/**
+ * Schema definitions for subagent_task tool - Bulk operations only
+ * Works with /docs/ namespace for ad-hoc subagent task management
+ */
+/**
+ * Individual task operation within the operations array
+ *
+ * NOTE: List operations return tasks with has_references flag (boolean)
+ * but do NOT load full referenced_documents to prevent context bloat.
+ * Use view_subagent_task or start_subagent_task to load full references.
+ */
+export interface SubagentTaskOperationSchema {
+    operation: 'create' | 'edit' | 'list';
+    title?: string;
+    content?: string;
+    task?: string;
+    status?: string;
+}
+/**
+ * Main input schema for bulk subagent task operations
+ */
+export interface SubagentTaskInputSchema {
+    type: 'object';
+    properties: {
+        document: {
+            type: 'string';
+            description: 'Document path (e.g., "/docs/project/tasks.md"). ALWAYS required - provides context for all operations. NOTE: Subagent tasks should use /docs/ namespace.';
+        };
+        operations: {
+            type: 'array';
+            description: 'Array of task operations to perform';
+            items: {
+                type: 'object';
+                properties: {
+                    operation: {
+                        type: 'string';
+                        enum: ['create', 'edit', 'list'];
+                        description: 'Task operation type';
+                    };
+                    title: {
+                        type: 'string';
+                        description: 'Task title (required for create)';
+                    };
+                    content: {
+                        type: 'string';
+                        description: 'Task content with optional @references and workflow metadata (Workflow: workflow_name, Main-Workflow: workflow_name). Use the get_workflow tool to discover available workflow names.';
+                    };
+                    task: {
+                        type: 'string';
+                        description: 'Task slug. TWO FORMATS: 1) "slug" - uses document parameter as context, 2) "#slug" - uses document parameter as context (with # prefix). Required for edit operation.';
+                    };
+                    status: {
+                        type: 'string';
+                        enum: ['pending', 'in_progress', 'completed', 'blocked'];
+                        description: 'Filter by status for list operation';
+                    };
+                };
+                required: ['operation'];
+            };
+        };
+    };
+    required: ['document', 'operations'];
+    additionalProperties: false;
+}
+/**
+ * Schema constants for subagent task tool
+ */
+export declare const SUBAGENT_TASK_CONSTANTS: {
+    readonly OPERATIONS: {
+        readonly CREATE: "create";
+        readonly EDIT: "edit";
+        readonly LIST: "list";
+    };
+    readonly STATUSES: {
+        readonly PENDING: "pending";
+        readonly IN_PROGRESS: "in_progress";
+        readonly COMPLETED: "completed";
+        readonly BLOCKED: "blocked";
+    };
+    readonly MAX_TITLE_LENGTH: 200;
+    readonly MAX_CONTENT_LENGTH: 2000;
+    readonly MAX_NOTE_LENGTH: 1000;
+};
+/**
+ * Helper functions for subagent task validation
+ */
+export declare function isValidSubagentTaskOperation(operation: string): boolean;
+export declare function isValidSubagentTaskStatus(status: string): boolean;
+/**
+ * Get the input schema for subagent_task tool (bulk operations only)
+ */
+export declare function getSubagentTaskSchema(): SubagentTaskInputSchema;
+//# sourceMappingURL=subagent-task-schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-task-schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/schemas/subagent-task-schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE;QACV,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ,CAAC;YACf,WAAW,EAAE,0JAA0J,CAAC;SACzK,CAAC;QACF,UAAU,EAAE;YACV,IAAI,EAAE,OAAO,CAAC;YACd,WAAW,EAAE,qCAAqC,CAAC;YACnD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ,CAAC;gBACf,UAAU,EAAE;oBACV,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ,CAAC;wBACf,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;wBACjC,WAAW,EAAE,qBAAqB,CAAC;qBACpC,CAAC;oBACF,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ,CAAC;wBACf,WAAW,EAAE,kCAAkC,CAAC;qBACjD,CAAC;oBACF,OAAO,EAAE;wBACP,IAAI,EAAE,QAAQ,CAAC;wBACf,WAAW,EAAE,uLAAuL,CAAC;qBACtM,CAAC;oBACF,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ,CAAC;wBACf,WAAW,EAAE,uKAAuK,CAAC;qBACtL,CAAC;oBACF,MAAM,EAAE;wBACN,IAAI,EAAE,QAAQ,CAAC;wBACf,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;wBACzD,WAAW,EAAE,qCAAqC,CAAC;qBACpD,CAAC;iBACH,CAAC;gBACF,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC;aACzB,CAAC;SACH,CAAC;KACH,CAAC;IACF,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACrC,oBAAoB,EAAE,KAAK,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;CAe1B,CAAC;AAEX;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,uBAAuB,CA4C/D"}

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

@@ -0,0 +1,81 @@
+/**
+ * Schema definitions for subagent_task tool - Bulk operations only
+ * Works with /docs/ namespace for ad-hoc subagent task management
+ */
+/**
+ * Schema constants for subagent task tool
+ */
+export const SUBAGENT_TASK_CONSTANTS = {
+    OPERATIONS: {
+        CREATE: 'create',
+        EDIT: 'edit',
+        LIST: 'list',
+    },
+    STATUSES: {
+        PENDING: 'pending',
+        IN_PROGRESS: 'in_progress',
+        COMPLETED: 'completed',
+        BLOCKED: 'blocked',
+    },
+    MAX_TITLE_LENGTH: 200,
+    MAX_CONTENT_LENGTH: 2000,
+    MAX_NOTE_LENGTH: 1000,
+};
+/**
+ * Helper functions for subagent task validation
+ */
+export function isValidSubagentTaskOperation(operation) {
+    return Object.values(SUBAGENT_TASK_CONSTANTS.OPERATIONS).includes(operation);
+}
+export function isValidSubagentTaskStatus(status) {
+    return Object.values(SUBAGENT_TASK_CONSTANTS.STATUSES).includes(status);
+}
+/**
+ * Get the input schema for subagent_task tool (bulk operations only)
+ */
+export function getSubagentTaskSchema() {
+    return {
+        type: 'object',
+        properties: {
+            document: {
+                type: 'string',
+                description: 'Document path (e.g., "/docs/project/tasks.md"). ALWAYS required - provides context for all operations. NOTE: Subagent tasks should use /docs/ namespace.',
+            },
+            operations: {
+                type: 'array',
+                description: 'Array of task operations to perform',
+                items: {
+                    type: 'object',
+                    properties: {
+                        operation: {
+                            type: 'string',
+                            enum: ['create', 'edit', 'list'],
+                            description: 'Task operation type'
+                        },
+                        title: {
+                            type: 'string',
+                            description: 'Task title (required for create)'
+                        },
+                        content: {
+                            type: 'string',
+                            description: 'Task content with optional @references and workflow metadata (Workflow: workflow_name, Main-Workflow: workflow_name). Use the get_workflow tool to discover available workflow names.'
+                        },
+                        task: {
+                            type: 'string',
+                            description: 'Task slug. TWO FORMATS: 1) "slug" - uses document parameter as context, 2) "#slug" - uses document parameter as context (with # prefix). Required for edit operation.'
+                        },
+                        status: {
+                            type: 'string',
+                            enum: ['pending', 'in_progress', 'completed', 'blocked'],
+                            description: 'Filter by status for list operation'
+                        }
+                    },
+                    required: ['operation']
+                }
+            }
+        },
+        required: ['document', 'operations'],
+        additionalProperties: false,
+    };
+}
+//# sourceMappingURL=subagent-task-schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-task-schemas.js","sourceRoot":"","sources":["../../../src/tools/schemas/subagent-task-schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgEH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,UAAU,EAAE;QACV,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;KACb;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,aAAa;QAC1B,SAAS,EAAE,WAAW;QACtB,OAAO,EAAE,SAAS;KACnB;IACD,gBAAgB,EAAE,GAAG;IACrB,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,IAAI;CACb,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,SAAiB;IAC5D,OAAO,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,SAAuC,CAAC,CAAC;AAC7G,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,OAAO,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAA6D,CAAC,CAAC;AACjI,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0JAA0J;aACxK;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,qCAAqC;gBAClD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,SAAS,EAAE;4BACT,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;4BAChC,WAAW,EAAE,qBAAqB;yBACnC;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,kCAAkC;yBAChD;wBACD,OAAO,EAAE;4BACP,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,uLAAuL;yBACrM;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,uKAAuK;yBACrL;wBACD,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC;4BACxD,WAAW,EAAE,qCAAqC;yBACnD;qBACF;oBACD,QAAQ,EAAE,CAAC,WAAW,CAAC;iBACxB;aACF;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;QACpC,oBAAoB,EAAE,KAAK;KAC5B,CAAC;AACJ,CAAC"}