@lousy-agents/cli 1.0.0

package/dist/use-cases/action-resolution.js

@@ -0,0 +1,107 @@
+/**
+ * Use case for building action resolution metadata.
+ * This module provides logic for identifying actions that need version resolution
+ * and generating lookup URLs for the LLM to fetch latest versions.
+ */
+/**
+ * The placeholder string used in workflow templates when version resolution is needed.
+ */
+export const VERSION_PLACEHOLDER = "RESOLVE_VERSION";
+/**
+ * Instructions for the LLM to resolve action versions.
+ */
+export const VERSION_RESOLUTION_INSTRUCTIONS = `To resolve action versions:
+1. For each action in actionsToResolve, fetch the lookup_url to find the latest release
+2. Find the latest release tag (e.g., v4.0.0)
+3. Get the commit SHA for that tag from the release page or GitHub API
+4. Pin actions to SHA with version comment: action@SHA  # vX.X.X
+5. Call this tool again with resolvedVersions to generate the final workflow
+
+Example resolved format: actions/setup-node@1a2b3c4d5e6f  # v4.0.0`;
+/**
+ * Generates a GitHub releases lookup URL for an action.
+ * @param action The action name (e.g., "actions/setup-node")
+ * @returns The URL to the action's latest release page
+ */
+export function generateLookupUrl(action) {
+    return `https://github.com/${action}/releases/latest`;
+}
+/**
+ * Builds an ActionToResolve entry for a given action.
+ * @param action The action name (e.g., "actions/setup-node")
+ * @returns ActionToResolve metadata for the action
+ */
+export function buildActionToResolve(action) {
+    return {
+        action,
+        currentPlaceholder: VERSION_PLACEHOLDER,
+        lookupUrl: generateLookupUrl(action),
+    };
+}
+/**
+ * Builds an array of ActionToResolve entries from setup step candidates.
+ * Filters out actions that already have resolved versions.
+ * @param candidates The setup step candidates
+ * @param resolvedVersions Optional array of already-resolved versions
+ * @returns Array of actions that need version resolution
+ */
+export function buildActionsToResolve(candidates, resolvedVersions) {
+    const resolvedActions = new Set(resolvedVersions?.map((r) => r.action) ?? []);
+    // Include checkout action which is always added to workflows
+    const allActions = ["actions/checkout", ...candidates.map((c) => c.action)];
+    // Deduplicate and filter out already-resolved actions
+    const uniqueActions = [...new Set(allActions)].filter((action) => !resolvedActions.has(action));
+    return uniqueActions.map(buildActionToResolve);
+}
+/**
+ * Formats an action reference with SHA pinning and version comment.
+ * @param action The action name (e.g., "actions/setup-node")
+ * @param sha The commit SHA
+ * @param versionTag The version tag for the comment (e.g., "v4.0.0")
+ * @returns Formatted action reference (e.g., "actions/setup-node@abc123  # v4.0.0")
+ */
+export function formatShaPinnedAction(action, sha, versionTag) {
+    return `${action}@${sha}  # ${versionTag}`;
+}
+/**
+ * Finds a resolved version for a given action.
+ * @param action The action name to look up
+ * @param resolvedVersions Array of resolved versions
+ * @returns The resolved version or undefined if not found
+ */
+export function findResolvedVersion(action, resolvedVersions) {
+    return resolvedVersions.find((r) => r.action === action);
+}
+/**
+ * Gets the version string to use for an action.
+ * Returns SHA-pinned format if resolved, or placeholder if not.
+ * @param action The action name
+ * @param resolvedVersions Optional array of resolved versions
+ * @param fallbackVersion Optional fallback version (e.g., "v4")
+ * @returns The version string to use in the workflow
+ */
+export function getActionVersion(action, resolvedVersions, fallbackVersion) {
+    if (resolvedVersions) {
+        const resolved = findResolvedVersion(action, resolvedVersions);
+        if (resolved) {
+            return `${resolved.sha}  # ${resolved.versionTag}`;
+        }
+    }
+    // If we have a fallback version (from existing workflow or gateway), use it
+    if (fallbackVersion) {
+        return fallbackVersion;
+    }
+    // Otherwise, use placeholder
+    return VERSION_PLACEHOLDER;
+}
+/**
+ * Checks if all required actions have been resolved.
+ * @param candidates The setup step candidates
+ * @param resolvedVersions Array of resolved versions
+ * @returns True if all actions (including checkout) are resolved
+ */
+export function allActionsResolved(candidates, resolvedVersions) {
+    const actionsToResolve = buildActionsToResolve(candidates, resolvedVersions);
+    return actionsToResolve.length === 0;
+}
+//# sourceMappingURL=action-resolution.js.map

