@thanh01.pmt/domain-kit 0.5.0 → 0.6.1

package/dist/graph/index.d.cts

@@ -1,11 +1,12 @@
-import { L as LlmClientConfig } from '../llmClient-ysPhLjcH.cjs';
+import { LlmClientConfig, LlmClient } from '../utils/llmClient.cjs';
 import { d as Feature, c as Step } from '../projectGraphSchema-DnD7orZV.cjs';
-import { K as Keyword } from '../keywordExtractor-BxlGRMHC.cjs';
-export { H as Hallucination, j as HybridGraphPipelineOptions, k as HybridGraphPipelineResult, K as KnowledgeGraphPipelineOptions, a as KnowledgeGraphPipelineResult, f as KnowledgeGraphVerificationReport, V as VerifyOptions, i as auditPhasePlan, e as auditSyllabusCoverage, c as breakPrerequisiteCycles, d as detectPrerequisiteCycles, h as generateHybridGraph, g as generateKnowledgeGraph, b as verifyKnowledgeGraph, v as verifyProjectGraph } from '../hybridGraphPipeline-dT-bio-3.cjs';
-export { C as ConceptMapping, E as EscalateOptions, e as escalateAndMapConcepts } from '../conceptEscalator-ltRLtPhf.cjs';
+import { K as Keyword } from '../keywordExtractor-1YAFntsn.cjs';
+export { H as Hallucination, j as HybridGraphPipelineOptions, k as HybridGraphPipelineResult, K as KnowledgeGraphPipelineOptions, a as KnowledgeGraphPipelineResult, f as KnowledgeGraphVerificationReport, V as VerifyOptions, i as auditPhasePlan, e as auditSyllabusCoverage, c as breakPrerequisiteCycles, d as detectPrerequisiteCycles, h as generateHybridGraph, g as generateKnowledgeGraph, b as verifyKnowledgeGraph, v as verifyProjectGraph } from '../hybridGraphPipeline-B4mamLim.cjs';
+export { C as ConceptMapping, E as EscalateOptions, e as escalateAndMapConcepts } from '../conceptEscalator-BmMJD8C5.cjs';
+import { LlmTransportResult } from '../utils/llmTransportResult.cjs';
 import 'zod';
