@electriccitizen/bolt 0.1.0 → 0.2.0

package/dist/ai/prompts/analyze-ticket.js

@@ -0,0 +1,116 @@
+/**
+ * Prompt template for ticket analysis — examines a Jira ticket (or description)
+ * against the site profile and produces an investigation plan.
+ */
+const OUTPUT_FORMAT = `{
+  "ticket": {
+    "key": "PROJ-123",
+    "summary": "Short ticket summary",
+    "type": "Bug",
+    "priority": "High"
+  },
+  "problemSummary": "Clear, concise description of what the ticket is actually asking — not just restating the title, but interpreting the real problem.",
+  "likelyCauses": [
+    {
+      "probability": "high | medium | low",
+      "description": "What could cause this problem and why this is likely",
+      "category": "config | code | permissions | js | caching | data | module"
+    }
+  ],
+  "investigationSteps": [
+    {
+      "order": 1,
+      "description": "What to do and why",
+      "command": "ddev drush <specific command>",
+      "file": "path/to/relevant/file"
+    }
+  ],
+  "suggestedTests": {
+    "plugins": ["browser-smoke", "field-interaction"],
+    "contentTypes": ["blog"],
+    "flags": ["--headed"]
+  },
+  "riskAssessment": "What else could be affected by this issue or its fix",
+  "relatedModules": ["drupal/media_library", "drupal/paragraphs"],
+  "confidence": {
+    "canFix": "autonomous | needs-info | needs-human",
+    "reason": "Why Claude can or cannot fix this without human intervention"
+  }
+}`;
+/**
+ * Build an AgentTask for analyzing a ticket.
+ */
+export function buildAnalyzeTicketTask(ctx) {
+    const goal = [
+        'You are Bolt\'s ticket analyst. Examine the provided ticket and site profile to produce a detailed investigation plan.',
+        '',
+        '## Your Job',
+        '- Understand what the ticket is really asking (not just restate the title)',
+        '- Cross-reference the problem against the site\'s actual structure (content types, fields, modules, routes)',
+        '- Identify the most likely root causes, ranked by probability',
+        '- Produce specific, actionable investigation steps (with actual drush commands and file paths)',
+        '- Assess whether this could be fixed autonomously by an AI agent, or needs human input',
+        '',
+        '## Rules',
+        '- Be specific to THIS site — use actual content types, field names, and module names from the profile',
+        '- Investigation steps must be concrete — actual commands to run, actual config names to check',
+        '- Don\'t guess — if the site profile doesn\'t have enough info, say what\'s missing',
+        '- Rank likely causes by probability, not just list them',
+        '- The "confidence" field is critical — be honest about what an AI can and cannot fix:',
+        '  - "autonomous": The fix is likely a config change, permission tweak, CSS fix, or clear code change',
+        '  - "needs-info": The analysis needs more data (screenshots, steps to reproduce, access to specific pages)',
+        '  - "needs-human": The fix requires design decisions, stakeholder input, or complex refactoring',
+        '- All commands should use `ddev drush` or `ddev composer` prefix (DDEV environment)',
+        '- Do NOT run any commands — this is analysis only',
+    ].join('\n');
+    // Build context with all available data.
+    const context = {
+        ticket: {
+            key: ctx.ticketKey || 'MANUAL',
+            summary: ctx.ticketSummary,
+            description: ctx.ticketDescription,
+            type: ctx.ticketType,
+            priority: ctx.ticketPriority,
+        },
+        siteProfile: {
+            contentTypes: ctx.siteProfile.contentTypes.map(ct => ({
+                id: ct.id,
+                label: ct.label,
+                fieldCount: ct.fields.length,
+                fields: ct.fields.map(f => `${f.name} (${f.type}, ${f.required ? 'required' : 'optional'})`),
+            })),
+            enabledModules: ctx.siteProfile.enabledModules,
+            routes: ctx.siteProfile.routes.slice(0, 50), // Limit to avoid prompt bloat.
+            mediaTypes: ctx.siteProfile.mediaTypes,
+            paragraphBundles: ctx.siteProfile.paragraphBundles.map(p => ({
+                id: p.id,
+                label: p.label,
+                fields: p.fields.map(f => `${f.name} (${f.type})`),
+            })),
+            menus: ctx.siteProfile.menus.map(m => ({
+                name: m.name,
+                itemCount: m.items.length,
+            })),
+        },
+    };
+    if (ctx.ticketComments && ctx.ticketComments.length > 0) {
+        context.ticketComments = ctx.ticketComments;
+    }
+    if (ctx.recentGitLog) {
+        context.recentGitLog = ctx.recentGitLog;
+    }
+    if (ctx.testResults) {
+        context.currentTestResults = ctx.testResults;
+    }
+    const knowledge = ['drupal-debugging', 'drupal-internals'];
+    return {
+        goal,
+        context,
+        knowledge,
+        outputFormat: OUTPUT_FORMAT,
+        maxTurns: 3, // Analysis is reasoning only — no tool use needed.
+        timeout: 60_000,
+        allowedTools: [], // No tools — pure reasoning.
+    };
+}
+//# sourceMappingURL=analyze-ticket.js.map

