@metagptx/deepflow-cli 0.1.0 → 0.1.1

package/README.md

@@ -70,7 +70,7 @@ npm run smoke
 npm run pack:dry-run
 ```
 
-Run the full Web/Core-backed smoke when a token and app are available:
+Run the full Web-backed smoke when a token and app are available:
 
 ```bash
 DEEPFLOW_CLI_E2E_TOKEN=<dfpat_token> \

package/docs/cli-design.md

@@ -2,7 +2,7 @@
 
 ## 背景
 
-DeepFlow 需要提供一种面向外部系统的调用方式，但外部调用方不应直接耦合 Web/Core 的 HTTP API 细节。CLI 作为稳定入口，对外暴露“方法”语义：调用方执行 `deepflow <method>`，CLI 负责读取配置、鉴权、请求 DeepFlow Web API、处理响应和输出结构化结果。
+DeepFlow 需要提供一种面向外部系统的调用方式，但外部调用方不应直接耦合 Web API 细节或 Core 内部标识。CLI 作为稳定入口，对外暴露“方法”语义：调用方执行 `deepflow <method>`，CLI 负责读取配置、鉴权、请求 DeepFlow Web API、处理响应和输出结构化结果。
 
 首版目标是支持外部创建一个迭代并启动 Plan，后续再逐步扩展查询、停止、继续执行、获取结果等能力。
 
@@ -204,13 +204,12 @@ deepflow plan run --repo <repo_id_or_app_code> --name "Demo Iteration" --context
   "ok": true,
   "method": "plan.run",
   "iterationId": "local-iteration-id",
-  "backendIterationId": "backend-iteration-id",
   "planSessionId": "session-id",
   "runId": "run-id",
-  "uiUrl": "http://localhost:3100/iterations/backend-iteration-id/plan?sessionId=session-id",
+  "uiUrl": "http://localhost:3100/iterations/local-iteration-id/plan?sessionId=session-id",
   "statusUrl": "http://localhost:3100/api/local/sessions/session-id?iterationId=local-iteration-id",
