@lousy-agents/cli 1.0.0

package/dist/use-cases/setup-step-discovery.js

@@ -0,0 +1,202 @@
+/**
+ * Use case for discovering setup steps in workflows.
+ * This module provides reusable logic for finding existing and missing setup steps.
+ */
+/**
+ * Extracts action name from a "uses" string
+ * @example "actions/setup-node@v4" -> "actions/setup-node"
+ */
+export function parseActionName(uses) {
+    const atIndex = uses.indexOf("@");
+    return atIndex === -1 ? uses : uses.substring(0, atIndex);
+}
+/**
+ * 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 function isSetupAction(actionName, patterns) {
+    return patterns.includes(actionName);
+}
+/**
+ * Iterates over all steps in a workflow that have a "uses" field
+ * @param workflow The parsed workflow object
+ * @param callback Function to call for each step with a "uses" field
+ */
+function forEachWorkflowStep(workflow, callback) {
+    if (!workflow || typeof workflow !== "object") {
+        return;
+    }
+    const jobs = workflow.jobs;
+    if (!jobs || typeof jobs !== "object") {
+        return;
+    }
+    for (const job of Object.values(jobs)) {
+        if (!job || typeof job !== "object") {
+            continue;
+        }
+        const steps = job.steps;
+        if (!Array.isArray(steps)) {
+            continue;
+        }
+        for (const step of steps) {
+            if (!step || typeof step !== "object") {
+                continue;
+            }
+            const stepObj = step;
+            const uses = stepObj.uses;
+            if (typeof uses === "string") {
+                const withConfig = stepObj.with;
+                callback({
+                    uses,
+                    with: withConfig && typeof withConfig === "object"
+                        ? withConfig
+                        : undefined,
+                });
+            }
+        }
+    }
+}
+/**
+ * Extracts all steps from a workflow (including steps without "uses")
+ * @param workflow The parsed workflow object
+ * @returns Array of step details
+ */
+export function extractAllWorkflowSteps(workflow) {
+    const steps = [];
+    if (!workflow || typeof workflow !== "object") {
+        return steps;
+    }
+    const jobs = workflow.jobs;
+    if (!jobs || typeof jobs !== "object") {
+        return steps;
+    }
+    for (const job of Object.values(jobs)) {
+        if (!job || typeof job !== "object") {
+            continue;
+        }
+        const jobSteps = job.steps;
+        if (!Array.isArray(jobSteps)) {
+            continue;
+        }
+        for (const step of jobSteps) {
+            if (!step || typeof step !== "object") {
+                continue;
+            }
+            const stepObj = step;
+            const withConfig = stepObj.with;
+            steps.push({
+                name: typeof stepObj.name === "string" ? stepObj.name : undefined,
+                uses: typeof stepObj.uses === "string" ? stepObj.uses : undefined,
+                with: withConfig && typeof withConfig === "object"
+                    ? withConfig
+                    : undefined,
+            });
+        }
+    }
+    return steps;
+}
+/**
+ * Extracts existing setup actions from a parsed workflow
+ * @param workflow The parsed workflow object
+ * @returns Set of action names already present
+ */
+export function getExistingActionsFromWorkflow(workflow) {
+    const actions = new Set();
+    forEachWorkflowStep(workflow, (step) => {
+        actions.add(parseActionName(step.uses));
+    });
+    return actions;
+}
+/**
+ * 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 function findMissingCandidates(candidates, existingActions) {
+    return candidates.filter((candidate) => !existingActions.has(candidate.action));
+}
+/**
+ * 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 function mergeCandidates(...candidateSources) {
+    const result = [];
+    const seen = new Set();
+    for (const candidates of candidateSources) {
+        for (const candidate of candidates) {
+            if (!seen.has(candidate.action)) {
+                seen.add(candidate.action);
+                result.push(candidate);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Extracts version from a "uses" string
+ * @example "actions/setup-node@v4" -> "v4"
+ */
+export function parseActionVersion(uses) {
+    const atIndex = uses.indexOf("@");
+    return atIndex !== -1 ? uses.substring(atIndex + 1) : undefined;
+}
+/**
+ * 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 function extractActionsFromWorkflow(workflow) {
+    const actions = [];
+    forEachWorkflowStep(workflow, (step) => {
+        const name = parseActionName(step.uses);
+        const version = parseActionVersion(step.uses);
+        // Skip actions without versions - these are incomplete references
+        if (version) {
+            actions.push({ name, version });
+        }
+    });
+    return actions;
+}
+/**
+ * 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 function extractSetupStepsFromWorkflow(workflow, patterns) {
+    const candidates = [];
+    forEachWorkflowStep(workflow, (step) => {
+        const action = parseActionName(step.uses);
+        if (isSetupAction(action, patterns)) {
+            candidates.push({
+                action,
+                version: parseActionVersion(step.uses),
+                config: step.with,
+                source: "workflow",
+            });
+        }
+    });
+    return candidates;
+}
+/**
+ * Deduplicates candidates by action name, keeping the first occurrence
+ * @param candidates Array of candidates to deduplicate
+ * @returns Deduplicated array of candidates
+ */
+export function deduplicateCandidates(candidates) {
+    const seen = new Set();
+    const deduplicated = [];
+    for (const candidate of candidates) {
+        if (!seen.has(candidate.action)) {
+            seen.add(candidate.action);
+            deduplicated.push(candidate);
+        }
+    }
+    return deduplicated;
+}
+//# sourceMappingURL=setup-step-discovery.js.map

