Move the wiki sources to wiki/ and tidy version history statuses

No issue closed: all issues of MIL-001 to MIL-004 are closed.

.gitea/workflows/ci.yml

@@ -0,0 +1,46 @@
+# Continuous integration for the squirrel census project: runs the pytest tests
+# on Python 3.13 for every push and pull request. Read by Gitea Actions (a
+# runner must be registered for the repository). It changes nothing outside the
+# repository and uses no secret. Decision: MIL-001 task "Add CI workflow".
+# Host: Gitea Actions; uses only github.* contexts, so it also runs on GitHub.
+
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+env:
+  PYTHON_VERSION: "3.13"
+  PIP_VERSION: "26.2.1"
+
+concurrency:
+  group: tests-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  pytest:
+    name: Run the tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Check out the code
+        uses: actions/checkout@v4.2.2
+
+      - name: Set up Python
+        uses: actions/setup-python@v5.6.0
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Create the virtual environment and install
+        run: |
+          python -m venv .venv
+          .venv/bin/python -m pip install --upgrade "pip==${PIP_VERSION}"
+          .venv/bin/python -m pip install -e ".[dev]"
+
+      - name: Run the tests
+        run: .venv/bin/python -m pytest

.gitignore

@@ -0,0 +1,35 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Packaging and builds
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Test and tool caches
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# Secrets: personal tokens used only by the maintainer, never by the project
+.env
+
+# Generated source documentation (Doxygen)
+docs/doxygen/
+
+# Editors and operating systems
+.idea/
+.vscode/
+.DS_Store
+Thumbs.db

.yamllint.yml

@@ -0,0 +1,8 @@
+# yamllint configuration for the workflow files in .gitea/workflows/.
+extends: default
+rules:
+  document-start: disable
+  line-length:
+    max: 100
+  truthy:
+    check-keys: false

Doxyfile

@@ -0,0 +1,19 @@
+# Doxygen configuration for the squirrel census project.
+# Build the source documentation with: doxygen Doxyfile
+# Output goes to docs/doxygen/ (ignored by git). Everything not listed here
+# keeps the Doxygen default.
+
+PROJECT_NAME           = "Squirrel Census"
+PROJECT_BRIEF          = "Count squirrels by primary fur colour"
+PROJECT_NUMBER         = 0.1.0
+OUTPUT_DIRECTORY       = docs/doxygen
+INPUT                  = src docs/mainpage.dox
+FILE_PATTERNS          = *.py *.dox
+RECURSIVE              = YES
+OPTIMIZE_OUTPUT_JAVA   = YES
+EXTRACT_ALL            = YES
+GENERATE_HTML          = YES
+GENERATE_LATEX         = NO
+QUIET                  = YES
+WARN_IF_UNDOCUMENTED   = YES
+WARN_AS_ERROR          = NO

README.md

@@ -1,2 +1,142 @@
-# 025-squirrel
+# Squirrel Census
 
+Day 25 of Udemy's *100 Days of Code: The Complete Python Pro Bootcamp*: count the
+squirrels of the 2018 Central Park Squirrel Census by primary fur colour (gray,
+cinnamon, black) and export the counts to `squirrel_count.csv`. Python 3.13 or
+later, no runtime dependencies, with tests and source documentation.
+
+![Program run][img-run]
+
+## Requirements
+
+- Python 3.13 or later (`python --version` on Windows, `python3 --version` on Linux and macOS).
+- `venv`, which ships with Python (on Debian: the `python3-venv` package).
+- The 2018 census file. It is already in the repository under `data/`.
+- Optional: [Doxygen][doxygen] 1.9 or later, only to build the source documentation.
+
+There are no runtime dependencies: the program uses only the Python standard library
+([ADR-0001][adr-0001]). `pytest` is needed only to run the tests.
+
+## Set up
+
+Create a local virtual environment named `.venv` in the project folder, upgrade `pip`
+and install the project with its development tools (pytest, ruff, mypy).
+
+### Windows powershell
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+If PowerShell refuses to run the activation script, allow it for the current session:
+`Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned`.
+
+### Linux debian
+
+```bash
+sudo apt install python3 python3-venv
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+### MacOS
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+On macOS, Python 3.13 can be installed with `brew install python@3.13`.
+
+## Run
+
+With the virtual environment active, run from the project folder:
+
+```bash
+python -m squirrel
+```
+
+The program reads `data/2018_Central_Park_Squirrel_Census_-_Squirrel_Data.csv`, prints
+the colour counts and writes `squirrel_count.csv`:
+
+```text
+Gray: 2473
+Cinnamon: 392
+Black: 103
+```
+
+Use other files by passing them as arguments, `python -m squirrel <census file> <summary file>`.
+If the census file does not exist the program prints a message and exits with status 2.
+
+## Run the tests
+
+```bash
+python -m pytest
+```
+
+![Test run][img-tests]
+
+The tests use small fixture rows; one test also checks the real 2018 census file when
+it is present.
+
+## Continuous integration
+
+The workflow [`.gitea/workflows/ci.yml`][ci] runs for every push to `main` and for every
+pull request. It sets up Python 3.13, creates a `.venv`, upgrades `pip`, installs the
+project with `.[dev]` and runs `python -m pytest`. It uses `github.*` contexts only, so
+it also runs on GitHub Actions.
+
+## Build the source documentation
+
+The source is documented with Doxygen comments and configured by [`Doxyfile`][doxyfile].
+
+```bash
+doxygen Doxyfile
+```
+
+Open `docs/doxygen/html/index.html` in a browser. The output folder is ignored by git.
+
+## Project layout
+
+```text
+.gitea/workflows/ci.yml   continuous integration workflow
+data/                     the 2018 census file
+docs/                     business case, plan, milestones, models, reviews, ADRs
+docs/images/              screenshots used by this README and the wiki
+src/squirrel/             the package: census.py, cli.py, constants.py
+tests/                    pytest tests
+wiki/                     wiki pages in English, Danish (.da) and Bahasa Malaysia (.ms)
+Doxyfile                  Doxygen configuration
+pyproject.toml            project configuration (Python >=3.13, no runtime dependencies)
+squirrel_count.csv        the result of the assignment
+```
+
+The project documents, in reading order: [Business Case][bc], [Stakeholder
+Analysis][sa], [Project Plan][pp], [Use Case][uc], [Domain Model][dm], [ADR-0001][adr-0001].
+The repository also has a wiki in English, Danish and Bahasa Malaysia.
+
+## License
+
+GNU Affero General Public License v3.0 or later. See [LICENSE][license].
+
+---
+
+[img-run]: docs/images/run.png
+[img-tests]: docs/images/tests.png
+[doxygen]: https://www.doxygen.nl/
+[adr-0001]: docs/adr/adr-0001-standard-library-instead-of-pandas.md
+[ci]: .gitea/workflows/ci.yml
+[doxyfile]: Doxyfile
+[bc]: docs/business-case.md
+[sa]: docs/stakeholder-analysis.md
+[pp]: docs/project-plan.md
+[uc]: docs/uc-001/uc.md
+[dm]: docs/domain-model.md
+[license]: LICENSE

docs/adr/adr-0001-standard-library-instead-of-pandas.md

@@ -0,0 +1,56 @@
+# ADR-0001 Use the standard library instead of Pandas
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | ADR-0001 |
+| CrossReference | [BC-001], [SA-001], [MIL-002] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+Allowed Status values: `Proposed`, `Accepted`, `Rejected`, `Deprecated`, `Superseded by ADR-NNNN`.
+
+---
+
+## Context
+
+The day 25 lecture reads the census with `pandas.read_csv`, filters rows by fur colour and builds a DataFrame for the export. The Business Case sets a success criterion of zero third-party runtime packages ([BC-001], criterion 3), and stakeholder S03 wants a repository with no runtime dependencies ([SA-001]). Stakeholder S02 wants the function names of the assignment.
+
+Options evaluated:
+
+1. **Pandas** — closest to the lecture; adds a large runtime dependency (with NumPy) that every visitor must install.
+2. **Standard library** — the `csv` module to read and write and `collections.Counter` to count; no runtime dependency, a few more lines than Pandas.
+3. **Pandas as an optional extra** — two code paths for one result; more code to test and explain.
+
+## Decision
+
+Use the standard library (`csv` and `collections.Counter`) for reading, counting and writing, and keep the lecture's step names (`read_csv`, `count_by_fur_color`, `build_summary`, `write_csv`) as public function names.
+
+## Consequences
+
+**Positive:**
+
+- The project has no runtime dependency; `pip install .` installs only the package ([BC-001] criterion 3).
+- Setup is the same on Windows PowerShell, Linux Debian and macOS, with no compiled wheels.
+- The code is short enough to read in one sitting (S02).
+
+**Negative:**
+
+- The code differs from the lecture's Pandas calls, so a participant comparing line by line sees different statements.
+- A later assignment that needs DataFrame features must introduce Pandas then.
+
+## Affected Artifacts
+
+- [BC-001] — meets success criterion 3 and mitigates the Pandas risk.
+- [SA-001] — resolves the conflict between S01's lecture and S03's expectation.
+- [MIL-002] — the tasks "Read the census file" to "Add the command line entry point" implement it.
+
+---
+
+[BC-001]: ../business-case.md
+[SA-001]: ../stakeholder-analysis.md
+[MIL-002]: ../milestones/mil-002-census-analysis.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/artifact-registry.md

@@ -15,10 +15,15 @@ document of a type. `Primary File` may contain a glob (e.g.
 | SA | Stakeholder Analysis | docs/stakeholder-analysis.md | 002 |
 | PP | Project Plan | docs/project-plan.md | 002 |
 | MIL | Milestone / Gateway | docs/milestones/*.md | 005 |
-| ADR | Architecture Decision Record | docs/adr/adr-NNNN-*.md | 0001 |
-| RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 008 |
+| ADR | Architecture Decision Record | docs/adr/adr-NNNN-*.md | 0002 |
+| RC | SQA Review Record | docs/sqa/reviews/rc-*.md | 025 |
 | DICT | Domain Dictionary | docs/dictionary.md | 002 |
 | TM | Traceability Matrix | docs/sqa/traceability-matrix.md | 002 |
+| UCD | Use Case Diagram | docs/use-case-diagram.md | 002 |
+| US | User Story | docs/user-stories.md | 002 |
+| UC | Use Case | docs/uc-*/uc.md | 002 |
+| DM | Domain Model | docs/domain-model.md | 003 |
+| SSD | System Sequence Diagram | docs/uc-*/ssd.md | 002 |
 
 ## Languages
 

docs/business-case.md

@@ -11,8 +11,8 @@
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
-| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [f1b3c03] |
-
+| 2026-10-13 | Deprecated | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [f1b3c03] |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | CrossReference: added [UCD-001] | [259d017] |
 ---
 
 ## Executive Summary
@@ -134,3 +134,5 @@ Proceed — the scope is small, the risks are mitigated and the result is direct
 ---
 
 [f1b3c03]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/f1b3c034dc3880b7884646b4a4ed28e5f98fbcd3
+[UCD-001]: ./use-case-diagram.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/dictionary.md

@@ -4,15 +4,15 @@
 | Key | Value |
 | --- | --- |
 | ID | DICT-001 |
-| CrossReference | [BC-001], [SA-001] |
+| CrossReference | [BC-001], [SA-001], [DM-002] |
 | Language | en |
 | Domain | it |
 
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
-| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [f1b3c03] |
-
+| 2026-10-13 | Deprecated | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [f1b3c03] |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | CrossReference: added [DM-002] | [259d017] |
 ---
 
 ## Purpose and Scope
@@ -27,7 +27,8 @@ Maps each Product Owner (PO) term of the squirrel census project to its professi
 | Squirrel sighting | en | sighting row | One recorded observation of one squirrel in the census file. | BC, MIL, US, UC, DM | SSD, source code |
 | Fur colour | en | fur_color | The primary fur colour of a squirrel: Gray, Cinnamon or Black. | BC, SA, MIL, US, UC, DM | SSD, source code |
 | Colour count | en | color_count | The number of squirrel sightings with one fur colour. | BC, MIL, US, UC, DM | SSD, source code |
-| Summary | en | summary table | The table of fur colours and their counts that is exported as `squirrel_count.csv`. | BC, MIL, US, UC, DM | SSD, source code |
+| Summary | en | summary table | The table of fur colours and their counts. | BC, MIL, US, UC, DM | SSD, source code |
+| Summary file | en | output file | The file the summary is written to. | BC, MIL, US, UC, DM | SSD, source code |
 | Participant | en | command line user | The course participant who runs the program on the census file. | BC, SA, US, UC | SSD |
 
 ## Rules
@@ -42,3 +43,5 @@ Maps each Product Owner (PO) term of the squirrel census project to its professi
 [BC-001]: ./business-case.md
 [SA-001]: ./stakeholder-analysis.md
 [f1b3c03]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/f1b3c034dc3880b7884646b4a4ed28e5f98fbcd3
+[DM-002]: ./domain-model.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/domain-model.md

@@ -0,0 +1,87 @@
+# Domain Model
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | DM-002 |
+| CrossReference | [UC-001], [UCD-001], [SSD-001], [DICT-001] |
+| Language | en |
+| Domain | it |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Purpose and Scope
+
+Covers: [UC-001] Count squirrels by fur colour.
+
+## Diagram
+
+Concepts, attributes and associations only — no operations.
+
+```plantuml
+@startuml
+class Participant
+class "Census file" as CF {
+  name
+}
+class "Squirrel sighting" as SS
+class "Fur colour" as FC {
+  name
+}
+class "Colour count" as CC {
+  number of sightings
+}
+class Summary
+class "Summary file" as SF {
+  name
+}
+Participant "1" --> "1" CF : supplies
+CF "1" --> "0..*" SS : contains
+SS "0..*" --> "0..1" FC : has
+CC "0..*" --> "1" FC : counts sightings of
+Summary "1" --> "3" CC : consists of
+Summary "1" --> "1" SF : is written to
+Participant "1" --> "0..*" Summary : receives
+@enduml
+```
+
+## Concept Table
+
+| Concept | Definition | Attributes | Source (use case / glossary) |
+| --- | --- | --- | --- |
+| Participant | The course participant who runs the program | - | [UC-001] primary actor |
+| Census file | The file with the 2018 squirrel census | name | [UC-001] step 1, [DICT-001] |
+| Squirrel sighting | One recorded observation of one squirrel | - | [UC-001] step 2, [DICT-001] |
+| Fur colour | The primary fur colour of a squirrel: Gray, Cinnamon or Black | name | [UC-001] step 2, [DICT-001] |
+| Colour count | The number of sightings with one fur colour | number of sightings | [UC-001] step 4, [DICT-001] |
+| Summary | The table of colour counts | - | [UC-001] step 3, [DICT-001] |
+| Summary file | The file the summary is written to | name | [UC-001] step 1, [DICT-001] |
+
+## Association Table
+
+| From | Association (reading direction) | To | Multiplicity |
+| --- | --- | --- | --- |
+| Participant | supplies | Census file | 1 to 1 |
+| Census file | contains | Squirrel sighting | 1 to 0..* |
+| Squirrel sighting | has | Fur colour | 0..* to 0..1 |
+| Colour count | counts sightings of | Fur colour | 0..* to 1 |
+| Summary | consists of | Colour count | 1 to 3 |
+| Summary | is written to | Summary file | 1 to 1 |
+| Participant | receives | Summary | 1 to 0..* |
+
+## Generalizations
+
+None.
+
+---
+
+[UC-001]: ./uc-001/uc.md
+[UCD-001]: ./use-case-diagram.md
+[SSD-001]: ./uc-001/ssd.md
+[DICT-001]: ./dictionary.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/mainpage.dox

@@ -0,0 +1,13 @@
+/**
+@mainpage Squirrel Census
+
+Count the squirrels of the 2018 Central Park Squirrel Census by primary fur colour
+(Gray, Cinnamon, Black) and export the counts to `squirrel_count.csv`.
+
+The steps follow the Udemy "100 Days of Code" lecture of day 25: squirrel.census.read_csv,
+squirrel.census.count_by_fur_color, squirrel.census.build_summary and
+squirrel.census.write_csv. The command line entry point is squirrel.cli.main, started
+with `python -m squirrel`. Every literal is defined once in squirrel.constants.
+
+The package uses only the Python standard library.
+*/

docs/milestones/mil-001-project-scaffold.md

@@ -4,15 +4,15 @@
 | Key | Value |
 | --- | --- |
 | ID | MIL-001 |
-| CrossReference | [BC-001] |
+| CrossReference | [BC-001], [US-001] |
 | Language | en |
 | Domain | it |
 
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
-| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [f1b3c03] |
-
+| 2026-10-13 | Deprecated | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [f1b3c03] |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | CrossReference: added [US-001] | [259d017] |
 ---
 
 ## Purpose
@@ -72,3 +72,5 @@ A branch merged to `main` containing `.gitignore`, `pyproject.toml`, `src/squirr
 
 [BC-001]: ../business-case.md
 [f1b3c03]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/f1b3c034dc3880b7884646b4a4ed28e5f98fbcd3
