model

Jul 16, 2026

Changes in this version

+ func IsKnownKind(k Kind) bool

type EntryType

+ func ParseTypeFilter(s string) (EntryType, bool)

type Layer

+ func ParseLayerFilter(s string) (Layer, bool)

Jul 10, 2026

Changes in this version

+ func CrossRepoIDs(ids []string) []string

+ func DeriveRepoID(remoteURL string) (string, error)

+ func IsCrossRepoID(id string) bool

+ func IsForwardClassRefKind(k RefKind) bool

+ func ParseConfigScalar(s string) any

+ func SplitCrossRepoID(id string) (repoID, entryID string, isCrossRepo bool)

+ func StrictUnmarshalYAML(data []byte, out any) error

+ func ValidateCrossRepoID(id string) error

+ func ValidateRepoID(repoID string) error

+ type BaseConfig struct

+ Embedding EmbeddingConfig

+ LLM LLMConfig

+ Participant string

+ Sync SyncConfig

+ func MergeBaseConfig(base, overlay BaseConfig) BaseConfig

+ func (b BaseConfig) IsZero() bool

+ type ConfigValue struct

+ Key string

+ Secret bool

+ Source ConfigValueSource

+ Value string

+ func EffectiveConfigValues(global BaseConfig, project, local *PerRepoConfig) []ConfigValue

+ type ConfigValueSource string

+ const ConfigSourceDefault

+ const ConfigSourceGlobal

+ const ConfigSourceLocal

+ const ConfigSourceProject

type Graph

+ func (from *Graph) ResolveAcross(id string) (e *Entry, owner *Graph, ok bool)

+ func (g *Graph) DisplayID(id string) (string, bool)

+ func (g *Graph) MemberGraph(repoID string) (*Graph, error)

+ func (g *Graph) QualifiedItemStatus(e *Entry) (Status, []string)

+ func (g *Graph) ResolveUnionID(input string) (string, error)

+ func (g *Graph) ResolveUnionIDs(inputs []string) ([]string, error)

+ type MultiGraph struct

+ Local *Graph

+ func NewMultiGraph(local *Graph, deps []string, loader func(repoID string) (*Graph, error)) *MultiGraph

+ func (m *MultiGraph) Member(repoID string) (*Graph, error)

+ type PerRepoConfig struct

+ Dependencies []string

+ GraphDir string

+ Language string

+ RepoID string

+ SkillScope Scope

+ SupportedAgents []AgentTarget

type RefExpansion

+ UnresolvedRepo string

type ShowTree

+ PrimaryID string

type ShowTreeItem

+ CrossRepoID string

+ func (it ShowTreeItem) NodeID() string

Jul 6, 2026

Changes in this version

+ func MergeClaudeMCPJSON(existing []byte) ([]byte, bool, error)

+ func MergeClaudeSettingsAllow(existing []byte) ([]byte, bool, error)

+ func MergeCodexConfigTOML(existing []byte) ([]byte, bool, error)

type Entry

+ Class ProcedureClass

+ Embedded bool

+ ProcedureSpec *ProcedureSpecRaw

+ func (e *Entry) FirstSummarySentence() string

+ func (e *Entry) IsProcedure() bool

+ func (e *Entry) IsShellProcedure() bool

+ func (e *Entry) IsTaskProcedure() bool

type Graph

+ func (g *Graph) ProcedureChainForCanonical(canonical string) *ProcedureChain

+ func (g *Graph) ProcedureChains() []*ProcedureChain

+ func (g *Graph) ProcedureChainsForCanonical(canonical string) []*ProcedureChain

+ func (g *Graph) Procedures() []*Entry

+ func (g *Graph) ResolveProcedure(canonical string) *Entry

type Kind

+ const KindProcedure

+ type MCPRegTarget struct

+ Merge func(existing []byte) (merged []byte, changed bool, err error)

+ Path string

+ func MCPRegistrationTargets(target AgentTarget, repoRoot string) ([]MCPRegTarget, error)

+ type ProcedureChain struct

+ CanonicalHistory []string

+ Entries []*Entry

+ Head *Entry

+ Heads []*Entry

+ LiveHeads []*Entry

+ func (c *ProcedureChain) Forked() bool

