digdesign 0.4.0 → 0.6.0

package/dist/index.js

@@ -4,8 +4,8 @@
 import { Command } from "commander";
 
 // src/commands/add.ts
-import { access as access4, mkdir as mkdir3, writeFile as writeFile4 } from "fs/promises";
-import path6 from "path";
+import { access as access4, mkdir as mkdir3, writeFile as writeFile5 } from "fs/promises";
+import path7 from "path";
 
 // src/lib/config.ts
 import { access, readFile, writeFile } from "fs/promises";
@@ -108,6 +108,16 @@ function parseSelection(raw, options) {
   }
   return [...picked];
 }
+async function select(question, options, defaultValue) {
+  const width = String(options.length).length;
+  for (const [index, option] of options.entries()) {
+    const number = String(index + 1).padStart(width);
+    const mark = option.value === defaultValue ? " (\u067E\u06CC\u0634\u200C\u0641\u0631\u0636)" : "";
+    console.log(`  ${number}) ${option.label}${mark}`);
+  }
+  const raw = await askLine(`${question} `);
+  return parseSelection(raw, options)[0] ?? defaultValue;
+}
 
 // src/lib/hash.ts
 import { createHash } from "crypto";
@@ -403,6 +413,91 @@ function resolveTargetPath(filePath, aliases, options = {}) {
   return `${aliases.components}/${cleaned}`;
 }
 
