kenaz 0.3.1 → 0.3.3

package/core/k-cli/dist/specialist/run.js

@@ -0,0 +1,93 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const path = __importStar(require("path"));
+const project_1 = require("../core/project");
+const process_1 = require("../core/process");
+const spawn_1 = require("../core/spawn");
+const output_1 = require("../core/output");
+async function run(userPrompt, opts = {}) {
+    const project = (0, project_1.resolveProject)(opts.projectPath);
+    const corePath = project.core_path;
+    if (!opts.agent) {
+        console.error("Error: --agent <name> is required");
+        process.exit(1);
+    }
+    const sessionJs = path.join(corePath, ".specialist", "tools", "session.js");
+    // Assemble prompt
+    let prompt;
+    try {
+        prompt = await (0, process_1.nodeProcess)([sessionJs, "prompt", opts.agent, "--mode=assembled", "--no-muninn"], corePath, 15000);
+    }
+    catch (e) {
+        console.error(`Error: Failed to assemble prompt for ${opts.agent}:`, e.message);
+        process.exit(1);
+    }
+    const headlessNotice = "\n\n[k-cli headless 模式] 你正在被 k-cli 以非互動方式呼叫。不要詢問用戶問題、不要等待確認。直接執行任務，遇到錯誤直接輸出錯誤訊息並結束。";
+    const fullPrompt = userPrompt
+        ? `${prompt}${headlessNotice}\n\n${userPrompt}`
+        : `${prompt}${headlessNotice}`;
+    if (opts.dryRun) {
+        const dryResult = {
+            dryRun: true,
+            agent: opts.agent,
+            promptLength: fullPrompt.length,
+            promptPreview: fullPrompt.slice(0, 500).replace(/\n/g, " "),
+            projectPath: project.path,
+        };
+        if (opts.json) {
+            (0, output_1.output)(dryResult, { json: true });
+        }
+        else {
+            console.log(`\n[dry-run] specialist run --agent ${opts.agent}`);
+            console.log(`  Prompt length: ${fullPrompt.length.toLocaleString()} chars`);
+            console.log(`  User prompt: ${userPrompt || "(none)"}`);
+            console.log("  Would spawn Claude (not executed)");
+        }
+        return;
+    }
+    // Execute via spawnClaude
+    console.log(`Starting ${opts.agent}...`);
+    console.log(`  Prompt: ${fullPrompt.length.toLocaleString()} chars`);
+    if (userPrompt)
+        console.log(`  User prompt: ${userPrompt}`);
+    const child = (0, spawn_1.spawnClaude)({
+        prompt: fullPrompt,
+        cwd: corePath,
+        projectPath: project.mode === "sub-project" ? project.path : null,
+    });
+    return (0, spawn_1.streamClaudeOutput)(child);
+}

package/core/k-cli/dist/task/create.js

