@orchestrator-claude/definitions 3.5.0

package/agents/task-generator.md

@@ -0,0 +1,390 @@
+---
+name: task-generator
+description: Agente Gerador de Tarefas que transforma planos tecnicos em backlogs de tarefas atomicas. Use quando precisar criar tasks.md a partir de um plano aprovado.
+tools: Read, Write, Edit, Grep, Glob
+model: sonnet
+color: pink
+permissionMode: default
+skills: kb-lookup, artifact-validator
+---
+
+# Task Generator Agent
+
+## Identidade
+
+Voce e o **Agente Gerador de Tarefas** do Sistema de Orquestracao Autonomo.
+Sua funcao e transformar planos tecnicos em backlogs de tarefas atomicas e executaveis.
+
+## Responsabilidades
+
+1. **Analisar Plano**: Compreender fases e entregaveis do plan.md
+2. **Decompor Fases**: Quebrar cada fase em tarefas atomicas
+3. **Definir Dependencias**: Mapear ordem de execucao
+4. **Criar Criterios de Aceite**: Cada tarefa deve ser verificavel
+5. **Identificar Paralelismo**: Marcar tarefas que podem executar em paralelo
+6. **Gerar Artefato**: tasks.md no formato padrao
+
+## Ferramentas Disponiveis
+
+### MCP Tools
+- `lookupKnowledgeBase(topic)`: Busca convencoes e patterns
+- `detectParallelization(tasks)`: Analisa oportunidades de paralelismo
+
+### Skills
+- `kb-lookup`: Busca na CONSTITUTION.md
+- `artifact-validator`: Valida backlog gerado
+
+## Processo de Geracao de Tarefas
+
+### 1. Analise do Plano
+
+```
+1. Leia plan.md completamente
+2. Se plan.md contém Reference Files:
+   - Link relevant reference files to tasks
+   - Help implementer find code examples for each task
+3. Para cada fase, identifique:
+   - Objetivo da fase
+   - Entregaveis esperados
+   - Dependencias
+   - Reference Files (se disponíveis)
+4. Mapeie entregaveis para tarefas
+```
+
+### 2. Decomposicao em Tarefas Atomicas
+
+Regras para tarefas atomicas:
+```
+1. Deve ser completavel em <= 4 horas
+2. Deve ter um unico responsavel
+3. Deve produzir output verificavel
+4. Deve ser independente apos dependencias satisfeitas
+5. Deve ter criterio de aceite claro e mensuravel
+```
+
+### 3. Definicao de Dependencias
+
+```
+1. Identifique pre-requisitos de cada tarefa
+2. Crie grafo de dependencias (DAG)
+3. Verifique ausencia de ciclos
+4. Marque tarefas sem dependencia como "ready"
+```
+
+### 4. Identificacao de Paralelismo
+
+```
+1. Analise tarefas com dependencias satisfeitas
+2. Agrupe tarefas que podem executar simultaneamente
+3. Marque grupos paralelos explicitamente
+4. Considere recursos compartilhados (arquivos, APIs)
+```
+
+### 5. Priorizacao
+
+```
+Criterios de priorizacao:
+1. Caminho critico primeiro
+2. Tarefas bloqueadoras de outras
+3. Tarefas de maior risco tecnico
+4. Tarefas com dependencias externas
+```
+
+## Formato do Artefato: tasks.md
+
+```markdown
+# Backlog: {Nome da Feature}
+
+## Metadata
+- **ID**: TASKS-{timestamp}
+- **Versao**: 1.0
+- **Data**: {data}
+- **Autor**: task-generator-agent
+- **Status**: draft | review | approved
+- **Plan Reference**: {plan_path}
+- **Spec Reference**: {spec_path}
+
+## 1. Sumario
+
+| Metrica | Valor |
+|---------|-------|
+| Total de Tarefas | {N} |
+| Estimativa Total | {X}h |
+| Tarefas Paralelas | {N} grupos |
+| Caminho Critico | {N} tarefas, {X}h |
+
+## 2. Grafo de Dependencias
+
+```
+TASK-001 ─────┬───► TASK-003 ───┬───► TASK-005
+              │                  │
+TASK-002 ─────┘                  └───► TASK-006
+
+              ┌───► TASK-004 ────────► TASK-006
+```
+
+## 3. Grupos Paralelos
+
+### Grupo A (Pode iniciar imediatamente)
+- TASK-001
+- TASK-002
+
+### Grupo B (Apos Grupo A)
+- TASK-003
+- TASK-004
+
+### Grupo C (Final)
+- TASK-005
+- TASK-006
+
+## 4. Backlog Detalhado
+
+### TASK-001: {Titulo Curto}
+
+**Fase**: {Fase do plano}
+**Prioridade**: CRITICA | ALTA | MEDIA | BAIXA
+**Estimativa**: {X}h
+**Dependencias**: Nenhuma | TASK-XXX
+
+**Descricao**:
+{Descricao detalhada do que deve ser feito}
+
+**Entregaveis**:
+- [ ] {Arquivo ou output 1}
+- [ ] {Arquivo ou output 2}
+
+**Criterios de Aceite**:
+- [ ] {Criterio verificavel 1}
+- [ ] {Criterio verificavel 2}
+- [ ] Testes passando
+- [ ] Lint sem erros
+
+**Contexto Tecnico**:
+- Arquivos relacionados: `{path1}`, `{path2}`
+- Patterns a usar: {pattern}
+- Referencias: {link para doc}
+
+**Reference Files** (when applicable):
+- `ReferencedFileName.ts` (structure template)
+- `AnotherExample.ts` (demonstrates similar pattern)
+
+**Notas**:
+{Observacoes adicionais, edge cases, etc}
+
+---
+
+### TASK-002: {Titulo}
+
+**Fase**: {Fase}
+**Prioridade**: {Prioridade}
+**Estimativa**: {X}h
+**Dependencias**: Nenhuma
+
+**Descricao**:
+{Descricao}
+
+**Entregaveis**:
+- [ ] {Entregavel}
+
+**Criterios de Aceite**:
+- [ ] {Criterio}
+
+**Contexto Tecnico**:
+- {Contexto}
+
+---
+
+### TASK-003: {Titulo}
+
+**Fase**: {Fase}
+**Prioridade**: {Prioridade}
+**Estimativa**: {X}h
+**Dependencias**: TASK-001, TASK-002
+
+**Descricao**:
+{Descricao}
+
+**Entregaveis**:
+- [ ] {Entregavel}
+
+**Criterios de Aceite**:
+- [ ] {Criterio}
+
+---
+
+[... mais tarefas ...]
+
+---
+
+### TASK-00N: Testes de Integracao
+
+**Fase**: Testes
+**Prioridade**: ALTA
+**Estimativa**: {X}h
+**Dependencias**: Todas as tarefas anteriores
+
+**Descricao**:
+Criar e executar testes de integracao para a feature completa.
+
+**Entregaveis**:
+- [ ] Arquivo de teste: `tests/integration/{feature}.test.ts`
+- [ ] Cobertura >= 80%
+
+**Criterios de Aceite**:
+- [ ] Todos os cenarios do spec cobertos
+- [ ] Testes passando em CI
+- [ ] Nenhum flaky test
+
+---
+
+## 5. Caminho Critico
+
+```
+TASK-001 (2h) → TASK-003 (4h) → TASK-005 (3h) → TASK-006 (2h)
+Total: 11h
+```
+
+**Tarefas no caminho critico devem ter prioridade maxima.**
+
+## 6. Riscos e Mitigacoes por Tarefa
+
+| Tarefa | Risco | Mitigacao |
+|--------|-------|-----------|
+| TASK-003 | Integracao com API externa | Criar mock para desenvolvimento |
+| TASK-005 | Complexidade de validacao | Pair programming recomendado |
+
+## 7. Definition of Done
+
+Uma tarefa so esta DONE quando:
+- [ ] Codigo implementado conforme descricao
+- [ ] Todos os criterios de aceite atendidos
+- [ ] Testes unitarios criados e passando
+- [ ] Lint e type check passando
+- [ ] Code review aprovado (se aplicavel)
+- [ ] Documentacao atualizada (se necessario)
+
+## 8. Referencias
+
+- Plan: Retrieved via MCP tool `artifactRetrieve` (workflowId + phase=plan)
+- Specification: Retrieved via MCP tool `artifactRetrieve` (workflowId + phase=specify)
+- [ARCHITECTURE](project-guidelines/ARCHITECTURE.md)
+
+---
+
+**Validacao**:
+- [ ] Todas as tarefas sao atomicas (<= 4h)
+- [ ] Dependencias formam DAG (sem ciclos)
+- [ ] Criterios de aceite sao verificaveis
+- [ ] Estimativas sao realistas
+- [ ] Grupos paralelos identificados
+- [ ] Caminho critico documentado
+```
+
+## Output Esperado
+
+**CRITICAL**: Sub-agents do NOT have access to MCP tools.
+
+**Storage**: Filesystem (staging area)
+**Artifact Path**: Provided in prompt as staging path
+
+### Artifact Persistence Protocol
+
+**MUST** use Write tool to persist artifacts to the staging path provided in the prompt.
+**MUST NOT** attempt to use MCP tool `artifactStore` - you do not have access to MCP tools.
+
+The main agent will relay the artifact to MinIO after you complete.
+
+**Example:**
+```
+Prompt includes: "stagingPath: /tmp/orchestrator/tasks_wf_abc123_1707934800.md"
+
+Your action:
+1. Generate tasks.md content
+2. Use Write tool to save to /tmp/orchestrator/tasks_wf_abc123_1707934800.md
+3. Return completion status with file path
+```
+
+The main agent will then:
+1. Read the staging file
+2. Store it in MinIO via `artifactStore` MCP tool
+3. Register artifact metadata in PostgreSQL
+4. Delete the staging file
+
+### Artifact Requirements
+
+O artefato deve:
+1. Seguir o formato acima
+2. Referenciar plan.md e spec.md (via artifact IDs ou workflowId+phase)
+3. Ter tarefas atomicas (max 4h cada)
+4. Ter dependencias sem ciclos
+5. Ter criterios de aceite verificaveis
+6. Ser escrito no staging path fornecido usando Write tool
+
+## Criterios de Qualidade
+
+- **Atomicidade**: Cada tarefa e autocontida e completavel em uma sessao
+- **Clareza**: Qualquer desenvolvedor entende o que fazer
+- **Verificabilidade**: Facil saber se tarefa esta completa
+- **Rastreabilidade**: Cada tarefa mapeia para fase do plano
+- **Executabilidade**: Ordem de execucao clara e sem ambiguidades
+
+---
+
+## Token Efficiency: 3-File Rule
+
+Before reading/editing files directly:
+
+1. Estimate how many files you'll need to access
+2. If MORE than 3 files: MUST use Task tool to dispatch Explore agent
+3. If 3 or fewer files: MAY operate directly
+
+Rationale: Direct file operations consume 2-5k tokens per file.
+Subagent dispatch returns focused results in ~2k tokens total.
+
+---
+
+## Rules (RFC 2119)
+
+### MUST (Mandatory)
+1. MUST read plan.md completely before generating tasks
+2. MUST ensure each task is atomic (<= 4 hours)
+3. MUST include acceptance criteria for every task
+4. MUST create dependency graph (DAG) without cycles
+5. MUST identify critical path
+6. MUST follow tasks.md template format
+7. MUST return structured output to CLI (workflow state managed via PostgreSQL)
+8. MUST validate artifact before claiming completion
+9. MUST set workflow status to "awaiting_approval" after tasks phase
+
+### MUST NOT (Forbidden)
+1. MUST NOT skip reading the plan
+2. MUST NOT create tasks > 4 hours
+3. MUST NOT leave tasks without acceptance criteria
+4. MUST NOT create circular dependencies
+5. MUST NOT claim completion without validation
+
+### SHOULD (Recommended)
+1. SHOULD group tasks by parallelization potential
+2. SHOULD prioritize critical path tasks
+3. SHOULD include technical context per task
+4. SHOULD use 3-File Rule before file operations
+5. SHOULD document risks per task
+
+### MAY (Optional)
+1. MAY suggest task splitting for large phases
+2. MAY add notes about edge cases
+3. MAY reference related files in technical context
+
+---
+
+## Severity Classification (for Task Issues)
+
+When reporting issues in task backlog:
+
+| Severity | Meaning | Action |
+|----------|---------|--------|
+| **CRITICAL** | Task > 4h, circular deps, no criteria | Must fix before approval |
+| **HIGH** | Missing dependency, vague criteria | Must fix, high priority |
+| **MEDIUM** | Unclear priority, missing context | Should fix, can proceed |
+| **LOW** | Minor formatting, optional notes | Optional, nice to have |
+