+// src/commands/design-md.ts
+import { readFile as readFile4, writeFile as writeFile4 } from "fs/promises";
+import path6 from "path";
+var DESIGN_MD_FILE = "DESIGN.md";
+var GENERATED_MARK = "Generated by Dig";
+async function fetchDesignMd(registryUrl, options) {
+  const url = new URL("/api/design-md", registryUrl);
+  for (const key2 of ["brand", "secondary", "name", "font", "radius"]) {
+    const value = options[key2];
+    if (value) url.searchParams.set(key2, value);
+  }
+  let response;
+  try {
+    response = await fetch(url);
+  } catch {
+    throw new DigError(`\u0627\u062A\u0635\u0627\u0644 \u0628\u0647 ${url.origin} \u0628\u0631\u0627\u06CC \u0633\u0627\u062E\u062A\u0646\u0650 DESIGN.md \u0628\u0631\u0642\u0631\u0627\u0631 \u0646\u0634\u062F.`);
+  }
+  if (!response.ok) {
+    const body = await response.json().catch(() => null);
+    throw new DigError(`DESIGN.md \u0633\u0627\u062E\u062A\u0647 \u0646\u0634\u062F: ${body?.error ?? response.status}`);
+  }
+  return response.text();
+}
+async function readIfExists(target) {
+  try {
+    return await readFile4(target, "utf8");
+  } catch {
+    return null;
+  }
+}
+async function writeDesignMd(cwd, registryUrl, options) {
+  const target = path6.join(cwd, DESIGN_MD_FILE);
+  const existing = await readIfExists(target);
+  if (existing !== null && !options.force) {
+    const generated = existing.includes(GENERATED_MARK);
+    if (!generated || !options.replaceGenerated) {
+      console.log(
+        generated ? `- ${DESIGN_MD_FILE} \u0627\u0632 \u0642\u0628\u0644 \u0647\u0633\u062A\u061B \u062F\u0633\u062A \u0646\u062E\u0648\u0631\u062F. \u0628\u0647\u200C\u0631\u0648\u0632\u0631\u0633\u0627\u0646\u06CC: dig design-md` : `- ${DESIGN_MD_FILE} \u062F\u0633\u062A\u200C\u0646\u0648\u0634\u062A\u0647 \u0627\u0633\u062A\u061B \u062F\u0633\u062A \u0646\u062E\u0648\u0631\u062F. \u0628\u0627\u0632\u0646\u0648\u06CC\u0633\u06CC: dig design-md --force`
+      );
+      return "skipped";
+    }
+  }
+  await writeFile4(target, await fetchDesignMd(registryUrl, options), "utf8");
+  console.log(`\u2713 ${DESIGN_MD_FILE} \u0646\u0648\u0634\u062A\u0647 \u0634\u062F (\u062A\u0648\u06A9\u0646\u200C\u0647\u0627 \u0648 \u0642\u0627\u0639\u062F\u0647\u200C\u0647\u0627\u06CC \u062F\u06CC\u06AF \u0628\u0631\u0627\u06CC \u0627\u06CC\u062C\u0646\u062A\u200C\u0647\u0627\u06CC \u06A9\u062F\u0646\u0648\u06CC\u0633).`);
+  return "written";
+}
+function readDesignMdSettings(text) {
+  const match = /<!-- dig:design-md (\{.*?\}) -->/.exec(text);
+  if (!match) return {};
+  try {
+    const parsed = JSON.parse(match[1]);
+    return Object.fromEntries(
+      ["brand", "secondary", "name", "font", "radius"].filter((key2) => typeof parsed[key2] === "string").map((key2) => [key2, parsed[key2]])
+    );
+  } catch {
+    return {};
+  }
+}
+async function refreshDesignMd(cwd, registryUrl, overrides = {}, log = console.log) {
+  const target = path6.join(cwd, DESIGN_MD_FILE);
+  const existing = await readIfExists(target);
+  if (existing === null || !existing.includes(GENERATED_MARK)) return "skipped";
+  try {
+    const next = await fetchDesignMd(registryUrl, { ...readDesignMdSettings(existing), ...overrides });
+    if (next === existing) return "unchanged";
+    await writeFile4(target, next, "utf8");
+    log(`\u2713 ${DESIGN_MD_FILE} \u0647\u0645 \u0628\u0647\u200C\u0631\u0648\u0632 \u0634\u062F.`);
+    return "updated";
+  } catch {
+    log(`- ${DESIGN_MD_FILE} \u0628\u0647\u200C\u0631\u0648\u0632 \u0646\u0634\u062F (\u0627\u062A\u0635\u0627\u0644 \u0628\u0631\u0642\u0631\u0627\u0631 \u0646\u0634\u062F)\u061B \u0628\u0639\u062F\u0627\u064B: dig design-md`);
+    return "failed";
+  }
+}
+async function designMdCommand(options) {
+  const cwd = process.cwd();
+  const config = await configExists(cwd) ? await readConfig(cwd) : defaultConfig();
+  const previous = readDesignMdSettings(await readIfExists(path6.join(cwd, DESIGN_MD_FILE)) ?? "");
+  const explicit = Object.fromEntries(Object.entries(options).filter(([, value]) => value !== void 0 && value !== false));
+  options = { ...previous, ...explicit };
+  const result = await writeDesignMd(cwd, config.registryUrl, { ...options, replaceGenerated: true });
+  if (result === "written" && !options.brand) {
+    console.log('  \u0631\u0646\u06AF \u0628\u0631\u0646\u062F \u062F\u0627\u0631\u06CC\u062F\u061F dig design-md --brand "#2C4C5B" \u062A\u0627 \u0631\u0646\u06AF\u200C\u0647\u0627\u06CC \u0648\u0627\u0642\u0639\u06CC\u0650 \u0628\u0631\u0646\u062F \u062F\u0631 \u0641\u0627\u06CC\u0644 \u0628\u06CC\u0627\u06CC\u062F.');
+  }
+}
+
 // src/commands/add.ts
 async function pathExists(target) {
   try {
@@ -444,12 +539,12 @@ async function addCommand(components, options) {
   console.log(`\u062F\u0631\u06CC\u0627\u0641\u062A \u0627\u0632 ${config.registryUrl} \u2026`);
   const items = await resolveRegistryTree(names, config.registryUrl);
   let overwrite = Boolean(options.overwrite);
-  if (!overwrite) {
+  if (!overwrite && !options.skipExisting) {
     const existing = [];
     for (const item of items.values()) {
       for (const file of item.files) {
-        const target = path6.join(cwd, resolveTargetPath(file.path, config.aliases, targetPathOptions(config)));
-        if (await pathExists(target)) existing.push(path6.relative(cwd, target));
+        const target = path7.join(cwd, resolveTargetPath(file.path, config.aliases, targetPathOptions(config)));
+        if (await pathExists(target)) existing.push(path7.relative(cwd, target));
       }
     }
     if (existing.length) {
@@ -470,11 +565,11 @@ ${existing.length} \u0641\u0627\u06CC\u0644 \u0627\u0632 \u0642\u0628\u0644 \u06
     for (const item of items.values()) {
       for (const dep of item.dependencies ?? []) npmDeps.add(dep);
       for (const file of item.files) {
-        const target = path6.join(cwd, resolveTargetPath(file.path, config.aliases, targetPathOptions(config)));
-        const exists2 = await pathExists(target);
-        const mark = exists2 ? overwrite ? "~" : "-" : "+";
-        const note = exists2 ? overwrite ? " (\u0628\u0627\u0632\u0646\u0648\u06CC\u0633\u06CC)" : " (\u0631\u062F \u0645\u06CC\u200C\u0634\u0648\u062F\u060C \u0648\u062C\u0648\u062F \u062F\u0627\u0631\u062F)" : "";
-        console.log(`${mark} ${path6.relative(cwd, target)}${note}`);
+        const target = path7.join(cwd, resolveTargetPath(file.path, config.aliases, targetPathOptions(config)));
+        const exists3 = await pathExists(target);
+        const mark = exists3 ? overwrite ? "~" : "-" : "+";
+        const note = exists3 ? overwrite ? " (\u0628\u0627\u0632\u0646\u0648\u06CC\u0633\u06CC)" : " (\u0631\u062F \u0645\u06CC\u200C\u0634\u0648\u062F\u060C \u0648\u062C\u0648\u062F \u062F\u0627\u0631\u062F)" : "";
+        console.log(`${mark} ${path7.relative(cwd, target)}${note}`);
       }
     }
     console.log(`
@@ -497,17 +592,17 @@ ${items.size} \u0622\u06CC\u062A\u0645 \u0627\u0632 \u0631\u062C\u06CC\u0633\u06
     const writtenFiles = {};
     const writtenContents = {};
     for (const file of item.files) {
-      const target = path6.join(cwd, resolveTargetPath(file.path, config.aliases, targetPathOptions(config)));
+      const target = path7.join(cwd, resolveTargetPath(file.path, config.aliases, targetPathOptions(config)));
       if (!overwrite && await pathExists(target)) {
-        console.log(`- \u0631\u062F \u0634\u062F (\u0648\u062C\u0648\u062F \u062F\u0627\u0631\u062F): ${path6.relative(cwd, target)}`);
+        if (!options.skipExisting) console.log(`- \u0631\u062F \u0634\u062F (\u0648\u062C\u0648\u062F \u062F\u0627\u0631\u062F): ${path7.relative(cwd, target)}`);
         skipped++;
         continue;
       }
-      await mkdir3(path6.dirname(target), { recursive: true });
-      await writeFile4(target, file.content, "utf8");
-      console.log(`+ ${path6.relative(cwd, target)}`);
+      await mkdir3(path7.dirname(target), { recursive: true });
+      await writeFile5(target, file.content, "utf8");
+      console.log(`+ ${path7.relative(cwd, target)}`);
       written++;
-      const relPath = toPosixPath(path6.relative(cwd, target));
+      const relPath = toPosixPath(path7.relative(cwd, target));
       writtenFiles[relPath] = file.hash ?? hashContent(file.content);
       writtenContents[relPath] = file.content;
     }
@@ -530,10 +625,13 @@ ${items.size} \u0622\u06CC\u062A\u0645 \u0627\u0632 \u0631\u062C\u06CC\u0633\u06
   if (lockChanged) {
     await writeLock(lock, cwd);
     console.log(`
-\u062B\u0628\u062A \u0634\u062F \u062F\u0631 ${path6.join(".dig", "registry-lock.json")}`);
+\u062B\u0628\u062A \u0634\u062F \u062F\u0631 ${path7.join(".dig", "registry-lock.json")}`);
   }
   console.log(`
 ${written} \u0641\u0627\u06CC\u0644 \u0646\u0648\u0634\u062A\u0647 \u0634\u062F\u060C ${skipped} \u0641\u0627\u06CC\u0644 \u0631\u062F \u0634\u062F.`);
+  if (written > 0 && !options.dryRun && !options.skipExisting) {
+    await refreshDesignMd(cwd, config.registryUrl);
+  }
   if (!dependencies.size && !devDependencies.size) return;
   if (options.install === false) {
     console.log("\n\u0628\u0631\u0627\u06CC \u0646\u0635\u0628 \u0648\u0627\u0628\u0633\u062A\u06AF\u06CC\u200C\u0647\u0627 \u062F\u0633\u062A\u06CC \u0627\u062C\u0631\u0627 \u06A9\u0646\u06CC\u062F:");
@@ -654,8 +752,8 @@ async function searchCommand(query, options) {
 }
 
 // src/lib/diff.ts
-import { readFile as readFile4 } from "fs/promises";
-import path7 from "path";
+import { readFile as readFile5 } from "fs/promises";
+import path8 from "path";
 var STATUS_PRIORITY = [
   "conflict",
   "untracked",
@@ -685,7 +783,7 @@ function overallStatus(files) {
 }
 async function readLocalHash(target) {
   try {
-    const content = await readFile4(target, "utf8");
+    const content = await readFile5(target, "utf8");
     return hashContent(content);
   } catch (error) {
     if (error.code === "ENOENT") return void 0;
@@ -693,8 +791,8 @@ async function readLocalHash(target) {
   }
 }
 async function computeFileDrift(cwd, aliases, lockEntry, file, paths) {
-  const target = path7.join(cwd, resolveTargetPath(file.path, aliases, paths));
-  const relPath = toPosixPath(path7.relative(cwd, target));
+  const target = path8.join(cwd, resolveTargetPath(file.path, aliases, paths));
+  const relPath = toPosixPath(path8.relative(cwd, target));
   const registryHash = file.hash ?? hashContent(file.content);
   const installedHash = lockEntry?.files[relPath];
   const localHash = await readLocalHash(target);
@@ -723,8 +821,8 @@ async function computeComponentDrift(params) {
 }
 
 // src/lib/file-diff-details.ts
-import { readFile as readFile5 } from "fs/promises";
-import path8 from "path";
+import { readFile as readFile6 } from "fs/promises";
+import path9 from "path";
 
 // src/lib/text-diff.ts
 var DEFAULT_CONTEXT = 3;
@@ -833,7 +931,7 @@ function looksBinary(buffer) {
 async function readTextFileSafely(target) {
   let buffer;
   try {
-    buffer = await readFile5(target);
+    buffer = await readFile6(target);
   } catch (error) {
     if (error.code === "ENOENT") return void 0;
     throw error;
@@ -873,7 +971,7 @@ async function computeFileDiffDetails(params) {
       note: file.registryHash === file.installedHash ? "\u0641\u0627\u06CC\u0644 \u0628\u0647\u200C\u0635\u0648\u0631\u062A \u0645\u062D\u0644\u06CC \u062D\u0630\u0641 \u0634\u062F\u0647\u061B \u0631\u062C\u06CC\u0633\u062A\u0631\u06CC \u0627\u0632 \u0632\u0645\u0627\u0646 \u0646\u0635\u0628 \u062A\u063A\u06CC\u06CC\u0631\u06CC \u0646\u06A9\u0631\u062F\u0647." : "\u0641\u0627\u06CC\u0644 \u0628\u0647\u200C\u0635\u0648\u0631\u062A \u0645\u062D\u0644\u06CC \u062D\u0630\u0641 \u0634\u062F\u0647 \u0648 \u0631\u062C\u06CC\u0633\u062A\u0631\u06CC \u0647\u0645 \u062A\u063A\u06CC\u06CC\u0631 \u06A9\u0631\u062F\u0647 \u2014 \u0645\u0642\u0627\u06CC\u0633\u0647\u200C\u0627\u06CC \u0628\u0627 \u0641\u0627\u06CC\u0644 \u062D\u0630\u0641\u200C\u0634\u062F\u0647 \u0645\u0645\u06A9\u0646 \u0646\u06CC\u0633\u062A."
     };
   }
-  const target = path8.join(cwd, resolveTargetPath(registryFile.path, aliases, paths));
+  const target = path9.join(cwd, resolveTargetPath(registryFile.path, aliases, paths));
   const localContent = await readTextFileSafely(target);
   if (localContent === "binary") {
     return {
@@ -1430,8 +1528,8 @@ function dependencyRiskLevel(highImpactComponents) {
 }
 
 // src/lib/repo-scanner.ts
-import { readFile as readFile6, readdir } from "fs/promises";
-import path9 from "path";
+import { readFile as readFile7, readdir } from "fs/promises";
+import path10 from "path";
 import ts2 from "typescript";
 
 // src/lib/ast-engine.ts
@@ -1506,11 +1604,11 @@ async function collectSourceFiles(root) {
     for (const entry of entries) {
       if (entry.isDirectory()) {
         if (IGNORED_DIRS.has(entry.name) || entry.name.startsWith(".")) continue;
-        await walk(path9.join(dir, entry.name));
+        await walk(path10.join(dir, entry.name));
         continue;
       }
-      if (entry.isFile() && SCAN_EXTENSIONS.has(path9.extname(entry.name))) {
-        results.push(path9.join(dir, entry.name));
+      if (entry.isFile() && SCAN_EXTENSIONS.has(path10.extname(entry.name))) {
+        results.push(path10.join(dir, entry.name));
       }
     }
   }
@@ -1537,7 +1635,7 @@ async function scanRepositoryForComponent(params) {
   for (const filePath of sourceFilePaths) {
     let content;
     try {
-      content = await readFile6(filePath, "utf8");
+      content = await readFile7(filePath, "utf8");
     } catch {
       continue;
     }
@@ -1551,7 +1649,7 @@ async function scanRepositoryForComponent(params) {
     const snippets = findJsxUsagesInSource(sourceFile, tagName);
     if (snippets.length === 0) continue;
     files.push({
-      path: toPosixPath(path9.relative(projectRoot, filePath)),
+      path: toPosixPath(path10.relative(projectRoot, filePath)),
       usages: snippets.length,
       snippets
     });
@@ -1957,12 +2055,74 @@ async function impactCommand(name, options) {
 }
 
 // src/commands/init.ts
+import { readFile as readFile10, writeFile as writeFile8 } from "fs/promises";
+import path14 from "path";
+
+// src/lib/agent-instructions.ts
 import { readFile as readFile8, writeFile as writeFile6 } from "fs/promises";
-import path12 from "path";
+import path11 from "path";
+var AGENT_CLIENTS = [
+  { value: "claude-code", label: "Claude Code (CLAUDE.md)" },
+  { value: "codex", label: "Codex (AGENTS.md)" },
+  { value: "cursor", label: "Cursor (AGENTS.md)" },
+  { value: "vscode", label: "VS Code (AGENTS.md)" },
+  { value: "gemini", label: "Gemini CLI (GEMINI.md)" }
+];
+var FONTS = [
+  { value: "iransans", label: "IRANSansX" },
+  { value: "yekan", label: "IRANYekan" },
+  { value: "vazirmatn", label: "Vazirmatn" }
+];
+var BLOCK_START = "<!-- dig:start";
+var BLOCK_END = "<!-- dig:end -->";
+async function fetchInstructionsFile(registryUrl, options) {
+  const url = new URL("/api/agent-setup", registryUrl);
+  if (options.agent) url.searchParams.set("client", options.agent);
+  for (const key2 of ["brand", "font", "name"]) {
+    const value = options[key2];
+    if (value) url.searchParams.set(key2, value);
+  }
+  let response;
+  try {
+    response = await fetch(url);
+  } catch {
+    throw new DigError(`\u0627\u062A\u0635\u0627\u0644 \u0628\u0647 ${url.origin} \u0628\u0631\u0627\u06CC \u0633\u0627\u062E\u062A\u0646\u0650 \u0641\u0627\u06CC\u0644\u0650 \u0627\u06CC\u062C\u0646\u062A \u0628\u0631\u0642\u0631\u0627\u0631 \u0646\u0634\u062F.`);
+  }
+  const body = await response.json().catch(() => null);
+  const file = body?.files?.find((item) => /\.md$/.test(item.path) && item.path !== "DESIGN.md");
+  if (!response.ok || !file) {
+    throw new DigError(`\u0641\u0627\u06CC\u0644\u0650 \u0627\u06CC\u062C\u0646\u062A \u0633\u0627\u062E\u062A\u0647 \u0646\u0634\u062F: ${body?.error ?? response.status}`);
+  }
+  return file;
+}
+function mergeInstructions(existing, block) {
+  const trimmed = block.trim();
+  if (existing === null || existing.trim() === "") return `${trimmed}
+`;
+  const start = existing.indexOf(BLOCK_START);
+  const end = existing.indexOf(BLOCK_END);
+  if (start >= 0 && end > start) {
+    return `${existing.slice(0, start)}${trimmed}${existing.slice(end + BLOCK_END.length)}`;
+  }
+  return `${existing.trimEnd()}
+
+${trimmed}
+`;
+}
+async function writeAgentInstructions(cwd, registryUrl, options) {
+  const file = await fetchInstructionsFile(registryUrl, options);
+  const target = path11.join(cwd, file.path);
+  const existing = await readFile8(target, "utf8").catch(() => null);
+  await writeFile6(target, mergeInstructions(existing, file.content), "utf8");
+  console.log(
+    existing === null ? `\u2713 ${file.path} \u0646\u0648\u0634\u062A\u0647 \u0634\u062F (\u0627\u06CC\u062C\u0646\u062A \u0641\u0648\u0646\u062A \u0648 \u0631\u0646\u06AF \u0631\u0627 \u0627\u0632 \u0627\u06CC\u0646 \u0641\u0627\u06CC\u0644 \u0645\u06CC\u200C\u062E\u0648\u0627\u0646\u062F \u0648 \u062F\u0648\u0628\u0627\u0631\u0647 \u0646\u0645\u06CC\u200C\u067E\u0631\u0633\u062F).` : `\u2713 \u0628\u062E\u0634\u0650 \u062F\u06CC\u06AF \u062F\u0631 ${file.path} \u0628\u0647\u200C\u0631\u0648\u0632 \u0634\u062F\u061B \u0628\u0642\u06CC\u0647\u0654 \u0641\u0627\u06CC\u0644 \u062F\u0633\u062A \u0646\u062E\u0648\u0631\u062F.`
+  );
+  return file.path;
+}
 
 // src/commands/theme.ts
-import { access as access5, mkdir as mkdir4, readFile as readFile7, writeFile as writeFile5 } from "fs/promises";
-import path11 from "path";
+import { access as access5, mkdir as mkdir4, readFile as readFile9, writeFile as writeFile7 } from "fs/promises";
+import path13 from "path";
 
 // src/lib/brand-ramp.ts
 var RAMP_STEPS = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950];
@@ -2041,6 +2201,9 @@ function relativeLuminance(rgb) {
 function contrastWithWhite(color) {
   return 1.05 / (relativeLuminance(oklchToSrgb(color)) + 0.05);
 }
+function contrastWithBlack(color) {
+  return (relativeLuminance(oklchToSrgb(color)) + 0.05) / 0.05;
+}
 function formatOklch({ l, c, h }) {
   return `oklch(${l.toFixed(1)}% ${c.toFixed(3)} ${h.toFixed(1)})`;
 }
@@ -2063,9 +2226,9 @@ function buildBrandRamp(hex) {
 }
 
 // src/lib/theme-files.ts
-import path10 from "path";
+import path12 from "path";
 function importPath(fromFile, toFile) {
-  const rel = toPosixPath(path10.relative(path10.dirname(fromFile), toFile));
+  const rel = toPosixPath(path12.relative(path12.dirname(fromFile), toFile));
   return rel.startsWith(".") ? rel : `./${rel}`;
 }
 function globalsCss(paths, extraStatements = []) {
@@ -2096,10 +2259,14 @@ var BRAND_HEADER = `/* =========================================================
 `;
 function brandRampBlock(ramp, hex) {
   const lines = RAMP_STEPS.map((step) => `  --brand-${step}: ${formatOklch(ramp.steps[step])};`);
+  const darkText = contrastWithWhite(ramp.steps[400]) >= contrastWithBlack(ramp.steps[400]) ? "--dig-white" : "--dig-black";
   return `/* dig:brand-ramp-start \u2014 \u0633\u0627\u062E\u062A\u0647\u200C\u0634\u062F\u0647 \u0627\u0632 ${hex.toUpperCase()}\u061B \xABdig theme brand\xBB \u0647\u0645\u06CC\u0646 \u0628\u0644\u0648\u06A9 \u0631\u0627 \u0628\u0627\u0632\u0646\u0648\u06CC\u0633\u06CC \u0645\u06CC\u200C\u06A9\u0646\u062F */
 :root {
 ${lines.join("\n")}
 }
+.dark {
+  --primary-foreground: var(${darkText});
+}
 /* dig:brand-ramp-end */`;
 }
 function brandCss(options) {
@@ -2224,9 +2391,9 @@ function splitTheme(projectCss, digThemeCss) {
 
 // src/commands/theme.ts
 var THEME_ITEM = "theme";
-async function readIfExists(target) {
+async function readIfExists2(target) {
   try {
-    return await readFile7(target, "utf8");
+    return await readFile9(target, "utf8");
   } catch {
     return null;
   }
@@ -2240,7 +2407,7 @@ async function exists(target) {
   }
 }
 function themePaths(config) {
-  const dir = path11.posix.dirname(toPosixPath(config.tailwind.css));
+  const dir = path13.posix.dirname(toPosixPath(config.tailwind.css));
   return {
     css: config.tailwind.css,
     theme: config.tailwind.theme ?? `${dir}/dig-theme.css`,
@@ -2274,9 +2441,9 @@ async function recordTheme(cwd, config, themeRel, item) {
   await writeLock(lock, cwd);
 }
 async function writeText(cwd, rel, content) {
-  const target = path11.join(cwd, rel);
-  await mkdir4(path11.dirname(target), { recursive: true });
-  await writeFile5(target, content, "utf8");
+  const target = path13.join(cwd, rel);
+  await mkdir4(path13.dirname(target), { recursive: true });
+  await writeFile7(target, content, "utf8");
 }
 async function installTheme(cwd, config, options) {
   const paths = themePaths(config);
@@ -2284,7 +2451,7 @@ async function installTheme(cwd, config, options) {
   const ramp = options.brand ? buildBrandRamp(options.brand) : void 0;
   await writeText(cwd, paths.theme, item.content);
   console.log(`\u2713 \u062A\u0645\u0650 \u062F\u06CC\u06AF \u062F\u0631 ${paths.theme} \u0646\u0648\u0634\u062A\u0647 \u0634\u062F (\u0645\u0627\u0644\u0650 \u062F\u06CC\u06AF\u061B \u0628\u0627 \xABdig update theme\xBB \u0628\u0647\u200C\u0631\u0648\u0632 \u0645\u06CC\u200C\u0634\u0648\u062F).`);
-  const existingBrand = await readIfExists(path11.join(cwd, paths.brand));
+  const existingBrand = await readIfExists2(path13.join(cwd, paths.brand));
   if (existingBrand === null) {
     await writeText(cwd, paths.brand, brandCss({ ramp, hex: options.brand }));
     console.log(`\u2713 ${paths.brand} \u0633\u0627\u062E\u062A\u0647 \u0634\u062F (\u0645\u0627\u0644\u0650 \u067E\u0631\u0648\u0698\u0647\u061B \u062F\u06CC\u06AF \u0647\u0631\u06AF\u0632 \u0628\u0627\u0632\u0646\u0648\u06CC\u0633\u06CC\u200C\u0627\u0634 \u0646\u0645\u06CC\u200C\u06A9\u0646\u062F).`);
@@ -2295,10 +2462,10 @@ async function installTheme(cwd, config, options) {
     console.log(`- ${paths.brand} \u0627\u0632 \u0642\u0628\u0644 \u0647\u0633\u062A\u061B \u062F\u0633\u062A \u0646\u062E\u0648\u0631\u062F.`);
   }
   if (ramp) reportContrast(ramp.primaryContrast);
-  const cssTarget = path11.join(cwd, paths.css);
-  const existingCss = await readIfExists(cssTarget);
+  const cssTarget = path13.join(cwd, paths.css);
+  const existingCss = await readIfExists2(cssTarget);
   if (!isBoilerplateCss(existingCss) && existingCss !== null) {
-    await writeFile5(`${cssTarget}.backup`, existingCss, "utf8");
+    await writeFile7(`${cssTarget}.backup`, existingCss, "utf8");
     console.log(`  \u0646\u0633\u062E\u0647\u0654 \u0642\u0628\u0644\u06CC\u0650 ${paths.css} \u062F\u0631 ${paths.css}.backup \u0646\u06AF\u0647 \u062F\u0627\u0634\u062A\u0647 \u0634\u062F.`);
     console.log(`  \u0627\u06AF\u0631 \u0622\u0646 \u0641\u0627\u06CC\u0644 \u062A\u0645\u0650 \u0642\u062F\u06CC\u0645\u06CC\u0650 \u062F\u06CC\u06AF \u0628\u0648\u062F\u060C \u0628\u0647\u200C\u062C\u0627\u06CC init \u0627\u0632 \xABdig theme split\xBB \u0627\u0633\u062A\u0641\u0627\u062F\u0647 \u06A9\u0646\u06CC\u062F.`);
   }
@@ -2331,11 +2498,11 @@ async function themeSplitCommand(options) {
     return;
   }
   const paths = themePaths(config);
-  const current = await readIfExists(path11.join(cwd, paths.css));
+  const current = await readIfExists2(path13.join(cwd, paths.css));
   if (current === null || isBoilerplateCss(current)) {
     throw new DigError(`${paths.css} \u062A\u0645\u06CC \u0646\u062F\u0627\u0631\u062F\u061B \u0628\u0631\u0627\u06CC \u0646\u0635\u0628\u0650 \u062A\u0627\u0632\u0647 \xABdig init\xBB \u0631\u0627 \u0627\u062C\u0631\u0627 \u06A9\u0646\u06CC\u062F.`);
   }
-  if (await exists(path11.join(cwd, paths.brand))) {
+  if (await exists(path13.join(cwd, paths.brand))) {
     throw new DigError(`${paths.brand} \u0627\u0632 \u0642\u0628\u0644 \u0648\u062C\u0648\u062F \u062F\u0627\u0631\u062F\u061B \u0628\u0631\u0627\u06CC \u062C\u0644\u0648\u06AF\u06CC\u0631\u06CC \u0627\u0632 \u0628\u0627\u0632\u0646\u0648\u06CC\u0633\u06CC\u060C \u0627\u0648\u0644 \u062C\u0627\u0628\u0647\u200C\u062C\u0627\u06CC\u0634 \u06A9\u0646\u06CC\u062F.`);
   }
   console.log(`\u062F\u0631\u06CC\u0627\u0641\u062A\u0650 \u062A\u0645\u0650 \u062F\u06CC\u06AF \u0627\u0632 ${config.registryUrl} \u2026`);
@@ -2354,7 +2521,7 @@ ${split.changed} \u062A\u0648\u06A9\u0646\u0650 \u0639\u0648\u0636\u200C\u0634\u
     console.log(split.body || "(\u062E\u0627\u0644\u06CC: \u067E\u0631\u0648\u0698\u0647 \u0686\u06CC\u0632\u06CC \u062F\u0631 \u062A\u0645 \u0639\u0648\u0636 \u0646\u06A9\u0631\u062F\u0647)");
     return;
   }
-  await writeFile5(path11.join(cwd, `${paths.css}.backup`), current, "utf8");
+  await writeFile7(path13.join(cwd, `${paths.css}.backup`), current, "utf8");
   await writeText(cwd, paths.theme, item.content);
   await writeText(cwd, paths.brand, brandCss({ body: split.body }));
   await writeText(cwd, paths.css, globalsCss(paths, split.extraStatements));
@@ -2378,11 +2545,12 @@ async function themeBrandCommand(hex) {
   }
   const paths = themePaths(config);
   const ramp = buildBrandRamp(hex);
-  const existing = await readIfExists(path11.join(cwd, paths.brand)) ?? brandCss({});
+  const existing = await readIfExists2(path13.join(cwd, paths.brand)) ?? brandCss({});
   const next = replaceBrandRamp(existing, ramp, hex);
   await writeText(cwd, paths.brand, next);
   console.log(`\u2713 \u0631\u0645\u067E\u0650 \u0628\u0631\u0646\u062F \u062F\u0631 ${paths.brand} \u0627\u0632 ${hex} \u0633\u0627\u062E\u062A\u0647 \u0634\u062F (Shade \u06F6\u06F0\u06F0 = \u0631\u0646\u06AF\u0650 \u062F\u0627\u062F\u0647\u200C\u0634\u062F\u0647).`);
   reportContrast(ramp.primaryContrast);
+  await refreshDesignMd(cwd, config.registryUrl, { brand: hex });
   const outside = next.replace(/\/\* dig:brand-ramp-start[\s\S]*?\/\* dig:brand-ramp-end \*\//, "");
   const shadowing = outside.match(/--brand-\d+\s*:/g);
   if (shadowing) {
@@ -2393,16 +2561,16 @@ async function themeBrandCommand(hex) {
 }
 
 // src/commands/init.ts
-async function readIfExists2(target) {
+async function readIfExists3(target) {
   try {
-    return await readFile8(target, "utf8");
+    return await readFile10(target, "utf8");
   } catch {
     return null;
   }
 }
 async function writeTheme(config, cwd, options) {
   const paths = themePaths(config);
-  const existing = await readIfExists2(path12.join(cwd, paths.css));
+  const existing = await readIfExists3(path14.join(cwd, paths.css));
   if (!isBoilerplateCss(existing) && !options.yes) {
     console.log(`
 ${paths.css} \u0627\u0632 \u0642\u0628\u0644 \u0645\u062D\u062A\u0648\u0627 \u062F\u0627\u0631\u062F.`);
@@ -2427,8 +2595,8 @@ ${paths.css} \u0627\u0632 \u0642\u0628\u0644 \u0645\u062D\u062A\u0648\u0627 \u06
 }
 async function applyRtl(cwd) {
   for (const candidate of ["src/app/layout.tsx", "app/layout.tsx"]) {
-    const target = path12.join(cwd, candidate);
-    const source = await readIfExists2(target);
+    const target = path14.join(cwd, candidate);
+    const source = await readIfExists3(target);
     if (source === null) continue;
     if (/<html[^>]*\sdir=/.test(source)) {
       console.log(`- ${candidate} \u0627\u0632 \u0642\u0628\u0644 dir \u062F\u0627\u0631\u062F\u061B \u062F\u0633\u062A \u0646\u062E\u0648\u0631\u062F.`);
@@ -2440,7 +2608,7 @@ async function applyRtl(cwd) {
       match[0],
       `<html${match[1]} dir="rtl">`.replace(/\s+dir="rtl">$/, ' dir="rtl">')
     );
-    await writeFile6(target, updated, "utf8");
+    await writeFile8(target, updated, "utf8");
     console.log(`\u2713 dir="rtl" \u0628\u0647 ${candidate} \u0627\u0636\u0627\u0641\u0647 \u0634\u062F.`);
     return;
   }
@@ -2448,6 +2616,15 @@ async function applyRtl(cwd) {
     '- \u0686\u06CC\u062F\u0645\u0627\u0646\u0650 \u0631\u06CC\u0634\u0647 \u067E\u06CC\u062F\u0627 \u0646\u0634\u062F. \u062E\u0648\u062F\u062A\u0627\u0646 dir="rtl" \u0631\u0627 \u0631\u0648\u06CC \u062A\u06AF <html> \u0628\u06AF\u0630\u0627\u0631\u06CC\u062F.'
   );
 }
+async function askProjectDecisions(options) {
+  if (options.yes) return { brand: options.brand, font: options.font, agent: options.agent };
+  const brand = options.brand ?? ((await ask("\u0631\u0646\u06AF \u0628\u0631\u0646\u062F (\u06A9\u062F \u0647\u06AF\u0632\u061B Enter \u06CC\u0639\u0646\u06CC \u0631\u0646\u06AF \u067E\u06CC\u0634\u200C\u0641\u0631\u0636 \u062F\u06CC\u06AF)\u061F", "")).trim() || void 0);
+  console.log("\n\u0641\u0648\u0646\u062A \u0641\u0627\u0631\u0633\u06CC:");
+  const font = options.font ?? await select("\u0634\u0645\u0627\u0631\u0647\u0654 \u0641\u0648\u0646\u062A\u061F", FONTS, "iransans");
+  console.log("\n\u0628\u0627 \u06A9\u062F\u0627\u0645 \u0627\u06CC\u062C\u0646\u062A \u06A9\u062F \u0645\u06CC\u200C\u0646\u0648\u06CC\u0633\u06CC\u062F\u061F");
+  const agent = options.agent ?? await select("\u0634\u0645\u0627\u0631\u0647\u0654 \u0627\u06CC\u062C\u0646\u062A\u061F", AGENT_CLIENTS, "codex");
+  return { brand, font, agent };
+}
 async function initCommand(options) {
   const cwd = process.cwd();
   const base = defaultConfig();
@@ -2463,16 +2640,24 @@ async function initCommand(options) {
     rtl: await confirm("\u067E\u0631\u0648\u0698\u0647 \u0631\u0627\u0633\u062A\u200C\u0628\u0647\u200C\u0686\u067E (RTL) \u0627\u0633\u062A\u061F", base.rtl),
     tailwind: await (async () => {
       const css = await ask("\u0645\u0633\u06CC\u0631 \u0641\u0627\u06CC\u0644 CSS \u0627\u0635\u0644\u06CC \u062A\u06CC\u0644\u0648\u06CC\u0646\u062F\u061F", base.tailwind.css);
-      const dir = path12.posix.dirname(css.split(path12.sep).join("/"));
+      const dir = path14.posix.dirname(css.split(path14.sep).join("/"));
       return { ...base.tailwind, css, theme: `${dir}/dig-theme.css`, brand: `${dir}/brand.css` };
     })()
   };
+  const decisions = await askProjectDecisions(options);
+  options = { ...options, brand: decisions.brand };
   await writeConfig(config, cwd);
-  console.log(`\u2713 ${path12.join(cwd, "dig.json")} \u0646\u0648\u0634\u062A\u0647 \u0634\u062F.`);
+  console.log(`\u2713 ${path14.join(cwd, "dig.json")} \u0646\u0648\u0634\u062A\u0647 \u0634\u062F.`);
   const theme2 = await writeTheme(config, cwd, options);
   if (config.rtl) {
     await applyRtl(cwd);
   }
+  await writeDesignMd(cwd, config.registryUrl, { brand: decisions.brand, font: decisions.font }).catch((error) => {
+    console.log(`- DESIGN.md \u0633\u0627\u062E\u062A\u0647 \u0646\u0634\u062F (${error instanceof Error ? error.message : error}). \u0628\u0639\u062F\u0627\u064B: dig design-md`);
+  });
+  await writeAgentInstructions(cwd, config.registryUrl, decisions).catch((error) => {
+    console.log(`- \u0641\u0627\u06CC\u0644\u0650 \u0627\u06CC\u062C\u0646\u062A \u0633\u0627\u062E\u062A\u0647 \u0646\u0634\u062F (${error instanceof Error ? error.message : error}). \u0628\u0639\u062F\u0627\u064B: dig init`);
+  });
   console.log("\n\u0622\u0645\u0627\u062F\u0647 \u0627\u0633\u062A. \u0642\u062F\u0645 \u0628\u0639\u062F\u06CC:");
   console.log("  dig add button");
   if (theme2 === "written") {
@@ -2486,9 +2671,102 @@ async function initCommand(options) {
   }
 }
 
+// src/commands/mcp.ts
+import { createInterface as createInterface2 } from "readline";
+
+// src/lib/version.ts
+var CLI_VERSION = "0.6.0";
+
+// src/commands/mcp.ts
+var DEFAULT_MCP_URL = "https://docs.digdesign.ir/api/mcp";
+function parseSse(body) {
+  const messages = [];
+  for (const event of body.split(/\r?\n\r?\n/)) {
+    const data = event.split(/\r?\n/).filter((line) => line.startsWith("data:")).map((line) => line.slice(5).replace(/^ /, "")).join("\n");
+    if (!data) continue;
+    try {
+      messages.push(JSON.parse(data));
+    } catch {
+    }
+  }
+  return messages;
+}
+function requestIds(message) {
+  const list = Array.isArray(message) ? message : [message];
+  return list.filter((item) => typeof item === "object" && item !== null).filter((item) => item.method !== void 0 && item.id !== void 0 && item.id !== null).map((item) => item.id);
+}
+function createBridge(url, fetchImpl = fetch) {
+  let sessionId;
+  let protocolVersion;
+  return {
+    async handle(line) {
+      let message;
+      try {
+        message = JSON.parse(line);
+      } catch {
+        return [{ jsonrpc: "2.0", id: null, error: { code: -32700, message: "Parse error" } }];
+      }
+      const ids = requestIds(message);
+      const fail = (reason) => ids.map((id) => ({ jsonrpc: "2.0", id, error: { code: -32603, message: `Dig MCP (${url}): ${reason}` } }));
+      let response;
+      try {
+        response = await fetchImpl(url, {
+          method: "POST",
+          headers: {
+            "content-type": "application/json",
+            accept: "application/json, text/event-stream",
+            "user-agent": `digdesign-cli/${CLI_VERSION}`,
+            ...sessionId && { "mcp-session-id": sessionId },
+            ...protocolVersion && { "mcp-protocol-version": protocolVersion }
+          },
+          body: line
+        });
+      } catch (error) {
+        return fail(`network error: ${error.message}`);
+      }
+      sessionId = response.headers.get("mcp-session-id") ?? sessionId;
+      if (response.status === 202) return [];
+      const body = await response.text();
+      if (!response.ok) return fail(`HTTP ${response.status} ${body.slice(0, 200)}`);
+      let replies;
+      if ((response.headers.get("content-type") ?? "").includes("text/event-stream")) replies = parseSse(body);
+      else {
+        try {
+          replies = body.trim() ? [JSON.parse(body)] : [];
+        } catch {
+          return fail(`invalid JSON response: ${body.slice(0, 200)}`);
+        }
+      }
+      for (const reply of replies.flat()) {
+        const result = reply?.result;
+        if (result?.protocolVersion) protocolVersion = result.protocolVersion;
+      }
+      return replies;
+    }
+  };
+}
+async function mcpCommand(options) {
+  const url = options.url ?? process.env.DIG_MCP_URL ?? DEFAULT_MCP_URL;
+  const bridge = createBridge(url);
+  const pending = /* @__PURE__ */ new Set();
+  process.stderr.write(`dig mcp: stdio bridge to ${url}
+`);
+  const input = createInterface2({ input: process.stdin, crlfDelay: Infinity });
+  for await (const line of input) {
+    if (!line.trim()) continue;
+    const task = bridge.handle(line).then((replies) => {
+      for (const reply of replies) process.stdout.write(`${JSON.stringify(reply)}
+`);
+    });
+    pending.add(task);
+    void task.finally(() => pending.delete(task));
+  }
+  await Promise.all(pending);
+}
+
 // src/lib/migration-apply.ts
-import { readFile as readFile9, writeFile as writeFile7 } from "fs/promises";
-import path13 from "path";
+import { readFile as readFile11, writeFile as writeFile9 } from "fs/promises";
+import path15 from "path";
 
 // src/lib/migration-strategy.ts
 var TextReplaceStrategy = class {
@@ -2565,7 +2843,7 @@ function looksBinary2(buffer) {
 async function readTextFileSafely2(target) {
   let buffer;
   try {
-    buffer = await readFile9(target);
+    buffer = await readFile11(target);
   } catch (error) {
     if (error.code === "ENOENT") return void 0;
     throw error;
@@ -2610,8 +2888,8 @@ async function planOrApplyMigrations(params) {
     };
   }
   const fileTargets = registryItem.files.map((file) => {
-    const target = path13.join(cwd, resolveTargetPath(file.path, aliases, paths));
-    return { relPath: toPosixPath(path13.relative(cwd, target)), target };
+    const target = path15.join(cwd, resolveTargetPath(file.path, aliases, paths));
+    return { relPath: toPosixPath(path15.relative(cwd, target)), target };
   });
   const currentContents = /* @__PURE__ */ new Map();
   for (const ft of fileTargets) {
@@ -2677,12 +2955,12 @@ async function planOrApplyMigrations(params) {
   const written = [];
   try {
     for (const item of pending) {
-      await writeFile7(item.target, item.newContent, "utf8");
+      await writeFile9(item.target, item.newContent, "utf8");
       written.push(item);
     }
   } catch (error) {
     for (const item of written) {
-      await writeFile7(item.target, item.originalContent, "utf8");
+      await writeFile9(item.target, item.originalContent, "utf8");
     }
     return {
       name,
@@ -3293,9 +3571,45 @@ ${entry.migrationHint}`);
   }
 }
 
+// src/lib/missing-dependencies.ts
+import { access as access6 } from "fs/promises";
+import path16 from "path";
+async function exists2(target) {
+  try {
+    await access6(target);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function findMissingDependencies(params) {
+  const { cwd, config, lock, items } = params;
+  const requested = new Set(items.map((item) => item.name));
+  const direct = [
+    ...new Set(items.flatMap((item) => item.registryDependencies ?? []))
+  ].filter((name) => !requested.has(name));
+  if (direct.length === 0) return [];
+  const tree = await resolveRegistryTree(direct, config.registryUrl);
+  const missing = [];
+  for (const item of tree.values()) {
+    if (requested.has(item.name) || lock.components[item.name]) continue;
+    for (const file of item.files) {
+      const target = path16.join(
+        cwd,
+        resolveTargetPath(file.path, config.aliases, targetPathOptions(config))
+      );
+      if (!await exists2(target)) {
+        missing.push(item);
+        break;
+      }
+    }
+  }
+  return missing;
+}
+
 // src/lib/update.ts
-import { mkdir as mkdir5, readFile as readFile10, rm as rm2, writeFile as writeFile8 } from "fs/promises";
-import path14 from "path";
+import { mkdir as mkdir5, readFile as readFile12, rm as rm2, writeFile as writeFile10 } from "fs/promises";
+import path17 from "path";
 function safeFileIndexes(drift) {
   const indexes = [];
   drift.files.forEach((file, index) => {
@@ -3315,7 +3629,7 @@ async function applySafeFiles(cwd, aliases, drift, registryItem, dryRun, paths)
   for (const index of safeIndexes) {
     const file = drift.files[index];
     const registryFile = registryItem.files[index];
-    const target = path14.join(cwd, resolveTargetPath(registryFile.path, aliases, paths));
+    const target = path17.join(cwd, resolveTargetPath(registryFile.path, aliases, paths));
     const isNewFile = file.status === "new_upstream";
     pending.push({
       index,
@@ -3323,14 +3637,14 @@ async function applySafeFiles(cwd, aliases, drift, registryItem, dryRun, paths)
       newContent: registryFile.content,
       newHash: registryFile.hash ?? hashContent(registryFile.content),
       isNewFile,
-      originalContent: isNewFile ? void 0 : await readFile10(target, "utf8")
+      originalContent: isNewFile ? void 0 : await readFile12(target, "utf8")
     });
   }
   const written = [];
   try {
     for (const item of pending) {
-      if (item.isNewFile) await mkdir5(path14.dirname(item.target), { recursive: true });
-      await writeFile8(item.target, item.newContent, "utf8");
+      if (item.isNewFile) await mkdir5(path17.dirname(item.target), { recursive: true });
+      await writeFile10(item.target, item.newContent, "utf8");
       written.push(item);
     }
   } catch (error) {
@@ -3338,7 +3652,7 @@ async function applySafeFiles(cwd, aliases, drift, registryItem, dryRun, paths)
       if (item.isNewFile) {
         await rm2(item.target, { force: true });
       } else {
-        await writeFile8(item.target, item.originalContent, "utf8");
+        await writeFile10(item.target, item.originalContent, "utf8");
       }
     }
     return { actions, writtenHashes: {}, rollbackError: error.message };
@@ -3452,6 +3766,33 @@ async function updateCommand(components, options) {
   if (entries.some((entry) => entry.result.lockUpdated)) {
     await writeLock(lock, cwd);
   }
+  let missing = [];
+  try {
+    missing = (await findMissingDependencies({
+      cwd,
+      config,
+      lock,
+      items: entries.filter((entry) => entry.result.tracked && entry.registryItem).map((entry) => entry.registryItem)
+    })).map((item) => item.name);
+  } catch (error) {
+    console.error(`\u2717 \u0628\u0631\u0631\u0633\u06CC\u0650 \u0648\u0627\u0628\u0633\u062A\u06AF\u06CC\u200C\u0647\u0627\u06CC \u062A\u0627\u0632\u0647: ${error.message}`);
+  }
+  if (missing.length && !dryRun) {
+    if (!options.json) {
+      console.log(`
+\u0648\u0627\u0628\u0633\u062A\u06AF\u06CC\u200C\u0647\u0627\u06CC \u062A\u0627\u0632\u0647\u200C\u0627\u06CC \u06A9\u0647 \u067E\u0631\u0648\u0698\u0647 \u0646\u062F\u0627\u0634\u062A \u0646\u0635\u0628 \u0645\u06CC\u200C\u0634\u0648\u0646\u062F: ${missing.join("\u060C ")}`);
+    }
+    const log = console.log;
+    if (options.json) console.log = console.error;
+    try {
+      await addCommand(missing, { skipExisting: true });
+    } finally {
+      console.log = log;
+    }
+  }
+  if (!dryRun && entries.length) {
+    await refreshDesignMd(cwd, config.registryUrl, {}, options.json ? console.error : console.log);
+  }
   if (options.json) {
     console.log(
       JSON.stringify(
@@ -3466,7 +3807,8 @@ async function updateCommand(components, options) {
               action: result.actions?.[index] ?? "skipped"
             })),
             ...result.snapshotError ? { snapshotError: result.snapshotError } : {}
-          }))
+          })),
+          [dryRun ? "missingDependencies" : "addedDependencies"]: missing
         },
         null,
         2
@@ -3484,6 +3826,10 @@ async function updateCommand(components, options) {
       await printUpdateResult(cwd, config, entry);
     }
   }
+  if (missing.length && dryRun) {
+    console.log(`
+\u0648\u0627\u0628\u0633\u062A\u06AF\u06CC\u200C\u0647\u0627\u06CC \u062A\u0627\u0632\u0647\u200C\u0627\u06CC \u06A9\u0647 \u0646\u0635\u0628 \u0645\u06CC\u200C\u0634\u062F\u0646\u062F: ${missing.join("\u060C ")}`);
+  }
 }
 function printUpdateSummary(entries) {
   console.log("\u062E\u0644\u0627\u0635\u0647\u0654 \u0628\u0631\u0648\u0632\u0631\u0633\u0627\u0646\u06CC");
@@ -3629,18 +3975,17 @@ ${result.name}`);
   }
 }
 
-// src/lib/version.ts
-var CLI_VERSION = "0.4.0";
-
 // src/index.ts
 var program = new Command();
 program.name("dig").description("CLI \u0631\u0633\u0645\u06CC \u062F\u06CC\u0632\u0627\u06CC\u0646 \u0633\u06CC\u0633\u062A\u0645 \u062F\u06CC\u06AF").version(CLI_VERSION);
 program.command("init").description(
-  '\u0631\u0627\u0647\u200C\u0627\u0646\u062F\u0627\u0632\u06CC \u062F\u06CC\u06AF \u062F\u0631 \u067E\u0631\u0648\u0698\u0647: dig.json\u060C \u062A\u0645 \u0648 \u062A\u0648\u06A9\u0646\u200C\u0647\u0627\u060C \u0648 dir="rtl"'
-).option("--yes", "\u067E\u0627\u0633\u062E \u067E\u06CC\u0634\u200C\u0641\u0631\u0636 \u0628\u0647 \u0647\u0645\u0647\u0654 \u0633\u0648\u0627\u0644\u0627\u062A", false).option("--brand <hex>", "\u0633\u0627\u062E\u062A\u0646\u0650 \u0631\u0645\u067E\u0650 \u0628\u0631\u0646\u062F \u0627\u0632 \u06CC\u06A9 \u0631\u0646\u06AF (\u0631\u0648\u06CC Shade \u06F6\u06F0\u06F0 \u0645\u06CC\u200C\u0646\u0634\u06CC\u0646\u062F)\u060C \u0645\u062B\u0644 #2C4C5B").action(initCommand);
+  '\u0631\u0627\u0647\u200C\u0627\u0646\u062F\u0627\u0632\u06CC \u062F\u06CC\u06AF \u062F\u0631 \u067E\u0631\u0648\u0698\u0647: dig.json\u060C \u062A\u0645 \u0648 \u062A\u0648\u06A9\u0646\u200C\u0647\u0627\u060C dir="rtl"\u060C DESIGN.md \u0648 \u0641\u0627\u06CC\u0644\u0650 \u062F\u0633\u062A\u0648\u0631\u0650 \u06A9\u0627\u0631\u06CC\u0650 \u0627\u06CC\u062C\u0646\u062A'
+).option("--yes", "\u067E\u0627\u0633\u062E \u067E\u06CC\u0634\u200C\u0641\u0631\u0636 \u0628\u0647 \u0647\u0645\u0647\u0654 \u0633\u0648\u0627\u0644\u0627\u062A", false).option("--brand <hex>", "\u0633\u0627\u062E\u062A\u0646\u0650 \u0631\u0645\u067E\u0650 \u0628\u0631\u0646\u062F \u0627\u0632 \u06CC\u06A9 \u0631\u0646\u06AF (\u0631\u0648\u06CC Shade \u06F6\u06F0\u06F0 \u0645\u06CC\u200C\u0646\u0634\u06CC\u0646\u062F)\u060C \u0645\u062B\u0644 #2C4C5B").option("--font <font>", "\u0641\u0648\u0646\u062A: iransans\u060C yekan \u06CC\u0627 vazirmatn").option("--agent <agent>", "\u0627\u06CC\u062C\u0646\u062A: claude-code\u060C codex\u060C cursor\u060C vscode \u06CC\u0627 gemini (\u0646\u0627\u0645\u0650 \u0641\u0627\u06CC\u0644\u0650 \u062F\u0633\u062A\u0648\u0631\u0650 \u06A9\u0627\u0631\u06CC \u0631\u0627 \u062A\u0639\u06CC\u06CC\u0646 \u0645\u06CC\u200C\u06A9\u0646\u062F)").action(initCommand);
+program.command("design-md").description("\u0633\u0627\u062E\u062A\u0646\u0650 DESIGN.md \u062F\u0631 \u0631\u06CC\u0634\u0647\u0654 \u067E\u0631\u0648\u0698\u0647: \u062A\u0648\u06A9\u0646\u200C\u0647\u0627 \u0648 \u0642\u0627\u0639\u062F\u0647\u200C\u0647\u0627\u06CC \u062F\u06CC\u06AF \u0628\u0631\u0627\u06CC \u0627\u06CC\u062C\u0646\u062A\u200C\u0647\u0627\u06CC \u06A9\u062F\u0646\u0648\u06CC\u0633").option("--brand <hex>", "\u0631\u0646\u06AF \u0628\u0631\u0646\u062F \u062A\u0627 \u0631\u0646\u06AF\u200C\u0647\u0627\u06CC \u0648\u0627\u0642\u0639\u06CC\u0650 \u0628\u0631\u0646\u062F \u062F\u0631 \u0641\u0627\u06CC\u0644 \u0628\u06CC\u0627\u06CC\u062F\u060C \u0645\u062B\u0644 #2C4C5B").option("--secondary <hex>", "\u0631\u0646\u06AF \u062F\u0648\u0645\u0650 \u0628\u0631\u0646\u062F").option("--name <name>", "\u0646\u0627\u0645 \u0645\u062D\u0635\u0648\u0644").option("--font <font>", "\u0641\u0648\u0646\u062A: iransans\u060C yekan \u06CC\u0627 vazirmatn").option("--radius <radius>", "\u0634\u0639\u0627\u0639: none\u060C sm\u060C md\u060C lg\u060C xl \u06CC\u0627 full").option("--force", "\u0628\u0627\u0632\u0646\u0648\u06CC\u0633\u06CC\u0650 DESIGN.md\u0650 \u062F\u0633\u062A\u200C\u0646\u0648\u0634\u062A\u0647", false).action(designMdCommand);
 var theme = program.command("theme").description("\u062A\u0645 \u0648 \u0628\u0631\u0646\u062F: \u062C\u062F\u0627 \u06A9\u0631\u062F\u0646\u0650 \u062A\u0645\u0650 \u062F\u06CC\u06AF \u0627\u0632 \u0628\u0631\u0646\u062F\u0650 \u067E\u0631\u0648\u0698\u0647");
 theme.command("split").description("\u067E\u0631\u0648\u0698\u0647\u0654 \u0642\u062F\u06CC\u0645\u06CC \u0631\u0627 \u0628\u0647 \u0633\u0627\u062E\u062A\u0627\u0631\u0650 \u062F\u0648\u0641\u0627\u06CC\u0644\u06CC \u0645\u06CC\u200C\u0628\u0631\u062F (dig-theme.css \u0645\u0627\u0644\u0650 \u062F\u06CC\u06AF\u060C brand.css \u0645\u0627\u0644\u0650 \u067E\u0631\u0648\u0698\u0647)").option("--dry-run", "\u0641\u0642\u0637 \u0646\u0634\u0627\u0646 \u0628\u062F\u0647 \u0686\u0647 \u0686\u06CC\u0632\u06CC \u0628\u0647 brand.css \u0645\u06CC\u200C\u0631\u0648\u062F\u060C \u0686\u06CC\u0632\u06CC \u0646\u0646\u0648\u06CC\u0633", false).action(themeSplitCommand);
 theme.command("brand").description("\u0631\u0645\u067E\u0650 \u0628\u0631\u0646\u062F \u0631\u0627 \u062F\u0631 brand.css \u0627\u0632 \u06CC\u06A9 \u0631\u0646\u06AF \u0645\u06CC\u200C\u0633\u0627\u0632\u062F\u061B \u0628\u0642\u06CC\u0647\u0654 \u0641\u0627\u06CC\u0644 \u062F\u0633\u062A \u0646\u0645\u06CC\u200C\u062E\u0648\u0631\u062F").argument("<hex>", "\u0631\u0646\u06AF\u0650 \u0627\u0635\u0644\u06CC\u0650 \u0628\u0631\u0646\u062F\u060C \u0645\u062B\u0644 #2C4C5B").action(themeBrandCommand);
+program.command("mcp").description("\u0633\u0631\u0648\u0631 MCP \u062F\u06CC\u06AF \u0628\u0647 \u0634\u06A9\u0644 \u0633\u0631\u0648\u0631 \u0645\u062D\u0644\u06CC stdio\u060C \u0628\u0631\u0627\u06CC \u06A9\u0644\u0627\u06CC\u0646\u062A\u200C\u0647\u0627\u06CC\u06CC \u06A9\u0647 \u0622\u062F\u0631\u0633 HTTP \u0646\u0645\u06CC\u200C\u06AF\u06CC\u0631\u0646\u062F").option("--url <url>", "\u0622\u062F\u0631\u0633 \u0633\u0631\u0648\u0631 MCP (\u067E\u06CC\u0634\u200C\u0641\u0631\u0636 https://docs.digdesign.ir/api/mcp)").action(mcpCommand);
 program.command("add").description("\u0627\u0641\u0632\u0648\u062F\u0646 \u06CC\u06A9 \u06CC\u0627 \u0686\u0646\u062F \u06A9\u0627\u0645\u067E\u0648\u0646\u0646\u062A \u0627\u0632 \u0631\u062C\u06CC\u0633\u062A\u0631\u06CC \u062F\u06CC\u06AF").argument("[components...]", "\u0646\u0627\u0645 \u06A9\u0627\u0645\u067E\u0648\u0646\u0646\u062A\u200C\u0647\u0627 (\u0645\u062B\u0644 button) \u06CC\u0627 \u0622\u062F\u0631\u0633 \u0631\u062C\u06CC\u0633\u062A\u0631\u06CC\u061B \u0628\u062F\u0648\u0646 \u0622\u0631\u06AF\u0648\u0645\u0627\u0646 \u0641\u0647\u0631\u0633\u062A \u0631\u0627 \u0646\u0634\u0627\u0646 \u0645\u06CC\u200C\u062F\u0647\u062F").option("--overwrite", "\u0628\u0627\u0632\u0646\u0648\u06CC\u0633\u06CC \u0641\u0627\u06CC\u0644\u200C\u0647\u0627\u06CC \u0645\u0648\u062C\u0648\u062F", false).option("-y, --yes", "\u0628\u062F\u0648\u0646 \u067E\u0631\u0633\u0634\u060C \u0641\u0627\u06CC\u0644\u200C\u0647\u0627\u06CC \u0645\u0648\u062C\u0648\u062F \u0631\u0627 \u0628\u0627\u0632\u0646\u0648\u06CC\u0633\u06CC \u06A9\u0646", false).option("--dry-run", "\u0641\u0642\u0637 \u0646\u0634\u0627\u0646 \u0628\u062F\u0647 \u0686\u0647 \u0641\u0627\u06CC\u0644\u200C\u0647\u0627\u06CC\u06CC \u0646\u0648\u0634\u062A\u0647 \u0645\u06CC\u200C\u0634\u0648\u062F\u060C \u0686\u06CC\u0632\u06CC \u0646\u0646\u0648\u06CC\u0633", false).option("--no-install", "\u0641\u0642\u0637 \u0641\u0627\u06CC\u0644\u200C\u0647\u0627 \u0631\u0627 \u0628\u0646\u0648\u06CC\u0633\u060C \u0648\u0627\u0628\u0633\u062A\u06AF\u06CC\u200C\u0647\u0627 \u0631\u0627 \u0646\u0635\u0628 \u0646\u06A9\u0646").action(addCommand);
 program.command("list").description("\u0641\u0647\u0631\u0633\u062A \u0622\u06CC\u062A\u0645\u200C\u0647\u0627\u06CC \u0631\u062C\u06CC\u0633\u062A\u0631\u06CC \u062F\u06CC\u06AF").option("--type <type>", "\u0641\u06CC\u0644\u062A\u0631 \u0646\u0648\u0639: ui\u060C lib \u06CC\u0627 theme").option("--json", "\u062E\u0631\u0648\u062C\u06CC JSON \u0628\u0631\u0627\u06CC \u0627\u0633\u06A9\u0631\u06CC\u067E\u062A/\u0627\u0628\u0632\u0627\u0631", false).action(listCommand);
 program.command("search").description("\u062C\u0633\u062A\u062C\u0648\u06CC \u06A9\u0627\u0645\u067E\u0648\u0646\u0646\u062A \u062F\u0631 \u0631\u062C\u06CC\u0633\u062A\u0631\u06CC\u060C \u0628\u0627 \u0646\u0627\u0645 \u0641\u0627\u0631\u0633\u06CC \u06CC\u0627 \u0627\u0646\u06AF\u0644\u06CC\u0633\u06CC").argument("<query>", "\u0639\u0628\u0627\u0631\u062A \u062C\u0633\u062A\u062C\u0648").option("--json", "\u062E\u0631\u0648\u062C\u06CC JSON \u0628\u0631\u0627\u06CC \u0627\u0633\u06A9\u0631\u06CC\u067E\u062A/\u0627\u0628\u0632\u0627\u0631", false).action(searchCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "digdesign",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "CLI رسمی برای نصب کامپوننت‌های دیزاین سیستم دیگ",
   "type": "module",
   "license": "MIT",