issue-flow 0.7.7 → 0.8.0

package/dist/{chunk-WGDLUPSF.js → chunk-TGP6WK65.js}

@@ -6,14 +6,14 @@ import {
 } from "./chunk-HDV3YDTG.js";
 import {
   publishGitState
-} from "./chunk-XPW46TI5.js";
+} from "./chunk-J3PJBZXJ.js";
 import {
   EXECUTE_PHASE,
   elapsedSecondsSince,
   getPhaseUsageTotals,
   publishIterationMetrics,
   publishStoryMetrics
-} from "./chunk-ZYBYMEWG.js";
+} from "./chunk-QO2MWMAZ.js";
 import {
   applyPlaceholders,
   loadPrompt
@@ -22,7 +22,7 @@ import {
   createConfig,
   resolvePaths,
   validateDependencies
-} from "./chunk-RUTDK6ZF.js";
+} from "./chunk-BASRRXAM.js";
 import {
   allStoriesPass,
   applyStoryMetrics,
@@ -53,7 +53,7 @@ import {
   trimErrorMessage,
   useColor,
   useUnicode
-} from "./chunk-WO6ERABE.js";
+} from "./chunk-BH7DYADV.js";
 
 // src/core/engine.ts
 import { existsSync } from "fs";
@@ -610,4 +610,4 @@ export {
   printRunSummary,
   runExecute
 };
-//# sourceMappingURL=chunk-WGDLUPSF.js.map
+//# sourceMappingURL=chunk-TGP6WK65.js.map

package/dist/{chunk-G37JNQKB.js → chunk-VPDWTZ3F.js}

@@ -4,7 +4,7 @@ import {
   printInfo,
   printSuccess,
   printWarning
-} from "./chunk-WO6ERABE.js";
+} from "./chunk-BH7DYADV.js";
 
 // src/commands/init.ts
 import { execa } from "execa";
@@ -132,4 +132,4 @@ async function runInit(source = "github") {
 export {
   runInit
 };
-//# sourceMappingURL=chunk-G37JNQKB.js.map
+//# sourceMappingURL=chunk-VPDWTZ3F.js.map

package/dist/{chunk-6IOPYFUM.js → chunk-VSF2CR3G.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   listPullRequests
-} from "./chunk-XPW46TI5.js";
+} from "./chunk-J3PJBZXJ.js";
 import {
   runHeadless
-} from "./chunk-KHTLN54U.js";
+} from "./chunk-JWZKV3CL.js";
 import {
   publishPhaseMetrics
-} from "./chunk-ZYBYMEWG.js";
+} from "./chunk-QO2MWMAZ.js";
 import {
   applyPlaceholders,
   loadPrompt
@@ -17,7 +17,7 @@ import {
   loadPrReviewConfig,
   resolveIssuePaths,
   run
-} from "./chunk-RUTDK6ZF.js";
+} from "./chunk-BASRRXAM.js";
 import {
   getGlobalTimeout,
   getSessionPublisher,
@@ -29,7 +29,7 @@ import {
   printWarning,
   saveTaskPlan,
   writeFileAtomic
-} from "./chunk-WO6ERABE.js";
+} from "./chunk-BH7DYADV.js";
 
 // src/commands/pr-review.ts
 import { join as join3 } from "path";
@@ -733,4 +733,4 @@ export {
   exitCodeFor,
   runPrReview
 };
-//# sourceMappingURL=chunk-6IOPYFUM.js.map
+//# sourceMappingURL=chunk-VSF2CR3G.js.map

package/dist/cli.js

@@ -2,12 +2,12 @@
 import {
   setIssuesCliOverrides,
   setWebCliOverrides
-} from "./chunk-RUTDK6ZF.js";
+} from "./chunk-BASRRXAM.js";
 import {
   printError,
   setGlobalTimeout,
   setVerbose
-} from "./chunk-WO6ERABE.js";
+} from "./chunk-BH7DYADV.js";
 
 // src/cli.ts
 import { createRequire } from "module";
@@ -159,8 +159,8 @@ withIssueOptions(
     program.command("init").description("Verify that all prerequisites (claude, gh, git) are met")
   )
 ).action(async () => {
-  const { loadIssuesConfig } = await import("./config-OAZG7KIK.js");
-  const { runInit } = await import("./init-TBC3WI74.js");
+  const { loadIssuesConfig } = await import("./config-R7O5YC65.js");
+  const { runInit } = await import("./init-WP7Z2LFQ.js");
   const { preferredProvider } = await loadIssuesConfig();
   const code = await runInit(preferredProvider);
   process.exit(code);
@@ -178,7 +178,7 @@ withGlobalOptions(
     }
     throw error;
   }
-  const { runGenerate } = await import("./generate-BEJF3SVJ.js");
+  const { runGenerate } = await import("./generate-TGJQLGMV.js");
   const code = await runGenerate(options.prompt, target);
   process.exit(code);
 });
