get-tbd 0.2.0 → 0.2.2

package/dist/docs/guidelines/common-doc-guidelines.md

@@ -1,6 +1,6 @@
 ---
 title: Common Documentation Guidelines
-description: Common cross-project standards for writing and organizing docs, code comments, and text files — how to organize, structure, write, and format documents, plus the guideline footer convention. Downstream of github.com/jlevy/practical-prose. Use whenever writing or editing any documentation, README, guideline, or design doc.
+description: Common cross-project standards for writing and organizing docs, code comments, and text files—how to organize, structure, write, and format documents, plus the guideline footer convention. Downstream of github.com/jlevy/practical-prose. Use whenever writing or editing any documentation, README, guideline, or design doc.
 author: Joshua Levy (github.com/jlevy) with LLM assistance
 ---
 # Common Documentation Guidelines
@@ -219,7 +219,7 @@ Stylistically, emphasize **clarity**, **depth**, **rigor**, and **warmth**.
 
 - **Auto-formatting:** Always use auto-formatting on every file type that supports it.
   Defer to the language- or format-specific rules for exact style.
-- **Emojis:** Do not use emojis gratuitously — only when they add clarity through a
+- **Emojis:** Do not use emojis gratuitously—only when they add clarity through a
   consistent semantic vocabulary.
   Use ✅ and ❌ for success and failure (or ✔︎ and ✘ if the codebase already uses them),
   and ⚠️ and ‼️ for user-facing warnings and errors (or ∆ and ‼︎ to match an existing

package/dist/docs/guidelines/convex-limits-best-practices.md

@@ -75,25 +75,25 @@ This research synthesizes information from:
 
 ### Primary Sources
 
-- [Convex Production Limits](https://docs.convex.dev/production/state/limits) — Official
+- [Convex Production Limits](https://docs.convex.dev/production/state/limits)—Official
   limits documentation
 
-- [Convex Best Practices](https://docs.convex.dev/understanding/best-practices) —
-  Official best practices guide
+- [Convex Best Practices](https://docs.convex.dev/understanding/best-practices)—Official
+  best practices guide
 
-- [Indexes and Query Performance](https://docs.convex.dev/database/reading-data/indexes)
-  — Index optimization guide
+- [Indexes and Query Performance](https://docs.convex.dev/database/reading-data/indexes)—Index
+  optimization guide
 
-- [Pagination Guide](https://docs.convex.dev/database/pagination) — Official pagination
+- [Pagination Guide](https://docs.convex.dev/database/pagination)—Official pagination
   patterns
 
-- [Queries that Scale](https://stack.convex.dev/queries-that-scale) — Community best
+- [Queries that Scale](https://stack.convex.dev/queries-that-scale)—Community best
   practices
 
-- [Convex Aggregate Component](https://github.com/get-convex/aggregate) — Official
+- [Convex Aggregate Component](https://github.com/get-convex/aggregate)—Official
   aggregation library
 
-- [Convex Helpers](https://github.com/get-convex/convex-helpers) — Additional utilities
+- [Convex Helpers](https://github.com/get-convex/convex-helpers)—Additional utilities
   for pagination and queries
 
 * * *
@@ -503,17 +503,17 @@ basis … Usually this is only needed if your product has highly bursty traffic.
 
 **Sources**:
 
-- [Convex Runtimes](https://docs.convex.dev/functions/runtimes) — Runtime comparison and
+- [Convex Runtimes](https://docs.convex.dev/functions/runtimes)—Runtime comparison and
   `"use node";` directive
 
-- [Convex Actions](https://docs.convex.dev/functions/actions) — Action limits and
-  runtime selection
+- [Convex Actions](https://docs.convex.dev/functions/actions)—Action limits and runtime
+  selection
 
-- [Convex Limits](https://docs.convex.dev/production/state/limits) — Official limits
+- [Convex Limits](https://docs.convex.dev/production/state/limits)—Official limits
   documentation
 
-- [Convex Contact](https://docs.convex.dev/production/contact) — Support contact for
-  limit increases (support@convex.dev)
+- [Convex Contact](https://docs.convex.dev/production/contact)—Support contact for limit
+  increases (support@convex.dev)
 
 ### 4. Storage and Bandwidth Quotas
 
@@ -1402,8 +1402,8 @@ export UDF_EXECUTOR_OCC_MAX_BACKOFF_MS=5000
 
 - [Convex Aggregate Component](https://github.com/get-convex/aggregate)
 
-- [@convex-dev/workpool](https://www.npmjs.com/package/@convex-dev/workpool) — “you
-  should ensure that each step is an idempotent Convex action”
+- [@convex-dev/workpool](https://www.npmjs.com/package/@convex-dev/workpool)—“you should
+  ensure that each step is an idempotent Convex action”
 
 - Source: `crates/common/src/knobs.rs:146-155`
 
@@ -1787,7 +1787,7 @@ export const processData = internalAction({
 
 **Sources**:
 
-- [Convex Actions Documentation](https://docs.convex.dev/functions/actions) — Section on
+- [Convex Actions Documentation](https://docs.convex.dev/functions/actions)—Section on
   awaiting promises
 
 ### Pitfall 10: Nested Same-Runtime Action Calls ✅
@@ -2067,47 +2067,47 @@ problematic nested same-runtime pattern.
 
 ### Official Convex Documentation
 
-- [Convex Production Limits](https://docs.convex.dev/production/state/limits) — Complete
+- [Convex Production Limits](https://docs.convex.dev/production/state/limits)—Complete
   limits reference (verified January 2026)
 
-- [Convex Pricing](https://www.convex.dev/pricing) — Current plan limits and pricing
+- [Convex Pricing](https://www.convex.dev/pricing)—Current plan limits and pricing
 
-- [Convex Best Practices](https://docs.convex.dev/understanding/best-practices) —
-  Official best practices guide
+- [Convex Best Practices](https://docs.convex.dev/understanding/best-practices)—Official
+  best practices guide
 
-- [Convex Runtimes](https://docs.convex.dev/functions/runtimes) — Runtime comparison
+- [Convex Runtimes](https://docs.convex.dev/functions/runtimes)—Runtime comparison
   (Convex vs Node.js)
 
-- [Indexes and Query Performance](https://docs.convex.dev/database/reading-data/indexes)
-  — Index optimization and query patterns
+- [Indexes and Query Performance](https://docs.convex.dev/database/reading-data/indexes)—Index
+  optimization and query patterns
 
-- [Pagination Guide](https://docs.convex.dev/database/pagination) — Cursor-based and
+- [Pagination Guide](https://docs.convex.dev/database/pagination)—Cursor-based and
   offset pagination
 
-- [Query Functions](https://docs.convex.dev/functions/query-functions) — Query design
-  and patterns
+- [Query Functions](https://docs.convex.dev/functions/query-functions)—Query design and
+  patterns
 
-- [Full Text Search](https://docs.convex.dev/search/text-search) — Search index limits
+- [Full Text Search](https://docs.convex.dev/search/text-search)—Search index limits
 
-- [Vector Search](https://docs.convex.dev/search/vector-search) — Vector index limits
+- [Vector Search](https://docs.convex.dev/search/vector-search)—Vector index limits
 
-- [Scheduled Functions](https://docs.convex.dev/scheduling/scheduled-functions) —
-  Scheduling limits
+- [Scheduled Functions](https://docs.convex.dev/scheduling/scheduled-functions)—Scheduling
+  limits
 
-- [Environment Variables](https://docs.convex.dev/production/environment-variables) —
-  Environment variable limits
+- [Environment Variables](https://docs.convex.dev/production/environment-variables)—Environment
+  variable limits
 
 ### Community Resources
 
-- [Queries that Scale](https://stack.convex.dev/queries-that-scale) — Community article
-  on scalable query patterns (February 2024)
+- [Queries that Scale](https://stack.convex.dev/queries-that-scale)—Community article on
+  scalable query patterns (February 2024)
 
 ### Official Libraries and Tools
 
-- [Convex Aggregate Component](https://github.com/get-convex/aggregate) — Official
-  library for maintaining denormalized aggregates
+- [Convex Aggregate Component](https://github.com/get-convex/aggregate)—Official library
+  for maintaining denormalized aggregates
 
-- [Convex Helpers](https://github.com/get-convex/convex-helpers) — Utilities for
+- [Convex Helpers](https://github.com/get-convex/convex-helpers)—Utilities for
   pagination, filtering, and common patterns
 
 * * *

package/dist/docs/guidelines/convex-rules.md

@@ -3,9 +3,9 @@ title: Convex Rules
 description: Guidelines and best practices for building Convex projects, including database schema design, queries, mutations, and real-world examples
 author: Convex team
 ---
-# Convex guidelines
+# Convex Guidelines
 
-## Function guidelines
+## Function Guidelines
 
 ### New function syntax
 
@@ -265,7 +265,7 @@ Note: `paginationOpts` is an object with the following properties:
   continueCursor (a string that represents the cursor to use to fetch the next page of
   documents)
 
-## Validator guidelines
+## Validator Guidelines
 
 - `v.bigint()` is deprecated for representing signed 64-bit integers.
   Use `v.int64()` instead.
@@ -273,7 +273,7 @@ Note: `paginationOpts` is an object with the following properties:
 - Use `v.record()` for defining a record type.
   `v.map()` and `v.set()` are not supported.
 
-## Schema guidelines
+## Schema Guidelines
 
 - Always define your schema in `convex/schema.ts`.
 
@@ -292,7 +292,7 @@ Note: `paginationOpts` is an object with the following properties:
   If you want to be able to query by “field1” then “field2” and by “field2” then
   “field1”, you must create separate indexes.
 
-## Typescript guidelines
+## TypeScript Guidelines
 
 - You can use the helper typescript type `Id` imported from ‘./\_generated/dataModel’ to
   get the type of the id for a given table.
@@ -341,7 +341,7 @@ export const exampleQuery = query({
 - Always add `@types/node` to your `package.json` when using any Node.js built-in
   modules.
 
-## Full text search guidelines
+## Full Text Search Guidelines
 
 - A query for “10 messages in channel ‘#general’ that best match the query ‘hello hi’ in
   their body” would look like:
@@ -349,7 +349,7 @@ export const exampleQuery = query({
 const messages = await ctx.db .query("messages") .withSearchIndex("search_body", (q) =>
 q.search("body", “hello hi”).eq("channel", “#general”), ) .take(10);
 
-## Query guidelines
+## Query Guidelines
 
 - Do NOT use `filter` in queries.
   Instead, define an index in the schema and use `withIndex` instead.
@@ -374,7 +374,7 @@ q.search("body", “hello hi”).eq("channel", “#general”), ) .take(10);
 - Document queries that use indexes will be ordered based on the columns in the index
   and can avoid slow table scans.
 
-## Mutation guidelines
+## Mutation Guidelines
 
 - Use `ctx.db.replace` to fully replace an existing document.
   This method will throw an error if the document does not exist.
@@ -382,7 +382,7 @@ q.search("body", “hello hi”).eq("channel", “#general”), ) .take(10);
 - Use `ctx.db.patch` to shallow merge updates into an existing document.
   This method will throw an error if the document does not exist.
 
-## Action guidelines
+## Action Guidelines
 
 - Always add `"use node";` to the top of files containing actions that use Node.js
   built-in modules.
@@ -405,7 +405,7 @@ export const exampleAction = action({
 });
 ```
 
-## Scheduling guidelines
+## Scheduling Guidelines
 
 ### Cron guidelines
 
@@ -445,7 +445,7 @@ export default crons;
 - If a cron calls an internal function, always import the `internal` object from
   ‘\_generated/api’, even if the internal function is registered in the same file.
 
-## File storage guidelines
+## File Storage Guidelines
 
 - Convex includes file storage for large files like images, videos, and PDFs.
 
@@ -485,7 +485,7 @@ export const exampleQuery = query({
 - Convex storage stores items as `Blob` objects.
   You must convert all items to/from a `Blob` when using Convex storage.
 
-# Examples:
+# Examples
 
 ## Example: chat-app
 
@@ -899,7 +899,7 @@ export default function App() {
 }
 ```
 
-## Additional guidelines
+## Additional Guidelines
 
 (These are added to the original Convex rules above.)
 

package/dist/docs/guidelines/electron-app-development-patterns.md

@@ -13,11 +13,11 @@ lightweight alternatives.
 
 This guideline is organized in three parts:
 
-1. **Part 1: Verified Facts** — Technical details verified through direct testing,
-   source code analysis, and documented issue reports
-2. **Part 2: Third-Party Perspectives** — Community opinions and blog posts, clearly
+1. **Part 1: Verified Facts**—Technical details verified through direct testing, source
+   code analysis, and documented issue reports
+2. **Part 2: Third-Party Perspectives**—Community opinions and blog posts, clearly
    marked as such
-3. **Part 3: Analysis and Recommendations** — Decision frameworks and recommendations
+3. **Part 3: Analysis and Recommendations**—Decision frameworks and recommendations
    based on available evidence, with explicit uncertainty acknowledgment
 
 ## Research Methodology
@@ -605,8 +605,8 @@ Building a desktop app involves three separate decisions:
 
 1. **Framework/runtime**: Electron vs Electrobun (vs Tauri, etc.)
 2. **Package manager**: npm vs pnpm vs Bun (as a toolchain)
-3. **Packaging & updates**: electron-builder vs electron-forge vs Electrobun’s built-in
-   pipeline
+3. **Packaging and updates**: electron-builder vs electron-forge vs Electrobun’s
+   built-in pipeline
 
 The sections below address these decisions, starting with package manager choice for
 Electron apps, then framework choice (Electron vs Electrobun).
@@ -792,18 +792,18 @@ Avoid `unsafe-eval` and `unsafe-inline`.
 - [Bun #1588: Electron failed to install correctly](https://github.com/oven-sh/bun/issues/1588)
 - [electron-forge #3906: Use bun when bunx is used](https://github.com/electron/forge/issues/3906)
   (April 2025)
-- [Quasar #17085: Electron build error with Bun and pnpm](https://github.com/quasarframework/quasar/issues/17085)
-  — Fixed in Quasar v1.8.5, v2.0.0-beta.11, v3.12.8, v4.0.0-beta.12
+- [Quasar #17085: Electron build error with Bun and pnpm](https://github.com/quasarframework/quasar/issues/17085)—Fixed
+  in Quasar v1.8.5, v2.0.0-beta.11, v3.12.8, v4.0.0-beta.12
 
 ### GitHub Issue Reports (Electrobun)
 
 - [Bun #24876: Crash on MacBook Pro M2 Pro](https://github.com/oven-sh/bun/issues/24876)
-  (November 2025) — Closed as duplicate; resolved in Electrobun 0.1.21-beta.0+
+  (November 2025)—Closed as duplicate; resolved in Electrobun 0.1.21-beta.0+
 
 ### GitHub Discussions
 
-- [Bun #790: Desktop support (Electron replacement)](https://github.com/oven-sh/bun/discussions/790)
-  — Community discussion on Bun desktop app support
+- [Bun #790: Desktop support (Electron replacement)](https://github.com/oven-sh/bun/discussions/790)—Community
+  discussion on Bun desktop app support
 
 ### Community Resources (Stack Overflow)
 
@@ -819,22 +819,22 @@ Avoid `unsafe-eval` and `unsafe-inline`.
 
 ### Blog Posts and News (Third-Party Opinions)
 
-- [Why We Ditched Node for Bun in 2026](https://dev.to/rayenmabrouk/why-we-ditched-node-for-bun-in-2026-and-why-you-should-too-48kg)
-  — Opinion piece
+- [Why We Ditched Node for Bun in 2026](https://dev.to/rayenmabrouk/why-we-ditched-node-for-bun-in-2026-and-why-you-should-too-48kg)—Opinion
+  piece
 - [Electrobun on Hacker News](https://news.ycombinator.com/item?id=42199486)
 - [Electrobun on Brian Lovin’s HN](https://brianlovin.com/hn/42199486)
 
 ### Anthropic/Bun Acquisition (Primary Sources)
 
-- [Anthropic acquires Bun as Claude Code reaches $1B milestone](https://www.anthropic.com/news/anthropic-acquires-bun-as-claude-code-reaches-usd1b-milestone)
-  — Official Anthropic announcement (December 3, 2025)
-- [Bun is joining Anthropic](https://bun.com/blog/bun-joins-anthropic) — Bun’s
+- [Anthropic acquires Bun as Claude Code reaches $1B milestone](https://www.anthropic.com/news/anthropic-acquires-bun-as-claude-code-reaches-usd1b-milestone)—Official
+  Anthropic announcement (December 3, 2025)
+- [Bun is joining Anthropic](https://bun.com/blog/bun-joins-anthropic)—Bun’s
   announcement (December 2, 2025)
 
 ### Other Bug Reports
 
-- [Launchpad #1944468: Electron applications all crash upon launch](https://bugs.launchpad.net/bugs/1944468)
-  — Ubuntu-specific Electron issues
+- [Launchpad #1944468: Electron applications all crash upon launch](https://bugs.launchpad.net/bugs/1944468)—Ubuntu-specific
+  Electron issues
 
 <!-- This document follows common-doc-guidelines.md.
 See github.com/jlevy/practical-prose and review guidelines before editing.

package/dist/docs/guidelines/general-comment-rules.md

@@ -41,7 +41,7 @@ These are language-agnostic rules on comments:
   NEVER DO THIS: “// Step 3: Fetch the data from the cache”\
   This is fine: “// Now fetch the data from the cache”
 
-- DO NOT use emojis or special unicode characters like ① or • or – or — in comments.
+- DO NOT use emojis or special unicode characters like ① or • or – or—in comments.
 
 - DO NOT leave comments about code changes that have been completed.
   DO NOT leave comments like:

package/dist/docs/guidelines/general-tdd-guidelines.md

@@ -106,13 +106,13 @@ Always run all the tests (except long-running tests) each time.
 
 Tests in the project are broken down into three types:
 
-1. Unit — fast, focused tests for small units of business logic
+1. Unit—fast, focused tests for small units of business logic
 
    - No network/web access
 
    - Typically part of CI builds.
 
-2. Integration — tests that exercise multiple components efficiently
+2. Integration—tests that exercise multiple components efficiently
 
    - Mock external APIs
 
@@ -122,7 +122,7 @@ Tests in the project are broken down into three types:
 
    - File names end with integration.test.ts
 
-3. Golden — tests that check behavior in a fine-grained way across known “golden”
+3. Golden—tests that check behavior in a fine-grained way across known “golden”
    scenarios
 
    - These are an essential type of test that is often neglected but very powerful!
@@ -141,7 +141,7 @@ Tests in the project are broken down into three types:
 
    - Typicaly part of CI builds as long as they are fast enough.
 
-4. E2E — tests of real system behavior with live APIs.
+4. E2E—tests of real system behavior with live APIs.
    Are not run on every commit as they can have costs or side effects or be slow.
    Requires all API keys.
    File names end with e2e.test.ts

package/dist/docs/guidelines/golden-testing-guidelines.md

@@ -7,7 +7,7 @@ author: Joshua Levy (github.com/jlevy) with LLM assistance
 
 **Related**: `tbd guidelines general-tdd-guidelines`
 
-## TL;DR (What to do)
+## TL;DR (What to Do)
 
 - Define a session schema (events) with stable vs unstable fields.
 
@@ -130,11 +130,11 @@ npx tryscript@latest --help    # CLI options
 ```
 
 **Key syntax** (see `tryscript docs` for complete reference):
-- `$ command` — command to run
-- `? N` — expected exit code (default 0)
-- `[..]` — matches any text on a single line
-- `...` — matches zero or more complete lines
-- `[PATTERN]` — custom regex patterns defined in YAML frontmatter
+- `$ command`—command to run
+- `? N`—expected exit code (default 0)
+- `[..]`—matches any text on a single line
+- `...`—matches zero or more complete lines
+- `[PATTERN]`—custom regex patterns defined in YAML frontmatter
 
 This guideline does not duplicate tryscript’s documentation.
 For pattern syntax, YAML frontmatter options, sandbox configuration, and advanced
@@ -475,11 +475,11 @@ The developer workflow for golden tests:
 
 1. **Make changes**: Modify business logic, fix bugs, add features
 
-2. **Run tests**: `pnpm test:golden` — tests fail if behavior changed
+2. **Run tests**: `pnpm test:golden`—tests fail if behavior changed
 
-3. **Regenerate**: `pnpm test:golden --update` — update golden files
+3. **Regenerate**: `pnpm test:golden --update`—update golden files
 
-4. **Review diffs**: `git diff tests/golden/` — verify changes are intentional
+4. **Review diffs**: `git diff tests/golden/`—verify changes are intentional
 
 5. **Commit**: Session files committed alongside code changes