kankaku-claude 0.12.0 → 1.0.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "kankaku",
   "description": "Records how long Claude Code works on each of your prompts: wall time, waiting time, work time and cost, per prompt, in kankaku's worklog format.",
-  "version": "0.12.0",
+  "version": "1.0.0",
   "author": {
     "name": "soyunninja"
   },

package/CHANGELOG.md

@@ -4,6 +4,21 @@ 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/).
 
+## 1.0.0 — 2026-09-29
+
+### Changed
+
+- The library dependency is renamed from `kankaku` to `kankaku-pi`, and
+  its entry points are imported as `kankaku-pi/domain`, `kankaku-pi/ports`
+  and `kankaku-pi/hub`. The package keeps its own name, `kankaku-claude`
+  (directory unchanged). No behaviour change.
+- `kankaku-claude sync` usage text names `dist/cli.js`, and comments no
+  longer point at files that are not in the repository.
+
+## 0.12.1 — 2026-09-29
+
+No changes in this package; released in lockstep with kankaku 0.12.1.
+
 ## 0.12.0 — 2026-09-29
 
 ### Added

package/README.md

@@ -40,27 +40,27 @@ no identity and are labelled by whichever tool syncs them first.
   a `.ts` file once it sits under a `node_modules` directory
   (`ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING`), so every published
   hook/statusline/CLI command runs the built `dist/*.js` file, never the
-  `.ts` source. Installed via `kankaku-tui` (below) this needs no action
+  `.ts` source. Installed via `kankaku` (below) this needs no action
   from you; a manual `--plugin-dir` checkout must run `npm install && npm
   run build` once before Claude Code can load it (see "Manual/dev"
   below).
 
 ## Install
 
-**Recommended: `kankaku-tui`'s setup wizard.** This package lives inside
-`kankaku-tui`'s own dependency tree, so installing and running its setup
+**Recommended: `kankaku`'s setup wizard.** This package lives inside
+`kankaku`'s own dependency tree, so installing and running its setup
 wizard configures Claude Code for you — statusline and hooks together, in
 one step, with no checkout and no `--plugin-dir`:
 
 ```bash
-npm i -g kankaku-tui
+npm i -g kankaku
 kankaku setup
 ```
 
 Checking Claude Code in the wizard (or confirming it in `kankaku setup
 --yes`) writes `statusLine` and `hooks` into `~/.claude/settings.json`,
 resolved from this package's own bundled files, merged with — never
-clobbering — whatever else is already there. See `kankaku-tui`'s own
+clobbering — whatever else is already there. See `kankaku`'s own
 README ("Claude Code") for the full behaviour, the
 `--claude-plugin-dir`/`KANKAKU_CLAUDE_PLUGIN_DIR` override, and why you
 should drop `--plugin-dir` (below) once this has run.
@@ -72,7 +72,7 @@ at it directly:
 git clone https://github.com/soyunninja/kankaku.git
 cd kankaku/packages/claude
 npm install && npm run build
-claude --plugin-dir /path/to/kankaku-claude
+claude --plugin-dir "$PWD"
 ```
 
 `npm run build` compiles `src/` into `dist/`; the hooks, statusline and
@@ -113,7 +113,7 @@ Claude Code plugins cannot set `statusLine` for themselves — there is no
 programmatic way for a plugin to add a `statusLine` entry to your settings.
 The statusline is also the *only* documented source of per-prompt cost
 (`cost.total_cost_usd`); hooks never receive it. `kankaku setup` (above)
-writes it for you automatically; without `kankaku-tui`, run:
+writes it for you automatically; without `kankaku`, run:
 
 ```
 /kankaku:setup

package/dist/auto-sync.js

