@aksp/opencrew 1.6.3 → 1.7.1

package/templates/_opencrew/core/escritorio/sprites-mesa.js

@@ -0,0 +1,122 @@
+// A mesa de cada agente e o que muda nela, em matrizes de pixels: o tampo com os pés, o monitor
+// com as telas de cada status e os sinais que aparecem sobre a cabeça do boneco (✓, "!" e "?"
+// são desenhos, não texto). Quem diz onde cada desenho vai é `cena.js`.
+// Spec: fase-e1-escritorio-ao-vivo.md, regras 16, 18 e 19 (repositório do OpenCrew).
+import { CORES, matriz } from './sprites.js';
+
+/**
+ * A mesa vista de cima e de frente: o tampo (com teclado, papel e caneca), a borda, a saia com a
+ * gaveta e os pés. Tem a largura do retângulo da mesa no modelo e `MESA_ACIMA` linhas a mais.
+ */
+export const MESA = matriz({
+  o: CORES.tinta, t: CORES.madeiraLuz, T: CORES.madeira, F: CORES.madeiraMedia, D: CORES.madeiraEscura, x: CORES.junta,
+  k: CORES.cinzaEscuro, K: CORES.cinzaClaro, w: CORES.branco, g: CORES.cinzaClaro, c: CORES.ceu, f: CORES.madeiraEscura,
+}, [
+  '.oooooooooooooooooooooooooooooooooooooooooo.',
+  'otttttttttttttttkkkkkkkkkkkkttttttttttttttto',
+  'oTTTTTTTTTTTTTTTkKKKKKKKKKKkTTTTwwwwwwTcccTo',
+  'oTTTTTTTTTTTTTTTkkkkkkkkkkkkTTTTwggggwTcfcTo',
+  'oTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTwwwwwwTcccTo',
+  'oTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTwgggwwTTTTTo',
+  'oTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTTwwwwwwTTTTTo',
+  'oFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFo',
+  'oooooooooooooooooooooooooooooooooooooooooooo',
+  '.oDDDDDDDDDDDDDDDDDDFFFFDDDDDDDDDDDDDDDDDDo.',
+  '.oDDooooooooooooooooooooooooooooooooooooDDo.',
+  '.oDDoxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxoDDo.',
+  '.oDDoxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxoDDo.',
+  '.oDDo..................................oDDo.',
+  '.oooo..................................oooo.',
+]);
+
+/**
+ * Quantas linhas do desenho da mesa ficam acima do retângulo do tampo: é o fundo do tampo, que
+ * cobre as pernas de quem está sentado atrás dele.
+ */
+export const MESA_ACIMA = 4;
+
+/** O monitor, de frente para quem olha, com a tela apagada; a base pousa no fundo do tampo. */
+export const MONITOR = matriz({ o: CORES.tinta, g: CORES.cinzaEscuro, k: CORES.telaApagada, G: CORES.cinzaClaro }, [
+  'oooooooooooo',
+  'oggggggggggo',
+  'ogkkkkkkkkgo',
+  'ogkkkkkkkkgo',
+  'ogkkkkkkkkgo',
+  'ogkkkkkkkkgo',
+  'ogkkkkkkkkgo',
+  'oggggggggggo',
+  'oooooooooooo',
+  '....oGGo....',
+  '..oGGGGGGo..',
+  '..oooooooo..',
+]);
+
+/** Onde o monitor fica, a partir do canto do retângulo da mesa; e a tela, a partir do canto do monitor. */
+export const MONITOR_EM = Object.freeze({ x: 1, y: -13 });
+export const TELA_EM = Object.freeze({ x: 2, y: 2 });
+
+const CODIGO = ['vlllllvv', 'vvvvvvvv', 'vlllvllv', 'vvvvvvvv'];
+const LINHAS_DA_TELA = [0, 1, 2, 3, 4];
+
+/** O monitor aceso, uma tela por fase (0 a 3): as linhas de código sobem um pixel a cada fase. */
+export const TELAS_ACESAS = Object.freeze([0, 1, 2, 3].map((fase) => matriz(
+  { v: CORES.telaAcesa, l: CORES.verde },
+  LINHAS_DA_TELA.map((linha) => CODIGO[(linha + fase) % CODIGO.length]),
+)));
+
+/** Âmbar, com o sinal de pausa: está esperando o usuário. */
+export const TELA_AMBAR = matriz({ y: CORES.ambar, o: CORES.tinta }, [
+  'yyyyyyyy',
+  'yyoyyoyy',
+  'yyoyyoyy',
+  'yyoyyoyy',
+  'yyyyyyyy',
+]);
+
+/** Vermelha, com um xis: falhou. */
+export const TELA_VERMELHA = matriz({ r: CORES.vermelho, o: CORES.tinta }, [
+  'rrrrrrrr',
+  'rrorrorr',
+  'rrroorrr',
+  'rrorrorr',
+  'rrrrrrrr',
+]);
+
+/** Sobre a cabeça de quem concluiu. */
+export const SINAL_FEITO = matriz({ o: CORES.tinta, g: CORES.verde }, [
+  '......ooo',
+  '.....oogo',
+  'ooo.ooggo',
+  'ogoooggoo',
+  'oggoggoo.',
+  'oogggoo..',
+  '.oogoo...',
+  '..ooo....',
+]);
+
+/** Sobre a cabeça de quem falhou. */
+export const SINAL_FALHA = matriz({ o: CORES.tinta, r: CORES.vermelho }, [
+  'oooo',
+  'orro',
+  'orro',
+  'orro',
+  'orro',
+  'oooo',
+  'orro',
+  'oooo',
+]);
+
+/** Sobre a cabeça de quem trabalhava e está sem sinal. */
+export const SINAL_DUVIDA = matriz({ o: CORES.tinta, w: CORES.branco }, [
+  '.oooo.',
+  'oowwoo',
+  'owoowo',
+  'ooowoo',
+  '.owoo.',
+  '.ooo..',
+  '.owo..',
+  '.ooo..',
+]);
+
+/** A sombra no chão de quem está em pé, fora da mesa. */
+export const SOMBRA = matriz({ x: CORES.junta }, ['.xxxxxxxx.']);

