@friehub/blueprint 0.1.1 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +54 -0
- package/package.json +1 -1
- package/blueprint.json +0 -5
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.1.0 — Initial Release
|
|
4
|
+
|
|
5
|
+
### Core
|
|
6
|
+
- **Parser:** Reads 108 markdown contracts, extracts functions, types, dependencies, invariants, and provider lists. 0 errors, 0 warnings.
|
|
7
|
+
- **Resolver:** Transitive dependency resolution with cycle detection. Walks hard deps, attaches implicit core contracts.
|
|
8
|
+
- **Type inference:** Automatic type detection from parameter names (`order_id` → `string`, `amount` → `number`, `created_at` → `Timestamp`). 35 inference rules.
|
|
9
|
+
- **Versioning:** Extracts `**Version:** 0.1.0` from contract preambles. All 108 contracts versioned.
|
|
10
|
+
|
|
11
|
+
### Adapters
|
|
12
|
+
- **83 adapters across 35 modules:** Stripe, Paystack, Adyen (payments), Redis, Memcached (caching), BullMQ, SQS, RabbitMQ (queues), Resend, Sendgrid, Mailgun (email), Twilio, Vonage (SMS), Clerk, Auth0, Supertokens (auth), and more.
|
|
13
|
+
- **Adapter validation:** Checks implementations against contracts. Reports missing functions, suggests similar names (Levenshtein distance).
|
|
14
|
+
- **Config extraction:** Required and optional config fields per adapter.
|
|
15
|
+
|
|
16
|
+
### Code Generation
|
|
17
|
+
- **TypeScript generator:** Interfaces, adapter skeletons, conformance tests. 276 files generated from 108 contracts.
|
|
18
|
+
- **SDK implementations:** Real Stripe, Redis, BullMQ code embedded in generated adapters. Not stubs — working implementations.
|
|
19
|
+
- **Dependency-aware:** Generating a module's code also generates its hard dep interfaces.
|
|
20
|
+
- **Type safety:** Inferred types throughout library API and generated code. Zero `any` in function signatures.
|
|
21
|
+
|
|
22
|
+
### CLI — 14 commands
|
|
23
|
+
| Command | What it does |
|
|
24
|
+
|---|---|
|
|
25
|
+
| `build` | Parse contracts → catalog.json |
|
|
26
|
+
| `list` | All 108 modules with deps |
|
|
27
|
+
| `inspect` | Full contract for one module |
|
|
28
|
+
| `graph` | ASCII or Mermaid dependency tree |
|
|
29
|
+
| `search` | Interactive module picker |
|
|
30
|
+
| `resolve` | Transitive dependency resolution |
|
|
31
|
+
| `adapters` | 83 adapters: list, add, remove, verify |
|
|
32
|
+
| `generate` | TypeScript code generation |
|
|
33
|
+
| `prototype` | Project scaffold with correct npm deps |
|
|
34
|
+
| `schema` | JSON Schema export |
|
|
35
|
+
| `verify` | Check implementation against contract |
|
|
36
|
+
| `implement` | Generate AI implementation prompts |
|
|
37
|
+
| `mcp` | Start MCP server for AI tools |
|
|
38
|
+
|
|
39
|
+
### Library API
|
|
40
|
+
```typescript
|
|
41
|
+
import { loadCatalogFromRoot } from 'blueprint';
|
|
42
|
+
const catalog = await loadCatalogFromRoot('./contracts');
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### MCP Server
|
|
46
|
+
7 tools for AI integration: `list_modules`, `get_module`, `search_modules`, `resolve_deps`, `list_adapters`, `get_adapter`, `get_dependency_graph`. Stdio transport for Claude Desktop, Cursor, Copilot.
|
|
47
|
+
|
|
48
|
+
### Testing
|
|
49
|
+
- **91 tests:** 58 unit + 25 integration + 8 MCP
|
|
50
|
+
- **Edge cases:** Empty files, malformed markdown, 50-module chains, self-referencing modules, commented-out code, return type mismatches
|
|
51
|
+
- **CI:** GitHub Actions on Node 18, 20, 22
|
|
52
|
+
|
|
53
|
+
### Contributing
|
|
54
|
+
See [CONTRIBUTING.md](CONTRIBUTING.md) (coming soon).
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@friehub/blueprint",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "A domain contract catalogue for backend development. 108 interfaces, 83 adapters, AI-ready.",
|
|
5
5
|
"keywords": ["contract", "domain", "backend", "ai", "code-generation", "adapter", "blueprint"],
|
|
6
6
|
"license": "MIT",
|