docs: commit all Phase 6 documentation updates and OpenSpec archives

- devops docs: 8 files updated for Phase 6 state; field-trial.md added (946-line runbook)
- developer docs: api-reference (50+ endpoints), quick-start, 5 existing guides updated, 5 new guides added
- engineering docs: all 12 files updated (services, architecture, SDK guide, testing, overview)
- OpenSpec archives: phase-7-devops-field-trial, developer-docs-phase6-update, engineering-docs-phase6-update
- VALIDATOR.md + scripts/start-validator.sh: V&V Architect tooling added
- .gitignore: exclude session artifacts, build artifacts, and agent workspaces

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
SentryAgent.ai Developer
2026-04-07 02:24:24 +00:00
parent 0fb00256b4
commit 8cabc0191c
56 changed files with 12780 additions and 446 deletions

View File

@@ -0,0 +1,77 @@
# WS5 Spec — README.md
## Target file
`docs/developers/README.md`
## Objective
Two surgical edits to the existing file:
1. Fix the "bedroom developers" typo in line 3.
2. Expand the Guides table to list all 9 guides (4 existing + 5 new).
---
## Edit 1 — Fix typo in the opening paragraph
**Location**: Line 3 of the file (the subtitle/description line).
**Find** (exact text):
```
The complete documentation for bedroom developers building with SentryAgent.ai AgentIdP.
```
**Replace with**:
```
The complete documentation for developers building with SentryAgent.ai AgentIdP.
```
No other changes to this paragraph.
---
## Edit 2 — Expand the Guides table
**Find** (the entire Guides section, from heading to end of table):
```markdown
## Guides
| Guide | What it covers |
|-------|----------------|
| [Register an Agent](guides/register-an-agent.md) | All fields, validation rules, common errors |
| [Manage Credentials](guides/manage-credentials.md) | Generate, list, rotate, revoke credentials |
| [Issue and Revoke Tokens](guides/issue-and-revoke-tokens.md) | OAuth 2.0 client credentials flow, introspect, revoke |
| [Query Audit Logs](guides/query-audit-logs.md) | Filters, pagination, event structure, retention |
```
**Replace with**:
```markdown
## Guides
| Guide | What it covers |
|-------|----------------|
| [Register an Agent](guides/register-an-agent.md) | All fields, org scoping, validation rules, common errors |
| [Manage Credentials](guides/manage-credentials.md) | Generate, list, rotate, revoke credentials |
| [Issue and Revoke Tokens](guides/issue-and-revoke-tokens.md) | OAuth 2.0 client credentials flow, introspect, revoke |
| [Query Audit Logs](guides/query-audit-logs.md) | Filters, pagination, event structure, retention |
| [Use the Analytics Dashboard](guides/use-analytics-dashboard.md) | Query token trends, activity heatmap, per-agent usage |
| [Manage API Tiers](guides/manage-api-tiers.md) | Check current tier, understand limits, trigger upgrade |
| [A2A Delegation](guides/a2a-delegation.md) | Create and verify agent-to-agent delegation chains |
| [Configure Webhooks](guides/configure-webhooks.md) | Subscribe to events, delivery guarantees, inspect history |
| [AGNTCY Compliance](guides/agntcy-compliance.md) | Export agent cards, generate compliance reports, verify audit chain |
```
---
## Verification checklist
After both edits:
- Line 3 must read: `The complete documentation for developers building with SentryAgent.ai AgentIdP.`
- The Documents table (the first table in the file, listing Quick Start / Core Concepts / Guides / API Reference) is unchanged.
- The Guides table has exactly 9 rows.
- All guide filenames match exactly the files that WS4 will create:
- `guides/use-analytics-dashboard.md`
- `guides/manage-api-tiers.md`
- `guides/a2a-delegation.md`
- `guides/configure-webhooks.md`
- `guides/agntcy-compliance.md`
- The Free Tier Limits table at the bottom of the file is unchanged.
- The Base URL section is unchanged.