pi-crew 0.2.3 → 0.2.5

package/src/adapters/claude-adapter.ts

@@ -1,25 +1,25 @@
-import type { ExportAdapter, ExportContent } from "./types.ts";
-
-export const claudeAdapter: ExportAdapter = {
-	toolId: "claude",
-	toolName: "Claude Code",
-	fileExtension: ".md",
-
-	getFilePath(content: ExportContent): string {
-		return `.claude/commands/pi-crew/${content.id}.md`;
-	},
-
-	formatFile(content: ExportContent): string {
-		const tagLines = content.tags.length > 0
-			? ["tags:", ...content.tags.map((tag) => `  - ${JSON.stringify(tag)}`)]
-			: [];
-		const frontmatter = [
-			"---",
-			`description: ${JSON.stringify(content.description)}`,
-			`category: ${JSON.stringify(content.category)}`,
-			...tagLines,
-			"---",
-		].join("\n");
-		return `${frontmatter}\n\n# ${content.name}\n\n${content.body}\n`;
-	},
-};
+import type { ExportAdapter, ExportContent } from "./types.ts";
+
+export const claudeAdapter: ExportAdapter = {
+	toolId: "claude",
+	toolName: "Claude Code",
+	fileExtension: ".md",
+
+	getFilePath(content: ExportContent): string {
+		return `.claude/commands/pi-crew/${content.id}.md`;
+	},
+
+	formatFile(content: ExportContent): string {
+		const tagLines = content.tags.length > 0
+			? ["tags:", ...content.tags.map((tag) => `  - ${JSON.stringify(tag)}`)]
+			: [];
+		const frontmatter = [
+			"---",
+			`description: ${JSON.stringify(content.description)}`,
+			`category: ${JSON.stringify(content.category)}`,
+			...tagLines,
+			"---",
+		].join("\n");
+		return `${frontmatter}\n\n# ${content.name}\n\n${content.body}\n`;
+	},
+};

package/src/adapters/codex-adapter.ts

@@ -1,21 +1,21 @@
-import type { ExportAdapter, ExportContent } from "./types.ts";
-
-export const codexAdapter: ExportAdapter = {
-	toolId: "codex",
-	toolName: "Codex",
-	fileExtension: ".md",
-
-	getFilePath(_content: ExportContent): string {
-		return "AGENTS.md";
-	},
-
-	formatFile(content: ExportContent): string {
-		const tags = content.tags.length > 0 ? ` (${content.tags.join(", ")})` : "";
-		return [
-			`## ${content.name}${tags}\n`,
-			`**Source:** ${content.source.type}/${content.source.name}  `,
-			`**Category:** ${content.category}\n`,
-			content.body,
-		].join("\n");
-	},
-};
+import type { ExportAdapter, ExportContent } from "./types.ts";
+
+export const codexAdapter: ExportAdapter = {
+	toolId: "codex",
+	toolName: "Codex",
+	fileExtension: ".md",
+
+	getFilePath(_content: ExportContent): string {
+		return "AGENTS.md";
+	},
+
+	formatFile(content: ExportContent): string {
+		const tags = content.tags.length > 0 ? ` (${content.tags.join(", ")})` : "";
+		return [
+			`## ${content.name}${tags}\n`,
+			`**Source:** ${content.source.type}/${content.source.name}  `,
+			`**Category:** ${content.category}\n`,
+			content.body,
+		].join("\n");
+	},
+};

package/src/adapters/cursor-adapter.ts

@@ -1,17 +1,17 @@
-import type { ExportAdapter, ExportContent } from "./types.ts";
-
-export const cursorAdapter: ExportAdapter = {
-	toolId: "cursor",
-	toolName: "Cursor",
-	fileExtension: ".md",
-
-	getFilePath(content: ExportContent): string {
-		return `.cursor/rules/pi-crew-${content.id}.md`;
-	},
-
-	formatFile(content: ExportContent): string {
-		const header = `# ${content.name}\n\n> ${content.description}`;
-		const tags = content.tags.length > 0 ? `\n\n**Tags:** ${content.tags.join(", ")}` : "";
-		return `${header}${tags}\n\n${content.body}\n`;
-	},
-};
+import type { ExportAdapter, ExportContent } from "./types.ts";
+
+export const cursorAdapter: ExportAdapter = {
+	toolId: "cursor",
+	toolName: "Cursor",
+	fileExtension: ".md",
+
+	getFilePath(content: ExportContent): string {
+		return `.cursor/rules/pi-crew-${content.id}.md`;
+	},
+
+	formatFile(content: ExportContent): string {
+		const header = `# ${content.name}\n\n> ${content.description}`;
+		const tags = content.tags.length > 0 ? `\n\n**Tags:** ${content.tags.join(", ")}` : "";
+		return `${header}${tags}\n\n${content.body}\n`;
+	},
+};

