feat(docs): auto-generate driftable documentation sections

.github/workflows/ci.yml

@@ -43,8 +43,11 @@ jobs:
               - 'src/**'
               - 'docs/**'
               - 'package.json'
+              - 'README.md'
+              - 'DEVELOPMENT.md'
               - 'script/generate-skill.ts'
               - 'script/generate-command-docs.ts'
+              - 'script/generate-docs-sections.ts'
               - 'script/eval-skill.ts'
               - 'test/skill-eval/**'
             code:
@@ -130,17 +133,26 @@ jobs:
             echo "stale=true" >> "$GITHUB_OUTPUT"
             echo "Skill files are out of date"
           fi
-      - name: Auto-commit regenerated skill files
-        if: steps.check-skill.outputs.stale == 'true' && steps.token.outcome == 'success'
+      - name: Check docs sections
+        id: check-sections
+        run: |
+          if git diff --quiet DEVELOPMENT.md docs/src/content/docs/contributing.md docs/src/content/docs/self-hosted.md; then
+            echo "Docs sections are up to date"
+          else
+            echo "stale=true" >> "$GITHUB_OUTPUT"
+            echo "Docs sections are out of date"
+          fi
+      - name: Auto-commit regenerated files
+        if: (steps.check-skill.outputs.stale == 'true' || steps.check-sections.outputs.stale == 'true') && steps.token.outcome == 'success'
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add plugins/sentry-cli/skills/sentry-cli/
-          git diff --cached --quiet || (git commit -m "chore: regenerate skill files" && git push)
-      - name: Fail for fork PRs with stale skill files
-        if: steps.check-skill.outputs.stale == 'true' && steps.token.outcome != 'success'
+          git add plugins/sentry-cli/skills/sentry-cli/ DEVELOPMENT.md docs/src/content/docs/contributing.md docs/src/content/docs/self-hosted.md
+          git diff --cached --quiet || (git commit -m "chore: regenerate docs" && git push)
+      - name: Fail for fork PRs with stale generated files
+        if: (steps.check-skill.outputs.stale == 'true' || steps.check-sections.outputs.stale == 'true') && steps.token.outcome != 'success'
         run: |
-          echo "::error::Skill files are out of date. Run 'bun run generate:docs' locally and commit the result."
+          echo "::error::Generated files are out of date. Run 'bun run generate:docs' locally and commit the result."
           exit 1
 
   lint:

.gitignore

@@ -58,8 +58,9 @@ src/generated/
 src/sdk.generated.ts
 src/sdk.generated.d.cts
 
-# Generated command docs (rebuilt from fragments + CLI introspection)
+# Generated docs pages (rebuilt from fragments + CLI introspection / env registry)
 docs/src/content/docs/commands/
+docs/src/content/docs/configuration.md
 
 # Generated discovery manifest (rebuilt by generate:skill, served via symlinked skill files)
 docs/public/.well-known/skills/index.json

DEVELOPMENT.md

@@ -59,11 +59,13 @@ When creating your Sentry OAuth application:
 
 - **Redirect URI**: Not required for device flow
 - **Scopes**: The CLI requests these scopes:
+<!-- GENERATED:START oauth-scopes -->
   - `project:read`, `project:write`, `project:admin`
   - `org:read`
   - `event:read`, `event:write`
   - `member:read`
-  - `team:read`
+  - `team:read`, `team:write`
+<!-- GENERATED:END oauth-scopes -->
 
 ## Environment Variables
 

README.md

@@ -68,24 +68,7 @@ sentry issue plan PROJ-ABC
 
 ## Commands
 
-| Command | Description |
-|---------|-------------|
-| `sentry auth` | Login, logout, check authentication status |
-| `sentry org` | List and view organizations |
-| `sentry project` | List, view, create, and delete projects |
-| `sentry issue` | List, view, explain, and plan issues |
-| `sentry event` | View event details |
-| `sentry trace` | List and view distributed traces |
-| `sentry span` | List and view spans |
-| `sentry log` | List and view logs (with streaming) |
-| `sentry dashboard` | List, view, and create dashboards with widgets |
-| `sentry sourcemap` | Inject debug IDs and upload sourcemaps |
-| `sentry init` | Initialize Sentry in your project |
-| `sentry schema` | Browse the Sentry API schema |
-| `sentry api` | Make direct API requests |
-| `sentry cli` | Upgrade, setup, fix, and send feedback |
-
-For detailed documentation, visit [cli.sentry.dev](https://cli.sentry.dev).
+Run `sentry --help` to see all available commands, or browse the [command reference](https://cli.sentry.dev/commands/).
 
 ## Configuration