@aelinrezende/pipa-core 1.0.0

package/README.md

@@ -0,0 +1,131 @@
+# pipa-core
+
+SDK para criar extensões do Pi com features reutilizáveis, API de execução e eventos de domínio tipados.
+
+Inclui `applyFeatures`, `PipaBaseFeature`, `PipaEvent`, `PipaApi` e o mapa `DomainEventMap`.
+
+## Instalação local
+
+No clone deste repositório, gere o pacote e instale o diretório produzido no projeto consumidor:
+
+```bash
+cd /caminho/para/pipa/.pi
+bun run scripts/build-core.ts
+
+cd /caminho/do/projeto-consumidor
+npm install /caminho/para/pipa/.pi/dist-core
+```
+
+O build gera `dist-core/`, incluindo `index.js`, declarações TypeScript, `package.json` e uma cópia deste README.
+
+## Uso
+
+Registre no `ExtensionAPI` as features necessárias:
+
+```ts
+import { applyFeatures, DocsFeature, PipaBaseFeature } from '@aelinrezende/pipa-core';
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+
+class AuditFeature extends PipaBaseFeature {
+  initialize(pi: ExtensionAPI): void {
+    pi.registerTool({ name: 'audit' /* ... */ });
+  }
+}
+
+await applyFeatures(pi, [DocsFeature, AuditFeature]);
+```
+
+Para cada construtor informado, `applyFeatures` cria uma instância e chama `initialize(pi)`, se implementado. Em seguida, registra métodos decorados com `@PipaEvent`. A propriedade `feature.pipa` é construída e atribuída imediatamente antes da execução de cada handler decorado; use o argumento `pipa` do handler quando precisar da API no evento.
+
+## Features incluídas
+
+| Feature | Responsabilidade |
+| --- | --- |
+| `DocsFeature` | Documentos e publicação da base de conhecimento. |
+| `TaskFeature` | Tarefas operacionais e dependências. |
+| `TeammateFeature` | Ciclo de vida e comunicação entre colegas. |
+| `TodoFeature` | Checklist operacional do agente. |
+| `BacklogFeature` | Backlog persistente do projeto. |
+| `PermissionFeature` | Guardas de terminal e custom tools. |
+| `OnboardingFeature` | Perfil e onboarding do agente principal. |
+| `ReminderCleanerFeature` | Remove notificações já consumidas do contexto. |
+| `ToolResultCompactorFeature` | Compacta resultados antigos e volumosos de tools. |
+
+As sete primeiras são exports do SDK. As duas últimas são ativadas pela extensão Pipa para higiene de contexto e não são exports do pacote.
+
+## Eventos
+
+`@PipaEvent` aceita eventos do agente e eventos de domínio. Eventos do agente são registrados em `pi.on`; eventos de domínio são observados em `pi.events`. Handlers recebem o payload e a `PipaApi`:
+
+```ts
+import { PipaBaseFeature, PipaEvent } from '@aelinrezende/pipa-core';
+import type { PipaApi, PipaPayload } from '@aelinrezende/pipa-core';
+
+class ListenerFeature extends PipaBaseFeature {
+  @PipaEvent('doc_created')
+  onDocCreated(item: PipaPayload<'doc_created'>, pipa: PipaApi): void {
+    console.log(`${item.code}: ${item.title}`);
+  }
+}
+```
+
+Os handlers de domínio são reações ao fato já consumado. Para emitir um evento, use a API disponível no handler ou na feature:
+
+```ts
+this.pipa.events.emit('doc_created', item);
+```
+
+### DomainEventMap (eventos nativos)
+
+| Domínio | Evento | Payload | Action de origem |
+| --- | --- | --- | --- |
+| Docs | `doc_created` | `DocItem` | `instantiate` |
+| Docs | `doc_updated` | `DocItem` | `update-frontmatter`, `update-body` |
+| Docs | `doc_removed` | `DocItem` | `remove` |
+| Docs | `doc_published` | `{ path, url }` | `publish` |
+| Backlog | `backlog_created` | `BacklogItem` | `instantiate` |
+| Backlog | `backlog_updated` | `BacklogItem` | `update-frontmatter`, `update-body`, `update-metadata` |
+| Backlog | `backlog_removed` | `BacklogItem` | `remove` |
+| Task | `task_created` | `Task` | `instantiate` |
+| Task | `task_claimed` | `Task` | `claim` |
+| Task | `task_updated` | `Task` | `setup`, `update` |
+| Task | `task_completed` | `Task` | `complete` |
+| Task | `task_removed` | `Task` | `remove` |
+| Todo | `todo_created` | `TodoItem` | `instantiate` |
+| Todo | `todo_updated` | `TodoItem` | `update` |
+| Todo | `todo_removed` | `TodoItem` | `remove` |
+| Todo | `todo_cleared` | `{ sessionId }` | `clear` |
+| Teammate | `teammate_created` | `TeammateEventPayload` | `instantiate` |
+| Teammate | `teammate_removed` | `{ dismissed, count, reason }` | `dismiss` |
+
+Leituras não emitem eventos. Além das actions da tabela, `task_updated` também pode ser emitido quando a alteração de uma subtarefa sincroniza o status da tarefa pai.
+
+### Estendendo o mapa
+
+`DomainEventMap` é uma interface e aceita declaration merging:
+
+```ts
+import type { PipaPayload } from '@aelinrezende/pipa-core';
+
+declare module '@aelinrezende/pipa-core' {
+  interface DomainEventMap {
+    audit_recorded: { id: string };
+  }
+}
+
+this.pipa.events.emit('audit_recorded', { id: 'audit-1' });
+
+@PipaEvent('audit_recorded')
+onAuditRecorded(item: PipaPayload<'audit_recorded'>): void {
+  console.log(item.id);
+}
+```
+
+## Exports principais
+
+- `applyFeatures(pi, features)` — instancia features, chama sua inicialização e registra handlers decorados.
+- `buildPipaApi(pi, context)` e `pipa()` — API da Pipa e acesso à instância principal.
+- `PipaEvent(event)` — decorator para `PiEvent` ou `DomainEventName`.
+- `PipaBaseFeature` — base com `pi`, `pipa` e `initialize?`.
+- `DomainEventMap`, `DomainEventName`, `PipaPayload<E>` e `DomainEventHandler<E>` — tipos de eventos de domínio.
+- Hubs e estado: `DocsHub`, `DocsState`, `TaskHub`, `TaskState`, `TeammateHub`, `TeammateState` e `PipaStore`.

