@zaganjade/pi-multi-skill 1.3.0 → 1.3.2

package/src/metadata.ts

@@ -1,170 +1,170 @@
-import { readFileSync } from "node:fs";
-import {
-	parseFrontmatter as parsePiFrontmatter,
-	stripFrontmatter as stripPiFrontmatter,
-} from "@earendil-works/pi-coding-agent";
-import type { EnrichedSkillInfo, LoadMode, SkillInfo, SkillMetadata, SkillOrder } from "./types.ts";
-
-const PROCESS_NAMES = new Set([
-	"using-superpowers",
-	"brainstorming",
-	"systematic-debugging",
-	"bmad-master",
-	"writing-plans",
-	"dispatching-parallel-agents",
-	"subagent-driven-development",
-	"executing-plans",
-]);
-
-const PLANNING_NAMES = new Set([
-	"analyst",
-	"pm",
-	"architect",
-	"ux-designer",
-	"scrum-master",
-]);
-
-function parseFrontmatter(content: string): Record<string, string> {
-	const { frontmatter } = parsePiFrontmatter<Record<string, unknown>>(content);
-	const fields: Record<string, string> = {};
-	for (const [key, value] of Object.entries(frontmatter)) {
-		if (value === undefined || value === null) continue;
-		fields[key] = String(value);
-	}
-	return fields;
-}
-
-export function stripFrontmatter(content: string): string {
-	return stripPiFrontmatter(content);
-}
-
-function parseListField(value: string | undefined): string[] {
-	if (!value) return [];
-	const trimmed = value.trim();
-	if (trimmed.startsWith("[")) {
-		try {
-			const parsed = JSON.parse(trimmed) as unknown;
-			if (Array.isArray(parsed)) {
-				return parsed.map(String).filter(Boolean);
-			}
-		} catch {
-			// fall through
-		}
-	}
-	return trimmed
-		.split(",")
-		.map((s) => s.trim())
-		.filter(Boolean);
-}
-
-function parseTokenBudget(value: string | undefined): LoadMode | undefined {
-	if (value === "meta" || value === "lazy" || value === "full") return value;
-	return undefined;
-}
-
-function extractCommands(body: string): string[] {
-	const commands: string[] = [];
-	const section = body.match(
-		/## Available Commands[\s\S]*?(?=\n## |\n# |$)/i,
-	);
-	if (!section) return commands;
-
-	for (const line of section[0].split("\n")) {
-		const match = line.match(/\*\*(\/[\w-]+)/);
-		if (match) commands.push(match[1]);
-	}
-	return commands;
-}
-
-function inferType(
-	name: string,
-	frontmatter: Record<string, string>,
-): SkillMetadata["type"] {
-	const explicit = frontmatter.type?.toLowerCase();
-	if (explicit === "process" || explicit === "rigid" || explicit === "flexible") {
-		return explicit;
-	}
-	if (PROCESS_NAMES.has(name)) return "process";
-	if (name.includes("debug") || name.includes("tdd")) return "rigid";
-	return "unknown";
-}
-
-function priorityScore(meta: SkillMetadata): number {
-	if (meta.type === "process") return 0;
-	if (PROCESS_NAMES.has(meta.name)) return 1;
-	if (PLANNING_NAMES.has(meta.name)) return 2;
-	if (meta.module === "core") return 1;
-	if (meta.module === "bmm") return 3;
-	return 4;
-}
-
-export function enrichSkill(skill: SkillInfo): EnrichedSkillInfo {
-	let rawContent = "";
-	try {
-		rawContent = readFileSync(skill.filePath, "utf-8");
-	} catch {
-		rawContent = "";
-	}
-
-	const frontmatter = parseFrontmatter(rawContent);
-	const body = stripFrontmatter(rawContent).trim();
-	const name = frontmatter.name || skill.name;
-	const description =
-		skill.description || frontmatter.description || truncateFirstLine(body);
-
-	const metadata: SkillMetadata = {
-		name,
-		description,
-		type: inferType(name, frontmatter),
-		module: frontmatter.module || "",
-		priority: Number.parseInt(frontmatter.priority || "50", 10) || 50,
-		commands: extractCommands(body),
-		skillId: frontmatter.skill_id || "",
-		version: frontmatter.version || "",
-		pairsWith: parseListField(frontmatter.pairs_with),
-		conflictsWith: parseListField(frontmatter.conflicts_with),
-		tokenBudget: parseTokenBudget(frontmatter.token_budget),
-	};
-
-	return { ...skill, name, description, metadata, rawContent, body };
-}
-
-function truncateFirstLine(body: string): string {
-	const line = body
-		.split("\n")
-		.map((l) => l.replace(/^>\s*/, "").trim())
-		.find((l) => l.length > 0);
-	return line?.slice(0, 120) ?? "";
-}
-
-export function sortSkills(
-	skills: EnrichedSkillInfo[],
-	order: SkillOrder = "process-first",
-): EnrichedSkillInfo[] {
-	if (order === "alpha") {
-		return [...skills].sort((a, b) => a.name.localeCompare(b.name));
-	}
-	if (order === "explicit") return skills;
-
-	return [...skills].sort((a, b) => {
-		const pa = priorityScore(a.metadata);
-		const pb = priorityScore(b.metadata);
-		if (pa !== pb) return pa - pb;
-		if (a.metadata.priority !== b.metadata.priority) {
-			return a.metadata.priority - b.metadata.priority;
-		}
-		return a.name.localeCompare(b.name);
-	});
-}
-
-export function truncateDescription(desc: string, maxLen = 120): string {
-	if (!desc) return "";
-	const lines = desc
-		.split("\n")
-		.map((l) => l.replace(/^>\s*/, "").trim())
-		.filter((l) => l.length > 0);
-	if (lines.length === 0) return "";
-	let text = lines[0];
-	if (lines.length > 1 && text.length < 40) text = `${text} ${lines[1]}`;
-	return text.length > maxLen ? `${text.slice(0, maxLen - 1)}…` : text;
-}
+import { readFileSync } from "node:fs";
+import {
+	parseFrontmatter as parsePiFrontmatter,
+	stripFrontmatter as stripPiFrontmatter,
+} from "@earendil-works/pi-coding-agent";
+import type { EnrichedSkillInfo, LoadMode, SkillInfo, SkillMetadata, SkillOrder } from "./types.ts";
+
+const PROCESS_NAMES = new Set([
+	"using-superpowers",
+	"brainstorming",
+	"systematic-debugging",
+	"bmad-master",
+	"writing-plans",
+	"dispatching-parallel-agents",
+	"subagent-driven-development",
+	"executing-plans",
+]);
+
+const PLANNING_NAMES = new Set([
+	"analyst",
+	"pm",
+	"architect",
+	"ux-designer",
+	"scrum-master",
+]);
+
+function parseFrontmatter(content: string): Record<string, string> {
+	const { frontmatter } = parsePiFrontmatter<Record<string, unknown>>(content);
+	const fields: Record<string, string> = {};
+	for (const [key, value] of Object.entries(frontmatter)) {
+		if (value === undefined || value === null) continue;
+		fields[key] = String(value);
+	}
+	return fields;
+}
+
+export function stripFrontmatter(content: string): string {
+	return stripPiFrontmatter(content);
+}
+
+function parseListField(value: string | undefined): string[] {
+	if (!value) return [];
+	const trimmed = value.trim();
+	if (trimmed.startsWith("[")) {
+		try {
+			const parsed = JSON.parse(trimmed) as unknown;
+			if (Array.isArray(parsed)) {
+				return parsed.map(String).filter(Boolean);
+			}
+		} catch {
+			// fall through
+		}
+	}
+	return trimmed
+		.split(",")
+		.map((s) => s.trim())
+		.filter(Boolean);
+}
+
+function parseTokenBudget(value: string | undefined): LoadMode | undefined {
+	if (value === "meta" || value === "lazy" || value === "full") return value;
+	return undefined;
+}
+
+function extractCommands(body: string): string[] {
+	const commands: string[] = [];
+	const section = body.match(
+		/## Available Commands[\s\S]*?(?=\n## |\n# |$)/i,
+	);
+	if (!section) return commands;
+
+	for (const line of section[0].split("\n")) {
+		const match = line.match(/\*\*(\/[\w-]+)/);
+		if (match) commands.push(match[1]);
+	}
+	return commands;
+}
+
+function inferType(
+	name: string,
+	frontmatter: Record<string, string>,
+): SkillMetadata["type"] {
+	const explicit = frontmatter.type?.toLowerCase();
+	if (explicit === "process" || explicit === "rigid" || explicit === "flexible") {
+		return explicit;
+	}
+	if (PROCESS_NAMES.has(name)) return "process";
+	if (name.includes("debug") || name.includes("tdd")) return "rigid";
+	return "unknown";
+}
+
+function priorityScore(meta: SkillMetadata): number {
+	if (meta.type === "process") return 0;
+	if (PROCESS_NAMES.has(meta.name)) return 1;
+	if (PLANNING_NAMES.has(meta.name)) return 2;
+	if (meta.module === "core") return 1;
+	if (meta.module === "bmm") return 3;
+	return 4;
+}
+
+export function enrichSkill(skill: SkillInfo): EnrichedSkillInfo {
+	let rawContent = "";
+	try {
+		rawContent = readFileSync(skill.filePath, "utf-8");
+	} catch {
+		rawContent = "";
+	}
+
+	const frontmatter = parseFrontmatter(rawContent);
+	const body = stripFrontmatter(rawContent).trim();
+	const name = frontmatter.name || skill.name;
+	const description =
+		skill.description || frontmatter.description || truncateFirstLine(body);
+
+	const metadata: SkillMetadata = {
+		name,
+		description,
+		type: inferType(name, frontmatter),
+		module: frontmatter.module || "",
+		priority: Number.parseInt(frontmatter.priority || "50", 10) || 50,
+		commands: extractCommands(body),
+		skillId: frontmatter.skill_id || "",
+		version: frontmatter.version || "",
+		pairsWith: parseListField(frontmatter.pairs_with),
+		conflictsWith: parseListField(frontmatter.conflicts_with),
+		tokenBudget: parseTokenBudget(frontmatter.token_budget),
+	};
+
+	return { ...skill, name, description, metadata, rawContent, body };
+}
+
+function truncateFirstLine(body: string): string {
+	const line = body
+		.split("\n")
+		.map((l) => l.replace(/^>\s*/, "").trim())
+		.find((l) => l.length > 0);
+	return line?.slice(0, 120) ?? "";
+}
+
+export function sortSkills(
+	skills: EnrichedSkillInfo[],
+	order: SkillOrder = "process-first",
+): EnrichedSkillInfo[] {
+	if (order === "alpha") {
+		return [...skills].sort((a, b) => a.name.localeCompare(b.name));
+	}
+	if (order === "explicit") return skills;
+
+	return [...skills].sort((a, b) => {
+		const pa = priorityScore(a.metadata);
+		const pb = priorityScore(b.metadata);
+		if (pa !== pb) return pa - pb;
+		if (a.metadata.priority !== b.metadata.priority) {
+			return a.metadata.priority - b.metadata.priority;
+		}
+		return a.name.localeCompare(b.name);
+	});
+}
+
+export function truncateDescription(desc: string, maxLen = 120): string {
+	if (!desc) return "";
+	const lines = desc
+		.split("\n")
+		.map((l) => l.replace(/^>\s*/, "").trim())
+		.filter((l) => l.length > 0);
+	if (lines.length === 0) return "";
+	let text = lines[0];
+	if (lines.length > 1 && text.length < 40) text = `${text} ${lines[1]}`;
+	return text.length > maxLen ? `${text.slice(0, maxLen - 1)}…` : text;
+}

