@thanh01.pmt/domain-kit 0.1.0 → 0.2.0

package/dist/graph/index.d.cts

@@ -1,11 +1,12 @@
 import { L as LlmClientConfig } from '../llmClient-ysPhLjcH.cjs';
-import { d as Feature, c as Step, u as ProjectGraph } from '../projectGraphSchema-DnD7orZV.cjs';
-import { K as Keyword } from '../keywordExtractor-zPAz2isq.cjs';
-export { H as Hallucination, V as VerifyOptions, v as verifyProjectGraph } from '../graphVerifier-QjgDAJce.cjs';
+import { d as Feature, c as Step } from '../projectGraphSchema-DnD7orZV.cjs';
+import { K as Keyword } from '../keywordExtractor-BxlGRMHC.cjs';
+export { H as Hallucination, i as HybridGraphPipelineOptions, j as HybridGraphPipelineResult, K as KnowledgeGraphPipelineOptions, a as KnowledgeGraphPipelineResult, f as KnowledgeGraphVerificationReport, V as VerifyOptions, e as auditSyllabusCoverage, c as breakPrerequisiteCycles, d as detectPrerequisiteCycles, h as generateHybridGraph, g as generateKnowledgeGraph, b as verifyKnowledgeGraph, v as verifyProjectGraph } from '../hybridGraphPipeline-DmWRKYXf.cjs';
 export { C as ConceptMapping, E as EscalateOptions, e as escalateAndMapConcepts } from '../conceptEscalator-ltRLtPhf.cjs';
-import { g as KnowledgeGraph, j as HybridGraph } from '../hybridGraphSchema-BCgXicgA.cjs';
 import 'zod';
-import '../parsers/index.cjs';
+import '../cpp-CZUPqJt9.cjs';
+import '../hybridGraphSchema-BCgXicgA.cjs';
+import '../syllabusParser-MSX1fEzW.cjs';
 
 /**
  * STEP C0: Extract FOUNDATION & SETUP feature (F0) via LLM.
@@ -92,43 +93,6 @@ declare function extractFeatureStepsBatched(goal: string, techStack: string, sdk
     }>;
 }, fileContentsMap: Map<string, string>, featuresMeta: Feature[], llmConfig?: LlmClientConfig): Promise<Map<string, Step[]>>;
 
-/**
- * Knowledge Graph Pipeline — generates knowledge_graph for concept-driven learning.
- *
- * Input: syllabus text, subject description, grade band
- * Output: KnowledgeGraph with concepts, problem_types, prerequisites, learning_path
- *
- * Includes:
- *   - Cycle detection in prerequisite chains
- *   - Topological sort for learning_path
- *   - Multi-language syllabus support
- *   - ULO/CIO/SIO depth control per concept
- */
-
-interface KnowledgeGraphPipelineOptions {
-    subject: string;
-    description?: string;
-    syllabusText?: string;
-    gradeBand?: [number, number];
-    domain?: string;
-    /** Target technology for SIO keyword binding (e.g. "python", "swift"); auto-detected fallback applies. */
-    techStack?: string;
-    llmConfig?: LlmClientConfig;
-    onProgress?: (step: string, message: string) => void;
-    /** Path to mlo-knowlege-tree.tsv. When provided, STEP_2_5 standardizes every concept against the tree (fail-closed). */
-    knowledgeTreePath?: string;
-    /** Where to persist proposed-new concepts for the later merge. Default: tmpdir/domain-kit-debug/concept-proposals.json */
-    proposalsPath?: string;
-}
-interface KnowledgeGraphPipelineResult {
-    knowledgeGraph: KnowledgeGraph;
-    warnings: string[];
-}
-/**
- * Generate a KnowledgeGraph from syllabus/description via LLM.
- */
-declare function generateKnowledgeGraph(options: KnowledgeGraphPipelineOptions): Promise<KnowledgeGraphPipelineResult>;
-
 interface DepthLayerAudit {
     conceptId: string;
     uloHasTechSignals: boolean;
@@ -199,28 +163,4 @@ declare const ULO_CODE_RE: RegExp;
 declare const CIO_CODE_RE: RegExp;
 declare const SIO_CODE_RE: RegExp;
 
-/**
- * Hybrid Graph Pipeline - generates hybrid_graph combining project + knowledge.
- *
- * STEP_1 generates feature-concept links. STEP_2 decomposes the build into
- * PROGRESSIVE COMPLETION PHASES (cross-feature): each phase describes what the
- * product can demonstrably do once complete, owns every feature built in it
- * (each feature in EXACTLY one phase), and declares which concepts are
- * introduced (new) or revisited at higher depth (advanced) at the phase start.
- * Later phases depend on earlier ones and may only raise the knowledge level -
- * verified against the concept prerequisite graph (fail-closed).
- */
-
-interface HybridGraphPipelineOptions {
-    projectGraph: ProjectGraph;
-    knowledgeGraph: KnowledgeGraph;
-    llmConfig?: LlmClientConfig;
-    onProgress?: (step: string, message: string) => void;
-}
-interface HybridGraphPipelineResult {
-    hybridGraph: HybridGraph;
-    warnings: string[];
-}
-declare function generateHybridGraph(options: HybridGraphPipelineOptions): Promise<HybridGraphPipelineResult>;
-
-export { CIO_CODE_RE, CONCEPT_CODE_RE, type DepthLayerAudit, type ExtractOverviewOptions, type ExtractScaffoldOptions, type ExtractStepsOptions, type HybridGraphPipelineOptions, type HybridGraphPipelineResult, type KnowledgeGraphPipelineOptions, type KnowledgeGraphPipelineResult, LEARNER_CLAUSE, SIO_CODE_RE, ULO_CODE_RE, assignConceptCodes, auditDepthLayers, cioActionSlug, cioCode, conceptCodeFromName, extractFeatureSteps, extractFeatureStepsBatched, extractProjectOverview, extractScaffold, generateHybridGraph, generateKnowledgeGraph, sioCode, standardStatement, techTagFor, uloCode };
+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 };

