autoproject-mcp 1.1.1 → 1.4.0

package/dist/tools/documentTools.js

@@ -2,11 +2,15 @@
 /**
  * MCP Tools: Product Document Management
  *
- * Provides 4 read-only tools for browsing and searching all document types
- * within a product via the AutoProject Agent API.
+ * Read + write tools for product content documents (PRD, BRD, ARCHITECTURE, etc.).
  *
- * Common documentTypeCode values (system-defined): PRD, BRD, TRD, SRS, FSD,
- * ARCHITECTURE, USER_GUIDE, RELEASE_NOTES, MEETING_NOTES, TEST_PLAN, etc.
+ * Typical align-with-implementation workflow:
+ *   1. list_documents (optional search/name) → pick documentId
+ *   2. get_document or get_document_sections → read current content
+ *   3. update_document_section (section-wise) and/or update_document (fullText/metadata)
+ *
+ * Common documentTypeCode values: PRD, BRD, TRD, SRS, FSD, ARCHITECTURE,
+ * USER_GUIDE, RELEASE_NOTES, MEETING_NOTES, TEST_PLAN, etc.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.documentToolDefinitions = void 0;
@@ -16,8 +20,9 @@ const DEFAULT_PRODUCT_ID = process.env.AUTOPROJECT_PRODUCT_ID ?? '';
 exports.documentToolDefinitions = [
     {
         name: 'list_documents',
-        description: 'List all documents for a product. Optionally filter by document type code (e.g. PRD, BRD, TRD, ARCHITECTURE, RELEASE_NOTES). ' +
-            'Returns document id, name, type, status, visibility, summary, and last-updated date.',
+        description: 'List documents for a product (names, types, status, summary). '
+            + 'Filter by documentType code and/or search/name (matches document name, slug, or summary). '
+            + 'Use this first to find the documentId before get_document or updates.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -26,6 +31,14 @@ exports.documentToolDefinitions = [
                     type: 'string',
                     description: 'Filter by document type code (e.g. PRD, BRD, TRD, ARCHITECTURE, RELEASE_NOTES, USER_GUIDE).',
                 },
+                search: {
+                    type: 'string',
+                    description: 'Search by document name, slug, or summary (case-insensitive). Alias: name.',
+                },
+                name: {
+                    type: 'string',
+                    description: 'Alias for search — find documents by name.',
+                },
                 limit: { type: 'number', description: 'Maximum number of results to return. Default: 50, max: 200.' },
             },
             required: [],
@@ -33,8 +46,8 @@ exports.documentToolDefinitions = [
     },
     {
         name: 'get_document',
-        description: 'Get the full content of a document including its latest version text and all sections. ' +
-            'Use this to read the actual content of a PRD, architecture doc, release notes, etc.',
+        description: 'Get a document fully: metadata, latest version fullText, and all sections. '
+            + 'Use when aligning a PRD/architecture doc with the current implementation.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -46,7 +59,8 @@ exports.documentToolDefinitions = [
     },
     {
         name: 'get_document_sections',
-        description: 'Get the structured sections of a document\'s current version. Useful for navigating large documents.',
+        description: 'Get the structured sections of a document\'s current version (sectionId, sectionKey, sectionName, content). '
+            + 'Prefer this for section-wise review before update_document_section.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -58,89 +72,133 @@ exports.documentToolDefinitions = [
     },
     {
         name: 'search_documents',
-        description: 'Full-text search across all document sections in a product. Returns matching sections with document name and type. ' +
-            'Useful for finding specific requirements, specs, or notes by keyword.',
+        description: 'Full-text search across document sections (and document names) in a product. '
+            + 'Returns matching sections with documentId, document name, and type.',
         inputSchema: {
             type: 'object',
             properties: {
                 productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
-                query: { type: 'string', description: 'Search term to find in document section content or titles.' },
+                query: { type: 'string', description: 'Search term to find in section content, section titles, or document names.' },
             },
             required: ['query'],
         },
     },
+    {
+        name: 'update_document',
+        description: 'Update a document\'s metadata and/or full text. '
+            + 'Metadata (name, summary, tags, status, visibility) patches in place. '
+            + 'fullText/content patches the current DRAFT version, or creates a new DRAFT version if the current one is published. '
+            + 'Requires write:documents scope. Prefer update_document_section for section-level edits.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                documentId: { type: 'string', description: 'Document UUID.' },
+                name: { type: 'string', description: 'New document name.' },
+                summary: { type: 'string', description: 'New document summary.' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Replacement tag list.' },
+                status: { type: 'string', description: 'Document status (e.g. DRAFT, PUBLISHED).' },
+                visibility: { type: 'string', description: 'Visibility (e.g. INTERNAL, PUBLIC).' },
+                fullText: { type: 'string', description: 'Full document markdown/text content.' },
+                content: { type: 'string', description: 'Alias for fullText.' },
+                changeSummary: { type: 'string', description: 'Optional note when creating/patching a version.' },
+            },
+            required: ['documentId'],
+        },
+    },
+    {
+        name: 'update_document_section',
+        description: 'Update one section of a document\'s current version (section-wise edit). '
+            + 'Identify the section by sectionId (from get_document_sections) and/or sectionKey. '
+            + 'If sectionKey is new, the section is created. Use to realign a section with the current implementation. '
+            + 'Requires write:documents scope.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product UUID. Defaults to AUTOPROJECT_PRODUCT_ID env.' },
+                documentId: { type: 'string', description: 'Document UUID.' },
+                sectionId: { type: 'string', description: 'Existing section UUID (preferred when updating).' },
+                sectionKey: { type: 'string', description: 'Stable section key (used to update or create).' },
+                sectionName: { type: 'string', description: 'Section title/heading.' },
+                content: { type: 'string', description: 'Section body content (markdown).' },
+                summary: { type: 'string', description: 'Optional short section summary.' },
+                sectionType: { type: 'string', description: 'Section type (e.g. PARAGRAPH, HEADING).' },
+                displayOrder: { type: 'number', description: 'Order among sections.' },
+                headingLevel: { type: 'number', description: 'Heading level (1–6) if applicable.' },
+                contentFormat: { type: 'string', description: 'Content format (default MARKDOWN).' },
+            },
+            required: ['documentId'],
+        },
+    },
 ];
-async function handleDocumentTool(toolName, args) {
-    const productId = args.productId || DEFAULT_PRODUCT_ID;
-    if (!productId) {
-        return { content: [{ type: 'text', text: 'Error: productId is required (or set AUTOPROJECT_PRODUCT_ID env).' }] };
+function resolveProductId(args) {
+    const id = args.productId || DEFAULT_PRODUCT_ID;
+    if (!id) {
+        throw new Error('productId is required (pass it or set AUTOPROJECT_PRODUCT_ID).');
     }
+    return id;
+}
+async function handleDocumentTool(toolName, args) {
+    const productId = resolveProductId(args);
     const documentId = args.documentId;
     switch (toolName) {
         case 'list_documents': {
-            const params = {};
-            if (args.documentType)
-                params.documentType = args.documentType;
-            if (args.limit)
-                params.limit = args.limit;
-            const data = await (0, client_js_1.apiGet)(`/products/${productId}/documents`, params);
-            const items = data?.items ?? [];
-            if (items.length === 0) {
-                return { content: [{ type: 'text', text: 'No documents found.' }] };
-            }
-            const lines = items.map((d) => `[${d.id}] [${d.documentTypeCode ?? 'N/A'}] ${d.name} | Status: ${d.status} | Visibility: ${d.visibility} | Updated: ${d.updatedAt}\n` +
-                (d.summary ? `  Summary: ${String(d.summary).slice(0, 120)}` : ''));
-            return { content: [{ type: 'text', text: `Documents (${items.length}):\n${lines.join('\n')}` }] };
+            return await (0, client_js_1.apiGet)(`/products/${productId}/documents`, {
+                documentType: args.documentType,
+                search: args.search ?? args.name,
+                limit: args.limit,
+            });
         }
         case 'get_document': {
             if (!documentId)
-                return { content: [{ type: 'text', text: 'Error: documentId is required.' }] };
-            const data = await (0, client_js_1.apiGet)(`/products/${productId}/documents/${documentId}`);
-            const d = data;
-            const header = `Document: ${d.name}\n` +
-                `ID: ${d.id} | Type: ${d.documentTypeCode ?? 'N/A'} (${d.documentTypeName ?? 'N/A'})\n` +
-                `Status: ${d.status} | Visibility: ${d.visibility} | Version: ${d.versionNumber ?? 'N/A'}\n` +
-                `Summary: ${d.summary ?? 'N/A'}\n` +
-                `Tags: ${Array.isArray(d.tags) && d.tags.length ? d.tags.join(', ') : 'none'}\n`;
-            const sections = d.sections ?? [];
-            let body;
-            if (d.fullText) {
-                body = `\n--- Full Text ---\n${d.fullText}`;
-            }
-            else if (sections.length > 0) {
-                const sectionLines = sections.map((s) => `${'#'.repeat(s.headingLevel || 2)} ${s.sectionName}\n${s.content ?? '(no content)'}`);
-                body = `\n--- Sections (${sections.length}) ---\n${sectionLines.join('\n\n')}`;
-            }
-            else {
-                body = '\n(No content available for this document)';
-            }
-            return { content: [{ type: 'text', text: header + body }] };
+                throw new Error('documentId is required.');
+            return await (0, client_js_1.apiGet)(`/products/${productId}/documents/${documentId}`);
         }
         case 'get_document_sections': {
             if (!documentId)
-                return { content: [{ type: 'text', text: 'Error: documentId is required.' }] };
-            const data = await (0, client_js_1.apiGet)(`/products/${productId}/documents/${documentId}/sections`);
-            const sections = data?.items ?? [];
-            if (sections.length === 0) {
-                return { content: [{ type: 'text', text: 'No sections found for this document.' }] };
-            }
-            const lines = sections.map((s) => `[${s.displayOrder}] ${'#'.repeat(s.headingLevel || 2)} ${s.sectionName} (${s.sectionType}) | key: ${s.sectionKey}`);
-            return { content: [{ type: 'text', text: `Sections (${sections.length}):\n${lines.join('\n')}` }] };
+                throw new Error('documentId is required.');
+            return await (0, client_js_1.apiGet)(`/products/${productId}/documents/${documentId}/sections`);
         }
         case 'search_documents': {
             const q = args.query || '';
             if (!q.trim())
-                return { content: [{ type: 'text', text: 'Error: query is required.' }] };
-            const data = await (0, client_js_1.apiGet)(`/products/${productId}/knowledge`, { q });
-            const results = data?.results ?? [];
-            if (results.length === 0) {
-                return { content: [{ type: 'text', text: `No results found for "${q}".` }] };
+                throw new Error('query is required.');
+            return await (0, client_js_1.apiGet)(`/products/${productId}/knowledge`, { q });
+        }
+        case 'update_document': {
+            if (!documentId)
+                throw new Error('documentId is required.');
+            return await (0, client_js_1.apiPatch)(`/products/${productId}/documents/${documentId}`, {
+                name: args.name,
+                summary: args.summary,
+                tags: args.tags,
+                status: args.status,
+                visibility: args.visibility,
+                fullText: args.fullText,
+                content: args.content,
+                changeSummary: args.changeSummary,
+            });
+        }
+        case 'update_document_section': {
+            if (!documentId)
+                throw new Error('documentId is required.');
+            if (!args.sectionId && !args.sectionKey) {
+                throw new Error('Provide sectionId and/or sectionKey.');
             }
-            const lines = results.map((r) => `[${r.documentTypeCode ?? 'N/A'}] ${r.documentName} › ${r.sectionName}\n  ${String(r.content ?? '').slice(0, 200)}`);
-            return { content: [{ type: 'text', text: `Search results for "${q}" (${results.length}):\n\n${lines.join('\n\n')}` }] };
+            return await (0, client_js_1.apiPatch)(`/products/${productId}/documents/${documentId}/sections`, {
+                sectionId: args.sectionId,
+                sectionKey: args.sectionKey,
+                sectionName: args.sectionName,
+                content: args.content,
+                summary: args.summary,
+                sectionType: args.sectionType,
+                displayOrder: args.displayOrder,
+                headingLevel: args.headingLevel,
+                contentFormat: args.contentFormat,
+            });
         }
         default:
-            return { content: [{ type: 'text', text: `Unknown document tool: ${toolName}` }] };
+            throw new Error(`Unknown document tool: ${toolName}`);
     }
 }
 //# sourceMappingURL=documentTools.js.map

package/dist/tools/documentTools.js.map

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

package/dist/tools/hierarchyTools.d.ts

@@ -1,6 +1,10 @@
 /**
  * MCP Tools: Hierarchy read and status update
- * Tools: get_feature_detail, get_task_detail, list_features, update_status
+ * Tools: get_hierarchy, list_modules, list_feature_groups, list_features,
+ *        get_feature_detail, get_task_detail, update_status
+ *
+ * Product hierarchy (UI terminology):
+ *   Module → Feature Group → Feature
  */
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
 export declare const hierarchyToolDefinitions: Tool[];

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

