feat(change-stories): add pup change-stories list command group

README.md

@@ -132,6 +132,7 @@ list of commands as built.
 | HAMR | ✅ | `hamr connections get`, `hamr connections create` | **New** — High Availability Multi-Region connections |
 | Investigations | ✅ | `investigations list`, `investigations get`, `investigations trigger` | Bits AI SRE investigation management |
 | Change Management | ✅ | `change-management create`, `change-management get`, `change-management update`, `change-management create-branch`, `change-management decisions` | Change request management with decisions and branching |
+| Change Stories | ✅ | `change-stories list` | Change events for a service (deployments, feature flags, config, k8s, watchdog) over a time window |
 | Incident Services/Teams | ✅ | `incidents services`, `incidents teams` | Service and team CRUD scoped to incident management |
 | Live Debugger | ✅ | `debugger probes list`, `debugger probes get`, `debugger probes create`, `debugger probes delete`, `debugger probes watch` | Remote log probe management for Live Debugger |
 | Software Catalog | ✅ | `software-catalog entities list`, `software-catalog entities upsert`, `software-catalog kinds list`, `software-catalog relations list` | Software Catalog entity and kind management (next-gen catalog) |

docs/COMMANDS.md

@@ -82,6 +82,7 @@ pup <domain> <subgroup> <action> [options] # Nested commands
 | workflows | get, create, update, delete, run, instances (list, get, cancel), connections (get, create, update, delete) | src/commands/workflows.rs | ✅ |
 | investigations | list, get, trigger | src/commands/investigations.rs | ✅ |
 | change-requests | create, get, update, create-branch, decisions (update, delete) | src/commands/change_management.rs | ✅ |
+| change-stories | list | src/commands/change_stories.rs | ✅ |
 | app-builder | list, get, create, update, delete, delete-batch, publish, unpublish | src/commands/app_builder.rs | ✅ |
 
 **Note:** RUM command is fully operational. Apps and sessions work completely. Metrics and retention-filters support list/get operations (create/update/delete operations pending due to complex API type structures).
@@ -192,6 +193,7 @@ pup infrastructure hosts list
 - **workflows** - Workflow Automation (get, create, update, delete, run, instances, connections)
 - **investigations** - Bits AI SRE investigations (list, get, trigger)
 - **change-requests** - Change request management (create, get, update, create-branch, decisions)
+- **change-stories** - Change events for a service (deployments, feature flags, config, k8s, watchdog) over time window
 
 ### Organization & Access
 - **users** - User management (list, get, roles)

docs/EXAMPLES.md

@@ -198,6 +198,40 @@ pup dbm samples search \
   --limit=25
 ```
 
+## Change Stories
+
+### List Change Stories for a Service
+```bash
+# All change events in the last hour (relative time)
+pup change-stories list --service api-gateway --from 1h --to now
+
+# All change events using an absolute window with unix timestamps
+pup change-stories list --service api-gateway --from 1713132000 --to 1713135600
+
+# Narrow to deployments in production using an absolute window
+pup change-stories list \
+  --service api-gateway --env prod \
+  --from 2024-01-15T00:00:00Z --to 2024-01-15T01:00:00Z \
+  --story-types deployment
+
+# Multiple story types
+pup change-stories list \
+  --service api-gateway \
+  --from 2024-01-15T00:00:00Z --to 2024-01-15T01:00:00Z \
+  --story-types deployment --story-types kubernetes
+
+# Region-scoped filter (--filter-tags is key:value)
+pup change-stories list \
+  --service api-gateway \
+  --from 2024-01-15T00:00:00Z --to 2024-01-15T01:00:00Z \
+  --filter-tags datacenter:us1.prod.dog
+
+# Trim response to ~4000 tokens (server default is 10000)
+pup change-stories list \
+  --service api-gateway --from 30min --to now \
+  --token-limit 4000
+```
+
 ## SLOs
 
 ### List SLOs