feat: add full commons JSON+TS examples for all verbs

Author: Your Name

examples/v1.0.0/commons/analyze/invalid/001-analyze.request.invalid.json

@@ -0,0 +1,9 @@
+{
+  "x402": {
+    "verb": "summarize",
+    "version": "1.0.0"
+  },
+  "input": {
+    "content": "This should be a string, not an object."
+  }
+}

examples/v1.0.0/commons/analyze/invalid/900-analyze.receipt.invalid.json

@@ -0,0 +1,22 @@
+{
+  "x402": {
+    "verb": "analyze",
+    "version": "1.0.0",
+    "request_id": "req-analyze-2025-11-19-0002"
+  },
+  "trace": {
+    "trace_id": "trace-analyze-0002",
+    "started_at": "2025-11-19T20:35:00Z",
+    "completed_at": "2025-11-19T20:35:01Z",
+    "duration_ms": 870,
+    "provider": "commandlayer-demo",
+    "region": "us-east-1",
+    "model": "analyze-large-001"
+  },
+  "status": "ok",
+  "result": {
+    "summary": "",
+    "insights": [],
+    "labels": []
+  }
+}

examples/v1.0.0/commons/analyze/ts/invalid/analyze.receipt.invalid.1.ts

@@ -0,0 +1,24 @@
+// INVALID analyze.receipt #1 — wrong status + empty summary
+
+export const analyzeReceiptInvalid1: any = {
+  x402: {
+    verb: "analyze",
+    version: "1.0.0",
+    request_id: "req-analyze-2025-11-19-0002"
+  },
+  trace: {
+    trace_id: "trace-analyze-0002",
+    started_at: "2025-11-19T20:35:00Z",
+    completed_at: "2025-11-19T20:35:01Z",
+    duration_ms: 870,
+    provider: "commandlayer-demo",
+    region: "us-east-1",
+    model: "analyze-large-001"
+  },
+  // ❌ status is not in enum
+  status: "ok",
+  result: {
+    // ❌ summary should not be empty if required/minLength: 1
+    summary: ""
+  }
+};

examples/v1.0.0/commons/analyze/ts/invalid/analyze.receipt.invalid.2.ts

@@ -0,0 +1,11 @@
+// INVALID analyze.receipt #2 — missing trace + result
+
+export const analyzeReceiptInvalid2: any = {
+  x402: {
+    verb: "analyze",
+    version: "1.0.0"
+  },
+  // ❌ Missing trace
+  // ❌ Missing result when status='success'
+  status: "success"
+};

examples/v1.0.0/commons/analyze/ts/invalid/analyze.request.invalid.1.ts

@@ -0,0 +1,12 @@
+// INVALID analyze.request #1 — wrong verb + wrong input type
+
+export const analyzeRequestInvalid1: any = {
+  x402: {
+    verb: "summarize",
+    version: "1.0.0"
+  },
+  // ❌ input should be a string
+  input: {
+    content: "This should be a string, not an object."
+  }
+};

examples/v1.0.0/commons/analyze/ts/invalid/analyze.request.invalid.2.ts

@@ -0,0 +1,7 @@
+// INVALID analyze.request #2 — missing required x402 + input
+
+export const analyzeRequestInvalid2: any = {
+  // ❌ missing x402
+  // ❌ missing input
+  goal: "This object intentionally violates the schema."
+};

examples/v1.0.0/commons/analyze/ts/valid/analyze.receipt.valid.1.ts

@@ -0,0 +1,81 @@
+// VALID analyze.receipt #1 — aligns with analyze.receipt.schema.json (assumed)
+
+export type AnalyzeReceiptStatus = "success" | "error" | "delegated";
+
+export interface X402AnalyzeReceiptEnvelope {
+  verb: "analyze";
+  version: "1.0.0";
+  request_id?: string;
+  network?: string;
+  tenant?: string;
+}
+
+export interface AnalyzeTraceMetadata {
+  trace_id: string;
+  parent_trace_id?: string;
+  started_at?: string;
+  completed_at?: string;
+  duration_ms?: number;
+  provider?: string;
+  region?: string;
+  model?: string;
+  tags?: string[];
+}
+
+export interface AnalyzeResultPayload {
+  summary: string;
+  insights?: string[];
+  labels?: string[];
+  score?: number;
+}
+
+export interface AnalyzeUsageMetrics {
+  input_tokens?: number;
+  output_tokens?: number;
+  total_tokens?: number;
+  cost?: number;
+}
+
+export interface AnalyzeReceipt {
+  x402: X402AnalyzeReceiptEnvelope;
+  trace: AnalyzeTraceMetadata;
+  status: AnalyzeReceiptStatus;
+  result: AnalyzeResultPayload;
+  usage?: AnalyzeUsageMetrics;
+}
+
+export const analyzeReceiptValid1: AnalyzeReceipt = {
+  x402: {
+    verb: "analyze",
+    version: "1.0.0",
+    request_id: "req-analyze-2025-11-19-0001",
+    network: "mainnet"
+  },
+  trace: {
+    trace_id: "trace-analyze-0001",
+    started_at: "2025-11-19T20:30:00Z",
+    completed_at: "2025-11-19T20:30:01Z",
+    duration_ms: 950,
+    provider: "commandlayer-demo",
+    region: "us-east-1",
+    model: "analyze-large-001",
+    tags: ["analyze", "example", "v1.0.0"]
+  },
+  status: "success",
+  result: {
+    summary:
+      "The launch plan is sound but dependent on ecosystem awareness and clarity around ERC-8004/x402 alignment.",
+    insights: [
+      "Clarify messaging to standards authors.",
+      "Secure 2–3 ecosystem design partners pre-launch."
+    ],
+    labels: ["risk:medium", "ecosystem:critical"],
+    score: 0.78
+  },
+  usage: {
+    input_tokens: 1024,
+    output_tokens: 220,
+    total_tokens: 1244,
+    cost: 0.0037
+  }
+};

