pipelines

package
v1.10.7 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: May 5, 2026 License: MIT Imports: 2 Imported by: 0

Documentation

Overview

Package pipelines ships the SHAPE of Helix's order-sensitive workflows (semantic indexing, live updates, evaluation runs) as []phasegraph.PhaseSpec literals.

Run bodies are noopRun placeholders. Phase 59-62 (semantic indexing), Phase 60 (live updates), and Phase 67 (eval) replace these with real implementations. The shapes (Requires/Provides chains) are the v1.10 contract per DAG-02 — downstream phases must not change phase IDs or the Requires graph.

Index

Constants

View Source 
const (
	PhasePrepareWorkspace  phasegraph.PhaseID = "prepare_workspace"
	PhaseConfigureMode     phasegraph.PhaseID = "configure_mode"
	PhaseRunAgent          phasegraph.PhaseID = "run_agent"
	PhaseCollectTrace      phasegraph.PhaseID = "collect_trace"
	PhaseApplyPatchCheck   phasegraph.PhaseID = "apply_patch_check"
	PhaseRunTests          phasegraph.PhaseID = "run_tests"
	PhaseRunDiagnostics    phasegraph.PhaseID = "run_diagnostics"
	PhaseScoreToolBehavior phasegraph.PhaseID = "score_tool_behavior"
	PhaseScoreGuardrails   phasegraph.PhaseID = "score_guardrails"
	PhaseAggregateReport   phasegraph.PhaseID = "aggregate_report"
)

Eval phase IDs (SPEC §39.7, verbatim).

View Source 
const (
	PhaseCollectEvents          phasegraph.PhaseID = "collect_events"
	PhaseCoalesceEvents         phasegraph.PhaseID = "coalesce_events"
	PhaseClassifyEvents         phasegraph.PhaseID = "classify_events"
	PhaseParseChangedFiles      phasegraph.PhaseID = "parse_changed_files"
	PhaseDiffEffectiveFacts     phasegraph.PhaseID = "diff_effective_facts"
	PhaseWriteOverlay           phasegraph.PhaseID = "write_overlay"
	PhaseRepairGraphCache       phasegraph.PhaseID = "repair_graph_cache"
	PhaseMarkScoresClusters     phasegraph.PhaseID = "mark_scores_clusters"
	PhaseEnqueueLSPRevalidation phasegraph.PhaseID = "enqueue_lsp_revalidation"
)

Live-update phase IDs (SPEC §39.6, verbatim).

View Source 
const (
	PhaseDiscoverFiles        phasegraph.PhaseID = "discover_files"
	PhaseParseTreeSitter      phasegraph.PhaseID = "parse_tree_sitter"
	PhaseExtractSymbols       phasegraph.PhaseID = "extract_symbols"
	PhaseResolveImports       phasegraph.PhaseID = "resolve_imports"
	PhaseResolveTypes         phasegraph.PhaseID = "resolve_types"
	PhaseLSPEnrich            phasegraph.PhaseID = "lsp_enrich"
	PhaseMergeFacts           phasegraph.PhaseID = "merge_facts"
	PhaseBuildEdges           phasegraph.PhaseID = "build_edges"
	PhaseWriteSnapshot        phasegraph.PhaseID = "write_snapshot"
	PhaseComputeScores        phasegraph.PhaseID = "compute_scores"
	PhaseComputeClusters      phasegraph.PhaseID = "compute_clusters"
	PhaseInitializeGraphCache phasegraph.PhaseID = "initialize_graph_cache"
)

Semantic-index phase IDs (SPEC §39.5, verbatim).

Variables

View Source 
var EvalPhases = []phasegraph.PhaseSpec{
	{ID: PhasePrepareWorkspace, Requires: nil, Provides: []string{"workspace"}, Run: noopRun},
	{ID: PhaseConfigureMode, Requires: []phasegraph.PhaseID{PhasePrepareWorkspace}, Provides: []string{"mode_config"}, Run: noopRun},
	{ID: PhaseRunAgent, Requires: []phasegraph.PhaseID{PhaseConfigureMode}, Provides: []string{"agent_run"}, Run: noopRun},
	{ID: PhaseCollectTrace, Requires: []phasegraph.PhaseID{PhaseRunAgent}, Provides: []string{"trace"}, Run: noopRun},
	{ID: PhaseApplyPatchCheck, Requires: []phasegraph.PhaseID{PhaseCollectTrace}, Provides: []string{"patch_result"}, Run: noopRun},
	{ID: PhaseRunTests, Requires: []phasegraph.PhaseID{PhaseApplyPatchCheck}, Provides: []string{"test_result"}, Run: noopRun},
	{ID: PhaseRunDiagnostics, Requires: []phasegraph.PhaseID{PhaseRunTests}, Provides: []string{"diag_result"}, Run: noopRun},
	{ID: PhaseScoreToolBehavior, Requires: []phasegraph.PhaseID{PhaseRunDiagnostics}, Provides: []string{"tool_behavior_score"}, Run: noopRun},
	{ID: PhaseScoreGuardrails, Requires: []phasegraph.PhaseID{PhaseScoreToolBehavior}, Provides: []string{"guardrails_score"}, Run: noopRun},
	{ID: PhaseAggregateReport, Requires: []phasegraph.PhaseID{PhaseScoreGuardrails}, Provides: []string{"report"}, Run: noopRun},
}

