@aelinrezende/pipa-core 1.0.0

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

@@ -0,0 +1,67 @@
+import Type from 'typebox';
+export declare const BACKLOG_TOOL_SCHEMA: {
+    /** Cria novo item no backlog com parâmetros diretos */
+    instantiate: Type.TObject<{
+        action: Type.TLiteral<"instantiate">;
+        title: Type.TString;
+        type: Type.TUnion<[Type.TLiteral<import("./backlog.entity").BacklogItemType>, ...Type.TLiteral<import("./backlog.entity").BacklogItemType>[]]>;
+        priority: Type.TUnion<[Type.TLiteral<import("./backlog.entity").BacklogPriority>, ...Type.TLiteral<import("./backlog.entity").BacklogPriority>[]]>;
+        domain: Type.TOptional<Type.TArray<Type.TUnion<[Type.TLiteral<import("./backlog.entity").BacklogDomain>, ...Type.TLiteral<import("./backlog.entity").BacklogDomain>[]]>>>;
+        parentCode: Type.TOptional<Type.TString>;
+        tags: Type.TOptional<Type.TArray<Type.TString>>;
+        metadata: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+        body: Type.TString;
+    }>;
+    /** Lista itens do backlog com filtro, ordenação e limite */
+    list: Type.TObject<{
+        action: Type.TLiteral<"list">;
+        status: Type.TOptional<Type.TUnion<[Type.TLiteral<import("./backlog.entity").BacklogStatus>, ...Type.TLiteral<import("./backlog.entity").BacklogStatus>[]]>>;
+        type: Type.TOptional<Type.TUnion<[Type.TLiteral<import("./backlog.entity").BacklogItemType>, ...Type.TLiteral<import("./backlog.entity").BacklogItemType>[]]>>;
+        sort: Type.TOptional<Type.TObject<{
+            field: Type.TUnion<[Type.TLiteral<"order" | "updatedAt">, ...Type.TLiteral<"order" | "updatedAt">[]]>;
+            order: Type.TUnion<[Type.TLiteral<"ASC" | "DESC">, ...Type.TLiteral<"ASC" | "DESC">[]]>;
+        }>>;
+        limit: Type.TOptional<Type.TNumber>;
+    }>;
+    /** Atualiza metadados YAML de um item do backlog */
+    'update-frontmatter': Type.TObject<{
+        action: Type.TLiteral<"update-frontmatter">;
+        code: Type.TString;
+        field: Type.TUnion<[Type.TLiteral<"body" | "code" | "createdAt" | "domain" | "order" | "parentCode" | "priority" | "status" | "tags" | "title" | "type" | "updatedAt">, ...Type.TLiteral<"body" | "code" | "createdAt" | "domain" | "order" | "parentCode" | "priority" | "status" | "tags" | "title" | "type" | "updatedAt">[]]>;
+        value: Type.TString;
+    }>;
+    /** Manipula o corpo markdown de um item do backlog */
+    'update-body': Type.TObject<{
+        action: Type.TLiteral<"update-body">;
+        code: Type.TString;
+        mode: Type.TUnion<[Type.TLiteral<"append">, Type.TLiteral<"replace">, Type.TLiteral<"set">]>;
+        value: Type.TString;
+        replacement: Type.TOptional<Type.TString>;
+    }>;
+    /** Faz merge de dados livres (metadata) em um item do backlog */
+    'update-metadata': Type.TObject<{
+        action: Type.TLiteral<"update-metadata">;
+        code: Type.TString;
+        metadata: Type.TRecord<"^.*$", Type.TUnknown>;
+    }>;
+    /** Busca item do backlog por título, código ou tags */
+    select: Type.TObject<{
+        action: Type.TLiteral<"select">;
+        query: Type.TOptional<Type.TString>;
+    }>;
+    /** Remove item do backlog por código */
+    remove: Type.TObject<{
+        action: Type.TLiteral<"remove">;
+        code: Type.TString;
+    }>;
+};
+export declare const BACKLOG_TOOL_ACTIONS_MESSAGE: {
+    list: string;
+    instantiate: string;
+    'update-frontmatter': string;
+    'update-body': string;
+    'update-metadata': string;
+    select: string;
+    remove: string;
+};
+//# sourceMappingURL=backlog.definitions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backlog.definitions.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/backlog/backlog.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAa3B,eAAO,MAAM,mBAAmB;IAC9B,uDAAuD;IACvD,WAAW;;;;;;;;;;;IAqDX,4DAA4D;IAC5D,IAAI;;;;;;;;;;IA2BJ,oDAAoD;IACpD,oBAAoB;;;;;;IAWpB,sDAAsD;IACtD,aAAa;;;;;;;IA2Bb,iEAAiE;IACjE,iBAAiB;;;;;IAajB,uDAAuD;IACvD,MAAM;;;;IASN,wCAAwC;IACxC,MAAM;;;;CAIP,CAAC;AAEF,eAAO,MAAM,4BAA4B;IACvC,IAAI;IACJ,WAAW;IACX,oBAAoB;IACpB,aAAa;IACb,iBAAiB;IACjB,MAAM;IACN,MAAM;CACP,CAAC"}

