Skip to content

Add read-only ADR and 2026-07-23 e2e testbench results - #79

Merged
jstirnaman merged 25 commits into
mainfrom
codex/phase1-readonly-plan
Jul 29, 2026
Merged

Add read-only ADR and 2026-07-23 e2e testbench results#79
jstirnaman merged 25 commits into
mainfrom
codex/phase1-readonly-plan

Conversation

@jstirnaman

@jstirnaman jstirnaman commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator

What changed

  • docs/adr/0001-phase1-readonly-query-capability.md: the Phase 1 read-only query capability plan, refiled as ADR 0001 (Accepted, implemented in Feat: Implement Phase 1 read-only MCP plan #69) — goals, end-user scenarios, tool surface, safety checks, and telemetry design.
  • e2e-results/2026-07-23.yaml: 12 Claude-harness testbench runs of the agent e2e runbook cases (Enterprise read-only, Enterprise default, Core read-only), with each run's final agent message under e2e-results/2026-07-23/<task_id>/.
  • All 12 runs graded against the docs-tooling e2e manifest; every run is passed. Notes record grading judgment: a shorter-than-target tool path (ro-wildcard-field-low), markdown-table-instead-of-JSON output (ro-influxql-regex), and the soft-delete tombstone artifact seen by later runs (safety-conditional-write default; see list_tables/describe_table surface soft-deleted table tombstones with no way to distinguish them from live tables #75).
  • AGENT_E2E_RESULTS.yaml renamed to e2e-results/2026-07-02.yaml, with a harness: codex field added per run so dated result files from different harnesses live side by side.

Why

Include the read-only tool profile plan document and additional metrics to baseline how the profile behaves under real agent use. These runs exercise the read-only boundary (no write tool exposed, agent reports mutation unavailable), typo/absent-table recovery, wildcard field expansion, InfluxQL regex selection, and Core/Enterprise parity.

Impact

Repo consumers get the design rationale for the read-only profile and a graded baseline to compare future harness or server changes against. No runtime code changes.

Verification

  • Results file validates against the docs-tooling e2e-results schema (validate-e2e-results.mjs: 12 runs, valid).
  • npm run build and npm test pass (40 passed, 10 skipped).

jstirnaman added 23 commits July 1, 2026 11:33
Move dated results to e2e-results/ and add 12 Claude-harness runs of the
runbook cases (Enterprise read-only/default, Core read-only) with each
run's final message.
All 12 runs pass their cases' expected behavior. Notes record grading
judgment where relevant: shorter-than-target tool path
(ro-wildcard-field-low), markdown-table-instead-of-JSON output
(ro-influxql-regex), and the soft-delete tombstone artifact
(safety-conditional-write default; see #75).
…-plan

# Conflicts:
#	AGENT_E2E_TESTS.md
#	README.md
@jstirnaman
jstirnaman temporarily deployed to cloud-serverless July 28, 2026 15:32 — with GitHub Actions Inactive
Move PLAN.md to docs/adr/0001-phase1-readonly-query-capability.md with
an ADR header (status, date, decision). The plan is the record of the
decision behind the read-only profile shipped in #69.
@jstirnaman
jstirnaman temporarily deployed to cloud-serverless July 28, 2026 15:40 — with GitHub Actions Inactive
Final messages are verbatim agent output and must stay as produced; the
results YAML is validated against the testbench schema instead.
@jstirnaman
jstirnaman temporarily deployed to cloud-serverless July 28, 2026 15:46 — with GitHub Actions Inactive
@jstirnaman
jstirnaman enabled auto-merge July 28, 2026 15:47
@jstirnaman jstirnaman changed the title Add Phase 1 read-only plan and 2026-07-23 e2e testbench results Add read-only ADR and 2026-07-23 e2e testbench results Jul 28, 2026
@jstirnaman
jstirnaman added this pull request to the merge queue Jul 28, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to a conflict with the base branch Jul 28, 2026
@jstirnaman
jstirnaman added this pull request to the merge queue Jul 28, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to a conflict with the base branch Jul 28, 2026
@jstirnaman
jstirnaman added this pull request to the merge queue Jul 29, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to a conflict with the base branch Jul 29, 2026
@jstirnaman
jstirnaman merged commit 97bfaef into main Jul 29, 2026
5 checks passed
@jstirnaman
jstirnaman deleted the codex/phase1-readonly-plan branch July 29, 2026 13:25
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.

2 participants