feat: implement M4 settings and recovery flow (#4)

Author: doosanofficial-ui

README.md

@@ -12,10 +12,11 @@ GitHub Copilot SDK 기반으로 Obsidian 사이드바에 Copilot CLI 수준의 
 
 - 리포지토리/문서/기본 플러그인 스캐폴드 생성 완료
 - M2 기본 UX 반영: 사이드바 채팅 뷰, 세션 생성/전환/삭제, 모의 스트리밍 응답
-- 명령 팔레트 연동 확장: `Open`, `Ask about current note`, `Apply pending changes`, `Start new chat session`, `Undo last applied change`, `Refresh auth status`
+- 명령 팔레트 연동 확장: `Open`, `Ask about current note`, `Apply pending changes`, `Start new chat session`, `Undo last applied change`, `Refresh auth status`, `Open sidebar settings panel`, `Retry last failed prompt`
 - 로컬 세션/상태 저장 및 pending change 적용 기본 흐름 구현
 - M3 컨텍스트/변경 흐름 확장: 명시적 추가 컨텍스트 노트 병합, 변경 전 diff 프리뷰, discard/undo 적용
 - M1 인증 실연동 경로(Desktop): `gh auth status`/`gh copilot status` 기반 로그인/권한 상태 probe + 수동 재검증
+- M4 설정/복구 흐름: 사이드바 내 설정 패널(모델/컨텍스트 정책/쓰기 정책/디버그/재시도) + 실패 프롬프트 재시도
 - 상세 요구사항: `docs/requirements.md`
 - 아키텍처 초안: `docs/architecture.md`
 - 구현 마일스톤: `docs/milestones.md`

docs/atomic-task-plan.md

@@ -100,3 +100,12 @@
 | M1-C02 | entitlement/no-entitlement 상태 매핑 | Copilot CLI | `npm run smoke:run && npm run smoke:assert` |
 | M1-C03 | 수동 재검증 명령/버튼 연계 | Copilot CLI | `npm run verify:e2e` |
 | M1-CL01 | M1 변경의 Cloud 검증 실행 | Cloud Agent | `npm run cloud:dispatch` 후 `npm run cloud:status`에서 최신 run 확인 |
+
+## 11) Iteration 6 (M4 Settings + Recovery) 템플릿
+
+| ID | 목표 | 담당 | 독립 검증 기준 |
+|---|---|---|---|
+| M4-C01 | 사이드바 설정 패널(모델/컨텍스트 정책/쓰기 정책) 구현 | Copilot CLI | `npm run check && npm run build` |
+| M4-C02 | 쓰기 적용 정책(confirm/auto) 반영 | Copilot CLI | `npm run smoke:run && npm run smoke:assert` |
+| M4-C03 | 실패 프롬프트 저장/재시도 명령 및 UI 연계 | Copilot CLI | `npm run verify:e2e` |
+| M4-CL01 | M4 변경의 Cloud 검증 실행 | Cloud Agent | `npm run cloud:dispatch` 후 `npm run cloud:status`에서 최신 run 확인 |

docs/requirements.md

@@ -58,6 +58,8 @@
 - `Start new chat session`
 - `Undo last applied change`
 - `Refresh auth status`
+- `Open sidebar settings panel`
+- `Retry last failed prompt`
 
 ### FR-006 세션/설정 저장
 
@@ -69,6 +71,7 @@
 
 - 네트워크/인증/권한 오류를 사용자 친화 메시지로 표기
 - 재시도, 재인증 경로 제공
+- 인증 실패 상태에서 실패 프롬프트를 저장하고 재시도 명령으로 복구할 수 있어야 한다.
 
 ## 6. 비기능 요구사항
 

main.js

@@ -30,6 +30,7 @@ var MAX_PENDING_CHANGES = 10;
 var MAX_ADDITIONAL_CONTEXT = 8;
 var STREAM_DELAY_MS = 30;
 var PREVIEW_MAX_LINES = 120;
+var RECOMMENDED_MODELS = ["gpt-5.3-codex", "gpt-4.1", "gpt-4o-mini"];
 var AUTH_ORDER = ["logged-in", "no-entitlement", "token-expired", "offline"];
 function createId(prefix) {
   return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
@@ -57,6 +58,9 @@ function defaultSettings() {
     authCheckedAt: Date.now(),
     model: "gpt-5.3-codex",
     contextPolicy: "selection-first",
+    changeApplyPolicy: "confirm-write",
+    retryFailedPrompt: true,
+    lastFailedPrompt: "",
     debugLogging: false
   };
 }
@@ -66,6 +70,9 @@ function isAuthState(value) {
 function isContextPolicy(value) {
   return value === "selection-first" || value === "note-only";
 }
+function isChangeApplyPolicy(value) {
+  return value === "confirm-write" || value === "auto-apply";
+}
 function isMessageRole(value) {
   return value === "user" || value === "assistant" || value === "system";
 }
@@ -175,6 +182,9 @@ function normalizeSettings(raw) {
     authCheckedAt: typeof source.authCheckedAt === "number" ? source.authCheckedAt : fallback.authCheckedAt,
     model: typeof source.model === "string" && source.model.trim().length > 0 ? source.model : fallback.model,
     contextPolicy: isContextPolicy(source.contextPolicy) ? source.contextPolicy : fallback.contextPolicy,
+    changeApplyPolicy: isChangeApplyPolicy(source.changeApplyPolicy) ? source.changeApplyPolicy : fallback.changeApplyPolicy,
+    retryFailedPrompt: typeof source.retryFailedPrompt === "boolean" ? source.retryFailedPrompt : fallback.retryFailedPrompt,
+    lastFailedPrompt: typeof source.lastFailedPrompt === "string" ? source.lastFailedPrompt : fallback.lastFailedPrompt,
     debugLogging: Boolean(source.debugLogging)
   };
 }
@@ -220,10 +230,16 @@ var CopilotSidebarView = class extends import_obsidian.ItemView {
       text: "Refresh Auth",
       cls: "copilot-button"
     });
