feat(modernization): migrate to ARFA 1.3 / DevKit (kcode.phar) standard

BREAKING CHANGES:
- PHP requirement bumped to ^8.4 (from ^8.3)
- Removed legacy dependencies: kariricode/data-structure, kariricode/property-inspector
- Reorganized src/ structure: Contract/ and Processor/ removed, new Attribute/, Handler/, Pipeline/, Result/ layout
- require-dev zeroed — toolchain managed by kcode DevKit

New in v4.0.0:
- Immutable Pipeline (ARFA 1.3 P1): withProcessor() / withPipeline() return new instances
- ProcessorRegistry redesigned with context-based registration
- ProcessorBuilder with flexible spec format (string[] or assoc map)
- ProcessingResultCollection for structured error + coverage tracking
- ProcessorHandler wraps processors with error collection and halt-on-error support
- 100% class/method/line coverage (128 tests, 234 assertions)

Infrastructure:
- DevKit kcode.phar manages cs-fixer, phpstan (L9), psalm, phpunit
- CI rewritten with kcode init + kcode quality pipeline
- Docs: ADR-001 (immutable), ADR-002 (context registry), ADR-003 (spec format), SPEC-001

Author: walmir-silva

.docker/php/Dockerfile

@@ -0,0 +1,48 @@
+name: CI
+
+# ARFA 1.3 / KaririCode Spec V4.0 — Unified CI Pipeline
+# Runs on every push and PR targeting main or develop.
+# Full pipeline: cs-fixer → phpstan (L9) → psalm → phpunit (pcov)
+# Zero tolerance: any tool failure blocks the merge.
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch:
+
+jobs:
+  quality:
+    name: Quality Pipeline (ARFA 1.3)
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      # PHP 8.4 + pcov (mandatory driver per ARFA 1.3 §Testing)
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.4'
+          extensions: mbstring, xml
+          coverage: pcov
+
+      # Pure dependency install — no scripts to avoid environment pollution
+      - name: Install dependencies
+        run: composer install --no-interaction --prefer-dist --no-progress --no-scripts
+
+      # Bootstrap kcode.phar from the official KaririCode release
+      - name: Install kcode (KaririCode Devkit)
+        run: |
+          wget -q https://github.com/KaririCode-Framework/kariricode-devkit/releases/latest/download/kcode.phar
+          chmod +x kcode.phar
+          sudo mv kcode.phar /usr/local/bin/kcode
+
+      # Generate .kcode/ configs: phpunit.xml.dist, phpstan.neon, psalm.xml, etc.
+      - name: Initialize devkit (.kcode/ generation)
+        run: kcode init
+
+      # cs-fixer → phpstan (L9) → psalm → phpunit
+      # Exit code ≠ 0 fails the job (zero-tolerance policy)
+      - name: Run full quality pipeline
+        run: kcode quality

.docker/php/kariricode-php.ini

@@ -1,67 +1,52 @@
-# Arquivos de configuração do sistema
+# Sistema / IDE
 /.idea/
 *.sublime-project
 *.sublime-workspace
-/.phpunit.result.cache
-/.php_cs.cache
-/.php_cs.dist.cache
-/phpstan.neon.dist
-/phpstan.neon.cache
-/.phpstan.result.cache
-/.phpcs-cache
+.DS_Store
+Thumbs.db
+.vscode/
 
 # Dependências
 /vendor/
 /node_modules/
 
-# Arquivos específicos do sistema operacional
-.DS_Store
-Thumbs.db
+# DevKit (gerado pelo kcode init — nunca versionar)
+.kcode/
 
-# Arquivos de build e compilação
+# Build e cobertura
 /build/
 /dist/
+coverage/
+coverage*/
+coverage-report-html/
+
+# Cache
+*.cache
 *.log
-*.tlog
 *.tmp
 *.temp
+*.swp
+*~
+._*
 
-# Arquivos e pastas de ambientes virtuais
-.env
-
-# Arquivos de cache
-/cache/
-*.cache
-*.class
-
-# Arquivos de log
-*.log
-*.sql
-*.sqlite
+# PHP caches
+/.phpunit.result.cache
+/.phpunit.cache
+/.php_cs.cache
+/.php_cs.dist.cache
+/phpstan.neon.cache
+/.phpstan.result.cache
+/.phpcs-cache
 
-# Pasta de testes que não devem ser incluídas no repositório
-coverage/
-coverage*
+# Ambiente — não necessário numa biblioteca
+.env
+.env.*
 
-# Arquivos de pacotes
-*.jar
-*.war
-*.ear
-*.zip
-*.tar.gz
-*.rar
+# Lock — gerenciado pelo CI
+/composer.lock
 
-# Outros arquivos e pastas
-*.swp
-*~
-._*
-temp/
-tmp/
-.vscode/launch.json
-.vscode/extensions.json
-tests/lista_de_arquivos.php
-tests/lista_de_arquivos_test.php
+# Artefatos temporários
 lista_de_arquivos.txt
 lista_de_arquivos_tests.txt
-add_static_to_providers.php
-/composer.lock
+temp/
+tmp/