packages/guard/README.md

# guard/ — loop-hygiene guard family

English | [中文](README.zh.md)

Behavioral guard plugins watch the agent loop for unproductive patterns and enforce per-call budgets. A guard is a self-contained consumer of core services and extension points, not a swappable capability.

| Package | Role | ctx key |
|---|---|---|
| [`repeat-tool-guard/`](repeat-tool-guard/README.md) | Advisory reminders for repeated tool calls | listens on tool and agent events |
| [`timeout-policy/`](timeout-policy/README.md) | Arms per-call tool deadlines as deployment policy | registers a `tools/execute` listener |

Reminders travel as `additionalContexts` on the `tools/post-execute` decision and are appended as logged plugin-sourced `user/message` events ([tools](../../docs/subsystems/tools.md)); the timeout split across `dsh-timeout`, capability termination, and this policy layer is recorded in the [timeout-library Agent Note](../../.agents/notes/implemented/architecture/2026-07-06-timeout-deadline-library.md).
feat(guard): add the repeat-tool-guard plugin 2026-07-08 14:24:20 +08:00			`# guard/ — loop-hygiene guard family`

docs: translate remaining READMEs 2026-07-26 05:03:53 +08:00			`English \| [中文](README.zh.md)`

docs: reserve seam for complete capabilities 2026-08-09 15:34:32 +08:00			`Behavioral guard plugins watch the agent loop for unproductive patterns and enforce per-call budgets. A guard is a self-contained consumer of core services and extension points, not a swappable capability.`
feat(guard): add the repeat-tool-guard plugin 2026-07-08 14:24:20 +08:00
			`\| Package \| Role \| ctx key \|`
			`\|---\|---\|---\|`
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			\| [`repeat-tool-guard/`](repeat-tool-guard/README.md) \| Advisory reminders for repeated tool calls \| listens on tool and agent events \|
refactor(packages): merge timeout/ into guard/, rename cordis/ to self-modification/ 2026-07-30 03:40:42 +08:00			\| [`timeout-policy/`](timeout-policy/README.md) \| Arms per-call tool deadlines as deployment policy \| registers a `tools/execute` listener \|
docs: anchor each subsystem page to its package group; make group READMEs thin tables 2026-08-02 05:54:15 +08:00
			Reminders travel as `additionalContexts` on the `tools/post-execute` decision and are appended as logged plugin-sourced `user/message` events ([tools](../../docs/subsystems/tools.md)); the timeout split across `dsh-timeout`, capability termination, and this policy layer is recorded in the [timeout-library Agent Note](../../.agents/notes/implemented/architecture/2026-07-06-timeout-deadline-library.md).