package/dist/ai/prompts/analyze-ticket.js.map

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

package/dist/ai/prompts/fix-ticket.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Prompt template for autonomous ticket fixing.
+ *
+ * Unlike analyze (pure reasoning), fix gives Claude full tool access
+ * to investigate, modify files, run drush commands, and verify.
+ */
+import type { AgentTask } from '../agent.js';
+import type { SiteProfile } from '../../types.js';
+import type { AnalysisResult } from '../schemas/analysis-result.js';
+export interface FixTicketContext {
+    /** Analysis result from bolt analyze. */
+    analysis: AnalysisResult;
+    /** Site profile from bolt-inspect:profile. */
+    siteProfile: SiteProfile;
+    /** Additional context provided by the dev (answers to questions, etc.). */
+    additionalContext?: string;
+    /** The site URL (for reference in commands). */
+    siteUrl?: string;
+    /** Max turns for the fix agent. */
+    maxTurns?: number;
+    /** Timeout in ms. */
+    timeout?: number;
+}
+/**
+ * Build an AgentTask for fixing a ticket.
+ */
+export declare function buildFixTicketTask(ctx: FixTicketContext): AgentTask;

package/dist/ai/prompts/fix-ticket.js

@@ -0,0 +1,129 @@
+/**
+ * Prompt template for autonomous ticket fixing.
+ *
+ * Unlike analyze (pure reasoning), fix gives Claude full tool access
+ * to investigate, modify files, run drush commands, and verify.
+ */
+const OUTPUT_FORMAT = `{
+  "ticket": {
+    "key": "PROJ-123",
+    "summary": "Short ticket summary"
+  },
+  "status": "fixed | partial | failed | needs-human",
+  "changes": [
+    {
+      "file": "path/to/changed/file",
+      "description": "What was changed and why",
+      "type": "modified | created | deleted"
+    }
+  ],
+  "explanation": "Clear explanation of what was done, what the root cause was, and why this fix is correct.",
+  "followUp": ["Any manual steps still needed (optional)"]
+}`;
+/**
+ * Build an AgentTask for fixing a ticket.
+ */
+export function buildFixTicketTask(ctx) {
+    const { analysis } = ctx;
+    const goal = [
+        'You are Bolt\'s autonomous fixer. Your job is to resolve the described issue by modifying code, config, or templates.',
+        '',
+        '## Your Job',
+        '- Fix the issue described in the analysis below',
+        '- Use the investigation steps as a starting point, but adapt as you learn more',
+        '- Make the minimum changes needed to fix the problem',
+        '- Verify your fix works by checking the result (drush commands, file inspection)',
+        '- Explain clearly what you changed and why',
+        '',
+        '## Environment',
+        '- This is a Drupal 11+ site running in DDEV',
+        '- All drush commands: `ddev drush <command>`',
+        '- All composer commands: `ddev composer <command>`',
+        '- After config changes: `ddev drush cr` to rebuild cache',
+        '- After config edits: `ddev drush cex -y` to export changes',
+        '',
+        '## What You CAN Do',
+        '- Edit Drupal config YAML files (in config/sync/)',
+        '- Edit Twig templates (in themes/)',
+        '- Edit CSS/SCSS files',
+        '- Edit custom module code (.module, .theme, services, plugins)',
+        '- Run `ddev drush` commands (cr, cex, cim, cset, etc.)',
+        '- Run `ddev composer require/remove` for contrib modules',
+        '- Create or modify custom module code',
+        '',
+        '## What You MUST NOT Do',
+        '- Modify files in `core/` or `vendor/` — they\'re overwritten on next update',
+        '- Write direct SQL or modify production data/content',
+        '- Touch credentials, API keys, `.env` files, or secrets',
+        '- Modify deployment config (CI/CD, hosting, DNS)',
+        '- Modify or delete real user accounts or content',
+        '- Make changes that require a database migration on production',
+        '',
+        '## Rules',
+        '- Minimum viable fix — don\'t refactor unrelated code',
+        '- If you realize the fix is more complex than expected, set status to "partial" or "needs-human"',
+        '- Always clear cache (`ddev drush cr`) after config changes',
+        '- Always export config (`ddev drush cex -y`) after making changes via drush cset/cim',
+        '- If the fix involves Twig changes, check the template override hierarchy first',
+        '- If you can\'t fix it, set status to "failed" or "needs-human" with a clear explanation',
+        '',
+        '## Analysis',
+        '',
+        `### Problem`,
+        analysis.problemSummary,
+        '',
+        '### Likely Causes',
+        ...analysis.likelyCauses.map(c => `- [${c.probability}] ${c.category}: ${c.description}`),
+        '',
+        '### Investigation Steps',
+        ...analysis.investigationSteps.map(s => {
+            let line = `${s.order}. ${s.description}`;
+            if (s.command)
+                line += `\n   $ ${s.command}`;
+            if (s.file)
+                line += `\n   → ${s.file}`;
+            return line;
+        }),
+        '',
+        '### Risk Assessment',
+        analysis.riskAssessment || '(none provided)',
+    ].join('\n');
+    const context = {
+        ticket: analysis.ticket,
+        siteProfile: {
+            contentTypes: ctx.siteProfile.contentTypes.map(ct => ({
+                id: ct.id,
+                label: ct.label,
+                fields: ct.fields.map(f => `${f.name} (${f.type}, ${f.required ? 'required' : 'optional'})`),
+            })),
+            enabledModules: ctx.siteProfile.enabledModules,
+            mediaTypes: ctx.siteProfile.mediaTypes,
+            paragraphBundles: ctx.siteProfile.paragraphBundles.map(p => ({
+                id: p.id,
+                label: p.label,
+            })),
+        },
+        relatedModules: analysis.relatedModules,
+    };
+    if (ctx.additionalContext) {
+        context.additionalContext = ctx.additionalContext;
+    }
+    if (ctx.siteUrl) {
+        context.siteUrl = ctx.siteUrl;
+    }
+    const knowledge = [
+        'drupal-debugging',
+        'drupal-internals',
+        'config-safety',
+    ];
+    return {
+        goal,
+        context,
+        knowledge,
+        outputFormat: OUTPUT_FORMAT,
+        maxTurns: ctx.maxTurns ?? 50,
+        timeout: ctx.timeout ?? 600_000, // 10 minutes.
+        allowedTools: ['Bash', 'Read', 'Edit', 'Write', 'Glob', 'Grep'],
+    };
+}
+//# sourceMappingURL=fix-ticket.js.map

