Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
be75eaa
feat: update akb schema products table
uw-amy-bordenave Jul 9, 2026
498a8d3
feat: update akb schema topics section
uw-amy-bordenave Jul 9, 2026
6a3571b
feat: update akb top-level docs' related concepts linking
uw-amy-bordenave Jul 9, 2026
e0a2aff
fix: compact table and update formatting
uw-amy-bordenave Jul 9, 2026
93e0718
feat: update akb dispatch products list
uw-amy-bordenave Jul 9, 2026
3cc5972
feat: update changelog and main instructions
uw-amy-bordenave Jul 9, 2026
b41c02d
feat: add testing for akb products and topics frontmatter
uw-amy-bordenave Jul 9, 2026
45ba23d
fix: update akb products frontmatter entry format
uw-amy-bordenave Jul 9, 2026
2735c2d
fix: update akb article product tag lists
uw-amy-bordenave Jul 9, 2026
c5401ef
fix: add full frontmatter to akb schema
uw-amy-bordenave Jul 9, 2026
1d6bb34
chore: update main agent instructions to prevent failed search tool c…
uw-amy-bordenave Jul 9, 2026
1a4cce2
feat: add slug column to akb products list and add list of products a…
uw-amy-bordenave Jul 9, 2026
bba562e
feat: add additional tests for products and topics fields
uw-amy-bordenave Jul 9, 2026
5499aec
chore: update changelog
uw-amy-bordenave Jul 9, 2026
948334e
fix: update akb article products and topics frontmatter properties
uw-amy-bordenave Jul 9, 2026
795c91f
feat: add to abbreviations list
uw-amy-bordenave Jul 9, 2026
28bae6b
feat: update akb topics tagging
uw-amy-bordenave Jul 9, 2026
1b7f277
fix: update link
uw-amy-bordenave Jul 9, 2026
5556781
fix: remove unnecessary config file
uw-amy-bordenave Jul 9, 2026
7213239
feat: bump zensical to 0.0.50
uw-amy-bordenave Jul 10, 2026
fa28e1c
fix: update topics lists
uw-amy-bordenave Jul 10, 2026
7a1df31
fix: handle serve wrapper interrupts gracefully
uw-amy-bordenave Jul 10, 2026
9728697
fix: clarify agent-layer conventions for index pages
uw-amy-bordenave Jul 10, 2026
ab7f51e
chore: update changelog
uw-amy-bordenave Jul 10, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
4 changes: 4 additions & 0 deletions .github/instructions/main.instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,7 @@ applyTo: "**"
IMPORTANT: This project uses a Python virtual environment (`.venv/`). ALWAYS run `.\.venv\Scripts\Activate.ps1` before ANY terminal command (zensical, pip, python, utility scripts, etc.). Never assume the venv is already activated.

When editing Markdown content under `docs/`, also follow `.github/instructions/content-style.instructions.md`.

Every completed development change must update `CHANGELOG.md` in the same changeset.

When using the search tool, consider setting `includeIgnoredFiles` to `true` because `site/`, `human-docs/`, and `agent-docs/` are listed in `files.exclude` and `search.exclude`.
5 changes: 0 additions & 5 deletions .vscode/settings.json

This file was deleted.

31 changes: 29 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,36 @@

# Changelog

Changes to the TCAT Wiki are documented here.
All notable changes to this project will be documented in this file.

