@aelinrezende/pipa-core 1.0.0

package/extensions/pipa/features/docs/hub/validator.d.ts

@@ -0,0 +1,19 @@
+import { DOCS_TOOL_NUDGES } from '../../../constants/docs';
+import type { DocItem } from '../docs.entity';
+/** Valida regras de negócio antes de operações em documentos */
+export declare class DocsValidator {
+    /** Verifica se o documento existe e retorna. Throw PipaException se não encontrado. */
+    protected canUpdate(code: string, action?: Exclude<keyof typeof DOCS_TOOL_NUDGES, 'publish'>): DocItem;
+    /** Verifica se o documento existe para remoção. */
+    protected canRemove(code: string): DocItem;
+    /** Verifica se o documento existe para operação select. */
+    protected canSelect(code: string): DocItem;
+    /** Valida dados para criação. */
+    protected canCreate({ title, parentCode }: Pick<DocItem, 'title' | 'parentCode'>): void;
+    /**
+     * Valida reparent: pai deve existir e não pode ser descendente do próprio documento.
+     * parentCode vazio/undefined torna o documento raiz (sem pai).
+     */
+    protected assertParentValid(code: string, parentCode?: string): void;
+}
+//# sourceMappingURL=validator.d.ts.map

package/extensions/pipa/features/docs/hub/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/docs/hub/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,gEAAgE;AAChE,qBAAa,aAAa;IACxB,uFAAuF;IACvF,SAAS,CAAC,SAAS,CACjB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,OAAO,CAAC,MAAM,OAAO,gBAAgB,EAAE,SAAS,CAAwB,GAC/E,OAAO,CAWT;IAED,mDAAmD;IACnD,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQzC;IAED,2DAA2D;IAC3D,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQzC;IAED,iCAAiC;IACjC,SAAS,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,GAAG,IAAI,CAWtF;IAED;;;OAGG;IACH,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CA0BnE;CACF"}

package/extensions/pipa/features/onboarding/index.d.ts

@@ -0,0 +1,2 @@
+export * from './onboarding.feature';
+//# sourceMappingURL=index.d.ts.map

package/extensions/pipa/features/onboarding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/onboarding/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/extensions/pipa/features/onboarding/onboarding.feature.d.ts

@@ -0,0 +1,19 @@
+import type { BeforeAgentStartEvent, BeforeAgentStartEventResult } from '@earendil-works/pi-coding-agent';
+import { PipaBaseFeature } from '../base-feature';
+import { type PipaApi } from '../../interfaces';
+/**
+ * Feature responsável por injetar o prompt de onboarding no agente principal (Pipa),
+ * caso o ambiente ainda não possua o arquivo global de configurações (`.pi/PROFILE.md`).
+ */
+export declare class OnboardingFeature extends PipaBaseFeature {
+    /**
+     * Hook disparado antes do início da execução de qualquer agente.
+     * Intercepta a inicialização do orquestrador principal (main) e, se estiver no modo onboarding,
+     * anexa as diretrizes de setup (onboarding.md) ao final do System Prompt.
+     *
+     * @param event O evento contendo o contexto e System Prompt que será enviado ao LLM.
+     * @param pipa A instância de API da Pipa.
+     */
+    enforceOnboarding(event: BeforeAgentStartEvent, pipa: PipaApi): BeforeAgentStartEventResult;
+}
+//# sourceMappingURL=onboarding.feature.d.ts.map

package/extensions/pipa/features/onboarding/onboarding.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.feature.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/onboarding/onboarding.feature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIlD,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGhD;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IACpD;;;;;;;OAOG;IAEH,iBAAiB,CAAC,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,OAAO,GAAG,2BAA2B,CAiB1F;CACF"}

package/extensions/pipa/features/onboarding/prompts.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Lê e retorna o conteúdo do arquivo de prompt de onboarding (`onboarding.md`).
+ * Este prompt é utilizado para guiar o setup inicial do framework quando o `.pi/PROFILE.md` não existe.
+ *
+ * @returns O conteúdo do arquivo onboarding.md em formato texto (utf-8).
+ */
+export declare function getOnboardingPrompt(): string;
+//# sourceMappingURL=prompts.d.ts.map

package/extensions/pipa/features/onboarding/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/onboarding/prompts.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/extensions/pipa/features/permission/hooks/custom-tools.d.ts