package/dist/ai/prompts/fix-ticket.js.map

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

package/dist/ai/prompts/pr-description.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Prompt template for writing PR descriptions from update results.
+ */
+import type { AgentTask } from '../agent.js';
+import type { UpdateResult } from '../../types.js';
+export interface PrDescriptionContext {
+    /** The update result for this PR. */
+    result: UpdateResult;
+    /** Git diff stat for the branch. */
+    diffStat: string;
+    /** Commit message(s) on the branch. */
+    commitMessages: string;
+    /** Config files that changed. */
+    configChanges: string[];
+}
+/**
+ * Build an AgentTask for writing a PR description.
+ */
+export declare function buildPrDescriptionTask(ctx: PrDescriptionContext): AgentTask;

package/dist/ai/prompts/pr-description.js

@@ -0,0 +1,56 @@
+/**
+ * Prompt template for writing PR descriptions from update results.
+ */
+const OUTPUT_FORMAT = `{
+  "title": "Short PR title (under 70 chars)",
+  "body": "Full markdown PR body with summary, changes, test results, and config details"
+}`;
+/**
+ * Build an AgentTask for writing a PR description.
+ */
+export function buildPrDescriptionTask(ctx) {
+    const { result } = ctx;
+    const goal = [
+        'You are Bolt\'s PR writer. Write a clear, informative GitHub PR description for a Drupal module update.',
+        '',
+        '## PR Guidelines',
+        '- Title: concise, under 70 characters, e.g., "Update drupal/gin from 4.0.6 to 5.0.12"',
+        '- Body should include:',
+        '  - Summary of what was updated and why (security fix? minor bump? major version?)',
+        '  - Composer command used',
+        '  - Database update status',
+        '  - Config changes (list changed files if any, explain significance)',
+        '  - Test results summary',
+        '  - Any notable risks or things for the reviewer to check',
+        '- Use markdown formatting',
+        '- End with: `🤖 Generated by [Bolt](https://github.com/electriccitizen/bolt)`',
+        '',
+        '## Rules',
+        '- Be factual — only state what actually happened',
+        '- If config files changed, briefly explain what they likely contain',
+        '- If it was a major version update, note that breaking changes are possible',
+        '- Keep it concise — reviewers want signal, not noise',
+        '- Do NOT run any commands — just analyze the provided data',
+    ].join('\n');
+    return {
+        goal,
+        context: {
+            package: result.package,
+            oldVersion: result.oldVersion,
+            newVersion: result.newVersion,
+            status: result.status,
+            testSummary: result.testSummary,
+            configChanges: ctx.configChanges,
+            dbUpdates: result.dbUpdates,
+            diffStat: ctx.diffStat,
+            commitMessages: ctx.commitMessages,
+            attempts: result.attempts,
+        },
+        knowledge: [],
+        outputFormat: OUTPUT_FORMAT,
+        maxTurns: 3, // PR writing is text generation — minimal turns.
+        timeout: 30_000,
+        allowedTools: [], // No tools needed.
+    };
+}
+//# sourceMappingURL=pr-description.js.map

