@design-ai/cli 4.56.0 → 4.57.0

package/cli/commands/index.mjs

@@ -0,0 +1,292 @@
+// `design-ai index` — build, inspect, and verify the local retrieval index.
+// Explicit-only: nothing here runs in the background or on behalf of other commands.
+
+import { DESIGN_AI_HOME } from "../lib/paths.mjs";
+import { dim, header, info, success, warn } from "../lib/log.mjs";
+import {
+  buildEmbeddingIndex,
+  embeddingIndexStatus,
+  loadEmbeddingIndexFile,
+  writeEmbeddingIndex,
+} from "../lib/embedding-index.mjs";
+import { configuredEmbeddingProvider, defaultConfigFile } from "../lib/local-config.mjs";
+import {
+  buildCorpusIndex,
+  buildLearningIndex,
+  defaultIndexDir,
+  retrievalIndexStatus,
+  verifyRetrievalIndexes,
+  writeRetrievalIndexes,
+} from "../lib/retrieval-index.mjs";
+import { defaultLearningFile } from "../lib/learn-shared.mjs";
+import { unknownOptionMessage } from "../lib/suggest.mjs";
+
+const INDEX_OPTIONS = ["-h", "--help", "--build", "--status", "--verify", "--json", "--embeddings", "--provider"];
+
+// A bare --provider command string is split on spaces (documented here and in
+// printHelp): "python3 embed.py --quiet" -> command "python3", args ["embed.py",
+// "--quiet"]. Providers whose command or args need spaces/quoting should be
+// configured via ~/.design-ai/config.json embeddings.provider.args instead — that
+// is the robust path; --provider is the quick one-shot override.
+function parseProviderFlag(value) {
+  const parts = String(value || "").trim().split(/\s+/).filter(Boolean);
+  if (parts.length === 0) return null;
+  return { command: parts[0], args: parts.slice(1) };
+}
+
+export function parseIndexArgs(args) {
+  const out = { action: "status", json: false, help: false, embeddings: false, provider: "" };
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === "-h" || arg === "--help") {
+      out.help = true;
+    } else if (arg === "--json") {
+      out.json = true;
+    } else if (arg === "--build") {
+      out.action = "build";
+    } else if (arg === "--status") {
+      out.action = "status";
+    } else if (arg === "--verify") {
+      out.action = "verify";
+    } else if (arg === "--embeddings") {
+      out.embeddings = true;
+    } else if (arg === "--provider") {
+      out.provider = args[i + 1] || "";
+      i += 1;
+    } else {
+      throw new Error(unknownOptionMessage("index", arg, INDEX_OPTIONS));
+    }
+  }
+  return out;
+}
+
+function printHelp() {
+  console.log("Usage:  design-ai index [--build|--status|--verify] [--json] [--embeddings [--provider \"cmd args\"]]\n");
+  console.log("Manages the local retrieval index (derived, rebuildable cache files).");
+  console.log("Index files stay on this machine and are safe to delete at any time.\n");
+  console.log("Options:");
+  console.log("  --build     Build/refresh the corpus + learning retrieval index (explicit, never background)");
+  console.log("  --status    Report index paths, digests, staleness, and document counts. Default action");
+  console.log("  --verify    Rebuild in memory and compare against the stored index; read-only");
+  console.log("  --json      Emit machine-readable output");
+  console.log("  --embeddings          Also build the opt-in local embedding sidecar (requires a provider)");
+  console.log("  --provider \"cmd args\" Embedding provider command for this invocation (overrides config).");
+  console.log("                        Split on spaces; for commands needing quoting, use the config file's");
+  console.log("                        embeddings.provider.args array instead (~/.design-ai/config.json)");
+  console.log("\nEmbeddings are never built by default: --embeddings requires a provider from --provider or");
+  console.log("~/.design-ai/config.json (embeddings.provider), and both a config AND the --embeddings flag");
+  console.log("are required — config alone never silently enables it.");
+}
+
+function statusLine(label, entry) {
+  if (!entry.present) return `${label}: missing (run design-ai index --build)`;
+  if (entry.error) return `${label}: unreadable — ${entry.error}`;
+  const freshness = entry.fresh ? "fresh" : "stale (run design-ai index --build)";
+  return `${label}: ${freshness} — ${entry.documentCount} documents, generated ${entry.generatedAt}`;
+}
+
+function embeddingsStatusLine(embeddings) {
+  if (!embeddings) return "Embeddings: not built (opt-in; design-ai index --build --embeddings --provider ...)";
+  if (embeddings.error) return `Embeddings: unreadable — ${embeddings.error}`;
+  const freshness = embeddings.fresh ? "fresh" : "stale (run design-ai index --build --embeddings)";
+  const providerLabel = embeddings.provider ? ` (provider: ${embeddings.provider.command})` : "";
+  return `Embeddings: ${freshness} — ${embeddings.documentCount} vectors, generated ${embeddings.generatedAt}${providerLabel}`;
+}
+
+function printStatus(status) {
+  header("design-ai index", "status");
+  info(`Index dir: ${status.indexDir}`);
+  info(statusLine("Corpus index", status.corpus));
+  info(statusLine("Learning index", status.learning));
+  info(embeddingsStatusLine(status.embeddings));
+  if (status.fresh) {
+    success("Index is fresh.");
+  } else {
+    warn(`Index is not fresh. Rebuild with: ${status.buildCommand}`);
+  }
+}
+
+function resolveProvider({ flagProvider, configFile }) {
+  if (flagProvider) return { provider: parseProviderFlag(flagProvider), source: "flag" };
+  const configured = configuredEmbeddingProvider(configFile);
+  if (configured) return { provider: configured, source: "config" };
+  return { provider: null, source: "" };
+}
+
+function embeddingsUnavailableError({ configFile }) {
+  return [
+    "--embeddings requires a provider: pass --provider \"command args\" for this invocation,",
+    `or configure embeddings.provider in ${configFile} (see docs/AI-LEARNING-PHASE2.md, Phase B).`,
+  ].join("\n");
+}
+
+// index --status embeddings section shape (nullable, present only when the sidecar
+// file exists): { file, present, fresh, sourceMatch, generatedAt, documentCount,
+// provider, storedDigest, currentDigest, error }. Positioned after "learning" and
+// before top-level "fresh" in the JSON payload (documented contract).
+function embeddingsStatusSection(context) {
+  const raw = embeddingIndexStatus(context);
+  if (!raw.present) return null;
+  return raw;
+}
+
+export async function runIndex(args) {
+  const parsed = parseIndexArgs(args);
+  if (parsed.help) {
+    printHelp();
+    return;
+  }
+
+  const context = {
+    designAiPath: DESIGN_AI_HOME,
+    indexDir: defaultIndexDir(),
+    learningFile: defaultLearningFile(),
+  };
+  const configFile = defaultConfigFile();
+
+  if (parsed.action === "build") {
+    const corpus = buildCorpusIndex({ designAiPath: context.designAiPath });
+    const learning = buildLearningIndex({ filePath: context.learningFile });
+    const written = writeRetrievalIndexes({ indexDir: context.indexDir, corpus, learning });
+
+    let embeddingsResult = null;
+    if (parsed.embeddings) {
+      const { provider } = resolveProvider({ flagProvider: parsed.provider, configFile });
+      if (!provider) {
+        embeddingsResult = { ok: false, error: embeddingsUnavailableError({ configFile }) };
+      } else {
+        const built = buildEmbeddingIndex({
+          provider,
+          designAiPath: context.designAiPath,
+          learningFile: context.learningFile,
+        });
+        if (built.ok) {
+          const writtenEmbeddings = writeEmbeddingIndex({ indexDir: context.indexDir, payload: built.payload });
+          embeddingsResult = {
+            ok: true,
+            file: writtenEmbeddings.file,
+            documentCount: built.payload.vectors.length,
+            provider: { command: built.payload.provider.command, modelLabel: built.payload.provider.modelLabel, dimensions: built.payload.provider.dimensions },
+          };
+        } else {
+          embeddingsResult = { ok: false, error: built.error };
+        }
+      }
+    }
+
+    if (parsed.json) {
+      const payload = {
+        action: "build",
+        indexDir: context.indexDir,
+        corpus: { file: written.corpusFile, documentCount: corpus.stats.documentCount, digest: corpus.source.corpusDigest },
+        learning: { file: written.learningFile, documentCount: learning.stats.documentCount, digest: learning.source.learningDigest },
+      };
+      if (embeddingsResult) payload.embeddings = embeddingsResult;
+      console.log(JSON.stringify(payload, null, 2));
+      if (embeddingsResult && !embeddingsResult.ok) process.exitCode = 1;
+      return;
+    }
+
+    header("design-ai index", "build");
+    info(`Corpus index: ${written.corpusFile} (${corpus.stats.documentCount} documents)`);
+    info(`Learning index: ${written.learningFile} (${learning.stats.documentCount} entries)`);
+    success("Index built.");
+    if (embeddingsResult) {
+      if (embeddingsResult.ok) {
+        success(`Embedding index built: ${embeddingsResult.file} (${embeddingsResult.documentCount} vectors)`);
+      } else {
+        warn(`Embedding index not built: ${embeddingsResult.error}`);
+        process.exitCode = 1;
+      }
+    }
+    return;
+  }
+
+  if (parsed.action === "verify") {
+    const verify = verifyRetrievalIndexes(context);
+    const embeddings = embeddingsStatusSection(context);
+    let embeddingsCheck = null;
+    if (embeddings) {
+      if (embeddings.error) {
+        embeddingsCheck = { name: "embeddings", file: embeddings.file, matches: false, reason: embeddings.error };
+      } else {
+        const { provider } = resolveProvider({ flagProvider: parsed.provider, configFile });
+        if (!provider) {
+          embeddingsCheck = {
+            name: "embeddings",
+            file: embeddings.file,
+            matches: true,
+            skipped: true,
+            reason: "skipped: provider unavailable (pass --provider or configure ~/.design-ai/config.json to verify embedding content)",
+          };
+        } else {
+          const rebuilt = buildEmbeddingIndex({
+            provider,
+            designAiPath: context.designAiPath,
+            learningFile: context.learningFile,
+          });
+          if (!rebuilt.ok) {
+            embeddingsCheck = {
+              name: "embeddings",
+              file: embeddings.file,
+              matches: true,
+              skipped: true,
+              reason: `skipped: provider unavailable (${rebuilt.error})`,
+            };
+          } else {
+            const stored = loadEmbeddingIndexFile(embeddings.file);
+            const normalize = (payload) => {
+              const { generatedAt, ...rest } = payload || {};
+              return JSON.stringify(rest);
+            };
+            const matches = normalize(stored.payload) === normalize(rebuilt.payload);
+            embeddingsCheck = {
+              name: "embeddings",
+              file: embeddings.file,
+              matches,
+              reason: matches ? "" : "stored embedding index differs from an in-memory rebuild of its sources",
+            };
+          }
+        }
+      }
+      verify.checks.push(embeddingsCheck);
+      verify.ok = verify.ok && (embeddingsCheck.matches !== false);
+    }
+
+    if (parsed.json) {
+      console.log(JSON.stringify({ action: "verify", ...verify }, null, 2));
+    } else {
+      header("design-ai index", "verify");
+      for (const check of verify.checks) {
+        if (check.matches) {
+          info(check.skipped ? `${check.name}: ${check.reason}` : `${check.name}: matches an in-memory rebuild`);
+        } else {
+          warn(`${check.name}: ${check.reason}`);
+          console.log(`  ${dim(check.file)}`);
+        }
+      }
+      if (verify.ok) success("Stored index matches its sources.");
+    }
+    if (!verify.ok) process.exitCode = 1;
+    return;
+  }
+
+  const status = retrievalIndexStatus(context);
+  const embeddings = embeddingsStatusSection(context);
+  const fresh = embeddings ? status.fresh && embeddings.fresh : status.fresh;
+  // Key order is a documented contract (embeddings sits after learning, before
+  // fresh) — build the object explicitly rather than relying on spread order.
+  const fullStatus = {
+    indexDir: status.indexDir,
+    corpus: status.corpus,
+    learning: status.learning,
+    embeddings,
+    fresh,
+    buildCommand: status.buildCommand,
+  };
+  if (parsed.json) {
+    console.log(JSON.stringify({ action: "status", ...fullStatus }, null, 2));
+    return;
+  }
+  printStatus(fullStatus);
+}

