@lousy-agents/cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zach Pratt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,148 @@
+# Lousy Agents
+
+**Turn "lousy" AI outputs into production-grade code.**
+
+![Demo](media/demo.gif)
+
+## TL;DR
+
+A CLI tool that scaffolds projects with the structure AI coding assistants need to be effective. Run `npx @lousy-agents/cli init` to create a new project with testing, linting, and GitHub Copilot configuration. Run `npx @lousy-agents/cli copilot-setup` in existing projects to generate a workflow that gives Copilot your environment context.
+
+---
+
+Lousy Agents is a CLI scaffolding tool that sets up your projects with the structure, instructions, and feedback loops that AI coding assistants need to be effective. One command gives you a production-ready development environment with testing, linting, and AI assistant configuration.
+
+## Quick Start
+
+```bash
+# Scaffold a new webapp project (no install required)
+npx @lousy-agents/cli init --kind webapp
+
+# Or use interactive mode to choose your project type
+npx @lousy-agents/cli init
+
+# Generate GitHub Copilot setup workflow from your project configuration
+npx @lousy-agents/cli copilot-setup
+```
+
+## Table of Contents
+
+- [Who This Is For](#who-this-is-for)
+- [Why This Exists](#why-this-exists)
+- [Features](#features)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Roadmap](#roadmap)
+- [Documentation](#documentation)
+- [Reference Example](#reference-example)
+
+## Who This Is For
+
+- **Software Engineers**: Frustrated by inconsistent AI output and looking for proven patterns to improve results.
+- **Curious Beginners**: Interested in AI-assisted coding but unsure how to set things up for success.
+- **Team Leads**: Exploring how to standardize AI tooling across a team or project.
+- **Platform Engineers**: Need to automate project scaffolding in scripts or CI/CD pipelines.
+
+No prior experience with coding agents is required—just curiosity and a willingness to experiment.
+
+## Why This Exists
+
+AI coding assistants work best when given clear constraints. Without structure, they guess—and often guess wrong. Lousy Agents provides the scaffolding they need to succeed:
+
+- **Instructions & Specs**: Templates that clearly communicate your intent, so agents produce code that matches your vision.
+- **Feedback Loops**: Pre-configured testing ([Vitest](https://vitest.dev/)) and linting ([Biome](https://biomejs.dev/)) that let agents catch and fix their own mistakes immediately.
+- **Copilot Configuration**: Settings and workflows that ground AI assistants in your specific engineering standards.
+
+## Features
+
+### CLI Commands
+
+- **[`init`](docs/init.md)** - Scaffold new projects with testing, linting, and Copilot configuration
+- **[`new`](docs/new.md)** - Create new resources like custom GitHub Copilot agents
+- **[`copilot-setup`](docs/copilot-setup.md)** - Generate GitHub Actions workflows for Copilot environment setup
+
+### MCP Server
+
+- **[MCP Server](docs/mcp-server.md)** - Model Context Protocol server for AI assistant integration
+
+### Spec-Driven Development
+
+A methodology where you write clear specifications *first*, giving agents precise requirements to implement—rather than vague prompts. Each scaffolded project includes instruction files for writing specs and tests.
+
+### Non-Interactive Mode
+
+Use the `--kind` flag to skip prompts and integrate into scripts or automation:
+
+```bash
+npx @lousy-agents/cli init --kind webapp  # No prompts, perfect for CI/CD
+```
+
+## Installation
+
+No installation required! Use npx to run directly:
+
+```bash
+npx @lousy-agents/cli init
+```
+
+For frequent use, install globally:
+
+```bash
+npm install -g @lousy-agents/cli
+```
+
+## Usage
+
+For detailed documentation on each command, see:
+
+- **[`init` command](docs/init.md)** - Scaffold new projects
+- **[`new` command](docs/new.md)** - Create new resources
+- **[`copilot-setup` command](docs/copilot-setup.md)** - Generate Copilot workflows
+- **[MCP Server](docs/mcp-server.md)** - AI assistant integration
+
+### Quick Examples
+
+**Create a new webapp:**
+
+```bash
+npx lousy-agents init --kind webapp
+```
+
+**Create a custom Copilot agent:**
+
+```bash
+npx lousy-agents new --copilot-agent security
+```
+
+**Generate Copilot setup workflow:**
+
+```bash
+npx lousy-agents copilot-setup
+```
+
+## Roadmap
+
+| Feature | Status |
+|---------|--------|
+| Scaffolding for webapps | In Progress |
+| Scaffolding for CLI | Not Started |
+| Scaffolding for REST APIs | Not Started |
+| Scaffolding for GraphQL APIs | Not Started |
+| MCP server package | ✅ Complete |
+
+## Documentation
+
+- **[`init` Command](docs/init.md)** - Project scaffolding
+- **[`new` Command](docs/new.md)** - Create new resources
+- **[`copilot-setup` Command](docs/copilot-setup.md)** - Workflow generation
+- **[MCP Server](docs/mcp-server.md)** - AI assistant integration
+
+## Reference Example
+
+The [ui/copilot-with-react](ui/copilot-with-react) directory contains a fully working reference implementation demonstrating these patterns in action. It's a Next.js + TypeScript project with:
+
+- Pre-configured testing (Vitest) and linting (Biome)
+- GitHub Copilot instructions and specs
+- Dev Container configuration for GitHub Codespaces
+
+Launch a GitHub Codespace to instantly spin up this environment and experiment with spec-driven development.

package/dist/commands/copilot-setup.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Main command implementation for copilot-setup
+ */
+export declare const copilotSetupCommand: import("citty").CommandDef<{}>;
+//# sourceMappingURL=copilot-setup.d.ts.map

package/dist/commands/copilot-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-setup.d.ts","sourceRoot":"","sources":["../../src/commands/copilot-setup.ts"],"names":[],"mappings":"AAyBA;;GAEG;AACH,eAAO,MAAM,mBAAmB,gCAyI9B,CAAC"}

package/dist/commands/copilot-setup.js

@@ -0,0 +1,97 @@
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { defineCommand } from "citty";
+import { consola } from "consola";
+import { createEnvironmentGateway, createWorkflowGateway, fileExists, } from "../gateways/index.js";
+import { buildCandidatesFromEnvironment, generateWorkflowContent, updateWorkflowWithMissingSteps, } from "../use-cases/copilot-setup.js";
+import { findMissingCandidates, getExistingActionsFromWorkflow, mergeCandidates, } from "../use-cases/setup-step-discovery.js";
+const copilotSetupArgs = {};
+/**
+ * Main command implementation for copilot-setup
+ */
+export const copilotSetupCommand = defineCommand({
+    meta: {
+        name: "copilot-setup",
+        description: "Generate or update the Copilot Setup Steps workflow based on detected environment configuration",
+    },
+    args: copilotSetupArgs,
+    run: async (context) => {
+        // Support dependency injection for testing via context.data
+        const targetDir = typeof context.data?.targetDir === "string"
+            ? context.data.targetDir
+            : process.cwd();
+        // Create gateways
+        const environmentGateway = createEnvironmentGateway();
+        const workflowGateway = createWorkflowGateway();
+        consola.info("Detecting environment configuration...");
+        // Step 1: Detect environment configuration files
+        const environment = await environmentGateway.detectEnvironment(targetDir);
+        if (environment.hasMise) {
+            consola.success("Found mise.toml - will use mise-action");
+        }
+        if (environment.versionFiles.length > 0) {
+            const fileNames = environment.versionFiles
+                .map((f) => f.filename)
+                .join(", ");
+            consola.success(`Found version files: ${fileNames}`);
+        }
+        // Step 2: Parse existing workflows for setup actions
+        const workflowsDir = join(targetDir, ".github", "workflows");
+        const workflowsDirExists = await fileExists(workflowsDir);
+        const workflowCandidates = workflowsDirExists
+            ? await workflowGateway.parseWorkflowsForSetupActions(targetDir)
+            : [];
+        if (workflowCandidates.length > 0) {
+            const actionNames = workflowCandidates
+                .map((c) => c.action)
+                .join(", ");
+            consola.success(`Found setup actions in existing workflows: ${actionNames}`);
+        }
+        // Step 3: Build candidates from environment
+        const envCandidates = await buildCandidatesFromEnvironment(environment);
+        // Step 4: Merge candidates (workflow takes precedence)
+        const allCandidates = mergeCandidates(workflowCandidates, envCandidates);
+        if (allCandidates.length === 0) {
+            consola.warn("No environment configuration or setup actions detected. Creating minimal workflow with checkout only.");
+        }
+        // Step 5: Check if copilot-setup-steps.yml already exists
+        const workflowExists = await workflowGateway.copilotSetupWorkflowExists(targetDir);
+        // Ensure workflows directory exists
+        if (!workflowsDirExists) {
+            await mkdir(workflowsDir, { recursive: true });
+        }
+        if (workflowExists) {
+            // Update existing workflow
+            consola.info("Found existing copilot-setup-steps.yml - checking for missing steps...");
+            const existingWorkflow = await workflowGateway.readCopilotSetupWorkflow(targetDir);
+            const existingActions = getExistingActionsFromWorkflow(existingWorkflow);
+            const missingCandidates = findMissingCandidates(allCandidates, existingActions);
+            if (missingCandidates.length === 0) {
+                consola.success("Copilot Setup Steps workflow already contains all detected setup steps. No changes needed.");
+                return;
+            }
+            const missingNames = missingCandidates
+                .map((c) => c.action)
+                .join(", ");
+            consola.info(`Adding missing setup steps: ${missingNames}`);
+            const updatedContent = await updateWorkflowWithMissingSteps(existingWorkflow, missingCandidates);
+            await workflowGateway.writeCopilotSetupWorkflow(targetDir, updatedContent);
+            consola.success(`Updated copilot-setup-steps.yml with ${missingCandidates.length} new step(s)`);
+        }
+        else {
+            // Create new workflow
+            consola.info("Creating new copilot-setup-steps.yml workflow...");
+            const content = await generateWorkflowContent(allCandidates);
+            await workflowGateway.writeCopilotSetupWorkflow(targetDir, content);
+            const stepCount = allCandidates.length + 1; // +1 for checkout
+            consola.success(`Created copilot-setup-steps.yml with ${stepCount} step(s)`);
+            if (allCandidates.length > 0) {
+                const actionNames = allCandidates
+                    .map((c) => c.action)
+                    .join(", ");
+                consola.info(`Included setup steps: ${actionNames}`);
+            }
+        }
+    },
+});
+//# sourceMappingURL=copilot-setup.js.map

package/dist/commands/copilot-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-setup.js","sourceRoot":"","sources":["../../src/commands/copilot-setup.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -0,0 +1,12 @@
+export declare const PROJECT_TYPE_OPTIONS: ("CLI" | "webapp" | "REST API" | "GraphQL API")[];
+export declare const initCommand: import("citty").CommandDef<{
+    kind: {
+        type: "string";
+        description: string;
+    };
+    name: {
+        type: "string";
+        description: string;
+    };
+}>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,oBAAoB,mDAA4B,CAAC;AAmE9D,eAAO,MAAM,WAAW;;;;;;;;;EAoFtB,CAAC"}

package/dist/commands/init.js

@@ -0,0 +1,115 @@
+import { defineCommand } from "citty";
+import { consola } from "consola";
+import { z } from "zod";
+import { getProjectStructure } from "../lib/config.js";
+import { createFilesystemStructure, } from "../lib/filesystem-structure.js";
+import { getProjectNameError, isValidProjectName, } from "../lib/project-name-validation.js";
+const ProjectTypeSchema = z.enum(["CLI", "webapp", "REST API", "GraphQL API"]);
+export const PROJECT_TYPE_OPTIONS = ProjectTypeSchema.options;
+const initArgs = {
+    kind: {
+        type: "string",
+        description: `Project type: ${PROJECT_TYPE_OPTIONS.join(", ")}`,
+    },
+    name: {
+        type: "string",
+        description: "Project name (used in package.json and other config files)",
+    },
+};
+function formatErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function createCliScaffolding(targetDir) {
+    try {
+        // Load the CLI structure from configuration
+        const cliStructure = await getProjectStructure("CLI");
+        if (!cliStructure) {
+            consola.warn("No CLI project structure defined in configuration");
+            return;
+        }
+        await createFilesystemStructure(cliStructure, targetDir);
+    }
+    catch (error) {
+        consola.error(`Failed to create CLI scaffolding: ${formatErrorMessage(error)}`);
+        throw error;
+    }
+}
+async function createWebappScaffolding(targetDir, templateContext) {
+    try {
+        // Load the webapp structure from configuration
+        const webappStructure = await getProjectStructure("webapp");
+        if (!webappStructure) {
+            consola.warn("No webapp project structure defined in configuration");
+            return;
+        }
+        await createFilesystemStructure(webappStructure, targetDir, templateContext);
+    }
+    catch (error) {
+        consola.error(`Failed to create webapp scaffolding: ${formatErrorMessage(error)}`);
+        throw error;
+    }
+}
+export const initCommand = defineCommand({
+    meta: {
+        name: "init",
+        description: "Initialize a new project with lousy agents scaffolding",
+    },
+    args: initArgs,
+    run: async (context) => {
+        // Support dependency injection for testing via context.data
+        // Runtime checks for type safety
+        const targetDir = typeof context.data?.targetDir === "string"
+            ? context.data.targetDir
+            : process.cwd();
+        const promptFn = typeof context.data?.prompt === "function"
+            ? context.data.prompt
+            : consola.prompt.bind(consola);
+        // Use CLI argument if provided, otherwise prompt
+        const rawProjectType = context.args.kind
+            ? context.args.kind
+            : await promptFn("What type of project are you initializing?", {
+                type: "select",
+                options: PROJECT_TYPE_OPTIONS,
+            });
+        // Validate the user input at runtime
+        const parseResult = ProjectTypeSchema.safeParse(rawProjectType);
+        if (!parseResult.success) {
+            const validOptions = PROJECT_TYPE_OPTIONS.join(", ");
+            consola.error(`Invalid project type selected: ${String(rawProjectType)}. Valid options are: ${validOptions}`);
+            throw new Error(`Invalid project type. Expected one of: ${validOptions}`);
+        }
+        const projectType = parseResult.data;
+        consola.success(`Selected project type: ${projectType}`);
+        if (projectType === "CLI") {
+            await createCliScaffolding(targetDir);
+            consola.info("CLI project scaffolding complete. Check the .github directory for instructions.");
+        }
+        else if (projectType === "webapp") {
+            // Get project name from CLI argument or prompt
+            const rawProjectName = context.args.name
+                ? context.args.name
+                : await promptFn("What is your project name?", {
+                    type: "text",
+                    placeholder: "my-webapp",
+                });
+            const projectName = typeof rawProjectName === "string" ? rawProjectName.trim() : "";
+            if (!projectName) {
+                consola.error("Project name is required for webapp projects");
+                throw new Error("Project name is required");
+            }
+            if (!isValidProjectName(projectName)) {
+                const errorMessage = getProjectNameError(projectName) ||
+                    "Invalid npm package name";
+                consola.error(`Invalid project name: "${projectName}". ${errorMessage}`);
+                throw new Error(`Invalid project name. ${errorMessage}`);
+            }
+            const templateContext = { projectName };
+            await createWebappScaffolding(targetDir, templateContext);
+            consola.info("Webapp project scaffolding complete. Run 'npm install' to install dependencies.");
+        }
+        else {
+            consola.info(`Scaffolding for ${projectType} projects will be implemented in a future release.`);
+        }
+    },
+});
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/new.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The `new` command for scaffolding new resources.
+ * Currently supports creating Copilot custom agents.
+ */
+export declare const newCommand: import("citty").CommandDef<{
+    "copilot-agent": {
+        type: "string";
+        description: string;
+    };
+}>;
+//# sourceMappingURL=new.d.ts.map

package/dist/commands/new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;EAkCrB,CAAC"}

package/dist/commands/new.js

@@ -0,0 +1,41 @@
+import { defineCommand } from "citty";
+import { consola } from "consola";
+import { createAgentFileGateway } from "../gateways/agent-file-gateway.js";
+import { CreateCopilotAgentUseCase } from "../use-cases/create-copilot-agent.js";
+const newArgs = {
+    "copilot-agent": {
+        type: "string",
+        description: "Create a new GitHub Copilot custom agent with the specified name. Example: lousy-agents new --copilot-agent security",
+    },
+};
+/**
+ * The `new` command for scaffolding new resources.
+ * Currently supports creating Copilot custom agents.
+ */
+export const newCommand = defineCommand({
+    meta: {
+        name: "new",
+        description: "Create new resources (e.g., Copilot agents)",
+    },
+    args: newArgs,
+    run: async (context) => {
+        // Support dependency injection for testing via context.data
+        const targetDir = typeof context.data?.targetDir === "string"
+            ? context.data.targetDir
+            : process.cwd();
+        const copilotAgentName = context.args["copilot-agent"];
+        if (!copilotAgentName) {
+            throw new Error("Missing required option: --copilot-agent <name>. Example: lousy-agents new --copilot-agent security");
+        }
+        // Create the use case with the file system gateway
+        const gateway = createAgentFileGateway();
+        const useCase = new CreateCopilotAgentUseCase(gateway);
+        // Execute the use case
+        const result = await useCase.execute(targetDir, copilotAgentName);
+        if (!result.success) {
+            throw new Error(result.error);
+        }
+        consola.success(`Created Copilot agent: ${result.filePath}`);
+    },
+});
+//# sourceMappingURL=new.js.map

package/dist/commands/new.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.js","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,MAAM,OAAO,GAAG;IACZ,eAAe,EAAE;QACb,IAAI,EAAE,QAAiB;QACvB,WAAW,EACP,sHAAsH;KAC7H;CACJ,CAAC;AAIF;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;IACpC,IAAI,EAAE;QACF,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,6CAA6C;KAC7D;IACD,IAAI,EAAE,OAAO;IACb,GAAG,EAAE,KAAK,EAAE,OAAgC,EAAE,EAAE;QAC5C,4DAA4D;QAC5D,MAAM,SAAS,GACX,OAAO,OAAO,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ;YACvC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS;YACxB,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAExB,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAEvD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACX,qGAAqG,CACxG,CAAC;QACN,CAAC;QAED,mDAAmD;QACnD,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAEvD,uBAAuB;QACvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAElE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,0BAA0B,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;CACJ,CAAC,CAAC"}

package/dist/entities/copilot-agent.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Core domain entity for GitHub Copilot custom agent files.
+ * Handles name normalization and content generation.
+ */
+/**
+ * Normalizes an agent name to lowercase with hyphens.
+ * Handles spaces, mixed case, multiple spaces, and leading/trailing spaces.
+ */
+export declare function normalizeAgentName(name: string): string;
+/**
+ * Generates the markdown content for a custom Copilot agent file.
+ * Includes YAML frontmatter, documentation link, and example structure.
+ */
+export declare function generateAgentContent(agentName: string): string;
+//# sourceMappingURL=copilot-agent.d.ts.map

package/dist/entities/copilot-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-agent.d.ts","sourceRoot":"","sources":["../../src/entities/copilot-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAqC9D"}

package/dist/entities/copilot-agent.js

@@ -0,0 +1,53 @@
+/**
+ * Core domain entity for GitHub Copilot custom agent files.
+ * Handles name normalization and content generation.
+ */
+/**
+ * Normalizes an agent name to lowercase with hyphens.
+ * Handles spaces, mixed case, multiple spaces, and leading/trailing spaces.
+ */
+export function normalizeAgentName(name) {
+    return name.trim().toLowerCase().replace(/\s+/g, "-");
+}
+/**
+ * Generates the markdown content for a custom Copilot agent file.
+ * Includes YAML frontmatter, documentation link, and example structure.
+ */
+export function generateAgentContent(agentName) {
+    const normalizedName = normalizeAgentName(agentName);
+    return `---
+name: ${normalizedName}
+description: Brief description of what this agent does
+---
+
+<!-- 
+This is a custom GitHub Copilot agent for repository-level use.
+Learn more: https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents
+-->
+
+# ${normalizedName} Agent
+
+You are a ${normalizedName} agent specialized in {domain/responsibility}.
+
+## Your Role
+
+{Brief description of the agent's expertise and focus area}
+
+## Responsibilities
+
+- {Primary responsibility}
+- {Secondary responsibility}
+- {Additional responsibility}
+
+## Guidelines
+
+- {Guideline or best practice}
+- {Guideline or best practice}
+- {Guideline or best practice}
+
+## Example Interactions
+
+{Example of how the agent should respond to typical requests}
+`;
+}
+//# sourceMappingURL=copilot-agent.js.map

package/dist/entities/copilot-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-agent.js","sourceRoot":"","sources":["../../src/entities/copilot-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IAClD,MAAM,cAAc,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAErD,OAAO;QACH,cAAc;;;;;;;;;IASlB,cAAc;;YAEN,cAAc;;;;;;;;;;;;;;;;;;;;;CAqBzB,CAAC;AACF,CAAC"}

package/dist/entities/copilot-setup.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Core domain entities for the Copilot Setup Steps feature.
+ * These are the fundamental types that represent the business domain.
+ */
+/**
+ * Types of version files supported for detection
+ */
+export type VersionFileType = "node" | "python" | "java" | "ruby" | "go";
+/**
+ * Represents a detected version file in the repository
+ */
+export interface VersionFile {
+    type: VersionFileType;
+    filename: string;
+    version?: string;
+}
+/**
+ * Result of detecting environment configuration
+ */
+export interface DetectedEnvironment {
+    hasMise: boolean;
+    versionFiles: VersionFile[];
+}
+/**
+ * Represents a setup step candidate extracted from workflows or version files
+ */
+export interface SetupStepCandidate {
+    action: string;
+    version?: string;
+    config?: Record<string, unknown>;
+    source: "version-file" | "workflow";
+}
+/**
+ * Represents a step in a GitHub Actions workflow
+ */
+export interface WorkflowStep {
+    name?: string;
+    uses: string;
+    with?: Record<string, unknown>;
+}
+/**
+ * Represents an action that needs version resolution.
+ * Used to prompt the LLM to look up the latest version.
+ */
+export interface ActionToResolve {
+    /** Action name without version (e.g., "actions/setup-node") */
+    action: string;
+    /** Placeholder used in workflow template (e.g., "RESOLVE_VERSION") */
+    currentPlaceholder: string;
+    /** URL to lookup latest version (e.g., "https://github.com/actions/setup-node/releases/latest") */
+    lookupUrl: string;
+}
+/**
+ * Represents a resolved action version with SHA and tag.
+ * Used when the LLM has looked up and resolved the version.
+ */
+export interface ResolvedVersion {
+    /** Action name without version (e.g., "actions/setup-node") */
+    action: string;
+    /** Resolved commit SHA */
+    sha: string;
+    /** Version tag for human-readable comment (e.g., "v4.0.0") */
+    versionTag: string;
+}
+//# sourceMappingURL=copilot-setup.d.ts.map

package/dist/entities/copilot-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-setup.d.ts","sourceRoot":"","sources":["../../src/entities/copilot-setup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,WAAW,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,cAAc,GAAG,UAAU,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mGAAmG;IACnG,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;CACtB"}

package/dist/entities/copilot-setup.js

@@ -0,0 +1,6 @@
+/**
+ * Core domain entities for the Copilot Setup Steps feature.
+ * These are the fundamental types that represent the business domain.
+ */
+export {};
+//# sourceMappingURL=copilot-setup.js.map

package/dist/entities/copilot-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-setup.js","sourceRoot":"","sources":["../../src/entities/copilot-setup.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/entities/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Entities - Core domain types and interfaces
+ */
+export * from "./copilot-agent.js";
+export * from "./copilot-setup.js";
+//# sourceMappingURL=index.d.ts.map