package/extensions/pipa/constants/backlog.d.ts

@@ -0,0 +1,49 @@
+import type { BacklogDomain, BacklogItem, BacklogItemFrontmatter, BacklogItemType, BacklogPriority, BacklogStatus } from '../features/backlog/backlog.entity';
+/** Tipos válidos de item do backlog */
+export declare const BACKLOG_ITEM_TYPES: BacklogItemType[];
+/** Status válidos do backlog */
+export declare const BACKLOG_STATUSES: BacklogStatus[];
+/** Prioridades válidas */
+export declare const BACKLOG_PRIORITIES: BacklogPriority[];
+/** Domínios válidos */
+export declare const BACKLOG_DOMAINS: BacklogDomain[];
+/** Campos de ordenação da listagem */
+export declare const BACKLOG_SORT_FIELDS: (keyof Pick<BacklogItem, 'updatedAt' | 'order'>)[];
+/** Direções de ordenação */
+export declare const BACKLOG_SORT_ORDERS: ('ASC' | 'DESC')[];
+/** Campos do frontmatter editáveis via update-frontmatter */
+export declare const BACKLOG_FRONTMATTER_FIELDS: BacklogItemFrontmatter[];
+/** Mensagens contextuais para cada ação da tool backlog */
+export declare const BACKLOG_TOOL_NUDGES: {
+    list: {
+        code: string;
+        readonly failed: readonly [string, 'Falha ao listar backlog'];
+        readonly success: readonly [string, 'Backlog listado com sucesso'];
+    };
+    create: {
+        code: string;
+        readonly failed: readonly [string, 'Falha ao criar item no backlog'];
+        readonly success: readonly [string, 'Item criado no backlog'];
+    };
+    'update-frontmatter': {
+        code: string;
+        readonly failed: readonly [string, 'Falha ao atualizar frontmatter'];
+        readonly success: readonly [string, 'Frontmatter atualizado'];
+    };
+    'update-body': {
+        code: string;
+        readonly failed: readonly [string, 'Falha ao atualizar corpo markdown'];
+        readonly success: readonly [string, 'Corpo markdown atualizado'];
+    };
+    'update-metadata': {
+        code: string;
+        readonly failed: readonly [string, 'Falha ao atualizar metadata'];
+        readonly success: readonly [string, 'Metadata atualizado'];
+    };
+    select: {
+        code: string;
+        readonly failed: readonly [string, 'Falha na busca'];
+        readonly success: readonly [string, 'Busca concluída'];
+    };
+};
+//# sourceMappingURL=backlog.d.ts.map

