@bosun-sh/logbook 1.0.0 → 2.0.0

package/dist/workspace/v1-cli-aliases.js

@@ -0,0 +1,223 @@
+import { TaskSchema } from "../task/schema.js";
+import { toV1Task } from "../task/v1-compat.js";
+const estimateComplexity = (fibonacci) => {
+    if (fibonacci <= 2)
+        return "trivial";
+    if (fibonacci <= 5)
+        return "small";
+    if (fibonacci <= 8)
+        return "medium";
+    if (fibonacci <= 13)
+        return "large";
+    return "complex";
+};
+const aliasDefinitions = [
+    ["create-task", "task.create"],
+    ["list-tasks", "task.list"],
+    ["current-task", "task.current"],
+    ["update-task", "task.update"],
+    ["edit-task", "task.edit"],
+    ["init", "workspace.init"],
+];
+export const v1CliAliases = Object.freeze(aliasDefinitions.map(([alias, toolId]) => ({
+    alias,
+    toolId,
+    compatibility: "v1",
+})));
+export const translateV1CliCommand = (alias, input) => {
+    const command = v1CliAliases.find((candidate) => candidate.alias === alias);
+    if (command === undefined) {
+        return null;
+    }
+    const translated = translateInput(command.toolId, input);
+    const warnings = translated.fields.length === 0
+        ? []
+        : [
+            {
+                code: "compatibility_mapping_applied",
+                message: "V1 CLI arguments were translated to v2 tool input.",
+                details: {
+                    alias,
+                    toolId: command.toolId,
+                    fields: translated.fields,
+                },
+            },
+        ];
+    const translation = {
+        toolId: command.toolId,
+        input: translated.input,
+        warnings,
+    };
+    Object.defineProperty(translation, "withCompatibilityOutput", {
+        enumerable: false,
+        value: (envelope) => withV1CompatibilityOutput(alias, envelope, warnings),
+    });
+    return translation;
+};
+const translateInput = (toolId, input) => {
+    if (toolId === "task.create" || toolId === "task.edit") {
+        return translateTaskWriteInput(toolId, input);
+    }
+    if (toolId === "task.update") {
+        return translateTaskUpdateInput(input);
+    }
+    if (toolId === "task.list" || toolId === "task.current") {
+        return translateTaskFilterInput(input);
+    }
+    return { input, fields: [] };
+};
+const translateTaskWriteInput = (_toolId, input) => {
+    const fields = [];
+    const output = { ...input };
+    mapListField(output, fields, ["definition_of_done", "definition-of-done", "definitionOfDone"], "definitionOfDone");
+    mapListField(output, fields, ["test_cases", "test-cases", "testCases"], "definitionOfReady", {
+        enumerable: false,
+    });
+    mapScalarField(output, fields, ["assigned_session", "assigned-session", "assignedSession"], "sessionId");
+    mapModelField(output, fields);
+    mapEstimateField(output, fields);
+    return { input: output, fields };
+};
+const translateTaskUpdateInput = (input) => {
+    const fields = [];
+    const output = { ...input };
+    mapScalarField(output, fields, ["new_status", "new-status", "newStatus"], "newStatus");
+    const title = readFirst(output, ["comment_title", "comment-title", "commentTitle"], fields);
+    const content = readFirst(output, ["comment_content", "comment-content", "commentContent"], fields);
+    const kind = readFirst(output, ["comment_kind", "comment-kind", "commentKind"], fields);
+    const replyToCommentId = readFirst(output, ["comment_reply_to", "comment-reply-to", "commentReplyTo"], fields);
+    if (title !== undefined || content !== undefined || replyToCommentId !== undefined) {
+        output.comment = {
+            ...(title === undefined ? {} : { title: String(title) }),
+            content: content === undefined ? "" : String(content),
+            ...(kind === undefined ? {} : { kind: String(kind) }),
+            ...(replyToCommentId === undefined ? {} : { replyToCommentId: String(replyToCommentId) }),
+        };
+    }
+    return { input: output, fields };
+};
+const translateTaskFilterInput = (input) => {
+    const fields = [];
+    const output = { ...input };
+    mapScalarField(output, fields, ["assigned_session", "assigned-session", "assignedSession"], "sessionId");
+    return { input: output, fields };
+};
+const mapListField = (output, fields, candidates, target, options = {}) => {
+    const value = readFirst(output, candidates, fields);
+    if (value !== undefined) {
+        setOutputField(output, target, normalizeList(value).join("\n"), options);
+    }
+};
+const mapScalarField = (output, fields, candidates, target) => {
+    const value = readFirst(output, candidates, fields);
+    if (value !== undefined) {
+        setOutputField(output, target, value);
+    }
+};
+const setOutputField = (output, target, value, options = {}) => {
+    Object.defineProperty(output, target, {
+        configurable: true,
+        enumerable: options.enumerable ?? true,
+        value,
+        writable: true,
+    });
+};
+const mapModelField = (output, fields) => {
+    const value = readFirst(output, ["assigned_model", "assigned-model", "assignedModel"], fields);
+    if (value !== undefined) {
+        output.model = { id: String(value) };
+    }
+};
+const mapEstimateField = (output, fields) => {
+    const estimation = readFirst(output, ["estimation"], fields);
+    const predictedKTokens = readFirst(output, ["predictedKTokens", "predicted-k-tokens"], fields);
+    if (estimation === undefined && predictedKTokens === undefined) {
+        return;
+    }
+    const fibonacci = Number(estimation ?? 1);
+    output.estimate = {
+        predictedKTokens: Number(predictedKTokens ?? 0),
+        fibonacci,
+        complexity: estimateComplexity(fibonacci),
+        confidence: "medium",
+    };
+};
+const readFirst = (output, candidates, fields) => {
+    for (const candidate of candidates) {
+        if (Object.hasOwn(output, candidate)) {
+            const value = output[candidate];
+            delete output[candidate];
+            fields.push(candidate);
+            return value;
+        }
+    }
+    return undefined;
+};
+const normalizeList = (value) => {
+    if (Array.isArray(value)) {
+        return value.map((entry) => String(entry).trim()).filter((entry) => entry.length > 0);
+    }
+    if (typeof value === "string") {
+        try {
+            const parsed = JSON.parse(value);
+            if (Array.isArray(parsed)) {
+                return parsed.map((entry) => String(entry).trim()).filter((entry) => entry.length > 0);
+            }
+        }
+        catch { }
+        const trimmed = value.trim();
+        return trimmed.length === 0 ? [] : [trimmed];
+    }
+    if (value === undefined || value === null) {
+        return [];
+    }
+    return [String(value)];
+};
+const withV1CompatibilityOutput = (alias, envelope, warnings) => {
+    if (!envelope.ok || v1CliAliases.every((candidate) => candidate.alias !== alias)) {
+        return envelope;
+    }
+    const data = addCompatibilityData(envelope.data);
+    const nextWarnings = [...(envelope.warnings ?? []), ...warnings];
+    return {
+        ok: true,
+        data,
+        ...(nextWarnings.length === 0 ? {} : { warnings: nextWarnings }),
+    };
+};
+const addCompatibilityData = (data) => {
+    if (!isRecord(data)) {
+        return data;
+    }
+    const compat = buildCompatibility(data);
+    if (compat === undefined) {
+        return data;
+    }
+    return {
+        ...data,
+        compat: {
+            ...(isRecord(data.compat) ? data.compat : {}),
+            v1: compat,
+        },
+    };
+};
+const buildCompatibility = (data) => {
+    const compat = {};
+    const task = toTask(data.task);
+    if (task !== undefined) {
+        compat.task = toV1Task(task);
+    }
+    if (Array.isArray(data.items)) {
+        const tasks = data.items.map(toTask).filter((item) => item !== undefined);
+        if (tasks.length > 0) {
+            compat.items = tasks.map(toV1Task);
+        }
+    }
+    return Object.keys(compat).length === 0 ? undefined : compat;
+};
+const toTask = (value) => {
+    const parsed = TaskSchema.safeParse(value);
+    return parsed.success ? parsed.data : undefined;
+};
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+//# sourceMappingURL=v1-cli-aliases.js.map

