advice

package
v0.5.7 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 3, 2026 License: Apache-2.0 Imports: 4 Imported by: 0

Documentation

Overview

Package advice is what a checkpoint receipt says about the checkpoint it just wrote: the placeholders it dropped and the fields it kept as given but doubts.

The CLI and the MCP server used to build these sentences each for itself, and they drifted — a nudge added to one front end reached agents on that host only, and a wording fix had to be found and made twice. The checks and the sentences live here; a front end supplies only how its fields are spelled, "--next" on a command line and `next` in a tool call.

Index

Constants

This section is empty.

Variables

View Source
var CLI = Fields{
	Next: "--next", Questions: "--question", Intent: "--intent", Failed: "--failed", Verified: "--verified",
	Decision: [2]string{"--decided entry", "--decided entries"},
	RuledOut: [2]string{"--failed entry", "--failed entries"},
}

CLI is `logos checkpoint`'s spelling.

View Source
var MCP = Fields{
	Next: "`next`", Questions: "`questions`", Intent: "`intent`", Failed: "`failed`", Verified: "`verified`",
	Decision: [2]string{"decision", "decisions"},
	RuledOut: [2]string{"ruled-out approach", "ruled-out approaches"},
}

MCP is the checkpoint tool's spelling.

Functions

func Checkpoint

func Checkpoint(c session.Checkpoint, earlier []session.Checkpoint, dropped int, f Fields) []string

Checkpoint returns the receipt's sentences for c, in the order an agent should act on them. dropped is how many placeholder failed entries the caller removed before committing; earlier is the project's history as it stood before this checkpoint, which the intent check reads.

Every sentence after the first is "recorded as given": a checkpoint is written when context is running out, so nothing here refuses one — it says the doubt out loud instead.

func Claims added in v0.5.5

func Claims(c session.Checkpoint, r claims.Report, f Fields) (out []string, asked bool)

Claims returns the receipt's sentences for what the activity log said about c's claims, and whether one of them is the empty-failed question — which the caller then marks in the log, so it is asked once a session.

Types

type Fields

type Fields struct {
	Next, Questions, Intent, Failed, Verified string
	Decision, RuledOut                        [2]string
}

Fields is how one front end names a checkpoint's fields, so a nudge tells the agent the exact thing to type. The paired nouns are singular and plural.

Jump to

Keyboard shortcuts

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