agentblueprint 0.7.15 → 0.7.17

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agent Blueprint
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,6 @@
 # agentblueprint
 
-CLI and MCP server for [Agent Blueprint](https://app.agentblueprint.ai) — gives your coding agent read access to your AI blueprints, business cases, implementation plans, and specs.
+CLI and MCP server for [Agent Blueprint](https://app.agentblueprint.ai) — 23 MCP tools for creating structured business profiles, generating pipeline artifacts, exploring blueprint data, syncing implementation state, and downloading full Agent Skills directories. Vendor-agnostic output works with ServiceNow, Salesforce, OpenClaw, or any platform.
 
 ## CLI Quick Start
 
@@ -67,6 +67,14 @@ You can also start the MCP server explicitly with `agentblueprint serve`.
 2. Click "Create Token"
 3. Copy the token (shown once)
 
+## Supported Headless Workflow
+
+Current scope is intentionally narrow:
+
+`existing PAT + existing org -> create_business_profile -> generate_use_cases -> generate_blueprint or trigger_full_pipeline -> get_generation_status -> download_blueprint`
+
+This release does **not** handle organization creation, OAuth bootstrap, or free-form context extraction into the business profile.
+
 ## Download Blueprint as Agent Skills
 
 Download a blueprint as a local Agent Skills directory that any coding agent can read from the filesystem. This is the recommended way to work with blueprints.
@@ -102,6 +110,11 @@ The [Agent Skills](https://agentskills.io) standard is supported by Claude Code,
 
 | Tool | Description |
 |------|-------------|
+| `create_business_profile` | Create or upsert a structured business profile for an existing organization |
+| `generate_use_cases` | Generate normalized use cases from the current business profile and readiness assessment |
+| `generate_blueprint` | Start blueprint generation for a chosen use case and return an `auditId` |
+| `trigger_full_pipeline` | Start the full pipeline for an existing business profile and return a `jobId` |
+| `get_generation_status` | Poll either blueprint generation or full-pipeline generation status |
 | `list_blueprints` | List all blueprints (summaries) |
 | `get_blueprint` | Blueprint summary — title, agents, phases, pattern |
 | `get_business_case` | Business case summary — ROI, pilot economics, recommendation |
@@ -111,6 +124,8 @@ The [Agent Skills](https://agentskills.io) standard is supported by Claude Code,
 | `get_business_profile` | Organization business profile |
 | `download_blueprint` | Download full blueprint as Agent Skills file manifest |
 
+The `generate_blueprint` and `trigger_full_pipeline` tools are asynchronous. Use `get_generation_status` to poll until the run completes, then call `download_blueprint` with the resolved `blueprintId`.
+
 The `get_blueprint`, `get_business_case`, and `get_implementation_plan` tools return concise summaries optimized for agent context windows. For full details (agent specs, financial projections, user stories), use `download_blueprint` to get the complete Agent Skills directory.
 
 ## Available Resources

package/dist/__tests__/generation-client.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/generation-client.test.js

@@ -0,0 +1,96 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { AgentBlueprintClient } from '../client.js';
+const mockConfig = {
+    apiKey: 'ab_live_test1234567890',
+    apiUrl: 'https://test.agentblueprint.ai',
+};
+describe('AgentBlueprintClient generation methods', () => {
+    let client;
+    beforeEach(() => {
+        client = new AgentBlueprintClient(mockConfig);
+        vi.restoreAllMocks();
+    });
+    it('createBusinessProfile posts to the v1 business-profile endpoint and preserves customerOrgId', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({
+                success: true,
+                data: { id: 'profile-1', companyName: 'Acme', isNew: true },
+                timestamp: '',
+            }),
+        }));
+        await client.createBusinessProfile({ companyName: 'Acme' }, '11111111-1111-1111-1111-111111111111');
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/business-profile?customerOrgId=11111111-1111-1111-1111-111111111111', expect.objectContaining({
+            method: 'POST',
+            body: JSON.stringify({ fields: { companyName: 'Acme' } }),
+        }));
+    });
+    it('generateUseCases posts to the new v1 route', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({
+                success: true,
+                data: { useCases: [{ id: 'uc-1' }], generationMetadata: null, debugInfo: null },
+                timestamp: '',
+            }),
+        }));
+        await client.generateUseCases({ count: 2, guidanceText: 'Focus on service ops' });
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/generate/use-cases', expect.objectContaining({
+            method: 'POST',
+            body: JSON.stringify({ count: 2, guidanceText: 'Focus on service ops' }),
+        }));
+    });
+    it('triggerBlueprintGeneration posts to the new v1 route', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ success: true, data: { auditId: 'audit-1' }, timestamp: '' }),
+        }));
+        await client.triggerBlueprintGeneration({ useCaseId: 'uc-1', platform: 'vendor_agnostic' });
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/generate/blueprint', expect.objectContaining({
+            method: 'POST',
+            body: JSON.stringify({ useCaseId: 'uc-1', platform: 'vendor_agnostic' }),
+        }));
+    });
+    it('getBlueprintGenerationStatus hits the status endpoint and preserves customerOrgId', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({
+                success: true,
+                data: { kind: 'blueprint', auditId: 'audit-1', status: 'completed', blueprintId: 'bp-1' },
+                timestamp: '',
+            }),
+        }));
+        await client.getBlueprintGenerationStatus('audit-1', '11111111-1111-1111-1111-111111111111');
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/generate/blueprint/status/audit-1?customerOrgId=11111111-1111-1111-1111-111111111111', expect.objectContaining({ method: 'GET' }));
+    });
+    it('triggerFullPipeline posts to the new v1 route', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ success: true, data: { jobId: 'job-1' }, timestamp: '' }),
+        }));
+        await client.triggerFullPipeline({
+            businessProfileId: 'profile-1',
+            specialInstructions: 'Bias for customer support',
+        });
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/generate/full-pipeline', expect.objectContaining({
+            method: 'POST',
+            body: JSON.stringify({
+                businessProfileId: 'profile-1',
+                specialInstructions: 'Bias for customer support',
+            }),
+        }));
+    });
+    it('getFullPipelineStatus hits the status endpoint', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({
+                success: true,
+                data: { kind: 'full_pipeline', jobId: 'job-1', status: 'completed' },
+                timestamp: '',
+            }),
+        }));
+        await client.getFullPipelineStatus('job-1');
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/generate/full-pipeline/status/job-1', expect.objectContaining({ method: 'GET' }));
+    });
+});
+//# sourceMappingURL=generation-client.test.js.map