package/dist/use-cases/setup-step-discovery.js.map

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

package/dist/use-cases/workflow-generator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Use case for generating Copilot Setup Steps workflow content.
+ * This module handles the transformation of setup step candidates
+ * into GitHub Actions workflow YAML.
+ */
+import type { ResolvedVersion, SetupStepCandidate } from "../entities/copilot-setup.js";
+import type { ActionVersionGateway } from "../gateways/action-version-gateway.js";
+/**
+ * Options for workflow content generation
+ */
+export interface GenerateWorkflowOptions {
+    /** Whether to use placeholder versions instead of gateway versions */
+    usePlaceholders?: boolean;
+    /** Resolved versions to use for SHA-pinning */
+    resolvedVersions?: ResolvedVersion[];
+}
+/**
+ * Generates the Copilot Setup Steps workflow content using typed workflow builder
+ * @param candidates The setup step candidates to include
+ * @param versionGateway Optional gateway for looking up action versions (defaults to local)
+ * @param options Optional generation options for placeholders and resolved versions
+ * @returns The workflow YAML content as a string
+ */
+export declare function generateWorkflowContent(candidates: SetupStepCandidate[], versionGateway?: ActionVersionGateway, options?: GenerateWorkflowOptions): Promise<string>;
+/**
+ * Updates an existing workflow by appending missing setup steps
+ * @param existingWorkflow The parsed existing workflow
+ * @param missingCandidates Candidates to add to the workflow
+ * @param versionGateway Optional gateway for looking up action versions (defaults to local)
+ * @param options Optional generation options for placeholders and resolved versions
+ * @returns The updated workflow YAML content
+ */
+export declare function updateWorkflowWithMissingSteps(existingWorkflow: unknown, missingCandidates: SetupStepCandidate[], versionGateway?: ActionVersionGateway, options?: GenerateWorkflowOptions): Promise<string>;
+//# sourceMappingURL=workflow-generator.d.ts.map

package/dist/use-cases/workflow-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-generator.d.ts","sourceRoot":"","sources":["../../src/use-cases/workflow-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EACR,eAAe,EACf,kBAAkB,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAgClF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;CACxC;AAyJD;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CACzC,UAAU,EAAE,kBAAkB,EAAE,EAChC,cAAc,GAAE,oBAAmD,EACnE,OAAO,CAAC,EAAE,uBAAuB,GAClC,OAAO,CAAC,MAAM,CAAC,CA8CjB;AAED;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAChD,gBAAgB,EAAE,OAAO,EACzB,iBAAiB,EAAE,kBAAkB,EAAE,EACvC,cAAc,GAAE,oBAAmD,EACnE,OAAO,CAAC,EAAE,uBAAuB,GAClC,OAAO,CAAC,MAAM,CAAC,CAsDjB"}

package/dist/use-cases/workflow-generator.js

