diff --git a/RELEASES.md b/RELEASES.md index fe694e22..37683e3e 100644 --- a/RELEASES.md +++ b/RELEASES.md @@ -98,3 +98,16 @@ Local source, contained-helper and runtime mechanics are independently accepted: One optional upstream test and five browser tests skipped. No new host transition, paid provider qualification, live installation, or browser appearance claim follows. Source revision is the commit carrying this change record; publication is separate. + +## Unreleased — hook answer citations and dated source provenance + +- Hook event/blocking explanations explicitly cite the selected host's official + documentation in the delivered answer, with source date and runtime-evidence limits. +- The retained Goose v1.57.0 release is labeled as a dated observation, not timeless + "latest". Documentation and release freshness are independent; existing evaluation + criteria and historical evidence are preserved. + +[Compatibility evidence](skills/hook-creator/references/compatibility-matrix.md#citation-and-dated-release-clarification--2026-11-09). +Instruction-only source correction; no host-version transition, new distribution, +model rerun or lifecycle activation is claimed. Versioning for a future promotion +remains a separate decision before canonical verification. diff --git a/skills/hook-creator/AGENTS.md b/skills/hook-creator/AGENTS.md index 6f61b719..851ef68a 100644 --- a/skills/hook-creator/AGENTS.md +++ b/skills/hook-creator/AGENTS.md @@ -7,6 +7,17 @@ - Preserve original fixtures and schemas. New neutral inputs and setup belong in `evals/inputs`; execution prerequisites are verified separately; supported suite fields only. - Inspect executable code before isolated tests; never execute payload commands or mutate live installations. +## Citation and snapshot maintenance + +- Event/blocking explanations must cite the selected host's official documentation + in the delivered answer; Goose uses the public Hooks reference linked from + `references/goose-hooks.md`. Reading a local inventory is not a citation. +- Record source-check dates and exact release identifiers separately. Never label + a retained release "latest" without a fresh dated check; snapshot maintenance is + not synchronized with host releases. Keep unavailable freshness explicit. +- Preserve existing evaluation criteria and frozen campaigns when clarifying these + instructions; static checks do not prove future answers or hook activation. + ## Host version policy Active instructions target current stable host releases and current official documentation. diff --git a/skills/hook-creator/SKILL.md b/skills/hook-creator/SKILL.md index d6d04087..5f216248 100644 --- a/skills/hook-creator/SKILL.md +++ b/skills/hook-creator/SKILL.md @@ -37,6 +37,16 @@ before authoring executable configuration; never infer a host from a shared even | Codex | [Codex hooks](references/codex-hooks.md) | Trusted lifecycle hooks; not merely legacy notify | | OpenCode | [OpenCode hooks](references/opencode-hooks.md) | JavaScript/TypeScript plugin callbacks and events | +For event-inventory and blocking-authority answers, cite the selected host's +official documentation in the final response, not only in internal reading. +For Goose, cite [the official Hooks reference](https://goose-docs.ai/docs/guides/context-engineering/hooks). +State the documentation check date (or the retained snapshot date if live access is +unavailable), and distinguish documented behavior from exact-version runtime +activation evidence. A local inventory alone is not a public-source citation. +Name any cited release by exact version and dated observation; never describe a +retained version as timeless "latest". Refresh upstream when current behavior is +requested; if unavailable, disclose the freshness gap rather than inventing it. + For non-Goose targets, use the selected host's documented configuration ownership, events, matcher population, handler types, decisions and failure policy. Do not apply the Goose recipe below or translate event names mechanically. Resolve source diff --git a/skills/hook-creator/references/compatibility-matrix.md b/skills/hook-creator/references/compatibility-matrix.md index 486f4511..8a697c7a 100644 --- a/skills/hook-creator/references/compatibility-matrix.md +++ b/skills/hook-creator/references/compatibility-matrix.md @@ -45,3 +45,17 @@ and denial rules universally. No prior exact Claude/Codex/OpenCode version basel exists here, so no version-transition compatibility claim is inferred. Ranges remain unverified. No plugin changelog was found in this checkout: a destination must be confirmed before creating a linked changelog entry for the identified upstream changes. + +## Citation and dated release clarification — 2026-11-09 + +agent-plugin source candidate **0.8.0**, baseline `49bba1f45379c1bcb1339821e239e09174d69140`; +this instruction-only correction is not a publication or host-version transition. + +| Host / exact observation | Adaptation and evidence | Status / remaining proof | +|---|---|---| +| Goose v1.57.0, tagged release published 2026-10-28T19:26:10Z; metadata/notes rechecked 2026-11-09 | [Inventory](goose-hooks.md#answer-citation-and-freshness) requires an official citation in delivered event/blocking answers and replaces timeless "Latest stable release" wording with the exact dated observation. [Hooks docs](https://goose-docs.ai/docs/guides/context-engineering/hooks) rechecked separately; twelve-event inventory unchanged. [Tagged notes](https://github.com/aaif-goose/goose/releases/tag/v1.57.0) contain no hook-contract change claim. | Documented + static review; no binary hook activation or model rerun. No new supported range inferred. | + +Existing scenario 3 already requires citation and documentation/runtime separation; +its criteria and historical campaign grades remain unchanged. The previously dated +missing-changelog observation is retained; the current source change record is +[RELEASES.md](../../../RELEASES.md#unreleased--hook-answer-citations-and-dated-source-provenance). diff --git a/skills/hook-creator/references/goose-hooks.md b/skills/hook-creator/references/goose-hooks.md index 5af3dfbb..4b2241f8 100644 --- a/skills/hook-creator/references/goose-hooks.md +++ b/skills/hook-creator/references/goose-hooks.md @@ -6,10 +6,27 @@ Read only for Goose targets; event names and blocking rules are not cross-host d ## Sources and version boundary - [Official Hooks reference](https://goose-docs.ai/docs/guides/context-engineering/hooks), retrieved as Markdown on 2026-11-07. -- [Latest stable release](https://github.com/aaif-goose/goose/releases/tag/v1.57.0), API checked 2026-11-07: v1.57.0 published 2026-10-28T19:26:10Z. +- [Goose v1.57.0 — stable release checked 2026-11-07](https://github.com/aaif-goose/goose/releases/tag/v1.57.0), API checked 2026-11-07: v1.57.0 published 2026-10-28T19:26:10Z. - Release notes inspected; they do not establish a tested hook contract or a verified minimum supported version. Current live documentation can advance independently of the stable binary. - [Target details](goose-target-compatibility.md) and [versioned evidence](compatibility-matrix.md) retain exact distinctions. Do not infer support for every documented feature from the release label. +## Answer citation and freshness + +When answering which Goose hook events exist or which can block, cite the +[official Hooks reference](https://goose-docs.ai/docs/guides/context-engineering/hooks) +in the delivered answer. Reading this inventory without citing its official source +does not satisfy the source-backed answer requirement. State the date of the +source used and distinguish documented capabilities from exact-version runtime +activation evidence; do not imply that documentation proves host execution. + +The retained release observation is **Goose v1.57.0**, not a promise of "latest". +Its tagged release metadata and notes were rechecked on **2026-11-09**; the notes +contain no hook-contract change claim. The live Hooks documentation was also +rechecked on **2026-11-09** and still documents the twelve events below. These +separate checks do not bind live documentation to the v1.57.0 binary or establish +an open-ended supported range. Refresh the official source for current requests; +if access is unavailable, disclose the retained date and unverified freshness. + ## Documented events | Event | When it runs | Matcher target |