This project adheres to [Semantic Versioning](https://semver.org/) and [Conventional Commits](https://www.conventionalcommits.org/).
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/) and [Conventional Commits](https://www.conventionalcommits.org/).

## v13.1.0 (2026-07-09)

### Features

- **Core**: Upgrade Zensical to 0.0.50
- **Docs**: Add to abbreviations list
- **Docs**: Add new `topics` slugs to the AKB schema's themed vocabulary tables
- **Docs**: Add a `Slug` column to the AKB schema's Product tags table (matching each product's `docs/assistant/{topic}/` directory name), rename the `topics` section to "Topic tags", and add a "Product slugs" table duplicating those slugs as first-class `topics` values, with a short rationale for the intentional duplication
- **Core**: Add `test_akb_content.py` tests, enforcing that (1) the first `products` entry for single-product topic folders matches that folder's owning product, (2) the first `topics` entry matches the parent topic folder's own slug, and (3) every `products` entry has its schema slug present somewhere in `topics`; `cross-platform/` and `support/` are exempt from checks 1-2 as cross-cutting, multi-product sections
- **Docs**: Expand the AKB schema's product tags table to list all first-class products, and align the generated dispatch registry's `products` frontmatter to match
- **Docs**: Restructure the AKB schema's controlled `topics` vocabulary into themed tables covering every product area
- **Docs**: Standardize the "Related Concepts" section across `assistant/index.md`, `assistant/schema.md`, `assistant/intents.md`, and the generated `assistant/dispatch.md` to link to each other with shared, consistent text; update `utilities/akb-generate-dispatch.py` accordingly
- **Core**: Add `test_akb_content.py` tests validating that every AKB article's `products` and `topics` frontmatter values exactly match the controlled vocabularies in `assistant/schema.md`
- **Docs**: Add full frontmatter to AKB schema doc

### Fixes

- **Core**: Document and test that agent-layer URLs preserve docs-relative source paths, including `index.md`, while human index pages retain directory URLs
- **Core**: Handle interrupted site preparation and local preview serving without printing a Python traceback
- **Core**: Remove explicit Python Markdown association settings file, no longer needed as of Zensical Studio 0.1.2
- **Docs**: Rename or case-normalize non-conforming `topics` values in AKB articles to match the schema's updated controlled vocabulary
- **Docs**: Reorder AKB article `products`/`topics` frontmatter so the first `products` entry matches the owning product for the article's parent topic folder, the first `topics` entry matches that folder's slug, and every listed product's slug is present in `topics`, per the new `test_akb_content.py` checks; regenerate `assistant/dispatch.md` afterward
- **Docs**: Fix a stray `QA/QC Reports` `products` value (should be `QA-QC Reports`) and its missing `qa-qc` `topics` slug in `assistant/cross-platform/concept/abbreviations.md`
- **Docs**: Compact the dispatch registry's status legend table formatting
- **Docs**: Fix AKB article `products` frontmatter values that did not match the schema's canonical casing
- **Docs**: Update AKB article `products` frontmatter values for AKB root docs

