codekanban 0.18.0 → 0.20.0

package/.dockerignore

@@ -0,0 +1,91 @@
+# Git
+.git
+.gitignore
+.gitattributes
+.github
+
+# Build artifacts
+CodeKanban.exe
+CodeKanban
+test.exe
+bin/
+binary/
+ui/dist/
+
+# Development files
+*.md
+docs/
+
+# Data and config
+data/
+config.yaml
+config.yaml.testbak
+*.db
+*.db-*
+
+# Node modules
+ui/node_modules/
+node_modules/
+
+# Temporary files
+tmp/
+*.tmp
+*.log
+nul
+
+# IDE and editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+*_test.go
+test_*.txt
+
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+build.py
+build-npm.py
+build-npm-multipackage.py
+publish-all-packages.py
+
+# OS files
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# Archives
+*.zip
+*.tar
+*.tar.gz
+*.rar
+
+# Tools and scripts
+tools/
+worktrees/
+recordings/
+
+# NPM packages
+npm-bin/
+npm-packages/
+package.json
+.npmignore
+
+# OpenAPI
+openapi.json
+
+# MCP
+.playwright-mcp/
+.claude/
+
+# Misc
+1.txt
+中文测试.txt
+aicode-kanban.zip
+.goreleaser.yml

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "codekanban",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "An auxiliary programming tool for the AI era, helping you speed up 10x.",
   "bin": {
     "codekanban": "npm-bin/codekanban.js"
   },
   "optionalDependencies": {
-    "@codekanban/win32-x64": "0.18.0",
-    "@codekanban/darwin-x64": "0.18.0",
-    "@codekanban/darwin-arm64": "0.18.0",
-    "@codekanban/linux-x64": "0.18.0",
-    "@codekanban/linux-arm64": "0.18.0"
+    "@codekanban/win32-x64": "0.20.0",
+    "@codekanban/darwin-x64": "0.20.0",
+    "@codekanban/darwin-arm64": "0.20.0",
+    "@codekanban/linux-x64": "0.20.0",
+    "@codekanban/linux-arm64": "0.20.0"
   },
   "keywords": [
     "ai",

package/packages/node-sdk/README.md

@@ -0,0 +1,39 @@
+# `@codekanban/sdk`
+
+Node SDK and CLI for CodeKanban project workflows.
+
+## Features
+
+- Resolve CodeKanban projects by `projectId` or local `path`
+- Auto-create projects for new paths
+- Select the main worktree automatically
+- Launch terminal + agent workflows for `codex` or `claude`
+- Support `standard`, `plan`, and `yolo` Codex profiles
+- Read terminal session lists and AI session summaries
+- Read AI conversations and continue existing terminal sessions
+
+## CLI
+
+```bash
+node packages/node-sdk/bin/codekanban-sdk.js workflow start --base-url http://127.0.0.1:3000 --path D:\repo --profile plan --add-dir D:\shared --prompt "Inspect and plan the refactor"
+node packages/node-sdk/bin/codekanban-sdk.js session list --base-url http://127.0.0.1:3000 --path D:\repo
+node packages/node-sdk/bin/codekanban-sdk.js session conversation --base-url http://127.0.0.1:3000 --id <db-id>
+node packages/node-sdk/bin/codekanban-sdk.js terminal continue --base-url http://127.0.0.1:3000 --session-id <terminal-session-id> --prompt "Continue from the previous plan"
+```
+
+## Library
+
+```js
+import { CodeKanbanClient } from '@codekanban/sdk';
+
+const client = new CodeKanbanClient({ baseURL: 'http://127.0.0.1:3000' });
+
+const result = await client.startWorkflow({
+  path: 'D:/repo',
+  prompt: 'Inspect the repository and produce a plan first.',
+  profile: 'plan',
+  permissions: {
+    addDirs: ['D:/shared'],
+  },
+});
+```

package/packages/node-sdk/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@codekanban/sdk",
+  "version": "0.1.0",
+  "description": "Node SDK and CLI for launching CodeKanban project workflows and reading business sessions.",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./cli": "./src/cli.js"
+  },
+  "bin": {
+    "codekanban-sdk": "./bin/codekanban-sdk.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "keywords": [
+    "codekanban",
+    "sdk",
+    "codex",
+    "terminal",
+    "ai-session",
+    "workflow"
+  ],
+  "author": "fy0",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fy0/CodeKanban"
+  },
+  "homepage": "https://github.com/fy0/CodeKanban#readme"
+}

package/packages/node-sdk/src/cli.js