EvalPhases ships the SHAPE only — Run bodies are noopRun placeholders that Phase 67 (eval harness) replaces with real implementations (DAG-02 contract).

Chain (linear, per SPEC §39.7): 

prepare_workspace → configure_mode → run_agent → collect_trace
→ apply_patch_check → run_tests → run_diagnostics → score_tool_behavior
→ score_guardrails → aggregate_report
View Source 
var LiveUpdatePhases = []phasegraph.PhaseSpec{
	{ID: PhaseCollectEvents, Requires: nil, Provides: []string{"events"}, Run: noopRun},
	{ID: PhaseCoalesceEvents, Requires: []phasegraph.PhaseID{PhaseCollectEvents}, Provides: []string{"coalesced_events"}, Run: noopRun},
	{ID: PhaseClassifyEvents, Requires: []phasegraph.PhaseID{PhaseCoalesceEvents}, Provides: []string{"classified_events"}, Run: noopRun},
	{ID: PhaseParseChangedFiles, Requires: []phasegraph.PhaseID{PhaseClassifyEvents}, Provides: []string{"reparsed_trees"}, Run: noopRun},
	{ID: PhaseDiffEffectiveFacts, Requires: []phasegraph.PhaseID{PhaseParseChangedFiles}, Provides: []string{"fact_diff"}, Run: noopRun},
	{ID: PhaseWriteOverlay, Requires: []phasegraph.PhaseID{PhaseDiffEffectiveFacts}, Provides: []string{"overlay_writes"}, Run: noopRun},
	{ID: PhaseRepairGraphCache, Requires: []phasegraph.PhaseID{PhaseWriteOverlay}, Provides: []string{"repaired_graph"}, Run: noopRun},
	{ID: PhaseMarkScoresClusters, Requires: []phasegraph.PhaseID{PhaseRepairGraphCache}, Provides: []string{"marked_freshness"}, Run: noopRun},
	{ID: PhaseEnqueueLSPRevalidation, Requires: []phasegraph.PhaseID{PhaseMarkScoresClusters}, Provides: []string{"lsp_revalidation_queue"}, Run: noopRun},
}

LiveUpdatePhases ships the SHAPE only — Run bodies are noopRun placeholders that Phase 60 (live updates) replaces with real implementations (DAG-02 contract).

Chain (linear, per SPEC §39.6): 

collect_events → coalesce_events → classify_events → parse_changed_files
→ diff_effective_facts → write_overlay → repair_graph_cache
→ mark_scores_clusters → enqueue_lsp_revalidation
View Source 
var SemanticIndexPhases = []phasegraph.PhaseSpec{
	{ID: PhaseDiscoverFiles, Requires: nil, Provides: []string{"files"}, Run: noopRun},
	{ID: PhaseParseTreeSitter, Requires: []phasegraph.PhaseID{PhaseDiscoverFiles}, Provides: []string{"trees"}, Run: noopRun},
	{ID: PhaseExtractSymbols, Requires: []phasegraph.PhaseID{PhaseParseTreeSitter}, Provides: []string{"symbols"}, Run: noopRun},
	{ID: PhaseResolveImports, Requires: []phasegraph.PhaseID{PhaseExtractSymbols}, Provides: []string{"import_edges"}, Run: noopRun},
	{ID: PhaseResolveTypes, Requires: []phasegraph.PhaseID{PhaseResolveImports}, Provides: []string{"type_facts"}, Run: noopRun},
	{ID: PhaseLSPEnrich, Requires: []phasegraph.PhaseID{PhaseResolveTypes}, Provides: []string{"lsp_facts"}, Run: noopRun},
	{ID: PhaseMergeFacts, Requires: []phasegraph.PhaseID{PhaseLSPEnrich}, Provides: []string{"merged_facts"}, Run: noopRun},
	{ID: PhaseBuildEdges, Requires: []phasegraph.PhaseID{PhaseMergeFacts}, Provides: []string{"edges"}, Run: noopRun},
	{ID: PhaseWriteSnapshot, Requires: []phasegraph.PhaseID{PhaseBuildEdges}, Provides: []string{"snapshot"}, Run: noopRun},
	{ID: PhaseComputeScores, Requires: []phasegraph.PhaseID{PhaseWriteSnapshot}, Provides: []string{"scores"}, Run: noopRun},
	{ID: PhaseComputeClusters, Requires: []phasegraph.PhaseID{PhaseComputeScores}, Provides: []string{"clusters"}, Run: noopRun},
	{ID: PhaseInitializeGraphCache, Requires: []phasegraph.PhaseID{PhaseComputeClusters}, Provides: []string{"graph_cache"}, Run: noopRun},
}

SemanticIndexPhases ships the SHAPE only — Run bodies are noopRun placeholders that Phase 59-62 will replace with real implementations (DAG-02 contract).

Chain (linear, per SPEC §39.5): 

discover_files → parse_tree_sitter → extract_symbols → resolve_imports
→ resolve_types → lsp_enrich → merge_facts → build_edges → write_snapshot
→ compute_scores → compute_clusters → initialize_graph_cache

Functions

This section is empty.

Types

This section is empty.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.