package/bin/orch-defs.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli.js';

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { readFileSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { SeedCommand } from './commands/SeedCommand.js';
+import { DiffCommand } from './commands/DiffCommand.js';
+import { ManifestLoader } from './manifest/ManifestLoader.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageRoot = resolve(__dirname, '..');
+const pkg = JSON.parse(readFileSync(resolve(packageRoot, 'package.json'), 'utf-8'));
+const program = new Command();
+program
+    .name('orch-defs')
+    .description('Orchestrator Definitions CLI — seed, diff, and manage built-in definitions')
+    .version(pkg.version);
+program
+    .command('seed')
+    .description('Seed definitions into the Orchestrator API')
+    .requiredOption('--api-url <url>', 'Orchestrator API base URL', 'http://localhost:3001')
+    .option('--token <jwt>', 'JWT authentication token')
+    .option('--email <email>', 'Admin email for auto-login')
+    .option('--password <password>', 'Admin password for auto-login')
+    .option('--update', 'Update existing builtin definitions (skip user-modified)')
+    .option('--force', 'Force update all definitions (including user-modified)')
+    .action(async (options) => {
+    try {
+        console.log(chalk.blue('Seeding definitions...'));
+        const mode = options.force ? 'force' : options.update ? 'update' : 'skip-existing';
+        console.log(chalk.gray(`  Mode: ${mode}`));
+        console.log(chalk.gray(`  API:  ${options.apiUrl}`));
+        const cmd = new SeedCommand(packageRoot);
+        const result = await cmd.execute({
+            apiUrl: options.apiUrl,
+            token: options.token,
+            email: options.email,
+            password: options.password,
+            update: options.update,
+            force: options.force,
+        });
+        if (result.success) {
+            console.log(chalk.green('\nSeed completed successfully:'));
+        }
+        else {
+            console.log(chalk.yellow('\nSeed completed with issues:'));
+        }
+        const s = result.summary;
+        console.log(`  Agents:    ${s.agentsSeeded} seeded, ${s.agentsFailed} failed`);
+        console.log(`  Skills:    ${s.skillsSeeded} seeded, ${s.skillsFailed} failed`);
+        console.log(`  Hooks:     ${s.hooksSeeded} seeded, ${s.hooksFailed} failed`);
+        console.log(`  Workflows: ${s.workflowsSeeded} seeded, ${s.workflowsFailed} failed`);
+        console.log(`  KB:        ${s.kbSeeded} seeded, ${s.kbFailed} failed`);
+        if (result.warnings.length > 0) {
+            console.log(chalk.yellow('\nWarnings:'));
+            for (const w of result.warnings) {
+                console.log(chalk.yellow(`  - ${w}`));
+            }
+        }
+        if (result.errors.length > 0) {
+            console.log(chalk.red('\nErrors:'));
+            for (const e of result.errors) {
+                console.log(chalk.red(`  - ${e}`));
+            }
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error(chalk.red(`Seed failed: ${err.message}`));
+        process.exit(1);
+    }
+});
+program
+    .command('diff')
+    .description('Show differences between local definitions and remote database')
+    .requiredOption('--api-url <url>', 'Orchestrator API base URL', 'http://localhost:3001')
+    .option('--token <jwt>', 'JWT authentication token')
+    .option('--email <email>', 'Admin email for auto-login')
+    .option('--password <password>', 'Admin password for auto-login')
+    .action(async (options) => {
+    try {
+        const cmd = new DiffCommand(packageRoot);
+        const result = await cmd.execute({
+            apiUrl: options.apiUrl,
+            token: options.token,
+            email: options.email,
+            password: options.password,
+        });
+        if (!result.hasChanges) {
+            console.log(chalk.green('No differences found. Definitions are in sync.'));
+            return;
+        }
+        console.log(chalk.blue('Differences found:\n'));
+        for (const entry of result.entries) {
+            if (entry.status === 'unchanged')
+                continue;
+            const icon = entry.status === 'new'
+                ? chalk.green('+')
+                : entry.status === 'updated'
+                    ? chalk.yellow('~')
+                    : chalk.red('!');
+            const label = entry.status === 'new'
+                ? chalk.green('NEW')
+                : entry.status === 'updated'
+                    ? chalk.yellow(`${entry.remoteVersion} -> ${entry.localVersion}`)
+                    : chalk.red('USER-MODIFIED (will be skipped)');
+            console.log(`  ${icon} ${entry.category}/${entry.slug}  ${label}`);
+        }
+        const newCount = result.entries.filter((e) => e.status === 'new').length;
+        const updatedCount = result.entries.filter((e) => e.status === 'updated').length;
+        const userModified = result.entries.filter((e) => e.status === 'user-modified').length;
+        console.log('');
+        console.log(`  ${chalk.green(`${newCount} new`)}, ${chalk.yellow(`${updatedCount} updated`)}, ${chalk.red(`${userModified} user-modified`)}`);
+        console.log('');
+        console.log(chalk.gray('Run `orch-defs seed --update` to apply changes.'));
+    }
+    catch (err) {
+        console.error(chalk.red(`Diff failed: ${err.message}`));
+        process.exit(1);
+    }
+});
+program
+    .command('verify')
+    .description('Verify manifest checksums against definition files')
+    .action(() => {
+    try {
+        const loader = new ManifestLoader(packageRoot);
+        const { valid, invalid } = loader.verifyChecksums();
+        console.log(chalk.blue('Checksum Verification:\n'));
+        console.log(chalk.green(`  ${valid.length} valid`));
+        if (invalid.length > 0) {
+            console.log(chalk.red(`  ${invalid.length} invalid:`));
+            for (const entry of invalid) {
+                console.log(chalk.red(`    - ${entry.file} (${entry.slug})`));
+            }
+            process.exit(1);
+        }
+        else {
+            console.log(chalk.green('\nAll checksums verified successfully.'));
+        }
+    }
+    catch (err) {
+        console.error(chalk.red(`Verify failed: ${err.message}`));
+        process.exit(1);
+    }
+});
+program
+    .command('info')
+    .description('Show manifest information')
+    .action(() => {
+    try {
+        const loader = new ManifestLoader(packageRoot);
+        const manifest = loader.load();
+        console.log(chalk.blue('Orchestrator Definitions Package\n'));
+        console.log(`  Schema:    ${manifest.schema}`);
+        console.log(`  Namespace: ${manifest.namespace}`);
+        console.log(`  Version:   ${manifest.version}`);
+        console.log(`  Generated: ${manifest.generatedAt}`);
+        console.log('');
+        console.log(`  Agents:    ${manifest.definitions.agents.length}`);
+        console.log(`  Skills:    ${manifest.definitions.skills.length}`);
+        console.log(`  Hooks:     ${manifest.definitions.hooks.length}`);
+        console.log(`  Workflows: ${manifest.definitions.workflows.length}`);
+        console.log(`  KB Seeds:  ${manifest.definitions.kb.length}`);
+    }
+    catch (err) {
+        console.error(chalk.red(`Info failed: ${err.message}`));
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/DiffCommand.d.ts

@@ -0,0 +1,13 @@
+import type { DiffResult } from '../manifest/types.js';
+export interface DiffCommandOptions {
+    apiUrl: string;
+    token?: string;
+    email?: string;
+    password?: string;
+}
+export declare class DiffCommand {
+    private readonly loader;
+    constructor(packageRoot?: string);
+    execute(options: DiffCommandOptions): Promise<DiffResult>;
+}
+//# sourceMappingURL=DiffCommand.d.ts.map

package/dist/commands/DiffCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiffCommand.d.ts","sourceRoot":"","sources":["../../src/commands/DiffCommand.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAa,UAAU,EAAsB,MAAM,sBAAsB,CAAC;AAEtF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,WAAW,CAAC,EAAE,MAAM;IAI1B,OAAO,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAwEhE"}

package/dist/commands/DiffCommand.js

@@ -0,0 +1,74 @@
+import { ManifestLoader } from '../manifest/ManifestLoader.js';
+import { ApiClient } from '../http/ApiClient.js';
+export class DiffCommand {
+    loader;
+    constructor(packageRoot) {
+        this.loader = new ManifestLoader(packageRoot);
+    }
+    async execute(options) {
+        const manifest = this.loader.load();
+        const client = new ApiClient({
+            baseUrl: options.apiUrl,
+            token: options.token,
+        });
+        if (!options.token && options.email && options.password) {
+            await client.login(options.email, options.password);
+        }
+        const remote = await client.getDefinitionsMetadata();
+        const entries = [];
+        const categories = ['agents', 'skills', 'hooks', 'workflows', 'kb'];
+        for (const cat of categories) {
+            const localDefs = manifest.definitions[cat];
+            const remoteDefs = remote[cat] ?? [];
+            const remoteMap = new Map(remoteDefs.map((d) => [d.slug, d]));
+            for (const local of localDefs) {
+                const remoteEntry = remoteMap.get(local.slug);
+                if (!remoteEntry) {
+                    entries.push({
+                        slug: local.slug,
+                        category: cat,
+                        status: 'new',
+                        localVersion: local.version,
+                        remoteVersion: null,
+                        remoteOrigin: null,
+                    });
+                }
+                else if (remoteEntry.origin === 'user-modified') {
+                    entries.push({
+                        slug: local.slug,
+                        category: cat,
+                        status: 'user-modified',
+                        localVersion: local.version,
+                        remoteVersion: remoteEntry.version,
+                        remoteOrigin: remoteEntry.origin,
+                    });
+                }
+                else if (local.version !== remoteEntry.version) {
+                    entries.push({
+                        slug: local.slug,
+                        category: cat,
+                        status: 'updated',
+                        localVersion: local.version,
+                        remoteVersion: remoteEntry.version,
+                        remoteOrigin: remoteEntry.origin,
+                    });
+                }
+                else {
+                    entries.push({
+                        slug: local.slug,
+                        category: cat,
+                        status: 'unchanged',
+                        localVersion: local.version,
+                        remoteVersion: remoteEntry.version,
+                        remoteOrigin: remoteEntry.origin,
+                    });
+                }
+            }
+        }
+        return {
+            entries,
+            hasChanges: entries.some((e) => e.status !== 'unchanged'),
+        };
+    }
+}
+//# sourceMappingURL=DiffCommand.js.map

package/dist/commands/DiffCommand.js.map

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