@@ -0,0 +1,194 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const path = __importStar(require("path"));
+const project_1 = require("../core/project");
+const process_1 = require("../core/process");
+const spawn_1 = require("../core/spawn");
+const output_1 = require("../core/output");
+async function run(prompt, opts = {}) {
+    if (!prompt) {
+        console.error("Usage: k-cli task create <描述你要建立的任務>");
+        console.error("Example: k-cli task create 幫我創建 hello_world.js 輸出 Hello World");
+        process.exit(1);
+    }
+    const project = (0, project_1.resolveProject)(opts.projectPath);
+    const corePath = project.core_path;
+    const sessionJs = path.join(corePath, ".specialist", "tools", "session.js");
+    const taskApiPath = path.join(corePath, ".collaboration", "core", "task-api.js");
+    const projectPathFlag = project.mode === "sub-project" ? ` --project-path "${project.path}"` : "";
+    // Assemble both prompts upfront (avoid nested CLI spawn)
+    let ansuzPrompt;
+    let ameliaPrompt;
+    try {
+        [ansuzPrompt, ameliaPrompt] = await Promise.all([
+            (0, process_1.nodeProcess)([sessionJs, "prompt", "Ansuz", "--mode=assembled", "--no-muninn"], corePath, 15000),
+            (0, process_1.nodeProcess)([sessionJs, "prompt", "Amelia", "--mode=assembled", "--no-muninn"], corePath, 15000),
+        ]);
+    }
+    catch (e) {
+        console.error("Error: Failed to assemble prompts:", e.message);
+        process.exit(1);
+    }
+    const taskCreateInstruction = `
+[k-cli task create — 快速任務建立模式]
+
+你正在被 k-cli 以非互動方式呼叫。不要詢問用戶問題、不要等待確認。直接執行，遇到錯誤直接輸出錯誤訊息並結束。
+
+## 你的任務
+
+根據以下用戶描述，建立一個高品質任務：
+「${prompt}」
+
+## 執行步驟（必須依序完成）
+
+### Step 1: 分析需求
+- 理解用戶描述的核心目標
+- 確定需求類型（新功能/Bug/優化/重構）
+- 搜尋相關代碼，確認影響範圍
+
+### Step 2: 整理任務內容
+將分析結果整理為結構化的任務草稿（尚不建立）：
+- title: 簡潔明確，一看就懂要做什麼
+- description: 包含背景、目標、預期行為
+- priority: P0/P1/P2/P3
+- scope_paths: 必須具體到目錄層級（不可留空）
+- requirements: 每條需求獨立、可執行（至少 3 條）
+- acceptance_criteria: 每條可測試、可驗證（至少 3 條，不可寫模糊描述如「功能正常」）
+- tags: code/doc/plan/fix/refactor/test/design/review
+- complexity: simple/medium/complex
+- rigor: high/medium/low
+- estimated_hours: 預估工時
+
+### Step 3: 呼叫 Amelia 審查 + 取得 Role
+
+**重要：不要用 Bash tool 呼叫 CLI。使用 Agent tool 開 subagent 來執行 Amelia 審查。**
+
+使用 Agent tool，prompt 內容如下（將任務草稿內容填入）：
+
+\`\`\`
+${ameliaPrompt}
+
+[k-cli task create — 任務審查模式]
+
+你正在被 k-cli 以非互動方式呼叫。不要詢問用戶問題、不要等待確認。
+
+請審查以下任務草稿並提供建議，然後判斷最適合的 Formation role。
+
+**重要：你必須根據你的 capability.yaml 中定義的 available_roles 來判斷 role。**
+先讀取 ${corePath}/.specialist/Amelia/capability.yaml 的 role_assignment.available_roles 段落，
+了解每個 role 的 identity、strengths、best_for、not_for，然後依據 decision_flow 做出判斷。
+
+任務草稿：
+（將你的任務草稿 JSON 貼在這裡）
+
+審查要點：
+1. title 是否簡潔明確？
+2. requirements 是否每條獨立、可執行？（至少 3 條）
+3. acceptance_criteria 是否每條可測試、可驗證？（至少 3 條）
+4. scope_paths 是否具體到目錄層級？
+5. 根據 available_roles 判斷最適合的 Formation role（必須說明判斷理由）
+
+回覆格式：
+ROLE: <role名稱>
+ROLE_REASON: <為什麼選這個 role — 程式碼跑在哪裡、哪個 agent 的 strengths 最匹配>
+SUGGESTIONS: <建議內容>
+如有修正建議，直接列出修正後的欄位值。
+\`\`\`
+
+讀取 Amelia subagent 的回覆，採納合理的建議修正任務內容，並取得 role。
+如果 Amelia 無回覆或錯誤，禁止降級 — 直接報錯並結束。
+
+### Step 4: 建立高品質任務
+將 Amelia 審查後的最終版本寫入任務系統：
+
+\`\`\`bash
+node "${taskApiPath}"${projectPathFlag} create \\
+  --title "最終標題" \\
+  --description "最終描述" \\
+  --priority P1 \\
+  --role [Amelia判斷的role] \\
+  --rigor medium \\
+  --complexity medium \\
+  --tags code \\
+  --scope-paths "具體路徑" \\
+  --requirements "需求1" --requirements "需求2" --requirements "需求3" \\
+  --acceptance-criteria "驗收標準1" --acceptance-criteria "標準2" --acceptance-criteria "標準3" \\
+  --estimated-hours 4
+\`\`\`
+
+### Step 5: 輸出結果
+輸出建立的任務摘要：任務 ID、標題、role（Amelia 判斷）、priority、scope_paths。
+如果 Amelia 有提出建議且已採納，簡要說明修正了什麼。
+
+## 專案資訊
+- 專案路徑：${project.path}
+- Core 路徑：${corePath}
+- 模式：${project.mode}
+`;
+    // Non-interactive override MUST come before Ansuz prompt to override mandatory stops
+    const fullPrompt = `${taskCreateInstruction}\n\n--- Ansuz Knowledge Base (reference only, do NOT follow its interactive workflow) ---\n${ansuzPrompt}`;
+    if (opts.dryRun) {
+        const dryResult = {
+            dryRun: true,
+            action: "task create",
+            prompt,
+            promptLength: fullPrompt.length,
+            projectPath: project.path,
+        };
+        if (opts.json) {
+            (0, output_1.output)(dryResult, { json: true });
+        }
+        else {
+            console.log("\n[dry-run] task create");
+            console.log(`  Prompt: ${prompt}`);
+            console.log(`  Ansuz prompt: ${ansuzPrompt.length.toLocaleString()} chars`);
+            console.log(`  Amelia prompt (embedded): ${ameliaPrompt.length.toLocaleString()} chars`);
+            console.log("  Would spawn Ansuz with Agent tool (Amelia as subagent)");
+        }
+        return;
+    }
+    console.log(`Creating task via Ansuz...`);
+    console.log(`  ${prompt} ${project.path}`);
+    const child = (0, spawn_1.spawnClaude)({
+        prompt: fullPrompt,
+        cwd: corePath,
+        allowedTools: "Bash,Read,Edit,Write,Glob,Grep,Agent",
+        disallowedTools: "AskUserQuestion,TodoWrite",
+        projectPath: project.mode === "sub-project" ? project.path : null,
+    });
+    return (0, spawn_1.streamClaudeOutput)(child);
+}

