@tanstack/intent 0.1.1 → 0.2.0

package/dist/{workspace-patterns-Cz_lNhwz.mjs → workspace-patterns-BDoJIWk-.mjs}

@@ -1,9 +1,8 @@
-import { r as findSkillFiles } from "./utils-Dj49bkF_.mjs";
+import { r as findSkillFiles } from "./utils-6FtqhOYf.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { parse } from "yaml";
 import { parse as parse$1 } from "jsonc-parser";
-
 //#region src/workspace-patterns.ts
 function normalizeWorkspacePattern(pattern) {
 	return pattern.replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/+$/, "");
@@ -189,6 +188,5 @@ function findPackagesWithSkills(root) {
 function findWorkspacePackages(root) {
 	return readWorkspacePackageDirs(root) ?? [];
 }
-
 //#endregion
-export { readWorkspacePatterns as a, getWorkspaceInfo as i, findWorkspacePackages as n, resolveWorkspacePackages as o, findWorkspaceRoot as r, findPackagesWithSkills as t };
+export { readWorkspacePatterns as a, getWorkspaceInfo as i, findWorkspacePackages as n, resolveWorkspacePackages as o, findWorkspaceRoot as r, findPackagesWithSkills as t };

package/dist/workspace-patterns-CrL8hAbd.mjs

@@ -0,0 +1,2 @@
+import { i as getWorkspaceInfo, r as findWorkspaceRoot } from "./workspace-patterns-BDoJIWk-.mjs";
+export { findWorkspaceRoot, getWorkspaceInfo };

package/meta/generate-skill/SKILL.md

@@ -52,7 +52,9 @@ SKILL.md into that package's skills directory (e.g.
 `packages/client/skills/core/SKILL.md`), not a shared root.
 
 1. **Skill name** — format `library-group/skill-name` (e.g. `tanstack-query/core`,
-   `tanstack-router/loaders`, `db/core/live-queries`)
+   `tanstack-router/loaders`, `db/core/live-queries`). This is the skill's
+   directory path: its **last segment** becomes the frontmatter `name` (a
+   spec-legal leaf), and the full path is where the `SKILL.md` lives.
 2. **Skill description** — what the skill covers and when an agent should load it
 3. **Source documentation** — the docs, guides, API references, and/or source
    files to distill from
@@ -170,17 +172,18 @@ domain-discovery — use those directly.
 
 ```yaml
 ---
-name: [library]/[skill-name]
+name: '[skill-name]'
 description: >
   [1–3 sentences. What this skill covers and exactly when an agent should
   load it. Written for the agent — include the keywords an agent would
   encounter when it needs this skill. Dense routing key.]
-type: core
-library: [library]
-library_version: "[version this targets]"
+metadata:
+  type: core
+  library: '[library]'
+  library_version: '[version this targets]'
 sources:
-  - "[Owner/repo]:docs/[path].md"
-  - "[Owner/repo]:src/[path].ts"
+  - '[Owner/repo]:docs/[path].md'
+  - '[Owner/repo]:src/[path].ts'
 ---
 ```
 
@@ -188,14 +191,15 @@ sources:
 
 ```yaml
 ---
-name: [library]/[parent]/[skill-name]
+name: '[skill-name]'
 description: >
   [1–3 sentences. What this sub-topic covers and when to load it.]
-type: sub-skill
-library: [library]
-library_version: "[version]"
+metadata:
+  type: sub-skill
+  library: '[library]'
+  library_version: '[version]'
 sources:
-  - "[Owner/repo]:docs/[path].md"
+  - '[Owner/repo]:docs/[path].md'
 ---
 ```
 
@@ -203,29 +207,39 @@ sources:
 
 ```yaml
 ---
-name: [library]/[framework]
+name: '[framework]'
 description: >
   [1–3 sentences. Framework-specific bindings. Name the hooks, components,
   providers.]
-type: framework
-library: [library]
-framework: [react | vue | solid | svelte | angular]
-library_version: "[version]"
+metadata:
+  type: framework
+  library: '[library]'
+  framework: '[react | vue | solid | svelte | angular]'
+  library_version: '[version]'
 requires:
-  - [library]/core
+  - '[library]/core'
 sources:
-  - "[Owner/repo]:docs/framework/[framework]/[path].md"
+  - '[Owner/repo]:docs/framework/[framework]/[path].md'
 ---
 ```
 
 ### Frontmatter rules
 