package/dist/__tests__/generation-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-client.test.js","sourceRoot":"","sources":["../../src/__tests__/generation-client.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,UAAU,GAAG;IACjB,MAAM,EAAE,wBAAwB;IAChC,MAAM,EAAE,gCAAgC;CACzC,CAAC;AAEF,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,IAAI,MAA4B,CAAC;IAEjC,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,IAAI,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAC9C,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6FAA6F,EAAE,KAAK,IAAI,EAAE;QAC3G,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC/C,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC1B,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE;gBAC3D,SAAS,EAAE,EAAE;aACd,CAAC;SACH,CAAC,CAAC,CAAC;QAEJ,MAAM,MAAM,CAAC,qBAAqB,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,sCAAsC,CAAC,CAAC;QAEpG,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAChC,2GAA2G,EAC3G,MAAM,CAAC,gBAAgB,CAAC;YACtB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC;SAC1D,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC/C,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC1B,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;gBAC/E,SAAS,EAAE,EAAE;aACd,CAAC;SACH,CAAC,CAAC,CAAC;QAEJ,MAAM,MAAM,CAAC,gBAAgB,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAElF,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAChC,0DAA0D,EAC1D,MAAM,CAAC,gBAAgB,CAAC;YACtB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC;SACzE,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC/C,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;SAC5F,CAAC,CAAC,CAAC;QAEJ,MAAM,MAAM,CAAC,0BAA0B,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAE5F,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAChC,0DAA0D,EAC1D,MAAM,CAAC,gBAAgB,CAAC;YACtB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;SACzE,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;QACjG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC/C,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC1B,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE;gBACzF,SAAS,EAAE,EAAE;aACd,CAAC;SACH,CAAC,CAAC,CAAC;QAEJ,MAAM,MAAM,CAAC,4BAA4B,CAAC,SAAS,EAAE,sCAAsC,CAAC,CAAC;QAE7F,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAChC,4HAA4H,EAC5H,MAAM,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAC3C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC/C,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;SACxF,CAAC,CAAC,CAAC;QAEJ,MAAM,MAAM,CAAC,mBAAmB,CAAC;YAC/B,iBAAiB,EAAE,WAAW;YAC9B,mBAAmB,EAAE,2BAA2B;SACjD,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAChC,8DAA8D,EAC9D,MAAM,CAAC,gBAAgB,CAAC;YACtB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,iBAAiB,EAAE,WAAW;gBAC9B,mBAAmB,EAAE,2BAA2B;aACjD,CAAC;SACH,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC/C,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC1B,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE;gBACpE,SAAS,EAAE,EAAE;aACd,CAAC;SACH,CAAC,CAAC,CAAC;QAEJ,MAAM,MAAM,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAE5C,MAAM,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAChC,2EAA2E,EAC3E,MAAM,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAC3C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/generation-tools.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/generation-tools.test.js

