@thanh01.pmt/domain-kit 0.6.0 → 0.6.1

package/dist/{chunk-2OGNQUXC.mjs → chunk-4UCXYRM3.mjs}

@@ -1,282 +1,11 @@
+import { createLlmClient, llmChatJson, parseJsonFromLlm } from './chunk-7A2SG466.mjs';
+import { transportResultFrom } from './chunk-IBVXXVGE.mjs';
 import { parseSyllabus } from './chunk-T4Y2DE2W.mjs';
 import { stripDiacritics } from './chunk-OYSZQVPY.mjs';
 import { readFileSync, mkdirSync, writeFileSync } from 'fs';
 import { tmpdir } from 'os';
 import { join } from 'path';
 
-// src/utils/llmClient.ts
-function summarizeProvenance(callLog) {
-  const providers = [];
-  const models = [];
-  let failed = 0;
-  for (const r of callLog) {
-    if (!providers.includes(r.provider)) providers.push(r.provider);
-    if (!models.includes(r.model)) models.push(r.model);
-    if (!r.ok) failed++;
-  }
-  return { providers, models, calls: callLog.length, failed_calls: failed, degraded: failed > 0 };
-}
-var LlmClientError = class extends Error {
-  constructor(message, status, cause) {
-    super(message);
-    this.status = status;
-    this.cause = cause;
-    this.name = "LlmClientError";
-  }
-};
-function resolveProviderChain(config) {
-  const chain = [];
-  const push = (label, baseUrl, apiKey, model) => {
-    if (apiKey && baseUrl && model && !chain.some((c) => c.baseUrl === baseUrl && c.model === model)) {
-      chain.push({ label, baseUrl, apiKey, model });
-    }
-  };
-  if (config?.apiKey) {
-    push("config", config.baseUrl || "https://api.openai.com/v1", config.apiKey, config.model || "gpt-4o-mini");
-  }
-  push("legacy", process.env.LLM_BASE_URL || process.env.OPENAI_BASE_URL || "", process.env.LLM_API_KEY || process.env.OPENAI_API_KEY || "", process.env.LLM_MODEL || process.env.LLM_TIER_FAST || "");
-  push("dashscope", process.env.DASHSCOPE_BASE_URL || process.env.ALIBABA_BASE_URL || "", process.env.DASHSCOPE_API_KEY || process.env.ALIBABA_API_KEY || "", process.env.DASHSCOPE_MODEL || process.env.DEFAULT_AI_MODEL || "");
-  push("nvidia", "https://integrate.api.nvidia.com/v1", process.env.NVIDIA_API_KEY || "", process.env.NVIDIA_MODEL || "nvidia/nemotron-3-ultra-550b-a55b:free");
-  push("openrouter", "https://openrouter.ai/api/v1", process.env.OPENROUTER_API_KEY || "", process.env.OPENROUTER_MODEL || "nvidia/nemotron-3-ultra-550b-a55b:free");
-  if (process.env.OPENROUTER_MODEL) {
-    const or = chain.find((c) => c.label === "openrouter");
-    if (or) {
-      const rest = chain.filter((c) => c !== or);
-      return [or, ...rest];
-    }
-  }
-  return chain;
-}
-var MIN_REQUEST_INTERVAL_MS = 2500;
-var requestIntervalMs = Number(process.env.LLM_MIN_REQUEST_INTERVAL_MS || MIN_REQUEST_INTERVAL_MS);
-var lastRequestAt = 0;
-async function pacedDelay() {
-  const wait = lastRequestAt + requestIntervalMs - Date.now();
-  if (wait > 0) await new Promise((resolve) => setTimeout(resolve, wait));
-  lastRequestAt = Date.now();
-}
-function createLlmClient(config) {
-  const chain = resolveProviderChain(config);
-  const primary = chain[0];
-  if (!primary) {
-    throw new LlmClientError(
-      "No LLM provider configured. Set NVIDIA_API_KEY (primary) and/or OPENROUTER_API_KEY (fallback), or pass llmConfig."
-    );
-  }
-  primary.apiKey;
-  primary.baseUrl;
-  const model = primary.model;
-  if (config?.minRequestIntervalMs !== void 0) {
-    requestIntervalMs = Math.max(0, config.minRequestIntervalMs);
-  }
-  const callLog = [];
-  async function chat(messages, options) {
-    const temperature = options?.temperature ?? config?.temperature ?? 0.1;
-    const maxTokens = options?.maxTokens ?? config?.maxTokens ?? parseInt(process.env.LLM_MAX_TOKENS || "65536", 10);
-    const attempts = [];
-    let lastError = null;
-    const TRANSIENT = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
-    const REQUEST_TIMEOUT_MS = Number(process.env.LLM_REQUEST_TIMEOUT_MS || 3e5);
-    const MAX_CHAIN_ROUNDS = 3;
-    for (let round = 1; round <= MAX_CHAIN_ROUNDS; round++) {
-      if (round > 1) {
-        attempts.push("round " + (round - 1) + " failed \u2014 backing off 20s before rewalking the chain");
-        await new Promise((resolve) => setTimeout(resolve, 2e4));
-      }
-      for (const provider of chain) {
-        const recIdx = callLog.push({ provider: provider.label, model: provider.model, ok: false }) - 1;
-        try {
-          const headers = {
-            "Content-Type": "application/json",
-            "Authorization": `Bearer ${provider.apiKey}`
-          };
-          const payload = {
-            model: provider.model,
-            messages,
-            temperature,
-            max_tokens: maxTokens
-          };
-          await pacedDelay();
-          const doFetch = () => fetch(`${provider.baseUrl}/chat/completions`, {
-            method: "POST",
-            headers: {
-              "Content-Type": "application/json",
-              "Authorization": `Bearer ${provider.apiKey}`
-            },
-            body: JSON.stringify({
-              model: provider.model,
-              messages,
-              temperature,
-              max_tokens: maxTokens
-            }),
-            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
-          });
-          let response;
-          try {
-            response = await doFetch();
-          } catch (netErr) {
-            attempts.push(`${provider.label}: network error (${netErr instanceof Error ? netErr.message : String(netErr)}) \u2014 retrying once`);
-            await new Promise((r) => setTimeout(r, 5e3));
-            lastRequestAt = Date.now();
-            response = await doFetch();
-          }
-          if (!response.ok) {
-            const body = await response.text().catch(() => "");
-            const err = new LlmClientError(
-              `[${provider.label}] LLM API error: ${response.status} ${response.statusText} \u2014 ${body.slice(0, 200)}`,
-              response.status
-            );
-            if (response.status === 429) {
-              const retryAfterRaw = response.headers.get("retry-after");
-              const retryAfterMs = Math.min(
-                6e4,
-                Math.max(15e3, (Number.isFinite(Number(retryAfterRaw)) ? Number(retryAfterRaw) : 20) * 1e3)
-              );
-              attempts.push(`${provider.label}: 429 rate-limited \u2014 backing off ${Math.round(retryAfterMs / 1e3)}s`);
-              await new Promise((resolve) => setTimeout(resolve, retryAfterMs));
-              lastRequestAt = Date.now();
-              const retry = await fetch(`${provider.baseUrl}/chat/completions`, {
-                method: "POST",
-                headers,
-                body: JSON.stringify(payload),
-                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
-              });
-              if (!retry.ok) throw err;
-              const retryData = await retry.json();
-              const retryContent2 = retryData.choices?.[0]?.message?.content || "";
-              if (!retryContent2.trim()) throw err;
-              callLog[recIdx] = { ...callLog[recIdx], ok: true };
-              return {
-                content: retryContent2,
-                model: retryData.model || provider.model,
-                provider: provider.label,
-                attempts: attempts.slice(),
-                usage: retryData.usage,
-                finishReason: retryData.choices?.[0]?.finish_reason
-              };
-            }
-            if (TRANSIENT.has(response.status)) {
-              await new Promise((r) => setTimeout(r, 3e3));
-              const retry = await fetch(`${provider.baseUrl}/chat/completions`, {
-                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-                method: "POST",
-                headers: {
-                  "Content-Type": "application/json",
-                  "Authorization": `Bearer ${provider.apiKey}`
-                },
-                body: JSON.stringify({
-                  model: provider.model,
-                  messages,
-                  temperature,
-                  max_tokens: maxTokens
-                })
-              });
-              if (!retry.ok) throw err;
-              const retryData = await retry.json();
-              const retryContent = retryData.choices?.[0]?.message?.content || "";
-              callLog[recIdx] = { ...callLog[recIdx], ok: true };
-              return {
-                content: retryContent,
-                model: retryData.model || provider.model,
-                provider: provider.label,
-                attempts: attempts.slice(),
-                usage: retryData.usage,
-                finishReason: retryData.choices?.[0]?.finish_reason
-              };
-            }
-            throw err;
-          }
-          const data = await response.json();
-          const wrappedError = data.error;
-          if (wrappedError) {
-            throw new LlmClientError("[" + provider.label + "] upstream error " + (wrappedError.code ?? "") + ": " + (wrappedError.message ?? "unknown"));
-          }
-          const content = data.choices?.[0]?.message?.content || "";
-          if (!content.trim()) {
-            throw new LlmClientError("[" + provider.label + "] empty completion returned");
-          }
-          return {
-            content,
-            model: data.model || provider.model,
-            provider: provider.label,
-            attempts: attempts.slice(),
-            usage: data.usage,
-            finishReason: data.choices?.[0]?.finish_reason
-          };
-        } catch (err) {
-          const msg = err instanceof Error ? err.message : String(err);
-          callLog[recIdx] = { ...callLog[recIdx], ok: false, error: msg.slice(0, 200) };
-          attempts.push(`${provider.label}: ${msg}`);
-          lastError = err instanceof LlmClientError ? err : new LlmClientError(`[${provider.label}] ${msg}`);
-        }
-      }
-      if (round < MAX_CHAIN_ROUNDS) continue;
-      throw lastError ?? new LlmClientError("All LLM providers failed (empty chain).");
-    }
-    throw lastError ?? new LlmClientError("All LLM providers failed after " + MAX_CHAIN_ROUNDS + " rounds.");
-  }
-  return { chat, model, callLog };
-}
-function parseJsonFromLlm(text) {
-  let cleaned = text.trim();
-  if (cleaned.startsWith("```json")) {
-    cleaned = cleaned.slice(7);
-  } else if (cleaned.startsWith("```")) {
-    cleaned = cleaned.slice(3);
-  }
-  if (cleaned.endsWith("```")) {
-    cleaned = cleaned.slice(0, -3);
-  }
-  cleaned = cleaned.trim();
-  try {
-    return JSON.parse(cleaned);
-  } catch {
-    const start = cleaned.indexOf("{");
-    if (start >= 0) {
-      let depth = 0;
-      let inString = false;
-      let escape = false;
-      for (let i = start; i < cleaned.length; i++) {
-        const ch = cleaned[i];
-        if (escape) {
-          escape = false;
-          continue;
-        }
-        if (ch === "\\") {
-          escape = true;
-          continue;
-        }
-        if (ch === '"') {
-          inString = !inString;
-          continue;
-        }
-        if (inString) continue;
-        if (ch === "{") depth++;
-        if (ch === "}") {
-          depth--;
-          if (depth === 0) {
-            try {
-              return JSON.parse(cleaned.slice(start, i + 1));
-            } catch {
-            }
-          }
-        }
-      }
-    }
-    throw new LlmClientError(`Failed to parse JSON from LLM response: ${cleaned.slice(0, 200)}`);
-  }
-}
-async function llmChatJson(client, systemPrompt, userPrompt, options) {
-  const result = await client.chat(
-    [
-      { role: "system", content: systemPrompt },
-      { role: "user", content: userPrompt }
-    ],
-    options
-  );
-  return parseJsonFromLlm(result.content);
-}
-
 // src/graph/scaffoldExtractor.ts
 async function extractScaffold(options) {
   const { goal, techStack, fileList, llmConfig, sharedClient } = options;
@@ -375,7 +104,7 @@ async function extractProjectOverview(options) {
       (kw) => `- ${kw.keyword} (from ${kw.source})`
     );
     if (kwItems.length > 0) {
-      keywordsAnchor = "\nAST Domain Keywords & Patterns (from static analysis \u2014 use as context anchor):\n" + kwItems.join("\n") + "\n";
+      keywordsAnchor = "\nDomain Keywords & Patterns (from regex-based static scan \u2014 use as context anchor):\n" + kwItems.join("\n") + "\n";
     }
   }
   const systemPrompt = "You are a software architect. The app the user will build IS EXACTLY the provided files (not an SDK/lib). Analyze them and return a PROJECT OVERVIEW \u2014 meta only, DO NOT list steps (steps are handled in a later step). NEVER invent files/APIs. NEVER reference internal SDK/lib unless it appears in the given files.\nEND-USER VIEW (M1/Design Thinking): product.purpose must describe the USER PROBLEM (what the user does with the app, which need it solves). NEVER describe repo/artifacts.\nDEVELOPMENT STAGES: Include 4-6 development stages in product.development_stages. Each stage must have: stage (name), need (list of feature needs), learn (concepts learned), product_state (what works), temporary_approach, and validation.\nMISSING GAPS: Identify 0-5 missing_gaps (features/functionality that should exist but don't).\nTECH DEBT: Identify 0-5 tech_debt issues (code quality problems).\nALL text must be in ENGLISH.";