@@ -0,0 +1,12 @@
+import type { ToolCallEvent, ToolCallEventResult } from '@earendil-works/pi-coding-agent';
+import type { PipaApi } from '../../../interfaces';
+/**
+ * Hook dedicado a gerenciar permissões de ferramentas específicas (como task, todo, teammates e ask_user_question).
+ */
+export declare class CustomToolsGuard {
+    /**
+     * Valida permissões customizadas definidas em blockedForMain e outras regras de ciclo de vida.
+     */
+    validateTools({ toolName, input }: ToolCallEvent, pipa: PipaApi): Promise<ToolCallEventResult | void>;
+}
+//# sourceMappingURL=custom-tools.d.ts.map

package/extensions/pipa/features/permission/hooks/custom-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-tools.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/permission/hooks/custom-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE1F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IAEG,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAsE1G;CACF"}

package/extensions/pipa/features/permission/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export * from './terminal';
+export * from './custom-tools';
+//# sourceMappingURL=index.d.ts.map

package/extensions/pipa/features/permission/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/permission/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/extensions/pipa/features/permission/hooks/terminal.d.ts

@@ -0,0 +1,12 @@
+import type { ToolCallEvent, ToolCallEventResult } from '@earendil-works/pi-coding-agent';
+import type { PipaApi } from '../../../interfaces';
+/**
+ * Hook dedicado para bloquear comandos bash perigosos e avisar o supervisor em operações diretas de edição.
+ */
+export declare class TerminalGuard {
+    /**
+     * Valida permissões para as ferramentas globais do sistema, como bash, edit e write.
+     */
+    validateTerminal({ toolName, input }: ToolCallEvent, pipa: PipaApi): Promise<ToolCallEventResult | void>;
+}
+//# sourceMappingURL=terminal.d.ts.map

package/extensions/pipa/features/permission/hooks/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/permission/hooks/terminal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE1F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IAEG,gBAAgB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA6C7G;CACF"}

package/extensions/pipa/features/permission/permission.definitions.d.ts

@@ -0,0 +1,16 @@
+import type { CommandPolicy } from '../../interfaces';
+/**
+ * Lista global de comandos de terminal considerados perigosos.
+ * Bloqueia operações que podem causar perda de dados ou processos longos/interativos.
+ */
+export declare const blockedCommands: string[];
+/**
+ * Mapeamento de permissões restritas exclusivas para o supervisor (main).
+ * O caractere '*' bloqueia o uso completo da ferramenta.
+ */
+export declare const blockedForMain: Record<string, string[]>;
+/**
+ * Políticas específicas por executável para restringir flags perigosas.
+ */
+export declare const commandPolicies: Record<string, CommandPolicy>;
+//# sourceMappingURL=permission.definitions.d.ts.map

package/extensions/pipa/features/permission/permission.definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.definitions.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/permission/permission.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,eAAe,UAoC3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAInD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAIzD,CAAC"}

package/extensions/pipa/features/permission/permission.feature.d.ts

@@ -0,0 +1,13 @@
+import { PipaBaseFeature } from '../base-feature';
+import { TerminalGuard, CustomToolsGuard } from './hooks';
+declare const PermissionFeature_base: import("ts-mixer/dist/types/types").Class<any[], PipaBaseFeature & TerminalGuard & CustomToolsGuard, typeof PipaBaseFeature & typeof TerminalGuard & typeof CustomToolsGuard>;
+/**
+ * Feature para controle de permissões globais e de segurança de ferramentas.
+ * Deve conter apenas restrições genéricas e de segurança global do sistema.
+ * Regras específicas de permissões associadas a domínios ou ciclo de vida de recursos (como tarefas ou teammates)
+ * devem residir em seus respectivos hooks/features.
+ */
+export declare class PermissionFeature extends PermissionFeature_base {
+}
+export {};
+//# sourceMappingURL=permission.feature.d.ts.map

package/extensions/pipa/features/permission/permission.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.feature.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/permission/permission.feature.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;;AAE1D;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,sBAAuD;CAAG"}

package/extensions/pipa/features/provider/custom.feature.d.ts

