@agent-lint/mcp 0.3.3 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @agent-lint/mcp Changelog
 
+## 0.4.0
+
+### Minor Changes
+
+- 637e0e2: Add maintenance rule installation to `agent-lint init`, make repeated installs update managed rule files cleanly, and expand maintenance snippets so agents can infer Agent Lint tasks from plain-English context requests.
+
+## 0.3.4
+
+### Patch Changes
+
+- a4047fa: Fix doctor workspace discovery and report persistence regressions, and align cross-platform fixture coverage for CLI and MCP outputs.
+
 ## [0.3.3]
 
 ### Fixed

package/dist/bin.js

@@ -4,7 +4,7 @@ import {
   logMcp,
   runHttpServer,
   runStdioServer
-} from "./chunk-DYP46E6V.js";
+} from "./chunk-PAQI5DE3.js";
 
 // src/bin.ts
 var nodeVersion = parseInt(process.versions.node.split(".")[0], 10);

package/dist/{chunk-DYP46E6V.js → chunk-PAQI5DE3.js}

@@ -17304,19 +17304,6 @@ var artifactTypeValues = [
   "plans"
 ];
 var artifactTypeSchema = external_exports.enum(artifactTypeValues);
-var contextDocumentSchema = external_exports.object({
-  label: external_exports.string().min(1).max(120),
-  content: external_exports.string().min(1).max(2e5),
-  path: external_exports.string().min(1).max(512).optional(),
-  type: artifactTypeSchema.optional(),
-  priority: external_exports.number().int().min(0).max(10).optional()
-});
-var artifactSubmissionSchema = external_exports.object({
-  type: artifactTypeSchema,
-  content: external_exports.string().min(1).max(1e6),
-  contextDocuments: external_exports.array(contextDocumentSchema).max(20).optional(),
-  userId: external_exports.string().min(1).max(128).optional()
-});
 var qualityMetricIds = [
   "clarity",
   "specificity",
@@ -17356,71 +17343,112 @@ var AGENT_HINTS = [
     ecosystem: "Root docs",
     patterns: ["AGENTS.md", "CLAUDE.md"],
     examples: ["AGENTS.md", "CLAUDE.md"],
+    discoveryTier: "canonical",
     notes: "Prefer root-level files when available."
   },
   {
     ecosystem: "Nested policy docs",
-    patterns: ["**/.agents/**/*.md", "docs/**/agents*.md"],
-    examples: [".agents/AGENTS.md", "docs/agent_guide.md"]
+    patterns: [
+      ".agents/AGENTS.md",
+      ".agents/**/AGENTS.md",
+      ".agents/CLAUDE.md",
+      ".agents/**/CLAUDE.md"
+    ],
+    examples: [".agents/AGENTS.md", ".agents/team/CLAUDE.md"],
+    discoveryTier: "canonical"
+  },
+  {
+    ecosystem: "Fallback docs",
+    patterns: ["docs/**/agents*.md"],
+    examples: ["docs/agent_guide.md"],
+    discoveryTier: "fallback"
   }
 ];
 var SKILL_HINTS = [
   {
     ecosystem: "Windsurf",
-    patterns: [".windsurf/skills/**/SKILL.md", ".windsurf/skills/**/*.md"],
-    examples: [".windsurf/skills/frontend/SKILL.md"]
+    patterns: [".windsurf/skills/**/SKILL.md"],
+    examples: [".windsurf/skills/frontend/SKILL.md"],
+    discoveryTier: "canonical"
   },
   {
     ecosystem: "Claude/Cline style",
     patterns: [".claude/skills/**/SKILL.md", ".skills/**/SKILL.md", "skills/**/SKILL.md"],
-    examples: ["skills/release/SKILL.md", ".claude/skills/testing/SKILL.md"]
+    examples: ["skills/release/SKILL.md", ".claude/skills/testing/SKILL.md"],
+    discoveryTier: "canonical"
   },
   {
     ecosystem: "Agent Skills standard",
     patterns: [".agents/skills/**/SKILL.md", ".github/skills/**/SKILL.md"],
-    examples: [".agents/skills/release/SKILL.md", ".github/skills/security-review/SKILL.md"]
+    examples: [".agents/skills/release/SKILL.md", ".github/skills/security-review/SKILL.md"],
+    discoveryTier: "canonical"
   },
   {
     ecosystem: "Generic",
     patterns: ["**/*skill*.md", "**/SKILL.md"],
     examples: ["docs/skills/code-review-skill.md"],
+    discoveryTier: "fallback",
     notes: "Use content heuristics when naming is inconsistent."
   }
 ];
 var RULE_HINTS = [
   {
     ecosystem: "Root/docs",
-    patterns: ["rules.md", "docs/rules.md", "docs/**/*rule*.md"],
-    examples: ["docs/rules.md", "rules.md"]
+    patterns: ["rules.md", "docs/rules.md"],
+    examples: ["docs/rules.md", "rules.md"],
+    discoveryTier: "canonical"
   },
   {
     ecosystem: "Editor-specific",
     patterns: [".cursor/rules/**/*.md", ".cursor/rules/**/*.mdc", ".windsurf/rules/**/*.md"],
-    examples: [".cursor/rules/typescript.mdc"]
+    examples: [".cursor/rules/typescript.mdc"],
+    discoveryTier: "canonical"
+  },
+  {
+    ecosystem: "Fallback docs",
+    patterns: ["docs/**/*rule*.md"],
+    examples: ["docs/backend-rule-overrides.md"],
+    discoveryTier: "fallback"
   }
 ];
 var WORKFLOW_HINTS = [
   {
     ecosystem: "Slash-command docs",
-    patterns: ["docs/workflows/**/*.md", "docs/commands/**/*.md", "**/*workflow*.md"],
-    examples: ["docs/workflows/release.md", "docs/commands/fix.md"]
+    patterns: ["docs/workflows/**/*.md", "docs/commands/**/*.md"],
+    examples: ["docs/workflows/release.md", "docs/commands/fix.md"],
+    discoveryTier: "canonical"
   },
   {
     ecosystem: "Client command folders",
     patterns: [".claude/commands/**/*.md", ".windsurf/workflows/**/*.md"],
-    examples: [".claude/commands/review.md"]
+    examples: [".claude/commands/review.md"],
+    discoveryTier: "canonical"
+  },
+  {
+    ecosystem: "Fallback docs",
+    patterns: ["**/*workflow*.md"],
+    examples: ["docs/deploy-workflow.md"],
+    discoveryTier: "fallback"
   }
 ];
 var PLAN_HINTS = [
   {
     ecosystem: "Roadmap/plan docs",
-    patterns: ["docs/**/*plan*.md", "docs/**/*roadmap*.md", "docs/**/*backlog*.md"],
-    examples: ["docs/phased_implementation_plan.md", "docs/roadmap_master.md"]
+    patterns: ["docs/plans/**/*.md", "docs/backlog/**/*.md"],
+    examples: ["docs/plans/auth-and-billing-rollout.md", "docs/backlog/q2.md"],
+    discoveryTier: "canonical"
   },
   {
     ecosystem: "Top-level planning",
     patterns: ["PLAN.md", "great_plan.md", "PRD.md"],
-    examples: ["docs/great_plan.md", "docs/PRD.md"]
+    examples: ["PLAN.md", "PRD.md"],
+    discoveryTier: "canonical"
+  },
+  {
+    ecosystem: "Fallback docs",
+    patterns: ["docs/**/*plan*.md", "docs/**/*roadmap*.md", "docs/**/*backlog*.md"],
+    examples: ["docs/phased_implementation_plan.md", "docs/roadmap_master.md"],
+    discoveryTier: "fallback"
   }
 ];
 function getArtifactPathHints(type) {
@@ -17438,6 +17466,9 @@ function getArtifactPathHints(type) {
   }
   return PLAN_HINTS;
 }
