plan

package

v0.10.15 Latest Latest Go to latest Published: Oct 19, 2026 License: MIT Imports: 16 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/peiman/vaultmind

Links

Open Source Insights

Documentation ¶

Index ¶

Constants
Variables
type ApplyResult
type Executor
- func (e *Executor) Apply(p Plan, dryRun, diff, commit bool) (*ApplyResult, error)
type OpError
- func ValidatePlan(p Plan, reg *schema.Registry) []OpError
type OpResult
- func CreateNote(vaultPath string, op Operation) (*OpResult, error)
type Operation
type Plan

Constants ¶

View Source

const (
	OpFrontmatterSet   = "frontmatter_set"
	OpFrontmatterUnset = "frontmatter_unset"
	OpFrontmatterMerge = "frontmatter_merge"
	OpGeneratedRegion  = "generated_region_render"
	OpNoteCreate       = "note_create"
)

Variables ¶

View Source

var KnownOps = map[string]bool{
	OpFrontmatterSet: true, OpFrontmatterUnset: true, OpFrontmatterMerge: true,
	OpGeneratedRegion: true, OpNoteCreate: true,
}

Functions ¶

This section is empty.

Types ¶

type ApplyResult ¶

type ApplyResult struct {
	PlanDescription     string     `json:"plan_description"`
	OperationsTotal     int        `json:"operations_total"`
	OperationsCompleted int        `json:"operations_completed"`
	Operations          []OpResult `json:"operations"`
	Committed           bool       `json:"committed"`
	CommitSHA           string     `json:"commit_sha,omitempty"`
}

type Executor ¶

type Executor struct {
	VaultPath string
	Detector  git.RepoStateDetector
	Checker   *git.PolicyChecker
	Committer *git.Committer
	Registry  *schema.Registry
	Config    *vault.Config
}

Executor orchestrates plan execution: validate, git policy check, execute ops in order, rollback on failure, optional batch commit.

func (*Executor) Apply ¶

func (e *Executor) Apply(p Plan, dryRun, diff, commit bool) (*ApplyResult, error)

Apply executes a plan: validate → git policy → execute ops → rollback on failure → optional commit.

type OpError ¶

type OpError struct {
	Code    string `json:"code"`
	Message string `json:"message"`
}

func ValidatePlan ¶

func ValidatePlan(p Plan, reg *schema.Registry) []OpError

ValidatePlan checks a Plan for structural validity against the type registry. It returns a slice of OpErrors describing every problem found. An empty slice means the plan is valid.

type OpResult ¶

type OpResult struct {
	Op        string   `json:"op"`
	Target    string   `json:"target,omitempty"`
	Path      string   `json:"path,omitempty"`
	ID        string   `json:"id,omitempty"`
	Status    string   `json:"status"`
	WriteHash string   `json:"write_hash,omitempty"`
	Error     *OpError `json:"error,omitempty"`
}

func CreateNote ¶

func CreateNote(vaultPath string, op Operation) (*OpResult, error)

type Operation ¶

type Operation struct {
	Op          string                 `json:"op"`
	Target      string                 `json:"target,omitempty"`
	Key         string                 `json:"key,omitempty"`
	Value       interface{}            `json:"value,omitempty"`
	Fields      map[string]interface{} `json:"fields,omitempty"`
	SectionKey  string                 `json:"section_key,omitempty"`
	Template    string                 `json:"template,omitempty"`
	Path        string                 `json:"path,omitempty"`
	Type        string                 `json:"type,omitempty"`
	Frontmatter map[string]interface{} `json:"frontmatter,omitempty"`
	Body        string                 `json:"body,omitempty"`
}

type Plan ¶

type Plan struct {
	Version     int         `json:"version"`
	Description string      `json:"description"`
	Operations  []Operation `json:"operations"`
}

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL