@sage-protocol/cli 0.3.0 → 0.3.3

package/dist/cli/services/mcp/template-manager.js

@@ -0,0 +1,156 @@
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Simple prompt template manager for MCP flows.
+ *
+ * Templates are defined as JSON data and rendered into concrete prompts
+ * which are persisted using quickStart.quickCreatePrompt.
+ */
+function createTemplateManager({
+  quickStart,
+  fsModule = fs,
+  pathModule = path,
+  logger = console,
+} = {}) {
+  if (!quickStart || typeof quickStart.quickCreatePrompt !== 'function') {
+    throw new Error('TemplateManager requires quickStart.quickCreatePrompt');
+  }
+
+  const defaultTemplatePath = pathModule.join(__dirname, 'templates', 'default-templates.json');
+  let templatesCache = null;
+
+  function loadTemplates() {
+    if (templatesCache) return templatesCache;
+    try {
+      const raw = fsModule.readFileSync(defaultTemplatePath, 'utf8');
+      const parsed = JSON.parse(raw);
+      const list = Array.isArray(parsed) ? parsed : parsed.templates || [];
+      templatesCache = list;
+    } catch (error) {
+      logger?.warn?.('template_manager_load_failed', { path: defaultTemplatePath, err: error.message || String(error) });
+      templatesCache = [];
+    }
+    return templatesCache;
+  }
+
+  function listTemplates({ category, search } = {}) {
+    const all = loadTemplates();
+    const cat = (category || '').toLowerCase();
+    const term = (search || '').toLowerCase();
+    const filtered = all.filter((tpl) => {
+      if (cat && String(tpl.category || '').toLowerCase() !== cat) return false;
+      if (!term) return true;
+      const haystack = [
+        tpl.key || '',
+        tpl.name || '',
+        tpl.description || '',
+        (tpl.metadata && tpl.metadata.suggested_description) || '',
+      ]
+        .join(' ')
+        .toLowerCase();
+      return haystack.includes(term);
+    });
+
+    const items = filtered.map((tpl) => {
+      const vars = Array.isArray(tpl.variables) ? tpl.variables : [];
+      return {
+        key: tpl.key,
+        name: tpl.name,
+        category: tpl.category || '',
+        summary: tpl.description || (tpl.metadata && tpl.metadata.suggested_description) || '',
+        requiredVariables: vars.filter((v) => v && v.required).map((v) => v.name),
+        optionalVariables: vars.filter((v) => v && !v.required).map((v) => v.name),
+      };
+    });
+
+    return { templates: items };
+  }
+
+  function getTemplate({ key }) {
+    const all = loadTemplates();
+    const id = String(key || '').trim();
+    if (!id) {
+      throw new Error('template key is required');
+    }
+    const tpl = all.find((t) => t.key === id);
+    if (!tpl) {
+      throw new Error(`Template not found for key "${key}"`);
+    }
+    return { template: tpl };
+  }
+
+  function renderWithVars(templateString, customize, variables) {
+    let result = String(templateString || '');
+    const vars = Array.isArray(variables) ? variables : [];
+    for (const v of vars) {
+      if (!v || !v.name) continue;
+      const value = customize && Object.prototype.hasOwnProperty.call(customize, v.name)
+        ? String(customize[v.name])
+        : (v.default !== undefined ? String(v.default) : `\${${v.name}}`);
+      const pattern = new RegExp(`\\$\\{${v.name}\\}`, 'g');
+      result = result.replace(pattern, value);
+    }
+    return result;
+  }
+
+  async function createFromTemplate({ template, customize, library, name } = {}) {
+    const { template: tpl } = getTemplate({ key: template });
+    const vars = Array.isArray(tpl.variables) ? tpl.variables : [];
+    const missing = vars
+      .filter((v) => v && v.required)
+      .filter((v) => !customize || customize[v.name] === undefined || customize[v.name] === null || customize[v.name] === '');
+
+    if (missing.length) {
+      const names = missing.map((v) => v.name).join(', ');
+      throw new Error(`Missing required variables for template "${tpl.key}": ${names}`);
+    }
+
+    const content = renderWithVars(tpl.content_template || '', customize, vars);
+
+    const promptName =
+      name ||
+      tpl.name ||
+      (customize && customize.title) ||
+      (customize && customize.project_type && `${customize.project_type} Prompt`) ||
+      tpl.key;
+
+    let description = '';
+    if (tpl.metadata && tpl.metadata.suggested_description) {
+      description = renderWithVars(tpl.metadata.suggested_description, customize, vars);
+    } else {
+      description = tpl.description || '';
+    }
+
+    const defaultTags = Array.isArray(tpl.metadata?.default_tags)
+      ? tpl.metadata.default_tags.map((t) => String(t).trim()).filter(Boolean)
+      : [];
+    const tags = defaultTags;
+
+    const quickResult = await quickStart.quickCreatePrompt({
+      name: promptName,
+      content,
+      description,
+      library,
+      tags,
+    });
+
+    return {
+      success: true,
+      template: tpl.key,
+      variables: customize || {},
+      tags,
+      quickCreate: quickResult,
+    };
+  }
+
+  return {
+    listTemplates,
+    getTemplate,
+    createFromTemplate,
+  };
+}
+
+module.exports = {
+  createTemplateManager,
+};