package/dist/ai/prompts/pr-description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-description.js","sourceRoot":"","sources":["../../../src/ai/prompts/pr-description.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,MAAM,aAAa,GAAG;;;EAGpB,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAyB;IAC9D,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAEvB,MAAM,IAAI,GAAG;QACX,yGAAyG;QACzG,EAAE;QACF,kBAAkB;QAClB,uFAAuF;QACvF,wBAAwB;QACxB,oFAAoF;QACpF,2BAA2B;QAC3B,4BAA4B;QAC5B,sEAAsE;QACtE,0BAA0B;QAC1B,2DAA2D;QAC3D,2BAA2B;QAC3B,+EAA+E;QAC/E,EAAE;QACF,UAAU;QACV,kDAAkD;QAClD,qEAAqE;QACrE,6EAA6E;QAC7E,sDAAsD;QACtD,4DAA4D;KAC7D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;QACL,IAAI;QACJ,OAAO,EAAE;YACP,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B;QACD,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,aAAa;QAC3B,QAAQ,EAAE,CAAC,EAAE,iDAAiD;QAC9D,OAAO,EAAE,MAAM;QACf,YAAY,EAAE,EAAE,EAAE,mBAAmB;KACtC,CAAC;AACJ,CAAC"}

package/dist/ai/prompts/update-package.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Prompt template for updating a single Drupal package.
+ * Claude handles the full lifecycle: composer update → conflict resolution →
+ * drush updb → watchdog check → config export.
+ */
+import type { AgentTask } from '../agent.js';
+import type { UpdateCandidate } from '../../types.js';
+export interface UpdatePackageContext {
+    /** The package to update. */
+    candidate: UpdateCandidate;
+    /** Current Drupal core version. */
+    coreVersion: string;
+    /** Git branch name for this update. */
+    branchName: string;
+    /** Site URL for test commands. */
+    siteUrl: string;
+    /** Number of tests in the baseline. */
+    baselineTestCount: number;
+    /** Number of suppressed tests in the baseline. */
+    baselineSuppressedCount: number;
+}
+/**
+ * Build an AgentTask for updating a single package.
+ */
+export declare function buildUpdatePackageTask(ctx: UpdatePackageContext): AgentTask;

package/dist/ai/prompts/update-package.js