+    const retryFailedButton = controlRow.createEl("button", {
+      text: "Retry Failed",
+      cls: "copilot-button"
+    });
     const layout = root.createDiv({ cls: "copilot-sidebar-layout" });
     const leftPane = layout.createDiv({ cls: "copilot-sidebar-pane copilot-sidebar-pane-sessions" });
     leftPane.createDiv({ text: "Sessions", cls: "copilot-pane-title" });
     const sessionList = leftPane.createDiv({ cls: "copilot-session-list" });
+    leftPane.createDiv({ text: "Settings", cls: "copilot-pane-title" });
+    const settingsPanel = leftPane.createDiv({ cls: "copilot-settings-panel" });
     leftPane.createDiv({ text: "Context Notes", cls: "copilot-pane-title" });
     const contextList = leftPane.createDiv({ cls: "copilot-context-list" });
     leftPane.createDiv({ text: "Pending Changes", cls: "copilot-pane-title" });
@@ -255,6 +271,9 @@ var CopilotSidebarView = class extends import_obsidian.ItemView {
     refreshAuthButton.addEventListener("click", () => {
       void this.plugin.refreshAuthStatus("manual");
     });
+    retryFailedButton.addEventListener("click", () => {
+      void this.plugin.retryLastFailedPrompt();
+    });
     composerButton.addEventListener("click", () => {
       void this.submitComposer();
     });
@@ -269,6 +288,7 @@ var CopilotSidebarView = class extends import_obsidian.ItemView {
       authBadge,
       authMeta: authDetail,
       sessionList,
+      settingsPanel,
       contextList,
       pendingList,
       messages,
@@ -295,6 +315,7 @@ var CopilotSidebarView = class extends import_obsidian.ItemView {
     const compactDetail = snapshot.authDetail.length > 180 ? `${snapshot.authDetail.slice(0, 177)}...` : snapshot.authDetail;
     this.elements.authMeta.setText(`${compactDetail} | checked ${checkedAt}`);
     this.renderSessions(snapshot);
+    this.renderSettings(snapshot);
     this.renderContextNotes(snapshot);
     this.renderPendingChanges(snapshot);
     this.renderMessages(activeSession);
@@ -328,6 +349,81 @@ var CopilotSidebarView = class extends import_obsidian.ItemView {
       });
     }
   }
