@friehub/blueprint 0.1.0 → 0.1.2

package/.github/workflows/publish.yml

@@ -18,7 +18,8 @@ jobs:
       - run: npm ci
       - run: npm run build
       - run: npm test
-      - name: Publish
-        run: npm publish --access public
+      - name: Pre-publish checks
+        run: bash scripts/check-publish.sh
+      - run: npm publish --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+## 0.1.0 — Initial Release
+
+### Core
+- **Parser:** Reads 108 markdown contracts, extracts functions, types, dependencies, invariants, and provider lists. 0 errors, 0 warnings.
+- **Resolver:** Transitive dependency resolution with cycle detection. Walks hard deps, attaches implicit core contracts.
+- **Type inference:** Automatic type detection from parameter names (`order_id` → `string`, `amount` → `number`, `created_at` → `Timestamp`). 35 inference rules.
+- **Versioning:** Extracts `**Version:** 0.1.0` from contract preambles. All 108 contracts versioned.
+
+### Adapters
+- **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.
+- **Adapter validation:** Checks implementations against contracts. Reports missing functions, suggests similar names (Levenshtein distance).
+- **Config extraction:** Required and optional config fields per adapter.
+
+### Code Generation
+- **TypeScript generator:** Interfaces, adapter skeletons, conformance tests. 276 files generated from 108 contracts.
+- **SDK implementations:** Real Stripe, Redis, BullMQ code embedded in generated adapters. Not stubs — working implementations.
+- **Dependency-aware:** Generating a module's code also generates its hard dep interfaces.
+- **Type safety:** Inferred types throughout library API and generated code. Zero `any` in function signatures.
+
+### CLI — 14 commands
+| Command | What it does |
+|---|---|
+| `build` | Parse contracts → catalog.json |
+| `list` | All 108 modules with deps |
+| `inspect` | Full contract for one module |
+| `graph` | ASCII or Mermaid dependency tree |
+| `search` | Interactive module picker |
+| `resolve` | Transitive dependency resolution |
+| `adapters` | 83 adapters: list, add, remove, verify |
+| `generate` | TypeScript code generation |
+| `prototype` | Project scaffold with correct npm deps |
+| `schema` | JSON Schema export |
+| `verify` | Check implementation against contract |
+| `implement` | Generate AI implementation prompts |
+| `mcp` | Start MCP server for AI tools |
+
+### Library API
+```typescript
+import { loadCatalogFromRoot } from 'blueprint';
+const catalog = await loadCatalogFromRoot('./contracts');
+```
+
+### MCP Server
+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.
+
+### Testing
+- **91 tests:** 58 unit + 25 integration + 8 MCP
+- **Edge cases:** Empty files, malformed markdown, 50-module chains, self-referencing modules, commented-out code, return type mismatches
+- **CI:** GitHub Actions on Node 18, 20, 22
+
+### Contributing
+See [CONTRIBUTING.md](CONTRIBUTING.md) (coming soon).

package/dist/index.js

@@ -4,5 +4,7 @@ export { loadCatalogFromRoot } from "./core/load-catalog.js";
 export { loadAdapters, loadAdapter } from "./core/adapters/load.js";
 export { resolve as resolveDeps, detectCycles } from "./core/resolve.js";
 export { searchModules } from "./core/search.js";
-export { buildGraph } from "./core/graph.js";
 export { implicitCores } from "./core/catalog.js";
+export { validateAdapter, validateAdapterSelection } from "./core/adapters/validate.js";
+export { generateImplementPrompts } from "./core/implement.js";
+export { verifyImplementation } from "./core/verify.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@friehub/blueprint",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A domain contract catalogue for backend development. 108 interfaces, 83 adapters, AI-ready.",
   "keywords": ["contract", "domain", "backend", "ai", "code-generation", "adapter", "blueprint"],
   "license": "MIT",
@@ -21,6 +21,7 @@
     "check": "tsc -p tsconfig.json --noEmit",
     "test": "npm run build && node --test dist/core/*.test.js dist/core/adapters/*.test.js",
     "test:mcp": "node --test dist/mcp/*.test.js",
+    "check:publish": "bash scripts/check-publish.sh",
     "test:integration": "npm run build && bash scripts/integration-test.sh",
     "postinstall": "npm run build",
     "link": "npm run build && npm link"

package/blueprint.json

@@ -1,5 +0,0 @@
-{
-  "adapters": {
-    "caching": "redis"
-  }
-}