myco_hunger
Compiles the substrate's hunger report: contract drift, raw-note backlog, reflex signals, and plugin counts. Required as the first tool call every session to initialize the agent's cognitive state.
Instructions
Compose the substrate's hunger report: contract drift (canon version mismatch), raw-note backlog (integer count of notes/raw/*.md pending assimilation), active reflex signals (HIGH/MEDIUM/LOW), concrete next-action advice, and per-kind count of substrate-local plugins. This is the R1 BOOT RITUAL — the mandatory first substantive action every session per the Hard Contract.
Use this: as the FIRST tool call of every session without exception (R1 is a contract rule, not a suggestion). Use it again mid-session whenever the agent wants a fresh state snapshot — it's cheap and idempotent. Do NOT use it as a substitute for myco_brief (which is human-facing markdown, this is agent-facing structured data).
Side effects: none by default. When execute=true, patches
<entry_point>'s <!-- MYCO-BOOT-SIGNALS:BEGIN ... END -->
block with the current hunger signals, respecting R6
write_surface. On abrupt exit (~1.5s kill budget, SessionEnd
hook) prefer myco_senesce with quick=true; hunger itself does
not auto-trigger senesce.
Returns: { exit_code, report: { contract_drift, raw_backlog, reflex_signals, advice, local_plugins: { count, count_by_kind, errors, overlay_verbs } }, execute, entry_point_patched }. The substrate_pulse sidecar then tells you which rule to honor next (advances from R1 → R3 after first hunger call).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| execute | No | When true, write the boot_brief.md + patch the entry-point's MYCO-BOOT-SIGNALS block with current reflex signals. When false (default), compute the report but make zero writes — useful for 'peek without touching'. R6 write_surface still applies to the patched entry-point path. | |
| project_dir | No | Absolute path of the workspace / project whose Myco substrate this call targets. Overrides auto-discovery. When omitted, Myco resolves via MCP roots/list, then MYCO_PROJECT_DIR, then cwd — the substrate_pulse field in every response echoes which source answered. |