@chrisdudek/yg 5.4.0 → 5.4.1

package/dist/bin.js

@@ -17,6 +17,17 @@ var DEFAULT_CONFIG = `version: "5.1.0"
 quality:
   max_direct_relations: 10
 
+# Coverage \u2014 which files must belong to a node.
+# Fresh projects start in "require nothing" mode: every unmapped file surfaces as
+# a NON-blocking warning (not a blocking error), so your very first \`yg check\` is
+# green while you adopt incrementally. Add a path prefix to \`required\` (e.g.
+# "src/") to make that area blocking once you start mapping it. NOTE: an ABSENT
+# coverage block defaults to requiring the WHOLE repo \u2014 this explicit empty list
+# is what opts a fresh project into require-nothing.
+coverage:
+  required: []
+  excluded: []
+
 # Reviewer configuration added by: yg init
 # (see yg schemas read config + yg knowledge read configuration)
 
@@ -3890,6 +3901,13 @@ async function ensureYggdrasilGitignore(yggRoot) {
 }
 var API_PROVIDERS = ["anthropic", "openai", "google", "openai-compatible", "ollama"];
 var CLI_PROVIDERS = ["claude-code", "codex", "gemini-cli"];
+var ALL_PROVIDERS = [...CLI_PROVIDERS, ...API_PROVIDERS];
+var API_KEY_ENV = {
+  anthropic: "ANTHROPIC_API_KEY",
+  openai: "OPENAI_API_KEY",
+  google: "GOOGLE_API_KEY",
+  "openai-compatible": "OPENAI_API_KEY"
+};
 var CLAUDE_CODE_ALIASES = [
   { value: "haiku", label: "haiku" },
   { value: "sonnet", label: "sonnet" },
@@ -3984,15 +4002,16 @@ async function promptModelText(provider) {
 async function runReviewerConfigFlow() {
   const provider = await p.select({
     message: "Which provider should verify your code?",
+    initialValue: "claude-code",
     options: [
-      { value: "anthropic", label: "Anthropic", hint: "API \u2014 Claude models" },
-      { value: "openai", label: "OpenAI", hint: "API \u2014 GPT models" },
-      { value: "google", label: "Google", hint: "API \u2014 Gemini models" },
-      { value: "ollama", label: "Ollama", hint: "Local \u2014 no API costs" },
-      { value: "openai-compatible", label: "OpenAI-compatible", hint: "API \u2014 custom endpoint" },
-      { value: "claude-code", label: "Claude Code", hint: "CLI \u2014 uses installed claude" },
-      { value: "codex", label: "Codex", hint: "CLI \u2014 uses installed codex" },
-      { value: "gemini-cli", label: "Gemini CLI", hint: "CLI \u2014 uses installed gemini" }
+      { value: "claude-code", label: "Claude Code", hint: "CLI \u2014 free, no API key; uses installed claude" },
+      { value: "codex", label: "Codex", hint: "CLI \u2014 free, no API key; uses installed codex" },
+      { value: "gemini-cli", label: "Gemini CLI", hint: "CLI \u2014 free, no API key; uses installed gemini" },
+      { value: "ollama", label: "Ollama", hint: "Local \u2014 no API costs; needs a local install" },
+      { value: "anthropic", label: "Anthropic", hint: "API key \u2014 Claude models" },
+      { value: "openai", label: "OpenAI", hint: "API key \u2014 GPT models" },
+      { value: "google", label: "Google", hint: "API key \u2014 Gemini models" },
+      { value: "openai-compatible", label: "OpenAI-compatible", hint: "API key \u2014 custom endpoint" }
     ]
   });
   assertNotCancelled(provider);
@@ -4123,9 +4142,9 @@ async function freshInit(projectRoot) {
   const yggRoot = path14.join(projectRoot, ".yggdrasil");
   if (!isTTY()) {
     process.stderr.write(chalk2.red(`Error: ${buildIssueMessage({
-      what: "yg init requires an interactive terminal.",
-      why: "Setup requires interactive prompts to configure platform and reviewer.",
-      next: "Run yg init in an interactive terminal session."
+      what: "yg init requires an interactive terminal (no --provider given).",
+      why: "The interactive wizard needs prompts to configure platform and reviewer. Docker, devcontainer, and CI runs have no TTY.",
+      next: `Run yg init in an interactive terminal, OR bootstrap non-interactively: yg init --platform <name> --provider <name> [--model <m>] [--endpoint <url>]. Supported providers: ${ALL_PROVIDERS.join(", ")}.`
     })}
 `));
     process.exit(1);
@@ -4139,7 +4158,7 @@ async function freshInit(projectRoot) {
   const platform = await promptPlatform();
   p.log.step("Step 2: Reviewer provider");
   p.log.info(
-    "The reviewer checks your source code against aspect rules during yg check --approve.\n  API providers make HTTP calls. CLI providers delegate to an installed agent.\n  For local review without API costs, use Ollama."
+    "The reviewer checks your source code against aspect rules during yg check --approve.\n  If you already run an agent CLI (Claude Code, Codex, Gemini), pick it \u2014 the\n  reviewer then needs no API key and adds no separate API bill. Ollama runs\n  locally with no API cost. API providers (Anthropic, OpenAI, Google) need a key."
   );
   const reviewerConfig = await runReviewerConfigFlow();
   await createYggdrasilStructure(projectRoot, yggRoot, platform);
@@ -4159,6 +4178,54 @@ async function createYggdrasilStructure(projectRoot, yggRoot, platform) {
   await ensureYggdrasilGitignore(yggRoot);
   await installRulesForPlatform(projectRoot, platform);
 }
+async function freshInitNonInteractive(projectRoot, yggRoot, opts) {
+  const { platform, provider } = opts;
+  const model = opts.model?.trim();
+  if (!model) {
+    process.stderr.write(chalk2.red(`Error: ${buildIssueMessage({
+      what: "--model is required for non-interactive init.",
+      why: "Non-interactive init records the reviewer model verbatim and applies no default \u2014 the model must be named explicitly.",
+      next: `Re-run naming a model: yg init --platform ${platform} --provider ${provider} --model <name>.`
+    })}
+`));
+    process.exit(1);
+  }
+  let endpoint = opts.endpoint?.trim() || void 0;
+  if (needsEndpoint(provider) && !endpoint) {
+    if (provider === "ollama") {
+      endpoint = "http://localhost:11434";
+    } else {
+      process.stderr.write(chalk2.red(`Error: ${buildIssueMessage({
+        what: `--endpoint is required for provider '${provider}'.`,
+        why: "An OpenAI-compatible provider has no default base URL \u2014 the reviewer needs an endpoint to call.",
+        next: `Re-run naming an endpoint: yg init --platform ${platform} --provider ${provider} --model ${model} --endpoint <url>.`
+      })}
+`));
+      process.exit(1);
+    }
+  }
+  await createYggdrasilStructure(projectRoot, yggRoot, platform);
+  await writeReviewerConfig(yggRoot, { provider, model, endpoint });
+  if (needsApiKey(provider)) {
+    const envVar = API_KEY_ENV[provider];
+    const apiKey = (envVar ? process.env[envVar] : void 0)?.trim();
+    if (apiKey) {
+      await writeSecretsFile(yggRoot, apiKey);
+    } else {
+      process.stdout.write(chalk2.yellow(`${buildIssueMessage({
+        what: `No API key found${envVar ? ` in $${envVar}` : ""}; wrote the config without one.`,
+        why: "An API provider needs a key before the reviewer can run; init records the config anyway so setup is not blocked.",
+        next: `Set ${envVar ?? "the provider API key environment variable"} (or add the key to .yggdrasil/yg-secrets.yaml) before running yg check --approve.`
+      })}
+`));
+    }
+  }
+  await ensureGitattributes(projectRoot);
+  process.stdout.write(chalk2.green(
+    `Yggdrasil initialized (platform: ${platform}, provider: ${provider}, model: ${model}). Run yg check to get started.
+`
+  ));
+}
 async function runVersionUpgrade2(projectRoot, yggRoot, platform) {
   const { migrationActions, migrationWarnings, withheld } = await runVersionUpgrade({
     yggRoot,
@@ -4249,7 +4316,7 @@ async function existingInit(projectRoot) {
   }
 }
 function registerInitCommand(program2) {
-  program2.command("init").description("Initialize Yggdrasil graph in current project").option("--upgrade", "Non-interactive: refresh rules").option("--platform <name>", `Platform for rules file (${PLATFORMS.join(", ")})`).action(async (options) => {
+  program2.command("init").description("Initialize Yggdrasil graph in current project").option("--upgrade", "Non-interactive: refresh rules").option("--platform <name>", `Platform for rules file (${PLATFORMS.join(", ")})`).option("--provider <name>", `Non-interactive fresh init: reviewer provider (${ALL_PROVIDERS.join(", ")})`).option("--model <name>", "Non-interactive fresh init: reviewer model (required)").option("--endpoint <url>", "Non-interactive fresh init: reviewer endpoint (ollama / openai-compatible)").action(async (options) => {
     try {
       const projectRoot = process.cwd();
       const yggRoot = path14.join(projectRoot, ".yggdrasil");
@@ -4359,6 +4426,40 @@ function registerInitCommand(program2) {
       }
       if (exists) {
         await existingInit(projectRoot);
+      } else if (options.provider) {
+        if (!options.platform) {
+          process.stderr.write(chalk2.red(`Error: ${buildIssueMessage({
+            what: "--provider requires --platform for non-interactive init.",
+            why: "A fresh graph must install the rules file for a specific agent platform; there is no prompt to ask in non-interactive mode.",
+            next: `Pass --platform <name>. Supported: ${PLATFORMS.join(", ")}.`
+          })}
+`));
+          process.exit(1);
+        }
+        if (!PLATFORMS.includes(options.platform)) {
+          process.stderr.write(chalk2.red(`Error: ${buildIssueMessage({
+            what: `Unknown platform '${options.platform}'.`,
+            why: "The --platform value must match one of the supported agent platforms.",
+            next: `Use one of: ${PLATFORMS.join(", ")}`
+          })}
+`));
+          process.exit(1);
+        }
+        if (!ALL_PROVIDERS.includes(options.provider)) {
+          process.stderr.write(chalk2.red(`Error: ${buildIssueMessage({
+            what: `Unknown provider '${options.provider}'.`,
+            why: "The --provider value must match one of the supported reviewer providers.",
+            next: `Use one of: ${ALL_PROVIDERS.join(", ")}`
+          })}
+`));
+          process.exit(1);
+        }
+        await freshInitNonInteractive(projectRoot, yggRoot, {
+          platform: options.platform,
+          provider: options.provider,
+          model: options.model,
+          endpoint: options.endpoint
+        });
       } else {
         await freshInit(projectRoot);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrisdudek/yg",
-  "version": "5.4.0",
+  "version": "5.4.1",
   "description": "Architecture rules your AI coding agent can't ignore. It gets the rules for a file before it edits, and every change is checked — by a free local script or an LLM reviewer — before it moves on. Works with Claude Code, Cursor, Copilot, Codex, Cline.",
   "type": "module",
   "bin": {