package/extensions/pipa/features/backlog/backlog.entity.d.ts

@@ -0,0 +1,43 @@
+import { BaseClass, ToolActionPayload, ToolParams } from '../../interfaces/common';
+import { BACKLOG_TOOL_SCHEMA } from './backlog.definitions';
+export type BacklogItemType = 'epic' | 'story' | 'task' | 'bugfix';
+export type BacklogStatus = 'triage' | 'in_progress' | 'done' | 'blocked' | 'cancelled';
+export type BacklogPriority = 'low' | 'medium' | 'high' | 'critical';
+export type BacklogDomain = 'api' | 'ui' | 'integration';
+export type BacklogToolParams = ToolParams<typeof BACKLOG_TOOL_SCHEMA>;
+/** Payload de cada ação da tool backlog */
+export type BacklogToolSchema<K extends keyof typeof BACKLOG_TOOL_SCHEMA> = ToolActionPayload<typeof BACKLOG_TOOL_SCHEMA, K>;
+/** Representa um item do backlog de tarefas do projeto */
+export declare class BacklogItem {
+    constructor(data: BaseClass<BacklogItem>);
+    /** Código curto gerado via nanoid(8) */
+    code: string;
+    /** Título descritivo da tarefa */
+    title: string;
+    /** Tipo do item: epic, story, task, bugfix */
+    type: BacklogItemType;
+    /** Status atual do item */
+    status: BacklogStatus;
+    /** Conteúdo markdown (objetivo, critérios…) */
+    body: string;
+    /** ISO date de criação */
+    createdAt: string;
+    /** ISO date da última modificação */
+    updatedAt: string;
+    /** Prioridade do item */
+    priority?: BacklogPriority;
+    /** Domínios relacionados */
+    domain?: BacklogDomain[];
+    /** Código do item pai (epic ou story) */
+    parentCode?: string;
+    /** Ordem de exibição */
+    order?: number;
+    /** Etiquetas livres */
+    tags?: string[];
+    /** Campo livre para dados arbitrários (links, IDs externos, flags) */
+    metadata?: Record<string, unknown>;
+}
+/** Campos do frontmatter editáveis — union type derivado de BacklogItem */
+export type BacklogItemFrontmatter = keyof Pick<BacklogItem, 'code' | 'title' | 'type' | 'status' | 'body' | 'createdAt' | 'updatedAt' | 'parentCode' | 'priority' | 'domain' | 'tags' | 'order'>;
+export type BacklogStore = Map<string, BacklogItem>;
+//# sourceMappingURL=backlog.entity.d.ts.map

package/extensions/pipa/features/backlog/backlog.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog.entity.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/backlog/backlog.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AACnE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;AACxF,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AACrE,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,IAAI,GAAG,aAAa,CAAC;AACzD,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEvE,2CAA2C;AAC3C,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,OAAO,mBAAmB,IAAI,iBAAiB,CAC3F,OAAO,mBAAmB,EAC1B,CAAC,CACF,CAAC;AAEF,0DAA0D;AAC1D,qBAAa,WAAW;IACtB,YAAY,IAAI,EAAE,SAAS,CAAC,WAAW,CAAC,EAEvC;IAED,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IAEd,8CAA8C;IAC9C,IAAI,EAAE,eAAe,CAAC;IAEtB,2BAA2B;IAC3B,MAAM,EAAE,aAAa,CAAC;IAEtB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAElB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IAEzB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uBAAuB;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,2EAA2E;AAC3E,MAAM,MAAM,sBAAsB,GAAG,MAAM,IAAI,CAC7C,WAAW,EACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,GACR,MAAM,GACN,WAAW,GACX,WAAW,GACX,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,MAAM,GACN,OAAO,CACV,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import { PipaBaseFeature } from '../base-feature';
+import { BacklogGuard } from './hooks';
+declare const BacklogFeature_base: import("ts-mixer/dist/types/types").Class<any[], PipaBaseFeature & BacklogGuard, typeof PipaBaseFeature & typeof BacklogGuard>;
+/**
+ * Feature principal do backlog de tarefas do projeto.
+ * Registra a tool 'backlog' e bloqueia write/edit direto em backlog.json.
+ */
+export declare class BacklogFeature extends BacklogFeature_base {
+    loadBacklog(): void;
+    initialize(pi: ExtensionAPI): void;
+}
+export {};
+//# sourceMappingURL=backlog.feature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backlog.feature.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/backlog/backlog.feature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAOpE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIlD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;;AAGvC;;;GAGG;AACH,qBAAa,cAAe,SAAQ,mBAAoC;IAE/D,WAAW,IAAI,IAAI,CAEzB;IAED,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA4CjC;CACF"}

