continuous-improvement 3.17.0 → 3.18.0

package/templates/portfolio_event.schema.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/naimkatiman/continuous-improvement/main/templates/portfolio_event.schema.json",
+  "title": "PortfolioEvent",
+  "description": "Shared event schema for all repos in the portfolio. Every CI run, deploy, incident, experiment, agent action, security finding, release, decision, and metric snapshot is one event.",
+  "type": "object",
+  "required": ["eventId", "repo", "eventType", "occurredAt", "source"],
+  "additionalProperties": false,
+  "properties": {
+    "eventId": {
+      "type": "string",
+      "description": "Globally unique id (uuid or <repo>-<timestamp>-<n>)."
+    },
+    "repo": {
+      "type": "string",
+      "description": "GitHub repo in owner/name form, e.g. naimkatiman/tradeclaw."
+    },
+    "eventType": {
+      "type": "string",
+      "enum": ["ci", "deploy", "incident", "experiment", "agent", "security", "release", "decision", "metric"]
+    },
+    "occurredAt": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 UTC timestamp."
+    },
+    "source": {
+      "type": "string",
+      "description": "What emitted the event: github-actions, wrangler, manual, agent:<name>, cron:<name>."
+    },
+    "actor": {
+      "type": "string",
+      "description": "Human or agent responsible, e.g. naimkatiman or agent:portfolio-health."
+    },
+    "status": {
+      "type": "string",
+      "enum": ["success", "failure", "in_progress", "cancelled", "n/a"],
+      "description": "Outcome where applicable."
+    },
+    "severity": {
+      "type": "string",
+      "enum": ["info", "low", "medium", "high", "critical"],
+      "description": "Required in practice for incident and security events."
+    },
+    "title": {
+      "type": "string",
+      "description": "One-line human-readable summary."
+    },
+    "evidenceUrl": {
+      "type": "string",
+      "description": "Link to the receipt: CI run, release receipt file, experiment file, dashboard."
+    },
+    "commitSha": {
+      "type": "string"
+    },
+    "metricName": {
+      "type": "string",
+      "description": "For metric events: stable snake_case metric name."
+    },
+    "metricValue": {
+      "type": "number",
+      "description": "For metric events: numeric value."
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Event-type-specific payload. Keep flat and JSON-serializable."
+    }
+  }
+}

package/templates/release_receipt_template.md

@@ -0,0 +1,37 @@
+# Release Receipt
+
+> One receipt per release/deploy. Copy this file to `.releases/<YYYY-MM-DD>-<version-or-slug>.md`, fill every field, commit it with the release. A release without a receipt did not happen.
+
+## Identity
+
+| Field | Value |
+|---|---|
+| Repo | |
+| Version / tag | |
+| Commit SHA | |
+| Environment | production / staging / preview |
+| Released at (UTC) | |
+| Owner | |
+
+## What shipped
+
+- User-visible impact (one sentence, outcome not mechanism):
+- Feature flags changed (name, old value, new value):
+- Migrations run (file names, or "none"):
+
+## Verification
+
+- Tests run (exact commands + result):
+- Security scans run (tool + result, or "none"):
+- Manual verification performed:
+
+## Risk
+
+- Known risks accepted at release time:
+- Rollback command (exact, copy-pasteable):
+- Monitoring link (dashboard/logs to watch after release):
+
+## Sign-off
+
+- [ ] All fields above are filled (no blanks — use "none" explicitly)
+- [ ] Rollback command was verified to exist (not just guessed)