package/dist/use-cases/action-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-resolution.js","sourceRoot":"","sources":["../../src/use-cases/action-resolution.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;mEAOoB,CAAC;AAEpE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC5C,OAAO,sBAAsB,MAAM,kBAAkB,CAAC;AAC1D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IAC/C,OAAO;QACH,MAAM;QACN,kBAAkB,EAAE,mBAAmB;QACvC,SAAS,EAAE,iBAAiB,CAAC,MAAM,CAAC;KACvC,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACjC,UAAgC,EAChC,gBAAoC;IAEpC,MAAM,eAAe,GAAG,IAAI,GAAG,CAC3B,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAC/C,CAAC;IAEF,6DAA6D;IAC7D,MAAM,UAAU,GAAG,CAAC,kBAAkB,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5E,sDAAsD;IACtD,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CACjD,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAC3C,CAAC;IAEF,OAAO,aAAa,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACjC,MAAc,EACd,GAAW,EACX,UAAkB;IAElB,OAAO,GAAG,MAAM,IAAI,GAAG,OAAO,UAAU,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAC/B,MAAc,EACd,gBAAmC;IAEnC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC5B,MAAc,EACd,gBAAoC,EACpC,eAAwB;IAExB,IAAI,gBAAgB,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAC/D,IAAI,QAAQ,EAAE,CAAC;YACX,OAAO,GAAG,QAAQ,CAAC,GAAG,OAAO,QAAQ,CAAC,UAAU,EAAE,CAAC;QACvD,CAAC;IACL,CAAC;IAED,4EAA4E;IAC5E,IAAI,eAAe,EAAE,CAAC;QAClB,OAAO,eAAe,CAAC;IAC3B,CAAC;IAED,6BAA6B;IAC7B,OAAO,mBAAmB,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAC9B,UAAgC,EAChC,gBAAmC;IAEnC,MAAM,gBAAgB,GAAG,qBAAqB,CAC1C,UAAU,EACV,gBAAgB,CACnB,CAAC;IACF,OAAO,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/dist/use-cases/candidate-builder.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Use case for building setup step candidates from environment detection.
+ * This module handles the logic of determining which GitHub Actions
+ * setup steps should be added based on detected version files.
+ */
+import type { DetectedEnvironment, SetupStepCandidate } from "../entities/copilot-setup.js";
+import type { ActionVersionGateway } from "../gateways/action-version-gateway.js";
+import { type CopilotSetupConfig } from "../lib/copilot-setup-config.js";
+/**
+ * Builds setup step candidates from detected environment
+ * @param environment The detected environment configuration
+ * @param versionGateway Optional gateway for looking up action versions (defaults to local)
+ * @param config Optional copilot-setup configuration
+ * @returns Array of setup step candidates
+ */
+export declare function buildCandidatesFromEnvironment(environment: DetectedEnvironment, versionGateway?: ActionVersionGateway, config?: CopilotSetupConfig): Promise<SetupStepCandidate[]>;
+//# sourceMappingURL=candidate-builder.d.ts.map

package/dist/use-cases/candidate-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-builder.d.ts","sourceRoot":"","sources":["../../src/use-cases/candidate-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACR,mBAAmB,EACnB,kBAAkB,EAGrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAElF,OAAO,EACH,KAAK,kBAAkB,EAI1B,MAAM,gCAAgC,CAAC;AAExC;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAChD,WAAW,EAAE,mBAAmB,EAChC,cAAc,GAAE,oBAAmD,EACnE,MAAM,CAAC,EAAE,kBAAkB,GAC5B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyB/B"}

package/dist/use-cases/candidate-builder.js