package/extensions/pipa/features/backlog/backlog.hub.d.ts

@@ -0,0 +1,25 @@
+import { PipaApi } from '../../interfaces';
+import { BacklogItem, BacklogToolSchema } from './backlog.entity';
+import { BacklogCore, BacklogValidator } from './hub';
+declare const BacklogHub_base: import("ts-mixer/dist/types/types").Class<any[], BacklogValidator & BacklogCore, typeof BacklogValidator & typeof BacklogCore>;
+/**
+ * Gerencia o backlog local de tarefas do projeto.
+ * Persiste todos os itens como um único backlog.json.
+ */
+export declare class BacklogHub extends BacklogHub_base {
+    readonly pipa: PipaApi;
+    constructor(pipa: PipaApi);
+    instantiate(data: BacklogToolSchema<'instantiate'>): {
+        action: "instantiate";
+        title: string;
+        type: import("./backlog.entity").BacklogItemType;
+        priority: import("./backlog.entity").BacklogPriority;
+        domain?: import("./backlog.entity").BacklogDomain[] | undefined;
+        parentCode?: string | undefined;
+        tags?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        body: string;
+    } & BacklogItem;
+}
+export {};
+//# sourceMappingURL=backlog.hub.d.ts.map

package/extensions/pipa/features/backlog/backlog.hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backlog.hub.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/backlog/backlog.hub.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAgB,gBAAgB,EAAE,MAAM,OAAO,CAAC;;AAEpE;;;GAGG;AACH,qBAAa,UAAW,SAAQ,eAAoC;IACtD,QAAQ,CAAC,IAAI,EAAE,OAAO;IAAlC,YAAqB,IAAI,EAAE,OAAO,EAEjC;IAED,WAAW,CAAC,IAAI,EAAE,iBAAiB,CAAC,aAAa,CAAC;;;;;;;;;;oBAuBjD;CACF"}

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

@@ -0,0 +1,13 @@
+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 write/edit/read em backlog.json dentro de BACKLOG_BASE_DIR.
+ * Força uso da tool backlog para manipular tarefas.
+ */
+export declare class BacklogGuard {
+    private readonly blockedToolCallIds;
+    guardBacklogWrite(event: ToolCallEvent, _pipa: PipaApi): ToolCallEventResult | void;
+    collapseBlockedLoop(event: ContextEvent, _pipa: PipaApi): ContextEventResult | void;
+}
+//# sourceMappingURL=guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/backlog/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;AAGrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAYnD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IAGxD,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CA0BlF;IAGD,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CA2ClF;CACF"}

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

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

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

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

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

