agentblueprint 0.7.8 → 0.7.10

package/dist/mcp-setup.js

@@ -5,108 +5,138 @@ import { createInterface } from 'node:readline';
 import { join } from 'node:path';
 const execFileAsync = promisify(execFile);
 /**
- * Interactive setup for the ServiceNow MCP server.
+ * Resolve credentials from flags, env vars, or interactive prompts.
+ * Priority: explicit option > env var > interactive prompt.
+ */
+function resolveCredential(option, envVar, fallback) {
+    return option || process.env[envVar] || fallback;
+}
+/**
+ * Setup for the ServiceNow MCP server.
+ *
+ * When credentials are provided via options or env vars (SN_INSTANCE,
+ * SN_USER, SN_PASS), runs non-interactively. Otherwise falls back to
+ * interactive prompts.
  *
  * Installs the `servicenow-mcp-server` npm package globally if needed,
  * writes instance credentials, and prints the MCP config snippet for
  * the user to add to their coding agent of choice.
  */
-export async function setupServiceNowMcp() {
+export async function setupServiceNowMcp(credentials) {
     console.error('\n--- ServiceNow MCP Server Setup ---\n');
-    const rl = createInterface({ input: process.stdin, output: process.stderr });
-    const ask = (prompt) => new Promise((resolve) => {
-        rl.question(prompt, (answer) => resolve(answer.trim()));
-    });
-    try {
-        // 1. Prompt for credentials
-        const instanceName = await ask('ServiceNow instance name (press enter to skip): ');
-        if (!instanceName) {
-            console.error('Skipping ServiceNow MCP setup.');
-            return;
-        }
-        const username = (await ask('Username [admin]: ')) || 'admin';
-        const password = await ask('Password: ');
-        if (!password) {
-            console.error('Error: Password is required. Aborting MCP setup.');
-            return;
-        }
-        // 2. Check if servicenow-mcp-server is installed
-        let installed = false;
+    // Resolve from flags/env first
+    let instanceName = resolveCredential(credentials?.instance, 'SN_INSTANCE');
+    let username = resolveCredential(credentials?.username, 'SN_USER', 'admin');
+    let password = resolveCredential(credentials?.password, 'SN_PASS');
+    // If all resolved non-interactively, skip prompts entirely
+    const nonInteractive = !!(instanceName && password);
+    if (!nonInteractive) {
+        // Fall back to interactive prompts
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        const ask = (prompt) => new Promise((resolve) => {
+            rl.question(prompt, (answer) => resolve(answer.trim()));
+        });
         try {
-            await execFileAsync('which', ['servicenow-mcp-server']);
-            installed = true;
-        }
-        catch {
-            installed = false;
-        }
-        if (!installed) {
-            console.error('Installing servicenow-mcp-server globally...');
-            try {
-                await execFileAsync('npm', ['install', '-g', 'servicenow-mcp-server']);
+            if (!instanceName) {
+                instanceName = await ask('ServiceNow instance name (press enter to skip): ');
+                if (!instanceName) {
+                    console.error('Skipping ServiceNow MCP setup.');
+                    return;
+                }
             }
-            catch {
-                console.error(`Failed to install servicenow-mcp-server globally. Install manually with:\n  npm install -g servicenow-mcp-server`);
-                return;
+            if (!username || username === 'admin') {
+                const prompted = await ask('Username [admin]: ');
+                if (prompted)
+                    username = prompted;
+            }
+            if (!password) {
+                password = await ask('Password: ');
+                if (!password) {
+                    console.error('Error: Password is required. Aborting MCP setup.');
+                    return;
+                }
             }
         }
-        // 3. Resolve absolute binary path (avoids nvm/fnm/volta PATH issues)
-        let binaryPath;
-        try {
-            const { stdout } = await execFileAsync('which', ['servicenow-mcp-server']);
-            binaryPath = stdout.trim();
-        }
-        catch {
-            console.error('Error: Could not resolve servicenow-mcp-server binary path.');
-            return;
+        finally {
+            rl.close();
         }
-        // 4. Resolve global package directory
-        let pkgDir;
+    }
+    if (nonInteractive) {
+        console.error('Using credentials from flags/environment (non-interactive mode).');
+    }
+    // 2. Check if servicenow-mcp-server is installed
+    let installed = false;
+    try {
+        await execFileAsync('which', ['servicenow-mcp-server']);
+        installed = true;
+    }
+    catch {
+        installed = false;
+    }
+    if (!installed) {
+        console.error('Installing servicenow-mcp-server globally...');
         try {
-            const { stdout } = await execFileAsync('npm', ['root', '-g']);
-            pkgDir = join(stdout.trim(), 'servicenow-mcp-server');
+            await execFileAsync('npm', ['install', '-g', 'servicenow-mcp-server']);
         }
         catch {
-            console.error('Error: Could not resolve global npm root.');
+            console.error(`Failed to install servicenow-mcp-server globally. Install manually with:\n  npm install -g servicenow-mcp-server`);
             return;
         }
-        // 5. Write config file with instance credentials
-        const configDir = join(pkgDir, 'config');
-        await mkdir(configDir, { recursive: true });
-        const configContent = JSON.stringify({
-            instances: [
-                {
-                    name: instanceName,
-                    url: `https://${instanceName}.service-now.com`,
-                    username,
-                    password,
-                    default: true,
-                },
-            ],
-        }, null, 2);
-        const configPath = join(configDir, 'servicenow-instances.json');
-        await writeFile(configPath, configContent, { encoding: 'utf-8', mode: 0o600 });
-        // 6. Print success and MCP config snippet
-        console.error('');
-        console.error('ServiceNow MCP server configured:');
-        console.error(`  Instance:    ${instanceName}`);
-        console.error(`  Config:      ${configPath}`);
-        console.error(`  Binary:      ${binaryPath}`);
-        console.error('');
-        console.error('Add this to your coding agent\'s MCP config:');
-        console.error('');
-        console.error(JSON.stringify({
-            mcpServers: {
-                servicenow: {
-                    command: binaryPath,
-                    args: [],
-                },
-            },
-        }, null, 2));
-        console.error('');
-        console.error('Add to your coding agent\'s MCP config and restart to connect.');
     }
-    finally {
-        rl.close();
+    // 3. Resolve absolute binary path (avoids nvm/fnm/volta PATH issues)
+    let binaryPath;
+    try {
+        const { stdout } = await execFileAsync('which', ['servicenow-mcp-server']);
+        binaryPath = stdout.trim();
+    }
+    catch {
+        console.error('Error: Could not resolve servicenow-mcp-server binary path.');
+        return;
+    }
+    // 4. Resolve global package directory
+    let pkgDir;
+    try {
+        const { stdout } = await execFileAsync('npm', ['root', '-g']);
+        pkgDir = join(stdout.trim(), 'servicenow-mcp-server');
     }
+    catch {
+        console.error('Error: Could not resolve global npm root.');
+        return;
+    }
+    // 5. Write config file with instance credentials
+    const configDir = join(pkgDir, 'config');
+    await mkdir(configDir, { recursive: true });
+    const configContent = JSON.stringify({
+        instances: [
+            {
+                name: instanceName,
+                url: `https://${instanceName}.service-now.com`,
+                username,
+                password,
+                default: true,
+            },
+        ],
+    }, null, 2);
+    const configPath = join(configDir, 'servicenow-instances.json');
+    await writeFile(configPath, configContent, { encoding: 'utf-8', mode: 0o600 });
+    // 6. Print success and MCP config snippet
+    console.error('');
+    console.error('ServiceNow MCP server configured:');
+    console.error(`  Instance:    ${instanceName}`);
+    console.error(`  Config:      ${configPath}`);
+    console.error(`  Binary:      ${binaryPath}`);
+    console.error('');
+    console.error('Add this to your coding agent\'s MCP config:');
+    console.error('');
+    console.error(JSON.stringify({
+        mcpServers: {
+            servicenow: {
+                command: binaryPath,
+                args: [],
+            },
+        },
+    }, null, 2));
+    console.error('');
+    console.error('Add to your coding agent\'s MCP config and restart to connect.');
 }
 //# sourceMappingURL=mcp-setup.js.map

package/dist/mcp-setup.js.map

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

package/dist/renderers.d.ts

@@ -1,4 +1,4 @@
-import type { ImplementationStateResponse, ProgressResponse } from './types.js';
+import type { ImplementationStateResponse, ProgressResponse, StrategicRecommendationsResponse } from './types.js';
 export interface SkillFile {
     path: string;
     content: string;
@@ -33,6 +33,7 @@ export interface SkillRenderInput {
     };
     implementationState?: ImplementationStateResponse | null;
     progress?: ProgressResponse | null;
+    recommendations?: StrategicRecommendationsResponse | null;
     staleness?: StalenessInfo;
 }
 export declare function slugify(input: string): string;

package/dist/renderers.js

@@ -2066,6 +2066,10 @@ function buildImplementationState(input) {
     lines.push('  name: ""           # e.g., "ServiceNow", "Salesforce", "Custom Node.js"');
     lines.push('  version: ""        # e.g., "Australia", "Spring \'26"');
     lines.push('  environment: ""    # e.g., "dev", "staging", "production"');
+    lines.push('  # Add any instance-specific details (extra fields are preserved):');
+    lines.push('  # instance_url: "https://dev12345.service-now.com"');
+    lines.push('  # instance_id: "dev12345"');
+    lines.push('  # scope: "x_abc_my_app"');
     lines.push('');
     // Agents
     if (team.length === 0) {
@@ -2085,14 +2089,27 @@ function buildImplementationState(input) {
             if (i === 0) {
                 lines.push('    status: not_started  # not_started | in_progress | implemented | modified | skipped');
                 lines.push('    platform_artifact: ""  # sys_id, function name, service URL, etc.');
+                lines.push('    deviations: []');
+                lines.push('    integrations_connected: []');
+                lines.push('    notes: ""');
+                lines.push('    # Extra fields are preserved. Examples of what agents typically add:');
+                lines.push('    # tools:');
+                lines.push('    #   - name: "lookup_employee"');
+                lines.push('    #     type: "REST API"');
+                lines.push('    #     table: "sys_user"');
+                lines.push('    #   - name: "create_ticket"');
+                lines.push('    #     type: "Flow Action"');
+                lines.push('    #     flow: "Create Incident"');
+                lines.push('    # topic: "HR Service Delivery"');
+                lines.push('    # sys_id: "abc123def456"');
             }
             else {
                 lines.push('    status: not_started');
                 lines.push('    platform_artifact: ""');
+                lines.push('    deviations: []');
+                lines.push('    integrations_connected: []');
+                lines.push('    notes: ""');
             }
-            lines.push('    deviations: []');
-            lines.push('    integrations_connected: []');
-            lines.push('    notes: ""');
             if (i < team.length - 1)
                 lines.push('');
         }
@@ -2101,8 +2118,12 @@ function buildImplementationState(input) {
     // Architecture
     lines.push('architecture:');
     lines.push(`  pattern: ""        # actual pattern used (spec recommends: ${pattern})`);
-    lines.push('  deviations: []');
+    lines.push('  deviations: []     # e.g., ["Switched from multi-agent to single orchestrator"]');
     lines.push('  additional_components: []');
+    lines.push('  # Add any implementation-specific details:');
+    lines.push('  # update_set: "AI Agent Deployment"');
+    lines.push('  # app_scope: "x_abc_ai_agents"');
+    lines.push('  # team_sys_id: "abc123"');
     lines.push('');
     // Metrics -- collect and deduplicate from all agents
     const seenMetrics = new Set();
@@ -2442,6 +2463,72 @@ function buildClaudeCodeHooksConfig(input) {
     return JSON.stringify(config, null, 2) + '\n';
 }
 // =============================================================================
+// STRATEGIC RECOMMENDATIONS (Phase 5 — Living Blueprint)
+// =============================================================================
+function buildRecommendations(input) {
+    const recs = input.recommendations.recommendations;
+    const lines = [];
+    lines.push('# Strategic Recommendations');
+    lines.push('');
+    lines.push(`> Generated: ${recs.generatedAt}`);
+    lines.push('');
+    lines.push(recs.summary);
+    lines.push('');
+    // Group by priority
+    const priorityOrder = ['critical', 'high', 'medium', 'low'];
+    const priorityLabels = {
+        critical: 'Critical',
+        high: 'High Priority',
+        medium: 'Medium Priority',
+        low: 'Lower Priority',
+    };
+    for (const priority of priorityOrder) {
+        const group = recs.recommendations.filter(r => r.priority === priority);
+        if (group.length === 0)
+            continue;
+        lines.push(`## ${priorityLabels[priority]}`);
+        lines.push('');
+        for (const rec of group) {
+            lines.push(`### ${rec.id}: ${rec.title}`);
+            lines.push('');
+            lines.push(`**Category:** ${rec.category.replace(/_/g, ' ')}`);
+            lines.push(`**Confidence:** ${rec.confidence}`);
+            lines.push('');
+            lines.push(`**What:** ${rec.what}`);
+            lines.push('');
+            lines.push(`**Why:** ${rec.why}`);
+            lines.push('');
+            lines.push(`**Expected Impact:** ${rec.expectedImpact}`);
+            if (rec.financialImpact) {
+                const fi = rec.financialImpact;
+                const value = fi.estimatedValue ? ` (${fi.estimatedValue})` : '';
+                lines.push('');
+                lines.push(`**Financial Impact:** ${fi.type.replace(/_/g, ' ')}${value} -- ${fi.basis}`);
+            }
+            if (rec.relatedAgents?.length) {
+                lines.push('');
+                lines.push(`**Related Agents:** ${rec.relatedAgents.join(', ')}`);
+            }
+            if (rec.relatedMetrics?.length) {
+                lines.push('');
+                lines.push(`**Related Metrics:** ${rec.relatedMetrics.join(', ')}`);
+            }
+            lines.push('');
+        }
+    }
+    // Context snapshot footer
+    const ctx = recs.contextSnapshot;
+    lines.push('---');
+    lines.push('');
+    lines.push(`Implementation: ${ctx.implementationProgress}`);
+    lines.push(`Performance: ${ctx.performanceStatus}`);
+    if (ctx.daysInImplementation > 0) {
+        lines.push(`Days in implementation: ${ctx.daysInImplementation}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+// =============================================================================
 // MAIN RENDER FUNCTION
 // =============================================================================
 /**
@@ -2501,6 +2588,10 @@ export function renderSkillDirectory(input) {
     if (hasImplementationData(input)) {
         files.set('CURRENT-STATE.md', buildCurrentState(input));
     }
+    // Strategic recommendations (return visits -- Living Blueprint Phase 5)
+    if (hasImplementationData(input) && input.recommendations?.recommendations) {
+        files.set('RECOMMENDATIONS.md', buildRecommendations(input));
+    }
     return files;
 }
 //# sourceMappingURL=renderers.js.map