Repository navigation
0.3.0
- Clarify quote. A quote whose words come from more than one writer is flagged (needs clarifying, in the status bar and in
rakkan lint). Clarify quote, in the right-click menu, the command palette and the status bar, works on any quote: confirm it as a quote from its source, mark it as the AI's citation, remove the quote markup, or remove it and mark the words as yours (offered in AI text only). The menu lists only the choices that can be written; when none can, a notice says why. Go to next unclarified quote steps through the flagged ones. The answer is written into the note as ordinary markers. - Who wrote the
[@key]decides. A quote in your own text is the source's words. A quote the AI wrote, inside AI text, is the AI's citation: the words stay the AI's until you confirm them. - Paste as quote, closer to the original. One plain line stays in the line as
「…」[@key]; anything else becomes a cited blockquote. Pasted into AI text, the quote is written as confirmed, so it is yours to cite, not the AI's. The quote shows as the text does on its own: code fences and$$blocks left open are closed, tabs keep their columns, an email address stays a link, and no marker in the pasted text gets out. - Remove all markers, and put them back. Settings → Disable and uninstall → Remove all markers… rewrites every note with markers as plain Markdown, in place, after you review the list of notes, tick two confirmations and type the vault name. Where the markers were is first saved to
rakkan-authorship.json(markers only, no text). With Rakkan installed again, Restore markers from the authorship archive gives every unchanged note back exactly as it was, finding moved and renamed notes by content. - Web Clipper templates. Pages clipped with Obsidian Web Clipper are saved as signed quotes, with an optional AI summary signed by the model that wrote it.
- Untrusted quotes.
quoteTexthas a second mode for plain text from outside a note (a web page, a device, an agent): every ASCII punctuation mark is escaped, so the text shows exactly as written and can carry no marker in. Therakkancommand and the MCP layer will quote with it. - A fuzz suite. 16 properties check the parser, signing, quoting and Clarify quote against random text built from Rakkan's and Markdown's syntax, 100 000 runs each before this release. Quotes are rendered with markdown-it and compared with the original text. The rule behind it is now in SPEC: a tool that writes markers may only err away from the person, so nothing becomes yours unless you wrote it.
- An MCP layer for agents.
npm run mcpbuildsdist/rakkan-mcp.mjs, which wraps a filesystem MCP server and addsrakkan_signandrakkan_lintover its reads and writes.
Fixes, most found by the fuzz suite:
- Paste revision and
rakkan sign: a tag the AI changed is credited whole, also when signed again; a change that can't be marked keeps the original line; an atom (a link, a tag) holding two authors' words is split by the original's markers; text that leaves a name-only AI block keeps the name as its key; headings, list markers and table pipes stay outside the markers, so marking a heading as AI keeps it a heading; a new paragraph no longer pulls the next line of yours into the change; tasks the AI ticked or unticked are reported. - Markers: a pair is escaped after an odd number of backslashes, in signatures too; a key runs to the first whitespace; a closing marker at the end of a bare URL closes its span; code markers a block declares but has nothing to mark are still hidden and removed, not left behind as
&&&. - Counting: no whitespace or invisible character counts; a line ends at CR LF, CR or LF, as in CommonMark.
- Quotes: code and math in a cited blockquote stay the quote's, also while typing; an HTML comment holding
--is read as CommonMark reads it. - Speed: no repeated rescans of long lines.