@@ -0,0 +1,50 @@
+import type { PipaApi } from '../../../interfaces';
+import { BacklogItem, BacklogToolSchema } from '../backlog.entity';
+import { BacklogState } from './state';
+import { BacklogValidator } from './validator';
+declare const BacklogCore_base: import("ts-mixer/dist/types/types").Class<any[], BacklogValidator & BacklogState, typeof BacklogValidator & typeof BacklogState>;
+/**
+ * Núcleo de CRUD do backlog.
+ * Síncrono. Persiste todos os itens como um único backlog.json.
+ * Leitura (list/get) delega para BacklogState, que carrega o disco sob demanda.
+ */
+export declare class BacklogCore extends BacklogCore_base {
+    readonly pipa: PipaApi;
+    constructor(pipa: PipaApi);
+    /** Busca item por código — delega ao BacklogState (escaneia disco) */
+    get(code: string): BacklogItem | undefined;
+    /** Lista itens com filtro e ordenação — delega ao BacklogState (escaneia disco) */
+    list(sort: BacklogToolSchema<'list'>): BacklogItem[];
+    /** Atualiza campo do frontmatter e persiste o backlog.json */
+    updateFrontmatter({ code, field, value }: BacklogToolSchema<'update-frontmatter'>): BacklogItem;
+    /**
+     * Deriva o status esperado de um nó a partir do status dos filhos.
+     * Regra (aprovada): sem filhos → não muda; todos os filhos com o MESMO status → esse status;
+     * mix não uniforme → in_progress.
+     */
+    private deriveStatus;
+    /**
+     * Deriva o status de um nó a partir do status dos filhos e persiste no store se mudou.
+     * Regra (aprovada): sem filhos → não muda; todos os filhos com o MESMO status → esse status;
+     * mix não uniforme → in_progress.
+     */
+    private deriveNodeStatus;
+    /**
+     * Recalcula o status dos ancestrais em cascata até a raiz, a partir de um item.
+     * Guarda contra parentCode cíclico: interrompe ao reencontrar um código já visitado.
+     * Persiste uma única vez no fim da cascata.
+     */
+    protected recalculateAncestors(code: string): void;
+    /** Normaliza quebras de linha — aceita \\n literal ou newline real */
+    private normalizeBody;
+    /** Manipula corpo markdown e persiste o backlog.json */
+    updateBody({ code, mode, value, replacement }: BacklogToolSchema<'update-body'>): BacklogItem;
+    /** Faz merge de dados livres (metadata) no item e persiste o backlog.json */
+    updateMetadata({ code, metadata }: BacklogToolSchema<'update-metadata'>): BacklogItem;
+    /** Busca fuzzy por título/código/tags via fuse.js */
+    select({ query }: BacklogToolSchema<'select'>): BacklogItem[];
+    /** Remove item do backlog e recalcula o antigo pai em cascata */
+    remove({ code }: BacklogToolSchema<'remove'>): BacklogItem;
+}
+export {};
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/backlog/hub/core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAiB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;;AAC/C;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,gBAAqC;IACxD,QAAQ,CAAC,IAAI,EAAE,OAAO;IAAlC,YAAqB,IAAI,EAAE,OAAO,EAEjC;IAED,sEAAsE;IACtE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEzC;IAED,mFAAmF;IACnF,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,WAAW,EAAE,CAEnD;IAED,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,iBAAiB,CAAC,oBAAoB,CAAC,GAAG,WAAW,CAmB9F;IAED;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAepB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;;OAIG;IACH,SAAS,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBjD;IAED,sEAAsE;IACtE,OAAO,CAAC,aAAa;IAIrB,wDAAwD;IACxD,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAgB,EAAE,EAAE,iBAAiB,CAAC,aAAa,CAAC,GAAG,WAAW,CAUjG;IAED,6EAA6E;IAC7E,cAAc,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,GAAG,WAAW,CAUpF;IAED,qDAAqD;IACrD,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,WAAW,EAAE,CAS5D;IAED,iEAAiE;IACjE,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAAG,WAAW,CAkBzD;CACF"}

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

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

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

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

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

@@ -0,0 +1,48 @@
+import { PipaApi, ToolParams } from '../../../interfaces';
+import { FileManager } from '../../../lib';
+import { BACKLOG_TOOL_SCHEMA } from '../backlog.definitions';
+import { BacklogItem, BacklogToolSchema } from '../backlog.entity';
+/** Critérios de filtro/ordenação para listagem do backlog */
+export type BacklogListCriteria = Partial<Pick<BacklogItem, 'status' | 'type'>> & {
+    sort: ToolParams<typeof BACKLOG_TOOL_SCHEMA>['sort'];
+    limit?: number;
+};
+/**
+ * Utilitário de leitura: carrega backlog.json do disco sob demanda.
+ * Sem cache em memória. BacklogCore é responsável pela escrita (persistOne).
+ */
+export declare class BacklogState {
+    readonly pipa: PipaApi;
+    constructor(pipa: PipaApi);
+    static get fileManager(): FileManager<BacklogItem[]>;
+    private static get store();
+    /**
+     * Carrega backlog.json do disco para a store em memória, substituindo o cache atual.
+     */
+    static load(): void;
+    /**
+     * Salva silenciosamente o estado atual para o disco em JSON.
+     */
+    private static persist;
+    /**
+     * Lista itens com filtro e ordenação — escaneia o disco.
+     */
+    static listBy(criteria?: BacklogToolSchema<'list'>): BacklogItem[];
+    /** Lista todos os itens (sem filtro) */
+    static all(): BacklogItem[];
+    /**
+     * Busca um item por código — escaneia o disco.
+     */
+    static get(code: string): BacklogItem | undefined;
+    /** Limpa o cache do backlog */
+    static clear(): void;
+    /** Adiciona um item ao cache do backlog */
+    static add(item: BacklogItem): void;
+    /**
+     * Atualiza os dados de um item existente na store e retorna o item atualizado.
+     */
+    static update(id: string, data: Partial<BacklogItem>): BacklogItem;
+    /** Remove um item do cache do backlog */
+    static delete(code: string): boolean;
+}
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/backlog/hub/state.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAgB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEjF,6DAA6D;AAC7D,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,GAAG;IAChF,IAAI,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,qBAAa,YAAY;IACX,QAAQ,CAAC,IAAI,EAAE,OAAO;IAAlC,YAAqB,IAAI,EAAE,OAAO,EAAI;IAEtC,WAAkB,WAAW,+BAE5B;IAED,OAAO,CAAC,MAAM,KAAK,KAAK,GAQvB;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,IAAI,IAAI,CAKlB;IAED;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,OAAO;IAItB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,WAAW,EAAE,CA0BjE;IAED,wCAAwC;IACxC,MAAM,CAAC,GAAG,IAAI,WAAW,EAAE,CAE1B;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEhD;IAED,+BAA+B;IAC/B,MAAM,CAAC,KAAK,SAEX;IAED,2CAA2C;IAC3C,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,QAG3B;IAED;;OAEG;IACH,OAAc,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAexE;IAED,yCAAyC;IACzC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKnC;CACF"}

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

