Skip to content

CHANGELOG.md

Latest commit

 

History

History
408 lines (260 loc) · 29.9 KB

CHANGELOG.md

File metadata and controls

408 lines (260 loc) · 29.9 KB

Changelog

0.4.2

Patch Changes

  • a37540f: Generalize internal downstream-instance references to vendor-neutral phrasing in the architecture docs and the frontmatter utility comment, drop a maintainer-local checkout path from the technical docs, and harden the doc boundary contract to catch relative sibling-checkout and internal-reference regressions.
  • 031da31: Fix Lab notebook accessibility in dark mode. Chart text and axes are no longer forced to a light-theme color that disappeared over Marimo's dark chart canvas — the Altair helper lets Marimo theme text/axes/grid for the active mode, and the exported notebooks also inject the vault palette into the chart shadow DOM so the text tracks the theme. Single-series bars use a color that clears WCAG non-text contrast on both backgrounds. The notebook shell keeps a single scroll with the topbar and the "feito com amor" footer pinned to the viewport instead of drifting with the content. Adds a contrast contract that guards chart mark colors.

0.4.1

Patch Changes

  • 7e80f78: v0.4.1: footer author configurável, fronteira template/usuário e documentação dos pacotes.

    Footer — author/holder configurável — o nome do titular no rodapé agora vira link quando há license.holderUrl em vault.config.json (Footer renderiza activeHolderUrl; uma nota pode sobrescrever via frontmatter authorUrl). O initialize.yml deriva o owner de GITHUB_REPOSITORY e define license.holder/license.holderUrl para o perfil do novo dono — antes o vault gerado herdava silenciosamente a identidade do mantenedor (só o kudos era limpo). Para o vault-seed, o holder aponta para github.com/aretw0.

    Inicialização — initialize.yml agora também remove publish-lab-runtime.yml (publish PyPI, exclusivo do trusted publisher do mantenedor) e scripts/lab_runtime_version_contract.test.mjs, que o glob de testes do vault gerado executaria. O smoke_template.js ganhou um contrato que calcula do disco que todo publish-*.yml e os contratos de versão de mantenedor estejam na lista de remoção — um futuro workflow de publish ou guard de versão não vaza silenciosamente para vaults de usuário.

    Documentação dos pacotes — READMEs adicionados aos pacotes publicáveis que não tinham (@aretw0/dgk-astro-plugins, @aretw0/dgk-channels, @aretw0/dgk-runner, @aretw0/dgk-skills); dgk-lab-runtime promovido a Development Status :: 4 - Beta; o ROADMAP do CLI foi realocado de um diretório órfão para packages/cli/.

0.4.0

