chore: sync public mirror from internal

[haasonsaas]

Summary

• sync the sanitized public tree from evalops/maestro-internal
• keep evalops/maestro as a generated public mirror of the private source of truth
• preserve public-owned CI and trusted-publishing workflows from the public checkout
• internal source SHA: 391eeda3bfbda4d58dc4a7e007593ec3cf5deae1
• last generated public sync base: 8d2c2a5cd39b1273592e9363d094d6e44d216bbb
• previewed public-tree drift: 29 file(s) to copy/update and 0 stale file(s) to delete
• public-only commits since last generated sync: 0

Source-of-truth status

Public Mirror Drift Audit

• package: @evalops/maestro
• private source: https://github.com/evalops/maestro-internal@main (391eeda3bfbd)
• public projection: https://github.com/evalops/maestro@main (8d2c2a5cd39b)
• files to copy or update: 29
• stale files to delete: 0
• result: drift detected
• invariant: public_projection_has_drift

Sample Changed Paths

• copy/update packages/tui-rs/src/app.rs
• copy/update packages/tui-rs/src/session/entries.rs
• copy/update packages/tui-rs/src/session/export.rs
• copy/update packages/tui-rs/src/session/wire_format_generated.rs
• copy/update packages/tui-rs/src/session/writer.rs
• copy/update src/agent/compaction.ts
• copy/update src/agent/types.ts
• copy/update src/bootstrap/agent-creation-setup.ts
• copy/update src/cli/args.ts
• copy/update src/cli/commands/context.ts
• copy/update src/cli/help.ts
• copy/update src/cli/system-prompt.ts
• copy/update src/config/index.ts
• copy/update src/config/toml-config.ts
• copy/update src/main.ts
• copy/update src/prompts/system-prompt.ts
• copy/update src/prompts/types.ts
• copy/update src/server/hosted-session-manager.ts
• copy/update src/session/manager.ts
• copy/update src/session/session-branch.ts
• copy/update src/session/types.ts
• copy/update src/session/wire-format.generated.ts
• copy/update src/session/wire-format.manifest.json
• copy/update src/web-server.ts
• copy/update test/agent/perform-compaction.test.ts
• ... 4 more

Guidance

Let internal main generate and merge the public sync PR before relying on public main.

Drift sample

• copy/update packages/tui-rs/src/app.rs
• copy/update packages/tui-rs/src/session/entries.rs
• copy/update packages/tui-rs/src/session/export.rs
• copy/update packages/tui-rs/src/session/wire_format_generated.rs
• copy/update packages/tui-rs/src/session/writer.rs
• copy/update src/agent/compaction.ts
• copy/update src/agent/types.ts
• copy/update src/bootstrap/agent-creation-setup.ts
• copy/update src/cli/args.ts
• copy/update src/cli/commands/context.ts
• copy/update src/cli/help.ts
• copy/update src/cli/system-prompt.ts
• copy/update src/config/index.ts
• copy/update src/config/toml-config.ts
• copy/update src/main.ts
• copy/update src/prompts/system-prompt.ts
• copy/update src/prompts/types.ts
• copy/update src/server/hosted-session-manager.ts
• copy/update src/session/manager.ts
• copy/update src/session/session-branch.ts

Public-only commits since last generated sync

• none detected since last generated sync

Validation

• generated by the sync-public-release-mirror workflow in public-tree mode

[cursor]

PR Summary

Medium Risk
Introduces a new promptContextManifest field that flows through prompt assembly, agent state, and session serialization (TS and Rust), which could affect session compatibility and compaction behavior. Adds a new CLI command and refactors prompt-context loading logic, so regressions would mainly surface as missing/incorrect context or broken imports/exports.

Overview
Adds a structured PromptProjectDocManifest that records which project instruction files (e.g. AGENTS.md/CLAUDE.md) were loaded into the system prompt, including byte budgets, hashes, truncation, and diagnostics.

Propagates this manifest through prompt resolution (resolveMaestroSystemPrompt/finalizeSystemPrompt), agent creation/state, compaction restore filtering, and persists it in session headers and wire formats (TS + tui-rs), with updated tests.

Introduces maestro context explain to print the manifest (human-readable or --json) and updates CLI arg parsing/help to support it.

^{Reviewed by Cursor Bugbot for commit 698cd9f. Bugbot is set up for automated code reviews on this repo. Configure here.}