ci: Version Packages

[github-actions]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@tanstack/intent@0.5.0

Minor Changes

• #258 920a3d5 - Bring library skill authoring and maintenance into the normal coding-agent workflow. intent install --maintainer installs persistent guidance for agreed skill batches, source-grounded updates, representative executable task checks, and fresh-consumer verification when available.

  Add intent review to identify affected guidance and unmapped changes from Git, then record evidence-backed outcomes against source and skill content hashes. A skill or planning record with no recorded review is compared with the commit that introduced it. Repeated no-ops stay quiet until content changes; missing source evidence remains unresolved. The generated release workflow uses recorded reviews when present and retains the existing staleness fallback otherwise.

  Require every authoring batch to create and incrementally maintain domain_map.yaml, skill_spec.md, and skill_tree.yaml, preserving prior coverage, maintainer decisions, and remaining work. Track their review against source and skill contents and keep missing or invalid records unresolved. Keep focused authoring available through maintainer setup, maintainer add, meta generate-skill, and review reminders without mandatory full-library discovery. Add maintainer fixtures and protected task graders.

  Separate activation guidance in description from descriptive text in metadata.purpose, preserving original descriptions when migrating existing skills. Expose purpose separately in discovery and list --json; older skills remain supported. Group related features by developer task, use references for conditional detail, check discovery separately from task correctness, and bundle tested scripts only when useful.

  Keep the review-state lock held through atomic replacement, explain stale locks, and render repository-controlled review fields as untrusted data. Use the same command runner for reminder follow-up review commands.

  Replace scaffold with intent maintainer setup|add|status|sync|review|check. Initialize cumulative records and copy the check-skills.yml CI workflow when none exists, register package-owned skills, synchronize frontmatter and publishing metadata, and check authoring gaps and revision-bound reviews through deterministic commands. Preserve existing authored decisions and custom record locations.

• #262 e560b60 - maintainer setup replaces maintainer adopt, which is removed along with its JSON plan and --apply; update any script that called it. Setup registers existing package-owned skills found under skills/ directories that the skill tree does not record yet. Skill contents are preserved; the domain comes from metadata.domain, the domain map, or the parent directory, and defaults to uncategorized for the maintainer to edit. Invalid or conflicting skills are reported and left unregistered. Agent skill directories, dependencies, and packages outside the workspace are not scanned.

• #263 d4eca84 - Add optional interactive maintainer review with guidance and source-diff inspection, per-item reasons and evidence, and confirmation before recording. Reuse existing fingerprints and evidence validation, retain JSON workflows, and prohibit interactive prompts in CI. Add maintainer review --unchanged <reason> and --updated <reason> to record one outcome for every pending item in a single command, with the reviewed revision and changed files as evidence.

• #260 3437a6c - Add explicit repository skill distribution to the maintainer command workflow. Package-only distribution is the default and needs no record. Keep skills in their owning packages, record a selection or an explicit opt-out in skill_tree.yaml, and generate Claude/Cursor plugin metadata and consumer install commands for npx skills add and gh skill add. Preserve unrelated plugin fields, require explicit prerequisite selection, and check generated files for drift without publishing or installing anything on the maintainer's behalf.

  Find selected package skills even when root-level skills exist, and reject conflicting Claude marketplace-only definitions before writing generated files.

• #289 0a42b40 - validate checks every fenced TypeScript and JavaScript block in a SKILL.md against the owning package's own types when TypeScript is available in the repository. A renamed export, a removed option, or a changed shape fails validation with the skill file and line. Imports of exports marked @deprecated produce warnings, and relative Markdown links must resolve. Names, modules, and globals a partial snippet leaves out are not reported. Repositories without TypeScript skip the code checks with a notice. Pending review items for skills report whether their examples still compile.

Patch Changes

• #279 c642ba8 - Ship @tanstack/intent with zero runtime dependencies. The libraries it uses (yaml, semver, jsonc-parser, cac, std-env, @clack/prompts) are now bundled and tree-shaken into dist, which cuts the install footprint from roughly 2.4 MB across 10 packages to under 1 MB in one, and makes every command start faster because Node loads a few chunks instead of ~150 files from node_modules.

• #276 74d1b26 - Speed up dependency discovery. Resolve each dependency directory with a plain node_modules walk plus a single symlink collapse instead of Node's module resolver, which evaluated export maps and realpathed every path segment per lookup, and resolve each package's real root once per package instead of once per skill. intent list in a pnpm monorepo runs roughly 30% faster; discovered packages and paths are unchanged.

• #282 fc5472a - Cut the filesystem work in dependency discovery. Each dependency edge now costs one readlink instead of a stat through the symlink plus an lstat and a realpath; symlink targets, candidate paths, and node_modules directories are memoized per scan; and directories the walk has already resolved skip their identity lstat. Workspace pattern sorting no longer initializes the ICU collator on every run. intent list in a pnpm monorepo runs about 35% faster and in an npm project about 25% faster, with identical results.