package/extensions/pipa/constants/backlog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/constants/backlog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,aAAa,EACd,MAAM,oCAAoC,CAAC;AAE5C,uCAAuC;AACvC,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAAwC,CAAC;AAEzF,gCAAgC;AAChC,eAAO,MAAM,gBAAgB,EAAE,aAAa,EAA8D,CAAC;AAE3G,0BAA0B;AAC1B,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAA0C,CAAC;AAE3F,uBAAuB;AACvB,eAAO,MAAM,eAAe,EAAE,aAAa,EAAiC,CAAC;AAE7E,sCAAsC;AACtC,eAAO,MAAM,mBAAmB,EAAE,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,EAA2B,CAAC;AAE9G,4BAA4B;AAC5B,eAAO,MAAM,mBAAmB,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,EAAoB,CAAC;AAEvE,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B,EAAE,sBAAsB,EAO9D,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB;IAC9B,IAAI;QACF,IAAI;iBACA,MAAM,oBACkB,yBAAyB;iBAEjD,OAAO,oBACiB,6BAA6B;;IAG3D,MAAM;QACJ,IAAI;iBACA,MAAM,oBACkB,gCAAgC;iBAExD,OAAO,oBACiB,wBAAwB;;IAGtD,oBAAoB;QAClB,IAAI;iBACA,MAAM,oBACkB,gCAAgC;iBAExD,OAAO,oBACiB,wBAAwB;;IAGtD,aAAa;QACX,IAAI;iBACA,MAAM,oBACkB,mCAAmC;iBAE3D,OAAO,oBACiB,2BAA2B;;IAGzD,iBAAiB;QACf,IAAI;iBACA,MAAM,oBACkB,6BAA6B;iBAErD,OAAO,oBACiB,qBAAqB;;IAGnD,MAAM;QACJ,IAAI;iBACA,MAAM,oBACkB,gBAAgB;iBAExC,OAAO,oBACiB,iBAAiB;;CAGhD,CAAC"}

package/extensions/pipa/constants/compactor.d.ts

@@ -0,0 +1,7 @@
+/** Número de turns recentes que ficam protegidos da compactação. */
+export declare const COMPACTOR_RECENT_TURNS = 3;
+/** Tamanho mínimo (em chars) para um tool result ser elegível à compactação. */
+export declare const COMPACTOR_MIN_CHARS = 1000;
+/** Diretório global onde os conteúdos compactados são persistidos. */
+export declare const COMPACTOR_BASE_DIR: string;
+//# sourceMappingURL=compactor.d.ts.map

package/extensions/pipa/constants/compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/constants/compactor.ts"],"names":[],"mappings":"AAGA,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,OAAQ,CAAC;AAGzC,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,QAA4C,CAAC"}

package/extensions/pipa/constants/docs.d.ts

@@ -0,0 +1,46 @@
+/** Comprimento máximo do summary dos documentos */
+export declare const DOC_SUMMARY_LENGTH = 200;
+/** Mensagens contextuais para cada ação da tool docs */
+export declare const DOCS_TOOL_NUDGES: {
+    create: {
+        code: string;
+        readonly failed: readonly [string, 'Falha ao criar documento'];
+        readonly success: readonly [string, 'Documento criado'];
+    };
+    list: {
+        code: string;
+        readonly failed: readonly [string, 'Falha ao listar documentos'];
+        readonly success: readonly [string, 'Documentos listados'];
+    };
+    'update-frontmatter': {
+        code: string;
+        readonly failed: readonly [string, 'Falha ao atualizar frontmatter'];
+        readonly success: readonly [string, 'Frontmatter atualizado'];
+    };
+    'update-body': {
+        code: string;
+        readonly failed: readonly [string, 'Falha ao atualizar corpo markdown'];
+        readonly success: readonly [string, 'Corpo markdown atualizado'];
+    };
+    'update-metadata': {
+        code: string;
+        readonly failed: readonly [string, 'Falha ao atualizar metadata'];
+        readonly success: readonly [string, 'Metadata atualizado'];
+    };
+    select: {
+        code: string;
+        readonly failed: readonly [string, 'Falha na busca'];
+        readonly success: readonly [string, 'Busca concluída'];
+    };
+    remove: {
+        code: string;
+        readonly failed: readonly [string, 'Falha ao remover documento'];
+        readonly success: readonly [string, 'Documento removido'];
+    };
+    publish: {
+        code: string;
+        readonly failed: readonly [string, 'Falha ao publicar documentação'];
+        readonly success: readonly [string, 'Documentação publicada'];
+    };
+};
+//# sourceMappingURL=docs.d.ts.map