package/dist/graph/index.d.ts

@@ -1,11 +1,12 @@
 import { L as LlmClientConfig } from '../llmClient-ysPhLjcH.js';
-import { d as Feature, c as Step, u as ProjectGraph } from '../projectGraphSchema-DnD7orZV.js';
-import { K as Keyword } from '../keywordExtractor-CKaXqSku.js';
-export { H as Hallucination, V as VerifyOptions, v as verifyProjectGraph } from '../graphVerifier-DsTP9uAN.js';
+import { d as Feature, c as Step } from '../projectGraphSchema-DnD7orZV.js';
+import { K as Keyword } from '../keywordExtractor-DU5XRN8-.js';
+export { H as Hallucination, i as HybridGraphPipelineOptions, j as HybridGraphPipelineResult, K as KnowledgeGraphPipelineOptions, a as KnowledgeGraphPipelineResult, f as KnowledgeGraphVerificationReport, V as VerifyOptions, e as auditSyllabusCoverage, c as breakPrerequisiteCycles, d as detectPrerequisiteCycles, h as generateHybridGraph, g as generateKnowledgeGraph, b as verifyKnowledgeGraph, v as verifyProjectGraph } from '../hybridGraphPipeline-DVZYLCAQ.js';
 export { C as ConceptMapping, E as EscalateOptions, e as escalateAndMapConcepts } from '../conceptEscalator-YfMKIKCZ.js';
-import { g as KnowledgeGraph, j as HybridGraph } from '../hybridGraphSchema-BCgXicgA.js';
 import 'zod';