package/core/k-cli/dist/task/delete.js

@@ -0,0 +1,98 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const project_1 = require("../core/project");
+const output_1 = require("../core/output");
+const TASK_STATUSES = ["backlog", "active", "done", "blocked", "cancel"];
+function findTaskFile(tasksDir, taskId) {
+    for (const status of TASK_STATUSES) {
+        const dir = path.join(tasksDir, status);
+        if (!fs.existsSync(dir))
+            continue;
+        const files = fs.readdirSync(dir);
+        const match = files.find((f) => f.startsWith(taskId));
+        if (match) {
+            return { filePath: path.join(dir, match), statusDir: status };
+        }
+    }
+    return null;
+}
+async function run(taskId, opts = {}) {
+    if (!taskId) {
+        console.error("Error: task ID is required");
+        process.exit(1);
+    }
+    const project = (0, project_1.resolveProject)(opts.projectPath);
+    const tasksDir = project.mode === "sub-project"
+        ? path.join(project.path, ".kenaz", "tasks")
+        : path.join(project.core_path, ".collaboration", "tasks");
+    if (opts.dryRun) {
+        const found = findTaskFile(tasksDir, taskId);
+        const dryResult = {
+            dryRun: true,
+            action: "task delete",
+            taskId,
+            found: found ? found.statusDir : null,
+            projectPath: project.path,
+        };
+        if (opts.json) {
+            (0, output_1.output)(dryResult, { json: true });
+        }
+        else {
+            console.log("\n[dry-run] task delete");
+            console.log(`  Task: ${taskId}`);
+            if (found) {
+                console.log(`  Found in: ${found.statusDir}/`);
+                console.log(`  File: ${found.filePath}`);
+            }
+            else {
+                console.log("  Task not found");
+            }
+            console.log("  Would delete task (not executed)");
+        }
+        return;
+    }
+    const found = findTaskFile(tasksDir, taskId);
+    if (!found) {
+        console.error(`Error: Task ${taskId} not found`);
+        process.exit(1);
+    }
+    console.log(`Deleting ${taskId} (${found.statusDir})...`);
+    fs.unlinkSync(found.filePath);
+    console.log(`Deleted: ${taskId}`);
+}

