StructZero
Home / Docs / Workflows

Workflows & Verification

Available

Understand the pre-flight verification pipeline, automated localized repair loops, and audit recovery mechanisms that prevent broken code from shipping.

Automated Pre-Flight Verification Gate

Available

Code generation does not conclude when the model finishes emitting text. Every proposed file passes through an automated pre-flight quality pipeline before it is committed to disk.

flowchart TD
    FileGenerated[Generated File Draft] --> SyntaxCheck{AST Syntax Check}
    SyntaxCheck -- Pass --> ImportCheck{Import Resolution}
    SyntaxCheck -- Fail --> Repair[Auto-Repair Loop]
    ImportCheck -- Pass --> SecurityCheck{Security Audit}
    ImportCheck -- Fail --> Repair
    Repair --> RetryCheck{Retry < 2?}
    RetryCheck -- Yes --> SyntaxCheck
    RetryCheck -- No --> Restore[Restore Clean Backup]
    SecurityCheck -- Pass --> Certified[Certified & Committed]

1. AST Syntax Compilation

Parses generated code using real compiler APIs (TypeScript compiler, Python AST module). If a syntax error is discovered, the code is flagged immediately.

2. Import Path Resolution

Verifies that every imported module file exists on disk and that named exports match the actual symbol table of the target module.

3. Auto-Repair Loops

When verification detects an isolated defect, a repair agent makes an automated fix attempt (capped at two iterations) to resolve the error.

4. Clean State Restoration

If repair attempts fail, StructZero restores the verified clean backup. Your workspace is never left in an uncompilable state.

Engineering Event Recorder & Audit Recovery

Available

Every prompt, model debate step, AST validation check, and operator approval is written to append-only JSONL event logs. This provides complete auditability and enables deterministic replay.

Event Logging Architecture

graph LR
    ModelCall[LLM Model Call] --> LogStream[Engineering Event Recorder]
    DebateStep[Debate Decision] --> LogStream
    GateCheck[Certification Check Result] --> LogStream
    LogStream --> JSONL[Tamper-Evident JSONL File]

Logs are saved locally under .system_generated/logs/ and can be exported for enterprise SIEM ingestion or compliance auditing.