package/templates/_opencrew/core/escritorio/sprites-sala.js

@@ -0,0 +1,92 @@
+// A sala do escritório, em matrizes de pixels: a parede do fundo, o piso em ladrilho de dois tons
+// e o que enfeita a parede (janela, relógio, planta). Quem diz onde cada desenho vai é `cena.js`.
+// Spec: fase-e1-escritorio-ao-vivo.md, regra 16 (repositório do OpenCrew).
+import { CORES, matriz } from './sprites.js';
+
+/**
+ * A parede, numa faixa de 8 px que se repete de lado a lado: sanca de madeira, papel de parede
+ * listrado e lambri. A altura é a da parede no modelo (`TOPO`).
+ */
+export const PAREDE = matriz({ m: CORES.madeiraMedia, d: CORES.madeiraEscura, p: CORES.parede, P: CORES.paredeSombra, h: CORES.madeiraLuz }, [
+  'mmmmmmmm',
+  'dddddddd',
+  'PPPPPPPP',
+  'pppppppP',
+  'pppppppP',
+  'pppppppP',
+  'pppppppP',
+  'pppppppP',
+  'pppppppP',
+  'pppppppP',
+  'pppppppP',
+  'pppppppP',
+  'pppppppP',
+  'pppppppP',
+  'hhhhhhhh',
+  'mmmmmmmm',
+  'mmmmmmmm',
+  'dddddddd',
+]);
+
+const LADRILHO_LINHAS = Object.freeze([
+  'jjjjjjjjjjjjjjjj',
+  'jaaaaaaaaaaaaaaa',
+  'jaaaaaaaaaaaaaaa',
+  'jaaaaaaaaaaaaaaa',
+  'jaaaaaaaaaaaaaaa',
+  'jaaaaaaaaaaaaaaa',
+  'jaaaaaaaaaaaaaaa',
+  'jaaaaaaaaaaaaaaa',
+  'jaaaaaaaaaaaaaaa',
+]);
+
+/** O ladrilho do piso, com a junta em cima e à esquerda; o claro e o escuro se alternam em xadrez. */
+export const LADRILHO = matriz({ j: CORES.junta, a: CORES.pisoClaro }, LADRILHO_LINHAS);
+export const LADRILHO_ESCURO = matriz({ j: CORES.junta, a: CORES.pisoEscuro }, LADRILHO_LINHAS);
+
+/** Janela de duas folhas: um reflexo no vidro da esquerda, uma nuvem no da direita. */
+export const JANELA = matriz({ o: CORES.tinta, w: CORES.branco, b: CORES.ceu, B: CORES.ceuClaro }, [
+  'oooooooooooooooooooooooo',
+  'owwwwwwwwwwwwwwwwwwwwwwo',
+  'owbbbbbBBbbwwbbbbbbbbbwo',
+  'owbbbbBBbbbwwbbbbwwbbbwo',
+  'owbbbBBbbbbwwbbwwwwwbbwo',
+  'owbbBBbbbbbwwbbbbbbbbbwo',
+  'owbBBbbbbbbwwbbbbbbbbbwo',
+  'owbbbbbbbbbwwbbbbbbbbbwo',
+  'owwwwwwwwwwwwwwwwwwwwwwo',
+  'oooooooooooooooooooooooo',
+]);
+
+/** Relógio de parede, parado nas três horas: nada na sala se mexe sem um agente trabalhando. */
+export const RELOGIO = matriz({ o: CORES.tinta, w: CORES.branco }, [
+  '..ooooo..',
+  '.owwwwwo.',
+  'owwwowwwo',
+  'owwwowwwo',
+  'owwwooowo',
+  'owwwwwwwo',
+  'owwwwwwwo',
+  '.owwwwwo.',
+  '..ooooo..',
+]);
+
+/** Planta em vaso de barro, para o chão junto à parede. */
+export const PLANTA = matriz({ o: CORES.tinta, g: CORES.folha, G: CORES.folhaEscura, t: CORES.madeiraEscura, v: CORES.madeiraMedia, V: CORES.madeiraEscura }, [
+  '...ooooo...',
+  '..oggggGo..',
+  '.oggGggggo.',
+  'oggggggGggo',
+  'ogGggggggGo',
+  'oggggGggggo',
+  '.ogGgggGgo.',
+  '..oggggGo..',
+  '...oGGGo...',
+  '....oto....',
+  '..ooooooo..',
+  '..ovvvvvo..',
+  '..ovvvvVo..',
+  '...ovvVo...',
+  '...ovvVo...',
+  '...ooooo...',
+]);