+- `name` is the spec-legal leaf segment — lowercase letters, numbers, and
+  hyphens only — and matches the skill's parent directory. It carries no
+  slashes; the namespace lives in the skill's directory path instead.
+- Intent-specific scalars (`type`, `library`, `library_version`, `framework`)
+  live under the `metadata` map. The Agent Skills spec permits only `name`,
+  `description`, `license`, `compatibility`, `metadata`, and `allowed-tools`
+  at the top level, so emitting these scalars at the top level fails
+  validation.
 - `description` must be written so the agent loads this skill at the right
   time — not too broad (triggers on everything) and not too narrow (never
   triggers). Pack with function names, option names, concept keywords.
 - `sources` uses the format `Owner/repo:relative-path`. Glob patterns are
   supported (e.g. `TanStack/query:docs/framework/react/guides/*.md`).
-- `library_version` is the version of the source library this skill targets.
+- `metadata.library_version` is the version of the source library this skill
+  targets.
 - `requires` lists skills that must be loaded before this one.
 
 ---

package/meta/tree-generator/SKILL.md

@@ -287,14 +287,15 @@ framework-agnostic concepts and contains the sub-skill registry.
 
 ```yaml
 ---
-name: [lib]-core
+name: '[lib]-core'
 description: >
   [1–3 sentences. What this library does and the framework-agnostic
   concepts it provides. Pack with keywords: function names, config
   options, concepts. This is a routing key, not a human summary.]
-type: core
-library: [lib]
-library_version: "[version this targets]"
+metadata:
+  type: core
+  library: '[lib]'
+  library_version: '[version this targets]'
 ---
 ```
 
@@ -332,16 +333,17 @@ One SKILL.md per domain. Follow this structure exactly.
 
 ```yaml
 ---
-name: [lib]-core/[domain-slug]
+name: '[domain-slug]'
 description: >
   [1–3 sentences. What this domain covers AND when to load it. Name
   specific functions, options, or APIs. Dense routing key.]
-type: sub-skill
-library: [lib]
-library_version: "[version]"
+metadata:
+  type: sub-skill
+  library: '[lib]'
+  library_version: '[version]'
 sources:
-  - "[repo]:docs/[path].md"
-  - "[repo]:src/[path].ts"
+  - '[repo]:docs/[path].md'
+  - '[repo]:src/[path].ts'
 ---
 ```
 
@@ -452,17 +454,18 @@ framework-specific patterns and mistakes.
 
 ```yaml
 ---
-name: react-[lib]
+name: 'react-[lib]'
 description: >
   [1–3 sentences. React-specific bindings for [library]. Name the hooks,
   components, and providers. Mention React-specific patterns like SSR
   hydration if applicable.]
-type: framework
-library: [lib]
-framework: react
-library_version: "[version]"
+metadata:
+  type: framework
+  library: '[lib]'
+  framework: react
+  library_version: '[version]'
 requires:
-  - [lib]-core
+  - '[lib]-core'
 ---
 ```
 
@@ -499,18 +502,18 @@ with the framework frontmatter:
 
 ```yaml
 ---
-name: react-[lib]/[domain-slug]
+name: '[domain-slug]'
 description: >
   [React-specific description for this domain.]
-type: sub-skill
-library: [lib]
-framework: react
-library_version: "[version]"
+metadata:
+  type: sub-skill
+  library: '[lib]'
+  framework: react
+  library_version: '[version]'
 requires:
-  - [lib]-core
-  - [lib]-core/[domain-slug]
+  - '[lib]-core'
+  - '[lib]-core/[domain-slug]'
 ---
-
 This skill builds on [lib]-core/[domain-slug]. Read the core skill first.
 ```
 
