lee-spec-kit 0.5.1 → 0.5.2

package/README.en.md

@@ -203,9 +203,12 @@ npx lee-spec-kit context F001 --approve A --execute --execute-strict
 `--json` output includes:
 
 - `reasonCode`: status reason code (`SINGLE_MATCHED`, `MULTIPLE_ACTIVE_FEATURES`, etc.)
+- `operationType`: action nature (`local` | `remote` | `manual`)
 - `actionOptions`: maps labels to atomic actions plus `summary`/`approvalPrompt` for user-facing label explanation
+- `primaryActionLabel` / `primaryActionType` / `primaryActionCategory` / `primaryActionOperationType`: metadata for the first atomic action
+- `selectionFallback`: fallback used when branch auto-detection does not match (`none` | `open_features` | `all_features` | `done_features`)
 - `workflowPolicy`: current completion policy (`mode`, `requireIssue`, `requireBranch`, `requirePr`, `requireReview`)
-- `checkPolicy`: approval validation policy (`token: "<LABEL>"`, `acceptedTokens`, `tokenPattern`, `validLabels`, `requireExplanationBeforeApproval`, `requiredExplanationFields`, `contextVersion`, ...)
+- `checkPolicy`: approval validation policy (`hint`, `policyOnly`, `token: "<LABEL>"`, `acceptedTokens`, `tokenPattern`, `validLabels`, `requireExplanationBeforeApproval`, `requiredExplanationFields`, `contextVersion`, ...)
 
 Error payloads (`status: "error"`) include `reasonCode` and labeled `suggestions` (`A/B/C`) (e.g. `INVALID_APPROVAL`, `CONTEXT_STALE`, `EXECUTION_FAILED`, `EXECUTION_NOT_COMMAND`).
 

package/README.md

@@ -222,12 +222,15 @@ npx lee-spec-kit context F001 --approve A --execute --execute-strict
 - `reasonCode`: 상태 이유 코드 (`SINGLE_MATCHED`, `MULTIPLE_ACTIVE_FEATURES` 등)
 - `type: "command"`: `scope`(project|docs), `cwd`, `cmd` 제공 (복사하여 붙여넣기 가능한 형태로 `cd ... && git ...` 형태로 출력)
 - `type: "instruction"`: 사람이 수행해야 하는 안내 메시지
+- `operationType`: 액션 성격 (`local` | `remote` | `manual`)
 - `actionOptions`: `label`(`A`, `B`, `C`...)과 해당 `action` 매핑 + `summary`/`approvalPrompt`(라벨 설명 템플릿)
+- `primaryActionLabel`/`primaryActionType`/`primaryActionCategory`/`primaryActionOperationType`: 첫 번째 원자 액션의 요약 메타데이터
+- `selectionFallback`: 자동 감지 실패 시 사용된 폴백 (`none` | `open_features` | `all_features` | `done_features`)
 - `category`: 액션 분류 (자동화/반자동용 `approval.mode: "category"`에서 사용)
 - `requiresUserCheck`: 사용자 확인 필요 여부 (에이전트는 **사용자 응답을 `<라벨>` 또는 `<라벨> OK` 형식(예: `A`, `A OK`)으로 제한**하는 것을 권장 / 설정의 `approval`로 오버라이드 가능)
 - `workflowPolicy`: 현재 완료 조건 정책 (`mode`, `requireIssue`, `requireBranch`, `requirePr`, `requireReview`)
 
-또한 `checkPolicy`가 포함되어, 에이전트가 사용자 확인 정책을 적용할 때 참고할 수 있습니다. (`docPath`, `hint`, `token: "<LABEL>"`, `acceptedTokens`, `tokenPattern`, `validLabels`, `requireExplanationBeforeApproval`, `requiredExplanationFields`, `contextVersion`, `config`)
+또한 `checkPolicy`가 포함되어, 에이전트가 사용자 확인 정책을 적용할 때 참고할 수 있습니다. (`docPath`, `hint`, `policyOnly`, `token: "<LABEL>"`, `acceptedTokens`, `tokenPattern`, `validLabels`, `requireExplanationBeforeApproval`, `requiredExplanationFields`, `contextVersion`, `config`)
 
 오류 응답(`status: "error"`)에는 `reasonCode`와 `suggestions`(라벨형 다음 동작: `A/B/C`)가 포함됩니다. (예: `INVALID_APPROVAL`, `CONTEXT_STALE`, `EXECUTION_FAILED`, `EXECUTION_NOT_COMMAND`)
 