package/extensions/pipa/constants/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/constants/docs.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,wDAAwD;AACxD,eAAO,MAAM,gBAAgB;IAC3B,MAAM;QACJ,IAAI;iBACA,MAAM,oBACkB,0BAA0B;iBAElD,OAAO,oBACiB,kBAAkB;;IAGhD,IAAI;QACF,IAAI;iBACA,MAAM,oBACkB,4BAA4B;iBAEpD,OAAO,oBACiB,qBAAqB;;IAGnD,oBAAoB;QAClB,IAAI;iBACA,MAAM,oBACkB,gCAAgC;iBAExD,OAAO,oBACiB,wBAAwB;;IAGtD,aAAa;QACX,IAAI;iBACA,MAAM,oBACkB,mCAAmC;iBAE3D,OAAO,oBACiB,2BAA2B;;IAGzD,iBAAiB;QACf,IAAI;iBACA,MAAM,oBACkB,6BAA6B;iBAErD,OAAO,oBACiB,qBAAqB;;IAGnD,MAAM;QACJ,IAAI;iBACA,MAAM,oBACkB,gBAAgB;iBAExC,OAAO,oBACiB,iBAAiB;;IAG/C,MAAM;QACJ,IAAI;iBACA,MAAM,oBACkB,4BAA4B;iBAEpD,OAAO,oBACiB,oBAAoB;;IAGlD,OAAO;QACL,IAAI;iBACA,MAAM,oBACkB,gCAAgC;iBAExD,OAAO,oBACiB,wBAAwB;;CAGvD,CAAC"}

package/extensions/pipa/constants/file.d.ts

@@ -0,0 +1,15 @@
+/** Nome do arquivo contendo sumário das tarefas */
+export declare const TASKS_INDEX_FILE = "tasks.json";
+/** Diretório base onde as tarefas são armazenadas */
+export declare const TASKS_BASE_DIR: string;
+/** Diretório de arquivos da sessão */
+export declare const SESSIONS_DIR: string;
+/** Diretório base do backlog (config fallback: .context/project/backlog) */
+export declare const BACKLOG_BASE_DIR: string;
+/** Arquivo JSON único que persiste todos os itens do backlog */
+export declare const BACKLOG_JSON_FILE = "backlog.json";
+/** Diretório base da documentação */
+export declare const DOCS_BASE_DIR: string;
+/** Arquivo JSON único que persiste os documentos na pasta docs */
+export declare const DOCS_JSON_FILE = "entries.json";
+//# sourceMappingURL=file.d.ts.map

package/extensions/pipa/constants/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/constants/file.ts"],"names":[],"mappings":"AAGA,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAE7C,qDAAqD;AACrD,eAAO,MAAM,cAAc,QAA0C,CAAC;AAEtE,sCAAsC;AACtC,eAAO,MAAM,YAAY,QAA6C,CAAC;AAEvE,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,QAA6D,CAAC;AAE3F,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD,qCAAqC;AACrC,eAAO,MAAM,aAAa,QAAmC,CAAC;AAE9D,kEAAkE;AAClE,eAAO,MAAM,cAAc,iBAAiB,CAAC"}

package/extensions/pipa/constants/pipa.d.ts

@@ -0,0 +1,6 @@
+export type PiEvent = (typeof PI_EVENTS)[number];
+/**
+ * Mapeamento dos eventos do Pi.
+ */
+export declare const PI_EVENTS: readonly ['initialized', 'session_start', 'context', 'resources_discover', 'before_agent_start', 'agent_start', 'agent_end', 'tool_execution_start', 'tool_execution_update', 'tool_execution_end', 'tool_call', 'tool_result', 'message_start', 'message_update', 'message_end', 'turn_start', 'turn_end', 'session_shutdown'];
+//# sourceMappingURL=pipa.d.ts.map

package/extensions/pipa/constants/pipa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipa.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/constants/pipa.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,SAAS,YAEpB,aAAa,EAGb,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,kBAAkB,CACnB,CAAC"}

package/extensions/pipa/constants/store.d.ts

@@ -0,0 +1,6 @@
+export declare const TEAMMATES_STORE_KEY = "TEAMMATES_STORE";
+export declare const TASKS_STORE_KEY = "TASKS_STORE";
+export declare const BACKLOG_STORE_KEY = "BACKLOG_STORE";
+export declare const DOCS_STORE_KEY = "DOCS_STORE";
+export declare const MAIN_SESSION_ID = "MAIN_SESSION";
+//# sourceMappingURL=store.d.ts.map

package/extensions/pipa/constants/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/constants/store.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAC7C,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AACjD,eAAO,MAAM,cAAc,eAAe,CAAC;AAC3C,eAAO,MAAM,eAAe,iBAAiB,CAAC"}

package/extensions/pipa/constants/task.d.ts