package/dist/workspace/v1-cli-aliases.js.map

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

package/dist/workspace/v1-cli-task.d.ts

@@ -0,0 +1,2 @@
+export declare const translateV1TaskArgs: (command: string, args: Record<string, string>) => Record<string, unknown>;
+//# sourceMappingURL=v1-cli-task.d.ts.map

package/dist/workspace/v1-cli-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1-cli-task.d.ts","sourceRoot":"","sources":["../../src/workspace/v1-cli-task.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,mBAAmB,GAC9B,SAAS,MAAM,EACf,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CA0CxB,CAAA"}

package/dist/workspace/v1-cli-task.js

@@ -0,0 +1,53 @@
+const normalizeListArg = (value) => {
+    try {
+        const parsed = JSON.parse(value);
+        if (Array.isArray(parsed)) {
+            return parsed.map((entry) => String(entry).trim()).filter((entry) => entry.length > 0);
+        }
+    }
+    catch { }
+    const trimmed = value.trim();
+    return trimmed.length === 0 ? [] : [trimmed];
+};
+export const translateV1TaskArgs = (command, args) => {
+    if (command === "create-task") {
+        const result = {};
+        if (args["definition-of-done"] !== undefined) {
+            result.definition_of_done = normalizeListArg(args["definition-of-done"]);
+        }
+        if (args["test-cases"] !== undefined) {
+            result.test_cases = normalizeListArg(args["test-cases"]);
+        }
+        if (args["predicted-k-tokens"] !== undefined) {
+            result.predictedKTokens = Number.parseInt(args["predicted-k-tokens"], 10);
+        }
+        if (args["assigned-session"] !== undefined) {
+            result.assigned_session = args["assigned-session"];
+        }
+        if (args["assigned-model"] !== undefined) {
+            result.assigned_model = args["assigned-model"];
+        }
+        if (args.estimation !== undefined) {
+            result.estimation = Number.parseInt(args.estimation, 10);
+        }
+        return result;
+    }
+    if (command === "update-task") {
+        const result = {};
+        if (args["new-status"] !== undefined) {
+            result.new_status = args["new-status"];
+        }
+        if (args["comment-title"] !== undefined) {
+            result.comment_title = args["comment-title"];
+        }
+        if (args["comment-content"] !== undefined) {
+            result.comment_content = args["comment-content"];
+        }
+        if (args["comment-reply-to"] !== undefined) {
+            result.comment_reply_to = args["comment-reply-to"];
+        }
+        return result;
+    }
+    return {};
+};
+//# sourceMappingURL=v1-cli-task.js.map

