v1.5.1

🎯 What's new in v1.5.1

📂 Empty folder support in hierarchical index

run_generate_hierarchical_index() now generates _index.md for ALL P.A.R.A. folders even when empty — no more 404 dead links in the navigation map. Empty folders display a clean message.

📚 Phase 6 documentation

Added "Post-Migration Self-Maintenance" to both EN/UA migration guides — 8-step protocol for AI agents to keep the vault healthy across sessions.

🔧 Changelog

Full details: CHANGELOG.md

What's Changed

• docs: update READMEs for v1.5.0 — fix paths, add search, Why section, badges by @weby-homelab in #22
• fix: update CI paths for src/ layout, actions for Node 24, enable GitHub Pages by @weby-homelab in #23
• fix: resolve all ruff errors, CodeQL implicit concatenation, pip-audit CVEs by @weby-homelab in #24
• chore(deps): bump actions/deploy-pages from 4 to 5 by @dependabot[bot] in #18
• chore(deps): bump actions/upload-pages-artifact from 3 to 5 by @dependabot[bot] in #21
• chore(deps): bump actions/checkout from 5 to 7 by @dependabot[bot] in #20
• chore: remove broken PyPI badge — package not published yet by @weby-homelab in #25
• docs: add AI Agent Migration Guide — 5-phase protocol for any LLM by @weby-homelab in #26
• Release v1.5.1 — Hierarchical index now covers all P.A.R.A. folders + documentation Phase 6 by @weby-homelab in #27

New Contributors

• @dependabot[bot] made their first contribution in #18

Full Changelog: v1.5.0...v1.5.1

v1.5.0

🚀 v1.5.0 — src/ layout, FastMCP, CI/CD, docs, 144 tests

Architecture

• src/ layout — moved all code to src/power_framework/, removed legacy power_core/ and mcp_servers/
• FastMCP migration — replaced raw mcp.server.Server with decorator-based FastMCP (~60% less boilerplate)
• Package rename — power_core.* → power_framework.core.*, mcp_servers.* → power_framework.mcp.*
• CLI entry point — updated from power_core.cli:main to power_framework.core.cli:main

New features

• power search — full-text vault search with relevance scoring, snippet display, and tag/type matching
• power --version — version flag for CLI

CI/CD

• CodeQL — weekly SAST scan with security-and-quality queries
• OIDC Trusted Publishing — PyPI releases via OpenID Connect, zero secrets
• GitHub Pages — auto-deployed mkdocs-material documentation site
• Dependabot — weekly pip + monthly GHA updates

Documentation

• Full mkdocs-material site with API reference, CLI guide, MCP server guide, architecture overview, contributing guide
• SECURITY.md with GPG-encrypted disclosure contact

Testing

• 144 tests total (23 new: CLI functional, MCP tools, full-cycle integration)
• 90.25% code coverage, enforced minimum 70%
• MyPy strict — 0 errors across 11 source files

Security

• CodeQL weekly scans (SAST)
• OIDC Trusted Publishing — no API tokens on release
• Dependabot automated dependency updates

---

Full Changelog: https://github.com/weby-homelab/P.O.W.E.R/blob/v1.5.0/CHANGELOG.md

v1.4.0 — CLI + README Overhaul

What's New

CLI Commands

• power init <path> — Create a complete OKF-compliant vault structure
• power lint <path> — Check for broken links, missing metadata, orphans
• power index <path> — Rebuild catalog index.md
• power ingest <path> — Create notes with validated OKF metadata

Installation

pip install power-framework
power --help

README Overhaul

• User-first layout with Quick Start in the first screen
• Architecture details collapsed into expandable section
• Matching Ukrainian translation (README.ua.md)

Full Changelog: v1.3.0...v1.4.0

What's Changed

• docs: add comprehensive badges to README by @weby-homelab in #2
• fix: URL-encode dots in Release badge by @weby-homelab in #3
• feat: add CLI, rewrite README for user-first DX by @weby-homelab in #6

Full Changelog: v1.3.0...v1.4.0

v1.3.0 — power_core package, security hardening, CI/CD

What's New in v1.3.0

Critical Security Fixes

• Path Traversal vulnerability fixed in MCP server vault_path parameter
• YAML injection prevention via Pydantic validation and string escaping
• Input validation for all MCP tool parameters

Architecture

• New power_core/ package — shared library with Pydantic v2 schemas, safe YAML parser, atomic writes
• Eliminated code duplication — MCP server and CLI scripts now use power_core
• Atomic writes prevent data corruption from interrupted writes

Testing & CI/CD

• 79 pytest tests with fixtures for comprehensive coverage
• GitHub Actions CI — automated pytest, ruff lint, mypy type check
• GitHub Actions Release — auto-release on tag push

New Scripts

• scripts/sync-brain.sh — Cron auto-sync with GPG signing support
• scripts/cleanup_branches.py — Automated merged branch cleanup via GitHub API

Infrastructure

• pyproject.toml — Dependencies, tool configs, package metadata
• .gitignore — Security rules (secrets, caches, DBs)
• LICENSE — MIT License
• CONTRIBUTING.md — Development workflow
• CHANGELOG.md — Version history

Validation

• 79/79 tests passed
• ruff: all checks passed
• mypy: no issues found
• GPG-signed commits

What's Changed

• feat: v1.3.0 — power_core package, security hardening, CI/CD by @weby-homelab in #1

New Contributors

• @weby-homelab made their first contribution in #1

Full Changelog: v1.2.2...v1.3.0

v1.2.2

P.O.W.E.R. Framework - Version 1.2.2 Release. Corrects the Mermaid diagrams and documentation phrasing across both README versions to present the framework as fully agent-agnostic (local/cloud) and clearly distinguish between repository contents and target Obsidian vault structures.

v1.2.1

P.O.W.E.R. Framework - Version 1.2.1 Release. Updates the project description to clearly highlight universal local/cloud agentic support across both README versions. Confirms full compatibility with any MCP-capable or prompt-capable LLM platform.

v1.2.0

P.O.W.E.R. Framework - Version 1.2.0 Release. Introduces the fully self-contained P.O.W.E.R. MCP Server (mcp_servers/power_server.py) exposing the vault manager tools (lint_vault, generate_index, and ingest_note). Updates the installer script (install.sh) to support automatic MCP delivery and links them to local host clients. Documents configuration options in both English and Ukrainian.

v1.1.1

P.O.W.E.R. Framework - Version 1.1.1 Release. Patches path resolutions in lint_brain.py and generate_index.py to resolve paths dynamically relative to the execution context or parameters. Updates SKILL.md to remove user-specific absolute paths, making it fully portable for other developers.

v1.1.0

P.O.W.E.R. Framework - Version 1.1.0 Release. Introduces the reusable P.O.W.E.R. AI Agent Custom Skill (skills/power/) containing custom SKILL.md, generate_index.py, and lint_brain.py scripts. Features a one-command automatic workspace installer (install.sh). Updates both English and Ukrainian README configurations.

v1.0.0

Initial release of the P.O.W.E.R. Framework - Hybrid Knowledge Management System. Features a structured layout combining P.A.R.A., OKF Overlay metadata schema, automated LLM-Wiki bookkeeping (indexing, logs, linting), and customized Execution Rules (GPG validation, autosync cron, PR workflows). Includes both English (default) and Ukrainian translations.