@@ -0,0 +1,62 @@
+import type { TaskStatus } from '../features/task/task.entity';
+/**
+ * Dicionário de nudges padronizados para as ações da ferramenta de tarefas.
+ * Define códigos e mensagens de sucesso/falha/acesso negado para cada ação.
+ */
+export declare const TASK_TOOL_NUDGES: {
+    /**
+     * Nudges relacionados à consulta de uma tarefa.
+     */
+    get: {
+        code: string;
+        readonly failed: readonly [string, 'Falha durante consulta'];
+    };
+    /**
+     * Nudges relacionados à configuração de tarefas.
+     */
+    setup: {
+        code: string;
+        readonly failed: readonly [string, 'Falha durante configuração'];
+        readonly denied: readonly [string, 'Acesso negado para configurar'];
+    };
+    /**
+     * Nudges relacionados à reivindicação de tarefas por colegas (subagents).
+     */
+    claim: {
+        code: string;
+        readonly failed: readonly [string, 'Falha durante reivindicação'];
+    };
+    /**
+     * Nudges relacionados à criação de novas tarefas.
+     */
+    instantiate: {
+        code: string;
+        readonly failed: readonly [string, 'Falha durante criação'];
+    };
+    /**
+     * Nudges relacionados à atualização de tarefas.
+     */
+    update: {
+        code: string;
+        readonly failed: readonly [string, 'Falha durante atualização'];
+        readonly denied: readonly [string, 'Acesso negado para editar'];
+    };
+    /**
+     * Nudges relacionados à remoção (deleção) de tarefas.
+     */
+    remove: {
+        code: string;
+        readonly failed: readonly [string, 'Falha durante remoção'];
+        readonly denied: readonly [string, 'Acesso negado'];
+    };
+    /**
+     * Nudges relacionados à marcação de uma tarefa como concluída.
+     */
+    complete: {
+        code: string;
+        readonly failed: readonly [string, 'Falha durante conclusão'];
+        readonly denied: readonly [string, 'Acesso negado'];
+    };
+};
+export declare const TASK_STATUS_TRANSLATIONS: Record<TaskStatus, string>;
+//# sourceMappingURL=task.d.ts.map

package/extensions/pipa/constants/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/constants/task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;IACH,GAAG;QACD,IAAI;iBACA,MAAM,oBACkB,wBAAwB;;IAItD;;OAEG;IACH,KAAK;QACH,IAAI;iBACA,MAAM,oBACkB,4BAA4B;iBAEpD,MAAM,oBACkB,+BAA+B;;IAI7D;;OAEG;IACH,KAAK;QACH,IAAI;iBACA,MAAM,oBACkB,6BAA6B;;IAI3D;;OAEG;IACH,WAAW;QACT,IAAI;iBACA,MAAM,oBACkB,uBAAuB;;IAIrD;;OAEG;IACH,MAAM;QACJ,IAAI;iBACA,MAAM,oBACkB,2BAA2B;iBAEnD,MAAM,oBACkB,2BAA2B;;IAIzD;;OAEG;IACH,MAAM;QACJ,IAAI;iBACA,MAAM,oBACkB,uBAAuB;iBAE/C,MAAM,oBACkB,eAAe;;IAI7C;;OAEG;IACH,QAAQ;QACN,IAAI;iBACA,MAAM,oBACkB,yBAAyB;iBAEjD,MAAM,oBACkB,eAAe;;CAG9C,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAM/D,CAAC"}

package/extensions/pipa/constants/teammate.d.ts

@@ -0,0 +1,25 @@
+import type { TeammateStatus } from '../features/teammate/teammate.entity';
+/**
+ * Dicionário de nudges padronizados para as ações da ferramenta de teammates.
+ * Define códigos e mensagens de sucesso/falha/acesso negado para cada ação.
+ */
+export declare const TEAMMATE_TOOL_NUDGES: {
+    /**
+     * Nudges relacionados ao processo de subir um novo agente (instantiate).
+     */
+    instantiate: {
+        code: string;
+        readonly failed: readonly [string, 'Falha durante início'];
+        readonly denied: readonly [string, 'Acesso negado para invocar colega'];
+    };
+    /**
+     * Nudges relacionados à remoção (deleção) de um agente e subordinados (dismiss).
+     */
+    dismiss: {
+        code: string;
+        readonly failed: readonly [string, 'Tentativa inválida de dispensar colega'];
+        readonly denied: readonly [string, 'Acesso negado'];
+    };
+};
+export declare const TEAMMATE_STATUS_TRANSLATIONS: Record<TeammateStatus, string>;
+//# sourceMappingURL=teammate.d.ts.map

package/extensions/pipa/constants/teammate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teammate.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/constants/teammate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;OAEG;IACH,WAAW;QACT,IAAI;iBACA,MAAM,oBACkB,sBAAsB;iBAE9C,MAAM,oBACkB,mCAAmC;;IAGjE;;OAEG;IACH,OAAO;QACL,IAAI;iBACA,MAAM,oBACkB,wCAAwC;iBAEhE,MAAM,oBACkB,eAAe;;CAG9C,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAKvE,CAAC"}