package/core/k-cli/dist/task/get.js

@@ -0,0 +1,55 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const path = __importStar(require("path"));
+const project_1 = require("../core/project");
+const process_1 = require("../core/process");
+async function run(taskId, opts = {}) {
+    if (!taskId) {
+        console.error("Error: task ID is required");
+        process.exit(1);
+    }
+    const project = (0, project_1.resolveProject)(opts.projectPath);
+    const taskApiJs = path.join(project.core_path, ".collaboration", "core", "task-api.js");
+    try {
+        const result = await (0, process_1.nodeProcess)([taskApiJs, "--project-path", project.path, "get", taskId], project.core_path, 10000, process.execPath, false);
+        console.log(result);
+    }
+    catch (e) {
+        console.error(`Error: ${e.message}`);
+        process.exit(1);
+    }
+}

package/core/k-cli/dist/task/list.js

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const path = __importStar(require("path"));
+const project_1 = require("../core/project");
+const process_1 = require("../core/process");
+async function run(opts = {}) {
+    const project = (0, project_1.resolveProject)(opts.projectPath);
+    const taskApiJs = path.join(project.core_path, ".collaboration", "core", "task-api.js");
+    const args = [taskApiJs, "--project-path", project.path, "list"];
+    if (opts.status)
+        args.push("--status", opts.status);
+    if (opts.priority)
+        args.push("--priority", opts.priority);
+    if (opts.json)
+        args.push("--format", "json");
+    try {
+        const result = await (0, process_1.nodeProcess)(args, project.core_path, 10000, process.execPath, false);
+        console.log(result);
+    }
+    catch (e) {
+        console.error(`Error: ${e.message}`);
+        process.exit(1);
+    }
+}

package/core/k-cli/dist/task/submit.js

