Importação

A importação puxa uma base de conhecimento já existente para dentro de um espaço em um único upload: exportações do claude.ai e do ChatGPT, um memory-server MCP, projetos e memória do Claude, além de arquivos Markdown e de texto simples. O formato é detectado pelo conteúdo, e não pelo nome do arquivo, então você não precisa preparar nada à mão — o próprio motor desmonta o pacote e o distribui em pastas.

A importação é o espelho da exportação: a exportação lê do disco os arquivos que são a fonte da verdade; a importação analisa a origem e grava as notas pelo caminho de escrita normal. Cada nota chega ao espaço exatamente como se um humano a tivesse criado no editor — com versionamento, proveniência e indexação.

Quais formatos ela entende

Um único pacote do Claude ou do ChatGPT costuma trazer vários tipos de dado ao mesmo tempo; a importação detecta e traz tudo o que sabe tratar:

O formato é definido pela análise do conteúdo (todo serviço entrega um arquivo chamado conversations.json, então o nome não é confiável). Mensagens vazias e conversas sem um único trecho com conteúdo não geram notas "órfãs" — quantas foram ignoradas aparece no resumo da importação. Se dentro do pacote vier um JSON que não é reconhecido, ele também vai parar no resumo, como unsupported — a perda de dados sempre aparece no resumo, em vez de acontecer sem ninguém ver.

Como importar

A importação fica na aba Import nas configurações do espaço (/s/<space>/management/import). Cada opção é uma seção própria:

• File — escolha o arquivo da exportação (conversations.json, o ZIP inteiro da exportação ou memory.json). Um arquivo .md/.txt avulso entra por arrastar e soltar (veja abaixo), não por esse diálogo.
• Skip existing notes — o que fazer numa importação repetida (veja abaixo).
• Memory entries — onde colocar as entidades de memória (veja abaixo).

Uma importação demorada roda como tarefa durável: barra de progresso com contador ao vivo de notas gravadas, a fase atual e um botão Cancel. Dá para sair da aba e voltar — a importação segue rodando em segundo plano e, na volta, você vê o progresso de novo ou o resumo final.

A opção "Skip existing notes"

O nome do arquivo de uma nota é determinístico e amarrado à identidade da origem. Por isso, reimportar a mesma exportação sobrescreve os mesmos arquivos em vez de multiplicar duplicatas — e cinquenta conversas "Untitled" não se atropelam.

• Desligada (o padrão para reenvios — upsert) — as notas existentes são sobrescritas por caminho, de forma idempotente.
• Ligada — notas cujo caminho já existe são ignoradas. É o caso "reimportei o histórico atualizado — não passe por cima do que eu já ajustei à mão".

A opção "Memory entries"

As entidades de memory.json podem ir para um de três lugares:

• folder — notas visíveis, voltadas ao usuário, sob a pasta raiz da importação.
• space — para o mount oculto de memória do agente do espaço (.notarium/memory): essas entradas não aparecem na árvore, no Feed nem na busca, mas o agente chega até elas via recall.
• skip — não importar a memória de jeito nenhum.

Como os dados são organizados

A importação cria uma árvore de pastas previsível dentro da raiz escolhida:

conversations/claude/      — conversas do Claude
conversations/chatgpt/     — conversas do ChatGPT
projects/<projeto>/        — projetos do Claude (+ docs/, prompt-template.md)
memory/claude/             — memória da conta Claude
memory/<tipo-de-entidade>/ — entidades de memory.json
design-chats/<projeto>/    — design chats do Claude

As datas são preservadas como dados

Uma importação ingênua dataria todo o histórico como "hoje", e o Feed empilharia centenas de conversas num monte só. Em vez disso, o Notarium leva a data de criação adiante como dado: cada nota recebe no frontmatter um created: com o momento em que a conversa realmente aconteceu. O Feed espalha o histórico importado pelos dias reais, e o ciclo exportação → importação preserva as datas — nada se perde na mudança.

O campo "Created" também pode ser editado à mão pelo editor (nos metadados da nota) — numa migração, por exemplo, ou para acertar a data de uma nota. Já o horário da última modificação (modified) sempre reflete quando o arquivo foi de fato editado, e esse não dá para mudar.

Como funciona por baixo dos panos

A importação foi feita para aguentar tanto pacotes de vários gigabytes quanto uma conexão que cai:

• Processamento em streaming. O upload é gravado no disco em streaming, o ZIP é descompactado um membro por vez e o array JSON de conversas é analisado elemento a elemento — uma conversa de cada vez. O pico de memória não depende do tamanho do pacote, então uma exportação de 600 MB não derruba o servidor.
• Tarefa durável. Quando o host tem um banco de metadados (a norma na auto-hospedagem), a importação roda por padrão como tarefa durável: o upload é salvo em staging e um worker em segundo plano grava as notas fora da requisição. Aba fechada, conexão perdida, até um reinício do servidor — nada disso custa progresso.
• Cooperatividade. Uma importação em massa não monopoliza o servidor: a gravação dá passagem às requisições interativas, e a indexação em segundo plano pausa enquanto o fluxo corre e recupera o atraso depois. Busca e navegação continuam responsivas mesmo com milhares de notas sendo gravadas.

flowchart LR
  src([Pacote / arquivo]) -->|upload| stage[Staging no disco]
  stage -->|tarefa de importação| worker[Worker em segundo plano]
  worker -->|caminho de escrita| notes[(Notas Markdown)]
  worker -.->|progresso| ui([Aba Import])

Limites

• Cancelar, mas não pausar. Dá para cancelar uma tarefa (de forma cooperativa), mas não pausar e retomar.
• O indicador é indeterminado. Não se sabe de antemão quantas notas há no pacote, então o progresso mostra a fase e um contador ao vivo de notas gravadas, e não porcentagem e ETA.
• Upload interrompido recomeça do zero. A durabilidade só entra em cena depois que os bytes chegaram: se o envio de um pacote grande for cortado, ele começa de novo.
• Anexos binários não são importados. O texto dos anexos vai embutido no corpo da nota; os arquivos binários em si, não (igual na exportação).
• A importação cai na raiz do espaço. O diálogo de importação não deixa escolher a pasta de destino — as notas vão para a raiz; no arrastar e soltar, a raiz é definida pela zona onde você soltou o arquivo.

A seguir

• Exportação — leve um espaço ou uma pasta de volta em um pacote de arquivos Markdown.
• Agentes e MCP — como um agente trabalha com a memória importada via recall.