angela

package

Go to main page

Versions in this module

v1

v1.2.3

May 3, 2026

Changes in this version

+ const LogModeDryRun

+ const LogModeFull

+ const LogModeIncremental

+ const LogModeInteractive

+ const LogResultAIError

+ const LogResultAbortedArbitrate

+ const LogResultAbortedCorruptSrc

+ const LogResultDryRun

+ const LogResultWritten

+ const QuarantineTimestampLayout

+ var ErrArbitrateAbort = errors.New("polish: arbitration aborted")

+ var ErrArbitrateRefused = errors.New("polish: duplicate sections need TTY or --arbitrate-rule")

+ func AppendLogEntry(stateDir string, entry LogEntry) error

+ func FormatResolution(source string, choice ArbitrateChoice) string

+ func PolishLogPath(stateDir string) string

+ func ValidArbitrationRule(s string) bool

+ type ArbitrateChoice int

+ const ChoiceAbort

+ const ChoiceBoth

+ const ChoiceFirst

+ const ChoiceSecond

+ type ArbitrateOptions struct

+ Verbose bool

+ type ArbitrationRule string

+ const RuleAbort

+ const RuleBoth

+ const RuleFirst

+ const RuleNone

+ const RuleSecond

+ type DupGroup struct

+ Heading string

+ Occurrences []SectionLocation

+ type LogAIInfo struct

+ CompletionTokens int

+ Model string

+ PromptTokens int

+ Provider string

+ type LogDuplicate struct

+ Count int

+ Heading string

+ Resolution string

+ type LogEntry struct

+ AI *LogAIInfo

+ Exit int

+ File string

+ Findings LogFindings

+ Mode string

+ Op string

+ Result string

+ Timestamp time.Time

+ func ReadLogEntries(stateDir string) ([]LogEntry, error)

+ type LogFindings struct

+ Duplicates []LogDuplicate

+ LeakedFM *LogLeakedFM

+ type LogLeakedFM struct

+ Bytes int

+ Stripped bool

+ type Resolution struct

+ Choice ArbitrateChoice

+ Heading string

+ type SanitizeReport struct

+ DupGroups []DupGroup

+ LeakedFM StripInfo

+ Resolutions []Resolution

+ Source string

+ func DetectStructuralIssues(rawAIOutput []byte) ([]byte, SanitizeReport)

+ func SanitizeAIOutput(rawAIOutput []byte, rule ArbitrationRule, isTTY bool, streams domain.IOStreams, ...) (cleanedBody []byte, report SanitizeReport, err error)

+ type SectionLocation struct

+ ByteEnd int

+ ByteStart int

+ Heading string

+ Line int

+ Words int

+ type StripInfo struct

+ Bytes int

+ Line int

+ Stripped bool

v1.2.2

Apr 17, 2026

v1.2.1

Apr 17, 2026

v1.2.0

Apr 17, 2026

Changes in this version

+ func ApplySynthesizerProposal(p SynthesizerProposal) (string, domain.DocMeta, error)

+ func BuildPersonaReviewPrompt(personas []PersonaProfile) string

+ func ExpectedOutputTokens(inputTokens, maxOutput int) int

+ func ModelContextLimit(model string) (int, bool)

+ func ModelOutputSpeed(model string) (float64, bool)

+ func RenderBlockMarkdown(doc *synthesizer.Doc, block synthesizer.Block) string

type PersonaProfile

+ ReviewDirective string

+ func PersonaByName(name string) (PersonaProfile, bool)

type ReviewFinding

+ AgreementCount int

+ Personas []string

+ func RunSynthesizerReview(ctx context.Context, reader domain.CorpusReader, docs []domain.DocMeta, ...) ([]ReviewFinding, error)

type ReviewOpts

+ Personas []PersonaProfile

type Suggestion

+ func SynthesizerDraftSuggestions(docPath string, docContent []byte, registry *synthesizer.Registry, ...) []Suggestion

