@thanh01.pmt/domain-kit 0.5.0 → 0.6.1

package/dist/pipeline/index.d.cts

@@ -1,23 +1,24 @@
 import { u as ProjectGraph } from '../projectGraphSchema-DnD7orZV.cjs';
-import { K as Keyword } from '../keywordExtractor-BxlGRMHC.cjs';
-import { H as Hallucination, K as KnowledgeGraphPipelineOptions, f as KnowledgeGraphVerificationReport, j as HybridGraphPipelineOptions } from '../hybridGraphPipeline-dT-bio-3.cjs';
-import { C as ConceptMapping } from '../conceptEscalator-ltRLtPhf.cjs';
+import { K as Keyword } from '../keywordExtractor-1YAFntsn.cjs';
+import { H as Hallucination, K as KnowledgeGraphPipelineOptions, f as KnowledgeGraphVerificationReport, j as HybridGraphPipelineOptions } from '../hybridGraphPipeline-B4mamLim.cjs';
+import { C as ConceptMapping } from '../conceptEscalator-BmMJD8C5.cjs';
 import { ResolveConceptsResult } from '../concepts/index.cjs';
 import { AssembledRoadmap } from '../assembly/index.cjs';
-import { L as LlmClientConfig } from '../llmClient-ysPhLjcH.cjs';
+import { LlmClientConfig, LlmCallRecord } from '../utils/llmClient.cjs';
 import { P as ParsedSyllabus } from '../syllabusParser-MSX1fEzW.cjs';
-import { g as KnowledgeGraph, j as HybridGraph } from '../hybridGraphSchema-nrUeSwpU.cjs';
-import { g as CurriculumFeed } from '../curriculumFeedSchema-DUFwFyr2.cjs';
-import { D as DetectDomainProfileOptions } from '../domainProfileDetector-bzugdQmS.cjs';
-import { c as DomainProfile, g as GraphType } from '../domainProfileSchema-CwT3Ffsw.cjs';
+import { g as KnowledgeGraph, j as HybridGraph } from '../hybridGraphSchema-C37qxdTM.cjs';
+import { k as CurriculumFeed } from '../curriculumFeedSchema-DK-TUAJZ.cjs';
+import { D as DetectDomainProfileOptions } from '../domainProfileDetector-BsADsuRV.cjs';
+import { d as DomainProfile, h as GraphType } from '../domainProfileSchema-779FGk14.cjs';
 import 'zod';
-import '../cpp-CZUPqJt9.cjs';
+import '../cpp-vlDl6pCL.cjs';
+import '../utils/llmTransportResult.cjs';
 
 /**
  * Project Graph Pipeline — full orchestrator.
  *
  * Ported from knowledge-tree/generate_roadmap_v3.py PipelineOrchestrator
- * Coordinates: AST analysis → keyword extraction → LLM graph generation →
+ * Coordinates: regex-based scan → keyword extraction → LLM graph generation →
  *             verification → concept escalation → concept resolution → assembly.
  */
 