package/templates/_opencrew/core/escritorio/sprites.js

@@ -0,0 +1,187 @@
+// Os desenhos do escritório são matrizes de pixels escritas como texto: uma string por linha, uma
+// letra por pixel e uma paleta (letra → cor). Nenhuma imagem entra no pacote.
+// Este módulo traz as cores fixas de toda a cena, o molde do boneco de 16×16 com as trocas de
+// linha de cada pose, e a conta que transforma uma matriz nos retângulos que a cena preenche.
+// Os irmãos `sprites-sala.js` e `sprites-mesa.js` trazem a sala e os móveis.
+// Spec: fase-e1-escritorio-ao-vivo.md, regra 16 (repositório do OpenCrew).
+
+/** As cores fixas da cena. A camisa, o cabelo e a pele de cada boneco vêm do modelo. */
+export const CORES = Object.freeze({
+  tinta: '#1a1c2c',
+  branco: '#f4f4ee',
+  cinzaClaro: '#c3c8d4',
+  cinzaEscuro: '#4a5266',
+  pisoClaro: '#9aa5b8',
+  pisoEscuro: '#8d98ad',
+  junta: '#808ba1',
+  parede: '#ead9b5',
+  paredeSombra: '#d6c196',
+  madeiraLuz: '#dba76a',
+  madeira: '#c58a52',
+  madeiraMedia: '#a0683f',
+  madeiraEscura: '#6f4630',
+  ceu: '#7ec4e0',
+  ceuClaro: '#bfe6f0',
+  folha: '#4c9a52',
+  folhaEscura: '#2f6b40',
+  telaApagada: '#232838',
+  telaAcesa: '#123f4a',
+  verde: '#5fd47a',
+  ambar: '#f4a73b',
+  vermelho: '#e0564c',
+});
+
+/**
+ * Uma matriz de pixels: `linhas` do mesmo tamanho e a `paleta` com a cor de cada letra. O ponto
+ * é sempre o pixel vazio.
+ */
+export function matriz(paleta, linhas) {
+  return Object.freeze({ paleta: Object.freeze({ '.': null, ...paleta }), linhas: Object.freeze(linhas) });
+}
+
+/**
+ * O molde do boneco: 16×16, de frente, parado. Na paleta, `cabelo`, `pele`, `camisa` e as duas
+ * sombras são fendas que `coresDoBoneco` troca pelas cores de cada agente.
+ */
+export const MOLDE = matriz({
+  o: CORES.tinta, h: 'cabelo', s: 'pele', S: 'pele-sombra', c: 'camisa', C: 'camisa-sombra',
+  p: CORES.cinzaEscuro, P: CORES.telaApagada, b: CORES.madeiraEscura, w: CORES.branco, g: CORES.cinzaClaro,
+}, [
+  '....oooooooo....',
+  '...ohhhhhhhho...',
+  '..ohhhhhhhhhho..',
+  '..ohhhhhhhhhho..',
+  '..ohhsssssshho..',
+  '..ohsssssssSho..',
+  '..ossossssosSo..',
+  '..osssssssssSo..',
+  '...oSSSSSSSSo...',
+  '..oCccccccccCo..',
+  '..oCccccccccCo..',
+  '..osccccccccso..',
+  '...oCCCCCCCCo...',
+  '....oppppppo....',
+  '....oppoopPo....',
+  '...obbboobbbo...',
+]);
+
+/**
+ * As poses são o molde com linhas trocadas: cada troca diz o número da linha e o texto novo.
+ * `digitar` e `andar` têm dois quadros; `mao` é o braço levantado de quem espera; `festa`, os
+ * dois braços para cima de quem comemora; `papel` é o braço com o papel, que se soma às pernas
+ * de quem anda.
+ */
+export const TROCAS = Object.freeze({
+  'digitar-a': { 11: '..oCccccccccso..', 12: '...ossCCCCCCo...' },
+  'digitar-b': { 11: '..osccccccccCo..', 12: '...oCCCCCCsso...' },
+  'andar-a': { 14: '....oppoobbo....', 15: '...obbbo.oo.....' },
+  'andar-b': { 14: '....obboopPo....', 15: '.....oo.obbbo...' },
+  mao: {
+    0: '....oooooooo.oo.',
+    1: '...ohhhhhhhhosso',
+    2: '..ohhhhhhhhhhoso',
+    3: '..ohhhhhhhhhhoso',
+    4: '..ohhsssssshhoCo',
+    5: '..ohsssssssShoCo',
+    6: '..ossossssosSoCo',
+    7: '..osssssssssSoCo',
+    8: '...oSSSSSSSSoCCo',
+    9: '..oCcccccccccCo.',
+    11: '..osccccccccCo..',
+  },
+  festa: {
+    0: '.oo.oooooooo.oo.',
+    1: 'ossohhhhhhhhosso',
+    2: 'osohhhhhhhhhhoso',
+    3: 'osohhhhhhhhhhoso',
+    4: 'oCohhsssssshhoCo',
+    5: 'oCohsssssssShoCo',
+    6: 'oCossossssosSoCo',
+    7: 'oCosssssssssSoCo',
+    8: 'oCCoSSSSSSSSoCCo',
+    9: '.oCccccccccccCo.',
+    11: '..oCccccccccCo..',
+  },
+  papel: {
+    8: '...oSSSSSSSSooo.',
+    9: '..oCccccccccCwwo',
+    10: '..oCccccccccCwgo',
+    11: '..osccccccccswwo',
+    12: '...oCCCCCCCCoooo',
+  },
+});
+
+const virar = (linha) => [...linha].reverse().join('');
+const POSTAS = new Map();
+
+/**
+ * As 16 linhas do boneco numa pose. A mesma pose devolve sempre a mesma lista.
+ * @param {string} pose uma das poses de `quadro` (`parado` é o molde)
+ * @param {{ papel?: boolean, festa?: boolean, espelhado?: boolean }} [o] `papel`: leva o papel ·
+ *   `festa`: os dois braços para cima, no lugar da pose · `espelhado`: virado para a esquerda
+ */
+export function linhasDoBoneco(pose, { papel = false, festa = false, espelhado = false } = {}) {
+  const chave = `${pose}|${papel}|${festa}|${espelhado}`;
+  if (!POSTAS.has(chave)) {
+    const trocas = { ...(festa ? TROCAS.festa : TROCAS[pose]), ...(papel ? TROCAS.papel : null) };
+    const linhas = MOLDE.linhas.map((linha, i) => trocas[i] ?? linha);
+    POSTAS.set(chave, espelhado ? linhas.map(virar) : linhas);
+  }
+  return POSTAS.get(chave);
+}
+
+/** A cor um quarto mais escura: a sombra que dá volume à pele e à camisa. */
+export function sombra(cor) {
+  const canal = (inicio) => Math.round(parseInt(cor.slice(inicio, inicio + 2), 16) * 0.75).toString(16).padStart(2, '0');
+  return `#${canal(1)}${canal(3)}${canal(5)}`;
+}
+
+const PALETAS = new Map();
+
+/** A paleta do molde com as cores de um agente (`{ camisa, cabelo, pele }`, em `#rrggbb`). */
+export function coresDoBoneco({ camisa, cabelo, pele }) {
+  const chave = `${camisa}|${cabelo}|${pele}`;
+  if (!PALETAS.has(chave)) {
+    const fendas = { cabelo, pele, 'pele-sombra': sombra(pele), camisa, 'camisa-sombra': sombra(camisa) };
+    PALETAS.set(chave, Object.fromEntries(Object.entries(MOLDE.paleta).map(([letra, cor]) => [letra, fendas[cor] ?? cor])));
+  }
+  return PALETAS.get(chave);
+}
+
+/** Os trechos de uma linha: `[x, largura, letra]` de cada sequência da mesma letra, sem os vazios. */
+function trechos(linha) {
+  return [...linha.matchAll(/([^.])\1*/g)].map((achado) => [achado.index, achado[0].length, achado[1]]);
+}
+
+const guardar = (lista, item) => {
+  lista.push(item);
+  return item;
+};
+
+/** Trechos iguais em linhas seguidas viram um retângulo só: a cena preenche menos vezes. */
+function juntar(linhas) {
+  const todos = [];
+  let acima = new Map();
+  linhas.forEach((linha, y) => {
+    const nesta = new Map();
+    for (const [x, largura, letra] of trechos(linha)) {
+      const chave = `${x}:${largura}:${letra}`;
+      const retangulo = acima.get(chave) ?? guardar(todos, [x, y, largura, 0, letra]);
+      retangulo[3] += 1;
+      nesta.set(chave, retangulo);
+    }
+    acima = nesta;
+  });
+  return todos;
+}
+
+const RETANGULOS = new WeakMap();
+
+/**
+ * Os retângulos que desenham uma matriz: `[x, y, largura, altura, letra]`, a partir do canto
+ * superior esquerdo dela. A conta é feita uma vez por lista de linhas.
+ */
+export function retangulos(linhas) {
+  if (!RETANGULOS.has(linhas)) RETANGULOS.set(linhas, juntar(linhas));
+  return RETANGULOS.get(linhas);
+}

