devchain-cli 0.23.3 → 0.23.4

package/dist/server/modules/mcp/tool-descriptors/epic.metadata.js

@@ -2,10 +2,27 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.epicMetadata = void 0;
 const mcp_dto_1 = require("../dtos/mcp.dto");
+const NEW_EPIC_RELATION_INPUT_SCHEMA = {
+    type: 'object',
+    required: ['relatedEpicId', 'relation'],
+    properties: {
+        relatedEpicId: {
+            type: 'string',
+            pattern: '^[a-f0-9-]{8,36}$',
+            description: 'Related Epic UUID or 8+ character UUID prefix, resolved in the new Epic workspace',
+        },
+        relation: {
+            type: 'string',
+            enum: ['related', 'blocks', 'blocked_by'],
+            description: 'Relation value relative to the new Epic',
+        },
+    },
+    additionalProperties: false,
+};
 exports.epicMetadata = [
     {
         name: 'devchain_list_epics',
-        description: 'List epics for the project resolved from the session with optional filters',
+        description: "List epics for the project resolved from the session with optional filters. Each item carries a descriptionPreview (first ~300 characters) and descriptionLength instead of the full description; call devchain_get_epic_by_id for one epic's full text, or pass includeDescription: true to receive full descriptions in this list",
         inputSchema: {
             type: 'object',
             required: ['sessionId'],
@@ -24,6 +41,10 @@ exports.epicMetadata = [
                     type: 'string',
                     description: 'Optional search query applied to epic titles and descriptions',
                 },
+                includeDescription: {
+                    type: 'boolean',
+                    description: 'When true, each item returns the full description instead of descriptionPreview and descriptionLength',
+                },
             },
             additionalProperties: false,
         },
@@ -50,7 +71,7 @@ exports.epicMetadata = [
     },
     {
         name: 'devchain_create_epic',
-        description: 'Create a new epic within the project resolved from the session',
+        description: 'Create a new epic within the project resolved from the session. Optional relation (single) or relations (1-20) are created atomically with the epic in one transaction; a failed create leaves no partial state',
         inputSchema: {
             type: 'object',
             required: ['sessionId', 'title'],
@@ -84,22 +105,15 @@ exports.epicMetadata = [
                     description: 'Optional list of required skill slugs for this epic',
                 },
                 relation: {
-                    type: 'object',
-                    required: ['relatedEpicId', 'relation'],
-                    properties: {
-                        relatedEpicId: {
-                            type: 'string',
-                            pattern: '^[a-f0-9-]{8,36}$',
-                            description: 'Related Epic UUID or 8+ character UUID prefix, resolved in the new Epic workspace',
-                        },
-                        relation: {
-                            type: 'string',
-                            enum: ['related', 'blocks', 'blocked_by'],
-                            description: 'Relation value relative to the new Epic',
-                        },
-                    },
-                    additionalProperties: false,
-                    description: 'Optional single relation created atomically with the Epic',
+                    ...NEW_EPIC_RELATION_INPUT_SCHEMA,
+                    description: 'Optional single relation created atomically with the Epic (kept for compatibility; mutually exclusive with relations)',
+                },
+                relations: {
+                    type: 'array',
+                    minItems: 1,
+                    maxItems: 20,
+                    items: NEW_EPIC_RELATION_INPUT_SCHEMA,
+                    description: 'Optional relations (1-20) created atomically with the Epic in one transaction, written in input order (mutually exclusive with relation). Each target may appear once; a rolled-back create leaves no Epic, no relation, and no event. A new root Epic can hold only one eligible Related time route to same-project roots, so two such related entries fail with RELATION_ROUTE_CONFLICT naming both indexes; child-Epic and cross-project related entries never conflict',
                 },
             },
             additionalProperties: false,
@@ -108,7 +122,7 @@ exports.epicMetadata = [
     },
     {
         name: 'devchain_get_epic_by_id',
-        description: 'Fetch a single epic, including comments and related hierarchy details',
+        description: "Fetch a single epic, including comments and related hierarchy details. The parent is a summary ({ id, title, status, agentName }); pass includeParentDescription: true to also get the parent's full description for phase context, or call this tool with the parent id",
         inputSchema: {
             type: 'object',
             required: ['sessionId', 'id'],
@@ -121,6 +135,10 @@ exports.epicMetadata = [
                     type: 'string',
                     description: 'Epic UUID or 8+ char hex prefix (a-f, 0-9, hyphens only; max 36 chars)',
                 },
+                includeParentDescription: {
+                    type: 'boolean',
+                    description: "When true, the parent summary also carries the parent epic's full description",
+                },
             },
             additionalProperties: false,
         },
@@ -263,7 +281,7 @@ exports.epicMetadata = [
     },
     {
         name: 'devchain_update_epic',
-        description: 'Update an epic with flexible field updates including status (by name), assignment (by agent name or clear), parent hierarchy, and tags. Uses optimistic locking via version. Tag-only examples: replace `{ sessionId, id, version, setTags: [...] }`, add `{ sessionId, id, version, addTags: [...] }`, remove `{ sessionId, id, version, removeTags: [...] }`.',
+        description: 'Update an epic with flexible field updates including status (by name), assignment (by agent name or clear), parent hierarchy, and tags. Uses optimistic locking via version. For small description changes, prefer descriptionEdits (literal find/replace, applied in order) or appendDescription over resending the full description; each find text must occur exactly once in the current description, so include enough surrounding context to make it unique. The response shows the context around each edited part, so a re-read is not needed; after VERSION_CONFLICT, re-read the epic (devchain_get_epic_by_id) and retry with the current version and text. Tag-only examples: replace `{ sessionId, id, version, setTags: [...] }`, add `{ sessionId, id, version, addTags: [...] }`, remove `{ sessionId, id, version, removeTags: [...] }`.',
         inputSchema: {
             type: 'object',
             required: ['sessionId', 'id', 'version'],
@@ -278,7 +296,37 @@ exports.epicMetadata = [
                 },
                 version: { type: 'number', description: 'Current version for optimistic locking' },
                 title: { type: 'string', description: 'New epic title' },
-                description: { type: 'string', description: 'New epic description' },
+                description: {
+                    type: 'string',
+                    description: 'Full new epic description (mutually exclusive with descriptionEdits and appendDescription; prefer edits for small changes)',
+                },
+                descriptionEdits: {
+                    type: 'array',
+                    minItems: 1,
+                    maxItems: 50,
+                    items: {
+                        type: 'object',
+                        required: ['find', 'replace'],
+                        properties: {
+                            find: {
+                                type: 'string',
+                                minLength: 1,
+                                description: 'Literal text to replace (no regex, no patterns); must occur exactly once in the current description — include enough surrounding context to make it unique',
+                            },
+                            replace: {
+                                type: 'string',
+                                description: 'Literal replacement text; $&, $1, and $$ have no special meaning and stay plain text',
+                            },
+                        },
+                        additionalProperties: false,
+                    },
+                    description: 'Ordered literal find/replace edits applied to the current description (1-50 items, mutually exclusive with description); all edits apply atomically under the version lock',
+                },
+                appendDescription: {
+                    type: 'string',
+                    minLength: 1,
+                    description: 'Text appended to the end of the current description (mutually exclusive with description); can combine with descriptionEdits',
+                },
                 statusName: {
                     type: 'string',
                     description: 'Status name (case-insensitive exact match)',

package/dist/server/modules/mcp/tool-descriptors/epic.metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"epic.metadata.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tool-descriptors/epic.metadata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"epic.metadata.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tool-descriptors/epic.metadata.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/mcp/tool-descriptors/skill.bindings.js

@@ -7,11 +7,17 @@ const binding_types_1 = require("./binding-types");
 function createSkillContext(runtime) {
     return {
         skillsService: runtime.skillsService ?? (0, null_adapter_1.createNullAdapter)('SkillsService'),
+        skillSourceLifecycleService: runtime.skillSourceLifecycleService ??
+            (0, null_adapter_1.createNullAdapter)('SkillSourceLifecycleService'),
         resolveSessionContext: runtime.resolveSessionContext,
     };
 }
 exports.skillBindings = (0, binding_types_1.defineToolGroup)(createSkillContext, [
     ['devchain_list_skills', skill_tools_1.handleListSkills],
     ['devchain_get_skill', skill_tools_1.handleGetSkill],
+    ['devchain_skills_usage_stats', skill_tools_1.handleSkillsUsageStats],
+    ['devchain_skills_set_enabled', skill_tools_1.handleSkillsSetEnabled],
+    ['devchain_skills_set_source_enabled', skill_tools_1.handleSkillsSetSourceEnabled],
+    ['devchain_skills_sync', skill_tools_1.handleSkillsSync],
 ]);
 //# sourceMappingURL=skill.bindings.js.map

package/dist/server/modules/mcp/tool-descriptors/skill.bindings.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill.bindings.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tool-descriptors/skill.bindings.ts"],"names":[],"mappings":";;;AAEA,kEAAoF;AACpF,oEAAsE;AACtE,mDAA0E;AAE1E,SAAS,kBAAkB,CAAC,OAA0B;IACpD,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAA,gCAAiB,EAAgB,eAAe,CAAC;QACzF,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;KACrD,CAAC;AACJ,CAAC;AAEY,QAAA,aAAa,GAAG,IAAA,+BAAe,EAAmB,kBAAkB,EAAE;IACjF,CAAC,sBAAsB,EAAE,8BAAgB,CAAC;IAC1C,CAAC,oBAAoB,EAAE,4BAAc,CAAC;CACvC,CAAC,CAAC"}
+{"version":3,"file":"skill.bindings.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tool-descriptors/skill.bindings.ts"],"names":[],"mappings":";;;AAGA,kEAO0C;AAC1C,oEAAsE;AACtE,mDAA0E;AAE1E,SAAS,kBAAkB,CAAC,OAA0B;IACpD,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAA,gCAAiB,EAAgB,eAAe,CAAC;QACzF,2BAA2B,EACzB,OAAO,CAAC,2BAA2B;YACnC,IAAA,gCAAiB,EAA8B,6BAA6B,CAAC;QAC/E,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;KACrD,CAAC;AACJ,CAAC;AAEY,QAAA,aAAa,GAAG,IAAA,+BAAe,EAAmB,kBAAkB,EAAE;IACjF,CAAC,sBAAsB,EAAE,8BAAgB,CAAC;IAC1C,CAAC,oBAAoB,EAAE,4BAAc,CAAC;IACtC,CAAC,6BAA6B,EAAE,oCAAsB,CAAC;IACvD,CAAC,6BAA6B,EAAE,oCAAsB,CAAC;IACvD,CAAC,oCAAoC,EAAE,0CAA4B,CAAC;IACpE,CAAC,sBAAsB,EAAE,8BAAgB,CAAC;CAC3C,CAAC,CAAC"}

package/dist/server/modules/mcp/tool-descriptors/skill.metadata.js

@@ -5,7 +5,7 @@ const mcp_dto_1 = require("../dtos/mcp.dto");
 exports.skillMetadata = [
     {
         name: 'devchain_list_skills',
-        description: "List skills available to the session's project, excluding disabled skills. Supports optional q for multi-term keyword filtering across skill fields — space-separated terms match independently (e.g. 'react typescript test').",
+        description: "List skills available to the session's project, excluding disabled skills. Supports optional q for multi-term keyword filtering across skill fields — space-separated terms match independently (e.g. 'react typescript test'). With includeDisabled: true, returns every stored skill, including skills of sources disabled for the project and sources disabled globally; each item then carries four flags: disabled (effective state — true when any block applies), skillDisabled (the project disabled this skill), sourceProjectEnabled (default true), and sourceGloballyEnabled (default true). Skills with sourceGloballyEnabled: false are read-only for MCP. Their stored content can be stale, because disabled sources do not sync. The list is the last stored catalog, not a confirmed fresh one.",
         inputSchema: {
             type: 'object',
             required: ['sessionId'],
@@ -18,6 +18,10 @@ exports.skillMetadata = [
                     type: 'string',
                     description: 'Multi-term keyword filter. Space-separated terms match independently across slug, name, display name, and description. Results are ranked by relevance.',
                 },
+                includeDisabled: {
+                    type: 'boolean',
+                    description: 'When true, return every stored skill with the four state flags (disabled, skillDisabled, sourceProjectEnabled, sourceGloballyEnabled), including skills behind project-disabled and globally disabled sources. Default false lists only enabled (discoverable) skills with no flag fields. Skills with sourceGloballyEnabled: false are read-only for MCP; their content can be stale and the list is the last stored catalog.',
+                },
             },
             additionalProperties: false,
         },
@@ -25,7 +29,7 @@ exports.skillMetadata = [
     },
     {
         name: 'devchain_get_skill',
-        description: 'Get a skill by slug with full content/details and record usage from session context. Works even when the skill is disabled (disable only affects discovery).',
+        description: 'Get a skill by slug with full content/details and record usage from session context. Returns only skills that are enabled for the project; a disabled skill is never returned.',
         inputSchema: {
             type: 'object',
             required: ['sessionId', 'slug'],
@@ -36,12 +40,110 @@ exports.skillMetadata = [
                 },
                 slug: {
                     type: 'string',
-                    description: 'Skill slug in source/name form (for example: anthropic/code-review)',
+                    description: 'Full source/name slug or bare slug name (for example: anthropic/code-review or code-review)',
                 },
             },
             additionalProperties: false,
         },
         paramsSchema: mcp_dto_1.GetSkillParamsSchema,
     },
+    {
+        name: 'devchain_skills_usage_stats',
+        description: "Read the complete skill usage statistics for the session's project in one unpaged response. Usage counts successful devchain_get_skill loads only; it does not prove that a skill helped. Returns summary {totalEvents, distinctSkills, firstEventAt, lastEventAt} and skills[] rows {slug, name, displayName, usageCount, firstAccessedAt, lastAccessedAt} for every used skill; complete is always true, so a missing slug means zero recorded use. Also returns epicReferences[]: for each slug, how many of the project's epics (parents and children, each counted once per slug) currently require it, grouped by status label. epicReferences describes current project requirements and ignores the from/to window; status labels carry no closed flag.",
+        inputSchema: {
+            type: 'object',
+            required: ['sessionId'],
+            properties: {
+                sessionId: {
+                    type: 'string',
+                    description: 'Session ID (full UUID or 8+ char prefix)',
+                },
+                from: {
+                    type: 'string',
+                    description: 'Optional inclusive ISO timestamp lower bound for usage events. Does not affect epicReferences.',
+                },
+                to: {
+                    type: 'string',
+                    description: 'Optional inclusive ISO timestamp upper bound for usage events. Does not affect epicReferences.',
+                },
+            },
+            additionalProperties: false,
+        },
+        paramsSchema: mcp_dto_1.SkillsUsageStatsParamsSchema,
+    },
+    {
+        name: 'devchain_skills_set_enabled',
+        description: 'Enable or disable a batch of skills (1-200 full source/name slugs) for the session project. Project-wide effect: the change applies to every agent of the project, and other projects stay unchanged. The tool does not check for human approval — confirm with the user before calling it. Resolves slugs among skills of globally enabled sources, including sources that are disabled for this project, so a skill-level toggle can land while its source is still project-disabled. Skills of globally disabled sources are read-only and return notFound. The compared state is the skill-level disable, independent of any source-level disable. Slugs are trimmed, lowercased, and deduplicated. Returns { updatedCount, unchanged, notFound }: unchanged lists slugs already in the requested skill-level state, notFound lists slugs that do not exist or whose source is disabled globally, and every other requested slug changed state (the changed slugs are not echoed; derive them as the request minus unchanged and notFound). Guests and sessions without agent context are rejected.',
+        inputSchema: {
+            type: 'object',
+            required: ['sessionId', 'slugs', 'enabled'],
+            properties: {
+                sessionId: {
+                    type: 'string',
+                    description: 'Session ID (full UUID or 8+ char prefix)',
+                },
+                slugs: {
+                    type: 'array',
+                    minItems: 1,
+                    maxItems: 200,
+                    items: {
+                        type: 'string',
+                        description: 'Full skill slug in source/name form (for example: anthropic/code-review)',
+                    },
+                    description: 'Skill slugs to enable or disable for the project.',
+                },
+                enabled: {
+                    type: 'boolean',
+                    description: 'true enables the skills for the project; false disables them.',
+                },
+            },
+            additionalProperties: false,
+        },
+        paramsSchema: mcp_dto_1.SkillsSetEnabledParamsSchema,
+    },
+    {
+        name: 'devchain_skills_set_source_enabled',
+        description: 'Enable or disable one skill source for the session project only; other projects and the global source state (settings skills.sources) are out of scope. Project-wide effect: the change applies to every agent of the project. The tool does not check for human approval — confirm with the user before calling it. Returns { name, projectId, projectEnabled }. An unknown source returns SOURCE_NOT_FOUND; a source disabled in global settings returns SOURCE_DISABLED_GLOBALLY (a project toggle has no effect there); both change nothing. Guests and sessions without agent context are rejected.',
+        inputSchema: {
+            type: 'object',
+            required: ['sessionId', 'sourceName', 'enabled'],
+            properties: {
+                sessionId: {
+                    type: 'string',
+                    description: 'Session ID (full UUID or 8+ char prefix)',
+                },
+                sourceName: {
+                    type: 'string',
+                    description: 'Registered skill source name (for example: anthropic or devchain-local). Matched case-insensitively after trimming.',
+                },
+                enabled: {
+                    type: 'boolean',
+                    description: 'true enables the source for the project; false disables it.',
+                },
+            },
+            additionalProperties: false,
+        },
+        paramsSchema: mcp_dto_1.SkillsSetSourceEnabledParamsSchema,
+    },
+    {
+        name: 'devchain_skills_sync',
+        description: 'Sync the skill catalog now and wait for the result: one source with sourceName, or every enabled source without it. Returns the SyncResult as it is (status, added, updated, removed, failed, unchanged, errors), including the already_running result when another sync holds the admission slot. The effect is global (all projects). GitHub sources download over the network, and a sync can take long. A disabled source is skipped and returns an empty result. A timeout, already_running, or errors do not confirm a fresh catalog. After an edit of a local skill, edit the authoritative local source folder (not the materialized contentPath), then sync that source. The tool does not check for human approval. An unknown source returns SOURCE_NOT_FOUND; guests and sessions without agent context are rejected.',
+        inputSchema: {
+            type: 'object',
+            required: ['sessionId'],
+            properties: {
+                sessionId: {
+                    type: 'string',
+                    description: 'Session ID (full UUID or 8+ char prefix)',
+                },
+                sourceName: {
+                    type: 'string',
+                    description: 'Optional registered skill source to sync (for example: devchain-local). Without it, every enabled source syncs.',
+                },
+            },
+            additionalProperties: false,
+        },
+        paramsSchema: mcp_dto_1.SkillsSyncParamsSchema,
+    },
 ];
 //# sourceMappingURL=skill.metadata.js.map

package/dist/server/modules/mcp/tool-descriptors/skill.metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill.metadata.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tool-descriptors/skill.metadata.ts"],"names":[],"mappings":";;;AAAA,6CAA+E;AAGlE,QAAA,aAAa,GAAwB;IAChD;QACE,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,iOAAiO;QACnO,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,WAAW,CAAC;YACvB,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0CAA0C;iBACxD;gBACD,CAAC,EAAE;oBACD,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,yJAAyJ;iBAC5J;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,YAAY,EAAE,gCAAsB;KACrC;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EACT,8JAA8J;QAChK,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;YAC/B,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0CAA0C;iBACxD;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qEAAqE;iBACnF;aACF;YACD,oBAAoB,EAAE,KAAK;SAC5B;QACD,YAAY,EAAE,8BAAoB;KACnC;CACF,CAAC"}
+{"version":3,"file":"skill.metadata.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tool-descriptors/skill.metadata.ts"],"names":[],"mappings":"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"}