package/extensions/pipa/constants/todo.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Dicionário de nudges padronizados para as ações da ferramenta de todo.
+ * Define códigos e mensagens de falha para cada ação.
+ */
+export declare const TODO_TOOL_NUDGES: {
+    /**
+     * Nudges relacionados à atualização de tarefas (update).
+     */
+    update: {
+        code: string;
+        readonly failed: readonly [string, 'Falha durante atualização'];
+    };
+    /**
+     * Nudges relacionados à remoção de tarefas (remove).
+     */
+    remove: {
+        code: string;
+        readonly failed: readonly [string, 'Falha durante remoção'];
+    };
+};
+//# sourceMappingURL=todo.d.ts.map

package/extensions/pipa/constants/todo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/constants/todo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B;;OAEG;IACH,MAAM;QACJ,IAAI;iBACA,MAAM,oBACkB,2BAA2B;;IAIzD;;OAEG;IACH,MAAM;QACJ,IAAI;iBACA,MAAM,oBACkB,uBAAuB;;CAGtD,CAAC"}

package/extensions/pipa/core/apply-features.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import { PipaBaseFeatureConstructor } from '../features/base-feature';
+export declare function applyFeatures(pi: ExtensionAPI, features: PipaBaseFeatureConstructor[]): Promise<void>;
+//# sourceMappingURL=apply-features.d.ts.map

package/extensions/pipa/core/apply-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-features.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/core/apply-features.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EAGb,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAmB,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAOvF,wBAAsB,aAAa,CAAC,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,0BAA0B,EAAE,iBAqC3F"}

package/extensions/pipa/core/config.d.ts

@@ -0,0 +1,3 @@
+import { PipaConfig } from '../interfaces/config';
+export declare const config: PipaConfig;
+//# sourceMappingURL=config.d.ts.map

package/extensions/pipa/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/core/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAuClD,eAAO,MAAM,MAAM,EAAI,UAIrB,CAAC"}

package/extensions/pipa/core/decorators/events.d.ts

@@ -0,0 +1,15 @@
+import 'reflect-metadata';
+import { PiEvent } from '../../constants/pipa';
+import type { DomainEventName } from '../events.types';
+export declare const PI_EVENTS_SYMBOLS: Record<"agent_end" | "agent_start" | "before_agent_start" | "context" | "initialized" | "message_end" | "message_start" | "message_update" | "resources_discover" | "session_shutdown" | "session_start" | "tool_call" | "tool_execution_end" | "tool_execution_start" | "tool_execution_update" | "tool_result" | "turn_end" | "turn_start", symbol>;
+/** Lista [evento, símbolo] de todos os eventos registráveis (agente + domínio). */
+export declare function listEventSymbols(): Array<[PiEvent | DomainEventName, symbol]>;
+/**
+ * Associa o método decorado a um evento específico do Pi, permitindo que ele seja
+ * executado automaticamente quando esse evento ocorrer.
+ *
+ * @param event O evento ao qual o método deve ser associado: evento fixo do agente
+ * (ex: "tool_call", "session_start") ou evento de domínio (ex: "doc_created").
+ */
+export declare const PipaEvent: (event: PiEvent | DomainEventName) => MethodDecorator;
+//# sourceMappingURL=events.d.ts.map

package/extensions/pipa/core/decorators/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/core/decorators/events.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAa,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,eAAO,MAAM,iBAAiB,uVAQ7B,CAAC;AAeF,mFAAmF;AACnF,wBAAgB,gBAAgB,IAAI,KAAK,CAAC,CAAC,OAAO,GAAG,eAAe,EAAE,MAAM,CAAC,CAAC,CAK7E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,UAAW,OAAO,GAAG,eAAe,KAAG,eAE5D,CAAC"}

package/extensions/pipa/core/errors/pipa-exception.d.ts

@@ -0,0 +1,17 @@
+/** Exceção para erros de validação que propaga direto ao harness. */
+export declare class PipaException extends Error {
+    /** Ação que gerou o erro (ex: de "task.create" extrai "create"). */
+    readonly action: string;
+    /** Ferramenta que gerou o erro (ex: de "task.create" extrai "task"). */
+    readonly tool: string;
+    /**
+     * @param intent String "ferramenta.acao" (ex: "task.create").
+     * @param messages Linhas de erro exibidas abaixo do cabeçalho `[{action}]`.
+     * @example
+     * ```ts
+     * throw new PipaException(...TASK_TOOL_NUDGES.setup.failed, `Tarefa não encontrada.`);
+     * ```
+     */
+    constructor(intent: string, ...messages: string[]);
+}
+//# sourceMappingURL=pipa-exception.d.ts.map

