kankaku-claude 1.4.0 → 1.4.1

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## Unreleased
+
+### Added
+
+- `/kankaku:task new <title> [--ref <externalRef>]` creates an open task in
+  the resolved project and links it session-only, caching the returned task
+  immediately. Creation stays out of hooks.
+
 ## 1.4.0 — 2026-09-30
 
 ### Added

package/README.md

@@ -297,6 +297,11 @@ for the folder, so the records written from then on carry that task:
   `/kankaku:task <id>` by hub id, and `/kankaku:task <text>` by a unique
   case-insensitive part of the title (several matches are listed and nothing
   changes). A purely numeric argument is always a list number.
+- `/kankaku:task new <title> [--ref <externalRef>]` creates an open task
+  in the resolved project and links it to this session. The title is required;
+  `--ref` takes one argument (quote references containing spaces). Creation
+  requires a reachable hub; failure leaves the existing link unchanged.
+  The returned task is cached immediately so record resolution retains its id.
 - `/kankaku:task clear` removes the link.
 
 The link is session-only, like `/kankaku task pick` in pi: it is stored in

package/commands/task.md

@@ -1,6 +1,6 @@
 ---
-description: Link this session to a hub task (list open tasks, pick one, or clear the link)
-argument-hint: [number | id | text | clear]
+description: Create or link a hub task for this session, list open tasks, or clear the link
+argument-hint: [number | id | text | clear | new <title> [--ref <externalRef>]]
 allowed-tools: Bash(node:*)
 ---
 

package/dist/catalog-refresh.js

@@ -1,5 +1,5 @@
 import { join } from "node:path";
-import { CachedCatalog, PocketBaseClient, createPocketBaseCatalogFetcher, resolveHubCredentials } from "kankaku-pi/hub";
+import { CachedCatalog, PocketBaseClient, createHubTask, createPocketBaseCatalogFetcher, resolveHubCredentials } from "kankaku-pi/hub";
 const DEFAULT_REFRESH_MS = 3000;
 /**
  * Best-effort refresh bounded by `catalogTimeoutMs`; on failure the cached
@@ -32,6 +32,26 @@ export async function refreshCatalog(deps, homeDir) {
         return undefined;
     return { snapshot: cached, text: `catalog from cache, ${formatAge(deps.now() - cached.fetchedAt)} old` };
 }
+/** Explicit task command only: POST and adopt before the session link is written. */
+export async function createCatalogTask(deps, homeDir, projectId, title, externalRef) {
+    const hub = resolveHubCredentials({ env: deps.env, homeDir: () => homeDir });
+    if (!hub.credentials)
+        throw new Error("hub credentials are not configured");
+    const client = new PocketBaseClient({ ...hub.credentials, ...(deps.fetch ? { fetch: deps.fetch } : {}) });
+    const catalog = new CachedCatalog({ filePath: join(homeDir, ".kankaku", "catalog.json"), url: hub.credentials.url, clock: { now: deps.now }, fetchCatalog: createPocketBaseCatalogFetcher(client) });
+    if (!catalog.read())
+        throw new Error("no catalog cache");
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), deps.catalogTimeoutMs ?? DEFAULT_REFRESH_MS);
+    try {
+        const task = await createHubTask(client, { projectId, title, ...(externalRef ? { externalRef } : {}) }, controller.signal);
+        catalog.adoptTask(task);
+        return task;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
 function formatAge(ms) {
     const seconds = Math.max(0, Math.round(ms / 1000));
     if (seconds < 60)

package/dist/task-cli.js

@@ -1,6 +1,6 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { refreshCatalog } from "./catalog-refresh.js";
+import { createCatalogTask, refreshCatalog } from "./catalog-refresh.js";
 import { findSession } from "./find-session.js";
 import { resolveKankakuDir, resolveTargetFile } from "./paths.js";
 import { readSessionTarget, sessionInputs, withoutTaskLink, writeSessionTarget } from "./session-target-store.js";
@@ -28,6 +28,13 @@ export async function runTaskCli(args, deps) {
     const file = resolveTargetFile(claudeDir, session);
     const stored = readSessionTarget(file) ?? { lastList: { kind: "tasks", ids: [] } };
     const arg = args.join(" ").trim();
+    const creating = args[0] === "new";
+    const refIndex = args.indexOf("--ref");
+    const title = creating ? args.slice(1, refIndex === -1 ? undefined : refIndex).join(" ").trim() : "";
+    const externalRef = refIndex === -1 ? undefined : args[refIndex + 1]?.trim();
+    if (creating && (!title || (refIndex !== -1 && (!externalRef || refIndex !== args.length - 2)))) {
+        return say(["usage: /kankaku:task new <title> [--ref <externalRef>]"], 1);
+    }
     if (arg === "clear") {
         if (stored.hubTaskId === undefined)
             return say(["no task linked"], 0);
@@ -50,6 +57,16 @@ export async function runTaskCli(args, deps) {
     }
     const projectName = resolved.target.projectName ?? projectId;
     const open = listOpenTasks(tasks, projectId);
+    if (creating) {
+        try {
+            const task = await createCatalogTask(deps, homeDir, projectId, title, externalRef);
+            writeSessionTarget(file, { ...stored, hubTaskId: task.id, hubTaskTitle: task.title, projectId, pickedAt: deps.now() });
+            return say([...prefix, `created and linked: ${task.title}`], 0);
+        }
+        catch {
+            return say([...prefix, "task creation failed; existing session link unchanged"], 1);
+        }
+    }
     if (arg === "" || arg === "list") {
         if (open.length === 0)
             return say([...prefix, `no open tasks in project ${projectName}`], 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kankaku-claude",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Claude Code plugin that records how long the agent works on each user prompt, in kankaku's worklog format.",
   "type": "module",
   "files": [
@@ -27,7 +27,7 @@
     "prepublishOnly": "npm run check"
   },
   "dependencies": {
-    "kankaku-pi": "^1.4.0"
+    "kankaku-pi": "^1.4.1"
   },
   "devDependencies": {
     "@types/node": "^24.13.4",