@@ -1175,7 +904,110 @@ function techSignalHits(text) {
   }
   return hits;
 }
-function auditDepthLayers(concepts) {
+var COMPLETABLE_VERBS = [
+  "build",
+  "create",
+  "implement",
+  "write",
+  "configure",
+  "add",
+  "use",
+  "apply",
+  "display",
+  "store",
+  "load",
+  "save",
+  "handle",
+  "parse",
+  "validate",
+  "test",
+  "register",
+  "compute",
+  "generate",
+  "print",
+  "format",
+  "convert",
+  "extend",
+  "define",
+  "execute",
+  "run",
+  "read",
+  "fetch",
+  "wrap",
+  "log",
+  "call",
+  "raise",
+  "install",
+  "import",
+  "export",
+  "declare",
+  "embed",
+  "model",
+  "represent",
+  "override",
+  "customize",
+  "enforce",
+  "mock",
+  "assert",
+  "query",
+  "index",
+  "cache",
+  "stream",
+  "split",
+  "join",
+  "strip",
+  "encode",
+  "decode",
+  "traverse",
+  "measure",
+  "evaluate",
+  "benchmark",
+  "diagnose",
+  "demonstrate",
+  "verify",
+  "organize",
+  "structure",
+  "choose",
+  "select",
+  "compare",
+  "distinguish",
+  "attach",
+  "annotate",
+  "expose",
+  "accept",
+  "manage",
+  "group",
+  "sort",
+  "filter",
+  "map",
+  "reduce",
+  "catch",
+  "throw",
+  "migrate",
+  "inspect",
+  "trace",
+  "parameterize",
+  "construct",
+  "design",
+  "capture",
+  // Completable implementation verbs present in production SIO output but
+  // missing from the original registry (2026-10-07 smoke test, swift kg):
+  "update",
+  "inject",
+  "compose",
+  "pass",
+  "modify",
+  "connect",
+  "remove",
+  "transform",
+  "trigger",
+  "refresh",
+  "persist",
+  "observe",
+  "arrange",
+  "derive"
+];
+function auditDepthLayers(concepts, transport) {
   return concepts.map((c) => {
     const ulo = (c.ulo ?? "").trim();
     const cio = (c.cio ?? "").trim();
@@ -1196,7 +1028,7 @@ function auditDepthLayers(concepts) {
     });
     const conceptKeywords = (c.keywords ?? []).map((k) => k.toLowerCase()).filter(Boolean);
     const sioOffConceptItems = conceptKeywords.length > 0 ? sioItems.filter((s) => !boundToConcept(s)) : [];
-    const COMPLETABLE = /\b(build|create|implement|write|configure|add|use|apply|display|store|load|save|handle|parse|validate|test|register|compute|generate|print|format|convert|extend|define|execute|run|read|fetch|wrap|log|call|raise|install|import|export|declare|embed|model|represent|override|customize|enforce|mock|assert|query|index|cache|stream|split|join|strip|encode|decode|traverse|measure|evaluate|benchmark|diagnose|demonstrate|verify|organize|structure|choose|select|compare|distinguish|attach|annotate|expose|accept|manage|group|sort|filter|map|reduce|catch|throw|migrate|inspect|trace|parameterize|construct|design|capture)\b/i;
+    const COMPLETABLE = new RegExp("\\b(?:" + COMPLETABLE_VERBS.join("|") + ")\\b", "i");
     const sioNotCompletable = sioItems.filter((s) => !COMPLETABLE.test(s) && !/`[^`]+`/.test(s));
     const density = (text) => {
       if (!text) return 0;
@@ -1236,7 +1068,8 @@ function auditDepthLayers(concepts) {
       clauseOk,
       codesOk,
       codeIssues,
-      passed
+      passed,
+      transport
     };
   });
 }
@@ -1271,14 +1104,14 @@ function excerpt(text, max) {
   const t = (text || "").trim();
   return t.length > max ? t.slice(0, max) + "..." : t;
 }
-async function chatJson(client, system, user) {
+async function chatJson(client, system, user, transport) {
   const r = await client.chat(
     [{ role: "system", content: system }, { role: "user", content: user }],
     { temperature: 0.1, maxTokens: parseInt(process.env.KG_MAX_TOKENS || "65536", 10) }
   );
   return parseJsonFromLlm(r.content);
 }
-var LO_BATCH_SIZE = 6;
+var LO_BATCH_SIZE = 10;
 function chunkConcepts(items, size) {
   const out = [];
   for (let i = 0; i < items.length; i += size) out.push(items.slice(i, i + size));
@@ -1317,7 +1150,7 @@ async function authorDepthLayersHierarchically(client, concepts, techStack, warn
   for (const batch of chunkConcepts(concepts, LO_BATCH_SIZE)) {
     const batchList = batch.map((c) => "- " + c.id + " (" + c.name + ")" + (c.description ? ": " + excerpt(c.description, 160) : "")).join("\n");
     const batchUser = "Concepts:\n" + batchList + '\n\nReturn JSON:\n{"ulos":[{"concept_id":"C1","ulo":"..."}]}';
-    const uloRes = await chatJson(client, uloSystem, batchUser);
+    const uloRes = await chatJson(client, uloSystem, batchUser, transportResultFrom("9router", client.model, { framingStripped: true }));
     for (const u of uloRes.ulos ?? []) {
       if (u.concept_id && u.ulo) uloByConcept[u.concept_id] = standardStatement(u.ulo);
     }
@@ -1356,7 +1189,7 @@ async function authorDepthLayersHierarchically(client, concepts, techStack, warn
     new Set(batch.map((c) => c.id));
     const batchUloContext = batch.map((c) => "- " + c.id + " (" + c.name + "): " + (uloByConcept[c.id] || "(missing)")).join("\n");
     const batchCioUser = "Approved ULOs:\n" + batchUloContext + '\n\nReturn JSON:\n{"cios":[{"concept_id":"C1","cio":"..."}]}';
-    const cioRes = await chatJson(client, cioSystem, batchCioUser);
+    const cioRes = await chatJson(client, cioSystem, batchCioUser, transportResultFrom("9router", client.model, { framingStripped: true }));
     for (const x of cioRes.cios ?? []) {
       if (x.concept_id && x.cio) cioByConcept[x.concept_id] = standardStatement(x.cio);
     }
@@ -1381,15 +1214,7 @@ async function authorDepthLayersHierarchically(client, concepts, techStack, warn
     "   context where it is used. Application/Analysis/Creation skills are assessed",
     "   INDIRECTLY through completing these tasks \u2014 there is no fixed Bloom ceiling.",
     "   MACHINE CHECK: every item MUST contain at least one ACTION VERB from this whitelist",
-    "   (build, create, implement, write, configure, add, use, apply, display, store, load,",
-    "   save, handle, parse, validate, test, register, compute, generate, print, format,",
-    "   convert, extend, define, execute, run, read, fetch, wrap, log, call, raise, install,",
-    "   import, export, declare, embed, model, represent, override, customize, enforce, mock,",
-    "   assert, query, index, cache, stream, split, join, strip, encode, decode, traverse,",
-    "   measure, evaluate, benchmark, diagnose, demonstrate, verify, organize, structure,",
-    "   choose, select, compare, distinguish, attach, annotate, expose, accept, manage, group,",
-    "   sort, filter, map, reduce, catch, throw, migrate, inspect, trace, parameterize,",
-    "   construct, design, capture) \u2014 OR wrap the concrete construct in backticks.",
+    "   (" + COMPLETABLE_VERBS.join(", ") + ") \u2014 OR wrap the concrete construct in backticks.",
     "   Items with abstract verbs (understand, learn, know, grasp, appreciate, explore) and",
     "   no backtick construct FAIL the audit. Prefer starting the task phrase with the verb.",
     "3. 2-3 items per concept, each referencing a DIFFERENT concrete construct.",
@@ -1417,7 +1242,7 @@ async function authorDepthLayersHierarchically(client, concepts, techStack, warn
       "Return JSON:",
       '{"sios":[{"concept_id":"C1","sio":["...","..."]}]}'
     ].join("\n");
-    const sioRes = await chatJson(client, sioSystem, batchSioUser);
+    const sioRes = await chatJson(client, sioSystem, batchSioUser, transportResultFrom("9router", client.model, { framingStripped: true }));
     for (const x of sioRes.sios ?? []) {
       if (x.concept_id && Array.isArray(x.sio)) sioByConcept[x.concept_id] = x.sio.map((item) => standardStatement(String(item)));
     }
@@ -1470,7 +1295,7 @@ async function authorDepthLayersHierarchically(client, concepts, techStack, warn
         "- CIO: HOW mechanism, technology-agnostic, more concrete than ULO, Marr 2-Language neutral.",
         "- SIO: keyword-bound completable implementation tasks naming real constructs of " + techStack + ".",
         "- BINDING RULE: every SIO item must contain at least one of the concept's listed keywords VERBATIM (copy the exact keyword text into the sentence).",
-        "- COMPLETABILITY RULE: every SIO item must contain an actionable verb (build, create, implement, write, configure, parse, validate, handle, store, load, run, read, fetch, display, generate, format, convert, test, debug, trace, measure, design, structure, select, filter, sort, map, reduce, catch, throw, migrate, deploy, query, index, cache, stream, inspect) or wrap a concrete construct in backticks \u2014 abstract verbs (understand, learn, know, grasp, explore, appreciate) always fail.",
+        "- COMPLETABILITY RULE: every SIO item must contain an actionable verb (" + ["build", "create", "update", "inject", "compose", "pass", "modify", "use"].join(", ") + " ...full registry in the SIO authoring step) or wrap a concrete construct in backticks \u2014 abstract verbs (understand, learn, know, grasp, explore, appreciate) always fail.",
         "",
         JSON_ONLY
       ].join("\n");
@@ -1518,7 +1343,7 @@ async function authorDepthLayersHierarchically(client, concepts, techStack, warn
       "Depth-layer contract audit failed after repair for: " + detail + " \u2014 regenerate or fix the prompt contract (fail-closed, no silent fallback)"
     );
   }
-  return { uloByConcept, cioByConcept, sioByConcept, audits, warnings };
+  return { uloByConcept, cioByConcept, sioByConcept, audits, warnings, lastTransport: audits[0]?.transport };
 }
 function cell(v) {
   return (v || "").split(",").map((s) => s.trim()).filter(Boolean);
@@ -1661,7 +1486,7 @@ async function standardizeConcepts(opts) {
     "     Adopt the tree's terminology. Only propose new when the tree genuinely has NO concept teaching that knowledge (broader AND narrower both fail).",
     '  2. "proposed_new" - no tree concept covers it at the same granularity. Propose an UPPER_SNAKE_CASE code (descriptive, stable, max 5 words) and a one-sentence definition.',
     "     If between 1 and 3 tree concepts are CLOSE but not exact, list their codes in possible_tree_matches for human review.",
-    `For a "standardized" decision ALSO return "adopted_keywords": the subset of that tree concept's keywords (from the shortlist) that make sense for the course TECH STACK. Drop keywords that name tooling from other ecosystems (e.g. JS test runners for a Python course) \u2014 keep conceptual keywords even when spelled generically. Maximum 8, ordered most-relevant first.`,
+    `For a "standardized" decision ALSO return "adopted_keywords": copy VERBATIM from that tree concept's keyword list in the shortlist (exact tokens, do not re-spell, singularize or translate). Pick the subset that makes sense for the course TECH STACK; if none fit, return an EMPTY array \u2014 never invent a keyword. Maximum 8, ordered most-relevant first.`,
     "Rules:",
     "- Judge by MEANING (definition + keywords), not by string similarity.",
     '- COVERAGE RULE: a "standardized" match must cover ALL primary dimensions of the input concept \u2014 every distinct aspect named in its title or description. A tree concept covering only ONE of several aspects (e.g. "interpreting error messages" for a concept about error handling AND user experience) is a PARTIAL match: decide "proposed_new" and list that tree code in possible_tree_matches.',
@@ -1701,10 +1526,25 @@ async function standardizeConcepts(opts) {
       const tc = catalog.concepts.find((x) => x.code === d.tree_code);
       if (!tc) throw new Error("Concept " + c.id + " standardized to unknown tree code " + d.tree_code + " \u2014 fail-closed");
       const treeKw = new Set(tc.keywords.map((k) => k.toLowerCase()));
-      const adopted = (d.adopted_keywords || []).map((k) => String(k)).filter((k) => {
-        if (treeKw.has(k.toLowerCase())) return true;
-        throw new Error("Concept " + c.id + ' adopted keyword "' + k + '" not in tree concept ' + tc.code + " \u2014 fail-closed");
-      });
+      const rawAdopted = (d.adopted_keywords || []).map((k) => String(k)).filter(Boolean);
+      let adopted;
+      if (tc.keywords.length === 0) {
+        adopted = rawAdopted.filter((k) => (c.keywords ?? []).some((ck) => ck.toLowerCase() === k.toLowerCase()));
+        if (adopted.length === 0) adopted = (c.keywords ?? []).slice(0, 8);
+        warnings.push("Concept " + c.id + ": tree concept " + tc.code + " has no keyword registry \u2014 adopted " + adopted.length + " keyword(s) from the analysis concept");
+      } else {
+        const norm = (k) => k.toLowerCase().replace(/ies$/, "y").replace(/s$/, "");
+        const treeKwNorm = new Set([...treeKw].map(norm));
+        const dropped = [];
+        adopted = rawAdopted.filter((k) => {
+          if (treeKw.has(k.toLowerCase()) || treeKwNorm.has(norm(k))) return true;
+          dropped.push(k);
+          return false;
+        });
+        if (dropped.length > 0) {
+          warnings.push("Concept " + c.id + ": dropped " + dropped.length + " adopted keyword(s) not in tree concept " + tc.code + " registry: " + dropped.join(", "));
+        }
+      }
       if (tc.keywords.length > 0 && adopted.length === 0) {
         throw new Error("Concept " + c.id + " standardized to " + tc.code + " without adopted_keywords \u2014 fail-closed");
       }
@@ -1799,7 +1639,7 @@ async function generateKnowledgeGraph(options) {
     log("STEP_1", `Parsed syllabus: ${parsedSyllabus.units.length} units, ${parsedSyllabus.allTopics.length} topics`);
   }
   const client = createLlmClient(llmConfig);
-  const maxSyllabusChars = parseInt(process.env.KG_MAX_SYLLABUS_CHARS || "16000", 10);
+  const maxSyllabusChars = parseInt(process.env.KG_MAX_SYLLABUS_CHARS || "32000", 10);
   let truncatedSyllabus = "";
   if (syllabusText) {
     if (syllabusText.length > maxSyllabusChars) {
@@ -1989,23 +1829,32 @@ Return JSON:
       }
     }
     const idByTreeCode = new Map(concepts.filter((c) => c.tree_code).map((c) => [c.tree_code, c.id]));
+    const unmappedTreePrereqs = /* @__PURE__ */ new Set();
     for (const c of concepts) {
       for (const tp of c.tree_prerequisites || []) {
         const target = idByTreeCode.get(tp);
         if (target && target !== c.id && !(c.prerequisites || []).includes(target)) {
           c.prerequisites = [...c.prerequisites || [], target];
           warnings.push("Prereq seeded from tree: " + c.id + " <- " + tp + " (" + target + ")");
+        } else if (!target) {
+          unmappedTreePrereqs.add(tp);
         }
       }
     }
+    if (unmappedTreePrereqs.size > 0) {
+      const shown = [...unmappedTreePrereqs].slice(0, 10).join(", ");
+      warnings.push("Tree prereqs outside THIS analysis (no edge seeded, " + unmappedTreePrereqs.size + " codes): " + shown + (unmappedTreePrereqs.size > 10 ? ", ..." : ""));
+    }
     log("STEP_2_5", "Standardized: " + std.decisions.filter((d) => d.decision === "standardized").length + ", proposed new: " + std.decisions.filter((d) => d.decision === "proposed_new").length);
+  } else {
+    warnings.push("No knowledgeTreePath provided \u2014 concepts are NOT standardized against the knowledge tree (all proposed_new)");
   }
   log("STEP_3", "Checking for prerequisite cycles...");
   const cycles = detectPrerequisiteCycles(concepts);
   if (cycles.length > 0) {
     log("STEP_3", `Found ${cycles.length} cycle(s) in prerequisite chain \u2014 breaking cycles`);
     for (const cycle of cycles) {
-      warnings.push(`Cycle detected: ${cycle.join(" \u2192 ")} \u2014 breaking at weakest edge`);
+      warnings.push(`Cycle detected: ${cycle.join(" \u2192 ")} \u2014 removing the closing back-edge (last DFS edge; pedagogically arbitrary)`);
     }
     const { fixed, removed } = breakPrerequisiteCycles(concepts, cycles);
     for (let i = 0; i < concepts.length; i++) {
@@ -2420,6 +2269,6 @@ async function decomposePhases(args) {
   return phases;
 }
 
-export { CIO_CODE_RE, CONCEPT_CODE_RE, LEARNER_CLAUSE, SIO_CODE_RE, ULO_CODE_RE, assignConceptCodes, auditDepthLayers, auditPhasePlan, auditSyllabusCoverage, breakPrerequisiteCycles, cioActionSlug, cioCode, conceptCodeFromName, createLlmClient, detectPrerequisiteCycles, escalateAndMapConcepts, extractFeatureSteps, extractFeatureStepsBatched, extractProjectOverview, extractScaffold, generateHybridGraph, generateKnowledgeGraph, llmChatJson, sioCode, standardStatement, summarizeProvenance, techTagFor, uloCode, verifyKnowledgeGraph, verifyProjectGraph };
-//# sourceMappingURL=chunk-2OGNQUXC.mjs.map
-//# sourceMappingURL=chunk-2OGNQUXC.mjs.map
+export { CIO_CODE_RE, CONCEPT_CODE_RE, LEARNER_CLAUSE, SIO_CODE_RE, ULO_CODE_RE, assignConceptCodes, auditDepthLayers, auditPhasePlan, auditSyllabusCoverage, breakPrerequisiteCycles, cioActionSlug, cioCode, conceptCodeFromName, detectPrerequisiteCycles, escalateAndMapConcepts, extractFeatureSteps, extractFeatureStepsBatched, extractProjectOverview, extractScaffold, generateHybridGraph, generateKnowledgeGraph, sioCode, standardStatement, techTagFor, uloCode, verifyKnowledgeGraph, verifyProjectGraph };
+//# sourceMappingURL=chunk-4UCXYRM3.mjs.map
+//# sourceMappingURL=chunk-4UCXYRM3.mjs.map