package/templates/_opencrew/core/prompts/build.prompt.md

@@ -131,9 +131,9 @@ Generate these files. Use the Write tool for all file creation — never use Bas
    - **`displayName` is REQUIRED and MUST be byte-for-byte identical to the agent's
      `name:` frontmatter field in its `.agent.md`** (the mandatory two-word "FirstName
      LastName" persona name). The Pipeline Runner reads `displayName` — NOT `title` — to
-     render the agent's name in `state.json`, in "🤖 {name} is working…" announcements, and
-     in the dashboard. If `displayName` is missing, empty, or set to the role/title instead
-     of the persona name, the crew renders with functions but no names.
+     render the agent's name in "🤖 {name} is working…" announcements, and the Escritório
+     (the optional live view) shows the same column. If `displayName` is missing, empty, or set
+     to the role/title instead of the persona name, the crew renders with functions but no names.
    - `id` = the `path` basename with `./agents/` and `.agent.md` stripped
      (e.g. `./agents/researcher.agent.md` → `researcher`).
    - `title` = the agent's `title:` frontmatter (the role/function label). This is a

package/templates/_opencrew/core/prompts/discovery.prompt.md

@@ -305,7 +305,7 @@ target_formats:  # content crews only; empty list for others
 
 The `crew_code` must be a short, URL-safe slug derived from the crew's purpose (e.g., `content-calendar`, `competitor-tracker`, `lead-notify`).
 
-**CRITICAL — Name uniqueness:** The `crew_code` MUST NEVER match any existing folder name in `crews/`. Before finalizing, run `ls crews/ 2>/dev/null` (Bash) to list existing crew directories. If the slug you derive matches an existing folder, append a numeric suffix (`-2`, `-3`, etc.) until it is unique. Never reuse an existing crew folder name — doing so would overwrite another crew's files.
+**CRITICAL — Name uniqueness:** The `crew_code` MUST NEVER match any existing folder name in `crews/`. Before finalizing, list the existing folders of `crews/` with the IDE's folder-listing tool (no shell command); if `crews/` does not exist yet, there are none. If the slug you derive matches an existing folder, append a numeric suffix (`-2`, `-3`, etc.) until it is unique. Never reuse an existing crew folder name — doing so would overwrite another crew's files.
 
 ---
 

package/templates/_opencrew/core/prompts/repair.prompt.md

@@ -1,8 +1,8 @@
 # Repair — Fix Crew Agent Names / Manifest
 
 You are the opencrew Repair agent. Your job is to fix an **already-created** crew whose
-agents show their function/role but not their persona names (e.g. the dashboard and the
-Pipeline Runner announce "Pesquisador" instead of "Pedro Pesquisa").
+agents show their function/role but not their persona names (e.g. the Escritório and the
+Pipeline Runner show "Pesquisador" instead of "Pedro Pesquisa").
 
 This is a known defect in crews built by older versions: the `crew-party.csv` manifest was
 generated without a `displayName` column (or with the role/title in it instead of the
@@ -13,10 +13,9 @@ re-run the Build phase.
 
 ## Scope
 
-You may ONLY touch files under `crews/{code}/`:
+You may ONLY touch these files under `crews/{code}/`:
 - `crews/{code}/crew-party.csv`
 - `crews/{code}/agents/*.agent.md` (only in the fallback case — see Step 4)
-- `crews/{code}/state.json` (only if it exists)
 
 Never modify `_opencrew/`, `templates/`, or any other crew. Use the Write tool for all file
 writes (never Bash `mkdir`).
@@ -77,13 +76,7 @@ existed and must be generated now, following the **Agent Naming Convention** fro
 Only do this for agents that are actually broken. Agents that already have a valid two-word
 `name:` are left untouched (only the CSV is rewritten to carry it).
 
-## Step 5: Refresh `state.json` (only if it exists)
-
-If `crews/{code}/state.json` exists, update each agent entry's `name` field to the repaired
-`displayName`. Do not change any other field. If the file does not exist, skip — the
-Pipeline Runner recreates it from the CSV on the next run.
-
-## Step 6: Report
+## Step 5: Report
 
 Present a summary table of what changed:
 
@@ -96,11 +89,13 @@ Crew "{name}" repaired.
 | copywriter  | Guilherme     | ✍️ Guilherme Gancho | generated   |
 
 crew-party.csv: rewritten with displayName column
-state.json: {updated | not present}
 
 Run it: /opencrew run {code}
 ```
 
+The Escritório (the optional live view) takes the names from the CSV when the next run starts:
+there is nothing else to refresh.
+
 If nothing was broken (CSV already had a valid `displayName` for every agent), say so
 plainly instead of inventing changes: "This crew's manifest is already correct — no repair
 needed."