Add codebase analysis documentation

.zeuz/SUMMARY.md

@@ -0,0 +1 @@
+# Codebase Analysis Summary

.zeuz/ai-generated-artifacts.json

@@ -0,0 +1,18 @@
+[
+  {
+    "generatedAt": "2026-05-23T18:20:56.168Z",
+    "files": [
+      ".zeuz/analysis/bootstrap-context.md",
+      ".zeuz/decisions.md",
+      ".zeuz/errors.md",
+      ".zeuz/locks/.gitkeep",
+      ".zeuz/plan.md",
+      ".zeuz/skipped.md",
+      ".zeuz/snapshots.md",
+      ".zeuz/SUMMARY.md",
+      ".zeuz/tasks/TASK-001.md",
+      ".zeuz/tasks/TASK-002.md",
+      ".zeuz/test-results/.gitkeep"
+    ]
+  }
+]

.zeuz/analysis/bootstrap-context.md

@@ -0,0 +1,37 @@
+# Bootstrap Context
+
+Generated: 2026-05-23T18:20:30Z
+
+## Source-of-truth guidance files
+
+- `AGENTS.md`: **Not found**.
+  - Evidence: `find . -maxdepth 4 -name AGENTS.md` returned no results.
+- Root `CLAUDE.md`: **Not found**.
+  - Evidence: `ls -la CLAUDE.md` reports `No such file or directory`.
+- Service-local `CLAUDE.md` files: **Not found**.
+  - Evidence: `find . -maxdepth 6 -name CLAUDE.md` returned no results.
+
+## Documentation directory (`docs/`)
+- `docs/` directory: **Not found**.
+  - Evidence: `ls -la docs` reports `No such file or directory`.
+
+## Repository boundaries (top-level)
+Based on the directory layout in the current working directory:
+- `Apps/`: application components (contains multiple subprojects; exact boundaries require deeper discovery later).
+- `Framework/`: shared framework/runtime code.
+- `Projects/`: project definitions/configuration.
+- `Drivers/`: driver/integration layer code.
+- `Installer/`: install/bootstrap scripts.
+- `server/`: server-side entrypoints.
+- `reporting/`: reporting artifacts.
+- `tests/`: test suite.
+- `node_cli.py`: top-level Python CLI entrypoint candidate.
+
+## Canonical commands (best-effort evidence from filesystem)
+No root-level build/test scripts were confirmed yet (Phase 1 will inventory config files like `pyproject.toml`, etc.). For now, only these were observed:
+- `pyproject.toml` exists at repo root (`./pyproject.toml`).
+- `node_cli.py` exists at repo root (`./node_cli.py`).
+- `tests/` directory exists (`./tests`).
+
+## Security/auth constraints
+Not determinable from Phase 0 bootstrap alone; subsequent phases will inspect auth/config and any secret-handling patterns.

.zeuz/decisions.md

@@ -0,0 +1 @@
+# Decisions

.zeuz/errors.md

@@ -0,0 +1 @@
+# Errors

.zeuz/plan.md

@@ -0,0 +1,19 @@
+# Master Plan
+Generated: 2026-05-23T18:19:48Z
+
+## Phases
+- [ ] Phase 0: Initialization & Planning
+- [ ] Phase 1: Discovery & Inventory
+- [ ] Phase 2: Architecture & System Design Analysis
+- [ ] Phase 3: Code Conventions, Patterns & DX
+- [ ] Phase 4: Feature, Domain & Integration Analysis
+- [ ] Phase 5: Security, Compliance & Governance Analysis
+- [ ] Phase 6: Artifact Generation
+- [ ] Phase 7: Testing & Validation
+- [ ] Phase 8: Final Snapshot & Verification
+
+## Task Registry
+| Task ID | Phase | Description | Status | Assigned To | Started | Completed |
+|---------|-------|-------------|--------|-------------|---------|-----------|
+| TASK-001 | 0 | Initialize .zeuz directory | DONE | main | 2026-05-23T18:19:48Z | 2026-05-23T18:19:48Z |
+| TASK-002 | 0 | Bootstrap repository context | DONE | main | 2026-05-23T18:20:05Z | 2026-05-23T18:20:40Z |

.zeuz/skipped.md

@@ -0,0 +1 @@
+# Skipped

.zeuz/snapshots.md

@@ -0,0 +1,6 @@
+# Snapshot Log
+
+| Timestamp | Git SHA (optional) | Description |
+|-----------|---------------------|-------------|
+| 2026-05-23T18:20:05Z | N/A | TASK-001 complete — Initialize .zeuz directory |
+| 2026-05-23T18:20:40Z | N/A | TASK-002 complete — Bootstrap repository context |

.zeuz/tasks/TASK-001.md

@@ -0,0 +1,31 @@
+# TASK-001: Initialize .zeuz directory
+
+## Metadata
+- **Phase**: 0
+- **Status**: DONE
+- **Assigned To**: main
+- **Started**: 2026-05-23T18:19:48Z
+- **Completed**: 2026-05-23T18:19:48Z
+- **Duration**: 0m
+- **Depends On**: none
+- **Blocks**: none
+
+## Description
+Creates the `.zeuz/` directory structure and initializes master plan and tracking files required for subsequent analysis phases.
+
+## Acceptance Criteria
+- [x] `.zeuz/plan.md` exists with Phase registry
+- [x] `.zeuz/tasks/TASK-001.md` exists
+- [x] `.zeuz/snapshots.md` exists
+
+## Checklist
+- [x] Create `.zeuz/` subdirectories
+- [x] Write plan and tracking files
+
+## Output
+- `.zeuz/plan.md`
+- `.zeuz/tasks/TASK-001.md`
+- `.zeuz/decisions.md`, `.zeuz/errors.md`, `.zeuz/skipped.md`, `.zeuz/snapshots.md`, `.zeuz/SUMMARY.md`
+
+## Test Requirements
+- N/A (no generated artifacts beyond scaffolding)

.zeuz/tasks/TASK-002.md

@@ -0,0 +1,33 @@
+# TASK-002: Bootstrap repository context
+
+## Metadata
+- **Phase**: 0
+- **Status**: DONE
+- **Assigned To**: main
+- **Started**: 2026-05-23T18:20:05Z
+- **Completed**: 2026-05-23T18:20:40Z
+- **Duration**: 0m
+- **Depends On**: [TASK-001]
+- **Blocks**: none
+
+## Description
+Reads source-of-truth guidance files required by the CLAUDE analysis prompt: root `AGENTS.md` (if present), root `CLAUDE.md` (if present), and any service-local `CLAUDE.md` files (if present). Also inventories existing documentation under `docs/` (if present). If files are missing, records explicit evidence of absence.
+
+## Acceptance Criteria
+- [ ] `.zeuz/analysis/bootstrap-context.md` exists
+- [ ] Evidence-based notes include whether `AGENTS.md` and `CLAUDE.md` exist or are missing
+- [ ] Absence of `docs/` is recorded if `docs/` directory does not exist
+
+## Notes
+Bootstrapping only captured evidence about guidance/document directories; deeper command/runtime inventory is deferred to Phase 1.
+
+## Checklist
+- [ ] Find `AGENTS.md` and `CLAUDE.md`
+- [ ] Check for `docs/` directory and existing docs
+- [ ] Write `.zeuz/analysis/bootstrap-context.md`
+
+## Output
+- `.zeuz/analysis/bootstrap-context.md`
+
+## Test Requirements
+- N/A (documentation-only bootstrap)