package/src/adapters/export-util.ts

@@ -1,137 +1,137 @@
-import type { AgentConfig } from "../agents/agent-config.ts";
-import type { TeamConfig } from "../teams/team-config.ts";
-import type { WorkflowConfig } from "../workflows/workflow-config.ts";
-import type { SkillDescriptor } from "../skills/discover-skills.ts";
-import type { ExportContent } from "./types.ts";
-import { adapterRegistry } from "./registry.ts";
-import { resolveContainedPath } from "../utils/safe-paths.ts";
-
-function slugify(value: string): string {
-	return value
-		.toLowerCase()
-		.replace(/[^a-z0-9]+/g, "-")
-		.replace(/^-+|-+$/g, "");
-}
-
-export function agentToExportContent(agent: AgentConfig): ExportContent {
-	const category = agent.routing?.category ?? "agent";
-	const tags = agent.routing?.triggers ?? [];
-	return {
-		id: slugify(agent.name),
-		name: agent.name,
-		description: agent.description,
-		category,
-		tags,
-		body: agent.systemPrompt,
-		source: { type: "agent", name: agent.name },
-	};
-}
-
-export function teamToExportContent(team: TeamConfig): ExportContent {
-	const category = team.routing?.category ?? "team";
-	const tags = team.routing?.triggers ?? [];
-	const rolesDesc = team.roles
-		.map((role) => `- **${role.name}**: ${role.description ?? role.agent}`)
-		.join("\n");
-	const body = `${team.description}\n\n### Roles\n${rolesDesc}`;
-	return {
-		id: slugify(team.name),
-		name: team.name,
-		description: team.description,
-		category,
-		tags,
-		body,
-		source: { type: "team", name: team.name },
-	};
-}
-
-export function workflowToExportContent(workflow: WorkflowConfig): ExportContent {
-	const stepsDesc = workflow.steps
-		.map((step) => `- **${step.id}** (${step.role}): ${step.task}`)
-		.join("\n");
-	const body = `${workflow.description}\n\n### Steps\n${stepsDesc}`;
-	return {
-		id: slugify(workflow.name),
-		name: workflow.name,
-		description: workflow.description,
-		category: "workflow",
-		tags: [],
-		body,
-		source: { type: "workflow", name: workflow.name },
-	};
-}
-
-export function skillToExportContent(skill: SkillDescriptor): ExportContent {
-	return {
-		id: slugify(skill.name),
-		name: skill.name,
-		description: skill.description || `Skill: ${skill.name}`,
-		category: "skill",
-		tags: [],
-		body: `Skill loaded from ${skill.source}: ${skill.path}`,
-		source: { type: "skill", name: skill.name },
-	};
-}
-
-export type ExportableResource =
-	| { kind: "agent"; config: AgentConfig }
-	| { kind: "team"; config: TeamConfig }
-	| { kind: "workflow"; config: WorkflowConfig }
-	| { kind: "skill"; config: SkillDescriptor };
-
-export function resourcesToExportContent(resources: ExportableResource[]): ExportContent[] {
-	return resources.map((resource): ExportContent => {
-		switch (resource.kind) {
-			case "agent":
-				return agentToExportContent(resource.config);
-			case "team":
-				return teamToExportContent(resource.config);
-			case "workflow":
-				return workflowToExportContent(resource.config);
-			case "skill":
-				return skillToExportContent(resource.config);
-		}
-	});
-}
-
-export interface ToolExportResult {
-	toolId: string;
-	files: Array<{ path: string; content: string }>;
-}
-
-export function generateToolExport(
-	toolId: string,
-	resources: ExportableResource[],
-	projectRoot?: string,
-): ToolExportResult {
-	const adapter = adapterRegistry.get(toolId);
-	if (!adapter) {
-		throw new Error(`Unknown export adapter: ${toolId}. Available: ${adapterRegistry.getAll().map((a) => a.toolId).join(", ")}`);
-	}
-	const contents = resourcesToExportContent(resources);
-	const files = contents.map((content): { path: string; content: string } => {
-		const filePath = adapter.getFilePath(content);
-		// Validate path containment when a project root is provided
-		if (projectRoot) {
-			try {
-				resolveContainedPath(projectRoot, filePath);
-			} catch (e) {
-				throw new Error(
-					`Export path '${filePath}' escapes project root '${projectRoot}': ${e instanceof Error ? e.message : String(e)}`,
-				);
-			}
-		}
-		return {
-			path: filePath,
-			content: adapter.formatFile(content),
-		};
-	});
-	// Merge duplicate file paths (e.g., codex adapter maps everything to AGENTS.md)
-	const merged = new Map<string, string>();
-	for (const f of files) {
-		const existing = merged.get(f.path);
-		merged.set(f.path, existing ? `${existing}\n\n${f.content}` : f.content);
-	}
-	const mergedFiles = [...merged.entries()].map(([p, content]) => ({ path: p, content }));
-	return { toolId, files: mergedFiles };
-}
+import type { AgentConfig } from "../agents/agent-config.ts";
+import type { TeamConfig } from "../teams/team-config.ts";
+import type { WorkflowConfig } from "../workflows/workflow-config.ts";
+import type { SkillDescriptor } from "../skills/discover-skills.ts";
+import type { ExportContent } from "./types.ts";
+import { adapterRegistry } from "./registry.ts";
+import { resolveContainedPath } from "../utils/safe-paths.ts";
+
+function slugify(value: string): string {
+	return value
+		.toLowerCase()
+		.replace(/[^a-z0-9]+/g, "-")
+		.replace(/^-+|-+$/g, "");
+}
+
+export function agentToExportContent(agent: AgentConfig): ExportContent {
+	const category = agent.routing?.category ?? "agent";
+	const tags = agent.routing?.triggers ?? [];
+	return {
+		id: slugify(agent.name),
+		name: agent.name,
+		description: agent.description,
+		category,
+		tags,
+		body: agent.systemPrompt,
+		source: { type: "agent", name: agent.name },
+	};
+}
+
+export function teamToExportContent(team: TeamConfig): ExportContent {
+	const category = team.routing?.category ?? "team";
+	const tags = team.routing?.triggers ?? [];
+	const rolesDesc = team.roles
+		.map((role) => `- **${role.name}**: ${role.description ?? role.agent}`)
+		.join("\n");
+	const body = `${team.description}\n\n### Roles\n${rolesDesc}`;
+	return {
+		id: slugify(team.name),
+		name: team.name,
+		description: team.description,
+		category,
+		tags,
+		body,
+		source: { type: "team", name: team.name },
+	};
+}
+
+export function workflowToExportContent(workflow: WorkflowConfig): ExportContent {
+	const stepsDesc = workflow.steps
+		.map((step) => `- **${step.id}** (${step.role}): ${step.task}`)
+		.join("\n");
+	const body = `${workflow.description}\n\n### Steps\n${stepsDesc}`;
+	return {
+		id: slugify(workflow.name),
+		name: workflow.name,
+		description: workflow.description,
+		category: "workflow",
+		tags: [],
+		body,
+		source: { type: "workflow", name: workflow.name },
+	};
+}
+
+export function skillToExportContent(skill: SkillDescriptor): ExportContent {
+	return {
+		id: slugify(skill.name),
+		name: skill.name,
+		description: skill.description || `Skill: ${skill.name}`,
+		category: "skill",
+		tags: [],
+		body: `Skill loaded from ${skill.source}: ${skill.path}`,
+		source: { type: "skill", name: skill.name },
+	};
+}
+
+export type ExportableResource =
+	| { kind: "agent"; config: AgentConfig }
+	| { kind: "team"; config: TeamConfig }
+	| { kind: "workflow"; config: WorkflowConfig }
+	| { kind: "skill"; config: SkillDescriptor };
+
+export function resourcesToExportContent(resources: ExportableResource[]): ExportContent[] {
+	return resources.map((resource): ExportContent => {
+		switch (resource.kind) {
+			case "agent":
+				return agentToExportContent(resource.config);
+			case "team":
+				return teamToExportContent(resource.config);
+			case "workflow":
+				return workflowToExportContent(resource.config);
+			case "skill":
+				return skillToExportContent(resource.config);
+		}
+	});
+}
+
+export interface ToolExportResult {
+	toolId: string;
+	files: Array<{ path: string; content: string }>;
+}
+
+export function generateToolExport(
+	toolId: string,
+	resources: ExportableResource[],
+	projectRoot?: string,
+): ToolExportResult {
+	const adapter = adapterRegistry.get(toolId);
+	if (!adapter) {
+		throw new Error(`Unknown export adapter: ${toolId}. Available: ${adapterRegistry.getAll().map((a) => a.toolId).join(", ")}`);
+	}
+	const contents = resourcesToExportContent(resources);
+	const files = contents.map((content): { path: string; content: string } => {
+		const filePath = adapter.getFilePath(content);
+		// Validate path containment when a project root is provided
+		if (projectRoot) {
+			try {
+				resolveContainedPath(projectRoot, filePath);
+			} catch (e) {
+				throw new Error(
+					`Export path '${filePath}' escapes project root '${projectRoot}': ${e instanceof Error ? e.message : String(e)}`,
+				);
+			}
+		}
+		return {
+			path: filePath,
+			content: adapter.formatFile(content),
+		};
+	});
+	// Merge duplicate file paths (e.g., codex adapter maps everything to AGENTS.md)
+	const merged = new Map<string, string>();
+	for (const f of files) {
+		const existing = merged.get(f.path);
+		merged.set(f.path, existing ? `${existing}\n\n${f.content}` : f.content);
+	}
+	const mergedFiles = [...merged.entries()].map(([p, content]) => ({ path: p, content }));
+	return { toolId, files: mergedFiles };
+}

package/src/adapters/index.ts

@@ -1,15 +1,15 @@
-export type { ExportContent, ExportAdapter, AdapterRegistry } from "./types.ts";
-export { createAdapterRegistry, adapterRegistry } from "./registry.ts";
-export { claudeAdapter } from "./claude-adapter.ts";
-export { cursorAdapter } from "./cursor-adapter.ts";
-export { codexAdapter } from "./codex-adapter.ts";
-export { generateToolExport, resourcesToExportContent } from "./export-util.ts";
-
-import { adapterRegistry } from "./registry.ts";
-import { claudeAdapter } from "./claude-adapter.ts";
-import { cursorAdapter } from "./cursor-adapter.ts";
-import { codexAdapter } from "./codex-adapter.ts";
-
-adapterRegistry.register(claudeAdapter);
-adapterRegistry.register(cursorAdapter);
-adapterRegistry.register(codexAdapter);
+export type { ExportContent, ExportAdapter, AdapterRegistry } from "./types.ts";
+export { createAdapterRegistry, adapterRegistry } from "./registry.ts";
+export { claudeAdapter } from "./claude-adapter.ts";
+export { cursorAdapter } from "./cursor-adapter.ts";
+export { codexAdapter } from "./codex-adapter.ts";
+export { generateToolExport, resourcesToExportContent } from "./export-util.ts";
+
+import { adapterRegistry } from "./registry.ts";
+import { claudeAdapter } from "./claude-adapter.ts";
+import { cursorAdapter } from "./cursor-adapter.ts";
+import { codexAdapter } from "./codex-adapter.ts";
+
+adapterRegistry.register(claudeAdapter);
+adapterRegistry.register(cursorAdapter);
+adapterRegistry.register(codexAdapter);