@@ -0,0 +1,8 @@
+import type { BeforeAgentStartEvent, ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import { PipaBaseFeature } from '../base-feature';
+import type { PipaApi } from '../../interfaces';
+export declare class ProviderFeature extends PipaBaseFeature {
+    initialize(pi: ExtensionAPI): Promise<void> | void;
+    addToolsDefinition(event: BeforeAgentStartEvent, pipa: PipaApi): BeforeAgentStartEvent | undefined;
+}
+//# sourceMappingURL=custom.feature.d.ts.map

package/extensions/pipa/features/provider/custom.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.feature.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/provider/custom.feature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAOhD,qBAAa,eAAgB,SAAQ,eAAe;IAClD,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAoCjD;IAGD,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,OAAO,qCAwB7D;CACF"}

package/extensions/pipa/features/reminder-cleaner/hooks/cleaner.d.ts

@@ -0,0 +1,14 @@
+import type { ContextEvent } from '@earendil-works/pi-coding-agent';
+import type { ContextEventResult } from '@earendil-works/pi-coding-agent/extensions';
+import type { PipaApi } from '../../../interfaces';
+/**
+ * Colapsa no contexto LLM as notificações (nudges) customizadas duplicadas:
+ * identidade = `customType` + hash do conteúdo, último vence, mantendo 1 resumo
+ * consolidado (padrão TaskGuard — nunca sumir silencioso).
+ *
+ * Idempotente e sem estado: afeta apenas o que vai ao LLM; a session permanece append-only.
+ */
+export declare class ReminderCleaner {
+    clean(event: ContextEvent, _pipa: PipaApi): ContextEventResult | void;
+}
+//# sourceMappingURL=cleaner.d.ts.map

package/extensions/pipa/features/reminder-cleaner/hooks/cleaner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleaner.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/reminder-cleaner/hooks/cleaner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;GAMG;AACH,qBAAa,eAAe;IAE1B,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CA2CpE;CACF"}

package/extensions/pipa/features/reminder-cleaner/reminder-cleaner.feature.d.ts

@@ -0,0 +1,12 @@
+import { PipaBaseFeature } from '../base-feature';
+import { ReminderCleaner } from './hooks/cleaner';
+declare const ReminderCleanerFeature_base: import("ts-mixer/dist/types/types").Class<any[], PipaBaseFeature & ReminderCleaner, typeof PipaBaseFeature & typeof ReminderCleaner>;
+/**
+ * Feature neutra de higiene de contexto: limpa do contexto LLM as notificações
+ * (nudges) que já cumpriram seu papel, independentemente da feature de origem
+ * (task, teammates, docs, backlog, etc).
+ */
+export declare class ReminderCleanerFeature extends ReminderCleanerFeature_base {
+}
+export {};
+//# sourceMappingURL=reminder-cleaner.feature.d.ts.map

package/extensions/pipa/features/reminder-cleaner/reminder-cleaner.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-cleaner.feature.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/reminder-cleaner/reminder-cleaner.feature.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;;AAElD;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,2BAAuC;CAAG"}

package/extensions/pipa/features/task/hooks/guard.d.ts

@@ -0,0 +1,14 @@
+import type { ContextEvent, ToolCallEvent, ToolCallEventResult } from '@earendil-works/pi-coding-agent';
+import type { ContextEventResult } from '@earendil-works/pi-coding-agent/extensions';
+import type { PipaApi } from '../../../interfaces';
+/**
+ * Bloqueia qualquer tool call feita sem uma tarefa ativa reivindicada
+ * e colapsa o loop de tentativas repetidas no contexto enviado ao LLM,
+ * substituindo as mensagens bloqueadas por um único aviso consolidado.
+ */
+export declare class TaskGuard {
+    private readonly blockedToolCallIds;
+    guardUnclaimedToolCall({ toolName, toolCallId }: ToolCallEvent, pipa: PipaApi): ToolCallEventResult | void;
+    collapseBlockedLoop(event: ContextEvent, _pipa: PipaApi): ContextEventResult | void;
+}
+//# sourceMappingURL=guard.d.ts.map

package/extensions/pipa/features/task/hooks/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/task/hooks/guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACxG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAanD;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IAGxD,sBAAsB,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAsBzG;IAGD,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CA+ClF;CACF"}

package/extensions/pipa/features/task/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export * from './guard';
+export * from './reminders';
+export * from './tui-register';
+//# sourceMappingURL=index.d.ts.map

package/extensions/pipa/features/task/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/task/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/extensions/pipa/features/task/hooks/reminders.d.ts

@@ -0,0 +1,15 @@
+import { type PipaApi } from '../../../interfaces';
+import { TeammateSessionIntervalsHost } from '../../teammate/hooks';
+/**
+ * Hook responsável por notificar criadores de tarefas órfãs e teammates idle
+ * sobre tarefas disponíveis que podem executar.
+ */
+export declare class TaskReminders extends TeammateSessionIntervalsHost {
+    private readonly lastCreatorNudge;
+    private readonly lastTeammateNudge;
+    nudgeCreatorAboutUnownedTasks(): void;
+    nudgeIdleTeammatesAboutAvailableTasks(): void;
+    nudgeIdleTeammatesWithActiveTasks(): void;
+    shutdown(_: unknown, pipa: PipaApi): void;
+}
+//# sourceMappingURL=reminders.d.ts.map

package/extensions/pipa/features/task/hooks/reminders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminders.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/task/hooks/reminders.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAQpE;;;GAGG;AACH,qBAAa,aAAc,SAAQ,4BAA4B;IAC7D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IAG/D,6BAA6B,SAqC5B;IAGD,qCAAqC,SA0CpC;IAGD,iCAAiC,SAgDhC;IAGD,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,QAEjC;CACF"}

package/extensions/pipa/features/task/hooks/tui-register.d.ts

@@ -0,0 +1,8 @@
+import type { PipaApi } from '../../../interfaces';
+/**
+ * Hook para registrar o widget TUI de gerenciamento de tarefas.
+ */
+export declare class TaskTuiRegister {
+    captureMain(_: unknown, api: PipaApi): void;
+}
+//# sourceMappingURL=tui-register.d.ts.map

package/extensions/pipa/features/task/hooks/tui-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-register.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/task/hooks/tui-register.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD;;GAEG;AACH,qBAAa,eAAe;IAE1B,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,QA+BnC;CACF"}

package/extensions/pipa/features/task/hub/core.d.ts

@@ -0,0 +1,60 @@
+import { PipaApi } from '../../../interfaces';
+import { Task, TaskToolSchema } from '../task.entity';
+import { TaskState } from './state';
+import { TaskValidator } from './validator';
+declare const TaskCore_base: import("ts-mixer/dist/types/types").Class<any[], TaskValidator & TaskState, typeof TaskValidator & typeof TaskState>;
+/**
+ * Mixin central de operações e regras de negócio para tarefas no TaskHub.
+ */
+export declare class TaskCore extends TaskCore_base {
+    readonly pipa: PipaApi;
+    constructor(pipa: PipaApi);
+    /**
+     * Obtém os detalhes de uma tarefa específica pelo seu ID.
+     * @param data Payload único da action 'get'.
+     * @returns A tarefa encontrada.
+     * @throws PipaException quando o ID não existe.
+     */
+    get({ id }: TaskToolSchema<'get'>): Task;
+    /**
+     * Lista as tarefas do quadro, com suporte a filtro opcional por status.
+     * @param data Payload único da action 'list'.
+     * @returns A lista de tarefas.
+     */
+    list({ status }: TaskToolSchema<'list'>): Task[];
+    /**
+     * Inicializa uma nova tarefa com metadados básicos e a marca como em andamento.
+     * @param data Payload único da action 'setup'.
+     * @returns A tarefa configurada.
+     */
+    setup({ id, updates }: TaskToolSchema<'setup'>): Task;
+    /**
+     * Atualiza os metadados de uma tarefa existente.
+     * @param data Payload único da action 'update'.
+     * @returns A tarefa atualizada.
+     */
+    update({ id, updates }: TaskToolSchema<'update'>): Task;
+    /**
+     * Remove permanentemente uma tarefa do quadro de pendências.
+     * @param data Payload único da action 'remove'.
+     */
+    remove({ id, force }: TaskToolSchema<'remove'>): void;
+    /**
+     * Reivindica e associa uma tarefa ao subagente atual, colocando-a em andamento.
+     * @param data Payload único da action 'claim'.
+     * @returns A tarefa reivindicada.
+     */
+    claim({ id }: TaskToolSchema<'claim'>): Task;
+    /**
+     * Conclui uma tarefa, sinalizando seu encerramento e notificando o supervisor.
+     * @param data Payload único da action 'complete'.
+     * @returns A tarefa concluída.
+     */
+    complete({ id, artifactFile, force }: TaskToolSchema<'complete'>): Task;
+    /**
+     * Proativamente avisa subagentes que estão ociosos sobre novas tarefas disponíveis.
+     */
+    notifyEligibleIdleTeammates(): void;
+}
+export {};
+//# sourceMappingURL=core.d.ts.map

package/extensions/pipa/features/task/hub/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/task/hub/core.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;;AAE5C;;GAEG;AACH,qBAAa,QAAS,SAAQ,aAA+B;IAC/C,QAAQ,CAAC,IAAI,EAAE,OAAO;IAAlC,YAAqB,IAAI,EAAE,OAAO,EAEjC;IAED;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,IAAI,CAQvC;IAED;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAS/C;IAED;;;;OAIG;IACH,KAAK,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAepD;IAED;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAWtD;IAED;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAYpD;IAED;;;;OAIG;IACH,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAoB3C;IAED;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAwCtE;IAED;;OAEG;IACI,2BAA2B,IAAI,IAAI,CA0BzC;CACF"}

package/extensions/pipa/features/task/hub/index.d.ts

@@ -0,0 +1,5 @@
+export * from './state';
+export * from './validator';
+export * from './core';
+export * from './squad';
+//# sourceMappingURL=index.d.ts.map

package/extensions/pipa/features/task/hub/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/task/hub/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/extensions/pipa/features/task/hub/squad.d.ts

@@ -0,0 +1,37 @@
+import { PipaApi } from '../../../interfaces';
+import { Task, TaskToolSchema } from '../task.entity';
+/**
+ * Mixin de operações de squad para o TaskManager.
+ */
+export declare class TaskSquad {
+    readonly pipa: PipaApi;
+    constructor(pipa: PipaApi);
+    /**
+     * Lista as tarefas principais (épicos) de todos os squads em andamento ou registrados.
+     */
+    static getActiveSquads(): Task[];
+    /**
+     * Retorna a primeira task raiz (sem parentTaskId) do squad informado, ou undefined.
+     */
+    getParentSquadTask(squad?: string): Task | undefined;
+    /**
+     * Lista tarefas de um squad.
+     * @param data Payload único da action 'list-by-squad'.
+     * @returns A lista de tarefas do squad.
+     */
+    listBySquad({ squad }: TaskToolSchema<'list-by-squad'>): Task[];
+    /**
+     * Status de progresso de um squad.
+     * @param data Payload único da action 'squad-status'.
+     * @returns Objeto com status do squad.
+     */
+    squadStatus({ squad }: TaskToolSchema<'squad-status'>): {
+        squad: string;
+        total: number;
+        completed: number;
+        inProgress: number;
+        pending: number;
+        progress: string;
+    };
+}
+//# sourceMappingURL=squad.d.ts.map

package/extensions/pipa/features/task/hub/squad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"squad.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/task/hub/squad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,qBAAa,SAAS;IACR,QAAQ,CAAC,IAAI,EAAE,OAAO;IAAlC,YAAqB,IAAI,EAAE,OAAO,EAAI;IAEtC;;OAEG;IACH,OAAc,eAAe,IAAI,IAAI,EAAE,CAEtC;IAED;;OAEG;IACH,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAMnD;IAED;;;;OAIG;IACH,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE,cAAc,CAAC,eAAe,CAAC,GAAG,IAAI,EAAE,CAE9D;IAED;;;;OAIG;IACH,WAAW,CAAC,EAAE,KAAK,EAAE,EAAE,cAAc,CAAC,cAAc,CAAC;;;;;;;MAepD;CACF"}

