Skip to content

chore(skills): Intent naming — persist / persist-* / <fw>-persist#39

Merged
SutuSebastian merged 10 commits into
mainfrom
chore/intent-skills-domain-tree
Jul 23, 2026
Merged

chore(skills): Intent naming — persist / persist-* / <fw>-persist#39
SutuSebastian merged 10 commits into
mainfrom
chore/intent-skills-domain-tree

Conversation

@SutuSebastian

@SutuSebastian SutuSebastian commented Jul 22, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Core: persist
  • Sources / codecs / backends / transport: persist-<name>
  • Frameworks: <framework>-persist
  • Covers every public ./sources/*, ./codecs/*, ./backends/*, ./transport/*, and ./frameworks/* entry

Test plan

  • bun run intent:validate
  • npm pack --dry-run ships SKILL.md; excludes _artifacts
  • CI check-skills green

Composition naming avoids clashing with upstream library skill leaves;
ship persist-zustand as the next source tracer and record the rest in
skills/_artifacts/skill_tree.yaml.
@changeset-bot

changeset-bot Bot commented Jul 22, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: a137334

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

This PR includes changesets to release 1 package
Name Type
@stainless-code/persist 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

coderabbitai Bot commented Jul 22, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@SutuSebastian, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 37 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 3ffff8f5-f1b0-4de2-bec9-137c7c97f7d0

📥 Commits

Reviewing files that changed from the base of the PR and between ebb529d and a137334.

📒 Files selected for processing (31)
  • .changeset/intent-skills-rename.md
  • .github/workflows/check-skills.yml
  • package.json
  • scripts/sync-skill-versions.ts
  • skills/alpine-persist/SKILL.md
  • skills/angular-persist/SKILL.md
  • skills/lit-persist/SKILL.md
  • skills/persist-async-storage/SKILL.md
  • skills/persist-compressed/SKILL.md
  • skills/persist-crosstab/SKILL.md
  • skills/persist-encrypted/SKILL.md
  • skills/persist-idb/SKILL.md
  • skills/persist-jotai/SKILL.md
  • skills/persist-mmkv/SKILL.md
  • skills/persist-mobx/SKILL.md
  • skills/persist-node-fs/SKILL.md
  • skills/persist-pinia/SKILL.md
  • skills/persist-redux/SKILL.md
  • skills/persist-secure-store/SKILL.md
  • skills/persist-seroval/SKILL.md
  • skills/persist-standard-schema/SKILL.md
  • skills/persist-tanstack-store/SKILL.md
  • skills/persist-valtio/SKILL.md
  • skills/persist-zustand/SKILL.md
  • skills/persist/SKILL.md
  • skills/preact-persist/SKILL.md
  • skills/react-persist/SKILL.md
  • skills/solid-persist/SKILL.md
  • skills/svelte-persist/SKILL.md
  • skills/svelte-store-persist/SKILL.md
  • skills/vue-persist/SKILL.md
📝 Walkthrough

Walkthrough

Changes

Intent skill expansion

Layer / File(s) Summary
Skill catalog and recursive version tooling
skills/_artifacts/skill_tree.yaml, scripts/sync-skill-versions.ts
Adds persistence skill metadata and recursively stamps versions into nested SKILL.md files while excluding _artifacts.
Persistence skill documentation
skills/persist-tanstack-store/SKILL.md, skills/persist-zustand/SKILL.md
Renames and refines the TanStack Store skill and adds Zustand adapter guidance covering setup, hydration, storage, teardown, mistakes, and API usage.
Release and Intent CI metadata
.changeset/intent-skills-rename.md, .github/workflows/check-skills.yml, package.json
Adds a patch changeset, upgrades the Intent CLI in validation and review jobs, and adds the tanstack-intent keyword.

Estimated code review effort: 2 (Simple) | ~15 minutes

Possibly related PRs

  • stainless-code/persist#2: Established the TanStack Intent packaging, CI workflow, and TanStack Store skill documentation that this change updates.

Suggested labels: docs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately captures the skill renaming and new persist-* naming convention.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/intent-skills-domain-tree

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

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
.github/workflows/check-skills.yml (1)

40-40: 🔒 Security & Privacy | 🔵 Trivial | ⚡ Quick win

Invoke the locked Intent dependency in CI.

Both jobs install the exact direct version globally, but its transitive dependency tree is resolved outside the repository’s lockfile. Prefer invoking the repository-pinned CLI through a lockfile-based install, using the same approach in both jobs.

Also applies to: 64-64

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In @.github/workflows/check-skills.yml at line 40, Update both jobs in the
workflow to install dependencies through the repository’s lockfile and invoke
the pinned `@tanstack/intent` CLI from that installation instead of globally
installing the direct version. Use the same lockfile-based approach for both
command steps, preserving the configured Intent version from the repository
dependency declarations.

Source: Linters/SAST tools

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Nitpick comments:
In @.github/workflows/check-skills.yml:
- Line 40: Update both jobs in the workflow to install dependencies through the
repository’s lockfile and invoke the pinned `@tanstack/intent` CLI from that
installation instead of globally installing the direct version. Use the same
lockfile-based approach for both command steps, preserving the configured Intent
version from the repository dependency declarations.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 659558e0-d3b9-46c6-aaaf-4cab13e54d41

📥 Commits

Reviewing files that changed from the base of the PR and between 0dac2e0 and ebb529d.

📒 Files selected for processing (7)
  • .changeset/intent-skills-rename.md
  • .github/workflows/check-skills.yml
  • package.json
  • scripts/sync-skill-versions.ts
  • skills/_artifacts/skill_tree.yaml
  • skills/persist-tanstack-store/SKILL.md
  • skills/persist-zustand/SKILL.md

Add persist-core (required by framework skills), jotai/valtio/mobx/pinia/redux
composition leaves, and persist-react useHydrated. Remaining frameworks stay
planned in skills/_artifacts/skill_tree.yaml.
@SutuSebastian SutuSebastian changed the title chore(skills): persist-* Intent leaves + zustand chore(skills): persist-* Intent skills for sources + react Jul 23, 2026
Cover preact, vue, solid, angular, lit, alpine, svelte runes, and
svelte-store so agent guidance matches the full public hydration surface.
@SutuSebastian SutuSebastian changed the title chore(skills): persist-* Intent skills for sources + react chore(skills): full persist-* Intent coverage Jul 23, 2026
Sources stay persist-*; framework leaves flip to Intent-style
react-persist / vue-persist / …; persist-core becomes persist.
@SutuSebastian SutuSebastian changed the title chore(skills): full persist-* Intent coverage chore(skills): Intent naming — persist / persist-* / <fw>-persist Jul 23, 2026
Cover seroval, standard-schema, idb, async-storage, mmkv, secure-store,
encrypted, compressed, node-fs, and BroadcastChannel crosstab as persist-*
composition leaves so agent guidance matches every opt-in subpath.
Correct migrate/one-shot, alpine $hydrated bag, IDB encrypt compose,
pinia/$state+merge, jotai readonly typing; slim tanstack-store sprawl
and drop no-op persist pointers (requires already loads core).
Avoid npm install -g so @tanstack/intent and its transitive tree resolve
from bun.lock like the rest of CI.
@SutuSebastian

Copy link
Copy Markdown
Contributor Author

PR comment fact-check (unresolved threads: 0)

Only actionable claim was CodeRabbit’s review-body nit on .github/workflows/check-skills.yml (global npm install -g @tanstack/intent@0.3.5).

Verdict: ✅ Correct — pinned major is fine, but transitive deps still resolve outside bun.lock. Applied: both jobs now use ./.github/actions/setup + bun run intent:validate / bun run intent:stale (devDep @tanstack/intent@0.3.5).

CodeRabbit walkthrough still mentions skills/_artifacts/🕒 outdated vs later commits that deleted it (no thread to resolve).

Changeset-bot: informational only.

Copy-paste wiring now matches Install (JSON default storage; crosstab/
secure-store declare example peers; CryptoKey shown for encrypted).
@SutuSebastian
SutuSebastian merged commit 4387948 into main Jul 23, 2026
15 checks passed
@SutuSebastian
SutuSebastian deleted the chore/intent-skills-domain-tree branch July 23, 2026 06:15
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