+ func (c *ProcedureChain) HasCanonical(name string) bool

+ type ProcedureClass string

+ const ProcedureClassMove

+ const ProcedureClassShell

+ const ProcedureClassTask

+ type ProcedureSpecRaw struct

+ Params yaml.Node

+ State yaml.Node

+ Steps yaml.Node

Jun 28, 2026

Changes in this version

+ func IsValidIntent(s string) bool

type Entry

+ Intent Intent

+ func (e *Entry) IsSettled() bool

+ type Intent string

+ const IntentGuiding

+ const IntentPending

+ const IntentSettled

type StatusKind

+ const StatusSettled

Jun 25, 2026

Changes in this version

+ const DefaultColdnessDecayName

+ func ColdnessScore(g *Graph, e *Entry, decay DecayFunc, now time.Time) float64

Jun 17, 2026

Changes in this version

+ func SetYAMLSequence(existing []byte, path string, values []string) ([]byte, error)

Jun 14, 2026

Changes in this version

+ var DefaultSupportedAgents = []AgentTarget

+ var KnownAgentTargets = []AgentTarget

type AgentTarget

+ const AgentCodex

+ func ParseAgentTarget(s string) (AgentTarget, error)

type Config

+ SupportedAgents []AgentTarget

type RefKind

+ const RefKindSurfacedBy

Jun 11, 2026

Changes in this version

type RefKind

+ func AdmissibleRefKinds(class RefTargetClass) []RefKind

+ type RefKindCell struct

+ Applicable bool

+ Note string

+ func RefKindApplicability(kind RefKind, class RefTargetClass) (RefKindCell, bool)

+ type RefTargetClass string

+ const TargetLiveDecision

+ const TargetLiveSignal

+ const TargetRetired

+ const TargetTerminalDone

+ func ClassifyRefTarget(target *Entry, status Status) RefTargetClass

Jun 9, 2026

Changes in this version

type Graph

+ func (g *Graph) ResolveRef(id string) ResolvedRef

+ type ModelRollup struct

+ Model string

+ Provider string

+ type OpRollup struct

+ Op string

type RefExpansion

+ SupersedePath []string

+ type ResolvedRef struct

+ func (r ResolvedRef) Head() string

+ func (r ResolvedRef) IsStale() bool

+ func (r ResolvedRef) Origin() string

+ func (r ResolvedRef) Path() []string

type ShowTree

+ PrimaryStatus Status

+ PrimarySupersedePath []string

+ PrimaryTopics []TopicPath

type ShowTreeItem

+ Status Status

+ SupersedePath []string

+ type StatMetrics struct

+ CacheCreateTokens int

+ CacheReadTokens int

+ Calls int

+ DurationMS int64

+ InputTokens int

+ Items int

+ OutputTokens int

+ func (m StatMetrics) HasItems() bool

+ func (m StatMetrics) ItemsPerSec() float64

+ func (m StatMetrics) MsPerCall() float64

+ func (m StatMetrics) TokensPerSec() float64

+ type StatsRecord struct

+ CacheCreateTokens int

+ CacheReadTokens int

+ DurationMS int64

+ InputTokens int

+ Items int

+ Model string

+ Op string

+ OutputTokens int

+ Provider string

+ Timestamp time.Time

+ func FilterStats(records []StatsRecord, since *time.Time, op, provider, model string) []StatsRecord

+ type StatsReport struct

+ ByModel []ModelRollup

+ ByOp []OpRollup

+ Totals StatMetrics

+ func AggregateStats(records []StatsRecord) StatsReport

Jun 3, 2026

Changes in this version

+ const DefaultRetryBaseDelay

+ const DefaultRetryMaxAttempts

+ const DefaultRetryMaxDelay

+ func SkillFileBody(content []byte) []byte

+ type CountRow struct

+ Count int

+ Heat float64

+ Label string

+ type Counts struct

+ Rows []CountRow

+ func (Counts) Shape() RenderShape

type FlatList

+ RefExpansions [][]RefExpansion

type Graph

+ func (g *Graph) TopicCounts(entries []*Entry, now time.Time) Counts

type LLMConfig

+ Retry RetryConfig

type Ref

+ func (r Ref) OnDiskKind() RefKind