@@ -41,6 +42,8 @@ interface PipelineResult {
     hallucinations: Hallucination[];
     keywords: Keyword[];
     featureConcepts: Map<string, ConceptMapping[]>;
+    /** Which providers served this graph, and whether any call fell over. */
+    provenance: LlmCallRecord[];
 }
 /**
  * Run the full project graph generation pipeline.
@@ -119,6 +122,12 @@ interface DomainPipelineResult {
     knowledgeResult?: KnowledgePipelineResult;
     hybridResult?: HybridPipelineResult;
     warnings: string[];
+    /** Present only when the AUTO-detected learning mode could not run and the router ran a weaker pipeline instead. An explicit forcedLearningMode request fails closed instead of downgrading. */
+    modeDowngrade?: {
+        from: GraphType;
+        to: GraphType;
+        reason: string;
+    };
 }
 /**
  * Route and execute the appropriate domain pipeline based on input context.

package/dist/pipeline/index.d.ts

@@ -1,23 +1,24 @@
 import { u as ProjectGraph } from '../projectGraphSchema-DnD7orZV.js';
-import { K as Keyword } from '../keywordExtractor-DU5XRN8-.js';
-import { H as Hallucination, K as KnowledgeGraphPipelineOptions, f as KnowledgeGraphVerificationReport, j as HybridGraphPipelineOptions } from '../hybridGraphPipeline-DXQDbBEj.js';
-import { C as ConceptMapping } from '../conceptEscalator-YfMKIKCZ.js';
+import { K as Keyword } from '../keywordExtractor-DWw8z_AF.js';
+import { H as Hallucination, K as KnowledgeGraphPipelineOptions, f as KnowledgeGraphVerificationReport, j as HybridGraphPipelineOptions } from '../hybridGraphPipeline-D2_1GUva.js';
+import { C as ConceptMapping } from '../conceptEscalator-DMsehscs.js';
 import { ResolveConceptsResult } from '../concepts/index.js';
 import { AssembledRoadmap } from '../assembly/index.js';
-import { L as LlmClientConfig } from '../llmClient-ysPhLjcH.js';
+import { LlmClientConfig, LlmCallRecord } from '../utils/llmClient.js';
 import { P as ParsedSyllabus } from '../syllabusParser-MSX1fEzW.js';
-import { g as KnowledgeGraph, j as HybridGraph } from '../hybridGraphSchema-nrUeSwpU.js';
-import { g as CurriculumFeed } from '../curriculumFeedSchema-DUFwFyr2.js';
-import { D as DetectDomainProfileOptions } from '../domainProfileDetector-DHb1T0zB.js';
-import { c as DomainProfile, g as GraphType } from '../domainProfileSchema-CwT3Ffsw.js';
+import { g as KnowledgeGraph, j as HybridGraph } from '../hybridGraphSchema-C37qxdTM.js';
+import { k as CurriculumFeed } from '../curriculumFeedSchema-DK-TUAJZ.js';
+import { D as DetectDomainProfileOptions } from '../domainProfileDetector-6pjgL-6_.js';
+import { d as DomainProfile, h as GraphType } from '../domainProfileSchema-779FGk14.js';
 import 'zod';
-import '../cpp-CZUPqJt9.js';
+import '../cpp-vlDl6pCL.js';
+import '../utils/llmTransportResult.js';
 
 /**
  * Project Graph Pipeline — full orchestrator.
  *
  * Ported from knowledge-tree/generate_roadmap_v3.py PipelineOrchestrator
- * Coordinates: AST analysis → keyword extraction → LLM graph generation →
+ * Coordinates: regex-based scan → keyword extraction → LLM graph generation →
  *             verification → concept escalation → concept resolution → assembly.
  */
 
