agentblueprint 0.4.0

package/README.md

@@ -0,0 +1,137 @@
+# 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 Quick Start
+
+```bash
+# Install globally
+npm install -g agentblueprint
+
+# Store your API token (one-time)
+agentblueprint login
+
+# List blueprints
+agentblueprint list
+
+# Get a blueprint summary (JSON to stdout)
+agentblueprint get blueprint <id>
+
+# Get other artifacts
+agentblueprint get business-case <id>
+agentblueprint get use-case <id>
+agentblueprint get implementation-plan <id>
+agentblueprint get implementation-spec <id>
+agentblueprint get business-profile
+
+# Download as Agent Skills directory
+agentblueprint download <id>
+
+# Partner cross-org access
+agentblueprint list --org <customer-org-id>
+agentblueprint get blueprint <id> --org <customer-org-id>
+```
+
+Or run without installing via npx:
+
+```bash
+npx agentblueprint list --token <your-api-key>
+npx agentblueprint get blueprint <id> --token <your-api-key>
+```
+
+## MCP Server Setup
+
+The same binary auto-detects MCP mode when stdin is piped (non-interactive). No separate command needed.
+
+Add to your Claude Code MCP config (`.claude/settings.json` or project settings):
+
+```json
+{
+  "mcpServers": {
+    "agent-blueprint": {
+      "command": "npx",
+      "args": ["@agentblueprint/mcp-server"],
+      "env": {
+        "AGENT_BLUEPRINT_API_KEY": "<your-api-key>"
+      }
+    }
+  }
+}
+```
+
+You can also start the MCP server explicitly with `agentblueprint serve`.
+
+## Get an API Key
+
+1. Go to [Agent Blueprint Settings > API Tokens](https://app.agentblueprint.ai/settings/api-tokens)
+2. Click "Create Token"
+3. Copy the token (shown once)
+
+## 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.
+
+```bash
+# Using the CLI (after `agentblueprint login`)
+agentblueprint download <id>
+agentblueprint download <id> --dir ./my-skills
+
+# Or via npx
+npx agentblueprint download --token <key> --blueprint <id>
+```
+
+This creates an Agent Skills directory structure:
+
+```
+.agent-blueprint/<blueprint-slug>/
+├── SKILL.md                              # Overview + frontmatter (auto-discovered by agents)
+├── references/
+│   ├── business-context.md               # Use case, pain points, transformation story
+│   ├── agent-specifications.md           # Full agent specs with tools, guardrails, metrics
+│   ├── financial-case.md                 # ROI, cost breakdown, sensitivity, 5-year projection
+│   ├── implementation-roadmap.md         # Epics, stories, timeline, roles, dependencies
+│   ├── architecture-decisions.md         # Platform, pattern, integration gaps, feasibility
+│   └── guardrails-and-governance.md      # Risks, mitigation, per-agent guardrails
+└── scripts/
+    └── validate-spec.sh                  # Structure completeness checker
+```
+
+The [Agent Skills](https://agentskills.io) standard is supported by Claude Code, Codex, Cursor, GitHub Copilot, Windsurf, and 18+ other coding agents. SKILL.md loads automatically at activation (~100 tokens), reference files load on demand.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_blueprints` | List all blueprints (summaries) |
+| `get_blueprint` | Blueprint summary — title, agents, phases, pattern |
+| `get_business_case` | Business case summary — ROI, pilot economics, recommendation |
+| `get_implementation_plan` | Implementation plan summary — epics, timeline, story counts |
+| `get_use_case` | Use case analysis for a blueprint |
+| `get_implementation_spec` | Implementation spec metadata |
+| `get_business_profile` | Organization business profile |
+| `download_blueprint` | Download full blueprint as Agent Skills file manifest |
+
+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
+
+| URI | Description |
+|-----|-------------|
+| `agentblueprint://blueprints` | Blueprint list (JSON) |
+| `agentblueprint://blueprints/{id}` | Blueprint detail (Markdown) |
+| `agentblueprint://blueprints/{id}/spec` | Implementation spec (Markdown) |
+
+## Authentication
+
+Three ways to provide your API token (checked in this order):
+
+1. `--token <key>` flag on any command
+2. `AGENT_BLUEPRINT_API_KEY` environment variable
+3. `agentblueprint login` (saved to `~/.config/agentblueprint/config.json`)
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `AGENT_BLUEPRINT_API_KEY` | No | — | Your API token (alternative to `agentblueprint login`) |
+| `AGENT_BLUEPRINT_API_URL` | No | `https://app.agentblueprint.ai` | API base URL |

package/dist/__tests__/cli.test.d.ts

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

package/dist/__tests__/cli.test.js

@@ -0,0 +1,136 @@
+import { describe, it, expect } from 'vitest';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { join } from 'node:path';
+import { parseDownloadArgs } from '../download.js';
+const exec = promisify(execFile);
+const CLI_PATH = join(import.meta.dirname, '../../dist/cli.js');
+describe('parseDownloadArgs', () => {
+    it('parses positional blueprint ID', () => {
+        const result = parseDownloadArgs(['abc-123']);
+        expect(result.blueprintId).toBe('abc-123');
+        expect(result.dir).toBe('.agent-blueprint');
+    });
+    it('parses --org flag', () => {
+        const result = parseDownloadArgs(['abc-123', '--org', 'org-456']);
+        expect(result.blueprintId).toBe('abc-123');
+        expect(result.customerOrgId).toBe('org-456');
+    });
+    it('parses --blueprint flag alongside --org', () => {
+        const result = parseDownloadArgs(['--blueprint', 'bp-789', '--org', 'org-456', '--dir', '/tmp/out']);
+        expect(result.blueprintId).toBe('bp-789');
+        expect(result.customerOrgId).toBe('org-456');
+        expect(result.dir).toBe('/tmp/out');
+    });
+    it('parses --list flag', () => {
+        const result = parseDownloadArgs(['--list']);
+        expect(result.list).toBe(true);
+        expect(result.blueprintId).toBeUndefined();
+    });
+    it('--blueprint takes priority over positional', () => {
+        const result = parseDownloadArgs(['--blueprint', 'bp-flag', 'bp-positional']);
+        expect(result.blueprintId).toBe('bp-flag');
+    });
+    it('defaults dir to .agent-blueprint', () => {
+        const result = parseDownloadArgs([]);
+        expect(result.dir).toBe('.agent-blueprint');
+        expect(result.list).toBe(false);
+    });
+});
+describe('CLI binary', () => {
+    it('shows help with --help', async () => {
+        const { stderr } = await exec('node', [CLI_PATH, '--help']);
+        expect(stderr).toContain('Agent Blueprint CLI');
+        expect(stderr).toContain('agentblueprint login');
+        expect(stderr).toContain('agentblueprint list');
+        expect(stderr).toContain('agentblueprint get');
+        expect(stderr).toContain('agentblueprint download');
+    });
+    it('shows version with --version', async () => {
+        const { stdout } = await exec('node', [CLI_PATH, '--version']);
+        expect(stdout.trim()).toMatch(/^\d+\.\d+\.\d+$/);
+    });
+    it('starts MCP server with no arguments on piped stdin (non-TTY)', async () => {
+        // When stdin is piped (as in execFile), no-args triggers MCP mode.
+        // Without a token, it errors with missing API key.
+        try {
+            await exec('node', [CLI_PATH], {
+                env: { ...process.env, AGENT_BLUEPRINT_API_KEY: '', HOME: '/tmp/nonexistent-cli-test' },
+            });
+            expect.fail('should have exited with error');
+        }
+        catch (err) {
+            const error = err;
+            expect(error.stderr).toContain('Missing API key');
+        }
+    });
+    it('errors on unknown command', async () => {
+        try {
+            await exec('node', [CLI_PATH, 'foobar']);
+            expect.fail('should have exited with error');
+        }
+        catch (err) {
+            const error = err;
+            expect(error.stderr).toContain('Unknown command');
+            expect(error.code).toBe(1);
+        }
+    });
+    it('errors on get without type', async () => {
+        try {
+            await exec('node', [CLI_PATH, 'get']);
+            expect.fail('should have exited with error');
+        }
+        catch (err) {
+            const error = err;
+            expect(error.stderr).toContain('Missing artifact type');
+        }
+    });
+    it('errors on get with unknown type', async () => {
+        try {
+            await exec('node', [CLI_PATH, 'get', 'foobar', 'some-id', '--token', 'ab_live_fake']);
+            expect.fail('should have exited with error');
+        }
+        catch (err) {
+            const error = err;
+            expect(error.stderr).toContain('Unknown type');
+        }
+    });
+    it('errors on get blueprint without ID', async () => {
+        try {
+            await exec('node', [CLI_PATH, 'get', 'blueprint', '--token', 'ab_live_fake']);
+            expect.fail('should have exited with error');
+        }
+        catch (err) {
+            const error = err;
+            expect(error.stderr).toContain('Missing blueprint ID');
+        }
+    });
+    it('errors on get implementation-spec without ID', async () => {
+        try {
+            await exec('node', [CLI_PATH, 'get', 'implementation-spec', '--token', 'ab_live_fake']);
+            expect.fail('should have exited with error');
+        }
+        catch (err) {
+            const error = err;
+            expect(error.stderr).toContain('Missing blueprint ID');
+        }
+    });
+    it('errors on list without token', async () => {
+        try {
+            await exec('node', [CLI_PATH, 'list'], {
+                env: { ...process.env, AGENT_BLUEPRINT_API_KEY: '', HOME: '/tmp/nonexistent-cli-test' },
+            });
+            expect.fail('should have exited with error');
+        }
+        catch (err) {
+            const error = err;
+            expect(error.stderr).toContain('Missing API key');
+        }
+    });
+    it('help includes implementation-spec and serve', async () => {
+        const { stderr } = await exec('node', [CLI_PATH, '--help']);
+        expect(stderr).toContain('implementation-spec');
+        expect(stderr).toContain('When stdin is piped');
+    });
+});
+//# sourceMappingURL=cli.test.js.map

package/dist/__tests__/cli.test.js.map

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

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

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

package/dist/__tests__/client.test.js

@@ -0,0 +1,99 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { AgentBlueprintClient } from '../client.js';
+import { ApiError } from '../errors.js';
+const mockConfig = {
+    apiKey: 'ab_live_test1234567890',
+    apiUrl: 'https://test.agentblueprint.ai',
+};
+describe('AgentBlueprintClient', () => {
+    let client;
+    beforeEach(() => {
+        client = new AgentBlueprintClient(mockConfig);
+        vi.restoreAllMocks();
+    });
+    it('getBusinessProfile calls correct endpoint', async () => {
+        const profileData = { id: 'prof-1', companyName: 'Acme Corp', industry: 'Technology' };
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ success: true, data: profileData, timestamp: '' }),
+        }));
+        const result = await client.getBusinessProfile();
+        expect(result).toEqual(profileData);
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/business-profile', expect.objectContaining({
+            headers: expect.objectContaining({
+                'Authorization': 'Bearer ab_live_test1234567890',
+            }),
+        }));
+    });
+    it('listBlueprints sends correct request', async () => {
+        const mockData = [
+            { id: 'bp-1', title: 'Test BP', version: 1, platform: 'general', agentCount: 2 },
+        ];
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ success: true, data: mockData, timestamp: new Date().toISOString() }),
+        }));
+        const result = await client.listBlueprints();
+        expect(result).toEqual(mockData);
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/blueprints', expect.objectContaining({
+            headers: expect.objectContaining({
+                'Authorization': 'Bearer ab_live_test1234567890',
+            }),
+        }));
+    });
+    it('getBlueprint encodes ID in URL', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ success: true, data: { id: 'bp-1' }, timestamp: '' }),
+        }));
+        await client.getBlueprint('bp-1');
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/blueprints/bp-1', expect.anything());
+    });
+    it('throws ApiError on non-ok response', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: false,
+            status: 401,
+            statusText: 'Unauthorized',
+            json: () => Promise.resolve({ error: 'Invalid token' }),
+        }));
+        await expect(client.listBlueprints()).rejects.toThrow(ApiError);
+        await expect(client.listBlueprints()).rejects.toThrow('Invalid token');
+    });
+    it('getBusinessCase calls correct endpoint', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ success: true, data: { id: 'bc-1' }, timestamp: '' }),
+        }));
+        await client.getBusinessCase('bp-1');
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/blueprints/bp-1/business-case', expect.anything());
+    });
+    it('getImplementationPlan calls correct endpoint', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ success: true, data: { id: 'ip-1' }, timestamp: '' }),
+        }));
+        await client.getImplementationPlan('bp-1');
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/blueprints/bp-1/implementation-plan', expect.anything());
+    });
+    it('getUseCase calls correct endpoint', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({ success: true, data: { id: 'uc-1' }, timestamp: '' }),
+        }));
+        await client.getUseCase('bp-1');
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/blueprints/bp-1/use-case', expect.anything());
+    });
+    it('getImplementationSpec calls correct endpoint', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
+            ok: true,
+            json: () => Promise.resolve({
+                success: true,
+                data: { blueprintId: 'bp-1', filename: 'test.zip', metadata: {} },
+                timestamp: '',
+            }),
+        }));
+        await client.getImplementationSpec('bp-1');
+        expect(fetch).toHaveBeenCalledWith('https://test.agentblueprint.ai/api/v1/blueprints/bp-1/implementation-spec', expect.anything());
+    });
+});
+//# sourceMappingURL=client.test.js.map

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

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