@@ -0,0 +1,195 @@
+/**
+ * Use case for generating Copilot Setup Steps workflow content.
+ * This module handles the transformation of setup step candidates
+ * into GitHub Actions workflow YAML.
+ */
+import { NormalJob, Step, Workflow, } from "@github-actions-workflow-ts/lib";
+import { Scalar, stringify as stringifyYaml } from "yaml";
+import { createActionVersionGateway } from "../gateways/action-version-gateway.js";
+import { findResolvedVersion, VERSION_PLACEHOLDER, } from "./action-resolution.js";
+/**
+ * Generates a human-readable step name from an action name
+ * @example "actions/setup-node" -> "Setup node"
+ * @example "jdx/mise-action" -> "Setup mise"
+ */
+function generateStepName(actionName) {
+    const name = actionName.split("/").pop() || actionName;
+    return `Setup ${name.replace("setup-", "").replace("-action", "")}`;
+}
+/**
+ * Gets the version string for an action based on options.
+ * Priority: resolved version > candidate version > placeholder
+ */
+function getVersionForAction(action, candidateVersion, options) {
+    if (options?.resolvedVersions) {
+        const resolved = findResolvedVersion(action, options.resolvedVersions);
+        if (resolved) {
+            return resolved.sha;
+        }
+    }
+    if (options?.usePlaceholders) {
+        return VERSION_PLACEHOLDER;
+    }
+    return candidateVersion || "";
+}
+/**
+ * Builds the 'uses' value for a step, returning a YAML Scalar with comment
+ * when the action has a resolved version, or a plain string otherwise.
+ *
+ * Note: The Step constructor from @github-actions-workflow-ts/lib accepts both
+ * string and Scalar at runtime, even though its TypeScript types only declare string.
+ * We use type casts when passing the return value to Step to work around this.
+ *
+ * @param action The action name (e.g., "actions/setup-node")
+ * @param version The version string (SHA or version tag)
+ * @param options Optional conversion options for resolved versions
+ * @returns Either a Scalar with comment (for SHA-pinned) or a plain string
+ */
+function buildUsesValue(action, version, options) {
+    const uses = version ? `${action}@${version}` : action;
+    if (options?.resolvedVersions) {
+        const resolved = findResolvedVersion(action, options.resolvedVersions);
+        if (resolved) {
+            const scalar = new Scalar(uses);
+            scalar.comment = ` ${resolved.versionTag}`;
+            return scalar;
+        }
+    }
+    return uses;
+}
+/**
+ * Builds a Step object from a SetupStepCandidate
+ * @param candidate The candidate to convert to a Step
+ * @param options Optional conversion options for placeholders and resolved versions
+ * @returns A typed Step object
+ */
+function buildStepFromCandidate(candidate, options) {
+    const version = getVersionForAction(candidate.action, candidate.version, options);
+    const usesValue = buildUsesValue(candidate.action, version, options);
+    const withConfig = candidate.config && Object.keys(candidate.config).length > 0
+        ? candidate.config
+        : undefined;
+    const stepProps = {
+        name: generateStepName(candidate.action),
+        uses: usesValue,
+        with: withConfig,
+    };
+    return new Step(stepProps);
+}
+/**
+ * Converts an array of SetupStepCandidate to typed Step objects
+ * @param candidates The setup step candidates to convert
+ * @param options Optional conversion options for placeholders and resolved versions
+ * @returns Array of typed Step objects
+ */
+function buildStepsFromCandidates(candidates, options) {
+    return candidates.map((candidate) => buildStepFromCandidate(candidate, options));
+}
+/**
+ * Appends missing setup steps to an existing workflow's job steps array
+ * @param steps The existing steps array to append to
+ * @param missingCandidates The candidates to add as new steps
+ * @param options Optional conversion options for placeholders and resolved versions
+ */
+function appendMissingStepsToJob(steps, missingCandidates, options) {
+    for (const candidate of missingCandidates) {
+        const newStep = buildStepFromCandidate(candidate, options);
+        steps.push(newStep.step);
+    }
+}
+/**
+ * Gets the checkout version based on resolved versions, placeholders, or gateway.
+ * Reduces duplication by centralizing the version resolution logic.
+ */
+async function getCheckoutVersion(versionGateway, options) {
+    if (options?.resolvedVersions) {
+        const resolved = findResolvedVersion("actions/checkout", options.resolvedVersions);
+        if (resolved) {
+            return resolved.sha;
+        }
+    }
+    if (options?.usePlaceholders) {
+        return VERSION_PLACEHOLDER;
+    }
+    return (await versionGateway.getVersion("actions/checkout")) || "v4";
+}
+/**
+ * Generates the Copilot Setup Steps workflow content using typed workflow builder
+ * @param candidates The setup step candidates to include
+ * @param versionGateway Optional gateway for looking up action versions (defaults to local)
+ * @param options Optional generation options for placeholders and resolved versions
+ * @returns The workflow YAML content as a string
+ */
+export async function generateWorkflowContent(candidates, versionGateway = createActionVersionGateway(), options) {
+    const stepOptions = {
+        usePlaceholders: options?.usePlaceholders,
+        resolvedVersions: options?.resolvedVersions,
+    };
+    const checkoutVersion = await getCheckoutVersion(versionGateway, options);
+    const checkoutUsesValue = buildUsesValue("actions/checkout", checkoutVersion, stepOptions);
+    const checkoutStepProps = {
+        name: "Checkout code",
+        uses: checkoutUsesValue,
+    };
+    const steps = [
+        new Step(checkoutStepProps),
+        ...buildStepsFromCandidates(candidates, stepOptions),
+    ];
+    const job = new NormalJob("copilot-setup-steps", {
+        "runs-on": "ubuntu-latest",
+        "timeout-minutes": 30,
+        permissions: {
+            "id-token": "write",
+            contents: "read",
+        },
+    }).addSteps(steps);
+    const workflow = new Workflow("copilot-setup-steps.yml", {
+        name: "Copilot Setup Steps",
+        on: {
+            workflow_dispatch: {},
+            push: {
+                branches: ["main"],
+                paths: [".github/workflows/copilot-setup-steps.yml"],
+            },
+            pull_request: {
+                branches: ["main"],
+                paths: [".github/workflows/copilot-setup-steps.yml"],
+            },
+        },
+    }).addJob(job);
+    return `---\n${stringifyYaml(workflow.workflow, { lineWidth: 0 })}`;
+}
+/**
+ * Updates an existing workflow by appending missing setup steps
+ * @param existingWorkflow The parsed existing workflow
+ * @param missingCandidates Candidates to add to the workflow
+ * @param versionGateway Optional gateway for looking up action versions (defaults to local)
+ * @param options Optional generation options for placeholders and resolved versions
+ * @returns The updated workflow YAML content
+ */
+export async function updateWorkflowWithMissingSteps(existingWorkflow, missingCandidates, versionGateway = createActionVersionGateway(), options) {
+    if (!existingWorkflow || typeof existingWorkflow !== "object") {
+        return generateWorkflowContent(missingCandidates, versionGateway, options);
+    }
+    const workflow = JSON.parse(JSON.stringify(existingWorkflow));
+    const jobs = workflow.jobs;
+    if (!jobs) {
+        return generateWorkflowContent(missingCandidates, versionGateway, options);
+    }
+    const jobNames = Object.keys(jobs);
+    if (jobNames.length === 0) {
+        return generateWorkflowContent(missingCandidates, versionGateway, options);
+    }
+    const mainJobName = jobNames[0];
+    const mainJob = jobs[mainJobName];
+    if (!mainJob || !Array.isArray(mainJob.steps)) {
+        return generateWorkflowContent(missingCandidates, versionGateway, options);
+    }
+    const stepOptions = {
+        usePlaceholders: options?.usePlaceholders,
+        resolvedVersions: options?.resolvedVersions,
+    };
+    appendMissingStepsToJob(mainJob.steps, missingCandidates, stepOptions);
+    return `---\n${stringifyYaml(workflow, { lineWidth: 0 })}`;
+}
+//# sourceMappingURL=workflow-generator.js.map

