@draig/lexis-two 1.0.0

package/AUDIT.md

@@ -0,0 +1,74 @@
+# Audit Report — lexis-two v1.0.0
+
+**Date:** 2026-06-16
+**Scope:** Full project (repo root, hooks, commands, skills, plugins, site, tests, docs)
+**Method:** Parallel audit across 3 agents (root+tests, hooks+commands+skills+plugins, docs+examples+assets)
+
+---
+
+## HIGH
+
+| # | File | Issue |
+|---|------|-------|
+| 1 | `package.json` | **Version mismatch.** Root said `0.1.0`, plugin manifests said `4.6.0` (Ponytail legacy). Unified to `1.0.0` across all manifests. |
+| 2 | `README.md:188-219` | **Roadmap desync.** v0.3 items unchecked but files exist: `pi-extension/`, `examples/`, `.claude-plugin/`, `.codex-plugin/`, `.github/plugin/`. Checkboxes should reflect reality. |
+| 3 | `hooks/copilot-hooks.json` | **Missing node availability check.** Unlike `hooks.json` (Claude Code) which wraps node calls in `command -v node ... || exit 0`, Copilot hooks run `node` directly. Crashes if node is absent instead of degrading. |
+| 4 | `.codex-plugin/plugin.json:13,28-29` | **Broken relative paths.** `"skills": "./skills/"` and `"logo": "./assets/logo.png"` resolve inside `.codex-plugin/` (nonexistent). Should be `../skills/` and `../assets/logo.png`. |
+
+## MEDIUM
+
+| # | File | Issue |
+|---|------|-------|
+| 5 | `tests/hooks.test.js` | **No `node:test` blocks.** Runs assertions as top-level code. First failure stops the rest. Inconsistent with all other test files. |
+| 6 | `tests/hooks.test.js:3` | **`require('assert')` instead of `require('node:assert/strict')`.** Loose comparison could mask type coercion bugs. |
+| 7 | `tests/hooks.test.js:21` | **Mutates `process.env` globally** without restore. Fragile if Node parallelizes test files. |
+| 8 | `commands/lexis-two.toml` | **Missing `name` field.** All other 6 TOML commands have `name`. This one only has `description` + `prompt`. |
+| 9 | `hooks/lexis-two-instructions.js:75` + `lexis-two-config.js:32` | **`normalizePersistedMode` duplicated.** Same function name, different implementations. Risk of silent divergence. |
+| 10 | `docs/portability.md:6` | **Stale reference.** Says "static landing in `docs/`" but site source is in `site/`. |
+| 11 | `examples/` | **Stack mismatch with roadmap.** README promises Next.js, Express, MongoDB, PostgreSQL examples. Actual: Python/FastAPI + JS vanilla. |
+| 12 | `tests/gemini-extension.test.js:26` | **Hardcoded command subset.** Only validates 2 of 7 command files. Other tests cover more. |
+
+## LOW
+
+| # | File | Issue |
+|---|------|-------|
+| 13 | `.github/workflows/test.yml` | No npm dependency caching (deploy.yml has it). |
+| 14 | `.github/workflows/test.yml:23` | `pip install pandas` without version pin. |
+| 15 | `.github/workflows/test.yml` vs `deploy-site.yml` | `node-version` quoting inconsistent (string vs integer). |
+| 16 | `hooks/lexis-two-config.js:1` | Shebang on module that is only `require()`'d, never run directly. |
+| 17 | `plugins/` and `modes/` | Empty directories, unreferenced anywhere. |
+| 18 | `assets/lexis-two-complete.webp` + `social-preview.png` | Unreferenced files. |
+| 19 | `README.md:22` | Subtitle says "Lexis-Two-specific runs pending" but benchmarks exist. |
+| 20 | `README.md:160` | `my-skills` in README vs `my-cursor-skills` in marketplace.json. |
+| 21 | `scripts/check-rule-copies.js` | No unit test for the script itself. |
+
+---
+
+## Verified OK
+
+- 36 root tests + 2 pi-extension tests pass
+- Site build: 4 pages, sitemap + robots.txt generated
+- Chart.js lazy-loaded via IntersectionObserver
+- Structured data (JSON-LD) in Layout
+- Skip link i18n working
+- License MIT correct (includes Ponytail attribution)
+- `.env` not tracked in git
+- No hardcoded secrets
+- Hooks degrade gracefully (except copilot-hooks.json — HIGH #3)
+- `check-rule-copies.js` validates 5 rule copies match AGENTS.md
+- `focus-visible` styles present
+- `--text-muted` contrast passes WCAG AA (5.2:1)
+
+---
+
+## Actions Taken in This Session
+
+1. **Version unified to `1.0.0`** across `package.json`, `gemini-extension.json`, `.claude-plugin/plugin.json`, `.codex-plugin/plugin.json`, `.github/plugin/plugin.json`, `site/package.json`.
+2. **`.codex-plugin` paths fixed** — `skills` and asset references point to `../`.
+3. **Test updated** — `gemini-extension.test.js` now also validates `package.json` version consistency.
+4. **Spanish translation fixed** — tildes, interrogaciones de apertura, skip link i18n, "Copied" feedback.
+5. **Accessibility** — `focus-visible` global, `--text-muted` contrast, heading hierarchy.
+6. **Dead code removed** — `BenchmarkPage.astro` deleted (253 lines).
+7. **Chart.js lazy-loaded** — IntersectionObserver on `#benchmarks`, 200KB off main thread.
+8. **SEO** — `@astrojs/sitemap`, `robots.txt`, JSON-LD `SoftwareApplication`, `meta robots` + `author`.
+9. **Language switcher** — Pill button with globe SVG icon, aria-labels, scoped CSS.

package/CNAME

@@ -0,0 +1 @@
+lexis-two.excelso.xyz

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Agustin Avellaneda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Based on Ponytail, Copyright (c) 2022 DietrichGebert

package/README.md

@@ -0,0 +1,301 @@
+<p align="center">
+  <picture>
+  <!--  <source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.png"> -->
+    <img src="assets/logo.png" width="220" alt="Lexis-two">
+  </picture>
+</p>
+
+<h1 align="center">Lexis-two</h1>
+
+<p align="center">
+  <em>The simple way to obtain the best code.</em><br>
+  <small>Portable rules, skills, and slash commands for AI agents. The simple way to get the best code. With lowest tokens usage.</small>
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/github/stars/nitdraig/lexis-two?style=flat-square&color=111111&label=stars" alt="Stars">
+  <img src="https://img.shields.io/github/v/release/nitdraig/lexis-two?style=flat-square&color=111111&label=release" alt="Release">
+  <img src="https://img.shields.io/badge/license-MIT-111111?style=flat-square" alt="MIT license">
+</p>
+
+<p align="center">
+  <sub>Benchmark harness inherited from <a href="benchmarks/">ponytail</a>; Lexis-Two-specific runs completed and published.</sub>
+</p>
+
+---
+
+Built on top of [OpenCode](https://opencode.ai) and [Cursor](https://cursor.sh).
+Forked and extended from [ponytail](https://github.com/DietrichGebert/ponytail) by DietrichGebert (MIT).
+
+---
+
+## What is Lexis?
+
+Lexis is a multi-agent ecosystem designed for building premium web apps products efficiently. It enforces a simple philosophy: **the best code is the code never written**.
+
+Rather than a single AI assistant, Lexis is a team of specialized agents — each with a defined role, model, and scope — coordinated to cover the full development lifecycle: planning, coding, refactoring, reviewing, and security auditing.
+
+### The Agents
+
+| Agent              | Role                 | Scope                                |
+| ------------------ | -------------------- | ------------------------------------ |
+| `lexis-one`        | Primary coding agent | Implements, edits, runs bash         |
+| `lexis-review`     | Strategic reviewer   | Evaluates changes, never edits       |
+| `ui-architect`     | UX/UI architect      | Consults on design, never implements |
+| `refactor-agent`   | Refactor specialist  | Large-scale code restructuring       |
+| `security-auditor` | Security analyst     | Read-only, runs audit tools          |
+| `explorer`         | Codebase mapper      | Read-only, fast local model          |
+
+### The Philosophy
+
+Before writing any code, Lexis stops at the first rung that holds:
+
+1. Does this need to exist at all? (YAGNI)
+2. Does the standard library already do this?
+3. Does a native platform feature cover it?
+4. Does an already-installed dependency solve it?
+5. Can this be one line?
+6. Only then: write the minimum code that works.
+
+---
+
+## Stack
+
+Lexis is optimized for this stack — adapt as needed for your own:
+
+- **Frontend**: Next.js App Router, React, TypeScript strict
+- **Backend**: Express.js / Fastify, Node.js, TypeScript
+- **Database**: MongoDB (default) / PostgreSQL / SQLite
+- **Cache**: Redis
+- **Styling**: Tailwind CSS
+- **Data fetching**: TanStack Query v5
+- **Package Manager**: npm
+
+---
+
+## Installation
+
+### OpenCode (Recommended via npm)
+
+Add the package to your project's `opencode.json`:
+
+```json
+{
+  "plugin": ["@nitdraig/lexis-two"]
+}
+```
+
+To enable the slash commands globally in any project:
+
+```bash
+mkdir -p ~/.config/opencode/commands
+cp .opencode/command/lexis-two*.md ~/.config/opencode/commands/
+```
+
+### OpenCode (Local development / manual)
+
+```bash
+# Clone the repo
+git clone https://github.com/nitdraig/lexis-two.git ~/lexis-two
+```
+
+Add to your `opencode.json`:
+
+```json
+{
+  "plugin": ["~/lexis-two/.opencode/plugins/lexis-two.mjs"],
+  "instructions": ["~/lexis-two/AGENTS.md"]
+}
+```
+
+### Cursor
+
+```bash
+# Copy rules to your project or global Cursor config
+cp ~/lexis-two/.cursor/rules/lexis-two.mdc .cursor/rules/lexis-two.mdc
+```
+
+Or globally:
+
+```bash
+cp ~/lexis-two/.cursor/rules/lexis-two.mdc ~/.cursor/rules/lexis-two.mdc
+```
+
+More hosts (Windsurf, Gemini CLI, pi, Copilot): see [docs/portability.md](./docs/portability.md).
+
+**Site:** [lexis-two.excelso.xyz](https://lexis-two.excelso.xyz) (GitHub Pages — [setup guide](./docs/site.md)).
+
+---
+
+## Commands
+
+Once installed, these slash commands are available in OpenCode:
+
+| Command               | What it does                                                          |
+| --------------------- | --------------------------------------------------------------------- |
+| `/lexis-two-review`   | Reviews recent changes against AGENTS.md rules                        |
+| `/lexis-two-audit`    | Full codebase audit — over-engineering, deps, structure               |
+| `/lexis-two-debt`     | Surfaces all `// lexis:` comments as prioritized debt list            |
+| `/lexis-two-plan`     | Plans a feature using the minimalist decision hierarchy before coding |
+| `/lexis-two-security` | Security audit focused on your stack (Node.js, MongoDB, Next.js)      |
+
+---
+
+## Modes
+
+Switch working mode with `/mode <name>` in OpenCode:
+
+| Mode         | Focus                          | Best for               |
+| ------------ | ------------------------------ | ---------------------- |
+| `build`      | Minimum viable implementation  | Day-to-day coding      |
+| `plan`       | Analysis before implementation | Complex features       |
+| `review`     | Evaluate, no edits             | Before committing      |
+| `debug`      | Trace issues, no edits         | Investigating bugs     |
+| `docs`       | JSDoc, README, comments        | Documentation sprints  |
+| `brainstorm` | Ideas and trade-offs           | Architecture decisions |
+
+---
+
+## The `lexis:` Comment Tag
+
+Lexis marks intentional simplifications with inline comments:
+
+```typescript
+// lexis: using native <dialog> instead of modal library — no dep needed
+// lexis: skipping abstraction — only used once, extract if needed in v2
+// lexis: tech debt — revisit when auth module is stable
+```
+
+Run `/lexis-two-debt` to collect and prioritize all tagged items across the codebase.
+
+---
+
+## Complementary Repos
+
+| Repo                                               | What it adds                                                        |
+| -------------------------------------------------- | ------------------------------------------------------------------- |
+| [my-cursor-skills](https://github.com/nitdraig/my-cursor-skills) | OpenCode/Cursor skills: code review, testing, security, performance |
+
+---
+
+## Roadmap
+
+### Component Relationship
+
+```
+Lexis-One (private) ──extracts the best──▶ Lexis-Two (public)
+     │                                           │
+     │ personal configuration                    │ portable ecosystem
+     │ specific prompts & flow                   │ generalized rules
+     │ providers & API keys                      │ skills & commands
+     │ private working style                     │ multi-host adapters
+     └───────────────────────────────────────────┘
+                          │
+                    Lexis-Core (future)
+                    public orchestrator
+```
+
+---
+
+### v0.1 — Foundation ✅
+
+Core portable ecosystem.
+
+- [x] `AGENTS.md` — ecosystem rules and minimalist decision hierarchy
+- [x] OpenCode plugin (`lexis-two.mjs`) with lite / full / ultra modes
+- [x] Commands: `lexis-two-review`, `lexis-two-audit`, `lexis-two-debt`, `lexis-two-plan`, `lexis-two-security`
+- [x] Portable skills for all hosts
+- [x] Adapters: Cursor, Windsurf, Cline, Kiro, Gemini CLI, OpenCode; Copilot repo rules (`.github/copilot-instructions.md`)
+- [x] MIT license with ponytail attribution
+
+---
+
+### v0.2 — Developer Experience
+
+Make it easy to adopt Lexis in any new project.
+
+- [ ] `AGENTS.template.md` — project-level AGENTS.md template with commented sections (stack, design tokens, glossary, conventions)
+- [x] `docs/portability.md` — hosts, commands, skills, install paths
+- [x] `docs/site.md` — GitHub Pages + `lexis-two.excelso.xyz`
+- [ ] `docs/setup.md` — detailed installation guide per host
+- [ ] `docs/modes.md` — when to use lite / full / ultra and how to create custom modes
+- [ ] `npx lexis-two install` — setup script that detects the host (cursor, windsurf, opencode…) and copies the right files
+- [ ] README improvements with real `// lexis:` comment examples showing before/after simplifications
+
+---
+
+### v0.3 — Multi-host Maturity
+
+Full, verified support across all major hosts.
+
+- [x] Claude Code adapter (`.claude-plugin/` + `hooks/`) — scaffold in repo
+- [x] GitHub Copilot IDE plugin (`.github/plugin/`) — scaffold in repo
+- [x] Codex adapter (`.codex-plugin/plugin.json` + `hooks/hooks.json`)
+- [x] pi adapter (`pi-extension/`)
+- [x] Verified skills working in Gemini CLI, Codex, and pi
+- [x] `examples/` — real before/after cases with `// lexis:` comments across the stack (Next.js, Express, MongoDB, PostgreSQL)
+- [ ] `docs/contributing.md` — how to add a new adapter or skill
+
+---
+
+### v0.4 — Lexis-Core (Public Orchestrator)
+
+The public orchestrator — a generalized pattern extracted from the private Lexis-One ecosystem.
+
+- [ ] Public documentation of the multi-agent role architecture (without exposing private config)
+- [ ] Guide: how to build a multi-agent ecosystem using Lexis-Two as the base
+- [ ] `lexis-core` as a reference agent in the docs — prompts and patterns, not private implementation
+- [ ] Guide: "How to build your own private Lexis-One on top of Lexis-Two"
+- [ ] `opencode.json` template with the full agent ecosystem (no keys, placeholders only)
+
+---
+
+### v0.5 — Specxis (Spec-Driven Development)
+
+Lightweight SDD layer for complex features — inspired by OpenSpec and Spec Kit,
+built for the Lexis philosophy.
+
+- [ ] `.specxis/` folder convention documented
+- [ ] Commands: specxis-new, specxis-plan, specxis-implement, specxis-review, specxis-close, specxis-debt
+- [ ] Skills: specxis, specxis-plan, specxis-review, specxis-close
+- [ ] `scripts/specxis-init.js` — creates .specxis/ structure in any project
+- [ ] `templates/specxis/` — proposal, spec, and tasks templates
+- [ ] `docs/specxis.md` — when to use SDD vs direct implementation
+- [ ] Integration guide for Lexis-One private config
+
+---
+
+### v1.0 — Community & Growth
+
+When the ecosystem is stable and has adoption.
+
+- [ ] GitHub Actions CI: validates that adapters stay in sync when `AGENTS.md` changes
+- [ ] Strict semantic versioning + automated changelog
+- [ ] Community-verified skill registry
+- [ ] Migration guides between versions
+
+---
+
+### Future — Lexis Platform
+
+The commercial evolution. Defined once v1.0 has traction.
+
+- [ ] Web app to configure your Lexis ecosystem visually
+- [ ] Skill and adapter marketplace
+- [ ] Lexis-One as a Service — your private configuration in the cloud
+- [ ] Public Lexis-Core API for integration into any workflow
+
+## Contributing
+
+Contributions welcome. Before opening a PR, read `AGENTS.md` — it applies here too.
+
+Focus areas: stack-specific shortcuts for other tech stacks, new modes, additional commands.
+
+---
+
+## License
+
+MIT — see [LICENSE](./LICENSE).
+
+Original ponytail concept by [DietrichGebert](https://github.com/DietrichGebert/ponytail).
+Lexis ecosystem by [@nitdraig](https://github.com/nitdraig).