@@ -0,0 +1,87 @@
+/**
+ * Prompt template for updating a single Drupal package.
+ * Claude handles the full lifecycle: composer update → conflict resolution →
+ * drush updb → watchdog check → config export.
+ */
+/**
+ * JSON format the agent must return.
+ */
+const OUTPUT_FORMAT = `{
+  "success": true|false,
+  "package": "vendor/package",
+  "oldVersion": "1.0.0",
+  "newVersion": "1.1.0",
+  "strategy": "description of what worked or why it failed",
+  "composerCommand": "the composer command that succeeded",
+  "dbUpdatesApplied": true|false,
+  "dbUpdateOutput": "relevant drush updb output",
+  "watchdogErrors": ["any new errors found"],
+  "configChangesCount": 0,
+  "error": "error message if failed, null if succeeded"
+}`;
+/**
+ * Build an AgentTask for updating a single package.
+ */
+export function buildUpdatePackageTask(ctx) {
+    const { candidate, coreVersion, branchName, siteUrl } = ctx;
+    const goal = [
+        `You are Bolt's update agent. Update the Drupal package "${candidate.name}" ` +
+            `from version ${candidate.currentVersion} to ${candidate.latestVersion}.`,
+        '',
+        '## Environment',
+        `- DDEV local environment — all commands via \`ddev drush\` / \`ddev composer\``,
+        `- Drupal core version: ${coreVersion}`,
+        `- Git branch: ${branchName} (already created and checked out)`,
+        `- Site URL: ${siteUrl}`,
+        `- Baseline: ${ctx.baselineTestCount} tests passing, ${ctx.baselineSuppressedCount} suppressed`,
+        '',
+        '## Your task',
+        '',
+        `1. **Check compatibility:** Before updating, verify that ${candidate.latestVersion} ` +
+            `is compatible with Drupal core ${coreVersion}. If not, find the highest compatible version.`,
+        '',
+        `2. **Run composer update:** Start with \`ddev composer update ${candidate.name} --with-dependencies\`. ` +
+            `If it fails, read the error output, diagnose with \`ddev composer why-not\`, and try alternative strategies. ` +
+            `Keep trying until you find a working approach or determine it's truly impossible.`,
+        '',
+        `3. **Run database updates:** \`ddev drush updb -y\`. Read the output for errors.`,
+        '',
+        `4. **Check watchdog:** \`ddev drush watchdog:show --count=10 --severity=Error\`. ` +
+            `Note any new errors that appeared after the update.`,
+        '',
+        `5. **Export config:** \`ddev drush cex -y\`. This captures any config changes from the update.`,
+        '',
+        `6. **Clear caches:** \`ddev drush cr\`.`,
+        '',
+        '## Rules',
+        '- Do NOT run `bolt test` — the caller handles testing.',
+        '- Do NOT commit or stage files — the caller handles git.',
+        '- Do NOT modify any source code files — only composer and drush commands.',
+        '- If you cannot update the package after trying multiple strategies, report failure with details.',
+        `- If the best compatible version is lower than ${candidate.latestVersion}, update to that version instead.`,
+        '- Always clean up failed attempts: `git checkout . && git clean -fd` before trying a new strategy.',
+    ].join('\n');
+    const knowledge = [
+        'composer',
+        'drupal-updates',
+        'config-safety',
+        'ddev-operations',
+    ];
+    return {
+        goal,
+        context: {
+            package: candidate.name,
+            currentVersion: candidate.currentVersion,
+            targetVersion: candidate.latestVersion,
+            isSecurityUpdate: candidate.isSecurityUpdate,
+            coreVersion,
+            branchName,
+        },
+        knowledge,
+        outputFormat: OUTPUT_FORMAT,
+        maxTurns: 25,
+        timeout: 300_000,
+        allowedTools: ['Bash'],
+    };
+}
+//# sourceMappingURL=update-package.js.map

