# Changelog

All notable changes to the ASK Design System are recorded here. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); version numbers follow [Semantic Versioning](https://semver.org/).

The tag namespace is `ask-design@x.y.z`.

## [Unreleased]

### Added
- _Add entries here as you open PRs._

## [1.0.0] — 2026-05-21

Initial release. Approved by Matteo Rizzo.

### Added

- **Brand foundations** — positioning statement, three brand pillars (Walled Garden / RAG Engine / Policy as Code), and the "Power Under Control" essence (`docs/brand/guidelines.md`).
- **Voice & tone** — three attributes (Authoritative & Pragmatic / Protective yet Enabling / Deterministic & Accountable) with copywriting examples (`docs/brand/voice-and-tone.md`).
- **Environments** — Chat / Notebook / Vertical App execution-environment differentiation rules (`docs/brand/environments.md`).
- **Compliance patterns A–D** — Verified Citation Block, HITL Validation, Active Guardrail Interventions, Implicit RBAC Filtering (`docs/brand/compliance-patterns.md`).
- **Design tokens (DTCG v1)** — full color, type, spacing, radius, motion, elevation token set in `design-tokens/tokens.json`.
- **Tokens Studio export** — `design-tokens/figma/tokens-studio.json` for direct Figma import.
- **shadcn / Tailwind preset** — `design-tokens/shadcn/globals.css` and `tailwind.preset.ts` with HSL-channel CSS variables and dark mode.
- **Storybook theme** — `design-tokens/storybook/theme.ts`.
- **Logo set** — wordmark, mark-only, knockout, on-white, rounded variants in SVG (`logo/*.svg`) and rasterized PNG (`logo/png/`).
- **Brand sheets** — printable visual reference at `brand-sheets/Ask Brand Sheet.html` and component reference at `brand-sheets/Ask Design System.html`.
- **Repo scaffolding** — README, LICENSE (proprietary), CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, issue & PR templates, CI workflows, CODEOWNERS, Dependabot.
- **Token build pipeline** — Style Dictionary configuration at `style-dictionary.config.mjs`, scripts at `scripts/build-tokens.mjs` and `scripts/check-tokens.mjs`.

### Brand pillars in this release

| Pillar | UI manifestation |
|---|---|
| Walled Garden | Pod boundary badges, tenant-isolation indicators |
| RAG Engine | Inline citation chip primitive (Pattern A) |
| Policy as Code | HITL slide-to-approve + RBAC implicit filtering (Patterns B & D) |

[Unreleased]: https://github.com/mirai-srl/project-ask-design-system/compare/ask-design@1.0.0...HEAD
[1.0.0]: https://github.com/mirai-srl/project-ask-design-system/releases/tag/ask-design%401.0.0