get-tbd 0.1.19 → 0.1.20

package/dist/bin.mjs

@@ -13576,6 +13576,12 @@ const YAML_STRINGIFY_OPTIONS_COMPACT = {
 * ~50 lines is slightly more than one terminal screen.
 */
 const PAGINATION_LINE_THRESHOLD = 50;
+/**
+* Maximum lines to display when showing parent bead context in `tbd show`.
+* The parent's full serialized output is truncated to this many lines,
+* with an ellipsis and omitted-line count appended if exceeded.
+*/
+const PARENT_CONTEXT_MAX_LINES = 50;
 
 //#endregion
 //#region src/utils/yaml-utils.ts
@@ -13878,7 +13884,7 @@ function serializeIssue(issue) {
 * Package version, derived from git at build time.
 * Format: X.Y.Z for releases, X.Y.Z-dev.N.hash for dev builds.
 */
-const VERSION$1 = "0.1.19";
+const VERSION$1 = "0.1.20";
 
 //#endregion
 //#region src/cli/lib/version.ts
@@ -97286,17 +97292,15 @@ async function writeFileAsync(filePath, data, options = DEFAULT_WRITE_OPTIONS) {
 *
 * On main/dev branches:
 *   .tbd/
-*     config.yml              - Project configuration (tracked)
-*     state.yml               - Local state (gitignored)
-*     .gitignore              - Ignores docs/, data-sync-worktree/, data-sync/
-*     docs/                   - Installed documentation (gitignored, regenerated on setup)
-*     data-sync-worktree/     - Hidden worktree checkout of tbd-sync branch
-*       .tbd/
-*         data-sync/
-*           issues/
-*           mappings/
-*           attic/
-*           meta.yml
+*     Committed to the repo:
+*       config.yml            - Project configuration
+*       .gitignore            - Controls what's gitignored below
+*       workspaces/           - Persistent state (outbox, named workspaces)
+*     Gitignored (local only):
+*       state.yml             - Local state
+*       docs/                 - Installed documentation (regenerated on setup)
+*       data-sync-worktree/   - Hidden worktree checkout of tbd-sync branch
+*         .tbd/data-sync/     - issues/, mappings/, attic/, meta.yml
 *
 * On tbd-sync branch:
 *   .tbd/
@@ -99150,7 +99154,10 @@ Example:
 				"",
 				"# Temporary files",
 				"*.tmp",
-				"*.temp"
+				"*.temp",
+				"",
+				"# workspaces/ stores state (including outbox) committed to the working branch",
+				"!workspaces/"
 			]);
 			this.output.debug(`Created ${TBD_DIR}/.gitignore`);
 			await mkdir(join(cwd, TBD_SHORTCUTS_SYSTEM), { recursive: true });
@@ -100802,6 +100809,45 @@ const listCommand = new Command("list").description("List issues").option("--sta
 *
 * See: tbd-design.md §4.4 Show
 */
+/**
+* Render a serialized issue with colorized output, optionally truncated.
+*
+* @param issue - The issue to render
+* @param colors - Color functions
+* @param maxLines - If set, truncate output to this many lines with an omission notice
+* @returns Array of formatted lines
+*/
+function renderIssueLines(issue, colors) {
+	const serialized = serializeIssue(issue);
+	const output = [];
+	for (const line of serialized.split("\n")) if (line === "---") output.push(colors.dim(line));
+	else if (line.startsWith("id:")) output.push(`${colors.dim("id:")} ${colors.id(line.slice(4))}`);
+	else if (line.startsWith("status:")) {
+		const status = line.slice(8).trim();
+		const statusColor = getStatusColor(status, colors);
+		output.push(`${colors.dim("status:")} ${statusColor(status)}`);
+	} else if (line.startsWith("priority:")) {
+		const priority = parseInt(line.slice(10).trim(), 10);
+		const priorityColor = getPriorityColor(priority, colors);
+		output.push(`${colors.dim("priority:")} ${priorityColor(formatPriority(priority))}`);
+	} else if (line.startsWith("title:")) output.push(`${colors.dim("title:")} ${colors.bold(line.slice(7))}`);
+	else if (line.startsWith("spec_path:")) output.push(`${colors.dim("spec_path:")} ${colors.id(line.slice(11))}`);
+	else if (line.startsWith("## Notes")) output.push(colors.bold(line));
+	else if (line.startsWith("  - ")) output.push(`  - ${colors.label(line.slice(4))}`);
+	else output.push(line);
+	return output;
+}
+/**
+* Print lines with optional max-lines truncation.
+* If maxLines is set and the output exceeds it, truncates and appends an omission notice.
+*/
+function printWithTruncation(lines, colors, maxLines) {
+	if (maxLines && lines.length > maxLines) {
+		const omitted = lines.length - maxLines;
+		for (const line of lines.slice(0, maxLines)) console.log(line);
+		console.log(colors.dim(`… [${omitted} line${omitted === 1 ? "" : "s"} omitted]`));
+	} else for (const line of lines) console.log(line);
+}
 var ShowHandler = class extends BaseCommand {
 	async run(id, command, options) {
 		const ctx = await loadFullContext(command);
@@ -100812,29 +100858,28 @@ var ShowHandler = class extends BaseCommand {
 		} catch {
 			throw new NotFoundError("Issue", id);
 		}
+		let parentIssue;
+		if (issue.parent_id && options.parent !== false) try {
+			parentIssue = await readIssue(ctx.dataSyncDir, issue.parent_id);
+		} catch {}
+		const maxLines = options.maxLines ? parseInt(options.maxLines, 10) : void 0;
 		const displayId = ctx.displayId(issue.id);
 		const displayIssue = {
 			...issue,
-			displayId
+			displayId,
+			...parentIssue ? { parent: {
+				...parentIssue,
+				displayId: ctx.displayId(parentIssue.id)
+			} } : {}
 		};
 		this.output.data(displayIssue, () => {
 			const colors = this.output.getColors();
-			const lines = serializeIssue(issue).split("\n");
-			for (const line of lines) if (line === "---") console.log(colors.dim(line));
-			else if (line.startsWith("id:")) console.log(`${colors.dim("id:")} ${colors.id(line.slice(4))}`);
-			else if (line.startsWith("status:")) {
-				const status = line.slice(8).trim();
-				const statusColor = getStatusColor(status, colors);
-				console.log(`${colors.dim("status:")} ${statusColor(status)}`);
-			} else if (line.startsWith("priority:")) {
-				const priority = parseInt(line.slice(10).trim(), 10);
-				const priorityColor = getPriorityColor(priority, colors);
-				console.log(`${colors.dim("priority:")} ${priorityColor(formatPriority(priority))}`);
-			} else if (line.startsWith("title:")) console.log(`${colors.dim("title:")} ${colors.bold(line.slice(7))}`);
-			else if (line.startsWith("spec_path:")) console.log(`${colors.dim("spec_path:")} ${colors.id(line.slice(11))}`);
-			else if (line.startsWith("## Notes")) console.log(colors.bold(line));
-			else if (line.startsWith("  - ")) console.log(`  - ${colors.label(line.slice(4))}`);
-			else console.log(line);
+			printWithTruncation(renderIssueLines(issue, colors), colors, maxLines);
+			if (parentIssue) {
+				console.log("");
+				console.log(colors.dim("The parent of this bead is:"));
+				printWithTruncation(renderIssueLines(parentIssue, colors), colors, PARENT_CONTEXT_MAX_LINES);
+			}
 			if (options.showOrder) {
 				console.log("");
 				console.log(colors.dim("child_order_hints:"));
@@ -100847,7 +100892,7 @@ var ShowHandler = class extends BaseCommand {
 		});
 	}
 };
-const showCommand = new Command("show").description("Show issue details").argument("<id>", "Issue ID").option("--show-order", "Display children ordering hints").action(async (id, options, command) => {
+const showCommand = new Command("show").description("Show issue details").argument("<id>", "Issue ID").option("--show-order", "Display children ordering hints").option("--no-parent", "Suppress automatic parent context display").option("--max-lines <n>", "Truncate output to N lines").action(async (id, options, command) => {
 	await new ShowHandler(command).run(id, command, options);
 });
 
@@ -103178,6 +103223,8 @@ var SyncHandler = class extends BaseCommand {
 				console.log("    1. Commit:  git add .tbd/workspaces && git commit -m 'tbd: save outbox'");
 				console.log("    2. Push your working branch:  git push");
 				console.log("    3. Run 'tbd sync' when push access is available");
+				console.log("");
+				console.log("  WARNING: Do NOT add .tbd/workspaces/ to .gitignore -- that would cause data loss.");
 			} else {
 				const totalInOutbox = existingOutboxCount + result.saved;
 				if (existingOutboxCount > 0) {
@@ -103193,6 +103240,8 @@ var SyncHandler = class extends BaseCommand {
 				console.log("    2. Push your working branch:  git push");
 				console.log("    3. Run 'tbd sync' when push access is available");
 				console.log("       (outbox will be imported automatically on successful sync)");
+				console.log("");
+				console.log("  WARNING: Do NOT add .tbd/workspaces/ to .gitignore -- that would cause data loss.");
 			}
 		} catch (saveError) {
 			const saveErrorMsg = saveError instanceof Error ? saveError.message : String(saveError);
@@ -107366,7 +107415,7 @@ function inferGuidelineCategory(name) {
 	if (name.startsWith("typescript-")) return "typescript";
 	if (name.startsWith("python-")) return "python";
 	if (name.includes("tdd") || name.includes("testing") || name.includes("golden")) return "testing";
-	if (name.startsWith("general-") || name.includes("rules") || name.includes("patterns") || name.startsWith("backward-") || name.startsWith("convex-") || name.startsWith("release-")) return "general";
+	if (name.startsWith("general-") || name.includes("rules") || name.includes("patterns") || name.startsWith("backward-") || name.startsWith("convex-") || name.startsWith("release-") || name.startsWith("writing-")) return "general";
 }
 var GuidelinesHandler = class extends DocCommandHandler {
 	constructor(command) {
@@ -108270,7 +108319,10 @@ var SetupDefaultHandler = class extends BaseCommand {
 			"",
 			"# Temporary files",
 			"*.tmp",
-			"*.temp"
+			"*.temp",
+			"",
+			"# workspaces/ stores state (including outbox) committed to the working branch",
+			"!workspaces/"
 		]);
 		if (tbdGitignoreResult.created) console.log(`  ${colors.success("✓")} Created .tbd/.gitignore`);
 		else if (tbdGitignoreResult.added.length > 0) console.log(`  ${colors.success("✓")} Updated .tbd/.gitignore with new patterns`);
@@ -108397,7 +108449,10 @@ Example:
 			"",
 			"# Temporary files",
 			"*.tmp",
-			"*.temp"
+			"*.temp",
+			"",
+			"# workspaces/ stores state (including outbox) committed to the working branch",
+			"!workspaces/"
 		]);
 		if (tbdGitignoreResult.created) console.log(`  ${colors.success("✓")} Created .tbd/.gitignore`);
 		else if (tbdGitignoreResult.added.length > 0) console.log(`  ${colors.success("✓")} Updated .tbd/.gitignore`);