tospudo 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 hayrdenhald
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,78 @@
+# 🍠 Tospudo
+
+A tool to manage TODOs in your project.
+
+## Installation
+
+```bash
+pnpm add -D tospudo
+```
+
+Add it to your `package.json` scripts:
+
+```json
+{
+  "scripts": {
+    "todo": "tospudo"
+  }
+}
+```
+
+## Usage
+
+```bash
+pnpm todo
+```
+
+Tospudo scans all files from the current directory, respecting `.gitignore`.
+
+It reports every `TODO` and `FIXME` comment found in code, plus unchecked items (`- [ ]`) in a `TODO.md` file.
+
+## CLI options
+
+- `--max <number>` — exit with code 1 if the TODO count exceeds this number (useful in CI)
+- `--help`
+- `--version`
+
+## Configuration
+
+Configuration is optional. Use a `tospudo.config.json` file:
+
+```json
+{
+  "$schema": "./node_modules/tospudo/schema.json",
+  "ignore": ["src/generated/**"],
+  "max": 20
+}
+```
+
+The `$schema` field enables autocomplete and inline documentation for all options in VS Code and other editors that support JSON Schema.
+
+Or add a `tospudo` key to `package.json`:
+
+```json
+{
+  "tospudo": {
+    "ignore": ["src/generated/**"],
+    "max": 20
+  }
+}
+```
+
+**Options:**
+
+- `ignore` — glob patterns to exclude from scanning, in addition to `.gitignore` rules
+- `max` — exit with code 1 if TODO count exceeds this threshold; useful in CI. Can also be set with the `--max` CLI flag
+- `maxLength` — truncate TODO text in scan output to this many characters (default: `80`); does not affect `TODO.md` content
+- `sectionEmojis` — show an emoji prefix in `TODO.md` section headings, e.g. `🐛 fix` (default: `true`)
+
+<br>
+
+---
+
+<br>
+<br>
+<br>
+<div align="center">
+  <img src="logo.svg" width="200px">
+</div>

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import * as p from "@clack/prompts";
+import cac from "cac";
+import pc from "picocolors";
+import pkg from "../package.json" with { type: "json" };
+import { loadConfig } from "./config.js";
+import { printResults } from "./output.js";
+import { scanFiles } from "./scanner.js";
+import { ANY_ITEM_REGEX, appendTodo, CHECKED_REGEX, completeLine, deleteLine, hasSections, migrateToSections, parseAllItems, parseAllItemsWithStatus, parseCompletedLines, parseLines, pruneEmptySections, SECTIONS, uncompleteLine, } from "./todo-md.js";
+const TODO_PATH = join(process.cwd(), "TODO.md");
+function readTodoMd() {
+    return readFile(TODO_PATH, "utf8");
+}
+async function runScan(options) {
+    const config = await loadConfig();
+    const max = options?.max !== undefined ? Number(options.max) : config?.max;
+    const todos = await scanFiles(config?.ignore ?? []);
+    printResults(todos, max, config?.maxLength);
+    if (max !== undefined && todos.length > max) {
+        process.exit(1);
+    }
+}
+async function runList() {
+    if (!existsSync(TODO_PATH)) {
+        p.cancel("No TODO.md found in current directory.");
+        process.exit(1);
+    }
+    const content = await readTodoMd();
+    const items = parseAllItemsWithStatus(content);
+    if (items.length === 0) {
+        console.log(pc.green("No TODOs found in TODO.md."));
+    }
+    else {
+        console.log(pc.bold(`\nTODO.md (${items.length} item${items.length === 1 ? "" : "s"}):`));
+        for (const line of content.split("\n")) {
+            const sectionMatch = /^## (.+)$/.exec(line);
+            const itemMatch = ANY_ITEM_REGEX.exec(line);
+            if (sectionMatch) {
+                console.log(pc.bold(`\n  ${sectionMatch[1]}`));
+            }
+            else if (itemMatch) {
+                const checked = CHECKED_REGEX.test(line);
+                const checkbox = checked ? pc.green("[x]") : pc.dim("[ ]");
+                const text = checked ? pc.dim(itemMatch[1].trim()) : itemMatch[1].trim();
+                console.log(`  ${checkbox} ${text}`);
+            }
+        }
+        console.log("");
+    }
+    const config = await loadConfig();
+    const allTodos = await scanFiles(config?.ignore ?? []);
+    const codeTodos = allTodos.filter((t) => t.file !== "TODO.md" && !t.file.endsWith("/TODO.md"));
+    if (codeTodos.length > 0) {
+        const n = codeTodos.length;
+        console.log(pc.dim(`  ... ${items.length === 0 ? "but" : "and"} ${n} TODO${n === 1 ? "" : "s"} spread around the rest of the codebase.`));
+        console.log("");
+    }
+}
+function parseSectionPrefix(text) {
+    const match = /^(\w+):\s*(.+)$/.exec(text);
+    if (!match)
+        return null;
+    const candidate = match[1];
+    if (!SECTIONS.includes(candidate))
+        return null;
+    return { section: candidate, todoText: match[2].trim() };
+}
+async function runAdd(text) {
+    const config = await loadConfig();
+    const emoji = config?.sectionEmojis !== false;
+    let existing = existsSync(TODO_PATH) ? await readTodoMd() : "";
+    if (existing.length > 0 && !hasSections(existing)) {
+        existing = migrateToSections(existing, emoji);
+    }
+    let todoText = text?.trim();
+    if (!todoText) {
+        const input = await p.text({ message: "What needs to be done?" });
+        if (p.isCancel(input))
+            process.exit(0);
+        todoText = input.trim();
+        if (!todoText) {
+            p.cancel("TODO text cannot be empty.");
+            process.exit(1);
+        }
+    }
+    const parsed = parseSectionPrefix(todoText);
+    let section;
+    if (parsed) {
+        section = parsed.section;
+        todoText = parsed.todoText;
+    }
+    else {
+        const selected = await p.select({
+            message: "Which section?",
+            options: SECTIONS.map((s) => ({ value: s, label: s })),
+        });
+        if (p.isCancel(selected))
+            process.exit(0);
+        section = selected;
+    }
+    await writeFile(TODO_PATH, appendTodo(existing, todoText, section, emoji), "utf8");
+    p.outro(`Added: ${todoText}`);
+}
+async function runCheck() {
+    if (!existsSync(TODO_PATH)) {
+        p.cancel("No TODO.md found in current directory.");
+        process.exit(1);
+    }
+    const content = await readTodoMd();
+    const items = parseLines(content);
+    if (items.length === 0) {
+        p.cancel("No unchecked TODOs found.");
+        process.exit(1);
+    }
+    const selected = await p.autocomplete({
+        message: "Select a TODO to check off:",
+        options: items.map((item) => ({ label: item.text, value: item.index })),
+    });
+    if (p.isCancel(selected))
+        process.exit(0);
+    await writeFile(TODO_PATH, completeLine(content, selected), "utf8");
+    p.outro(`Checked: ${items.find((i) => i.index === selected)?.text}`);
+}
+async function runUncheck() {
+    if (!existsSync(TODO_PATH)) {
+        p.cancel("No TODO.md found in current directory.");
+        process.exit(1);
+    }
+    const content = await readTodoMd();
+    const items = parseCompletedLines(content);
+    if (items.length === 0) {
+        p.cancel("No checked TODOs found.");
+        process.exit(1);
+    }
+    const selected = await p.autocomplete({
+        message: "Select a TODO to uncheck:",
+        options: items.map((item) => ({ label: item.text, value: item.index })),
+    });
+    if (p.isCancel(selected))
+        process.exit(0);
+    await writeFile(TODO_PATH, uncompleteLine(content, selected), "utf8");
+    p.outro(`Unchecked: ${items.find((i) => i.index === selected)?.text}`);
+}
+async function runRemove() {
+    if (!existsSync(TODO_PATH)) {
+        p.cancel("No TODO.md found in current directory.");
+        process.exit(1);
+    }
+    const content = await readTodoMd();
+    const items = parseAllItems(content);
+    if (items.length === 0) {
+        p.cancel("No TODOs found.");
+        process.exit(1);
+    }
+    const selected = await p.autocomplete({
+        message: "Select a TODO to remove:",
+        options: items.map((item) => ({ label: item.text, value: item.index })),
+    });
+    if (p.isCancel(selected))
+        process.exit(0);
+    await writeFile(TODO_PATH, pruneEmptySections(deleteLine(content, selected)), "utf8");
+    p.outro(`Removed: ${items.find((i) => i.index === selected)?.text}`);
+}
+const cli = cac("tospudo");
+cli
+    .command("scan", "Scan for TODOs across the codebase")
+    .option("--max <number>", "Maximum number of TODOs before failing")
+    .action(runScan);
+cli.command("list", "List TODOs in TODO.md").action(runList);
+cli.command("add [text]", "Add a new TODO to TODO.md").action(runAdd);
+cli.command("check", "Check off a TODO").action(runCheck);
+cli.command("uncheck", "Uncheck a completed TODO").action(runUncheck);
+cli.command("remove", "Remove a TODO").action(runRemove);
+cli.command("", "Interactive menu").action(async () => {
+    const action = await p.select({
+        message: "What would you like to do?",
+        options: [
+            { value: "scan", label: "Scan codebase for TODOs" },
+            { value: "list", label: "List TODOs in TODO.md" },
+            { value: "add", label: "Add a TODO to TODO.md" },
+            { value: "check", label: "Check off a TODO" },
+            { value: "uncheck", label: "Uncheck a TODO" },
+            { value: "remove", label: "Remove a TODO" },
+        ],
+    });
+    if (p.isCancel(action))
+        process.exit(0);
+    if (action === "scan")
+        await runScan();
+    if (action === "list")
+        await runList();
+    if (action === "add")
+        await runAdd();
+    if (action === "check")
+        await runCheck();
+    if (action === "uncheck")
+        await runUncheck();
+    if (action === "remove")
+        await runRemove();
+});
+cli.help();
+cli.version(pkg.version);
+cli.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,cAAc,EACd,UAAU,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,QAAQ,EAER,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;AAEjD,SAAS,UAAU;IACjB,OAAO,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,OAA0B;IAC/C,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC;IAC3E,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;IACpD,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC5C,IAAI,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,OAAO;IACpB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,CAAC,CAAC,MAAM,CAAC,wCAAwC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAC1F,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACjD,CAAC;iBAAM,IAAI,SAAS,EAAE,CAAC;gBACrB,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACzE,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAC/F,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC;QAC3B,OAAO,CAAC,GAAG,CACT,EAAE,CAAC,GAAG,CACJ,SAAS,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,0CAA0C,CACrH,CACF,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,CAAE,QAA8B,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,OAAO,EAAE,OAAO,EAAE,SAAoB,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AACtE,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAa;IACjC,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,EAAE,aAAa,KAAK,KAAK,CAAC;IAC9C,IAAI,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClD,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,QAAQ,GAAI,KAAgB,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,CAAC,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,OAAgB,CAAC;IACrB,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACzB,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;YAC9B,OAAO,EAAE,gBAAgB;YACzB,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;SACvD,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,GAAG,QAAmB,CAAC;IAChC,CAAC;IACD,MAAM,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;IACnF,CAAC,CAAC,KAAK,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,CAAC,CAAC,MAAM,CAAC,wCAAwC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,CAAC,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,YAAY,CAAC;QACpC,OAAO,EAAE,6BAA6B;QACtC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;KACxE,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,SAAS,CAAC,SAAS,EAAE,YAAY,CAAC,OAAO,EAAE,QAAkB,CAAC,EAAE,MAAM,CAAC,CAAC;IAC9E,CAAC,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,KAAK,UAAU,UAAU;IACvB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,CAAC,CAAC,MAAM,CAAC,wCAAwC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,CAAC,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,YAAY,CAAC;QACpC,OAAO,EAAE,2BAA2B;QACpC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;KACxE,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,SAAS,CAAC,SAAS,EAAE,cAAc,CAAC,OAAO,EAAE,QAAkB,CAAC,EAAE,MAAM,CAAC,CAAC;IAChF,CAAC,CAAC,KAAK,CAAC,cAAc,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,CAAC,CAAC,MAAM,CAAC,wCAAwC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,YAAY,CAAC;QACpC,OAAO,EAAE,0BAA0B;QACnC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;KACxE,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,SAAS,CAAC,SAAS,EAAE,kBAAkB,CAAC,UAAU,CAAC,OAAO,EAAE,QAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAChG,CAAC,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;AAE3B,GAAG;KACA,OAAO,CAAC,MAAM,EAAE,oCAAoC,CAAC;KACrD,MAAM,CAAC,gBAAgB,EAAE,wCAAwC,CAAC;KAClE,MAAM,CAAC,OAAO,CAAC,CAAC;AAEnB,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAE7D,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,2BAA2B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAEtE,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAE1D,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAEtE,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAEzD,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;IACpD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC;QAC5B,OAAO,EAAE,4BAA4B;QACrC,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB,EAAE;YACnD,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,uBAAuB,EAAE;YACjD,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,EAAE;YAChD,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE;YAC7C,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,EAAE;YAC7C,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE;SAC5C;KACF,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,MAAM,KAAK,MAAM;QAAE,MAAM,OAAO,EAAE,CAAC;IACvC,IAAI,MAAM,KAAK,MAAM;QAAE,MAAM,OAAO,EAAE,CAAC;IACvC,IAAI,MAAM,KAAK,KAAK;QAAE,MAAM,MAAM,EAAE,CAAC;IACrC,IAAI,MAAM,KAAK,OAAO;QAAE,MAAM,QAAQ,EAAE,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,UAAU,EAAE,CAAC;IAC7C,IAAI,MAAM,KAAK,QAAQ;QAAE,MAAM,SAAS,EAAE,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,GAAG,CAAC,IAAI,EAAE,CAAC;AACX,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACzB,GAAG,CAAC,KAAK,EAAE,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const ConfigSchema: z.ZodObject<{
+    ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    max: z.ZodOptional<z.ZodNumber>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    sectionEmojis: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type TospudoConfig = z.infer<typeof ConfigSchema>;
+export declare function loadConfig(): Promise<TospudoConfig | null>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY;;;;;iBAKvB,CAAC;AAEH,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAWlD,wBAAsB,UAAU,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQhE"}

package/dist/config.js

@@ -0,0 +1,27 @@
+import { cosmiconfig } from "cosmiconfig";
+import { z } from "zod";
+export const ConfigSchema = z.object({
+    ignore: z.array(z.string()).optional(),
+    max: z.number().int().positive().optional(),
+    maxLength: z.number().int().positive().optional(),
+    sectionEmojis: z.boolean().optional(),
+});
+const explorer = cosmiconfig("tospudo", {
+    searchPlaces: [
+        "package.json",
+        "tospudo.config.json",
+        "tospudo.config.yaml",
+        "tospudo.config.yml",
+    ],
+});
+export async function loadConfig() {
+    const result = await explorer.search();
+    if (!result || result.isEmpty)
+        return null;
+    const parsed = ConfigSchema.safeParse(result.config);
+    if (!parsed.success) {
+        throw new Error(`Invalid tospudo config: ${parsed.error.message}`);
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACjD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAIH,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,EAAE;IACtC,YAAY,EAAE;QACZ,cAAc;QACd,qBAAqB;QACrB,qBAAqB;QACrB,oBAAoB;KACrB;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;IACvC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,3 @@
+import type { TodoItem } from "./parser.js";
+export declare function printResults(todos: TodoItem[], max?: number, maxLength?: number): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAe5C,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAgCtF"}

package/dist/output.js

@@ -0,0 +1,40 @@
+import pc from "picocolors";
+const DEFAULT_MAX_LENGTH = 80;
+function formatLocation(item) {
+    if (item.line !== undefined) {
+        return `${item.file}:${item.line}`;
+    }
+    return item.file;
+}
+function truncate(text, limit) {
+    return text.length > limit ? `${text.slice(0, limit)} …` : text;
+}
+export function printResults(todos, max, maxLength) {
+    const limit = maxLength ?? DEFAULT_MAX_LENGTH;
+    const count = todos.length;
+    if (count === 0) {
+        console.log(pc.green("No TODOs found."));
+    }
+    else {
+        console.log(pc.bold(`Found ${count} TODO${count === 1 ? "" : "s"}:\n`));
+        const maxTextLength = Math.max(...todos.map((t) => truncate(t.text, limit).length + (t.hasMore ? 2 : 0)));
+        for (const item of todos) {
+            const location = formatLocation(item);
+            const display = truncate(item.text, limit);
+            const more = item.hasMore ? pc.dim(" …") : "";
+            const textWidth = display.length + (item.hasMore ? 2 : 0);
+            const padding = " ".repeat(Math.max(0, maxTextLength - textWidth + 4));
+            console.log(`  ${display}${more}${padding}${pc.cyan(location)}`);
+        }
+        console.log("");
+    }
+    if (max !== undefined) {
+        if (count > max) {
+            console.log(pc.red(`Threshold: ${max} — EXCEEDED (${count}/${max}) ✗`));
+        }
+        else {
+            console.log(pc.green(`Threshold: ${max} — OK ✓`));
+        }
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,SAAS,cAAc,CAAC,IAAc;IACpC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAa;IAC3C,OAAO,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAiB,EAAE,GAAY,EAAE,SAAkB;IAC9E,MAAM,KAAK,GAAG,SAAS,IAAI,kBAAkB,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IAE3B,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QAExE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC5B,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC1E,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,GAAG,IAAI,GAAG,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,GAAG,gBAAgB,KAAK,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,9 @@
+export interface TodoItem {
+    file: string;
+    line?: number;
+    text: string;
+    hasMore?: boolean;
+}
+export declare function parseFileForTodos(content: string, file: string): TodoItem[];
+export declare function parseTodoMd(content: string, file: string): TodoItem[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA+DD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CA+B3E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAerE"}

package/dist/parser.js

@@ -0,0 +1,93 @@
+const TODO_REGEX = /(?:(?:TODO|FIXME):|^\s*\*?\s*(?:TODO|FIXME)\b)/im;
+const CHECKBOX_REGEX = /^- \[ \] (.+)$/;
+function extractCommentContent(line, inBlockComment, inHtmlComment) {
+    let result = "";
+    let pos = 0;
+    while (pos < line.length) {
+        if (inHtmlComment) {
+            const close = line.indexOf("-->", pos);
+            if (close === -1) {
+                result += line.slice(pos);
+                break;
+            }
+            result += line.slice(pos, close);
+            inHtmlComment = false;
+            pos = close + 3;
+        }
+        else if (inBlockComment) {
+            const close = line.indexOf("*/", pos);
+            if (close === -1) {
+                result += line.slice(pos);
+                break;
+            }
+            result += line.slice(pos, close);
+            inBlockComment = false;
+            pos = close + 2;
+        }
+        else {
+            const slashSlash = line.indexOf("//", pos);
+            const slashStar = line.indexOf("/*", pos);
+            const htmlOpen = line.indexOf("<!--", pos);
+            const candidates = [
+                { idx: slashSlash, type: "line" },
+                { idx: slashStar, type: "block" },
+                { idx: htmlOpen, type: "html" },
+            ]
+                .filter((c) => c.idx !== -1)
+                .sort((a, b) => a.idx - b.idx);
+            const next = candidates[0];
+            if (!next)
+                break;
+            if (next.type === "line") {
+                result += line.slice(next.idx + 2);
+                break;
+            }
+            if (next.type === "block") {
+                inBlockComment = true;
+                pos = next.idx + 2;
+            }
+            if (next.type === "html") {
+                inHtmlComment = true;
+                pos = next.idx + 4;
+            }
+        }
+    }
+    return { commentContent: result, inBlockComment, inHtmlComment };
+}
+export function parseFileForTodos(content, file) {
+    const lines = content.split("\n");
+    const results = [];
+    let inBlockComment = false;
+    let inHtmlComment = false;
+    for (let i = 0; i < lines.length; i++) {
+        const { commentContent, inBlockComment: nextBlock, inHtmlComment: nextHtml, } = extractCommentContent(lines[i], inBlockComment, inHtmlComment);
+        inBlockComment = nextBlock;
+        inHtmlComment = nextHtml;
+        if (!TODO_REGEX.test(commentContent))
+            continue;
+        // NOTE: Find where the keyword starts to reconstruct "TODO: ..." from the keyword onwards
+        const keywordMatch = /(?:TODO|FIXME)/i.exec(lines[i]);
+        const raw = keywordMatch ? lines[i].slice(keywordMatch.index).trim() : lines[i].trim();
+        const text = raw.replace(/\s*(?:\*\/|-->)\s*$/, "").trim();
+        const nextLine = lines[i + 1];
+        const hasMore = nextLine !== undefined &&
+            extractCommentContent(nextLine, inBlockComment, inHtmlComment).commentContent.trim() !== "";
+        results.push({ file, line: i + 1, text, hasMore });
+    }
+    return results;
+}
+export function parseTodoMd(content, file) {
+    const lines = content.split("\n");
+    const results = [];
+    for (const line of lines) {
+        const match = CHECKBOX_REGEX.exec(line.trim());
+        if (match) {
+            results.push({
+                file,
+                text: match[1].trim(),
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"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"}

package/dist/scanner.d.ts

@@ -0,0 +1,3 @@
+import type { TodoItem } from "./parser.js";
+export declare function scanFiles(userIgnore?: string[]): Promise<TodoItem[]>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAa5C,wBAAsB,SAAS,CAAC,UAAU,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA6B9E"}

package/dist/scanner.js

@@ -0,0 +1,40 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import fg from "fast-glob";
+import ignore from "ignore";
+import { parseFileForTodos, parseTodoMd } from "./parser.js";
+async function loadGitignore(cwd) {
+    const ig = ignore();
+    const gitignorePath = join(cwd, ".gitignore");
+    if (existsSync(gitignorePath)) {
+        const content = await readFile(gitignorePath, "utf8");
+        ig.add(content);
+    }
+    return ig;
+}
+export async function scanFiles(userIgnore = []) {
+    const cwd = process.cwd();
+    const ig = await loadGitignore(cwd);
+    const globIgnore = ["node_modules/**", "**/node_modules/**", ".git/**", ...userIgnore];
+    const files = await fg("**/*", {
+        cwd,
+        dot: true,
+        ignore: globIgnore,
+        onlyFiles: true,
+    });
+    const filteredFiles = files.filter((f) => !ig.ignores(f));
+    const allTodos = [];
+    for (const file of filteredFiles) {
+        const absolutePath = join(cwd, file);
+        const content = await readFile(absolutePath, "utf8");
+        if (file === "TODO.md" || file.endsWith("/TODO.md")) {
+            allTodos.push(...parseTodoMd(content, file));
+        }
+        else {
+            allTodos.push(...parseFileForTodos(content, file));
+        }
+    }
+    return allTodos;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,WAAW,CAAC;AAC3B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,KAAK,UAAU,aAAa,CAAC,GAAW;IACtC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACtD,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,aAAuB,EAAE;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;IAEpC,MAAM,UAAU,GAAG,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,CAAC;IAEvF,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE;QAC7B,GAAG;QACH,GAAG,EAAE,IAAI;QACT,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAE1D,MAAM,QAAQ,GAAe,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAErD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACpD,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/todo-md.d.ts

@@ -0,0 +1,29 @@
+export declare const CHECKED_REGEX: RegExp;
+export declare const ANY_ITEM_REGEX: RegExp;
+export declare const SECTIONS: readonly ["fix", "feature", "refactor", "test", "chore", "ci", "style", "build", "perf"];
+export type Section = (typeof SECTIONS)[number];
+export declare function hasSections(content: string): boolean;
+export declare function migrateToSections(content: string, emoji?: boolean): string;
+export declare function parseLines(content: string): {
+    index: number;
+    text: string;
+}[];
+export declare function parseCompletedLines(content: string): {
+    index: number;
+    text: string;
+}[];
+export declare function parseAllItems(content: string): {
+    index: number;
+    text: string;
+}[];
+export declare function parseAllItemsWithStatus(content: string): {
+    index: number;
+    text: string;
+    checked: boolean;
+}[];
+export declare function uncompleteLine(content: string, index: number): string;
+export declare function completeLine(content: string, index: number): string;
+export declare function deleteLine(content: string, index: number): string;
+export declare function pruneEmptySections(content: string): string;
+export declare function appendTodo(content: string, text: string, section?: Section, emoji?: boolean): string;
+//# sourceMappingURL=todo-md.d.ts.map

package/dist/todo-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-md.d.ts","sourceRoot":"","sources":["../src/todo-md.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa,QAAoB,CAAC;AAC/C,eAAO,MAAM,cAAc,QAAoB,CAAC;AAEhD,eAAO,MAAM,QAAQ,0FAUX,CAAC;AAEX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAuBhD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,UAAO,GAAG,MAAM,CAKvE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAK7E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAKtF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAKhF;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,EAAE,CAMrD;AAQD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKrE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKnE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA2B1D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,UAAO,GAAG,MAAM,CAmCjG"}

package/dist/todo-md.js

@@ -0,0 +1,147 @@
+const UNCHECKED_REGEX = /^- \[ \] (.+)$/;
+export const CHECKED_REGEX = /^- \[x\] (.+)$/i;
+export const ANY_ITEM_REGEX = /^- \[.?\] (.+)$/;
+export const SECTIONS = [
+    "fix",
+    "feature",
+    "refactor",
+    "test",
+    "chore",
+    "ci",
+    "style",
+    "build",
+    "perf",
+];
+const SECTION_EMOJIS = {
+    fix: "🐛",
+    feature: "✨",
+    refactor: "♻️",
+    test: "🧪",
+    chore: "🧹",
+    ci: "🚀",
+    style: "💅",
+    build: "📦",
+    perf: "⚡",
+};
+function sectionHeading(section, emoji) {
+    return emoji ? `## ${SECTION_EMOJIS[section]} ${section}` : `## ${section}`;
+}
+/** Matches a section heading line for a given section name, with or without emoji. */
+function matchesSectionHeading(line, section) {
+    return line === `## ${section}` || (line.startsWith(`## `) && line.endsWith(` ${section}`));
+}
+export function hasSections(content) {
+    return content.split("\n").some((line) => /^## \S/.test(line));
+}
+export function migrateToSections(content, emoji = true) {
+    const lines = content.split("\n");
+    const checkboxLines = lines.filter((line) => ANY_ITEM_REGEX.test(line));
+    if (checkboxLines.length === 0)
+        return content;
+    return `${sectionHeading("fix", emoji)}\n\n${checkboxLines.join("\n")}\n`;
+}
+export function parseLines(content) {
+    return content.split("\n").flatMap((line, index) => {
+        const match = UNCHECKED_REGEX.exec(line);
+        return match ? [{ index, text: match[1].trim() }] : [];
+    });
+}
+export function parseCompletedLines(content) {
+    return content.split("\n").flatMap((line, index) => {
+        const match = CHECKED_REGEX.exec(line);
+        return match ? [{ index, text: match[1].trim() }] : [];
+    });
+}
+export function parseAllItems(content) {
+    return content.split("\n").flatMap((line, index) => {
+        const match = ANY_ITEM_REGEX.exec(line);
+        return match ? [{ index, text: match[1].trim() }] : [];
+    });
+}
+export function parseAllItemsWithStatus(content) {
+    return content.split("\n").flatMap((line, index) => {
+        const match = ANY_ITEM_REGEX.exec(line);
+        if (!match)
+            return [];
+        return [{ index, text: match[1].trim(), checked: CHECKED_REGEX.test(line) }];
+    });
+}
+function assertValidIndex(index, length) {
+    if (index < 0 || index >= length) {
+        throw new RangeError(`Line index ${index} is out of bounds (file has ${length} lines)`);
+    }
+}
+export function uncompleteLine(content, index) {
+    const lines = content.split("\n");
+    assertValidIndex(index, lines.length);
+    lines[index] = lines[index].replace(/^- \[x\] /i, "- [ ] ");
+    return lines.join("\n");
+}
+export function completeLine(content, index) {
+    const lines = content.split("\n");
+    assertValidIndex(index, lines.length);
+    lines[index] = lines[index].replace("- [ ]", "- [x]");
+    return lines.join("\n");
+}
+export function deleteLine(content, index) {
+    const lines = content.split("\n");
+    assertValidIndex(index, lines.length);
+    lines.splice(index, 1);
+    return lines.join("\n");
+}
+export function pruneEmptySections(content) {
+    const lines = content.split("\n");
+    const keep = new Array(lines.length).fill(true);
+    for (let i = 0; i < lines.length; i++) {
+        if (!/^## \S/.test(lines[i]))
+            continue;
+        // Find the end of this section (next ## heading or EOF)
+        let nextSection = lines.length;
+        for (let j = i + 1; j < lines.length; j++) {
+            if (/^## \S/.test(lines[j])) {
+                nextSection = j;
+                break;
+            }
+        }
+        // Check if section has any checkbox items
+        const hasItems = lines.slice(i + 1, nextSection).some((l) => ANY_ITEM_REGEX.test(l));
+        if (!hasItems) {
+            // Remove the header and any blank lines immediately after it up to the next section
+            for (let j = i; j < nextSection; j++) {
+                keep[j] = false;
+            }
+        }
+    }
+    const result = lines.filter((_, i) => keep[i]).join("\n");
+    // Collapse 3+ consecutive blank lines into 2
+    return result.replace(/\n{3,}/g, "\n\n");
+}
+export function appendTodo(content, text, section, emoji = true) {
+    if (!section) {
+        const trimmed = content.trimEnd();
+        const base = trimmed.length > 0 ? `${trimmed}\n` : "";
+        return `${base}- [ ] ${text}\n`;
+    }
+    const lines = content.split("\n");
+    const sectionStartIndex = lines.findIndex((line) => matchesSectionHeading(line, section));
+    if (sectionStartIndex === -1) {
+        const trimmed = content.trimEnd();
+        const base = trimmed.length > 0 ? `${trimmed}\n` : "";
+        return `${base}\n${sectionHeading(section, emoji)}\n\n- [ ] ${text}\n`;
+    }
+    const nextSectionIndex = lines.findIndex((line, i) => i > sectionStartIndex && /^## \S/.test(line));
+    const blockEnd = nextSectionIndex === -1 ? lines.length : nextSectionIndex;
+    let lastItemIndex = -1;
+    for (let i = sectionStartIndex + 1; i < blockEnd; i++) {
+        if (/^- \[/.test(lines[i]))
+            lastItemIndex = i;
+    }
+    const insertAfter = lastItemIndex !== -1
+        ? lastItemIndex
+        : lines[sectionStartIndex + 1] === ""
+            ? sectionStartIndex + 1
+            : sectionStartIndex;
+    lines.splice(insertAfter + 1, 0, `- [ ] ${text}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=todo-md.js.map

package/dist/todo-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-md.js","sourceRoot":"","sources":["../src/todo-md.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "tospudo",
+  "version": "1.0.0",
+  "description": "A tool to manage TODOs in your project.",
+  "type": "module",
+  "bin": {
+    "tospudo": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "schema.json"
+  ],
+  "keywords": [
+    "todo"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hayrdenhald/tospudo.git"
+  },
+  "author": "hayrdenhald",
+  "license": "ISC",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "1.2.0",
+    "cac": "7.0.0",
+    "cosmiconfig": "9.0.1",
+    "fast-glob": "3.3.3",
+    "ignore": "7.0.5",
+    "picocolors": "1.1.1",
+    "zod": "4.3.6"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.10",
+    "@types/node": "25.5.0",
+    "knip": "6.2.0",
+    "typescript": "6.0.2",
+    "vitest": "4.1.2"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "pnpm run clean && tsc --project tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "knip": "knip",
+    "test": "vitest run",
+    "test:unit": "vitest run tests/unit",
+    "test:meta": "vitest run tests/meta"
+  }
+}

package/schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "TospudoConfig",
+  "description": "Configuration for tospudo.",
+  "type": "object",
+  "additionalProperties": true,
+  "allowedProperties": ["$schema"],
+  "properties": {
+    "ignore": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Glob patterns to exclude from scanning, in addition to .gitignore rules."
+    },
+    "max": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Exit with code 1 if TODO count exceeds this threshold. Useful in CI. Can also be set with the --max CLI flag."
+    },
+    "maxLength": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Truncate TODO text in scan output to this many characters. Defaults to 80. Does not affect TODO.md content."
+    },
+    "sectionEmojis": {
+      "type": "boolean",
+      "description": "Show an emoji prefix in TODO.md section headings (e.g. \"🐛 fix\"). Defaults to true."
+    }
+  }
+}