package/extensions/pipa/core/errors/pipa-exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipa-exception.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/core/errors/pipa-exception.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,qBAAa,aAAc,SAAQ,KAAK;IACtC,oEAAoE;IACpE,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,wEAAwE;IACxE,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;;;;;;OAOG;IACH,YAAY,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,EAShD;CACF"}

package/extensions/pipa/core/events.types.d.ts

@@ -0,0 +1,72 @@
+import type { BacklogItem } from '../features/backlog/backlog.entity';
+import type { DocItem } from '../features/docs/docs.entity';
+import type { Task } from '../features/task/task.entity';
+import type { Teammate } from '../features/teammate/teammate.entity';
+import type { TodoItem } from '../features/todo/todo.entity';
+import type { PipaApi } from '../interfaces/pipa';
+/**
+ * Mapa de eventos de domínio → payload.
+ *
+ * Interface (e não type) para permitir declaration merging: features externas
+ * estendem o mapa sem alterar o core — basta declarar a nova chave e emitir
+ * no hub correspondente.
+ */
+export interface DomainEventMap {
+    /** Dispara na action `instantiate`; payload = documento persistido. */
+    doc_created: DocItem;
+    /** Dispara nas actions `update-frontmatter` e `update-body`; payload = documento atualizado. */
+    doc_updated: DocItem;
+    /** Dispara na action `remove`; payload = documento removido. */
+    doc_removed: DocItem;
+    /** Dispara na action `publish`; payload = caminho do site e URL servida. */
+    doc_published: {
+        path: string;
+        url: string;
+    };
+    /** Dispara na action `instantiate`; payload = item persistido. */
+    backlog_created: BacklogItem;
+    /** Dispara nas actions `update-frontmatter`, `update-body` e `update-metadata`; payload = item atualizado. */
+    backlog_updated: BacklogItem;
+    /** Dispara na action `remove`; payload = item removido. */
+    backlog_removed: BacklogItem;
+    /** Dispara na action `instantiate`; payload = tarefa persistida. */
+    task_created: Task;
+    /** Dispara na action `claim`; payload = tarefa reivindicada. */
+    task_claimed: Task;
+    /** Dispara nas actions `setup` e `update`; payload = tarefa atualizada. */
+    task_updated: Task;
+    /** Dispara na action `complete`; payload = tarefa concluída. */
+    task_completed: Task;
+    /** Dispara na action `remove`; payload = tarefa removida. */
+    task_removed: Task;
+    /** Dispara na action `instantiate`; payload = item persistido. */
+    todo_created: TodoItem;
+    /** Dispara na action `update`; payload = item atualizado. */
+    todo_updated: TodoItem;
+    /** Dispara na action `remove`; payload = item removido. */
+    todo_removed: TodoItem;
+    /** Dispara na action `clear`; payload = sessão do agente dono da lista esvaziada. */
+    todo_cleared: {
+        sessionId: string;
+    };
+    /** Dispara na action `instantiate`; payload = DTO mínimo do teammate criado (sem session/pipa). */
+    teammate_created: TeammateEventPayload;
+    /** Dispara na action `dismiss`; payload = agente dispensado, quantidade de sessões encerradas e motivo da dispensa. */
+    teammate_removed: {
+        dismissed: {
+            id: string;
+            name: string;
+        };
+        count: number;
+        reason: string;
+    };
+}
+/** Payload mínimo serializável dos eventos de teammate — nunca inclui `session`/`pipa`. */
+export type TeammateEventPayload = Pick<Teammate, 'sessionId' | 'name' | 'status' | 'role' | 'parentSessionId' | 'depth'>;
+/** Nome de um evento de domínio (chave do mapa). */
+export type DomainEventName = keyof DomainEventMap;
+/** Payload de um evento de domínio, derivado do mapa. */
+export type PipaPayload<E extends DomainEventName> = DomainEventMap[E];
+/** Handler de evento de domínio: recebe o payload e a instância da PipaApi. */
+export type DomainEventHandler<E extends DomainEventName> = (payload: PipaPayload<E>, pipa: PipaApi) => void;
+//# sourceMappingURL=events.types.d.ts.map