+ type RefExpansion struct

+ Desc string

+ ID string

+ Kind RefKind

+ Status Status

type RefKind

+ const RefKindGroundedIn

+ const RefKindRequiredBy

type RenderShape

+ const ShapeCounts

+ type RetryConfig struct

+ BaseDelay string

+ MaxAttempts int

+ MaxDelay string

+ func (rc RetryConfig) Resolved() (maxAttempts int, baseDelay, maxDelay time.Duration, err error)

type SkillBundleEntry

+ func ResolveSkillIncludes(entries []SkillBundleEntry) ([]SkillBundleEntry, error)

May 20, 2026

Changes in this version

+ func IsCapturableRefKind(k RefKind) bool

+ func IsValidRefKind(k RefKind) bool

+ func RefIDs(refs []Ref) []string

type Graph

+ func (g *Graph) ResolveRefIDs(refs []Ref) ([]Ref, error)

+ type Ref struct

+ Desc string

+ ID string

+ Kind RefKind

+ func (r *Ref) UnmarshalYAML(node *yaml.Node) error

+ func (r Ref) MarshalYAML() (any, error)

+ type RefKind string

+ const RefKindAddresses

+ const RefKindBuildsOn

+ const RefKindDependsOn

+ const RefKindEvidence

+ const RefKindGrounds

+ const RefKindRefines

+ const RefKindRelated

+ const RefKindSurfaces

+ const RefKindUnknown

+ func RefKindValues() []RefKind

type ShowTreeItem

+ RefDesc string

+ RefKind RefKind

type TruncatedRef

+ RefDesc string

+ RefKind RefKind

May 7, 2026

Changes in this version

+ func ShouldBumpMinimumVersion(current, binaryVersion string) bool

type Config

+ SkillScope Scope

May 7, 2026

Changes in this version

+ const DefaultDecayName

+ func AddScore(g *Graph, e *Entry, decay DecayFunc, now time.Time) float64

+ func HeatScore(g *Graph, e *Entry, decay DecayFunc, now time.Time) float64

+ func InDegreeScore(g *Graph, e *Entry) float64

+ func LogScore(g *Graph, e *Entry, decay DecayFunc, now time.Time) float64

+ func MultScore(g *Graph, e *Entry, decay DecayFunc, now time.Time) float64

+ func ResolveSinceSpec(spec string, now time.Time) (time.Time, error)

+ type AnnotationTopic struct

+ Label string

+ Members []string

+ func (a *AnnotationTopic) UnmarshalYAML(node *yaml.Node) error

+ func (a AnnotationTopic) MarshalYAML() (any, error)

+ type ArgKind string

+ const ArgKindFunc

+ const ArgKindIdent

+ const ArgKindNumber

+ const ArgKindString

+ type DecayFunc func(ageDays float64) float64

+ func DecayByName(name string) (DecayFunc, error)

type Entry

+ AnnotationTopics []AnnotationTopic

+ FocusActors []string

+ FocusWhen *FocusWhen

+ Involvement []Involvement

+ Topics []TopicPath

+ func (e *Entry) IsAnnotation() bool

+ func (e *Entry) IsFocus() bool

+ func (e *Entry) MembersFor(t AnnotationTopic) []string

+ func (e *Entry) ResolveActors(inv Involvement) []string

+ func (e *Entry) ResolveWhen(inv Involvement) *FocusWhen

+ type FlatList struct

+ Entries []*Entry

+ Scores []float64

+ func (FlatList) Shape() RenderShape

+ type FocusBlock struct

+ Focuses []FocusGroup

+ func (FocusBlock) Shape() RenderShape

+ type FocusGroup struct

+ Actors []string

+ Focus *Entry

+ Targets []FocusTarget

+ When *FocusWhen

+ type FocusState string

+ const FocusStateDriving

+ const FocusStatePullAvailable

+ const FocusStateStalled

+ type FocusTarget struct

+ ActorsExplicit bool

+ ResolvedActors []string

+ ResolvedWhen *FocusWhen

+ Score float64

+ State FocusState

+ Target *Entry

+ type FocusWhen struct

+ From string

+ To string

+ func (w *FocusWhen) IsZero() bool

+ func (w *FocusWhen) Validate() error

+ type Function struct