package/dist/use-cases/workflow-generator.js.map

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

package/package.json

@@ -0,0 +1,65 @@
+{
+    "name": "@lousy-agents/cli",
+    "version": "1.0.0",
+    "description": "CLI scaffolding tool that sets up projects with structure, instructions, and feedback loops for AI coding assistants",
+    "type": "module",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/zpratt/lousy-agents.git"
+    },
+    "author": "zpratt",
+    "license": "MIT",
+    "bugs": {
+        "url": "https://github.com/zpratt/lousy-agents/issues"
+    },
+    "homepage": "https://github.com/zpratt/lousy-agents#readme",
+    "keywords": [
+        "cli",
+        "scaffolding",
+        "ai",
+        "copilot",
+        "github-copilot",
+        "coding-assistant",
+        "vibe-coding"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "files": [
+        "dist"
+    ],
+    "bin": {
+        "lousy-agents": "./dist/index.js",
+        "lousy-agents-mcp": "./dist/mcp-server.js"
+    },
+    "scripts": {
+        "dev": "tsx src/index.ts",
+        "build": "tsc",
+        "start": "node dist/index.js",
+        "test": "vitest run",
+        "lint": "biome check .",
+        "lint:fix": "biome check --write .",
+        "lint:workflows": "actionlint",
+        "lint:yaml": "yamllint ."
+    },
+    "dependencies": {
+        "@github-actions-workflow-ts/lib": "2.3.0",
+        "@modelcontextprotocol/sdk": "1.25.3",
+        "c12": "3.3.3",
+        "citty": "0.2.0",
+        "consola": "3.4.2",
+        "eta": "4.5.0",
+        "yaml": "2.8.2",
+        "zod": "4.3.6"
+    },
+    "devDependencies": {
+        "@biomejs/biome": "2.3.12",
+        "@types/chance": "1.1.7",
+        "@types/node": "24.10.4",
+        "chance": "1.1.13",
+        "tsx": "4.21.0",
+        "typescript": "5.9.3",
+        "vitest": "4.0.18",
+        "whatwg-fetch": "3.6.20"
+    }
+}