+  renderSettings(snapshot) {
+    if (!this.elements) {
+      return;
+    }
+    const panel = this.elements.settingsPanel;
+    panel.empty();
+    const modelRow = panel.createDiv({ cls: "copilot-setting-row" });
+    modelRow.createDiv({ text: "Model", cls: "copilot-setting-label" });
+    const modelSelect = modelRow.createEl("select", { cls: "copilot-setting-select" });
+    for (const model of RECOMMENDED_MODELS) {
+      const option = modelSelect.createEl("option");
+      option.value = model;
+      option.text = model;
+    }
+    if (!RECOMMENDED_MODELS.includes(snapshot.model)) {
+      const customOption = modelSelect.createEl("option");
+      customOption.value = snapshot.model;
+      customOption.text = `${snapshot.model} (custom)`;
+    }
+    modelSelect.value = snapshot.model;
+    modelSelect.addEventListener("change", () => {
+      void this.plugin.updateModel(modelSelect.value);
+    });
+    const contextRow = panel.createDiv({ cls: "copilot-setting-row" });
+    contextRow.createDiv({ text: "Context Policy", cls: "copilot-setting-label" });
+    const contextSelect = contextRow.createEl("select", { cls: "copilot-setting-select" });
+    const selectionOption = contextSelect.createEl("option");
+    selectionOption.value = "selection-first";
+    selectionOption.text = "Selection First";
+    const noteOption = contextSelect.createEl("option");
+    noteOption.value = "note-only";
+    noteOption.text = "Note Only";
+    contextSelect.value = snapshot.contextPolicy;
+    contextSelect.addEventListener("change", () => {
+      const nextPolicy = contextSelect.value === "note-only" ? "note-only" : "selection-first";
+      void this.plugin.updateContextPolicy(nextPolicy);
+    });
+    const applyPolicyRow = panel.createDiv({ cls: "copilot-setting-row" });
+    applyPolicyRow.createDiv({ text: "Write Policy", cls: "copilot-setting-label" });
+    const applyPolicySelect = applyPolicyRow.createEl("select", { cls: "copilot-setting-select" });
+    const confirmOption = applyPolicySelect.createEl("option");
+    confirmOption.value = "confirm-write";
+    confirmOption.text = "Confirm Before Apply";
+    const autoOption = applyPolicySelect.createEl("option");
+    autoOption.value = "auto-apply";
+    autoOption.text = "Auto Apply";
+    applyPolicySelect.value = snapshot.changeApplyPolicy;
+    applyPolicySelect.addEventListener("change", () => {
+      const nextPolicy = applyPolicySelect.value === "auto-apply" ? "auto-apply" : "confirm-write";
+      void this.plugin.updateChangeApplyPolicy(nextPolicy);
+    });
+    const debugRow = panel.createDiv({ cls: "copilot-setting-row" });
+    const debugToggle = debugRow.createEl("input", {
+      cls: "copilot-setting-checkbox",
+      attr: { type: "checkbox" }
+    });
+    debugToggle.checked = snapshot.debugLogging;
+    debugRow.createDiv({ text: "Debug logging", cls: "copilot-setting-label" });
+    debugToggle.addEventListener("change", () => {
+      void this.plugin.updateDebugLogging(debugToggle.checked);
+    });
+    const retryRow = panel.createDiv({ cls: "copilot-setting-row" });
+    const retryToggle = retryRow.createEl("input", {
+      cls: "copilot-setting-checkbox",
+      attr: { type: "checkbox" }
+    });
+    retryToggle.checked = snapshot.retryFailedPrompt;
+    retryRow.createDiv({ text: "Enable failed prompt retry", cls: "copilot-setting-label" });
+    retryToggle.addEventListener("change", () => {
+      void this.plugin.updateRetryFailedPrompt(retryToggle.checked);
+    });
+    const failedPrompt = snapshot.lastFailedPrompt.trim();
+    const failedText = failedPrompt.length > 0 ? failedPrompt.slice(0, 120) : "None";
+    panel.createDiv({ text: `Last failed prompt: ${failedText}`, cls: "copilot-setting-hint" });
+  }
   renderPendingChanges(snapshot) {
     if (!this.elements) {
       return;
@@ -515,6 +611,21 @@ var CopilotSidebarPlugin = class extends import_obsidian.Plugin {
         await this.undoLastAppliedChange();
       }
     });