package/dist/index.js

@@ -128,7 +128,7 @@ var I18N = {
       "context.tipShowAll": "\uC804\uCCB4 \uBCF4\uAE30",
       "context.tipShowDone": "\uC644\uB8CC\uB9CC \uBCF4\uAE30",
       "context.checkRequired": "[\uD655\uC778 \uD544\uC694] ",
-      "context.checkPolicyHint": "\u2139\uFE0F  \uC0AC\uC6A9\uC790 \uD655\uC778 \uADDC\uCE59: /docs/agents/agents.md \uCC38\uACE0 (git push/merge/merge commit \uD3EC\uD568) \u2014 [\uD655\uC778 \uD544\uC694]\uAC00 \uC788\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C `<\uB77C\uBCA8>` \uB610\uB294 `<\uB77C\uBCA8> OK` (\uC608: `A`, `A OK`) \uC751\uB2F5\uC744 \uBC1B\uC740 \uB4A4 \uC9C4\uD589 (config: approval\uB85C \uC870\uC815 \uAC00\uB2A5)",
+      "context.checkPolicyHint": "\u2139\uFE0F  \uC0AC\uC6A9\uC790 \uD655\uC778 \uC815\uCC45 \uC548\uB0B4(\uD604\uC7AC Next Action \uC544\uB2D8): /docs/agents/agents.md \uCC38\uACE0 (git push/merge/merge commit \uD3EC\uD568). [\uD655\uC778 \uD544\uC694]\uAC00 \uC788\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C `<\uB77C\uBCA8>` \uB610\uB294 `<\uB77C\uBCA8> OK` (\uC608: `A`, `A OK`) \uC751\uB2F5\uC744 \uBC1B\uC740 \uB4A4 \uC9C4\uD589 (config: approval\uB85C \uC870\uC815 \uAC00\uB2A5)",
       "context.actionOptionHint": "\uC2B9\uC778 \uC751\uB2F5 \uD615\uC2DD: `<\uB77C\uBCA8>` \uB610\uB294 `<\uB77C\uBCA8> OK` (\uC608: `A`, `A OK`)",
       "context.actionExplainHint": "\uC2B9\uC778 \uC694\uCCAD \uC804, \uAC01 \uB77C\uBCA8\uC774 \uBB34\uC5C7\uC744 \uC2E4\uD589/\uBCC0\uACBD\uD558\uB294\uC9C0 \uD55C \uC904 \uC694\uC57D\uACFC \uD568\uAED8 \uC124\uBA85\uD558\uC138\uC694.",
       "context.tipDocsCommitRules": "\uCEE4\uBC0B \uBA54\uC2DC\uC9C0 \uADDC\uCE59: /docs/agents/git-workflow.md \uCC38\uACE0",
@@ -325,7 +325,7 @@ var I18N = {
       "context.tipShowAll": "Show all",
       "context.tipShowDone": "Show done only",
       "context.checkRequired": "[CHECK required] ",
-      "context.checkPolicyHint": "\u2139\uFE0F  User check policy: see /docs/agents/agents.md (includes git push/merge and merge commits) \u2014 if you see [CHECK required], wait for `<label>` or `<label> OK` (e.g. `A`, `A OK`) before proceeding (config: approval can override)",
+      "context.checkPolicyHint": "\u2139\uFE0F  User check policy notice (not the current next action): see /docs/agents/agents.md (includes git push/merge and merge commits). If you see [CHECK required], wait for `<label>` or `<label> OK` (e.g. `A`, `A OK`) before proceeding (config: approval can override)",
       "context.actionOptionHint": "Approval reply format: `<label>` or `<label> OK` (e.g. `A`, `A OK`)",
       "context.actionExplainHint": "Before requesting approval, explain what each label will run/change with a one-line summary.",
       "context.tipDocsCommitRules": "Commit message rules: /docs/agents/git-workflow.md",
@@ -3869,6 +3869,22 @@ async function runConfig(options) {
     { owner: "config" }
   );
 }
+var REMOTE_ACTION_CATEGORIES = /* @__PURE__ */ new Set([
+  "issue_create",
+  "pr_create",
+  "pr_status_update",
+  "code_review"
+]);
+var LOCAL_ACTION_CATEGORIES = /* @__PURE__ */ new Set([
+  "docs_commit",
+  "branch_create",
+  "task_execute"
+]);
+var REMOTE_COMMAND_PATTERN = /\b(?:git\s+push|git\s+merge|gh\s+(?:issue|pr)\b)/i;
+function resolveComponentOption(options) {
+  const component = (options.component || options.repo || "").trim().toLowerCase();
+  return component || void 0;
+}
 function getActionLabel(index) {
   let n = index + 1;
   let label = "";
@@ -3879,6 +3895,29 @@ function getActionLabel(index) {
   }
   return label;
 }
+function resolveActionOperationType(action) {
+  if (action.operationType) return action.operationType;
+  if (action.type === "command") {
+    if (REMOTE_COMMAND_PATTERN.test(action.cmd)) return "remote";
+    return "local";
+  }
+  if (action.category && REMOTE_ACTION_CATEGORIES.has(action.category)) {
+    return "remote";
+  }
+  if (action.category && LOCAL_ACTION_CATEGORIES.has(action.category)) {
+    return "local";
+  }
+  return "manual";
+}
+function annotateActionOperationType(action) {
+  return {
+    ...action,
+    operationType: resolveActionOperationType(action)
+  };
+}
+function annotateActions(actions) {
+  return actions.map((action) => annotateActionOperationType(action));
+}
 function getActionSummary(action) {
   if (action.category === "docs_commit") return "Commit docs updates";
   if (action.category === "issue_create") return "Create and record issue";
@@ -3898,6 +3937,12 @@ function getActionSummary(action) {
   }
   return action.message;
 }
+function formatActionSummary(action) {
+  if (action.type === "command") {
+    return `(${action.scope}) ${action.cmd}`;
+  }
+  return action.message;
+}
 function toActionOptions(actions) {
   return actions.map((action, index) => {
     const label = getActionLabel(index);
@@ -3922,6 +3967,7 @@ function buildActionSnapshot(actionOptions) {
         cwd: action.cwd,
         cmd: action.cmd,
         category: action.category,
+        operationType: action.operationType,
         requiresUserCheck: !!action.requiresUserCheck
       };
     }
@@ -3930,6 +3976,7 @@ function buildActionSnapshot(actionOptions) {
       type: action.type,
       message: action.message,
       category: action.category,
+      operationType: action.operationType,
       requiresUserCheck: !!action.requiresUserCheck
     };
   });
@@ -3944,20 +3991,21 @@ function getContextVersion(feature, actionOptions) {
   });
   return createHash("sha256").update(payload).digest("hex").slice(0, 12);
 }
