Crate forge_agent 

ForgeKit agent layer - Deterministic AI loop.

This crate provides a deterministic agent loop for AI-driven code operations:

• Observation: Gather context from the graph
• Constraint: Apply policy rules
• Planning: Generate execution steps
• Mutation: Apply changes
• Verification: Validate results
• Commit: Finalize transaction

Status

This crate is under active development. Observation and planning phases are implemented.

Re-exports

pub use policy::Policy;

pub use policy::PolicyReport;

pub use policy::PolicyValidator;

pub use policy::PolicyViolation;

pub use observe::Observation;

pub use loop::AgentLoop;

pub use loop::AgentPhase;

pub use loop::LoopResult;

pub use audit::AuditEvent;

pub use audit::AuditLog;

pub use workflow::Dependency;

pub use workflow::TaskContext;

pub use workflow::TaskError;

pub use workflow::TaskId;

pub use workflow::TaskResult;

pub use workflow::ValidationReport;

pub use workflow::Workflow;

pub use workflow::WorkflowError;

pub use workflow::WorkflowExecutor;

pub use workflow::WorkflowResult;

pub use workflow::WorkflowTask;

pub use workflow::WorkflowValidator;

pub use transaction::FileSnapshot;

pub use transaction::Transaction;

pub use transaction::TransactionState;

Modules

audit

Audit trail system with serde-serializable events and JSON persistence.

commit

Commit engine - Transaction finalization.

loop

Agent loop orchestrator - Deterministic 6-phase execution.

mutate

Mutation engine - Transaction-based code mutation.

observe

Observation phase - Graph-based context gathering.

planner

Planning engine - Execution plan generation from observations.

policy

Policy engine - Constraint validation system.

runtime_integration

Runtime integration for Agent with ForgeRuntime.

transaction

Transaction management - File snapshotting and atomic rollback.

verify

Verification engine - Post-mutation validation.

workflow

Workflow orchestration system for multi-step agent operations.

Structs

Agent

Agent for deterministic AI-driven code operations.

CommitResult

Result of the commit phase.

ConstrainedPlan

Result of applying policy constraints.

ExecutionPlan

Execution plan for the mutation phase.

ForgeRuntime

ForgeKit runtime for automatic reindexing and caching.

MutationResult

Result of the mutation phase.

RuntimeConfig

Runtime configuration for indexing and caching.

RuntimeStats

Runtime statistics.

VerificationResult

Result of the verification phase.

Enums

AgentError

Error types for agent operations.

Type Aliases

Result

Result type for agent operations.