@tanstack/intent 0.0.1 → 0.0.2

package/README.md

@@ -50,16 +50,16 @@ npx intent setup
 
 ## CLI Commands
 
-| Command                  | Description                                      |
-| ------------------------ | ------------------------------------------------ |
-| `intent init`            | Inject intent discovery into agent config files  |
-| `intent list [--json]`   | Discover intent-enabled packages                 |
-| `intent meta`            | List meta-skills for library maintainers         |
-| `intent scaffold`        | Print the guided skill generation prompt         |
-| `intent validate [dir]`  | Validate SKILL.md files                          |
-| `intent setup`           | Copy CI/Oz workflow templates                    |
-| `intent stale [--json]`  | Check skills for version drift                   |
-| `intent feedback`        | Submit skill feedback                            |
+| Command                 | Description                                     |
+| ----------------------- | ----------------------------------------------- |
+| `intent init`           | Inject intent discovery into agent config files |
+| `intent list [--json]`  | Discover intent-enabled packages                |
+| `intent meta`           | List meta-skills for library maintainers        |
+| `intent scaffold`       | Print the guided skill generation prompt        |
+| `intent validate [dir]` | Validate SKILL.md files                         |
+| `intent setup`          | Copy CI/Oz workflow templates                   |
+| `intent stale [--json]` | Check skills for version drift                  |
+| `intent feedback`       | Submit skill feedback                           |
 
 ## License
 

package/dist/cli.mjs

@@ -12,6 +12,55 @@ import { fileURLToPath } from "node:url";
 function getMetaDir() {
 	return join(dirname(fileURLToPath(import.meta.url)), "..", "meta");
 }
+function padColumn(text, width) {
+	return text.length >= width ? text + "  " : text.padEnd(width);
+}
+function printTable(headers, rows) {
+	const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length)) + 2);
+	const headerLine = headers.map((h, i) => padColumn(h, widths[i])).join("");
+	const separator = widths.map((w) => "─".repeat(w)).join("");
+	console.log(headerLine);
+	console.log(separator);
+	for (const row of rows) console.log(row.map((cell, i) => padColumn(cell, widths[i])).join(""));
+}
+function printSkillTree(skills, opts) {
+	const roots = [];
+	const children = /* @__PURE__ */ new Map();
+	for (const skill of skills) {
+		const slashIdx = skill.name.indexOf("/");
+		if (slashIdx === -1) roots.push(skill.name);
+		else {
+			const parent = skill.name.slice(0, slashIdx);
+			if (!children.has(parent)) children.set(parent, []);
+			children.get(parent).push(skill);
+		}
+	}
+	if (roots.length === 0) {
+		for (const skill of skills) if (!roots.includes(skill.name)) roots.push(skill.name);
+	}
+	for (const rootName of roots) {
+		const rootSkill = skills.find((s) => s.name === rootName);
+		if (!rootSkill) continue;
+		printSkillLine(rootName, rootSkill, 4, opts);
+		for (const sub of children.get(rootName) ?? []) printSkillLine(sub.name.slice(sub.name.indexOf("/") + 1), sub, 6, opts);
+	}
+}
+function printSkillLine(displayName, skill, indent, opts) {
+	const nameStr = " ".repeat(indent) + displayName;
+	const padding = " ".repeat(Math.max(2, opts.nameWidth - nameStr.length));
+	const typeCol = opts.showTypes ? (skill.type ? `[${skill.type}]` : "").padEnd(14) : "";
+	console.log(`${nameStr}${padding}${typeCol}${skill.description}`);
+}
+function computeSkillNameWidth(allPackageSkills) {
+	let max = 0;
+	for (const skills of allPackageSkills) for (const s of skills) {
+		const slashIdx = s.name.indexOf("/");
+		const displayName = slashIdx === -1 ? s.name : s.name.slice(slashIdx + 1);
+		const indent = slashIdx === -1 ? 4 : 6;
+		max = Math.max(max, indent + displayName.length);
+	}
+	return max + 2;
+}
 async function cmdList(args) {
 	const jsonOutput = args.includes("--json");
 	let result;
@@ -33,14 +82,28 @@ async function cmdList(args) {
 		}
 		return;
 	}
-	console.log(`Intent-enabled packages (${result.packages.length} found):\n`);
+	const totalSkills = result.packages.reduce((sum, p) => sum + p.skills.length, 0);
+	console.log(`\n${result.packages.length} intent-enabled packages, ${totalSkills} skills (${result.packageManager})\n`);
+	printTable([
+		"PACKAGE",
+		"VERSION",
+		"SKILLS",
+		"REQUIRES"
+	], result.packages.map((pkg) => [
+		pkg.name,
+		pkg.version,
+		String(pkg.skills.length),
+		pkg.intent.requires?.join(", ") || "–"
+	]));
+	const nameWidth = computeSkillNameWidth(result.packages.map((p) => p.skills));
+	const showTypes = result.packages.some((p) => p.skills.some((s) => s.type));
+	console.log(`\nSkills:\n`);
 	for (const pkg of result.packages) {
-		const reqStr = pkg.intent.requires?.length ? `  (requires: ${pkg.intent.requires.join(", ")})` : "";
-		console.log(`${pkg.name} v${pkg.version}${reqStr}`);
-		for (const skill of pkg.skills) {
-			const desc = skill.description ? `  ${skill.description}` : "";
-			console.log(`  ${skill.name.padEnd(32)}${desc}`);
-		}
+		console.log(`  ${pkg.name}`);
+		printSkillTree(pkg.skills, {
+			nameWidth,
+			showTypes
+		});
 		console.log();
 	}
 	if (result.warnings.length > 0) {

package/meta/domain-discovery/SKILL.md

@@ -64,7 +64,7 @@ Log (but do not group yet):
 - What the library does in one sentence
 - The core abstractions a developer interacts with
 - Which frameworks it supports
-- Any existing skill files, agent configs, or playbooks
+- Any existing skill files, agent configs, or intents
 - Whether the library is a monorepo and which packages matter
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/intent",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Ship compositional knowledge for AI coding agents alongside your npm packages",
   "license": "MIT",
   "type": "module",
@@ -33,6 +33,7 @@
   },
   "scripts": {
     "build": "tsdown src/index.ts src/cli.ts src/setup.ts src/intent-library.ts src/library-scanner.ts --format esm --dts",
-    "test:lib": "vitest run"
+    "test:lib": "vitest run",
+    "test:types": "tsc --noEmit"
   }
 }