package/dist/workspace/v1-cli-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1-cli-task.js","sourceRoot":"","sources":["../../src/workspace/v1-cli-task.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAY,EAAE;IACnD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAA;QAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACxF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;IAC5B,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;AAC9C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,OAAe,EACf,IAA4B,EACH,EAAE;IAC3B,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QAC9B,MAAM,MAAM,GAA4B,EAAE,CAAA;QAC1C,IAAI,IAAI,CAAC,oBAAoB,CAAC,KAAK,SAAS,EAAE,CAAC;YAC7C,MAAM,CAAC,kBAAkB,GAAG,gBAAgB,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAA;QAC1E,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,CAAC,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAA;QAC1D,CAAC;QACD,IAAI,IAAI,CAAC,oBAAoB,CAAC,KAAK,SAAS,EAAE,CAAC;YAC7C,MAAM,CAAC,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAA;QAC3E,CAAC;QACD,IAAI,IAAI,CAAC,kBAAkB,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAA;QACpD,CAAC;QACD,IAAI,IAAI,CAAC,gBAAgB,CAAC,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAA;QAChD,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;QAC1D,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QAC9B,MAAM,MAAM,GAA4B,EAAE,CAAA;QAC1C,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,CAAA;QACxC,CAAC;QACD,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,CAAA;QAC9C,CAAC;QACD,IAAI,IAAI,CAAC,iBAAiB,CAAC,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAClD,CAAC;QACD,IAAI,IAAI,CAAC,kBAAkB,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAA;QACpD,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED,OAAO,EAAE,CAAA;AACX,CAAC,CAAA"}

package/package.json

