@moda-ai/cli 1.55.31 → 1.55.33

package/README.md

@@ -143,7 +143,9 @@ Flag aliases: `moda context --message-index=N` = `--msg-index=N`, and
 `moda users --limit=N` = `--page-size=N`. Each command rejects a flag it does
 not take, and time windows differ by command: `--days-back=N` (a whole number,
 1-90) on the overview, Problem and detection commands, `--time-range` on
-`traces`, `search` and `clusters`. Boolean flags accept `true`/`false`, `1`/`0`,
+`traces`, `search` and `clusters`. The other window spelling is rewritten when
+it names the same span (`--days-back=7` is `--time-range=7d`, `--time-range=30d`
+is `--days-back=30`); one with no exact match fails. Boolean flags accept `true`/`false`, `1`/`0`,
 `yes`/`no` and `on`/`off`.
 
 Prompt management:

package/dist/{agent-e4k17rzy.js → agent-g07tg64w.js}

@@ -1,8 +1,8 @@
 import {
   buildDoctorReport
-} from "./cli-a03st7e3.js";
+} from "./cli-5fstvkva.js";
 import"./cli-9bgnvth2.js";
-import"./cli-zgj5bakm.js";
+import"./cli-6j8h2ave.js";
 import"./cli-mm48br00.js";
 import {
   readHarnessSyncState

package/dist/{cli-a03st7e3.js → cli-5fstvkva.js}

@@ -4,7 +4,7 @@ import {
 } from "./cli-9bgnvth2.js";
 import {
   inspectPromptManifest
-} from "./cli-zgj5bakm.js";
+} from "./cli-6j8h2ave.js";
 import {
   readHarnessSyncState,
   renderDoctorHuman,

package/dist/{cli-n1d52cww.js → cli-602yx84w.js}

@@ -1,15 +1,15 @@
-import {
-  DEFAULT_POLL_INTERVAL_MS,
-  DEFAULT_WAIT_TIMEOUT_MS,
-  fetchLatestRun
-} from "./cli-yz8xcpyk.js";
 import {
   assertReplayablePrompt,
   discoverPrompts,
   parsePromptFileForAb,
   readPromptLock,
   runPromptSync
-} from "./cli-zgj5bakm.js";
+} from "./cli-6j8h2ave.js";
+import {
+  DEFAULT_POLL_INTERVAL_MS,
+  DEFAULT_WAIT_TIMEOUT_MS,
+  fetchLatestRun
+} from "./cli-yz8xcpyk.js";
 import {
   UUID_RE
 } from "./cli-n2hng3gv.js";

package/dist/{cli-zgj5bakm.js → cli-6j8h2ave.js}

@@ -5725,9 +5725,9 @@ async function runPromptsCommand(input, legacyFlags, legacyProfileOptions) {
       await promotePrompt(positionals, flags, profileOptions, context);
       break;
     case "ab":
-      return (await import("./prompts-ab-qed3ra5e.js")).runPromptAb(flags, profileOptions, context);
+      return (await import("./prompts-ab-t7xptf0c.js")).runPromptAb(flags, profileOptions, context);
     case "propose":
-      await (await import("./prompts-propose-y5r68pcw.js")).runPromptPropose(positionals, flags, profileOptions, context);
+      await (await import("./prompts-propose-8feadk2t.js")).runPromptPropose(positionals, flags, profileOptions, context);
       break;
     case "list":
     case "show":

package/dist/{cli-8dtnwp9r.js → cli-hcwdz9sd.js}

@@ -1,3 +1,9 @@
+// src/init/rules.ts
+import { createHash } from "node:crypto";
+import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname as dirname2, join as join2, sep } from "node:path";
+import { confirm } from "@inquirer/prompts";
+
 // src/package-assets.ts
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -6,10 +12,6 @@ function packageAssetPath(...parts) {
 }
 
 // src/init/rules.ts
