Tags give the ability to mark specific points in history as being important
-
v0.10.1
Release: v0.10.14f240e05 · ·Release v0.10.1 - **Uninitialized Workspace Onboarding Directive**: Enhanced `hooks/pjp-startup.bash` to emit a structured onboarding directive when entering an uninitialized workspace, guiding agents to run `ajourn init` with `.git/info/exclude` registration. - **Formal Lifecycle Hook Specification (`[TECH-007]`)**: Authored `docs/technical/specs/lifecycle-hooks.rst` defining the dual-state workspace handling protocol and non-contamination invariants. - **Automated Hook Onboarding Testing**: Expanded `Test 22` in `tests/run_tests.bash` to verify uninitialized onboarding directives and validate zero global state leakage. - **Agent Instruction Alignment**: Synchronized `AGENTS.md` and `skills/pjp/SKILL.md` to document the automated onboarding workflow for uninitialized repositories.
-
v0.10.0
Release: v0.10.00bdd26d9 · ·Release v0.10.0 - **Unified Cockpit Commands (`ajourn status` & `ajourn list`)**: Introduced `ajourn status` for a high-density summary of current objective (`state.json`), in-flight/failed features (`features.json`), active rejections (`rejections.json`), and the last 3 log entries, alongside `ajourn list [-n N]` for chronological history inspection across daily log files. - **Enhanced State CLI Manipulation (`ajourn state`)**: Added direct JSON argument support to `ajourn state [--patch]` and atomic subcommands `ajourn state set <key> <val>` and `ajourn state unset <key>`. - **Git-Style Plugin Delegation**: Added automatic delegation of non-built-in subcommands to `ajourn-<subcommand>` executables found in `.agents/journal/plugins/` or `$PATH`. - **Git Exclusion Hygiene**: Enhanced `ajourn init` to register `.agents/` in `.git/info/exclude` by default in git repositories, preserving clean `.gitignore` files. - **Expanded Test Suite (Tests 18-25)**: Added automated test coverage in `tests/run_tests.bash` for state manipulation, plugin delegation, git exclusion hygiene, unified cockpit commands, startup hook isolation, state key validation, 0-byte state recovery, and safe message handling. - **Global State Contamination**: Removed fallback to `ajourn -g startup` in `hooks/pjp-startup.bash` for uninitialized workspaces, preventing cross-project whiteboard leakage. - **Installation Symlink Isolation**: Guarded `~/.gemini/hooks.json` symlink creation and removal in `GNUmakefile` to default `CONFIG_DIR` only, preventing test teardown or custom directory runs from breaking user symlinks. - **Workstation Environment Verification (`tests/verify_env.bash`)**: Added explicit validation for the `~/.gemini/hooks.json` symlink and converted script to `.bash` standards.
-
v0.9.0
Release: v0.9.0c7258c6c · ·Release v0.9.0 - **Modular GNUmakefile Targets**: Added dedicated `install-skill` and `install-hooks` targets to `GNUmakefile` for atomic customization management. - **Config Directory Parameterization**: Parameterized `CONFIG_DIR ?= $(HOME)/.gemini/config` in `GNUmakefile` to support custom and staged deployments. - **Subcommands Matrix Update**: Added `help` subcommand to `docs/technical/specs/subcommands.rst`. - **Environment Verification Engine (`make verify-env`)**: Modernized `tests/verify_env.sh` to validate `ajourn` in `$PATH`, `hooks.json` registrations, executable startup hook scripts (`hooks/pjp-startup.bash`), and `~/.gemini/config/skills/pjp` skills. - **Test Suite Workspace Isolation**: Isolated `CONFIG_DIR` during `Test 8: Makefile Installation` in `tests/run_tests.bash` to prevent test teardown from deleting active user configuration files. - **Multi-Licensing Governance**: Corrected `CONTRIBUTING.rst` license section to accurately state the SPDX multi-licensing model across code (GPL-3.0-or-later), AI skills (MIT), and documentation (GFDL-1.3-or-later). - **Documentation & Path Modernization**: Updated `README.rst`, `UPGRADE.rst`, `AGENTS.md`, `cognitive-layering.rst`, and `deployment-and-trust.rst` to reflect `~/.gemini/config/` paths and user-level `make install`. - **Software Version Synchronization**: Synchronized `pjp_version` to `0.9.0` across `bin/ajourn`, `GNUmakefile`, `SKILL.md`, and technical specifications.
-
v0.8.0
Release: v0.8.083920e2c · ·Release v0.8.0 - **Multi-File State Ledger (`[TECH-006]`)**: Introduced decoupled, domain-partitionable feature ledgers (`features.json`) and architectural rejection indexes (`rejections.json`) in `.agents/journal/`. - **Verifiable Feature Ledger Subcommand (`ajourn feature`)**: Added `ajourn feature <list|add|pass|fail>` supporting domain partitioning (`--domain <name>`), key-by-ID lexicographical sorting, and POSIX lockfile concurrency control. - **Architectural Rejection Index Subcommand (`ajourn reject`)**: Added `ajourn reject <add|list|lookup>` to record and query discarded proposals with tag normalization and fuzzy text matching. - **Multi-Ledger Session Ingestion (`ajourn startup`)**: Enhanced `ajourn startup` to automatically display pending/failing features and recent architectural rejections alongside whiteboard state and history. - **Invocation-Aware Lifecycle Startup Hook**: Added modular `PreInvocation` startup hook (`hooks/pjp-startup.bash`, `hooks/hooks.json`) executing strictly on invocation 1 to ingest workspace ledger state without turn-by-turn notification noise. - **Specification & Phased Roadmap Alignment**: Authored `docs/technical/specs/multi-file-state-ledger.rst` (`[TECH-006]`) and `docs/project/roadmaps/phase-6-multi-file-state-ledger.rst` (Phase 6). - **Test Suite Expansion**: Added `Test 14: Verifiable Feature Ledger`, `Test 15: Architectural Rejection Index`, `Test 16: Multi-Ledger Startup Ingestion`, and `Test 17: PJP Lifecycle Startup Hook` to `tests/run_tests.bash`. - **Noisy Post-Invocation Reminder Hook**: Removed intrusive `hooks/pjp-reminder.bash` and `pjp-reminder` `PostInvocation` configuration from `hooks.json` to prevent turn-by-turn notification pollution and task output contamination. - **Lifecycle Hook Integration & Message Boundaries**: Streamlined Antigravity hook integration to execute `ajourn startup` strictly on session initialization, preserving clean message envelopes across agent turns and background tasks.
-
v0.7.1
Release: v0.7.1 Release67860bbe · ·release(v0.7.1): release v0.7.1 - comprehensive README reference, security docs, and version bump
-
v0.6.0
Release: v0.6.068a9840a · ·Release v0.6.0 - **Built-in Shell Autocompletion**: Added `ajourn completion [bash|zsh]` with dynamic plugin discovery (`ajourn-*`), tag suggestions (`-t`/`--tags`), and path autocompletion. - **Auto-loading Shell Integration**: Configured `GNUmakefile` to automatically install completion scripts to `$(PREFIX)/share/bash-completion/completions` and create auto-loading symlinks at `~/.bashrc.d/ajourn.bash` on Fedora/RHEL systems. - **Subcommand Usage Help System**: Implemented dedicated help pages for all subcommands (`init`, `log`, `state`, `search`, `startup`, `heritage`, `migrate`, `tidy`, `verify`, `rechain`, `completion`). All subcommands now respond to `--help`, `-h`, `help`, and `ajourn help <subcommand>`. - **Official `pjp` AI Agent Skill**: Created `skills/pjp/SKILL.md` (PJP v0.6.0) providing complete guidelines for AI agents adopting PJP. Deprecated and removed legacy `project-journal` skill. - **Upgrade Guide**: Added `UPGRADE.rst` documenting step-by-step procedures for upgrading binaries, autocompletion scripts, AI agent skills, and legacy journal stores. - **Test Suite Expansion**: Added `Test 10: Shell Completion` and `Test 11: Subcommand Help Pages` to `tests/run_tests.sh`. - Added **Consult Journal Memory First** directive to `AGENTS.md` and `README.rst` mandating that AI agents inspect `ajourn startup` output and past journal entries before executing exploratory system discovery commands. - Added **Zero-Ambiguity AI Agent Implementation Guide** to `AGENTS.md` and `README.rst` providing a deterministic 5-step quickstart for any AI agent receiving instructions to adopt PJP. - Documented **Plugin & Extension Architecture** in `AGENTS.md` and `README.rst` detailing Git-style executable delegation (`ajourn-<subcommand>`) and lifecycle event hooks (`.agents/journal/hooks/`).
-
v0.5.0
Release: v0.5.068a9840a · ·Release v0.5.0 - Updated `README.rst` integration documentation to reflect the modern `config/hooks.json` format and show how to wrap the startup command with `jq` to prevent unmarshaling failures. - Redirected all warning, error, and state-update messages from `stdout` to `stderr` in `ajourn` to prevent JSON/protobuf unmarshaling failures when invoked by agent hooks. - Updated the environment verification test script `tests/verify_env.sh` to recognize and check `~/.gemini/config/hooks.json` in addition to `~/.gemini/settings.json`.
-
v0.4.0
Release: v0.4.068a9840a · ·Release v0.4.0 - Cryptographic SHA-256 hash chaining across the entire journal history for tamper-proofing. - Single-line journal entry format for streamlined searchability, grepping, and parsing. - Added `verify` command to audit and verify the integrity of the journal hash chain. - Added `rechain` command to recalculate or fix the cryptographic hash chain. - Upgraded `log`, `search`, `startup`, `migrate`, and `tidy` commands to standard single-line hashed layout. - Improved `migrate` command to automatically convert legacy multiline PJP format to the new standard. - Enhanced `tidy` to automatically rechain log files. - Expanded the test suite with verification, tampering, and recovery scenarios (Test 9).
-
v0.3.0
Release: v0.3.0ab1c51a4 · ·Release v0.3.0 Added - **Multi-user Architecture**: Journal filenames now include the system user (``$USER``) to prevent Git merge conflicts on shared ledgers. - **Agent Identity Hash**: Agent identifiers now automatically extract and append a short hash of the conversation ID from ``ANTIGRAVITY_SOURCE_METADATA``. - **Tidy Command**: Introduced ``ajourn tidy`` to intelligently parse, standardise, and de-duplicate log entries. Changed - **Git Ignore Protocol**: Updated ``.gitignore`` to track ``.agents/journal/entries/`` for shared team state, while strictly ignoring the volatile ``state.json``. - **SDK Migration**: Migrated CLI variable checks from ``GEMINI_AGENT_NAME`` to ``ANTIGRAVITY_AGENT_NAME`` to support the Google Antigravity SDK. - **GNUmakefile Prefix**: Modified ``PREFIX`` to default to ``$(HOME)/.local`` for safer user-level installations without ``sudo``. - **Release Protocol**: Updated ``docs/technical/release.rst`` to include mandatory ``CHANGELOG.rst`` updates and document the automated note extraction process. Fixed - **Make Install Target**: Replaced ``$(PWD)`` with ``$(CURDIR)`` in ``GNUmakefile`` to ensure standard ``make -C`` behavior. - **Test Isolation**: Explicitly unset ``ANTIGRAVITY_SOURCE_METADATA`` during testing to prevent live agents from polluting mocked environments. - **Hook Configuration**: Corrected invalid ``TurnEnd`` hook to ``AfterAgent`` and migrated ``type: prompt`` to ``type: command`` in documentation. Security
-
v0.2.1
Release: v0.2.171ad281b · ·Release v0.2.1 Added - **Migration Tool**: Introduced ``ajourn migrate`` to automate the transition from legacy PJP naming schemes (Unix timestamps, YAML state) to the v0.2.x standard. Fixed - **ShellCheck Compliance**: Resolved variable masking and redirection style warnings in the migration logic.
-
v0.2.0
Release: v0.2.071ad281b · ·Release v0.2.0 Added - **Machine-Native State**: Whiteboard migrated from YAML to JSON (``state.json``) for machine-to-machine reliability. - **Atomic Patching**: Support for concurrent state updates via ``ajourn state --patch`` and ``jq``. - **Heritage Distillation**: Automatic archival and concatenation of logs older than 30 days via ``ajourn heritage``. - **Cognitive Layering Case Study**: Formally documented the "Verno Scenario" in ``docs/technical/discussions/``. - **PJP Trust Model**: Defined the "Trust but Verify" architecture using Git as an immutable audit ledger. - **Identity Enforcement**: Added missing-variable warnings to ``ajourn startup`` to ensure agent accountability. - **Discussion Layer**: Formalized the ``docs/technical/discussions/`` directory in the PJP specification. - **GNU FDL 1.3 License**: Adopted the official license to protect protocol reasoning and documentation. - **Contribution Guidelines**: Created ``CONTRIBUTING.rst`` with specific mandates for AI agent contributors. Changed - **Log Naming Convention**: Refactored journal files from Unix timestamps to agent-specific daily files (``YYYY-MM-DD-AGENT_NAME.md``). - **Consolidated Ledger**: Moved all journal entries into a dedicated ``entries/`` subdirectory. - **Enhanced Search**: ``ajourn search`` now provides line numbers and 2 lines of context (``grep -rnH -iC 2``).
-
v0.1.0
Release: v0.1.071ad281b · ·Release v0.1.0 Added - **Project Genesis**: Initial implementation of the Project Journaling Protocol. - **Ajourn Reference Tool**: Core Bash script with ``init``, ``log``, ``state``, ``search``, and ``startup``. - **Local/Global Scoping**: Support for project-rooted and system-level journals. - **Integration Hooks**: Initial specification for CLI session hooks. - **Functional Testing**: Basic functional test suite for core command verification.