@tanstack/cli 0.62.2 → 0.62.4

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@tanstack/cli",
-  "version": "0.62.2",
+  "version": "0.62.4",
   "description": "TanStack CLI",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/types/index.d.ts",
   "files": [
     "dist",
-    "skills"
+    "skills",
+    "!skills/_artifacts"
   ],
   "bin": {
     "tanstack": "./dist/bin.js"
@@ -40,11 +41,12 @@
     "tempy": "^3.1.0",
     "validate-npm-package-name": "^7.0.0",
     "zod": "^3.24.2",
-    "@tanstack/create": "0.63.0"
+    "@tanstack/create": "0.63.1"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.2",
     "@tanstack/config": "^0.16.2",
+    "@tanstack/intent": "^0.0.13",
     "@types/diff": "^5.2.0",
     "@types/node": "^22.13.4",
     "@types/semver": "^7.7.0",

package/skills/add-addons-existing-app/SKILL.md

@@ -6,7 +6,7 @@ description: >
   project metadata preconditions.
 type: core
 library: tanstack-cli
-library_version: "0.61.0"
+library_version: "0.62.1"
 ---
 
 # Add Add-ons To Existing App

package/skills/choose-ecosystem-integrations/SKILL.md

@@ -7,7 +7,7 @@ description: >
   provider options, and router-only compatibility constraints.
 type: composition
 library: tanstack-cli
-library_version: "0.61.0"
+library_version: "0.62.1"
 requires:
   - create-app-scaffold
   - query-docs-library-metadata

package/skills/create-app-scaffold/SKILL.md

@@ -7,7 +7,7 @@ description: >
   construction.
 type: core
 library: tanstack-cli
-library_version: "0.61.0"
+library_version: "0.62.1"
 ---
 
 # Create App Scaffold

package/skills/create-app-scaffold/references/create-flag-compatibility-matrix.md

@@ -1,6 +1,6 @@
 # Create Flag Compatibility Matrix
 
-Targets `@tanstack/cli` v0.61.0.
+Targets `@tanstack/cli` v0.62.1.
 
 ## Compatibility
 

package/skills/maintain-custom-addons-dev-watch/SKILL.md

@@ -2,11 +2,11 @@
 name: maintain-custom-addons-dev-watch
 description: >
   Build and iterate custom add-ons/templates with tanstack add-on init,
-  add-on compile, add-on dev, and tanstack dev --dev-watch, including sync
+  add-on compile, add-on dev, and tanstack create --dev-watch, including sync
   loop preconditions, watch-path validation, and project metadata constraints.
 type: lifecycle
 library: tanstack-cli
-library_version: "0.61.0"
+library_version: "0.62.1"
 requires:
   - add-addons-existing-app
 ---
@@ -30,10 +30,11 @@ npx @tanstack/cli add-on compile
 npx @tanstack/cli add-on dev
 ```
 
-### Sync watched package output into target app
+### Sync watched framework directory into a sandbox target app
 
 ```bash
-npx @tanstack/cli dev --dev-watch ../my-addon-package
+# --dev-watch is a flag on `create`, not on `dev`
+npx @tanstack/cli create my-sandbox --dev-watch ../path/to/framework-dir
 ```
 
 ### Re-run compile before apply when changing metadata
@@ -49,33 +50,33 @@ npx @tanstack/cli add my-custom-addon
 
 Wrong:
 ```bash
-npx @tanstack/cli dev --dev-watch ../my-addon-package --no-install
+npx @tanstack/cli create my-sandbox --dev-watch ../my-addon-package --no-install
 ```
 
 Correct:
 ```bash
-npx @tanstack/cli dev --dev-watch ../my-addon-package
+npx @tanstack/cli create my-sandbox --dev-watch ../my-addon-package
 ```
 
 Dev-watch rejects `--no-install`, so automated loops fail before any sync work starts.
 
 Source: packages/cli/src/dev-watch.ts:112
 
-### HIGH Start dev-watch without valid package entry
+### HIGH Start dev-watch without valid framework directory
 
 Wrong:
 ```bash
-npx @tanstack/cli dev --dev-watch ../missing-or-invalid-package
+npx @tanstack/cli create my-sandbox --dev-watch ../missing-or-invalid-dir
 ```
 
 Correct:
 ```bash
-npx @tanstack/cli dev --dev-watch ../valid-addon-package
+npx @tanstack/cli create my-sandbox --dev-watch ../valid-framework-dir
 ```
 
-Watch setup validates path and package metadata first, so invalid targets fail before file syncing begins.
+Watch setup validates that the path exists, is a directory, and contains at least one of `add-ons/`, `assets/`, or `framework.json`. Invalid targets fail before file syncing begins.
 
-Source: packages/cli/src/dev-watch.ts:100
+Source: packages/cli/src/command-line.ts:599
 
 ### CRITICAL Author add-on from code-router project
 

package/skills/query-docs-library-metadata/SKILL.md

@@ -6,7 +6,7 @@ description: >
   --addon-details for agent-safe discovery and preflight validation.
 type: core
 library: tanstack-cli
-library_version: "0.61.0"
+library_version: "0.62.1"
 ---
 
 # Query Docs And Library Metadata
@@ -30,7 +30,9 @@ npx @tanstack/cli libraries --json
 ### Fetch a specific docs page with explicit version
 
 ```bash
-npx @tanstack/cli doc --library router --version latest --path /docs/framework/react/guide/routing
+# Syntax: tanstack doc <library-id> <path> [--docs-version <version>]
+npx @tanstack/cli doc router framework/react/guide/routing
+npx @tanstack/cli doc router framework/react/guide/routing --docs-version latest
 ```
 
 ### Search docs for implementation targets
@@ -45,16 +47,19 @@ npx @tanstack/cli search-docs "server functions" --library start --json
 
 Wrong:
 ```bash
-npx @tanstack/cli doc --library made-up-lib --version latest --path /docs
+# Wrong: --library and --version are not flags on doc; path must not include /docs/ prefix
+npx @tanstack/cli doc --library router --version latest --path /docs/framework/react/guide/routing
 ```
 
 Correct:
 ```bash
+# Step 1: resolve a valid library id
 npx @tanstack/cli libraries --json
-npx @tanstack/cli doc --library router --version latest --path /docs/framework/react/guide/routing
+# Step 2: fetch using positional args — library id then doc path (no /docs/ prefix)
+npx @tanstack/cli doc router framework/react/guide/routing
 ```
 
-`doc` validates identifiers against registry metadata and fails when any segment is not real.
+`doc` takes `<library>` and `<path>` as positional arguments (not flags), and the path must not include a leading `/docs/` segment. Use `--docs-version` (not `--version`) to pin a specific version.
 
 Source: packages/cli/src/cli.ts:746
 

package/skills/query-docs-library-metadata/references/discovery-command-output-schemas.md

@@ -1,34 +1,43 @@
 # Discovery Command Output Schemas
 
-Targets `@tanstack/cli` v0.61.0.
+Targets `@tanstack/cli` v0.62.1.
 
 ## `tanstack libraries --json`
 
 ```json
 {
+  "group": "All Libraries",
   "count": 3,
   "libraries": [
     {
       "id": "router",
-      "label": "TanStack Router",
-      "description": "Type-safe routing",
-      "latestVersion": "latest"
+      "name": "TanStack Router",
+      "tagline": "Type-safe routing for React",
+      "description": "...",
+      "frameworks": ["react", "solid"],
+      "latestVersion": "1.x.x",
+      "docsUrl": "https://tanstack.com/router",
+      "githubUrl": "https://github.com/TanStack/router"
     }
   ]
 }
 ```
 
+Key fields: `id` (use for `tanstack doc <id>`), `name`, `tagline`, `latestVersion`.
+
 ## `tanstack search-docs <query> --json`
 
 ```json
 {
   "query": "server functions",
+  "totalHits": 42,
   "results": [
     {
-      "library": "start",
-      "version": "latest",
       "title": "Server Functions",
-      "path": "/docs/framework/react/guide/server-functions"
+      "url": "https://tanstack.com/router/latest/docs/...",
+      "snippet": "...",
+      "library": "start",
+      "breadcrumb": ["Guides", "Server Functions"]
     }
   ]
 }
@@ -36,35 +45,87 @@ Targets `@tanstack/cli` v0.61.0.
 
 ## `tanstack create --list-add-ons --json`
 
+Output is a **flat array** of add-on objects (no wrapper):
+
 ```json
-{
-  "count": 4,
-  "addOns": [
-    {
-      "id": "drizzle",
-      "name": "Drizzle",
-      "category": "database",
-      "dependsOn": []
-    }
-  ]
-}
+[
+  {
+    "id": "drizzle",
+    "name": "Drizzle",
+    "description": "TypeScript ORM",
+    "type": "add-on",
+    "category": "orm",
+    "phase": "add-on",
+    "modes": ["file-router"],
+    "link": "https://orm.drizzle.team",
+    "warning": null,
+    "exclusive": ["orm"],
+    "dependsOn": [],
+    "options": {}
+  }
+]
 ```
 
+Key fields: `id` (use for `--add-ons` and `tanstack add`), `exclusive` (categories allowing only one choice), `dependsOn` (ids auto-added), `options` (non-empty means configurable — inspect with `--addon-details`).
+
 ## `tanstack create --addon-details <id> --json`
 
 ```json
 {
   "id": "prisma",
   "name": "Prisma",
-  "options": [
-    {
-      "name": "provider",
+  "description": "Next-generation ORM",
+  "type": "add-on",
+  "category": "orm",
+  "phase": "add-on",
+  "modes": ["file-router"],
+  "exclusive": ["orm"],
+  "dependsOn": [],
+  "options": {
+    "provider": {
+      "type": "select",
+      "label": "Database provider",
+      "description": "The database driver Prisma will connect to",
       "default": "postgres",
-      "choices": ["postgres", "sqlite", "mysql"]
+      "options": [
+        { "value": "postgres", "label": "PostgreSQL" },
+        { "value": "sqlite", "label": "SQLite" },
+        { "value": "mysql", "label": "MySQL" }
+      ]
     }
-  ],
-  "dependsOn": []
+  },
+  "routes": [],
+  "packageAdditions": {
+    "dependencies": {},
+    "devDependencies": {},
+    "scripts": {}
+  }
 }
 ```
 
+`options` is a **record keyed by option name**, each entry has `type`, `label`, `default`, and (for `select`) an `options` array of `{ value, label }`.
+
+## `tanstack ecosystem --json`
+
+```json
+{
+  "query": { "category": null, "library": null },
+  "count": 5,
+  "partners": [
+    {
+      "id": "neon",
+      "name": "Neon",
+      "tagline": "Serverless Postgres",
+      "description": "...",
+      "category": "database",
+      "categoryLabel": "Database",
+      "url": "https://neon.tech",
+      "libraries": ["router", "start"]
+    }
+  ]
+}
+```
+
+Note: ecosystem `id` values are **not** necessarily the same as add-on `id` values. Always cross-reference with `--list-add-ons --json` before using in `tanstack add`.
+
 Use this reference to parse shapes defensively and normalize fields before feeding downstream planning or generation steps.