Skip to content

fix(skills): drop first-class "default API key" framing (0.6.2)#24

Merged
caballeto merged 1 commit into
mainfrom
fix/api-key-default-framing
May 1, 2026
Merged

fix(skills): drop first-class "default API key" framing (0.6.2)#24
caballeto merged 1 commit into
mainfrom
fix/api-key-default-framing

Conversation

@caballeto
Copy link
Copy Markdown
Member

Summary

Strips the "permanent default API key" framing from the devhelm-manage skill docs. The mono API reverted is_default after a design review (devhelmhq/mono#330) — the starter key minted during onboarding is an ordinary key named "Default" with no special backend treatment. It can be renamed, revoked, deleted, and rotated like any other key.

Also corrects the prose around key visibility: the API returns the full key value on every read (list, get, create, regenerate). The skill was claiming last-4-only masking, which doesn't match the platform.

Changes

  • skills/devhelm-manage/SKILL.md — reframe starter key section; update sensitivity rule (treat as sensitive in output, don't promise masked reads).
  • skills/devhelm-manage/references/api-keys.md — remove "default key is permanent/non-deletable" claims; update create/list JSON examples; note rotation via both new-key-then-revoke and regenerate patterns.
  • skills/devhelm-manage/references/workspaces.md — clarify tokens are per-org, not per-workspace.
  • Bump to 0.6.2.

Test plan

  • npm run build — clean.
  • npm run lint — clean.
  • npm run typecheck — clean.
  • npm test — 893 passing.

Ready for the usual release flow: merge → integration tests → manual npm publish approval.

Made with Cursor

The monorepo backend never shipped is_default as a first-class concept
(it was reverted in mono#330 after a design review), and the API
returns the full key value on every read by design. The skill prose
here had leaked both assumptions — correct them so the agent doesn't
promise behavior the platform doesn't provide.

- The "Default" key is just a name — created during onboarding for UX
  but ordinary on every other axis (deletable, renameable, no flag).
- API key values are visible on every read. Treat them as sensitive
  in agent output (no commits, no logs) but don't claim last-4-only
  masking.
- workspaces.md: API tokens are per-org, not per-workspace.

Co-authored-by: Cursor <cursoragent@cursor.com>
@caballeto caballeto merged commit 7d56ef4 into main May 1, 2026
3 checks passed
@caballeto caballeto deleted the fix/api-key-default-framing branch May 1, 2026 16:04
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.

1 participant