@@ -0,0 +1,14 @@
+import { BACKLOG_TOOL_NUDGES } from '../../../constants/backlog';
+import type { BacklogItem } from '../backlog.entity';
+/** Valida regras de negócio antes de operações no backlog */
+export declare class BacklogValidator {
+    /** Verifica se o item existe e retorna. Throw PipaException se não encontrado. */
+    protected canUpdate(code: string, action?: Exclude<keyof typeof BACKLOG_TOOL_NUDGES, 'remove'>): BacklogItem;
+    /** Verifica se o item existe para remoção. Throw PipaException se não encontrado. */
+    protected canRemove(code: string): BacklogItem;
+    /** Verifica se o item existe para operação select. */
+    protected canSelect(code: string): BacklogItem;
+    /** Valida dados para criação. Throw PipaException se inválido. */
+    protected canCreate({ type, title }: Pick<BacklogItem, 'type' | 'title'>): void;
+}
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/backlog/hub/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAErF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,6DAA6D;AAC7D,qBAAa,gBAAgB;IAC3B,kFAAkF;IAClF,SAAS,CAAC,SAAS,CACjB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,OAAO,CAAC,MAAM,OAAO,mBAAmB,EAAE,QAAQ,CAAwB,GACjF,WAAW,CAWb;IAED,qFAAqF;IACrF,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAQ7C;IAED,sDAAsD;IACtD,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAW7C;IAED,kEAAkE;IAClE,SAAS,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAW9E;CACF"}

package/extensions/pipa/features/base-feature.d.ts

@@ -0,0 +1,13 @@
+import type * as Pi from '@earendil-works/pi-coding-agent/extensions';
+import { PipaApi } from '../interfaces';
+export declare abstract class PipaBaseFeature {
+    readonly pi: Pi.ExtensionAPI;
+    constructor(pi: Pi.ExtensionAPI);
+    pipa: PipaApi;
+    /**
+     * Método de inicialização da feature, chamado uma vez durante o setup da extensão.
+     */
+    initialize?(pi: Pi.ExtensionAPI): Promise<void> | void;
+}
+export type PipaBaseFeatureConstructor = new (pi: Pi.ExtensionAPI) => PipaBaseFeature;
+//# sourceMappingURL=base-feature.d.ts.map

package/extensions/pipa/features/base-feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-feature.d.ts","sourceRoot":"","sources":["../../../../extensions/pipa/features/base-feature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,EAAE,MAAM,4CAA4C,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,8BAAsB,eAAe;IAChB,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,YAAY;IAA/C,YAA4B,EAAE,EAAE,EAAE,CAAC,YAAY,EAAI;IAE5C,IAAI,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACxD;AACD,MAAM,MAAM,0BAA0B,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,YAAY,KAAK,eAAe,CAAC"}

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

