@neetru/cli 2.29.0 → 2.31.0

package/dist/lib/compose-generator.d.ts

@@ -20,17 +20,21 @@ export declare function resolveDbConfig(engine: string): ComposeDbConfig | null;
 export interface ComposeGeneratorInput {
     productSlug: string;
     dbEngine: string;
-    appPort?: number;
-    coreUrl?: string;
-    firebaseProject?: string;
-    firebaseApiKey?: string;
 }
 /**
- * Gera o conteúdo do docker-compose.dev.yml baseado na config do produto.
- * Template em templates/dev/docker-compose.dev.yml com substituições {{VAR}}.
+ * URL de conexão do host (onde o app roda com `npm run dev`) para o banco do
+ * compose. `null` quando a engine não usa URL (Firestore usa o emulador).
  */
-export declare function generateComposeDev(input: ComposeGeneratorInput): string;
+export declare function localDatabaseUrl(dbEngine: string): string | null;
 /**
- * Escreve o compose + Dockerfile.agent no diretório do projeto.
+ * Gera o conteúdo do `neetru-compose.dev.yml` baseado na config do produto.
+ *
+ * Só o BANCO sobe em container. O agente ficou de fora de propósito
+ * (2026-10-09): o serviço `agent` antigo dependia de um `Dockerfile.agent` que
+ * nenhum caminho do `dev up` gravava (o compose falhava no build e nem o banco
+ * subia), rodava o binário do agente com `node` (é executável `pkg`, não JS) e
+ * ligava um `NEETRU_DEV_MODE` que o agente não implementa — além de montar o
+ * `docker.sock` do host num binário baixado. O agente local volta quando a
+ * sprint dev-suite entregar o modo dev no próprio agente.
  */
-export declare function writeComposeDev(cwd: string, input: ComposeGeneratorInput): string;
+export declare function generateComposeDev(input: ComposeGeneratorInput): string;

package/dist/lib/compose-generator.js

