chore: release get-tbd v0.3.0

[jlevy]

Release get-tbd v0.3.0 — a minor release headlined by forkable docs, with a metadata-only repository format bump f04 → f06 (f05 forkable-docs layout, f06 config upgrade history).

This PR bumps packages/tbd/package.json to 0.3.0 and finalizes the ## 0.3.0 CHANGELOG section. After merge, tagging v0.3.0 on the merge commit triggers release.yml to publish to npm and create the GitHub Release.

Release verification (run locally on this branch)

• format:check, lint:check, build, publint — pass
• vitest: 1324 tests / 84 files — pass
• tryscript e2e: 883 checks (incl. 38 forkable-docs scenarios) — pass
• benchmark — exit 0 (soft startup-time warnings only)
• Supply chain: pnpm-lock.yaml byte-identical to v0.2.3, no manifest changes, pnpm audit --prod clean
• Changelog extraction for 0.3.0 verified (release-body extractor returns the full section)

---

0.3.0

The headline is forkable docs: every doc tbd serves (guidelines, shortcuts, templates, and the new reference docs) can now be forked into your repo as visible, git-tracked files, edited in place, and reconciled with upstream after upgrades. The repository format bumps f04 → f06 in this release: f05 adds the forkable-docs layout, and f06 adds a config upgrade history and redefines tbd_version. Both migrations are metadata-only, so upgrading is safe and revertible.

Features

• Forkable docs (tbd docs fork / unfork / update / diff / status): fork any managed doc into a visible fork dir (docs/tbd/), shadowing the hidden cache everywhere the doc is served. tbd docs update three-way merges upstream changes (--merge, --keep-ours, --dry-run); tbd docs diff compares against upstream/base/incoming; tbd docs status reports each fork's state from content hashes (fork state lives in committed .tbd/doc-forks/).
• The tbd docs surface is re-homed around managed docs: bare tbd docs is the status overview, tbd docs list lists all docs across kinds with state markers, the manual moved to tbd docs show tbd-docs (alias tbd docs manual), and tbd docs sync refreshes the cache.
• docref + docmap formats, and a new reference doc kind: every doc source is addressed by a docref URI grammar and every listing is one docmap (docmap/0.1); both formats ship as forkable reference docs alongside the manual and design doc.
• Fork drift is visible, never auto-fixed: tbd status gains a Docs: line and tbd sync prints a stale/conflicted/missing notice; only tbd docs update ever modifies tracked files.
• Config upgrade history (format f06): tbd_version now records the version that last ran tbd setup, and a new tbd_upgrades list records the setup history (informational; gating stays on tbd_format).

Guidelines and content

• New suggest-upstream-improvements shortcut for reviewing fork customizations and contributing them upstream.
• New docref-format and docmap-format reference docs.
• Onboarding and agent surface updated for forkable docs (welcome-user two-axis offer; agent skill routes fork/update/missing-file requests).
• cli-agent-skill-patterns guideline expanded (issues cli-agent-skill-patterns: five small gaps surfaced by an L2-ish CLI (pprose) #173, docs: address cli-agent-skill-patterns gaps from issue #173 (pprose audit) #175): L2b self-installer variant, deliberate managed-artifact upgrades, generator-resolvable pins, Cursor native paths.
• checkout-third-party-repo shortcut reuses an existing checkout (checkout-third-party-repo shortcut: no guidance when the repo is already cloned in attic/ #168).
• Every bundled guideline now declares a category in its frontmatter.

Security

Lockfile unchanged since v0.2.3 (same pnpm-lock.yaml hash, no manifest changes); pnpm audit --prod reports no known vulnerabilities.

Full commit history: v0.2.3...v0.3.0

https://claude.ai/code/session_018erxkUHGwShRZJaoN8oUon

---

Generated by Claude Code

[deepsource-io]

DeepSource Code Review

We reviewed changes in b156bfa...8b37f63 on this pull request. Below is the summary for the review, and you can see the individual issues we found as inline review comments.

See full review on DeepSource ↗

PR Report Card

Overall Grade

Security   Reliability   Complexity   Hygiene

Code Review Summary

Analyzer	Status	Updated (UTC)	Details
Secrets		Jun 15, 2026 4:19p.m.	Review ↗

---

Important

AI Review is run only on demand for your team. We're only showing results of static analysis review right now. To trigger AI Review, comment @deepsourcebot review on this thread.

[github-actions]

Coverage Report for packages/tbd

Status	Category	Percentage	Covered / Total
🔵	Lines	33.9%	2876 / 8483
🔵	Statements	33.82%	2977 / 8801
🔵	Functions	38.99%	452 / 1159
🔵	Branches	29.98%	1362 / 4543

File Coverage

No changed files found.

Generated in workflow #1033 for commit 8b37f63 by the Vitest Coverage Report Action