+ Args []FunctionArg

+ Name string

+ type FunctionArg struct

+ Func *Function

+ Kind ArgKind

+ Number float64

+ String string

type Graph

+ func (g *Graph) ActiveFocuses() []*Entry

+ func (g *Graph) Annotations() []*Entry

+ func (g *Graph) EffectiveTopics(e *Entry) []TopicPath

+ func (g *Graph) Focuses() []*Entry

+ type Group struct

+ Entries []*Entry

+ Key string

+ type Grouped struct

+ Field string

+ Groups []Group

+ func (Grouped) Shape() RenderShape

+ type Involvement struct

+ Actors []string

+ ActorsSet bool

+ Target string

+ When *FocusWhen

type Kind

+ const KindAnnotation

+ const KindFocus

+ type Layout struct

+ Sections []Section

+ type ParticipantsBlock struct

+ Groups []ParticipantsGroup

+ func (ParticipantsBlock) Shape() RenderShape

+ type ParticipantsGroup struct

+ Actor *Entry

+ Roles []*Entry

+ type RenderShape string

+ const ShapeFlatList

+ const ShapeFocusBlock

+ const ShapeGrouped

+ const ShapeParticipantsBlock

+ const ShapeWipList

+ type Section struct

+ Functions []Function

+ type SectionData interface

+ Shape func() RenderShape

+ type TopicPath struct

+ Components []string

+ func CanonicalizeTopicPaths(paths []TopicPath) []TopicPath

+ func ParseTopicPath(s string) (TopicPath, error)

+ func (t TopicPath) Equal(o TopicPath) bool

+ func (t TopicPath) FoldKey() string

+ func (t TopicPath) HasPrefix(prefix TopicPath) bool

+ func (t TopicPath) IsZero() bool

+ func (t TopicPath) String() string

+ type WipList struct

+ Markers []*WIPMarker

+ func (WipList) Shape() RenderShape

May 5, 2026

Changes in this version

type Config

+ Embedding EmbeddingConfig

+ type EmbeddingConfig struct

+ APIKeys map[string]string

+ BatchSize int

+ Dimensions int

+ DocumentTemplate string

+ Endpoint string

+ Model string

+ OllamaEndpoint string

+ Provider string

+ QueryTemplate string

+ RateLimitRPS float64

+ Timeout string

Apr 28, 2026

Changes in this version

+ const DefaultSyncCooldown

+ func CountGraphCommits(gitLogOutput string) int

+ func ParseMergeTreeConflicts(output string) []string

+ func ResolveSyncCooldown(cfg *Config) time.Duration

+ func SetYAMLField(existing []byte, path string, value any) ([]byte, error)

+ type ActorChain struct

+ CanonicalHistory []string

+ Entries []*Entry

+ Head *Entry

+ func (c *ActorChain) HasCanonical(name string) bool

type Config

+ Language string

+ Participant string

+ Sync SyncConfig

type Entry

+ Actor string

+ Aliases []string

+ Canonical string

+ func (e *Entry) IsActor() bool

+ func (e *Entry) IsRole() bool

type Graph

+ func (g *Graph) ActiveActorHeads() []*Entry

+ func (g *Graph) ActiveRoles() []*Entry

+ func (g *Graph) ActorChains() []*ActorChain

+ func (g *Graph) Actors() []*Entry

+ func (g *Graph) AllParticipants() []string

+ func (g *Graph) ChainForCanonical(canonical string) *ActorChain

+ func (g *Graph) ChainsForCanonical(canonical string) []*ActorChain

+ func (g *Graph) ResolveRoleChain(role *Entry) *ActorChain

+ func (g *Graph) Roles() []*Entry

type Kind

+ const KindActor

+ const KindRole

type StatusKind

+ const StatusCascadeClosedBy

+ const StatusCascadeOrphan

+ type SyncConfig struct

+ Cooldown string

+ type SyncState string

+ const SyncStateCleanRebase

+ const SyncStateConflictPredicted

+ const SyncStateFastForward

+ const SyncStateFetchFailed

+ const SyncStateLocalAhead

+ const SyncStateNoRemote

+ const SyncStateNoRepo

+ const SyncStateNoUpstream

+ const SyncStateSkipped