package/src/adapters/registry.ts

@@ -1,18 +1,18 @@
-import type { AdapterRegistry, ExportAdapter } from "./types.ts";
-
-export function createAdapterRegistry(): AdapterRegistry {
-	const adapters = new Map<string, ExportAdapter>();
-	return {
-		get(toolId: string): ExportAdapter | undefined {
-			return adapters.get(toolId);
-		},
-		getAll(): ExportAdapter[] {
-			return [...adapters.values()];
-		},
-		register(adapter: ExportAdapter): void {
-			adapters.set(adapter.toolId, adapter);
-		},
-	};
-}
-
-export const adapterRegistry: AdapterRegistry = createAdapterRegistry();
+import type { AdapterRegistry, ExportAdapter } from "./types.ts";
+
+export function createAdapterRegistry(): AdapterRegistry {
+	const adapters = new Map<string, ExportAdapter>();
+	return {
+		get(toolId: string): ExportAdapter | undefined {
+			return adapters.get(toolId);
+		},
+		getAll(): ExportAdapter[] {
+			return [...adapters.values()];
+		},
+		register(adapter: ExportAdapter): void {
+			adapters.set(adapter.toolId, adapter);
+		},
+	};
+}
+
+export const adapterRegistry: AdapterRegistry = createAdapterRegistry();

