@vinihcrosa/lumem-os 0.3.1 → 0.5.0

package/README.md

@@ -52,7 +52,7 @@ This is the path `pnpm smoke:install` exercises, one throwaway prefix at a time.
 | Node | 22 or newer |
 | git | 2.30 or newer — the whole product is worktrees |
 | An ACP agent | the `claude` CLI, for the agent conversation. The first-run screen installs the adapter for you |
-| OS | macOS and Linux. Windows is not supported ([why](docs/prd/distribution/prd.md)) |
+| OS | macOS and Linux. Windows is not supported ([why](docs/features/014-distribution/prd.md)) |
 
 Nothing else: the two native dependencies (`better-sqlite3`, `node-pty`) ship
 prebuilt binaries, so a global install compiles nothing on the common platforms.
@@ -65,12 +65,12 @@ conversations, memory. `--state-dir` moves it.
 
 | | |
 |---|---|
-| [Projects and worktrees](docs/prd/walking-skeleton/prd.md) | register a repo by path or [clone it from a URL](docs/prd/project-from-url/prd.md); cut worktrees from the product instead of the terminal |
-| [Agent conversations over ACP](docs/prd/acp-sessions/prd.md) | plan, usage and cost, slash commands, an embedded terminal, and the conversation **on disk** — closing Lumem does not lose it |
-| [Files, diff and an editor](docs/prd/file-editor/prd.md) | browse the checkout, read the diff against the base branch, and edit with autosave |
-| [Project scripts](docs/prd/project-scripts/prd.md) | `setup`, `run`, `test` and `teardown` live in `<repo>/.lumem/project.toml`; a new worktree is born prepared, and one click brings the app up on a port reserved for that checkout |
-| [Workspace memory](docs/prd/workspace-memory/prd.md) | what the harness learned, versioned in git, behind a write gate and an inbox of proposals. The three switches that spend tokens ship **off** |
-| [Pull request status](docs/prd/pull-request-status/prd.md) | designed, not built: which of your worktrees is actually mergeable |
+| [Projects and worktrees](docs/features/001-walking-skeleton/prd.md) | register a repo by path or [clone it from a URL](docs/features/011-project-from-url/prd.md); cut worktrees from the product instead of the terminal |
+| [Agent conversations over ACP](docs/features/006-acp-sessions/prd.md) | plan, usage and cost, slash commands, an embedded terminal, and the conversation **on disk** — closing Lumem does not lose it |
+| [Files, diff and an editor](docs/features/005-file-editor/prd.md) | browse the checkout, read the diff against the base branch, and edit with autosave |
+| [Project scripts](docs/features/012-project-scripts/prd.md) | `setup`, `run`, `test` and `teardown` live in `<repo>/.lumem/project.toml`; a new worktree is born prepared, and one click brings the app up on a port reserved for that checkout |
+| [Workspace memory](docs/features/007-workspace-memory/prd.md) | what the harness learned, versioned in git, behind a write gate and an inbox of proposals. The three switches that spend tokens ship **off** |
+| [Pull request status](docs/features/013-pull-request-status/prd.md) | which of your worktrees is actually mergeable, read from the `gh` on your machine — Lumem never sees, asks for or stores a token |
 
 ## How it works
 

package/bin/lumem.mjs

@@ -4335,6 +4335,27 @@ var acpEventSchema = external_exports.discriminatedUnion("type", [
     /** O tamanho do bloco, em caracteres — a marca d'água. */
     chars: external_exports.number().int().nonnegative()
   }),