Minor Changes

  • 18804e4: v0.4: CLI publishing pipeline, presentations, notebook contracts and reliability fixes.

    Inicialização

    initialize.yml — protege o branch main contra force-push e exclusões e habilita GitHub Pages automaticamente no primeiro push do usuário. Fecha #55 e #56.

    Lab e Notebooks

    Apresentações — quatro notebooks Marimo de apresentação substituem o antigo apresentacao-vault-seed.py. Cada um cobre um aspecto distinto: visão geral, o Lab, fluxo de publicação e integração com agentes de IA. Os slides ficam em 99 - Meta e Anexos/Notebooks/apresentacoes/ com layouts nativos do Marimo (layout_file). A página /lab/ agora separa notebooks analíticos de apresentações em seções distintas.

    Notas de referência — pasta 99.4 - Apresentações/ com cinco notas publicadas (MOC + uma por apresentação). Tags mapeiam cada nota ao intent correto da sidebar: meta/onboarding → "Começar", meta/lab → "Explorar", meta/site → "Publicar", meta/agentes → "Automatizar".

    Contratos dinâmicos de notebook — scripts/notebook_cell_output_lint.test.mjs reescrito sem listas hardcoded: discoverNotebooks() descobre automaticamente todos os notebooks em 99 - Meta e Anexos/Notebooks/, e o contrato de chaves do runtime é derivado diretamente de _lab_notebook_runtime.py. Cobertura sobe de 5 para 20 notebooks testados.

    Starters migrados — explorador.py e revisao-diaria.py migrados para _lab_notebook_runtime (removido inline try: import pyodide). Violações de lint corrigidas: células com múltiplos mo.*() top-level encapsuladas em mo.vstack([...]).

    Runtime helper injection — fix SyntaxError: '(' was never closed em notebooks cujo marimo.App() ocupa múltiplas linhas. Rastreamento de profundidade de parênteses localiza corretamente o ) de fechamento. Testes de regressão adicionados.

    CLI e Publicação

    dgk sow — wizard interativo de credenciais para Telegram. Armazena tokens em ~/.dgk/silo.json com permissões 0o600. Verifica credenciais contra a API real antes de salvar. Descobre e persiste contatos do Telegram no primeiro setup. dgk sow list mascara valores armazenados. dgk sow remove distingue serviço desconhecido de credencial não configurada.

    dgk serve — hardening — import de dgk-channels/contacts agora é dinâmico (não quebra em vaults sem o pacote instalado). Verificação de token Telegram via GET /bot<token>/getMe antes de persistir. Filtragem de tokens por allowlist explícita por serviço (impede vazamento de variáveis de ambiente não autorizadas).

    dgk open / note — comandos top-level substituindo dgk lab open e dgk lab note. dgk open obsidian abre o vault via URI scheme; dgk open <nome> abre notebook Marimo por nome curto.

    dgk lab — exclusivamente pipeline: etl, curate, evaluate, export. Comandos de navegação promovidos ao nível raiz.

    Workflow pnpm-free — dgk check e dgk lint chamam scripts diretamente via node; usuários não precisam conhecer pnpm.

    dgk setup cross-platform — reescrito em JavaScript puro. Sem dependência de bash. Funciona no Windows sem Git Bash ou WSL.

    Fixes de Confiabilidade

    Rate limiter (dgk-channels) — recheck de minDelayMs após sleep de burst-window. Sem o fix, uma mensagem enviada imediatamente após a janela de burst poderia violar o intervalo mínimo entre envios.

    Inbox do Telegram — nome de arquivo agora inclui message_id como sufixo ({ts} from telegram--{id}.md). Impede perda silenciosa de mensagens chegando no mesmo minuto.

    ETL de feeds (curate_feeds_ia.py) — import urllib.request restaurado. Ausência causava NameError no primeiro ciclo de coleta.

    Extensibilidade

    @aretw0/dgk-skills — pacote Pi-compatível com cinco skills declarativas (vault-context, vault-search, vault-read, vault-create, vault-daily). Ensina agentes a interagir com o vault via Obsidian CLI. Instalável via pi install npm:@aretw0/dgk-skills.

    dgk publish skill / extension — scaffold para novos pacotes de skills Pi e extensões TypeScript com workflow de publicação via tag GitHub Actions.

    CI e Qualidade

    CI — test:python removido do script validate; exclusivo do job test-python que instala uv. Corrige falhas uv: not found no runner de validação.

    smoke_user_vault.mjs — lista RESET_ON_INIT sincronizada com as novas notas da pasta 99.4 - Apresentações/. Contrato G detecta notas published que escapariam ao usuário sem reset.

0.3.1

