@prism-d1/cli 1.0.79 → 1.0.81

package/dist/src/commands/workshop/generate-demo-data.d.ts

@@ -1,15 +1,54 @@
+/**
+ * PRISM D1 — workshop demo data generator.
+ *
+ * The dashboards read TWO stores, and a generator that fills only one leaves
+ * roughly half of every view blank:
+ *
+ *   EventBridge → metrics-processor → events table + CloudWatch
+ *     Delivery KPIs, eval gates, governance, agent ops, security, most of CISO.
+ *
+ *   AI-usage table (attribution) → otel-receiver GET routes
+ *     AI share, merge rate, defect rate, $/shipped commit, Attribution
+ *     Coverage, Repository Breakdown, the observed PRISM level, and the whole
+ *     Developer Productivity dashboard.
+ *
+ * Attribution is written directly to DynamoDB rather than POSTed to
+ * /v1/traces because the receiver derives the owning developer from the
+ * caller's JWT claim. Every seeded commit would land under the single
+ * participant running this command, and a one-developer fleet cannot
+ * demonstrate the per-developer view or a coverage shortfall. Direct writes
+ * are the only way to seed a multi-developer fleet.
+ *
+ * The cost of that choice is schema coupling. Item shapes below must match
+ * infra/lib/lambda/otel-receiver.ts — specifically writeCommitAttribution,
+ * writeSpanIfNew and bumpDailyAggregate. If those change, this changes too.
+ *
+ * Guardrails, because this writes fabricated facts into a metrics store:
+ *   - every seeded item carries demo_seed=true and a seed_run_id
+ *   - seeding refuses to run when the table already holds real attribution,
+ *     unless --force is passed
+ *   - --purge-demo removes seeded items and leaves real ones alone
+ */
 declare const _default: {
     description: string;
-    options: {
+    options: ({
         flags: string;
         description: string;
         default: string;
-    }[];
+    } | {
+        flags: string;
+        description: string;
+        default?: undefined;
+    })[];
     action(options: {
         region: string;
         bus: string;
         team: string;
         repo: string;
+        table: string;
+        attribution: boolean;
+        purgeDemo?: boolean;
+        force?: boolean;
     }): void;
 };
 export default _default;

package/dist/src/commands/workshop/generate-demo-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-demo-data.d.ts","sourceRoot":"","sources":["../../../../src/commands/workshop/generate-demo-data.ts"],"names":[],"mappings":";;;;;;;oBA+CkB;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;;AAR7E,wBA8VE"}
+{"version":3,"file":"generate-demo-data.d.ts","sourceRoot":"","sources":["../../../../src/commands/workshop/generate-demo-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;;;;;;;;;;;;oBA+Ie;QACd,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;;AArBH,wBAqeE"}