get-tbd 0.1.8

package/dist/src-CWD4YCBk.mjs

@@ -0,0 +1,319 @@
+import { z } from "zod";
+import matter from "gray-matter";
+import { parse, stringify } from "yaml";
+
+//#region src/lib/schemas.ts
+/**
+* Zod schemas for tbd entities.
+*
+* These schemas are the normative specification for the file format.
+* See: tbd-design.md §2.6 Schemas
+*/
+/**
+* ISO8601 timestamp with Z suffix (UTC).
+*/
+const Timestamp = z.string().datetime();
+/**
+* Issue ID: prefix + 26 lowercase alphanumeric characters (ULID format).
+* Format: is-{ulid} where ulid is 26 chars (a-z, 0-9).
+* Example: is-01hx5zzkbkactav9wevgemmvrz
+*/
+const IssueId = z.string().regex(/^is-[0-9a-z]{26}$/);
+/**
+* Short ID: 1+ base36 characters used for external/display IDs.
+* Typically 4 chars for new IDs (e.g., a7k2, b3m9).
+* Imports may preserve longer numeric IDs (e.g., "100" from "tbd-100").
+*/
+const ShortId = z.string().regex(/^[0-9a-z]+$/);
+/**
+* External Issue ID input: accepts {prefix}-{short} or just {short}.
+* Examples: bd-a7k2, a7k2, bd-100, 100
+*/
+const ExternalIssueIdInput = z.string().regex(/^([a-z]+-)?[0-9a-z]+$/);
+/**
+* Edit counter - incremented on every local change.
+* NOTE: Version is NOT used for conflict detection (Git push rejection is used).
+* Content hash is used as tiebreaker during merge resolution.
+* Version is informational only - set to max(local, remote) + 1 after merges.
+*/
+const Version = z.number().int().nonnegative();
+/**
+* Entity type discriminator.
+*/
+const EntityType = z.literal("is");
+/**
+* All entities share common fields.
+*/
+const BaseEntity = z.object({
+	type: EntityType,
+	id: IssueId,
+	version: Version,
+	created_at: Timestamp,
+	updated_at: Timestamp,
+	extensions: z.record(z.string(), z.unknown()).optional()
+});
+/**
+* Issue status values matching Beads.
+*/
+const IssueStatus = z.enum([
+	"open",
+	"in_progress",
+	"blocked",
+	"deferred",
+	"closed"
+]);
+/**
+* Issue kind/type values matching Beads.
+* Note: CLI uses --type flag, which maps to this `kind` field.
+*/
+const IssueKind = z.enum([
+	"bug",
+	"feature",
+	"task",
+	"epic",
+	"chore"
+]);
+/**
+* Priority: 0 (highest/critical) to 4 (lowest).
+*/
+const Priority = z.number().int().min(0).max(4);
+/**
+* Dependency types - only "blocks" supported initially.
+*/
+const DependencyRelationType = z.enum(["blocks"]);
+/**
+* A dependency relationship.
+*/
+const Dependency = z.object({
+	type: DependencyRelationType,
+	target: IssueId
+});
+/**
+* Full issue schema.
+*
+* Note: Fields use .nullable() in addition to .optional() because
+* YAML parses `field: null` as JavaScript null, not undefined.
+*/
+const IssueSchema = BaseEntity.extend({
+	type: z.literal("is"),
+	title: z.string().min(1).max(500),
+	description: z.string().max(5e4).nullable().optional(),
+	notes: z.string().max(5e4).nullable().optional(),
+	kind: IssueKind.default("task"),
+	status: IssueStatus.default("open"),
+	priority: Priority.default(2),
+	assignee: z.string().nullable().optional(),
+	labels: z.array(z.string()).default([]),
+	dependencies: z.array(Dependency).default([]),
+	parent_id: IssueId.nullable().optional(),
+	due_date: Timestamp.nullable().optional(),
+	deferred_until: Timestamp.nullable().optional(),
+	created_by: z.string().nullable().optional(),
+	closed_at: Timestamp.nullable().optional(),
+	close_reason: z.string().nullable().optional(),
+	spec_path: z.string().nullable().optional()
+});
+/**
+* Git branch name - restricted to safe characters.
+* Allows: alphanumeric, hyphens, underscores, forward slashes, and dots.
+* Prevents shell injection in git commands.
+*/
+const GitBranchName = z.string().min(1).max(255).regex(/^[a-zA-Z0-9._/-]+$/, "Invalid branch name: only alphanumeric, dots, underscores, hyphens, and slashes allowed");
+/**
+* Git remote name - restricted to safe characters.
+* Allows: alphanumeric, hyphens, underscores, and dots.
+* Prevents shell injection in git commands.
+*/
+const GitRemoteName = z.string().min(1).max(255).regex(/^[a-zA-Z0-9._-]+$/, "Invalid remote name: only alphanumeric, dots, underscores, and hyphens allowed");
+/**
+* Doc cache configuration - maps destination paths to source locations.
+*
+* Keys are destination paths relative to .tbd/docs/ (e.g., "shortcuts/standard/commit-code.md")
+* Values are source locations:
+* - internal: prefix for bundled docs (e.g., "internal:shortcuts/standard/commit-code.md")
+* - Full URL for external docs (e.g., "https://raw.githubusercontent.com/org/repo/main/file.md")
+*
+* Example:
+* ```yaml
+* doc_cache:
+*   shortcuts/standard/commit-code.md: internal:shortcuts/standard/commit-code.md
+*   shortcuts/custom/my-shortcut.md: https://raw.githubusercontent.com/org/repo/main/shortcuts/my-shortcut.md
+* ```
+*/
+const DocCacheConfigSchema = z.record(z.string(), z.string());
+/**
+* Documentation cache configuration (consolidated structure).
+*
+* Combines file sync mappings and lookup paths into a single config block.
+* See: docs/project/specs/active/plan-2026-01-26-docs-cache-config-restructure.md
+*/
+const DocsCacheSchema = z.object({
+	files: z.record(z.string(), z.string()).optional(),
+	lookup_path: z.array(z.string()).default([".tbd/docs/shortcuts/system", ".tbd/docs/shortcuts/standard"])
+});
+/**
+* Project configuration stored in .tbd/config.yml
+*
+* ⚠️ FORMAT VERSIONING: See tbd-format.ts for version history and migration rules.
+* The tbd_format field tracks breaking changes to this schema.
+*/
+const ConfigSchema = z.object({
+	tbd_format: z.string().default("f01"),
+	tbd_version: z.string(),
+	sync: z.object({
+		branch: GitBranchName.default("tbd-sync"),
+		remote: GitRemoteName.default("origin")
+	}).default({}),
+	display: z.object({ id_prefix: z.string().min(1).max(20) }),
+	settings: z.object({
+		auto_sync: z.boolean().default(false),
+		doc_auto_sync_hours: z.number().default(24),
+		use_gh_cli: z.boolean().default(true)
+	}).default({}),
+	docs_cache: DocsCacheSchema.optional()
+});
+/**
+* Shared metadata stored in .tbd/data-sync/meta.yml
+*/
+const MetaSchema = z.object({
+	schema_version: z.number().int(),
+	created_at: Timestamp
+});
+/**
+* Per-node state stored in .tbd/state.yml (gitignored).
+* Tracks local timing information that shouldn't be shared across nodes.
+*/
+const LocalStateSchema = z.object({
+	last_sync_at: Timestamp.optional(),
+	last_doc_sync_at: Timestamp.optional(),
+	welcome_seen: z.boolean().optional()
+});
+/**
+* Preserved conflict losers.
+*/
+const AtticEntrySchema = z.object({
+	entity_id: IssueId,
+	timestamp: Timestamp,
+	field: z.string(),
+	lost_value: z.string(),
+	winner_source: z.enum(["local", "remote"]),
+	loser_source: z.enum(["local", "remote"]),
+	context: z.object({
+		local_version: Version,
+		remote_version: Version,
+		local_updated_at: Timestamp,
+		remote_updated_at: Timestamp
+	})
+});
+
+//#endregion
+//#region src/file/parser.ts
+/**
+* YAML front matter parser and serializer for issue files.
+*
+* Issues are stored as Markdown files with YAML front matter:
+* ---
+* type: is
+* id: is-a1b2c3
+* ...
+* ---
+*
+* Description body here.
+*
+* ## Notes
+*
+* Working notes here.
+*
+* See: tbd-design.md §2.1 Markdown + YAML Front Matter Format
+*/
+/**
+* gray-matter options using the 'yaml' package as engine.
+* This preserves date strings instead of converting them to Date objects.
+*/
+const matterOptions = { engines: { yaml: {
+	parse: (str) => parse(str),
+	stringify: (obj) => stringify(obj)
+} } };
+/**
+* Parse a Markdown file with YAML front matter.
+* Uses gray-matter for consistent frontmatter parsing.
+* Handles both LF and CRLF line endings.
+*/
+function parseMarkdownWithFrontmatter(content) {
+	const normalizedContent = content.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+	if (!matter.test(normalizedContent)) throw new Error("Invalid format: missing front matter opening delimiter");
+	const parsed = matter(normalizedContent, matterOptions);
+	if (parsed.matter === "" && !normalizedContent.includes("---\n---")) {
+		const lines = normalizedContent.split("\n");
+		let hasClosing = false;
+		for (let i = 1; i < lines.length; i++) if (lines[i]?.trim() === "---") {
+			hasClosing = true;
+			break;
+		}
+		if (!hasClosing) throw new Error("Invalid format: missing front matter closing delimiter");
+	}
+	const frontmatter = parsed.data;
+	const body = parsed.content.trim();
+	const notesMatch = /\n## Notes\n/i.exec(body);
+	let description = body;
+	let notes = "";
+	if (notesMatch?.index !== void 0) {
+		description = body.slice(0, notesMatch.index).trim();
+		notes = body.slice(notesMatch.index + notesMatch[0].length).trim();
+	}
+	return {
+		frontmatter,
+		description,
+		notes
+	};
+}
+/**
+* Parse an issue from Markdown file content.
+*/
+function parseIssue(content) {
+	const { frontmatter, description, notes } = parseMarkdownWithFrontmatter(content);
+	const data = {
+		...frontmatter,
+		description: description || void 0,
+		notes: notes || void 0
+	};
+	return IssueSchema.parse(data);
+}
+/**
+* Serialize an issue to Markdown file content.
+* Uses canonical serialization for deterministic output.
+*/
+function serializeIssue(issue) {
+	const { description, notes, ...metadata } = issue;
+	const sortedMetadata = {};
+	for (const key of Object.keys(metadata).sort()) sortedMetadata[key] = metadata[key];
+	const parts = [
+		"---",
+		stringify(sortedMetadata, {
+			sortMapEntries: true,
+			lineWidth: 0,
+			nullStr: "null"
+		}).trim(),
+		"---"
+	];
+	if (description) parts.push(description.trim());
+	if (notes) {
+		parts.push("");
+		parts.push("## Notes");
+		parts.push("");
+		parts.push(notes.trim());
+	}
+	return parts.join("\n") + "\n";
+}
+
+//#endregion
+//#region src/index.ts
+/**
+* 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 = "0.1.8";
+
+//#endregion
+export { ShortId as C, Priority as S, Version as T, IssueKind as _, AtticEntrySchema as a, LocalStateSchema as b, Dependency as c, DocsCacheSchema as d, EntityType as f, IssueId as g, GitRemoteName as h, serializeIssue as i, DependencyRelationType as l, GitBranchName as m, parseIssue as n, BaseEntity as o, ExternalIssueIdInput as p, parseMarkdownWithFrontmatter as r, ConfigSchema as s, VERSION as t, DocCacheConfigSchema as u, IssueSchema as v, Timestamp as w, MetaSchema as x, IssueStatus as y };
+//# sourceMappingURL=src-CWD4YCBk.mjs.map

package/dist/src-CWD4YCBk.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"src-CWD4YCBk.mjs","names":["parseYaml","stringifyYaml"],"sources":["../src/lib/schemas.ts","../src/file/parser.ts","../src/index.ts"],"sourcesContent":["/**\n * Zod schemas for tbd entities.\n *\n * These schemas are the normative specification for the file format.\n * See: tbd-design.md §2.6 Schemas\n */\n\nimport { z } from 'zod';\n\n// =============================================================================\n// Common Types (§2.6.1)\n// =============================================================================\n\n/**\n * ISO8601 timestamp with Z suffix (UTC).\n */\nexport const Timestamp = z.string().datetime();\n\n/**\n * Issue ID: prefix + 26 lowercase alphanumeric characters (ULID format).\n * Format: is-{ulid} where ulid is 26 chars (a-z, 0-9).\n * Example: is-01hx5zzkbkactav9wevgemmvrz\n */\nexport const IssueId = z.string().regex(/^is-[0-9a-z]{26}$/);\n\n/**\n * Short ID: 1+ base36 characters used for external/display IDs.\n * Typically 4 chars for new IDs (e.g., a7k2, b3m9).\n * Imports may preserve longer numeric IDs (e.g., \"100\" from \"tbd-100\").\n */\nexport const ShortId = z.string().regex(/^[0-9a-z]+$/);\n\n/**\n * External Issue ID input: accepts {prefix}-{short} or just {short}.\n * Examples: bd-a7k2, a7k2, bd-100, 100\n */\nexport const ExternalIssueIdInput = z.string().regex(/^([a-z]+-)?[0-9a-z]+$/);\n\n/**\n * Edit counter - incremented on every local change.\n * NOTE: Version is NOT used for conflict detection (Git push rejection is used).\n * Content hash is used as tiebreaker during merge resolution.\n * Version is informational only - set to max(local, remote) + 1 after merges.\n */\nexport const Version = z.number().int().nonnegative();\n\n/**\n * Entity type discriminator.\n */\nexport const EntityType = z.literal('is');\n\n// =============================================================================\n// BaseEntity (§2.6.2)\n// =============================================================================\n\n/**\n * All entities share common fields.\n */\nexport const BaseEntity = z.object({\n  type: EntityType,\n  id: IssueId,\n  version: Version,\n  created_at: Timestamp,\n  updated_at: Timestamp,\n\n  // Extensibility namespace for third-party data\n  extensions: z.record(z.string(), z.unknown()).optional(),\n});\n\n// =============================================================================\n// Issue Schema (§2.6.3)\n// =============================================================================\n\n/**\n * Issue status values matching Beads.\n */\nexport const IssueStatus = z.enum(['open', 'in_progress', 'blocked', 'deferred', 'closed']);\n\n/**\n * Issue kind/type values matching Beads.\n * Note: CLI uses --type flag, which maps to this `kind` field.\n */\nexport const IssueKind = z.enum(['bug', 'feature', 'task', 'epic', 'chore']);\n\n/**\n * Priority: 0 (highest/critical) to 4 (lowest).\n */\nexport const Priority = z.number().int().min(0).max(4);\n\n/**\n * Dependency types - only \"blocks\" supported initially.\n */\nexport const DependencyRelationType = z.enum(['blocks']);\n\n/**\n * A dependency relationship.\n */\nexport const Dependency = z.object({\n  type: DependencyRelationType,\n  target: IssueId,\n});\n\n/**\n * Full issue schema.\n *\n * Note: Fields use .nullable() in addition to .optional() because\n * YAML parses `field: null` as JavaScript null, not undefined.\n */\nexport const IssueSchema = BaseEntity.extend({\n  type: z.literal('is'),\n\n  title: z.string().min(1).max(500),\n  description: z.string().max(50000).nullable().optional(),\n  notes: z.string().max(50000).nullable().optional(),\n\n  kind: IssueKind.default('task'),\n  status: IssueStatus.default('open'),\n  priority: Priority.default(2),\n\n  assignee: z.string().nullable().optional(),\n  labels: z.array(z.string()).default([]),\n  dependencies: z.array(Dependency).default([]),\n\n  // Hierarchical issues\n  parent_id: IssueId.nullable().optional(),\n\n  // Beads compatibility\n  due_date: Timestamp.nullable().optional(),\n  deferred_until: Timestamp.nullable().optional(),\n\n  created_by: z.string().nullable().optional(),\n  closed_at: Timestamp.nullable().optional(),\n  close_reason: z.string().nullable().optional(),\n\n  // Spec linking - path to related spec/doc (relative to repo root)\n  spec_path: z.string().nullable().optional(),\n});\n\n// =============================================================================\n// Config Schema (§2.6.4)\n// =============================================================================\n\n/**\n * Git branch name - restricted to safe characters.\n * Allows: alphanumeric, hyphens, underscores, forward slashes, and dots.\n * Prevents shell injection in git commands.\n */\nexport const GitBranchName = z\n  .string()\n  .min(1)\n  .max(255)\n  .regex(\n    /^[a-zA-Z0-9._/-]+$/,\n    'Invalid branch name: only alphanumeric, dots, underscores, hyphens, and slashes allowed',\n  );\n\n/**\n * Git remote name - restricted to safe characters.\n * Allows: alphanumeric, hyphens, underscores, and dots.\n * Prevents shell injection in git commands.\n */\nexport const GitRemoteName = z\n  .string()\n  .min(1)\n  .max(255)\n  .regex(\n    /^[a-zA-Z0-9._-]+$/,\n    'Invalid remote name: only alphanumeric, dots, underscores, and hyphens allowed',\n  );\n\n/**\n * Doc cache configuration - maps destination paths to source locations.\n *\n * Keys are destination paths relative to .tbd/docs/ (e.g., \"shortcuts/standard/commit-code.md\")\n * Values are source locations:\n * - internal: prefix for bundled docs (e.g., \"internal:shortcuts/standard/commit-code.md\")\n * - Full URL for external docs (e.g., \"https://raw.githubusercontent.com/org/repo/main/file.md\")\n *\n * Example:\n * ```yaml\n * doc_cache:\n *   shortcuts/standard/commit-code.md: internal:shortcuts/standard/commit-code.md\n *   shortcuts/custom/my-shortcut.md: https://raw.githubusercontent.com/org/repo/main/shortcuts/my-shortcut.md\n * ```\n */\nexport const DocCacheConfigSchema = z.record(z.string(), z.string());\n\n/**\n * Documentation cache configuration (consolidated structure).\n *\n * Combines file sync mappings and lookup paths into a single config block.\n * See: docs/project/specs/active/plan-2026-01-26-docs-cache-config-restructure.md\n */\nexport const DocsCacheSchema = z.object({\n  /**\n   * Files to sync: maps destination paths to source locations.\n   * Keys are destination paths relative to .tbd/docs/\n   * Values are source locations:\n   * - internal: prefix for bundled docs (e.g., \"internal:shortcuts/standard/commit-code.md\")\n   * - Full URL for external docs (e.g., \"https://raw.githubusercontent.com/org/repo/main/file.md\")\n   */\n  files: z.record(z.string(), z.string()).optional(),\n  /**\n   * Search paths for doc lookup (like shell $PATH).\n   * Earlier paths take precedence when names conflict.\n   */\n  lookup_path: z\n    .array(z.string())\n    .default(['.tbd/docs/shortcuts/system', '.tbd/docs/shortcuts/standard']),\n});\n\n/**\n * Project configuration stored in .tbd/config.yml\n *\n * ⚠️ FORMAT VERSIONING: See tbd-format.ts for version history and migration rules.\n * The tbd_format field tracks breaking changes to this schema.\n */\nexport const ConfigSchema = z.object({\n  /**\n   * Format version for the .tbd/ directory structure.\n   * See tbd-format.ts for version history and migration rules.\n   * Only bumped for breaking changes that require migration.\n   */\n  tbd_format: z.string().default('f01'),\n\n  tbd_version: z.string(),\n  sync: z\n    .object({\n      branch: GitBranchName.default('tbd-sync'),\n      remote: GitRemoteName.default('origin'),\n    })\n    .default({}),\n  display: z.object({\n    id_prefix: z.string().min(1).max(20), // Required: set during init --prefix or import\n  }),\n  settings: z\n    .object({\n      auto_sync: z.boolean().default(false),\n      /**\n       * How often to automatically sync documentation cache (in hours).\n       * - Default: 24 (sync once per day when actively using tbd)\n       * - Set to 0 to disable auto-sync\n       * - Only triggers when accessing docs (shortcut, guidelines, template commands)\n       */\n      doc_auto_sync_hours: z.number().default(24),\n      /**\n       * Whether to install the ensure-gh-cli.sh hook script during setup.\n       * When true (default), `tbd setup` installs a SessionStart hook that\n       * ensures the GitHub CLI is available in agent sessions.\n       * Set to false or use `tbd setup --no-gh-cli` to disable.\n       */\n      use_gh_cli: z.boolean().default(true),\n    })\n    .default({}),\n  /**\n   * Documentation cache configuration (consolidated).\n   * Contains files to sync and lookup paths.\n   * See DocsCacheSchema for structure details.\n   */\n  docs_cache: DocsCacheSchema.optional(),\n});\n\n// =============================================================================\n// Meta Schema (§2.6.5)\n// =============================================================================\n\n/**\n * Shared metadata stored in .tbd/data-sync/meta.yml\n */\nexport const MetaSchema = z.object({\n  schema_version: z.number().int(),\n  created_at: Timestamp,\n});\n\n// =============================================================================\n// Local State Schema (§2.6.6)\n// =============================================================================\n\n/**\n * Per-node state stored in .tbd/state.yml (gitignored).\n * Tracks local timing information that shouldn't be shared across nodes.\n */\nexport const LocalStateSchema = z.object({\n  /** When this node last synced issues successfully */\n  last_sync_at: Timestamp.optional(),\n  /** When this node last synced the doc cache successfully */\n  last_doc_sync_at: Timestamp.optional(),\n  /** Whether the user has seen the welcome message */\n  welcome_seen: z.boolean().optional(),\n});\n\n// =============================================================================\n// Attic Entry Schema (§2.6.7)\n// =============================================================================\n\n/**\n * Preserved conflict losers.\n */\nexport const AtticEntrySchema = z.object({\n  entity_id: IssueId,\n  timestamp: Timestamp,\n  field: z.string(),\n  lost_value: z.string(),\n  winner_source: z.enum(['local', 'remote']),\n  loser_source: z.enum(['local', 'remote']),\n  context: z.object({\n    local_version: Version,\n    remote_version: Version,\n    local_updated_at: Timestamp,\n    remote_updated_at: Timestamp,\n  }),\n});\n","/**\n * YAML front matter parser and serializer for issue files.\n *\n * Issues are stored as Markdown files with YAML front matter:\n * ---\n * type: is\n * id: is-a1b2c3\n * ...\n * ---\n *\n * Description body here.\n *\n * ## Notes\n *\n * Working notes here.\n *\n * See: tbd-design.md §2.1 Markdown + YAML Front Matter Format\n */\n\nimport matter from 'gray-matter';\nimport { parse as parseYaml, stringify as stringifyYaml } from 'yaml';\n\nimport type { Issue } from '../lib/types.js';\nimport { IssueSchema } from '../lib/schemas.js';\n\n/**\n * gray-matter options using the 'yaml' package as engine.\n * This preserves date strings instead of converting them to Date objects.\n */\nexport const matterOptions = {\n  engines: {\n    yaml: {\n      parse: (str: string): object => parseYaml(str) as object,\n      stringify: (obj: object): string => stringifyYaml(obj),\n    },\n  },\n};\n\n/**\n * Parsed issue file content.\n */\nexport interface ParsedIssueFile {\n  frontmatter: Record<string, unknown>;\n  description: string;\n  notes: string;\n}\n\n/**\n * Parse a Markdown file with YAML front matter.\n * Uses gray-matter for consistent frontmatter parsing.\n * Handles both LF and CRLF line endings.\n */\nexport function parseMarkdownWithFrontmatter(content: string): ParsedIssueFile {\n  // Normalize CRLF to LF before parsing\n  const normalizedContent = content.replace(/\\r\\n/g, '\\n').replace(/\\r/g, '\\n');\n\n  // Check for valid frontmatter\n  if (!matter.test(normalizedContent)) {\n    throw new Error('Invalid format: missing front matter opening delimiter');\n  }\n\n  const parsed = matter(normalizedContent, matterOptions);\n\n  // gray-matter returns empty object if no closing delimiter found\n  // but the raw matter string will be empty if parsing failed\n  if (parsed.matter === '' && !normalizedContent.includes('---\\n---')) {\n    // Check if there's actually a closing delimiter\n    const lines = normalizedContent.split('\\n');\n    let hasClosing = false;\n    for (let i = 1; i < lines.length; i++) {\n      if (lines[i]?.trim() === '---') {\n        hasClosing = true;\n        break;\n      }\n    }\n    if (!hasClosing) {\n      throw new Error('Invalid format: missing front matter closing delimiter');\n    }\n  }\n\n  const frontmatter = parsed.data as Record<string, unknown>;\n\n  // Parse body - split into description and notes\n  const body = parsed.content.trim();\n\n  // Find notes section\n  const notesMatch = /\\n## Notes\\n/i.exec(body);\n  let description = body;\n  let notes = '';\n\n  if (notesMatch?.index !== undefined) {\n    description = body.slice(0, notesMatch.index).trim();\n    notes = body.slice(notesMatch.index + notesMatch[0].length).trim();\n  }\n\n  return { frontmatter, description, notes };\n}\n\n/**\n * Parse an issue from Markdown file content.\n */\nexport function parseIssue(content: string): Issue {\n  const { frontmatter, description, notes } = parseMarkdownWithFrontmatter(content);\n\n  // Merge body content into frontmatter\n  const data = {\n    ...frontmatter,\n    description: description || undefined,\n    notes: notes || undefined,\n  };\n\n  // Validate and parse with Zod\n  return IssueSchema.parse(data);\n}\n\n/**\n * Serialize an issue to Markdown file content.\n * Uses canonical serialization for deterministic output.\n */\nexport function serializeIssue(issue: Issue): string {\n  // Extract body fields\n  const { description, notes, ...metadata } = issue;\n\n  // Sort keys alphabetically for canonical output\n  const sortedMetadata: Record<string, unknown> = {};\n  for (const key of Object.keys(metadata).sort()) {\n    sortedMetadata[key] = metadata[key as keyof typeof metadata];\n  }\n\n  // Serialize YAML with specific options for canonical output\n  const yaml = stringifyYaml(sortedMetadata, {\n    sortMapEntries: true,\n    lineWidth: 0, // No wrapping\n    nullStr: 'null',\n  });\n\n  // Build the file content\n  // Note: No blank line between closing --- and body content\n  const parts = ['---', yaml.trim(), '---'];\n\n  if (description) {\n    parts.push(description.trim());\n  }\n\n  if (notes) {\n    parts.push('');\n    parts.push('## Notes');\n    parts.push('');\n    parts.push(notes.trim());\n  }\n\n  // Single newline at end\n  return parts.join('\\n') + '\\n';\n}\n","/**\n * tbd: Git-native issue tracking for AI agents and humans\n *\n * This is the library entry point. All exports here should be node-free\n * to support browser/edge runtime usage. CLI-specific code is in ./cli/.\n */\n\n// Version injected at build time\ndeclare const __TBD_VERSION__: string;\n\n/**\n * Package version, derived from git at build time.\n * Format: X.Y.Z for releases, X.Y.Z-dev.N.hash for dev builds.\n */\nexport const VERSION: string =\n  typeof __TBD_VERSION__ !== 'undefined' ? __TBD_VERSION__ : 'development';\n\n// Re-export schemas for library consumers\nexport * from './lib/schemas.js';\nexport * from './lib/types.js';\n\n// Re-export core operations (these should be node-free)\nexport { parseIssue, serializeIssue } from './file/parser.js';\n"],"mappings":"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"}