package/dist/cli/services/mcp/templates/default-templates.json

@@ -0,0 +1,84 @@
+[
+  {
+    "key": "landscape-design-planner",
+    "name": "Landscape Design Planner",
+    "category": "design",
+    "description": "Structured planner for landscape and courtyard design projects.",
+    "variables": [
+      { "name": "project_type", "required": true, "description": "courtyard, garden, patio, deck, etc." },
+      { "name": "region", "required": true, "description": "location or climate zone" },
+      { "name": "style", "required": false, "description": "modern, traditional, cottage, etc.", "default": "modern" },
+      { "name": "budget_range", "required": false, "description": "low, medium, high, or numeric range" }
+    ],
+    "content_template": "You are an experienced landscape designer specializing in ${project_type} projects in ${region}.\n\nYour tasks:\n1. Analyze the site conditions and constraints.\n2. Propose a high-level layout for the ${project_type}.\n3. Recommend materials, planting zones, and functional zones.\n4. Highlight tradeoffs given the budget range (${budget_range}).\n\nRespond with:\n- Site assumptions\n- Layout description\n- Material and planting recommendations\n- Risks and open questions.",
+    "metadata": {
+      "default_tags": ["design", "landscape", "courtyard"],
+      "suggested_description": "${project_type} planning prompt for projects in ${region}."
+    }
+  },
+  {
+    "key": "code-review-assistant",
+    "name": "Code Review Assistant",
+    "category": "development",
+    "description": "Prompt for structured, actionable code review feedback.",
+    "variables": [
+      { "name": "language", "required": true, "description": "primary language or stack" },
+      { "name": "context", "required": false, "description": "repository or feature context", "default": "general" },
+      { "name": "focus_areas", "required": false, "description": "performance, readability, security, etc." }
+    ],
+    "content_template": "You are a senior ${language} engineer performing a code review.\n\nContext: ${context}\nFocus areas: ${focus_areas}\n\nFor the given code, provide:\n1. High-level summary of what the code does.\n2. Strengths.\n3. Issues grouped by severity (critical, important, minor).\n4. Concrete suggestions and examples for improvement.\n5. Any follow-up questions.\n\nBe concise but specific; avoid restating the code.",
+    "metadata": {
+      "default_tags": ["code-review", "development"],
+      "suggested_description": "Structured ${language} code review assistant prompt."
+    }
+  },
+  {
+    "key": "data-analysis-brief",
+    "name": "Data Analysis Brief",
+    "category": "analysis",
+    "description": "Briefing prompt for exploratory or explanatory data analysis.",
+    "variables": [
+      { "name": "dataset_description", "required": true, "description": "what the data represents" },
+      { "name": "audience", "required": false, "description": "decision makers, technical team, etc.", "default": "mixed" },
+      { "name": "primary_question", "required": true, "description": "main question to answer" }
+    ],
+    "content_template": "You are a data analyst preparing a structured analysis plan.\n\nDataset: ${dataset_description}\nAudience: ${audience}\nPrimary question: ${primary_question}\n\nProvide:\n1. Clarifying questions you would ask before analysis.\n2. Proposed analysis steps and methods.\n3. Key metrics and visualizations you would produce.\n4. Potential risks, caveats, or biases.\n5. How you would communicate results to the audience.",
+    "metadata": {
+      "default_tags": ["analysis", "planning"],
+      "suggested_description": "Plan an analysis for ${dataset_description} focusing on ${primary_question}."
+    }
+  },
+  {
+    "key": "writing-assistant",
+    "name": "Writing Assistant",
+    "category": "writing",
+    "description": "General-purpose structured writing assistant prompt.",
+    "variables": [
+      { "name": "piece_type", "required": true, "description": "blog post, email, announcement, etc." },
+      { "name": "topic", "required": true, "description": "subject of the piece" },
+      { "name": "tone", "required": false, "description": "professional, friendly, playful, etc.", "default": "professional" }
+    ],
+    "content_template": "You are an assistant helping draft a ${piece_type} about ${topic} in a ${tone} tone.\n\nProvide:\n1. A suggested outline.\n2. A draft introduction paragraph.\n3. 2–3 key points with short supporting paragraphs.\n4. A concise conclusion or call to action.\n\nKeep the language clear and accessible.",
+    "metadata": {
+      "default_tags": ["writing", "content"],
+      "suggested_description": "${piece_type} assistant prompt for ${topic}."
+    }
+  },
+  {
+    "key": "governance-library-publish-helper",
+    "name": "Governance Library Publish Helper",
+    "category": "governance",
+    "description": "Helper prompt to plan publishing a Sage library to a SubDAO.",
+    "variables": [
+      { "name": "library_name", "required": true, "description": "name of the library being published" },
+      { "name": "subdao_name", "required": false, "description": "name of the target SubDAO" },
+      { "name": "risk_level", "required": false, "description": "low, medium, high", "default": "medium" }
+    ],
+    "content_template": "You are assisting with publishing the \"${library_name}\" library to a Sage SubDAO (${subdao_name}).\n\nFor this publication, outline:\n1. Why this library is valuable to the SubDAO.\n2. Any risks or tradeoffs (risk level: ${risk_level}).\n3. Preconditions for a safe rollout (tests, review, etc.).\n4. A short, clear proposal description for governance.\n\nRespond as a structured brief the proposer can paste into their governance proposal.",
+    "metadata": {
+      "default_tags": ["governance", "library", "publish"],
+      "suggested_description": "Governance brief helper for publishing ${library_name}."
+    }
+  }
+]
+

