lee-spec-kit 0.6.26 → 0.6.27

package/README.en.md

@@ -365,11 +365,12 @@ npx lee-spec-kit flow F004 --request "promote issue 004 to F004 and proceed" --a
 npx lee-spec-kit flow F004 --request "promote issue 004 to F004 and proceed"
 
 # long-running auto: create checkpoint + resume
-npx lee-spec-kit flow F004 --auto-until-category pr_create,code_review,pr_status_update --start-auto --json
-npx lee-spec-kit flow --resume <RUN_ID> --json
+npx lee-spec-kit flow F004 --auto-until-category pr_create,code_review,pr_status_update --start-auto --json-compact
+npx lee-spec-kit flow --resume <RUN_ID> --json-compact
 
 # JSON output for automation
 npx lee-spec-kit flow --json
+npx lee-spec-kit flow --json-compact
 
 # strict checks (optional)
 npx lee-spec-kit flow --strict
@@ -380,6 +381,7 @@ npx lee-spec-kit flow --strict
 | Option            | Description |
 | ----------------- | ----------- |
 | `--json`          | JSON output for agents |
+| `--json-compact`  | Compact JSON output for agents (implies `--json`, reduced duplication) |
 | `--component <id>`| Select target component in multi mode (e.g. `app`, `api`, `worker`) |
 | `--all`           | Include completed features when auto-detecting |
 | `--done`          | Show completed (workflow-done) features only |
@@ -408,9 +410,9 @@ Auto gate mode rules:
 - With `--start-auto`, JSON also includes `autoRun.run` (`runId`, `status`, `resumeCommand`).
 
 Agent resume rules (recommended):
-- When `flow --json` returns `autoRun.enabled=true`, resume with `autoRun.resume.flowCommand` after interruption/compression.
+- When `flow --json-compact` (or `flow --json`) returns `autoRun.enabled=true`, resume with `autoRun.resume.flowCommand` after interruption/compression.
 - If you need a fresh checkpoint before resuming, run `autoRun.resume.contextCommand` first.
-- If `context --json` returns `approvalRequest.required=true`, stop immediately and report to the user.
+- If `context --json-compact` (or `context --json`) returns `approvalRequest.required=true`, stop immediately and report to the user.
 - When `--start-auto` is used, prefer `autoRun.run.resumeCommand` (`flow --resume <runId>`) as the first resume path.
 
 ### GitHub helpers

package/README.md

@@ -384,11 +384,12 @@ npx lee-spec-kit flow F004 --request "issue 004를 F004로 승격시켜서 진
 npx lee-spec-kit flow F004 --request "issue 004를 F004로 승격시켜서 진행해"
 
 # 장시간 자동 진행: run 체크포인트 생성 + 재개
-npx lee-spec-kit flow F004 --auto-until-category pr_create,code_review,pr_status_update --start-auto --json
-npx lee-spec-kit flow --resume <RUN_ID> --json
+npx lee-spec-kit flow F004 --auto-until-category pr_create,code_review,pr_status_update --start-auto --json-compact
+npx lee-spec-kit flow --resume <RUN_ID> --json-compact
 
 # 에이전트 파이프라인용 JSON
 npx lee-spec-kit flow --json
+npx lee-spec-kit flow --json-compact
 
 # 엄격 검사(선택)
 npx lee-spec-kit flow --strict
@@ -399,6 +400,7 @@ npx lee-spec-kit flow --strict
 | 옵션               | 설명 |
 | ------------------ | ---- |
 | `--json`           | 에이전트용 JSON 출력 |
+| `--json-compact`   | 에이전트용 압축 JSON 출력 (`--json` 포함, 중복 필드 최소화) |
 | `--component <id>` | multi에서 대상 컴포넌트 지정 (예: `app`, `api`, `worker`) |
 | `--all`            | 자동 감지 실패 시 완료된 Feature까지 포함해서 표시 |
 | `--done`           | 완료(workflow-done) Feature만 표시 |
@@ -427,9 +429,9 @@ npx lee-spec-kit flow --strict
 - `--start-auto`를 사용하면 JSON `autoRun.run`에 `runId`, `status`, `resumeCommand`가 포함됩니다.
 
 에이전트 재개 규칙(권장):
