Skip to content

Add LLM-focused developer commands - #43

Open
erikdubbelboer wants to merge 32 commits into
mainfrom
add-llm-focused-commands
Open

erikdubbelboer wants to merge 32 commits into
mainfrom
add-llm-focused-commands

Conversation

@erikdubbelboer

Copy link
Copy Markdown
Member

Expand the CLI with structured commands for games, versions, playtests, analytics, and related developer workflows. Add machine-readable help, safer API handling, release tooling, and comprehensive tests while preserving legacy compatibility.

Comment thread .github/workflows/ci.yml Fixed
@erikdubbelboer
erikdubbelboer force-pushed the add-llm-focused-commands branch 2 times, most recently from 43b94c8 to 94783d2 Compare August 17, 2026 20:42
Comment thread scripts/verify-package.mjs Dismissed
@erikdubbelboer
erikdubbelboer force-pushed the add-llm-focused-commands branch 3 times, most recently from 33f83d9 to af0ac06 Compare August 23, 2026 10:51
@erikdubbelboer
erikdubbelboer force-pushed the add-llm-focused-commands branch from c67b63d to 1a0b8b1 Compare September 1, 2026 07:18
Expand the CLI with structured commands for games, versions,
playtests, analytics, and related developer workflows. Add
machine-readable help, safer API handling, release tooling,
and comprehensive tests while preserving legacy compatibility.
- Don't fail if we can't persist the new access token after refresh.
  Just use it for this single invocation.
- Improve documentation and LLM understanding around `poki auth login`.
Automatically look up source refresh timestamps for structured analytics
queries and attach matching developer event descriptions when game scope
and event identity are unambiguous. Preserve query results when metadata
lookups fail and report non-blocking warnings.

Clarify that result completeness does not establish ingestion completeness
and current descriptions do not verify historical behavior. Include
descriptions in default event listings and correct the lifecycle completion
example to use an empty label and completion counters.
```
% poki media-kit
notice:
  code: MISSING_ACTION
  message: No action supplied for poki media-kit; showing group help.
command: poki media-kit
usage: "poki media-kit <action> [options]"
summary: Manage Media Kit assets.
behavior[3	]: Use types for current upload requirements. Older orientation-specific assets remain readable, downloadable, and deletable.	Processing status is uploading, ready, or error. Upload acceptance does not mean storage processing has finished.	Normalized asset_type is the backend attributes.type category; normalized type remains marketing_assets. Raw output preserves the backend document.
commands[10	]{path	summary}:
  poki media-kit types	Describe current upload types, enforced requirements, and frontend recommendations.
  poki media-kit list	List all Media Kit assets for a game.
  poki media-kit get	Inspect an asset, optionally waiting for completion.
  poki media-kit upload	Upload one or more files of one current asset type.
  poki media-kit delete	Permanently delete an asset and its stored file.
  poki media-kit preview-url	Return an absolute signed preview URL.
  poki media-kit download-url	Return an absolute signed download URL.
  poki media-kit download	Stream an asset or ZIP to a local file.
  poki media-kit fields	List the offline Media Kit asset field index.
  poki media-kit field	Return one complete Media Kit asset field definition.
help:
  command: poki help <group> <action>
  manifest: poki help --all
  search: poki help --search TEXT
  permissions: poki help permissions
  formats: poki help formats
  shapes: poki help shapes
  workflows: poki help workflows
```
We always want this to be a manual action in P4D.
- Add --test-version and repeatable --device-category options, defaulting to v2.
- Validate device selections against the chosen methodology.
- Create tests with a fixed target_count of 500 gameplays or pageviews.
- Update result summaries and discovery docs for quotas, progress, and metrics.
- Cover methodology defaults and device selections in command tests.
Add poki realtime users, errors, and c2p for live user estimates,
version error counts, and pageview conversion metrics.

Route requests through the realtime service using saved OAuth
credentials. Include structured help, permission metadata,
production and acceptance URLs, and mocked tests.
@erikdubbelboer
erikdubbelboer force-pushed the add-llm-focused-commands branch from f0027fd to 186968a Compare October 6, 2026 15:37
@erikdubbelboer
erikdubbelboer force-pushed the add-llm-focused-commands branch from 9acb7c9 to a3ab9d5 Compare October 7, 2026 02:05
Fix C2P response handling and recording states. Update readiness checks for game approval, release status and archived games.

Add archive and favorite settings, store URL changes and thumbnail updates from AB test winners. Expose planned release metadata and Dialog usage, and update funnel defaults and eligibility docs.

Add regression tests for the updated API contracts.
# Conflicts:
#	.github/workflows/lint.yml
Add game and thumbnail A/B test lifecycles and Web Fit requests, with explicit permission requirements in command help.

Fix Player Fit payloads, restrict immutable event fields, align list capabilities, and tighten analytics query validation. Delegate content validation and event normalization to the backend while retaining request-shape and storage guards.

Update resource documentation and regression coverage. Validated with 500 passing tests, lint, typecheck, and build.
Add categories list using the authenticated /categories endpoint and point
category discovery guidance to current API titles. Keep the bundled audience
snapshot for test-targeting eligibility, which the endpoint does not expose.

Explain content-moderation-required errors and include moderation blockers
in game readiness for activation, Playtests, and Player Fit. Preserve the
approved-game exemption and document that ordinary uploads remain available.

Add regression coverage and require commit message lines to stay within
80 characters in AGENTS.md.

Implements the API contracts proposed in mothership PRs #6141 and #6142.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants