trace

package

v0.4.1 Latest Latest Go to latest Published: Apr 10, 2026 License: MIT Imports: 6 Imported by: 0

Details

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

Repository

github.com/Fail-Safe/Noema

Links

Open Source Insights

Documentation ¶

Index ¶

Variables
func IsValidType(t string) bool
func NewID(title string) string
type Frontmatter
type Trace
- func (t *Trace) Write(path string) error
type Type

Constants ¶

This section is empty.

Variables ¶

View Source

var ValidTypes = []Type{
	TypeFact, TypeDecision, TypePreference, TypeContext,
	TypeSkill, TypeIntent, TypeObservation, TypeNote,
	TypeDivergence,
}

Functions ¶

func IsValidType ¶

func IsValidType(t string) bool

func NewID ¶

func NewID(title string) string

NewID generates a trace ID from a title: YYYYMMDD-slugified-title.

If the slugified title already begins with a date prefix (either `YYYYMMDD-` or `YYYY-MM-DD-`), the leading date is stripped before today's date is prepended. This is a defensive measure: agents commonly include dates in titles to mark when an event occurred (e.g., "20260402 dadbot heartbeat check"), and without the strip the resulting ID would carry two date prefixes (`20260402-20260402-dadbot-heartbeat-check`). The strip does not validate that the digits form a real calendar date — its only job is to prevent visual prefix duplication in the final ID.

Types ¶

type Frontmatter ¶

type Frontmatter struct {
	ID          string   `yaml:"id"`
	Title       string   `yaml:"title"`
	Type        string   `yaml:"type"`
	Author      string   `yaml:"author,omitempty"`
	Tags        []string `yaml:"tags,omitempty"`
	DerivedFrom []string `yaml:"derived_from,omitempty"`
	Origin      string   `yaml:"origin,omitempty"`
	Created     string   `yaml:"created"`
	Updated     string   `yaml:"updated"`
}

type Trace ¶

type Trace struct {
	Frontmatter
	Body string
}

func New ¶

func New(title, traceType, author string, tags []string, body string) *Trace

func Parse ¶

func Parse(data []byte) (*Trace, error)

func ParseFile ¶

func ParseFile(path string) (*Trace, error)

func (*Trace) Write ¶

func (t *Trace) Write(path string) error

type Type ¶

type Type string

const (
	TypeFact        Type = "fact"
	TypeDecision    Type = "decision"
	TypePreference  Type = "preference"
	TypeContext     Type = "context"
	TypeSkill       Type = "skill"
	TypeIntent      Type = "intent"
	TypeObservation Type = "observation"
	TypeNote        Type = "note"
	TypeDivergence  Type = "divergence"
)

Source Files ¶

View all Source files

trace.go

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