Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions internal/agent/system_prompt_preview.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
package agent

// BuildSystemPromptPreview returns the same system prompt a run would seed for
// the supplied options. It is intended for non-runtime reporting surfaces that
// need to estimate prompt footprint without starting a provider call.
func BuildSystemPromptPreview(options Options) string {
return buildSystemPrompt(options)
}
3 changes: 3 additions & 0 deletions internal/cli/app.go
Original file line number Diff line number Diff line change
Expand Up @@ -167,6 +167,8 @@ func runWithDeps(args []string, stdout io.Writer, stderr io.Writer, deps appDeps
return runProviders(args[1:], stdout, stderr, deps)
case "doctor":
return runDoctor(args[1:], stdout, stderr, deps)
case "context":
return runContext(args[1:], stdout, stderr, deps)
case "search", "find":
return runSearch(args[1:], stdout, stderr, deps)
case "sessions", "session":
Expand Down Expand Up @@ -421,6 +423,7 @@ Commands:
models List Zero model registry entries
providers Inspect resolved provider profiles
doctor Run backend health checks for config and provider setup
context Report workspace context budget usage
search Search persisted local Zero session events
find Alias for search
sessions Inspect local Zero session lineage
Expand Down
1 change: 1 addition & 0 deletions internal/cli/app_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -562,6 +562,7 @@ func assertHelpOutput(t *testing.T, args []string) {
"models",
"providers",
"doctor",
"context",
"search",
"plugins",
"hooks",
Expand Down
91 changes: 91 additions & 0 deletions internal/cli/context.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
package cli

import (
"fmt"
"io"
"strings"

"github.com/Gitlawb/zero/internal/config"
"github.com/Gitlawb/zero/internal/contextreport"
"github.com/Gitlawb/zero/internal/modelregistry"
)

type contextOptions struct {
json bool
}

func runContext(args []string, stdout io.Writer, stderr io.Writer, deps appDeps) int {
options, help, err := parseContextArgs(args)
if err != nil {
return writeExecUsageError(stderr, err.Error())
}
if help {
if err := writeContextHelp(stdout); err != nil {
return exitCrash
}
return exitSuccess
}

workspaceRoot, err := resolveWorkspaceRoot("", deps)
if err != nil {
return writeExecUsageError(stderr, err.Error())
}
resolved, err := deps.resolveConfig(workspaceRoot, config.Overrides{})
if err != nil {
return writeAppError(stderr, err.Error(), exitProvider)
}

modelRegistry, err := modelregistry.DefaultRegistry()
if err != nil {
return writeAppError(stderr, err.Error(), exitCrash)
}
report, err := contextreport.Build(contextreport.Options{
WorkspaceRoot: workspaceRoot,
Provider: resolved.Provider,
Registry: newCoreRegistry(workspaceRoot),
ContextWindow: modelContextWindow(modelRegistry, resolved.Provider.Model),
})
if err != nil {
return writeAppError(stderr, err.Error(), exitCrash)
}
if options.json {
if err := writePrettyJSON(stdout, report); err != nil {
return exitCrash
}
return exitSuccess
}
if _, err := fmt.Fprintln(stdout, contextreport.Format(report)); err != nil {
return exitCrash
}
return exitSuccess
}

func parseContextArgs(args []string) (contextOptions, bool, error) {
options := contextOptions{}
for _, arg := range args {
switch {
case arg == "-h" || arg == "--help" || arg == "help":
return options, true, nil
case arg == "--json":
options.json = true
case strings.HasPrefix(arg, "-"):
return options, false, execUsageError{fmt.Sprintf("unknown context flag %q", arg)}
default:
return options, false, execUsageError{fmt.Sprintf("unexpected context argument %q", arg)}
}
}
return options, false, nil
}

func writeContextHelp(w io.Writer) error {
_, err := fmt.Fprint(w, `Usage:
zero context [flags]

Reports the current workspace context budget.

Flags:
--json Print JSON report
-h, --help Show this help
`)
return err
}
131 changes: 131 additions & 0 deletions internal/cli/context_test.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,131 @@
package cli

import (
"bytes"
"encoding/json"
"strings"
"testing"

"github.com/Gitlawb/zero/internal/config"
)

func TestRunContextHelp(t *testing.T) {
var stdout bytes.Buffer
var stderr bytes.Buffer

exitCode := runWithDeps([]string{"context", "--help"}, &stdout, &stderr, appDeps{})

if exitCode != exitSuccess {
t.Fatalf("expected exit code %d, got %d: %s", exitSuccess, exitCode, stderr.String())
}
for _, want := range []string{"Usage:", "zero context [flags]", "--json", "-h, --help"} {
if !strings.Contains(stdout.String(), want) {
t.Fatalf("expected context help to contain %q, got %q", want, stdout.String())
}
}
if stderr.Len() != 0 {
t.Fatalf("expected empty stderr, got %q", stderr.String())
}
}

func TestRunContextTextReport(t *testing.T) {
var stdout bytes.Buffer
var stderr bytes.Buffer
cwd := t.TempDir()

exitCode := runWithDeps([]string{"context"}, &stdout, &stderr, appDeps{
getwd: func() (string, error) {
return cwd, nil
},
resolveConfig: func(workspaceRoot string, overrides config.Overrides) (config.ResolvedConfig, error) {
if workspaceRoot != cwd {
t.Fatalf("workspaceRoot = %q, want %q", workspaceRoot, cwd)
}
return config.ResolvedConfig{
Provider: config.ProviderProfile{
Name: "openai",
ProviderKind: config.ProviderKindOpenAI,
Model: "gpt-4.1",
},
}, nil
},
})

if exitCode != exitSuccess {
t.Fatalf("expected exit code %d, got %d: %s", exitSuccess, exitCode, stderr.String())
}
for _, want := range []string{"Zero context report", "root: " + cwd, "model: gpt-4.1"} {
if !strings.Contains(stdout.String(), want) {
t.Fatalf("expected context output to contain %q, got %q", want, stdout.String())
}
}
if stderr.Len() != 0 {
t.Fatalf("expected empty stderr, got %q", stderr.String())
}
}

func TestRunContextJSONReport(t *testing.T) {
var stdout bytes.Buffer
var stderr bytes.Buffer
cwd := t.TempDir()

exitCode := runWithDeps([]string{"context", "--json"}, &stdout, &stderr, appDeps{
getwd: func() (string, error) {
return cwd, nil
},
resolveConfig: func(string, config.Overrides) (config.ResolvedConfig, error) {
return config.ResolvedConfig{
Provider: config.ProviderProfile{
Name: "openai",
ProviderKind: config.ProviderKindOpenAI,
Model: "gpt-4.1",
},
}, nil
},
})

if exitCode != exitSuccess {
t.Fatalf("expected exit code %d, got %d: %s", exitSuccess, exitCode, stderr.String())
}
var report struct {
Root string `json:"root"`
ModelID string `json:"modelId"`
ContextWindow int `json:"contextWindow"`
ToolCount int `json:"toolCount"`
}
if err := json.Unmarshal(stdout.Bytes(), &report); err != nil {
t.Fatalf("context JSON did not decode: %v\n%s", err, stdout.String())
}
if report.Root != cwd {
t.Fatalf("Root = %q, want %q", report.Root, cwd)
}
if report.ModelID != "gpt-4.1" {
t.Fatalf("ModelID = %q, want gpt-4.1", report.ModelID)
}
if report.ContextWindow <= 0 {
t.Fatalf("ContextWindow = %d, want > 0", report.ContextWindow)
}
if report.ToolCount <= 0 {
t.Fatalf("ToolCount = %d, want > 0", report.ToolCount)
}
if stderr.Len() != 0 {
t.Fatalf("expected empty stderr, got %q", stderr.String())
}
}

func TestRunContextRejectsUnknownFlag(t *testing.T) {
var stdout bytes.Buffer
var stderr bytes.Buffer

exitCode := runWithDeps([]string{"context", "--wat"}, &stdout, &stderr, appDeps{})

if exitCode != exitUsage {
t.Fatalf("expected usage exit %d, got %d", exitUsage, exitCode)
}
if stdout.Len() != 0 {
t.Fatalf("expected empty stdout, got %q", stdout.String())
}
if !strings.Contains(stderr.String(), `unknown context flag "--wat"`) {
t.Fatalf("expected unknown flag error, got %q", stderr.String())
}
}
Loading
Loading