-- `flow --json` 결과에 `autoRun.enabled=true`가 있으면, 중단/압축 후에도 `autoRun.resume.flowCommand`를 그대로 재실행해 이어갑니다.
+- `flow --json-compact`(또는 `flow --json`) 결과에 `autoRun.enabled=true`가 있으면, 중단/압축 후에도 `autoRun.resume.flowCommand`를 그대로 재실행해 이어갑니다.
 - 재개 전 현재 지점 확인이 필요하면 `autoRun.resume.contextCommand`를 먼저 실행합니다.
-- `context --json` 확인 결과 `approvalRequest.required=true`면 즉시 멈추고 사용자에게 보고합니다.
+- `context --json-compact`(또는 `context --json`) 확인 결과 `approvalRequest.required=true`면 즉시 멈추고 사용자에게 보고합니다.
 - `--start-auto`를 사용하는 경우에는 `autoRun.run.resumeCommand`(`flow --resume <runId>`)를 우선 재개 경로로 사용합니다.
 
 ### GitHub helper

package/dist/index.js

@@ -7125,7 +7125,7 @@ function buildAgentOrchestrationPolicy(actionOptions, autoRunAvailable) {
     resumePriority: [
       "flow --resume <RUN_ID>",
       "autoRun.resume.flowCommand",
-      "context --json"
+      "context --json-compact"
     ]
   };
 }
@@ -9530,6 +9530,108 @@ function buildAgentOrchestrationPolicy2(autoRun) {
     preferredResumeCommand
   };
 }