+  /**
+   * O teto do workspace falou (`028` §6, Parte 3 — T16).
+   *
+   * Ele **aparece na conversa**, e não só numa tela de configuração, pela mesma
+   * razão que a memória injetada aparece: o que o daemon faz por conta própria
+   * tem de ser legível no lugar onde a consequência acontece.
+   *
+   * `warn` é o turno de quem **conduz** — o número vai junto e a conversa segue.
+   * `block` é o da esteira, que para. A Q45 registra por que os dois existem: o
+   * mesmo número, a mesma leitura, verbos diferentes.
+   */
+  external_exports.object({
+    type: external_exports.literal("budget"),
+    outcome: external_exports.enum(["warn", "block"]),
+    /** Qual teto segurou. O bloqueio nomeia, senão mexer nele é adivinhação. */
+    cap: external_exports.enum(["cost-per-task", "cost-per-day", "turns-per-session"]),
+    limit: external_exports.number().nonnegative(),
+    spent: external_exports.number().nonnegative(),
+    /** A frase pronta, porque quem monta a frase é quem sabe a unidade. */
+    message: external_exports.string()
+  }),
   /**
    * An event the daemon received and could not name.
    *
@@ -4462,14 +4483,51 @@ var CLAUDE_ADAPTER = {
   // Duas strings porque não são a mesma string, e é exatamente essa a armadilha:
   // o pacote é escopado e o binário não.
   command: "claude-agent-acp",
-  pinnedVersion: "0.40.0",
-  cli: { command: "claude", install: null },
-  apiKeyEnv: ["ANTHROPIC_API_KEY"]
+  /*
+   * Medido em 2026-09-08, e a medição é o motivo de não ser `0.40.0`.
+   *
+   * O adaptador **embute** o runtime: `0.40.0` depende de
+   * `@anthropic-ai/claude-agent-sdk@0.3.160`, que é o Claude Code `2.1.160`, e a
+   * API recusa o modelo default desta conta com *"version 2.1.251 or newer is
+   * required"*. Quem responde `session/prompt` é o SDK de dentro, então o
+   * `claude` do PATH — `2.1.263` na máquina que mediu — não salva.
+   *
+   * `0.75.1` traz o SDK `0.3.257`. O estudo, com as duas versões lado a lado,
+   * está em `docs/project/claude-agent-acp-0.75.md`.
+   */
+  pinnedVersion: "0.75.1",
+  /*
+   * `null` desde 2026-09-08, e isto **reverte** o que estava escrito no §
+   * `cli` opcional acima: *"o `claude-agent-acp`, ao contrário, é um adaptador que
+   * dirige um binário que tem que existir"*. Era verdade no `0.40.0`. Deixou de
+   * ser, e a medição é o motivo — três vezes, no `0.75.1`:
+   *
+   * - com o `claude` fora do PATH (só `node` nele), `initialize` e `session/new`
+   *   fecham e ele lista os cinco modelos, Opus 5 incluído;
+   * - o daemon em execução spawna
+   *   `@anthropic-ai/claude-agent-sdk-darwin-arm64/claude` — o binário de **dentro**
+   *   do pacote, nunca o do PATH;
+   * - os `authMethods` que ele oferece têm `args: ["--cli", "auth", "login",
+   *   "--claudeai"]`. O `--cli` é do próprio adaptador; não há um `claude` a chamar.
+   *
+   * O que o processo filho ainda precisa do PATH é o keychain: com só `node`,
+   * `session/prompt` responde `Authentication required`; com `/usr/bin/security` ao
+   * lado, o mesmo turno fecha em `end_turn`. Isso é ambiente, não proveniência — a
+   * distinção está na [Q3](../../../docs/features/027-adapter-provenance/open-questions.md).
+   */
+  cli: null,
+  // Medido: `0.40.0` embutia o `0.3.160` e `0.75.1` embute o `0.3.257`, e o
+  // número depois do `0.3.` é o do Claude Code que a API cobra na recusa.
+  runtime: "@anthropic-ai/claude-agent-sdk",
+  apiKeyEnv: ["ANTHROPIC_API_KEY"],
+  // Medido na Q43, e é o único dos cinco que fecha o laço: `default`, `plan`,
+  // `acceptEdits` e `dontAsk` param no primeiro `Edit` esperando alguém.
+  autonomousMode: "bypassPermissions"
 };
 var DEFAULT_ADAPTER_ID = CLAUDE_ADAPTER.id;
 
 // ../shared/src/constants.ts
-var LUMEM_VERSION = "0.3.1";
+var LUMEM_VERSION = "0.5.0";
 
 // ../shared/src/pty-protocol.ts
 var ptySessionStateSchema = external_exports.enum(["running", "exited"]);