package/dist/__tests__/config.test.d.ts

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

package/dist/__tests__/config.test.js

@@ -0,0 +1,37 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { loadConfig } from '../config.js';
+describe('loadConfig', () => {
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        vi.unstubAllEnvs();
+    });
+    afterEach(() => {
+        process.env = { ...originalEnv };
+    });
+    it('loads API key from token override', () => {
+        const config = loadConfig('ab_live_test123');
+        expect(config.apiKey).toBe('ab_live_test123');
+        expect(config.apiUrl).toBe('https://app.agentblueprint.ai');
+    });
+    it('loads API key from environment', () => {
+        process.env.AGENT_BLUEPRINT_API_KEY = 'ab_live_envkey';
+        const config = loadConfig();
+        expect(config.apiKey).toBe('ab_live_envkey');
+    });
+    it('uses custom API URL from environment', () => {
+        process.env.AGENT_BLUEPRINT_API_KEY = 'ab_live_test';
+        process.env.AGENT_BLUEPRINT_API_URL = 'http://localhost:3000';
+        const config = loadConfig();
+        expect(config.apiUrl).toBe('http://localhost:3000');
+    });
+    it('throws when no API key provided', () => {
+        delete process.env.AGENT_BLUEPRINT_API_KEY;
+        expect(() => loadConfig()).toThrow('Missing API key');
+    });
+    it('token override takes precedence over env', () => {
+        process.env.AGENT_BLUEPRINT_API_KEY = 'ab_live_env';
+        const config = loadConfig('ab_live_override');
+        expect(config.apiKey).toBe('ab_live_override');
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/__tests__/config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../../src/__tests__/config.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,MAAM,WAAW,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAEvC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,gBAAgB,CAAC;QACvD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,cAAc,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,uBAAuB,CAAC;QAC9D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,OAAO,CAAC,GAAG,CAAC,uBAAuB,GAAG,aAAa,CAAC;QACpD,MAAM,MAAM,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/renderers.test.d.ts

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