package/cli/commands/learn-help.mjs

@@ -0,0 +1,149 @@
+// Help text for `design-ai learn`.
+
+import { LEARNING_FEEDBACK_OUTCOMES } from "../lib/learn.mjs";
+
+export function printHelp() {
+  console.log("Usage:  design-ai learn [--list] [--category kind] [--query text] [--explain] [--limit N] [--json] [--out file] [--force]");
+  console.log("        design-ai learn --recall query [--limit N] [--category kind] [--json]");
+  console.log("        design-ai learn <mode> ...  Bare-word alias for a mode flag, e.g. `learn signals --json` = `learn --signals --json`");
+  console.log("        design-ai learn --init [--yes|--dry-run] [--json] [--out file] [--force]");
+  console.log("        design-ai learn --remember text [--category kind] [--json] [--out file] [--force]");
+  console.log("        design-ai learn --feedback text [--outcome keep|improve|avoid] [--category kind] [--json] [--out file] [--force]");
+  console.log("        design-ai learn --feedback --from-file notes.md [--outcome keep|improve|avoid] [--category kind] [--json] [--out file] [--force]");
+  console.log("        cat notes.md | design-ai learn --feedback --stdin [--outcome keep|improve|avoid] [--category kind] [--json] [--out file] [--force]");
+  console.log("        design-ai learn --from-file notes.md [--category kind] [--json] [--out file] [--force]");
+  console.log("        cat notes.md | design-ai learn --stdin [--category kind] [--json] [--out file] [--force]");
+  console.log("        design-ai learn --export [--category kind] [--query text] [--limit N] [--json] [--out file] [--force]");
+  console.log("        design-ai learn --backup [--json] [--out file] [--force]");
+  console.log("        design-ai learn --redact [--json] [--out file] [--force]");
+  console.log("        design-ai learn --redact --from-file learning-backup.json [--json] [--out file] [--force]");
+  console.log("        cat learning-backup.json | design-ai learn --redact --stdin [--json] [--out file] [--force]");
+  console.log("        design-ai learn --verify --from-file learning.json [--json] [--out file] [--force]");
+  console.log("        cat learning.json | design-ai learn --verify --stdin [--json] [--out file] [--force]");
+  console.log("        design-ai learn --diff --from-file learning.json [--json] [--out file] [--force]");
+  console.log("        cat learning.json | design-ai learn --diff --stdin [--json] [--out file] [--force]");
+  console.log("        design-ai learn --restore --from-file learning-backup.json [--dry-run|--yes] [--backup-file path] [--json] [--out file] [--force]");
+  console.log("        cat learning-backup.json | design-ai learn --restore --stdin [--dry-run|--yes] [--backup-file path] [--json] [--out file] [--force]");
+  console.log("        design-ai learn --restore-backups [--limit N] [--json] [--out file] [--force]");
+  console.log("        design-ai learn --restore-backups --prune [--keep N] [--dry-run|--yes] [--json] [--out file] [--force]");
+  console.log("        design-ai learn --import --from-file learning.json --dry-run [--json] [--out file] [--force]");
+  console.log("        cat learning.json | design-ai learn --import --stdin --yes [--json] [--out file] [--force]");
+  console.log("        design-ai learn --audit [--json] [--out file] [--force]");
+  console.log("        design-ai learn --audit --fix --dry-run [--json] [--out file] [--force]");
+  console.log("        design-ai learn --audit --fix --yes [--json] [--out file] [--force]");
+  console.log("        design-ai learn --curate [--dry-run|--yes] [--usage-file path] [--json|--report] [--out file] [--force]");
+  console.log("        design-ai learn --stats [--json] [--out file] [--force]");
+  console.log("        design-ai learn --usage [--limit N] [--usage-file path] [--json] [--out file] [--force]");
+  console.log("        design-ai learn --signals [--from-file signal-file-or-dir] [--usage-file path] [--strict] [--json|--report] [--out file] [--force]");
+  console.log("        design-ai learn --agent-backlog [--from-file signal-file-or-dir] [--usage-file path] [--strict] [--json|--report] [--out file] [--force]");
+  console.log("        design-ai learn --propose-skills [--from-file signal-file-or-dir] [--usage-file path] [--review-file path] [--review-check|--apply-plan] [--min-evidence N] [--strict] [--json|--report|--patch|--review-template] [--out file] [--force]");
+  console.log("        design-ai learn --eval-template [--query text] [--category kind] [--limit N] [--json] [--out file] [--force]");
+  console.log("        design-ai learn --eval --from-file eval.json [--category kind] [--limit N] [--strict] [--json] [--out file] [--force]");
+  console.log("        cat eval.json | design-ai learn --eval --stdin [--category kind] [--limit N] [--strict] [--json]");
+  console.log("        design-ai learn --forget id-or-number --yes [--json] [--out file] [--force]");
+  console.log("        design-ai learn --clear --yes [--json] [--out file] [--force]\n");
+  console.log("Stores local design preferences for explicit prompt personalization.");
+  console.log("This is local memory, not model training or fine-tuning.\n");
+  console.log("Options:");
+  console.log("  --init               Preview or apply starter local learning entries for dogfood use");
+  console.log("  --remember text      Remember an inline preference or project constraint");
+  console.log("  --feedback text      Convert outcome feedback into a reusable local learning note");
+  console.log(`  --outcome kind       Feedback outcome: ${LEARNING_FEEDBACK_OUTCOMES.join(", ")}. Default: improve`);
+  console.log("  --from-file file     Read remember/feedback text or import/verify/diff/restore/redact JSON from a file");
+  console.log("  --stdin              Read remember/feedback text or import/verify/diff/restore/redact JSON from standard input");
+  console.log("  --category kind      preference, brand, workflow, constraint, accessibility, korean, other");
+  console.log("  --query text         Filter list/export output to entries whose category or text matches the query");
+  console.log("  --explain            With --list, include selection score, matched tokens, and reason");
+  console.log("  --limit N            Limit list/export output to the N most recent matching entries, 1-100");
+  console.log("  --recall query       Read-only combined recall: top corpus knowledge files plus local learning entries ranked for the query");
+  console.log("  --list               List saved learning entries. Default when no action is given");
+  console.log("  --export             Print the learned-context block used by --with-learning");
+  console.log("  --backup             Print a full portable learning-profile backup; use --json for importable JSON");
+  console.log("  --redact             Print a portable JSON backup with sensitive-looking text redacted");
+  console.log("  --verify             Validate a portable learning JSON payload without importing it");
+  console.log("  --diff               Compare the active profile against a portable learning JSON payload without importing it");
+  console.log("  --restore            Preview or apply replacing the active profile with a portable learning JSON payload");
+  console.log("  --restore-backups    List sibling restore rollback backups for the active learning profile");
+  console.log("  --prune              With --restore-backups, preview or delete older rollback backup files");
+  console.log("  --keep N             With --restore-backups --prune, keep the N newest backups. Default: 5");
+  console.log("  --backup-file path   With --restore, override the automatic rollback backup file path");
+  console.log("  --import             Merge entries from a JSON learning profile or learn --export --json payload");
+  console.log("  --audit              Inspect profile shape, sensitive content, and cleanup suggestions without changing it");
+  console.log("  --fix                With --audit, prepare or apply safe cleanup suggestions");
+  console.log("  --curate             Preview or apply archive-first curation for duplicate/sensitive entries, plus usage review hints");
+  console.log("  --report             With --curate, --signals, --agent-backlog, or --propose-skills, emit a Markdown review report instead of human console output");
+  console.log("  --patch              With --propose-skills, emit a preview-only unified diff handoff without editing skill files");
+  console.log("  --review-check       With --propose-skills, verify the review file against current proposals without changing files");
+  console.log("  --apply-plan         With --propose-skills, turn accepted review decisions into a read-only manual apply plan");
+  console.log("  --review-template    With --propose-skills, emit a JSON proposal review-file template without changing review decisions");
+  console.log("  --dry-run            Preview --init, --import, --restore, --curate, --restore-backups --prune, or --audit --fix without changing files");
+  console.log("  --stats              Summarize profile counts, recency, and audit status without changing it");
+  console.log("  --usage              Summarize prompt/pack --with-learning usage sidecar events without changing files");
+  console.log("  --signals            Summarize local learning, usage, eval, check-capture, agent backlog, and workspace readiness signals without changing files");
+  console.log("  --agent-backlog      Emit a focused local AI/agent development backlog from the signal registry without changing files");
+  console.log("  --propose-skills     Preview skill instruction deltas from repeated check-capture learning signals without changing files");
+  console.log("  --min-evidence N     With --propose-skills, require N related check-capture entries before emitting a proposal. Default: 2");
+  console.log("  --review-file path   With --propose-skills, read proposal review decisions without changing the review file");
+  console.log("  --eval-template      Generate a runnable learning eval checkpoint from the active profile");
+  console.log("  --eval               Run deterministic learning-selection checkpoint cases without changing files");
+  console.log("  --strict             With --eval, --signals, --agent-backlog, or --propose-skills, exit non-zero when any checkpoint, signal, backlog, or proposal gate warns or fails");
+  console.log("  --forget id-or-number Remove one entry by id or 1-based list number; requires --yes");
+  console.log("  --clear              Remove all saved learning entries; requires --yes");
+  console.log("  --yes                Confirm destructive local profile changes");
+  console.log("  --file path          Override the learning profile path");
+  console.log("  --usage-file path    Override the learning usage sidecar path used by --usage, --curate, --signals, --agent-backlog, or --propose-skills");
+  console.log("  --json               Emit machine-readable output");
+  console.log("  --out file           Write JSON output to a file, export Markdown for --export, or learning review report Markdown");
+  console.log("  --force              Overwrite an existing --out file, or an existing --backup-file during --restore");
+  console.log("");
+  console.log("Environment:");
+  console.log("  DESIGN_AI_LEARNING_FILE=/path/learning.json       Override the default profile path");
+  console.log("  DESIGN_AI_LEARNING_USAGE_FILE=/path/usage.json    Override the default usage sidecar path");
+  console.log("");
+  console.log("Examples:");
+  console.log("  design-ai learn --init");
+  console.log("  design-ai learn --init --yes --json");
+  console.log("  design-ai learn --remember \"Prefer dense Korean product UI\" --category korean");
+  console.log("  design-ai learn --feedback \"Keep audit findings short and evidence-led\" --outcome keep");
+  console.log("  design-ai learn --feedback --from-file feedback.md --outcome improve");
+  console.log("  cat feedback.md | design-ai learn --feedback --stdin --outcome avoid --category brand");
+  console.log("  design-ai learn --recall \"korean payment\" --limit 5");
+  console.log("  design-ai learn --list --category korean --limit 5");
+  console.log("  design-ai learn --list --query \"keyboard accessibility\" --explain --json");
+  console.log("  design-ai learn --export --query \"pricing page\" --limit 3");
+  console.log("  design-ai learn --backup --json --out learning-backup.json");
+  console.log("  design-ai learn --redact --json --out learning-redacted.json");
+  console.log("  design-ai learn --redact --from-file learning-backup.json --json --out learning-redacted.json --force");
+  console.log("  design-ai learn --verify --from-file learning-backup.json");
+  console.log("  design-ai learn --diff --from-file learning-backup.json --json");
+  console.log("  design-ai learn --restore --from-file learning-backup.json --dry-run");
+  console.log("  design-ai learn --restore --from-file learning-backup.json --yes --backup-file learning-before-restore.json");
+  console.log("  design-ai learn --restore-backups --json");
+  console.log("  design-ai learn --restore-backups --prune --keep 5");
+  console.log("  design-ai learn --restore-backups --prune --keep 5 --yes");
+  console.log("  design-ai learn --import --from-file learning.json --dry-run");
+  console.log("  design-ai learn --audit");
+  console.log("  design-ai learn --audit --fix --dry-run");
+  console.log("  design-ai learn --curate");
+  console.log("  design-ai learn --curate --usage-file ./learning.usage.json");
+  console.log("  design-ai learn --curate --report --out learning-curation-report.md");
+  console.log("  design-ai learn --curate --yes --json");
+  console.log("  design-ai learn --stats --json");
+  console.log("  design-ai learn --usage --json");
+  console.log("  design-ai learn --signals --from-file . --json");
+  console.log("  design-ai learn --signals --from-file . --report --out learning-signals.md");
+  console.log("  design-ai learn --agent-backlog --from-file . --report --out agent-backlog.md");
+  console.log("  design-ai learn --propose-skills --from-file . --min-evidence 3 --json");
+  console.log("  design-ai learn --propose-skills --from-file . --strict --json");
+  console.log("  design-ai learn --propose-skills --from-file . --review-file skill-proposals.review.json --strict --json");
+  console.log("  design-ai learn --propose-skills --from-file . --review-file skill-proposals.review.json --review-check --json");
+  console.log("  design-ai learn --propose-skills --from-file . --review-file skill-proposals.review.json --apply-plan --json");
+  console.log("  design-ai learn --propose-skills --from-file . --review-template --out skill-proposals.review.json");
+  console.log("  design-ai learn --propose-skills --from-file . --report --out skill-proposals.md");
+  console.log("  design-ai learn --propose-skills --from-file . --patch --out skill-proposals.patch");
+  console.log("  design-ai learn --eval-template --query \"keyboard accessibility\" --out learning-eval.json");
+  console.log("  design-ai learn --eval --from-file learning-eval.json --strict --json");
+  console.log("  design-ai learn --forget learn-abc123def0 --yes");
+  console.log("  design-ai prompt \"audit checkout UX\" --with-learning");
+  console.log("  design-ai pack \"spec a pricing page\" --with-learning");
+}