package/src/parse-args.ts

@@ -1,80 +1,80 @@
-import type { LoadMode, ParsedSkillsArgs } from "./types.ts";
-
-const FLAG_MODES: Record<string, LoadMode> = {
-	"--meta": "meta",
-	"--full": "full",
-	"--lazy": "lazy",
-};
-
-export function parseSkillsArgs(raw: string): ParsedSkillsArgs {
-	let text = raw.trim();
-	let mode: LoadMode = "full";
-	let auto = false;
-	let parallel = false;
-
-	for (const [flag, loadMode] of Object.entries(FLAG_MODES)) {
-		if (text.includes(flag)) {
-			mode = loadMode;
-			text = text.replace(new RegExp(`\\s*${flag}\\b`, "g"), " ").trim();
-		}
-	}
-
-	if (/\s--auto\b/.test(text)) {
-		auto = true;
-		text = text.replace(/\s*--auto\b/g, " ").trim();
-	}
-
-	if (/\s--parallel\b/.test(text)) {
-		parallel = true;
-		text = text.replace(/\s*--parallel\b/g, " ").trim();
-	}
-
-	const tokens = text.match(/^(\S+)(?:\s+([\s\S]*))?$/);
-	if (!tokens) {
-		return {
-			skillNames: [],
-			mode,
-			auto,
-			parallel,
-			parallelTasks: [],
-			instructions: "",
-		};
-	}
-
-	const skillNames = tokens[1]
-		.split(",")
-		.map((s) => s.trim())
-		.filter((s) => s.length > 0);
-
-	let instructions = tokens[2]?.trim() ?? "";
-	let embeddedCommand: string | undefined;
-	let parallelTasks: string[] = [];
-
-	if (parallel && instructions.includes("|")) {
-		parallelTasks = instructions
-			.split("|")
-			.map((s) => s.trim())
-			.filter((s) => s.length > 0);
-		instructions = "";
-	} else if (parallel && instructions) {
-		parallelTasks = [instructions];
-	}
-
-	const cmdMatch = instructions.match(
-		/^(\/[\w-]+(?:\s+[^\n|]+)?)(?:\s+([\s\S]*))?$/,
-	);
-	if (cmdMatch && !parallel) {
-		embeddedCommand = cmdMatch[1].trim();
-		instructions = cmdMatch[2]?.trim() ?? "";
-	}
-
-	return {
-		skillNames,
-		mode,
-		auto,
-		parallel,
-		parallelTasks,
-		embeddedCommand,
-		instructions,
-	};
-}
+import type { LoadMode, ParsedSkillsArgs } from "./types.ts";
+
+const FLAG_MODES: Record<string, LoadMode> = {
+	"--meta": "meta",
+	"--full": "full",
+	"--lazy": "lazy",
+};
+
+export function parseSkillsArgs(raw: string): ParsedSkillsArgs {
+	let text = raw.trim();
+	let mode: LoadMode = "full";
+	let auto = false;
+	let parallel = false;
+
+	for (const [flag, loadMode] of Object.entries(FLAG_MODES)) {
+		if (text.includes(flag)) {
+			mode = loadMode;
+			text = text.replace(new RegExp(`\\s*${flag}\\b`, "g"), " ").trim();
+		}
+	}
+
+	if (/\s--auto\b/.test(text)) {
+		auto = true;
+		text = text.replace(/\s*--auto\b/g, " ").trim();
+	}
+
+	if (/\s--parallel\b/.test(text)) {
+		parallel = true;
+		text = text.replace(/\s*--parallel\b/g, " ").trim();
+	}
+
+	const tokens = text.match(/^(\S+)(?:\s+([\s\S]*))?$/);
+	if (!tokens) {
+		return {
+			skillNames: [],
+			mode,
+			auto,
+			parallel,
+			parallelTasks: [],
+			instructions: "",
+		};
+	}
+
+	const skillNames = tokens[1]
+		.split(",")
+		.map((s) => s.trim())
+		.filter((s) => s.length > 0);
+
+	let instructions = tokens[2]?.trim() ?? "";
+	let embeddedCommand: string | undefined;
+	let parallelTasks: string[] = [];
+
+	if (parallel && instructions.includes("|")) {
+		parallelTasks = instructions
+			.split("|")
+			.map((s) => s.trim())
+			.filter((s) => s.length > 0);
+		instructions = "";
+	} else if (parallel && instructions) {
+		parallelTasks = [instructions];
+	}
+
+	const cmdMatch = instructions.match(
+		/^(\/[\w-]+(?:\s+[^\n|]+)?)(?:\s+([\s\S]*))?$/,
+	);
+	if (cmdMatch && !parallel) {
+		embeddedCommand = cmdMatch[1].trim();
+		instructions = cmdMatch[2]?.trim() ?? "";
+	}
+
+	return {
+		skillNames,
+		mode,
+		auto,
+		parallel,
+		parallelTasks,
+		embeddedCommand,
+		instructions,
+	};
+}