package/extensions/pipa/core/events.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.types.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/core/events.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,WAAW,EAAE,OAAO,CAAC;IACrB,gGAAgG;IAChG,WAAW,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,WAAW,EAAE,OAAO,CAAC;IACrB,4EAA4E;IAC5E,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAE7C,kEAAkE;IAClE,eAAe,EAAE,WAAW,CAAC;IAC7B,8GAA8G;IAC9G,eAAe,EAAE,WAAW,CAAC;IAC7B,2DAA2D;IAC3D,eAAe,EAAE,WAAW,CAAC;IAE7B,oEAAoE;IACpE,YAAY,EAAE,IAAI,CAAC;IACnB,gEAAgE;IAChE,YAAY,EAAE,IAAI,CAAC;IACnB,2EAA2E;IAC3E,YAAY,EAAE,IAAI,CAAC;IACnB,gEAAgE;IAChE,cAAc,EAAE,IAAI,CAAC;IACrB,6DAA6D;IAC7D,YAAY,EAAE,IAAI,CAAC;IAEnB,kEAAkE;IAClE,YAAY,EAAE,QAAQ,CAAC;IACvB,6DAA6D;IAC7D,YAAY,EAAE,QAAQ,CAAC;IACvB,2DAA2D;IAC3D,YAAY,EAAE,QAAQ,CAAC;IACvB,qFAAqF;IACrF,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAEpC,mGAAmG;IACnG,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,uHAAuH;IACvH,gBAAgB,EAAE;QAAE,SAAS,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9F;AAED,2FAA2F;AAC3F,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,QAAQ,EACR,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,iBAAiB,GAAG,OAAO,CACvE,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,eAAe,GAAG,MAAM,cAAc,CAAC;AAEnD,yDAAyD;AACzD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,eAAe,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC;AAEvE,+EAA+E;AAC/E,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,eAAe,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC"}

package/extensions/pipa/core/pipa.d.ts

@@ -0,0 +1,19 @@
+import { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';
+import { PipaApi } from '../interfaces/pipa';
+/**
+ * Retorna a instância principal da PipaApi, referente a sessão principal.
+ */
+export declare const pipa: () => Readonly<PipaApi>;
+/**
+ * Constrói a API da Pipa para ser utilizada nos features, encapsulando o ExtensionAPI
+ * e adicionando funcionalidades customizadas.
+ *
+ * Inicializa a instância principal da PipaApi, garantindo que o contexto seja atualizado
+ * a cada evento disparado.
+ *
+ * @param pi O ExtensionAPI fornecido pelo Pi Coding Agent.
+ * @param context O contexto de execução do evento.
+ * @returns Uma instância de PipaApi, pronta para ser utilizada pelos features da Pipa.
+ */
+export declare function buildPipaApi(pi: ExtensionAPI, context: ExtensionContext): PipaApi;
+//# sourceMappingURL=pipa.d.ts.map

package/extensions/pipa/core/pipa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipa.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/core/pipa.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAKjF,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAQ7C;;GAEG;AACH,eAAO,MAAM,IAAI,yBAEhB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CA0GjF"}

package/extensions/pipa/core/toast.d.ts

@@ -0,0 +1,13 @@
+import type { Notification } from 'node-notifier';
+export interface ToastOptions extends Notification {
+    message: string;
+}
+export declare class Toast {
+    private readonly interpolations;
+    private readonly activeToasts;
+    constructor(interpolations: () => Record<string, string | number>);
+    private sendToast;
+    show(message: string, options?: Omit<ToastOptions, 'message'>): Promise<void>;
+}
+export type ToastService = Toast;
+//# sourceMappingURL=toast.d.ts.map

package/extensions/pipa/core/toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/core/toast.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAQlD,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,OAAO,EAAE,MAAM,CAAC;CACjB;AAqBD,qBAAa,KAAK;IAGJ,OAAO,CAAC,QAAQ,CAAC,cAAc;IAF3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD,YAA6B,cAAc,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,EAAI;YAExE,SAAS;IAgCjB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,iBAElE;CACF;AAED,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC"}

package/extensions/pipa/cross-cutting/resource-loader.d.ts

@@ -0,0 +1,8 @@
+import { DefaultResourceLoader } from '@earendil-works/pi-coding-agent';
+/**
+ * Retorna uma instância compartilhada do ResourceLoader para ser usada por subagentes.
+ * Isso garante que todos os subagentes tenham acesso aos mesmos recursos e extensões carregados.
+ */
+export declare function getSharedResourceLoader(cwd: string): Promise<DefaultResourceLoader>;
+export declare function ensureResourceLoaderReloaded(): Promise<void>;
+//# sourceMappingURL=resource-loader.d.ts.map

package/extensions/pipa/cross-cutting/resource-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-loader.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/cross-cutting/resource-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAe,MAAM,iCAAiC,CAAC;AAOrF;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAczF;AAED,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,IAAI,CAAC,CASlE"}

package/extensions/pipa/cross-cutting/store.d.ts

@@ -0,0 +1,5 @@
+export declare class PipaStore {
+    static set<T>(key: string, metadata: T): T;
+    static get<T>(key: string): T | undefined;
+}
+//# sourceMappingURL=store.d.ts.map

package/extensions/pipa/cross-cutting/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/cross-cutting/store.ts"],"names":[],"mappings":"AAEA,qBAAa,SAAS;IACpB,OAAc,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAIhD;IAED,OAAc,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAE/C;CACF"}