+ const SyncStateUpToDate

+ type SyncStatus struct

+ ConflictPaths []string

+ LocalAhead int

+ Reason string

+ RemoteAhead int

+ State SyncState

Apr 21, 2026

Changes in this version

+ const CurrentGraphSchemaVersion

+ const DefaultAgentTarget

+ const DefaultLLMConcurrency

+ const DefaultLLMModel

+ const DefaultLLMProvider

+ const DefaultScope

+ const SchemaMetaFileName

+ const SkillStampHash

+ const SkillStampVersion

+ func CanonicalizeFrontmatter(fm map[string]any) []byte

+ func ComputeSkillHash(fileContent []byte) string

+ func FormatSchemaMeta(m SchemaMeta) ([]byte, error)

+ func IsDevVersion(v string) bool

+ func IsValidKindForType(t EntryType, k Kind) bool

+ func RenderSkillFile(entry SkillBundleEntry, version, contentHash string) ([]byte, error)

+ func RewriteID(id string, newType EntryType) (string, error)

+ func SkillInstallDir(target AgentTarget, scope Scope, repoRoot, userHome string) (string, error)

+ type AgentTarget string

+ const AgentClaude

+ type CompatibilityResult struct

+ Compatible bool

+ IsDevBuild bool

+ Reason string

+ func CheckCompatibility(meta SchemaMeta, binaryVersion string, binarySchemaVersion int) CompatibilityResult

type Config

+ LLM LLMConfig

+ func MergeConfig(base, overlay *Config) *Config

type Entry

+ func (e *Entry) IsAspiration() bool

type Graph

+ func (g *Graph) Activities() []*Entry

+ func (g *Graph) Aspirations() []*Entry

+ func (g *Graph) Directives() []*Entry

+ func (g *Graph) RecentDone(n int) []*Entry

+ func (g *Graph) RecentInsights(n int) []*Entry

type GraphFilter

+ MissingKind bool

type Kind

+ const KindActivity

+ const KindAspiration

+ const KindDone

+ const KindFact

+ const KindGap

+ const KindInsight

+ const KindQuestion

+ func DefaultKindForType(t EntryType) Kind

+ type LLMConfig struct

+ APIKeys map[string]string

+ Concurrency int

+ Model string

+ OllamaEndpoint string

+ Provider string

+ RateLimitRPS float64

+ Timeout string

+ type SchemaMeta struct

+ GraphSchemaVersion int

+ MinimumVersion *string

+ func ParseSchemaMeta(data []byte) (*SchemaMeta, error)

+ type Scope string

+ const ScopeProject

+ const ScopeUser

+ type SkillBundle struct

+ Entries []SkillBundleEntry

+ Target AgentTarget

+ type SkillBundleEntry struct

+ Content []byte

+ RelPath string

+ Skill string

+ type SkillFile struct

+ AbsPath string

+ Content []byte

+ StoredHash string

+ StoredVersion string

+ func ParseSkillFile(absPath string, content []byte) *SkillFile

+ type SkillInstallStatus string

+ const SkillStatusCurrent

+ const SkillStatusMissing

+ const SkillStatusModified

+ const SkillStatusPristine

+ func ComputeSkillStatus(embedded SkillBundleEntry, installed *SkillFile) SkillInstallStatus

Apr 17, 2026

Changes in this version

+ const DefaultGraphDir

+ const SDDDirName

+ var LayerAbbrev = map[Layer]string

+ var LayerFromAbbrev = map[string]Layer

+ var TypeAbbrev = map[EntryType]string

+ var TypeFromAbbrev = map[string]EntryType

+ func AttachDirRelPath(id string) (string, error)

+ func DeriveBranchName(entryID, description string) string

+ func FormatConfig(cfg Config) string

+ func FormatFrontmatter(e *Entry) string

+ func FormatWIPMarker(m *WIPMarker) string

+ func GenerateID(typ EntryType, layer Layer, suffix string) string

+ func GenerateIDAt(typ EntryType, layer Layer, suffix string, t time.Time) string

+ func GenerateWIPMarkerID(participant string) string

+ func IDToRelPath(id string) (string, error)

+ func IsWIPDir(d fs.DirEntry) bool

+ func RandomSuffix(n int) (string, error)