@@ -0,0 +1,73 @@
+import Type from 'typebox';
+export declare const DOCS_SORT_FIELDS: string[];
+export declare const DOCS_SORT_ORDERS: string[];
+export declare const DOCS_FRONTMATTER_FIELDS: string[];
+export declare const DOCS_TOOL_SCHEMA: {
+    /** Cria novo documento */
+    instantiate: Type.TObject<{
+        action: Type.TLiteral<"instantiate">;
+        title: Type.TString;
+        parentCode: Type.TOptional<Type.TString>;
+        tags: Type.TOptional<Type.TArray<Type.TString>>;
+        metadata: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+        body: Type.TString;
+        summary: Type.TString;
+    }>;
+    /** Lista documentos */
+    list: Type.TObject<{
+        action: Type.TLiteral<"list">;
+        tags: Type.TOptional<Type.TArray<Type.TString>>;
+        sort: Type.TOptional<Type.TObject<{
+            field: Type.TUnion<[Type.TLiteral<string>, ...Type.TLiteral<string>[]]>;
+            order: Type.TUnion<[Type.TLiteral<string>, ...Type.TLiteral<string>[]]>;
+        }>>;
+        limit: Type.TOptional<Type.TNumber>;
+    }>;
+    /** Atualiza frontmatter (título/tags) */
+    'update-frontmatter': Type.TObject<{
+        action: Type.TLiteral<"update-frontmatter">;
+        code: Type.TString;
+        field: Type.TUnion<[Type.TLiteral<string>, ...Type.TLiteral<string>[]]>;
+        value: Type.TUnion<[Type.TString, Type.TArray<Type.TString>]>;
+    }>;
+    /** Atualiza conteúdo */
+    'update-body': Type.TObject<{
+        action: Type.TLiteral<"update-body">;
+        code: Type.TString;
+        mode: Type.TUnion<[Type.TLiteral<"append">, Type.TLiteral<"replace">, Type.TLiteral<"set">]>;
+        value: Type.TString;
+        replacement: Type.TOptional<Type.TString>;
+        summary: Type.TOptional<Type.TString>;
+    }>;
+    /** Faz merge de dados livres (metadata) em um documento */
+    'update-metadata': Type.TObject<{
+        action: Type.TLiteral<"update-metadata">;
+        code: Type.TString;
+        metadata: Type.TRecord<"^.*$", Type.TUnknown>;
+    }>;
+    /** Busca documentos via fuzzy search */
+    select: Type.TObject<{
+        action: Type.TLiteral<"select">;
+        query: Type.TString;
+    }>;
+    /** Remove documento */
+    remove: Type.TObject<{
+        action: Type.TLiteral<"remove">;
+        code: Type.TString;
+    }>;
+    /** Publica site estático via retypeapp */
+    publish: Type.TObject<{
+        action: Type.TLiteral<"publish">;
+    }>;
+};
+export declare const DOCS_TOOL_ACTIONS_MESSAGE: {
+    instantiate: string;
+    list: string;
+    'update-frontmatter': string;
+    'update-body': string;
+    'update-metadata': string;
+    select: string;
+    remove: string;
+    publish: string;
+};
+//# sourceMappingURL=docs.definitions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.definitions.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/docs/docs.definitions.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAK3B,eAAO,MAAM,gBAAgB,UAAsC,CAAC;AACpE,eAAO,MAAM,gBAAgB,UAAkB,CAAC;AAChD,eAAO,MAAM,uBAAuB,UAAkC,CAAC;AAEvE,eAAO,MAAM,gBAAgB;IAC3B,0BAA0B;IAC1B,WAAW;;;;;;;;;IA6CX,uBAAuB;IACvB,IAAI;;;;;;;;;IAwBJ,yCAAyC;IACzC,oBAAoB;;;;;;IAapB,wBAAwB;IACxB,aAAa;;;;;;;;IAmDb,2DAA2D;IAC3D,iBAAiB;;;;;IAajB,wCAAwC;IACxC,MAAM;;;;IAKN,uBAAuB;IACvB,MAAM;;;;IAKN,0CAA0C;IAC1C,OAAO;;;CAQR,CAAC;AAEF,eAAO,MAAM,yBAAyB;IACpC,WAAW;IACX,IAAI;IACJ,oBAAoB;IACpB,aAAa;IACb,iBAAiB;IACjB,MAAM;IACN,MAAM;IACN,OAAO;CACR,CAAC"}

package/extensions/pipa/features/docs/docs.entity.d.ts

