docs(skills): stop teaching deprecated LockContext.identify() (#591)

[coderdan]

Targets the 1.0 candidate. Closes the identity-docs half of #591 and supersedes the three stale skill-refresh PRs.

What

The stash-encryption + stash-supabase skills and the @cipherstash/stack README taught the deprecated LockContext.identify() as the primary identity-aware-encryption path. identify() fetches a per-operation CTS token that was removed in protect-ffi 0.25 and is no longer used by encryption. These ship to customers (skills via the stash tarball; README with the package), so it's wrong guidance at launch.

Now they lead with the current pattern — authenticate with OidcFederationStrategy, then .withLockContext({ identityClaim }) per operation — and demote identify() to a clearly-marked deprecated note.

Why not just merge #598 / #604 / #606

Those skill-refresh PRs predate both the adapter split (they still reference @cipherstash/stack/{supabase,drizzle}, 0 references to the new @cipherstash/stack-* packages) and the contains()→matches() rename (0 matches(). Each is a ~400-line near-total rewrite, so merging/rebasing would regress the package paths and the matches() surface. The current candidate skills are the source of truth for structure/paths/matches; the only RC-critical content those PRs held was the identity-docs correction (which #598 nailed), carried forward here.

I'm closing #598 / #604 / #606 as superseded.

Scope notes

• packages/protect/README.md still references identify() but is the legacy package — left as a follow-up, not RC-critical.
• docs(stack): refresh the stash-encryption skill; fix the identity-aware auth docs and a vacuously-passing test #598 also carried a source/test fix: the encryption/index.ts authStrategy change is already on the candidate; the "vacuously-passing" unit lock-context.test.ts is now superseded by test(stack): federate a Clerk M2M JWT for the identity suites; wire into CI #620's real matrix-identity integration coverage — the leftover redundant unit test is a hygiene item for Extend no-skip enforcement to the unit vitest config #628 (unit no-skip gate).
• docs(drizzle): refresh the stash-drizzle skill; correct the eq/ne index contract #604's "eq/ne index contract" and docs(supabase): correct the stash-supabase skill #606's general corrections didn't isolate to a clear RC-critical factual delta against the current (post-feat(stack)!: rename EQL v3 encrypted contains() → matches() (#617) #640/split) skills; not carried forward.

Changesets: stash patch (skills) + @cipherstash/stack patch (README).

Refs #591

https://claude.ai/code/session_01MxTTPaPP16m6br7Hoab94w

[changeset-bot]

🦋 Changeset detected

Latest commit: 40ab142

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 10 packages

Name	Type
stash	Patch
@cipherstash/stack	Patch
@cipherstash/basic-example	Patch
@cipherstash/e2e	Patch
@cipherstash/bench	Patch
@cipherstash/prisma-next	Patch
@cipherstash/stack-drizzle	Patch
@cipherstash/stack-supabase	Patch
@cipherstash/test-kit	Patch
@cipherstash/prisma-next-example	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f68e1d6a-0d3d-4e1f-b88a-ff4f43e7e140

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/skills-identity-and-corrections-refresh

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}