Patch Changes

  • 5ad1091: Fix invisible and broken content in published notebooks, clarify attachment folder documentation, and resolve Astro 6 deprecation warning.

    Notebooks — WASM runtime fix: Lab notebooks were throwing a NameError popup in the browser. Root cause: _lab_notebook_runtime.py contains from dgk_lab_runtime import *, and marimo's AST parser converts any cell with a wildcard import to app._unparsable_cell(...), which is never executed in the WASM runtime. Fixed by extracting only the inline fallback function definitions (the except ImportError: block body) before injecting them into the exported cell — no wildcard import, no unparsable cell.

    Notebooks — cell output fix: In marimo, only the last evaluated expression in a cell body is shown as visual output. All "Lane de entendimento" sections had 5 consecutive mo.md() calls — only the last was visible. Section headings preceding mo.ui.table() / mo.ui.altair_chart() were also silently discarded. Fixed by combining sequential mo.md() calls into a single call and wrapping heading+table pairs with mo.vstack(). Also fixes a broken f-string in the analise-publicacao.py header cell and a hidden checkbox widget in etl-demo.py. Regression tests added (notebook_cell_output_lint.test.mjs, notebook_export_runtime_helpers.test.mjs).

    Docs: Corrected Attachments/ → Anexos/ naming in organizacao-do-projeto.md, Entendendo a Estrutura de Pastas.md, and README.md. Clarified that 99 - Meta e Anexos/Anexos/ is the global attachment sink configured for the entire vault.

    Astro: Migrated markdown.remarkPlugins to markdown.processor: unified({...}) from @astrojs/markdown-remark to silence the Astro 6 deprecation warning.

    pnpm supply-chain policy: Added pnpm-workspace.yaml with policies.minimumReleaseAge.severity: warn so that template users' CI doesn't fail with ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION when pnpm v11 considers recently-published packages (including Astro ecosystem updates) too new. The template maintainer curates all dependencies; the pnpm v11 error default is too strict for a curated template repo.

0.3.0

Minor Changes

  • 4c79e8c: Add deterministic Lab dataset preparation for local snapshots and runtime data sources, and remove the unsupported dgk release command until a generated-vault release flow exists.

  • 4c79e8c: Polish the published site and Lab mobile experience with a LAN preview script, mobile theme controls, clearer Lab sidebar placement, aligned cards, calmer graph previews, and a Marimo shell that leaves fullscreen control to the notebook runtime.

  • 92b2014: Breaking change: pastas PARA renomeadas para português.

    Antes Depois
    00 - Inbox 00 - Entrada
    10 - Fleeting & Daily 10 - Diário
    20 - Projects 20 - Projetos
    30 - Areas 30 - Áreas
    40 - Resources 40 - Recursos
    50 - Archives 50 - Arquivo
    90 - Templates 90 - Modelos
    99 - Meta & Attachments 99 - Meta e Anexos

    Migração manual para vaults existentes: renomeie as pastas no explorador de arquivos e execute find & replace nos arquivos .md para atualizar wikilinks com os novos nomes.

Patch Changes

  • Updated dependencies [efcee90]
    • @aretw0/dgk-astro-plugins@0.2.0

All notable changes to this project will be documented in this file.

0.2.11 (2026-05-19)

✨ Novos Recursos

  • ai: centralize assistant instructions (a705b8c)
  • onboarding: enrich vault exploration examples (52fd221)
  • onboarding: improve vault setup journey (4bd8ac8)

📚 Documentação

  • release: align versioning playbook with automation (d44b291)

🐛 Correções

  • adjust .gitignore (a7a9e05)
  • ci: configure release git identity before rebase (89e6186)
  • ci: create release PRs from develop (3525739)
  • ci: harden vault validation and release workflows (122a15f)
  • ci: keep audit report informational (28c9d6b)
  • ci: modernize template validation with pnpm (78b1f98)
  • ci: push full release branch history (6239fa4)

0.2.9 (2026-01-27)

📚 Documentação

  • add status badges to README (35dcb30)

✨ Novos Recursos

  • Add Gemini AI commands and workflows for GitHub Actions. (732f48d)

0.2.8 (2026-01-05)

📚 Documentação

  • plugins: update strategy with automation stack and opt-in philosophy (678e03a)

✨ Novos Recursos

  • docs: add comprehensive dashboard guide (e12c051)
  • templates: add GTD daily note and refine dashboard template (d922d23)

0.2.7 (2025-12-12)

📚 Documentação

  • Remove .env based secret management and update related documentation (56cc4d0)