package/extensions/pipa/features/task/hub/state.d.ts

@@ -0,0 +1,104 @@
+import { BaseClass, PipaApi } from '../../../interfaces';
+import { FileManager } from '../../../lib';
+import { Teammate } from '../../teammate/teammate.entity';
+import { Task } from '../task.entity';
+export declare class TaskState {
+    readonly pipa: PipaApi;
+    constructor(pipa: PipaApi);
+    static get fileManager(): FileManager<Task[]>;
+    /**
+     * Recupera a store de tarefas.
+     */
+    private static get store();
+    /**
+     * Carrega as tarefas persistidas em disco para a store em memória.
+     * O diretório é o da sessão principal (~/.pi/tasks/<sessionId-do-main>/tasks.json).
+     */
+    static load(): void;
+    /**
+     * Salva silenciosamente o estado atual para o disco em JSON.
+     */
+    private static persist;
+    /**
+     * Adiciona uma nova tarefa à store e retorna a tarefa criada.
+     */
+    static add(task: BaseClass<Task>): Task;
+    /**
+     * Atualiza os dados de uma tarefa existente na store e retorna a tarefa atualizada.
+     */
+    static update(id: string, data: Partial<Task>): Task;
+    /**
+     * Recupera uma tarefa da store pelo id.
+     * Lança um erro se a tarefa não for encontrada.
+     */
+    static get(id: string): Task;
+    /**
+     * Recupera uma tarefa da store pelo id.
+     */
+    static find(id: string): Task | undefined;
+    /**
+     * Lista todas as tarefas atualmente armazenadas.
+     */
+    static list(sessionId?: string): Task[];
+    /**
+     * Busca tarefas que atendam a um predicado.
+     */
+    static search(filter: (task: Task) => boolean): Task[];
+    /**
+     * Busca a primeira tarefa que atenda a um predicado.
+     */
+    static findOne(filter: (task: Task) => boolean): Task | undefined;
+    /**
+     * Remove uma tarefa da store pelo id.
+     */
+    static delete(id: string): void;
+    /**
+     * Limpa o cache de tarefas em memória.
+     */
+    static clear(): void;
+    /**
+     * Verifica se uma tarefa não possui nenhum bloqueio pendente.
+     * Bloqueios do tipo 'hard' exigem que a tarefa dependente esteja concluída.
+     * Bloqueios do tipo 'soft' apenas sinalizam a pendência.
+     */
+    static isUnblocked(task: Task): boolean;
+    /**
+     * Verifica se um teammate é elegível para uma tarefa.
+     * Criador online → self-only por sessão. Criador offline → fallback via nome do teammate (role).
+     */
+    static isEligibleForTask(task: Task, teammate: Teammate): boolean;
+    /**
+     * Lista todas as tarefas livres (pending, sem owner) e não bloqueadas.
+     */
+    static listAvailable(): Task[];
+    /**
+     * Lista todas as tarefas atribuídas a um determinado teammate.
+     */
+    static listByOwner(sessionId: string): Task[];
+    /**
+     * Lista todas as tarefas que estão ativas (em andamento ou em setup).
+     */
+    static listActive(): Task[];
+    /**
+     * Verifica se um determinado teammate possui uma tarefa ativa (em andamento ou em setup).
+     */
+    static hasActiveTask(sessionId: string): boolean;
+    /**
+     * Retorna a task de setup ou em andamento de um agente, ou undefined.
+     */
+    static getActiveTask(sessionId: string): Task | undefined;
+    /**
+     * Retorna as dependências "hard" não concluídas de uma tarefa.
+     */
+    static getUncompletedHardDependencies(task: Task): Task[];
+    /**
+     * Verifica se há alguma dependência "hard" pendente.
+     */
+    static hasUncompletedHardDependency(task: Task): boolean;
+    /**
+     * Sincroniza o status de uma tarefa pai com base nas suas filhas.
+     * Retorna true se o status foi alterado.
+     */
+    static syncParentStatus(parentId: string): boolean;
+}
+//# sourceMappingURL=state.d.ts.map