package/dist/ai/prompts/update-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-package.js","sourceRoot":"","sources":["../../../src/ai/prompts/update-package.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH;;GAEG;AACH,MAAM,aAAa,GAAG;;;;;;;;;;;;EAYpB,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAyB;IAC9D,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;IAE5D,MAAM,IAAI,GAAG;QACX,2DAA2D,SAAS,CAAC,IAAI,IAAI;YAC7E,gBAAgB,SAAS,CAAC,cAAc,OAAO,SAAS,CAAC,aAAa,GAAG;QACzE,EAAE;QACF,gBAAgB;QAChB,gFAAgF;QAChF,0BAA0B,WAAW,EAAE;QACvC,iBAAiB,UAAU,oCAAoC;QAC/D,eAAe,OAAO,EAAE;QACxB,eAAe,GAAG,CAAC,iBAAiB,mBAAmB,GAAG,CAAC,uBAAuB,aAAa;QAC/F,EAAE;QACF,cAAc;QACd,EAAE;QACF,4DAA4D,SAAS,CAAC,aAAa,GAAG;YACtF,kCAAkC,WAAW,gDAAgD;QAC7F,EAAE;QACF,iEAAiE,SAAS,CAAC,IAAI,0BAA0B;YACzG,+GAA+G;YAC/G,mFAAmF;QACnF,EAAE;QACF,kFAAkF;QAClF,EAAE;QACF,mFAAmF;YACnF,qDAAqD;QACrD,EAAE;QACF,gGAAgG;QAChG,EAAE;QACF,yCAAyC;QACzC,EAAE;QACF,UAAU;QACV,wDAAwD;QACxD,0DAA0D;QAC1D,2EAA2E;QAC3E,mGAAmG;QACnG,kDAAkD,SAAS,CAAC,aAAa,mCAAmC;QAC5G,oGAAoG;KACrG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,SAAS,GAAsB;QACnC,UAAU;QACV,gBAAgB;QAChB,eAAe;QACf,iBAAiB;KAClB,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,OAAO,EAAE;YACP,OAAO,EAAE,SAAS,CAAC,IAAI;YACvB,cAAc,EAAE,SAAS,CAAC,cAAc;YACxC,aAAa,EAAE,SAAS,CAAC,aAAa;YACtC,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;YAC5C,WAAW;YACX,UAAU;SACX;QACD,SAAS;QACT,YAAY,EAAE,aAAa;QAC3B,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,OAAO;QAChB,YAAY,EAAE,CAAC,MAAM,CAAC;KACvB,CAAC;AACJ,CAAC"}

package/dist/ai/prompts/update-plan.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Prompt template for planning update order and strategy.
+ * Claude evaluates all candidates and returns an ordered plan.
+ */
+import type { AgentTask } from '../agent.js';
+import type { UpdateCandidate } from '../../types.js';
+export interface UpdatePlanContext {
+    /** All update candidates. */
+    candidates: UpdateCandidate[];
+    /** Current Drupal core version. */
+    coreVersion: string;
+    /** Packages to ignore (from .bolt.yml). */
+    ignorePatterns: string[];
+    /** Priority packages (from .bolt.yml). */
+    priorityPackages: string[];
+}
+/**
+ * Build an AgentTask for planning updates.
+ */
+export declare function buildUpdatePlanTask(ctx: UpdatePlanContext): AgentTask;

package/dist/ai/prompts/update-plan.js