@@ -0,0 +1,27 @@
+import { BaseClass, ToolActionPayload, ToolParams } from '../../interfaces/common';
+import { DOCS_TOOL_SCHEMA } from './docs.definitions';
+export type DocsToolParams = ToolParams<typeof DOCS_TOOL_SCHEMA>;
+export type DocsToolSchema<K extends keyof typeof DOCS_TOOL_SCHEMA> = ToolActionPayload<typeof DOCS_TOOL_SCHEMA, K>;
+export declare class DocItem {
+    constructor(data: BaseClass<DocItem>);
+    /** Código curto (nanoid) */
+    code: string;
+    /** Título do documento */
+    title: string;
+    /** Conteúdo markdown */
+    body: string;
+    /** Resumo curto do documento (fornecido pelo agente, máximo DOC_SUMMARY_LENGTH caracteres) */
+    summary: string;
+    /** ISO date de criação */
+    createdAt: string;
+    /** ISO date da última modificação */
+    updatedAt: string;
+    /** Código do documento pai (cria hierarquia no publish) */
+    parentCode?: string;
+    /** Etiquetas livres para categorização */
+    tags?: string[];
+    /** Metadados arbitrários */
+    metadata?: Record<string, unknown>;
+}
+export type DocsStore = Map<string, DocItem>;
+//# sourceMappingURL=docs.entity.d.ts.map

package/extensions/pipa/features/docs/docs.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.entity.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/docs/docs.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEjE,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,OAAO,gBAAgB,IAAI,iBAAiB,CAAC,OAAO,gBAAgB,EAAE,CAAC,CAAC,CAAC;AAEpH,qBAAa,OAAO;IAClB,YAAY,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,EAEnC;IAED,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IAEd,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IAEb,8FAA8F;IAC9F,OAAO,EAAE,MAAM,CAAC;IAEhB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAElB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import { PipaBaseFeature } from '../base-feature';
+declare const DocsFeature_base: import("ts-mixer/dist/types/types").Class<any[], PipaBaseFeature, typeof PipaBaseFeature>;
+/**
+ * Feature principal de gerenciamento de documentos.
+ * Registra a tool 'docs' e persiste os dados em docs/entries.json.
+ */
+export declare class DocsFeature extends DocsFeature_base {
+    loadDocs(): void;
+    initialize(pi: ExtensionAPI): void;
+}
+export {};
+//# sourceMappingURL=docs.feature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.feature.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/docs/docs.feature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAOpE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;;AAMlD;;;GAGG;AACH,qBAAa,WAAY,SAAQ,gBAAsB;IAE9C,QAAQ,IAAI,IAAI,CAEtB;IAED,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAsDjC;CACF"}

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

