@tanstack/intent 0.0.29 → 0.0.33

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@tanstack/intent",
-  "version": "0.0.29",
+  "version": "0.0.33",
   "description": "Ship compositional knowledge for AI coding agents alongside your npm packages",
   "license": "MIT",
   "type": "module",
   "repository": {
     "type": "git",
-    "url": "https://github.com/tanstack/intent"
+    "url": "https://github.com/TanStack/intent"
   },
   "exports": {
     ".": {
@@ -36,11 +36,10 @@
     "verdaccio": "^6.3.2"
   },
   "scripts": {
-    "prepack": "npm run build",
     "build": "tsdown src/index.ts src/cli.ts src/setup.ts src/intent-library.ts src/library-scanner.ts --format esm --dts",
     "test:smoke": "pnpm run build && node dist/cli.mjs --help > /dev/null",
     "test:lib": "vitest run --exclude 'tests/integration/**'",
     "test:integration": "vitest run tests/integration/",
     "test:types": "tsc --noEmit"
   }
-}
+}

package/dist/display-DdmZXLZm.mjs

@@ -1,3 +0,0 @@
-import { n as printSkillTree, r as printTable, t as computeSkillNameWidth } from "./display-hdsqb4w-.mjs";
-
-export { computeSkillNameWidth, printSkillTree, printTable };

package/dist/install-BzDmD5yI.mjs

@@ -1,69 +0,0 @@
-//#region src/commands/install.ts
-const INSTALL_PROMPT = `You are an AI assistant helping a developer set up skill-to-task mappings for their project.
-
-Follow these steps in order:
-
-1. CHECK FOR EXISTING MAPPINGS
-   Search the project's agent config files (AGENTS.md, CLAUDE.md, .cursorrules,
-   .github/copilot-instructions.md) for a block delimited by:
-     <!-- intent-skills:start -->
-     <!-- intent-skills:end -->
-   - If found: show the user the current mappings, keep that file as the source of truth,
-     and ask "What would you like to update?" Then skip to step 4 with their requested changes.
-   - If not found: continue to step 2.
-
-2. DISCOVER AVAILABLE SKILLS
-   Run: \`npx @tanstack/intent@latest list\`
-   This outputs each skill's name, description, full path, and whether it was found in
-   project-local node_modules or accessible global node_modules.
-   This works best in Node-compatible environments (npm, pnpm, Bun, or Deno npm interop
-   with node_modules enabled).
-
-3. SCAN THE REPOSITORY
-   Build a picture of the project's structure and patterns:
-   - Read package.json for library dependencies
-   - Survey the directory layout (src/, app/, routes/, components/, api/, etc.)
-   - Note recurring patterns (routing, data fetching, auth, UI components, etc.)
-
-   Based on this, propose 3-5 skill-to-task mappings. For each one explain:
-   - The task or code area (in plain language the user would recognise)
-   - Which skill applies and why
-
-   Then ask: "What other tasks do you commonly use AI coding agents for?
-   I'll create mappings for those too."
-   Also ask: "I'll default to AGENTS.md unless you want another supported config file.
-   Do you have a preference?"
-
-4. WRITE THE MAPPINGS BLOCK
-   Once you have the full set of mappings, write or update the agent config file.
-   - If you found an existing intent-skills block, update that file in place.
-   - Otherwise prefer AGENTS.md by default, unless the user asked for another supported file.
-
-   Use this exact block:
-
-<!-- intent-skills:start -->
-# Skill mappings - when working in these areas, load the linked skill file into context.
-skills:
-  - task: "describe the task or code area here"
-    load: "node_modules/package-name/skills/skill-name/SKILL.md"
-<!-- intent-skills:end -->
-
-   Rules:
-   - Use the user's own words for task descriptions
-   - Include the exact path from \`npx @tanstack/intent@latest list\` output so agents can load it directly
-   - Paths should use the stable \`node_modules/<package-name>/skills/...\` format (no version numbers)
-   - If a skill path from \`list\` contains package-manager-internal directories (e.g. \`.pnpm/\`, \`.bun/\`)
-     with version numbers, it is a transitive dependency without a stable top-level symlink.
-     For these skills, do NOT embed the versioned path. Instead, add a comment telling the agent
-     how to locate the skill at runtime:
-       - task: "describe the task"
-         # To load this skill, run: npx @tanstack/intent@latest list | grep <skill-name>
-   - Keep entries concise - this block is read on every agent task
-   - Preserve all content outside the block tags unchanged
-   - If the user is on Deno, note that this setup is best-effort today and relies on npm interop`;
-function runInstallCommand() {
-	console.log(INSTALL_PROMPT);
-}
-
-//#endregion
-export { runInstallCommand as n, INSTALL_PROMPT as t };

