@harness-engineering/core 0.6.0 → 0.7.0

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Result, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext } from '@harness-engineering/types';
+import { Result, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport } from '@harness-engineering/types';
 export * from '@harness-engineering/types';
 import { z } from 'zod';
 
@@ -2251,6 +2251,14 @@ type TurnExecutor = (context: TurnContext) => Promise<{
 declare function runPipeline(initialContext: SkillContext, executor: SkillExecutor, options?: PipelineOptions): Promise<PipelineResult>;
 declare function runMultiTurnPipeline(initialContext: SkillContext, turnExecutor: TurnExecutor, options?: PipelineOptions): Promise<PipelineResult>;
 
+interface RunCIChecksInput {
+    projectRoot: string;
+    config: Record<string, unknown>;
+    skip?: CICheckName[];
+    failOn?: CIFailOnSeverity;
+}
+declare function runCIChecks(input: RunCIChecksInput): Promise<Result<CICheckReport, Error>>;
+
 /**
  * @harness-engineering/core
  *
@@ -2259,4 +2267,4 @@ declare function runMultiTurnPipeline(initialContext: SkillContext, turnExecutor
 
 declare const VERSION = "0.6.0";
 
-export { type AST, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AgentAction, AgentActionEmitter, type AgentConfig, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentType, type AgentsMapConfig, type BaseError, type BoundaryDefinition, type BoundaryValidation, type BoundaryValidator, type BoundaryViolation, type BrokenLink, type ChangedFile, ChecklistBuilder, type CircularDependency, type CircularDepsResult, type CodeBlock, type CodeChanges, type CodePattern, type CodeReference, type CodebaseSnapshot, type CommitFormat, type CommitValidation, type ConfigError, type ConfigPattern, ConsoleSink, type ConstraintError, type ContextError, type ContextFilterResult, type Convention, type CoverageOptions, type CoverageReport, type CustomRule, type CustomRuleResult, DEFAULT_STATE, type DeadCodeConfig, type DeadCodeReport, type DeadExport, type DeadFile, type DeadInternal, type DependencyEdge, type DependencyGraph, type DependencyValidation, type DependencyViolation, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, EntropyAnalyzer, type EntropyConfig, EntropyConfigSchema, type EntropyError, type EntropyReport, type ExecutorHealth, type Export, type ExportMap, type FailureEntry, FailureEntrySchema, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, FileSink, type Fix, type FixConfig, type FixResult, type FixType, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, type GenerationSection, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type Import, type InlineReference, type IntegrityReport, type InternalSymbol, type JSDocComment, type LanguageParser, type Layer, type LayerConfig, type LogEntry, type LogFilter, type Metric, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, type ParseError, type PatternConfig, PatternConfigSchema, type PatternMatch, type PatternReport, type PatternViolation, type PeerReview, type PeerReviewOptions, type PipelineOptions, type PipelineResult, REQUIRED_SECTIONS, type ReachabilityNode, type ReviewChecklist, type ReviewComment, type ReviewContext, type ReviewItem, type SelfReviewConfig, type SkillExecutor, type SourceFile, type Span, type SpanEvent, type StepExecutor, type StructureValidation, type Suggestion, type SuggestionReport, type TelemetryAdapter, type TelemetryHealth, type TimeRange, type TokenBudget, type TokenBudgetOverrides, type Trace, type TurnExecutor, TypeScriptParser, type UnusedImport, VERSION, type ValidationError, type WorkflowPhase, analyzeDiff, appendFailure, appendLearning, applyFixes, archiveFailures, buildDependencyGraph, buildSnapshot, checkDocCoverage, configureFeedback, contextBudget, contextFilter, createBoundaryValidator, createError, createFixes, createParseError, createSelfReview, defineLayer, detectCircularDeps, detectCircularDepsInFiles, detectDeadCode, detectDocDrift, detectPatternViolations, executeWorkflow, extractMarkdownLinks, extractSections, generateAgentsMap, generateSuggestions, getActionEmitter, getFeedbackConfig, getPhaseCategories, loadFailures, loadHandoff, loadRelevantLearnings, loadState, logAgentAction, parseDiff, previewFix, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resolveFileToLayer, runMechanicalGate, runMultiTurnPipeline, runPipeline, saveHandoff, saveState, trackAction, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateKnowledgeMap, validatePatternConfig };
+export { type AST, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AgentAction, AgentActionEmitter, type AgentConfig, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentType, type AgentsMapConfig, type BaseError, type BoundaryDefinition, type BoundaryValidation, type BoundaryValidator, type BoundaryViolation, type BrokenLink, type ChangedFile, ChecklistBuilder, type CircularDependency, type CircularDepsResult, type CodeBlock, type CodeChanges, type CodePattern, type CodeReference, type CodebaseSnapshot, type CommitFormat, type CommitValidation, type ConfigError, type ConfigPattern, ConsoleSink, type ConstraintError, type ContextError, type ContextFilterResult, type Convention, type CoverageOptions, type CoverageReport, type CustomRule, type CustomRuleResult, DEFAULT_STATE, type DeadCodeConfig, type DeadCodeReport, type DeadExport, type DeadFile, type DeadInternal, type DependencyEdge, type DependencyGraph, type DependencyValidation, type DependencyViolation, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, EntropyAnalyzer, type EntropyConfig, EntropyConfigSchema, type EntropyError, type EntropyReport, type ExecutorHealth, type Export, type ExportMap, type FailureEntry, FailureEntrySchema, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, FileSink, type Fix, type FixConfig, type FixResult, type FixType, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, type GenerationSection, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type Import, type InlineReference, type IntegrityReport, type InternalSymbol, type JSDocComment, type LanguageParser, type Layer, type LayerConfig, type LogEntry, type LogFilter, type Metric, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, type ParseError, type PatternConfig, PatternConfigSchema, type PatternMatch, type PatternReport, type PatternViolation, type PeerReview, type PeerReviewOptions, type PipelineOptions, type PipelineResult, REQUIRED_SECTIONS, type ReachabilityNode, type ReviewChecklist, type ReviewComment, type ReviewContext, type ReviewItem, type RunCIChecksInput, type SelfReviewConfig, type SkillExecutor, type SourceFile, type Span, type SpanEvent, type StepExecutor, type StructureValidation, type Suggestion, type SuggestionReport, type TelemetryAdapter, type TelemetryHealth, type TimeRange, type TokenBudget, type TokenBudgetOverrides, type Trace, type TurnExecutor, TypeScriptParser, type UnusedImport, VERSION, type ValidationError, type WorkflowPhase, analyzeDiff, appendFailure, appendLearning, applyFixes, archiveFailures, buildDependencyGraph, buildSnapshot, checkDocCoverage, configureFeedback, contextBudget, contextFilter, createBoundaryValidator, createError, createFixes, createParseError, createSelfReview, defineLayer, detectCircularDeps, detectCircularDepsInFiles, detectDeadCode, detectDocDrift, detectPatternViolations, executeWorkflow, extractMarkdownLinks, extractSections, generateAgentsMap, generateSuggestions, getActionEmitter, getFeedbackConfig, getPhaseCategories, loadFailures, loadHandoff, loadRelevantLearnings, loadState, logAgentAction, parseDiff, previewFix, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resolveFileToLayer, runCIChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, saveHandoff, saveState, trackAction, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateKnowledgeMap, validatePatternConfig };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Result, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext } from '@harness-engineering/types';
+import { Result, WorkflowStep, WorkflowStepResult, Workflow, WorkflowResult, SkillLifecycleHooks, SkillContext, SkillResult, TurnContext, CICheckName, CIFailOnSeverity, CICheckReport } from '@harness-engineering/types';
 export * from '@harness-engineering/types';
 import { z } from 'zod';
 
@@ -2251,6 +2251,14 @@ type TurnExecutor = (context: TurnContext) => Promise<{
 declare function runPipeline(initialContext: SkillContext, executor: SkillExecutor, options?: PipelineOptions): Promise<PipelineResult>;
 declare function runMultiTurnPipeline(initialContext: SkillContext, turnExecutor: TurnExecutor, options?: PipelineOptions): Promise<PipelineResult>;
 
+interface RunCIChecksInput {
+    projectRoot: string;
+    config: Record<string, unknown>;
+    skip?: CICheckName[];
+    failOn?: CIFailOnSeverity;
+}
+declare function runCIChecks(input: RunCIChecksInput): Promise<Result<CICheckReport, Error>>;
+
 /**
  * @harness-engineering/core
  *
@@ -2259,4 +2267,4 @@ declare function runMultiTurnPipeline(initialContext: SkillContext, turnExecutor
 
 declare const VERSION = "0.6.0";
 
-export { type AST, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AgentAction, AgentActionEmitter, type AgentConfig, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentType, type AgentsMapConfig, type BaseError, type BoundaryDefinition, type BoundaryValidation, type BoundaryValidator, type BoundaryViolation, type BrokenLink, type ChangedFile, ChecklistBuilder, type CircularDependency, type CircularDepsResult, type CodeBlock, type CodeChanges, type CodePattern, type CodeReference, type CodebaseSnapshot, type CommitFormat, type CommitValidation, type ConfigError, type ConfigPattern, ConsoleSink, type ConstraintError, type ContextError, type ContextFilterResult, type Convention, type CoverageOptions, type CoverageReport, type CustomRule, type CustomRuleResult, DEFAULT_STATE, type DeadCodeConfig, type DeadCodeReport, type DeadExport, type DeadFile, type DeadInternal, type DependencyEdge, type DependencyGraph, type DependencyValidation, type DependencyViolation, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, EntropyAnalyzer, type EntropyConfig, EntropyConfigSchema, type EntropyError, type EntropyReport, type ExecutorHealth, type Export, type ExportMap, type FailureEntry, FailureEntrySchema, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, FileSink, type Fix, type FixConfig, type FixResult, type FixType, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, type GenerationSection, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type Import, type InlineReference, type IntegrityReport, type InternalSymbol, type JSDocComment, type LanguageParser, type Layer, type LayerConfig, type LogEntry, type LogFilter, type Metric, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, type ParseError, type PatternConfig, PatternConfigSchema, type PatternMatch, type PatternReport, type PatternViolation, type PeerReview, type PeerReviewOptions, type PipelineOptions, type PipelineResult, REQUIRED_SECTIONS, type ReachabilityNode, type ReviewChecklist, type ReviewComment, type ReviewContext, type ReviewItem, type SelfReviewConfig, type SkillExecutor, type SourceFile, type Span, type SpanEvent, type StepExecutor, type StructureValidation, type Suggestion, type SuggestionReport, type TelemetryAdapter, type TelemetryHealth, type TimeRange, type TokenBudget, type TokenBudgetOverrides, type Trace, type TurnExecutor, TypeScriptParser, type UnusedImport, VERSION, type ValidationError, type WorkflowPhase, analyzeDiff, appendFailure, appendLearning, applyFixes, archiveFailures, buildDependencyGraph, buildSnapshot, checkDocCoverage, configureFeedback, contextBudget, contextFilter, createBoundaryValidator, createError, createFixes, createParseError, createSelfReview, defineLayer, detectCircularDeps, detectCircularDepsInFiles, detectDeadCode, detectDocDrift, detectPatternViolations, executeWorkflow, extractMarkdownLinks, extractSections, generateAgentsMap, generateSuggestions, getActionEmitter, getFeedbackConfig, getPhaseCategories, loadFailures, loadHandoff, loadRelevantLearnings, loadState, logAgentAction, parseDiff, previewFix, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resolveFileToLayer, runMechanicalGate, runMultiTurnPipeline, runPipeline, saveHandoff, saveState, trackAction, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateKnowledgeMap, validatePatternConfig };
+export { type AST, type ActionContext, type ActionEvent, type ActionEventHandler, type ActionEventType, type ActionResult, type ActionSink, type ActionTracker, type ActionType, type AgentAction, AgentActionEmitter, type AgentConfig, type AgentExecutor, type AgentMapLink, type AgentMapSection, type AgentMapValidation, type AgentProcess, type AgentType, type AgentsMapConfig, type BaseError, type BoundaryDefinition, type BoundaryValidation, type BoundaryValidator, type BoundaryViolation, type BrokenLink, type ChangedFile, ChecklistBuilder, type CircularDependency, type CircularDepsResult, type CodeBlock, type CodeChanges, type CodePattern, type CodeReference, type CodebaseSnapshot, type CommitFormat, type CommitValidation, type ConfigError, type ConfigPattern, ConsoleSink, type ConstraintError, type ContextError, type ContextFilterResult, type Convention, type CoverageOptions, type CoverageReport, type CustomRule, type CustomRuleResult, DEFAULT_STATE, type DeadCodeConfig, type DeadCodeReport, type DeadExport, type DeadFile, type DeadInternal, type DependencyEdge, type DependencyGraph, type DependencyValidation, type DependencyViolation, type DocumentationDrift, type DocumentationFile, type DocumentationGap, type DriftConfig, type DriftReport, EntropyAnalyzer, type EntropyConfig, EntropyConfigSchema, type EntropyError, type EntropyReport, type ExecutorHealth, type Export, type ExportMap, type FailureEntry, FailureEntrySchema, type FeedbackConfig, type FeedbackError$1 as FeedbackError, type FileCategory, FileSink, type Fix, type FixConfig, type FixResult, type FixType, type ForbiddenPattern, type GateConfig, GateConfigSchema, type GateResult, GateResultSchema, type GenerationSection, type Handoff, HandoffSchema, type HarnessState, HarnessStateSchema, type HealthCheckResult, type Import, type InlineReference, type IntegrityReport, type InternalSymbol, type JSDocComment, type LanguageParser, type Layer, type LayerConfig, type LogEntry, type LogFilter, type Metric, NoOpExecutor, NoOpSink, NoOpTelemetryAdapter, type ParseError, type PatternConfig, PatternConfigSchema, type PatternMatch, type PatternReport, type PatternViolation, type PeerReview, type PeerReviewOptions, type PipelineOptions, type PipelineResult, REQUIRED_SECTIONS, type ReachabilityNode, type ReviewChecklist, type ReviewComment, type ReviewContext, type ReviewItem, type RunCIChecksInput, type SelfReviewConfig, type SkillExecutor, type SourceFile, type Span, type SpanEvent, type StepExecutor, type StructureValidation, type Suggestion, type SuggestionReport, type TelemetryAdapter, type TelemetryHealth, type TimeRange, type TokenBudget, type TokenBudgetOverrides, type Trace, type TurnExecutor, TypeScriptParser, type UnusedImport, VERSION, type ValidationError, type WorkflowPhase, analyzeDiff, appendFailure, appendLearning, applyFixes, archiveFailures, buildDependencyGraph, buildSnapshot, checkDocCoverage, configureFeedback, contextBudget, contextFilter, createBoundaryValidator, createError, createFixes, createParseError, createSelfReview, defineLayer, detectCircularDeps, detectCircularDepsInFiles, detectDeadCode, detectDocDrift, detectPatternViolations, executeWorkflow, extractMarkdownLinks, extractSections, generateAgentsMap, generateSuggestions, getActionEmitter, getFeedbackConfig, getPhaseCategories, loadFailures, loadHandoff, loadRelevantLearnings, loadState, logAgentAction, parseDiff, previewFix, requestMultiplePeerReviews, requestPeerReview, resetFeedbackConfig, resolveFileToLayer, runCIChecks, runMechanicalGate, runMultiTurnPipeline, runPipeline, saveHandoff, saveState, trackAction, validateAgentsMap, validateBoundaries, validateCommitMessage, validateConfig, validateDependencies, validateFileStructure, validateKnowledgeMap, validatePatternConfig };

package/dist/index.js

@@ -91,6 +91,7 @@ __export(index_exports, {
   requestPeerReview: () => requestPeerReview,
   resetFeedbackConfig: () => resetFeedbackConfig,
   resolveFileToLayer: () => resolveFileToLayer,
+  runCIChecks: () => runCIChecks,
   runMechanicalGate: () => runMechanicalGate,
   runMultiTurnPipeline: () => runMultiTurnPipeline,
   runPipeline: () => runPipeline,
@@ -126,17 +127,17 @@ var import_util = require("util");
 var import_glob = require("glob");
 var accessAsync = (0, import_util.promisify)(import_fs.access);
 var readFileAsync = (0, import_util.promisify)(import_fs.readFile);
-async function fileExists(path2) {
+async function fileExists(path3) {
   try {
-    await accessAsync(path2, import_fs.constants.F_OK);
+    await accessAsync(path3, import_fs.constants.F_OK);
     return true;
   } catch {
     return false;
   }
 }
-async function readFileContent(path2) {
+async function readFileContent(path3) {
   try {
-    const content = await readFileAsync(path2, "utf-8");
+    const content = await readFileAsync(path3, "utf-8");
     return (0, import_types.Ok)(content);
   } catch (error) {
     return (0, import_types.Err)(error);
@@ -184,15 +185,15 @@ function validateConfig(data, schema) {
   let message = "Configuration validation failed";
   const suggestions = [];
   if (firstError) {
-    const path2 = firstError.path.join(".");
-    const pathDisplay = path2 ? ` at "${path2}"` : "";
+    const path3 = firstError.path.join(".");
+    const pathDisplay = path3 ? ` at "${path3}"` : "";
     if (firstError.code === "invalid_type") {
       const received = firstError.received;
       const expected = firstError.expected;
       if (received === "undefined") {
         code = "MISSING_FIELD";
         message = `Missing required field${pathDisplay}: ${firstError.message}`;
-        suggestions.push(`Field "${path2}" is required and must be of type "${expected}"`);
+        suggestions.push(`Field "${path3}" is required and must be of type "${expected}"`);
       } else {
         code = "INVALID_TYPE";
         message = `Invalid type${pathDisplay}: ${firstError.message}`;
@@ -405,27 +406,27 @@ function extractSections(content) {
     return result;
   });
 }
-function isExternalLink(path2) {
-  return path2.startsWith("http://") || path2.startsWith("https://") || path2.startsWith("#") || path2.startsWith("mailto:");
+function isExternalLink(path3) {
+  return path3.startsWith("http://") || path3.startsWith("https://") || path3.startsWith("#") || path3.startsWith("mailto:");
 }
 function resolveLinkPath(linkPath, baseDir) {
   return linkPath.startsWith(".") ? (0, import_path.join)(baseDir, linkPath) : linkPath;
 }
-async function validateAgentsMap(path2 = "./AGENTS.md") {
-  const contentResult = await readFileContent(path2);
+async function validateAgentsMap(path3 = "./AGENTS.md") {
+  const contentResult = await readFileContent(path3);
   if (!contentResult.ok) {
     return (0, import_types.Err)(
       createError(
         "PARSE_ERROR",
         `Failed to read AGENTS.md: ${contentResult.error.message}`,
-        { path: path2 },
+        { path: path3 },
         ["Ensure the file exists", "Check file permissions"]
       )
     );
   }
   const content = contentResult.value;
   const sections = extractSections(content);
-  const baseDir = (0, import_path.dirname)(path2);
+  const baseDir = (0, import_path.dirname)(path3);
   const sectionTitles = sections.map((s) => s.title);
   const missingSections = REQUIRED_SECTIONS.filter(
     (required) => !sectionTitles.some((title) => title.toLowerCase().includes(required.toLowerCase()))
@@ -553,8 +554,8 @@ async function checkDocCoverage(domain, options = {}) {
 
 // src/context/knowledge-map.ts
 var import_path3 = require("path");
-function suggestFix(path2, existingFiles) {
-  const targetName = (0, import_path3.basename)(path2).toLowerCase();
+function suggestFix(path3, existingFiles) {
+  const targetName = (0, import_path3.basename)(path3).toLowerCase();
   const similar = existingFiles.find((file) => {
     const fileName = (0, import_path3.basename)(file).toLowerCase();
     return fileName.includes(targetName) || targetName.includes(fileName);
@@ -562,7 +563,7 @@ function suggestFix(path2, existingFiles) {
   if (similar) {
     return `Did you mean "${similar}"?`;
   }
-  return `Create the file "${path2}" or remove the link`;
+  return `Create the file "${path3}" or remove the link`;
 }
 async function validateKnowledgeMap(rootDir = process.cwd()) {
   const agentsPath = (0, import_path3.join)(rootDir, "AGENTS.md");
@@ -1057,8 +1058,8 @@ function createBoundaryValidator(schema, name) {
         return (0, import_types.Ok)(result.data);
       }
       const suggestions = result.error.issues.map((issue) => {
-        const path2 = issue.path.join(".");
-        return path2 ? `${path2}: ${issue.message}` : issue.message;
+        const path3 = issue.path.join(".");
+        return path3 ? `${path3}: ${issue.message}` : issue.message;
       });
       return (0, import_types.Err)(
         createError(
@@ -1127,11 +1128,11 @@ function walk(node, visitor) {
 var TypeScriptParser = class {
   name = "typescript";
   extensions = [".ts", ".tsx", ".mts", ".cts"];
-  async parseFile(path2) {
-    const contentResult = await readFileContent(path2);
+  async parseFile(path3) {
+    const contentResult = await readFileContent(path3);
     if (!contentResult.ok) {
       return (0, import_types.Err)(
-        createParseError("NOT_FOUND", `File not found: ${path2}`, { path: path2 }, [
+        createParseError("NOT_FOUND", `File not found: ${path3}`, { path: path3 }, [
           "Check that the file exists",
           "Verify the path is correct"
         ])
@@ -1141,7 +1142,7 @@ var TypeScriptParser = class {
       const ast = (0, import_typescript_estree.parse)(contentResult.value, {
         loc: true,
         range: true,
-        jsx: path2.endsWith(".tsx"),
+        jsx: path3.endsWith(".tsx"),
         errorOnUnknownASTType: false
       });
       return (0, import_types.Ok)({
@@ -1152,7 +1153,7 @@ var TypeScriptParser = class {
     } catch (e) {
       const error = e;
       return (0, import_types.Err)(
-        createParseError("SYNTAX_ERROR", `Failed to parse ${path2}: ${error.message}`, { path: path2 }, [
+        createParseError("SYNTAX_ERROR", `Failed to parse ${path3}: ${error.message}`, { path: path3 }, [
           "Check for syntax errors in the file",
           "Ensure valid TypeScript syntax"
         ])
@@ -1436,22 +1437,22 @@ function extractInlineRefs(content) {
   }
   return refs;
 }
-async function parseDocumentationFile(path2) {
-  const contentResult = await readFileContent(path2);
+async function parseDocumentationFile(path3) {
+  const contentResult = await readFileContent(path3);
   if (!contentResult.ok) {
     return (0, import_types.Err)(
       createEntropyError(
         "PARSE_ERROR",
-        `Failed to read documentation file: ${path2}`,
-        { file: path2 },
+        `Failed to read documentation file: ${path3}`,
+        { file: path3 },
         ["Check that the file exists"]
       )
     );
   }
   const content = contentResult.value;
-  const type = path2.endsWith(".md") ? "markdown" : "text";
+  const type = path3.endsWith(".md") ? "markdown" : "text";
   return (0, import_types.Ok)({
-    path: path2,
+    path: path3,
     type,
     content,
     codeBlocks: extractCodeBlocks(content),
@@ -3962,6 +3963,181 @@ async function runMultiTurnPipeline(initialContext, turnExecutor, options) {
   };
 }
 
+// src/ci/check-orchestrator.ts
+var path2 = __toESM(require("path"));
+var ALL_CHECKS = ["validate", "deps", "docs", "entropy", "phase-gate"];
+async function runSingleCheck(name, projectRoot, config) {
+  const start = Date.now();
+  const issues = [];
+  try {
+    switch (name) {
+      case "validate": {
+        const agentsPath = path2.join(projectRoot, config.agentsMapPath ?? "AGENTS.md");
+        const result = await validateAgentsMap(agentsPath);
+        if (!result.ok) {
+          issues.push({ severity: "error", message: result.error.message });
+        } else if (!result.value.valid) {
+          if (result.value.errors) {
+            for (const err of result.value.errors) {
+              issues.push({ severity: "error", message: err.message });
+            }
+          }
+          for (const section of result.value.missingSections) {
+            issues.push({ severity: "warning", message: `Missing section: ${section}` });
+          }
+          for (const link of result.value.brokenLinks) {
+            issues.push({
+              severity: "warning",
+              message: `Broken link: ${link.text} \u2192 ${link.path}`,
+              file: link.path
+            });
+          }
+        }
+        break;
+      }
+      case "deps": {
+        const layers = config.layers;
+        if (layers && layers.length > 0) {
+          const parser = new TypeScriptParser();
+          const result = await validateDependencies({
+            layers,
+            rootDir: projectRoot,
+            parser
+          });
+          if (!result.ok) {
+            issues.push({ severity: "error", message: result.error.message });
+          } else if (result.value.violations.length > 0) {
+            for (const v of result.value.violations) {
+              issues.push({
+                severity: "error",
+                message: `${v.reason}: ${v.file} imports ${v.imports} (${v.fromLayer} \u2192 ${v.toLayer})`,
+                file: v.file,
+                line: v.line
+              });
+            }
+          }
+        }
+        break;
+      }
+      case "docs": {
+        const docsDir = path2.join(projectRoot, config.docsDir ?? "docs");
+        const result = await checkDocCoverage("project", { docsDir });
+        if (!result.ok) {
+          issues.push({ severity: "warning", message: result.error.message });
+        } else if (result.value.gaps.length > 0) {
+          for (const gap of result.value.gaps) {
+            issues.push({
+              severity: "warning",
+              message: `Undocumented: ${gap.file} (suggested: ${gap.suggestedSection})`,
+              file: gap.file
+            });
+          }
+        }
+        break;
+      }
+      case "entropy": {
+        const analyzer = new EntropyAnalyzer({
+          rootDir: projectRoot,
+          analyze: { drift: true, deadCode: true, patterns: false }
+        });
+        const result = await analyzer.analyze();
+        if (!result.ok) {
+          issues.push({ severity: "warning", message: result.error.message });
+        } else {
+          const report = result.value;
+          if (report.drift) {
+            for (const drift of report.drift.drifts) {
+              issues.push({
+                severity: "warning",
+                message: `Doc drift (${drift.type}): ${drift.details}`,
+                file: drift.docFile,
+                line: drift.line
+              });
+            }
+          }
+          if (report.deadCode) {
+            for (const dead of report.deadCode.deadExports) {
+              issues.push({
+                severity: "warning",
+                message: `Dead export: ${dead.name}`,
+                file: dead.file,
+                line: dead.line
+              });
+            }
+          }
+        }
+        break;
+      }
+      case "phase-gate": {
+        const phaseGates = config.phaseGates;
+        if (!phaseGates?.enabled) {
+          break;
+        }
+        issues.push({
+          severity: "warning",
+          message: "Phase gate is enabled but requires CLI context. Run `harness check-phase-gate` separately for full validation."
+        });
+        break;
+      }
+    }
+  } catch (error) {
+    issues.push({
+      severity: "error",
+      message: `Check '${name}' threw: ${error instanceof Error ? error.message : String(error)}`
+    });
+  }
+  const hasErrors = issues.some((i) => i.severity === "error");
+  const hasWarnings = issues.some((i) => i.severity === "warning");
+  const status = hasErrors ? "fail" : hasWarnings ? "warn" : "pass";
+  return {
+    name,
+    status,
+    issues,
+    durationMs: Date.now() - start
+  };
+}
+function buildSummary(checks) {
+  return {
+    total: checks.length,
+    passed: checks.filter((c) => c.status === "pass").length,
+    failed: checks.filter((c) => c.status === "fail").length,
+    warnings: checks.filter((c) => c.status === "warn").length,
+    skipped: checks.filter((c) => c.status === "skip").length
+  };
+}
+function determineExitCode(summary, failOn = "error") {
+  if (summary.failed > 0) return 1;
+  if (failOn === "warning" && summary.warnings > 0) return 1;
+  return 0;
+}
+async function runCIChecks(input) {
+  const { projectRoot, config, skip = [], failOn = "error" } = input;
+  try {
+    const checks = [];
+    for (const name of ALL_CHECKS) {
+      if (skip.includes(name)) {
+        checks.push({ name, status: "skip", issues: [], durationMs: 0 });
+      } else {
+        const result = await runSingleCheck(name, projectRoot, config);
+        checks.push(result);
+      }
+    }
+    const summary = buildSummary(checks);
+    const exitCode = determineExitCode(summary, failOn);
+    const report = {
+      version: 1,
+      project: config.name ?? "unknown",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      checks,
+      summary,
+      exitCode
+    };
+    return (0, import_types.Ok)(report);
+  } catch (error) {
+    return (0, import_types.Err)(error instanceof Error ? error : new Error(String(error)));
+  }
+}
+
 // src/index.ts
 var VERSION = "0.6.0";
 // Annotate the CommonJS export names for ESM import in node:
@@ -4026,6 +4202,7 @@ var VERSION = "0.6.0";
   requestPeerReview,
   resetFeedbackConfig,
   resolveFileToLayer,
+  runCIChecks,
   runMechanicalGate,
   runMultiTurnPipeline,
   runPipeline,

package/dist/index.mjs

@@ -18,17 +18,17 @@ import { promisify } from "util";
 import { glob } from "glob";
 var accessAsync = promisify(access);
 var readFileAsync = promisify(readFile);
-async function fileExists(path2) {
+async function fileExists(path3) {
   try {
-    await accessAsync(path2, constants.F_OK);
+    await accessAsync(path3, constants.F_OK);
     return true;
   } catch {
     return false;
   }
 }
-async function readFileContent(path2) {
+async function readFileContent(path3) {
   try {
-    const content = await readFileAsync(path2, "utf-8");
+    const content = await readFileAsync(path3, "utf-8");
     return Ok(content);
   } catch (error) {
     return Err(error);
@@ -76,15 +76,15 @@ function validateConfig(data, schema) {
   let message = "Configuration validation failed";
   const suggestions = [];
   if (firstError) {
-    const path2 = firstError.path.join(".");
-    const pathDisplay = path2 ? ` at "${path2}"` : "";
+    const path3 = firstError.path.join(".");
+    const pathDisplay = path3 ? ` at "${path3}"` : "";
     if (firstError.code === "invalid_type") {
       const received = firstError.received;
       const expected = firstError.expected;
       if (received === "undefined") {
         code = "MISSING_FIELD";
         message = `Missing required field${pathDisplay}: ${firstError.message}`;
-        suggestions.push(`Field "${path2}" is required and must be of type "${expected}"`);
+        suggestions.push(`Field "${path3}" is required and must be of type "${expected}"`);
       } else {
         code = "INVALID_TYPE";
         message = `Invalid type${pathDisplay}: ${firstError.message}`;
@@ -297,27 +297,27 @@ function extractSections(content) {
     return result;
   });
 }
-function isExternalLink(path2) {
-  return path2.startsWith("http://") || path2.startsWith("https://") || path2.startsWith("#") || path2.startsWith("mailto:");
+function isExternalLink(path3) {
+  return path3.startsWith("http://") || path3.startsWith("https://") || path3.startsWith("#") || path3.startsWith("mailto:");
 }
 function resolveLinkPath(linkPath, baseDir) {
   return linkPath.startsWith(".") ? join(baseDir, linkPath) : linkPath;
 }
-async function validateAgentsMap(path2 = "./AGENTS.md") {
-  const contentResult = await readFileContent(path2);
+async function validateAgentsMap(path3 = "./AGENTS.md") {
+  const contentResult = await readFileContent(path3);
   if (!contentResult.ok) {
     return Err(
       createError(
         "PARSE_ERROR",
         `Failed to read AGENTS.md: ${contentResult.error.message}`,
-        { path: path2 },
+        { path: path3 },
         ["Ensure the file exists", "Check file permissions"]
       )
     );
   }
   const content = contentResult.value;
   const sections = extractSections(content);
-  const baseDir = dirname(path2);
+  const baseDir = dirname(path3);
   const sectionTitles = sections.map((s) => s.title);
   const missingSections = REQUIRED_SECTIONS.filter(
     (required) => !sectionTitles.some((title) => title.toLowerCase().includes(required.toLowerCase()))
@@ -445,8 +445,8 @@ async function checkDocCoverage(domain, options = {}) {
 
 // src/context/knowledge-map.ts
 import { join as join2, basename as basename2, relative as relative2 } from "path";
-function suggestFix(path2, existingFiles) {
-  const targetName = basename2(path2).toLowerCase();
+function suggestFix(path3, existingFiles) {
+  const targetName = basename2(path3).toLowerCase();
   const similar = existingFiles.find((file) => {
     const fileName = basename2(file).toLowerCase();
     return fileName.includes(targetName) || targetName.includes(fileName);
@@ -454,7 +454,7 @@ function suggestFix(path2, existingFiles) {
   if (similar) {
     return `Did you mean "${similar}"?`;
   }
-  return `Create the file "${path2}" or remove the link`;
+  return `Create the file "${path3}" or remove the link`;
 }
 async function validateKnowledgeMap(rootDir = process.cwd()) {
   const agentsPath = join2(rootDir, "AGENTS.md");
@@ -949,8 +949,8 @@ function createBoundaryValidator(schema, name) {
         return Ok(result.data);
       }
       const suggestions = result.error.issues.map((issue) => {
-        const path2 = issue.path.join(".");
-        return path2 ? `${path2}: ${issue.message}` : issue.message;
+        const path3 = issue.path.join(".");
+        return path3 ? `${path3}: ${issue.message}` : issue.message;
       });
       return Err(
         createError(
@@ -1019,11 +1019,11 @@ function walk(node, visitor) {
 var TypeScriptParser = class {
   name = "typescript";
   extensions = [".ts", ".tsx", ".mts", ".cts"];
-  async parseFile(path2) {
-    const contentResult = await readFileContent(path2);
+  async parseFile(path3) {
+    const contentResult = await readFileContent(path3);
     if (!contentResult.ok) {
       return Err(
-        createParseError("NOT_FOUND", `File not found: ${path2}`, { path: path2 }, [
+        createParseError("NOT_FOUND", `File not found: ${path3}`, { path: path3 }, [
           "Check that the file exists",
           "Verify the path is correct"
         ])
@@ -1033,7 +1033,7 @@ var TypeScriptParser = class {
       const ast = parse(contentResult.value, {
         loc: true,
         range: true,
-        jsx: path2.endsWith(".tsx"),
+        jsx: path3.endsWith(".tsx"),
         errorOnUnknownASTType: false
       });
       return Ok({
@@ -1044,7 +1044,7 @@ var TypeScriptParser = class {
     } catch (e) {
       const error = e;
       return Err(
-        createParseError("SYNTAX_ERROR", `Failed to parse ${path2}: ${error.message}`, { path: path2 }, [
+        createParseError("SYNTAX_ERROR", `Failed to parse ${path3}: ${error.message}`, { path: path3 }, [
           "Check for syntax errors in the file",
           "Ensure valid TypeScript syntax"
         ])
@@ -1328,22 +1328,22 @@ function extractInlineRefs(content) {
   }
   return refs;
 }
-async function parseDocumentationFile(path2) {
-  const contentResult = await readFileContent(path2);
+async function parseDocumentationFile(path3) {
+  const contentResult = await readFileContent(path3);
   if (!contentResult.ok) {
     return Err(
       createEntropyError(
         "PARSE_ERROR",
-        `Failed to read documentation file: ${path2}`,
-        { file: path2 },
+        `Failed to read documentation file: ${path3}`,
+        { file: path3 },
         ["Check that the file exists"]
       )
     );
   }
   const content = contentResult.value;
-  const type = path2.endsWith(".md") ? "markdown" : "text";
+  const type = path3.endsWith(".md") ? "markdown" : "text";
   return Ok({
-    path: path2,
+    path: path3,
     type,
     content,
     codeBlocks: extractCodeBlocks(content),
@@ -3854,6 +3854,181 @@ async function runMultiTurnPipeline(initialContext, turnExecutor, options) {
   };
 }
 
+// src/ci/check-orchestrator.ts
+import * as path2 from "path";
+var ALL_CHECKS = ["validate", "deps", "docs", "entropy", "phase-gate"];
+async function runSingleCheck(name, projectRoot, config) {
+  const start = Date.now();
+  const issues = [];
+  try {
+    switch (name) {
+      case "validate": {
+        const agentsPath = path2.join(projectRoot, config.agentsMapPath ?? "AGENTS.md");
+        const result = await validateAgentsMap(agentsPath);
+        if (!result.ok) {
+          issues.push({ severity: "error", message: result.error.message });
+        } else if (!result.value.valid) {
+          if (result.value.errors) {
+            for (const err of result.value.errors) {
+              issues.push({ severity: "error", message: err.message });
+            }
+          }
+          for (const section of result.value.missingSections) {
+            issues.push({ severity: "warning", message: `Missing section: ${section}` });
+          }
+          for (const link of result.value.brokenLinks) {
+            issues.push({
+              severity: "warning",
+              message: `Broken link: ${link.text} \u2192 ${link.path}`,
+              file: link.path
+            });
+          }
+        }
+        break;
+      }
+      case "deps": {
+        const layers = config.layers;
+        if (layers && layers.length > 0) {
+          const parser = new TypeScriptParser();
+          const result = await validateDependencies({
+            layers,
+            rootDir: projectRoot,
+            parser
+          });
+          if (!result.ok) {
+            issues.push({ severity: "error", message: result.error.message });
+          } else if (result.value.violations.length > 0) {
+            for (const v of result.value.violations) {
+              issues.push({
+                severity: "error",
+                message: `${v.reason}: ${v.file} imports ${v.imports} (${v.fromLayer} \u2192 ${v.toLayer})`,
+                file: v.file,
+                line: v.line
+              });
+            }
+          }
+        }
+        break;
+      }
+      case "docs": {
+        const docsDir = path2.join(projectRoot, config.docsDir ?? "docs");
+        const result = await checkDocCoverage("project", { docsDir });
+        if (!result.ok) {
+          issues.push({ severity: "warning", message: result.error.message });
+        } else if (result.value.gaps.length > 0) {
+          for (const gap of result.value.gaps) {
+            issues.push({
+              severity: "warning",
+              message: `Undocumented: ${gap.file} (suggested: ${gap.suggestedSection})`,
+              file: gap.file
+            });
+          }
+        }
+        break;
+      }
+      case "entropy": {
+        const analyzer = new EntropyAnalyzer({
+          rootDir: projectRoot,
+          analyze: { drift: true, deadCode: true, patterns: false }
+        });
+        const result = await analyzer.analyze();
+        if (!result.ok) {
+          issues.push({ severity: "warning", message: result.error.message });
+        } else {
+          const report = result.value;
+          if (report.drift) {
+            for (const drift of report.drift.drifts) {
+              issues.push({
+                severity: "warning",
+                message: `Doc drift (${drift.type}): ${drift.details}`,
+                file: drift.docFile,
+                line: drift.line
+              });
+            }
+          }
+          if (report.deadCode) {
+            for (const dead of report.deadCode.deadExports) {
+              issues.push({
+                severity: "warning",
+                message: `Dead export: ${dead.name}`,
+                file: dead.file,
+                line: dead.line
+              });
+            }
+          }
+        }
+        break;
+      }
+      case "phase-gate": {
+        const phaseGates = config.phaseGates;
+        if (!phaseGates?.enabled) {
+          break;
+        }
+        issues.push({
+          severity: "warning",
+          message: "Phase gate is enabled but requires CLI context. Run `harness check-phase-gate` separately for full validation."
+        });
+        break;
+      }
+    }
+  } catch (error) {
+    issues.push({
+      severity: "error",
+      message: `Check '${name}' threw: ${error instanceof Error ? error.message : String(error)}`
+    });
+  }
+  const hasErrors = issues.some((i) => i.severity === "error");
+  const hasWarnings = issues.some((i) => i.severity === "warning");
+  const status = hasErrors ? "fail" : hasWarnings ? "warn" : "pass";
+  return {
+    name,
+    status,
+    issues,
+    durationMs: Date.now() - start
+  };
+}
+function buildSummary(checks) {
+  return {
+    total: checks.length,
+    passed: checks.filter((c) => c.status === "pass").length,
+    failed: checks.filter((c) => c.status === "fail").length,
+    warnings: checks.filter((c) => c.status === "warn").length,
+    skipped: checks.filter((c) => c.status === "skip").length
+  };
+}
+function determineExitCode(summary, failOn = "error") {
+  if (summary.failed > 0) return 1;
+  if (failOn === "warning" && summary.warnings > 0) return 1;
+  return 0;
+}
+async function runCIChecks(input) {
+  const { projectRoot, config, skip = [], failOn = "error" } = input;
+  try {
+    const checks = [];
+    for (const name of ALL_CHECKS) {
+      if (skip.includes(name)) {
+        checks.push({ name, status: "skip", issues: [], durationMs: 0 });
+      } else {
+        const result = await runSingleCheck(name, projectRoot, config);
+        checks.push(result);
+      }
+    }
+    const summary = buildSummary(checks);
+    const exitCode = determineExitCode(summary, failOn);
+    const report = {
+      version: 1,
+      project: config.name ?? "unknown",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      checks,
+      summary,
+      exitCode
+    };
+    return Ok(report);
+  } catch (error) {
+    return Err(error instanceof Error ? error : new Error(String(error)));
+  }
+}
+
 // src/index.ts
 var VERSION = "0.6.0";
 export {
@@ -3917,6 +4092,7 @@ export {
   requestPeerReview,
   resetFeedbackConfig,
   resolveFileToLayer,
+  runCIChecks,
   runMechanicalGate,
   runMultiTurnPipeline,
   runPipeline,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-engineering/core",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Core library for Harness Engineering toolkit",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -41,7 +41,7 @@
     "glob": "^10.3.0",
     "minimatch": "^10.2.4",
     "zod": "^3.22.0",
-    "@harness-engineering/types": "0.0.1"
+    "@harness-engineering/types": "0.1.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",