Release 0.6.0

0.6.0 (2026-04-29)

Features

• spec: accept object form for decisions[*].implementation (2ddebfa)

Bug Fixes

• action: bump peter-evans/create-pull-request v5 -> v8 (df1430b)

Release 0.5.0

0.5.0 (2026-04-29)

Features

• migrate: handle dict-shaped non-conforming v1.x data (9accb32), closes eFAILution/gitlab-component-helper#87

Bug Fixes

• action: stage v1.x → v2.0 migration before validation to break upgrade deadlock (061c0c3)

Release 0.4.0

0.4.0 (2026-04-23)

Features

• action: v2-aware, three-channel adoption aligned (9beb2a7)
• Claude Code skill, router AGENTS.md, honest empirical framing (8d9fa20)
• spec: v2.0 canonical shapes + JSON Schemas + schema-driven validator (1bf4aa7)

Bug Fixes

• ai: drop timestamp from generated .ai/index.yaml (10b61d5)
• ci: pass GITHUB_TOKEN to gitleaks-action (ac7647b)
• deps: pin Pillow, tqdm, zipp to clear OSV advisories (1a27be1)

Maintenance

• ai: regenerate .ai/index.yaml (6cea525)
• ai: regenerate .ai/index.yaml (eee1f12)
• ai: regenerate .ai/index.yaml (6157307)
• gitignore validation/real-world-projects/ scratch (dc6e27e)
• security: argus config, lint/bandit configs, npm update (e56543b)

Documentation

• readme: concrete install paths for the Claude Code skill (0c21c6c)
• reframe MCP design after production-MCP guidance (2c45958)
• results: live Claude pilot (n=12) — AICaC_SELECTIVE 100% vs AGENTS 50% (59495a3)
• validation: in-harness v2.0 eval protocol (deferred) (c911d14)
• validation: MCP server design sketch (deferred implementation) (ef466e4)

Code Refactoring

• ai: migrate .ai/ + sample to v2.0 canonical shape (6c86d3e)

Tests

• toon: update yaml_to_toon tests for v2.0 canonical shape (6ad6114)

Continuous Integration

• block Claude attribution and session URLs from ever landing (6d0435c)
• install jsonschema for unit tests (f2c9254)

Release 0.3.0

0.3.0 (2026-03-07)

Features

• action: add rebase/retry checkbox and restrict migration to default branch (f78e02c)
• regenerate TOON files from updated YAML sources (0b37fb6)

Bug Fixes

• action: handle existing migration branch and skip if PR exists (8a525b0)
• action: use force-push fallback instead of branch deletion (8faf906)
• ai: escape nested quotes in errors.yaml (10f6b26)
• ci: fix yamllint YAML syntax and add actionlint (2790bdb)
• ci: resolve actionlint errors and add git identity for migration (92b3a6a)

Continuous Integration

• lint: add yamllint to validate-aicac pipeline (f2c505f)

Release 0.2.0

0.2.0 (2026-03-07)

Features

• action: add TOON generation and issue-based migration workflow (4a976a7)
• action: enable suggest-toon by default (ed54b0e)
• validation: integrate TOON encoding as benchmark format (becd122), closes #3

Bug Fixes

• action: add issues:write permission and ensure migration label exists (f120b9c)
• ci: accept common_commands in validator and override pytest addopts (7f110bb)
• ci: checkout PR branch ref to fix release-it dry run (3bd0dd6)
• ci: fix unit test and integration test failures (3c5943a)

Continuous Integration

• action: add unit tests and integration tests to PR validation (55d8164)

Release 0.1.1

0.1.1 (2026-02-11)

Bug Fixes

• validate.py: handle missing contexts and report to user (f701ec6)

Maintenance

• fix release-it dry run errors (53067e0)

Continuous Integration

• add release-it config and workflow (cfc0226)

v0.1.0: AICaC Specification & GitHub Action

🚀 AICaC v0.1.0 - First Public Release

First official release of AI Context as Code (AICaC) - a structured approach to AI-readable project documentation.

📦 What's Included

Specification

• ✅ Complete AICaC whitepaper (23KB)
• ✅ .ai/ directory convention
• ✅ Four compliance levels
• ✅ Token efficiency validation

GitHub Action

• ✅ Smart auto-mode detection - automatically bootstraps or maintains
• ✅ Setup mode - Creates PR to adopt AICaC
• ✅ Maintain mode - Validates compliance and updates badges
• ✅ 99 tests, 81% coverage

Badging System

• ✅ Visual compliance indicators
• ✅ Automatic updates
• ✅ Four levels: None, Minimal, Standard, Comprehensive

🎯 Quick Start

Add this workflow to .github/workflows/aicac.yml:

name: AICaC Adoption

on:
  push:
    branches: [main]
  workflow_dispatch:

jobs:
  aicac:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v3

      - name: Check if .ai exists
        id: check
        run: |
          if [ -d ".ai" ]; then
            echo "mode=maintain" >> $GITHUB_OUTPUT
          else
            echo "mode=setup" >> $GITHUB_OUTPUT
          fi

      - uses: eFAILution/AICaC/.github/actions/aicac-adoption@v0.1.0
        with:
          mode: ${{ steps.check.outputs.mode }}
          github-token: ${{ secrets.GITHUB_TOKEN }}
          update-badge: 'true'

Important: Enable Actions to create PRs in Settings > Actions > General > Workflow permissions

📚 Documentation

• Complete Specification
• Action Documentation
• Badge Guide
• Testing Guide

🔬 Validation Results

• 40-60% token reduction vs traditional documentation
• 15-25% faster task completion (empirically validated)
• Direct queryability for AI assistants

🙏 Contributing

We welcome contributions! See the repository for details.

---

Making AI-readable documentation a reality.