-import { createHash } from "node:crypto";
-import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
-import { dirname as dirname2, join as join2, sep } from "node:path";
-import { confirm } from "@inquirer/prompts";
 var SKILLS_SOURCE_DIR = packageAssetPath("skills");
 var SKILLS = [
   {
@@ -89,6 +91,13 @@ function writeInstallRecord(record) {
   writeFileSync(path, `${JSON.stringify(record, null, 2)}
 `);
 }
+function bundledSkillVersion(skillId) {
+  try {
+    return skillVersion(loadSkillSource(skillId).content);
+  } catch {
+    return "unknown";
+  }
+}
 function skillVersion(skillContent) {
   const frontmatter = FRONTMATTER_RE.exec(skillContent)?.[1] ?? "";
   return /^version:\s*(\S+)\s*$/m.exec(frontmatter)?.[1] ?? "unknown";
@@ -357,247 +366,4 @@ async function installRules(detectedAgents, options = {}) {
   return result;
 }
 
-// src/init/mcp.ts
-import { existsSync as existsSync2 } from "node:fs";
-import { join as join3 } from "node:path";
-import { execSync } from "node:child_process";
-function isOnPath(cmd) {
-  try {
-    execSync(`which ${cmd}`, { stdio: "pipe" });
-    return true;
-  } catch {
-    return false;
-  }
-}
-function detectAgents() {
-  const cwd = process.cwd();
-  const agents = [];
-  if (existsSync2(join3(cwd, ".claude")) || isOnPath("claude")) {
-    agents.push("Claude Code");
-  }
-  if (existsSync2(join3(cwd, ".cursor"))) {
-    agents.push("Cursor");
-  }
-  return agents;
-}
-
-// src/skills-manifest.ts
-import {
-  existsSync as existsSync3,
-  mkdirSync as mkdirSync2,
-  readdirSync as readdirSync2,
-  readFileSync as readFileSync2,
-  rmdirSync,
-  unlinkSync as unlinkSync2,
-  writeFileSync as writeFileSync2
-} from "node:fs";
-import { dirname as dirname3, isAbsolute, join as join4, normalize, relative, resolve } from "node:path";
-var SKILLS_MANIFEST_PATH = join4(".moda", "skills.yml");
-var SKILL_SOURCE_HARNESS = "moda";
-var SKILL_SOURCE_INTEGRATION_BUNDLED = "integration-bundled";
-function readSkillsManifest(cwd) {
-  const manifestPath = join4(cwd, SKILLS_MANIFEST_PATH);
-  if (!existsSync3(manifestPath))
-    return null;
-  let text = "";
-  try {
-    text = readFileSync2(manifestPath, "utf8");
-  } catch {
-    return null;
-  }
-  return {
-    tenantId: readYamlScalar(text, "tenant_id"),
-    generationRunId: readYamlScalar(text, "generation_run_id"),
-    generationVersion: Number(readYamlScalar(text, "generation_version") || 0),
-    releaseKey: readYamlScalar(text, "release_key"),
-    statusFilter: readYamlScalar(text, "status_filter"),
-    releasedAt: readYamlScalar(text, "released_at"),
-    managedPaths: readManagedPaths(text),
-    records: readSkillRecords(text)
-  };
-}
-function manifestHeaderFrom(manifest) {
-  return {
-    tenantId: manifest?.tenantId ?? "",
-    releaseKey: manifest?.releaseKey ?? "",
-    statusFilter: manifest?.statusFilter ?? "",
-    generationRunId: manifest?.generationRunId ?? "",
-    generationVersion: manifest?.generationVersion ?? 0,
-    releasedAt: manifest?.releasedAt ?? ""
-  };
-}
-function writeSkillsManifest(cwd, header, records) {
-  const manifestPath = join4(cwd, SKILLS_MANIFEST_PATH);
-  const managedPaths = [...new Set(records.flatMap((record) => record.paths))].sort();
-  const lines = [
-    "version: 1",
-    "source: moda",
-    `tenant_id: ${yamlQuote(header.tenantId)}`,
-    `release_key: ${yamlQuote(header.releaseKey)}`,
-    `status_filter: ${yamlQuote(header.statusFilter)}`,
-    `generation_run_id: ${yamlQuote(header.generationRunId)}`,
-    `generation_version: ${header.generationVersion}`,
-    `released_at: ${yamlQuote(header.releasedAt)}`,
-    `installed_at: ${yamlQuote(new Date().toISOString())}`,
-    "managed_paths:",
-    ...managedPaths.map((path) => `  - ${yamlQuote(path)}`),
-    "skills:",
-    ...records.flatMap((record) => [
-      `  - skill_id: ${yamlQuote(record.skillId)}`,
-      `    content_hash: ${yamlQuote(record.contentHash)}`,
-      `    source: ${yamlQuote(record.source)}`,
-      "    paths:",
-      ...record.paths.map((path) => `      - ${yamlQuote(path)}`)
-    ]),
-    ""
-  ];
-  mkdirSync2(dirname3(manifestPath), { recursive: true });
-  writeFileSync2(manifestPath, lines.join(`
-`));
-}
-function upsertSkillManifestRecord(cwd, record) {
-  const manifest = readSkillsManifest(cwd);
-  const records = (manifest?.records ?? []).filter((existing) => !(existing.skillId === record.skillId && existing.source === record.source));
-  records.push(record);
-  writeSkillsManifest(cwd, manifestHeaderFrom(manifest), records);
-}
-function pruneManagedSkillPaths(cwd, managedPaths, log) {
-  let pruned = 0;
-  for (const rawPath of [...new Set(managedPaths)]) {
-    const safePath = safeManagedRelativePath(rawPath);
-    if (!safePath)
-      continue;
-    const absolutePath = absoluteManagedPath(cwd, safePath);
-    if (!absolutePath || !existsSync3(absolutePath))
-      continue;
-    try {
-      unlinkSync2(absolutePath);
-      pruned++;
-      log(`  pruned ${safePath}`);
-      pruneEmptyClaudeSkillDir(cwd, safePath);
-    } catch {}
-  }
-  return pruned;
-}
-function pruneEmptyClaudeSkillDir(cwd, relativePath) {
-  if (!relativePath.startsWith(".claude/skills/") || !relativePath.endsWith("/SKILL.md"))
-    return;
-  const dir = dirname3(join4(cwd, relativePath));
-  try {
-    if (existsSync3(dir) && readdirSync2(dir).length === 0) {
-      rmdirSync(dir);
-    }
-  } catch {}
-}
-function absoluteManagedPath(cwd, relativePath) {
-  const abs = resolve(cwd, relativePath);
-  const root = resolve(cwd);
-  const rel = relative(root, abs);
-  if (rel.startsWith("..") || isAbsolute(rel))
-    return null;
-  return abs;
-}
-function safeManagedRelativePath(rawPath) {
-  if (!rawPath || rawPath.includes("\x00") || isAbsolute(rawPath))
-    return null;
-  const normalized = normalize(rawPath).replace(/\\/g, "/");
-  if (normalized.startsWith("../") || normalized === ".." || normalized.includes("/../"))
-    return null;
-  const isClaudeSkill = normalized.startsWith(".claude/skills/") && normalized.endsWith("/SKILL.md");
-  const isCursorRule = normalized.startsWith(".cursor/rules/") && normalized.endsWith(".mdc");
-  return isClaudeSkill || isCursorRule ? normalized : null;
-}
-function readYamlScalar(text, key) {
-  const match = text.match(new RegExp(`^${key}:\\s*(.*?)\\s*$`, "m"));
-  return match ? parseYamlScalar(match[1]) : "";
-}
-function readSkillRecords(text) {
-  const records = [];
-  let inSkills = false;
-  let current = null;
-  let inPaths = false;
-  for (const line of text.split(/\r?\n/)) {
-    if (line.trim() === "skills:") {
-      inSkills = true;
-      continue;
-    }
-    if (!inSkills)
-      continue;
-    if (line.length > 0 && !line.startsWith(" "))
-      break;
-    const skillIdMatch = line.match(/^ {2}- skill_id:\s*(.*?)\s*$/);
-    if (skillIdMatch) {
-      if (current)
-        records.push(current);
-      current = {
-        skillId: parseYamlScalar(skillIdMatch[1]),
-        contentHash: "",
-        source: SKILL_SOURCE_HARNESS,
-        paths: []
-      };
-      inPaths = false;
-      continue;
-    }
-    if (!current)
-      continue;
-    const hashMatch = line.match(/^ {4}content_hash:\s*(.*?)\s*$/);
-    if (hashMatch) {
-      current.contentHash = parseYamlScalar(hashMatch[1]);
-      continue;
-    }
-    const sourceMatch = line.match(/^ {4}source:\s*(.*?)\s*$/);
-    if (sourceMatch) {
-      current.source = parseYamlScalar(sourceMatch[1]) || SKILL_SOURCE_HARNESS;
-      continue;
-    }
-    if (/^ {4}paths:\s*$/.test(line)) {
-      inPaths = true;
-      continue;
-    }
-    const pathMatch = inPaths ? line.match(/^ {6}-\s*(.*?)\s*$/) : null;
-    if (pathMatch) {
-      const value = parseYamlScalar(pathMatch[1]);
-      if (value)
-        current.paths.push(value);
-    }
-  }
-  if (current)
-    records.push(current);
-  return records;
-}
-function readManagedPaths(text) {
-  const paths = [];
-  let inManagedPaths = false;
-  for (const line of text.split(/\r?\n/)) {
-    if (line.trim() === "managed_paths:") {
-      inManagedPaths = true;
-      continue;
-    }
-    if (inManagedPaths && line.length > 0 && !line.startsWith(" "))
-      break;
-    if (!inManagedPaths)
-      continue;
-    const match = line.match(/^\s*-\s*(.*?)\s*$/);
-    if (match)
-      paths.push(parseYamlScalar(match[1]));
-  }
-  return paths.filter(Boolean);
-}
-function parseYamlScalar(raw) {
-  const value = raw.trim();
-  if (!value)
-    return "";
-  if (value.startsWith('"')) {
-    try {
-      return String(JSON.parse(value));
-    } catch {
-      return value.replace(/^"|"$/g, "");
-    }
-  }
-  return value.replace(/^'|'$/g, "");
-}
-function yamlQuote(value) {
-  return JSON.stringify(value);
-}
-
-export { packageAssetPath, claudeSkillToCursorRule, summarizeInstall, installRules, detectAgents, SKILL_SOURCE_HARNESS, SKILL_SOURCE_INTEGRATION_BUNDLED, readSkillsManifest, writeSkillsManifest, upsertSkillManifestRecord, pruneManagedSkillPaths };
+export { packageAssetPath, claudeSkillToCursorRule, bundledSkillVersion, summarizeInstall, installRules };

package/dist/{cli-mg5zv4s6.js → cli-k007ztbs.js}

@@ -1,12 +1,16 @@
 import {
   SKILL_SOURCE_HARNESS,
   SKILL_SOURCE_INTEGRATION_BUNDLED,
-  claudeSkillToCursorRule,
-  detectAgents,
   pruneManagedSkillPaths,
   readSkillsManifest,
   writeSkillsManifest
-} from "./cli-8dtnwp9r.js";
+} from "./cli-qm5b1vck.js";
+import {
+  detectAgents
+} from "./cli-rjav0vj1.js";
+import {
+  claudeSkillToCursorRule
+} from "./cli-hcwdz9sd.js";
 import {
   createCommandContext
 } from "./cli-dr6x0zv7.js";
@@ -901,19 +905,43 @@ function manifestHeaderFor(fetched) {
 function sha256(input) {
   return createHash("sha256").update(input).digest("hex");
 }
+var MODA_CLI_SKILL_ID = "moda-cli";
+async function installModaCliSkill(context) {
+  const { detectAgents: detectAgents2 } = await import("./mcp-1qre9f0n.js");
+  const { installRules, summarizeInstall } = await import("./rules-qddx5t0j.js");
+  const result = await installRules(detectAgents2(), { yes: true, silent: true });
+  if (result.status === "skipped") {
+    throw new CliInputError("No supported coding agent was detected here, so the moda-cli skill was not installed.", "Run this from a project with a .claude or .cursor directory, or with Claude Code on PATH. Only Claude Code and Cursor are supported.");
+  }
+  const summary = summarizeInstall(result);
+  if (context.outputMode !== "human") {
+    context.output.writeData({ skill: MODA_CLI_SKILL_ID, status: result.status, agents: result.agents, counts: result.counts, summary, outcomes: result.outcomes, notes: result.notes }, { ...result.status === "failed" ? { status: "error" } : {}, warnings: result.warnings });
+  } else {
+    console.log(`moda-cli skill for ${result.agents.join(", ")}: ${summary}`);
+    for (const note of result.notes)
+      console.log(`  ${note}`);
+    for (const warning of result.warnings)
+      console.error(`  ${warning}`);
+  }
+  return result.status === "failed" ? 1 : 0;
+}
 async function runSkillsInstall(context, ids) {
-  const { installIntegrationSkill, readBundledIndex, readBundledSkillMd } = await import("./skills-bundled-dq20spzk.js");
+  const { installIntegrationSkill, readBundledIndex, readBundledSkillMd } = await import("./skills-bundled-7jes6hqx.js");
   const index = readBundledIndex();
   if (context.flags.list === "true" || ids.length === 0) {
+    const { bundledSkillVersion } = await import("./rules-qddx5t0j.js");
     if (!index) {
       throw new CliInputError("This CLI build has no bundled integration guides", "Install a published @moda-ai/cli, or run `bun run bundle:skills` in apps/moda-cli.");
     }
-    const skills = index.skills.map((skill) => ({
-      id: skill.id,
-      version: skill.version,
-      language: skill.targets.language,
-      summary: skill.summary
-    }));
+    const skills = [
+      { id: MODA_CLI_SKILL_ID, version: bundledSkillVersion(MODA_CLI_SKILL_ID), language: "any", summary: "This CLI's own guide for coding agents; installs or refreshes it for each detected agent (copies edited locally are kept)." },
+      ...index.skills.map((skill) => ({
+        id: skill.id,
+        version: skill.version,
+        language: skill.targets.language,
+        summary: skill.summary
+      }))
+    ];
     if (context.outputMode !== "human") {
       context.output.writeData({ skills });
     } else {
@@ -925,6 +953,13 @@ async function runSkillsInstall(context, ids) {
     }
     return 0;
   }
+  if (ids.includes(MODA_CLI_SKILL_ID)) {
+    const others = ids.filter((id) => id !== MODA_CLI_SKILL_ID);
+    if (others.length > 0) {
+      throw new CliInputError(`Install ${MODA_CLI_SKILL_ID} on its own, so nothing was written.`, `Run \`moda skills install ${MODA_CLI_SKILL_ID}\`, then \`moda skills install ${others.join(" ")}\`.`);
+    }
+    return installModaCliSkill(context);
+  }
   const unknown = ids.filter((id) => !/^[a-z0-9-]+$/.test(id) || readBundledSkillMd(id) === null);
   if (unknown.length > 0) {
     throw new CliInputError(`Not bundled with this CLI: ${unknown.map((id) => JSON.stringify(id).slice(0, 80)).join(", ")}`, "List the bundled guides with: moda skills install --list");

package/dist/{cli-frhm2wz7.js → cli-mc3z77bv.js}

@@ -1,11 +1,15 @@
 import {
   SKILL_SOURCE_INTEGRATION_BUNDLED,
-  claudeSkillToCursorRule,
-  detectAgents,
-  packageAssetPath,
   readSkillsManifest,
   upsertSkillManifestRecord
-} from "./cli-8dtnwp9r.js";
+} from "./cli-qm5b1vck.js";
+import {
+  detectAgents
+} from "./cli-rjav0vj1.js";
+import {
+  claudeSkillToCursorRule,
+  packageAssetPath
+} from "./cli-hcwdz9sd.js";
 
 // src/skills-bundled.ts
 import { createHash } from "node:crypto";

package/dist/cli-qm5b1vck.js

@@ -0,0 +1,220 @@
+// src/skills-manifest.ts
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  rmdirSync,
+  unlinkSync,
+  writeFileSync
+} from "node:fs";
+import { dirname, isAbsolute, join, normalize, relative, resolve } from "node:path";
+var SKILLS_MANIFEST_PATH = join(".moda", "skills.yml");
+var SKILL_SOURCE_HARNESS = "moda";
+var SKILL_SOURCE_INTEGRATION_BUNDLED = "integration-bundled";
+function readSkillsManifest(cwd) {
+  const manifestPath = join(cwd, SKILLS_MANIFEST_PATH);
+  if (!existsSync(manifestPath))
+    return null;
+  let text = "";
+  try {
+    text = readFileSync(manifestPath, "utf8");
+  } catch {
+    return null;
+  }
+  return {
+    tenantId: readYamlScalar(text, "tenant_id"),
+    generationRunId: readYamlScalar(text, "generation_run_id"),
+    generationVersion: Number(readYamlScalar(text, "generation_version") || 0),
+    releaseKey: readYamlScalar(text, "release_key"),
+    statusFilter: readYamlScalar(text, "status_filter"),
+    releasedAt: readYamlScalar(text, "released_at"),
+    managedPaths: readManagedPaths(text),
+    records: readSkillRecords(text)
+  };
+}
+function manifestHeaderFrom(manifest) {
+  return {
+    tenantId: manifest?.tenantId ?? "",
+    releaseKey: manifest?.releaseKey ?? "",
+    statusFilter: manifest?.statusFilter ?? "",
+    generationRunId: manifest?.generationRunId ?? "",
+    generationVersion: manifest?.generationVersion ?? 0,
+    releasedAt: manifest?.releasedAt ?? ""
+  };
+}
+function writeSkillsManifest(cwd, header, records) {
+  const manifestPath = join(cwd, SKILLS_MANIFEST_PATH);
+  const managedPaths = [...new Set(records.flatMap((record) => record.paths))].sort();
+  const lines = [
+    "version: 1",
+    "source: moda",
+    `tenant_id: ${yamlQuote(header.tenantId)}`,
+    `release_key: ${yamlQuote(header.releaseKey)}`,
+    `status_filter: ${yamlQuote(header.statusFilter)}`,
+    `generation_run_id: ${yamlQuote(header.generationRunId)}`,
+    `generation_version: ${header.generationVersion}`,
+    `released_at: ${yamlQuote(header.releasedAt)}`,
+    `installed_at: ${yamlQuote(new Date().toISOString())}`,
+    "managed_paths:",
+    ...managedPaths.map((path) => `  - ${yamlQuote(path)}`),
+    "skills:",
+    ...records.flatMap((record) => [
+      `  - skill_id: ${yamlQuote(record.skillId)}`,
+      `    content_hash: ${yamlQuote(record.contentHash)}`,
+      `    source: ${yamlQuote(record.source)}`,
+      "    paths:",
+      ...record.paths.map((path) => `      - ${yamlQuote(path)}`)
+    ]),
+    ""
+  ];
+  mkdirSync(dirname(manifestPath), { recursive: true });
+  writeFileSync(manifestPath, lines.join(`
+`));
+}
+function upsertSkillManifestRecord(cwd, record) {
+  const manifest = readSkillsManifest(cwd);
+  const records = (manifest?.records ?? []).filter((existing) => !(existing.skillId === record.skillId && existing.source === record.source));
+  records.push(record);
+  writeSkillsManifest(cwd, manifestHeaderFrom(manifest), records);
+}
+function pruneManagedSkillPaths(cwd, managedPaths, log) {
+  let pruned = 0;
+  for (const rawPath of [...new Set(managedPaths)]) {
+    const safePath = safeManagedRelativePath(rawPath);
+    if (!safePath)
+      continue;
+    const absolutePath = absoluteManagedPath(cwd, safePath);
+    if (!absolutePath || !existsSync(absolutePath))
+      continue;
+    try {
+      unlinkSync(absolutePath);
+      pruned++;
+      log(`  pruned ${safePath}`);
+      pruneEmptyClaudeSkillDir(cwd, safePath);
+    } catch {}
+  }
+  return pruned;
+}
+function pruneEmptyClaudeSkillDir(cwd, relativePath) {
+  if (!relativePath.startsWith(".claude/skills/") || !relativePath.endsWith("/SKILL.md"))
+    return;
+  const dir = dirname(join(cwd, relativePath));
+  try {
+    if (existsSync(dir) && readdirSync(dir).length === 0) {
+      rmdirSync(dir);
+    }
+  } catch {}
+}
+function absoluteManagedPath(cwd, relativePath) {
+  const abs = resolve(cwd, relativePath);
+  const root = resolve(cwd);
+  const rel = relative(root, abs);
+  if (rel.startsWith("..") || isAbsolute(rel))
+    return null;
+  return abs;
+}
+function safeManagedRelativePath(rawPath) {
+  if (!rawPath || rawPath.includes("\x00") || isAbsolute(rawPath))
+    return null;
+  const normalized = normalize(rawPath).replace(/\\/g, "/");
+  if (normalized.startsWith("../") || normalized === ".." || normalized.includes("/../"))
+    return null;
+  const isClaudeSkill = normalized.startsWith(".claude/skills/") && normalized.endsWith("/SKILL.md");
+  const isCursorRule = normalized.startsWith(".cursor/rules/") && normalized.endsWith(".mdc");
+  return isClaudeSkill || isCursorRule ? normalized : null;
+}
+function readYamlScalar(text, key) {
+  const match = text.match(new RegExp(`^${key}:\\s*(.*?)\\s*$`, "m"));
+  return match ? parseYamlScalar(match[1]) : "";
+}
+function readSkillRecords(text) {
+  const records = [];
+  let inSkills = false;
+  let current = null;
+  let inPaths = false;
+  for (const line of text.split(/\r?\n/)) {
+    if (line.trim() === "skills:") {
+      inSkills = true;
+      continue;
+    }
+    if (!inSkills)
+      continue;
+    if (line.length > 0 && !line.startsWith(" "))
+      break;
+    const skillIdMatch = line.match(/^ {2}- skill_id:\s*(.*?)\s*$/);
+    if (skillIdMatch) {
+      if (current)
+        records.push(current);
+      current = {
+        skillId: parseYamlScalar(skillIdMatch[1]),
+        contentHash: "",
+        source: SKILL_SOURCE_HARNESS,
+        paths: []
+      };
+      inPaths = false;
+      continue;
+    }
+    if (!current)
+      continue;
+    const hashMatch = line.match(/^ {4}content_hash:\s*(.*?)\s*$/);
+    if (hashMatch) {
+      current.contentHash = parseYamlScalar(hashMatch[1]);
+      continue;
+    }
+    const sourceMatch = line.match(/^ {4}source:\s*(.*?)\s*$/);
+    if (sourceMatch) {
+      current.source = parseYamlScalar(sourceMatch[1]) || SKILL_SOURCE_HARNESS;
+      continue;
+    }
+    if (/^ {4}paths:\s*$/.test(line)) {
+      inPaths = true;
+      continue;
+    }
+    const pathMatch = inPaths ? line.match(/^ {6}-\s*(.*?)\s*$/) : null;
+    if (pathMatch) {
+      const value = parseYamlScalar(pathMatch[1]);
+      if (value)
+        current.paths.push(value);
+    }
+  }
+  if (current)
+    records.push(current);
+  return records;
+}
+function readManagedPaths(text) {
+  const paths = [];
+  let inManagedPaths = false;
+  for (const line of text.split(/\r?\n/)) {
+    if (line.trim() === "managed_paths:") {
+      inManagedPaths = true;
+      continue;
+    }
+    if (inManagedPaths && line.length > 0 && !line.startsWith(" "))
+      break;
+    if (!inManagedPaths)
+      continue;
+    const match = line.match(/^\s*-\s*(.*?)\s*$/);
+    if (match)
+      paths.push(parseYamlScalar(match[1]));
+  }
+  return paths.filter(Boolean);
+}
+function parseYamlScalar(raw) {
+  const value = raw.trim();
+  if (!value)
+    return "";
+  if (value.startsWith('"')) {
+    try {
+      return String(JSON.parse(value));
+    } catch {
+      return value.replace(/^"|"$/g, "");
+    }
+  }
+  return value.replace(/^'|'$/g, "");
+}
+function yamlQuote(value) {
+  return JSON.stringify(value);
+}
+
+export { SKILL_SOURCE_HARNESS, SKILL_SOURCE_INTEGRATION_BUNDLED, readSkillsManifest, writeSkillsManifest, upsertSkillManifestRecord, pruneManagedSkillPaths };

package/dist/cli-rjav0vj1.js

@@ -0,0 +1,25 @@
+// src/init/mcp.ts
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+function isOnPath(cmd) {
+  try {
+    execSync(`which ${cmd}`, { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function detectAgents() {
+  const cwd = process.cwd();
+  const agents = [];
+  if (existsSync(join(cwd, ".claude")) || isOnPath("claude")) {
+    agents.push("Claude Code");
+  }
+  if (existsSync(join(cwd, ".cursor"))) {
+    agents.push("Cursor");
+  }
+  return agents;
+}
+
+export { detectAgents };

package/dist/cli.js

@@ -1084,7 +1084,7 @@ function getUpdateNotice(options = {}) {
   return [
     "",
     `Update available: moda-cli ${VERSION} → ${latest}`,
-    "Run `npm install -g @moda-ai/cli@latest` to update."
+    "Run `npm install -g @moda-ai/cli@latest` to update, then `moda skills install moda-cli` to refresh the agent skill."
   ].join(`
 `);
 }
@@ -1911,10 +1911,10 @@ var SKILLS_SUBCOMMAND_HELP = [
   },
   {
     name: "install",
-    description: "Install bundled integration guides into .claude/skills (offline; no API key)",
-    usage: "moda skills install [--list] <id...>",
+    description: "Install bundled integration guides into .claude/skills, or refresh the moda-cli skill (offline; no API key)",
+    usage: "moda skills install [--list] <id...> | moda skills install moda-cli",
     flags: [{ name: "--list", description: "List the bundled guides." }],
-    examples: ["moda skills install --list", "moda skills install integration-node-openai"]
+    examples: ["moda skills install moda-cli", "moda skills install --list", "moda skills install integration-node-openai"]
   }
 ];
 var PROMPTS_REGISTRY_SUBCOMMAND_HELP = [
@@ -2959,10 +2959,10 @@ function leafManifestFields(leaf, commands) {
 import { fileURLToPath } from "url";
 import { realpathSync } from "fs";
 async function runPromptsCommand(...args) {
-  return (await import("./prompts-kswdk3ft.js")).runPromptsCommand(...args);
+  return (await import("./prompts-b8qx3mrv.js")).runPromptsCommand(...args);
 }
 async function runSkillsCommand(...args) {
-  return (await import("./skills-j8865009.js")).runSkillsCommand(...args);
+  return (await import("./skills-96z55tj4.js")).runSkillsCommand(...args);
 }
 async function runFixCommand(...args) {
   return (await import("./fix-w5z02wt4.js")).runFixCommand(...args);
@@ -2974,16 +2974,16 @@ async function runHarnessCommand(...args) {
   return (await import("./harness-6vwehf47.js")).runHarnessCommand(...args);
 }
 async function runSyncCommand(...args) {
-  return (await import("./sync-5e8t28t7.js")).runSyncCommand(...args);
+  return (await import("./sync-drz7req6.js")).runSyncCommand(...args);
 }
 async function runRegistryCommand(...args) {
   return (await import("./registry-ctnn8e26.js")).runRegistryCommand(...args);
 }
 async function runDoctorCommand(...args) {
-  return (await import("./doctor-hnzte896.js")).runDoctorCommand(...args);
+  return (await import("./doctor-tvre7zvk.js")).runDoctorCommand(...args);
 }
 async function runStatusCommand(...args) {
-  return (await import("./doctor-hnzte896.js")).runStatusCommand(...args);
+  return (await import("./doctor-tvre7zvk.js")).runStatusCommand(...args);
 }
 async function runAuthCommand(...args) {
   return (await import("./profile-commands-h8evz9x0.js")).runAuthCommand(...args);
@@ -2995,7 +2995,7 @@ async function runProfilesCommand(...args) {
   return (await import("./profile-commands-h8evz9x0.js")).runProfilesCommand(...args);
 }
 async function runAgentCommand(...args) {
-  return (await import("./agent-e4k17rzy.js")).runAgentCommand(...args);
+  return (await import("./agent-g07tg64w.js")).runAgentCommand(...args);
 }
 async function runProductionCommand(...args) {
   return (await import("./production-intelligence-7wb1djy2.js")).runProductionCommand(...args);
@@ -6143,7 +6143,7 @@ var commandRegistry = createCommandRegistry([
     resetApiRequestCountBeforeRun: true,
     telemetry: "result-and-error",
     handler: async (context) => {
-      const { runInit } = await import("./index-6atgddwt.js");
+      const { runInit } = await import("./index-75vcntpe.js");
       if (context.outputMode === "agent-stream") {
         context.output.writeEvent({
           event: "started",
@@ -7074,6 +7074,7 @@ var commandRegistry = createCommandRegistry([
       "moda skills status",
       "moda skills pull",
       "moda skills push",
+      "moda skills install moda-cli",
       "moda skills install --list",
       "moda skills install integration-node-openai"
     ],
@@ -7352,6 +7353,56 @@ function assertRoutedFlags(route, flags) {
   const args = Object.fromEntries(Object.keys(flags).filter((flag) => !aliases.has(flag.replace(/_/g, "-"))).map((flag) => [flag.replace(/-/g, "_"), true]));
   parseCommandFlags(shape.passthrough(), args, route.label, route.flagAliases ? { flagAliases: route.flagAliases } : {});
 }
+var DAYS_TO_TIME_RANGE = { 1: "24h", 3: "3d", 7: "7d", 30: "30d", 90: "90d" };
+function timeRangeAsDays(value) {
+  if (value === "24h")
+    return 1;
+  const match = /^(\d+)d$/.exec(value.trim());
+  const days = match ? Number(match[1]) : NaN;
+  return Number.isInteger(days) && days >= 1 && days <= 90 ? days : undefined;
+}
+function daysBackAcceptsAll(handler) {
+  return specsOf(handler).some((spec) => {
+    return schemaShape(spec.schema).days_back?.safeParse("all").success === true;
+  });
+}
+function foldWindowFlag(handler, route, ...targets) {
+  const flags = targets[0];
+  const accepted = new Set([
+    ...specsOf(handler).flatMap((spec) => specFlagNames(spec)),
+    ...route?.allowedFlags ?? []
+  ]);
+  const takesDays = accepted.has("days-back");
+  const takesRange = accepted.has("time-range");
+  if (takesDays === takesRange)
+    return;
+  const [from, to] = takesRange ? ["days-back", "time-range"] : ["time-range", "days-back"];
+  const raw = flags[from];
+  if (raw === undefined || raw === "true" || raw.trim() === "")
+    return;
+  const shown = canonicalCommandText(`moda ${route?.leaf.path ?? handler}`);
+  if (flags[to] !== undefined) {
+    throw new CliInputError(`Pass one time window: --${to} or --${from}, not both.`, `'${shown}' takes --${to}. See '${shown} --help'.`, `conflicting_window:${from}`, { field: `--${from}`, suggestedCommands: [`${shown} --help`] });
+  }
+  let value;
+  if (takesRange) {
+    value = /^\d+$/.test(raw.trim()) ? DAYS_TO_TIME_RANGE[Number(raw.trim())] : undefined;
+  } else if (raw.trim() === "all" && daysBackAcceptsAll(handler)) {
+    value = "all";
+  } else {
+    const days = timeRangeAsDays(raw);
+    value = days === undefined ? undefined : String(days);
+  }
+  if (value === undefined) {
+    const allowed = takesRange ? Object.values(DAYS_TO_TIME_RANGE).map((range) => `--time-range=${range}`) : ["--days-back=N (1-90)"];
+    throw new CliInputError(`--${from}=${raw} has no exact --${to} equivalent for '${shown}', so nothing was run.`, takesRange ? `'${shown}' takes --time-range=1h|24h|3d|7d|30d|90d|all; --days-back maps only to 1, 3, 7, 30 or 90 days.` : `'${shown}' takes --days-back=N (1-90); --time-range maps only to 24h or a whole number of days up to 90d.`, `unknown_flag:${from}`, { field: `--${from}`, allowed, suggestedCommands: [`${shown} --help`] });
+  }
+  for (const target of new Set(targets)) {
+    delete target[from];
+    target[to] = value;
+  }
+  return from;
+}
 var EMPTY_VALUE_ALLOWED = {
   context: new Set(["msg-index", "message-index"])
 };
@@ -7416,6 +7467,8 @@ async function dispatchParsedCommandInner(typedParsed, startedAt) {
   canonicalizeFlagKeys(flags, typedParsed.bareFlags);
   const switchError = normalizeBooleanFlags(flags);
   const typedFlags = stripUpdateCheckFlag(stripTelemetryFlag(flags));
+  const reportedFlags = { ...typedFlags };
+  let foldedWindowFlag;
   const telemetryDisabled = isTelemetryDisabled(flags);
   if (telemetryDisabled)
     discardSpoolOnEnvOptOut();
@@ -7506,7 +7559,7 @@ async function dispatchParsedCommandInner(typedParsed, startedAt) {
       apiKey: input.apiKey ?? resolveApiKey({ profile: telemetryProfile }),
       profile: telemetryProfile,
       command: identity2?.command ?? handlerTelemetry,
-      flags: typedFlags,
+      flags: reportedFlags,
       status: input.status,
       ...input.error !== undefined ? { errorType: classifyCliError(input.error), validationReason: cliValidationReason(input.error) } : {},
       exitCode: input.exitCode,
@@ -7514,7 +7567,7 @@ async function dispatchParsedCommandInner(typedParsed, startedAt) {
       apiRequestCount: input.apiRequestCount,
       adoption,
       ...identity2?.legacyAlias ? { legacyAlias: identity2.legacyAlias } : {},
-      acceptedFlags: telemetryAcceptedFlags(definition2, route),
+      acceptedFlags: new Set([...telemetryAcceptedFlags(definition2, route), ...foldedWindowFlag ? [foldedWindowFlag] : []]),
       knownFlags: telemetryKnownFlags()
     });
   };
@@ -7556,6 +7609,7 @@ async function dispatchParsedCommandInner(typedParsed, startedAt) {
   if (switchError)
     return failEarly(switchError, definition, identity);
   try {
+    foldedWindowFlag = foldWindowFlag(route?.handler ?? definition.name, route, typedFlags, commandFlags);
     if (route)
       assertRoutedFlags(route, typedFlags);
     assertFlagValues(definition.name, parsed.positionals, typedFlags, typedParsed.bareFlags, route);

package/dist/{doctor-hnzte896.js → doctor-tvre7zvk.js}

@@ -3,9 +3,9 @@ import {
   promptsDiscoveredCheck,
   runDoctorCommand,
   runStatusCommand
-} from "./cli-a03st7e3.js";
+} from "./cli-5fstvkva.js";
 import"./cli-9bgnvth2.js";
-import"./cli-zgj5bakm.js";
+import"./cli-6j8h2ave.js";
 import"./cli-mm48br00.js";
 import"./cli-xq45etg1.js";
 import"./cli-dr6x0zv7.js";

package/dist/{index-6atgddwt.js → index-75vcntpe.js}

@@ -1,6 +1,6 @@
 import {
   buildDoctorReport
-} from "./cli-a03st7e3.js";
+} from "./cli-5fstvkva.js";
 import {
   selectTenantAndCreateKey
 } from "./cli-9bgk5jeh.js";
@@ -16,20 +16,23 @@ import {
   bundledSkillsDir,
   installIntegrationSkill,
   readBundledIndex
-} from "./cli-frhm2wz7.js";
+} from "./cli-mc3z77bv.js";
 import {
   agentsMdProblem,
   runSkillSync
-} from "./cli-mg5zv4s6.js";
+} from "./cli-k007ztbs.js";
+import"./cli-qm5b1vck.js";
+import {
+  detectAgents
+} from "./cli-rjav0vj1.js";
 import {
-  detectAgents,
   installRules,
   summarizeInstall
-} from "./cli-8dtnwp9r.js";
+} from "./cli-hcwdz9sd.js";
 import {
   initPrompts,
   runPromptSync
-} from "./cli-zgj5bakm.js";
+} from "./cli-6j8h2ave.js";
 import"./cli-mm48br00.js";
 import {
   codingAgentDisplayName,

package/dist/mcp-1qre9f0n.js

@@ -0,0 +1,7 @@
+import {
+  detectAgents
+} from "./cli-rjav0vj1.js";
+import"./cli-0v6na3yp.js";
+export {
+  detectAgents
+};

package/dist/{prompts-ab-qed3ra5e.js → prompts-ab-t7xptf0c.js}

@@ -23,9 +23,9 @@ import {
   runPromptAb,
   selectProblemCases,
   waitLabel
-} from "./cli-n1d52cww.js";
+} from "./cli-602yx84w.js";
+import"./cli-6j8h2ave.js";
 import"./cli-yz8xcpyk.js";
-import"./cli-zgj5bakm.js";
 import"./cli-mm48br00.js";
 import"./cli-dr6x0zv7.js";
 import"./cli-n2hng3gv.js";

package/dist/{prompts-kswdk3ft.js → prompts-b8qx3mrv.js}

@@ -11,7 +11,7 @@ import {
   runPromptSync,
   runPromptsCommand,
   writePromptSyncProgress
-} from "./cli-zgj5bakm.js";
+} from "./cli-6j8h2ave.js";
 import {
   promptSourceHashPayload
 } from "./cli-mm48br00.js";

package/dist/{prompts-propose-y5r68pcw.js → prompts-propose-8feadk2t.js}

@@ -7,9 +7,9 @@ import {
   formatVerdict,
   rerunWithYes,
   resolvePromptArmSpec
-} from "./cli-n1d52cww.js";
+} from "./cli-602yx84w.js";
+import"./cli-6j8h2ave.js";
 import"./cli-yz8xcpyk.js";
-import"./cli-zgj5bakm.js";
 import"./cli-mm48br00.js";
 import"./cli-dr6x0zv7.js";
 import"./cli-n2hng3gv.js";

package/dist/rules-qddx5t0j.js

@@ -0,0 +1,13 @@
+import {
+  bundledSkillVersion,
+  claudeSkillToCursorRule,
+  installRules,
+  summarizeInstall
+} from "./cli-hcwdz9sd.js";
+import"./cli-0v6na3yp.js";
+export {
+  summarizeInstall,
+  installRules,
+  claudeSkillToCursorRule,
+  bundledSkillVersion
+};

package/dist/{skills-j8865009.js → skills-96z55tj4.js}

@@ -3,8 +3,10 @@ import {
   pullSkills,
   runSkillSync,
   runSkillsCommand
-} from "./cli-mg5zv4s6.js";
-import"./cli-8dtnwp9r.js";
+} from "./cli-k007ztbs.js";
+import"./cli-qm5b1vck.js";
+import"./cli-rjav0vj1.js";
+import"./cli-hcwdz9sd.js";
 import"./cli-dr6x0zv7.js";
 import"./cli-n2hng3gv.js";
 import"./cli-e23g9ywa.js";

package/dist/{skills-bundled-dq20spzk.js → skills-bundled-7jes6hqx.js}

@@ -3,8 +3,10 @@ import {
   installIntegrationSkill,
   readBundledIndex,
   readBundledSkillMd
-} from "./cli-frhm2wz7.js";
-import"./cli-8dtnwp9r.js";
+} from "./cli-mc3z77bv.js";
+import"./cli-qm5b1vck.js";
+import"./cli-rjav0vj1.js";
+import"./cli-hcwdz9sd.js";
 import"./cli-0v6na3yp.js";
 export {
   readBundledSkillMd,

package/dist/{sync-5e8t28t7.js → sync-drz7req6.js}

@@ -1,10 +1,12 @@
 import {
   runSkillsCommand
-} from "./cli-mg5zv4s6.js";
-import"./cli-8dtnwp9r.js";
+} from "./cli-k007ztbs.js";
+import"./cli-qm5b1vck.js";
+import"./cli-rjav0vj1.js";
+import"./cli-hcwdz9sd.js";
 import {
   runPromptsCommand
-} from "./cli-zgj5bakm.js";
+} from "./cli-6j8h2ave.js";
 import"./cli-mm48br00.js";
 import {
   runHarnessCommand

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moda-ai/cli",
-  "version": "1.55.31",
+  "version": "1.55.33",
   "description": "CLI for Moda: production monitoring and evals for AI agents.",
   "type": "module",
   "bin": {

package/skills/integration/index.json

@@ -1,7 +1,7 @@
 {
   "schema_version": "moda.skill_index.v1",
-  "bundled_at": "2026-10-17T00:31:13.506Z",
-  "cli_version": "1.55.31",
+  "bundled_at": "2026-10-17T03:41:09.544Z",
+  "cli_version": "1.55.33",
   "skills": [
     {
       "id": "integration-cloudflare-think",

package/skills/moda-cli/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: moda-cli
-version: 3.0.0
+version: 3.0.2
 description: Investigate a production AI agent with the Moda CLI (`moda`) - find where something happened in real traces (traces search, then traces get), check agent health, rank what to fix (investigate, problems), and dig into tool failures, user frustration, and hallucinations. Also prompt registry sync/promote, replays, custom signals, and false-positive marking. Use when the user mentions Moda, production traces or conversations of their agent, agent failures, or asks what to fix.
 ---
 
@@ -24,7 +24,9 @@ in `references/`; read one only when the task needs it.
   interactive wizard that writes to the repo.
 - Not installed: `npx -y -p @moda-ai/cli moda <command>`.
 - If a response carries `meta.update`, the installed CLI is out of date and
-  may not match this guide; tell the user how to update.
+  may not match this guide; tell the user how to update
+  (`npm install -g @moda-ai/cli@latest`, then `moda skills install moda-cli`
+  to refresh this guide).
 - Flags: `moda <noun> <verb> --help` lists every flag the command accepts, with
   types, ranges, and defaults. Each command rejects flags it does not take and
   the error lists the valid ones; read that list instead of guessing.
@@ -74,7 +76,9 @@ Details: `references/output-protocol.md`.
 
 Time windows differ by command: `--days-back=N` (1-90) on overview,
 investigate, problems, and detection commands; `--time-range=1h|24h|3d|7d|30d|90d|all`
-on search, traces, and clusters. `moda <noun> <verb> --help` shows which.
+on search, traces, and clusters. The other spelling works when it names the
+same span (`--days-back=7` is `--time-range=7d`); anything else fails and
+names the closest values. `moda <noun> <verb> --help` shows which.
 
 ## Fixing a Problem
 

package/skills/moda-cli/references/output-protocol.md

@@ -237,8 +237,12 @@ Treat an answer as degraded if **any** of these hold:
 
 #### Time-window flags by command
 
-A command rejects the window flag it doesn't take, and out-of-range values
-fail instead of being clamped.
+A command takes one window flag. The other spelling is rewritten when it names
+the same span: `--days-back=1|3|7|30|90` is `--time-range=24h|3d|7d|30d|90d`,
+and `--time-range=24h` or `Nd` (up to 90d) is `--days-back`. A value with no
+exact match (`--days-back=14` on `traces search`, `--time-range=all` or `1h`
+on a detection command) fails, as does passing both. Out-of-range values fail
+instead of being clamped.
 
 | Flag | Commands | Allowed values | Default |
 | --- | --- | --- | --- |