@@ -0,0 +1,66 @@
+/**
+ * Prompt template for planning update order and strategy.
+ * Claude evaluates all candidates and returns an ordered plan.
+ */
+const OUTPUT_FORMAT = `{
+  "plan": [
+    {
+      "package": "vendor/package",
+      "targetVersion": "1.1.0",
+      "strategy": "brief description of recommended approach",
+      "risk": "low|medium|high",
+      "reason": "why this order and strategy",
+      "skipReason": "if skipped, why (null if not skipped)"
+    }
+  ],
+  "notes": "any overall observations about the update set"
+}`;
+/**
+ * Build an AgentTask for planning updates.
+ */
+export function buildUpdatePlanTask(ctx) {
+    const goal = [
+        'You are Bolt\'s planning agent. Analyze these outdated Drupal packages and create an optimal update plan.',
+        '',
+        '## Your Task',
+        '',
+        'Review each candidate and determine:',
+        '1. **Order:** Which packages should be updated first? (security first, then dependencies, then the rest)',
+        '2. **Strategy:** What composer approach is best for each? (standard update vs. require vs. update with core)',
+        '3. **Risk:** Is this a low/medium/high risk update? (patch=low, minor=medium, major=high)',
+        '4. **Skip:** Should any be skipped? (incompatible with current core, known conflicts, etc.)',
+        '',
+        '## Rules',
+        '- Security updates always come first',
+        '- If multiple packages are tightly coupled (e.g., gin + gin_toolbar), group them',
+        '- Check if major version updates are compatible with current Drupal core',
+        '- Packages in the priority list should come after security but before others',
+        '- Do NOT run any commands — this is analysis only. Use your knowledge to reason about the plan.',
+        '- Be concise in your reasoning',
+    ].join('\n');
+    const knowledge = [
+        'composer',
+        'drupal-updates',
+    ];
+    return {
+        goal,
+        context: {
+            candidates: ctx.candidates.map((c) => ({
+                name: c.name,
+                current: c.currentVersion,
+                latest: c.latestVersion,
+                updateType: c.updateType,
+                isSecurityUpdate: c.isSecurityUpdate,
+            })),
+            coreVersion: ctx.coreVersion,
+            ignorePatterns: ctx.ignorePatterns,
+            priorityPackages: ctx.priorityPackages,
+        },
+        knowledge,
+        outputFormat: OUTPUT_FORMAT,
+        maxTurns: 5, // Planning is analysis only — shouldn't need many turns.
+        timeout: 60_000,
+        allowedTools: [], // No tools needed for planning.
+    };
+}
+//# sourceMappingURL=update-plan.js.map

package/dist/ai/prompts/update-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-plan.js","sourceRoot":"","sources":["../../../src/ai/prompts/update-plan.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,MAAM,aAAa,GAAG;;;;;;;;;;;;EAYpB,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAsB;IACxD,MAAM,IAAI,GAAG;QACX,2GAA2G;QAC3G,EAAE;QACF,cAAc;QACd,EAAE;QACF,sCAAsC;QACtC,0GAA0G;QAC1G,8GAA8G;QAC9G,2FAA2F;QAC3F,6FAA6F;QAC7F,EAAE;QACF,UAAU;QACV,sCAAsC;QACtC,kFAAkF;QAClF,0EAA0E;QAC1E,8EAA8E;QAC9E,iGAAiG;QACjG,gCAAgC;KACjC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,SAAS,GAAsB;QACnC,UAAU;QACV,gBAAgB;KACjB,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,OAAO,EAAE;YACP,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,CAAC,CAAC,cAAc;gBACzB,MAAM,EAAE,CAAC,CAAC,aAAa;gBACvB,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;aACrC,CAAC,CAAC;YACH,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,cAAc,EAAE,GAAG,CAAC,cAAc;YAClC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;SACvC;QACD,SAAS;QACT,YAAY,EAAE,aAAa;QAC3B,QAAQ,EAAE,CAAC,EAAE,yDAAyD;QACtE,OAAO,EAAE,MAAM;QACf,YAAY,EAAE,EAAE,EAAE,gCAAgC;KACnD,CAAC;AACJ,CAAC"}

package/dist/ai/schemas/analysis-result.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Schema validation for AI-generated ticket analysis results.
+ */
+export interface TicketInfo {
+    key: string;
+    summary: string;
+    type: string;
+    priority: string;
+}
+export interface LikelyCause {
+    probability: 'high' | 'medium' | 'low';
+    description: string;
+    category: 'config' | 'code' | 'permissions' | 'js' | 'caching' | 'data' | 'module';
+}
+export interface InvestigationStep {
+    order: number;
+    description: string;
+    command?: string;
+    file?: string;
+}
+export interface SuggestedTests {
+    plugins: string[];
+    contentTypes?: string[];
+    flags?: string[];
+}
+export interface AnalysisResult {
+    ticket: TicketInfo;
+    problemSummary: string;
+    likelyCauses: LikelyCause[];
+    investigationSteps: InvestigationStep[];
+    suggestedTests: SuggestedTests;
+    riskAssessment: string;
+    relatedModules: string[];
+    /** Confidence assessment for MVP-8 (bolt fix). */
+    confidence?: {
+        canFix: 'autonomous' | 'needs-info' | 'needs-human';
+        reason: string;
+    };
+}
+/**
+ * Validate and coerce agent output into AnalysisResult.
+ * Returns null if the output is missing required fields.
+ */
+export declare function validateAnalysisResult(raw: Record<string, unknown>): AnalysisResult | null;