Skip to content

feat: Port igrsoft v3.36.0 learnings - budgets, triage, evidence, lint - #10

Merged
ikorich merged 5 commits into
masterfrom
feature/igrsoft-v3.36-port
Jul 22, 2026
Merged

ikorich merged 5 commits into
masterfrom
feature/igrsoft-v3.36-port

Conversation

@ikorich

@ikorich ikorich commented Jul 22, 2026

Copy link
Copy Markdown
Member

Motivation

Port the company-workflow v3.36.0 session learnings (paired A/B benchmark + ov151 evidence-integrity findings) into system-developer, mirroring the apple-developer port (IGRSoft/apple-developer#119) adapted to systems work. Benchmark evidence: AR-companion spawn tripled stage cost ($5.36 vs $1.57 bare); DV ran 122K out-tokens/123 tool calls vs 77K/67 bare for equal results.

Changes

  • Contract sync v3.33.0 -> v3.36.0 — ~20 live refs; sizing table verified already current (DR0 at every tier); PL0 stamps note (test_mode, ui_visual_check — N/A for CLI work, stays false).
  • CLI evidence-freshness rule — cli-fallback transcripts produced this run only, never reused; QA direct-reads and cross-checks against ### build-evidence log paths (the systems analog of the ov151 evidence-integrity gate). UI live-drive/hittability gates deliberately not ported — no hook in systems work.
  • state-patch pointer form — manual read->merge->temp->fsync->rename prose replaced by state-patch.sh --stage <CODE> --prev <PREV> when the dispatcher supplies its path, silent-skip degrade otherwise (Layers 2/3 repair from unconditional frontmatter).
  • Output budgets + Complexity Triage — DV (_base), AR, DV-support, DR-support blocks with Build Evidence exempt from every cap; system-architector self-limits to Quick Recommendation Mode at Low complexity (0-10).
  • Linters — scripts/section-lint.sh (warn-only baseline: 491 sections over cap / 101 files, references/ in scope) + scripts/desc-lint.sh (two-tier 250/600 caps, green today) wired into scripts/test.sh with bats self-tests; existing CI picks them up.
  • Release 1.4.0 across both manifests, README, MEMORY, CHANGELOG. validate.sh: 0 errors.

Notes

  • desc skills cap 600 is a regression brake (worst today 514) — tightening waits on eval evidence.
  • section-lint stays warn-only until the burn-down; desc-lint is fatal and green.

Closes #9

ikorich added 5 commits July 22, 2026 19:38
Sizing table verified already current (DR0 at every tier) - version refs
only. PL0-stamps note now names metadata.test_mode and ui_visual_check
(N/A for systems work, stays false). CLI evidence gains a freshness rule:
cli-fallback transcripts produced this run only - igrsoft QA direct-reads
and cross-checks against build-evidence log paths; stale or duplicated
transcripts re-open DV. Historical CHANGELOG/MEMORY refs untouched.
The read->merge->temp->fsync->rename prose is gone. Primary: run igrsoft
state-patch.sh --stage <CODE> --prev <PREV> when the dispatcher supplies
its path (task.metadata.state_patch_script). Degrade: skip silently, no
hand-rolled merge - Layers 2/3 repair from frontmatter, whose emission
stays unconditional.
Benchmark-driven: AR-companion spawn tripled stage cost and DV ran 122K
out-tokens/123 tool calls vs 77K/67 bare for equal results. Budgets cap
artifact lines, return tokens, and tool calls (DV in _base, AR,
DV-support, DR-support) with Build Evidence exempt from every cap;
system-architector self-limits to Quick Recommendation Mode at Low
complexity (0-10), mode triggers outranking an inferred low score.
Ported from igrsoft via apple-developer. section-lint: leaf sections
<=1000 chars, warn-only baseline (pre-existing prose debt incl.
references/; burn-down separate). desc-lint: two-tier caps - agents/
commands <=250, skills <=600 (regression brake above the 515 worst;
tightening needs eval evidence). Wired into scripts/test.sh (desc fatal,
section warn even under --strict); bats self-tests picked up by CI.
igrsoft v3.36.0 compatibility port. Version consistent across
plugin.json, marketplace.json, README, MEMORY, CHANGELOG. section-lint
baseline recorded: 491 sections over cap across 101 files (warn-only;
burn-down tracked separately; scope includes references/).
validate.sh: 0 errors, 4 pre-existing warnings.
@ikorich
ikorich merged commit 85a3e9f into master Jul 22, 2026
2 checks passed
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.

Port igrsoft v3.36.0 learnings: contract sync, budgets, triage, linters

1 participant