+ type SynthesizerProposal struct

+ Block synthesizer.Block

+ CandidateKey string

+ Doc *synthesizer.Doc

+ Evidence []synthesizer.Evidence

+ RenderedMarkdown string

+ Signature synthesizer.Signature

+ SynthesizerName string

+ Warnings []synthesizer.Warning

+ func SynthesizerProposalsForDoc(doc *synthesizer.Doc, registry *synthesizer.Registry, ...) ([]SynthesizerProposal, error)

v1.1.0

Apr 13, 2026

Changes in this version

+ const AnalyzerSchemaVersion

+ const BackupSuffix

+ const BackupTimeFormat

+ const DiffStatusNew

+ const DiffStatusPersisting

+ const DiffStatusRegressed

+ const DiffStatusResolved

+ const DraftStateVersion

+ const EvidenceModeLenient

+ const EvidenceModeOff

+ const EvidenceModeStrict

+ const PolishStateVersion

+ const ReviewDiffNew

+ const ReviewDiffPersisting

+ const ReviewDiffRegressed

+ const ReviewDiffResolved

+ const ReviewStateVersion

+ const SeverityError

+ const SeverityInfo

+ const SeverityWarning

+ const StatusActive

+ const StatusIgnored

+ const StatusResolved

+ var ErrStateCorrupt = errors.New("state file corrupt or incompatible")

+ var TUIStyleCursor = lipgloss.NewStyle().Bold(true).Foreground(lipgloss.Color("14"))

+ var TUIStyleDim = lipgloss.NewStyle().Faint(true)

+ var TUIStyleError = lipgloss.NewStyle().Foreground(lipgloss.Color("9"))

+ var TUIStyleHelpKey = lipgloss.NewStyle().Bold(true).Foreground(lipgloss.Color("14"))

+ var TUIStyleInfo = lipgloss.NewStyle().Foreground(lipgloss.Color("8"))

+ var TUIStyleSpinner = lipgloss.NewStyle().Foreground(lipgloss.Color("14"))

+ var TUIStyleTitle = lipgloss.NewStyle().Bold(true)

+ var TUIStyleWarning = lipgloss.NewStyle().Foreground(lipgloss.Color("11"))

+ func AnnotateAndDiff(prev *DraftState, currentFiles map[string][]Suggestion) (DraftDiff, []ResolvedSuggestion)

+ func AssertContainedRelPath(relPath string) error

+ func AutofixDryRun(original, fixed, filename string) string

+ func AutofixWriteWithBackup(docPath, fixed string, backupEnabled bool, workDir, stateDir string) (string, error)

+ func BuildDeepDivePrompt(finding ReviewFinding, reader domain.CorpusReader) (string, string)

+ func BuildReviewPromptWithVHS(docs []DocSummary, styleGuide string, signals *CorpusSignals, vhs *VHSSignals, ...) (string, string)

+ func ContentHash(content []byte) string

+ func DescribePersonas(scored []ScoredPersona) string

+ func DetectChangedSections(sections []Section, stored map[string]string, minChangeLines int) ([]int, bool)

+ func DetectLanguage(line string) string

+ func DetectLanguageMultiLine(lines []string) string

+ func DraftFindingHash(filename string, s Suggestion) string

+ func EstimateCost(model string, inputTokens, outputTokens int) float64

+ func ExitCodeFor(suggestions []Suggestion, failOn string) int

+ func FormatAutofixReport(report AutofixReport) string

+ func FormatScore(s QualityScore) string

+ func FormatScoreDetail(s QualityScore) string

+ func HashReviewFindingWithAudience(f ReviewFinding, audience string) string

+ func HashSections(sections []Section) map[string]string

+ func IsInteractiveAvailable() bool

+ func IsTTYAvailable() bool

+ func MarkIgnored(state *ReviewState, hash, reason string, now time.Time) error