@@ -0,0 +1,67 @@
+/**
+ * Use case for building setup step candidates from environment detection.
+ * This module handles the logic of determining which GitHub Actions
+ * setup steps should be added based on detected version files.
+ */
+import { createActionVersionGateway } from "../gateways/action-version-gateway.js";
+import { getVersionFileConfigKeyMap, getVersionTypeToActionMap, loadCopilotSetupConfig, } from "../lib/copilot-setup-config.js";
+/**
+ * Builds setup step candidates from detected environment
+ * @param environment The detected environment configuration
+ * @param versionGateway Optional gateway for looking up action versions (defaults to local)
+ * @param config Optional copilot-setup configuration
+ * @returns Array of setup step candidates
+ */
+export async function buildCandidatesFromEnvironment(environment, versionGateway = createActionVersionGateway(), config) {
+    const loadedConfig = config || (await loadCopilotSetupConfig());
+    const versionTypeToAction = getVersionTypeToActionMap(loadedConfig);
+    const versionFileConfigKeys = getVersionFileConfigKeyMap(loadedConfig);
+    const candidates = [];
+    // If mise.toml is present, add mise-action only
+    if (environment.hasMise) {
+        const miseVersion = await versionGateway.getVersion("jdx/mise-action");
+        candidates.push({
+            action: "jdx/mise-action",
+            version: miseVersion,
+            source: "version-file",
+        });
+        return candidates;
+    }
+    // Otherwise, add individual setup actions for each version file
+    return buildCandidatesFromVersionFiles(environment.versionFiles, versionTypeToAction, versionFileConfigKeys, versionGateway);
+}
+/**
+ * Builds setup step candidates from individual version files
+ * @param versionFiles Array of version files to process
+ * @param versionTypeToAction Map from version file type to action name
+ * @param versionFileConfigKeys Map from version file type to config key
+ * @param versionGateway Gateway for looking up action versions
+ * @returns Array of setup step candidates
+ */
+async function buildCandidatesFromVersionFiles(versionFiles, versionTypeToAction, versionFileConfigKeys, versionGateway) {
+    const candidates = [];
+    // Track which types we've already added to deduplicate (e.g., .nvmrc and .node-version)
+    const addedTypes = new Set();
+    for (const versionFile of versionFiles) {
+        if (addedTypes.has(versionFile.type)) {
+            continue;
+        }
+        addedTypes.add(versionFile.type);
+        const action = versionTypeToAction[versionFile.type];
+        const configKey = versionFileConfigKeys[versionFile.type];
+        if (!action || !configKey) {
+            continue;
+        }
+        const version = await versionGateway.getVersion(action);
+        candidates.push({
+            action,
+            version,
+            config: {
+                [configKey]: versionFile.filename,
+            },
+            source: "version-file",
+        });
+    }
+    return candidates;
+}
+//# sourceMappingURL=candidate-builder.js.map

package/dist/use-cases/candidate-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate-builder.js","sourceRoot":"","sources":["../../src/use-cases/candidate-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,EAEH,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,GACzB,MAAM,gCAAgC,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAChD,WAAgC,EAChC,iBAAuC,0BAA0B,EAAE,EACnE,MAA2B;IAE3B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,sBAAsB,EAAE,CAAC,CAAC;IAChE,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAC;IACpE,MAAM,qBAAqB,GAAG,0BAA0B,CAAC,YAAY,CAAC,CAAC;IAEvE,MAAM,UAAU,GAAyB,EAAE,CAAC;IAE5C,gDAAgD;IAChD,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;QACvE,UAAU,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,iBAAiB;YACzB,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,cAAc;SACzB,CAAC,CAAC;QACH,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,gEAAgE;IAChE,OAAO,+BAA+B,CAClC,WAAW,CAAC,YAAY,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,CACjB,CAAC;AACN,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,+BAA+B,CAC1C,YAA2B,EAC3B,mBAA6D,EAC7D,qBAA+D,EAC/D,cAAoC;IAEpC,MAAM,UAAU,GAAyB,EAAE,CAAC;IAC5C,wFAAwF;IACxF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE9C,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACrC,IAAI,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,SAAS;QACb,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEjC,MAAM,MAAM,GAAG,mBAAmB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,qBAAqB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAE1D,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACxB,SAAS;QACb,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAExD,UAAU,CAAC,IAAI,CAAC;YACZ,MAAM;YACN,OAAO;YACP,MAAM,EAAE;gBACJ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,QAAQ;aACpC;YACD,MAAM,EAAE,cAAc;SACzB,CAAC,CAAC;IACP,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC"}

package/dist/use-cases/copilot-setup.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Use cases for the Copilot Setup Steps feature.
+ * This module re-exports from candidate-builder and workflow-generator
+ * for backwards compatibility.
+ */
+export { buildCandidatesFromEnvironment } from "./candidate-builder.js";
+export { type GenerateWorkflowOptions, generateWorkflowContent, updateWorkflowWithMissingSteps, } from "./workflow-generator.js";
+//# sourceMappingURL=copilot-setup.d.ts.map

package/dist/use-cases/copilot-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-setup.d.ts","sourceRoot":"","sources":["../../src/use-cases/copilot-setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAGxE,OAAO,EACH,KAAK,uBAAuB,EAC5B,uBAAuB,EACvB,8BAA8B,GACjC,MAAM,yBAAyB,CAAC"}

package/dist/use-cases/copilot-setup.js

@@ -0,0 +1,10 @@
+/**
+ * Use cases for the Copilot Setup Steps feature.
+ * This module re-exports from candidate-builder and workflow-generator
+ * for backwards compatibility.
+ */
+// Re-export candidate building functionality
+export { buildCandidatesFromEnvironment } from "./candidate-builder.js";
+// Re-export workflow generation functionality
+export { generateWorkflowContent, updateWorkflowWithMissingSteps, } from "./workflow-generator.js";
+//# sourceMappingURL=copilot-setup.js.map

package/dist/use-cases/copilot-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-setup.js","sourceRoot":"","sources":["../../src/use-cases/copilot-setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6CAA6C;AAC7C,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAExE,8CAA8C;AAC9C,OAAO,EAEH,uBAAuB,EACvB,8BAA8B,GACjC,MAAM,yBAAyB,CAAC"}

package/dist/use-cases/create-copilot-agent.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Use case for creating GitHub Copilot custom agent files.
+ * Orchestrates entity logic with gateway operations.
+ */
+import type { AgentFileGateway } from "../gateways/agent-file-gateway.js";
+/**
+ * Result of the create copilot agent operation
+ */
+export interface CreateCopilotAgentResult {
+    success: boolean;
+    normalizedName?: string;
+    filePath?: string;
+    error?: string;
+}
+/**
+ * Use case for creating a new Copilot agent file
+ */
+export declare class CreateCopilotAgentUseCase {
+    private readonly gateway;
+    constructor(gateway: AgentFileGateway);
+    /**
+     * Executes the create agent operation
+     * @param targetDir The root directory of the repository
+     * @param agentName The name of the agent to create
+     * @returns Result of the operation
+     */
+    execute(targetDir: string, agentName: string): Promise<CreateCopilotAgentResult>;
+}
+//# sourceMappingURL=create-copilot-agent.d.ts.map

package/dist/use-cases/create-copilot-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-copilot-agent.d.ts","sourceRoot":"","sources":["../../src/use-cases/create-copilot-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAe1E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,yBAAyB;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,gBAAgB;IAEtD;;;;;OAKG;IACG,OAAO,CACT,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,wBAAwB,CAAC;CAsDvC"}

package/dist/use-cases/create-copilot-agent.js