• #283 0be3bc7 - Make agent hooks fast when @tanstack/intent is installed in the project. The session-start catalog previously ran npx @tanstack/intent@latest list (or the pnpm, yarn, or bun equivalent), which resolves the package against the npm registry on every session start and took one to four seconds; the runner now executes the locally installed CLI directly with the current Node binary, which takes about a tenth of a second, and falls back to the package-manager runner only when there is no local install. When that installation also has a node_modules/.bin/intent shim, the catalog suggests node_modules/.bin/intent load <package>#<skill> for loads (otherwise it keeps suggesting the package-manager runner), and the edit gate recognizes that form. Reinstall hooks with intent hooks install to pick up the new runner.

• #278 0c074e3 - Trim intent list and intent load startup. Discovery no longer loads the semver package on every run (a small built-in comparator picks between duplicate installed versions of a package, with identical results), and intent install loads its interactive prompt library only when it actually prompts.

• #273 36a1bf1 - Record developer tasks at registration with maintainer add --task, retire a registered skill with maintainer remove <name> without deleting its guidance, and include the recording contract (allowed outcomes and required fields) in review --json reports. Evidence may be a single string or a list, and the report points at .intent/review.json, which review ignores.

• #272 33b5e8b - Print an ordered overview for intent maintainer --help and per-action options for intent maintainer <action> --help. Name every file maintainer add and maintainer sync write, label consumer install commands, show changed files and missing reviews in maintainer status and check, validate each skills root once, report all missing repository-distribution inputs together, and print unsupported options in their kebab-case form.

• #271 337f8f5 - Stop reporting files Intent writes as unmapped source changes. Agent instruction files, generated plugin metadata, the CI workflow, package manifests, and lockfiles no longer need a recorded review unless a skill maps them; review.ignore in skill_tree.yaml adds repository-specific patterns.

  Register a skill with the workspace package that owns the current directory when maintainer add runs without --package. Reject a review record that annotates no outcomes and explain the required fields. Accept per-skill files entries written by maintainer sync during validation. Advise the current CI workflow version.

• #291 909f5fc - Generate commands for installed Intent, reject unsafe setup write paths before creating records, and validate distribution selections before writes. Check JavaScript library contracts and JSX examples across supported Markdown fences, and reuse validation results in maintainer reports to avoid compiling the same examples twice.

• #292 305ca7f - Add a lightweight intent repair command for unambiguous frontmatter migrations and reviewable before/after example patches. Preserve conflicting metadata and refuse alias edits that could change unrelated fields. Write mode applies only safe frontmatter changes; code-example suggestions require review and are emitted as patches without changing source files.

• #284 864562c - Keep Markdown link destinations that contain a private-use character (U+E000) intact when intent load and intent meta rewrite relative paths; the escape placeholder is now chosen so it never collides with the destination's own characters.

• #267 54f7d97 - Refresh workspace roots, patterns, and members between core operations. Keep workspace discovery reuse within the existing operation-local filesystem cache so listing and loading observe changed membership and source kinds.

  Avoid enumerating unrelated workspace members and reading unused skill metadata during direct loads. Preserve fresh policy reads and final path checks.

• #290 ed6ca00 - Run skill checks through reusable GitHub workflows pinned to the immutable commit packaged with the installed Intent release. Setup validates generated workflow inputs and write paths before copying files. Analysis uses the repository's locked CLI, disables dependency lifecycle scripts, and has read permissions. Optional review publication runs separately with bounded report validation.

  The PR workflow runs one combined validation check and can prepare mechanical repairs and suggested example patches for review. It retains the patches when validation fails and never publishes fixes or marks semantic reviews complete. intent maintainer check --github-summary reports authoring issues, stale generated files, and pending source reviews in the GitHub Actions step summary.

  Validation counts each skill once across overlapping custom roots and avoids duplicate packaging warnings for the same skill.

• #268 fab9591 - Generate standalone hook command parsing from the tested policy parser. Preserve agent-specific output, install ownership, and fail-open catalog behavior.

• #265 5f56f22 - Reuse parsed planning records, source hashes, and Git source matches within maintainer operations. Keep fresh checks for later reports and writes.

• #275 9e73959 - Fix Windows path handling. Preserve backslash escapes in Markdown link destinations when intent load and intent meta rewrite relative paths (an escaped \) was normalized into a path separator). Normalize the Git repository root reported by git rev-parse so intent maintainer add no longer rejects every skill path with "must belong to the selected package", and print repository-relative paths in maintainer output and maintainer status --json with forward slashes on every platform.

• #266 7a2a9e1 - Recognize Intent installed as a devDependency at the owning workspace root when validating package skills.

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: fd9e3fc8-a133-4585-9171-a60e5fc48c19

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

---

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.}