docs(quick-260521-a01): API spec update — new section check, player-id, webinar-design-id

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: Steffen Fagerström Christensen

.planning/STATE.md

@@ -28,7 +28,7 @@ See: .planning/PROJECT.md (updated 2026-04-23)
 Phase: 24 — COMPLETE
 Plan: 1/1 complete
 Status: Milestone v1.5 complete — all phases done
-Last activity: 2026-05-13 - Completed quick task 260513-a06: Review command documentation and make sure commands listed in the root README reflect available commands
+Last activity: 2026-05-21 - Completed quick task 260521-a01: Review updated API spec and add new options/features to CLI and skill
 
 Progress: [██████████] 100%
 
@@ -122,6 +122,7 @@ None — v1.5 milestone complete.
 | 260508-dnq | Release v1.3.3: docs, skill update, version bump, and tags | 2026-05-08 | 7d682c2 | [260508-dnq-release-v1-3-3-docs-skill-update-version](./quick/260508-dnq-release-v1-3-3-docs-skill-update-version/) |
 | 260513-aab | Add seo get/status/update commands, update SKILL.md, release v1.3.4 | 2026-05-13 | 1038e93 | [260513-aab-api-spec-update-seo-commands-release-v1-3-4](./quick/260513-aab-api-spec-update-seo-commands-release-v1-3-4/) |
 | 260513-a06 | Review command documentation and make sure commands listed in the root README reflect available commands | 2026-05-13 | 35e4eda | [260513-a06-readme-commands-sync](./quick/260513-a06-readme-commands-sync/) |
+| 260521-a01 | Review updated API spec and add new options/features to CLI and skill | 2026-05-21 | fadb563 | [260521-a01-api-spec-review-add-new-options](./quick/260521-a01-api-spec-review-add-new-options/) |
 
 ## Session Continuity
 

.planning/quick/260521-a01-api-spec-review-add-new-options/260521-a01-PLAN.md

@@ -0,0 +1,68 @@
+---
+quick_id: 260521-a01
+slug: api-spec-review-add-new-options
+description: Review updated API spec and add new options/features to CLI and skill
+date: 2026-05-21
+status: in-progress
+---
+
+# Quick Task 260521-a01: API Spec Update — New Options and Features
+
+## Summary of Changes
+
+Diff between latest live API spec and committed spec reveals:
+
+1. **NEW ENDPOINT**: `POST /photo/section/check-generate-available` — checks if AI chapter generation is available for a video
+2. **NEW PARAM**: `player_id` (integer) on `POST /app/add` — "Add a contextual player being forked"
+3. **NEW PARAM**: `webinar_design_id` (integer) on `POST /live/create`, `POST /live/update`, `POST /live/repeat` — "Assign a webinar design by id to this webinar"
+
+## Tasks
+
+### Task 1: Update spec file and regenerate types
+
+- **files**: `packages/twentythree-cli/specs/twentythree-api-swagger.json`, `packages/twentythree-cli/src/api/types.ts`
+- **action**: Copy downloaded spec and regenerate types via `pnpm generate-types`
+- **verify**: Types file updated with new endpoint + parameters
+- **done**: [ ]
+
+### Task 2: Add `player-id` flag to `app add`
+
+- **files**: `packages/twentythree-cli/src/commands/app/add.ts`
+- **action**: Add optional `--player-id` integer flag mapping to `player_id` body param
+- **verify**: Flag present, sent in body when provided
+- **done**: [ ]
+
+### Task 3: Add `webinar-design-id` to webinar create/update/repeat
+
+- **files**:
+  - `packages/twentythree-cli/src/commands/webinar/create.ts`
+  - `packages/twentythree-cli/src/commands/webinar/update.ts`
+  - `packages/twentythree-cli/src/commands/webinar/repeat.ts`
+- **action**: Add optional `--webinar-design-id` integer flag to each; send as `webinar_design_id` in body (flag mode only for update)
+- **verify**: Flag present in each command, correctly mapped in body
+- **done**: [ ]
+
+### Task 4: Add `video section check-generate-available` command
+
+- **files**: `packages/twentythree-cli/src/commands/video/section/check-generate-available.ts`
+- **action**: Create new command that POSTs to `/photo/section/check-generate-available` with `photo_id` (required) and optional `fields`; outputs `section_generation_available_p` boolean
+- **verify**: Command file created, manifest updated after build
+- **done**: [ ]
+
+### Task 5: Update skill documentation
+
+- **files**:
+  - `packages/twentythree-skills/.cursor/skills/twentythree/reference/video.md`
+  - `packages/twentythree-skills/.cursor/skills/twentythree/reference/webinar.md`
+- **action**:
+  - Add `video section check-generate-available` command section after `video section generate`
+  - Add `--webinar-design-id` flag to webinar create, update, and repeat sections
+- **verify**: Both files updated with accurate documentation
+- **done**: [ ]
+
+### Task 6: TypeScript check
+
+- **files**: N/A
+- **action**: Run `pnpm --filter twentythree-cli exec tsc --noEmit` to confirm no new type errors
+- **verify**: Clean compile (ignoring pre-existing errors)
+- **done**: [ ]

.planning/quick/260521-a01-api-spec-review-add-new-options/260521-a01-SUMMARY.md

@@ -0,0 +1,43 @@
+---
+quick_id: 260521-a01
+slug: api-spec-review-add-new-options
+status: complete
+date: 2026-05-21
+---
+
+# Quick Task 260521-a01: API Spec Update Summary
+
+## What changed
+
+Downloaded latest TwentyThree API spec and compared against committed version. Four sets of changes found and implemented.
+
+## Changes made
+
+### New endpoint: `video section check-generate-available`
+- New command file: `src/commands/video/section/check-generate-available.ts`
+- POSTs to `/photo/section/check-generate-available`
+- Accepts video ID (positional) + optional `--fields`
+- Outputs whether AI chapter generation is available (`section_generation_available_p`)
+- Useful as a pre-check before calling `video section generate`
+
+### New flag: `--player-id` on `app add`
+- Adds optional `--player-id` integer flag to `src/commands/app/add.ts`
+- Maps to `player_id` body param: "Add a contextual player being forked"
+
+### New flag: `--webinar-design-id` on webinar create/update/repeat
+- Added to `src/commands/webinar/create.ts`, `update.ts`, `repeat.ts`
+- Maps to `webinar_design_id` body param: "Assign a webinar design by id to this webinar"
+- In `update.ts`: flag mode only (consistent with `--seo-policy` pattern)
+
+### Spec + types regenerated
+- Updated `specs/twentythree-api-swagger.json` to latest live spec
+- Regenerated `src/api/types.ts` via `pnpm generate-types`
+- Manifest regenerated via `pnpm build` (oclif manifest runs postbuild)
+
+### Skill documentation updated
+- `reference/video.md`: Added `video section check-generate-available` section after `video section generate`
+- `reference/webinar.md`: Added `--webinar-design-id` row to create, update, and repeat flag tables
+
+## Verification
+- TypeScript: clean compile (`tsc --noEmit` no errors)
+- Tests: 167 passed, 0 failed