docs: bootstrap CLAUDE.md

CLAUDE.md

@@ -0,0 +1,27 @@
+# CLAUDE.md — phenotype-omlx
+
+Extends parent governance. See the following for canonical definitions:
+- **Global baseline:** `~/.claude/CLAUDE.md`
+- **Phenotype root:** `/Users/kooshapari/CodeProjects/Phenotype/repos/CLAUDE.md`
+- **AgilePlus mandate:** `/Users/kooshapari/CodeProjects/Phenotype/repos/AgilePlus`
+
+## Project Overview
+
+- **Name:** phenotype-omlx
+- **Location:** /Users/kooshapari/CodeProjects/Phenotype/repos/phenotype-omlx
+- **Language Stack:** (fill in)
+- **Status:** Active
+
+## AgilePlus Mandate
+
+All work MUST be tracked in AgilePlus:
+- CLI: `cd /Users/kooshapari/CodeProjects/Phenotype/repos/AgilePlus && agileplus <command>`
+- Check for existing specs before implementing
+- Create spec for new work: `agileplus specify --title "<feature>" --description "<desc>"`
+- No code without corresponding AgilePlus spec
+
+## Worktree & Git Discipline
+
+- Feature work uses repo-specific worktrees: `repos/[PROJECT]-wtrees/<topic>/`
+- Canonical repo stays on `main` except during explicit merge operations
+

README.md

@@ -17,6 +17,7 @@
   <img src="https://img.shields.io/badge/license-Apache%202.0-blue" alt="License">
   <img src="https://img.shields.io/badge/python-3.10+-green" alt="Python 3.10+">
   <img src="https://img.shields.io/badge/platform-Apple%20Silicon-black?logo=apple" alt="Apple Silicon">
+  <a href="https://sladge.net"><img src="https://sladge.net/badge.svg" alt="AI Slop Inside"></a>
 </p>
 
 <p align="center">

docs/sessions/20260429-sladge-badge/00_SESSION_OVERVIEW.md

@@ -0,0 +1,18 @@
+# Session Overview
+
+## Goal
+
+Add the sladge governance badge to phenotype-omlx because it is a local LLM
+inference server with MCP, Claude Code, OpenAI, and Anthropic-compatible surfaces.
+
+## Outcome
+
+- Added the badge to the README badge block.
+- Used isolated worktree `phenotype-omlx-wtrees/sladge-badge` because canonical
+  phenotype-omlx has unrelated untracked worklog files.
+- Kept the change documentation-only.
+
+## Commit Scope
+
+- `README.md`
+- `docs/sessions/20260429-sladge-badge/`

docs/sessions/20260429-sladge-badge/01_RESEARCH.md

@@ -0,0 +1,17 @@
+# Research
+
+## Repository Fit
+
+phenotype-omlx is an LLM inference server for Apple Silicon. The README describes
+local LLM serving, MCP support, Claude Code optimization, and OpenAI/Anthropic
+API compatibility.
+
+## Local State
+
+The canonical checkout has unrelated untracked worklog files. The rollout used
+`phenotype-omlx-wtrees/sladge-badge` from `main`.
+
+## Governance Context
+
+projects-landing tracks sladge as governance metadata only. This rollout does
+not change runtime code or catalog metadata.

docs/sessions/20260429-sladge-badge/02_SPECIFICATIONS.md

@@ -0,0 +1,14 @@
+# Specifications
+
+## Acceptance Criteria
+
+- README includes exactly one `sladge.net` badge reference.
+- The badge appears in the existing badge block.
+- The canonical dirty checkout remains untouched.
+- The commit includes the required Codex co-author trailer.
+
+## Assumptions, Risks, Uncertainties
+
+- Assumption: LLM inference servers with MCP and API compatibility are in scope.
+- Risk: README uses HTML badge formatting rather than Markdown badges.
+- Mitigation: Match the existing centered HTML badge block.

docs/sessions/20260429-sladge-badge/03_DAG_WBS.md

@@ -0,0 +1,17 @@
+# DAG WBS
+
+## Work Breakdown
+
+1. Confirm LLM inference scope. `[done]`
+2. Check canonical status and worktree state. `[done]`
+3. Create isolated worktree from `main`. `[done]`
+4. Add README badge. `[done]`
+5. Add session documentation. `[done]`
+6. Validate badge presence and diff scope. `[done]`
+7. Commit documentation change. `[pending]`
+8. Update projects-landing governance ledger. `[pending]`
+
+## Dependencies
+
+- Step 6 depends on README/session docs being complete.
+- Step 8 depends on the badge commit.

docs/sessions/20260429-sladge-badge/04_IMPLEMENTATION_STRATEGY.md

@@ -0,0 +1,13 @@
+# Implementation Strategy
+
+## Approach
+
+Use an isolated docs-only rollout:
+
+- Add the sladge badge to the existing README badge block.
+- Store rollout evidence under `docs/sessions/`.
+- Avoid runtime, generated, and catalog changes.
+
+## Rationale
+
+The badge marks a direct LLM-serving surface without changing package behavior.

docs/sessions/20260429-sladge-badge/05_KNOWN_ISSUES.md

@@ -0,0 +1,12 @@
+# Known Issues
+
+## Current
+
+- Canonical phenotype-omlx has unrelated untracked worklog files.
+- Badge commit is prepared in an isolated worktree and should not be merged until
+  those unrelated files are reconciled.
+
+## Out of Scope
+
+- Runtime server validation is not required for this README-only governance
+  update.

docs/sessions/20260429-sladge-badge/06_TESTING_STRATEGY.md

@@ -0,0 +1,15 @@
+# Testing Strategy
+
+## Validation
+
+- Verify exactly one `sladge.net` reference in README.
+- Review `git diff --stat`.
+- Confirm worktree status before commit.
+
+## Commands
+
+```bash
+rg -n "sladge.net" README.md
+git diff --stat
+git status --short --untracked-files=all
+```

omlx/__main_hwledger__.py

@@ -0,0 +1,13 @@
+#!/usr/bin/env python3
+# SPDX-License-Identifier: Apache-2.0
+"""
+Entry point for hwLedger JSON-RPC RPC server.
+
+Invoked as: python -m omlx.__main_hwledger__
+or via uv: uv run --project . python -m omlx.__main_hwledger__
+"""
+
+from omlx.hwledger_rpc import main
+
+if __name__ == "__main__":
+    main()