Doc updates

Author: CorruptComputer

ALIDADE-SPEC.md

@@ -220,6 +220,8 @@ Errors block upload and must be resolved first; warnings are surfaced to the use
 | Tag value exceeds 255 character OSM limit | |
 | Impossible oneway (highway with oneway tag forming a routing island - no way in or out) | |
 | Deprecated tags | Shows migration suggestion from `id-tagging-schema` |
+| Untagged standalone node (locally edited, not a vertex of any way) | |
+| Untagged way (locally edited, not a relation member; `area=yes`-only counts as untagged) | |
 
 #### Info
 
@@ -231,7 +233,7 @@ Errors block upload and must be resolved first; warnings are surfaced to the use
 
 The following iD validators are omitted from Alidade as not applicable or out of scope:
 
-- **Untagged node in way** - nodes that are only geometry (no tags) are perfectly valid and extremely common; flagging them creates noise
+- **Untagged node in way** (way-vertex nodes) - nodes that serve only as geometry vertices are perfectly valid and extremely common; flagging them creates noise. Note: untagged *standalone* nodes (not vertices of any way) *are* flagged as a warning.
 - **Private data** (`phone`, `email`, `website` on personal features) - paternalistic for a power-user editor
 - **Help request** - iD-specific UI affordance, not relevant
 - **MapRules** - iD-specific hosted task management integration
@@ -532,8 +534,11 @@ Commit the regenerated files in `Alidade.Osm/AutoGen/TaggingSchemas/`, `Alidade.
 │       └── assets/js/             # indexeddb-interop.js, auth-interop.js
 ├── Alidade.Osm/                   # OSM domain models, API services, OSM-specific handlers, and validators
 │   ├── Handlers/
-│   │   ├── Editing/               # OSM element mutation handlers (CreateNode, MoveNode, DeleteWay, UpdateTags, etc.)
-│   │   └── Parsing/               # FetchBbox, ParseOsmXml, UploadChangeset, etc.
+│   │   ├── Changeset/             # BuildChangesets, CloseChangeset, CreateChangeset, UploadChangeset
+│   │   ├── Editing/               # OSM element mutation handlers (CreateNode, MoveNode, DeleteWay, FetchBbox, FetchElement, etc.)
+│   │   ├── Parsing/               # BuildOsmChangeXml, ParseDiffResult, ParseNotesJson, ParseOsmXml
+│   │   ├── Tagging/               # BulkUpdateTags, MergePresetTags, UpdateTags
+│   │   └── Tools/                 # Gridify and Square algorithm handlers
 │   ├── Models/
 │   │   ├── EditBuffer/            # EditBufferState, ConflictItem
 │   │   ├── Validation/            # ValidationIssue, ValidationSeverities

CLAUDE.md

@@ -2,7 +2,7 @@
 
 ## Project Overview
 
-Alidade is a browser-based OpenStreetMap editor built on Blazor WebAssembly (C#). It targets experienced OSM contributors and aims for feature parity with iD. The UI is rendered via MapLibre GL JS through a JS interop boundary; all application logic lives in C#. Key external data sources are `id-tagging-schema` (presets) and `name-suggestion-index`, both embedded at build time by `Alidade.OsmGen`.
+Alidade is a browser-based OpenStreetMap editor built on Blazor WebAssembly (C#). It targets experienced OSM contributors and aims for feature parity with iD. The UI is rendered via MapLibre GL JS through a JS interop boundary; all application logic lives in C#. Key external data sources are `id-tagging-schema` (presets), `name-suggestion-index`, and `editor-layer-index` (imagery layers), all embedded at build time by `Alidade.OsmGen`.
 
 ---
 
@@ -68,7 +68,7 @@ Singleton state services are distributed across projects based on where their mo
 Each project owns an Autofac module that registers its own services:
 - `Alidade.Core/AlidadeCoreModule.cs` — registers `SettingsStateService`
 - `Alidade.Map/AlidadeMapModule.cs` — registers `MapInteropService` and map-specific services
-- `Alidade.Osm/AlidadeOsmModule.cs` — registers `EditBufferStateService`, OSM API services, `PresetService`, `NsiService`
+- `Alidade.Osm/AlidadeOsmModule.cs` — registers `EditBufferStateService`, `OsmCacheService`, OSM API services, `PresetService`, `NsiService`
 - `Alidade/AlidadeModule.cs` — registers app services and state services; loads the above sub-modules; also registers all Questy handlers by scanning `Alidade`, `Alidade.Map`, and `Alidade.Osm` assemblies
 
 Use constructor injection throughout. State services are singletons; application services are instance-per-lifetime-scope.
@@ -142,7 +142,7 @@ See [CODE_STYLE.md](CODE_STYLE.md) for the full rules. The most commonly violate
 Release builds execute `git describe --long --always --dirty --exclude=* --abbrev=8` via a `SetSourceRevisionId` MSBuild target in `Directory.Build.props` to embed an 8-character commit hash as the version suffix. Debug builds use the suffix `"develop"`.
 
 **MapLibre is copied, not re-bundled**
-`Alidade.Map.csproj` copies MapLibre JS, CSS, and worker files from node_modules verbatim to `Alidade.Map/wwwroot/assets/lib/maplibre-gl/` via a `CopyMapLibre` MSBuild target. Do not run them through esbuild, webpack, or any other bundler — doing so would strip the `window.maplibregl` UMD global that `map-interop.js` depends on.
+`Alidade.Map.csproj` copies MapLibre JS, CSS, and license files from node_modules verbatim to `Alidade.Map/wwwroot/assets/lib/maplibre-gl/` via a `CopyMapLibre` MSBuild target. Do not run them through esbuild, webpack, or any other bundler — doing so would strip the `window.maplibregl` UMD global that `map-interop.js` depends on.
 
 **OsmGen generates three datasets**
 `Alidade.OsmGen` produces compiled C# for three data sources, not just two:

README.md

@@ -4,10 +4,17 @@ Alidade is a browser-based [OpenStreetMap](https://www.openstreetmap.org) editor
 
 ## Key characteristics
 - **Blazor WebAssembly** — all application logic runs in C# compiled to WASM; no JavaScript framework
-- **MapLibre GL JS** — WebGL-accelerated map rendering; OSM edits are pushed as GeoJSON diffs through a thin JS interop boundary
+- **[MapLibre GL JS](https://github.com/maplibre/maplibre-gl-js)** — WebGL-accelerated map rendering; OSM edits are pushed as GeoJSON diffs through a thin JS interop boundary
 - **Offline-capable** — full edit sessions are possible without connectivity; sync on reconnect
 - **Future desktop target** — architecture keeps an Electron packaging path open
 
+## Data assets
+Alidade embeds the following OSM community datasets as compiled C# at build time:
+
+- [`@openstreetmap/id-tagging-schema`](https://github.com/openstreetmap/id-tagging-schema)
+- [`name-suggestion-index`](https://github.com/osmlab/name-suggestion-index)
+- [`@openstreetmap/editor-layer-index`](https://github.com/osmlab/editor-layer-index)
+
 ## Contributions
 
 Since Alidade is in early development and is not yet ready for general use, I am not accepting public pull requests until the project stabilizes.