@@ -0,0 +1,229 @@
+import { CodeKanbanClient } from './client.js';
+import { buildAgentLaunchSpec } from './command-builder.js';
+import { createJsonOutput } from './utils.js';
+
+function readFlagValue(argv, index, flag) {
+  const value = argv[index + 1];
+  if (value == null || value.startsWith('--')) {
+    throw new Error(`${flag} requires a value`);
+  }
+  return value;
+}
+
+function parseCliArgs(argv) {
+  const positionals = [];
+  const flags = {
+    addDirs: [],
+    extraArgs: [],
+    includeTerminal: true,
+    includeAI: true,
+    refresh: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (!token.startsWith('--')) {
+      positionals.push(token);
+      continue;
+    }
+
+    switch (token) {
+      case '--base-url':
+        flags.baseURL = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--project-id':
+        flags.projectId = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--path':
+        flags.path = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--prompt':
+        flags.prompt = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--agent':
+        flags.agent = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--profile':
+        flags.profile = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--sandbox':
+        flags.sandbox = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--approval-policy':
+        flags.approvalPolicy = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--add-dir':
+        flags.addDirs.push(readFlagValue(argv, index, token));
+        index += 1;
+        break;
+      case '--extra-arg':
+        flags.extraArgs.push(readFlagValue(argv, index, token));
+        index += 1;
+        break;
+      case '--title':
+        flags.title = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--working-dir':
+        flags.workingDir = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--task-id':
+        flags.taskId = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--worktree-id':
+        flags.worktreeId = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--session-id':
+        flags.sessionId = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--id':
+        flags.id = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--tool-use-id':
+        flags.toolUseId = readFlagValue(argv, index, token);
+        index += 1;
+        break;
+      case '--refresh':
+        flags.refresh = true;
+        break;
+      case '--no-terminal':
+        flags.includeTerminal = false;
+        break;
+      case '--no-ai':
+        flags.includeAI = false;
+        break;
+      default:
+        throw new Error(`unknown flag: ${token}`);
+    }
+  }
+
+  return {
+    positionals,
+    flags,
+  };
+}
+
+function buildPermissions(flags) {
+  const permissions = {};
+  if (flags.sandbox) {
+    permissions.sandbox = flags.sandbox;
+  }
+  if (flags.approvalPolicy) {
+    permissions.approvalPolicy = flags.approvalPolicy;
+  }
+  if (flags.addDirs.length > 0) {
+    permissions.addDirs = flags.addDirs;
+  }
+  return Object.keys(permissions).length > 0 ? permissions : undefined;
+}
+
+function sanitizeConnection(value) {
+  if (!value || typeof value !== 'object') {
+    return value;
+  }
+  const next = { ...value };
+  delete next.connection;
+  return next;
+}
+
+function printJson(stream, payload) {
+  stream.write(createJsonOutput(payload));
+}
+
+export async function runCli(argv) {
+  try {
+    const { positionals, flags } = parseCliArgs(argv);
+    const [scope, action] = positionals;
+    if (!scope || !action) {
+      throw new Error('usage: <workflow|session|terminal> <action> --base-url <url> [...]');
+    }
+
+    if (scope === 'workflow' && action === 'command') {
+      const result = buildAgentLaunchSpec({
+        agent: flags.agent,
+        profile: flags.profile,
+        permissions: buildPermissions(flags),
+        extraArgs: flags.extraArgs,
+        prompt: flags.prompt || 'Inspect the project and respond.',
+      });
+      printJson(process.stdout, sanitizeConnection(result));
+      return 0;
+    }
+
+    if (!flags.baseURL) {
+      throw new Error('--base-url is required');
+    }
+
+    const client = new CodeKanbanClient({ baseURL: flags.baseURL });
+    let result;
+
+    if (scope === 'workflow' && action === 'start') {
+      result = await client.startWorkflow({
+        projectId: flags.projectId,
+        path: flags.path,
+        worktreeId: flags.worktreeId,
+        prompt: flags.prompt,
+        agent: flags.agent,
+        profile: flags.profile,
+        permissions: buildPermissions(flags),
+        extraArgs: flags.extraArgs,
+        title: flags.title,
+        workingDir: flags.workingDir,
+        taskId: flags.taskId,
+      });
+    } else if (scope === 'session' && action === 'list') {
+      result = await client.listSessions({
+        projectId: flags.projectId,
+        path: flags.path,
+        includeTerminal: flags.includeTerminal,
+        includeAI: flags.includeAI,
+      });
+    } else if (scope === 'session' && action === 'conversation') {
+      result = await client.getAISessionConversation({
+        id: flags.id,
+        sessionId: flags.sessionId,
+        refresh: flags.refresh,
+      });
+    } else if (scope === 'session' && action === 'tool-result') {
+      result = await client.getAISessionToolResult({
+        id: flags.id,
+        sessionId: flags.sessionId,
+        toolUseId: flags.toolUseId,
+      });
+    } else if (scope === 'terminal' && action === 'continue') {
+      result = await client.continueTerminalSession({
+        projectId: flags.projectId,
+        path: flags.path,
+        sessionId: flags.sessionId,
+        prompt: flags.prompt,
+      });
+    } else {
+      throw new Error(`unsupported command: ${scope} ${action}`);
+    }
+
+    printJson(process.stdout, sanitizeConnection(result));
+    return 0;
+  } catch (error) {
+    const payload = {
+      error: {
+        name: error instanceof Error ? error.name : 'Error',
+        message: error instanceof Error ? error.message : String(error),
+      },
+    };
+    printJson(process.stderr, payload);
+    return 1;
+  }
+}