+function getArtifactDiscoveryPatterns(type, tier = "canonical") {
+  return getArtifactPathHints(type).filter((hint) => hint.discoveryTier === tier).flatMap((hint) => hint.patterns);
+}
 function buildArtifactPathHintsMarkdown(type) {
   const hints = getArtifactPathHints(type);
   const lines = [
@@ -17450,6 +17481,8 @@ function buildArtifactPathHintsMarkdown(type) {
   for (const hint of hints) {
     lines.push(`## ${hint.ecosystem}`);
     lines.push("");
+    lines.push(`Discovery tier: ${hint.discoveryTier}`);
+    lines.push("");
     lines.push("Patterns:");
     for (const pattern of hint.patterns) {
       lines.push(`- ${pattern}`);
@@ -18197,11 +18230,17 @@ function buildTemplateMarkdown(type) {
     "```"
   ].join("\n");
 }
+function normalizePath(filePath) {
+  return filePath.replace(/\\/g, "/");
+}
 var SKIP_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
   ".git",
   ".next",
   ".nuxt",
+  ".turbo",
+  ".idea",
+  ".vscode",
   "dist",
   "build",
   "out",
@@ -18212,51 +18251,18 @@ var SKIP_DIRS = /* @__PURE__ */ new Set([
   "vendor",
   "target"
 ]);
+var ALLOWED_HIDDEN_DIRS = /* @__PURE__ */ new Set([
+  ".agents",
+  ".claude",
+  ".cursor",
+  ".github",
+  ".skills",
+  ".windsurf"
+]);
 var ARTIFACT_EXTENSIONS = /* @__PURE__ */ new Set([".md", ".mdc", ".yaml", ".yml", ".txt"]);
 var MAX_FILES = 200;
 var MAX_DEPTH = 6;
 var MAX_FILE_SIZE = 5e5;
-function shouldSkipDir(name) {
-  return SKIP_DIRS.has(name) || name.startsWith(".");
-}
-function isArtifactExtension(filePath) {
-  return ARTIFACT_EXTENSIONS.has(path.extname(filePath).toLowerCase());
-}
-function inferArtifactType(filePath, content) {
-  const normalized = filePath.replace(/\\/g, "/").toLowerCase();
-  const lowerContent = content.substring(0, 2e3).toLowerCase();
-  if (/agents\.md$/i.test(normalized) || /claude\.md$/i.test(normalized)) {
-    return "agents";
-  }
-  if (normalized.includes("skill")) {
-    return "skills";
-  }
-  if (normalized.includes("rule")) {
-    return "rules";
-  }
-  if (normalized.includes("workflow") || normalized.includes("command")) {
-    return "workflows";
-  }
-  if (normalized.includes("plan") || normalized.includes("roadmap") || normalized.includes("backlog")) {
-    return "plans";
-  }
-  if (lowerContent.includes("agents.md") || lowerContent.includes("claude.md")) {
-    return "agents";
-  }
-  if (lowerContent.includes("disable-model-invocation") || lowerContent.includes("required frontmatter")) {
-    return "skills";
-  }
-  if (lowerContent.includes("activation mode") || lowerContent.includes("do block")) {
-    return "rules";
-  }
-  if (lowerContent.includes("ordered steps") || lowerContent.includes("preconditions")) {
-    return "workflows";
-  }
-  if (lowerContent.includes("acceptance criteria") || lowerContent.includes("## phases")) {
-    return "plans";
-  }
-  return null;
-}
 var REQUIRED_SECTIONS = {
   agents: [
     "quick commands",
@@ -18298,70 +18304,143 @@ var REQUIRED_SECTIONS = {
     "evidence"
   ]
 };
+var CANONICAL_MATCHERS = artifactTypeValues.flatMap(
+  (type) => getArtifactDiscoveryPatterns(type, "canonical").map((pattern) => ({
+    type,
+    regex: globToRegExp(pattern)
+  }))
+);
+function escapeRegExp(value) {
+  return value.replace(/[|\\{}()[\]^$+?.]/g, "\\$&");
+}
+function globToRegExp(pattern) {
+  const normalizedPattern = normalizePath(pattern);
+  let source = "^";
+  for (let i = 0; i < normalizedPattern.length; i++) {
+    const char = normalizedPattern[i];
+    if (char === "*") {
+      const next = normalizedPattern[i + 1];
+      const afterNext = normalizedPattern[i + 2];
+      if (next === "*" && afterNext === "/") {
+        source += "(?:.*/)?";
+        i += 2;
+        continue;
+      }
+      if (next === "*") {
+        source += ".*";
+        i += 1;
+        continue;
+      }
+      source += "[^/]*";
+      continue;
+    }
+    if (char === "?") {
+      source += "[^/]";
+      continue;
+    }
+    source += escapeRegExp(char);
+  }
+  source += "$";
+  return new RegExp(source, "i");
+}
+function shouldSkipDir(name) {
+  return SKIP_DIRS.has(name) || name.startsWith(".") && !ALLOWED_HIDDEN_DIRS.has(name);
+}
+function isArtifactExtension(filePath) {
+  return ARTIFACT_EXTENSIONS.has(path.extname(filePath).toLowerCase());
+}
+function matchArtifactType(relativePath) {
+  for (const matcher of CANONICAL_MATCHERS) {
+    if (matcher.regex.test(relativePath)) {
+      return matcher.type;
+    }
+  }
+  return null;
+}
 function findMissingSections(content, type) {
   const lowerContent = content.toLowerCase();
   const required2 = REQUIRED_SECTIONS[type];
   return required2.filter((section) => !lowerContent.includes(section));
 }
-function collectCandidateFiles(rootPath, currentDepth, results) {
+function collectCandidateFiles(rootPath, currentPath, currentDepth, results) {
   if (currentDepth > MAX_DEPTH || results.length >= MAX_FILES) {
     return;
   }
   let entries;
   try {
-    entries = fs.readdirSync(rootPath, { withFileTypes: true });
+    entries = fs.readdirSync(currentPath, { withFileTypes: true });
   } catch {
     return;
   }
+  entries.sort((a, b) => a.name.localeCompare(b.name));
   for (const entry of entries) {
     if (results.length >= MAX_FILES) {
       break;
     }
-    const fullPath = path.join(rootPath, entry.name);
+    const fullPath = path.join(currentPath, entry.name);
     if (entry.isDirectory()) {
-      if (!shouldSkipDir(entry.name) || entry.name === ".cursor" || entry.name === ".windsurf" || entry.name === ".claude" || entry.name === ".agents") {
-        collectCandidateFiles(fullPath, currentDepth + 1, results);
+      if (!shouldSkipDir(entry.name)) {
+        collectCandidateFiles(rootPath, fullPath, currentDepth + 1, results);
       }
-    } else if (entry.isFile() && isArtifactExtension(entry.name)) {
-      results.push(fullPath);
+      continue;
+    }
+    if (!entry.isFile() || !isArtifactExtension(entry.name)) {
+      continue;
     }
+    const relativePath = normalizePath(path.relative(rootPath, fullPath));
+    const type = matchArtifactType(relativePath);
+    if (!type) {
+      continue;
+    }
+    results.push({
+      filePath: fullPath,
+      relativePath,
+      type
+    });
   }
 }
 function findSuggestedPath(type, rootPath) {
-  const hints = getArtifactPathHints(type);
-  if (hints.length > 0 && hints[0].examples.length > 0) {
-    return path.join(rootPath, hints[0].examples[0]);
+  const canonicalHints = getArtifactPathHints(type).filter(
+    (hint) => hint.discoveryTier === "canonical"
+  );
+  for (const hint of canonicalHints) {
+    if (hint.examples.length > 0) {
+      return path.join(rootPath, hint.examples[0]);
+    }
+  }
+  const allHints = getArtifactPathHints(type);
+  for (const hint of allHints) {
+    if (hint.examples.length > 0) {
+      return path.join(rootPath, hint.examples[0]);
+    }
   }
   return path.join(rootPath, `${type.toUpperCase()}.md`);
 }
 function discoverWorkspaceArtifacts(rootPath) {
   const resolvedRoot = path.resolve(rootPath);
-  const candidatePaths = [];
-  collectCandidateFiles(resolvedRoot, 0, candidatePaths);
+  const candidateFiles = [];
+  collectCandidateFiles(resolvedRoot, resolvedRoot, 0, candidateFiles);
+  candidateFiles.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
   const discovered = [];
   const foundTypes = /* @__PURE__ */ new Set();
-  for (const filePath of candidatePaths) {
+  for (const candidate of candidateFiles) {
     let content;
     let stats;
     try {
-      stats = fs.statSync(filePath);
+      stats = fs.statSync(candidate.filePath);
       if (stats.size > MAX_FILE_SIZE) {
         continue;
       }
-      content = fs.readFileSync(filePath, "utf-8");
+      content = fs.readFileSync(candidate.filePath, "utf-8");
     } catch {
       continue;
     }
-    const type = inferArtifactType(filePath, content);
-    if (!type) {
-      continue;
-    }
-    foundTypes.add(type);
-    const missingSections = findMissingSections(content, type);
+    foundTypes.add(candidate.type);
+    const missingSections = findMissingSections(content, candidate.type);
     discovered.push({
-      filePath,
-      relativePath: path.relative(resolvedRoot, filePath),
-      type,
+      filePath: candidate.filePath,
+      relativePath: candidate.relativePath,
+      type: candidate.type,
       exists: true,
       sizeBytes: stats.size,
       isEmpty: content.trim().length === 0,
@@ -18374,7 +18453,7 @@ function discoverWorkspaceArtifacts(rootPath) {
       missing.push({
         type,
         suggestedPath: findSuggestedPath(type, resolvedRoot),
-        reason: `No ${type} artifact found in the workspace.`
+        reason: `No canonical ${type} artifact found in the workspace.`
       });
     }
   }
@@ -18673,10 +18752,13 @@ function buildQuickCheckMarkdown(signals, changedPaths, changeDescription) {
   return lines.join("\n");
 }
 var CORE_RULES = [
-  "After any structural change (new module, new directory, new script, new dependency), call agentlint_quick_check with the changed paths to determine if context artifacts need updating.",
-  "Before creating or updating any AGENTS.md, CLAUDE.md, skills, rules, workflows, or plans file, call agentlint_get_guidelines for the artifact type to get the full specification.",
-  "When the user asks to review or fix context artifacts, call agentlint_plan_workspace_autofix to discover all artifacts and get a step-by-step fix plan.",
-  "Apply recommended changes directly using your file editing capabilities. Do not wait for explicit confirmation.",
+  "Treat plain-English requests about stale, missing, inconsistent, or low-quality AGENTS.md, CLAUDE.md, rules, skills, workflows, or plans as Agent Lint work even if the user does not name Agent Lint explicitly.",
+  "Treat structural change signals such as new modules, new directories, dependency changes, CI/config updates, environment/security changes, or repository reorganization as reasons to check whether context artifacts need updates.",
+  "For full workspace review or fix requests, start with agentlint_plan_workspace_autofix to scan the repository and produce the action plan.",
+  "For targeted structural changes, call agentlint_quick_check with changed paths and/or a short change description before editing any context artifacts.",
+  "Before creating or updating any AGENTS.md, CLAUDE.md, skills, rules, workflows, or plans file, call agentlint_get_guidelines for the artifact type to get the current specification.",
+  "When the user wants ongoing upkeep, use agentlint_emit_maintenance_snippet where supported or append equivalent maintenance instructions to the main project context file.",
+  "Apply recommended context artifact changes directly once Agent Lint has identified what to update.",
   "Keep context artifact files concise (under 10,000 characters). Reference external docs instead of duplicating content."
 ];
 function buildCursorSnippet() {
@@ -19192,8 +19274,8 @@ function resolveServerVersion() {
   if (process.env.npm_package_name === "@agent-lint/mcp" && process.env.npm_package_version) {
     return process.env.npm_package_version;
   }
-  if ("0.3.3".length > 0) {
-    return "0.3.3";
+  if ("0.4.0".length > 0) {
+    return "0.4.0";
   }
   try {
     const pkg = JSON.parse(
@@ -19673,4 +19755,4 @@ strip-bom-string/index.js:
    * Released under the MIT License.
    *)
 */
-//# sourceMappingURL=chunk-DYP46E6V.js.map
+//# sourceMappingURL=chunk-PAQI5DE3.js.map