Skip to content

Grading CLI observability, caching & emit-skill (Memo 110) - #99

Merged
a6b8 merged 5 commits into
mainfrom
memo-110-cli-observability-emit
Jun 5, 2026
Merged

Grading CLI observability, caching & emit-skill (Memo 110)#99
a6b8 merged 5 commits into
mainfrom
memo-110-cli-observability-emit

Conversation

@a6b8

@a6b8 a6b8 commented Jun 5, 2026

Copy link
Copy Markdown
Contributor

Closes #98. Pins flowmcp-grading v2.4.0 (FlowMCP/flowmcp-grading#60).

Phases (cli side)

  • P2 Caching--force threads the cache bypass into DataPretest.run; fromCache+dataAt surfaced in the deterministic result; new grading reload <ns|ns/schema> (re-fetch + rewrite test-N.json only, no _gradings/grade writes).
  • P3 Emit-Skill#buildEmitSubstitutions (repo-relative paths) + #buildEmitSkill assemble ONE self-contained skill text (ready-stage areas, real paths, inline schema, Task-ID + --consume-scores command IN the text); gated namespace-* named for the follow-up emit; --max-turns configurable.
  • P4 Observability#emitProgress → stderr per-schema/tool ticks; --quiet; printDeterministicSummary (stderr, additive, no machine key dropped; stdout JSON pure).
  • P5 I-4both-classified areas route to deterministicNow AND the non-det area-set.

Tests: 134/134 grading-suite pass against the published grading v2.4.0; full suite parity with main (pre-existing non-grading suites unaffected).

🤖 Generated with Claude Code

a6b8 and others added 5 commits June 5, 2026 17:53
Phase 2 (Memo 110): cache control on the CLI.
- thread --force through gradingDeterministic -> DataPretest.run
- surface fromCache + dataAt in the deterministic result
- new `grading reload <ns|ns/schema>`: re-fetch + rewrite test-N.json
  only (force), decoupled from grading (no _gradings/grade.json writes)
- tests for force-threading, data-stamp surfacing, reload routing

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Phase 3 (Memo 110): the emit returns a single self-contained Emit-Skill.
- #buildEmitSubstitutions feeds real repo-relative schema paths + tool/
  namespace names into the composed area prompts (no torso)
- #buildEmitSkill assembles ONE skill text: self-describing header, the
  bundled READY-stage areas, and the Task-ID + exact --consume-scores
  return command IN THE TEXT (Kap 10.1); gated stage-2 areas named for
  the follow-up emit
- maxTurns configurable (--max-turns, default 25; was hardcoded)
- tests for emit-skill text, maxTurns flow + malformed-value guard

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Phase 4 (Memo 110): observability (Befund B).
- #emitProgress ticks per-schema/per-tool to STDERR during the slow
  deterministic/emit/reload runs; --quiet silences it
- stdout machine JSON is untouched (piped `... | jq` stays pure)
- printDeterministicSummary: concise human summary to stderr, gated by
  !quiet && !json; no machine key dropped (rollup/proof consumers depend
  on them) — summary is additive
- tests: stderr ticks vs --quiet, summary gating

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Phase 5 (Memo 110, I-4): a `both`-classified area carries a free
deterministic gate AND an LLM round, so nextAction lists it in
deterministicNow AND the non-det area-set. Doctor test reflects the
corrected below-deterministic-green behaviour.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@codecov

codecov Bot commented Jun 5, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 83.58209% with 22 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
src/task/FlowMcpCli.mjs 83.58% 22 Missing ⚠️

📢 Thoughts on this report? Let us know!

@a6b8
a6b8 merged commit 5770698 into main Jun 5, 2026
2 checks passed
@a6b8
a6b8 deleted the memo-110-cli-observability-emit branch June 5, 2026 16:41
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.

Grading CLI observability, caching & emit-skill (Memo 110)

1 participant