@@ -0,0 +1,73 @@
+/**
+ * Use case for creating GitHub Copilot custom agent files.
+ * Orchestrates entity logic with gateway operations.
+ */
+import { z } from "zod";
+import { generateAgentContent, normalizeAgentName, } from "../entities/copilot-agent.js";
+/**
+ * Schema for validating agent name input
+ * Validates that the input is a non-empty string with reasonable constraints
+ */
+const AgentNameSchema = z
+    .string()
+    .min(1, "Agent name is required")
+    .max(100, "Agent name must be 100 characters or less")
+    .regex(/^[a-zA-Z0-9\s_-]+$/, "Agent name can only contain letters, numbers, spaces, hyphens, and underscores");
+/**
+ * Use case for creating a new Copilot agent file
+ */
+export class CreateCopilotAgentUseCase {
+    gateway;
+    constructor(gateway) {
+        this.gateway = gateway;
+    }
+    /**
+     * Executes the create agent operation
+     * @param targetDir The root directory of the repository
+     * @param agentName The name of the agent to create
+     * @returns Result of the operation
+     */
+    async execute(targetDir, agentName) {
+        // Validate the agent name using Zod schema
+        const validationResult = AgentNameSchema.safeParse(agentName);
+        if (!validationResult.success) {
+            const errorMessage = validationResult.error.issues[0]?.message ??
+                "Invalid agent name";
+            return {
+                success: false,
+                error: errorMessage,
+            };
+        }
+        // Normalize the agent name
+        const normalizedName = normalizeAgentName(validationResult.data);
+        // Validate that the normalized name is not empty (handles whitespace-only input)
+        if (!normalizedName) {
+            return {
+                success: false,
+                error: "Agent name is required",
+            };
+        }
+        // Get the file path
+        const filePath = this.gateway.getAgentFilePath(targetDir, normalizedName);
+        // Check if the file already exists
+        if (await this.gateway.agentFileExists(targetDir, normalizedName)) {
+            return {
+                success: false,
+                error: `Agent file already exists: ${filePath}`,
+                filePath,
+            };
+        }
+        // Ensure the directory exists
+        await this.gateway.ensureAgentsDirectory(targetDir);
+        // Generate the content
+        const content = generateAgentContent(normalizedName);
+        // Write the file
+        await this.gateway.writeAgentFile(targetDir, normalizedName, content);
+        return {
+            success: true,
+            normalizedName,
+            filePath,
+        };
+    }
+}
+//# sourceMappingURL=create-copilot-agent.js.map

package/dist/use-cases/create-copilot-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-copilot-agent.js","sourceRoot":"","sources":["../../src/use-cases/create-copilot-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACH,oBAAoB,EACpB,kBAAkB,GACrB,MAAM,8BAA8B,CAAC;AAGtC;;;GAGG;AACH,MAAM,eAAe,GAAG,CAAC;KACpB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;KAChC,GAAG,CAAC,GAAG,EAAE,2CAA2C,CAAC;KACrD,KAAK,CACF,oBAAoB,EACpB,gFAAgF,CACnF,CAAC;AAYN;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACL;IAA7B,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CACT,SAAiB,EACjB,SAAiB;QAEjB,2CAA2C;QAC3C,MAAM,gBAAgB,GAAG,eAAe,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,YAAY,GACd,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO;gBACzC,oBAAoB,CAAC;YACzB,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,YAAY;aACtB,CAAC;QACN,CAAC;QAED,2BAA2B;QAC3B,MAAM,cAAc,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEjE,iFAAiF;QACjF,IAAI,CAAC,cAAc,EAAE,CAAC;YAClB,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,wBAAwB;aAClC,CAAC;QACN,CAAC;QAED,oBAAoB;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAC1C,SAAS,EACT,cAAc,CACjB,CAAC;QAEF,mCAAmC;QACnC,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,CAAC;YAChE,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,8BAA8B,QAAQ,EAAE;gBAC/C,QAAQ;aACX,CAAC;QACN,CAAC;QAED,8BAA8B;QAC9B,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAEpD,uBAAuB;QACvB,MAAM,OAAO,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAC;QAErD,iBAAiB;QACjB,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;QAEtE,OAAO;YACH,OAAO,EAAE,IAAI;YACb,cAAc;YACd,QAAQ;SACX,CAAC;IACN,CAAC;CACJ"}

package/dist/use-cases/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Use Cases - Application-specific business rules
+ */
+export * from "./action-resolution.js";
+export * from "./candidate-builder.js";
+export * from "./copilot-setup.js";
+export * from "./create-copilot-agent.js";
+export * from "./workflow-generator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/use-cases/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/use-cases/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC"}

package/dist/use-cases/index.js

@@ -0,0 +1,9 @@
+/**
+ * Use Cases - Application-specific business rules
+ */
+export * from "./action-resolution.js";
+export * from "./candidate-builder.js";
+export * from "./copilot-setup.js";
+export * from "./create-copilot-agent.js";
+export * from "./workflow-generator.js";
+//# sourceMappingURL=index.js.map

package/dist/use-cases/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/use-cases/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC"}

package/dist/use-cases/setup-step-discovery.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Use case for discovering setup steps in workflows.
+ * This module provides reusable logic for finding existing and missing setup steps.
+ */
+import type { SetupStepCandidate } from "../entities/copilot-setup.js";
+/**
+ * Extracts action name from a "uses" string
+ * @example "actions/setup-node@v4" -> "actions/setup-node"
+ */
+export declare function parseActionName(uses: string): string;
+/**
+ * Checks if an action matches any of the setup action patterns
+ * @param actionName The action name to check (e.g., "actions/setup-node")
+ * @param patterns List of patterns to match against
+ */
+export declare function isSetupAction(actionName: string, patterns: string[]): boolean;
+/**
+ * Step object with all fields (for workflow reading)
+ */
+export interface WorkflowStepDetails {
+    name?: string;
+    uses?: string;
+    with?: Record<string, unknown>;
+}
+/**
+ * Extracts all steps from a workflow (including steps without "uses")
+ * @param workflow The parsed workflow object
+ * @returns Array of step details
+ */
+export declare function extractAllWorkflowSteps(workflow: unknown): WorkflowStepDetails[];
+/**
+ * Extracts existing setup actions from a parsed workflow
+ * @param workflow The parsed workflow object
+ * @returns Set of action names already present
+ */
+export declare function getExistingActionsFromWorkflow(workflow: unknown): Set<string>;
+/**
+ * Identifies candidates that are missing from an existing workflow
+ * @param candidates All candidates to potentially add
+ * @param existingActions Actions already present in the workflow
+ * @returns Candidates that need to be added
+ */
+export declare function findMissingCandidates(candidates: SetupStepCandidate[], existingActions: Set<string>): SetupStepCandidate[];
+/**
+ * Merges candidates from multiple sources, with earlier sources taking precedence
+ * @param candidateSources Arrays of candidates, in order of precedence
+ * @returns Merged and deduplicated candidates
+ */
+export declare function mergeCandidates(...candidateSources: SetupStepCandidate[][]): SetupStepCandidate[];
+/**
+ * Extracts version from a "uses" string
+ * @example "actions/setup-node@v4" -> "v4"
+ */
+export declare function parseActionVersion(uses: string): string | undefined;
+/**
+ * Action reference with name and version.
+ * @example { name: "actions/setup-node", version: "v4" }
+ * @example { name: "actions/checkout", version: "b4ffde65f46336ab88eb53be808477a3936bae11" }
+ */
+export interface ActionReference {
+    /** The action name without version (e.g., "actions/setup-node") */
+    name: string;
+    /** The version, tag, or commit SHA (e.g., "v4", "main", "a1b2c3d4") */
+    version: string;
+}
+/**
+ * Extracts all action references from a workflow.
+ * Only includes actions that have a version specified (format: "action@version").
+ * Actions without versions are skipped as they represent incomplete references.
+ * @param workflow The parsed workflow object
+ * @returns Array of action references with name and version
+ */
+export declare function extractActionsFromWorkflow(workflow: unknown): ActionReference[];
+/**
+ * Extracts setup step candidates from a parsed workflow based on action patterns
+ * @param workflow The parsed workflow object
+ * @param patterns List of action patterns to detect
+ * @returns Array of setup step candidates
+ */
+export declare function extractSetupStepsFromWorkflow(workflow: unknown, patterns: string[]): SetupStepCandidate[];
+/**
+ * Deduplicates candidates by action name, keeping the first occurrence
+ * @param candidates Array of candidates to deduplicate
+ * @returns Deduplicated array of candidates
+ */
+export declare function deduplicateCandidates(candidates: SetupStepCandidate[]): SetupStepCandidate[];
+//# sourceMappingURL=setup-step-discovery.d.ts.map

package/dist/use-cases/setup-step-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-step-discovery.d.ts","sourceRoot":"","sources":["../../src/use-cases/setup-step-discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAE7E;AAUD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAoDD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,OAAO,GAClB,mBAAmB,EAAE,CA4CvB;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,CAQ7E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACjC,UAAU,EAAE,kBAAkB,EAAE,EAChC,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAC7B,kBAAkB,EAAE,CAItB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC3B,GAAG,gBAAgB,EAAE,kBAAkB,EAAE,EAAE,GAC5C,kBAAkB,EAAE,CActB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGnE;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACtC,QAAQ,EAAE,OAAO,GAClB,eAAe,EAAE,CAanB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CACzC,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,EAAE,GACnB,kBAAkB,EAAE,CAiBtB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACjC,UAAU,EAAE,kBAAkB,EAAE,GACjC,kBAAkB,EAAE,CAYtB"}