@@ -41,6 +42,8 @@ interface PipelineResult {
     hallucinations: Hallucination[];
     keywords: Keyword[];
     featureConcepts: Map<string, ConceptMapping[]>;
+    /** Which providers served this graph, and whether any call fell over. */
+    provenance: LlmCallRecord[];
 }
 /**
  * Run the full project graph generation pipeline.
@@ -119,6 +122,12 @@ interface DomainPipelineResult {
     knowledgeResult?: KnowledgePipelineResult;
     hybridResult?: HybridPipelineResult;
     warnings: string[];
+    /** Present only when the AUTO-detected learning mode could not run and the router ran a weaker pipeline instead. An explicit forcedLearningMode request fails closed instead of downgrading. */
+    modeDowngrade?: {
+        from: GraphType;
+        to: GraphType;
+        reason: string;
+    };
 }
 /**
  * Route and execute the appropriate domain pipeline based on input context.

package/dist/pipeline/index.mjs

@@ -1,12 +1,15 @@
-export { runDomainPipeline, runHybridGraphPipeline, runKnowledgeGraphPipeline, runProjectGraphPipeline } from '../chunk-G7HLFMD2.mjs';
-import '../chunk-TWKIVUTQ.mjs';
-import '../chunk-E4GCCWJO.mjs';
-import '../chunk-DRVOV5ZD.mjs';
-import '../chunk-XMHKWHVK.mjs';
-import '../chunk-BL5NBKPH.mjs';
-import '../chunk-TYXSJUQU.mjs';
-import '../chunk-T4Y2DE2W.mjs';
+export { runDomainPipeline, runHybridGraphPipeline, runKnowledgeGraphPipeline, runProjectGraphPipeline } from '../chunk-KHCZYLKM.mjs';
 import '../chunk-KNDBODUQ.mjs';
 import '../chunk-ONQHJ4OH.mjs';
+import '../chunk-WKTH3JPA.mjs';
+import '../chunk-CGNXGVHV.mjs';
+import '../chunk-DSEJLTUO.mjs';
+import '../chunk-XMHKWHVK.mjs';
+import '../chunk-WD3P5V3B.mjs';
+import '../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/schemas/index.cjs

@@ -477,9 +477,27 @@ var HybridGraphSchema = zod.z.object({
   phases: zod.z.array(DevelopmentPhaseSchema).optional().default([]),
   // Metadata
   description: zod.z.string().optional().default(""),
+  // ── Minute totals (HG-1, 2026-10-05) ────────────────────────────────────
+  // These three used to sit side by side with near-identical names and NO
+  // documentation. Two measured DIFFERENT quantities, which is why the field
+  // below was renamed: it does not measure "the total". Read before trusting
+  // any of them.
+  /** Minutes of PRODUCT work: sum over every feature step. */
   total_project_minutes: zod.z.number().optional().default(0),
+  /** Minutes of CONCEPT work: sum over EVERY concept in the graph. */
   total_concept_minutes: zod.z.number().optional().default(0),
-  estimated_total_minutes: zod.z.number().optional().default(0)
+  /**
+   * 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: zod.z.number().optional().default(0)
 });
 var InputTypeSchema = zod.z.enum([
   "repository",
@@ -535,6 +553,11 @@ var DetectionConfidenceSchema = zod.z.object({
   domainCategory: zod.z.number().min(0).max(1).optional().default(0.5),
   learningMode: zod.z.number().min(0).max(1).optional().default(0.5)
 });
+var AmbiguousDomainSchema = zod.z.object({
+  domain1: DomainCategorySchema,
+  domain2: DomainCategorySchema,
+  reason: zod.z.string()
+});
 var DomainProfileSchema = zod.z.object({
   // Detection results
   inputType: InputTypeSchema,
@@ -543,6 +566,8 @@ var DomainProfileSchema = zod.z.object({
   graphType: GraphTypeSchema,
   // Confidence scores
   confidence: DetectionConfidenceSchema.optional(),
+  // Ambiguity flag when detection is borderline or context-conflicted
+  ambiguous: AmbiguousDomainSchema.optional(),
   // Evidence for detection decisions
   evidence: zod.z.array(zod.z.string()).optional().default([]),
   // Detected metadata (optional, populated during detection)
@@ -606,6 +631,14 @@ var FeedNodeSchema = zod.z.object({
     reason: zod.z.string().default("")
   })).optional(),
   is_core: zod.z.boolean().default(false),
+  /**
+   * Prerequisite concept ids this node needs that NO node in this feed provides —
+   * i.e. the learner must already know them before starting. Previously these were
+   * silently dropped (knowledge path) or crashed emission (both hybrid paths), so a
+   * course silently lost its entry requirements. Kept on the node so the mapping
+   * "concept X needs prior knowledge Y" survives; a course-level roll-up is derivable.
+   */
+  external_prerequisites: zod.z.array(zod.z.string()).default([]),
   // Depth layer text (optional, additive — old feeds validate unchanged).
   // Carries the ULO/CIO/SIO authored text from the KnowledgeGraph concept
   // so downstream consumers (KX generator) can inject depth-appropriate