@@ -1 +1 @@
-{"version":3,"file":"hierarchyTools.d.ts","sourceRoot":"","sources":["../../src/tools/hierarchyTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,eAAO,MAAM,wBAAwB,EAAE,IAAI,EAqD1C,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,oBAwBpF"}
+{"version":3,"file":"hierarchyTools.d.ts","sourceRoot":"","sources":["../../src/tools/hierarchyTools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAG1D,eAAO,MAAM,wBAAwB,EAAE,IAAI,EAwG1C,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,oBA0CpF"}

package/dist/tools/hierarchyTools.js

@@ -1,7 +1,11 @@
 "use strict";
 /**
  * MCP Tools: Hierarchy read and status update
- * Tools: get_feature_detail, get_task_detail, list_features, update_status
+ * Tools: get_hierarchy, list_modules, list_feature_groups, list_features,
+ *        get_feature_detail, get_task_detail, update_status
+ *
+ * Product hierarchy (UI terminology):
+ *   Module → Feature Group → Feature
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.hierarchyToolDefinitions = void 0;
@@ -9,43 +13,86 @@ exports.handleHierarchyTool = handleHierarchyTool;
 const client_js_1 = require("../client.js");
 exports.hierarchyToolDefinitions = [
     {
-        name: 'get_feature_detail',
-        description: 'Get full details of a feature (SubFeature) by ID, including acceptance criteria.',
+        name: 'get_hierarchy',
+        description: 'Get the product hierarchy tree: modules with nested feature groups. ' +
+            'Use this first to discover module IDs, then list_features with moduleId/status to pull work.',
         inputSchema: {
             type: 'object',
             properties: {
                 productId: { type: 'string', description: 'Product ID' },
-                featureId: { type: 'string', description: 'Feature ID' },
             },
-            required: ['productId', 'featureId'],
+            required: ['productId'],
         },
     },
     {
-        name: 'get_task_detail',
-        description: 'Get details of a task, including description and current status.',
+        name: 'list_modules',
+        description: 'List modules (top level of the product hierarchy) with status and description. ' +
+            'Optionally filter by module status.',
         inputSchema: {
             type: 'object',
             properties: {
                 productId: { type: 'string', description: 'Product ID' },
-                taskId: { type: 'string', description: 'Task ID' },
+                status: { type: 'string', description: 'Filter by module status (e.g. IN_PROGRESS, COMPLETED)' },
+                limit: { type: 'number', description: 'Max results (default 50, max 200)' },
             },
-            required: ['productId', 'taskId'],
+            required: ['productId'],
+        },
+    },
+    {
+        name: 'list_feature_groups',
+        description: 'List feature groups (second hierarchy level). Filter by moduleId and/or status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID' },
+                moduleId: { type: 'string', description: 'Filter by parent module ID' },
+                status: { type: 'string', description: 'Filter by feature-group status' },
+                limit: { type: 'number', description: 'Max results (default 50, max 200)' },
+            },
+            required: ['productId'],
         },
     },
     {
         name: 'list_features',
-        description: 'List features (SubFeatures) within a product, with optional status/priority filter.',
+        description: 'List features (third hierarchy level) within a product. ' +
+            'Filter by status, priority, moduleId, and/or featureGroupId to pull incomplete work for a module.',
         inputSchema: {
             type: 'object',
             properties: {
                 productId: { type: 'string', description: 'Product ID' },
-                status: { type: 'string', description: 'Filter by status (e.g. IN_PROGRESS)' },
+                status: { type: 'string', description: 'Filter by feature status (e.g. IN_PROGRESS, TODO)' },
                 priority: { type: 'string', description: 'Filter by priority (e.g. HIGH)' },
-                limit: { type: 'number', description: 'Max results' },
+                moduleId: { type: 'string', description: 'Filter by parent module ID' },
+                featureGroupId: { type: 'string', description: 'Filter by parent feature-group ID' },
+                limit: { type: 'number', description: 'Max results (default 50, max 200)' },
             },
             required: ['productId'],
         },
     },
+    {
+        name: 'get_feature_detail',
+        description: 'Get full details of a feature by ID, including acceptance criteria.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID' },
+                featureId: { type: 'string', description: 'Feature ID' },
+            },
+            required: ['productId', 'featureId'],
+        },
+    },
+    {
+        name: 'get_task_detail',
+        description: 'Get details of a task, including description and current status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                productId: { type: 'string', description: 'Product ID' },
+                taskId: { type: 'string', description: 'Task ID' },
+            },
+            required: ['productId', 'taskId'],
+        },
+    },
     {
         name: 'update_status',
         description: 'Update the status of a feature, task, or micro-task. Status must follow valid workflow transitions.',
@@ -53,7 +100,11 @@ exports.hierarchyToolDefinitions = [
             type: 'object',
             properties: {
                 productId: { type: 'string', description: 'Product ID' },
-                entityType: { type: 'string', enum: ['feature', 'task', 'micro-task', 'feature-group'], description: 'Type of entity' },
+                entityType: {
+                    type: 'string',
+                    enum: ['feature', 'task', 'micro-task', 'feature-group'],
+                    description: 'Type of entity',
+                },
                 entityId: { type: 'string', description: 'Entity ID' },
                 status: { type: 'string', description: 'New status value' },
             },
@@ -63,6 +114,22 @@ exports.hierarchyToolDefinitions = [
 ];
 async function handleHierarchyTool(name, args) {
     switch (name) {
+        case 'get_hierarchy': {
+            return await (0, client_js_1.apiGet)(`/products/${args.productId}/hierarchy`);
+        }
+        case 'list_modules': {
+            return await (0, client_js_1.apiGet)(`/products/${args.productId}/modules`, {
+                status: args.status,
+                limit: args.limit,
+            });
+        }
+        case 'list_feature_groups': {
+            return await (0, client_js_1.apiGet)(`/products/${args.productId}/feature-groups`, {
+                moduleId: args.moduleId,
+                status: args.status,
+                limit: args.limit,
+            });
+        }
         case 'get_feature_detail': {
             return await (0, client_js_1.apiGet)(`/products/${args.productId}/entities/feature/${args.featureId}`);
         }
@@ -73,6 +140,8 @@ async function handleHierarchyTool(name, args) {
             return await (0, client_js_1.apiGet)(`/products/${args.productId}/features`, {
                 status: args.status,
                 priority: args.priority,
+                moduleId: args.moduleId,
+                featureGroupId: args.featureGroupId,
                 limit: args.limit,
             });
         }

package/dist/tools/hierarchyTools.js.map

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

package/dist/tools/releaseCycleLinkTools.d.ts

@@ -1,14 +1,14 @@
 /**
- * MCP Tools: Release cycle linking for feature groups and sub-features.
+ * MCP Tools: Release cycle listing and linking for feature groups and features.
  *
  * Workflow for IDE agents:
- *   1. Call list_release_cycles (existing tool) to discover available cycles and their IDs.
+ *   1. Call list_release_cycles to discover available cycles and their IDs.
  *   2. Call get_feature_group_release_cycle / get_feature_release_cycle to check if already linked.
  *   3. If missing or wrong, call set_feature_group_release_cycle / set_feature_release_cycle.
  *
  * Terminology (aligned with AGENTS.md):
- *   "feature group"  = DB FeatureGroup / API "features"     (Feature Group in UI)
- *   "feature"        = DB SubFeature   / API "sub-features" (Feature in UI)
+ *   "feature group"  = DB FeatureGroup / API "feature-groups" (Feature Group in UI)
+ *   "feature"        = DB Feature      / API "features"       (Feature in UI)
  *
  * Cascade note: setting a release cycle on a feature group automatically cascades
  * to child features that previously inherited the old parent cycle.

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

@@ -1 +1 @@
-{"version":3,"file":"releaseCycleLinkTools.d.ts","sourceRoot":"","sources":["../../src/tools/releaseCycleLinkTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAK1D,eAAO,MAAM,+BAA+B,EAAE,IAAI,EAgEjD,CAAC;AAEF,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;GAqG/F"}
+{"version":3,"file":"releaseCycleLinkTools.d.ts","sourceRoot":"","sources":["../../src/tools/releaseCycleLinkTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAK1D,eAAO,MAAM,+BAA+B,EAAE,IAAI,EA8EjD,CAAC;AAEF,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;GAmH/F"}