Skip to content

feat: add the docket-export skill so agent sessions run the real artifact export - #444

Merged
danielhanold merged 5 commits into
mainfrom
feat/invoke-the-artifact-export-from-an-agent-session
Oct 23, 2026
Merged

danielhanold merged 5 commits into
mainfrom
feat/invoke-the-artifact-export-from-an-agent-session

Conversation

@danielhanold

@danielhanold danielhanold commented Oct 22, 2026 •

Copy link
Copy Markdown
Owner

↩ Change 0578 — Invoke the artifact export from an agent session

Adds docket-export, an inline skill that makes agent sessions run docket's real artifact export (open ... --export --print --json from the capability catalog) instead of copying a raw change, spec, plan, or results file into another tool. A failed export posts nothing. Shared repositories get the exported text unchanged; private repositories get a rewrite pass (leftovers, mentions, and always docket ADR/change numbers), a docket/dckt word check, and a before -> after stop when anything was rewritten. Unknown visibility counts as private.

Also names the skill in the skills/CLI/models/glossary docs and the convention's inline-skill sentences, and pins the skill's rules in repoguard (mutation-tested).

Review

Reviewed by docket-review-standard.

# Severity Finding Disposition
1 important Private rewrite of docket ADR numbers and #N only ran when the export reported leftovers/mentions, which it never does for those fixed (8db63dd)
2 minor No fallback for the ADR/change test when the prepare context is missing fixed (b75f6fd)
3 minor stray-marker leftovers point at source lines and are already gone from the copy fixed (b75f6fd)
4 minor Non-git directory signal (invalid-input, empty repository_state) not named fixed (b75f6fd)

…xport

The export never reports ADR numbers or bare #N as leftovers or mentions,
so gating that rewrite on them let a citation with no docket wording leak.
Pin the unconditional rule in the alignment contracts.
@danielhanold
danielhanold merged commit 4a64bc3 into main Oct 23, 2026
7 checks passed
@danielhanold
danielhanold deleted the feat/invoke-the-artifact-export-from-an-agent-session branch October 23, 2026 00:46
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.

1 participant