+ func MarkResolved(state *ReviewState, hash, by string, now time.Time) error

+ func MergeSections(sections []Section) string

+ func PolishMultiPass(ctx context.Context, provider domain.AIProvider, doc string, ...) (string, error)

+ func PostProcess(original, polished string) string

+ func PruneMissingEntries(state *DraftState, currentFiles map[string]bool) int

+ func PruneOldBackups(backupDir string, retentionDays int) error

+ func QuarantineCorruptState(path string) (string, error)

+ func ReanalyzeAfterFix(fixed string, meta domain.DocMeta, guide *StyleGuide, corpus []domain.DocMeta) int

+ func ResolveByPrefix(state *ReviewState, prefix string) (string, error)

+ func RestoreBackup(workDir, relPath, backupPath string) error

+ func ReviewFindingHash(f ReviewFinding) string

+ func SaveDraftState(path string, state *DraftState) error

+ func SavePolishState(path string, state *PolishState) error

+ func SaveReviewState(path string, state *ReviewState) error

+ func SerializeTOONWithVHS(summaries []DocSummary, signals *CorpusSignals, vhs *VHSSignals) string

+ func SetBackupClock(now func() time.Time) func()

+ func ShouldMultiPass(docWordCount int) bool

+ func SortDraftFindings(findings []DraftFinding)

+ func UnifiedDiffString(original, modified string, opts UnifiedDiffOptions) (string, error)

+ func UpdateReviewState(state *ReviewState, diff ReviewDiff, now time.Time)

+ func WriteBackup(workDir, stateDir, backupSubdir, relPath string) (string, error)

+ func WriteUnifiedDiff(w io.Writer, original, modified string, opts UnifiedDiffOptions) error

+ type AutoResult struct

+ Accepted int

+ Asked int

+ Details []string

+ Rejected int

+ type AutofixFileResult struct

+ Error error

+ Filename string

+ Fixed []string

+ Skipped []string

+ StillPresent int

+ func RunAutofix(content string, meta domain.DocMeta, mode AutofixMode, corpus []domain.DocMeta) (string, AutofixFileResult)

+ type AutofixMode int

+ const AutofixAggressive

+ const AutofixSafe

+ func ParseAutofixMode(s string) (AutofixMode, error)

+ type AutofixReport struct

+ Errors int

+ Files []AutofixFileResult

+ FilesModified int

+ FilesSkipped int

+ FindingsFixed int

+ type BackupEntry struct

+ Path string

+ Stamp string

+ Timestamp time.Time

+ func FindBackupByStamp(entries []BackupEntry, stamp string) (BackupEntry, bool)

+ func ListBackups(stateDir, backupSubdir, relPath string) ([]BackupEntry, error)

type CorpusSignals

+ ScopeClusters map[string][]string

+ ScopeTypes map[string]string

+ UnconsolidatedScopes []ScopeGroup

+ type DiffChoice int

+ const DiffAccept

+ const DiffBoth

+ const DiffReject

type DiffHunk

+ Lines []DiffLine

+ type DiffLine struct

+ Kind byte

+ Text string

type DiffOptions

+ Auto bool

type DocSummary

+ Branch string

+ Scope string

+ type DraftDiff struct

+ New int

+ Persisting int

+ Resolved int

+ type DraftEntry struct

+ AnalyzerSchemaVersion int

+ ContentHash string

+ Grade string

+ LastAnalyzed time.Time

+ Profile string

+ Score int

+ Suggestions []Suggestion

+ type DraftFinding struct

+ Filename string

+ Hash string

+ Suggestion Suggestion

+ type DraftInteractiveModel struct

+ QuitSummary string

+ func NewDraftInteractiveModel(findings []DraftFinding, docsDir string, meta map[string]domain.DocMeta, ...) DraftInteractiveModel

+ func (m DraftInteractiveModel) Init() tea.Cmd

+ func (m DraftInteractiveModel) Update(msg tea.Msg) (tea.Model, tea.Cmd)

+ func (m DraftInteractiveModel) View() string

+ type DraftState struct

+ Entries map[string]DraftEntry

+ LastRun time.Time

+ Version int

+ func LoadDraftState(path string) (*DraftState, error)

+ type Evidence struct

+ File string

+ Line int

+ Quote string

+ type EvidenceValidation struct

+ MinConfidence float64

+ Mode string

+ Required bool

+ type FactualClaim struct

+ Core string

+ Section string

+ Text string

+ Type string

+ type GIFRef struct

+ DocFilename string

+ GIFPath string

+ type HallucinationCheck struct

+ NewFactualClaims []FactualClaim

+ Unsupported []FactualClaim

+ func CheckHallucinations(original, polished, corpusSummary string) HallucinationCheck

+ type HunkClass int

+ const HunkCosmetic

+ const HunkMajorDeletion

+ const HunkModification

+ const HunkPureAddition

+ const HunkPureDeletion

+ func ClassifyHunk(h DiffHunk) HunkClass

+ type IncrementalOpts struct

+ Audience string

+ ConfigMaxToks int

+ CorpusSummary string

+ Meta domain.DocMeta

+ MinChangeLines int

+ Personas []PersonaProfile

+ Provider domain.AIProvider

+ StyleGuide string

+ type IncrementalResult struct

+ ChangedCount int

+ NewHashes map[string]string

+ Polished string

+ Skipped bool

+ WasIncremental bool

+ func PolishIncremental(ctx context.Context, doc string, storedHashes map[string]string, ...) (*IncrementalResult, error)

+ type LangRule struct

+ CaseInsensitive bool

+ Contains []string

+ Lang string

+ Prefixes []string

+ type MultiPassProgress func(sectionIndex, totalSections int, heading string, changed bool)

type PersonaProfile

+ func SelectPersonasForDoc(docType string, cfg config.PersonasConfig) []PersonaProfile

+ type PolishInteractiveModel struct

+ FinalDoc string

+ QuitSummary string

+ Written bool

+ func NewPolishInteractiveModel(original, polished, filename string) PolishInteractiveModel

+ func (m PolishInteractiveModel) Init() tea.Cmd

+ func (m PolishInteractiveModel) Update(msg tea.Msg) (tea.Model, tea.Cmd)

+ func (m PolishInteractiveModel) View() string

+ type PolishOpts struct

+ Audience string

+ ConfigMaxToks int

+ type PolishState struct

+ Entries map[string]PolishStateEntry

+ Version int

+ func LoadPolishState(path string) (*PolishState, error)

+ type PolishStateEntry struct

+ LastPolished time.Time

+ SectionHashes map[string]string

+ type PostCallAnalysis struct

+ Lines []string

+ func AnalyzeUsage(usage *domain.AIUsage, elapsed time.Duration, maxOutputTokens int) *PostCallAnalysis

+ type PreflightResult struct

+ AbortReason string

+ EstimatedCost float64

+ EstimatedInputTokens int

+ MaxOutputTokens int

+ ShouldAbort bool

+ Timeout time.Duration

+ Warnings []string

+ func Preflight(doc string, systemPrompt string, model string, maxOutputTokens int, ...) *PreflightResult

+ type QualityScore struct

+ Breakdown map[string]int

+ Grade string

+ Missing []string

+ Profile string

+ Total int

+ func ScoreDocument(content string, meta domain.DocMeta) QualityScore

+ type RejectedFinding struct

+ Finding ReviewFinding

+ Reason string

+ type ResolvedSuggestion struct

+ File string

+ Suggestion Suggestion

+ type ReviewDiff struct

+ New []ReviewFinding

+ Persisting []ReviewFinding

+ Regressed []ReviewFinding

+ Resolved []ReviewFinding

