feat(analytics): result envelope, chart gating, param binders, manifest fields (ISSUE-138/139/140/149)

[dwolfson]

Summary

Analytic executor and registry changes requested by trellis-analytics (the Analytic Library walking skeleton). Fixes ISSUE-138, ISSUE-139, ISSUE-140 and ISSUE-149.

Stacked on #452 (both edit PYEGERIA_ISSUES.md). Until #452 merges, this diff also shows #452's commits. The new commit here is 78e84e77.

ISSUE-149: manifest fields on AnalyticFunctionSpec

• AnalyticFunctionSpec gains these fields, all optional with defaults:
  • kind: routine | step, default routine;
  • source: an open string; an unknown value logs a warning (known values are in KNOWN_ANALYTIC_SOURCES: ods, egeria, resource);
  • version;
  • envelope: bool;
  • annotation_type;
  • resource_types;
  • family: the same meaning as FormatSet.family;
  • tags.
• All 23 built-in registry entries still load, and trellis's RoutineManifest/StepManifest subclasses still validate against the new base. Once this ships, trellis-analytics can drop its own copies.

ISSUE-139: the result envelope on every output

• The executor recognises a result's state (measured, nothing_found, not_established, not_applicable) in any of these shapes:
  • state/state_reason/subtitle;
  • resultState/resultStateReason;
  • a nested envelope dict;
  • an object's .envelope.
• Every analytic output then carries "envelope": {state, reason, subtitle}, and charts get title: {text, subtitle}.
• Pydantic results are returned as plain data.

ISSUE-140: chart only established answers

• When an envelope is present, SERIES/BAR/PIE draw a chart only for an established answer: measured, or nothing_found (a real zero). For not_established and not_applicable they return the data and the state.

ISSUE-138: building non-JSON arguments

• New ActionParameter.analytic_binders: a map from parameter name to a factory's dotted path. The factory is filled from the call params, so a routine taking a reader can be named by its own dotted path.

Compatibility: results without an envelope, and specs without binders, behave exactly as before. On trellis's side, tests/test_portal_tile.py:75 pins the old absence of a subtitle, which will change when trellis takes this release; the issue entry says so.

Test plan

• tests/micro-tests/test_issue_138_140_149_analytic_envelope.py (13 tests: binders, envelope on DICT/BAR, gating, model results, unchanged shape without an envelope, manifest defaults/validation)
• trellis-analytics' manifest.py subclasses validate against the new base (checked locally)
• Full micro-test suite passes (1144 tests)
• Documented in docs/output-formats-and-report-specs.md

🤖 Generated with Claude Code