package/src/registry.ts

@@ -1,46 +1,46 @@
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { enrichSkill } from "./metadata.ts";
-import type { SkillInfo } from "./types.ts";
-
-function getAgentDir(): string {
-	return join(homedir(), ".pi", "agent");
-}
-
-export function rebuildSkillIndex(skills: SkillInfo[]): void {
-	const index = {
-		updatedAt: new Date().toISOString(),
-		count: skills.length,
-		skills: skills.map((skill) => {
-			const enriched = enrichSkill(skill);
-			return {
-				name: enriched.name,
-				description: enriched.metadata.description,
-				type: enriched.metadata.type,
-				module: enriched.metadata.module,
-				priority: enriched.metadata.priority,
-				skillId: enriched.metadata.skillId,
-				version: enriched.metadata.version,
-				pairsWith: enriched.metadata.pairsWith,
-				conflictsWith: enriched.metadata.conflictsWith,
-				tokenBudget: enriched.metadata.tokenBudget,
-				commands: enriched.metadata.commands,
-				location: enriched.filePath,
-			};
-		}),
-	};
-
-	const dir = getAgentDir();
-	if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-
-	try {
-		writeFileSync(
-			join(dir, "skill-index.json"),
-			`${JSON.stringify(index, null, 2)}\n`,
-			"utf-8",
-		);
-	} catch {
-		// Non-fatal — index is optional
-	}
-}
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { enrichSkill } from "./metadata.ts";
+import type { SkillInfo } from "./types.ts";
+
+function getAgentDir(): string {
+	return join(homedir(), ".pi", "agent");
+}
+
+export function rebuildSkillIndex(skills: SkillInfo[]): void {
+	const index = {
+		updatedAt: new Date().toISOString(),
+		count: skills.length,
+		skills: skills.map((skill) => {
+			const enriched = enrichSkill(skill);
+			return {
+				name: enriched.name,
+				description: enriched.metadata.description,
+				type: enriched.metadata.type,
+				module: enriched.metadata.module,
+				priority: enriched.metadata.priority,
+				skillId: enriched.metadata.skillId,
+				version: enriched.metadata.version,
+				pairsWith: enriched.metadata.pairsWith,
+				conflictsWith: enriched.metadata.conflictsWith,
+				tokenBudget: enriched.metadata.tokenBudget,
+				commands: enriched.metadata.commands,
+				location: enriched.filePath,
+			};
+		}),
+	};
+
+	const dir = getAgentDir();
+	if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+
+	try {
+		writeFileSync(
+			join(dir, "skill-index.json"),
+			`${JSON.stringify(index, null, 2)}\n`,
+			"utf-8",
+		);
+	} catch {
+		// Non-fatal — index is optional
+	}
+}