+ func ComputeReviewDiff(prev *ReviewState, current []ReviewFinding) ReviewDiff

+ func ComputeReviewDiffWithAudience(prev *ReviewState, current []ReviewFinding, audience string) ReviewDiff

+ func ComputeReviewDiffWithRejected(prev *ReviewState, current []ReviewFinding, rejected []RejectedFinding, ...) ReviewDiff

+ func (d ReviewDiff) Counts() (new_, persisting, regressed, resolved int)

+ type ReviewFilter struct

+ All bool

+ Pattern *regexp.Regexp

type ReviewFinding

+ Confidence float64

+ DiffStatus string

+ Evidence []Evidence

+ Hash string

+ Relevance string

+ type ReviewInteractiveModel struct

+ QuitSummary string

+ func NewReviewInteractiveModel(findings []ReviewFinding, state *ReviewState, statePath string, ...) ReviewInteractiveModel

+ func (m ReviewInteractiveModel) Init() tea.Cmd

+ func (m ReviewInteractiveModel) Update(msg tea.Msg) (tea.Model, tea.Cmd)

+ func (m ReviewInteractiveModel) View() string

+ type ReviewOpts struct

+ Audience string

+ ConfigMaxTokens int

+ Evidence EvidenceValidation

+ Reader domain.CorpusReader

+ VHSSignals *VHSSignals

type ReviewReport

+ Diff *ReviewDiff

+ Rejected []RejectedFinding

+ type ReviewState struct

+ Findings map[string]StatefulFinding

+ LastRun time.Time

+ Version int

+ func LoadReviewState(path string) (*ReviewState, error)

+ type ScopeGroup struct

+ DocCount int

+ Scope string

type ScoredPersona

+ func ResolvePersonasForAudience(docType, body, audience string) []ScoredPersona

+ type Section struct

+ Body string

+ Heading string

+ Index int

+ func SplitSections(doc string) []Section

+ type SectionDecision int

+ const DecisionAccepted

+ const DecisionEdited

+ const DecisionPending

+ const DecisionRejected

+ const DecisionSkipped

+ type SectionDiff struct

+ Changed bool

+ Decision SectionDecision

+ EditedContent string

+ Heading string

+ IsNew bool

+ IsRemoved bool

+ Original string

+ Polished string

+ func ComputeSectionDiffs(original, polished string) []SectionDiff

+ type StatefulFinding struct

+ Finding ReviewFinding

+ FirstSeen time.Time

+ IgnoreReason string

+ LastSeen time.Time

+ ResolvedAt *time.Time

+ ResolvedBy string

+ Status string

+ func LogEntries(state *ReviewState) []StatefulFinding

type Suggestion

+ DiffStatus string

+ func ApplySeverityOverride(suggestions []Suggestion, override map[string]string) []Suggestion

+ func PromoteWarningsToErrors(suggestions []Suggestion) []Suggestion

+ type TapeMismatch struct

+ Command string

+ Reason string

+ TapeFile string

+ type UnifiedDiffOptions struct

+ Colored bool

+ Context int

+ FromFile string

+ ToFile string

+ type VHSSignals struct

+ CommandMismatches []TapeMismatch

+ OrphanGIFs []GIFRef

+ OrphanTapes []string

+ TapeCommands map[string][]string

+ TapeOutputs map[string]string

+ func AnalyzeVHSSignals(tapeDir, docsDir string, knownCommands []string) *VHSSignals

+ type ValidationResult struct

+ Rejected []RejectedFinding

+ Valid []ReviewFinding

+ func ValidateFindings(findings []ReviewFinding, reader domain.CorpusReader, v EvidenceValidation) ValidationResult

v1.0.0

Apr 1, 2026

Changes in this version

+ func ApplyDiff(original string, hunks []DiffHunk, accepted []bool) string

+ func AverageScore(scored []ScoredPersona) float64