-import '../parsers/index.js';
+import '../cpp-CZUPqJt9.js';
+import '../hybridGraphSchema-BCgXicgA.js';
+import '../syllabusParser-MSX1fEzW.js';
 
 /**
  * STEP C0: Extract FOUNDATION & SETUP feature (F0) via LLM.
@@ -92,43 +93,6 @@ declare function extractFeatureStepsBatched(goal: string, techStack: string, sdk
     }>;
 }, fileContentsMap: Map<string, string>, featuresMeta: Feature[], llmConfig?: LlmClientConfig): Promise<Map<string, Step[]>>;
 
-/**
- * Knowledge Graph Pipeline — generates knowledge_graph for concept-driven learning.
- *
- * Input: syllabus text, subject description, grade band
- * Output: KnowledgeGraph with concepts, problem_types, prerequisites, learning_path
- *
- * Includes:
- *   - Cycle detection in prerequisite chains
- *   - Topological sort for learning_path
- *   - Multi-language syllabus support
- *   - ULO/CIO/SIO depth control per concept
- */
-
-interface KnowledgeGraphPipelineOptions {
-    subject: string;
-    description?: string;
-    syllabusText?: string;
-    gradeBand?: [number, number];
-    domain?: string;
-    /** Target technology for SIO keyword binding (e.g. "python", "swift"); auto-detected fallback applies. */
-    techStack?: string;
-    llmConfig?: LlmClientConfig;
-    onProgress?: (step: string, message: string) => void;
-    /** Path to mlo-knowlege-tree.tsv. When provided, STEP_2_5 standardizes every concept against the tree (fail-closed). */
-    knowledgeTreePath?: string;
-    /** Where to persist proposed-new concepts for the later merge. Default: tmpdir/domain-kit-debug/concept-proposals.json */
-    proposalsPath?: string;
-}
-interface KnowledgeGraphPipelineResult {
-    knowledgeGraph: KnowledgeGraph;
-    warnings: string[];
-}
-/**
- * Generate a KnowledgeGraph from syllabus/description via LLM.
- */
-declare function generateKnowledgeGraph(options: KnowledgeGraphPipelineOptions): Promise<KnowledgeGraphPipelineResult>;
-
 interface DepthLayerAudit {
     conceptId: string;
     uloHasTechSignals: boolean;
@@ -199,28 +163,4 @@ declare const ULO_CODE_RE: RegExp;
 declare const CIO_CODE_RE: RegExp;
 declare const SIO_CODE_RE: RegExp;
 
-/**
- * Hybrid Graph Pipeline - generates hybrid_graph combining project + knowledge.
- *
- * STEP_1 generates feature-concept links. STEP_2 decomposes the build into
- * PROGRESSIVE COMPLETION PHASES (cross-feature): each phase describes what the
- * product can demonstrably do once complete, owns every feature built in it
- * (each feature in EXACTLY one phase), and declares which concepts are
- * introduced (new) or revisited at higher depth (advanced) at the phase start.
- * Later phases depend on earlier ones and may only raise the knowledge level -
- * verified against the concept prerequisite graph (fail-closed).
- */
-
-interface HybridGraphPipelineOptions {
-    projectGraph: ProjectGraph;
-    knowledgeGraph: KnowledgeGraph;
-    llmConfig?: LlmClientConfig;
-    onProgress?: (step: string, message: string) => void;
-}
-interface HybridGraphPipelineResult {
-    hybridGraph: HybridGraph;
-    warnings: string[];
-}
-declare function generateHybridGraph(options: HybridGraphPipelineOptions): Promise<HybridGraphPipelineResult>;
-
-export { CIO_CODE_RE, CONCEPT_CODE_RE, type DepthLayerAudit, type ExtractOverviewOptions, type ExtractScaffoldOptions, type ExtractStepsOptions, type HybridGraphPipelineOptions, type HybridGraphPipelineResult, type KnowledgeGraphPipelineOptions, type KnowledgeGraphPipelineResult, LEARNER_CLAUSE, SIO_CODE_RE, ULO_CODE_RE, assignConceptCodes, auditDepthLayers, cioActionSlug, cioCode, conceptCodeFromName, extractFeatureSteps, extractFeatureStepsBatched, extractProjectOverview, extractScaffold, generateHybridGraph, generateKnowledgeGraph, sioCode, standardStatement, techTagFor, uloCode };
+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 };

package/dist/graph/index.mjs

@@ -1,4 +1,5 @@
-export { CIO_CODE_RE, CONCEPT_CODE_RE, LEARNER_CLAUSE, SIO_CODE_RE, ULO_CODE_RE, assignConceptCodes, auditDepthLayers, cioActionSlug, cioCode, conceptCodeFromName, generateHybridGraph, generateKnowledgeGraph, sioCode, standardStatement, techTagFor, uloCode } from '../chunk-3VVPSRAM.mjs';
-export { escalateAndMapConcepts, extractFeatureSteps, extractFeatureStepsBatched, extractProjectOverview, extractScaffold, verifyProjectGraph } from '../chunk-MOKNFLUD.mjs';
+import '../chunk-ZKLT27T4.mjs';
+export { CIO_CODE_RE, CONCEPT_CODE_RE, LEARNER_CLAUSE, SIO_CODE_RE, ULO_CODE_RE, assignConceptCodes, auditDepthLayers, auditSyllabusCoverage, breakPrerequisiteCycles, cioActionSlug, cioCode, conceptCodeFromName, detectPrerequisiteCycles, escalateAndMapConcepts, extractFeatureSteps, extractFeatureStepsBatched, extractProjectOverview, extractScaffold, generateHybridGraph, generateKnowledgeGraph, sioCode, standardStatement, techTagFor, uloCode, verifyKnowledgeGraph, verifyProjectGraph } from '../chunk-JE57VFWX.mjs';
+import '../chunk-T4Y2DE2W.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/hybridGraphPipeline-DVZYLCAQ.d.ts

