docs(npm): update package readme for v1.2.0 did:web API

Author: Corey B

lib/node-fdd/README.md

@@ -1,33 +1,68 @@
 # @coreyburns/node-fdd
 
-The official CLI toolchain for composing, packing, and cryptographically signing Formatted Data Document (`.fdd`) layouts natively from your Node endpoint.
-
-The `.fdd` MIME type is a zero-JS interactive document specification meant to replace visual-first static PDFs natively by routing HTML rendering via declarative logic rules binding Cryptographic VC Payloads directly to your canvas.
+Official CLI & API toolchain for the OpenFDD (`.fdd`) format — zero-dependency, Node 18+.
 
 ---
 
-## ⚡ Global Installation
+## Installation
+
 ```bash
 npm install -g @coreyburns/node-fdd
 ```
 
-## 🛠 Operation Workflows
-The OpenFDD compiler requires you to merge standard HTML Templates with a Cryptographic Data Payload into a secure FDD Container.
+---
 
-### 1. Generating & Packing an `.fdd` Context
-Wrap your immutable schema, an optional mutable tracking schema (like `user-notes.json`), and the presentation layout using `fdd-pack`.
+## CLI Commands
 
 ```bash
-fdd-pack template.html fdd-data.json user-notes.json output.fdd
+# Generate an Ed25519 keypair
+fdd-identity keygen [./outDir]
+
+# Generate a did.json for /.well-known/did.json hosting
+fdd-identity did <public.pem> <domain>
+
+# Pack + sign an .fdd container in one step
+fdd-sign pack <template.html> <data.json> <private.pem> <did:web:domain> [output.fdd]
+
+# Extract structured data from an .fdd (no OCR, no DOM)
+fdd-sign parse <file.fdd>
+
+# Verify an .fdd signature against its did:web issuer
+fdd-sign verify <file.fdd>
+
+# Legacy: sign a raw JSON file only
+fdd-sign sign <data.json> <private.pem> [output.json]
+
+# Legacy: pack without signing
+fdd-pack <template.html> <data.json> [mutable.json] [output.fdd]
 ```
 
-### 2. Cryptographic Binding (Issuing)
-Officially binding a document enforces an Ed25519 trace mathematically tied to the JSON tree to ensure massive Verifiable Credential integrity mathematically.
+---
 
-```bash
-fdd-sign path/to/privateKey.pem fdd-data.json
+## API — did:web Workflow
+
+```javascript
+import { generateIdentity, createDidDocument } from '@coreyburns/node-fdd/identity';
+import { signFdd, parse, verify } from '@coreyburns/node-fdd';
+
+// 1. One-time setup
+const identity = generateIdentity();
+const didDoc = createDidDocument(identity.publicKeyBase64, 'bank.com');
+// Host didDoc at https://bank.com/.well-known/did.json
+
+// 2. Issue a document
+const fddString = signFdd(transactionData, htmlTemplate, identity.privateKeyPem, 'did:web:bank.com');
+
+// 3. Consume (recipient server)
+const { valid, issuer } = await verify(fddString);
+if (valid) {
+  const { vc, mutable } = parse(fddString);
+}
 ```
 
-## 🌍 Ecosystem Links
-*   [OpenFDD Specification (GitHub)](https://github.com/Spuds0588/open-fdd)
-*   [Read the Web Manifesto](https://spuds0588.github.io/open-fdd/site/index.html)
+---
+
+## Ecosystem Links
+
+- [OpenFDD Specification (GitHub)](https://github.com/Spuds0588/open-fdd)
+- [Web Manifesto](https://spuds0588.github.io/open-fdd/site/index.html)