@thanh01.pmt/domain-kit 0.6.1 → 0.6.3

package/dist/graph/index.d.cts

@@ -135,6 +135,23 @@ declare function auditDepthLayers(concepts: Array<{
     keywords?: string[];
 }>, transport?: LlmTransportResult): DepthLayerAudit[];
 
+interface HierarchicalLoConceptInput {
+    keywords?: string[];
+    id: string;
+    name: string;
+    description?: string;
+}
+interface HierarchicalLoResult {
+    uloByConcept: Record<string, string>;
+    cioByConcept: Record<string, string>;
+    sioByConcept: Record<string, string[]>;
+    audits: DepthLayerAudit[];
+    warnings: string[];
+    /** Transport provenance attached to the last layer-generation call. */
+    lastTransport?: LlmTransportResult;
+}
+declare function authorDepthLayersHierarchically(client: LlmClient, concepts: Array<HierarchicalLoConceptInput>, techStack: string, warnings: string[]): Promise<HierarchicalLoResult>;
+
 /**
  * LO code + statement standard — calibrated against the production
  * learning_objectives table (6,693 live rows) and the knowledge-tree
@@ -175,4 +192,4 @@ declare const ULO_CODE_RE: RegExp;
 declare const CIO_CODE_RE: RegExp;
 declare const SIO_CODE_RE: RegExp;
 
-export { CIO_CODE_RE, CONCEPT_CODE_RE, type DepthLayerAudit, type ExtractOverviewOptions, type ExtractScaffoldOptions, type ExtractStepsOptions, LEARNER_CLAUSE, SIO_CODE_RE, ULO_CODE_RE, assignConceptCodes, auditDepthLayers, cioActionSlug, cioCode, conceptCodeFromName, extractFeatureSteps, extractFeatureStepsBatched, extractProjectOverview, extractScaffold, sioCode, standardStatement, techTagFor, uloCode };
+export { CIO_CODE_RE, CONCEPT_CODE_RE, type DepthLayerAudit, type ExtractOverviewOptions, type ExtractScaffoldOptions, type ExtractStepsOptions, type HierarchicalLoConceptInput, type HierarchicalLoResult, LEARNER_CLAUSE, SIO_CODE_RE, ULO_CODE_RE, assignConceptCodes, auditDepthLayers, authorDepthLayersHierarchically, cioActionSlug, cioCode, conceptCodeFromName, extractFeatureSteps, extractFeatureStepsBatched, extractProjectOverview, extractScaffold, sioCode, standardStatement, techTagFor, uloCode };

package/dist/graph/index.d.ts

@@ -135,6 +135,23 @@ declare function auditDepthLayers(concepts: Array<{
     keywords?: string[];
 }>, transport?: LlmTransportResult): DepthLayerAudit[];
 
+interface HierarchicalLoConceptInput {
+    keywords?: string[];
+    id: string;
+    name: string;
+    description?: string;
+}
+interface HierarchicalLoResult {
+    uloByConcept: Record<string, string>;
+    cioByConcept: Record<string, string>;
+    sioByConcept: Record<string, string[]>;
+    audits: DepthLayerAudit[];
+    warnings: string[];
+    /** Transport provenance attached to the last layer-generation call. */
+    lastTransport?: LlmTransportResult;
+}
+declare function authorDepthLayersHierarchically(client: LlmClient, concepts: Array<HierarchicalLoConceptInput>, techStack: string, warnings: string[]): Promise<HierarchicalLoResult>;
+
 /**
  * LO code + statement standard — calibrated against the production
  * learning_objectives table (6,693 live rows) and the knowledge-tree
@@ -175,4 +192,4 @@ declare const ULO_CODE_RE: RegExp;
 declare const CIO_CODE_RE: RegExp;
 declare const SIO_CODE_RE: RegExp;
 
-export { CIO_CODE_RE, CONCEPT_CODE_RE, type DepthLayerAudit, type ExtractOverviewOptions, type ExtractScaffoldOptions, type ExtractStepsOptions, LEARNER_CLAUSE, SIO_CODE_RE, ULO_CODE_RE, assignConceptCodes, auditDepthLayers, cioActionSlug, cioCode, conceptCodeFromName, extractFeatureSteps, extractFeatureStepsBatched, extractProjectOverview, extractScaffold, sioCode, standardStatement, techTagFor, uloCode };
+export { CIO_CODE_RE, CONCEPT_CODE_RE, type DepthLayerAudit, type ExtractOverviewOptions, type ExtractScaffoldOptions, type ExtractStepsOptions, type HierarchicalLoConceptInput, type HierarchicalLoResult, LEARNER_CLAUSE, SIO_CODE_RE, ULO_CODE_RE, assignConceptCodes, auditDepthLayers, authorDepthLayersHierarchically, cioActionSlug, cioCode, conceptCodeFromName, extractFeatureSteps, extractFeatureStepsBatched, extractProjectOverview, extractScaffold, sioCode, standardStatement, techTagFor, uloCode };

package/dist/graph/index.mjs

@@ -1,5 +1,5 @@
-import '../chunk-ZKLT27T4.mjs';
-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 } from '../chunk-4UCXYRM3.mjs';
+import '../chunk-HRSBIVAW.mjs';
+export { CIO_CODE_RE, CONCEPT_CODE_RE, LEARNER_CLAUSE, SIO_CODE_RE, ULO_CODE_RE, assignConceptCodes, auditDepthLayers, auditPhasePlan, auditSyllabusCoverage, authorDepthLayersHierarchically, breakPrerequisiteCycles, cioActionSlug, cioCode, conceptCodeFromName, detectPrerequisiteCycles, escalateAndMapConcepts, extractFeatureSteps, extractFeatureStepsBatched, extractProjectOverview, extractScaffold, generateHybridGraph, generateKnowledgeGraph, sioCode, standardStatement, techTagFor, uloCode, verifyKnowledgeGraph, verifyProjectGraph } from '../chunk-O6Z7F7XI.mjs';
 import '../chunk-7A2SG466.mjs';
 import '../chunk-IBVXXVGE.mjs';
 import '../chunk-T4Y2DE2W.mjs';

package/dist/index.cjs

@@ -3963,11 +3963,13 @@ function excerpt(text, max) {
   const t = (text || "").trim();
   return t.length > max ? t.slice(0, max) + "..." : t;
 }
-async function chatJson(client, system, user, transport) {
+async function chatJson(client, system, user, onTransport) {
   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) }
   );
+  const t = r._transport ?? transportResultFrom("9router", client.model, { framingStripped: true });
+  onTransport?.(t);
   return parseJsonFromLlm(r.content);
 }
 var LO_BATCH_SIZE = 10;
@@ -3981,6 +3983,10 @@ async function authorDepthLayersHierarchically(client, concepts, techStack, warn
   const uloByConcept = {};
   const cioByConcept = {};
   const sioByConcept = {};
+  let lastTransport;
+  const setTransport = (t) => {
+    lastTransport = t;
+  };
   concepts.map((c) => "- " + c.id + ": " + c.name + (c.description ? " \u2014 " + excerpt(c.description, 160) : "")).join("\n");
   const uloSystem = [
     "You are a Curriculum Design Expert writing Universal Learning Objectives (ULO).",
@@ -4009,7 +4015,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, transportResultFrom("9router", client.model, { framingStripped: true }));
+    const uloRes = await chatJson(client, uloSystem, batchUser, setTransport);
     for (const u of uloRes.ulos ?? []) {
       if (u.concept_id && u.ulo) uloByConcept[u.concept_id] = standardStatement(u.ulo);
     }
@@ -4048,7 +4054,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, transportResultFrom("9router", client.model, { framingStripped: true }));
+    const cioRes = await chatJson(client, cioSystem, batchCioUser, setTransport);
     for (const x of cioRes.cios ?? []) {
       if (x.concept_id && x.cio) cioByConcept[x.concept_id] = standardStatement(x.cio);
     }
@@ -4101,7 +4107,7 @@ async function authorDepthLayersHierarchically(client, concepts, techStack, warn
       "Return JSON:",
       '{"sios":[{"concept_id":"C1","sio":["...","..."]}]}'
     ].join("\n");
-    const sioRes = await chatJson(client, sioSystem, batchSioUser, transportResultFrom("9router", client.model, { framingStripped: true }));
+    const sioRes = await chatJson(client, sioSystem, batchSioUser, setTransport);
     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)));
     }
@@ -4113,14 +4119,17 @@ async function authorDepthLayersHierarchically(client, concepts, techStack, warn
     }
   }
   concepts.map((c) => c.id);
-  const auditOnce = () => auditDepthLayers(concepts.map((c) => ({
-    id: c.id,
-    name: c.name,
-    keywords: c.keywords ?? [],
-    ulo: uloByConcept[c.id],
-    cio: cioByConcept[c.id],
-    sio: sioByConcept[c.id]
-  })));
+  const auditOnce = () => auditDepthLayers(
+    concepts.map((c) => ({
+      id: c.id,
+      name: c.name,
+      keywords: c.keywords ?? [],
+      ulo: uloByConcept[c.id],
+      cio: cioByConcept[c.id],
+      sio: sioByConcept[c.id]
+    })),
+    lastTransport
+  );
   let audits = auditOnce();
   const repairRound = async (round) => {
     const failingNow = audits.filter((a) => !a.passed);
@@ -4166,7 +4175,7 @@ async function authorDepthLayersHierarchically(client, concepts, techStack, warn
         '{"repairs":[{"concept_id":"C1","ulo":"...","cio":"...","sio":["..."]}]}'
       ].join("\n");
       try {
-        const repairRes = await chatJson(client, repairSystem, repairUser);
+        const repairRes = await chatJson(client, repairSystem, repairUser, setTransport);
         for (const r of repairRes.repairs ?? []) {
           if (!r.concept_id) continue;
           if (r.ulo) uloByConcept[r.concept_id] = standardStatement(r.ulo);
@@ -4202,7 +4211,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, lastTransport: audits[0]?.transport };
+  return { uloByConcept, cioByConcept, sioByConcept, audits, warnings, lastTransport: lastTransport ?? audits[0]?.transport };
 }
 function cell(v) {
   return (v || "").split(",").map((s) => s.trim()).filter(Boolean);
@@ -6835,6 +6844,7 @@ exports.assignConceptCodes = assignConceptCodes;
 exports.auditDepthLayers = auditDepthLayers;
 exports.auditPhasePlan = auditPhasePlan;
 exports.auditSyllabusCoverage = auditSyllabusCoverage;
+exports.authorDepthLayersHierarchically = authorDepthLayersHierarchically;
 exports.breakPrerequisiteCycles = breakPrerequisiteCycles;
 exports.build9routerProvider = build9routerProvider;
 exports.cioActionSlug = cioActionSlug;