@@ -0,0 +1,159 @@
+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 } from './hybridGraphSchema-BCgXicgA.js';
+import { P as ParsedSyllabus } from './syllabusParser-MSX1fEzW.js';
+
+/**
+ * STEP D: Ground-truth verification of project graph against code and SDK API index.
+ *
+ * Ported from knowledge-tree/llm_project_graph.py verify_project_graph()
+ * Removes invalid files, APIs, keywords and logs hallucinations.
+ */
+
+interface Hallucination {
+    type: string;
+    item: string;
+    feature_id: string;
+    step_id: string;
+    reason: string;
+}
+interface VerifyOptions {
+    repoDir: string;
+    sdkApiIndex: {
+        sdk_apis: Array<{
+            name: string;
+            kind: string;
+            used_in_demo: boolean;
+        }>;
+    };
+    fileContentsMap: Map<string, string>;
+}
+/**
+ * Verify project graph against actual code. Remove hallucinated files, APIs, keywords.
+ * F0 (foundation) keywords are kept as-is since they are pedagogical terms.
+ */
+declare function verifyProjectGraph(projectGraph: ProjectGraph, options: VerifyOptions): {
+    graph: ProjectGraph;
+    hallucinations: Hallucination[];
+};
+
+/**
+ * Knowledge Graph Verifier — validates referential integrity, prerequisite DAG
+ * acyclicity, and reverse syllabus coverage for concept-driven graphs.
+ */
+
+interface KnowledgeGraphVerificationReport {
+    valid: boolean;
+    cycles: string[][];
+    removedEdges: Array<{
+        from: string;
+        to: string;
+    }>;
+    danglingPrerequisites: Array<{
+        conceptId: string;
+        missingPrereqId: string;
+    }>;
+    coverageRatio: number;
+    totalSyllabusTopics: number;
+    coveredSyllabusTopics: number;
+    uncoveredTopics: string[];
+    warnings: string[];
+}
+/**
+ * Detect cycles in prerequisite graph using DFS.
+ */
+declare function detectPrerequisiteCycles(concepts: Concept[]): string[][];
+/**
+ * Break cycles by removing back-edges.
+ */
+declare function breakPrerequisiteCycles(concepts: Concept[], cycles: string[][]): {
+    fixed: Concept[];
+    removed: Array<{
+        from: string;
+        to: string;
+    }>;
+};
+/**
+ * Audit reverse coverage: verify that every topic in ParsedSyllabus is mapped
+ * to at least one concept in KnowledgeGraph.
+ */
+declare function auditSyllabusCoverage(concepts: Concept[], syllabus?: ParsedSyllabus): {
+    coverageRatio: number;
+    totalTopics: number;
+    coveredTopics: number;
+    uncovered: string[];
+};
+/**
+ * Full knowledge graph verifier function.
+ */
+declare function verifyKnowledgeGraph(kg: KnowledgeGraph, syllabusOrOptions?: ParsedSyllabus | {
+    parsedSyllabus?: ParsedSyllabus;
+}): {
+    verifiedGraph: KnowledgeGraph;
+    report: KnowledgeGraphVerificationReport;
+};
+
+/**
+ * Knowledge Graph Pipeline — generates knowledge_graph for concept-driven learning.
+ *
+ * Input: syllabus text, subject description, grade band
+ * Output: KnowledgeGraph with concepts, problem_types, prerequisites, learning_path
+ *
+ * Includes:
+ *   - Cycle detection in prerequisite chains
+ *   - Topological sort for learning_path
+ *   - Multi-language syllabus support
+ *   - ULO/CIO/SIO depth control per concept
+ */
+
+interface KnowledgeGraphPipelineOptions {
+    subject: string;
+    description?: string;
+    syllabusText?: string;
+    parsedSyllabus?: ParsedSyllabus;
+    gradeBand?: [number, number];
+    domain?: string;
+    /** Target technology for SIO keyword binding (e.g. "python", "swift"); auto-detected fallback applies. */
+    techStack?: string;
+    llmConfig?: LlmClientConfig;
+    onProgress?: (step: string, message: string) => void;
+    /** Path to mlo-knowlege-tree.tsv. When provided, STEP_2_5 standardizes every concept against the tree (fail-closed). */
+    knowledgeTreePath?: string;
+    /** Where to persist proposed-new concepts for the later merge. Default: tmpdir/domain-kit-debug/concept-proposals.json */
+    proposalsPath?: string;
+}
+interface KnowledgeGraphPipelineResult {
+    knowledgeGraph: KnowledgeGraph;
+    warnings: string[];
+    verificationReport?: KnowledgeGraphVerificationReport;
+}
+/**
+ * Generate a KnowledgeGraph from syllabus/description via LLM.
+ */
+declare function generateKnowledgeGraph(options: KnowledgeGraphPipelineOptions): Promise<KnowledgeGraphPipelineResult>;
+
+/**
+ * Hybrid Graph Pipeline - generates hybrid_graph combining project + knowledge.
+ *
+ * STEP_1 generates feature-concept links. STEP_2 decomposes the build into
+ * PROGRESSIVE COMPLETION PHASES (cross-feature): each phase describes what the
+ * product can demonstrably do once complete, owns every feature built in it
+ * (each feature in EXACTLY one phase), and declares which concepts are
+ * introduced (new) or revisited at higher depth (advanced) at the phase start.
+ * Later phases depend on earlier ones and may only raise the knowledge level -
+ * verified against the concept prerequisite graph (fail-closed).
+ */
+
+interface HybridGraphPipelineOptions {
+    projectGraph: ProjectGraph;
+    knowledgeGraph: KnowledgeGraph;
+    llmConfig?: LlmClientConfig;
+    onProgress?: (step: string, message: string) => void;
+}
+interface HybridGraphPipelineResult {
+    hybridGraph: HybridGraph;
+    warnings: string[];
+}
+declare function generateHybridGraph(options: HybridGraphPipelineOptions): Promise<HybridGraphPipelineResult>;
+
+export { type Hallucination as H, type KnowledgeGraphPipelineOptions as K, type VerifyOptions as V, type KnowledgeGraphPipelineResult as a, verifyKnowledgeGraph as b, breakPrerequisiteCycles as c, detectPrerequisiteCycles as d, auditSyllabusCoverage as e, type KnowledgeGraphVerificationReport as f, generateKnowledgeGraph as g, generateHybridGraph as h, type HybridGraphPipelineOptions as i, type HybridGraphPipelineResult as j, verifyProjectGraph as v };