+ func BuildCorpusSummary(corpus []domain.DocMeta) string

+ func BuildPersonaPrompt(personas []PersonaProfile) string

+ func BuildPolishPrompt(doc string, meta domain.DocMeta, styleGuide string, corpusSummary string, ...) (string, string)

+ func BuildReviewPrompt(docs []DocSummary, styleGuide string, signals *CorpusSignals) (string, string)

+ func ExtractAdaptiveSummary(body string, maxRunes int) string

+ func FormatDiff(hunks []DiffHunk, streams domain.IOStreams)

+ func FormatStyleGuideRules(guide *StyleGuide) string

+ func InteractiveDiff(hunks []DiffHunk, streams domain.IOStreams, opts DiffOptions) ([]bool, error)

+ func Polish(ctx context.Context, provider domain.AIProvider, doc string, ...) (string, error)

+ func ResolveMaxTokens(mode string, docWordCount int) int

+ func SaveReviewCache(loreDir string, report *ReviewReport, totalDocs int) error

+ func SerializeTOON(summaries []DocSummary, signals *CorpusSignals) string

+ type CorpusSignals struct

+ IsolatedDocs []string

+ PotentialPairs []DocPair

+ TagClusters map[string][]string

+ TypeDistribution map[string]int

+ func AnalyzeCorpusSignals(docs []DocSummary) *CorpusSignals

+ type DiffHunk struct

+ ContextAfter []string

+ ContextBefore []string

+ ModCount int

+ ModStart int

+ Modified []string

+ OrigCount int

+ OrigStart int

+ Original []string

+ func ComputeDiff(original, modified string) []DiffHunk

+ type DiffOptions struct

+ DryRun bool

+ YesAll bool

+ type DocPair struct

+ DaysDiff int

+ DocA string

+ DocB string

+ Tags string

+ Type string

+ type DocSummary struct

+ Date string

+ Filename string

+ Summary string

+ Tags []string

+ Type string

+ func PrepareDocSummaries(reader domain.CorpusReader) ([]DocSummary, int, error)

+ type DraftCheck struct

+ Check func(body string, sections map[string]string) *Suggestion

+ Label string

+ type PersonaProfile struct

+ ContentSignals []string

+ DisplayName string

+ DocTypes []string

+ DraftChecks []DraftCheck

+ Expertise string

+ Icon string

+ Name string

+ Principles []string

+ PromptDirective string

+ func GetRegistry() []PersonaProfile

+ func Profiles(scored []ScoredPersona) []PersonaProfile

+ type ReviewCache struct

+ DocCount int

+ Findings []ReviewFinding

+ LastReview time.Time

+ TotalDocs int

+ Version int

+ func LoadReviewCache(loreDir string) (*ReviewCache, error)

+ type ReviewFinding struct

+ Description string

+ Documents []string

+ Severity string

+ Title string

+ type ReviewReport struct

+ DocCount int

+ Findings []ReviewFinding

+ func Review(ctx context.Context, provider domain.AIProvider, docs []DocSummary, ...) (*ReviewReport, error)

+ type ScoredPersona struct

+ Profile PersonaProfile

+ Score int

+ func ResolvePersonas(docType, body string) []ScoredPersona

+ type StyleGuide struct

+ MaxBodyLength int

+ MinTags int

+ RequireAlternatives bool

+ RequireWhy bool

+ Warnings []Suggestion

+ func ParseStyleGuide(rules map[string]interface{}) *StyleGuide

+ type Suggestion struct

+ Category string

+ Message string

+ Severity string

+ func AnalyzeDraft(doc string, meta domain.DocMeta, guide *StyleGuide, corpus []domain.DocMeta, ...) []Suggestion

+ func CheckCoherence(doc string, meta domain.DocMeta, corpus []domain.DocMeta) []Suggestion

+ func RunPersonaDraftChecks(body string, personas []PersonaProfile) []Suggestion

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