@lousy-agents/cli 5.17.16 → 5.18.0

package/api/copilot-with-fastify/.agents/skills/feature-to-plan/SKILL.md

@@ -55,7 +55,7 @@ Work in a read-only planning phase first. If the runtime provides a dedicated pl
 
 1. **Discover product and engineering context.** Read whatever conventional files the repo provides — for example `AGENTS.md`, `README.md`, `CLAUDE.md`, `.github/copilot-instructions.md`, `CONTRIBUTING.md`, anything under `.github/instructions/`, or product docs under `docs/`. Don't assume any specific file exists; use what's there.
 2. **Seed Context & Goal.** Based on the argument:
-   - **Issue reference (`#N` or matches `^\d+$`):** fetch the issue and treat its Context & Goal and Acceptance Criteria sections (if present) as the starting point. Note any cross-reference IDs (e.g., a beads ID) in the issue footer.
+   - **Issue reference (`#N` or matches `^\d+$`):** fetch the issue and treat its Context & Goal and Acceptance Criteria sections (if present) as the starting point. Note any cross-reference IDs in the issue footer.
 
      ```bash
      gh issue view <N> --json title,body,labels,comments

package/api/copilot-with-fastify/package-lock.json

@@ -18,7 +18,7 @@
             },
             "devDependencies": {
                 "@biomejs/biome": "2.5.3",
-                "@lousy-agents/mcp": "5.17.15",
+                "@lousy-agents/mcp": "5.17.16",
                 "@modelcontextprotocol/server-sequential-thinking": "2026.7.4",
                 "@testcontainers/postgresql": "12.0.4",
                 "@types/node": "24.13.3",
@@ -972,9 +972,9 @@
             }
         },
         "node_modules/@lousy-agents/mcp": {
-            "version": "5.17.15",
-            "resolved": "https://registry.npmjs.org/@lousy-agents/mcp/-/mcp-5.17.15.tgz",
-            "integrity": "sha512-Ui0uDJAQB5FVYqu1/7miZK5M9cQ8/1FgSGiKKY+mfEV3CyBZx4E900k20ApXQakBh5ptZypG9lbGR+74SMymng==",
+            "version": "5.17.16",
+            "resolved": "https://registry.npmjs.org/@lousy-agents/mcp/-/mcp-5.17.16.tgz",
+            "integrity": "sha512-4WH5oFcnFLCAOChFK/yv3pItX+fuNNB4YbRU2/mZR/VyZW5JiwIWJxo1HxoGp9NXI+n3jPYbdjfcDStoGtQq3Q==",
             "dev": true,
             "license": "BSD-2-Clause-Patent",
             "dependencies": {

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

@@ -29,7 +29,7 @@
     },
     "devDependencies": {
         "@biomejs/biome": "2.5.3",
-        "@lousy-agents/mcp": "5.17.15",
+        "@lousy-agents/mcp": "5.17.16",
         "@modelcontextprotocol/server-sequential-thinking": "2026.7.4",
         "@testcontainers/postgresql": "12.0.4",
         "@types/node": "24.13.3",

package/cli/copilot-with-citty/.agents/skills/feature-to-plan/SKILL.md

@@ -55,7 +55,7 @@ Work in a read-only planning phase first. If the runtime provides a dedicated pl
 
 1. **Discover product and engineering context.** Read whatever conventional files the repo provides — for example `AGENTS.md`, `README.md`, `CLAUDE.md`, `.github/copilot-instructions.md`, `CONTRIBUTING.md`, anything under `.github/instructions/`, or product docs under `docs/`. Don't assume any specific file exists; use what's there.
 2. **Seed Context & Goal.** Based on the argument:
-   - **Issue reference (`#N` or matches `^\d+$`):** fetch the issue and treat its Context & Goal and Acceptance Criteria sections (if present) as the starting point. Note any cross-reference IDs (e.g., a beads ID) in the issue footer.
+   - **Issue reference (`#N` or matches `^\d+$`):** fetch the issue and treat its Context & Goal and Acceptance Criteria sections (if present) as the starting point. Note any cross-reference IDs in the issue footer.
 
      ```bash
      gh issue view <N> --json title,body,labels,comments

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

@@ -20,7 +20,7 @@
     },
     "devDependencies": {
         "@biomejs/biome": "2.5.3",
-        "@lousy-agents/mcp": "5.17.15",
+        "@lousy-agents/mcp": "5.17.16",
         "@modelcontextprotocol/server-sequential-thinking": "2026.7.4",
         "@types/node": "24.13.3",
         "@upstash/context7-mcp": "3.2.5",

package/dist/index.js

@@ -3032,7 +3032,7 @@ exports.basename = (path, { windows } = {}) => {
 
 
 },
-9646(__unused_rspack_module, __unused_rspack___webpack_exports__, __webpack_require__) {
+6367(__unused_rspack_module, __unused_rspack___webpack_exports__, __webpack_require__) {
 // NAMESPACE OBJECT: ../../node_modules/micromark/lib/constructs.js
 var constructs_namespaceObject = {};
 __webpack_require__.r(constructs_namespaceObject);
@@ -27525,6 +27525,312 @@ const PackageJsonSchema = schemas_object({
     return new FileSystemSkillFileGateway();
 }
 
+;// CONCATENATED MODULE: ../core/src/entities/agentic-location-catalog.ts
+/**
+ * Canonical catalog of agentic construct locations shared by lint and doctor.
+ * Pure data only — no filesystem I/O.
+ */ const agentic_location_catalog_AGENTIC_LOCATION_CATALOG = [
+    // Skill lint roots
+    {
+        id: "skill-github",
+        path: ".github/skills",
+        matchKind: "directory-prefix",
+        primaryConstruct: "skill",
+        lintTarget: "skills",
+        harnessHints: [
+            "copilot"
+        ]
+    },
+    {
+        id: "skill-claude",
+        path: ".claude/skills",
+        matchKind: "directory-prefix",
+        primaryConstruct: "skill",
+        lintTarget: "skills",
+        harnessHints: [
+            "claude"
+        ]
+    },
+    {
+        id: "skill-agents",
+        path: ".agents/skills",
+        matchKind: "directory-prefix",
+        primaryConstruct: "skill",
+        lintTarget: "skills",
+        harnessHints: [
+            "shared"
+        ]
+    },
+    // Doctor-only skill locations
+    {
+        id: "skill-pi",
+        path: ".pi/skills",
+        matchKind: "directory-prefix",
+        primaryConstruct: "skill",
+        lintTarget: "none",
+        harnessHints: [
+            "pi"
+        ]
+    },
+    {
+        id: "skill-pi-prompts",
+        path: ".pi/prompts",
+        matchKind: "directory-prefix",
+        primaryConstruct: "skill",
+        lintTarget: "none",
+        harnessHints: [
+            "pi"
+        ]
+    },
+    // Agent lint root (dual-role: agent + instruction)
+    {
+        id: "agent-github",
+        path: ".github/agents",
+        matchKind: "directory-prefix",
+        primaryConstruct: "agent",
+        secondaryConstructs: [
+            "instruction"
+        ],
+        lintTarget: "agents",
+        harnessHints: [
+            "copilot"
+        ],
+        instructionFormat: "copilot-agent"
+    },
+    // Hook lint exact configs
+    {
+        id: "hook-copilot-agent-shell",
+        path: ".github/hooks/agent-shell/hooks.json",
+        matchKind: "exact",
+        primaryConstruct: "hook",
+        lintTarget: "hooks",
+        harnessHints: [
+            "copilot"
+        ],
+        hookPlatform: "copilot"
+    },
+    {
+        id: "hook-claude-settings",
+        path: ".claude/settings.json",
+        matchKind: "exact",
+        primaryConstruct: "hook",
+        lintTarget: "hooks",
+        harnessHints: [
+            "claude"
+        ],
+        hookPlatform: "claude"
+    },
+    {
+        id: "hook-claude-settings-local",
+        path: ".claude/settings.local.json",
+        matchKind: "exact",
+        primaryConstruct: "hook",
+        lintTarget: "hooks",
+        harnessHints: [
+            "claude"
+        ],
+        hookPlatform: "claude"
+    },
+    // Doctor-only hook directory prefixes
+    {
+        id: "hook-github-dir",
+        path: ".github/hooks",
+        matchKind: "directory-prefix",
+        primaryConstruct: "hook",
+        lintTarget: "none",
+        harnessHints: [
+            "copilot"
+        ]
+    },
+    {
+        id: "hook-claude-dir",
+        path: ".claude/hooks",
+        matchKind: "directory-prefix",
+        primaryConstruct: "hook",
+        lintTarget: "none",
+        harnessHints: [
+            "claude"
+        ]
+    },
+    // Instruction lint locations
+    {
+        id: "instruction-copilot-root",
+        path: ".github/copilot-instructions.md",
+        matchKind: "exact",
+        primaryConstruct: "instruction",
+        lintTarget: "instructions",
+        harnessHints: [
+            "copilot"
+        ],
+        instructionFormat: "copilot-instructions"
+    },
+    {
+        id: "instruction-copilot-scoped",
+        path: ".github/instructions",
+        matchKind: "directory-prefix",
+        primaryConstruct: "instruction",
+        lintTarget: "instructions",
+        harnessHints: [
+            "copilot"
+        ],
+        instructionFormat: "copilot-scoped"
+    },
+    {
+        id: "instruction-agents-md",
+        path: "AGENTS.md",
+        matchKind: "exact",
+        primaryConstruct: "instruction",
+        lintTarget: "instructions",
+        harnessHints: [
+            "shared"
+        ],
+        instructionFormat: "agents-md"
+    },
+    {
+        id: "instruction-claude-md",
+        path: "CLAUDE.md",
+        matchKind: "exact",
+        primaryConstruct: "instruction",
+        lintTarget: "instructions",
+        harnessHints: [
+            "claude"
+        ],
+        instructionFormat: "claude-md"
+    },
+    // Doctor-only construct locations
+    {
+        id: "subagent-claude",
+        path: ".claude/agents",
+        matchKind: "directory-prefix",
+        primaryConstruct: "subagent",
+        lintTarget: "none",
+        harnessHints: [
+            "claude"
+        ]
+    },
+    {
+        id: "agent-claude-commands",
+        path: ".claude/commands",
+        matchKind: "directory-prefix",
+        primaryConstruct: "agent",
+        lintTarget: "none",
+        harnessHints: [
+            "claude"
+        ]
+    },
+    {
+        id: "plugin-codex",
+        path: ".codex-plugin",
+        matchKind: "directory-prefix",
+        primaryConstruct: "plugin",
+        lintTarget: "none",
+        harnessHints: [
+            "codex"
+        ]
+    }
+];
+
+;// CONCATENATED MODULE: ../core/src/lib/agentic-location-matchers.ts
+/**
+ * Pure path→construct matching helpers over the agentic location catalog.
+ * No filesystem I/O.
+ */ 
+/**
+ * Normalizes a repo-relative path for catalog matching.
+ * Collapses `.` / `..` segments. Returns "" when the path is absolute or
+ * escapes the repository root — callers treat "" as non-matching.
+ */ function normalizeRepoRelativePath(path) {
+    const normalized = path.replaceAll("\\", "/");
+    // POSIX absolute, UNC-style leading slash after backslash conversion,
+    // and Windows drive-letter absolute (C:/..., d:\...).
+    if (normalized.startsWith("/") || /^[A-Za-z]:(\/|$)/.test(normalized)) {
+        return "";
+    }
+    const resolved = [];
+    for (const segment of normalized.split("/")){
+        if (segment === "" || segment === ".") {
+            continue;
+        }
+        if (segment === "..") {
+            if (resolved.length === 0) {
+                return "";
+            }
+            resolved.pop();
+            continue;
+        }
+        resolved.push(segment);
+    }
+    return resolved.join("/");
+}
+function matchesLocationEntry(path, entry) {
+    const normalized = normalizeRepoRelativePath(path);
+    if (entry.matchKind === "exact") {
+        return normalized === entry.path;
+    }
+    return normalized === entry.path || normalized.startsWith(`${entry.path}/`);
+}
+function entriesMatchingPath(path, catalog = agentic_location_catalog_AGENTIC_LOCATION_CATALOG) {
+    return catalog.filter((entry)=>matchesLocationEntry(path, entry));
+}
+function specificityScore(entry) {
+    // Exact matches outrank any prefix; longer prefixes outrank shorter ones.
+    const kindBonus = entry.matchKind === "exact" ? 1_000_000 : 0;
+    return kindBonus + entry.path.length;
+}
+function bestMatchingEntry(path, catalog = agentic_location_catalog_AGENTIC_LOCATION_CATALOG) {
+    const matches = entriesMatchingPath(path, catalog);
+    if (matches.length === 0) {
+        return null;
+    }
+    let best = matches[0];
+    let bestScore = specificityScore(best);
+    for(let i = 1; i < matches.length; i++){
+        const candidate = matches[i];
+        const score = specificityScore(candidate);
+        if (score > bestScore) {
+            best = candidate;
+            bestScore = score;
+        }
+    }
+    return best;
+}
+function primaryConstructTypeForPath(path, catalog = agentic_location_catalog_AGENTIC_LOCATION_CATALOG) {
+    return bestMatchingEntry(path, catalog)?.primaryConstruct ?? null;
+}
+function constructTypesForPath(path, catalog = AGENTIC_LOCATION_CATALOG) {
+    const best = bestMatchingEntry(path, catalog);
+    if (!best) {
+        return [];
+    }
+    if (best.secondaryConstructs && best.secondaryConstructs.length > 0) {
+        return [
+            best.primaryConstruct,
+            ...best.secondaryConstructs
+        ];
+    }
+    return [
+        best.primaryConstruct
+    ];
+}
+function lintTargetEntries(target, catalog = agentic_location_catalog_AGENTIC_LOCATION_CATALOG) {
+    return catalog.filter((entry)=>entry.lintTarget === target);
+}
+function skillDirectoryRoots(catalog = agentic_location_catalog_AGENTIC_LOCATION_CATALOG) {
+    return lintTargetEntries("skills", catalog).filter((entry)=>entry.matchKind === "directory-prefix").map((entry)=>entry.path);
+}
+function agentDirectoryRoots(catalog = agentic_location_catalog_AGENTIC_LOCATION_CATALOG) {
+    return lintTargetEntries("agents", catalog).filter((entry)=>entry.matchKind === "directory-prefix").map((entry)=>entry.path);
+}
+function hookConfigPaths(catalog = agentic_location_catalog_AGENTIC_LOCATION_CATALOG) {
+    return lintTargetEntries("hooks", catalog).filter((entry)=>entry.matchKind === "exact" && entry.hookPlatform != null).map((entry)=>({
+            relativePath: entry.path,
+            platform: entry.hookPlatform
+        }));
+}
+function instructionDiscoveryEntries(catalog = agentic_location_catalog_AGENTIC_LOCATION_CATALOG) {
+    return catalog.filter((entry)=>entry.instructionFormat != null);
+}
+
 ;// CONCATENATED MODULE: ../core/src/gateways/skill-lint-gateway.ts
 /**
  * Gateway for skill lint file system operations.
@@ -27533,14 +27839,9 @@ const PackageJsonSchema = schemas_object({
 
 
 
+
 /** Maximum skill file size: 1 MB */ const MAX_SKILL_FILE_BYTES = 1_048_576;
-/**
- * Skill directory locations to search for SKILL.md files.
- */ const SKILL_DIRECTORIES = [
-    (0,external_node_path_.join)(".github", "skills"),
-    (0,external_node_path_.join)(".claude", "skills"),
-    (0,external_node_path_.join)(".agents", "skills")
-];
+/** Catalog skill roots converted to OS-native relative paths. */ const SKILL_DIRECTORIES = skillDirectoryRoots().map((root)=>(0,external_node_path_.join)(...root.split("/")));
 /** Maximum lock file size: 256 KB */ const MAX_LOCK_FILE_BYTES = 262_144;
 /** Relative path to the skills lock file. */ const SKILLS_LOCK_PATH = "skills-lock.json";
 /** Zod schema for skills-lock.json structure */ const SkillsLockSchema = schemas_object({
@@ -29677,7 +29978,10 @@ const HARNESS_FOOTPRINTS = {
         ],
         primaryIndicators: [
             ".github/copilot-instructions.md",
-            ".github/instructions/"
+            ".github/instructions/",
+            ".github/skills/",
+            ".github/agents/",
+            ".github/hooks/"
         ],
         crossRefMechanisms: [
             {
@@ -29996,6 +30300,7 @@ async function enumerateMcpServers(repoRoot) {
 
 
 
+
 const MAX_FILE_BYTES = 1_048_576;
 const SCANNABLE_EXTENSIONS = new Set([
     ".md",
@@ -30023,22 +30328,7 @@ function isMarkdownFile(name) {
     return name.endsWith(".md") || name.endsWith(".mdc");
 }
 function determineConstructType(relPath) {
-    if (relPath.startsWith(".agents/skills/") || relPath.startsWith(".pi/skills/") || relPath.startsWith(".pi/prompts/")) {
-        return "skill";
-    }
-    if (relPath.startsWith(".codex-plugin/")) {
-        return "plugin";
-    }
-    if (relPath.startsWith(".claude/hooks/")) {
-        return "hook";
-    }
-    if (relPath.startsWith(".claude/agents/")) {
-        return "subagent";
-    }
-    if (relPath.startsWith(".claude/commands/")) {
-        return "agent";
-    }
-    return "instruction";
+    return primaryConstructTypeForPath(relPath) ?? "instruction";
 }
 function determineHarness(repoRelativePath) {
     const matching = ALL_HARNESS_NAMES.filter((harness)=>matchesPrimaryIndicator(repoRelativePath, HARNESS_FOOTPRINTS[harness].primaryIndicators));
@@ -32435,12 +32725,21 @@ function createInitHooksCommand(useCase) {
  */ 
 
 
+
 /** Maximum agent file size: 1 MB */ const MAX_AGENT_FILE_BYTES = 1_048_576;
+/** Catalog agent roots converted to OS-native relative paths. */ const AGENT_DIRECTORIES = agentDirectoryRoots().map((root)=>(0,external_node_path_.join)(...root.split("/")));
 /**
  * File system implementation of the agent lint gateway.
  */ class FileSystemAgentLintGateway {
     async discoverAgents(targetDir) {
-        const agentsDir = (0,external_node_path_.join)(".github", "agents");
+        const agents = [];
+        for (const agentsDir of AGENT_DIRECTORIES){
+            const discovered = await this.discoverAgentsInDir(targetDir, agentsDir);
+            agents.push(...discovered);
+        }
+        return agents;
+    }
+    async discoverAgentsInDir(targetDir, agentsDir) {
         try {
             if (!await file_system_utils_pathExistsWithinRoot(targetDir, agentsDir)) {
                 return [];
@@ -32506,25 +32805,14 @@ function createInitHooksCommand(useCase) {
  * Discovers hook config files for GitHub Copilot and Claude Code.
  */ 
 
+
 /** Maximum hook config file size: 1 MB */ const MAX_CONFIG_FILE_BYTES = 1_048_576;
 /** Matches the Copilot hook key `"preToolUse":` to detect hook section presence */ const COPILOT_HOOK_PATTERN = /"preToolUse"\s*:/;
 /** Matches the Claude hook key `"PreToolUse":` to detect hook section presence */ const CLAUDE_HOOK_PATTERN = /"PreToolUse"\s*:/;
-/**
- * Hook configuration file locations to search.
- */ const HOOK_CONFIG_PATHS = [
-    {
-        relativePath: (0,external_node_path_.join)(".github", "hooks", "agent-shell", "hooks.json"),
-        platform: "copilot"
-    },
-    {
-        relativePath: (0,external_node_path_.join)(".claude", "settings.json"),
-        platform: "claude"
-    },
-    {
-        relativePath: (0,external_node_path_.join)(".claude", "settings.local.json"),
-        platform: "claude"
-    }
-];
+/** Catalog hook config paths converted to OS-native relative paths. */ const HOOK_CONFIG_PATHS = hookConfigPaths().map((entry)=>({
+        relativePath: (0,external_node_path_.join)(...entry.relativePath.split("/")),
+        platform: entry.platform
+    }));
 /**
  * File system implementation of the hook config lint gateway.
  */ class FileSystemHookConfigGateway {
@@ -32593,40 +32881,28 @@ function createInitHooksCommand(useCase) {
  * Supports GitHub Copilot, Claude Code, and community agent instruction formats.
  */ 
 
+
 /**
  * File system implementation of the instruction file discovery gateway.
  */ class FileSystemInstructionFileDiscoveryGateway {
     async discoverInstructionFiles(targetDir) {
         const files = [];
-        // .github/copilot-instructions.md
-        const copilotInstructions = (0,external_node_path_.join)(".github", "copilot-instructions.md");
-        if (await this.safePathExists(targetDir, copilotInstructions)) {
-            files.push({
-                filePath: (0,external_node_path_.join)(targetDir, copilotInstructions),
-                format: "copilot-instructions"
-            });
-        }
-        // .github/instructions/*.md
-        const instructionsDir = (0,external_node_path_.join)(".github", "instructions");
-        await this.discoverMdFilesInDir(targetDir, instructionsDir, "copilot-scoped", files);
-        // .github/agents/*.md
-        const agentsDir = (0,external_node_path_.join)(".github", "agents");
-        await this.discoverMdFilesInDir(targetDir, agentsDir, "copilot-agent", files);
-        // AGENTS.md at repo root
-        const agentsMd = "AGENTS.md";
-        if (await this.safePathExists(targetDir, agentsMd)) {
-            files.push({
-                filePath: (0,external_node_path_.join)(targetDir, agentsMd),
-                format: "agents-md"
-            });
-        }
-        // CLAUDE.md at repo root
-        const claudeMd = "CLAUDE.md";
-        if (await this.safePathExists(targetDir, claudeMd)) {
-            files.push({
-                filePath: (0,external_node_path_.join)(targetDir, claudeMd),
-                format: "claude-md"
-            });
+        for (const entry of instructionDiscoveryEntries()){
+            const format = entry.instructionFormat;
+            if (format == null) {
+                continue;
+            }
+            const relativePath = (0,external_node_path_.join)(...entry.path.split("/"));
+            if (entry.matchKind === "exact") {
+                if (await this.safePathExists(targetDir, relativePath)) {
+                    files.push({
+                        filePath: (0,external_node_path_.join)(targetDir, relativePath),
+                        format
+                    });
+                }
+                continue;
+            }
+            await this.discoverMdFilesInDir(targetDir, relativePath, format, files);
         }
         return files;
     }
@@ -62612,4 +62888,4 @@ if (installedChunkData !== 0) { // 0 means "already installed".'
 // module factories are used so entry inlining is disabled
 // startup
 // Load entry module and return exports
-var __webpack_exports__ = __webpack_require__(9646);
+var __webpack_exports__ = __webpack_require__(6367);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lousy-agents/cli",
-    "version": "5.17.16",
+    "version": "5.18.0",
     "description": "CLI scaffolding tool that sets up projects with structure, instructions, and feedback loops for AI coding assistants",
     "type": "module",
     "repository": {

package/ui/copilot-with-react/.agents/skills/feature-to-plan/SKILL.md

@@ -55,7 +55,7 @@ Work in a read-only planning phase first. If the runtime provides a dedicated pl
 
 1. **Discover product and engineering context.** Read whatever conventional files the repo provides — for example `AGENTS.md`, `README.md`, `CLAUDE.md`, `.github/copilot-instructions.md`, `CONTRIBUTING.md`, anything under `.github/instructions/`, or product docs under `docs/`. Don't assume any specific file exists; use what's there.
 2. **Seed Context & Goal.** Based on the argument:
-   - **Issue reference (`#N` or matches `^\d+$`):** fetch the issue and treat its Context & Goal and Acceptance Criteria sections (if present) as the starting point. Note any cross-reference IDs (e.g., a beads ID) in the issue footer.
+   - **Issue reference (`#N` or matches `^\d+$`):** fetch the issue and treat its Context & Goal and Acceptance Criteria sections (if present) as the starting point. Note any cross-reference IDs in the issue footer.
 
      ```bash
      gh issue view <N> --json title,body,labels,comments

package/ui/copilot-with-react/package.json

@@ -23,7 +23,7 @@
     "devDependencies": {
         "@biomejs/biome": "2.5.3",
         "@eslint/eslintrc": "3.3.6",
-        "@lousy-agents/mcp": "5.17.15",
+        "@lousy-agents/mcp": "5.17.16",
         "@modelcontextprotocol/server-sequential-thinking": "2026.7.4",
         "@testing-library/jest-dom": "7.0.0",
         "@testing-library/react": "16.3.2",