{title}

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_500":501,"_502":503},"routes/_app.x.$handle.$name",{"_100":99,"_32":45,"_108":90,"_27":109,"_13":14,"_110":-5,"_11":111,"_112":113,"_114":115,"_116":117,"_118":119,"_20":-5,"_120":-5,"_121":-5,"_122":25,"_123":124,"_125":59,"_126":-5,"_127":-5,"_128":129},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":-5,"_73":74,"_75":74,"_76":77,"_78":77,"_79":77,"_80":74,"_81":74,"_82":83,"_84":85,"_86":87,"_88":25},"version",172,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":20,"_35":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":33,"_34":20,"_35":36},"deleted",false,"deletedHere","path","docs/issue-tracker-valtown.md","latestPath","fileId","4e874dca-7be4-11f1-973a-1607ee4eb77e","name","issue-tracker-valtown.md","fileType","content","# Issue tracker: val-issue-tracker (JSON API)\n\nIssues and PRDs for this repo live in a [val-issue-tracker](https://www.val.town/x/nbbaier/val-issue-tracker)\ninstance. Use its JSON API for all operations — don't scrape the HTML pages.\n\n**Tracker URL**: `` — the host val's HTTP endpoint (e.g.\n`https://username-myval.web.val.run`). All paths below are relative to this.\n\n**Auth**: writes require `Authorization: Bearer `. Reads\n(list/get) are public — no token needed, same as the human-facing pages.\n\n## Conventions\n\n- **Create an issue**: `POST /api/issues` `{title, description?, priority?, labels?, assignee?, author?}` (`title` is the only required field) → returns the created issue.\n- **Read an issue**: `GET /api/issues/` → the issue plus a `comments` array.\n- **List issues**: `GET /api/issues?status=open&priority=high&label=needs-triage&search=...` → array of issues (`labels` as a string array; no comments — fetch by id for those).\n- **Comment on an issue**: `POST /api/issues//comments` `{body, author?}`.\n- **Apply / remove labels**: `POST /api/issues//labels` `{add: [\"...\"], remove: [\"...\"]}` — merges with existing labels, doesn't replace the array.\n- **Assign / claim**: `PATCH /api/issues/` `{assignee: \"...\"}`.\n- **Close**: `POST /api/issues//close` `{comment?}` — posts the comment first (if given), then sets status to `closed`.\n- **Reopen**: `PATCH /api/issues/` `{status: \"open\"}`.\n- **Edit title/description/priority**: `PATCH /api/issues/` `{title?, description?, priority?}`.\n\n`author` is free text — there's no Val Town account requirement for agents.\nEvery write may include it to attribute the change; if omitted it defaults to\n`\"agent\"`.\n\n## States\n\nThree states, not two: `open` / `in_progress` / `closed`. Where a skill speaks\nof GitHub/GitLab-style \"open\" issues, treat that as *not closed* — `open` OR\n`in_progress` — since this tracker has an intermediate state gh/glab don't.\n\n## When a skill says \"publish to the issue tracker\"\n\n`POST /api/issues`.\n\n## When a skill says \"fetch the relevant ticket\"\n\n`GET /api/issues/`.\n\n## Triage labels\n\nLabels are a free-text array on each issue. The five canonical roles\n(`needs-triage`, `needs-info`, `ready-for-agent`, `ready-for-human`,\n`wontfix`) apply directly via the labels endpoint above — no relabeling\nneeded unless this repo wants different strings (edit\n`docs/agents/triage-labels.md` in that case).\n\n## curl examples\n\n```bash\nTRACKER=https://your-handle-your-val.web.val.run\nKEY=... # ISSUE_TRACKER_API_KEY\n\n# Create\ncurl -s -X POST \"$TRACKER/api/issues\" \\\n -H \"Authorization: Bearer $KEY\" -H \"Content-Type: application/json\" \\\n -d '{\"title\":\"Fix flaky test\",\"labels\":[\"needs-triage\"],\"author\":\"agent\"}'\n\n# List open issues needing triage\ncurl -s \"$TRACKER/api/issues?status=open&label=needs-triage\"\n\n# Fetch one, with comments\ncurl -s \"$TRACKER/api/issues/12\"\n\n# Comment, then close\ncurl -s -X POST \"$TRACKER/api/issues/12/close\" \\\n -H \"Authorization: Bearer $KEY\" -H \"Content-Type: application/json\" \\\n -d '{\"comment\":\"Fixed in a1b2c3d.\"}'\n\n# Move through triage: add ready-for-agent, drop needs-triage\ncurl -s -X POST \"$TRACKER/api/issues/12/labels\" \\\n -H \"Authorization: Bearer $KEY\" -H \"Content-Type: application/json\" \\\n -d '{\"add\":[\"ready-for-agent\"],\"remove\":[\"needs-triage\"]}'\n```\n\n## Human permission model (context — doesn't affect the API)\n\nHumans use the web UI under a three-tier model: **viewer** (read-only),\n**contributor** (create issues, manage only what they created), **maintainer**\n(manage anything). The bearer token above always acts as maintainer for API\nwrites, regardless of the `author` value it attributes the change to.\n","# Issue tracker: val-issue-tracker (JSON API)\n\nUse the tracker's JSON API for agent and script operations; do not scrape HTML.\n\n**Tracker URL**: `` (for example `https://username-myval.web.val.run`)\n\n**Auth**: reads are public. Writes require\n`Authorization: Bearer `. Each write may include `actor`,\na Val Town handle; omitted actors default to `agent`. Actor provenance is stored\nonly in the append-only events log.\n\n## Issue shape\n\nIssues use GitHub-flavoured vocabulary:\n\n- `body`, not `description`; bodies are stored as markdown text but rendered as\n text.\n- `status` is exactly `open` or `closed`.\n- `state_reason` is `null` or `reopened` for open issues, and `completed`,\n `not_planned`, or `duplicate` for closed issues.\n- `labels` is an array of curated Label objects (`id`, `name`, `color`,\n timestamps).\n- `assignees` is an array of Val Town handles.\n- `blockers` and `blocks` are issue-reference arrays; `blocked` is derived from\n whether any blocker is open.\n- `creator` is derived from the issue's creation event. There are no actor\n columns on live entity or relationship tables.\n\n## Endpoints\n\n| Method and path | Body / query | Result |\n| --------------------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------- |\n| `GET /api/issues` | `?status=&label=&assignee=&search=` | List enriched issues |\n| `POST /api/issues` | `{title, body?, label_ids?: number[], assignees?: string[], actor?}` | Create an open issue |\n| `GET /api/issues/:id` | — | Issue plus `comments` |\n| `PATCH /api/issues/:id` | `{title?, body?, actor?}` | Edit scalar fields |\n| `DELETE /api/issues/:id` | `{actor?}` | Hard-delete with tombstone event |\n| `POST /api/issues/:id/close` | `{reason?: \"completed\" \\| \"not_planned\" \\| \"duplicate\", comment?, actor?}` | Close; reason defaults to `completed` |\n| `POST /api/issues/:id/reopen` | `{actor?}` | Reopen with `state_reason: \"reopened\"` |\n| `POST /api/issues/:id/labels` | `{add?: number[], remove?: number[], actor?}` | Apply/remove curated label IDs |\n| `POST /api/issues/:id/assignees` | `{add?: string[], remove?: string[], actor?}` | Assign/unassign handles |\n| `POST /api/issues/:id/blocks` | `{add?: number[], remove?: number[], actor?}` | Make this issue block/unblock issue IDs |\n| `POST /api/issues/:id/blocked-by` | `{add?: number[], remove?: number[], actor?}` | Add/remove this issue's blockers |\n| `POST /api/issues/:id/comments` | `{body, actor?}` | Create a comment |\n| `PATCH /api/comments/:id` | `{body, actor?}` | Edit a comment |\n| `DELETE /api/comments/:id` | `{actor?}` | Hard-delete a comment with tombstone event |\n| `GET /api/issues/:id/events` | — | Issue events in append order |\n| `GET /api/labels` | — | List curated labels |\n| `POST /api/labels` | `{name, color, actor?}` | Create a label (`color` is hex, with or without `#`) |\n| `PATCH /api/labels/:id` | `{name?, color?, actor?}` | Rename/recolour a label |\n| `DELETE /api/labels/:id` | `{actor?}` | Delete a label and remove its applications |\n\nBlocking edges must form a strict DAG. Self-edges, reciprocal edges, and longer\ncycles return `409`. Closing a blocked issue is allowed.\n\n## Triage labels\n\nLabels are curated entities, not free-text arrays. Before applying workflow\nlabels such as `needs-triage`, create each one once with `POST /api/labels`,\nretain its ID, then send that ID to the issue-label endpoint. The product's\nfresh-install defaults are `bug`, `enhancement`, `documentation`, `question`,\nand `duplicate`.\n\n## curl examples\n\n```bash\nTRACKER=https://your-handle-your-val.web.val.run\nKEY=...\n\n# Discover label IDs\ncurl -s \"$TRACKER/api/labels\"\n\n# Create with curated labels and multiple assignees\ncurl -s -X POST \"$TRACKER/api/issues\" \\\n -H \"Authorization: Bearer $KEY\" -H \"Content-Type: application/json\" \\\n -d '{\"title\":\"Fix flaky test\",\"body\":\"Observed in CI\",\"label_ids\":[1],\"assignees\":[\"alice\"],\"actor\":\"alice\"}'\n\n# Close as deliberately not planned\ncurl -s -X POST \"$TRACKER/api/issues/12/close\" \\\n -H \"Authorization: Bearer $KEY\" -H \"Content-Type: application/json\" \\\n -d '{\"reason\":\"not_planned\",\"comment\":\"Superseded by #15.\",\"actor\":\"alice\"}'\n\n# Reopen\ncurl -s -X POST \"$TRACKER/api/issues/12/reopen\" \\\n -H \"Authorization: Bearer $KEY\" -H \"Content-Type: application/json\" \\\n -d '{\"actor\":\"alice\"}'\n\n# Declare that #12 blocks #15\ncurl -s -X POST \"$TRACKER/api/issues/12/blocks\" \\\n -H \"Authorization: Bearer $KEY\" -H \"Content-Type: application/json\" \\\n -d '{\"add\":[15],\"actor\":\"alice\"}'\n```\n","createdAt",["D",1783653142598],"branchVersion","branchId","b6817ee5-03f4-41f2-901e-1bb2efa16e9e","id","abe99189-4851-4aab-ae08-280f66283cac","val-issue-tracker",["D",1783563523910],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Per-val issue tracker — import into any val for scoped issues","imageUrl","5d1042a9-7b0b-499d-8a72-3a8ac7a4e185","pinnedFileId","d1d90306-7b3c-11f1-b527-1607ee4eb77e","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","5f80108f-7ca4-4327-b77b-089dbe4b5a82","tursoName","abe9918948514aabae08280f66283cac","tursoHostname","abe9918948514aabae08280f66283cac-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789525245864],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_100":99,"_107":103},"org",{"_100":99,"_101":-5,"_102":103,"_18":55,"_104":105,"_106":25},"branch",{"_13":89,"_32":90,"_43":42,"_91":44,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":45,"_98":99},"isOwned",369,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","nbbaier","handle","displayName","avatar","https://secure.gravatar.com/avatar/0129a541b7b3574e92c4afd06c5e32da&d=identicon","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_43":44,"_32":45,"_38":495,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":63,"_64":65,"_66":67,"_68":69,"_70":496,"_72":-5,"_73":74,"_75":74,"_76":77,"_78":77,"_79":77,"_80":74,"_81":74,"_82":497,"_84":498,"_86":499,"_88":25},"tree",[295,311,312,313,314,315,316,317,318,319,320,321,322,323,324,325,326,327],"files",[295,296,297,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,317,318,319,320,321,322,323,324,325,326,327],"counts",{"_285":63,"_286":188,"_287":63,"_288":289,"_290":291},"contents",[130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_43":278,"_32":279,"_30":280,"_151":-5,"_41":42,"_40":281,"_153":59,"_38":282,"_13":63,"_34":283,"_35":-5,"_24":25,"_158":-5,"_27":284},{"_43":271,"_32":272,"_30":273,"_151":-5,"_41":42,"_40":274,"_153":59,"_38":275,"_13":63,"_34":20,"_35":276,"_24":25,"_158":-5,"_27":277},{"_43":265,"_32":266,"_30":267,"_151":-5,"_41":42,"_40":268,"_153":25,"_38":269,"_13":63,"_34":20,"_35":263,"_24":25,"_158":-5,"_27":270},{"_43":258,"_32":259,"_30":260,"_151":-5,"_41":42,"_40":261,"_153":25,"_38":262,"_13":63,"_34":20,"_35":263,"_24":25,"_158":-5,"_27":264},{"_43":251,"_32":252,"_30":253,"_151":-5,"_41":42,"_40":254,"_153":25,"_38":255,"_13":188,"_34":20,"_35":256,"_24":25,"_158":-5,"_27":257},{"_43":243,"_32":244,"_30":245,"_151":-5,"_41":42,"_40":246,"_153":25,"_38":247,"_13":248,"_34":20,"_35":249,"_24":25,"_158":-5,"_27":250},{"_43":236,"_32":237,"_30":238,"_151":-5,"_41":42,"_40":239,"_153":25,"_38":240,"_13":188,"_34":156,"_35":241,"_24":25,"_158":-5,"_27":242},{"_43":228,"_32":229,"_30":230,"_151":-5,"_41":42,"_40":231,"_153":25,"_38":232,"_13":233,"_34":156,"_35":234,"_24":25,"_158":-5,"_27":235},{"_43":221,"_32":222,"_30":223,"_151":-5,"_41":42,"_40":224,"_153":25,"_38":225,"_13":63,"_34":156,"_35":226,"_24":25,"_158":-5,"_27":227},{"_43":214,"_32":215,"_30":216,"_151":-5,"_41":42,"_40":217,"_153":25,"_38":218,"_13":63,"_34":20,"_35":219,"_24":25,"_158":-5,"_27":220},{"_43":206,"_32":207,"_30":208,"_151":-5,"_41":42,"_40":209,"_153":25,"_38":210,"_13":211,"_34":156,"_35":212,"_24":25,"_158":-5,"_27":213},{"_43":198,"_32":199,"_30":200,"_151":-5,"_41":42,"_40":201,"_153":25,"_38":202,"_13":203,"_34":156,"_35":204,"_24":25,"_158":-5,"_27":205},{"_43":191,"_32":192,"_30":193,"_151":-5,"_41":42,"_40":194,"_153":25,"_38":195,"_13":63,"_34":156,"_35":196,"_24":25,"_158":-5,"_27":197},{"_43":183,"_32":184,"_30":185,"_151":-5,"_41":42,"_40":186,"_153":25,"_38":187,"_13":188,"_34":20,"_35":189,"_24":25,"_158":-5,"_27":190},{"_43":175,"_32":176,"_30":177,"_151":-5,"_41":42,"_40":178,"_153":25,"_38":179,"_13":180,"_34":156,"_35":181,"_24":25,"_158":-5,"_27":182},{"_43":167,"_32":168,"_30":57,"_151":-5,"_41":42,"_40":169,"_153":25,"_38":170,"_13":171,"_34":172,"_35":173,"_24":25,"_158":-5,"_27":174},{"_43":160,"_32":161,"_30":162,"_151":-5,"_41":42,"_40":155,"_153":25,"_38":163,"_13":164,"_34":156,"_35":165,"_24":25,"_158":-5,"_27":166},{"_43":148,"_32":149,"_30":150,"_151":-5,"_41":42,"_40":152,"_153":25,"_38":154,"_13":155,"_34":156,"_35":157,"_24":25,"_158":-5,"_27":159},"2e20d1fd-693a-4de7-9d91-071f7adc7b7a","ui.tsx","fca19e20-7b48-11f1-8cf9-1607ee4eb77e","parentId",122,"latest",["D",1783574778713],30,"script","/** @jsxImportSource npm:hono@4.6.14/jsx */\nimport type { FC, PropsWithChildren } from \"npm:hono@4.6.14/jsx\";\nimport type { IssuePriority, IssueStatus } from \"./db.ts\";\n\n// ---------------------------------------------------------------------------\n// Design tokens\n// ---------------------------------------------------------------------------\n\nexport const FIELD =\n\t\"bg-[#1f232c] border border-[#2a2f3a] rounded-md h-10 pl-3.5 pr-10 text-sm leading-none font-medium text-[#e6e9ef] focus:outline-none focus:border-[#6ea8fe] appearance-none\";\n\n// text-sm/leading-none/appearance-none pin font metrics and native chrome\n// explicitly — \n\t);\n};\n\n// A \n\t\t{/* right-[13px] centers the 16px chevron box within FIELD's 40px right\n\t\t\tpadding: (40 - 16) / 2 = 12px from the inner edge, + 1px because the\n\t\t\toffset is measured from the outer border edge = 13px. This equalizes\n\t\t\tthe text→chevron gap with the chevron→edge gap. */}\n\t\t\n\t\t\t\n\t\t\n\t\n);\n\nexport const Banner: FC<{ kind: \"ok\" | \"err\"; msg: string }> = ({\n\tkind,\n\tmsg,\n}) => (\n\t\n\t\t{msg}\n\t\n);\n\nexport const StatusBadge: FC<{ status: IssueStatus }> = ({ status }) => (\n\t\n\t\t{STATUS_LABELS[status]}\n\t\n);\n\nexport const PriorityBadge: FC<{ priority: IssuePriority }> = ({\n\tpriority,\n}) => (\n\t\n\t\t{PRIORITY_LABELS[priority]}\n\t\n);\n\nexport const LabelTag: FC<{ label: string }> = ({ label }) => (\n\t\n\t\t{label}\n\t\n);\n","label",[149],"cd8a9ea8-1579-4629-9a43-c9a3525477d5","mod.ts","d1e3fc5c-7b3c-11f1-af1c-1607ee4eb77e",["D",1783568883064],11,"export {\n\tcreateIssueTracker,\n\tdefault,\n\ttype IssueTrackerOptions,\n} from \"./app.tsx\";\n",[161],"b64f3437-f4bc-4279-9ad6-786ec6cac581","main.ts",162,["D",1783653141198],10,"http","import { createIssueTracker } from \"./mod.ts\";\n\n/**\n * This val's own issue tracker — manages THIS val's scoped SQLite database.\n *\n * To add issues to a DIFFERENT val, import the tracker into that val:\n *\n * import { createIssueTracker } from \"https://esm.town/v/nbbaier/val-issue-tracker/mod.ts\";\n * export default createIssueTracker({ owner: [\"nbbaier\"] });\n *\n * Because scoped SQLite is bound to the running val, the imported tracker\n * reads/writes the host val's database automatically — no per-val config needed.\n */\nexport default createIssueTracker({});\n",[168],"17e2256d-d27b-4705-aa51-8a95e016e3e4","layout.tsx","fd6015ee-7b48-11f1-bafe-1607ee4eb77e",107,["D",1783574315459],2,"/** @jsxImportSource npm:hono@4.6.14/jsx */\nimport type { FC, PropsWithChildren } from \"npm:hono@4.6.14/jsx\";\n\nexport const Layout: FC<\n\tPropsWithChildren<{\n\t\ttitle: string;\n\t\tuser?: string | null;\n\t\tauth?: boolean;\n\t}>\n> = ({ title, user, auth = true, children }) => (\n\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t{title}\n\t\t\t

Diff · v172