@@ -3,7 +3,7 @@ export async function autoSync(trigger, deps) {
     if (deps.env.KANKAKU_SYNC_AUTO === "0")
         return;
     try {
-        const { resolveHubCredentials } = await import("kankaku/hub");
+        const { resolveHubCredentials } = await import("kankaku-pi/hub");
         const { homedir } = await import("node:os");
         const hub = resolveHubCredentials({ env: deps.env, homeDir: deps.homeDir ?? (() => deps.env.HOME || homedir()) });
         if (!hub.credentials || hub.invalidReason)

package/dist/cli-core.js

@@ -1,5 +1,5 @@
 import { basename, join } from "node:path";
-import { JsonlWorkLog } from "kankaku/hub";
+import { JsonlWorkLog } from "kankaku-pi/hub";
 import { listStateFiles, resolveKankakuDir } from "./paths.js";
 import { readState } from "./session-state.js";
 import { readCost } from "./cost-store.js";

package/dist/cost-store.js

@@ -6,9 +6,10 @@ const SEVEN_DAYS_MS = 7 * 24 * 60 * 60 * 1000;
  * Cost lives under the HOME directory, never a project: the statusline
  * command is wired globally and runs in every session on the machine, so a
  * project-relative path would litter whatever project happens to be open
- * (the defect this module fixes — see `odd/tasks/hook-tracking.md` T7).
+ * (the defect this module fixes: cost files were written into whichever
+ * project happened to be open).
  * Imports only node builtins so light hooks that read/write cost stay off
- * the `kankaku` import path.
+ * the `kankaku-pi` import path.
  */
 export function costDir(env) {
     const home = env.HOME || homedir();

package/dist/doctor.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { JsonlWorkLog, SyncStateStore, computeSyncStatus, resolveHubCredentials } from "kankaku/hub";
+import { JsonlWorkLog, SyncStateStore, computeSyncStatus, resolveHubCredentials } from "kankaku-pi/hub";
 import { costDir } from "./cost-store.js";
 import { listStateFiles, resolveKankakuDir } from "./paths.js";
 import { readState } from "./session-state.js";

package/dist/handle-hook.js

@@ -10,7 +10,7 @@ const STOP_COST_WAIT_MAX_MS = 1500;
 /**
  * Dispatches one Claude Code hook invocation. Light events (everything but
  * Stop/SessionStart/SessionEnd) only append one event line plus a tiny
- * state update, and never import `kankaku` at runtime — the heavier replay/
+ * state update, and never import `kankaku-pi` at runtime — the heavier replay/
  * storage layer is loaded with dynamic `import()` only inside the three
  * branches that actually settle or recover a record.
  */
@@ -111,7 +111,7 @@ export async function handleHook(input, deps) {
 async function handleStop(paths, sessionId, deps) {
     const { replayPrompt } = await import("./replay.js");
     const { buildClaudeRecord } = await import("./record.js");
-    const { JsonlWorkLog } = await import("kankaku/hub");
+    const { JsonlWorkLog } = await import("kankaku-pi/hub");
     const events = readEventLog(paths.eventsFile);
     const beforeStopTs = events.length >= 2 ? events[events.length - 2].ts : events[events.length - 1]?.ts ?? deps.now();
     const deadline = deps.now() + STOP_COST_WAIT_MAX_MS;
@@ -149,7 +149,7 @@ async function handleStop(paths, sessionId, deps) {
 async function handleSessionStart(paths, sessionId, cwd, source, ts, deps) {
     if (source !== "compact") {
         const { recoverStaleSessions } = await import("./inflight-recovery.js");
-        const { JsonlWorkLog } = await import("kankaku/hub");
+        const { JsonlWorkLog } = await import("kankaku-pi/hub");
         const recovered = recoverStaleSessions({
             claudeDir: paths.claudeDir,
             currentSessionId: sessionId,
@@ -189,7 +189,7 @@ async function handleSessionEnd(paths, sessionId, cwd, ts, deps) {
     if (state?.promptOpen) {
         const { replayPrompt } = await import("./replay.js");
         const { buildClaudeRecord } = await import("./record.js");
-        const { JsonlWorkLog } = await import("kankaku/hub");
+        const { JsonlWorkLog } = await import("kankaku-pi/hub");
         const events = readEventLog(paths.eventsFile);
         const prompts = splitPrompts(events);
         const last = prompts[prompts.length - 1];

package/dist/paths.js

@@ -1,7 +1,7 @@
 import { readdirSync } from "node:fs";
 import { isAbsolute, join } from "node:path";
 /**
- * Same rule as kankaku's `resolveKankakuDir` (kankaku/hub): an absolute
+ * Same rule as `resolveKankakuDir` in the `kankaku-pi` hub barrel (`kankaku-pi/hub`): an absolute
  * `KANKAKU_DIR` is used as-is, a relative one is joined against the session's
  * cwd. Inlined rather than imported so the light hooks (one per tool call)
  * never load the hub barrel for a two-line helper.

package/dist/record.js

@@ -24,7 +24,7 @@ const PLUGIN_VERSION = readPackageVersion(join(dirname(dirname(fileURLToPath(imp
  * caller decides which cost snapshot's model applies.
  *
  * Also stamps who MEASURED the record (`agent`, `plugin`, `pluginVersion`),
- * so a worklog later synced by another tool (the kankaku TUI) keeps the
+ * so a worklog later synced by another tool (the `kankaku` CLI) keeps the
  * right identity. `agentVersion` is omitted: Claude Code passes its version
  * to no hook payload, and spawning `claude --version` from a hook is not
  * acceptable.

package/dist/replay.js

@@ -1,11 +1,11 @@
-import { WorkTracker } from "kankaku/domain";
+import { WorkTracker } from "kankaku-pi/domain";
 /** Tool names whose span counts as waiting rather than working. */
 const INTERACTIVE_TOOLS = ["AskUserQuestion"];
 /**
  * The plugin's own subagent profile: Claude Code's `Agent`/`Task` tool
  * calls open a subagent span, read from `subagent_type`. No join key is
- * offered (`SubagentStart`/`SubagentStop` are recorded but not linked — see
- * odd/tasks/hook-tracking.md "Replay (pure)").
+ * offered (`SubagentStart`/`SubagentStop` are recorded but not linked, so a
+ * subagent span is closed by the replay itself).
  */
 const CLAUDE_CODE_SUBAGENT_PROFILE = {
     id: "claude-code",

package/dist/report.js

@@ -1,4 +1,4 @@
-import { buildTasks } from "kankaku/domain";
+import { buildTasks } from "kankaku-pi/domain";
 const STATUS_WORD = {
     completed: "done",
     interrupted: "interrupted",

package/dist/sync-cli.js

@@ -2,9 +2,9 @@ import { readFileSync } from "node:fs";
 import { homedir, hostname, tmpdir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { CachedCatalog, JsonlWorkLog, PocketBaseClient, PocketBaseSink, SyncStateStore, computeSyncStatus, createPocketBaseCatalogFetcher, resolveHubCredentials, runSync, safeHomeDir, } from "kankaku/hub";
+import { CachedCatalog, JsonlWorkLog, PocketBaseClient, PocketBaseSink, SyncStateStore, computeSyncStatus, createPocketBaseCatalogFetcher, resolveHubCredentials, runSync, safeHomeDir, } from "kankaku-pi/hub";
 import { resolveKankakuDir } from "./paths.js";
-const usage = "usage: node src/cli.ts sync [all|status]\n";
+const usage = "usage: node dist/cli.js sync [all|status]\n";
 function windowHours(env) {
     const value = Number(env.KANKAKU_SYNC_WINDOW_HOURS);
     return env.KANKAKU_SYNC_WINDOW_HOURS && Number.isFinite(value) && value > 0 ? value : 24;

package/dist/task-cli.js

@@ -1,6 +1,6 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { CachedCatalog, PocketBaseClient, createPocketBaseCatalogFetcher, resolveHubCredentials } from "kankaku/hub";
+import { CachedCatalog, PocketBaseClient, createPocketBaseCatalogFetcher, resolveHubCredentials } from "kankaku-pi/hub";
 import { findSession } from "./find-session.js";
 import { resolveKankakuDir, resolveTargetFile } from "./paths.js";
 import { readSessionTarget, writeSessionTarget } from "./session-target-store.js";

package/dist/task-select.js

@@ -2,7 +2,7 @@
  * Pure task selection for `/kankaku:task`. Mirrors pi's picker
  * (`adapters/target-picker.ts#pickHubTask`): a task is pickable when its
  * status is not `done` (the hub's statuses are `open | doing | done`, see
- * `HubTask` in `kankaku/domain`) and it belongs to the resolved project.
+ * `HubTask` in `kankaku-pi/domain`) and it belongs to the resolved project.
  */
 export function isOpenTask(task) {
     return task.status !== "done";

package/dist/work-target.js

@@ -1,7 +1,7 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { CachedCatalog, readProjectClient, readProjectTargetIds, resolveHubCredentials, } from "kankaku/hub";
-import { formatWorkTargetLabel, isValidClient, resolveClient, resolveWorkTarget, resolveWorkTargetSource, } from "kankaku/domain";
+import { CachedCatalog, readProjectClient, readProjectTargetIds, resolveHubCredentials, } from "kankaku-pi/hub";
+import { formatWorkTargetLabel, isValidClient, resolveClient, resolveWorkTarget, resolveWorkTargetSource, } from "kankaku-pi/domain";
 import { findSession } from "./find-session.js";
 import { resolveKankakuDir, resolveTargetFile } from "./paths.js";
 import { readSessionTarget } from "./session-target-store.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kankaku-claude",
-  "version": "0.12.0",
+  "version": "1.0.0",
   "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": "^0.12.0"
+    "kankaku-pi": "^1.0.0"
   },
   "devDependencies": {
     "@types/node": "^24.13.4",