@@ -202,7 +202,7 @@ withWebOptions(
       }
       throw error;
     }
-    const { runPipeline } = await import("./run-SEB6F3W4.js");
+    const { runPipeline } = await import("./run-2CXVR3VZ.js");
     const code = await runPipeline(
       issue,
       options.mode,
@@ -218,7 +218,7 @@ withIssueOptions(
     program.command("analyze").description("Analyze an issue via Claude Code Headless").argument("<issue>", "Issue number")
   )
 ).action(async (issue) => {
-  const { runAnalyze } = await import("./analyze-2RVGY5OK.js");
+  const { runAnalyze } = await import("./analyze-RBNKXWL5.js");
   const code = await runAnalyze(issue);
   process.exit(code);
 });
@@ -227,7 +227,7 @@ withIssueOptions(
     program.command("prd").description("Generate a PRD from an analyzed issue via Claude Code Headless").argument("<issue>", "Issue number")
   )
 ).action(async (issue) => {
-  const { runPrd } = await import("./prd-MBSSBLGO.js");
+  const { runPrd } = await import("./prd-FPZAHQEO.js");
   const code = await runPrd(issue);
   process.exit(code);
 });
@@ -236,7 +236,7 @@ withIssueOptions(
     program.command("plan").description("Convert a PRD to a tasks.json task plan via Claude Code Headless").argument("<issue>", "Issue number")
   )
 ).action(async (issue) => {
-  const { runPlan } = await import("./plan-YDZYB2BO.js");
+  const { runPlan } = await import("./plan-2MWMCKRY.js");
   const code = await runPlan(issue);
   process.exit(code);
 });
@@ -255,7 +255,7 @@ withWebOptions(
 ).action(
   async (positionalMaxIter, options) => {
     try {
-      const { runExecute } = await import("./execute-AOEM52CD.js");
+      const { runExecute } = await import("./execute-LU3HWA54.js");
       const code = await runExecute(positionalMaxIter, options);
       process.exit(code);
     } catch (error) {
@@ -269,7 +269,7 @@ withIssueOptions(
     program.command("review").description("Validate an issue resolution via Claude Code Headless").argument("<issue>", "Issue number")
   )
 ).action(async (issue) => {
-  const { runReview } = await import("./review-2MDDHZ4X.js");
+  const { runReview } = await import("./review-AHALLMXO.js");
   const code = await runReview(issue);
   process.exit(code);
 });
@@ -278,7 +278,7 @@ withIssueOptions(
     program.command("pr").description("Create a pull request via Claude Code Headless").argument("<issue>", "Issue number")
   )
 ).action(async (issue) => {
-  const { runPr } = await import("./pr-SIXMJIZF.js");
+  const { runPr } = await import("./pr-XVQDEQ7B.js");
   const code = await runPr(issue);
   process.exit(code);
 });
@@ -286,14 +286,14 @@ var webCommand = program.command("web").description("Manage the web monitoring s
 webCommand.command("serve").description(
   "Run the web monitor server in the foreground (internal \u2014 spawned detached by --web)"
 ).option("--port <n>", "Web server port (default: 3737)", parseInteger).option("--host <h>", "Web server host (default: 0.0.0.0)").option("--refresh <s>", "Suggested UI polling interval in seconds", parseInteger).action(async (options) => {
-  const { runWebServe } = await import("./web-3SBYL7QJ.js");
+  const { runWebServe } = await import("./web-JVPK2PIF.js");
   const code = await runWebServe(options);
   if (code !== 0) {
     process.exit(code);
   }
 });
 webCommand.command("stop").description("Stop the running web monitor server").action(async () => {
-  const { runWebStop } = await import("./web-3SBYL7QJ.js");
+  const { runWebStop } = await import("./web-JVPK2PIF.js");
   const code = await runWebStop();
   process.exit(code);
 });
@@ -304,7 +304,7 @@ withGlobalOptions(
   )
 ).action(
   async (pr, options) => {
-    const { runPrReview } = await import("./pr-review-AY56ZPJR.js");
+    const { runPrReview } = await import("./pr-review-VO6ZXAFM.js");
     const code = await runPrReview(pr, options);
     process.exit(code);
   }

package/dist/{config-OAZG7KIK.js → config-R7O5YC65.js}

@@ -15,8 +15,8 @@ import {
   setIssuesCliOverrides,
   setWebCliOverrides,
   validateDependencies
-} from "./chunk-RUTDK6ZF.js";
-import "./chunk-WO6ERABE.js";
+} from "./chunk-BASRRXAM.js";
+import "./chunk-BH7DYADV.js";
 export {
   DEFAULTS,
   GLOBAL_CONFIG_FILENAME,
@@ -34,4 +34,4 @@ export {
   setWebCliOverrides,
   validateDependencies
 };
-//# sourceMappingURL=config-OAZG7KIK.js.map
+//# sourceMappingURL=config-R7O5YC65.js.map

package/dist/execute-LU3HWA54.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import {
+  runExecute
+} from "./chunk-TGP6WK65.js";
+import "./chunk-HDV3YDTG.js";
+import "./chunk-J3PJBZXJ.js";
+import "./chunk-QO2MWMAZ.js";
+import "./chunk-SLHZPB3C.js";
+import "./chunk-BASRRXAM.js";
+import "./chunk-BH7DYADV.js";
+export {
+  runExecute
+};
+//# sourceMappingURL=execute-LU3HWA54.js.map

package/dist/{generate-BEJF3SVJ.js → generate-TGJQLGMV.js}

@@ -3,13 +3,13 @@ import {
   ensureProvidersRegistered,
   getProvider,
   localIssueRef
-} from "./chunk-EYVXLRRD.js";
+} from "./chunk-HSGTZ3CT.js";
 import {
   runHeadless
-} from "./chunk-KHTLN54U.js";
+} from "./chunk-JWZKV3CL.js";
 import {
   publishPhaseMetrics
-} from "./chunk-ZYBYMEWG.js";
+} from "./chunk-QO2MWMAZ.js";
 import {
   applyPlaceholders,
   loadPrompt
@@ -17,13 +17,13 @@ import {
 import {
   loadIssuesConfig,
   resolveProjectPaths
-} from "./chunk-RUTDK6ZF.js";
+} from "./chunk-BASRRXAM.js";
 import {
   getGlobalTimeout,
   isoNow,
   printError,
   printSuccess
-} from "./chunk-WO6ERABE.js";
+} from "./chunk-BH7DYADV.js";
 
 // src/issues/draft.ts
 var DRAFT_TAG = "issue-draft";
