Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions RELEASES.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
11 changes: 11 additions & 0 deletions skills/hook-creator/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
10 changes: 10 additions & 0 deletions skills/hook-creator/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
14 changes: 14 additions & 0 deletions skills/hook-creator/references/compatibility-matrix.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
19 changes: 18 additions & 1 deletion skills/hook-creator/references/goose-hooks.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 |
Expand Down
Loading