-  "messagesUrl": "http://localhost:3100/api/sessions/session-id/messages?iteration_id=backend-iteration-id",
-  "stopUrl": "http://localhost:3100/api/sessions/session-id/stop?iteration_id=backend-iteration-id"
+  "messagesUrl": "http://localhost:3100/api/local/sessions/session-id/messages?iterationId=local-iteration-id",
+  "stopUrl": "http://localhost:3100/api/local/sessions/session-id/stop?iterationId=local-iteration-id"
 }
 ```
 
@@ -355,7 +354,7 @@ DeepFlowCli/
    - 统一错误转换
 5. 实现 `deepflow plan run`，返回 `statusUrl` / `messagesUrl` / `stopUrl`。
 6. 增加 `--json` 输出和退出码。
-7. 补单元测试、本地 smoke 和可选 Web/Core e2e smoke。
+7. 补单元测试、本地 smoke 和可选 Web e2e smoke。
 
 ## 待确认问题
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metagptx/deepflow-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Command line interface for DeepFlow external automation.",
   "license": "UNLICENSED",
   "type": "module",

package/src/args.js

@@ -4,7 +4,6 @@ const VALUE_FLAGS = new Set([
   "base-url",
   "baseUrl",
   "base-branch",
-  "backend-iteration",
   "context",
   "context-file",
   "fast-timeout",
@@ -45,7 +44,6 @@ const LONG_ALIASES = new Map([
   ["--base-url", "base-url"],
   ["--baseUrl", "baseUrl"],
   ["--base-branch", "base-branch"],
-  ["--backend-iteration", "backend-iteration"],
   ["--context", "context"],
   ["--context-file", "context-file"],
   ["--fast-timeout", "fast-timeout"],

package/src/cli.js

@@ -42,8 +42,8 @@ Usage:
   deepflow apps list [--json]
   deepflow plan run --repo <repo_id_or_app_code> [--name <name>] [--context <text>] [--prompt <text>] [--json]
   deepflow plan status --iteration <local_iteration_id> --session <session_id> [--json]
-  deepflow session messages --backend-iteration <backend_iteration_id> --session <session_id> [--json]
-  deepflow session stop --backend-iteration <backend_iteration_id> --session <session_id> [--json]
+  deepflow session messages --iteration <local_iteration_id> --session <session_id> [--json]
+  deepflow session stop --iteration <local_iteration_id> --session <session_id> [--json]
 
 Global options:
   --base-url <url>       DeepFlow Web URL. Default: http://localhost:3100
@@ -154,15 +154,13 @@ function buildRepoBranches(repoRef, flags) {
 }
 
 function buildUiUrl(baseUrl, iteration, sessionId) {
-  const routeId = iteration.backendIterationId || iteration.id;
-  const path = `/iterations/${encodeURIComponent(routeId)}/plan?sessionId=${encodeURIComponent(sessionId)}`;
+  const path = `/iterations/${encodeURIComponent(iteration.id)}/plan?sessionId=${encodeURIComponent(sessionId)}`;
 
   return new URL(path, baseUrl).toString();
 }
 
 function buildSessionLinks(baseUrl, {
   localIterationId,
-  backendIterationId,
   sessionId,
 }) {
   return {
@@ -171,11 +169,11 @@ function buildSessionLinks(baseUrl, {
       sessionId,
     }),
     messagesUrl: buildSessionMessagesUrl(baseUrl, {
-      backendIterationId,
+      localIterationId,
       sessionId,
     }),
     stopUrl: buildSessionStopUrl(baseUrl, {
-      backendIterationId,
+      localIterationId,
       sessionId,
     }),
   };
@@ -350,7 +348,6 @@ async function runPlanRun(flags, env) {
   });
   const links = buildSessionLinks(reachableBaseUrl, {
     localIterationId: iteration.id,
-    backendIterationId: iteration.backendIterationId,
     sessionId: session.session_id,
   });
 
@@ -359,7 +356,6 @@ async function runPlanRun(flags, env) {
     method: "plan.run",
     baseUrl: reachableBaseUrl,
     iterationId: iteration.id,
-    backendIterationId: iteration.backendIterationId,
     iterationName: iteration.name,
     repoId,
     planSessionId: session.session_id,
@@ -395,21 +391,14 @@ async function runPlanStatus(flags, env) {
 
 async function runSessionMessages(flags, env) {
   const sessionId = requireOption(flags, "session", "--session <session_id> is required.");
-  const backendIterationId = flags.backendIteration || flags.iteration;
-
-  if (!backendIterationId) {
-    throw new CliError("--backend-iteration <backend_iteration_id> is required.", {
-      code: "missing_argument",
-      exitCode: 2,
-    });
-  }
+  const localIterationId = requireOption(flags, "iteration", "--iteration <local_iteration_id> is required.");
 
   const runtimeConfig = await resolveRuntimeConfig(flags, env);
   requireToken(runtimeConfig.token);
   const client = makeClient(runtimeConfig, flags);
   const reachableBaseUrl = await resolveReachableBaseUrl(client);
   const messages = await client.listMessages({
-    backendIterationId,
+    localIterationId,
     sessionId,
   });
 
@@ -417,7 +406,7 @@ async function runSessionMessages(flags, env) {
     ok: true,
     method: "session.messages",
     baseUrl: reachableBaseUrl,
-    backendIterationId,
+    iterationId: localIterationId,
     sessionId,
     messages,
   };
@@ -425,21 +414,14 @@ async function runSessionMessages(flags, env) {
 
 async function runSessionStop(flags, env) {
   const sessionId = requireOption(flags, "session", "--session <session_id> is required.");
-  const backendIterationId = flags.backendIteration || flags.iteration;
-
-  if (!backendIterationId) {
-    throw new CliError("--backend-iteration <backend_iteration_id> is required.", {
-      code: "missing_argument",
-      exitCode: 2,
-    });
-  }
+  const localIterationId = requireOption(flags, "iteration", "--iteration <local_iteration_id> is required.");
 
   const runtimeConfig = await resolveRuntimeConfig(flags, env);
   requireToken(runtimeConfig.token);
   const client = makeClient(runtimeConfig, flags);
   const reachableBaseUrl = await resolveReachableBaseUrl(client);
   const response = await client.stopSession({
-    backendIterationId,
+    localIterationId,
     sessionId,
   });
 
@@ -447,7 +429,7 @@ async function runSessionStop(flags, env) {
     ok: true,
     method: "session.stop",
     baseUrl: reachableBaseUrl,
-    backendIterationId,
+    iterationId: localIterationId,
     sessionId,
     response,
   };

package/src/client.js

@@ -216,11 +216,11 @@ export class DeepFlowClient {
   }
 
   async listMessages({
-    backendIterationId,
+    localIterationId,
     sessionId,
   }) {
     return this.request(
-      `/api/sessions/${encodeURIComponent(sessionId)}/messages?iteration_id=${encodeURIComponent(backendIterationId)}`,
+      `/api/local/sessions/${encodeURIComponent(sessionId)}/messages?iterationId=${encodeURIComponent(localIterationId)}`,
       {
         timeoutMs: this.fastTimeoutMs,
         auditMethod: "session.messages",
@@ -229,11 +229,11 @@ export class DeepFlowClient {
   }
 
   async stopSession({
-    backendIterationId,
+    localIterationId,
     sessionId,
   }) {
     return this.request(
-      `/api/sessions/${encodeURIComponent(sessionId)}/stop?iteration_id=${encodeURIComponent(backendIterationId)}`,
+      `/api/local/sessions/${encodeURIComponent(sessionId)}/stop?iterationId=${encodeURIComponent(localIterationId)}`,
       {
         method: "POST",
         timeoutMs: this.fastTimeoutMs,
@@ -254,21 +254,21 @@ export function buildPlanStatusUrl(baseUrl, {
 }
 
 export function buildSessionMessagesUrl(baseUrl, {
-  backendIterationId,
+  localIterationId,
   sessionId,
 }) {
   return new URL(
-    `/api/sessions/${encodeURIComponent(sessionId)}/messages?iteration_id=${encodeURIComponent(backendIterationId)}`,
+    `/api/local/sessions/${encodeURIComponent(sessionId)}/messages?iterationId=${encodeURIComponent(localIterationId)}`,
     baseUrl,
   ).toString();
 }
 
 export function buildSessionStopUrl(baseUrl, {
-  backendIterationId,
+  localIterationId,
   sessionId,
 }) {
   return new URL(
-    `/api/sessions/${encodeURIComponent(sessionId)}/stop?iteration_id=${encodeURIComponent(backendIterationId)}`,
+    `/api/local/sessions/${encodeURIComponent(sessionId)}/stop?iterationId=${encodeURIComponent(localIterationId)}`,
     baseUrl,
   ).toString();
 }

package/src/output.js

@@ -40,7 +40,6 @@ export function writeResult(io, result, { json = false } = {}) {
     case "plan.run":
       io.stdout.write("Plan run started.\n");
       io.stdout.write(`Iteration: ${result.iterationId}\n`);
-      io.stdout.write(`Backend iteration: ${result.backendIterationId}\n`);
       io.stdout.write(`Plan session: ${result.planSessionId}\n`);
       if (result.runId) {
         io.stdout.write(`Run: ${result.runId}\n`);