+[US-001]: ../user-stories.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/milestones/mil-002-census-analysis.md

@@ -4,15 +4,15 @@
 | Key | Value |
 | --- | --- |
 | ID | MIL-002 |
-| CrossReference | [BC-001] |
+| CrossReference | [BC-001], [US-001] |
 | Language | en |
 | Domain | it |
 
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
-| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [f1b3c03] |
-
+| 2026-10-13 | Deprecated | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [f1b3c03] |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | CrossReference: added [US-001] | [259d017] |
 ---
 
 ## Purpose
@@ -74,3 +74,5 @@ A branch merged to `main` containing the user story, use case, system sequence d
 
 [BC-001]: ../business-case.md
 [f1b3c03]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/f1b3c034dc3880b7884646b4a4ed28e5f98fbcd3
+[US-001]: ../user-stories.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/milestones/mil-003-documentation.md

@@ -4,15 +4,15 @@
 | Key | Value |
 | --- | --- |
 | ID | MIL-003 |
-| CrossReference | [BC-001] |
+| CrossReference | [BC-001], [US-001] |
 | Language | en |
 | Domain | it |
 
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
-| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [f1b3c03] |
-
+| 2026-10-13 | Deprecated | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [f1b3c03] |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | CrossReference: added [US-001] | [259d017] |
 ---
 
 ## Purpose
@@ -70,3 +70,5 @@ A branch merged to `main` containing `README.md` with the requested sections, Do
 
 [BC-001]: ../business-case.md
 [f1b3c03]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/f1b3c034dc3880b7884646b4a4ed28e5f98fbcd3
+[US-001]: ../user-stories.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/milestones/mil-004-wiki-publication.md

@@ -4,15 +4,15 @@
 | Key | Value |
 | --- | --- |
 | ID | MIL-004 |
-| CrossReference | [BC-001] |
+| CrossReference | [BC-001], [US-001] |
 | Language | en |
 | Domain | it |
 
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
-| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [f1b3c03] |
-
+| 2026-10-13 | Deprecated | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [f1b3c03] |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | CrossReference: added [US-001] | [259d017] |
 ---
 
 ## Purpose
@@ -70,3 +70,5 @@ Wiki pages `Home`, `Install`, `Usage` and `Description` in English plus `-da` an
 
 [BC-001]: ../business-case.md
 [f1b3c03]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/f1b3c034dc3880b7884646b4a4ed28e5f98fbcd3
+[US-001]: ../user-stories.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/project-plan.md

@@ -4,15 +4,15 @@
 | Key | Value |
 | --- | --- |
 | ID | PP-001 |
-| CrossReference | [BC-001], [SA-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004] |
+| CrossReference | [BC-001], [SA-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004], [US-001] |
 | Language | en |
 | Domain | it |
 
 ## Version History
 | Date | Status | Author | Reviewer | Change | Commit |
 | --- | --- | --- | --- | --- | --- |
-| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | S01 | Initial version | [f1b3c03] |
-
+| 2026-10-13 | Deprecated | Jens Tirsvad Nielsen | S01 | Initial version | [f1b3c03] |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | CrossReference: added [US-001] | [259d017] |
 ---
 
 ## Purpose
@@ -31,10 +31,10 @@ This plan schedules the four phases that deliver the squirrel census assignment:
 
 | Gateway | Document | Window | Decision date | Owner | Stories | Main deliverable | Milestone |
 | --- | --- | --- | --- | --- | --- | --- | --- |
-| G1 Project scaffold and tooling | [MIL-001] | 2026-10-13 to 2026-10-14 | 2026-10-14 | S01 | none | `.gitignore`, `pyproject.toml`, constants, Doxyfile, continuous integration (CI), repository metadata | |
-| G2 Squirrel census analysis | [MIL-002] | 2026-10-14 to 2026-10-15 | 2026-10-15 | S01 | US-001 | Package, tests, census file, `squirrel_count.csv` | |
-| G3 README, source documentation and screenshots | [MIL-003] | 2026-10-15 to 2026-10-16 | 2026-10-16 | S01 | none | README, Doxygen comments, screenshots | |
-| G4 Wiki and publication | [MIL-004] | 2026-10-16 | 2026-10-16 | S01 | none | Wiki in en, da and ms | |
+| G1 Project scaffold and tooling | [MIL-001] | 2026-10-13 to 2026-10-14 | 2026-10-14 | S01 | none | `.gitignore`, `pyproject.toml`, constants, Doxyfile, continuous integration (CI), repository metadata | [Milestone 124][MS-124] |
+| G2 Squirrel census analysis | [MIL-002] | 2026-10-14 to 2026-10-15 | 2026-10-15 | S01 | US-001 | Package, tests, census file, `squirrel_count.csv` | [Milestone 125][MS-125] |
+| G3 README, source documentation and screenshots | [MIL-003] | 2026-10-15 to 2026-10-16 | 2026-10-16 | S01 | none | README, Doxygen comments, screenshots | [Milestone 126][MS-126] |
+| G4 Wiki and publication | [MIL-004] | 2026-10-16 | 2026-10-16 | S01 | none | Wiki in en, da and ms | [Milestone 127][MS-127] |
 
 ```plantuml
 @startgantt
@@ -93,3 +93,9 @@ A No-Go at a gateway stops the later gateways; their dates move by the days the
 [MIL-003]: ./milestones/mil-003-documentation.md
 [MIL-004]: ./milestones/mil-004-wiki-publication.md
 [f1b3c03]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/f1b3c034dc3880b7884646b4a4ed28e5f98fbcd3
+[MS-124]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/milestone/124
+[MS-125]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/milestone/125
+[MS-126]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/milestone/126
+[MS-127]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/milestone/127
+[US-001]: ./user-stories.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-008-python-constants.md

@@ -0,0 +1,60 @@
+# RC Review of the MIL-001 Python files
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-008 |
+| CrossReference | [PY-MIL-001], [QC-PY-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [d71b586] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [PY-MIL-001]
+- Checklist used: [QC-PY-001]
+- Scope: full review of src/squirrel/__init__.py, src/squirrel/constants.py, tests/test_constants.py
+- Language and domain: n/a
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | Packages, modules, functions, variables, classes and constants follow PEP 8 casing (`snake_case`, `PascalCase`, `UPPER_SNAKE`) (Mandatory) | Pass | Module constants are UPPER_SNAKE; test functions snake_case; package `squirrel`. |
+| 2 | Names state purpose in the domain's language; no unexplained abbreviations, no single-letter names outside tiny scopes (Mandatory) | Pass | Names state purpose (FUR_COLOR_COLUMN, DEFAULT_OUTPUT_PATH). |
+| 3 | Code is produced by the project's formatter and passes its linter with no unexplained suppressions (Mandatory) | Pass | `ruff format --check` and `ruff check` (0.17.0, rules E, F, I, UP, B, D) pass with no suppressions. |
+| 4 | Every function and method signature is type-annotated, including `-> None` (Mandatory) | Pass | Every test function is annotated `-> None`; constants carry annotations; `mypy --strict` passes. |
+| 5 | No bare `except:`, no swallowed exceptions; specific exceptions are raised and the cause is kept (`raise ... from`) (Mandatory) | Pass | No exception handling in this module. |
+| 6 | No mutable default arguments and no shadowed builtins (Mandatory) | Pass | No functions with defaults; no builtins shadowed. |
+| 7 | Files, locks and connections are managed with context managers (Mandatory) | Pass | Test reads the source with `pathlib.Path.read_text`, which closes the file. |
+| 8 | Public modules, classes and functions have docstrings that say what, not how (Optional) | Pass | Module and constants have Doxygen `##` blocks and a module docstring. |
+| 9 | Logging uses `logging`, not `print`; no secrets or personal data in log output (Mandatory) | Pass | No `print` and no logging; no secrets. |
+| 10 | Classes and operations trace to the Design Class Diagram they implement; deviations are recorded (Mandatory) | N-A | No classes or operations exist; no DCD yet. |
+| 11 | Tests exist for new behaviour, are named for the behaviour, and do not depend on order or the network (Mandatory) | Pass | 6 tests in `tests/test_constants.py` named for behaviour; no order or network dependence. |
+| 12 | Type checker runs in strict mode without errors; `Any` is justified in a comment (Optional) | Pass | `mypy 2.4.0 --strict`: success, no issues in 3 source files. |
+| 13 | Dependencies are declared and pinned in the project's dependency file, none unused (Optional) | Pass | No runtime dependencies; dev tools pinned exactly in `pyproject.toml`. |
+| 14 | Each piece of knowledge (a business rule, constant, format, validation or query) is defined in one place; code is merged only where it expresses the same knowledge, not where it merely looks alike (Mandatory) | Pass | Each literal is defined once in `constants.py`. |
+| 15 | Imports point inward: business-rule modules import no framework, database, UI or delivery-mechanism code, and there are no import cycles (Mandatory) | Pass | Only `pathlib` is imported; no framework code. |
+| 16 | SOLID holds: a class or module has one reason to change; new behaviour is added by extension, not by editing a type test in several places; subclasses honour the contract of their base; protocols are narrow; high-level code depends on protocols or abstract types and receives its implementations (Mandatory) | Pass | A data module with no types or branching; nothing to violate. |
+
+## Overall Verdict
+
+Go — all Mandatory criteria pass; criterion 10 is not applicable because no class exists.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[PY-MIL-001]: ../../../src/squirrel/constants.py
+[QC-PY-001]: ../../../framework/qc/code/qc-programming-python.md
+[d71b586]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/d71b5863eba3dc29c5a5e09e4ffa087c67565fae

docs/sqa/reviews/rc-009-ci-workflow-yaml.md