@@ -556,19 +559,19 @@ framework hooks and providers).
 
 ```yaml
 ---
-name: compositions/[lib-a]-[lib-b]
+name: '[lib-a]-[lib-b]'
 description: >
   [How lib-a and lib-b wire together. Name the specific integration
   points: functions, hooks, patterns.]
-type: composition
-library_version: "[version of primary lib]"
+metadata:
+  type: composition
+  library_version: '[version of primary lib]'
 requires:
-  - [lib-a]-core
-  - react-[lib-a]
-  - [lib-b]-core
-  - react-[lib-b]
+  - '[lib-a]-core'
+  - 'react-[lib-a]'
+  - '[lib-b]-core'
+  - 'react-[lib-b]'
 ---
-
 This skill requires familiarity with both [lib-a] and [lib-b].
 Read their core and framework skills first.
 ```
@@ -601,15 +604,16 @@ for these skill types.
 
 ```yaml
 ---
-name: react-[lib]/security
+name: security
 description: >
   Go-live security validation for [library]. Checks [specific concerns].
-type: security
-library: [lib]
-framework: react
-library_version: '[version]'
+metadata:
+  type: security
+  library: '[lib]'
+  framework: react
+  library_version: '[version]'
 requires:
-  - react-[lib]
+  - 'react-[lib]'
 ---
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/intent",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Ship compositional knowledge for AI coding agents alongside your npm packages",
   "license": "MIT",
   "type": "module",
@@ -28,14 +28,13 @@
   "dependencies": {
     "cac": "^6.7.14",
     "jsonc-parser": "^3.3.1",
-    "semver": "^7.7.4",
-    "yaml": "2.8.3"
+    "semver": "^7.8.4",
+    "yaml": "2.9.0"
   },
   "devDependencies": {
     "@types/semver": "^7.7.1",
-    "@verdaccio/node-api": "6.0.0-6-next.76",
-    "tsdown": "^0.19.0",
-    "verdaccio": "^6.3.2"
+    "tsdown": "^0.22.2",
+    "verdaccio": "^6.7.2"
   },
   "scripts": {
     "build": "tsdown src/index.ts src/cli.ts src/setup.ts src/core.ts --format esm --dts",

package/dist/artifact-coverage-BfJ7f-S9.mjs

@@ -1,3 +0,0 @@
-import { t as readIntentArtifacts } from "./artifact-coverage-nGwun1tt.mjs";
-
-export { readIntentArtifacts };

package/dist/source-policy-D4slvwwI.mjs

@@ -1,9 +0,0 @@
-import "./utils-Dj49bkF_.mjs";
-import "./skill-paths-Cr74uFk4.mjs";
-import "./scanner-2XDBAsbm.mjs";
-import "./workspace-patterns-Cz_lNhwz.mjs";
-import "./project-context-DDCie6Ro.mjs";
-import "./excludes-DDMe-4iu.mjs";
-import { a as checkLoadAllowed, i as applySourcePolicy, n as EMPTY_NOTE, o as readSkillSourcesConfig, r as MIGRATION_NOTICE, s as scanForPolicedIntents, t as ALLOW_ALL_NOTICE } from "./source-policy-rGOtjQSM.mjs";
-
-export { scanForPolicedIntents };

package/dist/staleness-Ctzy2Zac.mjs

@@ -1,5 +0,0 @@
-import "./utils-Dj49bkF_.mjs";
-import "./artifact-coverage-nGwun1tt.mjs";
-import { n as checkStaleness, r as readPackageName, t as buildWorkspaceCoverageSignals } from "./staleness-B8IvDS_9.mjs";
-
-export { buildWorkspaceCoverageSignals, checkStaleness, readPackageName };

package/dist/workspace-patterns-BBW4c1gr.mjs

@@ -1,4 +0,0 @@
-import "./utils-Dj49bkF_.mjs";
-import { a as readWorkspacePatterns, i as getWorkspaceInfo, n as findWorkspacePackages, o as resolveWorkspacePackages, r as findWorkspaceRoot, t as findPackagesWithSkills } from "./workspace-patterns-Cz_lNhwz.mjs";
-
-export { findWorkspaceRoot, getWorkspaceInfo };