package/src/adapters/types.ts

@@ -1,23 +1,23 @@
-export interface ExportContent {
-	id: string;
-	name: string;
-	description: string;
-	category: string;
-	tags: string[];
-	body: string;
-	source: { type: "agent" | "team" | "workflow" | "skill"; name: string };
-}
-
-export interface ExportAdapter {
-	readonly toolId: string;
-	readonly toolName: string;
-	readonly fileExtension: string;
-	getFilePath(content: ExportContent): string;
-	formatFile(content: ExportContent): string;
-}
-
-export interface AdapterRegistry {
-	get(toolId: string): ExportAdapter | undefined;
-	getAll(): ExportAdapter[];
-	register(adapter: ExportAdapter): void;
-}
+export interface ExportContent {
+	id: string;
+	name: string;
+	description: string;
+	category: string;
+	tags: string[];
+	body: string;
+	source: { type: "agent" | "team" | "workflow" | "skill"; name: string };
+}
+
+export interface ExportAdapter {
+	readonly toolId: string;
+	readonly toolName: string;
+	readonly fileExtension: string;
+	getFilePath(content: ExportContent): string;
+	formatFile(content: ExportContent): string;
+}
+
+export interface AdapterRegistry {
+	get(toolId: string): ExportAdapter | undefined;
+	getAll(): ExportAdapter[];
+	register(adapter: ExportAdapter): void;
+}

package/src/agents/agent-config.ts

@@ -1,38 +1,38 @@
-export type ResourceSource = "builtin" | "user" | "project" | "git";
-
-export interface RoutingMetadata {
-	triggers?: string[];
-	useWhen?: string[];
-	avoidWhen?: string[];
-	cost?: "free" | "cheap" | "expensive";
-	category?: string;
-}
-
-export interface AgentConfig {
-	name: string;
-	description: string;
-	source: ResourceSource;
-	filePath: string;
-	systemPrompt: string;
-	model?: string;
-	fallbackModels?: string[];
-	thinking?: string;
-	tools?: string[];
-	extensions?: string[];
-	skills?: string[];
-	systemPromptMode?: "replace" | "append";
-	inheritProjectContext?: boolean;
-	inheritSkills?: boolean;
-	routing?: RoutingMetadata;
-	memory?: "user" | "project" | "local";
-	/** Tool loading strategy: "essential" = always load all tools, "lean" = only load tools in defaultTools list */
-	loadMode?: "essential" | "lean";
-	/** Explicit tool list when loadMode is "lean". null means all available tools. */
-	defaultTools?: string[] | null;
-	/** Context mode: "fresh" = clean start, "fork" = inherit parent session context */
-	contextMode?: "fresh" | "fork";
-	/** Maximum turns for this agent. Overrides runtime config if set. */
-	maxTurns?: number;
-	disabled?: boolean;
-	override?: { source: "config"; path: string };
-}
+export type ResourceSource = "builtin" | "user" | "project" | "git";
+
+export interface RoutingMetadata {
+	triggers?: string[];
+	useWhen?: string[];
+	avoidWhen?: string[];
+	cost?: "free" | "cheap" | "expensive";
+	category?: string;
+}
+
+export interface AgentConfig {
+	name: string;
+	description: string;
+	source: ResourceSource;
+	filePath: string;
+	systemPrompt: string;
+	model?: string;
+	fallbackModels?: string[];
+	thinking?: string;
+	tools?: string[];
+	extensions?: string[];
+	skills?: string[];
+	systemPromptMode?: "replace" | "append";
+	inheritProjectContext?: boolean;
+	inheritSkills?: boolean;
+	routing?: RoutingMetadata;
+	memory?: "user" | "project" | "local";
+	/** Tool loading strategy: "essential" = always load all tools, "lean" = only load tools in defaultTools list */
+	loadMode?: "essential" | "lean";
+	/** Explicit tool list when loadMode is "lean". null means all available tools. */
+	defaultTools?: string[] | null;
+	/** Context mode: "fresh" = clean start, "fork" = inherit parent session context */
+	contextMode?: "fresh" | "fork";
+	/** Maximum turns for this agent. Overrides runtime config if set. */
+	maxTurns?: number;
+	disabled?: boolean;
+	override?: { source: "config"; path: string };
+}