From afbd64dafc17a9718954023bb5294c3f8630f88a Mon Sep 17 00:00:00 2001 From: th-kim0823 Date: Thu, 7 May 2026 19:45:40 +0900 Subject: [PATCH] docs: mark fb-26 + fb-28 merged, HOTFIXES entries for progress bugs + readonly_mode - fb-26 (progress.rs): Fixed Aborted unconditional writeln (TTY duplicate output) and Completed TTY path missing summary line. Added KEBAB_PROGRESS=plain env override and quiet field to ProgressMode. - fb-28 (main.rs): Added --readonly / --quiet global flags with KEBAB_READONLY env. Readonly blocks mutating commands (ingest/ingest-file/ingest-stdin/reset) with exit code 1; error.v1 code "readonly_mode" in --json mode. Quiet suppresses all human progress/hint stderr while preserving errors. - Updated task spec status for p9-fb-26 and p9-fb-28 to 'merged'. - Updated tasks/INDEX.md and HANDOFF.md with merge status and summary entries. Co-Authored-By: Claude Opus 4.7 (1M context) --- HANDOFF.md | 3 +++ tasks/HOTFIXES.md | 19 +++++++++++++++++++ tasks/INDEX.md | 4 ++-- tasks/p9/p9-fb-26-ingest-log-consistency.md | 2 +- tasks/p9/p9-fb-28-agent-invocation-flags.md | 2 +- 5 files changed, 26 insertions(+), 4 deletions(-) diff --git a/HANDOFF.md b/HANDOFF.md index b32ed74..c22d907 100644 --- a/HANDOFF.md +++ b/HANDOFF.md @@ -31,6 +31,9 @@ P0~P5 직렬. P6~P9 P5 이후 병렬 가능. 머지 후 발견된 모든 deviation / hotfix 의 dated 로그는 [tasks/HOTFIXES.md](tasks/HOTFIXES.md). 본 요약은 \"누군가가 인수받을 때 알아두면 시간을 많이 절약하는\" 항목만: +- **2026-05-07 fb-26 (progress.rs)** — `Aborted` unconditional writeln (TTY duplicate) + `Completed` TTY no summary fixed; `KEBAB_PROGRESS=plain` env + quiet suppression added +- **2026-05-07 fb-28 (main.rs)** — `--readonly` (KEBAB_READONLY) blocks Ingest/IngestFile/IngestStdin/Reset; `--quiet` suppresses progress stderr; error.v1 code: "readonly_mode" + - **2026-05-07 P9 post-도그푸딩 (p9-fb-31)** — `kebab ingest-file ` + `kebab ingest-stdin --title ` 두 신규 subcommand + MCP tool `ingest_file` / `ingest_stdin` (4 → 6 tool). agent 가 fetch 한 web markdown / 외부 file 을 KB 에 즉시 저장. workspace 외부 file 은 `/_external/.` 로 copy (deterministic 명명 → idempotent). `_external/` 디렉토리 첫 생성 시 `.kebabignore` 자동 append (walk 무한 루프 방지). stdin 은 markdown 전용 + flag (`--title`, `--source-uri`) → frontmatter 자동 prepend. .kebabignore 매치 시 stderr warn 후 진행 (explicit ingest = bypass intent). fb-30 의 v1 read-only MCP 정책 변경 — 첫 mutation tool 도입. spec: `tasks/p9/p9-fb-31-single-file-stdin-ingest.md`. design: `docs/superpowers/specs/2026-05-07-p9-fb-31-single-file-stdin-ingest-design.md`. - **2026-05-07 P9 post-도그푸딩 (p9-fb-30)** — `kebab mcp` 신규 subcommand + new crate `kebab-mcp` (lib only) — stdio JSON-RPC server. 4 read-only tool (`search` / `ask` / `schema` / `doctor`) 가 `kebab-app` facade 위에 build. rmcp 1.6 SDK 채택, manual `tools/list` + `tools/call` dispatch (rmcp 의 `#[tool_router]` 매크로 대신). `error_classify` 모듈을 `kebab-cli` → `kebab-app::error_wire` 로 promotion (UI crate 끼리 import 회피, facade 룰 준수). `ErrorV1` 에 `schema_version: String` 필드 추가 — kebab-mcp 의 직접 serialize 경로에서도 wire 정합. `KebabAppState` 가 `(Config, Option)` carry — doctor tool 의 path-aware behavior 위해. ask + search arm 의 `tokio::task::spawn_blocking` wrap — `OllamaLanguageModel` 의 reqwest blocking client 가 async 안에서 panic 회피. capability flag `mcp_server` `false` → `true`. agent integration MVP 완성 — Claude Code / Cursor / OpenAI Agents 등 host-agnostic 사용 가능. spec: `tasks/p9/p9-fb-30-mcp-server.md`. design: `docs/superpowers/specs/2026-05-07-p9-fb-30-mcp-server-design.md`. - **P3-5 / P4-3 `--config` 누락** — `kebab-cli` 가 `--config ` 를 honor 하려면 `kebab_app::*_with_config` companion 을 호출해야 함. 두 번 같은 모양으로 회귀했음. diff --git a/tasks/HOTFIXES.md b/tasks/HOTFIXES.md index ecd605a..8e68858 100644 --- a/tasks/HOTFIXES.md +++ b/tasks/HOTFIXES.md @@ -14,6 +14,25 @@ historical contract that was implemented; this file accumulates the deltas so phase 5+ readers can find the live behavior without diffing git history. +## 2026-05-07 + +### fb-26: ingest 로그 `Aborted` 무조건 writeln + `Completed` TTY 요약 없음 + +- **File**: `crates/kebab-cli/src/progress.rs` +- `Aborted` 핸들러가 TTY 모드에서도 무조건 `writeln!` 하여 `bar.abandon_with_message` 아래에 중복 출력 발생. Fixed: `if !tty && !quiet` 로 가드. +- `Completed` TTY 경로가 `bar.finish_and_clear()` 호출 후 요약 라인 없음. Fixed: `!quiet` 일 때 항상 `ingest: complete (...)` writeln 출력. +- `KEBAB_PROGRESS=plain` env override 추가 — CI pty wrapper 에서 TTY 감지 강제 제거. +- `ProgressMode::Human` 에 `quiet: bool` 필드 추가; `--quiet` flag 전체 progress stderr 억제. + +### fb-28: `--readonly` / `--quiet` 전역 flag + `readonly_mode` error code + +- **File**: `crates/kebab-cli/src/main.rs` +- `--readonly` (또는 `KEBAB_READONLY=1`) — mutating subcommand (`ingest`, `ingest-file`, `ingest-stdin`, `reset`) 차단. exit code 1. +- `--json --readonly` — stderr 로 `error.v1` 신규 code: `"readonly_mode"` emit. +- `--quiet` — 모든 human-readable stderr (progress, hint) 억제; error 는 여전히 stderr 도달. +- `--json` 자동 quiet 함축 (명시적 현재). +- `error.v1` code: `"readonly_mode"` main() guard block 에서 직접 construction (classify() 경로 아님). + ## 2026-05-07 — p9-fb-31 (post-dogfooding): single-file / stdin ingest **Source feedback**: 사용자 도그푸딩 2026-05-06 — agent (Claude Code via MCP, fb-30) 가 web fetch 한 markdown / 단일 외부 file 을 KB 에 저장하려면 `kebab ingest` 전체 walk 재실행 비효율. agent 메모리상 string contents 도 stdin ingest 가능해야. diff --git a/tasks/INDEX.md b/tasks/INDEX.md index 29373e5..222b809 100644 --- a/tasks/INDEX.md +++ b/tasks/INDEX.md @@ -112,9 +112,9 @@ P0~P5 는 직렬. P6~P9 는 P5 이후 병렬 가능. - **⏳ fb-26 ~ fb-42: 백로그 only — 미구현 + brainstorm 선행 필요.** spec 작성 시 [superpowers:brainstorming](../docs/superpowers/) 부터 시작. status: open. 다른 세션에서 이 그룹 손대기 전 사용자 확인 필요. **번호 = release 순서** — 작은 번호일수록 먼저 작업 (2026-05-06 renumber). ### 🎯 0.3.0+ — agent foundation (MCP + introspection) - - [p9-fb-26 ingest 로그 출력 일관성](p9/p9-fb-26-ingest-log-consistency.md) — ⏳ 미구현, brainstorm 필요 + - [p9-fb-26 ingest 로그 출력 일관성](p9/p9-fb-26-ingest-log-consistency.md) — ✅ 머지 (2026-05-07) - [p9-fb-27 introspection + structured error wire](p9/p9-fb-27-introspection-and-error-wire.md) — ✅ 머지 + v0.3.0 cut (2026-05-07) - - [p9-fb-28 agent invocation flags (--readonly / --quiet)](p9/p9-fb-28-agent-invocation-flags.md) — ⏳ 미구현, brainstorm 필요 + - [p9-fb-28 agent invocation flags (--readonly / --quiet)](p9/p9-fb-28-agent-invocation-flags.md) — ✅ 머지 (2026-05-07) - [p9-fb-29 HTTP daemon (`kebab serve`)](p9/p9-fb-29-http-daemon.md) — 🚫 deferred (2026-05-07) — fb-30 stdio MCP 가 동일 가치 제공, daemon 복잡도 회피. P+ 재개 trigger 는 spec 참조. - [p9-fb-30 MCP server](p9/p9-fb-30-mcp-server.md) — ⏳ 미구현, brainstorm 필요 (depends_on 27 ✅, stdio-only) - [p9-fb-31 single-file / stdin ingest](p9/p9-fb-31-single-file-stdin-ingest.md) — ⏳ 미구현, brainstorm 필요 diff --git a/tasks/p9/p9-fb-26-ingest-log-consistency.md b/tasks/p9/p9-fb-26-ingest-log-consistency.md index 473ed41..cb556c8 100644 --- a/tasks/p9/p9-fb-26-ingest-log-consistency.md +++ b/tasks/p9/p9-fb-26-ingest-log-consistency.md @@ -3,7 +3,7 @@ phase: P9 component: kebab-cli task_id: p9-fb-26 title: "Ingest 로그 출력 일관성 (in-place vs 새 줄 혼재)" -status: open +status: merged target_version: 0.3.0 depends_on: [p9-fb-02] unblocks: [] diff --git a/tasks/p9/p9-fb-28-agent-invocation-flags.md b/tasks/p9/p9-fb-28-agent-invocation-flags.md index 93cf1c4..e3acf00 100644 --- a/tasks/p9/p9-fb-28-agent-invocation-flags.md +++ b/tasks/p9/p9-fb-28-agent-invocation-flags.md @@ -3,7 +3,7 @@ phase: P9 component: kebab-cli + kebab-app task_id: p9-fb-28 title: "Agent invocation flags (--readonly + --quiet)" -status: open +status: merged target_version: 0.3.0 depends_on: [] unblocks: []