0.2.6 (2025-12-05)

✨ Novos Recursos

🐛 Correções

  • adjust condition on release workflow (b22eee2)
  • remove failing workflow (f5e7f78)
  • workflow: adjust prepare release pr workflow (e5532f2)

0.2.5 (2025-11-20)

📚 Documentação

  • ai: documenta o propósito do GEMINI.md para o usuário final (3256864)
  • obsidian: documenta a nova estratégia de gerenciamento de plugins (4cc399d)

✨ Novos Recursos

  • docs: prioriza o plugin nativo 'Bases' sobre o 'Dataview' (d1d018d)
  • obsidian: ignora o diretório de plugins da comunidade (da61eeb)
  • project: refatora o GEMINI.md para desenvolvimento do template (625981e)
  • push release branch before creating PR (2509d5d)

0.2.4 (2025-10-15)

🐛 Correções

  • workflows: Updates release workflow to fetch version from VERSION file. (218c59a)

0.2.3 (2025-10-15)

🐛 Correções

  • release: Updates release scripts to skip tagging. (3fd6585)

0.2.2 (2025-10-15)

🐛 Correções

  • Updates version retrieval in release workflows. (5fe27dc)

0.2.1 (2025-10-14)

🐛 Correções

  • Removes redundant push step in versioning workflow. (8e9bc70)
  • Updates branch condition for versioning workflow. (7c256c0)

♻️ Refatoração

  • release: Alinha e automatiza o processo de release (4f51f57)