## v13.0.0 (2026-07-06)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- routing
risk_level: medium
authority_level: draft
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ audiences:
- advocate
- public
topics:
- metrics
- accessmap
- accessibility-metrics
risk_level: medium
authority_level: draft
review_status: stub
Expand Down
3 changes: 2 additions & 1 deletion docs/assistant/accessmap/concept/accessibility-needs.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ audiences:
- advocate
- public
topics:
- accessibility
- accessmap
- accessibility-data
risk_level: medium
authority_level: draft
review_status: stub
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- routing
risk_level: medium
authority_level: draft
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/accessmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- overview
risk_level: medium
authority_level: draft
Expand Down
2 changes: 1 addition & 1 deletion docs/assistant/accessmap/concept/ada-compliance-support.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ audiences:
- advocate
- public
topics:
- accessmap
- ada
- compliance
risk_level: high
authority_level: draft
review_status: stub
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ audiences:
- advocate
- public
topics:
- profiles
- accessmap
- mobility-profiles
risk_level: medium
authority_level: draft
review_status: stub
Expand Down
3 changes: 2 additions & 1 deletion docs/assistant/accessmap/concept/avoid-missing-curb-ramps.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ audiences:
- advocate
- public
topics:
- routing-preferences
- accessmap
- routing
risk_level: medium
authority_level: draft
review_status: stub
Expand Down
3 changes: 2 additions & 1 deletion docs/assistant/accessmap/concept/avoid-steep-slopes.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ audiences:
- advocate
- public
topics:
- routing-preferences
- accessmap
- routing
risk_level: medium
authority_level: draft
review_status: stub
Expand Down
3 changes: 2 additions & 1 deletion docs/assistant/accessmap/concept/blind-low-vision-support.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ audiences:
- advocate
- public
topics:
- blind-low-vision
- accessmap
- mobility-profiles
risk_level: medium
authority_level: draft
review_status: stub
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/campus-accessibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- campus
risk_level: medium
authority_level: explanatory
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- governance
risk_level: medium
authority_level: explanatory
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/comparison-apple-maps.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- comparison
risk_level: medium
authority_level: explanatory
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- construction
- routing
risk_level: medium
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- planning
risk_level: medium
authority_level: explanatory
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/curb-ramp-routing.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- curb-ramps
- routing
risk_level: medium
Expand Down
3 changes: 2 additions & 1 deletion docs/assistant/accessmap/concept/data-sources.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ audiences:
- advocate
- public
topics:
- data-sources
- accessmap
- dataset-lineage
risk_level: medium
authority_level: explanatory
review_status: stub
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/disconnected-sidewalks.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- connectivity
risk_level: medium
authority_level: explanatory
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/emergency-planning.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- emergency
risk_level: medium
authority_level: explanatory
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- communication
risk_level: medium
authority_level: explanatory
Expand Down
3 changes: 2 additions & 1 deletion docs/assistant/accessmap/concept/field-validation.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ audiences:
- advocate
- public
topics:
- validation
- accessmap
- data-quality
risk_level: medium
authority_level: explanatory
review_status: stub
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/google-maps-comparison.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- comparison
risk_level: medium
authority_level: explanatory
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- comparison
risk_level: medium
authority_level: explanatory
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/gtfs-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- gtfs
risk_level: medium
authority_level: explanatory
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/gtfs-pathways.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- gtfs
risk_level: medium
authority_level: explanatory
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- comparison
risk_level: medium
authority_level: explanatory
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- health
risk_level: medium
authority_level: explanatory
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- transit
risk_level: medium
authority_level: explanatory
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- data-quality
risk_level: medium
authority_level: explanatory
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/longer-route-selection.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ audiences:
- public
- advocate
topics:
- accessmap
- routing
risk_level: low
authority_level: explanatory
Expand Down
4 changes: 2 additions & 2 deletions docs/assistant/accessmap/concept/manual-wheelchair-support.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ audiences:
- advocate
- public
topics:
- profiles
- wheelchair
- accessmap
- mobility-profiles
risk_level: high
authority_level: explanatory
review_status: stub
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ audiences:
- advocate
- public
topics:
- data-gaps
- accessmap
- completeness
risk_level: medium
authority_level: explanatory
review_status: stub
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- curb-ramps
- routing
risk_level: medium
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/mobility-profiles.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ audiences:
- public
- advocate
topics:
- accessmap
- mobility-profiles
risk_level: medium
authority_level: explanatory
Expand Down
3 changes: 2 additions & 1 deletion docs/assistant/accessmap/concept/network-redundancy.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ audiences:
- advocate
- public
topics:
- network
- accessmap
- graph-metrics
risk_level: medium
authority_level: explanatory
review_status: stub
Expand Down
3 changes: 2 additions & 1 deletion docs/assistant/accessmap/concept/operational-use.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ audiences:
- advocate
- public
topics:
- operations
- accessmap
- operational-workflows
risk_level: medium
authority_level: explanatory
review_status: stub
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,8 @@ audiences:
- advocate
- public
topics:
- paratransit
- accessmap
- transit
risk_level: medium
authority_level: explanatory
review_status: stub
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/pedestrian-resilience.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- resilience
risk_level: medium
authority_level: explanatory
Expand Down
1 change: 1 addition & 0 deletions docs/assistant/accessmap/concept/planned-capabilities.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ audiences:
- advocate
- public
topics:
- accessmap
- roadmap
risk_level: medium
authority_level: explanatory
Expand Down
Loading