Semantiva Documentation

Semantiva is a semantic execution framework focused on typed, transparent, inspectable pipelines.

• Getting Started
  • Install & run your first pipeline
  • Installation
  • Quickstart - Hello Pipeline
  • Running a Pipeline from Python
  • Next Steps
  • See also
• Creating Components (Authoring Guide)
  • Audience
  • Do This / Not That
  • Contract Highlights
  • Minimal Templates (pass lint)
  • Context Processors (domain context logic)
  • Linting Your Components
• Semantiva CLI
  • Overview
  • Exit Codes
  • Run
  • Inspect
  • Dev / Lint
• Extending Semantiva (Registries & Extensions)
  • Overview
  • Public API Contract
  • Implement an Extension
  • Migration Examples
  • Package as an Entry Point
  • Built-in Extensions
  • Loading Extensions
  • Authoring Reminders
  • Thread Safety
• Concepts
  • Domain-Driven & Type-Oriented Design
  • Data Types
  • Processors
  • Nodes
  • Context Channel
  • Resolvers & Parameters
  • Dual-Channel Pipeline
  • Minimal Epistemic Unit (MEU)
• Pipelines in Semantiva
  • Overview & Mental Model
  • Defining Pipelines in YAML
  • Parameter resolution (precedence)
  • Parameter Validation in YAML Configuration
  • Canonical spec & identity
  • Running a Pipeline from Python
  • What is a Payload?
  • Public API Surface
  • Extension Points
  • Objects in Pipeline Configurations
  • Autodoc
• Data Types
  • Public API Surface
  • Autodoc
• Data Processors
  • Overview
  • Parameter Validation Examples
  • Examples
  • Annotated walkthrough
  • Run it
  • Autodoc
• Data IO (Sources & Sinks)
  • Overview
  • Public API Surface
  • Autodoc
• Context Processors
  • Overview
  • Context Observer Pattern
  • Parameter Validation Examples
  • Where do required keys come from?
  • Validation & Safe Mutation
  • Factories: rename/delete
  • Factories: stringbuild
  • Testing Context Processors
  • Autodoc
• Semantiva Contracts
  • Rule catalog
  • Fixing common SVA errors
  • CI integration
• Sweeps in YAML
  • Objective
  • Overview
  • Key concepts and parameters
  • Variable specification types
  • Modes
  • Basic example
  • Explanation
  • From context & zip mode
  • Explanation
  • Inspection
  • API reference (short)
  • Notes on expressions
  • Good practices
  • Examples
  • Explanation
  • Explanation
  • Expressions

Additional Topics

• Semantiva Studio Viewer
  • Quick Start
  • Modes & Controls
  • Export & Share
  • Trace Inspection
  • Positional Binding (node_uuid)
  • Limitations
  • Troubleshooting
  • Inspection schema note (GUI)
  • Large Graphs
  • See also
• Step Evidence Record (SER) v0 — draft
  • Example SER
  • Versioning Policy
  • Schema
  • IO Delta
  • Checks via SERHooks
  • Built-in checks
  • Environment pins
• Introspection & Validation
  • Examples
  • CLI Inspection
  • Python APIs for Introspection
  • JSON Outline Example
  • Linking Reports to GraphV1 Identities
  • Common Validation Errors
  • Unknown / Unused Parameters
  • Tips
  • Component Documentation in Introspection
  • Validation Phases
  • Autodoc
• Canonical Graph Builder
  • Graph and Identity
  • See also
• Registry System
  • Architecture Overview
  • Parameter Resolver System
  • Bootstrap Profiles
  • Distributed Execution
  • Programmatic Usage
  • Best Practices
  • Idempotent Defaults
  • Migration Notes
• Context Processing Architecture
  • Rationale
  • Key Classes
  • Observer Pattern Details
  • Lifecycle
  • Parameter Resolution
  • Collections & ChainMap
  • Performance
• Pipeline Configuration Schema
  • Validation
• Execution
  • Component Registry System
  • Template-method orchestrator
  • Public API Surface
  • Autodoc
• Workflows — Fitting Models via model:
  • Overview
  • Key Features
  • Traditional Usage
  • Flexible Parameter Mapping
  • Integration with Pipeline Components
  • Technical Implementation
  • Run it (inspect, then execute)
  • Example YAML Configurations
  • Programmatic Usage
  • API Reference
  • Autodoc
• Fan-Out Quickstart (Local)
  • What you’ll run
  • YAML
  • Key ideas
  • Next steps
• Logger
  • Logger
  • From the CLI
• Examples Index
  • How to run these examples
• API Reference
• Exceptions
  • InvalidNodeParameterError
  • PipelineConfigurationError
  • PipelineTopologyError
  • See also
• Glossary
  • Conventions
  • See also
• Trace ↔ Graph Alignment
  • Node Identity
  • SER Output
  • Pipeline & Run Identity
  • Trace → Graph Usage
• Testing Strategies and Best Practices
  • Overview
  • Pipeline-Based Testing (Recommended)
  • Node-Based Testing (Limited Use)
  • Antipatterns to Avoid

Index & Search

• Index — Global index of terms and pages

• Module Index — Python module index

• Search Page — Full-text search