@@ -1,25 +1,38 @@
 {
   "name": "@bosun-sh/logbook",
-  "version": "1.0.0",
-  "description": "File-system kanban board MCP server for AI agents",
+  "version": "2.0.0",
+  "description": "File-system kanban board CLI and MCP server for AI agents",
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "bin": {
-    "logbook-mcp": "src/mcp/server.ts"
+    "logbook": "bin/logbook.cjs"
   },
   "files": [
-    "src/",
-    "hooks/",
-    "README.md"
+    "bin/",
+    "dist/",
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md",
+    "quickstart.md"
   ],
   "engines": {
-    "bun": ">=1.0.0"
+    "node": ">=18.0.0"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "start": "bun src/mcp/server.ts",
+    "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && node scripts/copy-hook-templates.mjs",
+    "prepack": "bun run build",
+    "start": "bun src/workspace/bin-cli.ts mcp",
     "test": "bun test",
     "test:watch": "bun test --watch",
     "test:unit": "bun test tests/unit/",
@@ -29,19 +42,23 @@
     "lint:fix": "biome lint --write .",
     "format": "biome format --write .",
     "check": "biome check .",
-    "prepare": "husky",
-    "prepublishOnly": "bun run typecheck",
-    "publish": "bun run typecheck && npm pack --dry-run && npm publish --ignore-scripts",
+    "prepare": "node -e \"process.exit(0)\"",
+    "prepublishOnly": "bun run typecheck && bun run check && bun test && bun run build",
+    "release:dry-run": "bun run typecheck && bun run check && bun test && bun run build && node scripts/npm-pack-dry-run.mjs",
+    "release": "bun run release:dry-run && node scripts/npm-publish.mjs",
     "publish:dev": "bun link ."
   },
   "dependencies": {
-    "effect": "^3.12.0",
+    "@bosun-sh/ohtools": "^0.1.0",
+    "@duckdb/node-api": "1.5.2-r.1",
+    "effect": "3.21.2",
     "zod": "^3.24.1"
   },
   "devDependencies": {
     "@biomejs/biome": "latest",
     "@types/bun": "latest",
     "husky": "^9.0.0",
+    "tsc-alias": "^1.8.17",
     "typescript": "^5.7.3"
   }
 }

package/quickstart.md