package/dist/hybridGraphPipeline-DmWRKYXf.d.cts

@@ -0,0 +1,159 @@
+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 } from './hybridGraphSchema-BCgXicgA.cjs';
+import { P as ParsedSyllabus } from './syllabusParser-MSX1fEzW.cjs';
+
+/**
+ * STEP D: Ground-truth verification of project graph against code and SDK API index.
+ *
+ * Ported from knowledge-tree/llm_project_graph.py verify_project_graph()
+ * Removes invalid files, APIs, keywords and logs hallucinations.
+ */
+
+interface Hallucination {
+    type: string;
+    item: string;
+    feature_id: string;
+    step_id: string;
+    reason: string;
+}
+interface VerifyOptions {
+    repoDir: string;
+    sdkApiIndex: {
+        sdk_apis: Array<{
+            name: string;
+            kind: string;
+            used_in_demo: boolean;
+        }>;
+    };
+    fileContentsMap: Map<string, string>;
+}
+/**
+ * Verify project graph against actual code. Remove hallucinated files, APIs, keywords.
+ * F0 (foundation) keywords are kept as-is since they are pedagogical terms.
+ */
+declare function verifyProjectGraph(projectGraph: ProjectGraph, options: VerifyOptions): {
+    graph: ProjectGraph;
+    hallucinations: Hallucination[];
+};
+
+/**
+ * Knowledge Graph Verifier — validates referential integrity, prerequisite DAG
+ * acyclicity, and reverse syllabus coverage for concept-driven graphs.
+ */
+
+interface KnowledgeGraphVerificationReport {
+    valid: boolean;
+    cycles: string[][];
+    removedEdges: Array<{
+        from: string;
+        to: string;
+    }>;
+    danglingPrerequisites: Array<{
+        conceptId: string;
+        missingPrereqId: string;
+    }>;
+    coverageRatio: number;
+    totalSyllabusTopics: number;
+    coveredSyllabusTopics: number;
+    uncoveredTopics: string[];
+    warnings: string[];
+}
+/**
+ * Detect cycles in prerequisite graph using DFS.
+ */
+declare function detectPrerequisiteCycles(concepts: Concept[]): string[][];
+/**
+ * Break cycles by removing back-edges.
+ */
+declare function breakPrerequisiteCycles(concepts: Concept[], cycles: string[][]): {
+    fixed: Concept[];
+    removed: Array<{
+        from: string;
+        to: string;
+    }>;
+};
+/**
+ * Audit reverse coverage: verify that every topic in ParsedSyllabus is mapped
+ * to at least one concept in KnowledgeGraph.
+ */
+declare function auditSyllabusCoverage(concepts: Concept[], syllabus?: ParsedSyllabus): {
+    coverageRatio: number;
+    totalTopics: number;
+    coveredTopics: number;
+    uncovered: string[];
+};
+/**
+ * Full knowledge graph verifier function.
+ */
+declare function verifyKnowledgeGraph(kg: KnowledgeGraph, syllabusOrOptions?: ParsedSyllabus | {
+    parsedSyllabus?: ParsedSyllabus;
+}): {
+    verifiedGraph: KnowledgeGraph;
+    report: KnowledgeGraphVerificationReport;
+};
+
+/**
+ * Knowledge Graph Pipeline — generates knowledge_graph for concept-driven learning.
+ *
+ * Input: syllabus text, subject description, grade band
+ * Output: KnowledgeGraph with concepts, problem_types, prerequisites, learning_path
+ *
+ * Includes:
+ *   - Cycle detection in prerequisite chains
+ *   - Topological sort for learning_path
+ *   - Multi-language syllabus support
+ *   - ULO/CIO/SIO depth control per concept
+ */
+
+interface KnowledgeGraphPipelineOptions {
+    subject: string;
+    description?: string;
+    syllabusText?: string;
+    parsedSyllabus?: ParsedSyllabus;
+    gradeBand?: [number, number];
+    domain?: string;
+    /** Target technology for SIO keyword binding (e.g. "python", "swift"); auto-detected fallback applies. */
+    techStack?: string;
+    llmConfig?: LlmClientConfig;
+    onProgress?: (step: string, message: string) => void;
+    /** Path to mlo-knowlege-tree.tsv. When provided, STEP_2_5 standardizes every concept against the tree (fail-closed). */
+    knowledgeTreePath?: string;
+    /** Where to persist proposed-new concepts for the later merge. Default: tmpdir/domain-kit-debug/concept-proposals.json */
+    proposalsPath?: string;
+}
+interface KnowledgeGraphPipelineResult {
+    knowledgeGraph: KnowledgeGraph;
+    warnings: string[];
+    verificationReport?: KnowledgeGraphVerificationReport;
+}
+/**
+ * Generate a KnowledgeGraph from syllabus/description via LLM.
+ */
+declare function generateKnowledgeGraph(options: KnowledgeGraphPipelineOptions): Promise<KnowledgeGraphPipelineResult>;
+
+/**
+ * Hybrid Graph Pipeline - generates hybrid_graph combining project + knowledge.
+ *
+ * STEP_1 generates feature-concept links. STEP_2 decomposes the build into
+ * PROGRESSIVE COMPLETION PHASES (cross-feature): each phase describes what the
+ * product can demonstrably do once complete, owns every feature built in it
+ * (each feature in EXACTLY one phase), and declares which concepts are
+ * introduced (new) or revisited at higher depth (advanced) at the phase start.
+ * Later phases depend on earlier ones and may only raise the knowledge level -
+ * verified against the concept prerequisite graph (fail-closed).
+ */
+
+interface HybridGraphPipelineOptions {
+    projectGraph: ProjectGraph;
+    knowledgeGraph: KnowledgeGraph;
+    llmConfig?: LlmClientConfig;
+    onProgress?: (step: string, message: string) => void;
+}
+interface HybridGraphPipelineResult {
+    hybridGraph: HybridGraph;
+    warnings: string[];
+}
+declare function generateHybridGraph(options: HybridGraphPipelineOptions): Promise<HybridGraphPipelineResult>;
+
+export { type Hallucination as H, type KnowledgeGraphPipelineOptions as K, type VerifyOptions as V, type KnowledgeGraphPipelineResult as a, verifyKnowledgeGraph as b, breakPrerequisiteCycles as c, detectPrerequisiteCycles as d, auditSyllabusCoverage as e, type KnowledgeGraphVerificationReport as f, generateKnowledgeGraph as g, generateHybridGraph as h, type HybridGraphPipelineOptions as i, type HybridGraphPipelineResult as j, verifyProjectGraph as v };