-import '../cpp-CZUPqJt9.cjs';
-import '../hybridGraphSchema-nrUeSwpU.cjs';
+import '../cpp-vlDl6pCL.cjs';
+import '../hybridGraphSchema-C37qxdTM.cjs';
 import '../syllabusParser-MSX1fEzW.cjs';
 
 /**
@@ -21,6 +22,9 @@ interface ExtractScaffoldOptions {
     techStack: string;
     fileList: string[];
     llmConfig?: LlmClientConfig;
+    /** Pre-built client from the calling pipeline — reused so every step of one run
+     *  lands in ONE callLog and the feed can report real provenance. */
+    sharedClient?: LlmClient;
 }
 /**
  * Extract the FOUNDATION & SETUP feature (F0) via LLM.
@@ -49,6 +53,9 @@ interface ExtractOverviewOptions {
     fileContentsMap: Map<string, string>;
     astKeywords?: Keyword[];
     llmConfig?: LlmClientConfig;
+    /** Pre-built client from the calling pipeline — reused so every step of one run
+     *  lands in ONE callLog and the feed can report real provenance. */
+    sharedClient?: LlmClient;
 }
 /**
  * Extract project overview (features meta) via LLM.
@@ -77,6 +84,9 @@ interface ExtractStepsOptions {
     fileContentsMap: Map<string, string>;
     feature: Feature;
     llmConfig?: LlmClientConfig;
+    /** Pre-built client from the calling pipeline — reused so every step of one run
+     *  lands in ONE callLog and the feed can report real provenance. */
+    sharedClient?: LlmClient;
 }
 /**
  * Extract steps for a SINGLE feature via LLM.
@@ -91,7 +101,7 @@ declare function extractFeatureStepsBatched(goal: string, techStack: string, sdk
         kind: string;
         used_in_demo: boolean;
     }>;
-}, fileContentsMap: Map<string, string>, featuresMeta: Feature[], llmConfig?: LlmClientConfig): Promise<Map<string, Step[]>>;
+}, fileContentsMap: Map<string, string>, featuresMeta: Feature[], llmConfig?: LlmClientConfig, sharedClient?: LlmClient): Promise<Map<string, Step[]>>;
 
 interface DepthLayerAudit {
     conceptId: string;
@@ -109,6 +119,8 @@ interface DepthLayerAudit {
     codesOk: boolean;
     codeIssues: string[];
     passed: boolean;
+    /** Which LLM transport produced the layers under audit (for provenance). */
+    transport?: LlmTransportResult;
 }
 declare function auditDepthLayers(concepts: Array<{
     id: string;
@@ -121,7 +133,7 @@ declare function auditDepthLayers(concepts: Array<{
     cio_code?: string;
     sio_codes?: string[];
     keywords?: string[];
-}>): DepthLayerAudit[];
+}>, transport?: LlmTransportResult): DepthLayerAudit[];
 
 /**
  * LO code + statement standard — calibrated against the production

package/dist/graph/index.d.ts

@@ -1,11 +1,12 @@
-import { L as LlmClientConfig } from '../llmClient-ysPhLjcH.js';
+import { LlmClientConfig, LlmClient } from '../utils/llmClient.js';
 import { d as Feature, c as Step } from '../projectGraphSchema-DnD7orZV.js';
-import { K as Keyword } from '../keywordExtractor-DU5XRN8-.js';
-export { H as Hallucination, j as HybridGraphPipelineOptions, k as HybridGraphPipelineResult, K as KnowledgeGraphPipelineOptions, a as KnowledgeGraphPipelineResult, f as KnowledgeGraphVerificationReport, V as VerifyOptions, i as auditPhasePlan, e as auditSyllabusCoverage, c as breakPrerequisiteCycles, d as detectPrerequisiteCycles, h as generateHybridGraph, g as generateKnowledgeGraph, b as verifyKnowledgeGraph, v as verifyProjectGraph } from '../hybridGraphPipeline-DXQDbBEj.js';
-export { C as ConceptMapping, E as EscalateOptions, e as escalateAndMapConcepts } from '../conceptEscalator-YfMKIKCZ.js';
+import { K as Keyword } from '../keywordExtractor-DWw8z_AF.js';
+export { H as Hallucination, j as HybridGraphPipelineOptions, k as HybridGraphPipelineResult, K as KnowledgeGraphPipelineOptions, a as KnowledgeGraphPipelineResult, f as KnowledgeGraphVerificationReport, V as VerifyOptions, i as auditPhasePlan, e as auditSyllabusCoverage, c as breakPrerequisiteCycles, d as detectPrerequisiteCycles, h as generateHybridGraph, g as generateKnowledgeGraph, b as verifyKnowledgeGraph, v as verifyProjectGraph } from '../hybridGraphPipeline-D2_1GUva.js';
+export { C as ConceptMapping, E as EscalateOptions, e as escalateAndMapConcepts } from '../conceptEscalator-DMsehscs.js';
+import { LlmTransportResult } from '../utils/llmTransportResult.js';
 import 'zod';
-import '../cpp-CZUPqJt9.js';
-import '../hybridGraphSchema-nrUeSwpU.js';
+import '../cpp-vlDl6pCL.js';
+import '../hybridGraphSchema-C37qxdTM.js';
 import '../syllabusParser-MSX1fEzW.js';
 
 /**
@@ -21,6 +22,9 @@ interface ExtractScaffoldOptions {
     techStack: string;
     fileList: string[];
     llmConfig?: LlmClientConfig;
+    /** Pre-built client from the calling pipeline — reused so every step of one run
+     *  lands in ONE callLog and the feed can report real provenance. */
+    sharedClient?: LlmClient;
 }
 /**
  * Extract the FOUNDATION & SETUP feature (F0) via LLM.
@@ -49,6 +53,9 @@ interface ExtractOverviewOptions {
     fileContentsMap: Map<string, string>;
     astKeywords?: Keyword[];
     llmConfig?: LlmClientConfig;
+    /** Pre-built client from the calling pipeline — reused so every step of one run
+     *  lands in ONE callLog and the feed can report real provenance. */
+    sharedClient?: LlmClient;
 }
 /**
  * Extract project overview (features meta) via LLM.
@@ -77,6 +84,9 @@ interface ExtractStepsOptions {
     fileContentsMap: Map<string, string>;
     feature: Feature;
     llmConfig?: LlmClientConfig;
+    /** Pre-built client from the calling pipeline — reused so every step of one run
+     *  lands in ONE callLog and the feed can report real provenance. */
+    sharedClient?: LlmClient;
 }
 /**
  * Extract steps for a SINGLE feature via LLM.
@@ -91,7 +101,7 @@ declare function extractFeatureStepsBatched(goal: string, techStack: string, sdk
         kind: string;
         used_in_demo: boolean;
     }>;
-}, fileContentsMap: Map<string, string>, featuresMeta: Feature[], llmConfig?: LlmClientConfig): Promise<Map<string, Step[]>>;
+}, fileContentsMap: Map<string, string>, featuresMeta: Feature[], llmConfig?: LlmClientConfig, sharedClient?: LlmClient): Promise<Map<string, Step[]>>;
 
 interface DepthLayerAudit {
     conceptId: string;
@@ -109,6 +119,8 @@ interface DepthLayerAudit {
     codesOk: boolean;
     codeIssues: string[];
     passed: boolean;
+    /** Which LLM transport produced the layers under audit (for provenance). */
+    transport?: LlmTransportResult;
 }
 declare function auditDepthLayers(concepts: Array<{
     id: string;
@@ -121,7 +133,7 @@ declare function auditDepthLayers(concepts: Array<{
     cio_code?: string;
     sio_codes?: string[];
     keywords?: string[];
-}>): DepthLayerAudit[];
+}>, transport?: LlmTransportResult): DepthLayerAudit[];
 
 /**
  * LO code + statement standard — calibrated against the production

package/dist/graph/index.mjs

@@ -1,5 +1,8 @@
 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-TYXSJUQU.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-7A2SG466.mjs';
+import '../chunk-IBVXXVGE.mjs';
 import '../chunk-T4Y2DE2W.mjs';
+import '../chunk-OYSZQVPY.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/{hybridGraphPipeline-dT-bio-3.d.cts → hybridGraphPipeline-B4mamLim.d.cts}

@@ -1,6 +1,6 @@
 import { u as ProjectGraph } from './projectGraphSchema-DnD7orZV.cjs';
-import { L as LlmClientConfig } from './llmClient-ysPhLjcH.cjs';
-import { g as KnowledgeGraph, b as Concept, j as HybridGraph, l as DevelopmentPhase } from './hybridGraphSchema-nrUeSwpU.cjs';
+import { LlmClientConfig, LlmCallRecord } from './utils/llmClient.cjs';
+import { g as KnowledgeGraph, b as Concept, j as HybridGraph, l as DevelopmentPhase } from './hybridGraphSchema-C37qxdTM.cjs';
 import { P as ParsedSyllabus } from './syllabusParser-MSX1fEzW.cjs';
 
 /**
@@ -126,6 +126,8 @@ interface KnowledgeGraphPipelineResult {
     knowledgeGraph: KnowledgeGraph;
     warnings: string[];
     verificationReport?: KnowledgeGraphVerificationReport;
+    /** Which providers served this graph, and whether any call fell over. */
+    provenance: LlmCallRecord[];
 }
 /**
  * Generate a KnowledgeGraph from syllabus/description via LLM.
@@ -153,6 +155,8 @@ interface HybridGraphPipelineOptions {
 interface HybridGraphPipelineResult {
     hybridGraph: HybridGraph;
     warnings: string[];
+    /** Which providers served this graph, and whether any call fell over. */
+    provenance: LlmCallRecord[];
 }
 declare function generateHybridGraph(options: HybridGraphPipelineOptions): Promise<HybridGraphPipelineResult>;
 declare function auditPhasePlan(plan: Array<Record<string, unknown>>, features: Array<{

package/dist/{hybridGraphPipeline-DXQDbBEj.d.ts → hybridGraphPipeline-D2_1GUva.d.ts}

@@ -1,6 +1,6 @@
 import { u as ProjectGraph } from './projectGraphSchema-DnD7orZV.js';
-import { L as LlmClientConfig } from './llmClient-ysPhLjcH.js';
-import { g as KnowledgeGraph, b as Concept, j as HybridGraph, l as DevelopmentPhase } from './hybridGraphSchema-nrUeSwpU.js';
+import { LlmClientConfig, LlmCallRecord } from './utils/llmClient.js';
+import { g as KnowledgeGraph, b as Concept, j as HybridGraph, l as DevelopmentPhase } from './hybridGraphSchema-C37qxdTM.js';
 import { P as ParsedSyllabus } from './syllabusParser-MSX1fEzW.js';
 
 /**
@@ -126,6 +126,8 @@ interface KnowledgeGraphPipelineResult {
     knowledgeGraph: KnowledgeGraph;
     warnings: string[];
     verificationReport?: KnowledgeGraphVerificationReport;
+    /** Which providers served this graph, and whether any call fell over. */
+    provenance: LlmCallRecord[];
 }
 /**
  * Generate a KnowledgeGraph from syllabus/description via LLM.
@@ -153,6 +155,8 @@ interface HybridGraphPipelineOptions {
 interface HybridGraphPipelineResult {
     hybridGraph: HybridGraph;
     warnings: string[];
+    /** Which providers served this graph, and whether any call fell over. */
+    provenance: LlmCallRecord[];
 }
 declare function generateHybridGraph(options: HybridGraphPipelineOptions): Promise<HybridGraphPipelineResult>;
 declare function auditPhasePlan(plan: Array<Record<string, unknown>>, features: Array<{

package/dist/{hybridGraphSchema-nrUeSwpU.d.ts → hybridGraphSchema-C37qxdTM.d.cts}

@@ -2246,9 +2246,22 @@ declare const HybridGraphSchema: z.ZodObject<{
         }[] | undefined;
     }>, "many">>>;
     description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** Minutes of PRODUCT work: sum over every feature step. */
     total_project_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /** Minutes of CONCEPT work: sum over EVERY concept in the graph. */
     total_concept_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    estimated_total_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * Renamed from `estimated_total_minutes` (2026-10-05) — the old name read
+     * like "the course total" but the number is narrower:
+     *   total_project_minutes + (minutes of concepts that HAVE a feature link)
+     * unlinked concepts are deliberately excluded, and per concept the MAXIMUM
+     * link estimate wins, not the sum. Expect this to sit well BELOW
+     * total_project_minutes + total_concept_minutes.
+     *
+     * The figure the phase planner actually commits to is
+     * total_project_minutes + total_concept_minutes (see decomposePhases).
+     */
+    linked_prereq_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
     type: "hybrid_graph";
     description: string;
@@ -2539,7 +2552,7 @@ declare const HybridGraphSchema: z.ZodObject<{
     }[];
     total_project_minutes: number;
     total_concept_minutes: number;
-    estimated_total_minutes: number;
+    linked_prereq_minutes: number;
 }, {
     knowledge_graph: {
         subject: {
@@ -2830,7 +2843,7 @@ declare const HybridGraphSchema: z.ZodObject<{
     }[] | undefined;
     total_project_minutes?: number | undefined;
     total_concept_minutes?: number | undefined;
-    estimated_total_minutes?: number | undefined;
+    linked_prereq_minutes?: number | undefined;
 }>;
 type HybridGraph = z.infer<typeof HybridGraphSchema>;
 type ProjectConceptLink = z.infer<typeof ProjectConceptLinkSchema>;

package/dist/{hybridGraphSchema-nrUeSwpU.d.cts → hybridGraphSchema-C37qxdTM.d.ts}

@@ -2246,9 +2246,22 @@ declare const HybridGraphSchema: z.ZodObject<{
         }[] | undefined;
     }>, "many">>>;
     description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** Minutes of PRODUCT work: sum over every feature step. */
     total_project_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /** Minutes of CONCEPT work: sum over EVERY concept in the graph. */
     total_concept_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    estimated_total_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /**
+     * Renamed from `estimated_total_minutes` (2026-10-05) — the old name read
+     * like "the course total" but the number is narrower:
+     *   total_project_minutes + (minutes of concepts that HAVE a feature link)
+     * unlinked concepts are deliberately excluded, and per concept the MAXIMUM
+     * link estimate wins, not the sum. Expect this to sit well BELOW
+     * total_project_minutes + total_concept_minutes.
+     *
+     * The figure the phase planner actually commits to is
+     * total_project_minutes + total_concept_minutes (see decomposePhases).
+     */
+    linked_prereq_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
     type: "hybrid_graph";
     description: string;
@@ -2539,7 +2552,7 @@ declare const HybridGraphSchema: z.ZodObject<{
     }[];
     total_project_minutes: number;
     total_concept_minutes: number;
-    estimated_total_minutes: number;
+    linked_prereq_minutes: number;
 }, {
     knowledge_graph: {
         subject: {
@@ -2830,7 +2843,7 @@ declare const HybridGraphSchema: z.ZodObject<{
     }[] | undefined;
     total_project_minutes?: number | undefined;
     total_concept_minutes?: number | undefined;
-    estimated_total_minutes?: number | undefined;
+    linked_prereq_minutes?: number | undefined;
 }>;
 type HybridGraph = z.infer<typeof HybridGraphSchema>;
 type ProjectConceptLink = z.infer<typeof ProjectConceptLinkSchema>;