✨ Novos Recursos

  • Adds manual release process documentation. (dc8aabc)
  • adiciona feature flag para controlar workflows do Gemini (#6) (9682f6b)
  • setup: Feature/initial setup (#4) (#5) (8baeb95)
  • Updates Obsidian configuration and restores daily notes. (fa2c863)

0.2.1 (2025-10-14)

🐛 Correções

  • Removes redundant push step in versioning workflow. (8e9bc70)
  • Updates branch condition for versioning workflow. (7c256c0)

♻️ Refatoração

  • release: Alinha e automatiza o processo de release (4f51f57)

✨ Novos Recursos

  • Adds manual release process documentation. (dc8aabc)
  • adiciona feature flag para controlar workflows do Gemini (#6) (9682f6b)
  • setup: Feature/initial setup (#4) (#5) (8baeb95)
  • Updates Obsidian configuration and restores daily notes. (fa2c863)

0.2.0 (2025-09-11)

✨ Novos Recursos

  • Implementa guarda de release e inclui refactor no changelog (24b02a8)

📚 Documentação

  • Adiciona documentação sobre limpeza de histórico Git (0492c9a)
  • Adiciona documentação sobre o processo de release (040d982)

♻️ Refatoração

  • Remove debug output from release workflow (48ea20c)
  • Remove prefix 'Release' from release name (67948df)

🐛 Correções

  • Ajusta lógica do guarda de release para verificar commits entre tags (d3966e9)
  • Corrige a lógica para obter a tag anterior limpa no guarda de release (9267207)
  • Refina a lógica do guarda de release para obter a tag anterior corretamente (7c9318a)

0.1.4 (2025-09-11)

🐛 Correções

  • Melhora o nome da release no workflow (0cbca4e)

0.1.3 (2025-09-11)

✨ Novos Recursos

  • Adiciona permissão `contents: write` ao workflow de release (f5f589e)

0.1.2 (2025-09-10)

🐛 Correções

  • release: Refactor release notes extraction to use Node.js script (848182d)

0.1.1 (2025-09-10)

📚 Documentação

  • aprimora a documentação do processo de release (25a7fc1)

🐛 Correções

  • release: isola o versionamento no arquivo VERSION e robustece o workflow (756b2c9)

0.1.0 (2025-09-10)

📚 Documentação

  • Add digital gardener's perspective on versioning (63071ea)
  • Document release automation strategy and workflow (0b67184)
  • Document versioning and release strategy (fa56f4b)
  • Refine versioning strategy examples for template context (6a5737d)

✨ Novos Recursos

  • Add minor and major release scripts to package.json (12dc089)
  • Enable Markdown linting in CI workflow (bf645d0)
  • Flexibiliza regras de lint e documenta o processo (0fdb69a)
  • lint: implementa lint gradual e documenta o processo (e036183)
  • workflow: Add dormant GitHub Release automation workflow (a8bb01d)
  • workflow: Implement dynamic release workflow activation/deactivation (696e50b)

0.0.2 (2025-09-09)

🐛 Correções

  • Ajusta execução do script setup_node.sh (b7daa18)
  • Update project description to include Visual Studio Code (Foam) support (bc19e97)

✨ Novos Recursos

  • ✨ Automatiza a inicialização do vault para novos usuários (a870b50)
  • Add initial configuration files for Obsidian vault (334e0e8)
  • Adiciona .vscode/extensions.json e ajusta .gitignore (a2c8faf)
  • Adiciona arquivos de template e inicializa pasta Inbox (3ac85cc)
  • adiciona bumpFiles (b7fbd45)
  • adiciona estrutura de conventional commits (9802a7a)
  • Adiciona script para remover arquivo do histórico do Git (d74ce64)
  • build: adiciona VERSION e package-lock.json (7aa16f5)
  • ci: Restructure CI/CD for template and user workflows (4a0179f)
  • config: ignora arquivos de configuração de plugins sensíveis (2cf9cf8)
  • copilot: Refactor Copilot setup and .gitignore (307738b)
  • dev-config: adiciona configurações de versionamento e commit (82a6018)
  • dev-tools: adiciona package.json com ferramentas de desenvolvimento (33453e1)
  • Improve setup scripts and environment compatibility (1e50cfb)
  • Revamp vault structure and documentation (03427c5)
  • security: implementa sistema de gerenciamento de segredos com Git filter (6188836)
  • template: add initialization script and update README (a86f4b1)
  • workflow: Enhance vault initialization with template files and cleaner docs setup (5ce4b0e)

📚 Documentação

  • 🏗️ Adiciona documentação técnica da organização do projeto (38c4778)
  • 📚 Esclarece a distinção entre docs/ e 99-Meta & Attachments/ (6082594)
  • 📝 Documenta a automação da inicialização do vault (fdd9e6a)
  • Add GCM configuration for WSL users and update script (0c5f14e)
  • Refine original README.md for template clarity (8665137)
  • security: adiciona documentação sobre gestão de segredos no Git (8ce9a42)

0.0.1 (2025-09-09)

🐛 Correções

  • Ajusta execução do script setup_node.sh (b7daa18)
  • Update project description to include Visual Studio Code (Foam) support (bc19e97)

📚 Documentação

  • Add GCM configuration for WSL users and update script (0c5f14e)
  • security: adiciona documentação sobre gestão de segredos no Git (8ce9a42)

✨ Novos Recursos

  • Add initial configuration files for Obsidian vault (334e0e8)
  • Adiciona .vscode/extensions.json e ajusta .gitignore (a2c8faf)
  • Adiciona arquivos de template e inicializa pasta Inbox (3ac85cc)
  • adiciona bumpFiles (b7fbd45)
  • adiciona estrutura de conventional commits (9802a7a)
  • Adiciona script para remover arquivo do histórico do Git (d74ce64)
  • build: adiciona VERSION e package-lock.json (7aa16f5)
  • config: ignora arquivos de configuração de plugins sensíveis (2cf9cf8)
  • dev-config: adiciona configurações de versionamento e commit (82a6018)
  • dev-tools: adiciona package.json com ferramentas de desenvolvimento (33453e1)
  • Improve setup scripts and environment compatibility (1e50cfb)
  • Revamp vault structure and documentation (03427c5)
  • security: implementa sistema de gerenciamento de segredos com Git filter (6188836)