@@ -641,12 +674,28 @@ var FeedPhaseSchema = zod.z.object({
   product_completion: zod.z.string().min(1),
   node_ids: zod.z.array(zod.z.string()).min(1)
 });
+var FeedDiagnosticSchema = zod.z.object({
+  code: zod.z.string().min(1),
+  severity: zod.z.enum(["info", "warning", "error"]),
+  message: zod.z.string(),
+  node_ids: zod.z.array(zod.z.string()).default([])
+});
+var FeedProvenanceSchema = zod.z.object({
+  providers: zod.z.array(zod.z.string()).default([]),
+  models: zod.z.array(zod.z.string()).default([]),
+  calls: zod.z.number().int().nonnegative().default(0),
+  failed_calls: zod.z.number().int().nonnegative().default(0),
+  degraded: zod.z.boolean().default(false)
+});
 var CurriculumFeedSchema = zod.z.object({
   schema_version: zod.z.literal(2),
   source: zod.z.object({
     graph_type: zod.z.enum(["project_graph", "knowledge_graph", "hybrid_graph"]),
+    /** DERIVED from diagnostics — do not write to it directly. */
     warnings: zod.z.array(zod.z.string()).default([]),
-    hallucination_count: zod.z.number().int().nonnegative().default(0)
+    hallucination_count: zod.z.number().int().nonnegative().default(0),
+    diagnostics: zod.z.array(FeedDiagnosticSchema).default([]),
+    provenance: FeedProvenanceSchema.optional()
   }),
   learning_nodes: zod.z.array(FeedNodeSchema).min(1, "curriculum feed must contain at least one learning node"),
   dependency_edges: zod.z.array(FeedEdgeSchema).default([]),
@@ -679,6 +728,15 @@ function validateCurriculumFeed(feed) {
   }
   const phaseIds = parsed.phases.map((p) => p.id);
   if (new Set(phaseIds).size !== phaseIds.length) throw new Error("curriculum feed contains duplicate phase ids");
+  const phaseOrders = parsed.phases.map((p) => p.order);
+  if (new Set(phaseOrders).size !== phaseOrders.length) {
+    throw new Error("curriculum feed contains duplicate phase orders: " + phaseOrders.join(", "));
+  }
+  for (let i = 1; i < phaseOrders.length; i++) {
+    if (phaseOrders[i] <= phaseOrders[i - 1]) {
+      throw new Error("curriculum feed phase orders are not ascending: " + phaseOrders.join(", "));
+    }
+  }
   if (parsed.phases.length > 0) {
     const phaseIndexOf = /* @__PURE__ */ new Map();
     parsed.phases.forEach((p, i) => {
@@ -698,6 +756,7 @@ function validateCurriculumFeed(feed) {
   return parsed;
 }
 
+exports.AmbiguousDomainSchema = AmbiguousDomainSchema;
 exports.ArchEdgeSchema = ArchEdgeSchema;
 exports.ArchNodeSchema = ArchNodeSchema;
 exports.ArchitectureDetailSchema = ArchitectureDetailSchema;
@@ -717,11 +776,13 @@ exports.ExperienceComponentSchema = ExperienceComponentSchema;
 exports.ExperienceSchema = ExperienceSchema;
 exports.ExperimentProcedureSchema = ExperimentProcedureSchema;
 exports.FeatureSchema = FeatureSchema;
+exports.FeedDiagnosticSchema = FeedDiagnosticSchema;
 exports.FeedEdgeSchema = FeedEdgeSchema;
 exports.FeedGroupingSchema = FeedGroupingSchema;
 exports.FeedKeywordsSchema = FeedKeywordsSchema;
 exports.FeedNodeSchema = FeedNodeSchema;
 exports.FeedPhaseSchema = FeedPhaseSchema;
+exports.FeedProvenanceSchema = FeedProvenanceSchema;
 exports.FeedScaffoldCandidateSchema = FeedScaffoldCandidateSchema;
 exports.GrammarRuleSchema = GrammarRuleSchema;
 exports.GraphTypeSchema = GraphTypeSchema;