probe

package
v0.56.0 Latest Latest
Warning

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

Go to latest
Published: Nov 6, 2026 License: MIT Imports: 10 Imported by: 0

Documentation

Overview

Package probe runs the deterministic detection probes bin/f10-load-project.sh runs: host and CLI routing, stack and verify markers, existing plans. Each answer carries the evidence that produced it.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Probes

type Probes struct {
	RemoteURL string   `json:"remote,omitempty"` // origin url; empty without an origin
	Host      string   `json:"host,omitempty"`   // hostname of the remote; empty for a local-path remote
	CLI       Signal   `json:"cli"`              // "gh", "glab", "unknown" or "none"
	Stack     []Signal `json:"stack,omitempty"`  // marker files at the checkout root
	Verify    []Signal `json:"verify,omitempty"`
	Review    *Review  `json:"review,omitempty"` // a CI review workflow, when one uses the Claude Code action
	Plans     []string `json:"plans,omitempty"`  // plan filenames under the storage root
	PlansDir  string   `json:"plansDir"`
}

Probes holds everything detection can say about a checkout.

func Run

func Run(ctx context.Context, lay *layout.Layout) *Probes

Run probes the located checkout. Read-only, like everything here.

type Review added in v0.26.0

type Review struct {
	Reviewer string `json:"reviewer"`          // the login that posts: claude[bot], or github-actions[bot] with a github_token
	Trigger  string `json:"trigger"`           // "automatic", "manual", or "automatic, manual"
	Mention  string `json:"mention,omitempty"` // the comment that triggers a manual run, "@claude" by default
	Workflow string `json:"workflow"`          // the workflow file, relative to the checkout root: the evidence
}

A Review is the remote review a workflow running the Claude Code action declares: who posts and what fires it. Where it arrives and what marks it handled are the action's defaults, which facts.Scaffold writes as declared.

type Signal

type Signal struct {
	Value    string `json:"value"`
	Evidence string `json:"evidence"`
	// Judgment marks guidance rather than commands: a build file with no
	// lint or test entry, or a bare stack. Never written into project.md.
	Judgment bool `json:"judgment,omitempty"`
}

A Signal is one detected value plus the evidence that produced it.

func VerifyPicked added in v0.49.0

func VerifyPicked(signals []Signal) ([]Signal, bool)

VerifyPicked is the signals verify runs from: the commands found, else the judgments, never both, so a found command is never mixed with a guess.

Jump to

Keyboard shortcuts

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