@@ -0,0 +1,22 @@
+import { PipaApi } from '../../interfaces';
+import { DocItem, DocsToolSchema } from './docs.entity';
+import { DocsCore, DocsValidator } from './hub';
+declare const DocsHub_base: import("ts-mixer/dist/types/types").Class<any[], DocsValidator & DocsCore, typeof DocsValidator & typeof DocsCore>;
+/**
+ * Gerencia a base de documentos do projeto.
+ */
+export declare class DocsHub extends DocsHub_base {
+    readonly pipa: PipaApi;
+    constructor(pipa: PipaApi);
+    instantiate(data: DocsToolSchema<'instantiate'>): {
+        action: "instantiate";
+        title: string;
+        parentCode?: string | undefined;
+        tags?: string[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        body: string;
+        summary: string;
+    } & DocItem;
+}
+export {};
+//# sourceMappingURL=docs.hub.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.hub.d.ts","sourceRoot":"","sources":["../../../../../extensions/pipa/features/docs/docs.hub.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;;AAEhD;;GAEG;AACH,qBAAa,OAAQ,SAAQ,YAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,OAAO;IAAlC,YAAqB,IAAI,EAAE,OAAO,EAEjC;IAED,WAAW,CAAC,IAAI,EAAE,cAAc,CAAC,aAAa,CAAC;;;;;;;;gBAgB9C;CACF"}

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

@@ -0,0 +1,38 @@
+import type { PipaApi } from '../../../interfaces';
+import { DocListItem } from '../../../lib/doc';
+import { DocItem, DocsToolSchema } from '../docs.entity';
+import { DocsState } from './state';
+import { DocsValidator } from './validator';
+declare const DocsCore_base: import("ts-mixer/dist/types/types").Class<any[], DocsValidator & DocsState, typeof DocsValidator & typeof DocsState>;
+/**
+ * Núcleo de CRUD dos documentos.
+ * Síncrono. Persiste todos os itens como um único entries.json.
+ * Leitura (list/get) delega para DocsState.
+ */
+export declare class DocsCore extends DocsCore_base {
+    readonly pipa: PipaApi;
+    constructor(pipa: PipaApi);
+    /** Persiste um único item no disco via DocsState (FileManager.save) */
+    persistOne(item: DocItem): void;
+    /** Busca item por código */
+    get(code: string): DocItem | undefined;
+    /** Lista itens com filtro e ordenação */
+    list(sort: DocsToolSchema<'list'>): DocListItem[];
+    /** Atualiza campo do frontmatter e persiste o entries.json */
+    updateFrontmatter({ code, field, value }: DocsToolSchema<'update-frontmatter'>): DocItem;
+    /** Manipula corpo markdown e persiste o entries.json */
+    updateBody({ code, mode, value, replacement, summary }: DocsToolSchema<'update-body'>): DocItem;
+    /** Faz merge de dados livres (metadata) no item e persiste o entries.json */
+    updateMetadata({ code, metadata }: DocsToolSchema<'update-metadata'>): DocItem;
+    /** Busca fuzzy por título/código/tags via fuse.js */
+    select({ query }: DocsToolSchema<'select'>): DocItem[];
+    /** Remove item e salva json */
+    remove({ code }: DocsToolSchema<'remove'>): DocItem;
+    /** Publica site estático extraindo .md e rodando retypeapp */
+    publish(): Promise<{
+        path: string;
+        url: string;
+    }>;
+}
+export {};
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/docs/hub/core.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAsC,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;;AAI5C;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,aAA+B;IAC/C,QAAQ,CAAC,IAAI,EAAE,OAAO;IAAlC,YAAqB,IAAI,EAAE,OAAO,EAEjC;IAED,uEAAuE;IACvE,UAAU,CAAC,IAAI,EAAE,OAAO,QAGvB;IAED,4BAA4B;IAC5B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAErC;IAED,yCAAyC;IACzC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,WAAW,EAAE,CAEhD;IAED,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,cAAc,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAavF;IAED,wDAAwD;IACxD,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAgB,EAAE,OAAO,EAAE,EAAE,cAAc,CAAC,aAAa,CAAC,GAAG,OAAO,CAmBnG;IAED,6EAA6E;IAC7E,cAAc,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,cAAc,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAU7E;IAED,qDAAqD;IACrD,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,OAAO,EAAE,CASrD;IAED,+BAA+B;IAC/B,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,OAAO,CAQlD;IAED,8DAA8D;IACxD,OAAO,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAiEtD;CACF"}

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

@@ -0,0 +1,4 @@
+export { DocsCore } from './core';
+export { DocsState } from './state';
+export { DocsValidator } from './validator';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/docs/hub/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,34 @@
+import { PipaApi } from '../../../interfaces';
+import { FileManager } from '../../../lib';
+import { DocItem, DocsToolSchema } from '../docs.entity';
+/**
+ * Utilitário de leitura: carrega entries.json do disco sob demanda.
+ * Sem cache em memória. DocsCore é responsável pela escrita (persistOne).
+ */
+export declare class DocsState {
+    readonly pipa: PipaApi;
+    constructor(pipa: PipaApi);
+    /**
+     * Carrega entries.json do disco para a store em memória, substituindo o cache atual.
+     */
+    static load(): void;
+    private static get store();
+    readonly fileManager: FileManager<DocItem[]>;
+    /**
+     * Lista itens com filtro (por tags) e ordenação — usa o store carregado.
+     */
+    static listBy(criteria?: DocsToolSchema<'list'>): DocItem[];
+    /** Lista todos os itens (sem filtro) */
+    static all(): DocItem[];
+    /** Persiste todos os itens no disco (entries.json) via FileManager */
+    saveAll(): void;
+    /** Busca um item por código */
+    static get(code: string): DocItem | undefined;
+    /** Limpa o cache */
+    static clear(): void;
+    /** Adiciona um item ao cache */
+    static add(item: DocItem): void;
+    /** Remove um item do cache */
+    static delete(code: string): boolean;
+}
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../../extensions/pipa/features/docs/hub/state.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAc,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAa,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE;;;GAGG;AACH,qBAAa,SAAS;IACR,QAAQ,CAAC,IAAI,EAAE,OAAO;IAAlC,YAAqB,IAAI,EAAE,OAAO,EAEjC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,IAAI,IAAI,CAKlB;IAED,OAAO,CAAC,MAAM,KAAK,KAAK,GAQvB;IAED,SAAgB,WAAW,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAEpD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,OAAO,EAAE,CAoB1D;IAED,wCAAwC;IACxC,MAAM,CAAC,GAAG,IAAI,OAAO,EAAE,CAEtB;IAED,sEAAsE;IACtE,OAAO,SAEN;IAED,+BAA+B;IAC/B,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5C;IAED,oBAAoB;IACpB,MAAM,CAAC,KAAK,SAEX;IAED,gCAAgC;IAChC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,QAEvB;IAED,8BAA8B;IAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnC;CACF"}