@lousy-agents/cli 4.0.2 → 5.1.0

package/README.md

@@ -0,0 +1,38 @@
+# @lousy-agents/cli
+
+CLI scaffolding for Lousy Agents.
+
+Use this package to bootstrap new projects with testing, linting, AI assistant instructions, and GitHub Copilot setup.
+
+## Quick Start
+
+```bash
+npx @lousy-agents/cli init
+```
+
+Common follow-up commands:
+
+```bash
+# Generate Copilot setup workflow in an existing repository
+npx @lousy-agents/cli copilot-setup
+
+# Create new resources such as custom agents
+npx @lousy-agents/cli new
+
+# Validate skills, agents, and instruction files
+npx @lousy-agents/cli lint
+```
+
+## Documentation
+
+- Project overview: [README](https://github.com/zpratt/lousy-agents#readme)
+- `init` command: [`docs/init.md`](https://github.com/zpratt/lousy-agents/blob/main/docs/init.md)
+- `new` command: [`docs/new.md`](https://github.com/zpratt/lousy-agents/blob/main/docs/new.md)
+- `lint` command: [`docs/lint.md`](https://github.com/zpratt/lousy-agents/blob/main/docs/lint.md)
+- `copilot-setup` command: [`docs/copilot-setup.md`](https://github.com/zpratt/lousy-agents/blob/main/docs/copilot-setup.md)
+
+## Reference Examples
+
+- React webapp scaffold: [`packages/cli/ui/copilot-with-react`](https://github.com/zpratt/lousy-agents/tree/main/packages/cli/ui/copilot-with-react)
+- Fastify API scaffold: [`packages/cli/api/copilot-with-fastify`](https://github.com/zpratt/lousy-agents/tree/main/packages/cli/api/copilot-with-fastify)
+- Citty CLI scaffold: [`packages/cli/cli/copilot-with-citty`](https://github.com/zpratt/lousy-agents/tree/main/packages/cli/cli/copilot-with-citty)

package/api/copilot-with-fastify/.vscode/mcp.json

@@ -13,7 +13,7 @@
         "lousy-agents": {
             "type": "stdio",
             "command": "npx",
-            "args": ["-y", "-p", "@lousy-agents/cli", "lousy-agents-mcp"]
+            "args": ["-y", "-p", "@lousy-agents/mcp", "lousy-agents-mcp"]
         }
     }
 }

package/cli/copilot-with-citty/.vscode/mcp.json

@@ -13,7 +13,7 @@
         "lousy-agents": {
             "type": "stdio",
             "command": "npx",
-            "args": ["-y", "-p", "@lousy-agents/cli", "lousy-agents-mcp"]
+            "args": ["-y", "-p", "@lousy-agents/mcp", "lousy-agents-mcp"]
         }
     }
 }

package/dist/index.js

@@ -31542,6 +31542,34 @@ function defaultExec(command, args, options) {
     return new FileSystemInstructionAnalysisGateway();
 }
 
+;// CONCATENATED MODULE: ../core/src/gateways/npmrc-gateway.ts
+/**
+ * Gateway for reading and writing `.npmrc` configuration files.
+ */ 
+
+const MAX_NPMRC_BYTES = 64 * 1024;
+/**
+ * File system implementation of the NpmrcGateway.
+ */ class FileSystemNpmrcGateway {
+    async readNpmrc(targetDir) {
+        const npmrcPath = await file_system_utils_resolveSafePath(targetDir, ".npmrc");
+        if (!await file_system_utils_fileExists(npmrcPath)) {
+            return null;
+        }
+        await assertFileSizeWithinLimit(npmrcPath, MAX_NPMRC_BYTES, "`.npmrc` file");
+        return (0,promises_.readFile)(npmrcPath, "utf-8");
+    }
+    async writeNpmrc(targetDir, content) {
+        const npmrcPath = await file_system_utils_resolveSafePath(targetDir, ".npmrc");
+        await (0,promises_.writeFile)(npmrcPath, content, "utf-8");
+    }
+}
+/**
+ * Creates and returns the default NpmrcGateway.
+ */ function createNpmrcGateway() {
+    return new FileSystemNpmrcGateway();
+}
+
 ;// CONCATENATED MODULE: ../core/src/entities/feedback-loop.ts
 /**
  * Core domain entities for SDLC feedback loop discovery and validation.
@@ -32281,6 +32309,53 @@ function createWorkflowGateway() {
 
 
 
+
+;// CONCATENATED MODULE: ../core/src/use-cases/add-agent-shell.ts
+/**
+ * Use case for adding agent-shell to an npm project's `.npmrc` configuration.
+ * Enables npm script observability via the agent-shell script-shell shim.
+ */ /**
+ * The script-shell entry added to `.npmrc` to enable agent-shell.
+ * Uses a PATH-resolved binary name so it works independently of local node_modules.
+ */ const AGENT_SHELL_NPMRC_ENTRY = "script-shell=agent-shell";
+/**
+ * Checks whether `.npmrc` content already has an active (non-comment) script-shell entry.
+ * Lines starting with `#` or `;` are treated as comments and ignored.
+ */ function hasScriptShellEntry(content) {
+    return /^\s*script-shell\s*=/m.test(content);
+}
+/**
+ * Adds agent-shell to the project's `.npmrc` if not already configured.
+ * Only operates on npm projects.
+ */ async function addAgentShell(input, npmrcGateway) {
+    if (input.packageManager.type !== "npm") {
+        return {
+            wasAdded: false,
+            alreadyConfigured: false
+        };
+    }
+    const existingContent = await npmrcGateway.readNpmrc(input.targetDir);
+    if (existingContent !== null && hasScriptShellEntry(existingContent)) {
+        return {
+            wasAdded: false,
+            alreadyConfigured: true
+        };
+    }
+    const newEntry = `${AGENT_SHELL_NPMRC_ENTRY}\n`;
+    let updatedContent;
+    if (existingContent !== null) {
+        const separator = existingContent.length > 0 && !existingContent.endsWith("\n") ? "\n" : "";
+        updatedContent = `${existingContent}${separator}${newEntry}`;
+    } else {
+        updatedContent = newEntry;
+    }
+    await npmrcGateway.writeNpmrc(input.targetDir, updatedContent);
+    return {
+        wasAdded: true,
+        alreadyConfigured: false
+    };
+}
+
 ;// CONCATENATED MODULE: ../core/src/use-cases/check-copilot-review-ruleset.ts
 function isCopilotCodeReviewRule(rule) {
     return rule.type === "copilot_code_review";
@@ -34759,6 +34834,7 @@ const consola = dist_createConsola();
 
 
 
+
 const copilotSetupArgs = {};
 const copilotSetupCommand = defineCommand({
     meta: {
@@ -34772,6 +34848,7 @@ const copilotSetupCommand = defineCommand({
         const workflowGateway = createWorkflowGateway();
         const copilotSetupConfig = await loadCopilotSetupConfig();
         const rulesetGateway = context.data?.rulesetGateway ?? await createGitHubRulesetGateway();
+        const npmrcGateway = context.data?.npmrcGateway ?? createNpmrcGateway();
         const prompt = context.data?.prompt ?? ((message, options)=>consola.prompt(message, options));
         consola.info("Detecting environment configuration...");
         // Step 1: Detect environment configuration files
@@ -34814,7 +34891,7 @@ const copilotSetupCommand = defineCommand({
             const missingCandidates = findMissingCandidates(allCandidates, existingActions);
             if (missingCandidates.length === 0) {
                 consola.success("Copilot Setup Steps workflow already contains all detected setup steps. No changes needed.");
-                await checkAndPromptRuleset(rulesetGateway, targetDir, prompt);
+                await runPostWorkflowSteps(rulesetGateway, npmrcGateway, targetDir, prompt, environment);
                 return;
             }
             const missingNames = missingCandidates.map((c)=>c.action).join(", ");
@@ -34834,8 +34911,8 @@ const copilotSetupCommand = defineCommand({
                 consola.info(`Included setup steps: ${actionNames}`);
             }
         }
-        // Step 6: Check for Copilot PR review rulesets
-        await checkAndPromptRuleset(rulesetGateway, targetDir, prompt);
+        // Step 6: Run post-workflow steps (ruleset + agent-shell)
+        await runPostWorkflowSteps(rulesetGateway, npmrcGateway, targetDir, prompt, environment);
     }
 });
 async function checkAndPromptRuleset(rulesetGateway, targetDir, prompt) {
@@ -34878,6 +34955,33 @@ async function checkAndPromptRuleset(rulesetGateway, targetDir, prompt) {
         consola.error(`Failed to create ruleset: ${message}. You may need admin access to the repository.`);
     }
 }
+async function runPostWorkflowSteps(rulesetGateway, npmrcGateway, targetDir, prompt, environment) {
+    await checkAndPromptRuleset(rulesetGateway, targetDir, prompt);
+    await checkAndPromptAgentShell(npmrcGateway, targetDir, prompt, environment);
+}
+async function checkAndPromptAgentShell(npmrcGateway, targetDir, prompt, environment) {
+    const npmPackageManager = environment.packageManagers.find((pm)=>pm.type === "npm");
+    if (!npmPackageManager) {
+        return;
+    }
+    const shouldAdd = await prompt("Would you like to add agent-shell to observe npm script execution?", {
+        type: "confirm",
+        default: true
+    });
+    if (!shouldAdd) {
+        consola.info("Skipping agent-shell setup.");
+        return;
+    }
+    const result = await addAgentShell({
+        targetDir,
+        packageManager: npmPackageManager
+    }, npmrcGateway);
+    if (result.alreadyConfigured) {
+        consola.success("agent-shell is already configured in .npmrc.");
+        return;
+    }
+    consola.success("Added agent-shell to .npmrc. Run `npm install -g @lousy-agents/agent-shell` to complete setup.");
+}
 
 ;// CONCATENATED MODULE: ./src/lib/config.ts
 
@@ -55810,6 +55914,84 @@ const remark = unified().use(remarkParse).use(remarkStringify).freeze()
     }
 }
 
+;// CONCATENATED MODULE: ../core/src/use-cases/apply-severity-filter.ts
+/**
+ * Shared severity filtering for lint outputs.
+ * Applies rule severity configuration to diagnostics, filtering out "off" rules,
+ * remapping "warn" → "warning", and recalculating summary counts.
+ */ /** Maps a lint target to its config key */ const TARGET_TO_CONFIG_KEY = {
+    skill: "skills",
+    agent: "agents",
+    instruction: "instructions"
+};
+/**
+ * Maps config severity to diagnostic severity.
+ * "warn" → "warning", "error" → "error", "off" → null (drop).
+ */ function apply_severity_filter_mapSeverity(configSeverity) {
+    if (configSeverity === "off") {
+        return null;
+    }
+    if (configSeverity === "warn") {
+        return "warning";
+    }
+    return configSeverity;
+}
+/**
+ * Filters instruction suggestions based on rule severity configuration.
+ * Drops suggestions whose corresponding rule is "off".
+ * Suggestions without a ruleId pass through unchanged.
+ */ function filterInstructionSuggestions(suggestions, rules) {
+    return suggestions.filter((suggestion)=>{
+        if (!suggestion.ruleId) {
+            return true;
+        }
+        return rules[suggestion.ruleId] !== "off";
+    });
+}
+/**
+ * Applies severity filtering to a LintOutput based on rule configuration.
+ * Drops diagnostics for "off" rules, remaps severity for "warn"/"error" rules.
+ * Diagnostics without a ruleId pass through unchanged.
+ * For instruction targets, also filters qualityResult.suggestions.
+ */ function applySeverityFilter(output, rulesConfig) {
+    const configKey = TARGET_TO_CONFIG_KEY[output.target];
+    const targetRules = rulesConfig[configKey];
+    const filteredDiagnostics = [];
+    for (const diagnostic of output.diagnostics){
+        const configuredSeverity = diagnostic.ruleId ? targetRules[diagnostic.ruleId] : undefined;
+        if (!configuredSeverity) {
+            filteredDiagnostics.push(diagnostic);
+            continue;
+        }
+        const mappedSeverity = apply_severity_filter_mapSeverity(configuredSeverity);
+        if (mappedSeverity === null) {
+            continue;
+        }
+        filteredDiagnostics.push({
+            ...diagnostic,
+            severity: mappedSeverity
+        });
+    }
+    const totalErrors = filteredDiagnostics.filter((d)=>d.severity === "error").length;
+    const totalWarnings = filteredDiagnostics.filter((d)=>d.severity === "warning").length;
+    const totalInfos = filteredDiagnostics.filter((d)=>d.severity === "info").length;
+    const filteredQualityResult = output.qualityResult && configKey === "instructions" ? {
+        ...output.qualityResult,
+        suggestions: filterInstructionSuggestions(output.qualityResult.suggestions, targetRules)
+    } : output.qualityResult;
+    return {
+        ...output,
+        diagnostics: filteredDiagnostics,
+        qualityResult: filteredQualityResult,
+        summary: {
+            ...output.summary,
+            totalErrors,
+            totalWarnings,
+            totalInfos
+        }
+    };
+}
+
 ;// CONCATENATED MODULE: ../core/src/use-cases/lint-agent-frontmatter.ts
 /**
  * Use case for linting GitHub Copilot custom agent frontmatter.
@@ -56111,6 +56293,7 @@ function hasFrontmatterDelimiters(content) {
 
 
 
+
 /** Schema for validating target directory */ const TargetDirSchema = schemas_string().min(1, "Target directory is required");
 /**
  * Validates the target directory.
@@ -56275,78 +56458,6 @@ function hasFrontmatterDelimiters(content) {
         consola.warn(suggestion.message);
     }
 }
-/** Maps a lint target to its config key */ const TARGET_TO_CONFIG_KEY = {
-    skill: "skills",
-    agent: "agents",
-    instruction: "instructions"
-};
-/**
- * Maps config-facing severity to diagnostic-facing severity.
- * "warn" → "warning", "error" → "error", "off" → null (drop).
- */ function lint_mapSeverity(configSeverity) {
-    if (configSeverity === "off") {
-        return null;
-    }
-    if (configSeverity === "warn") {
-        return "warning";
-    }
-    return configSeverity;
-}
-/**
- * Filters instruction suggestions based on rule severity configuration.
- * Drops suggestions whose corresponding rule is "off".
- * Suggestions without a ruleId pass through unchanged.
- */ function filterInstructionSuggestions(suggestions, rules) {
-    return suggestions.filter((suggestion)=>{
-        if (!suggestion.ruleId) {
-            return true;
-        }
-        return rules[suggestion.ruleId] !== "off";
-    });
-}
-/**
- * Applies severity filtering to a LintOutput based on rule configuration.
- * Drops diagnostics for "off" rules, remaps severity for "warn"/"error" rules.
- * Diagnostics without a ruleId pass through unchanged.
- * For instruction targets, also filters qualityResult.suggestions.
- */ function applySeverityFilter(output, rulesConfig) {
-    const configKey = TARGET_TO_CONFIG_KEY[output.target];
-    const targetRules = rulesConfig[configKey];
-    const filteredDiagnostics = [];
-    for (const diagnostic of output.diagnostics){
-        const configuredSeverity = diagnostic.ruleId ? targetRules[diagnostic.ruleId] : undefined;
-        if (!configuredSeverity) {
-            filteredDiagnostics.push(diagnostic);
-            continue;
-        }
-        const mappedSeverity = lint_mapSeverity(configuredSeverity);
-        if (mappedSeverity === null) {
-            continue;
-        }
-        filteredDiagnostics.push({
-            ...diagnostic,
-            severity: mappedSeverity
-        });
-    }
-    const totalErrors = filteredDiagnostics.filter((d)=>d.severity === "error").length;
-    const totalWarnings = filteredDiagnostics.filter((d)=>d.severity === "warning").length;
-    const totalInfos = filteredDiagnostics.filter((d)=>d.severity === "info").length;
-    const filteredQualityResult = output.qualityResult && configKey === "instructions" ? {
-        ...output.qualityResult,
-        suggestions: filterInstructionSuggestions(output.qualityResult.suggestions, targetRules)
-    } : output.qualityResult;
-    return {
-        ...output,
-        diagnostics: filteredDiagnostics,
-        qualityResult: filteredQualityResult,
-        summary: {
-            ...output.summary,
-            totalErrors,
-            totalWarnings,
-            totalInfos
-        }
-    };
-}
 /**
  * The `lint` command for validating agent skills, custom agents, and instruction files.
  */ const lintCommand = defineCommand({