-function parseApprovalLabel(input) {
-  const match = input.trim().match(/^([A-Z]+)(?:\s+OK)?$/i);
-  if (!match) return null;
-  return match[1].toUpperCase();
-}
-function listLabels(actionOptions) {
-  if (actionOptions.length === 0) return "-";
-  return actionOptions.map((o) => o.label).join(", ");
+function matchesFeatureSelector(f, selector) {
+  const s = selector.trim();
+  if (!s) return false;
+  if (f.folderName.toLowerCase() === s.toLowerCase()) return true;
+  if (f.slug.toLowerCase() === s.toLowerCase()) return true;
+  if (f.id && f.id.toLowerCase() === s.toLowerCase()) return true;
+  return false;
 }
-function formatActionSummary(action) {
-  if (action.type === "command") {
-    return `(${action.scope}) ${action.cmd}`;
-  }
-  return action.message;
+function detectFromBranch(branchName, features) {
+  const match = branchName.match(/^feat\/\d+-(.+)$/);
+  if (!match) return [];
+  const detected = match[1];
+  return features.filter(
+    (f) => f.slug.toLowerCase() === detected.toLowerCase() || f.folderName.toLowerCase() === detected.toLowerCase()
+  );
 }
 function toSelectionStatus(features, selectionMode, openFeatures, targetFeatures) {
   const isNoOpen = selectionMode === "open" && features.length > 0 && openFeatures.length === 0;
@@ -3974,15 +4022,9 @@ function toReasonCode(status) {
   if (status === "multiple_active") return "MULTIPLE_ACTIVE_FEATURES";
   return "NO_MATCHED_FEATURES";
 }
-async function resolveContextState(config, featureName, options) {
-  if (!config) {
-    throw createCliError(
-      "CONFIG_NOT_FOUND",
-      tr(DEFAULT_LANG, "cli", "common.configNotFound")
-    );
-  }
+async function resolveContextSelection(config, featureName, options) {
   const { features, branches, warnings } = await scanFeatures(config);
-  const selectedComponent = (options.component || options.repo || "").trim().toLowerCase();
+  const selectedComponent = resolveComponentOption(options);
   const scopedFeatures = selectedComponent ? features.filter((f) => f.type === selectedComponent) : features;
   const doneFeatures = scopedFeatures.filter((f) => f.completion.workflowDone);
   const openFeatures = scopedFeatures.filter((f) => !f.completion.workflowDone);
@@ -3994,6 +4036,7 @@ async function resolveContextState(config, featureName, options) {
   );
   let targetFeatures = [];
   let selectionMode = "explicit";
+  let selectionFallback = "none";
   if (featureName) {
     targetFeatures = scopedFeatures.filter(
       (f) => matchesFeatureSelector(f, featureName)
@@ -4026,15 +4069,19 @@ async function resolveContextState(config, featureName, options) {
     }
     if (targetFeatures.length > 0) {
       selectionMode = "branch";
+      selectionFallback = "none";
     } else if (options.all) {
       targetFeatures = scopedFeatures;
       selectionMode = "all";
+      selectionFallback = "all_features";
     } else if (options.done) {
       targetFeatures = doneFeatures;
       selectionMode = "done";
+      selectionFallback = "done_features";
     } else {
       targetFeatures = openFeatures;
       selectionMode = "open";
+      selectionFallback = "open_features";
     }
   }
   const status = toSelectionStatus(
@@ -4044,7 +4091,7 @@ async function resolveContextState(config, featureName, options) {
     targetFeatures
   );
   const matchedFeature = targetFeatures.length === 1 ? targetFeatures[0] : null;
-  const actions = matchedFeature?.actions ?? [];
+  const actions = annotateActions(matchedFeature?.actions ?? []);
   const actionOptions = toActionOptions(actions);
   const contextVersion = getContextVersion(matchedFeature, actionOptions);
   return {
@@ -4056,6 +4103,7 @@ async function resolveContextState(config, featureName, options) {
     inProgressFeatures,
     readyToCloseFeatures,
     selectionMode,
+    selectionFallback,
     targetFeatures,
     status,
     matchedFeature,
@@ -4064,6 +4112,32 @@ async function resolveContextState(config, featureName, options) {
     contextVersion
   };
 }
+
+// src/commands/context.ts
+async function resolveContextState(config, featureName, options) {
+  if (!config) {
+    throw createCliError(
+      "CONFIG_NOT_FOUND",
+      tr(DEFAULT_LANG, "cli", "common.configNotFound")
+    );
+  }
+  return resolveContextSelection(config, featureName, options);
+}
+function parseApprovalLabel(input) {
+  const match = input.trim().match(/^([A-Z]+)(?:\s+OK)?$/i);
+  if (!match) return null;
+  return match[1].toUpperCase();
+}
+function listLabels(actionOptions) {
+  if (actionOptions.length === 0) return "-";
+  return actionOptions.map((o) => o.label).join(", ");
+}
+function formatActionSummary2(action) {
+  if (action.type === "command") {
+    return `(${action.scope}) ${action.cmd}`;
+  }
+  return action.message;
+}
 function executeCommandAction(cmd, jsonMode, cwd) {
   const shellPath = process.env.SHELL || (process.platform === "win32" ? process.env.ComSpec || "cmd.exe" : "/bin/sh");
   if (jsonMode) {
@@ -4122,22 +4196,6 @@ function contextCommand(program2) {
     }
   );
 }
-function matchesFeatureSelector(f, selector) {
-  const s = selector.trim();
-  if (!s) return false;
-  if (f.folderName.toLowerCase() === s.toLowerCase()) return true;
-  if (f.slug.toLowerCase() === s.toLowerCase()) return true;
-  if (f.id && f.id.toLowerCase() === s.toLowerCase()) return true;
-  return false;
-}
-function detectFromBranch(branchName, features) {
-  const match = branchName.match(/^feat\/\d+-(.+)$/);
-  if (!match) return [];
-  const detected = match[1];
-  return features.filter(
-    (f) => f.slug.toLowerCase() === detected.toLowerCase() || f.folderName.toLowerCase() === detected.toLowerCase()
-  );
-}
 function getListLabel(f, stepsMap, lang, workflowPolicy) {
   if (f.completion.implementationDone && !f.completion.workflowDone) {
     if (f.git.docsHasUncommittedChanges) {
@@ -4231,10 +4289,12 @@ async function runContext(featureName, options) {
     return;
   }
   if (options.json) {
+    const primaryAction = state.actionOptions[0] ?? null;
     const result = {
       status: state.status,
       reasonCode: toReasonCode(state.status),
       selectionMode: state.selectionMode,
+      selectionFallback: state.selectionFallback,
       branches: state.branches,
       warnings: state.warnings,
       matchedFeature: state.matchedFeature,
@@ -4246,10 +4306,15 @@ async function runContext(featureName, options) {
       readyToCloseCandidates: state.selectionMode === "open" ? state.readyToCloseFeatures : [],
       actions: state.actions,
       actionOptions: state.actionOptions,
+      primaryActionLabel: primaryAction?.label ?? null,
+      primaryActionType: primaryAction?.action.type ?? null,
+      primaryActionCategory: primaryAction?.action.category ?? null,
+      primaryActionOperationType: primaryAction?.action.operationType ?? null,
       workflowPolicy,
       checkPolicy: {
         docPath: "/docs/agents/agents.md",
         hint: tr(lang, "cli", "context.checkPolicyHint"),
+        policyOnly: true,
         token: "<LABEL>",
         acceptedTokens: ["<LABEL>", "<LABEL> OK"],
         tokenPattern: "^([A-Z]+)(?:\\s+OK)?$",
@@ -4268,7 +4333,8 @@ async function runContext(featureName, options) {
           label: o.label,
           summary: o.summary,
           approvalPrompt: o.approvalPrompt,
-          requiresUserCheck: !!o.action.requiresUserCheck
+          requiresUserCheck: !!o.action.requiresUserCheck,
+          operationType: o.action.operationType
         }))
       },
       prPolicy: {
@@ -4476,7 +4542,7 @@ async function runContext(featureName, options) {
     console.log();
     return;
   }
-  const actionOptions = toActionOptions(f.actions);
+  const actionOptions = state.actionOptions;
   console.log(chalk6.green(chalk6.bold("\u{1F449} Next Options (Atomic):")));
   let hasDocsCommand = false;
   actionOptions.forEach(({ label, action }) => {
@@ -4562,7 +4628,7 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
     }
     console.log();
     console.log(chalk6.green(`\u2705 Approved option: ${parsedLabel}`));
-    console.log(chalk6.gray(`   - Action: ${formatActionSummary(selectedAction)}`));
+    console.log(chalk6.gray(`   - Action: ${formatActionSummary2(selectedAction)}`));
     if (selectedAction.type === "command") {
       console.log(chalk6.gray("   - Run with: --execute"));
     } else {
@@ -5230,208 +5296,6 @@ function doctorCommand(program2) {
     }
   });
 }
-function resolveComponentOption(options) {
-  const component = (options.component || options.repo || "").trim().toLowerCase();
-  return component || void 0;
-}
-function getActionLabel2(index) {
-  let n = index + 1;
-  let label = "";
-  while (n > 0) {
-    const rem = (n - 1) % 26;
-    label = String.fromCharCode(65 + rem) + label;
-    n = Math.floor((n - 1) / 26);
-  }
-  return label;
-}
-function getActionSummary2(action) {
-  if (action.category === "docs_commit") return "Commit docs updates";
-  if (action.category === "issue_create") return "Create and record issue";
-  if (action.category === "branch_create") return "Create feature branch";
-  if (action.category === "pr_create") return "Create PR and record link";
-  if (action.category === "pr_status_update") return "Update PR status";
-  if (action.category === "code_review") return "Process code review feedback";
-  if (action.category === "task_execute") return "Proceed with task execution";
-  if (action.category === "feature_done") return "Feature is complete";
-  if (action.category === "spec_approve") return "Request spec approval";
-  if (action.category === "plan_approve") return "Request plan approval";
-  if (action.category === "tasks_approve") return "Request tasks approval";
-  if (action.category === "pr_metadata_migrate") return "Update tasks.md to latest PR fields";
-  if (action.category === "fallback") return "Re-check context and rerun";
-  if (action.type === "command") {
-    return action.scope === "docs" ? "Run docs command" : "Run project command";
-  }
-  return action.message;
-}
-function formatActionSummary2(action) {
-  if (action.type === "command") {
-    return `(${action.scope}) ${action.cmd}`;
-  }
-  return action.message;
-}
-function toActionOptions2(actions) {
-  return actions.map((action, index) => {
-    const label = getActionLabel2(index);
-    const summary = getActionSummary2(action);
-    const detail = formatActionSummary2(action);
-    return {
-      label,
-      summary,
-      detail,
-      approvalPrompt: `${label}: ${summary}`,
-      action
-    };
-  });
-}
-function buildActionSnapshot2(actionOptions) {
-  return actionOptions.map(({ label, action }) => {
-    if (action.type === "command") {
-      return {
-        label,
-        type: action.type,
-        scope: action.scope,
-        cwd: action.cwd,
-        cmd: action.cmd,
-        category: action.category,
-        requiresUserCheck: !!action.requiresUserCheck
-      };
-    }
-    return {
-      label,
-      type: action.type,
-      message: action.message,
-      category: action.category,
-      requiresUserCheck: !!action.requiresUserCheck
-    };
-  });
-}
-function getContextVersion2(feature, actionOptions) {
-  if (!feature) return null;
-  const payload = JSON.stringify({
-    id: feature.id || "",
-    folderName: feature.folderName,
-    currentStep: feature.currentStep,
-    actionSnapshot: buildActionSnapshot2(actionOptions)
-  });
-  return createHash("sha256").update(payload).digest("hex").slice(0, 12);
-}
-function matchesFeatureSelector2(f, selector) {
-  const s = selector.trim();
-  if (!s) return false;
-  if (f.folderName.toLowerCase() === s.toLowerCase()) return true;
-  if (f.slug.toLowerCase() === s.toLowerCase()) return true;
-  if (f.id && f.id.toLowerCase() === s.toLowerCase()) return true;
-  return false;
-}
-function detectFromBranch2(branchName, features) {
-  const match = branchName.match(/^feat\/\d+-(.+)$/);
-  if (!match) return [];
-  const detected = match[1];
-  return features.filter(
-    (f) => f.slug.toLowerCase() === detected.toLowerCase() || f.folderName.toLowerCase() === detected.toLowerCase()
-  );
-}
-function toSelectionStatus2(features, selectionMode, openFeatures, targetFeatures) {
-  const isNoOpen = selectionMode === "open" && features.length > 0 && openFeatures.length === 0;
-  if (features.length === 0) return "no_features";
-  if (isNoOpen) return "no_open";
-  if (targetFeatures.length === 1) return "single_matched";
-  if (targetFeatures.length > 1) return "multiple_active";
-  return "no_match";
-}
-function toReasonCode2(status) {
-  if (status === "no_features") return "NO_FEATURES";
-  if (status === "no_open") return "NO_OPEN_FEATURES";
-  if (status === "single_matched") return "SINGLE_MATCHED";
-  if (status === "multiple_active") return "MULTIPLE_ACTIVE_FEATURES";
-  return "NO_MATCHED_FEATURES";
-}
-async function resolveContextSelection(config, featureName, options) {
-  const { features, branches, warnings } = await scanFeatures(config);
-  const selectedComponent = resolveComponentOption(options);
-  const scopedFeatures = selectedComponent ? features.filter((f) => f.type === selectedComponent) : features;
-  const doneFeatures = scopedFeatures.filter((f) => f.completion.workflowDone);
-  const openFeatures = scopedFeatures.filter((f) => !f.completion.workflowDone);
-  const inProgressFeatures = openFeatures.filter(
-    (f) => !f.completion.implementationDone
-  );
-  const readyToCloseFeatures = openFeatures.filter(
-    (f) => f.completion.implementationDone
-  );
-  let targetFeatures = [];
-  let selectionMode = "explicit";
-  if (featureName) {
-    targetFeatures = scopedFeatures.filter(
-      (f) => matchesFeatureSelector2(f, featureName)
-    );
-    selectionMode = "explicit";
-  } else {
-    if (config.projectType === "single") {
-      const branchName = branches.project.single || "";
-      targetFeatures = detectFromBranch2(branchName, scopedFeatures);
-    } else if (selectedComponent) {
-      const branchName = branches.project[selectedComponent] || "";
-      targetFeatures = detectFromBranch2(
-        branchName,
-        scopedFeatures
-      );
-    } else {
-      const matches = [];
-      const componentKeys = [...new Set(scopedFeatures.map((f) => f.type))].filter((key) => key !== "single");
-      for (const component of componentKeys) {
-        const branchName = branches.project[component] || "";
-        if (!branchName) continue;
-        matches.push(
-          ...detectFromBranch2(
-            branchName,
-            scopedFeatures.filter((f) => f.type === component)
-          )
-        );
-      }
-      targetFeatures = matches;
-    }
-    if (targetFeatures.length > 0) {
-      selectionMode = "branch";
-    } else if (options.all) {
-      targetFeatures = scopedFeatures;
-      selectionMode = "all";
-    } else if (options.done) {
-      targetFeatures = doneFeatures;
-      selectionMode = "done";
-    } else {
-      targetFeatures = openFeatures;
-      selectionMode = "open";
-    }
-  }
-  const status = toSelectionStatus2(
-    scopedFeatures,
-    selectionMode,
-    openFeatures,
-    targetFeatures
-  );
-  const matchedFeature = targetFeatures.length === 1 ? targetFeatures[0] : null;
-  const actions = matchedFeature?.actions ?? [];
-  const actionOptions = toActionOptions2(actions);
-  const contextVersion = getContextVersion2(matchedFeature, actionOptions);
-  return {
-    features: scopedFeatures,
-    branches,
-    warnings,
-    doneFeatures,
-    openFeatures,
-    inProgressFeatures,
-    readyToCloseFeatures,
-    selectionMode,
-    targetFeatures,
-    status,
-    matchedFeature,
-    actions,
-    actionOptions,
-    contextVersion
-  };
-}
-
-// src/commands/view.ts
 function resolveComponentOption2(options) {
   if (options.repo && options.component && options.repo.trim().toLowerCase() !== options.component.trim().toLowerCase()) {
     throw createCliError(
@@ -5489,8 +5353,9 @@ async function runView(featureName, options) {
   if (options.json) {
     const payload = {
       status: state.status,
-      reasonCode: toReasonCode2(state.status),
+      reasonCode: toReasonCode(state.status),
       selectionMode: state.selectionMode,
+      selectionFallback: state.selectionFallback,
       counts: {
         features: state.features.length,
         open: state.openFeatures.length,
@@ -5537,7 +5402,7 @@ async function runView(featureName, options) {
   }
   if (!state.matchedFeature) {
     console.log();
-    console.log(chalk6.blue(`Selection: ${state.status} (${toReasonCode2(state.status)})`));
+    console.log(chalk6.blue(`Selection: ${state.status} (${toReasonCode(state.status)})`));
     const rows = state.targetFeatures.length > 0 ? state.targetFeatures : state.features;
     for (const f2 of rows) {
       const statusText = f2.completion.workflowDone ? chalk6.green("WORKFLOW_DONE") : f2.completion.implementationDone ? chalk6.cyan("DONE") : chalk6.yellow("IN_PROGRESS");
@@ -5725,16 +5590,18 @@ async function runFlow(featureName, options) {
       context: {
         before: {
           status: before.status,
-          reasonCode: toReasonCode2(before.status),
+          reasonCode: toReasonCode(before.status),
           selectionMode: before.selectionMode,
+          selectionFallback: before.selectionFallback,
           matchedFeature: before.matchedFeature,
           actionOptions: before.actionOptions,
           contextVersion: before.contextVersion
         },
         after: {
           status: after.status,
-          reasonCode: toReasonCode2(after.status),
+          reasonCode: toReasonCode(after.status),
           selectionMode: after.selectionMode,
+          selectionFallback: after.selectionFallback,
           matchedFeature: after.matchedFeature,
           actionOptions: after.actionOptions,
           contextVersion: after.contextVersion
@@ -5753,7 +5620,7 @@ async function runFlow(featureName, options) {
   console.log(chalk6.bold("\u{1F501} Flow Summary"));
   console.log(
     chalk6.gray(
-      `- Before: ${before.status} (${toReasonCode2(before.status)}) / After: ${after.status} (${toReasonCode2(after.status)})`
+      `- Before: ${before.status} (${toReasonCode(before.status)}) / After: ${after.status} (${toReasonCode(after.status)})`
     )
   );
   if (approvalResult && typeof approvalResult === "object") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lee-spec-kit",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "Project documentation structure generator for AI-assisted development",
   "type": "module",
   "bin": {