@@ -0,0 +1,59 @@
+# RC Review of ci.yml against the YAML checklist
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-009 |
+| CrossReference | [WF-MIL-001], [QC-YML-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [d71b586] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [WF-MIL-001]
+- Checklist used: [QC-YML-001]
+- Scope: full review
+- Language and domain: n/a
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The file parses with a safe YAML loader and has no duplicate keys in any mapping (Mandatory) | Pass | Parsed by yamllint (PyYAML based); no duplicate keys. |
+| 2 | Indentation is 2 spaces everywhere, never tabs; lines end with LF; the file ends with one newline and has no trailing spaces (Mandatory) | Pass | 2 spaces, LF, single trailing newline. |
+| 3 | Passes `yamllint` (or the project's YAML linter) with its configuration committed next to the code and no unexplained `disable` comments (Mandatory) | Pass | `yamllint` with `.yamllint.yml` committed: no errors. |
+| 4 | A scalar that YAML would coerce to another type is quoted: `yes`, `no`, `on`, `off`, `null`, `~`, numbers with a leading zero, versions such as `1.10`, and values that contain `: ` or ` #` (Mandatory) | Pass | Values quoted: "3.13", "26.2.1". |
+| 5 | Only safe, plain types are used: no language-specific tags (`!!python/object`, `!ruby/object`) and no `!include`-style extension unless the consuming tool documents it (Mandatory) | Pass | No tags or extensions. |
+| 6 | No secret is written in the file: no password, token, key or private connection string; a secret is referenced by name and supplied by the consuming tool (Mandatory) | Pass | No secret in the file. |
+| 7 | Embedded program text (shell, Python, SQL, `jq`, and so on) in a value is at most five lines; a longer one is moved to a file of its own, in its own language, and the YAML calls it (Mandatory) | Pass | The longest `run:` block has 3 lines. |
+| 8 | A block of keys or values repeated in the file or across files is defined once (an anchor, a template, an include or a reusable unit the consumer supports) (Mandatory) | Pass | No repeated block. |
+| 9 | Anchors, aliases and merge keys (`&`, `*`, `<<`) are used only where the consuming tool is known to support them (Mandatory) | Pass | No anchors used. |
+| 10 | The file validates against the schema of the consuming tool where one exists, and the schema or tool version is stated (Optional) | Pass | `actionlint 1.7.12` validates the workflow schema. |
+| 11 | A header comment states what the file is for, which tool reads it, and where its decision or design is recorded (Mandatory) | Pass | Header comment states purpose, reader, side effects and decision. |
+| 12 | Key names follow the convention of the consuming tool; one case style is used within the file (kebab-case or snake_case, never mixed) (Mandatory) | Pass | Keys are kebab-case as Gitea Actions expects; env names UPPER_SNAKE. |
+| 13 | Multi-line strings use a block scalar (`\|` or `>`) and state the chomping indicator (`\|-`, `\|+`) where the trailing newline matters (Optional) | Pass | Block scalar `|` used for the 3-line script; trailing newline is not significant. |
+| 14 | The file name is lowercase kebab-case with one extension style (`.yml` or `.yaml`) used throughout the repository (Optional) | Pass | `ci.yml` is lowercase; `.yml` is the only extension used. |
+| 15 | A change is exercised by a check that runs without the real target: a parse and schema test, or a dry run of the consuming tool (Optional) | Pass | yamllint and actionlint run without the real target. |
+
+## Overall Verdict
+
+Go — all Mandatory criteria pass.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[WF-MIL-001]: ../../../.gitea/workflows/ci.yml
+[QC-YML-001]: ../../../framework/qc/code/qc-yaml.md
+[d71b586]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/d71b5863eba3dc29c5a5e09e4ffa087c67565fae

docs/sqa/reviews/rc-010-ci-workflow.md

@@ -0,0 +1,69 @@
+# RC Review of ci.yml against the workflow checklist
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-010 |
+| CrossReference | [WF-MIL-001], [QC-WF-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Proposed | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [d71b586] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [WF-MIL-001]
+- Checklist used: [QC-WF-001]
+- Scope: full review
+- Language and domain: n/a
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The file meets the YAML checklist ([QC-YML-001]) (Mandatory) | Pass | See RC-009: YAML checklist passes. |
+| 2 | The file is in `.gitea/workflows/` or `.github/workflows/` with the extension `.yml` or `.yaml`, and the same workflow does not exist in both directories (Mandatory) | Pass | File is in `.gitea/workflows/` only; no `.github/workflows/` copy. |
+| 3 | The file declares `name`, `on` and `jobs`; `on` lists explicit events and, where it matters, `branches` or `paths` (Mandatory) | Pass | `name`, `on` (push to main, pull_request) and `jobs` are declared. |
+| 4 | A header comment states the purpose, the triggers, the inputs, the secrets it needs, what it changes outside the repository, and the decision or milestone it implements (Mandatory) | Pass | Header comment states purpose, triggers, secrets (none), outside effects (none) and decision. |
+| 5 | Every job and step has a descriptive `name`, unique within its job (Mandatory) | Pass | Every job and step has a unique descriptive `name`. |
+| 6 | The file passes `actionlint` (or the project's workflow validation test) and the tool version is stated (Mandatory) | Pass | `actionlint 1.7.12` reports no findings. |
+| 7 | Every job declares `permissions` explicitly with the least access that works (`contents: read` or none by default); write access only on the job that needs it (Mandatory) | Pass | Workflow-level `permissions: contents: read`. |
+| 8 | Every action used is pinned to a full commit SHA or an exact release tag, never to a branch; a moving major tag (`@v1`) is accepted only for an action published by the same organisation under a stated release policy (Mandatory) | Pass | `actions/checkout@v4.2.2` and `actions/setup-python@v5.6.0` are exact release tags. |
+| 9 | No secret is written in the file; a secret is read as `secrets.NAME`, passed to a step through `env:`, never placed on a command line or echoed (Mandatory) | Pass | No secret is used. |
+| 10 | Untrusted text (`inputs.*`, event fields such as a title, branch name or label, step outputs derived from them) is never interpolated into a `run:` script; it is passed through `env:` and used as a quoted variable (Mandatory) | Pass | No event field or input reaches a `run:` script; `PIP_VERSION` is a workflow `env` value used as a quoted shell variable. |
+| 11 | A trigger that gives a run secrets or a write token on code from a fork or an untrusted branch (`pull_request_target`, `workflow_run`) does not check out or execute that code (Mandatory) | Pass | Trigger is `pull_request`, not `pull_request_target`. |
+| 12 | A workflow that changes state outside the repository (release, tag, publish, sync, deploy) is started by hand or by a protected branch, and a manual run defaults to a dry run with an explicit input to apply (Mandatory) | Pass | The workflow changes nothing outside the repository. |
+| 13 | The token the workflow uses has only the scope the job needs, and where the host's built-in token is enough it is used instead of a personal token (Optional) | Pass | No token is used. |
+| 14 | Every job sets `runs-on` to an explicit label and `timeout-minutes` (Mandatory) | Pass | `runs-on: ubuntu-latest` and `timeout-minutes: 10`. |
+| 15 | `concurrency` is set where two runs would conflict: a check cancels the older run (`cancel-in-progress: true`); a publishing job queues (`cancel-in-progress: false`) (Mandatory) | Pass | Concurrency group per ref with `cancel-in-progress: true`. |
+| 16 | Triggers are filtered (`branches`, `paths`, `types`) so the workflow runs only for the changes it concerns (Mandatory) | Pass | Push filtered to `main`; pull requests run for all branches. |
+| 17 | Tools and dependencies are installed at pinned versions; a version is a workflow input with a default or a value in one place (Mandatory) | Pass | Python version and pip version are workflow `env` values; tool versions are exact in `pyproject.toml`. |
+| 18 | A dependency cache is used where the install is slow enough to matter (Optional) | N-A | Install takes seconds; a cache would add complexity without benefit. |
+| 19 | A failing step names the tool, the file and the reason in its log (annotation or `::error::` line) (Optional) | Pass | pytest names the failing file, test and reason in the log and exits non-zero. |
+| 20 | A `run:` block is within the limit on embedded program text of criterion 7 of [QC-YML-001]; a longer script is a file (`tools/`, or a shared repository fetched at a pinned ref) that the step calls with one command, and the workflow passes its settings through `env:` (Mandatory) | Pass | Longest `run:` block is 3 lines. |
+| 21 | Logic used by more than one workflow or repository is a reusable workflow (`workflow_call`) or a composite action; each input has a `description`, a `type` and a `default` where one is sensible (Mandatory) | N-A | Single workflow; nothing is shared. |
+| 22 | Every workflow feature used is verified on the instance that runs it, and the host and version are recorded; a feature the target hosts differ on is noted in the header (Mandatory) | Fail | Gitea 1.27.3 and runner labels (`ubuntu-latest`) are known, but the run of this workflow stayed `queued` for over 15 minutes on the only runner (busy), so the features are not yet verified on the instance. |
+| 23 | A reusable workflow states, in its header, how a caller pins it and the script it fetches, so the workflow and its script are the same release (Optional) | N-A | Not a reusable workflow. |
+| 24 | A static test of the repository's workflows exists and runs on every pull request: valid YAML, required keys, explicit permissions and runner, no inline script above the limit (Optional) | Fail | No static workflow test exists; actionlint and yamllint were run by hand. |
+
+## Overall Verdict
+
+Go-with-conditions — all Mandatory criteria pass except 22: the workflow has not yet run on the instance. The commands it runs were executed locally (pytest 6 passed, ruff, mypy --strict).
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| Re-check criterion 22 when run 1012 or the next run on main completes; record the result in a delta re-review | S01 | 2026-10-16 |
+| Decide whether to add a static workflow test (criterion 24, optional) | S01 | 2026-10-16 |
+
+---
+
+[WF-MIL-001]: ../../../.gitea/workflows/ci.yml
+[QC-WF-001]: ../../../framework/qc/code/qc-workflow.md
+[d71b586]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/d71b5863eba3dc29c5a5e09e4ffa087c67565fae

docs/sqa/reviews/rc-011-use-case-diagram.md

@@ -0,0 +1,69 @@
+# RC-011 Review of UCD-001
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-011 |
+| CrossReference | [UCD-001], [QC-UCD-001], [QC-LANG-001], [DICT-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [UCD-001]
+- Checklist used: [QC-UCD-001] and [QC-LANG-001]
+- Scope: full review
+- Language and domain: en / it
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | Actors are defined with correct UML stereotypes (e.g. `<<System>>`, `<<Actor>>`) (Mandatory) | Pass | Participant is <<Actor>> and Squirrel Census Program is <<System>> in the Actor Table. |
+| 2 | System boundary is clearly drawn and labeled (Mandatory) | Pass | The diagram draws the labelled rectangle "Squirrel Census Program". |
+| 3 | Include/extend relationships are used correctly per UML 2.5.1, not as generic "uses" arrows (Mandatory) | Pass | No include or extend relationship is used; the Relationships table says why. |
+| 4 | Every actor participates in at least one use case (no orphan actors) (Mandatory) | Pass | The Participant takes part in the only use case. |
+| 5 | Diagram is traceable to a documented stakeholder need (Mandatory) | Pass | The actor table traces the Participant to S01 and S02 of [SA-001]. |
+| 6 | Use case names are verb phrases describing actor goals, not internal system operations (Mandatory) | Pass | The use case "Count squirrels by fur colour" is a verb phrase of the actor goal. |
+| 7 | Diagram is free of implementation detail (e.g. UI widgets, database tables) (Optional) | Pass | No UI or storage detail. |
+| 8 | Actor and use case naming is consistent with corresponding Use Case and User Story documents (Optional) | Pass | Names match [UC-001] and [US-001]. |
+
+## Language and Domain Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The Metadata table has a `Language` row and a `Domain` row, and neither is a placeholder (Mandatory) | Pass | Metadata has `Language | en` and `Domain | it`. |
+| 2 | `Language` is a BCP 47 code and `Domain` is a value from the registry's domain list (Mandatory) | Pass | `en` is a BCP 47 code; `it` is in the registry domain list. |
+| 3 | The content (prose and table cells) is written in the stated language (Mandatory) | Pass | The use case diagram is written in English throughout. |
+| 4 | The register matches the one the registry gives for the artifact type (Mandatory) | Pass | Professional register: actors, stereotypes and goals. |
+| 5 | Domain terms are the PO terms of the domain's dictionary, with no synonyms (Mandatory) | Pass | Terms Participant, Census file, Squirrel sighting, Fur colour, Colour count, Summary and Summary file match [DICT-001]. |
+| 6 | Metadata keys, section headings, IDs and statuses are in English (Mandatory) | Pass | Metadata keys, headings, IDs and statuses are English. |
+| 7 | No translated twin (`<name>.<language>.md`) exists beside the document (Mandatory) | Pass | No translated twin exists in `docs/`. |
+| 8 | A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) | Pass | First version; no earlier accepted language. |
+| 9 | A reviewer competent in the domain, and in the language, has confirmed that the domain terms are used correctly (Mandatory) | Pass | Reviewer reads English and knows the software domain; no second reviewer needed. |
+| 10 | Abbreviations are spelled out on first use, in the stated language (Optional) | Pass | Abbreviations are expanded on first use in the body (S-IDs and artifact IDs are framework labels). |
+
+## Overall Verdict
+
+Go — all Mandatory criteria pass.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[UCD-001]: ../../use-case-diagram.md
+[QC-UCD-001]: ../../../framework/qc/artifacts/qc-use-case-diagram.md
+[QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
+[DICT-001]: ../../dictionary.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-012-user-stories.md

@@ -0,0 +1,68 @@
+# RC-012 Review of US-001
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-012 |
+| CrossReference | [US-001], [QC-US-001], [QC-LANG-001], [DICT-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [US-001]
+- Checklist used: [QC-US-001] and [QC-LANG-001]
+- Scope: full review
+- Language and domain: en / it
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | Follows INVEST criteria (Independent, Negotiable, Valuable, Estimable, Small, Testable) (Mandatory) | Pass | INVEST check line states each property; one story, no exceptions. |
+| 2 | Written in "As a / I want / So that" form (Mandatory) | Pass | US-001.01 uses "As a / I want / so that". |
+| 3 | Clear, testable acceptance criteria are included (Mandatory) | Pass | Four Given/When/Then criteria, including the figures 2473, 392 and 103. |
+| 4 | Traceable to a use case or epic (Mandatory) | Pass | Traces to [UC-001] and [MIL-002]. |
+| 5 | Story is sized to fit within a single iteration (Optional) | Pass | Fits one iteration. |
+| 6 | Story statement avoids technical implementation detail (Optional) | Pass | The story names no technology. |
+| 7 | Role named in the story matches an actor defined in the Use Case Diagram (Mandatory) | Pass | Role "Participant" is the actor of [UCD-001]. |
+
+## Language and Domain Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The Metadata table has a `Language` row and a `Domain` row, and neither is a placeholder (Mandatory) | Pass | Metadata has `Language | en` and `Domain | it`. |
+| 2 | `Language` is a BCP 47 code and `Domain` is a value from the registry's domain list (Mandatory) | Pass | `en` is a BCP 47 code; `it` is in the registry domain list. |
+| 3 | The content (prose and table cells) is written in the stated language (Mandatory) | Pass | The user story is written in English throughout. |
+| 4 | The register matches the one the registry gives for the artifact type (Mandatory) | Pass | Professional register: story form and acceptance criteria. |
+| 5 | Domain terms are the PO terms of the domain's dictionary, with no synonyms (Mandatory) | Pass | Terms Participant, Census file, Squirrel sighting, Fur colour, Colour count, Summary and Summary file match [DICT-001]. |
+| 6 | Metadata keys, section headings, IDs and statuses are in English (Mandatory) | Pass | Metadata keys, headings, IDs and statuses are English. |
+| 7 | No translated twin (`<name>.<language>.md`) exists beside the document (Mandatory) | Pass | No translated twin exists in `docs/`. |
+| 8 | A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) | Pass | First version; no earlier accepted language. |
+| 9 | A reviewer competent in the domain, and in the language, has confirmed that the domain terms are used correctly (Mandatory) | Pass | Reviewer reads English and knows the software domain; no second reviewer needed. |
+| 10 | Abbreviations are spelled out on first use, in the stated language (Optional) | Pass | Abbreviations are expanded on first use in the body (S-IDs and artifact IDs are framework labels). |
+
+## Overall Verdict
+
+Go — all Mandatory criteria pass.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[US-001]: ../../user-stories.md
+[QC-US-001]: ../../../framework/qc/artifacts/qc-user-story.md
+[QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
+[DICT-001]: ../../dictionary.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-013-use-case.md

@@ -0,0 +1,73 @@
+# RC-013 Review of UC-001
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-013 |
+| CrossReference | [UC-001], [QC-UC-001], [QC-LANG-001], [DICT-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [UC-001]
+- Checklist used: [QC-UC-001] and [QC-LANG-001]
+- Scope: full review
+- Language and domain: en / it
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | Consists of a single, concise paragraph summarizing only the primary success scenario (Mandatory) | N-A | The format is Fully Dressed, not Brief. |
+| 2 | Written as an informal multi-paragraph narrative; may mention some alternate flows without formal structure (Mandatory) | N-A | The format is Fully Dressed, not Casual. |
+| 3 | All standard sections are present: actors, preconditions, postconditions, main success scenario, alternative/exception flows (Mandatory) | Pass | Scope, level, primary actor, stakeholders, pre- and postconditions, main scenario, extensions, business rules and open issues are present. |
+| 4 | Preconditions and postconditions are explicitly defined (Mandatory) | Pass | Preconditions and postconditions are stated. |
+| 5 | Primary actor is explicitly stated (Mandatory) | Pass | Primary actor is Participant. |
+| 6 | Stakeholders and their interests are stated (Mandatory) | Pass | S01, S02 and S03 with their interests. |
+| 7 | Main success scenario is written as clear, numbered steps (Mandatory) | Pass | Main success scenario has four numbered steps. |
+| 8 | Alternative/exception flows correctly reference `<<include>>`/`<<extend>>` use cases where relevant, per UML 2.5.1 (Mandatory) | Pass | Extensions 1a and 2a need no include or extend use case. |
+| 9 | Explicit business rules are captured per step where applicable, rather than embedded loosely in narrative text (Optional) | Pass | Business rules are listed per step. |
+| 10 | Naming of actors and use case title is consistent with the corresponding Use Case Diagram and User Stories (Mandatory) | Pass | Title and actor match [UCD-001] and [US-001]. |
+| 11 | Scope/level (e.g. summary, user-goal, subfunction) is explicitly stated (Optional) | Pass | Level is user-goal. |
+| 12 | Use case is written from the actor's goal perspective, free of UI or implementation detail (Mandatory) | Pass | Written from the goal of the participant; no UI detail. |
+
+## Language and Domain Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The Metadata table has a `Language` row and a `Domain` row, and neither is a placeholder (Mandatory) | Pass | Metadata has `Language | en` and `Domain | it`. |
+| 2 | `Language` is a BCP 47 code and `Domain` is a value from the registry's domain list (Mandatory) | Pass | `en` is a BCP 47 code; `it` is in the registry domain list. |
+| 3 | The content (prose and table cells) is written in the stated language (Mandatory) | Pass | The use case is written in English throughout. |
+| 4 | The register matches the one the registry gives for the artifact type (Mandatory) | Pass | Professional register: numbered scenario and business rules. |
+| 5 | Domain terms are the PO terms of the domain's dictionary, with no synonyms (Mandatory) | Pass | Terms Participant, Census file, Squirrel sighting, Fur colour, Colour count, Summary and Summary file match [DICT-001]. |
+| 6 | Metadata keys, section headings, IDs and statuses are in English (Mandatory) | Pass | Metadata keys, headings, IDs and statuses are English. |
+| 7 | No translated twin (`<name>.<language>.md`) exists beside the document (Mandatory) | Pass | No translated twin exists in `docs/`. |
+| 8 | A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) | Pass | First version; no earlier accepted language. |
+| 9 | A reviewer competent in the domain, and in the language, has confirmed that the domain terms are used correctly (Mandatory) | Pass | Reviewer reads English and knows the software domain; no second reviewer needed. |
+| 10 | Abbreviations are spelled out on first use, in the stated language (Optional) | Pass | Abbreviations are expanded on first use in the body (S-IDs and artifact IDs are framework labels). |
+
+## Overall Verdict
+
+Go — all Mandatory criteria pass; criteria 1 and 2 apply to other formats.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[UC-001]: ../../uc-001/uc.md
+[QC-UC-001]: ../../../framework/qc/artifacts/qc-use-case.md
+[QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
+[DICT-001]: ../../dictionary.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-014-ssd.md

@@ -0,0 +1,68 @@
+# RC-014 Review of SSD-001
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-014 |
+| CrossReference | [SSD-001], [QC-SSD-001], [QC-LANG-001], [DICT-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [SSD-001]
+- Checklist used: [QC-SSD-001] and [QC-LANG-001]
+- Scope: full review
+- Language and domain: en / it
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | Input/output messages match the corresponding Use Case's main success scenario step-for-step (Mandatory) | Pass | One message `countByFurColor` covers use case steps 1 to 4; the table justifies it. |
+| 2 | Actor and System are treated strictly as black boxes (system shown as `:System`) (Mandatory) | Pass | Only Participant and :System appear. |
+| 3 | Object creation/destruction of the System instance handled explicitly where relevant (Optional) | Pass | Lifecycle Notes: the instance lives for one run. |
+| 4 | Return values are shown for operations that produce one, using dashed return arrows (Mandatory) | Pass | Dashed return arrows `summary` and `censusFileMissing`. |
+| 5 | Alternate/exceptional flows are represented separately (or explicitly out of scope noted) (Mandatory) | Pass | The alternate flow 1a is the second diagram; 2a is stated to have no message. |
+| 6 | Message names are verb phrases consistent with the use case's system responsibilities (Optional) | Pass | `countByFurColor` is a verb phrase. |
+| 7 | Diagram references the specific Use Case (name and ID) it depicts (Mandatory) | Pass | Source Use Case names Count squirrels by fur colour ([UC-001]). |
+
+## Language and Domain Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The Metadata table has a `Language` row and a `Domain` row, and neither is a placeholder (Mandatory) | Pass | Metadata has `Language | en` and `Domain | it`. |
+| 2 | `Language` is a BCP 47 code and `Domain` is a value from the registry's domain list (Mandatory) | Pass | `en` is a BCP 47 code; `it` is in the registry domain list. |
+| 3 | The content (prose and table cells) is written in the stated language (Mandatory) | Pass | The system sequence diagram is written in English throughout. |
+| 4 | The register matches the one the registry gives for the artifact type (Mandatory) | Pass | Professional register: messages, parameters and returns. |
+| 5 | Domain terms are the PO terms of the domain's dictionary, with no synonyms (Mandatory) | Pass | Terms Participant, Census file, Squirrel sighting, Fur colour, Colour count, Summary and Summary file match [DICT-001]. |
+| 6 | Metadata keys, section headings, IDs and statuses are in English (Mandatory) | Pass | Metadata keys, headings, IDs and statuses are English. |
+| 7 | No translated twin (`<name>.<language>.md`) exists beside the document (Mandatory) | Pass | No translated twin exists in `docs/`. |
+| 8 | A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) | Pass | First version; no earlier accepted language. |
+| 9 | A reviewer competent in the domain, and in the language, has confirmed that the domain terms are used correctly (Mandatory) | Pass | Reviewer reads English and knows the software domain; no second reviewer needed. |
+| 10 | Abbreviations are spelled out on first use, in the stated language (Optional) | Pass | Abbreviations are expanded on first use in the body (S-IDs and artifact IDs are framework labels). |
+
+## Overall Verdict
+
+Go — all Mandatory criteria pass.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[SSD-001]: ../../uc-001/ssd.md
+[QC-SSD-001]: ../../../framework/qc/artifacts/qc-ssd.md
+[QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
+[DICT-001]: ../../dictionary.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-015-dm-use-case.md

@@ -0,0 +1,68 @@
+# RC-015 Review of DM-001
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-015 |
+| CrossReference | [DM-001], [QC-DM-001], [QC-LANG-001], [DICT-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [DM-001]
+- Checklist used: [QC-DM-001] and [QC-LANG-001]
+- Scope: full review
+- Language and domain: en / it
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | Uses ubiquitous/business language throughout; no technical or implementation jargon (e.g. no "table", "class", "pointer") (Mandatory) | Pass | Concepts are business terms from [DICT-001]; no table or class names. |
+| 2 | Multiplicities on associations are correct and complete (e.g. `1..*`, `0..1`) (Mandatory) | Pass | All six associations have multiplicities at both ends. |
+| 3 | No operation/method signatures shown — attributes and associations only (Mandatory) | Pass | Concepts show attributes and associations only. |
+| 4 | Associations are named with an unambiguous reading direction (Optional) | Pass | Association names have a reading direction (supplies, contains, has, counts sightings of, consists of, is written to, receives). |
+| 5 | Generalization/specialization used correctly, reflecting true "is-a" relationships, not misused for code reuse (Optional) | Pass | No generalization is used. |
+| 6 | Every concept traces to a noun phrase found in the use cases or glossary (Mandatory) | Pass | Every concept traces to a noun in [UC-001] or [DICT-001]. |
+| 7 | Attributes are simple domain data (no foreign-key-like references or object pointers modeled as attributes) (Mandatory) | Pass | Attributes are name and number of sightings; relations are associations. |
+
+## Language and Domain Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The Metadata table has a `Language` row and a `Domain` row, and neither is a placeholder (Mandatory) | Pass | Metadata has `Language | en` and `Domain | it`. |
+| 2 | `Language` is a BCP 47 code and `Domain` is a value from the registry's domain list (Mandatory) | Pass | `en` is a BCP 47 code; `it` is in the registry domain list. |
+| 3 | The content (prose and table cells) is written in the stated language (Mandatory) | Pass | The domain model is written in English throughout. |
+| 4 | The register matches the one the registry gives for the artifact type (Mandatory) | Pass | Professional register: concepts and associations. |
+| 5 | Domain terms are the PO terms of the domain's dictionary, with no synonyms (Mandatory) | Pass | Terms Participant, Census file, Squirrel sighting, Fur colour, Colour count, Summary and Summary file match [DICT-001]. |
+| 6 | Metadata keys, section headings, IDs and statuses are in English (Mandatory) | Pass | Metadata keys, headings, IDs and statuses are English. |
+| 7 | No translated twin (`<name>.<language>.md`) exists beside the document (Mandatory) | Pass | No translated twin exists in `docs/`. |
+| 8 | A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) | Pass | First version; no earlier accepted language. |
+| 9 | A reviewer competent in the domain, and in the language, has confirmed that the domain terms are used correctly (Mandatory) | Pass | Reviewer reads English and knows the software domain; no second reviewer needed. |
+| 10 | Abbreviations are spelled out on first use, in the stated language (Optional) | Pass | Abbreviations are expanded on first use in the body (S-IDs and artifact IDs are framework labels). |
+
+## Overall Verdict
+
+Go — all Mandatory criteria pass.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[DM-001]: ../../uc-001/dm.md
+[QC-DM-001]: ../../../framework/qc/artifacts/qc-domain-model.md
+[QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
+[DICT-001]: ../../dictionary.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-016-dm-project.md

@@ -0,0 +1,68 @@
+# RC-016 Review of DM-002
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-016 |
+| CrossReference | [DM-002], [QC-DM-001], [QC-LANG-001], [DICT-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [DM-002]
+- Checklist used: [QC-DM-001] and [QC-LANG-001]
+- Scope: full review
+- Language and domain: en / it
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | Uses ubiquitous/business language throughout; no technical or implementation jargon (e.g. no "table", "class", "pointer") (Mandatory) | Pass | Concepts are business terms from [DICT-001]; no table or class names. |
+| 2 | Multiplicities on associations are correct and complete (e.g. `1..*`, `0..1`) (Mandatory) | Pass | All six associations have multiplicities at both ends. |
+| 3 | No operation/method signatures shown — attributes and associations only (Mandatory) | Pass | Concepts show attributes and associations only. |
+| 4 | Associations are named with an unambiguous reading direction (Optional) | Pass | Association names have a reading direction (supplies, contains, has, counts sightings of, consists of, is written to, receives). |
+| 5 | Generalization/specialization used correctly, reflecting true "is-a" relationships, not misused for code reuse (Optional) | Pass | No generalization is used. |
+| 6 | Every concept traces to a noun phrase found in the use cases or glossary (Mandatory) | Pass | Every concept traces to a noun in [UC-001] or [DICT-001]. |
+| 7 | Attributes are simple domain data (no foreign-key-like references or object pointers modeled as attributes) (Mandatory) | Pass | Attributes are name and number of sightings; relations are associations. |
+
+## Language and Domain Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The Metadata table has a `Language` row and a `Domain` row, and neither is a placeholder (Mandatory) | Pass | Metadata has `Language | en` and `Domain | it`. |
+| 2 | `Language` is a BCP 47 code and `Domain` is a value from the registry's domain list (Mandatory) | Pass | `en` is a BCP 47 code; `it` is in the registry domain list. |
+| 3 | The content (prose and table cells) is written in the stated language (Mandatory) | Pass | The domain model is written in English throughout. |
+| 4 | The register matches the one the registry gives for the artifact type (Mandatory) | Pass | Professional register: concepts and associations. |
+| 5 | Domain terms are the PO terms of the domain's dictionary, with no synonyms (Mandatory) | Pass | Terms Participant, Census file, Squirrel sighting, Fur colour, Colour count, Summary and Summary file match [DICT-001]. |
+| 6 | Metadata keys, section headings, IDs and statuses are in English (Mandatory) | Pass | Metadata keys, headings, IDs and statuses are English. |
+| 7 | No translated twin (`<name>.<language>.md`) exists beside the document (Mandatory) | Pass | No translated twin exists in `docs/`. |
+| 8 | A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) | Pass | First version; no earlier accepted language. |
+| 9 | A reviewer competent in the domain, and in the language, has confirmed that the domain terms are used correctly (Mandatory) | Pass | Reviewer reads English and knows the software domain; no second reviewer needed. |
+| 10 | Abbreviations are spelled out on first use, in the stated language (Optional) | Pass | Abbreviations are expanded on first use in the body (S-IDs and artifact IDs are framework labels). |
+
+## Overall Verdict
+
+Go — all Mandatory criteria pass.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[DM-002]: ../../domain-model.md
+[QC-DM-001]: ../../../framework/qc/artifacts/qc-domain-model.md
+[QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
+[DICT-001]: ../../dictionary.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-017-adr-0001.md

@@ -0,0 +1,55 @@
+# RC-017 Review of ADR-0001
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-017 |
+| CrossReference | [ADR-0001], [QC-ADR-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [ADR-0001]
+- Checklist used: [QC-ADR-001]
+- Scope: full review
+- Language and domain: n/a
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The ID (`ADR-NNNN`, 4-digit) matches the filename number and is unique and sequential (Mandatory) | Pass | ID ADR-0001 matches `adr-0001-...` and is the first ADR. |
+| 2 | Context states the problem, the forces (cost, risk, constraints) and the options evaluated (Mandatory) | Pass | Context states the criterion, the stakeholders S02 and S03 and three options. |
+| 3 | At least two options were considered, or the absence of alternatives is justified (Mandatory) | Pass | Three options were evaluated. |
+| 4 | Decision is stated in one or two unhedged sentences and matches one of the evaluated options (Mandatory) | Pass | The decision is one sentence and equals option 2. |
+| 5 | Consequences list both Positive and Negative outcomes (Mandatory) | Pass | Positive and Negative lists are present. |
+| 6 | Quality-attribute impacts (performance, security, portability, etc.) are named where the decision affects them (Optional) | Pass | Portability across Windows, Debian and macOS is named. |
+| 7 | Affected Artifacts are listed as links, and each is also in CrossReference (Mandatory) | Pass | Affected Artifacts BC-001, SA-001 and MIL-002 are also in CrossReference. |
+| 8 | Status changes are recorded as new Version History rows with a Change summary and Commit link; retained rows are never rewritten (Mandatory) | Pass | First version; row is Proposed then Accepted by this review. |
+| 9 | A superseded or deprecated ADR names its successor, and the successor links back (Optional) | N-A | No superseded ADR. |
+| 10 | Written in business or technical language of the domain, with no unexplained abbreviations (Optional) | Pass | Abbreviations are used as in the Business Case; CSV is spelled by the module name. |
+| 11 | Status is one of `Proposed`, `Accepted`, `Rejected`, `Deprecated` or `Superseded by ADR-NNNN`, and every Version History row uses only these (Mandatory) | Pass | Status values are Proposed and Accepted. |
+
+## Overall Verdict
+
+Go — all Mandatory criteria pass.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[ADR-0001]: ../../adr/adr-0001-standard-library-instead-of-pandas.md
+[QC-ADR-001]: ../../../framework/qc/artifacts/qc-adr.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-018-dictionary-2.md

@@ -0,0 +1,68 @@
+# RC-018 Review of DICT-001
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-018 |
+| CrossReference | [DICT-001], [QC-DICT-001], [QC-LANG-001], [DM-002] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [DICT-001]
+- Checklist used: [QC-DICT-001] and [QC-LANG-001]
+- Scope: full review (second review; conditions of RC-007 closed)
+- Language and domain: en / it
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | Every row has a PO term, its language, an IT term and a definition (Mandatory) | Pass | All seven rows have PO term, language, IT term and definition. |
+| 2 | Each PO term maps to exactly one IT term and the reverse (no synonyms) (Mandatory) | Pass | One IT term per PO term and the reverse; no synonyms. |
+| 3 | Every Domain Model concept has a row, and the Domain Model uses its PO term (Mandatory) | Pass | Every concept of [DM-001] and [DM-002] has a row (Participant, Census file, Squirrel sighting, Fur colour, Colour count, Summary, Summary file) and the model uses the PO terms. |
+| 4 | The Operation Contracts, Sequence Diagrams, Design Class Diagrams and ERD use the IT term, not the PO term (Mandatory) | N-A | The project creates no Operation Contract, Sequence Diagram, Design Class Diagram or ERD; design is the system sequence diagram and source code. |
+| 5 | Definitions are written in the PO language and are one sentence (Optional) | Pass | Definitions are single English sentences. |
+| 6 | "Used as PO term in" and "Used as IT term in" name artifact types that exist in the project (Optional) | Pass | Used-in columns name existing types. |
+| 7 | The dictionary's `Language` and `Domain` rows, and the language of every row, match the PO language and domain in the project registry (Mandatory) | Pass | Language en and Domain it match the registry. |
+
+## Language and Domain Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The Metadata table has a `Language` row and a `Domain` row, and neither is a placeholder (Mandatory) | Pass | Metadata has `Language | en` and `Domain | it`. |
+| 2 | `Language` is a BCP 47 code and `Domain` is a value from the registry's domain list (Mandatory) | Pass | `en` is a BCP 47 code; `it` is in the registry domain list. |
+| 3 | The content (prose and table cells) is written in the stated language (Mandatory) | Pass | The dictionary is written in English throughout. |
+| 4 | The register matches the one the registry gives for the artifact type (Mandatory) | Pass | Professional register: term pairs. |
+| 5 | Domain terms are the PO terms of the domain's dictionary, with no synonyms (Mandatory) | Pass | This document is the dictionary. |
+| 6 | Metadata keys, section headings, IDs and statuses are in English (Mandatory) | Pass | Metadata keys, headings, IDs and statuses are English. |
+| 7 | No translated twin (`<name>.<language>.md`) exists beside the document (Mandatory) | Pass | No translated twin exists in `docs/`. |
+| 8 | A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) | Pass | First version; no earlier accepted language. |
+| 9 | A reviewer competent in the domain, and in the language, has confirmed that the domain terms are used correctly (Mandatory) | Pass | Reviewer reads English and knows the software domain; no second reviewer needed. |
+| 10 | Abbreviations are spelled out on first use, in the stated language (Optional) | Pass | Abbreviations are expanded on first use in the body (S-IDs and artifact IDs are framework labels). |
+
+## Overall Verdict
+
+Go — all Mandatory criteria that can apply pass; criterion 4 has no object in this project. Supersedes the conditions of RC-007.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[DICT-001]: ../../dictionary.md
+[QC-DICT-001]: ../../../framework/qc/artifacts/qc-dictionary.md
+[QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
+[DM-002]: ../../domain-model.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-019-business-case-delta.md

@@ -0,0 +1,56 @@
+# RC-019 Review of BC-001
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-019 |
+| CrossReference | [BC-001], [QC-BC-001], [QC-LANG-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [BC-001]
+- Checklist used: [QC-BC-001] and [QC-LANG-001]
+- Scope: delta re-review of the criterion that cites the changed row and criteria 1, 2, 6, 7, 8 of QC-LANG-001: only the CrossReference row changed (first instance of a candidate type was created); earlier record applies to the rest
+- Language and domain: en / it
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 5 | Stakeholders are cross-referenced to Stakeholder Analysis IDs rather than re-described inline (Mandatory) | Pass | Stakeholders table is unchanged; CrossReference now also lists [UCD-001]. |
+
+## Language and Domain Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The Metadata table has a `Language` row and a `Domain` row, and neither is a placeholder (Mandatory) | Pass | Language and Domain rows unchanged. |
+| 2 | `Language` is a BCP 47 code and `Domain` is a value from the registry's domain list (Mandatory) | Pass | Unchanged. |
+| 6 | Metadata keys, section headings, IDs and statuses are in English (Mandatory) | Pass | Keys, headings and statuses are English. |
+| 7 | No translated twin (`<name>.<language>.md`) exists beside the document (Mandatory) | Pass | No translated twin. |
+| 8 | A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) | Pass | Language unchanged since the accepted version. |
+
+## Overall Verdict
+
+Go — only Metadata (CrossReference) and the Version History changed; the earlier review of the content still holds.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[BC-001]: ../../business-case.md
+[QC-BC-001]: ../../../framework/qc/artifacts/qc-business-case.md
+[QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-020-mil-001-delta.md

@@ -0,0 +1,56 @@
+# RC-020 Review of MIL-001
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-020 |
+| CrossReference | [MIL-001], [QC-MIL-001], [QC-LANG-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [MIL-001]
+- Checklist used: [QC-MIL-001] and [QC-LANG-001]
+- Scope: delta re-review of the criterion that cites the changed row and criteria 1, 2, 6, 7, 8 of QC-LANG-001: only the CrossReference row changed (first instance of a candidate type was created); earlier record applies to the rest
+- Language and domain: en / it
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 4 | Each milestone is traceable to a Business Case objective or KPI (Mandatory) | Pass | Traceability table is unchanged; the CrossReference row now also lists [US-001]. |
+
+## Language and Domain Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The Metadata table has a `Language` row and a `Domain` row, and neither is a placeholder (Mandatory) | Pass | Language and Domain rows unchanged. |
+| 2 | `Language` is a BCP 47 code and `Domain` is a value from the registry's domain list (Mandatory) | Pass | Unchanged. |
+| 6 | Metadata keys, section headings, IDs and statuses are in English (Mandatory) | Pass | Keys, headings and statuses are English. |
+| 7 | No translated twin (`<name>.<language>.md`) exists beside the document (Mandatory) | Pass | No translated twin. |
+| 8 | A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) | Pass | Language unchanged since the accepted version. |
+
+## Overall Verdict
+
+Go — only Metadata (CrossReference) and the Version History changed; the earlier review of the content still holds.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[MIL-001]: ../../milestones/mil-001-project-scaffold.md
+[QC-MIL-001]: ../../../framework/qc/artifacts/qc-milestones-gateways.md
+[QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-021-mil-002-delta.md

@@ -0,0 +1,56 @@
+# RC-021 Review of MIL-002
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-021 |
+| CrossReference | [MIL-002], [QC-MIL-001], [QC-LANG-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [MIL-002]
+- Checklist used: [QC-MIL-001] and [QC-LANG-001]
+- Scope: delta re-review of the criterion that cites the changed row and criteria 1, 2, 6, 7, 8 of QC-LANG-001: only the CrossReference row changed (first instance of a candidate type was created); earlier record applies to the rest
+- Language and domain: en / it
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 4 | Each milestone is traceable to a Business Case objective or KPI (Mandatory) | Pass | Traceability table is unchanged; the CrossReference row now also lists [US-001]. |
+
+## Language and Domain Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The Metadata table has a `Language` row and a `Domain` row, and neither is a placeholder (Mandatory) | Pass | Language and Domain rows unchanged. |
+| 2 | `Language` is a BCP 47 code and `Domain` is a value from the registry's domain list (Mandatory) | Pass | Unchanged. |
+| 6 | Metadata keys, section headings, IDs and statuses are in English (Mandatory) | Pass | Keys, headings and statuses are English. |
+| 7 | No translated twin (`<name>.<language>.md`) exists beside the document (Mandatory) | Pass | No translated twin. |
+| 8 | A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) | Pass | Language unchanged since the accepted version. |
+
+## Overall Verdict
+
+Go — only Metadata (CrossReference) and the Version History changed; the earlier review of the content still holds.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[MIL-002]: ../../milestones/mil-002-census-analysis.md
+[QC-MIL-001]: ../../../framework/qc/artifacts/qc-milestones-gateways.md
+[QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-022-mil-003-delta.md

@@ -0,0 +1,56 @@
+# RC-022 Review of MIL-003
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-022 |
+| CrossReference | [MIL-003], [QC-MIL-001], [QC-LANG-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [MIL-003]
+- Checklist used: [QC-MIL-001] and [QC-LANG-001]
+- Scope: delta re-review of the criterion that cites the changed row and criteria 1, 2, 6, 7, 8 of QC-LANG-001: only the CrossReference row changed (first instance of a candidate type was created); earlier record applies to the rest
+- Language and domain: en / it
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 4 | Each milestone is traceable to a Business Case objective or KPI (Mandatory) | Pass | Traceability table is unchanged; the CrossReference row now also lists [US-001]. |
+
+## Language and Domain Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The Metadata table has a `Language` row and a `Domain` row, and neither is a placeholder (Mandatory) | Pass | Language and Domain rows unchanged. |
+| 2 | `Language` is a BCP 47 code and `Domain` is a value from the registry's domain list (Mandatory) | Pass | Unchanged. |
+| 6 | Metadata keys, section headings, IDs and statuses are in English (Mandatory) | Pass | Keys, headings and statuses are English. |
+| 7 | No translated twin (`<name>.<language>.md`) exists beside the document (Mandatory) | Pass | No translated twin. |
+| 8 | A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) | Pass | Language unchanged since the accepted version. |
+
+## Overall Verdict
+
+Go — only Metadata (CrossReference) and the Version History changed; the earlier review of the content still holds.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[MIL-003]: ../../milestones/mil-003-documentation.md
+[QC-MIL-001]: ../../../framework/qc/artifacts/qc-milestones-gateways.md
+[QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-023-mil-004-delta.md

@@ -0,0 +1,56 @@
+# RC-023 Review of MIL-004
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-023 |
+| CrossReference | [MIL-004], [QC-MIL-001], [QC-LANG-001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [MIL-004]
+- Checklist used: [QC-MIL-001] and [QC-LANG-001]
+- Scope: delta re-review of the criterion that cites the changed row and criteria 1, 2, 6, 7, 8 of QC-LANG-001: only the CrossReference row changed (first instance of a candidate type was created); earlier record applies to the rest
+- Language and domain: en / it
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 4 | Each milestone is traceable to a Business Case objective or KPI (Mandatory) | Pass | Traceability table is unchanged; the CrossReference row now also lists [US-001]. |
+
+## Language and Domain Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | The Metadata table has a `Language` row and a `Domain` row, and neither is a placeholder (Mandatory) | Pass | Language and Domain rows unchanged. |
+| 2 | `Language` is a BCP 47 code and `Domain` is a value from the registry's domain list (Mandatory) | Pass | Unchanged. |
+| 6 | Metadata keys, section headings, IDs and statuses are in English (Mandatory) | Pass | Keys, headings and statuses are English. |
+| 7 | No translated twin (`<name>.<language>.md`) exists beside the document (Mandatory) | Pass | No translated twin. |
+| 8 | A change of language or domain since the previous accepted version has a Version History row and was reviewed again (Mandatory) | Pass | Language unchanged since the accepted version. |
+
+## Overall Verdict
+
+Go — only Metadata (CrossReference) and the Version History changed; the earlier review of the content still holds.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[MIL-004]: ../../milestones/mil-004-wiki-publication.md
+[QC-MIL-001]: ../../../framework/qc/artifacts/qc-milestones-gateways.md
+[QC-LANG-001]: ../../../framework/qc/artifacts/qc-language-domain.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/reviews/rc-024-python-census.md

@@ -0,0 +1,61 @@
+# RC Review of the MIL-002 Python files
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | RC-024 |
+| CrossReference | [PY-MIL-002], [QC-PY-001], [ADR-0001] |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Artifact Under Review
+
+- Instance reviewed: [PY-MIL-002]
+- Checklist used: [QC-PY-001]
+- Scope: full review of src/squirrel/census.py, cli.py, __main__.py, constants.py and tests/
+- Language and domain: n/a
+- Language reviewer: none (the stand-in reviewer reads English and the `it` domain)
+- Mode: autonomous, not independent (reviewer: AI as stand-in for S01)
+
+## Checklist Results
+
+| # | Criterion | Status | Evidence/Notes |
+| --- | --- | --- | --- |
+| 1 | Packages, modules, functions, variables, classes and constants follow PEP 8 casing (`snake_case`, `PascalCase`, `UPPER_SNAKE`) (Mandatory) | Pass | Modules, functions and constants use snake_case and UPPER_SNAKE; helper `_build_parser` has one leading underscore. |
+| 2 | Names state purpose in the domain's language; no unexplained abbreviations, no single-letter names outside tiny scopes (Mandatory) | Pass | Names state purpose (`count_by_fur_color`, `write_csv`); the lecture step names are kept (ADR-0001). |
+| 3 | Code is produced by the project's formatter and passes its linter with no unexplained suppressions (Mandatory) | Pass | `ruff check` and `ruff format --check` (0.17.0) pass with no suppressions. |
+| 4 | Every function and method signature is type-annotated, including `-> None` (Mandatory) | Pass | Every function is annotated including `-> None`; `mypy --strict` passes on 10 files. |
+| 5 | No bare `except:`, no swallowed exceptions; specific exceptions are raised and the cause is kept (`raise ... from`) (Mandatory) | Pass | No exception handling; a missing file is checked with `is_file()` and reported with exit status 2. |
+| 6 | No mutable default arguments and no shadowed builtins (Mandatory) | Pass | The only default argument is the immutable tuple `FUR_COLORS`; no builtin is shadowed. |
+| 7 | Files, locks and connections are managed with context managers (Mandatory) | Pass | Files are opened with `with path.open(...)`. |
+| 8 | Public modules, classes and functions have docstrings that say what, not how (Optional) | Pass | Public modules and functions have Doxygen blocks and docstrings. |
+| 9 | Logging uses `logging`, not `print`; no secrets or personal data in log output (Mandatory) | Pass | `print` is used only for the CLI output to the participant and the stderr error line, not for logging; no secrets. |
+| 10 | Classes and operations trace to the Design Class Diagram they implement; deviations are recorded (Mandatory) | N-A | No class is defined and no Design Class Diagram exists; operations trace to [SSD-001] (`countByFurColor`). |
+| 11 | Tests exist for new behaviour, are named for the behaviour, and do not depend on order or the network (Mandatory) | Pass | 20 tests: unit tests per function, CLI tests, a real-census test and an imports test; none depends on order or network. |
+| 12 | Type checker runs in strict mode without errors; `Any` is justified in a comment (Optional) | Pass | `mypy 2.4.0 --strict` reports no issues. |
+| 13 | Dependencies are declared and pinned in the project's dependency file, none unused (Optional) | Pass | No runtime dependency; dev tools pinned in `pyproject.toml`. |
+| 14 | Each piece of knowledge (a business rule, constant, format, validation or query) is defined in one place; code is merged only where it expresses the same knowledge, not where it merely looks alike (Mandatory) | Pass | All literals live in `constants.py`; each step is defined once. |
+| 15 | Imports point inward: business-rule modules import no framework, database, UI or delivery-mechanism code, and there are no import cycles (Mandatory) | Pass | `census.py` imports only the standard library and constants; `cli.py` imports `census`; no cycle. |
+| 16 | SOLID holds: a class or module has one reason to change; new behaviour is added by extension, not by editing a type test in several places; subclasses honour the contract of their base; protocols are narrow; high-level code depends on protocols or abstract types and receives its implementations (Mandatory) | Pass | `census.py` holds four single-purpose functions; the CLI only wires them. |
+
+## Overall Verdict
+
+Go — all Mandatory criteria pass; criterion 10 is not applicable because no class exists.
+
+## Action Items
+
+| Action | Owner | Due |
+| --- | --- | --- |
+| None | S01 | - |
+
+---
+
+[PY-MIL-002]: ../../../src/squirrel/census.py
+[QC-PY-001]: ../../../framework/qc/code/qc-programming-python.md
+[ADR-0001]: ../../adr/adr-0001-standard-library-instead-of-pandas.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/sqa/traceability-matrix.md

@@ -23,19 +23,29 @@ updated whenever an artifact instance is created or reviewed.
 
 | Artifact Instance | Type | Language | Domain | Upstream (Backward Link) | Downstream (Forward Link) | Last Reviewed (RC-ID) |
 | --- | --- | --- | --- | --- | --- | --- |
-| [BC-001] | Business Case | en | it | - | [SA-001], [PP-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004] | [RC-001] |
+| [BC-001] | Business Case | en | it | - | [SA-001], [PP-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004] | [RC-001], [RC-019] |
 | [SA-001] | Stakeholder Analysis | en | it | [BC-001] | [PP-001] | [RC-002] |
 | [PP-001] | Project Plan | en | it | [BC-001], [SA-001] | [MIL-001], [MIL-002], [MIL-003], [MIL-004] | - (no checklist; accepted by S01 in chat) |
-| [MIL-001] | Milestone | en | it | [BC-001], [PP-001] | - | [RC-003] |
-| [MIL-002] | Milestone | en | it | [BC-001], [PP-001], [MIL-001] | - | [RC-004] |
-| [MIL-003] | Milestone | en | it | [BC-001], [PP-001], [MIL-002] | - | [RC-005] |
-| [MIL-004] | Milestone | en | it | [BC-001], [PP-001], [MIL-003] | - | [RC-006] |
-| [DICT-001] | Domain Dictionary | en | it | [BC-001], [SA-001] | - | [RC-007] |
+| [MIL-001] | Milestone | en | it | [BC-001], [PP-001] | - | [RC-003], [RC-020] |
+| [MIL-002] | Milestone | en | it | [BC-001], [PP-001], [MIL-001] | - | [RC-004], [RC-021] |
+| [MIL-003] | Milestone | en | it | [BC-001], [PP-001], [MIL-002] | - | [RC-005], [RC-022] |
+| [MIL-004] | Milestone | en | it | [BC-001], [PP-001], [MIL-003] | - | [RC-006], [RC-023] |
+| [DICT-001] | Domain Dictionary | en | it | [BC-001], [SA-001] | - | [RC-007], [RC-018] |
+| [UCD-001] | Use Case Diagram | en | it | [SA-001], [BC-001] | [US-001], [UC-001] | [RC-011] |
+| [US-001] | User Story | en | it | [UCD-001], [BC-001], [MIL-002] | [UC-001] | [RC-012] |
+| [UC-001] | Use Case | en | it | [UCD-001], [US-001], [SA-001] | [SSD-001], [DM-001] | [RC-013] |
+| [SSD-001] | System Sequence Diagram | en | it | [UC-001] | - | [RC-014] |
+| [DM-001] | Domain Model | en | it | [UC-001], [DICT-001] | [DM-002] | [RC-015] |
+| [DM-002] | Domain Model | en | it | [DM-001], [DICT-001] | - | [RC-016] |
+| [ADR-0001] | Architecture Decision Record | - | - | [BC-001], [SA-001], [MIL-002] | `src/squirrel/census.py` | [RC-017] |
+| `src/squirrel/census.py`, `cli.py`, `__main__.py`, `tests/` | Python Source Code | - | - | [UC-001], [SSD-001], [ADR-0001] | - | [RC-024] |
+| `src/squirrel/constants.py`, `tests/test_constants.py` | Python Source Code | - | - | [MIL-001] | - | [RC-008] |
+| `.gitea/workflows/ci.yml` | CI Workflow | - | - | [MIL-001] | - | [RC-009], [RC-010] |
 
 ## Coverage Notes
 
 - `-` in Upstream means foundational; in Downstream, nothing is built on it yet; in Last Reviewed, no `RC-*` exists yet.
-- No instance yet of US, UC, SSD, DM, ADR or source code; they are added in MIL-002.
+- No instance of OC, SD, DCD, ERD or KPI; the project creates none (see RC-018).
 
 ---
 
@@ -54,4 +64,28 @@ updated whenever an artifact instance is created or reviewed.
 [RC-005]: ./reviews/rc-005-mil-003-documentation.md
 [RC-006]: ./reviews/rc-006-mil-004-wiki-publication.md
 [RC-007]: ./reviews/rc-007-dictionary.md
+[RC-008]: ./reviews/rc-008-python-constants.md
+[RC-009]: ./reviews/rc-009-ci-workflow-yaml.md
+[RC-010]: ./reviews/rc-010-ci-workflow.md
 [f1b3c03]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/f1b3c034dc3880b7884646b4a4ed28e5f98fbcd3
+[UCD-001]: ../use-case-diagram.md
+[US-001]: ../user-stories.md
+[UC-001]: ../uc-001/uc.md
+[SSD-001]: ../uc-001/ssd.md
+[DM-001]: ../uc-001/dm.md
+[DM-002]: ../domain-model.md
+[ADR-0001]: ../adr/adr-0001-standard-library-instead-of-pandas.md
+[RC-011]: ./reviews/rc-011-use-case-diagram.md
+[RC-012]: ./reviews/rc-012-user-stories.md
+[RC-013]: ./reviews/rc-013-use-case.md
+[RC-014]: ./reviews/rc-014-ssd.md
+[RC-015]: ./reviews/rc-015-dm-use-case.md
+[RC-016]: ./reviews/rc-016-dm-project.md
+[RC-017]: ./reviews/rc-017-adr-0001.md
+[RC-018]: ./reviews/rc-018-dictionary-2.md
+[RC-019]: ./reviews/rc-019-business-case-delta.md
+[RC-020]: ./reviews/rc-020-mil-001-delta.md
+[RC-021]: ./reviews/rc-021-mil-002-delta.md
+[RC-022]: ./reviews/rc-022-mil-003-delta.md
+[RC-023]: ./reviews/rc-023-mil-004-delta.md
+[RC-024]: ./reviews/rc-024-python-census.md

docs/uc-001/dm.md

@@ -0,0 +1,87 @@
+# Domain Model
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | DM-001 |
+| CrossReference | [UC-001], [UCD-001], [SSD-001], [DICT-001] |
+| Language | en |
+| Domain | it |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Purpose and Scope
+
+Covers: [UC-001] Count squirrels by fur colour.
+
+## Diagram
+
+Concepts, attributes and associations only — no operations.
+
+```plantuml
+@startuml
+class Participant
+class "Census file" as CF {
+  name
+}
+class "Squirrel sighting" as SS
+class "Fur colour" as FC {
+  name
+}
+class "Colour count" as CC {
+  number of sightings
+}
+class Summary
+class "Summary file" as SF {
+  name
+}
+Participant "1" --> "1" CF : supplies
+CF "1" --> "0..*" SS : contains
+SS "0..*" --> "0..1" FC : has
+CC "0..*" --> "1" FC : counts sightings of
+Summary "1" --> "3" CC : consists of
+Summary "1" --> "1" SF : is written to
+Participant "1" --> "0..*" Summary : receives
+@enduml
+```
+
+## Concept Table
+
+| Concept | Definition | Attributes | Source (use case / glossary) |
+| --- | --- | --- | --- |
+| Participant | The course participant who runs the program | - | [UC-001] primary actor |
+| Census file | The file with the 2018 squirrel census | name | [UC-001] step 1, [DICT-001] |
+| Squirrel sighting | One recorded observation of one squirrel | - | [UC-001] step 2, [DICT-001] |
+| Fur colour | The primary fur colour of a squirrel: Gray, Cinnamon or Black | name | [UC-001] step 2, [DICT-001] |
+| Colour count | The number of sightings with one fur colour | number of sightings | [UC-001] step 4, [DICT-001] |
+| Summary | The table of colour counts | - | [UC-001] step 3, [DICT-001] |
+| Summary file | The file the summary is written to | name | [UC-001] step 1, [DICT-001] |
+
+## Association Table
+
+| From | Association (reading direction) | To | Multiplicity |
+| --- | --- | --- | --- |
+| Participant | supplies | Census file | 1 to 1 |
+| Census file | contains | Squirrel sighting | 1 to 0..* |
+| Squirrel sighting | has | Fur colour | 0..* to 0..1 |
+| Colour count | counts sightings of | Fur colour | 0..* to 1 |
+| Summary | consists of | Colour count | 1 to 3 |
+| Summary | is written to | Summary file | 1 to 1 |
+| Participant | receives | Summary | 1 to 0..* |
+
+## Generalizations
+
+None.
+
+---
+
+[UC-001]: ./uc.md
+[UCD-001]: ../use-case-diagram.md
+[SSD-001]: ./ssd.md
+[DICT-001]: ../dictionary.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/uc-001/ssd.md

@@ -0,0 +1,58 @@
+# System Sequence Diagram
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | SSD-001 |
+| CrossReference | [UC-001] |
+| Language | en |
+| Domain | it |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Source Use Case
+
+Count squirrels by fur colour ([UC-001]) — scenario: main success scenario. The alternate flow 1a (census file missing) is the second diagram; flow 2a has no system message of its own.
+
+## Diagram
+
+```plantuml
+@startuml
+actor Participant as A
+participant ":System" as S
+A -> S : countByFurColor(censusFile, summaryFile)
+S --> A : summary
+@enduml
+```
+
+```plantuml
+@startuml
+actor Participant as A
+participant ":System" as S
+A -> S : countByFurColor(censusFile, summaryFile)
+S --> A : censusFileMissing
+@enduml
+```
+
+## System Operations
+
+| Step | Message | Parameters | Return | Use case step |
+| --- | --- | --- | --- | --- |
+| 1 | countByFurColor | censusFile, summaryFile | summary (colour count of each fur colour) | 1 (input), 2 (count), 3 (write), 4 (shown to the participant) |
+| 1a | countByFurColor | censusFile, summaryFile | censusFileMissing | 1a |
+
+Steps 2 to 4 of the use case are the work of the system inside one operation: the system receives one message and returns one result, so one message covers steps 1 to 4.
+
+## Lifecycle Notes
+
+The system instance lives for one run of the program; nothing is kept between runs.
+
+---
+
+[UC-001]: ./uc.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/uc-001/uc.md

@@ -0,0 +1,56 @@
+# Use Case (Brief/Casual/Fully Dressed)
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | UC-001 |
+| CrossReference | [UCD-001], [US-001], [SA-001] |
+| Language | en |
+| Domain | it |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+**Format:** Fully Dressed
+
+- **Scope:** Squirrel census program
+- **Level:** user-goal
+- **Primary Actor:** Participant (as named in [UCD-001])
+- **Stakeholders and Interests:**
+  - S01 — a correct summary that matches the dataset and the assignment
+  - S02 — a result that is easy to reproduce from the README
+  - S03 — a program with no runtime dependencies
+- **Preconditions:** The participant has the census file.
+- **Postconditions (success guarantee):** The summary file exists and holds the colour count of Gray, Cinnamon and Black; the participant has seen the counts.
+
+### Main Success Scenario
+
+1. The participant supplies the census file and the name of the summary file.
+2. The system counts the squirrel sightings of each fur colour.
+3. The system writes the summary to the summary file.
+4. The system shows the participant the colour count of each fur colour.
+
+### Extensions / Alternative Flows
+
+- 1a. The census file does not exist: the system tells the participant that the file is missing and ends without writing a summary.
+- 2a. A squirrel sighting has no fur colour: the system leaves it out of every colour count.
+
+### Special Requirements / Business Rules
+
+- Step 2: only the fur colours Gray, Cinnamon and Black are counted; a colour count is the number of sightings with that exact fur colour.
+- Step 3: the summary has one row per counted fur colour, in the order Gray, Cinnamon, Black.
+
+### Open Issues
+
+None.
+
+---
+
+[UCD-001]: ../use-case-diagram.md
+[US-001]: ../user-stories.md
+[SA-001]: ../stakeholder-analysis.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/use-case-diagram.md

@@ -0,0 +1,58 @@
+# Use Case Diagram
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | UCD-001 |
+| CrossReference | [SA-001], [BC-001] |
+| Language | en |
+| Domain | it |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Purpose and Scope
+
+The system is the squirrel census program. The boundary contains the one goal of the assignment: counting squirrels by fur colour from the census file and writing the summary. The participant is the only actor.
+
+## Diagram
+
+```plantuml
+@startuml
+left to right direction
+actor "Participant" as A1
+rectangle "Squirrel Census Program" {
+  usecase "Count squirrels by fur colour" as UC1
+}
+A1 --> UC1
+@enduml
+```
+
+## Actor Table
+
+| Actor | Stereotype | Stakeholder ID (SA) | Goals (use cases) |
+| --- | --- | --- | --- |
+| Participant | <<Actor>> | S01, S02 | Count squirrels by fur colour |
+| Squirrel Census Program | <<System>> | S01 | - |
+
+## Use Case Table
+
+| Use Case | Actor(s) | Goal |
+| --- | --- | --- |
+| Count squirrels by fur colour | Participant | Get the number of squirrels of each fur colour as a summary file |
+
+## Relationships
+
+| From | Relationship (`<<include>>` / `<<extend>>`) | To | Justification |
+| --- | --- | --- | --- |
+| - | - | - | There is only one use case, so there is no include or extend relationship |
+
+---
+
+[SA-001]: ./stakeholder-analysis.md
+[BC-001]: ./business-case.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

docs/user-stories.md

@@ -0,0 +1,52 @@
+# User Story
+
+## Metadata
+| Key | Value |
+| --- | --- |
+| ID | US-001 |
+| CrossReference | [UCD-001], [BC-001], [MIL-001], [MIL-002], [MIL-003], [MIL-004] |
+| Language | en |
+| Domain | it |
+
+## Version History
+| Date | Status | Author | Reviewer | Change | Commit |
+| --- | --- | --- | --- | --- | --- |
+| 2026-10-13 | Accepted | Jens Tirsvad Nielsen | AI as stand-in for S01 | Initial version | [259d017] |
+
+---
+
+## Purpose and Scope
+
+Covers the epic delivered by [MIL-002]: the participant counts squirrels by fur colour. Objective 1 of [BC-001].
+
+## Story List
+
+### US-001.01 — Count squirrels by fur colour
+
+**As a** Participant, **I want** to count the squirrels of each fur colour in the census file, **so that** I get a summary file with the number of gray, cinnamon and black squirrels.
+
+**Acceptance Criteria**
+
+- Given a census file with squirrel sightings, when the participant counts by fur colour, then the summary lists Gray, Cinnamon and Black with the number of sightings of each.
+- Given the 2018 census file, when the participant counts by fur colour, then the summary shows Gray 2473, Cinnamon 392 and Black 103.
+- Given a census file with a sighting that has no fur colour, when the participant counts, then that sighting is in no colour count.
+- Given a census file that does not exist, when the participant counts, then the participant is told that the file is missing and no summary is written.
+
+| Traces to | Size | INVEST exceptions |
+| --- | --- | --- |
+| [UC-001], [MIL-002] | fits one iteration | none |
+
+## INVEST Check
+
+Independent (the only story), Negotiable (file names are defaults), Valuable (delivers the assignment result), Estimable, Small (one iteration), Testable (the criteria are checkable with fixture rows and the 2018 census file). No exceptions.
+
+---
+
+[UCD-001]: ./use-case-diagram.md
+[BC-001]: ./business-case.md
+[MIL-001]: ./milestones/mil-001-project-scaffold.md
+[MIL-002]: ./milestones/mil-002-census-analysis.md
+[MIL-003]: ./milestones/mil-003-documentation.md
+[MIL-004]: ./milestones/mil-004-wiki-publication.md
+[UC-001]: ./uc-001/uc.md
+[259d017]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/commit/259d017ad257059330eb9a8bdbf940c9d082664e

pyproject.toml

@@ -0,0 +1,47 @@
+# Project configuration for the squirrel census assignment (day 25).
+# Read by pip, setuptools and pytest. The decision to use the standard library
+# only is recorded in docs/adr/adr-0001-standard-library-instead-of-pandas.md.
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "squirrel"
+version = "0.1.0"
+description = "Count the squirrels of the 2018 Central Park Squirrel Census by primary fur colour."
+readme = "README.md"
+requires-python = ">=3.13"
+license = "AGPL-3.0-or-later"
+license-files = ["LICENSE"]
+dependencies = []
+classifiers = [
+  "Programming Language :: Python :: 3.13",
+  "Intended Audience :: Education",
+]
+
+[project.optional-dependencies]
+dev = ["pytest==9.1.1", "ruff==0.17.0", "mypy==2.4.0"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 88
+src = ["src", "tests"]
+extend-exclude = ["docs"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "D"]
+ignore = ["D203", "D213"]
+
+[tool.mypy]
+strict = true
+files = ["src", "tests"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["D"]

squirrel_count.csv

@@ -0,0 +1,4 @@
+Fur Color,Count
+Gray,2473
+Cinnamon,392
+Black,103

src/squirrel/__init__.py

@@ -0,0 +1,5 @@
+##
+# @file __init__.py
+# @brief Package root of the squirrel census analysis.
+
+"""Count the squirrels of the 2018 Central Park Squirrel Census by fur colour."""

src/squirrel/__main__.py

@@ -0,0 +1,10 @@
+##
+# @file __main__.py
+# @brief Allows `python -m squirrel` to run the command line.
+
+"""Allows `python -m squirrel` to run the command line."""
+
+from squirrel.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

src/squirrel/census.py

@@ -0,0 +1,63 @@
+##
+# @file census.py
+# @brief Pure steps of the census analysis: read, count, summarise, write.
+
+"""Pure steps of the census analysis: read, count, summarise, write."""
+
+import collections
+import csv
+import pathlib
+from collections.abc import Iterable, Mapping, Sequence
+
+from squirrel.constants import (
+    FILE_ENCODING,
+    FUR_COLOR_COLUMN,
+    FUR_COLORS,
+    SUMMARY_COLUMNS,
+)
+
+
+##
+# @brief Read a CSV file into one dictionary per row, keyed by the header names.
+# @param path Location of the CSV file.
+# @return The rows of the file, in file order.
+def read_csv(path: pathlib.Path) -> list[dict[str, str]]:
+    """Read a CSV file into one dictionary per row, keyed by the header names."""
+    with path.open(encoding=FILE_ENCODING, newline="") as file:
+        return list(csv.DictReader(file))
+
+
+##
+# @brief Count the rows per fur colour; other or blank colours are counted in none.
+# @param rows Census rows, each holding the fur colour column.
+# @param colors Fur colours to count, in the order of the result.
+# @return Count per colour of `colors`, 0 for a colour that does not occur.
+def count_by_fur_color(
+    rows: Iterable[Mapping[str, str]],
+    colors: Sequence[str] = FUR_COLORS,
+) -> dict[str, int]:
+    """Count the rows per fur colour; other or blank colours are counted in none."""
+    seen = collections.Counter(row.get(FUR_COLOR_COLUMN) for row in rows)
+    return {color: seen[color] for color in colors}
+
+
+##
+# @brief Turn the counts into summary rows, keeping the order of the counts.
+# @param counts Count per fur colour.
+# @return One (colour, count) pair per colour.
+def build_summary(counts: Mapping[str, int]) -> list[tuple[str, int]]:
+    """Turn the counts into summary rows, keeping the order of the counts."""
+    return list(counts.items())
+
+
+##
+# @brief Write the summary as a CSV file: the header row, then one row per colour.
+# @param summary Rows to write, as built by `build_summary`.
+# @param path Location of the CSV file; its folder must exist.
+# @return None.
+def write_csv(summary: Sequence[tuple[str, int]], path: pathlib.Path) -> None:
+    """Write the summary as a CSV file: the header row, then one row per colour."""
+    with path.open("w", encoding=FILE_ENCODING, newline="") as file:
+        writer = csv.writer(file)
+        writer.writerow(SUMMARY_COLUMNS)
+        writer.writerows(summary)

src/squirrel/cli.py

@@ -0,0 +1,67 @@
+##
+# @file cli.py
+# @brief Command line entry point: count the squirrels and write the summary.
+
+"""Command line entry point: count the squirrels and write the summary."""
+
+import argparse
+import pathlib
+import sys
+from collections.abc import Sequence
+
+from squirrel import census
+from squirrel.constants import (
+    DEFAULT_INPUT_PATH,
+    DEFAULT_OUTPUT_PATH,
+    EXIT_INPUT_MISSING,
+)
+
+
+##
+# @brief Build the argument parser of the command line.
+# @return The parser with the optional `input` and `output` positionals.
+def _build_parser() -> argparse.ArgumentParser:
+    """Build the argument parser of the command line."""
+    parser = argparse.ArgumentParser(
+        prog="squirrel",
+        description="Count the census squirrels by primary fur colour.",
+    )
+    parser.add_argument(
+        "input",
+        nargs="?",
+        type=pathlib.Path,
+        default=DEFAULT_INPUT_PATH,
+        help="census CSV file (default: %(default)s)",
+    )
+    parser.add_argument(
+        "output",
+        nargs="?",
+        type=pathlib.Path,
+        default=DEFAULT_OUTPUT_PATH,
+        help="summary CSV file to write (default: %(default)s)",
+    )
+    return parser
+
+
+##
+# @brief Run the census analysis from the command line.
+# @param argv Arguments without the program name; `sys.argv` is used when None.
+# @return 0 on success, 2 when the census file does not exist.
+def main(argv: Sequence[str] | None = None) -> int:
+    """Run the census analysis from the command line."""
+    args = _build_parser().parse_args(argv)
+    input_path: pathlib.Path = args.input
+    output_path: pathlib.Path = args.output
+
+    if not input_path.is_file():
+        print(f"Census file not found: {input_path}", file=sys.stderr)
+        return EXIT_INPUT_MISSING
+
+    counts = census.count_by_fur_color(census.read_csv(input_path))
+    summary = census.build_summary(counts)
+    census.write_csv(summary, output_path)
+
+    # print is the intended output here: the counts are shown to the participant.
+    for color, count in summary:
+        print(f"{color}: {count}")
+    return 0

src/squirrel/constants.py

@@ -0,0 +1,30 @@
+##
+# @file constants.py
+# @brief Literals used by the squirrel census analysis, each defined once.
+
+"""Literals used by the squirrel census analysis, each defined once."""
+
+import pathlib
+
+## @brief Default location of the census CSV file, relative to the working directory.
+DEFAULT_INPUT_PATH: pathlib.Path = (
+    pathlib.Path("data") / "2018_Central_Park_Squirrel_Census_-_Squirrel_Data.csv"
+)
+
+## @brief Default location of the summary CSV file that is written.
+DEFAULT_OUTPUT_PATH: pathlib.Path = pathlib.Path("squirrel_count.csv")
+
+## @brief Text encoding of the input and output files.
+FILE_ENCODING: str = "utf-8"
+
+## @brief Name of the census column that holds the primary fur colour.
+FUR_COLOR_COLUMN: str = "Primary Fur Color"
+
+## @brief Fur colours that are counted, in the order they appear in the summary.
+FUR_COLORS: tuple[str, ...] = ("Gray", "Cinnamon", "Black")
+
+## @brief Exit status of the command line when the census file does not exist.
+EXIT_INPUT_MISSING: int = 2
+
+## @brief Header of the summary file: the colour column, then the count column.
+SUMMARY_COLUMNS: tuple[str, str] = ("Fur Color", "Count")

tests/test_census.py

@@ -0,0 +1,89 @@
+"""Tests for the squirrel.census module."""
+
+import pathlib
+
+from squirrel import census
+from squirrel.constants import (
+    FILE_ENCODING,
+    FUR_COLOR_COLUMN,
+    FUR_COLORS,
+    SUMMARY_COLUMNS,
+)
+
+OTHER_COLUMN = "Unique Squirrel ID"
+
+
+def _row(color: str) -> dict[str, str]:
+    return {FUR_COLOR_COLUMN: color}
+
+
+def test_read_csv_returns_one_dict_per_row(tmp_path: pathlib.Path) -> None:
+    path = tmp_path / "census.csv"
+    path.write_text(
+        f"{OTHER_COLUMN},{FUR_COLOR_COLUMN}\n1,{FUR_COLORS[0]}\n2,\n",
+        encoding=FILE_ENCODING,
+    )
+
+    rows = census.read_csv(path)
+
+    assert rows == [
+        {OTHER_COLUMN: "1", FUR_COLOR_COLUMN: FUR_COLORS[0]},
+        {OTHER_COLUMN: "2", FUR_COLOR_COLUMN: ""},
+    ]
+
+
+def test_count_by_fur_color_counts_each_colour() -> None:
+    gray, cinnamon, black = FUR_COLORS
+    rows = [
+        _row(gray),
+        _row(gray),
+        _row(cinnamon),
+        _row(black),
+        _row(black),
+        _row(black),
+    ]
+
+    counts = census.count_by_fur_color(rows)
+
+    assert counts == {gray: 2, cinnamon: 1, black: 3}
+
+
+def test_count_by_fur_color_ignores_blank_and_unknown_colours() -> None:
+    rows = [_row(""), _row("White"), _row(FUR_COLORS[0].lower()), {OTHER_COLUMN: "1"}]
+
+    counts = census.count_by_fur_color(rows)
+
+    assert sum(counts.values()) == 0
+
+
+def test_count_by_fur_color_includes_zero_counts_in_colour_order() -> None:
+    counts = census.count_by_fur_color([_row(FUR_COLORS[1])])
+
+    assert list(counts.items()) == [
+        (FUR_COLORS[0], 0),
+        (FUR_COLORS[1], 1),
+        (FUR_COLORS[2], 0),
+    ]
+
+
+def test_count_by_fur_color_uses_given_colours() -> None:
+    counts = census.count_by_fur_color([_row("White"), _row("White")], colors=["White"])
+
+    assert counts == {"White": 2}
+
+
+def test_build_summary_keeps_order_of_counts() -> None:
+    counts = {"Black": 3, "Gray": 1, "Cinnamon": 2}
+
+    assert census.build_summary(counts) == [("Black", 3), ("Gray", 1), ("Cinnamon", 2)]
+
+
+def test_write_csv_writes_header_then_rows(tmp_path: pathlib.Path) -> None:
+    path = tmp_path / "summary.csv"
+    summary = [(FUR_COLORS[0], 5), (FUR_COLORS[1], 0)]
+
+    census.write_csv(summary, path)
+
+    header = ",".join(SUMMARY_COLUMNS)
+    expected = f"{header}\n{FUR_COLORS[0]},5\n{FUR_COLORS[1]},0\n"
+    assert path.read_bytes().decode(FILE_ENCODING).replace("\r\n", "\n") == expected

tests/test_cli.py

@@ -0,0 +1,67 @@
+"""Tests for the squirrel.cli module."""
+
+import pathlib
+
+import pytest
+
+from squirrel import cli
+from squirrel.constants import (
+    FILE_ENCODING,
+    FUR_COLOR_COLUMN,
+    FUR_COLORS,
+    SUMMARY_COLUMNS,
+)
+
+
+def _write_census(path: pathlib.Path) -> None:
+    gray, cinnamon, _black = FUR_COLORS
+    lines = [FUR_COLOR_COLUMN, gray, gray, cinnamon, ""]
+    path.write_text("\n".join(lines) + "\n", encoding=FILE_ENCODING)
+
+
+def test_main_writes_summary_file_and_returns_zero(tmp_path: pathlib.Path) -> None:
+    census_path = tmp_path / "census.csv"
+    summary_path = tmp_path / "summary.csv"
+    _write_census(census_path)
+
+    status = cli.main([str(census_path), str(summary_path)])
+
+    assert status == 0
+    lines = summary_path.read_text(encoding=FILE_ENCODING).splitlines()
+    assert lines == [
+        ",".join(SUMMARY_COLUMNS),
+        f"{FUR_COLORS[0]},2",
+        f"{FUR_COLORS[1]},1",
+        f"{FUR_COLORS[2]},0",
+    ]
+
+
+def test_main_prints_one_line_per_colour(
+    tmp_path: pathlib.Path, capsys: pytest.CaptureFixture[str]
+) -> None:
+    census_path = tmp_path / "census.csv"
+    _write_census(census_path)
+
+    cli.main([str(census_path), str(tmp_path / "summary.csv")])
+
+    out_lines = capsys.readouterr().out.splitlines()
+    assert out_lines == [
+        f"{FUR_COLORS[0]}: 2",
+        f"{FUR_COLORS[1]}: 1",
+        f"{FUR_COLORS[2]}: 0",
+    ]
+
+
+def test_main_returns_2_and_writes_nothing_when_census_missing(
+    tmp_path: pathlib.Path, capsys: pytest.CaptureFixture[str]
+) -> None:
+    missing = tmp_path / "missing.csv"
+    summary_path = tmp_path / "summary.csv"
+
+    status = cli.main([str(missing), str(summary_path)])
+
+    captured = capsys.readouterr()
+    assert status == 2
+    assert not summary_path.exists()
+    assert captured.err.strip() == f"Census file not found: {missing}"
+    assert captured.out == ""

tests/test_constants.py

@@ -0,0 +1,47 @@
+"""Tests for the squirrel.constants module."""
+
+import ast
+import pathlib
+import sys
+
+from squirrel import constants
+
+
+def test_fur_colors_are_gray_cinnamon_black_in_order() -> None:
+    assert constants.FUR_COLORS == ("Gray", "Cinnamon", "Black")
+
+
+def test_summary_columns_are_fur_color_and_count() -> None:
+    assert constants.SUMMARY_COLUMNS == ("Fur Color", "Count")
+
+
+def test_default_input_path_has_census_file_name() -> None:
+    assert constants.DEFAULT_INPUT_PATH.name == (
+        "2018_Central_Park_Squirrel_Census_-_Squirrel_Data.csv"
+    )
+    assert constants.DEFAULT_INPUT_PATH.parent == pathlib.Path("data")
+
+
+def test_default_output_path_has_summary_file_name() -> None:
+    assert constants.DEFAULT_OUTPUT_PATH == pathlib.Path("squirrel_count.csv")
+
+
+def test_file_encoding_and_column_name_values() -> None:
+    assert constants.FILE_ENCODING == "utf-8"
+    assert constants.FUR_COLOR_COLUMN == "Primary Fur Color"
+
+
+def test_exit_input_missing_is_2() -> None:
+    assert constants.EXIT_INPUT_MISSING == 2
+
+
+def test_module_imports_only_standard_library() -> None:
+    source = pathlib.Path(constants.__file__).read_text(encoding="utf-8")
+    imported: set[str] = set()
+    for node in ast.walk(ast.parse(source)):
+        if isinstance(node, ast.Import):
+            imported.update(alias.name.split(".")[0] for alias in node.names)
+        elif isinstance(node, ast.ImportFrom) and node.module is not None:
+            imported.add(node.module.split(".")[0])
+
+    assert imported <= sys.stdlib_module_names

tests/test_imports.py

@@ -0,0 +1,40 @@
+"""Every module of the package imports only the standard library or itself."""
+
+import ast
+import pathlib
+import sys
+
+import squirrel
+
+PACKAGE_NAME = squirrel.__name__
+PACKAGE_DIR = pathlib.Path(squirrel.__file__).parent
+ALLOWED = sys.stdlib_module_names | {PACKAGE_NAME}
+
+
+def _imported_top_level_names(source: str) -> set[str]:
+    imported: set[str] = set()
+    for node in ast.walk(ast.parse(source)):
+        if isinstance(node, ast.Import):
+            imported.update(alias.name.split(".")[0] for alias in node.names)
+        elif (
+            isinstance(node, ast.ImportFrom)
+            and node.module is not None
+            and node.level == 0
+        ):
+            imported.add(node.module.split(".")[0])
+    return imported
+
+
+def test_package_has_modules_to_check() -> None:
+    assert list(PACKAGE_DIR.glob("*.py"))
+
+
+def test_every_module_imports_only_standard_library_or_squirrel() -> None:
+    offenders: dict[str, set[str]] = {}
+    for module in PACKAGE_DIR.rglob("*.py"):
+        source = module.read_text(encoding="utf-8")
+        foreign = _imported_top_level_names(source) - ALLOWED
+        if foreign:
+            offenders[module.name] = foreign
+
+    assert offenders == {}

tests/test_real_census.py

@@ -0,0 +1,21 @@
+"""Check the counts of the real 2018 Central Park census file, when present."""
+
+import pathlib
+
+import pytest
+
+from squirrel import census
+from squirrel.constants import DEFAULT_INPUT_PATH, FUR_COLORS
+
+REPO_ROOT = pathlib.Path(__file__).parents[1]
+
+
+def test_real_census_counts_match_published_figures() -> None:
+    path = REPO_ROOT / DEFAULT_INPUT_PATH
+    if not path.is_file():
+        pytest.skip(f"census file not present: {path}")
+
+    counts = census.count_by_fur_color(census.read_csv(path))
+
+    gray, cinnamon, black = FUR_COLORS
+    assert counts == {gray: 2473, cinnamon: 392, black: 103}

wiki/Description.da.md

@@ -0,0 +1,32 @@
+🌐 [English](Description) · **Dansk** · [Bahasa Melayu](Description.ms)
+
+# Beskrivelse
+
+## Hvad programmet gør
+
+Programmet følger lektionens trin:
+
+1. `read_csv` læser optællingsfilen.
+2. `count_by_fur_color` tæller observationerne af Gray, Cinnamon og Black.
+3. `build_summary` gør tallene til rækkerne i en opsummering.
+4. `write_csv` skriver opsummeringen til `squirrel_count.csv`.
+
+På optællingsfilen fra 2018 er resultatet Gray 2473, Cinnamon 392 og Black 103. Observationer uden pelsfarve tælles ikke med i nogen af dem.
+
+## Hvorfor ikke Pandas
+
+Lektionen bruger Pandas. Dette projekt bruger kun Pythons standardbibliotek (`csv` og `collections.Counter`), så der ikke er noget at installere for at køre det. Beslutningen er beskrevet som ADR-0001 i repositoryet.
+
+## Opbygning
+
+| Sti | Indhold |
+| --- | --- |
+| `src/squirrel/census.py` | De fire trin ovenfor |
+| `src/squirrel/cli.py` | Kommandolinjen, `python -m squirrel` |
+| `src/squirrel/constants.py` | Alle konstanter, defineret ét sted |
+| `tests/` | pytest-testene |
+| `docs/` | Business case, plan, modeller, reviewposter |
+
+## Kvalitet
+
+Alle dokumenter og al kode er gennemgået mod tjeklisterne i SQA- og QC-frameworket i autonom tilstand: reviewer er en AI-stedfortræder, så reviewene er ikke uafhængige.

wiki/Description.md

@@ -0,0 +1,32 @@
+🌐 **English** · [Dansk](Description.da) · [Bahasa Melayu](Description.ms)
+
+# Description
+
+## What it does
+
+The program follows the steps of the lecture:
+
+1. `read_csv` reads the census file.
+2. `count_by_fur_color` counts the sightings of Gray, Cinnamon and Black.
+3. `build_summary` turns the counts into the rows of a summary.
+4. `write_csv` writes the summary to `squirrel_count.csv`.
+
+On the 2018 census file the result is Gray 2473, Cinnamon 392 and Black 103. Sightings without a fur colour are counted in none of them.
+
+## Why no Pandas
+
+The lecture uses Pandas. This project uses only the Python standard library (`csv` and `collections.Counter`) so that there is nothing to install to run it. The decision is recorded as ADR-0001 in the repository.
+
+## Layout
+
+| Path | Content |
+| --- | --- |
+| `src/squirrel/census.py` | The four steps above |
+| `src/squirrel/cli.py` | The command line, `python -m squirrel` |
+| `src/squirrel/constants.py` | Every literal, defined once |
+| `tests/` | The pytest tests |
+| `docs/` | Business case, plan, models, review records |
+
+## Quality
+
+Every document and every piece of code was reviewed against the checklists of the SQA and QC framework, in autonomous mode: the reviewer is an AI stand-in, so the reviews are not independent.

wiki/Description.ms.md

@@ -0,0 +1,32 @@
+🌐 [English](Description) · [Dansk](Description.da) · **Bahasa Melayu**
+
+# Penerangan
+
+## Apa yang dilakukan program
+
+Program mengikut langkah dalam pelajaran:
+
+1. `read_csv` membaca fail banci.
+2. `count_by_fur_color` mengira pemerhatian Gray, Cinnamon dan Black.
+3. `build_summary` menukar kiraan kepada baris ringkasan.
+4. `write_csv` menulis ringkasan ke `squirrel_count.csv`.
+
+Pada fail banci 2018 hasilnya ialah Gray 2473, Cinnamon 392 dan Black 103. Pemerhatian tanpa warna bulu tidak dikira dalam mana-mana satu.
+
+## Mengapa tidak menggunakan Pandas
+
+Pelajaran menggunakan Pandas. Projek ini hanya menggunakan pustaka standard Python (`csv` dan `collections.Counter`) supaya tiada apa-apa untuk dipasang bagi menjalankannya. Keputusan itu direkodkan sebagai ADR-0001 dalam repositori.
+
+## Susun atur
+
+| Laluan | Kandungan |
+| --- | --- |
+| `src/squirrel/census.py` | Empat langkah di atas |
+| `src/squirrel/cli.py` | Baris perintah, `python -m squirrel` |
+| `src/squirrel/constants.py` | Semua pemalar, ditakrif sekali |
+| `tests/` | Ujian pytest |
+| `docs/` | Kes perniagaan, pelan, model, rekod semakan |
+
+## Kualiti
+
+Setiap dokumen dan kod disemak berdasarkan senarai semak rangka kerja SQA dan QC dalam mod autonomi: penyemak ialah pengganti AI, jadi semakan itu tidak bebas.

wiki/Home.da.md

@@ -0,0 +1,15 @@
+🌐 [English](Home) · **Dansk** · [Bahasa Melayu](Home.ms)
+
+# Egern-optælling
+
+Dag 25 i Udemys *100 Days of Code: The Complete Python Pro Bootcamp*: tæl egernene i Central Parks egern-optælling fra 2018 efter primær pelsfarve (grå, kanel, sort) og eksportér tallene til `squirrel_count.csv`.
+
+![Programkørsel](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/raw/branch/main/docs/images/run.png)
+
+| Side | Læs den, når du vil |
+| --- | --- |
+| [Installation](Install.da) | Oprette et `.venv` og installere projektet på Windows PowerShell, Linux Debian eller macOS |
+| [Brug](Usage.da) | Køre programmet og testene |
+| [Beskrivelse](Description.da) | Forstå hvordan koden er bygget, og hvorfor den ikke har kørselsafhængigheder |
+
+Koden, testene og projektdokumenterne ligger i [repositoryet](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel).

wiki/Home.md

@@ -0,0 +1,15 @@
+🌐 **English** · [Dansk](Home.da) · [Bahasa Melayu](Home.ms)
+
+# Squirrel Census
+
+Day 25 of Udemy's *100 Days of Code: The Complete Python Pro Bootcamp*: count the squirrels of the 2018 Central Park Squirrel Census by primary fur colour (gray, cinnamon, black) and export the counts to `squirrel_count.csv`.
+
+![Program run](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/raw/branch/main/docs/images/run.png)
+
+| Page | Read it when you want to |
+| --- | --- |
+| [Install](Install) | Create a `.venv` and install the project on Windows PowerShell, Linux Debian or macOS |
+| [Usage](Usage) | Run the program and the tests |
+| [Description](Description) | Understand how the code is built and why it has no runtime dependencies |
+
+The code, the tests and the project documents are in the [repository](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel).

wiki/Home.ms.md

@@ -0,0 +1,15 @@
+🌐 [English](Home) · [Dansk](Home.da) · **Bahasa Melayu**
+
+# Banci Tupai
+
+Hari ke-25 dalam *100 Days of Code: The Complete Python Pro Bootcamp* Udemy: kira tupai dalam Banci Tupai Central Park 2018 mengikut warna bulu utama (kelabu, kayu manis, hitam) dan eksport kiraan ke `squirrel_count.csv`.
+
+![Larian program](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/raw/branch/main/docs/images/run.png)
+
+| Halaman | Baca apabila anda mahu |
+| --- | --- |
+| [Pemasangan](Install.ms) | Mencipta `.venv` dan memasang projek di Windows PowerShell, Linux Debian atau macOS |
+| [Penggunaan](Usage.ms) | Menjalankan program dan ujian |
+| [Penerangan](Description.ms) | Memahami cara kod dibina dan sebab ia tiada kebergantungan masa jalan |
+
+Kod, ujian dan dokumen projek berada dalam [repositori](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel).

wiki/Install.da.md

@@ -0,0 +1,35 @@
+🌐 [English](Install) · **Dansk** · [Bahasa Melayu](Install.ms)
+
+# Installation
+
+Projektet kræver **Python 3.13 eller nyere**. Det har ingen kørselsafhængigheder; `pytest`, `ruff` og `mypy` er udviklingsværktøjer.
+
+## Windows PowerShell
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+## Linux Debian
+
+```bash
+sudo apt install python3 python3-venv
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+## macOS
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+Næste: [Brug](Usage.da).

wiki/Install.md

@@ -0,0 +1,35 @@
+🌐 **English** · [Dansk](Install.da) · [Bahasa Melayu](Install.ms)
+
+# Install
+
+The project needs **Python 3.13 or later**. It has no runtime dependencies; `pytest`, `ruff` and `mypy` are development tools.
+
+## Windows PowerShell
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+## Linux Debian
+
+```bash
+sudo apt install python3 python3-venv
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+## macOS
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+Next: [Usage](Usage).

wiki/Install.ms.md

@@ -0,0 +1,35 @@
+🌐 [English](Install) · [Dansk](Install.da) · **Bahasa Melayu**
+
+# Pemasangan
+
+Projek ini memerlukan **Python 3.13 atau lebih baharu**. Ia tiada kebergantungan masa jalan; `pytest`, `ruff` dan `mypy` ialah alat pembangunan.
+
+## Windows PowerShell
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\Activate.ps1
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+## Linux Debian
+
+```bash
+sudo apt install python3 python3-venv
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+## macOS
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e ".[dev]"
+```
+
+Seterusnya: [Penggunaan](Usage.ms).

wiki/Usage.da.md

@@ -0,0 +1,33 @@
+🌐 [English](Usage) · **Dansk** · [Bahasa Melayu](Usage.ms)
+
+# Brug
+
+## Kør programmet
+
+Med det virtuelle miljø aktivt, fra projektmappen:
+
+```bash
+python -m squirrel
+```
+
+Programmet læser `data/2018_Central_Park_Squirrel_Census_-_Squirrel_Data.csv`, skriver tallene for hver pelsfarve og gemmer `squirrel_count.csv`.
+
+![Programkørsel](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/raw/branch/main/docs/images/run.png)
+
+Brug andre filer med `python -m squirrel <optællingsfil> <opsummeringsfil>`. Findes optællingsfilen ikke, skriver programmet `Census file not found` og afslutter med status 2.
+
+## Kør testene
+
+```bash
+python -m pytest
+```
+
+![Testkørsel](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/raw/branch/main/docs/images/tests.png)
+
+## Byg kildedokumentationen
+
+```bash
+doxygen Doxyfile
+```
+
+Åbn `docs/doxygen/html/index.html`.

wiki/Usage.md

@@ -0,0 +1,33 @@
+🌐 **English** · [Dansk](Usage.da) · [Bahasa Melayu](Usage.ms)
+
+# Usage
+
+## Run the program
+
+With the virtual environment active, from the project folder:
+
+```bash
+python -m squirrel
+```
+
+The program reads `data/2018_Central_Park_Squirrel_Census_-_Squirrel_Data.csv`, prints the colour counts and writes `squirrel_count.csv`.
+
+![Program run](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/raw/branch/main/docs/images/run.png)
+
+Use other files with `python -m squirrel <census file> <summary file>`. If the census file does not exist, the program prints `Census file not found` and exits with status 2.
+
+## Run the tests
+
+```bash
+python -m pytest
+```
+
+![Test run](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/raw/branch/main/docs/images/tests.png)
+
+## Build the source documentation
+
+```bash
+doxygen Doxyfile
+```
+
+Open `docs/doxygen/html/index.html`.

wiki/Usage.ms.md

@@ -0,0 +1,33 @@
+🌐 [English](Usage) · [Dansk](Usage.da) · **Bahasa Melayu**
+
+# Penggunaan
+
+## Jalankan program
+
+Dengan persekitaran maya aktif, dari folder projek:
+
+```bash
+python -m squirrel
+```
+
+Program membaca `data/2018_Central_Park_Squirrel_Census_-_Squirrel_Data.csv`, mencetak kiraan setiap warna bulu dan menulis `squirrel_count.csv`.
+
+![Larian program](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/raw/branch/main/docs/images/run.png)
+
+Gunakan fail lain dengan `python -m squirrel <fail banci> <fail ringkasan>`. Jika fail banci tidak wujud, program mencetak `Census file not found` dan keluar dengan status 2.
+
+## Jalankan ujian
+
+```bash
+python -m pytest
+```
+
+![Larian ujian](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/025-squirrel/raw/branch/main/docs/images/tests.png)
+
+## Bina dokumentasi sumber
+
+```bash
+doxygen Doxyfile
+```
+
+Buka `docs/doxygen/html/index.html`.

wiki/_Sidebar.md

@@ -0,0 +1,24 @@
+<!-- Generated from wiki; edit the source pages, not the published wiki. -->
+
+**Squirrel Census**
+
+**English**
+
+- [Home](Home)
+- [Install](Install)
+- [Usage](Usage)
+- [Description](Description)
+
+**Dansk**
+
+- [Hjem](Home.da)
+- [Installation](Install.da)
+- [Brug](Usage.da)
+- [Beskrivelse](Description.da)
+
+**Bahasa Melayu**
+
+- [Utama](Home.ms)
+- [Pemasangan](Install.ms)
+- [Penggunaan](Usage.ms)
+- [Penerangan](Description.ms)