Update V0-12-0.md

Author: Sistema2D

FCVW/changelogs/V0-12-0.md

@@ -1,3 +1,228 @@
 # Changelog V0.12.0
 
-Release record for V0.12.0.
+## Version
+
+`V0.12.0`
+
+## Date
+
+2026-06-23
+
+## Release Status
+
+`published`
+
+## GitHub Release Status
+
+`pending manual publication`
+
+## Release Type
+
+`minor`
+
+## Summary
+
+- Added Markdown-only declarative automation contracts for pseudo-hooks, watcher rules, manual/agentic daemon loops, and governance gates.
+- Added ADR-0002 to clarify that hooks, watchers, daemons, and governance gates are governance contracts, not executable automation.
+- Added `TOKEN_BUDGET.md` as the canonical output-token economy guidance for compact execution summaries.
+- Refreshed the public README in PT-BR and EN-US with a clearer project explanation and Mermaid pipeline diagrams.
+- Added a centered README badge header showing framework version, release, Apache 2.0 license, and LinkedIn contact.
+- Moved the framework license to the repository root and changed the framework license posture to Apache License 2.0.
+- Preserved conceptual credit to `https://github.com/SantanderAI` for declarative automation inspiration, without copying source code.
+
+## Related Plans
+
+- `FCVW/Plans/in_progress/P2-R3-2026-06-23-declarative-automation-contracts.md`
+- `FCVW/Plans/in_progress/P2-R2-2026-06-23-v0120-communication-release.md`
+
+> Note: these plans were still located in `in_progress/` during release preparation because some cleanup/release-publication steps required manual follow-up.
+
+## Items Created
+
+- `LICENSE`
+- `FCVW/AUTOMATION.md`
+- `FCVW/HOOKS.md`
+- `FCVW/WATCHERS.md`
+- `FCVW/DAEMONS.md`
+- `FCVW/GOVERNANCE_GATES.md`
+- `FCVW/TOKEN_BUDGET.md`
+- `FCVW/decisions/ADR-0002-declarative-automation-contracts.md`
+- `FCVW/governance/TEMPLATE_AUTOMATION_CONTRACT.md`
+- `FCVW/governance/TEMPLATE_HOOK_CHECK.md`
+- `FCVW/governance/TEMPLATE_WATCHER_RULE.md`
+- `FCVW/governance/TEMPLATE_DAEMON_LOOP.md`
+- `FCVW/governance/TEMPLATE_GOVERNANCE_GATE_REPORT.md`
+- `FCVW/wiki/sources/santanderai-declarative-automation-inspiration.md`
+- `FCVW/changelogs/V0-12-0.md`
+
+## Items Modified
+
+- `AGENTS.md`
+- `README.md`
+- `FCVW/AI.md`
+- `FCVW/CONTEXT_MAP.md`
+- `FCVW/FILESYSTEM.md`
+- `FCVW/MANIFEST.md`
+- `FCVW/SECURITY.md`
+- `FCVW/STACK.md`
+- `FCVW/WORKFLOW.md`
+- `FCVW/skills/README.md`
+- `FCVW/skills/governance-validator/SKILL.md`
+- `FCVW/skills/wiki-lint/SKILL.md`
+- `FCVW/wiki/index.md`
+- `FCVW/wiki/log.md`
+
+## Items Removed
+
+- `FCVW/LICENSE`
+
+## Justifications
+
+- The framework already optimized input-context consumption through selective loading, AICC session syntheses, and JIT skills. It also needed an explicit output-token economy rule to reduce unnecessary chat narration during governed execution.
+- Declarative automation terminology needed to be made safe and unambiguous, preserving the pure Markdown baseline from ADR-0001 while allowing hooks, watchers, daemons, and gates to be documented as non-executable governance contracts.
+- The public README needed to communicate the project more clearly to first-time readers, in both PT-BR and EN-US, with visual pipeline diagrams.
+- The license needed to be placed at the repository root and aligned with Apache License 2.0 for free framework use.
+
+## Affected Files
+
+- `LICENSE`
+- `AGENTS.md`
+- `README.md`
+- `FCVW/AI.md`
+- `FCVW/AUTOMATION.md`
+- `FCVW/CONTEXT_MAP.md`
+- `FCVW/DAEMONS.md`
+- `FCVW/FILESYSTEM.md`
+- `FCVW/GOVERNANCE_GATES.md`
+- `FCVW/HOOKS.md`
+- `FCVW/MANIFEST.md`
+- `FCVW/SECURITY.md`
+- `FCVW/STACK.md`
+- `FCVW/TOKEN_BUDGET.md`
+- `FCVW/WATCHERS.md`
+- `FCVW/WORKFLOW.md`
+- `FCVW/changelogs/V0-12-0.md`
+- `FCVW/decisions/ADR-0002-declarative-automation-contracts.md`
+- `FCVW/governance/TEMPLATE_AUTOMATION_CONTRACT.md`
+- `FCVW/governance/TEMPLATE_DAEMON_LOOP.md`
+- `FCVW/governance/TEMPLATE_GOVERNANCE_GATE_REPORT.md`
+- `FCVW/governance/TEMPLATE_HOOK_CHECK.md`
+- `FCVW/governance/TEMPLATE_WATCHER_RULE.md`
+- `FCVW/skills/README.md`
+- `FCVW/skills/governance-validator/SKILL.md`
+- `FCVW/skills/wiki-lint/SKILL.md`
+- `FCVW/wiki/index.md`
+- `FCVW/wiki/log.md`
+- `FCVW/wiki/sources/santanderai-declarative-automation-inspiration.md`
+
+## Functional Impact
+
+- Adds compact output behavior as a first-class governance concern through `TOKEN_BUDGET.md`.
+- Clarifies that detailed execution evidence should live in plans, changelogs, audits, troubleshooting records, release notes, and PR descriptions instead of being repeated in chat.
+- Adds declarative automation contracts that let agents reason about pseudo-hooks, watchers, daemon loops, and gates without creating executable automation.
+- Improves onboarding by making the README explain the project, lifecycle, token economy, and automation boundary visually and bilingually.
+
+## Visual Impact
+
+- Adds a centered README header with shields/badges for:
+  - framework version;
+  - current release;
+  - Apache 2.0 license;
+  - LinkedIn contact.
+- Adds Mermaid diagrams for:
+  - main lifecycle pipeline;
+  - token economy pipeline;
+  - declarative automation pipeline.
+
+## Technical Impact
+
+- Keeps FCVW as a Markdown-first governance framework.
+- Does not add runtime code.
+- Does not add package dependencies.
+- Does not add CI/CD workflows.
+- Does not install Git hooks.
+- Does not create coded watchers.
+- Does not create background daemons.
+- Does not integrate provider SDKs or API-key flows.
+
+## License Impact
+
+- Adds root-level `LICENSE` with Apache License 2.0 reference.
+- Removes nested `FCVW/LICENSE` to avoid conflicting license placement.
+- Establishes Apache 2.0 as the framework license posture.
+
+## External Inspiration Credit
+
+Scenario 1 declarative automation records conceptual inspiration from `https://github.com/SantanderAI`, especially around:
+
+- loop and stop-condition patterns;
+- vault/lint style knowledge governance;
+- hard-gate thinking;
+- guardrail-oriented validation.
+
+No SantanderAI source code was copied into FCVW.
+
+## Evaluated Risks and Regressions
+
+- **Risk:** output-token policy could be interpreted as hiding validation evidence.  
+  **Mitigation:** the policy keeps detailed evidence mandatory in repository artifacts.
+
+- **Risk:** automation terms could be misunderstood as permission to create runtime scripts.  
+  **Mitigation:** ADR-0002 and the automation contract documents explicitly preserve Markdown-only Scenario 1.
+
+- **Risk:** README could become too long.  
+  **Mitigation:** the README uses bilingual sections, concise tables, and visual diagrams.
+
+- **Risk:** license migration could leave conflicting license files.  
+  **Mitigation:** root `LICENSE` was added and `FCVW/LICENSE` was removed.
+
+## Validation Executed
+
+- Confirmed the existing V0.12.0 changelog file was incomplete and should be replaced or expanded manually.
+- Confirmed README includes PT-BR and EN-US sections.
+- Confirmed README includes Mermaid diagrams.
+- Confirmed README includes badges for framework version, release, Apache 2.0 license, and LinkedIn contact.
+- Confirmed root `LICENSE` exists with Apache 2.0 reference.
+- Confirmed `FCVW/LICENSE` was removed.
+- Confirmed no executable automation artifacts were intentionally introduced.
+
+## Known Gaps
+
+- The GitHub Release/tag `v0.12.0` was not created through the available connector tools.
+- The current repository file `FCVW/changelogs/V0-12-0.md` contains only a minimal placeholder and should be manually replaced with this content.
+- A duplicate minimal file `FCVW/changelogs/V0.12.md` may require manual deletion if still present.
+
+## Suggested GitHub Release Text
+
+### Title
+
+`FrameCode VibeWork v0.12.0`
+
+### Tag
+
+`v0.12.0`
+
+### Target
+
+`main`
+
+### Release Description
+
+FrameCode VibeWork v0.12.0 adds Markdown-only declarative automation contracts, output-token economy guidance, a refreshed bilingual README with pipeline diagrams, and a root Apache 2.0 license.
+
+This release preserves the framework's pure Markdown baseline while making FCVW clearer for public use, safer around automation terminology, and more economical in AI-assisted execution.
+
+### Highlights
+
+- Markdown-only automation contracts for hooks, watchers, daemon loops, and governance gates.
+- ADR-0002 for explicit automation boundaries.
+- `TOKEN_BUDGET.md` for compact execution summaries.
+- README refreshed in PT-BR and EN-US with Mermaid diagrams.
+- Badge header for version, release, Apache 2.0 license, and LinkedIn contact.
+- Root Apache 2.0 license added.
+- Nested `FCVW/LICENSE` removed.
+- SantanderAI credited as conceptual inspiration for governance patterns.
+
+## Rollback Observations
+
+Roll back by reverting the V0.12.0 documentation and license commits, restoring the previous README state, removing `TOKEN_BUDGET.md`, removing root `LICENSE`, and restoring the previous license placement if required. No runtime artifact, database, migration, deployment, or external-service rollback is required.