+ func RelPathToID(rel string) (string, error)

+ func ResolveAttachmentLinks(content, id string) string

+ func ValidateEntry(e *Entry, g *Graph)

+ func WIPDir(graphDir string) string

+ func WIPMarkerPath(markerID string) string

+ type Config struct

+ GraphDir string

+ func ParseConfig(data []byte) (*Config, error)

+ type Entry struct

+ Attachments []string

+ Closes []string

+ Confidence string

+ Content string

+ ID string

+ Kind Kind

+ Layer Layer

+ Participants []string

+ Preflight string

+ Refs []string

+ Summary string

+ SummaryHash string

+ Supersedes []string

+ Time time.Time

+ Type EntryType

+ Warnings []Warning

+ func ParseEntry(filename, content string) (*Entry, error)

+ func (e *Entry) IsContract() bool

+ func (e *Entry) IsPlan() bool

+ func (e *Entry) LayerLabel() string

+ func (e *Entry) ShortContent(maxLen int) string

+ func (e *Entry) TypeLabel() string

+ type EntryType string

+ const TypeAction

+ const TypeDecision

+ const TypeSignal

+ type Graph struct

+ ByID map[string]*Entry

+ ClosedBy map[string][]string

+ Entries []*Entry

+ RefsTo map[string][]string

+ SupersededBy map[string][]string

+ func NewGraph(entries []*Entry) *Graph

+ func (g *Graph) ActiveDecisions() []*Entry

+ func (g *Graph) BuildShowTree(id string, maxDepth int, includeDownstream bool, ...) *ShowTree

+ func (g *Graph) Contracts() []*Entry

+ func (g *Graph) DerivedStatus(e *Entry) Status

+ func (g *Graph) Downstream(id string) []*Entry

+ func (g *Graph) Filter(f GraphFilter) []*Entry

+ func (g *Graph) GraphDir() string

+ func (g *Graph) Lint() []*Entry

+ func (g *Graph) OpenSignals() []*Entry

+ func (g *Graph) Plans() []*Entry

+ func (g *Graph) RecentActions(n int) []*Entry

+ func (g *Graph) RefChain(id string) []*Entry

+ func (g *Graph) ResolveID(input string) (string, error)

+ func (g *Graph) ResolveIDs(inputs []string) ([]string, error)

+ func (g *Graph) SetGraphDir(dir string)

+ func (g *Graph) TopologicalOrder() []*Entry

+ type GraphFilter struct

+ Kind Kind

+ Layer Layer

+ OpenOnly bool

+ Type EntryType

+ type IDParts struct

+ LayerCode string

+ Suffix string

+ Time time.Time

+ Timestamp string

+ TypeCode string

+ func ParseID(id string) (IDParts, error)

+ type Kind string

+ const KindContract

+ const KindDirective

+ const KindPlan

+ type Layer string

+ const LayerConceptual

+ const LayerOperational

+ const LayerProcess

+ const LayerStrategic

+ const LayerTactical

+ type ShowTree struct

+ Downstream []ShowTreeItem

+ Primary *Entry

+ Upstream []ShowTreeItem

+ type ShowTreeItem struct

+ Depth int

+ Entry *Entry

+ Relations []string

+ ShownAbove bool

+ ShownBelow bool

+ SummaryOnly bool

+ Truncated []TruncatedRef

+ type Status struct

+ By string

+ Kind StatusKind

+ type StatusKind string

+ const StatusActive

+ const StatusClosedBy

+ const StatusNone

+ const StatusOpen

+ const StatusSupersededBy

+ type TruncatedRef struct

+ ID string

+ Kind Kind

+ Relations []string

+ type WIPMarker struct

+ Branch string

+ Content string

+ Entry string

+ Exclusive bool

+ ID string

+ Participant string

+ Time time.Time

+ func HasExclusiveMarker(markers []*WIPMarker, entryID string) (*WIPMarker, bool)

+ func MarkersForEntry(markers []*WIPMarker, entryID string) []*WIPMarker

+ func ParseWIPMarker(filename, content string) (*WIPMarker, error)

+ func (m *WIPMarker) ShortContent(maxLen int) string

+ type Warning struct

+ Field string

+ Message string

+ Value string