+    this.addCommand({
+      id: "open-sidebar-settings-panel",
+      name: "Open sidebar settings panel",
+      callback: async () => {
+        await this.activateView();
+        new import_obsidian.Notice("Open the Copilot Sidebar and use the Settings section.");
+      }
+    });
+    this.addCommand({
+      id: "retry-last-failed-prompt",
+      name: "Retry last failed prompt",
+      callback: async () => {
+        await this.retryLastFailedPrompt();
+      }
+    });
     this.addCommand({
       id: "refresh-auth-status",
       name: "Refresh auth status",
@@ -553,6 +664,11 @@ var CopilotSidebarPlugin = class extends import_obsidian.Plugin {
       authDetail: this.settings.authDetail,
       authCheckedAt: this.settings.authCheckedAt,
       model: this.settings.model,
+      contextPolicy: this.settings.contextPolicy,
+      changeApplyPolicy: this.settings.changeApplyPolicy,
+      retryFailedPrompt: this.settings.retryFailedPrompt,
+      lastFailedPrompt: this.settings.lastFailedPrompt,
+      debugLogging: this.settings.debugLogging,
       isStreaming: this.streaming
     };
   }
@@ -566,6 +682,30 @@ var CopilotSidebarPlugin = class extends import_obsidian.Plugin {
     this.settings.activeSessionId = sessionId;
     await this.persistAndRender();
   }
+  async updateModel(model) {
+    const trimmed = model.trim();
+    if (!trimmed) {
+      return;
+    }
+    this.settings.model = trimmed;
+    await this.persistAndRender();
+  }
+  async updateContextPolicy(contextPolicy) {
+    this.settings.contextPolicy = contextPolicy;
+    await this.persistAndRender();
+  }
+  async updateChangeApplyPolicy(changeApplyPolicy) {
+    this.settings.changeApplyPolicy = changeApplyPolicy;
+    await this.persistAndRender();
+  }
+  async updateRetryFailedPrompt(enabled) {
+    this.settings.retryFailedPrompt = enabled;
+    await this.persistAndRender();
+  }
+  async updateDebugLogging(enabled) {
+    this.settings.debugLogging = enabled;
+    await this.persistAndRender();
+  }
   async startNewSession() {
     const session = createSession();
     this.settings.sessions = [session, ...this.settings.sessions].slice(0, MAX_SESSIONS);
@@ -758,6 +898,13 @@ var CopilotSidebarPlugin = class extends import_obsidian.Plugin {
       await this.persistAndRender();
       return;
     }
+    if (this.settings.changeApplyPolicy === "confirm-write") {
+      const accepted = typeof window !== "undefined" ? window.confirm(`Apply pending change to ${change.notePath}?`) : true;
+      if (!accepted) {
+        new import_obsidian.Notice("Apply canceled by policy confirmation.");
+        return;
+      }
+    }
     await this.app.vault.modify(target, change.after);
     this.settings.lastAppliedChange = {
       ...change,
@@ -805,11 +952,35 @@ var CopilotSidebarPlugin = class extends import_obsidian.Plugin {
     }
     await this.applyPendingChange(first.id);
   }
+  async retryLastFailedPrompt() {
+    const lastFailed = this.settings.lastFailedPrompt.trim();
+    if (!lastFailed) {
+      new import_obsidian.Notice("No failed prompt to retry.");
+      return;
+    }
+    await this.refreshAuthStatus("manual");
+    if (this.settings.authState !== "logged-in") {
+      new import_obsidian.Notice(`Cannot retry while auth is ${this.settings.authState}.`);
+      return;
+    }
+    await this.sendUserMessage(lastFailed);
+  }
   async sendUserMessage(prompt, providedContext) {
     const trimmed = prompt.trim();
     if (!trimmed) {
       return;
     }
+    if (this.settings.retryFailedPrompt && this.settings.authState !== "logged-in") {
+      this.settings.lastFailedPrompt = trimmed;
+    }
+    if (this.settings.debugLogging) {
+      console.info("[copilot-sidebar] sendUserMessage", {
+        authState: this.settings.authState,
+        promptLength: trimmed.length,
+        contextPolicy: this.settings.contextPolicy,
+        changeApplyPolicy: this.settings.changeApplyPolicy
+      });
+    }
     const session = this.ensureActiveSession();
     session.messages.push({
       id: createId("msg-user"),
@@ -842,6 +1013,9 @@ var CopilotSidebarPlugin = class extends import_obsidian.Plugin {
     assistantMessage.streaming = false;
     session.updatedAt = Date.now();
     this.streaming = false;
+    if (this.settings.authState === "logged-in") {
+      this.settings.lastFailedPrompt = "";
+    }
     await this.maybeCreatePendingChange(trimmed, response, context);
     this.syncSelectedPendingChange();
     await this.persistAndRender();
@@ -947,6 +1121,7 @@ var CopilotSidebarPlugin = class extends import_obsidian.Plugin {
       `Prompt: ${prompt}`,
       `Primary context (${this.settings.contextPolicy}): ${primaryContext}`,
       `Secondary context: ${secondaryContext}`,
+      `Write policy: ${this.settings.changeApplyPolicy}`,
       `Merged additional context: ${additionalSummary}`,
       "Suggested next steps:",
       "1. Validate key claims in your note.",
@@ -955,6 +1130,9 @@ var CopilotSidebarPlugin = class extends import_obsidian.Plugin {
     ].join(" ");
   }
   async maybeCreatePendingChange(prompt, response, context) {
+    if (this.settings.authState !== "logged-in") {
+      return;
+    }
     if (!context.notePath || !context.noteContent) {
       return;
     }

scripts/smoke-assert.mjs

@@ -21,7 +21,9 @@ const requiredCommands = [
   "apply-pending-changes",
   "ask-about-current-note",
   "open-copilot-sidebar",
+  "open-sidebar-settings-panel",
   "refresh-auth-status",
+  "retry-last-failed-prompt",
   "start-new-chat-session",
   "undo-last-applied-change"
 ];