@@ -0,0 +1,168 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { AgentBlueprintClient } from '../client.js';
+import { handleCreateBusinessProfile } from '../tools/create-business-profile.js';
+import { handleGenerateUseCases } from '../tools/generate-use-cases.js';
+import { handleGenerateBlueprint } from '../tools/generate-blueprint.js';
+import { handleTriggerFullPipeline } from '../tools/trigger-full-pipeline.js';
+import { handleGetGenerationStatus } from '../tools/get-generation-status.js';
+const mockConfig = {
+    apiKey: 'ab_live_test',
+    apiUrl: 'https://test.agentblueprint.ai',
+};
+describe('Generation tool handlers', () => {
+    let client;
+    beforeEach(() => {
+        client = new AgentBlueprintClient(mockConfig);
+        vi.restoreAllMocks();
+    });
+    it('handleCreateBusinessProfile formats create-or-upsert results', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({
+                success: true,
+                data: {
+                    id: 'profile-1',
+                    companyName: 'Acme Health',
+                    isNew: true,
+                    aiReadinessScore: 58,
+                },
+                timestamp: '',
+            }),
+        }));
+        const result = await handleCreateBusinessProfile(client, { fields: { companyName: 'Acme Health' } });
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toContain('Business profile created.');
+        expect(result.content[0].text).toContain('profile-1');
+    });
+    it('handleGenerateUseCases returns JSON with a count and next-step hint', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({
+                success: true,
+                data: {
+                    useCases: [
+                        { id: 'uc-1', title: 'AI Triage' },
+                        { id: 'uc-2', title: 'AI Summaries' },
+                    ],
+                    generationMetadata: null,
+                    debugInfo: null,
+                },
+                timestamp: '',
+            }),
+        }));
+        const result = await handleGenerateUseCases(client, { count: 2 });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.useCaseCount).toBe(2);
+        expect(parsed.hint).toContain('generate_blueprint');
+    });
+    it('handleGenerateBlueprint returns the auditId and polling instruction', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ success: true, data: { auditId: 'audit-1' }, timestamp: '' }),
+        }));
+        const result = await handleGenerateBlueprint(client, { useCaseId: 'uc-1' });
+        expect(result.content[0].text).toContain('Blueprint generation started.');
+        expect(result.content[0].text).toContain('audit-1');
+    });
+    it('handleTriggerFullPipeline returns the jobId and polling instruction', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ success: true, data: { jobId: 'job-1' }, timestamp: '' }),
+        }));
+        const result = await handleTriggerFullPipeline(client, { businessProfileId: 'profile-1' });
+        expect(result.content[0].text).toContain('Full pipeline started.');
+        expect(result.content[0].text).toContain('job-1');
+    });
+    it('handleGetGenerationStatus normalizes blueprint polling responses', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({
+                success: true,
+                data: {
+                    kind: 'blueprint',
+                    auditId: 'audit-1',
+                    status: 'completed',
+                    blueprintId: 'bp-1',
+                    progressPercent: 100,
+                    stage: 'done',
+                    stageLabel: 'Done',
+                    error: null,
+                    entityRoute: '/blueprints/bp-1',
+                    entityTitle: 'Blueprint',
+                    updatedAt: '2026-04-21T00:00:00.000Z',
+                    completedAt: '2026-04-21T00:00:00.000Z',
+                },
+                timestamp: '',
+            }),
+        }));
+        const result = await handleGetGenerationStatus(client, { auditId: 'audit-1' });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.kind).toBe('blueprint');
+        expect(parsed.hint).toContain('download_blueprint');
+    });
+    it('handleGetGenerationStatus normalizes full-pipeline polling responses', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({
+                success: true,
+                data: {
+                    kind: 'full_pipeline',
+                    jobId: 'job-1',
+                    status: 'completed',
+                    generatedArtifactIds: {
+                        readinessId: 'read-1',
+                        useCaseIds: ['uc-1'],
+                        selectedUseCaseId: 'uc-1',
+                        blueprintId: 'bp-1',
+                        businessCaseId: 'bc-1',
+                        implementationPlanId: 'ip-1',
+                    },
+                    progressPercent: 100,
+                    currentStep: 'Done',
+                    error: null,
+                    businessProfileId: 'profile-1',
+                    platform: 'vendor_agnostic',
+                    strategicInitiativeId: null,
+                    startedAt: '2026-04-21T00:00:00.000Z',
+                    completedAt: '2026-04-21T00:00:00.000Z',
+                    createdAt: '2026-04-21T00:00:00.000Z',
+                    updatedAt: '2026-04-21T00:00:00.000Z',
+                },
+                timestamp: '',
+            }),
+        }));
+        const result = await handleGetGenerationStatus(client, { jobId: 'job-1' });
+        const parsed = JSON.parse(result.content[0].text);
+        expect(parsed.kind).toBe('full_pipeline');
+        expect(parsed.generatedArtifactIds.blueprintId).toBe('bp-1');
+        expect(parsed.hint).toContain('download_blueprint');
+    });
+    it('returns a validation error when get_generation_status receives both IDs', async () => {
+        const result = await handleGetGenerationStatus(client, { auditId: 'audit-1', jobId: 'job-1' });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('exactly one');
+    });
+    it('formats 403 approval failures clearly', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: false,
+            status: 403,
+            statusText: 'Forbidden',
+            json: () => Promise.resolve({ error: 'AI generation requires an upgraded account. Contact support to unlock this feature.' }),
+        }));
+        const result = await handleGenerateUseCases(client, {});
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('Approval required (403)');
+    });
+    it('formats 429 rate limits clearly', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: false,
+            status: 429,
+            statusText: 'Too Many Requests',
+            json: () => Promise.resolve({ error: 'Rate limit exceeded. Maximum 5 use-case generations per hour.' }),
+        }));
+        const result = await handleGenerateUseCases(client, {});
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain('Rate limit exceeded (429)');
+    });
+});
+//# sourceMappingURL=generation-tools.test.js.map

