amr/passepartout
1
0
Fork 0
Code Issues 15 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

chore: add v0.2.1 changelog, fix README purpose, remove duplicate USER_MANUAL

Browse Source
This commit is contained in:
Amr Gharbeia
2026-05-03 07:35:23 -04:00
parent d35aea391e
commit b6923d5584
4 changed files with 102 additions and 141 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
docs/CHANGELOG.org
View File

@@ -1,6 +1,41 @@
#+TITLE: Changelog
#+STARTUP: content
* v0.2.1 — Rename, Safety, and Deployment (2026-05-02)
This release renames the project to Passepartout, adds content-level safety gates, professionalizes deployment, and documents every function with full explanatory prose.
** Project Rename
- **Passepartout:** Project renamed from OpenCortex to Passepartout. All files, packages, functions, and environment variables updated.
- **Org/lisp split:** Source of truth lives in ~org/~, tangled to ~lisp/~. Core files committed, skills generated at configure time.
- **31 org files:** Every file renamed to ~category-subject.org~ convention. Harness and skills unified under one directory.
** Safety
- **Secret Exposure Gate:** Content scanning for API keys, PEM blocks, PGP keys, credentials, and tokens in all outgoing text.
- **Path Protection:** File reads blocked for ~.env~, SSH keys, PEM/PGP, cloud configs, and credential stores.
- **Shell Safety:** Destructive commands (~rm -rf /~, ~dd~, ~mkfs~, ~shred~) and injection patterns (backtick, ~$()~) blocked with timeout and output limits.
- **Lisp Validation Gate:** Writes to ~.lisp~ and ~.org~ files validated for syntax errors before they reach disk.
- **REPL Verification Lint:** Warns if defuns are written without REPL prototyping.
** Deployment
- **Multi-distro:** Automatic detection of Debian vs Fedora, correct package names and managers.
- **systemd service:** User-level auto-start on boot via ~passepartout install service~.
- **Backup/Restore:** ~passepartout backup~ and ~passepartout restore~ commands.
- **Docker:** Updated to ~debian:trixie-slim~, fixed build context.
- **CI/CD:** GitHub Actions workflows for lint, test, and release. Gitea deploy workflow fixed.
** Engineering Process
- **REPL-first Lifecycle:** Two-track workflow: Org-first for prose and tests, REPL-first for implementation. Every function prototyped in the REPL before reaching Org.
- **Verification Loop:** Bouncer rejects bad lisp; rejection trace feeds back to LLM for self-correction.
- **System-prompt-augment:** Skills can inject domain-specific mandates into the LLM prompt via ~:system-prompt-augment~.
** Documentation
- **Literate Prose Restored:** Every Org file now has an Architectural Intent overview and explanatory prose before each function block, following the style established in the v0.1.0 era.
- **AGENTS.md:** Thinned to a routing layer — the skill org files are authoritative.
** Contributors
- **gitignore:** ~skills/*.lisp~ and ~tests/*.lisp~ as generated artifacts (source of truth is ~.org~).
- **DeepSeek and NVIDIA NIM:** Added as LLM providers (OpenAI-compatible). Use ~DEEPSEEK_API_KEY~ and ~NVIDIA_API_KEY~ env vars.
* v0.2.0 - Interactive Refinement (2026-04-29)
This release focuses on professionalizing the environment and enhancing the agent's structural capabilities.