Merge pull request #82 from decipherhub/fix/deployment-studio-localization-state

fix: gate Deployment Studio progress on verified evidence

Author: 0xMuang

FEATURES.md

@@ -9,6 +9,26 @@
 
 동시에 하나의 feature만 `active` 상태로 둔다.
 
+## STUDIO-002 — Localized Evidence-Gated Workflow
+
+### Behavior
+
+- Deployment Studio는 한국어를 기본으로 제공하고 사용자가 English로 전환한
+  선택을 브라우저에 유지한다.
+- 설정 저장, Doctor, 배포 계획, 배포, Artifact 검증, DEX 실행 단계는 이전
+  단계의 실제 evidence가 존재할 때만 완료로 표시한다.
+- 후속 단계 데이터가 남아 있더라도 선행 설정이 저장되지 않았다면 완료 표시와
+  실행 버튼을 fail-closed한다.
+
+### Verification
+
+- `npm test --prefix services/deployment-studio`
+- `git diff --check`
+
+### State
+
+passing
+
 ## DOC-004 — Product Architecture and Technical Whitepaper
 
 ### Behavior

PROGRESS.md

@@ -15,6 +15,11 @@ source of truth로 사용한다.
 
 ## Completed
 
+- `STUDIO-002 — Localized Evidence-Gated Workflow`: Deployment Studio의 기본
+  언어를 한국어로 제공하고 English 전환 선택을 유지한다. 설정 저장부터 Doctor,
+  계획, 배포, Artifact 검증, DEX 실행까지 실제 evidence와 선행 단계가 모두
+  충족된 경우에만 완료로 표시하도록 workflow 상태를 fail-closed했다.
+  Deployment Studio smoke test와 `git diff --check`를 통과했다.
 - `DOC-004 — Product Architecture and Technical Whitepaper`: current
   source-of-truth와 구현을 기준으로 외부 공유용 기술 백서를 작성했다. 문제 정의,
   제품 경계, Element/Recipe/Manifest/Operator, Router fill-time enforcement,

services/deployment-studio/test/smoke.ts

@@ -386,6 +386,36 @@ async function main(): Promise<void> {
   const app = readFileSync(resolve(webRoot, "app.js"), "utf8");
   const css = readFileSync(resolve(webRoot, "styles.css"), "utf8");
   new Function(app);
+  const {workflowCompletion} = require(resolve(webRoot, "app.js")) as {
+    workflowCompletion(value: Record<string, unknown>): Record<string, boolean>;
+  };
+  const prematureWorkflow = workflowCompletion({
+    project: "treasury-dex",
+    configReady: false,
+    doctorReady: true,
+    planReady: true,
+    deploymentReady: true,
+    verified: true,
+    activationReady: true
+  });
+  if (
+    prematureWorkflow.project !== true ||
+    Object.entries(prematureWorkflow).some(([stage, complete]) => stage !== "project" && complete)
+  ) {
+    throw new Error("workflow displayed downstream completion before configuration was explicitly saved");
+  }
+  const completedWorkflow = workflowCompletion({
+    project: "treasury-dex",
+    configReady: true,
+    doctorReady: true,
+    planReady: true,
+    deploymentReady: true,
+    verified: true,
+    activationReady: true
+  });
+  if (Object.values(completedWorkflow).some((complete) => !complete)) {
+    throw new Error("workflow did not display completion after every stage supplied evidence");
+  }
   for (const marker of [
     'id="projectMode"', 'id="network"', 'id="assetProfile"', 'id="venueRfq"',
     'id="runDoctor"', 'id="reviewPlan"', 'id="deployDemo"', 'id="verifyArtifact"',
@@ -401,6 +431,7 @@ async function main(): Promise<void> {
     'id="productionDeploymentId"', 'id="productionDeployer"', 'id="productionOperator"',
     'id="productionVenueRfq"', 'id="productionVenueAmm"',
     'id="runProductionPreflight"', 'id="generateProductionPlan"', 'id="exportProductionPlan"',
+    'id="languageToggle"',
     "Runtime constraints", "Demo fixtures", "Manual evidence checklist",
     "Arbitrum One · production plan only", "GIWA / organization EVM · plan only",
     "Production core", "preflight → plan"
@@ -413,15 +444,16 @@ async function main(): Promise<void> {
     "startDexDemo", "stopDexDemo", "/runtime/start", "/runtime/stop",
     "HELP_CONTENT", "DEMO_BROADCAST_NETWORKS", "selectedNetwork", "selectedModule",
     "openContextHelp", "buildProductionConfig", "runProductionPreflight",
-    "generateProductionPlan", "exportProductionPlan"
+    "generateProductionPlan", "exportProductionPlan", "initializeLanguage",
+    "corner-store-studio-language", "프로젝트 방식", "Artifact 검증"
   ]) {
     if (!app.includes(marker)) throw new Error(`studio UI wiring missing: ${marker}`);
   }
   for (const marker of [
     "--ink:", "--signal:", ".studio-shell", ".rail", ".workflow-map", ".status-led",
     ".artifact-grid", ".boundary-banner", ".help-trigger", ".context-dialog",
     ".target-switch", ".production-ledger", ".production-actions",
-    ".handoff-actions",
+    ".handoff-actions", ".language-toggle",
     "@media (max-width: 820px)"
   ]) {
     if (!css.includes(marker)) throw new Error(`studio visual token missing: ${marker}`);