Skip to content

fix: emit === HANDOFF === hint only in external mode#118

Merged
fdaviddpt merged 1 commit into
mainfrom
handoff-hint-external-only
Jun 23, 2026
Merged

fix: emit === HANDOFF === hint only in external mode#118
fdaviddpt merged 1 commit into
mainfrom
handoff-hint-external-only

Conversation

@fdaviddpt

Copy link
Copy Markdown
Contributor

Context

Implements #61. session-start-hook.sh emitted the === HANDOFF === write-target hint unconditionally. In legacy mode REMEMBER_HANDOFF resolves to {project}/.remember/remember.md — the exact path the /remember skill already falls back to when no block is present (SKILL.md:9). So in legacy mode the hint was pure noise.

Change

  • Gate the hint on the existing external-mode predicate [ "$REMEMBER_ROOT" != "$PROJECT_DIR" ] (same test already used for identity tiering at line 88 — one definition of "external", no drift).
  • External mode: unchanged. Legacy mode: hint suppressed, skill fallback handles it.
  • README.md:269 already described this as external-only behavior, so docs now match code. No README change needed; the issue's "document the noise" alternative is moot.

Tests

  • Added test_session_start_suppresses_handoff_block_in_legacy_mode (negative case). Proven red before the fix, green after.
  • Full suite: 481 passed, 41 skipped, 98.48% coverage.

Closes #61

In legacy mode REMEMBER_HANDOFF resolves to {project}/.remember/remember.md
— the exact path the /remember skill defaults to when no === HANDOFF ===
block is present (SKILL.md:9). The hint carried no new info there, just noise.

Gate reuses the existing external-mode predicate (REMEMBER_ROOT != PROJECT_DIR)
already used for identity tiering. README.md:269 already documented this as
external-only behavior, so docs now match code. Adds a legacy-mode negative test.

Closes #61

Co-Authored-By: Max <noreply>
@fdaviddpt fdaviddpt merged commit f1a0038 into main Jun 23, 2026
12 checks passed
@fdaviddpt fdaviddpt deleted the handoff-hint-external-only branch June 23, 2026 08:55
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.

Make === HANDOFF === emission conditional on external mode

1 participant