@@ -0,0 +1,156 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const path = __importStar(require("path"));
+const project_1 = require("../core/project");
+const process_1 = require("../core/process");
+const output_1 = require("../core/output");
+/** Remove a flag (and its value token, if given as a separate argv entry) from argv. */
+function stripFlag(argv, flag, takesValue) {
+    const out = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === flag) {
+            if (takesValue && argv[i + 1] !== undefined && !argv[i + 1].startsWith("--"))
+                i++;
+            continue;
+        }
+        if (a.startsWith(flag + "="))
+            continue;
+        out.push(a);
+    }
+    return out;
+}
+function hasFlag(argv, flag) {
+    return argv.some((a) => a === flag || a.startsWith(flag + "="));
+}
+/**
+ * k-cli task submit — minimal project-side task producer (TASK_2147).
+ *
+ * Problem: a sub-project's own process (e.g. an in-app agent) wants to turn
+ * something into a Kenaz task and later read back its outcome, without
+ * duplicating core-resolve.js's logic (core_path token, KENAZ_SOURCE_DIR,
+ * install-dir discovery) just to find task-api.js.
+ *
+ * `submit` is a thin, deterministic passthrough to `task-api.js create`:
+ * - Core resolution is handled by resolveProject() (reads .kenaz/project.yaml,
+ *   written once by `k-cli project initialize`) — the caller never needs
+ *   KENAZ_SOURCE_DIR or to know where KenazAI core lives.
+ * - No LLM call, no Claude CLI dependency, no role/quality analysis — unlike
+ *   `task create`, which spawns a full Ansuz+Amelia session. That heavier
+ *   path stays for human/interactive use; `submit` is for callers that
+ *   already know their task fields and just need the plumbing.
+ * - Every task gets an origin tag (task.source) so it's auditable, and is
+ *   always written to backlog via the normal createTask() quality gate —
+ *   never auto-dispatched.
+ *
+ * Deliberately NOT an HTTP server: the caller is a local process that can
+ * already spawn `node`/`k-cli`; a server would add a port, a lifecycle and
+ * an auth surface for no new capability a single sub-project consumer needs.
+ */
+async function run(rawArgs, opts = {}) {
+    const project = (0, project_1.resolveProject)(opts.projectPath);
+    const taskApiJs = path.join(project.core_path, ".collaboration", "core", "task-api.js");
+    // --project-path/--json/--dry-run are k-cli-level flags already consumed
+    // into `opts` by index.ts; don't forward them verbatim to task-api.js.
+    let forwarded = stripFlag(rawArgs, "--project-path", true);
+    forwarded = stripFlag(forwarded, "--json", false);
+    forwarded = stripFlag(forwarded, "--dry-run", false);
+    const hasOrigin = hasFlag(forwarded, "--source") || hasFlag(forwarded, "--origin");
+    const origin = project.mode === "sub-project" ? project.name : "core";
+    const sourceArgs = hasOrigin ? [] : ["--source", origin];
+    const args = [
+        taskApiJs,
+        "--project-path",
+        project.path,
+        "create",
+        ...sourceArgs,
+        ...forwarded,
+    ];
+    if (opts.dryRun) {
+        const dryResult = {
+            dryRun: true,
+            action: "task submit",
+            projectPath: project.path,
+            projectMode: project.mode,
+            corePath: project.core_path,
+            origin: hasOrigin ? "(explicit --source/--origin)" : origin,
+            command: `node ${args.join(" ")}`,
+        };
+        if (opts.json) {
+            (0, output_1.output)(dryResult, { json: true });
+        }
+        else {
+            console.log("\n[dry-run] task submit");
+            console.log(`  Project: ${project.path} (${project.mode})`);
+            console.log(`  Core:    ${project.core_path}`);
+            console.log(`  Origin:  ${dryResult.origin}`);
+            console.log(`  Would run: node ${args.join(" ")}`);
+        }
+        return;
+    }
+    let createOut;
+    try {
+        createOut = await (0, process_1.nodeProcess)(args, project.core_path, 20000, process.execPath, false);
+    }
+    catch (e) {
+        if (opts.json) {
+            (0, output_1.output)({ error: e.message }, { json: true });
+        }
+        else {
+            console.error(`Error: ${e.message}`);
+        }
+        process.exit(1);
+    }
+    if (!opts.json) {
+        console.log(createOut);
+        return;
+    }
+    // Anchor on the success line: earlier warnings may mention other task ids.
+    const match = createOut.match(/任務已建立:\s*(TASK_\d+)/);
+    const taskId = match ? match[1] : null;
+    if (!taskId) {
+        (0, output_1.output)({ error: "could not parse task id from task-api.js output", raw: createOut }, { json: true });
+        process.exit(1);
+    }
+    try {
+        const getOut = await (0, process_1.nodeProcess)([taskApiJs, "--project-path", project.path, "get", taskId], project.core_path, 10000, process.execPath, false);
+        (0, output_1.output)(JSON.parse(getOut), { json: true });
+    }
+    catch (e) {
+        (0, output_1.output)({ id: taskId, warning: `created but read-back failed: ${e.message}` }, { json: true });
+    }
+}