package/dist/scanner-CP4U8F_n.mjs

@@ -1,5 +0,0 @@
-import "./utils-COlDcU72.mjs";
-import "./workspace-patterns-Cndd-7vB.mjs";
-import { t as scanForIntents } from "./scanner-B-bbXBLY.mjs";
-
-export { scanForIntents };

package/dist/staleness-LRbiWWZK.mjs

@@ -1,4 +0,0 @@
-import "./utils-COlDcU72.mjs";
-import { t as checkStaleness } from "./staleness-SY7-mZMH.mjs";
-
-export { checkStaleness };

package/dist/staleness-SY7-mZMH.mjs

@@ -1,104 +0,0 @@
-import { a as parseFrontmatter, n as findSkillFiles } from "./utils-COlDcU72.mjs";
-import { readFileSync } from "node:fs";
-import { join, relative, sep } from "node:path";
-
-//#region src/staleness.ts
-function classifyVersionDrift(oldVer, newVer) {
-	if (oldVer === newVer) return null;
-	const oldParts = oldVer.replace(/[^0-9.]/g, "").split(".").map(Number);
-	const newParts = newVer.replace(/[^0-9.]/g, "").split(".").map(Number);
-	if ((newParts[0] ?? 0) > (oldParts[0] ?? 0)) return "major";
-	if ((newParts[1] ?? 0) > (oldParts[1] ?? 0)) return "minor";
-	if ((newParts[2] ?? 0) > (oldParts[2] ?? 0)) return "patch";
-	return null;
-}
-function readLocalVersion(packageDir) {
-	try {
-		const pkgJson = JSON.parse(readFileSync(join(packageDir, "package.json"), "utf8"));
-		return typeof pkgJson.version === "string" ? pkgJson.version : null;
-	} catch {
-		return null;
-	}
-}
-async function fetchNpmVersion(packageName) {
-	try {
-		const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`);
-		if (!res.ok) return null;
-		const data = await res.json();
-		return typeof data.version === "string" ? data.version : null;
-	} catch {
-		return null;
-	}
-}
-async function fetchCurrentVersion(packageDir, packageName) {
-	return readLocalVersion(packageDir) ?? await fetchNpmVersion(packageName);
-}
-function isStringRecord(value) {
-	return !!value && typeof value === "object" && !Array.isArray(value) && Object.values(value).every((entry) => typeof entry === "string");
-}
-function parseSyncState(value) {
-	if (!value || typeof value !== "object") return null;
-	const raw = value;
-	const parsed = {};
-	if (typeof raw.library_version === "string") parsed.library_version = raw.library_version;
-	if (raw.skills && typeof raw.skills === "object") {
-		const skills = {};
-		for (const [skillName, skillValue] of Object.entries(raw.skills)) {
-			if (!skillValue || typeof skillValue !== "object") continue;
-			const sourcesSha = skillValue.sources_sha;
-			if (sourcesSha !== void 0 && !isStringRecord(sourcesSha)) continue;
-			skills[skillName] = {};
-			if (sourcesSha) skills[skillName].sources_sha = sourcesSha;
-		}
-		parsed.skills = skills;
-	}
-	return parsed;
-}
-function readSyncState(packageDir) {
-	const statePath = join(packageDir, "skills", "sync-state.json");
-	try {
-		return parseSyncState(JSON.parse(readFileSync(statePath, "utf8")));
-	} catch {
-		return null;
-	}
-}
-async function checkStaleness(packageDir, packageName) {
-	const skillsDir = join(packageDir, "skills");
-	const library = packageName ?? "unknown";
-	const skillMetas = findSkillFiles(skillsDir).map((filePath) => {
-		const fm = parseFrontmatter(filePath);
-		const relName = relative(skillsDir, filePath).replace(/[/\\]SKILL\.md$/, "").split(sep).join("/");
-		return {
-			name: typeof fm?.name === "string" ? fm.name : relName,
-			filePath,
-			libraryVersion: fm?.library_version,
-			sources: Array.isArray(fm?.sources) ? fm.sources : void 0
-		};
-	});
-	const skillVersion = skillMetas.find((s) => s.libraryVersion)?.libraryVersion ?? null;
-	const currentVersion = await fetchCurrentVersion(packageDir, library);
-	const versionDrift = skillVersion && currentVersion ? classifyVersionDrift(skillVersion, currentVersion) : null;
-	const syncState = readSyncState(packageDir);
-	return {
-		library,
-		currentVersion,
-		skillVersion,
-		versionDrift,
-		skills: skillMetas.map((skill) => {
-			const reasons = [];
-			if (currentVersion && skill.libraryVersion && skill.libraryVersion !== currentVersion) reasons.push(`version drift (${skill.libraryVersion} → ${currentVersion})`);
-			const storedShas = syncState?.skills?.[skill.name]?.sources_sha ?? {};
-			if (skill.sources && Object.keys(storedShas).length > 0) {
-				for (const source of skill.sources) if (!storedShas[source]) reasons.push(`new source (${source})`);
-			}
-			return {
-				name: skill.name,
-				reasons,
-				needsReview: reasons.length > 0
-			};
-		})
-	};
-}
-
-//#endregion
-export { checkStaleness as t };

package/dist/workspace-patterns-D_y6rlqX.mjs

@@ -1,4 +0,0 @@
-import "./utils-COlDcU72.mjs";
-import { i as resolveWorkspacePackages, n as findWorkspaceRoot, r as readWorkspacePatterns, t as findPackagesWithSkills } from "./workspace-patterns-Cndd-7vB.mjs";
-
-export { findPackagesWithSkills, findWorkspaceRoot };

package/meta/templates/workflows/notify-intent.yml

@@ -1,51 +0,0 @@
-# notify-intent.yml — Drop this into your library repo's .github/workflows/
-#
-# Fires a repository_dispatch event whenever docs or source files change
-# on merge to main. This triggers the skill staleness check workflow.
-#
-# Requirements:
-#   - A fine-grained PAT with contents:write on this repository stored
-#     as the INTENT_NOTIFY_TOKEN repository secret.
-#
-# Template variables (replaced by `intent setup`):
-#   {{PAYLOAD_PACKAGE}} — e.g. @tanstack/query or my-workspace workspace
-#   {{DOCS_PATH}}       — e.g. docs/**
-#   {{SRC_PATH}}        — e.g. packages/query-core/src/**
-
-name: Trigger Skill Review
-
-on:
-  push:
-    branches: [main]
-    paths:
-      - '{{DOCS_PATH}}'
-      - '{{SRC_PATH}}'
-
-jobs:
-  notify:
-    name: Trigger Skill Review
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 2
-
-      - name: Collect changed files
-        id: changes
-        run: |
-          FILES=$(git diff --name-only HEAD~1 HEAD | jq -R -s -c 'split("\n") | map(select(length > 0))')
-          echo "files=$FILES" >> "$GITHUB_OUTPUT"
-
-      - name: Dispatch to intent repo
-        uses: peter-evans/repository-dispatch@v3
-        with:
-          token: ${{ secrets.INTENT_NOTIFY_TOKEN }}
-          repository: ${{ github.repository }}
-          event-type: skill-check
-          client-payload: |
-            {
-              "package": "{{PAYLOAD_PACKAGE}}",
-              "sha": "${{ github.sha }}",
-              "changed_files": ${{ steps.changes.outputs.files }}
-            }