Fix/agent api readiness session30

[MarcoPolo483]

No description provided.

[Copilot]

Pull request overview

Updates the EVA Data Model docs and agent onboarding materials for Session 30, reflecting expanded layer coverage and improved copy-paste usage patterns, plus a small introspection API adjustment to surface newly added layers.

Changes:

• Refreshes library/overview documentation to reflect 41 layers and Session 30 status.
• Adds agent-readiness/audit architecture docs and updates the agent experience narrative.
• Updates /model/layers hardcoded layer registry and expands USER-GUIDE.md with copy-paste examples and response-shape notes.

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 15 comments.

Show a summary per file

File	Description
docs/library/README.md	Updates library index metadata and published layer counts.
docs/library/12-AGENT-EXPERIENCE.md	Updates agent discovery guidance and notes /fields vs /example usage.
docs/library/11-EVIDENCE-LAYER.md	Updates cross-doc references to reflect new layer count.
docs/library/10-FK-ENHANCEMENT.md	Updates references to the layer catalog size.
docs/library/03-DATA-MODEL-REFERENCE.md	Renames the reference to 41 layers and updates related callouts.
docs/library/02-ARCHITECTURE.md	Updates architecture diagram text to reflect 41 layers.
docs/library/00-EVA-OVERVIEW.md	Updates overview header for Session 30 and 41 layers.
docs/architecture/DPDCA-AGENT-API-READINESS.md	Adds a new DPDCA session write-up for agent API readiness.
docs/architecture/AGENT-EXPERIENCE-AUDIT.md	Updates agent feedback text for the new layer count.
docs/architecture/AGENT-EXPERIENCE-AUDIT-SESSION30.md	Adds a new Session 30 audit report.
api/routers/introspection.py	Updates the hardcoded known_layers list used by /model/layers.
USER-GUIDE.md	Adds copy-paste quick start, response structure notes, and PowerShell tips.
README.md	Updates repository status text and layer catalog narrative for Session 30.
PLAN.md	Marks prior feature as DONE and adds Session 30 policy-layer completion notes.
LAYER-ARCHITECTURE.md	Updates layer count explanation and Session 30 coverage narrative.

[Copilot]

This file introduces multiple non-ASCII characters (e.g., chart icon, box-drawing characters, Unicode arrows, star symbols). Repo convention is ASCII-only for all edited Markdown; replace these with plain ASCII (e.g., use "*" bullets, "->" arrows, and remove icon characters).

[Copilot]

This new section introduces non-ASCII characters (e.g., checkmark/cross symbols). Repo convention requires ASCII-only in all edited Markdown files (no emoji or Unicode symbols). Replace these markers with ASCII equivalents like [PASS]/[FAIL], OK/WRONG, or similar.

[Copilot]

These edited lines include multiple non-ASCII characters (Unicode dashes and arrows like "→" and "–"), which violates the repo's ASCII-only rule for Markdown. Replace Unicode arrows with "->" and Unicode dashes with "--" (and remove the warning emoji).

[Copilot]

This new audit document uses non-ASCII characters throughout (stars, emoji checkmarks, warning symbols, etc.). The repo requires ASCII-only in all edited Markdown files; replace these symbols with ASCII equivalents (e.g., 9/10, [PASS]/[WARN], etc.).

[Copilot]

This section claims "/fields" works flawlessly, but api/routers/introspection.py returns 404 when no schema file exists for a layer. Consider rewording to reflect the real behavior (e.g., "/fields works for layers with a schema file; otherwise 404"), or link to /model/layers.has_schema for discovery.

Suggested change

	5. **Introspection endpoints** - `/model/layers`, `/fields`, `/example` work flawlessly
	6. **Consistent patterns** - Universal query support across layers
	5. **Introspection endpoints** - `/model/layers`, `/fields`, `/example` give rich metadata for layers with schemas; `/fields` correctly returns 404 when a layer has no schema
	6. **Consistent patterns** - Shared query patterns across layers, with `/model/layers.has_schema` exposing which layers support `/fields`

[Copilot]

In /model/layers, the hardcoded known_layers list no longer includes the "schemas" layer even though api/routers/layers.py defines schemas_router. This will cause /model/layers to omit schemas and drift from the actual available layer routers. Add "schemas" back (and ideally derive this list from the router registry to avoid future drift).

Suggested change

	"validation_rules"
	"validation_rules", "schemas"

[Copilot]

The wording "All layer endpoints return data wrapped" is inaccurate for this API: /model/{layer}/example returns a direct object (no wrapper) and /model/{layer}/count returns a different shape. Consider narrowing this to "List endpoints GET /model/{layer}/" (or explicitly calling out the exceptions in the response-structure section) to avoid misleading copy/paste usage.

[Copilot]

Layer numbering is internally inconsistent here: the README defines Layer 33 as workspace_config and Layer 34 as project_work, but the "Session 28-29" bullet claims Layer 33=agent_policies and Layer 34=quality_gates. This makes the layer catalog self-contradictory; correct the layer numbers (or remove the conflicting Lxx labels) so governance vs agent automation layers don't overlap.

[Copilot]

This new document contains many non-ASCII characters (emoji icons and Unicode arrows like "→" and "↓"). The repo requires ASCII-only in all edited Markdown files; replace emojis with ASCII tokens (e.g., [PASS]/[FAIL]/[WARN]) and replace "→"/"↓" with "->" and "v"/"down" as appropriate.

[Copilot]

"Layers: 41 (L0-L38 ...)" is mathematically inconsistent (L0 through L38 is 39 layers). Also, "Agent Automation L33-L38" overlaps the governance plane labels used a few lines below (L33-L34). Please correct the layer range and/or numbering so counts and Lxx labels agree.