package/extensions/pipa/features/task/hub/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/task/hub/state.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAc,MAAM,gBAAgB,CAAC;AAElD,qBAAa,SAAS;IACR,QAAQ,CAAC,IAAI,EAAE,OAAO;IAAlC,YAAqB,IAAI,EAAE,OAAO,EAAI;IAEtC,WAAkB,WAAW,wBAE5B;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,KAAK,KAAK,GAQvB;IAED;;;OAGG;IACH,OAAc,IAAI,IAAI,IAAI,CAGzB;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,OAAO;IAItB;;OAEG;IACH,OAAc,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAK7C;IAED;;OAEG;IACH,OAAc,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAW1D;IAED;;;OAGG;IACH,OAAc,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAQlC;IAED;;OAEG;IACH,OAAc,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE/C;IAED;;OAEG;IACH,OAAc,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAQ7C;IAED;;OAEG;IACH,OAAc,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,GAAG,IAAI,EAAE,CAE5D;IAED;;OAEG;IACH,OAAc,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,GAAG,IAAI,GAAG,SAAS,CAEvE;IAED;;OAEG;IACH,OAAc,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIrC;IAED;;OAEG;IACH,OAAc,KAAK,IAAI,IAAI,CAI1B;IAED;;;;OAIG;IACH,OAAc,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAkB7C;IAED;;;OAGG;IACH,OAAc,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAQvE;IAED;;OAEG;IACH,OAAc,aAAa,IAAI,IAAI,EAAE,CAIpC;IAED;;OAEG;IACH,OAAc,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,CAEnD;IAED;;OAEG;IACH,OAAc,UAAU,IAAI,IAAI,EAAE,CAEjC;IAED;;OAEG;IACH,OAAc,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAItD;IAED;;OAEG;IACH,OAAc,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAI/D;IAED;;OAEG;IACH,OAAc,8BAA8B,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,CAM/D;IAED;;OAEG;IACH,OAAc,4BAA4B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAQ9D;IAED;;;OAGG;IACH,OAAc,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAoCxD;CACF"}