package/dist/__tests__/generation-tools.test.js.map

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

package/dist/__tests__/renderers.test.js

@@ -737,6 +737,31 @@ describe('GETTING-STARTED.md implementation state reference', () => {
         const guide = files.get('GETTING-STARTED.md');
         expect(guide).toContain('agentblueprint sync');
     });
+    it('does not reference missing implementation roadmap files', () => {
+        const files = renderSkillDirectory(minimalInput);
+        const guide = files.get('GETTING-STARTED.md');
+        expect(guide).not.toContain('references/implementation-roadmap.md');
+    });
+    it('starts with the smallest executable pilot slice', () => {
+        const files = renderSkillDirectory(minimalInput);
+        const guide = files.get('GETTING-STARTED.md');
+        expect(guide).toContain('smallest executable pilot slice');
+        expect(guide).not.toContain('Build the first worker agent');
+    });
+    it('requires approval before demo or test sync', () => {
+        const files = renderSkillDirectory(minimalInput);
+        const guide = files.get('GETTING-STARTED.md');
+        expect(guide).toContain('ask the user before syncing local state back to Agent');
+        expect(guide).toContain('after approval in demo/test mode');
+    });
+    it('requires approval before high-impact actions', () => {
+        const files = renderSkillDirectory(minimalInput);
+        const guide = files.get('GETTING-STARTED.md');
+        expect(guide).toContain('background scripts');
+        expect(guide).toContain('production writes');
+        expect(guide).toContain('credential changes');
+        expect(guide).toContain('cleanup/deletion');
+    });
 });
 describe('GETTING-STARTED.md sync enhancements', () => {
     it('Step 5 has sync trigger points', () => {
@@ -1034,6 +1059,22 @@ describe('renderSkillDirectory with implementation state only', () => {
         expect(guide).toContain('CONTINUING AN IMPLEMENTATION');
         expect(guide).toContain('CURRENT-STATE.md');
     });
+    it('return-visit GETTING-STARTED.md includes deployment path decision guidance', () => {
+        const files = renderSkillDirectory(stateOnlyInput);
+        const guide = files.get('GETTING-STARTED.md');
+        expect(guide).toContain('deployment-path decision');
+        expect(guide).toContain('PROGRESS.md');
+    });
+    it('return-visit GETTING-STARTED.md avoids missing roadmap references', () => {
+        const files = renderSkillDirectory(stateOnlyInput);
+        const guide = files.get('GETTING-STARTED.md');
+        expect(guide).not.toContain('references/implementation-roadmap.md');
+    });
+    it('return-visit GETTING-STARTED.md keeps sync gated in demo or test mode', () => {
+        const files = renderSkillDirectory(stateOnlyInput);
+        const guide = files.get('GETTING-STARTED.md');
+        expect(guide).toContain('ask the user before syncing');
+    });
     it('return-visit Step 5 has MCP tool examples', () => {
         const files = renderSkillDirectory(stateOnlyInput);
         const guide = files.get('GETTING-STARTED.md');
@@ -1073,6 +1114,12 @@ describe('renderSkillDirectory with progress only', () => {
         expect(guide).not.toContain('CONTINUING AN IMPLEMENTATION');
         expect(guide).toContain('YOU ARE THE IMPLEMENTER');
     });
+    it('GETTING-STARTED.md includes deployment path decision guidance', () => {
+        const files = renderSkillDirectory(progressOnlyInput);
+        const guide = files.get('GETTING-STARTED.md');
+        expect(guide).toContain('deployment-path decision');
+        expect(guide).toContain('PROGRESS.md');
+    });
     it('evaluation-criteria.md is enriched with Actual columns', () => {
         const files = renderSkillDirectory(progressOnlyInput);
         const evalCriteria = files.get('references/evaluation-criteria.md');