Repository navigation
feat: export an opened artifact as a clean, docket-free Markdown file - #439
Merged
danielhanold merged 12 commits intoOct 20, 2026
Merged
danielhanold merged 12 commits into
danielhanold merged 12 commits into
Conversation
…ust marker balance
…ng rules, and mentions
…ansform step is load-bearing
…and mentions, and opens it
…er ship as a converted title Review finding: removeStamps and the self-check's isStamp listed stamp spellings, so 83 of 240 real stamped specs kept a stamp (`Change: #N · slug …`, `**Change:** N — title`, `Change N. Spec date …`, linked `**Change:** [#N](…)`), which step 6 then shipped as `**Change:** "<title>"` unnoticed. The transform now matches a stamp by shape on the link-stripped line: a line opening `Change`, `Change:`, or `**Change:**` with the id (or a later `· **Change:**` field). The head and its metadata go; an author sentence after it stays. The detector recognizes the label and converted-title shapes without needing a digit, still sharing no code with the transform. Two older real specs (a plain-label `·` run and a linked stamp) join the frozen corpus.
The self-check reported a ↩ anywhere outside code, any <a>/<A> placeholder, and any [x][y] pair as docket machinery the export did not remove, though the transform keeps all three on purpose. The banner rule now matches only the banner's '> ↩' line shape, an anchor needs an attribute assignment or a closing </a> on the line, and a reference link is flagged only when its label has a definition in the document.
…-check, and destination
- Finding 3: the transform (maskParagraph) and the self-check
(maskParagraphs), each written separately, now find inline code spans
across a whole paragraph. A span that crosses a line break stays code on
both of its lines. PROVENANCE.md no longer lists this as a limitation.
- Finding 4: an inserted title respects the author's quotes. A fully
convertible reference that is the whole quoted text takes those quotes
("change 0559" -> "<title>"). A quoted references-only parenthesis is
replaced by its titles and never leaves "". Inside a longer quoted phrase,
the title gets single quotes.
- Finding 5: a stray-marker leftover reports its source line as
source_line. line is left only for output lines, and the JSON test and
human warning are updated.
- Finding 6: --output-path is refused with output-path-protected when the
resolved destination (cleaned, parent symlinks resolved) is the source
artifact or lies inside the metadata checkout.
- Finding 7: corpusProblems directly asserts that no known word-form or
padded change id is left outside code, using a regex of its own.
danielhanold
deleted the
feat/export-an-opened-artifact-as-a-clean-docket-free-markdown-fi
branch
October 20, 2026 15:45
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds
docket open <change|spec|plan|results> [<id>] --export. It writes a clean Markdown copy of the artifact that can be shared with people who do not use docket, then opens it (--printprints the path instead).~/Downloadson macOS or the home folder on Linux, or--output-path. The file is named<date>-<type>-<name>.md. Exporting over the source or into the metadata checkout is refused.change 0559, padded ids) become quoted titles. A bare#N, a PR number or an ADR reference stays. Code is never touched.internal/exportcheck, which shares no code withinternal/export) reports leftovers and mentions of docket as warnings, filtered by--warnings all|leftovers|mentions. It never blocks.Review
Whole-branch review ran at the deep tier (bumped for a diff over 1,500 lines). It returned 7 findings, all fixed in-branch.
·runs, linked ids) were missed and shipped converted, and the self-check could not see them↩,<a>placeholders,x[i][j]) as leftovers""title"","(0507)"→"")source_line)--output-pathcould overwrite the source artifactoutput-path-protected)The full suite is green at e707401.