package/extensions/pipa/features/task/hub/validator.d.ts

@@ -0,0 +1,50 @@
+import { Teammate } from '../../teammate/teammate.entity';
+import { Dependency, Task } from '../task.entity';
+/**
+ * Mixin que fornece métodos de validação de negócios para o TaskHub.
+ * Isola as lógicas complexas de permissão, estado e checagem de erros.
+ */
+export declare class TaskValidator {
+    /**
+     * Valida unicidade de nome da tarefa.
+     */
+    private validateUniqueName;
+    /**
+     * Valida integridade de dependências (anti-órfão).
+     */
+    private validateAntiOrphan;
+    /**
+     * Valida se uma nova tarefa pode ser criada.
+     * Verifica unicidade do nome para evitar duplicidades de escopo.
+     * Verifica integridade de referências (anti-órfãos).
+     */
+    protected canCreate(taskName: string, blockedBy?: Dependency[]): void;
+    /**
+     * Valida se uma tarefa pode receber a ação de setup.
+     * Aceita setup apenas de tarefas que estão no status 'setup'.
+     */
+    protected canSetup(id: string, updates: Partial<Task>, teammate: Teammate): Task;
+    /**
+     * Valida se uma tarefa pode ser atualizada pelo teammate.
+     */
+    protected canUpdate(id: string, updates: Partial<Task>, teammate: Teammate): Task;
+    /**
+     * Valida se uma tarefa pode ser removida pelo teammate.
+     * Verifica se a tarefa existe e se o usuário tem permissão para forçar a remoção caso esteja em andamento.
+     */
+    protected canRemove(id: string, teammate: Teammate, force?: boolean): Task;
+    /**
+     * Valida se uma tarefa pode ser reivindicada pelo teammate.
+     * Verifica o estado pendente da tarefa, se o solicitante é elegível (criador online → self-only;
+     * criador offline → fallback via role) e se existem dependências hard não concluídas.
+     */
+    protected canClaim(id: string, teammate: Teammate): Task;
+    /**
+     * Valida se uma tarefa pode ser concluída.
+     * Verifica a existência da tarefa, exigência do artefato, se o usuário
+     * é o dono da tarefa (ou supervisor/main no caso de force) e subtarefas.
+     * A orientação de force só é exibida para main (não-main não pode usar force).
+     */
+    protected canComplete(id: string, teammate: Teammate, artifactFile?: string, force?: boolean): Task;
+}
+//# sourceMappingURL=validator.d.ts.map

package/extensions/pipa/features/task/hub/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/task/hub/validator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAMlD;;;GAGG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;;;OAIG;IACH,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,UAAU,EAAO,GAAG,IAAI,CAGxE;IAED;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAgB/E;IAED;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAkChF;IAED;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAsBzE;IAED;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAkCvD;IAED;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAwDlG;CACF"}