chore(repo): initial baseline import (docs v0.9.2 + bootstrap)

Imports the v0.9.2 documentation baseline and the bootstrap files required by docs/governance/repository-bootstrap-plan.md v0.1.0 §3, minus the justfile (added in the next commit). This commit establishes the git history for the project. All previous work lived only as filesystem state with no version control.
2026-05-14 12:25:33 +08:00
commit f1bc9a6c85
51 changed files with 14510 additions and 0 deletions
@@ -0,0 +1,65 @@
+
+# CHANORA_CFG_Baseline_Approval_Record_v0.9.2.2.1
+
+**Document type:** Configuration / Baseline Approval Record  
+**Version:** 0.9.2  
+**Status:** Baseline Candidate  
+**Language:** English  
+**Product:** Chanora  
+**Repo path:** `docs/governance/baseline-approval-record.md`  ---
+
+## 1. Baseline
+
+| Field | Value |
+|---|---|
+| Baseline name | Chanora MVP Baseline Candidate |
+| Baseline version | 0.9.0 |
+| Package | `CHANORA_Documentation_Baseline_Candidate_v0.9.2.2.1.zip` |
+| Approval target | Promote to `v1.0 Final / Approved Baseline` after review approval |
+
+## 2. Approval Decision
+
+| Decision | Value |
+|---|---|
+| Approved | Pending |
+| Approved with conditions | Pending |
+| Rejected | Pending |
+
+## 3. Approvers
+
+| Role | Name | Decision | Date | Signature / Evidence |
+|---|---|---|---|---|
+| Product owner | TBD | Pending | TBD | TBD |
+| System architect | TBD | Pending | TBD | TBD |
+| Software architect | TBD | Pending | TBD | TBD |
+| Software lead | TBD | Pending | TBD | TBD |
+| QA / verification owner | TBD | Pending | TBD | TBD |
+| Security reviewer | TBD | Pending | TBD | TBD |
+| UX owner | TBD | Pending | TBD | TBD |
+| Platform owner | TBD | Pending | TBD | TBD |
+
+## 4. Open Issues
+
+| Issue ID | Description | Disposition |
+|---|---|---|
+| TBD | TBD | TBD |
+
+## 5. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.0 | 2026-05-14 | Baseline approval record template for normalized package. |
+
+
+## Baseline Candidate 0.9.1 Update
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.1 | 2026-05-14 | Updated baseline after product decision closure: Apple App Store SDK gate uses Xcode 26+ and iOS 26 / iPadOS 26 SDK+ since 2026-04-28, platform baselines and decision traceability propagated across the document set. |
+
+
+## Baseline Candidate 0.9.2 Update
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.2 | 2026-05-14 | Corrected Apple App Store Connect upload gate to 2026-04-28 and checked full-package naming, references, and coverage. |
@@ -0,0 +1,73 @@
+# Cfg Baseline Candidate Validation Report
+
+**Document type:** Configuration / Validation Report  
+**Version:** 0.9.2  
+**Status:** Baseline Candidate  
+**Language:** English  
+**Product:** Chanora  
+**Repo path:** `docs/governance/baseline-candidate-validation-report.md`  ---
+
+## 1. Package
+
+```text
+chanora-docs-repo-format-v0.9.2.zip
+```
+
+## 2. File Count
+
+| Type | Count |
+|---|---:|
+| Markdown files | 36 |
+
+## 3. Defined ID Counts
+
+| ID family | Defined IDs |
+|---|---:|
+| SysRS | 295 |
+| SysDes | 141 |
+| SRS | 194 |
+| SAD | 70 |
+| SDD | 80 |
+
+## 4. Undefined Reference Check
+
+| ID family | Undefined references |
+|---|---:|
+| SysRS | 0 |
+| SysDes | 0 |
+| SRS | 0 |
+| SAD | 0 |
+| SDD | 0 |
+
+## 5. Direct-Layer Rule Check
+
+| Rule | Result |
+|---|---:|
+| SRS direct SysRS references | 0 |
+| SAD direct SysRS references | 0 |
+| SAD direct SysDes references | 0 |
+| SDD direct SysRS references | 0 |
+| SDD direct SysDes references | 0 |
+| SDD direct SRS references | 0 |
+
+## 6. Language Check
+
+| Check | Result |
+|---|---:|
+| CJK characters found | 0 |
+
+## 7. Apple Gate Coverage Check
+
+| Item | Coverage |
+|---|---|
+| Runtime deployment target | iOS 13+ remains separate runtime policy |
+| App Store Connect upload SDK gate | Xcode 26+ and iOS 26 / iPadOS 26 SDK+ for upload on or after 2026-04-28 |
+| Link chain | SysRS-287 -> SysDes-134 -> SRS-186 -> SAD-062 -> SDD-072 |
+| Internal Alpha / local development distinction | Captured in Platform Release Policy |
+| TestFlight / App Store upload distinction | Captured in Platform Release Policy |
+
+## 8. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.2 | 2026-05-14 | Validation report for Apple App Store Connect upload SDK gate correction, full file update, and coverage check. |
@@ -0,0 +1,79 @@
+
+# CHANORA_CFG_Decision_Impact_Assessment_v0.9.2.2.1
+
+**Document type:** Configuration / Decision Impact Assessment  
+**Version:** 0.9.2  
+**Status:** Baseline Candidate  
+**Language:** English  
+**Product:** Chanora  
+**Repo path:** `docs/governance/decision-impact-assessment.md`  ---
+
+## 1. Purpose
+
+This document records how key unresolved product and architecture decisions affect requirements, architecture, detailed design, verification, release readiness, security, privacy, and legal work products.
+
+## 2. High-Impact Decision Assessment
+
+| Decision | Recommended decision | Impact if changed later |
+|---|---|---|
+| Minimum iOS version | iOS 13 | Test matrix, platform support policy, app store build configuration, platform behavior tests. |
+| Minimum Android version | API 24 | Device support, permissions, audio routing, Google Play compatibility, platform tests. |
+| Android target SDK | Google Play-required API level on upload date; current release gate uses API 35+ unless newer policy applies |
+| Apple App Store SDK gate | Xcode 26+ with iOS 26 / iPadOS 26 SDK+ for App Store Connect upload on or after 2026-04-28 unless newer Apple upload policy applies | Google Play submission eligibility and platform permission behavior. |
+| Multiple active connections | Exclude from MVP | If added later, affects state model, audio routing, UI layout, reconnection logic, storage, verification. |
+| AEC/AGC/NS/HPF defaults | Enabled by default where supported | Affects UX, CPU, platform-specific audio settings, verification matrix. |
+| Audio processing path | Platform-native first; fallback later | Affects audio architecture, Rust/native dependencies, latency, CPU, platform compatibility. |
+| Trademark/legal review | Required before public/store release | Blocks public release if unresolved. |
+| Local DB | SQLite or equivalent | Affects storage schema, migrations, backup/delete policy, tests. |
+| Bridge | Stable typed generated/schema-controlled bridge | Affects API stability, async event flow, maintainability, code generation, tests. |
+| Diagnostics upload | No automatic upload in MVP | Affects privacy policy, security review, support process. |
+| Crash reporting | Disabled unless later approved | Affects privacy/legal docs, dependency and supply-chain review. |
+
+## 3. Document Update Rules
+
+| If decision changes | Update required |
+|---|---|
+| Minimum iOS/Android version changes | SysRS, SysDes, SRS, SAD, SDD, SYS.4, SWE.6, Release Readiness |
+| Apple SDK submission gate changes | SysRS, SysDes, SRS, SAD, SDD, SWE.6, Release Readiness |
+| Android target SDK changes | SRS, SWE.6, Release Readiness, Platform Guide |
+| Multiple connections added to MVP | SysRS, SysDes, SRS, SAD, SDD, SWE.4, SWE.5, SWE.6, SYS.4 |
+| Audio defaults change | SysRS, SysDes, SRS, SAD, SDD, SWE.4, SWE.5, SWE.6 |
+| Audio implementation path changes | SysDes, SAD, SDD, SWE.4, SWE.5, SYS.4 |
+| Legal/trademark policy changes | Release Readiness, Legal Review, Privacy Policy, External References |
+| DB choice changes | SysDes, SRS, SAD, SDD, SWE.4, SWE.5 |
+| Bridge choice changes | SysDes, SAD, SDD, SWE.4, SWE.5 |
+| Diagnostics upload enabled | SysRS, SysDes, SRS, SAD, SDD, Threat Model, Privacy Policy, Redaction Audit, Release Readiness |
+| Crash reporting enabled | SysRS, SysDes, SRS, SAD, SDD, Privacy Policy, Dependency Report, Release Readiness |
+
+## 4. Recommended Decision Closure Sequence
+
+1. Confirm release type and staged platform policy.
+2. Confirm mobile minimum versions and Android target SDK policy.
+3. Confirm one active server connection for MVP.
+4. Confirm audio processing defaults.
+5. Confirm audio implementation path.
+6. Confirm diagnostics/crash reporting privacy policy.
+7. Confirm SQLite/equivalent local database.
+8. Confirm bridge choice.
+9. Confirm legal/trademark/public wording review requirement.
+10. Confirm license model before public release.
+
+## 5. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.0 | 2026-05-14 | Initial decision impact assessment for key product and architecture decisions. |
+
+
+## Baseline Candidate 0.9.1 Update
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.1 | 2026-05-14 | Updated baseline after product decision closure: Apple App Store SDK gate uses Xcode 26+ and iOS 26 / iPadOS 26 SDK+ for App Store Connect upload on or after 2026-04-28, platform baselines and decision traceability propagated across the document set. |
+
+
+## Baseline Candidate 0.9.2 Update
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.2 | 2026-05-14 | Corrected Apple App Store Connect upload gate to 2026-04-28 and checked full-package naming, references, and coverage. |
@@ -0,0 +1,60 @@
+# Development Environment
+
+**Document type:** Governance / Development Environment  
+**Version:** 0.1.0  
+**Status:** Draft  
+**Language:** English  
+**Product:** Chanora  
+**Repo path:** `docs/governance/development-environment.md`
+
+---
+
+## 1. Purpose
+
+This document records the intended local development environment for Chanora.
+
+## 2. Required Toolchains
+
+The exact versions shall be finalized when the Flutter and Rust workspaces are created.
+
+Expected tools:
+
+| Tool | Purpose |
+|---|---|
+| Flutter SDK | Cross-platform UI |
+| Dart SDK | Flutter development |
+| Rust toolchain | Core, protocol, audio, storage, diagnostics |
+| Cargo | Rust package/build tool |
+| just | Local command runner |
+| Python 3 | Documentation validation scripts |
+| Xcode | iOS/iPadOS/macOS development and App Store Connect upload builds |
+| Android Studio / Android SDK | Android development |
+| CMake / native build tools | Native dependencies if required |
+
+## 3. Platform Notes
+
+| Platform | Notes |
+|---|---|
+| iOS / iPadOS | App Store Connect upload on or after 2026-04-28 requires Xcode 26+ and iOS 26 / iPadOS 26 SDK+. |
+| Android | Store upload must target the Google Play-required API level on upload date. |
+| Desktop | Windows, macOS, and Linux build requirements shall be finalized during scaffold and release planning. |
+
+## 4. Local Commands
+
+Local commands are defined in `justfile`.
+
+Initial commands:
+
+```bash
+just format
+just lint
+just test
+just verify-docs
+just security-scan
+```
+
+## 5. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.1.0 | 2026-05-14 | Initial development environment document. |
@@ -0,0 +1,86 @@
+# Document Index
+
+**Document type:** Configuration / Documentation Control  
+**Version:** 0.9.2  
+**Status:** Baseline Candidate  
+**Language:** English  
+**Product:** Chanora  
+**Repo path:** `docs/governance/document-index.md`
+
+---
+
+## 1. Purpose
+
+This document lists the normalized latest files included in the Chanora repository documentation package.
+
+## 2. Current Baseline Candidate Files
+
+| File | Status |
+|---|---|
+| `docs/architecture/sad.md` | Baseline Candidate |
+| `docs/architecture/sdd.md` | Baseline Candidate |
+| `docs/architecture/sysdes.md` | Baseline Candidate |
+| `docs/governance/baseline-approval-record.md` | Baseline Candidate |
+| `docs/governance/baseline-candidate-validation-report.md` | Baseline Candidate |
+| `docs/governance/decision-impact-assessment.md` | Baseline Candidate |
+| `docs/governance/document-naming-convention.md` | Baseline Candidate |
+| `docs/governance/document-review-report.md` | Baseline Candidate |
+| `docs/governance/git-commit-message-convention.md` | Baseline Candidate |
+| `docs/governance/path-migration-map.md` | Baseline Candidate |
+| `docs/governance/product-decision-register.md` | Baseline Candidate |
+| `docs/governance/repo-format-validation-report.md` | Baseline Candidate |
+| `docs/governance/traceability-matrix.md` | Baseline Candidate |
+| `docs/i18n/localization-architecture.md` | Baseline Candidate |
+| `docs/legal/trademark-and-attribution-review.md` | Baseline Candidate |
+| `docs/privacy/privacy-policy.md` | Baseline Candidate |
+| `docs/references/aspice-swe2-swe3-integration-note.md` | Baseline Candidate |
+| `docs/references/external-references.md` | Baseline Candidate |
+| `docs/release/platform-release-policy.md` | Baseline Candidate |
+| `docs/release/release-readiness-go-nogo-record.md` | Baseline Candidate |
+| `docs/requirements/srs.md` | Baseline Candidate |
+| `docs/requirements/sysrs.md` | Baseline Candidate |
+| `docs/security/dependency-and-supply-chain-report.md` | Baseline Candidate |
+| `docs/security/diagnostic-redaction-audit-report.md` | Baseline Candidate |
+| `docs/security/secure-storage-audit-report.md` | Baseline Candidate |
+| `docs/security/security-privacy-legal-guideline.md` | Baseline Candidate |
+| `docs/security/threat-model.md` | Baseline Candidate |
+| `docs/ui-ux/adaptive-layout-platform-guide.md` | Baseline Candidate |
+| `docs/ui-ux/material3-component-catalog.md` | Baseline Candidate |
+| `docs/ui-ux/material3-design-tokens.md` | Baseline Candidate |
+| `docs/ui-ux/material3-guideline.md` | Baseline Candidate |
+| `docs/verification/swe4-unit-verification-plan.md` | Baseline Candidate |
+| `docs/verification/swe5-software-integration-verification-plan.md` | Baseline Candidate |
+| `docs/verification/swe6-software-verification-plan.md` | Baseline Candidate |
+| `docs/verification/sys4-system-integration-verification-plan.md` | Baseline Candidate |
+| `docs/verification/verification-master-plan.md` | Baseline Candidate |
+
+## 3. Core Engineering Hierarchy
+
+```text
+SysRS -> SysDes -> SRS -> SAD -> SDD
+```
+
+## 4. Verification Work Product Mapping
+
+```text
+SDD -> SWE.4
+SAD + SDD -> SWE.5
+SRS -> SWE.6
+SysDes -> SYS.4
+```
+
+## 5. Repo File Naming Rules
+
+| Rule | Decision |
+|---|---|
+| Product prefix in file names | Not used under `docs/` |
+| Case style | lowercase kebab-case |
+| Version in file name | Not used |
+| Version location | Inside document metadata |
+| Release package version | Used in ZIP/package name |
+
+## 6. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.2 | 2026-05-14 | Converted documentation package to repository-oriented docs folder structure and updated internal filename references. |
@@ -0,0 +1,66 @@
+# Document Naming Convention
+
+**Document type:** Configuration / Documentation Control  
+**Version:** 0.9.2  
+**Status:** Baseline Candidate  
+**Language:** English  
+**Product:** Chanora  
+**Repo path:** `docs/governance/document-naming-convention.md`
+
+---
+
+## 1. Purpose
+
+This document defines the official repository documentation naming convention for Chanora.
+
+## 2. Repository Path Pattern
+
+Markdown documents under the repository shall use this pattern:
+
+```text
+docs/<category>/<lowercase-kebab-case-title>.md
+```
+
+Examples:
+
+```text
+docs/requirements/sysrs.md
+docs/architecture/sad.md
+docs/verification/swe4-unit-verification-plan.md
+docs/release/release-readiness-go-nogo-record.md
+docs/security/threat-model.md
+```
+
+## 3. Rules
+
+| Rule | Decision |
+|---|---|
+| Product prefix | Do not use `CHANORA_` inside repo file names. |
+| Version in filename | Do not include document version in repo file names. |
+| Filename style | Use lowercase kebab-case. |
+| Directory style | Use lowercase kebab-case. |
+| Version metadata | Keep version inside the Markdown document. |
+| Status metadata | Keep status inside the Markdown document. |
+| Release artifacts | ZIP/package names may include project name and version. |
+
+## 4. Top-Level Documentation Categories
+
+| Directory | Purpose |
+|---|---|
+| `docs/requirements/` | SysRS and SRS |
+| `docs/architecture/` | SysDes, SAD, SDD |
+| `docs/verification/` | SWE.4, SWE.5, SWE.6, SYS.4, verification master plan |
+| `docs/release/` | Release readiness and platform release policy |
+| `docs/security/` | Threat model, secure storage, redaction, dependency/supply-chain, security guidelines |
+| `docs/privacy/` | Privacy policy |
+| `docs/legal/` | Trademark and attribution review |
+| `docs/ui-ux/` | UI/UX, Material 3, design tokens, component catalog, adaptive layout |
+| `docs/i18n/` | Localization architecture |
+| `docs/governance/` | Index, traceability, approval, validation, review, decisions, commit convention |
+| `docs/references/` | External references and research notes |
+
+## 5. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.2 | 2026-05-14 | Replaced release-package naming convention with repository docs naming convention. |
@@ -0,0 +1,90 @@
+# Cfg Document Review Report V0.9.2.2.1
+
+**Document type:** Configuration / Review Report  
+**Version:** 0.9.2  
+**Status:** Baseline Candidate  
+**Language:** English  
+**Product:** Chanora  
+**Repo path:** `docs/governance/document-review-report.md`  ---
+
+## 1. Executive Summary
+
+The normalized package is suitable as a **Baseline Candidate v0.9** for human review.
+
+The package fixes the earlier draft-package issues:
+
+- superseded original filenames are not included in the normalized package;
+- all filenames follow a consistent naming convention;
+- the package contains only baseline-candidate files;
+- non-English text from the earlier draft metadata has been removed;
+- undefined system-design references have been removed from the verification planning package;
+- a naming convention, approval record template, document index, and validation report are included.
+
+The package is still **not Final** until human review and approval are completed.
+
+## 2. Recommended Status
+
+| Decision | Result |
+|---|---|
+| Ready for Final / Approved Baseline | No |
+| Ready for Baseline Candidate review | Yes |
+| Recommended current status | Baseline Candidate v0.9 |
+| Next target status after approval | Final / Approved Baseline v1.0 |
+
+## 3. Positive Review Findings
+
+| Area | Result |
+|---|---|
+| File naming | Normalized |
+| Package scope | Latest baseline-candidate files only |
+| Core hierarchy | `SysRS -> SysDes -> SRS -> SAD -> SDD` |
+| Verification mapping | `SDD -> SWE.4`, `SAD + SDD -> SWE.5`, `SRS -> SWE.6`, `SysDes -> SYS.4` |
+| SRS direct-source rule | SRS does not directly link to system-requirement IDs |
+| SAD direct-source rule | SAD links directly to SRS only |
+| SDD direct-source rule | SDD links directly to SAD only |
+| English-only baseline | Passed automated CJK check |
+| Approval metadata | Approval record template included |
+
+## 4. Remaining Review Actions Before Final
+
+| ID | Severity | Action |
+|---|---|---|
+| REV-ACT-001 | Major | Human stakeholders must review and approve the baseline candidate. |
+| REV-ACT-002 | Major | Review comments must be recorded and dispositioned. |
+| REV-ACT-003 | Major | Open issues must be accepted, deferred, or resolved. |
+| REV-ACT-004 | Major | Approval record must be completed with names, roles, dates, and decisions. |
+| REV-ACT-005 | Major | After approval, promote package and documents from `v0.9.2` to `v1.0`. |
+
+## 5. Finalization Recommendation
+
+Do not call this package Final until the approval record is completed.
+
+Recommended workflow:
+
+```text
+Baseline Candidate v0.9.1
+  -> Human review
+  -> Review comment disposition
+  -> Approval record completed
+  -> Promote to v1.0 Final / Approved Baseline
+```
+
+## 6. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.0 | 2026-05-14 | Review report for normalized baseline candidate package. |
+
+
+## Baseline Candidate 0.9.1 Update
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.1 | 2026-05-14 | Updated baseline after product decision closure: Apple App Store SDK gate uses Xcode 26+ and iOS 26 / iPadOS 26 SDK+ since 2026-04-28, platform baselines and decision traceability propagated across the document set. |
+
+
+## Baseline Candidate 0.9.2 Update
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.2 | 2026-05-14 | Corrected Apple App Store Connect upload gate to 2026-04-28 and checked full-package naming, references, and coverage. |
@@ -0,0 +1,185 @@
+
+# CHANORA_CFG_Git_Commit_Message_Convention_v0.9.2.2.1
+
+**Document type:** Configuration / Engineering Convention  
+**Version:** 0.9.2  
+**Status:** Baseline Candidate  
+**Language:** English  
+**Product:** Chanora  
+**Repo path:** `docs/governance/git-commit-message-convention.md`  ---
+
+## 1. Purpose
+
+This document defines the Git commit message convention for Chanora.
+
+Chanora shall use a Conventional Commits style format with project-specific scopes.
+
+## 2. Commit Format
+
+```text
+<type>(<scope>): <summary>
+```
+
+Optional body:
+
+```text
+<type>(<scope>): <summary>
+
+<body>
+
+Refs: <issue or requirement IDs>
+```
+
+Breaking change format:
+
+```text
+<type>(<scope>)!: <summary>
+
+BREAKING CHANGE: <description>
+```
+
+## 3. Commit Types
+
+| Type | Meaning |
+|---|---|
+| `feat` | New user-visible or system-visible capability |
+| `fix` | Bug fix |
+| `docs` | Documentation-only change |
+| `style` | Formatting change without behavior change |
+| `refactor` | Code restructuring without intended behavior change |
+| `perf` | Performance improvement |
+| `test` | Test addition or test update |
+| `build` | Build system, dependency, packaging, CI artifact change |
+| `ci` | CI/CD pipeline change |
+| `chore` | Maintenance task |
+| `revert` | Revert a previous commit |
+| `release` | Release preparation, version bump, release metadata |
+| `sec` | Security-specific change |
+| `i18n` | Localization, internationalization, Unicode, locale behavior |
+| `ux` | UI/UX behavior or interaction change |
+
+## 4. Recommended Scopes
+
+| Scope | Area |
+|---|---|
+| `flutter` | Flutter app in general |
+| `ui` | UI components and screens |
+| `theme` | Material 3, design tokens, theme extensions |
+| `adaptive` | Adaptive layout and window classes |
+| `voice` | Voice UI or voice control behavior |
+| `audio` | Audio capture, playback, processing, DSP |
+| `core` | Rust Core orchestration |
+| `protocol` | `tsclientlib` integration and protocol adapter |
+| `bridge` | Flutter/Rust bridge and DTOs |
+| `state` | State synchronization, reducers, snapshots, events |
+| `storage` | Local database or non-secret persistence |
+| `secure-storage` | Keychain/Keystore/secret storage |
+| `diagnostics` | Logs, redaction, diagnostic export |
+| `i18n` | Localization, Unicode, locale formatting, RTL |
+| `android` | Android-specific behavior |
+| `ios` | iOS-specific behavior |
+| `windows` | Windows-specific behavior |
+| `macos` | macOS-specific behavior |
+| `linux` | Linux-specific behavior |
+| `build` | Build tooling |
+| `ci` | CI pipeline |
+| `release` | Release packaging and release metadata |
+| `docs` | Documentation |
+| `req` | Requirements documents |
+| `sysdes` | System architectural design |
+| `srs` | Software requirements |
+| `sad` | Software architecture |
+| `sdd` | Software detailed design |
+| `ver` | Verification documents |
+
+## 5. Examples
+
+```text
+feat(voice): add push-to-talk state handling
+```
+
+```text
+fix(protocol): recover channel tree after reconnect snapshot
+```
+
+```text
+docs(sad): add interface catalog and performance view
+```
+
+```text
+i18n(ui): add fallback behavior for missing localization keys
+```
+
+```text
+sec(diagnostics): redact server password from export bundle
+```
+
+```text
+test(audio): add unit tests for audio meter level clamping
+```
+
+```text
+release(android): prepare internal alpha build metadata
+```
+
+## 6. Requirement and Document References
+
+When relevant, the commit body should reference affected IDs.
+
+Allowed examples:
+
+```text
+Refs: SRS-156, SAD-013, SDD-017
+```
+
+```text
+Refs: SWE4-UV-011
+```
+
+Do not force every commit to reference a requirement. Use references when the change affects requirements, architecture, detailed design, verification, release, security, or traceability.
+
+## 7. Pull Request Title Rule
+
+Pull request titles should follow the same format as commit messages when possible:
+
+```text
+feat(voice): add persistent VoiceBar controls
+```
+
+## 8. Branch Naming
+
+Recommended branch format:
+
+```text
+<type>/<short-topic>
+```
+
+Examples:
+
+```text
+feature/voicebar-controls
+fix/reconnect-state-sync
+docs/baseline-candidate-v09
+release/internal-alpha-001
+hotfix/diagnostic-redaction
+```
+
+## 9. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.0 | 2026-05-14 | Initial Git commit message convention for Chanora. |
+
+
+## Baseline Candidate 0.9.1 Update
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.1 | 2026-05-14 | Updated baseline after product decision closure: Apple App Store SDK gate uses Xcode 26+ and iOS 26 / iPadOS 26 SDK+ since 2026-04-28, platform baselines and decision traceability propagated across the document set. |
+
+
+## Baseline Candidate 0.9.2 Update
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.2 | 2026-05-14 | Corrected Apple App Store Connect upload gate to 2026-04-28 and checked full-package naming, references, and coverage. |
@@ -0,0 +1,60 @@
+# Documentation Path Migration Map
+
+**Document type:** Configuration / Migration Map  
+**Version:** 0.9.2  
+**Status:** Baseline Candidate  
+**Language:** English  
+**Product:** Chanora  
+**Repo path:** `docs/governance/path-migration-map.md`
+
+---
+
+## 1. Purpose
+
+This document maps the previous package-style filenames to the new repository documentation paths.
+
+## 2. Migration Map
+
+| Previous package filename | New repo path |
+|---|---|
+| `CHANORA_SAD_ASPICE_SWE2_Software_Architecture_Description_v0.9.2.md` | `docs/architecture/sad.md` |
+| `CHANORA_SDD_ASPICE_SWE3_Software_Detailed_Design_v0.9.2.md` | `docs/architecture/sdd.md` |
+| `CHANORA_SYSDES_ASPICE_SYS3_System_Architectural_Design_v0.9.2.md` | `docs/architecture/sysdes.md` |
+| `CHANORA_CFG_Baseline_Approval_Record_v0.9.2.md` | `docs/governance/baseline-approval-record.md` |
+| `CHANORA_CFG_Baseline_Candidate_Validation_Report_v0.9.2.md` | `docs/governance/baseline-candidate-validation-report.md` |
+| `CHANORA_CFG_Decision_Impact_Assessment_v0.9.2.md` | `docs/governance/decision-impact-assessment.md` |
+| `CHANORA_CFG_Document_Index_v0.9.2.md` | `docs/governance/document-index.md` |
+| `CHANORA_CFG_Document_Naming_Convention_v0.9.2.md` | `docs/governance/document-naming-convention.md` |
+| `CHANORA_CFG_Document_Review_Report_v0.9.2.md` | `docs/governance/document-review-report.md` |
+| `CHANORA_CFG_Git_Commit_Message_Convention_v0.9.2.md` | `docs/governance/git-commit-message-convention.md` |
+| `CHANORA_CFG_Product_Decision_Register_v0.9.2.md` | `docs/governance/product-decision-register.md` |
+| `CHANORA_CFG_Traceability_Matrix_v0.9.2.md` | `docs/governance/traceability-matrix.md` |
+| `CHANORA_I18N_Localization_Architecture_v0.9.2.md` | `docs/i18n/localization-architecture.md` |
+| `CHANORA_LEGAL_Trademark_And_Attribution_Review_v0.9.2.md` | `docs/legal/trademark-and-attribution-review.md` |
+| `CHANORA_PRIV_Privacy_Policy_v0.9.2.md` | `docs/privacy/privacy-policy.md` |
+| `CHANORA_REFS_ASPICE_SWE2_SWE3_Integration_Note_v0.9.2.md` | `docs/references/aspice-swe2-swe3-integration-note.md` |
+| `CHANORA_CFG_External_References_v0.9.2.md` | `docs/references/external-references.md` |
+| `CHANORA_REL_Platform_Release_Policy_v0.9.2.md` | `docs/release/platform-release-policy.md` |
+| `CHANORA_REL_Release_Readiness_Go_NoGo_Record_v0.9.2.md` | `docs/release/release-readiness-go-nogo-record.md` |
+| `CHANORA_SRS_ASPICE_SWE1_Software_Requirements_Specification_v0.9.2.md` | `docs/requirements/srs.md` |
+| `CHANORA_SYSRS_System_Requirements_Specification_v0.9.2.md` | `docs/requirements/sysrs.md` |
+| `CHANORA_SEC_Dependency_And_Supply_Chain_Report_v0.9.2.md` | `docs/security/dependency-and-supply-chain-report.md` |
+| `CHANORA_SEC_Diagnostic_Redaction_Audit_Report_v0.9.2.md` | `docs/security/diagnostic-redaction-audit-report.md` |
+| `CHANORA_SEC_Secure_Storage_Audit_Report_v0.9.2.md` | `docs/security/secure-storage-audit-report.md` |
+| `CHANORA_SEC_Security_Privacy_Legal_Guideline_v0.9.2.md` | `docs/security/security-privacy-legal-guideline.md` |
+| `CHANORA_SEC_Threat_Model_v0.9.2.md` | `docs/security/threat-model.md` |
+| `CHANORA_UIUX_Adaptive_Layout_Platform_Guide_v0.9.2.md` | `docs/ui-ux/adaptive-layout-platform-guide.md` |
+| `CHANORA_UIUX_Material3_Component_Catalog_v0.9.2.md` | `docs/ui-ux/material3-component-catalog.md` |
+| `CHANORA_UIUX_Material3_Design_Tokens_v0.9.2.md` | `docs/ui-ux/material3-design-tokens.md` |
+| `CHANORA_UIUX_Material3_Guideline_v0.9.2.md` | `docs/ui-ux/material3-guideline.md` |
+| `CHANORA_VER_ASPICE_SWE4_Unit_Verification_Plan_v0.9.2.md` | `docs/verification/swe4-unit-verification-plan.md` |
+| `CHANORA_VER_ASPICE_SWE5_Software_Integration_Verification_Plan_v0.9.2.md` | `docs/verification/swe5-software-integration-verification-plan.md` |
+| `CHANORA_VER_ASPICE_SWE6_Software_Verification_Plan_v0.9.2.md` | `docs/verification/swe6-software-verification-plan.md` |
+| `CHANORA_VER_ASPICE_SYS4_System_Integration_Verification_Plan_v0.9.2.md` | `docs/verification/sys4-system-integration-verification-plan.md` |
+| `CHANORA_VER_Master_Plan_v0.9.2.md` | `docs/verification/verification-master-plan.md` |
+
+## 3. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.2 | 2026-05-14 | Initial migration map from package filenames to repo docs paths. |
@@ -0,0 +1,145 @@
+
+# CHANORA_CFG_Product_Decision_Register_v0.9.2.2.1
+
+**Document type:** Configuration / Product Decision Register  
+**Version:** 0.9.2  
+**Status:** Baseline Candidate  
+**Language:** English  
+**Product:** Chanora  
+**Repo path:** `docs/governance/product-decision-register.md`  ---
+
+## 1. Purpose
+
+This document records key product, architecture, release, legal, and engineering decisions that affect Chanora scope, testing, architecture, app store eligibility, and release readiness.
+
+A decision marked **Proposed / Owner Confirmation Required** is a recommended decision that should be confirmed by the owner before Final / Approved Baseline.
+
+## 2. Decision Status Legend
+
+| Status | Meaning |
+|---|---|
+| Proposed / Owner Confirmation Required | Recommended decision; owner must confirm before Final. |
+| Accepted | Confirmed and part of baseline. |
+| Deferred | Not decided for this release; must not block scope if explicitly deferred. |
+| Rejected | Not selected. |
+
+## 3. Key Blocking Decisions
+
+| Decision ID | Decision | Recommended decision | Status | Owner | Why it matters |
+|---|---|---|---|---|---|
+| DEC-001 | Release type | Internal Alpha first, then External Beta, then MVP Public / Store Release | Proposed / Owner Confirmation Required | Product Owner | Controls release gate, verification bar, legal/privacy requirements, and platform scope. |
+| DEC-002 | MVP platform scope | MVP target remains Windows, macOS, Linux, Android, and iOS; first release may be staged by channel/platform | Proposed / Owner Confirmation Required | Product Owner + Engineering Owner | Controls verification matrix, build artifacts, store readiness, and support load. |
+| DEC-003 | Minimum iOS version | iOS 13 minimum for Flutter support baseline; test latest iOS release separately | Proposed / Owner Confirmation Required | Product Owner + iOS Owner | Controls iOS compatibility, test devices, and app store eligibility. |
+| DEC-004 | Minimum Android version | Android API 24 minimum; target API level must satisfy current Google Play policy | Proposed / Owner Confirmation Required | Product Owner + Android Owner | Controls Android device support, runtime permissions, and Play Store eligibility. |
+| DEC-005 | Android target SDK | Target the Google Play-required API level on the upload date; current release gate uses API 35+ unless newer Google policy applies | Proposed / Owner Confirmation Required | Android Owner + Release Manager | Required for new apps and updates submitted to Google Play after the current policy date. |
+| DEC-006 | Multiple server connections in MVP | Not in MVP; support one active server connection per client instance | Proposed / Owner Confirmation Required | Product Owner + Software Architect | Reduces state synchronization, audio routing, UI complexity, and verification scope. |
+| DEC-007 | AEC default state | Enabled by default on platforms/audio backends where supported and stable | Proposed / Owner Confirmation Required | Audio Owner + Product Owner | Affects echo quality, CPU usage, platform behavior, and user experience. |
+| DEC-008 | AGC default state | Enabled by default, with user setting to disable | Proposed / Owner Confirmation Required | Audio Owner + Product Owner | Affects perceived loudness consistency and may affect advanced user preference. |
+| DEC-009 | Noise suppression default state | Enabled by default, with user setting to disable | Proposed / Owner Confirmation Required | Audio Owner + Product Owner | Improves typical voice quality but may affect voice naturalness and CPU usage. |
+| DEC-010 | High-pass filter default state | Enabled by default | Proposed / Owner Confirmation Required | Audio Owner | Removes low-frequency rumble and usually improves speech capture. |
+| DEC-011 | Audio processing implementation path | Use platform-native audio processing first where available; use Rust/WebRTC-style processing as controlled fallback or later architecture option | Proposed / Owner Confirmation Required | Software Architect + Audio Owner | Controls architecture, latency, CPU use, platform compatibility, and testing. |
+| DEC-012 | Official SDK / trademark / licensing review | Public/store release is blocked until legal confirms TeamSpeak non-affiliation wording, trademark usage, OSS licenses, and `tsclientlib` license posture | Proposed / Owner Confirmation Required | Legal / Compliance + Product Owner | Public release risk and store metadata risk. |
+| DEC-013 | Local database choice | Use SQLite or equivalent embedded local database for non-secret local state; secrets remain in platform secure storage | Proposed / Owner Confirmation Required | Software Architect + Storage Owner | Controls storage schema, migrations, backup/delete policy, and portability. |
+| DEC-014 | Bridge choice | Use a stable typed Flutter/Rust bridge with generated or schema-controlled DTOs; default to `flutter_rust_bridge` unless prototype proves a better option | Proposed / Owner Confirmation Required | Software Architect | Controls API stability, maintainability, async event flow, and long-term code generation. |
+| DEC-015 | Product language for MVP | English-only product UI for MVP; i18n-ready architecture; server-provided content preserved and not translated | Proposed / Owner Confirmation Required | Product Owner | Controls localization scope and release schedule. |
+| DEC-016 | Diagnostics upload policy | No automatic upload for MVP; user-initiated local diagnostic export only | Proposed / Owner Confirmation Required | Product Owner + Legal + Security | Controls privacy policy, support workflow, and security review scope. |
+| DEC-017 | Crash reporting | Disabled for MVP unless explicit opt-in provider and privacy policy are approved | Proposed / Owner Confirmation Required | Product Owner + Legal + Security | Avoids privacy/legal complexity before public release. |
+| DEC-018 | Public product name | Chanora | Proposed / Owner Confirmation Required | Product Owner | Branding and legal identity. |
+| DEC-019 | Public non-affiliation statement | Use legal-approved wording; draft: “Chanora is independent and is not affiliated with, endorsed by, sponsored by, or officially associated with TeamSpeak.” | Proposed / Legal Confirmation Required | Legal / Compliance | Required for public release and store metadata. |
+| DEC-021 | Apple App Store submission SDK | Use Xcode 26 or later and the iOS 26 / iPadOS 26 SDK or later for App Store submission on or after 2026-04-28, unless Apple publishes a newer applicable requirement before upload | Proposed / Owner Confirmation Required | iOS Owner + Release Manager | Controls App Store Connect upload eligibility and release pipeline. |
+| DEC-020 | License model | TBD by owner; no public release until license model and OSS obligations are confirmed | Open | Product Owner + Legal | Business and OSS compliance decision. |
+
+## 4. Recommended MVP Defaults
+
+| Area | Recommended MVP default |
+|---|---|
+| Active connections | One active server connection |
+| UI design system | Material 3 + Chanora Design System |
+| Product language | English UI; i18n-ready |
+| Server content | Preserve and display Unicode; do not translate |
+| Diagnostics | Local, user-initiated export only |
+| Telemetry | None |
+| Crash reporting | None unless later approved |
+| Secret storage | Platform secure storage |
+| Non-secret local storage | SQLite or equivalent |
+| Audio processing | Platform-native first; fallback strategy documented |
+| AEC | Enabled by default where supported |
+| AGC | Enabled by default |
+| Noise suppression | Enabled by default |
+| High-pass filter | Enabled by default |
+| Android minimum | API 24 |
+| Android target | API 35 or newer for Google Play policy |
+| iOS minimum | iOS 13 |
+| Bridge | Stable typed Flutter/Rust bridge; default candidate `flutter_rust_bridge` |
+
+## 5. Decision Impact Matrix
+
+| Decision | Affects SysRS | Affects SysDes | Affects SRS | Affects SAD | Affects SDD | Affects Verification | Affects Release |
+|---|---|---|---|---|---|---|---|
+| Minimum iOS / Android versions | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Android target SDK | No | No | Yes | No | No | Yes | Yes |
+| Multiple active connections | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| AEC/AGC/NS/HPF defaults | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Audio implementation path | No if behavior unchanged | Yes | Possibly | Yes | Yes | Yes | Yes |
+| SDK/trademark/legal review | Yes | No | No | No | No | Yes | Yes |
+| SQLite/equivalent choice | Possibly | Yes | Yes | Yes | Yes | Yes | Yes |
+| Bridge choice | No if API behavior unchanged | Yes | Possibly | Yes | Yes | Yes | Yes |
+| Apple App Store SDK gate | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Diagnostics upload policy | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
+| Crash reporting | Yes if included | Yes if included | Yes if included | Yes if included | Yes if included | Yes | Yes |
+
+## 6. Decisions That Must Be Confirmed By You
+
+| Priority | Decision |
+|---|---|
+| P0 | Confirm Apple App Store submission SDK gate: Xcode 26+ and iOS 26 / iPadOS 26 SDK+ for App Store Connect upload on or after 2026-04-28. |
+| P0 | Confirm release type sequence: Internal Alpha first? |
+| P0 | Confirm MVP platform strategy: all platforms as product target, staged release allowed? |
+| P0 | Confirm no automatic telemetry / no automatic diagnostic upload for MVP. |
+| P0 | Confirm one active server connection for MVP. |
+| P0 | Confirm audio processing defaults: AEC, AGC, noise suppression, high-pass filter enabled by default where supported. |
+| P0 | Confirm legal/trademark review required before any public/store release. |
+| P1 | Confirm SQLite/equivalent local DB choice. |
+| P1 | Confirm bridge default candidate. |
+| P1 | Confirm English-only MVP UI with i18n-ready architecture. |
+| P1 | Confirm crash reporting disabled unless later explicitly approved. |
+
+## 7. Open Decision Log
+
+| Decision ID | Owner | Decision | Status | Date | Notes |
+|---|---|---|---|---|---|
+| DEC-001 | Product Owner | Release type sequence | Proposed / Owner Confirmation Required | TBD | Recommended: Internal Alpha first. |
+| DEC-002 | Product Owner / Engineering | MVP platform strategy | Proposed / Owner Confirmation Required | TBD | Recommended: all platforms as target, staged release allowed. |
+| DEC-003 | Product Owner / iOS Owner | Minimum iOS version | Proposed / Owner Confirmation Required | TBD | Recommended: iOS 13. |
+| DEC-004 | Product Owner / Android Owner | Minimum Android version | Proposed / Owner Confirmation Required | TBD | Recommended: Android API 24. |
+| DEC-005 | Android Owner / Release Manager | Android target SDK | Proposed / Owner Confirmation Required | TBD | Recommended: API 35 or newer for Play submission. |
+| DEC-006 | Product Owner / Software Architect | Multiple server connections in MVP | Proposed / Owner Confirmation Required | TBD | Recommended: not in MVP. |
+| DEC-007 | Audio Owner / Product Owner | AEC default | Proposed / Owner Confirmation Required | TBD | Recommended: enabled where supported. |
+| DEC-008 | Audio Owner / Product Owner | AGC default | Proposed / Owner Confirmation Required | TBD | Recommended: enabled. |
+| DEC-009 | Audio Owner / Product Owner | Noise suppression default | Proposed / Owner Confirmation Required | TBD | Recommended: enabled. |
+| DEC-010 | Audio Owner | High-pass filter default | Proposed / Owner Confirmation Required | TBD | Recommended: enabled. |
+| DEC-011 | Software Architect / Audio Owner | Audio processing path | Proposed / Owner Confirmation Required | TBD | Recommended: platform-native first. |
+| DEC-012 | Legal / Compliance | SDK/trademark/licensing review | Proposed / Owner Confirmation Required | TBD | Required before public/store release. |
+| DEC-013 | Software Architect / Storage Owner | Local database | Proposed / Owner Confirmation Required | TBD | Recommended: SQLite or equivalent. |
+| DEC-014 | Software Architect | Bridge choice | Proposed / Owner Confirmation Required | TBD | Recommended: typed bridge; default candidate `flutter_rust_bridge`. |
+| DEC-020 | Product Owner / Legal | License model | Open | TBD | Must be decided before public release. |
+
+## 8. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.0 | 2026-05-14 | Updated decision register with proposed decisions for mobile minimum versions, audio defaults, audio implementation path, legal review, local database, bridge choice, diagnostics policy, and MVP release scope. |
+
+
+## Baseline Candidate 0.9.1 Update
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.1 | 2026-05-14 | Updated baseline after product decision closure: Apple App Store SDK gate uses Xcode 26+ and iOS 26 / iPadOS 26 SDK+ for App Store Connect upload on or after 2026-04-28, platform baselines and decision traceability propagated across the document set. |
+
+
+## Baseline Candidate 0.9.2 Update
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.2 | 2026-05-14 | Corrected Apple App Store Connect upload gate to 2026-04-28 and checked full-package naming, references, and coverage. |
@@ -0,0 +1,75 @@
+# Repo Documentation Format Validation Report
+
+**Document type:** Configuration / Validation Report  
+**Version:** 0.9.2  
+**Status:** Baseline Candidate  
+**Language:** English  
+**Product:** Chanora  
+**Repo path:** `docs/governance/repo-format-validation-report.md`
+
+---
+
+## 1. Package
+
+```text
+chanora-docs-repo-format-v0.9.2.zip
+```
+
+## 2. File Count
+
+| Type | Count |
+|---|---:|
+| Markdown files under docs/ | 37 |
+| README files | 1 |
+
+## 3. Naming Check
+
+| Check | Result |
+|---|---:|
+| Old `CHANORA_*_v*.md` filename references outside migration map | 0 |
+| Old `CHANORA_*_v*.zip` package references outside migration map | 0 |
+| CJK characters found | 0 |
+
+## 4. Defined ID Counts
+
+| ID family | Defined IDs |
+|---|---:|
+| SysRS | 295 |
+| SysDes | 141 |
+| SRS | 194 |
+| SAD | 70 |
+| SDD | 80 |
+
+## 5. Undefined Reference Check
+
+| ID family | Undefined references |
+|---|---:|
+| SysRS | 0 |
+| SysDes | 0 |
+| SRS | 0 |
+| SAD | 0 |
+| SDD | 0 |
+
+## 6. Direct-Layer Rule Check
+
+| Rule | Result |
+|---|---:|
+| SRS direct SysRS references | 0 |
+| SAD direct SysRS references | 0 |
+| SAD direct SysDes references | 0 |
+| SDD direct SysRS references | 0 |
+| SDD direct SysDes references | 0 |
+| SDD direct SRS references | 0 |
+
+## 7. Old Reference Details
+
+| Type | Values |
+|---|---|
+| Old markdown filename references outside migration map | None |
+| Old ZIP filename references outside migration map | None |
+
+## 8. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.2 | 2026-05-14 | Validated repository-format documentation package and internal filename reference updates. |
@@ -0,0 +1,72 @@
+# Repository Bootstrap Plan
+
+**Document type:** Governance / Repository Bootstrap Plan  
+**Version:** 0.1.0  
+**Status:** Draft  
+**Language:** English  
+**Product:** Chanora  
+**Repo path:** `docs/governance/repository-bootstrap-plan.md`
+
+---
+
+## 1. Purpose
+
+This document defines the files and directories that should exist before product implementation begins.
+
+## 2. Bootstrap Scope
+
+This bootstrap package intentionally excludes CI workflow files.
+
+The goal is to establish:
+
+- repository metadata;
+- contributor guidance;
+- security policy;
+- changelog;
+- license placeholder;
+- notice placeholder;
+- editor and ignore rules;
+- local command placeholders;
+- documentation validation script;
+- future scaffold plan.
+
+## 3. Required Root Files
+
+| File | Purpose |
+|---|---|
+| `README.md` | App/project overview |
+| `CONTRIBUTING.md` | Contribution rules |
+| `SECURITY.md` | Security reporting and security gates |
+| `CHANGELOG.md` | Release/change history |
+| `LICENSE` | License placeholder until final license decision |
+| `NOTICE` | Non-affiliation and attribution placeholder |
+| `.editorconfig` | Editor formatting baseline |
+| `.gitignore` | Ignore rules |
+| `.env.example` | Safe local environment template |
+| `justfile` | Local command entrypoint |
+
+## 4. Required Tooling Files
+
+| File | Purpose |
+|---|---|
+| `tools/validate_docs.py` | Local documentation and traceability validation |
+
+## 5. Future Work
+
+CI workflow files should be added later after this bootstrap is committed and the repo structure is accepted.
+
+Recommended later CI files:
+
+```text
+.github/workflows/docs.yml
+.github/workflows/repo-health.yml
+.github/workflows/flutter.yml
+.github/workflows/rust.yml
+.github/workflows/security.yml
+```
+
+## 6. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.1.0 | 2026-05-14 | Initial repository bootstrap plan excluding CI. |
@@ -0,0 +1,190 @@
+
+# Chanora Requirements and Design Traceability Matrix
+
+**Version:** 0.9.2
+**Status:** Baseline Candidate  
+**Language:** English  
+**Product:** Chanora  
+**Lifecycle hierarchy:** `SysRS -> SysDes -> SRS -> SAD -> SDD`
+
+**Repo path:** `docs/governance/traceability-matrix.md`  ---
+
+## 1. Strict Hierarchy
+
+The Chanora documentation hierarchy shall follow this structure strictly:
+
+```text
+SysRS -> SysDes -> SRS -> SAD -> SDD
+```
+
+Direct-source rules:
+
+| Document | Direct upstream source allowed |
+|---|---|
+| SysDes | SysRS |
+| SRS | SysDes only |
+| SAD | SRS only |
+| SDD | SAD only |
+
+Prohibited direct links:
+
+| Document | Prohibited direct source |
+|---|---|
+| SRS | SysRS |
+| SAD | SysRS, SysDes |
+| SDD | SysRS, SysDes, SRS |
+
+## 2. Current Baseline Documents
+
+| Layer | Current baseline | ID range |
+|---|---|---|
+| SysRS | `chanora_SysRS_v0.7.md` | SysRS-001 through SysRS-285 |
+| SysDes | `chanora_SysDes_ASPICE_SYS3_v0.6.md` | SysDes-001 through SysDes-132 |
+| SRS | `chanora_SRS_ASPICE_SWE1_v0.5.md` | SRS-001 through SRS-184 |
+| SAD | `chanora_SAD_ASPICE_SWE2_v0.3.md` | SAD-001 through SAD-060 |
+| SDD | `chanora_SDD_ASPICE_SWE3_v0.3.md` | SDD-001 through SDD-070 |
+
+## 3. Coverage Rules
+
+| Upstream layer | Downstream layer | Coverage rule |
+|---|---|---|
+| SysRS | SysDes | SysRS shall be fully covered by SysDes. |
+| SysDes | SRS | Software-team-related SysDes items shall be fully covered by SRS. |
+| SRS | SAD | SAD shall cover all SRS items. |
+| SAD | SDD | SDD shall cover all SAD items. |
+
+## 4. Baseline Coverage Summary
+
+| Source | Target |
+|---|---|
+| SysRS-001 through SysRS-257 | SysDes-001 through SysDes-110 |
+| SysRS-258 through SysRS-285 | SysDes-111 through SysDes-132 |
+| SysDes-001 through SysDes-110 | SRS-001 through SRS-143 |
+| SysDes-111 through SysDes-132 | SRS-144 through SRS-184 |
+| SRS-001 through SRS-030 | SAD-032, SAD-039, SAD-040, SAD-041 |
+| SRS-031 through SRS-060 | SAD-033, SAD-039, SAD-041 |
+| SRS-061 through SRS-090 | SAD-034, SAD-039, SAD-041 |
+| SRS-091 through SRS-110 | SAD-035 |
+| SRS-111 through SRS-124 | SAD-036, SAD-050 |
+| SRS-125 through SRS-134 | SAD-037, SAD-049 |
+| SRS-135 through SRS-143 | SAD-038 |
+| SRS-144 through SRS-184 | SAD-001 through SAD-031, SAD-039 through SAD-060 |
+| SAD-001 through SAD-007 | SDD-001 through SDD-010 |
+| SAD-008 through SAD-011 | SDD-011 through SDD-015 |
+| SAD-012 through SAD-016 | SDD-016 through SDD-026 |
+| SAD-017 through SAD-019 | SDD-027 through SDD-030 |
+| SAD-020 through SAD-027 | SDD-031 through SDD-041 |
+| SAD-028 through SAD-031 | SDD-042 through SDD-045 |
+| SAD-032 through SAD-038 | SDD-046 through SDD-050 |
+| SAD-039 through SAD-045 | SDD-046 through SDD-050, SDD-055, SDD-056 |
+| SAD-046 through SAD-050 | SDD-051 through SDD-058, SDD-061 |
+| SAD-051 through SAD-060 | SDD-057 through SDD-070 |
+
+## 5. Change Impact Rules
+
+| Changed layer | Required impact analysis |
+|---|---|
+| SysRS | Review SysDes coverage; update SRS only through updated SysDes. |
+| SysDes | Review affected SRS requirements; SRS shall not bypass SysDes. |
+| SRS | Review affected SAD items; SAD shall link only to SRS. |
+| SAD | Review affected SDD items; SDD shall link only to SAD. |
+| SDD | Review implementation, unit construction, and verification evidence. |
+
+## 6. Traceability Verification Checklist
+
+| Check | Expected result |
+|---|---|
+| SysDes references SysRS | Allowed |
+| SRS references SysRS | Not allowed |
+| SRS references SysDes | Required |
+| SAD references SRS | Required |
+| SAD references SysRS or SysDes | Not allowed |
+| SDD references SAD | Required |
+| SDD references SysRS, SysDes, or SRS | Not allowed |
+| Latest SAD ID range | SAD-001 through SAD-060 |
+| Latest SDD ID range | SDD-001 through SDD-070 |
+
+
+## 8. Verification Work Product Traceability
+
+Verification work products are downstream evidence-producing artifacts. They do not change the strict engineering hierarchy.
+
+| Verification document | Direct verification source | Coverage |
+|---|---|---|
+| `chanora_SWE4_Unit_Verification_Plan_v0.1.md` | SDD | SDD-001 through SDD-070 |
+| `chanora_SWE5_Software_Integration_Verification_Plan_v0.1.md` | SAD and SDD | SAD-001 through SAD-060 and SDD-001 through SDD-070 |
+| `chanora_SWE6_Software_Verification_Plan_v0.1.md` | SRS | SRS-001 through SRS-184 |
+| `chanora_SYS4_System_Integration_Verification_Plan_v0.1.md` | SysDes | SysDes-001 through SysDes-132 |
+| `chanora_Verification_Master_Plan_v0.1.md` | Verification planning baseline | SWE.4, SWE.5, SWE.6, SYS.4 |
+
+## 9. Verification Change Impact
+
+| Changed artifact | Verification impact |
+|---|---|
+| SDD | Re-select SWE.4 unit verification measures and affected SWE.5 integration measures. |
+| SAD | Update SDD if needed and re-select affected SWE.5 integration measures. |
+| SRS | Update SAD/SDD if needed and re-select affected SWE.6 verification measures. |
+| SysDes | Update downstream engineering artifacts if needed and re-select affected SYS.4 measures. |
+| SysRS | Update SysDes and downstream artifacts if requirements intent changes. |
+
+
+## 10. Change History
+
+| Version | Date | Description |
+|---|---|---|
+| 0.1.0 | 2026-05-14 | Initial strict traceability matrix. |
+| 0.2.0 | 2026-05-14 | Updated current baseline to SAD v0.3 and SDD v0.3, with SAD-001 through SAD-060 and SDD-001 through SDD-070 coverage. |
+| 0.3.0 | 2026-05-14 | Added downstream verification work product traceability for SWE.4, SWE.5, SWE.6, and SYS.4. |
+
+---
+
+## 11. Product Decision Traceability Addendum
+
+| Source | Target |
+|---|---|
+| SysRS-286 through SysRS-295 | SysDes-133 through SysDes-141 |
+| SysDes-133 through SysDes-141 | SRS-185 through SRS-194 |
+| SRS-185 through SRS-194 | SAD-061 through SAD-070 |
+| SAD-061 through SAD-070 | SDD-071 through SDD-080 |
+| SDD-071 through SDD-080 | SWE.4 addendum SWE4-UV-031 through SWE4-UV-034 |
+| SAD-061 through SAD-070 and SDD-071 through SDD-080 | SWE.5 addendum SWE5-IV-014 |
+| SRS-185 through SRS-194 | SWE.6 addendum SWE6-SV-016 |
+| SysDes-133 through SysDes-141 | SYS.4 addendum SYS4-SIV-015 |
+
+
+## Baseline Candidate 0.9.1 Update
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.1 | 2026-05-14 | Updated baseline after product decision closure: Apple App Store SDK gate uses Xcode 26+ and iOS 26 / iPadOS 26 SDK+ since 2026-04-28, platform baselines and decision traceability propagated across the document set. |
+
+---
+
+## 12. Platform Release Policy Traceability
+
+| Policy document | Covered decisions |
+|---|---|
+| `docs/release/platform-release-policy.md` | iOS runtime target, Apple App Store Connect upload SDK gate, Android runtime target, Google Play target API gate |
+
+The Apple App Store Connect upload gate remains linked through:
+
+```text
+SysRS-287 -> SysDes-134 -> SRS-186 -> SAD-062 -> SDD-072
+```
+
+The corrected effective date is:
+
+```text
+Since 2026-04-28:
+App Store Connect upload builds require Xcode 26 or later
+using iOS 26 / iPadOS 26 SDK or later.
+```
+
+This build-SDK gate is separate from the iOS runtime deployment target.
+
+
+## Baseline Candidate 0.9.2 Update
+
+| Version | Date | Description |
+|---|---|---|
+| 0.9.2 | 2026-05-14 | Corrected Apple App Store Connect upload gate to 2026-04-28 and checked full-package naming, references, and coverage. |