package/dist/cli/services/mcp/tool-args-validator.js

@@ -61,6 +61,7 @@ function createToolArgsValidator({ zodModule } = {}) {
       manifest: Z.record(Z.any()),
       subdao: Z.string().regex(/^0x[a-fA-F0-9]{40}$/).optional().or(Z.literal('')).default(''),
       description: Z.string().max(280).optional().default(''),
+      dry_run: Z.boolean().optional().default(false),
     }),
     propose_manifest: Z.object({
       cid: Z.string().min(10).max(200),
@@ -69,6 +70,71 @@ function createToolArgsValidator({ zodModule } = {}) {
       promptCount: Z.number().int().min(0).optional(),
       manifest: Z.record(Z.any()).optional(),
     }),
+    improve_prompt: Z.object({
+      key: Z.string().min(1).max(200),
+      library: Z.string().min(1).max(200).optional(),
+      pass: Z.enum(['single', 'deep']).optional(),
+      depth: Z.enum(['single', 'deep']).optional(),
+      focus: Z.enum(['variables', 'edge-cases', 'output-quality', 'reusability', 'all']).optional().default('all'),
+    }).transform((obj) => ({
+      key: obj.key,
+      library: obj.library,
+      pass: obj.depth || obj.pass || 'single',
+      focus: obj.focus,
+    })),
+    rename_prompt: Z.object({
+      key: Z.string().min(1).max(200),
+      newKey: Z.string().min(1).max(200).optional(),
+      name: Z.string().min(1).max(200).optional(),
+    }),
+    update_library_metadata: Z.object({
+      library: Z.string().min(1).max(200),
+      name: Z.string().min(1).max(200).optional(),
+      description: Z.string().max(1000).optional(),
+      tags: Z.array(Z.string().max(64)).optional(),
+      apply_to_prompts: Z.boolean().optional().default(false),
+      merge_mode: Z.enum(['replace', 'merge']).optional().default('merge'),
+    }),
+    bulk_update_prompts: Z.object({
+      library: Z.string().min(1).max(200),
+      updates: Z.array(
+        Z.object({
+          key: Z.string().min(1).max(200),
+          name: Z.string().min(1).max(200).optional(),
+          description: Z.string().max(2000).optional(),
+          tags: Z.array(Z.string().max(64)).optional(),
+          content: Z.string().optional(),
+        }),
+      )
+        .min(1),
+      dry_run: Z.boolean().optional().default(false),
+    }),
+    list_templates: Z.object({
+      category: Z.string().max(200).optional(),
+      search: Z.string().max(500).optional(),
+    }),
+    get_template: Z.object({
+      key: Z.string().min(1).max(200),
+    }),
+    create_from_template: Z.object({
+      template: Z.string().min(1).max(200),
+      customize: Z.record(Z.any()),
+      library: Z.string().min(1).max(200).optional(),
+      name: Z.string().min(1).max(200).optional(),
+    }),
+    analyze_dependencies: Z.object({
+      library: Z.string().min(1).max(200),
+      analysis_type: Z.enum(['variables', 'all']).optional().default('variables'),
+    }),
+    suggest_subdaos_for_library: Z.object({
+      library: Z.string().min(1).max(200),
+      limit: Z.number().int().min(1).max(20).optional().default(5),
+      mode_filter: Z.enum(['any', 'creator', 'squad', 'community']).optional().default('any'),
+    }),
+    generate_publishing_commands: Z.object({
+      library: Z.string().min(1).max(200),
+      target: Z.string().max(200).optional().default('auto'),
+    }),
   };
 
   return function validate(name, args) {

package/dist/cli/services/mcp/trending-formatter.js

@@ -14,7 +14,7 @@ function buildTrendingResponse(suggestions = [], limit = 10) {
   return {
     content: [
       { type: 'text', text },
-      { type: 'json', text: JSON.stringify({ items }, null, 2) },
+      { type: 'text', text: '```json\n' + JSON.stringify({ items }, null, 2) + '\n```' },
     ],
   };
 }

package/dist/cli/services/mcp/unified-prompt-search.js

@@ -76,8 +76,8 @@ function createUnifiedPromptSearcher({
         content: [
           { type: 'text', text },
           {
-            type: 'json',
-            text: JSON.stringify({ total, page: normalizedPage, pageSize: normalizedPageSize, results: pageResults }, null, DEFAULT_INDENT),
+            type: 'text',
+            text: '```json\n' + JSON.stringify({ total, page: normalizedPage, pageSize: normalizedPageSize, results: pageResults }, null, DEFAULT_INDENT) + '\n```',
           },
         ],
       };

package/dist/cli/services/metaprompt/designer.js

@@ -57,7 +57,7 @@ class MetapromptDesigner {
     const history = this.path.join(base, 'history');
     try {
       this.fs.mkdirSync(history, { recursive: true });
-    } catch (_) {}
+    } catch (_) { }
     return history;
   }
 
@@ -103,7 +103,7 @@ class MetapromptDesigner {
       if (value.startsWith('[') && value.endsWith(']')) {
         try {
           value = JSON.parse(value.replace(/'/g, '"'));
-        } catch (_) {}
+        } catch (_) { }
       }
       meta[key] = value;
     });
@@ -197,9 +197,10 @@ class MetapromptDesigner {
       goal = 'Design a system prompt for an AI assistant that specialises in Sage Protocol development and prompt operations.',
       model = 'gpt-5',
       interviewStyle = 'one-question-at-a-time',
+      additionalInstructions = '',
     } = options;
 
-    return [
+    const lines = [
       'You are facilitating a metaprompt interview.',
       'Interview me one question at a time.',
       'Use each answer to decide the very next question.',
@@ -211,13 +212,19 @@ class MetapromptDesigner {
       'Offer optional follow-up artifacts (e.g., user prompt template, evaluation checklist).',
       'End by suggesting how to save or launch the prompt (e.g., via ChatGPT link).',
       `Interview cadence preference: ${interviewStyle}.`,
-    ].join('\n');
+    ];
+
+    if (additionalInstructions) {
+      lines.push(additionalInstructions);
+    }
+
+    return lines.join('\n');
   }
 
   saveTranscript(transcriptPath, payload) {
     try {
       this.fs.mkdirSync(this.path.dirname(transcriptPath), { recursive: true });
-    } catch (_) {}
+    } catch (_) { }
     this.fs.writeFileSync(transcriptPath, JSON.stringify(payload, null, 2));
   }
 }