@@ -0,0 +1,163 @@
+# quickstart: logbook in 5 minutes
+
+## 1. install
+
+```bash
+npm install -g @bosun-sh/logbook
+# or
+bunx @bosun-sh/logbook --help
+```
+
+the published CLI runs on Node.js; no Bun install is required for runtime.
+
+## 2. initialize the workspace
+
+```bash
+logbook init
+```
+
+this creates `.logbook/` in the current directory with `config.json`, `workspace.json`, a `storage/` directory, and the `review-spawn` and `need-info-notify` hook templates. it also offers to configure your detected MCP client and optionally set up Linear sync.
+
+add `.logbook/storage/` to `.gitignore`:
+
+```gitignore
+.logbook/storage/
+```
+
+## 3. connect to your ai client
+
+`logbook init` can write the MCP config for detected clients. if you skipped that step, add one of these manually:
+
+**Claude Code** — add to `.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "logbook": {
+      "command": "logbook",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+**OpenCode** — add to `opencode.json`:
+
+```json
+{
+  "mcp": {
+    "logbook": {
+      "type": "local",
+      "command": ["logbook", "mcp"],
+      "enabled": true
+    }
+  }
+}
+```
+
+## 4. create your first task
+
+```bash
+logbook task:create \
+  --title "Implement login endpoint" \
+  --description "JWT RS256 auth. See docs/auth.md for the spec." \
+  --definition-of-done "Endpoint returns 200 for valid credentials; tests pass" \
+  --project myapp \
+  --milestone v1
+```
+
+output:
+
+```json
+{"ok":true,"data":{"task":{"id":"task_...","status":"backlog","title":"Implement login endpoint",...}}}
+```
+
+## 5. list tasks
+
+```bash
+logbook task:list --status "*"    # all statuses
+logbook task:list --status in_progress
+```
+
+## 6. check the current task (as an agent would)
+
+```bash
+logbook task:current
+```
+
+if no task is `in_progress`, this transitions the highest-priority `todo` task automatically. returns a `no_current_task` error if nothing is available.
+
+## 7. move a task through the lifecycle
+
+```bash
+# start work
+logbook task:update --id <uuid> --new-status in_progress
+
+# submit for review
+logbook task:update --id <uuid> --new-status pending_review
+
+# mark done
+logbook task:update --id <uuid> --new-status done
+```
+
+## optional: linear sync
+
+`logbook init` can run this setup interactively. if you skipped it, configure Linear separately:
+
+1. add your Linear API key to `.env` or export it in your shell:
+
+   ```bash
+   echo "LINEAR_API_KEY=lin_api_..." >> .env
+   ```
+
+2. configure Logbook from your Linear team URL:
+
+   ```bash
+   logbook sync:linear:setup --team-url https://linear.app/bosun/team/BOSUN
+   ```
+
+   Or use explicit ids:
+
+   ```bash
+   logbook sync:linear:setup --workspace-id <workspace-id> --team-id <team-id>
+   ```
+
+   This writes the public `linear` block to `.logbook/config.json`:
+
+   ```json
+   {
+     "linear": {
+       "apiTokenEnv": "LINEAR_API_KEY",
+       "workspaceId": "your-workspace-id",
+       "defaultTeamId": "your-team-id"
+     }
+   }
+   ```
+
+3. pull issues from Linear:
+
+   ```bash
+   logbook sync:linear:pull --dry-run   # preview without writing
+   logbook sync:linear:pull             # pull and write
+   ```
+
+4. push tasks back to Linear:
+
+   ```bash
+   logbook sync:linear:push --dry-run
+   logbook sync:linear:push
+   ```
+
+5. check sync status:
+
+   ```bash
+   logbook sync:linear:status --check-provider
+   ```
+
+When you use Logbook through MCP, agent tool calls automatically pull fresh Linear changes before task-facing work and push successful task updates back to Linear.
+
+---
+
+that's it. from here:
+- see `README.md` for the full MCP tool reference
+- see the **Migrating from v1** section in `README.md` if you're migrating from v1

package/hooks/need-info-notify/config.yml

@@ -1,3 +0,0 @@
-event: task.status_changed
-condition: "new_status == 'need_info'"
-timeout_ms: 5000

package/hooks/need-info-notify/script.ts

@@ -1,69 +0,0 @@
-#!/usr/bin/env bun
-import { readFile } from "node:fs/promises"
-
-const taskId = process.env.LOGBOOK_TASK_ID ?? ""
-const dataFile = process.env.LOGBOOK_TASKS_FILE ?? "./tasks.jsonl"
-
-if (taskId === "") process.exit(0)
-
-const readLines = async (filePath: string): Promise<readonly string[]> => {
-  const content = await readFile(filePath, "utf8").catch((e: unknown) => {
-    if (isEnoent(e)) return ""
-    throw e
-  })
-  return content.split("\n").filter((l) => l.trim() !== "")
-}
-
-interface RawComment {
-  id: string
-  timestamp: string
-  title: string
-  content: string
-  reply: string
-  kind: string
-}
-
-interface RawTask {
-  id: string
-  comments: RawComment[]
-}
-
-const parseTask = (line: string): RawTask | null => {
-  try {
-    return JSON.parse(line) as RawTask
-  } catch {
-    return null
-  }
-}
-
-const findBlockingComment = (task: RawTask): RawComment | null => {
-  // Find the most recent need_info comment with an empty reply
-  for (let i = task.comments.length - 1; i >= 0; i--) {
-    const comment = task.comments[i]
-    if (comment !== undefined && comment.kind === "need_info" && comment.reply === "") {
-      return comment
-    }
-  }
-  return null
-}
-
-const isEnoent = (e: unknown): boolean =>
-  typeof e === "object" && e !== null && (e as { code?: unknown }).code === "ENOENT"
-
-const lines = await readLines(dataFile)
-
-let found: RawTask | null = null
-for (const line of lines) {
-  const task = parseTask(line)
-  if (task !== null && task.id === taskId) {
-    found = task
-    break
-  }
-}
-
-if (found === null) process.exit(0)
-
-const comment = findBlockingComment(found)
-if (comment === null) process.exit(0)
-
-process.stdout.write(`[need_info] Task ${taskId}: ${comment.title}\n${comment.content}\n`)

package/hooks/review-spawn/config.yml

@@ -1,3 +0,0 @@
-event: task.status_changed
-condition: "new_status == 'pending_review'"
-timeout_ms: 30000