+function getFeatureRef2(feature) {
+  return feature.folderName;
+}
+function toCompactFlowFeature(feature) {
+  if (!feature) return null;
+  return {
+    ref: getFeatureRef2(feature),
+    id: feature.id,
+    slug: feature.slug,
+    type: feature.type,
+    issueNumber: feature.issueNumber,
+    specStatus: feature.specStatus,
+    planStatus: feature.planStatus,
+    tasksDocStatus: feature.tasksDocStatus,
+    currentStep: feature.currentStep,
+    completion: {
+      implementationDone: feature.completion.implementationDone,
+      workflowDone: feature.completion.workflowDone
+    },
+    tasks: feature.tasks,
+    completionChecklist: feature.completionChecklist,
+    warnings: feature.warnings
+  };
+}
+function toCompactFlowActionOption(option) {
+  const base = {
+    label: option.label,
+    summary: option.summary,
+    detail: option.detail,
+    approvalPrompt: option.approvalPrompt,
+    requiresRequestText: option.requiresRequestText,
+    replyExample: option.replyExample,
+    actionType: option.action.type,
+    category: option.action.category,
+    operationType: option.action.operationType,
+    requiresUserCheck: !!option.action.requiresUserCheck
+  };
+  if (option.action.type === "command") {
+    base.scope = option.action.scope;
+    base.cwd = option.action.cwd;
+    base.cmd = option.action.cmd;
+    return base;
+  }
+  base.message = option.action.message;
+  return base;
+}
+function toCompactFlowContextSnapshot(state) {
+  const primaryAction = state.actionOptions[0] ?? null;
+  return {
+    status: state.status,
+    reasonCode: toReasonCode(state.status),
+    selectionMode: state.selectionMode,
+    selectionFallback: state.selectionFallback,
+    branches: state.branches,
+    warnings: state.warnings,
+    contextVersion: state.contextVersion,
+    matchedFeature: toCompactFlowFeature(state.matchedFeature),
+    candidateRefs: state.targetFeatures.length > 1 ? state.targetFeatures.map((feature) => getFeatureRef2(feature)) : [],
+    completedCandidateRefs: state.selectionMode === "open" ? state.doneFeatures.map((feature) => getFeatureRef2(feature)) : [],
+    openCandidateRefs: state.selectionMode === "open" ? state.openFeatures.map((feature) => getFeatureRef2(feature)) : [],
+    inProgressCandidateRefs: state.selectionMode === "open" ? state.inProgressFeatures.map((feature) => getFeatureRef2(feature)) : [],
+    readyToCloseCandidateRefs: state.selectionMode === "open" ? state.readyToCloseFeatures.map((feature) => getFeatureRef2(feature)) : [],
+    actionOptions: state.actionOptions.map(
+      (option) => toCompactFlowActionOption(option)
+    ),
+    primaryActionLabel: primaryAction?.label ?? null,
+    primaryActionType: primaryAction?.action.type ?? null,
+    primaryActionCategory: primaryAction?.action.category ?? null,
+    primaryActionOperationType: primaryAction?.action.operationType ?? null
+  };
+}
+function toCompactAutoRun(autoRun) {
+  if (!autoRun) return null;
+  const lastExecution = autoRun.executions.length > 0 ? autoRun.executions[autoRun.executions.length - 1] : null;
+  return {
+    enabled: autoRun.enabled,
+    status: autoRun.status,
+    reasonCode: autoRun.reasonCode,
+    untilCategories: autoRun.untilCategories,
+    request: autoRun.request,
+    preset: autoRun.preset ?? null,
+    source: autoRun.source ?? null,
+    iterations: autoRun.iterations,
+    executionCount: autoRun.executions.length,
+    lastExecution,
+    gate: autoRun.gate ?? null,
+    manual: autoRun.manual ?? null,
+    resume: autoRun.resume,
+    run: autoRun.run ?? null,
+    error: autoRun.error ?? null
+  };
+}
+function toCompactStatusReport(report) {
+  if (!report || typeof report !== "object") return null;
+  const payload = report;
+  return {
+    status: payload.status ?? null,
+    reasonCode: payload.reasonCode ?? null,
+    counts: payload.counts ?? null,
+    recommendation: payload.recommendation ?? null
+  };
+}
 async function runAutoUntilCategory(config, featureName, selectionOptions, untilCategories, requestText, metadata) {
   const contextArgs = ["context", ...buildSelectionArgs(featureName, selectionOptions)];
   const gateSet = new Set(untilCategories);
@@ -9794,7 +9896,10 @@ async function runAutoUntilCategory(config, featureName, selectionOptions, until
   }
 }
 function flowCommand(program2) {
-  program2.command("flow [feature-name]").description("Run combined workflow checks (context + status + doctor)").option("--json", "Output in JSON format for agents").option("--component <component>", "Component name for multi projects").option("--all", "Include completed features when auto-detecting").option("--done", "Show completed (workflow-done) features only").option(
+  program2.command("flow [feature-name]").description("Run combined workflow checks (context + status + doctor)").option("--json", "Output in JSON format for agents").option(
+    "--json-compact",
+    "Output compact JSON for agents (implies --json, reduced duplication)"
+  ).option("--component <component>", "Component name for multi projects").option("--all", "Include completed features when auto-detecting").option("--done", "Show completed (workflow-done) features only").option(
     "--request <text>",
     "Apply a new user request first via user_request_replan when auto mode is enabled"
   ).option(
@@ -9823,7 +9928,7 @@ function flowCommand(program2) {
       const lang = config?.lang ?? DEFAULT_LANG;
       const cliError = toCliError(error);
       const suggestions = getCliErrorSuggestions(cliError.code, lang);
-      if (options.json) {
+      if (options.json || options.jsonCompact) {
         console.log(
           JSON.stringify({
             status: "error",
@@ -10070,12 +10175,38 @@ async function runFlow(featureName, options) {
       );
     }
   }
-  if (options.json) {
+  const jsonMode = !!options.json || !!options.jsonCompact;
+  if (jsonMode) {
     const autoRunFailed = !!(autoRun && isAutoRunFailureStatus(autoRun.status));
     const agentOrchestration2 = buildAgentOrchestrationPolicy2(autoRun);
+    const status = autoRunFailed ? "error" : "ok";
+    const reasonCode = autoRunFailed ? autoRun?.reasonCode || "AUTO_EXECUTION_FAILED" : "FLOW_SUMMARY";
+    if (options.jsonCompact) {
+      const compactPayload = {
+        schema: "flow.v2.compact",
+        status,
+        reasonCode,
+        context: {
+          before: toCompactFlowContextSnapshot(before),
+          after: toCompactFlowContextSnapshot(after)
+        },
+        approval: approvalResult,
+        autoRun: toCompactAutoRun(autoRun),
+        agentOrchestration: agentOrchestration2,
+        statusReport: toCompactStatusReport(statusReport),
+        doctorReport: toCompactStatusReport(doctorReport),
+        strictChecks,
+        suggestion: after.matchedFeature ? `npx lee-spec-kit context ${after.matchedFeature.folderName}${componentHint}` : `npx lee-spec-kit context${componentHint}`
+      };
+      console.log(JSON.stringify(compactPayload, null, 2));
+      if (autoRunFailed) {
+        process.exitCode = 1;
+      }
+      return;
+    }
     const payload = {
-      status: autoRunFailed ? "error" : "ok",
-      reasonCode: autoRunFailed ? autoRun?.reasonCode || "AUTO_EXECUTION_FAILED" : "FLOW_SUMMARY",
+      status,
+      reasonCode,
       context: {
         before: {
           status: before.status,