@@ -153,4 +153,4 @@ async function runGenerate(promptText, target) {
 export {
   runGenerate
 };
-//# sourceMappingURL=generate-BEJF3SVJ.js.map
+//# sourceMappingURL=generate-TGJQLGMV.js.map

package/dist/init-WP7Z2LFQ.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import {
+  runInit
+} from "./chunk-VPDWTZ3F.js";
+import "./chunk-BH7DYADV.js";
+export {
+  runInit
+};
+//# sourceMappingURL=init-WP7Z2LFQ.js.map

package/dist/plan-2MWMCKRY.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import {
+  runPlan
+} from "./chunk-MK43N4X3.js";
+import "./chunk-RQW5W4XC.js";
+import "./chunk-HSGTZ3CT.js";
+import "./chunk-HDV3YDTG.js";
+import "./chunk-JWZKV3CL.js";
+import "./chunk-QO2MWMAZ.js";
+import "./chunk-SLHZPB3C.js";
+import "./chunk-BASRRXAM.js";
+import "./chunk-BH7DYADV.js";
+export {
+  runPlan
+};
+//# sourceMappingURL=plan-2MWMCKRY.js.map

package/dist/pr-XVQDEQ7B.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import {
+  runPr
+} from "./chunk-J4SICTAN.js";
+import "./chunk-RQW5W4XC.js";
+import "./chunk-HSGTZ3CT.js";
+import "./chunk-HDV3YDTG.js";
+import "./chunk-JWZKV3CL.js";
+import "./chunk-QO2MWMAZ.js";
+import "./chunk-SLHZPB3C.js";
+import "./chunk-BASRRXAM.js";
+import "./chunk-BH7DYADV.js";
+export {
+  runPr
+};
+//# sourceMappingURL=pr-XVQDEQ7B.js.map

package/dist/pr-review-VO6ZXAFM.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import {
+  exitCodeFor,
+  runPrReview
+} from "./chunk-VSF2CR3G.js";
+import "./chunk-J3PJBZXJ.js";
+import "./chunk-JWZKV3CL.js";
+import "./chunk-QO2MWMAZ.js";
+import "./chunk-SLHZPB3C.js";
+import "./chunk-BASRRXAM.js";
+import "./chunk-BH7DYADV.js";
+export {
+  exitCodeFor,
+  runPrReview
+};
+//# sourceMappingURL=pr-review-VO6ZXAFM.js.map

package/dist/prd-FPZAHQEO.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import {
+  runPrd
+} from "./chunk-36ECROTC.js";
+import "./chunk-RQW5W4XC.js";
+import "./chunk-HSGTZ3CT.js";
+import "./chunk-HDV3YDTG.js";
+import "./chunk-JWZKV3CL.js";
+import "./chunk-QO2MWMAZ.js";
+import "./chunk-SLHZPB3C.js";
+import "./chunk-BASRRXAM.js";
+import "./chunk-BH7DYADV.js";
+export {
+  runPrd
+};
+//# sourceMappingURL=prd-FPZAHQEO.js.map

package/dist/review-AHALLMXO.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import {
+  runReview
+} from "./chunk-A4M6AKIK.js";
+import "./chunk-HSGTZ3CT.js";
+import "./chunk-JWZKV3CL.js";
+import "./chunk-QO2MWMAZ.js";
+import "./chunk-SLHZPB3C.js";
+import "./chunk-BASRRXAM.js";
+import "./chunk-BH7DYADV.js";
+export {
+  runReview
+};
+//# sourceMappingURL=review-AHALLMXO.js.map

package/dist/{run-SEB6F3W4.js → run-2CXVR3VZ.js}

@@ -1,52 +1,52 @@
 #!/usr/bin/env node
 import {
   runPrd
-} from "./chunk-6L2BPOE3.js";
+} from "./chunk-36ECROTC.js";
 import {
   runReview
-} from "./chunk-EOTULFWV.js";
+} from "./chunk-A4M6AKIK.js";
 import {
   ensureWebMonitor
-} from "./chunk-JOK7VXRV.js";
+} from "./chunk-F52S6ZGF.js";
 import {
   runInit
-} from "./chunk-G37JNQKB.js";
+} from "./chunk-VPDWTZ3F.js";
 import {
   printRunSummary,
   runExecute
-} from "./chunk-WGDLUPSF.js";
+} from "./chunk-TGP6WK65.js";
 import {
   runPlan
-} from "./chunk-3E6KASSE.js";
+} from "./chunk-MK43N4X3.js";
 import {
   runPr
-} from "./chunk-6UTVPKNF.js";
-import "./chunk-OPIDR2DC.js";
+} from "./chunk-J4SICTAN.js";
+import "./chunk-RQW5W4XC.js";
 import {
   getProvider,
   resolveCommandIssue
-} from "./chunk-EYVXLRRD.js";
+} from "./chunk-HSGTZ3CT.js";
 import "./chunk-HDV3YDTG.js";
 import {
   mostRecent,
   prReviewDir,
   readPrReviewIndex,
   runPrReview
-} from "./chunk-6IOPYFUM.js";
+} from "./chunk-VSF2CR3G.js";
 import {
   listPullRequests,
   publishGitState
-} from "./chunk-XPW46TI5.js";
-import "./chunk-KHTLN54U.js";
+} from "./chunk-J3PJBZXJ.js";
+import "./chunk-JWZKV3CL.js";
 import {
   getRunUsageTotals
-} from "./chunk-ZYBYMEWG.js";
+} from "./chunk-QO2MWMAZ.js";
 import "./chunk-SLHZPB3C.js";
 import {
   loadIssuesConfig,
   loadWebConfig,
   resolveIssuePaths
-} from "./chunk-RUTDK6ZF.js";
+} from "./chunk-BASRRXAM.js";
 import {
   FilePublisher,
   NullPublisher,
@@ -60,7 +60,7 @@ import {
   setOutputCallback,
   setSessionPublisher,
   setStoryUpdateCallback
-} from "./chunk-WO6ERABE.js";
+} from "./chunk-BH7DYADV.js";
 
 // src/commands/run.ts
 import { randomUUID } from "crypto";
