Skip to content

office: add TurtleTerm operator flows#4

Closed
mdheller wants to merge 19 commits into
mainfrom
office/operator-flows
Closed

office: add TurtleTerm operator flows#4
mdheller wants to merge 19 commits into
mainfrom
office/operator-flows

Conversation

@mdheller
Copy link
Copy Markdown

@mdheller mdheller commented May 5, 2026

Summary

Adds the first TurtleTerm Office operator surface without implementing an office suite inside TurtleTerm.

The new office / /office flow produces deterministic SourceOS Office operator plans that point at sourceosctl office, include the TurtleTerm receipt command, and summarize OfficeArtifactEvidence runtime contract IDs when evidence is present.

Changes

  • Adds turtle-term office plan.
  • Adds /office plan alias support.
  • Adds turtle-term office evidence inspect <path>.
  • Emits operator-plan JSON with:
    • sourceos.turtleterm.office.operator_plan.v0
    • command_argv for sourceosctl office ...
    • receipt_command for turtle-term run -- sourceosctl office ...
    • expected office runtime contract kinds.
  • Emits evidence-summary JSON with:
    • sourceos.turtleterm.office.evidence_summary.v0
    • office document/version/writeback IDs when present.
  • Adds smoke coverage for normal office flow, /office alias, and evidence summary.
  • Updates README command examples and product surface list.

Boundary

No Google/Microsoft/Apple runtime dependency is introduced. TurtleTerm remains an operator/receipt surface and does not become the office runtime, WOPI host, or document engine.

Validation target

make turtle-smoke

The smoke target runs assets/sourceos/tests/test_sourceos_term_smoke.py and syntax checks packaging helpers.

mdheller added a commit that referenced this pull request May 23, 2026
Clean replay of the office operator surface from stale PR #4 onto current main.

Preserves the original office payload while avoiding overwrite of 80 intervening commits that landed after the stale branch diverged.

Includes:
- turtle-term office plan
- /office plan alias
- turtle-term office evidence inspect
- office operator-plan and evidence-summary JSON contracts
- smoke coverage preserving current agent-status tests
- README and install validation docs

Boundary: TurtleTerm remains an operator/receipt surface and does not become the office runtime, WOPI host, or document engine.

Validation observed on PR #21:
- TurtleTerm Script Checks: success
- TurtleTerm Linux Packaging: success
- TurtleTerm Security Checks: success
- Trust Surface: success
- verify-pages: success

Homebrew matrix was still in progress at merge attempt time and had passed audit on all runners.
Copy link
Copy Markdown
Author

Superseded by #21, which cleanly replayed the office operator payload onto current main after this branch had diverged by 80 commits.

What was preserved:

  • turtle-term office plan
  • /office plan alias
  • turtle-term office evidence inspect <path>
  • office operator-plan and evidence-summary JSON contracts
  • smoke coverage for plan, slash alias, and evidence summary
  • README/install validation docs

What was intentionally not preserved from this stale branch:

  • stale packaging/workflow churn that conflicted with newer mainline Linux packaging and Homebrew work.

Merged replacement commit: 58f6626.

@mdheller mdheller closed this May 23, 2026
@mdheller mdheller deleted the office/operator-flows branch May 30, 2026 22:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant