takt 0.2.2 → 0.3.0

package/dist/task/clone.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Git clone lifecycle management
+ *
+ * Creates, removes, and tracks git clones for task isolation.
+ * Uses `git clone --reference --dissociate` so each clone has a fully
+ * independent .git directory, then removes the origin remote to prevent
+ * Claude Code SDK from traversing back to the main repository.
+ */
+export interface WorktreeOptions {
+    /** worktree setting: true = auto path, string = custom path */
+    worktree: boolean | string;
+    /** Branch name (optional, auto-generated if omitted) */
+    branch?: string;
+    /** Task slug for auto-generated paths/branches */
+    taskSlug: string;
+}
+export interface WorktreeResult {
+    /** Absolute path to the clone */
+    path: string;
+    /** Branch name used */
+    branch: string;
+}
+/**
+ * Create a git clone for a task.
+ *
+ * Uses `git clone --reference --dissociate` to create an independent clone,
+ * then removes origin and checks out a new branch.
+ */
+export declare function createSharedClone(projectDir: string, options: WorktreeOptions): WorktreeResult;
+/**
+ * Create a temporary clone for an existing branch.
+ * Used by review/instruct to work on a branch that was previously pushed.
+ */
+export declare function createTempCloneForBranch(projectDir: string, branch: string): WorktreeResult;
+/**
+ * Remove a clone directory.
+ */
+export declare function removeClone(clonePath: string): void;
+/**
+ * Save clone metadata (branch → clonePath mapping).
+ * Used to clean up orphaned clone directories on merge/delete.
+ */
+export declare function saveCloneMeta(projectDir: string, branch: string, clonePath: string): void;
+/**
+ * Remove clone metadata for a branch.
+ */
+export declare function removeCloneMeta(projectDir: string, branch: string): void;
+/**
+ * Clean up an orphaned clone directory associated with a branch.
+ * Reads metadata, removes clone directory if it still exists, then removes metadata.
+ */
+export declare function cleanupOrphanedClone(projectDir: string, branch: string): void;
+//# sourceMappingURL=clone.d.ts.map

package/dist/task/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../src/task/clone.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAgFD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,cAAc,CAkB9F;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAc3F;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQnD;AAcD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAKzF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAOxE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAY7E"}

package/dist/task/clone.js

@@ -0,0 +1,181 @@
+/**
+ * Git clone lifecycle management
+ *
+ * Creates, removes, and tracks git clones for task isolation.
+ * Uses `git clone --reference --dissociate` so each clone has a fully
+ * independent .git directory, then removes the origin remote to prevent
+ * Claude Code SDK from traversing back to the main repository.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { createLogger } from '../utils/debug.js';
+import { slugify } from '../utils/slug.js';
+import { loadGlobalConfig } from '../config/globalConfig.js';
+const log = createLogger('clone');
+function generateTimestamp() {
+    return new Date().toISOString().replace(/[-:.]/g, '').slice(0, 13);
+}
+/**
+ * Resolve the base directory for clones from global config.
+ * Returns the configured worktree_dir (resolved to absolute), or ../
+ */
+function resolveCloneBaseDir(projectDir) {
+    const globalConfig = loadGlobalConfig();
+    if (globalConfig.worktreeDir) {
+        return path.isAbsolute(globalConfig.worktreeDir)
+            ? globalConfig.worktreeDir
+            : path.resolve(projectDir, globalConfig.worktreeDir);
+    }
+    return path.join(projectDir, '..');
+}
+/**
+ * Resolve the clone path based on options and global config.
+ *
+ * Priority:
+ * 1. Custom path in options.worktree (string)
+ * 2. worktree_dir from config.yaml (if set)
+ * 3. Default: ../{dir-name}
+ */
+function resolveClonePath(projectDir, options) {
+    const timestamp = generateTimestamp();
+    const slug = slugify(options.taskSlug);
+    const dirName = slug ? `${timestamp}-${slug}` : timestamp;
+    if (typeof options.worktree === 'string') {
+        return path.isAbsolute(options.worktree)
+            ? options.worktree
+            : path.resolve(projectDir, options.worktree);
+    }
+    return path.join(resolveCloneBaseDir(projectDir), dirName);
+}
+function resolveBranchName(options) {
+    if (options.branch) {
+        return options.branch;
+    }
+    const timestamp = generateTimestamp();
+    const slug = slugify(options.taskSlug);
+    return slug ? `takt/${timestamp}-${slug}` : `takt/${timestamp}`;
+}
+function branchExists(projectDir, branch) {
+    try {
+        execFileSync('git', ['rev-parse', '--verify', branch], {
+            cwd: projectDir,
+            stdio: 'pipe',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Clone a repository and remove origin to isolate from the main repo.
+ */
+function cloneAndIsolate(projectDir, clonePath) {
+    fs.mkdirSync(path.dirname(clonePath), { recursive: true });
+    execFileSync('git', ['clone', '--reference', projectDir, '--dissociate', projectDir, clonePath], {
+        cwd: projectDir,
+        stdio: 'pipe',
+    });
+    execFileSync('git', ['remote', 'remove', 'origin'], {
+        cwd: clonePath,
+        stdio: 'pipe',
+    });
+}
+/**
+ * Create a git clone for a task.
+ *
+ * Uses `git clone --reference --dissociate` to create an independent clone,
+ * then removes origin and checks out a new branch.
+ */
+export function createSharedClone(projectDir, options) {
+    const clonePath = resolveClonePath(projectDir, options);
+    const branch = resolveBranchName(options);
+    log.info('Creating shared clone', { path: clonePath, branch });
+    cloneAndIsolate(projectDir, clonePath);
+    if (branchExists(clonePath, branch)) {
+        execFileSync('git', ['checkout', branch], { cwd: clonePath, stdio: 'pipe' });
+    }
+    else {
+        execFileSync('git', ['checkout', '-b', branch], { cwd: clonePath, stdio: 'pipe' });
+    }
+    saveCloneMeta(projectDir, branch, clonePath);
+    log.info('Clone created', { path: clonePath, branch });
+    return { path: clonePath, branch };
+}
+/**
+ * Create a temporary clone for an existing branch.
+ * Used by review/instruct to work on a branch that was previously pushed.
+ */
+export function createTempCloneForBranch(projectDir, branch) {
+    const timestamp = generateTimestamp();
+    const clonePath = path.join(resolveCloneBaseDir(projectDir), `tmp-${timestamp}`);
+    log.info('Creating temp clone for branch', { path: clonePath, branch });
+    cloneAndIsolate(projectDir, clonePath);
+    execFileSync('git', ['checkout', branch], { cwd: clonePath, stdio: 'pipe' });
+    saveCloneMeta(projectDir, branch, clonePath);
+    log.info('Temp clone created', { path: clonePath, branch });
+    return { path: clonePath, branch };
+}
+/**
+ * Remove a clone directory.
+ */
+export function removeClone(clonePath) {
+    log.info('Removing clone', { path: clonePath });
+    try {
+        fs.rmSync(clonePath, { recursive: true, force: true });
+        log.info('Clone removed', { path: clonePath });
+    }
+    catch (err) {
+        log.error('Failed to remove clone', { path: clonePath, error: String(err) });
+    }
+}
+// --- Clone metadata ---
+const CLONE_META_DIR = 'clone-meta';
+function encodeBranchName(branch) {
+    return branch.replace(/\//g, '--');
+}
+function getCloneMetaPath(projectDir, branch) {
+    return path.join(projectDir, '.takt', CLONE_META_DIR, `${encodeBranchName(branch)}.json`);
+}
+/**
+ * Save clone metadata (branch → clonePath mapping).
+ * Used to clean up orphaned clone directories on merge/delete.
+ */
+export function saveCloneMeta(projectDir, branch, clonePath) {
+    const filePath = getCloneMetaPath(projectDir, branch);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify({ branch, clonePath }));
+    log.info('Clone meta saved', { branch, clonePath });
+}
+/**
+ * Remove clone metadata for a branch.
+ */
+export function removeCloneMeta(projectDir, branch) {
+    try {
+        fs.unlinkSync(getCloneMetaPath(projectDir, branch));
+        log.info('Clone meta removed', { branch });
+    }
+    catch {
+        // File may not exist — ignore
+    }
+}
+/**
+ * Clean up an orphaned clone directory associated with a branch.
+ * Reads metadata, removes clone directory if it still exists, then removes metadata.
+ */
+export function cleanupOrphanedClone(projectDir, branch) {
+    try {
+        const raw = fs.readFileSync(getCloneMetaPath(projectDir, branch), 'utf-8');
+        const meta = JSON.parse(raw);
+        if (fs.existsSync(meta.clonePath)) {
+            removeClone(meta.clonePath);
+            log.info('Orphaned clone cleaned up', { branch, clonePath: meta.clonePath });
+        }
+    }
+    catch {
+        // No metadata or parse error — nothing to clean up
+    }
+    removeCloneMeta(projectDir, branch);
+}
+//# sourceMappingURL=clone.js.map

package/dist/task/clone.js.map

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

package/dist/task/index.d.ts

@@ -5,7 +5,8 @@ export { TaskRunner, type TaskInfo, type TaskResult, } from './runner.js';
 export { showTaskList } from './display.js';
 export { TaskFileSchema, type TaskFileData } from './schema.js';
 export { parseTaskFile, parseTaskFiles, type ParsedTask } from './parser.js';
-export { createWorktree, removeWorktree, detectDefaultBranch, parseTaktWorktrees, listTaktWorktrees, getFilesChanged, extractTaskSlug, buildReviewItems, type WorktreeOptions, type WorktreeResult, type WorktreeInfo, type WorktreeReviewItem, } from './worktree.js';
-export { autoCommitWorktree, type AutoCommitResult } from './autoCommit.js';
+export { createSharedClone, removeClone, createTempCloneForBranch, saveCloneMeta, removeCloneMeta, cleanupOrphanedClone, type WorktreeOptions, type WorktreeResult, } from './clone.js';
+export { detectDefaultBranch, listTaktBranches, parseTaktBranches, getFilesChanged, extractTaskSlug, getOriginalInstruction, buildListItems, type BranchInfo, type BranchListItem, } from './branchList.js';
+export { autoCommitAndPush, type AutoCommitResult } from './autoCommit.js';
 export { TaskWatcher, type TaskWatcherOptions } from './watcher.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/task/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/task/index.js

@@ -5,7 +5,8 @@ export { TaskRunner, } from './runner.js';
 export { showTaskList } from './display.js';
 export { TaskFileSchema } from './schema.js';
 export { parseTaskFile, parseTaskFiles } from './parser.js';
-export { createWorktree, removeWorktree, detectDefaultBranch, parseTaktWorktrees, listTaktWorktrees, getFilesChanged, extractTaskSlug, buildReviewItems, } from './worktree.js';
-export { autoCommitWorktree } from './autoCommit.js';
+export { createSharedClone, removeClone, createTempCloneForBranch, saveCloneMeta, removeCloneMeta, cleanupOrphanedClone, } from './clone.js';
+export { detectDefaultBranch, listTaktBranches, parseTaktBranches, getFilesChanged, extractTaskSlug, getOriginalInstruction, buildListItems, } from './branchList.js';
+export { autoCommitAndPush } from './autoCommit.js';
 export { TaskWatcher } from './watcher.js';
 //# sourceMappingURL=index.js.map

package/dist/task/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,GAGX,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,GAKjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAyB,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,UAAU,GAGX,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AAC7E,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,oBAAoB,GAGrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,cAAc,GAGf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAyB,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC"}

package/dist/task/schema.d.ts

@@ -9,14 +9,14 @@ import { z } from 'zod/v4';
  *
  * Examples:
  *   task: "認証機能を追加する"
- *   worktree: true                  # .takt/worktrees/{timestamp}-{task-slug}/ に作成
+ *   worktree: true                  # 共有クローンで隔離実行
  *   branch: "feat/add-auth"         # オプション（省略時は自動生成）
  *   workflow: "default"             # オプション（省略時はcurrent workflow）
  *
- * worktree patterns:
- *   - true: create at .takt/worktrees/{timestamp}-{task-slug}/
+ * worktree patterns (uses git clone --shared internally):
+ *   - true: create shared clone in sibling dir or worktree_dir
  *   - "/path/to/dir": create at specified path
- *   - omitted: no worktree (run in cwd)
+ *   - omitted: no isolation (run in cwd)
  *
  * branch patterns:
  *   - "feat/xxx": use specified branch name

package/dist/task/schema.js

@@ -9,14 +9,14 @@ import { z } from 'zod/v4';
  *
  * Examples:
  *   task: "認証機能を追加する"
- *   worktree: true                  # .takt/worktrees/{timestamp}-{task-slug}/ に作成
+ *   worktree: true                  # 共有クローンで隔離実行
  *   branch: "feat/add-auth"         # オプション（省略時は自動生成）
  *   workflow: "default"             # オプション（省略時はcurrent workflow）
  *
- * worktree patterns:
- *   - true: create at .takt/worktrees/{timestamp}-{task-slug}/
+ * worktree patterns (uses git clone --shared internally):
+ *   - true: create shared clone in sibling dir or worktree_dir
  *   - "/path/to/dir": create at specified path
- *   - omitted: no worktree (run in cwd)
+ *   - omitted: no isolation (run in cwd)
  *
  * branch patterns:
  *   - "feat/xxx": use specified branch name

package/dist/task/summarize.d.ts

@@ -1,20 +1,22 @@
 /**
- * Task name summarization using AI
+ * Task name summarization using AI or romanization
  *
- * Generates concise English summaries for use in branch names and worktree paths.
+ * Generates concise English/romaji summaries for use in branch names and clone paths.
  */
 export interface SummarizeOptions {
     /** Working directory for Claude execution */
     cwd: string;
-    /** Model to use (optional, defaults to haiku for speed) */
+    /** Model to use (optional, defaults to config or haiku) */
     model?: string;
+    /** Use LLM for summarization (default: true). If false, uses romanization. */
+    useLLM?: boolean;
 }
 /**
- * Summarize a task name into a concise English slug using AI.
+ * Summarize a task name into a concise slug using AI or romanization.
  *
  * @param taskName - Original task name (can be in any language)
  * @param options - Summarization options
- * @returns English slug suitable for branch names
+ * @returns Slug suitable for branch names (English if LLM, romaji if not)
  */
 export declare function summarizeTaskName(taskName: string, options: SummarizeOptions): Promise<string>;
 //# sourceMappingURL=summarize.d.ts.map

package/dist/task/summarize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../src/task/summarize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CAsBjB"}
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../src/task/summarize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0CH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAaD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CA4BjB"}

package/dist/task/summarize.js

@@ -1,49 +1,82 @@
 /**
- * Task name summarization using AI
+ * Task name summarization using AI or romanization
  *
- * Generates concise English summaries for use in branch names and worktree paths.
+ * Generates concise English/romaji summaries for use in branch names and clone paths.
  */
-import { callClaude } from '../claude/client.js';
+import * as wanakana from 'wanakana';
+import { loadGlobalConfig } from '../config/globalConfig.js';
+import { getProvider } from '../providers/index.js';
 import { createLogger } from '../utils/debug.js';
 const log = createLogger('summarize');
-const SUMMARIZE_SYSTEM_PROMPT = `You are a helpful assistant that generates concise English slugs for git branch names.
+/**
+ * Sanitize a string for use as git branch name and directory name.
+ *
+ * Git branch restrictions: no spaces, ~, ^, :, ?, *, [, \, .., @{, leading -
+ * Directory restrictions: no /, \, :, *, ?, ", <, >, |
+ *
+ * This function allows only: a-z, 0-9, hyphen
+ */
+function sanitizeSlug(input, maxLength = 30) {
+    return input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-') // Replace invalid chars with hyphen
+        .replace(/-+/g, '-') // Collapse multiple hyphens
+        .replace(/^-+/, '') // Remove leading hyphens
+        .slice(0, maxLength)
+        .replace(/-+$/, ''); // Remove trailing hyphens (after slice)
+}
+const SUMMARIZE_SYSTEM_PROMPT = `You are a slug generator. Given a task description, output ONLY a slug.
 
-Rules:
-- Output ONLY the slug, nothing else
-- Use lowercase letters, numbers, and hyphens only
-- Maximum 30 characters
-- No leading/trailing hyphens
-- Be descriptive but concise
-- If the input is already in English and short, simplify it
+NEVER output sentences. NEVER start with "this", "the", "i", "we", or "it".
+ALWAYS start with a verb: add, fix, update, refactor, implement, remove, etc.
 
-Examples:
-- "認証機能を追加する" → "add-auth"
-- "Fix the login bug" → "fix-login-bug"
-- "worktreeを作るときブランチ名をAIで生成" → "ai-branch-naming"
-- "Add user registration with email verification" → "add-user-registration"`;
+Format: verb-noun (lowercase, hyphens, max 30 chars)
+
+Input → Output:
+認証機能を追加する → add-auth
+Fix the login bug → fix-login-bug
+ユーザー登録にメール認証を追加 → add-email-verification
+worktreeを作るときブランチ名をAIで生成 → ai-branch-naming
+レビュー画面に元の指示を表示する → show-original-instruction`;
+/**
+ * Convert Japanese text to romaji slug.
+ * Handles hiragana, katakana, and passes through alphanumeric.
+ * Kanji and other non-convertible characters become hyphens.
+ */
+function toRomajiSlug(text) {
+    // Convert to romaji (hiragana/katakana → romaji, kanji stays as-is)
+    const romaji = wanakana.toRomaji(text, { customRomajiMapping: {} });
+    return sanitizeSlug(romaji);
+}
 /**
- * Summarize a task name into a concise English slug using AI.
+ * Summarize a task name into a concise slug using AI or romanization.
  *
  * @param taskName - Original task name (can be in any language)
  * @param options - Summarization options
- * @returns English slug suitable for branch names
+ * @returns Slug suitable for branch names (English if LLM, romaji if not)
  */
 export async function summarizeTaskName(taskName, options) {
-    log.info('Summarizing task name', { taskName });
-    const response = await callClaude('summarizer', `Summarize this task: "${taskName}"`, {
+    const useLLM = options.useLLM ?? true;
+    log.info('Summarizing task name', { taskName, useLLM });
+    // Use romanization if LLM is disabled
+    if (!useLLM) {
+        const slug = toRomajiSlug(taskName);
+        log.info('Task name romanized', { original: taskName, slug });
+        return slug || 'task';
+    }
+    // Use LLM for summarization
+    const globalConfig = loadGlobalConfig();
+    const providerType = globalConfig.provider ?? 'claude';
+    const model = options.model ?? globalConfig.model ?? 'haiku';
+    const provider = getProvider(providerType);
+    const response = await provider.call('summarizer', taskName, {
         cwd: options.cwd,
-        model: options.model ?? 'haiku',
-        maxTurns: 1,
+        model,
         systemPrompt: SUMMARIZE_SYSTEM_PROMPT,
         allowedTools: [],
     });
-    const slug = response.content
-        .trim()
-        .toLowerCase()
-        .replace(/[^a-z0-9-]/g, '-')
-        .replace(/-+/g, '-')
-        .replace(/^-|-$/g, '')
-        .slice(0, 30);
+    const slug = sanitizeSlug(response.content);
     log.info('Task name summarized', { original: taskName, slug });
     return slug || 'task';
 }

package/dist/task/summarize.js.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../src/task/summarize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;AAEtC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;4EAc4C,CAAC;AAS7E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,OAAyB;IAEzB,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEhD,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,YAAY,EAAE,yBAAyB,QAAQ,GAAG,EAAE;QACpF,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO;QAC/B,QAAQ,EAAE,CAAC;QACX,YAAY,EAAE,uBAAuB;QACrC,YAAY,EAAE,EAAE;KACjB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO;SAC1B,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/D,OAAO,IAAI,IAAI,MAAM,CAAC;AACxB,CAAC"}
+{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../src/task/summarize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAqB,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;AAEtC;;;;;;;GAOG;AACH,SAAS,YAAY,CAAC,KAAa,EAAE,SAAS,GAAG,EAAE;IACjD,OAAO,KAAK;SACT,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAE,oCAAoC;SACjE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAU,4BAA4B;SACzD,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAW,yBAAyB;SACtD,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAU,wCAAwC;AAC1E,CAAC;AAED,MAAM,uBAAuB,GAAG;;;;;;;;;;;;6CAYa,CAAC;AAW9C;;;;GAIG;AACH,SAAS,YAAY,CAAC,IAAY;IAChC,oEAAoE;IACpE,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC,CAAC;IACpE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgB,EAChB,OAAyB;IAEzB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;IACtC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAExD,sCAAsC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpC,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,OAAO,IAAI,IAAI,MAAM,CAAC;IACxB,CAAC;IAED,4BAA4B;IAC5B,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;IACxC,MAAM,YAAY,GAAI,YAAY,CAAC,QAAyB,IAAI,QAAQ,CAAC;IACzE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,KAAK,IAAI,OAAO,CAAC;IAE7D,MAAM,QAAQ,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE;QAC3D,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK;QACL,YAAY,EAAE,uBAAuB;QACrC,YAAY,EAAE,EAAE;KACjB,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC5C,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/D,OAAO,IAAI,IAAI,MAAM,CAAC;AACxB,CAAC"}

package/dist/utils/session.d.ts

@@ -1,7 +1,7 @@
 /**
  * Session management utilities
  */
-import type { AgentResponse, WorkflowState } from '../models/types.js';
+import type { StreamEvent } from '../claude/types.js';
 /** Session log entry */
 export interface SessionLog {
     task: string;
@@ -14,12 +14,82 @@ export interface SessionLog {
     history: Array<{
         step: string;
         agent: string;
+        instruction: string;
         status: string;
         timestamp: string;
         content: string;
         error?: string;
+        /** Matched rule index (0-based) when rules-based detection was used */
+        matchedRuleIndex?: number;
+        /** How the rule match was detected */
+        matchedRuleMethod?: string;
     }>;
 }
+/** NDJSON record: workflow started */
+export interface NdjsonWorkflowStart {
+    type: 'workflow_start';
+    task: string;
+    workflowName: string;
+    startTime: string;
+}
+/** NDJSON record: step started */
+export interface NdjsonStepStart {
+    type: 'step_start';
+    step: string;
+    agent: string;
+    iteration: number;
+    timestamp: string;
+}
+/** NDJSON record: streaming chunk received */
+export interface NdjsonStream {
+    type: 'stream';
+    step: string;
+    event: StreamEvent;
+    timestamp: string;
+}
+/** NDJSON record: step completed */
+export interface NdjsonStepComplete {
+    type: 'step_complete';
+    step: string;
+    agent: string;
+    status: string;
+    content: string;
+    instruction: string;
+    matchedRuleIndex?: number;
+    matchedRuleMethod?: string;
+    error?: string;
+    timestamp: string;
+}
+/** NDJSON record: workflow completed successfully */
+export interface NdjsonWorkflowComplete {
+    type: 'workflow_complete';
+    iterations: number;
+    endTime: string;
+}
+/** NDJSON record: workflow aborted */
+export interface NdjsonWorkflowAbort {
+    type: 'workflow_abort';
+    iterations: number;
+    reason: string;
+    endTime: string;
+}
+/** Union of all NDJSON record types */
+export type NdjsonRecord = NdjsonWorkflowStart | NdjsonStepStart | NdjsonStream | NdjsonStepComplete | NdjsonWorkflowComplete | NdjsonWorkflowAbort;
+/**
+ * Append a single NDJSON line to a log file.
+ * Uses appendFileSync for atomic open→write→close (no file lock held).
+ */
+export declare function appendNdjsonLine(filepath: string, record: NdjsonRecord): void;
+/**
+ * Initialize an NDJSON log file with the workflow_start record.
+ * Creates the logs directory if needed and returns the file path.
+ */
+export declare function initNdjsonLog(sessionId: string, task: string, workflowName: string, projectDir?: string): string;
+/**
+ * Load an NDJSON log file and convert it to a SessionLog for backward compatibility.
+ * Parses each line as a JSON record and reconstructs the SessionLog structure.
+ */
+export declare function loadNdjsonLog(filepath: string): SessionLog | null;
 /** Generate a session ID */
 export declare function generateSessionId(): string;
 /**
@@ -29,13 +99,9 @@ export declare function generateSessionId(): string;
 export declare function generateReportDir(task: string): string;
 /** Create a new session log */
 export declare function createSessionLog(task: string, projectDir: string, workflowName: string): SessionLog;
-/** Add agent response to session log */
-export declare function addToSessionLog(log: SessionLog, stepName: string, response: AgentResponse): void;
-/** Finalize session log */
-export declare function finalizeSessionLog(log: SessionLog, status: 'completed' | 'aborted'): void;
-/** Save session log to file */
-export declare function saveSessionLog(log: SessionLog, sessionId: string, projectDir?: string): string;
-/** Load session log from file */
+/** Create a finalized copy of a session log (immutable — does not modify the original) */
+export declare function finalizeSessionLog(log: SessionLog, status: 'completed' | 'aborted'): SessionLog;
+/** Load session log from file (supports both .json and .jsonl formats) */
 export declare function loadSessionLog(filepath: string): SessionLog | null;
 /** Load project context (CLAUDE.md files) */
 export declare function loadProjectContext(projectDir: string): string;
@@ -58,6 +124,4 @@ export interface LatestLogPointer {
 export declare function updateLatestPointer(log: SessionLog, sessionId: string, projectDir?: string, options?: {
     copyToPrevious?: boolean;
 }): void;
-/** Convert workflow state to session log */
-export declare function workflowStateToSessionLog(state: WorkflowState, task: string, projectDir: string): SessionLog;
 //# sourceMappingURL=session.d.ts.map

package/dist/utils/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/utils/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGvE,wBAAwB;AACxB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5C,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,4BAA4B;AAC5B,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBtD;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,UAAU,CAUZ;AAED,wCAAwC;AACxC,wBAAgB,eAAe,CAC7B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,aAAa,GACtB,IAAI,CAUN;AAED,2BAA2B;AAC3B,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,IAAI,CAGN;AAED,+BAA+B;AAC/B,wBAAgB,cAAc,CAC5B,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAWR;AAED,iCAAiC;AACjC,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAMlE;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAgB7D;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC,IAAI,CA0BN;AAED,4CAA4C;AAC5C,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,UAAU,CAsBZ"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/utils/session.ts"],"names":[],"mappings":"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"}