@@ -730,4 +730,4 @@ export {
   publishStorySeed,
   runPipeline
 };
-//# sourceMappingURL=run-SEB6F3W4.js.map
+//# sourceMappingURL=run-2CXVR3VZ.js.map

package/dist/{web-3SBYL7QJ.js → web-JVPK2PIF.js}

@@ -4,20 +4,20 @@ import {
   getWebLockFile,
   readWebLock,
   removeWebLock
-} from "./chunk-JOK7VXRV.js";
+} from "./chunk-F52S6ZGF.js";
 import "./chunk-SLHZPB3C.js";
 import {
   ISSUES_DIR_NAME,
   PROJECTS_DIR_NAME,
   getGlobalRoot,
   loadWebConfig
-} from "./chunk-RUTDK6ZF.js";
+} from "./chunk-BASRRXAM.js";
 import {
   printError,
   printInfo,
   printWarning,
   sessionSnapshotSchema
-} from "./chunk-WO6ERABE.js";
+} from "./chunk-BH7DYADV.js";
 
 // src/web/session-directory.ts
 import { readdir, readFile, stat as statFile } from "fs/promises";
@@ -185,4 +185,4 @@ export {
   runWebServe,
   runWebStop
 };
-//# sourceMappingURL=web-3SBYL7QJ.js.map
+//# sourceMappingURL=web-JVPK2PIF.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "issue-flow",
-  "version": "0.7.7",
+  "version": "0.8.0",
   "description": "Unified CLI for orchestrating the full issue-flow pipeline via Claude Code Headless",
   "type": "module",
   "bin": {

package/web/CLAUDE.md

@@ -20,6 +20,54 @@ zero é um valor legítimo.
 Texto dinâmico sempre via `textContent`/`el()`; nunca `innerHTML` com dados
 do snapshot.
 
+## Abas, Kanban e drawer
+
+O painel tem duas abas ("Execução" e "Kanban") e um drawer de detalhes por
+story. Três regras seguram esse conjunto:
+
+- **Acesso a story sempre por `getStoryById()` / `getStories()`.** Elas são a
+  camada de leitura: normalizam num lugar só o que pode faltar num
+  `session.json` antigo (`status` → `'backlog'`, `dependencies`/
+  `acceptanceCriteria` → `[]`, `description` → `''`) e são o ponto onde uma
+  futura camada de escrita entra. Nenhum consumidor varre `snapshot.stories`
+  por conta própria, ou a normalização se espalha.
+- **Estado de UI vive em `state`** (`activeTab`, `selectedStoryId`), junto de
+  `logFilter`, nunca em variável solta ou em referência a nó do DOM. O drawer
+  guarda o **id** da story, não o card: `render()` recria o Kanban a cada poll,
+  então uma referência guardada na abertura apontaria para um nó fora do
+  documento. Pelo mesmo motivo o foco volta ao card via
+  `[data-story-id="…"]` no momento de fechar.
+- **`renderKanban()` e `renderDrawer()` são chamadas incondicionalmente** dentro
+  de `render()`, não ao trocar de aba. Uma aba inativa não pode ficar defasada,
+  e é o `renderDrawer()` de cada poll que mantém o drawer aberto em dia (e o
+  fecha quando a story some do plano).
+
+Cada card do Kanban é um `<button>` — Enter/Espaço e foco saem de graça. Como
+`<button>` só aceita *phrasing content*, todo o conteúdo interno é `<span>` com
+`display: block`/`flex` no CSS; `<p>` ou `<div>` ali dentro é HTML inválido.
+
+Detalhes cosméticos que não são cosméticos: `.tab-panel[hidden]` e
+`.drawer[hidden]` precisam de `display: none` explícito, senão o `display:
+grid`/`flex` da regra base vence o atributo `hidden`. E o overlay/drawer ficam
+em `z-index` 20/21 para cobrir o `.banner` de desconexão, que é `sticky` com
+`z-index: 10`.
+
+## Escrita: o que ainda não existe
+
+A interface é somente leitura por contrato (`snapshot.readOnly === true`,
+`capabilities: []`), e o servidor não registra nenhuma rota de escrita — o
+comentário em `src/web/server.ts` reserva `POST /api/control/*` para isso. O
+Kanban e o drawer foram desenhados para que a escrita caiba depois sem
+redesenhar a interação: o drawer já é o lugar onde uma story é inspecionada por
+id, e `getStoryById()` já é o único ponto por onde ela é lida.
+
+Quando essa etapa chegar, o contrato esperado é: as rotas de escrita passam a
+ser anunciadas em `capabilities` (o client decide o que renderizar a partir
+disso, nunca da versão do servidor), `readOnly` passa a `false`, e cada
+mutação responde com o snapshot atualizado para que a UI não precise adivinhar
+o efeito nem esperar o próximo poll. Enquanto `capabilities` estiver vazio,
+nenhum controle de escrita deve aparecer na tela.
+
 ## Métricas (tokens e custo)
 
 `formatUsage()` espelha `formatTokens()` de `src/core/metrics.ts` — mesma