- Link the public GraphTheory developer docs from the profile README.
- Orchestration: centralize council width policy in
width_policy.py; align triage andteam_coordinator.pydefaults with shippedcouncil_width/default_width8 (Grok Heavy phrases still widen to 16). - Hooks:
should_trigger_team_planskips read-only inspect/audit turns unless the user also asks to implement or improve; shared width parsing inhook_libinline plan build. - Bootstrap: advisory
recommended_flowdocuments widths 3|5|8|16 with default council 8. - Tests: triage width expectations,
test_hook_lib.py, width policy parsing.
- Coordinator skills: add eight strategic skills for routing, dispatch discipline, pre-dispatch enrich, candidate JSON, hook phases, repair waves, context budget, and single mode:
heavy-scope-router,heavy-swarm-dispatch,heavy-pre-dispatch-enrich,heavy-leaf-candidate-output,heavy-hook-phases,heavy-repair-wave,heavy-context-budget,heavy-single-mode. heavy-team-defaultv0.6.0: phase-based companion table wiring all swarm skills.- Profile docs:
.hermes.mdandSOUL.md- loadheavy-scope-routereach task; align council width 8 withconfig.yaml. - Docs:
enforcement-model.md- delegate minimum and skills section for 0.3.0.
- IDE TUI bootstrap:
display.auto_ide_skin(default true) selectsheavy-coder-idein Cursor / VS Code / Windsurf andheavy-coder-lightwhenHERMES_TUI_THEME=light(profile_bootstrap.py, shippedconfig.yaml). - heavy-coder-ide: compact banner (no tall
banner_hero); brighter muted/status colors; welcome steers--name hc --aliasfor composer prefix bleed. - Docs:
ide-terminal-composer.mddocumentsIky-style multi-character composer junk and auto skin selection. - Tests: IDE/light skin bootstrap in
tests/test_profile_bootstrap.py.
- Skills: add
heavy-explore-first,heavy-leaf-brief,heavy-synthesize-winner,heavy-ship-gatefor coordinator software-development discipline; extendheavy-team-defaultwith companion-skill map (v0.5.0). - TUI: align HEAVYCODER figlet row widths; add
heavy-coder-ideskin (ASCII>prompt); figlet width check invalidate_skin_tui_markup.py.
- Readability: brighten
banner_dim, status bar, and session border colors inheavy-coderskin; addskins/heavy-coder-light.yamlfor light IDE terminals; documentHERMES_TUI_THEME=lightin ide-terminal-composer.md.
- IDE ghost typing: document Ink fast-echo right-margin debris (
t tt r re re) in ide-terminal-composer.md; addscripts/ide_safe_chat.sh(HERMES_TUI_FAST_ECHO=0).
- IDE composer overlap:
prompt_symbolis⛓only (no trailing arrow); fixes stray glyph beside the first typed character on Cursor/VS Code terminals. See ide-terminal-composer.md. - Skin validation: reject
⛓+ second arrow inprompt_symbol.
- TUI composer prompt: replace
⛓▸with⛓❯inskins/heavy-coder.yamlso Cursor/IDE terminals do not show a stray letter-like glyph at the caret; document the rule in cli-observability.md. - Skin validation:
validate_skin_tui_markup.pyrejects▸/▹inbranding.prompt_symbol.
- TUI wordmark: replace box-drawing HEAVY CODER art with single-word HEAVYCODER Banner3 figlet so V/Y no longer read as stray U glyphs; doc note in cli-observability.md.
- Control surface: sharper prompt/completion/selection colors,
⛓▸prompt,⟨◈ HEAVY⟩response label, deck-style/helpheader inskins/heavy-coder.yaml.
- TUI skin fix: rewrite
skins/heavy-coder.yamlbanner art to use one Rich color tag per line so the Ink TUI no longer stacks multi-tag rows vertically (broken wordmark/hero). - Skin validation:
scripts/validate_skin_tui_markup.pyandtests/test_skin_tui_markup.pyguard banner markup; cli-observability.md documents the rule.
- Cyberpunk TUI skin: neon cyan/magenta chrome, framed wordmark, scanline caduceus hero, richer swarm spinner verbs/wings, and council-themed branding in
skins/heavy-coder.yaml. - Docs: cli-observability.md describes the updated skin look.
- Heavy Coder TUI skin: ship
skins/heavy-coder.yaml(Grok cyan/violet, Hermes gold, caduceus banner, swarm spinner verbs) viadistribution_owned. - Default skin on install:
config.yamlandprofile_bootstrapmergedisplay.skin: heavy-coderwhen missing. - Docs: cli-observability.md documents
/skin heavy-coderand install layout.
- Fast swarm watcher: add
scripts/swarm_watch.pywith low-latency, change-aware redraws and in-place terminal repainting. - Richer swarm dashboard: show elapsed time, updated age, per-candidate roles, goal excerpts, progress bars, and human-readable durations.
- Safer progress writes: write
.heavy-coder/swarm-progress.jsonatomically so second-pane watchers do not read partial JSON. - Truthful running state: mark dispatched candidate slots as running so the dashboard reflects parallel
delegate_taskbehavior. - Coordinator UX: tell users about
python scripts/swarm_watch.py --repo .after dispatch and fix compact council newline formatting.
- Context compression on install: shipped
config.yamlsetscompression.enabled: trueandcompression.threshold: 0.85;on_session_startmerges missing compression keys and upgrades legacy thresholds at or below 0.5 to 0.85.
- Install-by-default swarm UX: shipped
config.yamluses TUI + verbose tool progress;on_session_starthook merges missing display/delegation keys and installsheavy-councilplugin; canonical install uses--alias(heavy-coder chat). See cli-observability.md.
- Swarm UX: Default
display.interface: tui,tool_progress: verbose,delegation.max_async_children: 16; live.heavy-coder/swarm-progress.jsonupdated per leaf; coordinator instructed to tell users about/agentsand status bar ⛓. - Docs: cli-observability.md.
- Candidate evidence:
coerce_candidate_id()maps delegate child ids to schemacNids;subagent_stop_evidenceno longer writes invalidcandidate_idvalues (fixes blind critique schema penalties). - Validation UX: clearer jsonschema paths via
_format_validation_error; cachedload_validator();critique_candidateshandles read errors and validates in-memory payloads. - Tests:
test_critique_candidates.pyplus expandedtest_candidate_result.py.
- Default Composer swarm (width 8):
heavy_coder.council_widthandmin_delegate_tasksdefault to 8 for fast, high-quality paralleldelegate_taskon composer-2.5 (setcouncil_width: 16for Grok Heavy-scale). - Compact injection:
pre_llm_callinjectsDELEGATE_TASKS_JSON(capped bymax_injected_plan_chars); full plan under.heavy-coder/plans/. In-process plan build viacouncil_injection(no coordinator subprocess on the hot path). - Profile defaults:
skills.creation_nudge_interval: 0,delegation.subagent_auto_approve: true, slim leaf context,terminal+filetoolsets. - Docs: composer-hermes-swarms.md explains Composer + Hermes swarms + profile hooks.
- Stop embedding resolved repository paths in
delegate_taskscontext and redact absolute paths inpre_llm_callTEAM_PLAN_JSON before chat/session logs persist them.
- Register
terminalonpre_tool_callhook matcher; block solo terminal before delegation. scripts/sync_profile_hooks.py --verify-onlychecks hook matchers (terminal) before path sync.- Ship
plugins/heavy-council/;bootstrap_heavy_team.pyrunsinstall_heavy_council_plugin; document AGENTS.md exception to the no-plugin rule. - Add
pluginstodistribution_ownedwith profile-localplugins/README.md(no bundled Hermes plugins). - Document mandatory 16-task heavy council in
docs/plan-1a-shell-hooks.md; README paragraph andexamples/delegate_tasks_16.sample.json.
- Fix install docs: Hermes does not support
@tagonhermes profile installURLs; adddocs/release-checklist.md.
- Add Grok Heavy-style heavy council width 16: triage triggers,
--heavy-council,candidate_widthsanddelegation.max_concurrent_children16, docsgrok-heavy-council.md.
- Restructure README: Grok Heavy-style team use case first, Hermes install, profile install, and Grok OAuth with X Premium / SuperGrok callout.
- Add version-controlled GitHub discovery metadata (
github-repo-metadata.yaml) with validators, apply script, and docs. - Sync remote description and topics from the canonical file via
apply_github_repo_metadata.py.
- Fix
build_team_planwidth override emitting fewerdelegate_tasksthanwidth. - Harden candidate validation and hook stdin JSON parsing; avoid resetting hook phase on async delegation completion.
- Add unit tests for candidate results, state machine, and team plan edge cases.
- Add tag-triggered GitHub Release workflow and scripts/ship_release.sh for repeatable ships.
- Plan 1A: Hermes shell hooks (
pre_llm_call,pre_tool_call,post_tool_call,subagent_stop) enforce team workflow. - Add
agent-hooks/scripts,hooks_auto_accept,docs/plan-1a-shell-hooks.md,scripts/sync_profile_hooks.py.
- Implement working team pipeline: triage,
team_coordinator.py,heavy_coding_flow.py, critique and candidate schema validation. - Implement git worktree lifecycle (
worktrees.py), guardedclaim_issue/publish_prwith--execute. - Document required coordinator sequence in
heavy-team-defaultskill; update enforcement model.
- Honesty pass: document advisory vs mechanical enforcement in
docs/enforcement-model.md; tone down SOUL,.hermes.md, andheavy-team-defaultoverclaims. bootstrap_heavy_team.pyanddoctor.pyreport team config as diagnostics only.- Shorten
distribution.yamldescription; clarify pyproject vs profile version in coding standards.
- Fix CI failures: remove Unicode en/em dashes from tracked text, bump
distribution.yamlwhen release-relevant files change, and align docs withconfig.yaml. - Remove duplicate
heavy-team-defaultskill; detect duplicate skill names invalidate_distribution.py. - Set
heavy_coder.statustoscaffoldedto match SOUL and README. - Add
docs/coding-standards.md,scripts/ci_local.sh, and pre-commit distribution validation.
- Strengthened heavy-team-default: explicit COMPOSER OVERRIDE blocks single-agent composer-style execution for all coding situations unless the user prefixes with "composer only".
- Team mode (width 3/5 plus coordinator, critic, synthesizer, verifier) is non-bypassable by default.
- Add deterministic
scripts/bootstrap_heavy_team.pyhook. Forcesteam_enforced=trueand width at least 3, and emits mandatory team pattern JSON on every coding/repo task. - Full team enforcement ships with both source repo and live installed profile.
- Updated description and validation for enforced team mode.
- Enforce Heavy-style multi-agent teams by default (
.hermes.mdplusheavy-team-defaultskill). - Move skill to top-level for validation compatibility.
- Bake team mode into SOUL.md and config.
- Initial scaffolded profile distribution, schemas, validation scripts, and CI.