@@ -1,5 +1,3 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
 /**
  * Mapeia engine de banco → config Docker Compose.
  * Usa imagens oficiais — mesmas engines que rodam em produção na VM.
@@ -57,12 +55,35 @@ export function resolveDbConfig(engine) {
     return configs['vm-postgres-single'] ?? null; // default
 }
 /**
- * Gera o conteúdo do docker-compose.dev.yml baseado na config do produto.
- * Template em templates/dev/docker-compose.dev.yml com substituições {{VAR}}.
+ * URL de conexão do host (onde o app roda com `npm run dev`) para o banco do
+ * compose. `null` quando a engine não usa URL (Firestore usa o emulador).
+ */
+export function localDatabaseUrl(dbEngine) {
+    const db = resolveDbConfig(dbEngine) ?? resolveDbConfig('vm-postgres-single');
+    switch (db.internalPort) {
+        case 5432:
+            return `postgresql://postgres:neetru_dev@localhost:${db.port}/app`;
+        case 3306:
+            return `mysql://root:neetru_dev@localhost:${db.port}/app`;
+        case 27017:
+            return `mongodb://localhost:${db.port}/app`;
+        default:
+            return null;
+    }
+}
+/**
+ * Gera o conteúdo do `neetru-compose.dev.yml` baseado na config do produto.
+ *
+ * Só o BANCO sobe em container. O agente ficou de fora de propósito
+ * (2026-10-09): o serviço `agent` antigo dependia de um `Dockerfile.agent` que
+ * nenhum caminho do `dev up` gravava (o compose falhava no build e nem o banco
+ * subia), rodava o binário do agente com `node` (é executável `pkg`, não JS) e
+ * ligava um `NEETRU_DEV_MODE` que o agente não implementa — além de montar o
+ * `docker.sock` do host num binário baixado. O agente local volta quando a
+ * sprint dev-suite entregar o modo dev no próprio agente.
  */
 export function generateComposeDev(input) {
     const db = resolveDbConfig(input.dbEngine) ?? resolveDbConfig('vm-postgres-single');
-    const appPort = input.appPort ?? 3000;
     // Bloco `environment:` só entra quando há vars — senão vira `environment:`
     // vazio, que o docker compose rejeita ("environment must be a mapping").
     // Firestore (env: {}) caía nisso → `dev up` firestore gerava compose inválido.
@@ -76,8 +97,9 @@ export function generateComposeDev(input) {
         `      timeout: ${db.healthcheck.timeout}`,
         `      retries: ${db.healthcheck.retries}`,
     ].join('\n');
-    return `# Neetru Dev Local — emulador de VM (${db.engine})
+    return `# Neetru Dev Local — banco do produto ${input.productSlug} (${db.engine})
 # Gerado por \`neetru dev up\`. Modifique o neetru.config.json e rode novamente.
+# O app roda fora do container, com \`npm run dev\`.
 
 services:
   database:
@@ -90,63 +112,9 @@ ${dbEnvBlock}    ports:
     healthcheck:
 ${dbHealthcheck}
     restart: unless-stopped
-    networks:
-      - neetru-dev-net
-
-  agent:
-    build:
-      context: .
-      dockerfile: Dockerfile.agent
-    container_name: neetru-dev-agent
-    environment:
-      - NEETRU_SERVER_ID=dev-local-${input.productSlug}
-      - NEETRU_CORE_URL=${input.coreUrl ?? 'https://core.neetru.com'}
-      - NEETRU_FIREBASE_PROJECT=${input.firebaseProject ?? 'neetru'}
-      - NEETRU_FIREBASE_API_KEY=${input.firebaseApiKey ?? ''}
-      - NEETRU_DEV_MODE=true
-      - NEETRU_APP_PORT=${appPort}
-      - DATABASE_URL=${db.internalPort === 5432 ? 'postgresql://postgres:neetru_dev@database:5432/app' : db.internalPort === 3306 ? 'mysql://root:neetru_dev@database:3306/app' : db.internalPort === 27017 ? 'mongodb://database:27017/app' : ''}
-    ports:
-      - "${appPort}:${appPort}"
-    volumes:
-      - /var/run/docker.sock:/var/run/docker.sock
-      - neetru-agent-data:/var/cache/neetru
-      - .:/app/product:cached
-    depends_on:
-      database:
-        condition: service_healthy
-    restart: unless-stopped
-    networks:
-      - neetru-dev-net
 
 volumes:
   neetru-db-data:
-  neetru-agent-data:
-
-networks:
-  neetru-dev-net:
-    driver: bridge
 `;
 }
-/**
- * Escreve o compose + Dockerfile.agent no diretório do projeto.
- */
-export function writeComposeDev(cwd, input) {
-    const composePath = path.join(cwd, 'neetru-compose.dev.yml');
-    const dockerfilePath = path.join(cwd, 'Dockerfile.agent');
-    const entrypointPath = path.join(cwd, 'agent-entrypoint.sh');
-    const compose = generateComposeDev(input);
-    fs.writeFileSync(composePath, compose, 'utf8');
-    // Copia o Dockerfile.agent do template embutido
-    const templateDir = path.join(path.dirname(new URL(import.meta.url).pathname), '..', '..', 'templates', 'dev');
-    // Em modo pkg/compilado, busca do __dirname ou do diretório do CLI
-    const altTemplate = path.join(process.cwd(), 'node_modules', '@neetru', 'cli', 'templates', 'dev');
-    const dockerfileSrc = fs.existsSync(path.join(templateDir, 'Dockerfile.agent'))
-        ? path.join(templateDir, 'Dockerfile.agent')
-        : path.join(altTemplate, 'Dockerfile.agent');
-    if (fs.existsSync(dockerfileSrc)) {
-        fs.copyFileSync(dockerfileSrc, dockerfilePath);
-    }
-    return composePath;
-}
 //# sourceMappingURL=compose-generator.js.map

package/dist/lib/compose-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose-generator.js","sourceRoot":"","sources":["../../src/lib/compose-generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compose-generator.js","sourceRoot":"","sources":["../../src/lib/compose-generator.ts"],"names":[],"mappings":"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"}

package/dist/lib/config-schema.d.ts

@@ -89,15 +89,38 @@ export declare const neetruConfigSchema: z.ZodObject<{
         engine?: "firestore-instance" | "vm-postgres-single" | "vm-mysql-single" | "nosql-vm" | undefined;
         dbId?: string | undefined;
     }>>;
+    /** Protocolo de docs de produto v1 (`neetru docs init` grava; ver lib/product-docs/config.ts). */
+    docs: z.ZodOptional<z.ZodObject<{
+        protocolVersion: z.ZodOptional<z.ZodNumber>;
+        root: z.ZodOptional<z.ZodString>;
+        publish: z.ZodOptional<z.ZodBoolean>;
+        publishOnDeploy: z.ZodOptional<z.ZodBoolean>;
+        api: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        protocolVersion: z.ZodOptional<z.ZodNumber>;
+        root: z.ZodOptional<z.ZodString>;
+        publish: z.ZodOptional<z.ZodBoolean>;
+        publishOnDeploy: z.ZodOptional<z.ZodBoolean>;
+        api: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        protocolVersion: z.ZodOptional<z.ZodNumber>;
+        root: z.ZodOptional<z.ZodString>;
+        publish: z.ZodOptional<z.ZodBoolean>;
+        publishOnDeploy: z.ZodOptional<z.ZodBoolean>;
+        api: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     slug: string;
     runtime: "nextjs" | "node-api";
     $schema?: string | undefined;
     tenantId?: string | undefined;
-    deploy?: z.objectOutputType<{
-        region: z.ZodOptional<z.ZodString>;
-        serviceName: z.ZodOptional<z.ZodString>;
+    docs?: z.objectOutputType<{
+        protocolVersion: z.ZodOptional<z.ZodNumber>;
+        root: z.ZodOptional<z.ZodString>;
+        publish: z.ZodOptional<z.ZodBoolean>;
+        publishOnDeploy: z.ZodOptional<z.ZodBoolean>;
+        api: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
     publish?: {
         description: string;
@@ -108,6 +131,10 @@ export declare const neetruConfigSchema: z.ZodObject<{
         ctaHref?: string | undefined;
         ctaLabel?: string | undefined;
     } | undefined;
+    deploy?: z.objectOutputType<{
+        region: z.ZodOptional<z.ZodString>;
+        serviceName: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
     database?: {
         engine?: "firestore-instance" | "vm-postgres-single" | "vm-mysql-single" | "nosql-vm" | undefined;
         dbId?: string | undefined;
@@ -118,9 +145,12 @@ export declare const neetruConfigSchema: z.ZodObject<{
     runtime: "nextjs" | "node-api";
     $schema?: string | undefined;
     tenantId?: string | undefined;
-    deploy?: z.objectInputType<{
-        region: z.ZodOptional<z.ZodString>;
-        serviceName: z.ZodOptional<z.ZodString>;
+    docs?: z.objectInputType<{
+        protocolVersion: z.ZodOptional<z.ZodNumber>;
+        root: z.ZodOptional<z.ZodString>;
+        publish: z.ZodOptional<z.ZodBoolean>;
+        publishOnDeploy: z.ZodOptional<z.ZodBoolean>;
+        api: z.ZodOptional<z.ZodBoolean>;
     }, z.ZodTypeAny, "passthrough"> | undefined;
     publish?: {
         description: string;
@@ -131,6 +161,10 @@ export declare const neetruConfigSchema: z.ZodObject<{
         ctaHref?: string | undefined;
         ctaLabel?: string | undefined;
     } | undefined;
+    deploy?: z.objectInputType<{
+        region: z.ZodOptional<z.ZodString>;
+        serviceName: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
     database?: {
         engine?: "firestore-instance" | "vm-postgres-single" | "vm-mysql-single" | "nosql-vm" | undefined;
         dbId?: string | undefined;

package/dist/lib/config-schema.js

@@ -42,6 +42,17 @@ export const neetruConfigSchema = z.object({
         engine: z.enum(['vm-postgres-single', 'vm-mysql-single', 'nosql-vm', 'firestore-instance']).optional(),
         dbId: z.string().optional(),
     }).optional(),
+    /** Protocolo de docs de produto v1 (`neetru docs init` grava; ver lib/product-docs/config.ts). */
+    docs: z
+        .object({
+        protocolVersion: z.number().int().positive().optional(),
+        root: z.string().optional(),
+        publish: z.boolean().optional(),
+        publishOnDeploy: z.boolean().optional(),
+        api: z.boolean().optional(),
+    })
+        .passthrough()
+        .optional(),
 });
 export const catalogUpsertPayloadSchema = z.object({
     slug: slugSchema,

package/dist/lib/config-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/lib/config-schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/lib/config-schema.ts"],"names":[],"mappings":"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"}

package/dist/lib/product-docs/check.d.ts

@@ -0,0 +1,62 @@
+import { type DocsTaxonomy } from './taxonomy.js';
+import { type ProductRepo } from './config.js';
+export type Level = 'erro' | 'aviso' | 'sugestao';
+export interface Finding {
+    /** Caminho relativo à raiz do repositório, com `/`. */
+    file: string;
+    line?: number;
+    code: string;
+    level: Level;
+    message: string;
+}
+export interface FileContext {
+    taxonomy: DocsTaxonomy;
+    slug: string;
+    /** Caminho relativo à raiz do repo da pasta de docs (ex.: `docs`). */
+    docsRoot: string;
+    /** Existe este caminho (relativo à raiz do repo)? */
+    exists: (repoRel: string) => boolean;
+    legacyNames: Set<string>;
+    /** AAAA-MM-DD de hoje (injetável em teste). */
+    today: string;
+    /** O arquivo foi alterado na branch (LK001 vira erro). */
+    changed: boolean;
+}
+/** Valida UM doc. `relInDocs` é relativo à pasta de docs, com `/`. Função pura. */
+export declare function checkDocFile(relInDocs: string, raw: string, ctx: FileContext): Finding[];
+export interface CheckOptions {
+    /** Só os arquivos alterados contra a branch principal (catraca). */
+    changed?: boolean;
+    /** Aviso vira erro. */
+    strict?: boolean;
+    taxonomy: DocsTaxonomy;
+    today?: string;
+}
+export interface CheckResult {
+    ok: boolean;
+    findings: Finding[];
+    counts: {
+        erro: number;
+        aviso: number;
+        sugestao: number;
+    };
+    filesChecked: number;
+    docsRoot: string;
+    changedBase?: string;
+    /** --changed pedido mas o git não respondeu: checou tudo. */
+    changedFallback?: boolean;
+}
+/** Lista os `.md` da pasta de docs (relativos a ela, com `/`). */
+export declare function listDocFiles(repo: ProductRepo): Promise<string[]>;
+/** Lê `docs/_nomes-legados.json` (array ou `{ arquivos: [...] }`). */
+export declare function readLegacyNames(repo: ProductRepo): Set<string>;
+/** Hoje no fuso dos docs (America/Sao_Paulo ou NEETRU_TZ) — nunca UTC. */
+export { todayIso } from './dates.js';
+/** Checagens do repositório inteiro: mínimo do primeiro dia (PR002), README, CHANGELOG (PR004). */
+export declare function checkRepoLevel(repo: ProductRepo): Finding[];
+export declare function summarize(findings: Finding[], strict: boolean): {
+    ok: boolean;
+    counts: CheckResult['counts'];
+};
+/** Roda o validador no repositório do produto. Nunca lança por conteúdo de doc. */
+export declare function checkProductDocs(repo: ProductRepo, opts: CheckOptions): Promise<CheckResult>;