@tanstack/intent 0.0.6 → 0.0.7

package/meta/tree-generator/SKILL.md

@@ -520,10 +520,18 @@ See also: [lib]-core/[other-domain]/SKILL.md § Common Mistakes
 The cross-reference ensures agents that load one skill are pointed
 toward the related skill where the other side of the tension lives.
 
+Also check the domain map's `cross_references` section for non-tension
+relationships between skills. For each cross-reference, add a "See also"
+line at the end of the relevant skill's body:
+
+```markdown
+See also: [other-skill]/SKILL.md — [reason]
+```
+
 ### Step 6 — Write composition skills (if applicable)
 
 Use the `compositions` entries from `domain_map.yaml` (populated during
-skill-domain-discovery Phase 2h) to identify which composition skills
+skill-domain-discovery Phase 3h) to identify which composition skills
 to produce.
 
 Composition skills cover how two or more libraries work together. These

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/intent",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Ship compositional knowledge for AI coding agents alongside your npm packages",
   "license": "MIT",
   "type": "module",

package/dist/feedback-BTSaBAS_.mjs

@@ -1,299 +0,0 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { execSync } from "node:child_process";
-
-//#region src/feedback.ts
-const META_FEEDBACK_REPO = "TanStack/intent";
-const SECRET_PATTERNS = [
-	/(?:ghp|gho|ghu|ghs|ghr)_[A-Za-z0-9_]{36,}/,
-	/(?:sk|pk)[-_](?:live|test)[-_][A-Za-z0-9]{24,}/,
-	/AKIA[0-9A-Z]{16}/,
-	/-----BEGIN (?:RSA |EC )?PRIVATE KEY-----/,
-	/eyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}/,
-	/(?:Bearer|token)\s+[A-Za-z0-9_\-.~+/]{20,}/i,
-	/[A-Za-z0-9]{32,}(?=.*(?:key|secret|token|password))/i
-];
-function containsSecrets(text) {
-	return SECRET_PATTERNS.some((pattern) => pattern.test(text));
-}
-function hasGhCli() {
-	try {
-		execSync("gh --version", { stdio: "ignore" });
-		return true;
-	} catch {
-		return false;
-	}
-}
-function getHomeConfigDir() {
-	return process.env.XDG_CONFIG_HOME ?? join(process.env.HOME ?? process.env.USERPROFILE ?? "", ".config");
-}
-function resolveFrequency(root) {
-	const userConfigPath = join(getHomeConfigDir(), "intent", "config.json");
-	try {
-		const userCfg = JSON.parse(readFileSync(userConfigPath, "utf8"));
-		if (userCfg.feedback?.frequency) return userCfg.feedback.frequency;
-	} catch {}
-	const projectConfigPath = join(root, "intent.config.json");
-	try {
-		const projCfg = JSON.parse(readFileSync(projectConfigPath, "utf8"));
-		if (projCfg.feedback?.frequency) return projCfg.feedback.frequency;
-	} catch {}
-	return "every-5";
-}
-const REQUIRED_FIELDS = [
-	"skill",
-	"package",
-	"skillVersion",
-	"task",
-	"whatWorked",
-	"whatFailed",
-	"missing",
-	"selfCorrections",
-	"userRating"
-];
-function validatePayload(payload) {
-	const errors = [];
-	if (!payload || typeof payload !== "object") return {
-		valid: false,
-		errors: ["Payload must be a JSON object"]
-	};
-	const obj = payload;
-	for (const field of REQUIRED_FIELDS) if (typeof obj[field] !== "string" || obj[field].trim() === "") errors.push(`Missing or empty required field: ${field}`);
-	if (obj.userRating && ![
-		"good",
-		"mixed",
-		"bad"
-	].includes(obj.userRating)) errors.push("userRating must be one of: good, mixed, bad");
-	if (containsSecrets(Object.values(obj).filter((v) => typeof v === "string").join("\n"))) errors.push("Payload appears to contain secrets or tokens — submission rejected");
-	return {
-		valid: errors.length === 0,
-		errors
-	};
-}
-const META_REQUIRED_FIELDS = [
-	"metaSkill",
-	"library",
-	"agentUsed",
-	"artifactQuality",
-	"whatWorked",
-	"whatFailed",
-	"suggestions",
-	"userRating"
-];
-const VALID_META_SKILLS = [
-	"domain-discovery",
-	"tree-generator",
-	"generate-skill",
-	"skill-staleness-check"
-];
-const VALID_AGENTS = [
-	"claude-code",
-	"cursor",
-	"copilot",
-	"codex",
-	"other"
-];
-const VALID_QUALITY_RATINGS = [
-	"good",
-	"mixed",
-	"bad"
-];
-function validateMetaPayload(payload) {
-	const errors = [];
-	if (!payload || typeof payload !== "object") return {
-		valid: false,
-		errors: ["Payload must be a JSON object"]
-	};
-	const obj = payload;
-	for (const field of META_REQUIRED_FIELDS) if (typeof obj[field] !== "string" || obj[field].trim() === "") errors.push(`Missing or empty required field: ${field}`);
-	if (obj.metaSkill && !VALID_META_SKILLS.includes(obj.metaSkill)) errors.push(`metaSkill must be one of: ${VALID_META_SKILLS.join(", ")}`);
-	if (obj.agentUsed && !VALID_AGENTS.includes(obj.agentUsed)) errors.push(`agentUsed must be one of: ${VALID_AGENTS.join(", ")}`);
-	if (obj.artifactQuality && !VALID_QUALITY_RATINGS.includes(obj.artifactQuality)) errors.push("artifactQuality must be one of: good, mixed, bad");
-	if (obj.userRating && !VALID_QUALITY_RATINGS.includes(obj.userRating)) errors.push("userRating must be one of: good, mixed, bad");
-	if (containsSecrets(Object.values(obj).filter((v) => typeof v === "string").join("\n"))) errors.push("Payload appears to contain secrets or tokens — submission rejected");
-	return {
-		valid: errors.length === 0,
-		errors
-	};
-}
-function metaToMarkdown(payload) {
-	const lines = [
-		`# Meta-Skill Feedback: ${payload.metaSkill}`,
-		"",
-		`**Library:** ${payload.library}`,
-		`**Agent:** ${payload.agentUsed}`,
-		`**Artifact quality:** ${payload.artifactQuality}`,
-		`**Rating:** ${payload.userRating}`
-	];
-	if (payload.interviewQuality) lines.push(`**Interview quality:** ${payload.interviewQuality}`);
-	if (payload.failureModeQuality) lines.push(`**Failure mode quality:** ${payload.failureModeQuality}`);
-	lines.push("", "## What Worked", payload.whatWorked, "", "## What Failed", payload.whatFailed, "", "## Suggestions", payload.suggestions);
-	return lines.join("\n") + "\n";
-}
-function toMarkdown(payload) {
-	const lines = [
-		`# Skill Feedback: ${payload.skill}`,
-		"",
-		`**Package:** ${payload.package}`,
-		`**Skill version:** ${payload.skillVersion}`,
-		`**Rating:** ${payload.userRating}`,
-		"",
-		"## Task",
-		payload.task,
-		"",
-		"## What Worked",
-		payload.whatWorked,
-		"",
-		"## What Failed",
-		payload.whatFailed,
-		"",
-		"## Missing",
-		payload.missing,
-		"",
-		"## Self-Corrections",
-		payload.selfCorrections
-	];
-	if (payload.userComments) lines.push("", "## User Comments", payload.userComments);
-	return lines.join("\n") + "\n";
-}
-function submitFeedback(payload, repo, opts) {
-	const md = toMarkdown(payload);
-	if (opts.ghAvailable) try {
-		execSync(`gh issue create --repo ${repo} --title "${`Skill Feedback: ${payload.skill} (${payload.userRating})`.replace(/"/g, "\\\"")}" --body -`, {
-			input: md,
-			stdio: [
-				"pipe",
-				"pipe",
-				"pipe"
-			]
-		});
-		return {
-			method: "gh",
-			detail: `Submitted issue to ${repo}`
-		};
-	} catch {}
-	if (opts.outputPath) {
-		writeFileSync(opts.outputPath, md, "utf8");
-		return {
-			method: "file",
-			detail: `Saved to ${opts.outputPath}`
-		};
-	}
-	return {
-		method: "stdout",
-		detail: md
-	};
-}
-function submitMetaFeedback(payload, opts) {
-	const md = metaToMarkdown(payload);
-	if (opts.ghAvailable) try {
-		execSync(`gh issue create --repo ${META_FEEDBACK_REPO} --title "${`Meta-Skill Feedback: ${payload.metaSkill} (${payload.userRating})`.replace(/"/g, "\\\"")}" --label "feedback:${payload.metaSkill}" --body -`, {
-			input: md,
-			stdio: [
-				"pipe",
-				"pipe",
-				"pipe"
-			]
-		});
-		return {
-			method: "gh",
-			detail: `Submitted issue to ${META_FEEDBACK_REPO}`
-		};
-	} catch {}
-	if (opts.outputPath) {
-		writeFileSync(opts.outputPath, md, "utf8");
-		return {
-			method: "file",
-			detail: `Saved to ${opts.outputPath}`
-		};
-	}
-	return {
-		method: "stdout",
-		detail: md
-	};
-}
-function runFeedback(args) {
-	const isMeta = args.includes("--meta");
-	const submitFlag = args.includes("--submit");
-	const fileIdx = args.indexOf("--file");
-	const filePath = fileIdx !== -1 ? args[fileIdx + 1] : void 0;
-	if (!submitFlag || !filePath) {
-		if (isMeta) console.error("Usage: intent feedback --meta --submit --file <path>");
-		else console.error("Usage: intent feedback --submit --file <path>");
-		process.exit(1);
-	}
-	if (!existsSync(filePath)) {
-		console.error(`File not found: ${filePath}`);
-		process.exit(1);
-	}
-	let raw;
-	try {
-		raw = JSON.parse(readFileSync(filePath, "utf8"));
-	} catch {
-		console.error("Invalid JSON in feedback file");
-		process.exit(1);
-	}
-	const ghAvailable = hasGhCli();
-	if (resolveFrequency(process.cwd()) === "never") {
-		console.log("Feedback is disabled (frequency: never)");
-		return;
-	}
-	const dateSuffix = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-	if (isMeta) {
-		const validation$1 = validateMetaPayload(raw);
-		if (!validation$1.valid) {
-			console.error("Meta-feedback validation failed:");
-			for (const err of validation$1.errors) console.error(`  - ${err}`);
-			process.exit(1);
-		}
-		const payload$1 = raw;
-		const fallbackPath$1 = `intent-meta-feedback-${dateSuffix}.md`;
-		const result$1 = submitMetaFeedback(payload$1, {
-			ghAvailable,
-			outputPath: ghAvailable ? void 0 : fallbackPath$1
-		});
-		switch (result$1.method) {
-			case "gh":
-				console.log(`✓ ${result$1.detail}`);
-				break;
-			case "file":
-				console.log(`✓ ${result$1.detail}`);
-				console.log(`You can manually open an issue at https://github.com/${META_FEEDBACK_REPO}/issues with this content.`);
-				break;
-			case "stdout":
-				console.log("--- Meta-feedback markdown (copy/paste to issue) ---");
-				console.log(result$1.detail);
-				break;
-		}
-		return;
-	}
-	const validation = validatePayload(raw);
-	if (!validation.valid) {
-		console.error("Feedback validation failed:");
-		for (const err of validation.errors) console.error(`  - ${err}`);
-		process.exit(1);
-	}
-	const payload = raw;
-	const repo = payload.package.replace(/^@/, "").replace(/\//, "/");
-	const fallbackPath = `intent-feedback-${dateSuffix}.md`;
-	const result = submitFeedback(payload, repo, {
-		ghAvailable,
-		outputPath: ghAvailable ? void 0 : fallbackPath
-	});
-	switch (result.method) {
-		case "gh":
-			console.log(`✓ ${result.detail}`);
-			break;
-		case "file":
-			console.log(`✓ ${result.detail}`);
-			console.log("You can manually open an issue with this content.");
-			break;
-		case "stdout":
-			console.log("--- Feedback markdown (copy/paste to issue) ---");
-			console.log(result.detail);
-			break;
-	}
-}
-
-//#endregion
-export { runFeedback as a, toMarkdown as c, resolveFrequency as i, validateMetaPayload as l, hasGhCli as n, submitFeedback as o, metaToMarkdown as r, submitMetaFeedback as s, containsSecrets as t, validatePayload as u };

package/dist/feedback-PR8JNBfM.mjs

@@ -1,3 +0,0 @@
-import { a as runFeedback, c as toMarkdown, i as resolveFrequency, l as validateMetaPayload, n as hasGhCli, o as submitFeedback, r as metaToMarkdown, s as submitMetaFeedback, t as containsSecrets, u as validatePayload } from "./feedback-BTSaBAS_.mjs";
-
-export { runFeedback };

package/dist/init-BU1ZnUbK.mjs

@@ -1,3 +0,0 @@
-import { a as runInit, i as readProjectConfig, n as hasIntentBlock, o as writeProjectConfig, r as injectIntentBlock, t as detectAgentConfigs } from "./init-DUiDMMrN.mjs";
-
-export { detectAgentConfigs, runInit };

package/dist/init-DUiDMMrN.mjs

@@ -1,72 +0,0 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-
-//#region src/init.ts
-const AGENT_CONFIG_FILES = [
-	"AGENTS.md",
-	"CLAUDE.md",
-	".cursorrules",
-	".github/copilot-instructions.md"
-];
-const INTENT_BLOCK_MARKER = "## Intent Skills";
-const INTENT_BLOCK = `## Intent Skills
-
-This project uses TanStack Intent. Run \`npx intent list\` to discover
-available AI coding skills. Before working with a library that has skills,
-read the relevant SKILL.md file at the path shown in the list output.
-After completing a task that used skills, collect and submit feedback
-following the instructions in the list output.
-`;
-const DEFAULT_CONFIG = { feedback: { frequency: "every-5" } };
-function detectAgentConfigs(root) {
-	return AGENT_CONFIG_FILES.map((f) => join(root, f)).filter((f) => existsSync(f));
-}
-function hasIntentBlock(filePath) {
-	try {
-		return readFileSync(filePath, "utf8").includes(INTENT_BLOCK_MARKER);
-	} catch {
-		return false;
-	}
-}
-function injectIntentBlock(filePath) {
-	if (hasIntentBlock(filePath)) return false;
-	let content;
-	try {
-		content = readFileSync(filePath, "utf8");
-	} catch {
-		content = "";
-	}
-	const separator = content.length > 0 && !content.endsWith("\n\n") ? "\n\n" : "";
-	writeFileSync(filePath, content + separator + INTENT_BLOCK);
-	return true;
-}
-function writeProjectConfig(root) {
-	const configPath = join(root, "intent.config.json");
-	if (!existsSync(configPath)) writeFileSync(configPath, JSON.stringify(DEFAULT_CONFIG, null, 2) + "\n");
-	return configPath;
-}
-function readProjectConfig(root) {
-	const configPath = join(root, "intent.config.json");
-	try {
-		return JSON.parse(readFileSync(configPath, "utf8"));
-	} catch {
-		return null;
-	}
-}
-function runInit(root) {
-	const detected = detectAgentConfigs(root);
-	const injected = [];
-	const skipped = [];
-	const created = [];
-	for (const filePath of detected) if (injectIntentBlock(filePath)) injected.push(filePath);
-	else skipped.push(filePath);
-	return {
-		injected,
-		skipped,
-		created,
-		configPath: writeProjectConfig(root)
-	};
-}
-
-//#endregion
-export { runInit as a, readProjectConfig as i, hasIntentBlock as n, writeProjectConfig as o, injectIntentBlock as r, detectAgentConfigs as t };