---
id: AGD-0074
ticket: studio-dependency-management
title: "Studio: gerenciamento e reconstrução de dependências locais"
status: open
created: 2026-10-06
resolved:
decision:
tags: [studio, dependencies]
---

## Pain

Domain owner: `studio`

Worker: Agenda Worker. Impactos: `compiler/general` (resolução de dependências)
e `compiler/pbs` (fontes reservadas SDK/core).

Necessidade essencial do produto: preparar e reconstruir cópias físicas das dependências do projeto, com uma área de gerenciamento no Studio.

## Context

Desdobramento da AGD-0071 / DSC-0069; fora do escopo daquela agenda. SDK/core acompanham o Studio; dependências externas inicialmente já existem na máquina. Cópias em .workspace/ ignorada pelo Git; download e cache ficam para avaliação futura.

## Open Questions

- [ ] Qual área do Studio apresenta dependências, origens locais e estado das cópias?
- [ ] Quais metadados versionados permitem reconstrução, e quais paths pertencem à máquina?
- [ ] Como identificar conteúdo e detectar alterações? Lockfile e hashes são propostas a avaliar.
- [ ] Como preparar dependências transitivas e diagnosticar origens ausentes?
- [ ] Como atualizar cópias sem invalidar consultas e sessões em andamento?
- [ ] Como lidar com SDK/core indisponíveis na distribuição instalada?

## Options

### Option A — Preparação local integrada ao Studio (recomendada)

Oferecer uma área de gerenciamento apoiada por serviço utilizável fora da UI.
Copiar libs externas de diretórios locais para `.workspace/`; registrar os
destinos físicos para o resolver existente. SDK/core permanecem bundled no
Studio e não devem ser copiados para o projeto por necessidade editorial.
Benefício: escopo compacto e reconstrução explícita. Custo: definir identidade,
atualização e diagnóstico. Manutenção concentrada em um fluxo compartilhado.

### Option B — Preparação manual externa

Usuário copia arquivos e mantém o registry manualmente. Menor custo inicial,
mas favorece divergências e não atende à necessidade de gerenciamento no produto.
Pode servir como condição temporária para a AGD-0071, não como solução final.

## Tradeoffs

Origens apenas locais reduzem complexidade, mas outra máquina precisa receber
as bibliotecas antes da reconstrução. Cópias isolam o projeto de mudanças na
origem e duplicam armazenamento. `.workspace/` permanece ignorada pelo Git;
metadados de reconstrução não devem depender exclusivamente dela.

## Recommendation

Planejar A como capacidade essencial do produto, sem data ou implementação
autorizada nesta agenda. Começar por cópia local e atualização explícita.
Download, registry remoto, resolução automática de versões e cache compartilhado
ficam fora do recorte inicial; cache pode futuramente integrar essa mesma área.

## Discussion

Necessidade registrada explicitamente pelo usuário durante a AGD-0071. Não é
um requisito opcional a descartar por funcionar a navegação sem UI de gestão.
O desenho e a execução ainda precisam de discussão, decision e plan próprios.

Hoje `DependencyResolver` e `RegistryStore` resolvem diretórios existentes via
path ou `.workspace/repos/registry.json`; não fazem instalação. SDK/core vêm
de recursos do frontend. Preservar a distinção entre ambiente reservado e
dependências comuns. O usuário escolheu documentos externos em memória
read-only na AGD-0071, independentemente da origem bundled ou física.

Referência consolidada: [LSN-0078](../../lessons/DSC-0069-pbs-editorial-chains-sdk-navigation/LSN-0078-pbs-chains-and-revision-bound-external-sources.md),
DSC-0069 concluída. A implementação consome fontes já disponíveis na origem e não entrega o gestor.

## Resolution

Ainda em aberto.

## Next Step

Retomar esta discussão ao planejar a capacidade de gerenciamento do Studio;
fechar UX, metadados, reconstrução e lifecycle antes de emitir decision e plan.