examples/v1.0.0/commons/analyze/ts/valid/analyze.receipt.valid.2.ts

@@ -0,0 +1,28 @@
+// VALID analyze.receipt #2 — same schema, different data
+
+import type { AnalyzeReceipt } from "./analyze.receipt.valid.1";
+
+export const analyzeReceiptValid2: AnalyzeReceipt = {
+  x402: {
+    verb: "analyze",
+    version: "1.0.0",
+    request_id: "req-analyze-2025-11-19-0003"
+  },
+  trace: {
+    trace_id: "trace-analyze-0003",
+    started_at: "2025-11-19T20:40:00Z",
+    completed_at: "2025-11-19T20:40:01Z",
+    duration_ms: 880,
+    provider: "commandlayer-demo",
+    region: "eu-west-1",
+    model: "analyze-medium-001",
+    tags: ["analyze", "example", "alt"]
+  },
+  status: "success",
+  result: {
+    summary:
+      "Analysis highlights minor documentation gaps and recommends clarifying schema ownership and versioning guarantees.",
+    insights: ["Clarify schema stewardship in README.", "Document versioning policy."],
+    labels: ["docs:improvable"]
+  }
+};

examples/v1.0.0/commons/analyze/ts/valid/analyze.request.valid.1.ts

@@ -0,0 +1,46 @@
+// VALID analyze.request #1 — aligned with analyze.request.schema.json (assumed)
+
+export interface X402AnalyzeRequestEnvelope {
+  verb: "analyze";
+  version: "1.0.0";
+  request_id?: string;
+  network?: string;
+  tenant?: string;
+}
+
+export interface AnalyzeLimits {
+  max_tokens?: number;
+  timeout_ms?: number;
+}
+
+export interface AnalyzeRequest {
+  x402: X402AnalyzeRequestEnvelope;
+  input: string;
+  goal?: string;
+  hints?: string[];
+  limits?: AnalyzeLimits;
+  metadata?: Record<string, unknown>;
+}
+
+export const analyzeRequestValid1: AnalyzeRequest = {
+  x402: {
+    verb: "analyze",
+    version: "1.0.0",
+    request_id: "req-analyze-2025-11-19-0001"
+  },
+  input:
+    "Review this plan and identify protocol, ecosystem, and execution risks for CommandLayer launch.",
+  goal: "Surface top 5 risks and unknowns.",
+  hints: [
+    "Focus on external ecosystem dependencies.",
+    "Call out assumptions about VC interest."
+  ],
+  limits: {
+    max_tokens: 512,
+    timeout_ms: 4000
+  },
+  metadata: {
+    project: "commandlayer",
+    verb_set: "commons"
+  }
+};

examples/v1.0.0/commons/analyze/ts/valid/analyze.request.valid.2.ts

@@ -0,0 +1,19 @@
+// VALID analyze.request #2 — same schema, different data
+
+import type { AnalyzeRequest } from "./analyze.request.valid.1";
+
+export const analyzeRequestValid2: AnalyzeRequest = {
+  x402: {
+    verb: "analyze",
+    version: "1.0.0",
+    request_id: "req-analyze-2025-11-19-0002",
+    network: "base"
+  },
+  input:
+    "Analyze this technical spec and highlight schema risks, ambiguous fields, and potential validation pitfalls.",
+  goal: "Find schema-level risks and incompatibilities.",
+  hints: ["Pay attention to allOf and additionalProperties usage."],
+  limits: {
+    max_tokens: 256
+  }
+};