@draig/lexis-two 1.0.2 → 1.0.4

package/commands/lexis-two-audit.toml

@@ -1,3 +0,0 @@
-name = "lexis-two-audit"
-description = "Audit the whole repo for over-engineering, what can be deleted"
-skill = "../skills/lexis-two-audit/SKILL.md"

package/commands/lexis-two-debt.toml

@@ -1,3 +0,0 @@
-name = "lexis-two-debt"
-description = "Harvest all lexis: comments into a prioritized debt ledger"
-skill = "../skills/lexis-two-debt/SKILL.md"

package/commands/lexis-two-help.toml

@@ -1,3 +0,0 @@
-name = "lexis-two-help"
-description = "Quick reference for lexis-two levels, skills, and commands"
-prompt = "Show the lexis-two quick reference. One shot, change nothing: do not switch mode, write flag files, or persist anything. Levels: /lexis-two lite, /lexis-two (full, default), /lexis-two ultra. Commands: /lexis-two-review, /lexis-two-audit, /lexis-two-debt, /lexis-two-plan, /lexis-two-security, /lexis-two-help."

package/commands/lexis-two-plan.toml

@@ -1,3 +0,0 @@
-name = "lexis-two-plan"
-description = "Plan a feature using the Lexis-Two lazy decision hierarchy before any code is written"
-skill = "../skills/lexis-two-plan/SKILL.md"

package/commands/lexis-two-review.toml

@@ -1,3 +0,0 @@
-name = "lexis-two-review"
-description = "Review current diff for over-engineering and Lexis-Two rule violations"
-skill = "../skills/lexis-two-review/SKILL.md"

package/commands/lexis-two-security.toml

@@ -1,3 +0,0 @@
-name = "lexis-two-security"
-description = "Security audit focused on Node.js / TypeScript / Next.js / MongoDB stack"
-skill = "../skills/lexis-two-security/SKILL.md"

package/commands/lexis-two.toml

@@ -1,3 +0,0 @@
-name = "lexis-two"
-description = "Switch lexis-two intensity level (lite/full/ultra/off)"
-prompt = "Switch to lexis-two {{args}} mode. If no level specified, use full. Lazy senior dev mode, before any code: does it need to exist at all (YAGNI)? Does the standard library do it? A native platform feature? Can it be one line? Build the minimum that works. No unrequested abstractions, no avoidable dependencies, no boilerplate. Mark intentional simplifications with a lexis: comment."

package/docs/assets/logo.svg

@@ -1,4 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 220 48" role="img" aria-label="Lexis-Two">
-  <rect x="0" y="8" width="220" height="32" rx="4" fill="#141816" stroke="#7cba8a" stroke-width="1.5"/>
-  <text x="110" y="30" fill="#7cba8a" font-family="ui-monospace, monospace" font-size="14" font-weight="600" text-anchor="middle" letter-spacing="0.12em">LEXIS-TWO</text>
-</svg>

package/docs/portability.md

@@ -1,147 +0,0 @@
-# Agent Portability
-
-Lexis-Two is an agent-portable ecosystem. The `skills/` folder holds the core behavior.
-Host-specific files are thin adapters that point to those skills.
-
-**Site (live target):** [lexis-two.excelso.xyz](https://lexis-two.excelso.xyz) — built from `site/` and deployed via GitHub Actions. See [site.md](./site.md) for hosting.
-
-## Naming
-
-| Name | What it is |
-| ---- | ---------- |
-| `lexis` | Base prefix — `// lexis:` comments, shared philosophy |
-| `lexis-two` | This repo — public portable rules, skills, commands, adapters |
-| `lexis-one` | Private agent configuration (not published) |
-| `lexis-zero` | Future orchestrator-style agent (not shipped yet) |
-
-Slash commands and skill folders use the `lexis-two-*` prefix. Plugin manifests use `"name": "lexis-two"`.
-
-## Supported Hosts
-
-| Host | Files | Level |
-| ---- | ----- | ----- |
-| OpenCode | `.opencode/plugins/lexis-two.mjs`, `.opencode/command/`, `hooks/`, `skills/` | Full — plugin + mode switches + commands |
-| Claude Code | `.claude-plugin/`, `hooks/hooks.json`, `commands/`, `skills/` | **Coming soon** (v0.3) — files in repo, not verified |
-| GitHub Copilot (IDE plugin) | `.github/plugin/plugin.json`, `hooks/copilot-hooks.json`, `commands/`, `skills/` | **Coming soon** (v0.3) — files in repo, not verified |
-| Gemini CLI | `gemini-extension.json`, `AGENTS.md`, `commands/`, `skills/` | Full — extension manifest + commands |
-| pi | `pi-extension/`, `skills/` (via `package.json` `"pi"`) | Full — extension + commands |
-| Codex | `.codex-plugin/plugin.json`, `hooks/hooks.json`, `AGENTS.md` | Full — plugin + hooks |
-| Cursor | `.cursor/rules/lexis-two.mdc` | Rules — always-on project rule |
-| Windsurf | `.windsurf/rules/lexis-two.md` | Rules — project rule |
-| Cline | `.clinerules/lexis-two.md` | Rules — project rule |
-| GitHub Copilot (repo) | `.github/copilot-instructions.md` | Rules — repository instruction |
-| GitHub Copilot CLI | `AGENTS.md` or `~/.copilot/copilot-instructions.md` | Rules — no mode switches |
-| Kiro | `.kiro/steering/lexis-two.md` | Rules — steering rule |
-| VS Code + Codex | `AGENTS.md` or `~/.codex/AGENTS.md` | Rules — instruction tier |
-| Antigravity | `AGENTS.md` or `.agents/rules/` | Rules — instruction tier |
-| Generic agents | `AGENTS.md` or `skills/*/SKILL.md` | Rules — copy and load |
-
-### Adapter rule
-
-Keep adapters thin. When a host supports skills or hooks, point it at the
-existing `skills/` and `hooks/` files. When a host only supports project
-instructions, keep its rule text aligned with `AGENTS.md`.
-
-Run `node scripts/check-rule-copies.js` after editing `AGENTS.md` to verify
-instruction-tier copies (Cursor, Windsurf, Cline, Kiro) have not drifted.
-
-## Slash Commands
-
-Available on hosts that ship `commands/` and/or `.opencode/command/` today: OpenCode, Gemini CLI, pi. Claude Code and Copilot plugin: v0.3.
-
-| Command | Skill / behavior |
-| ------- | ---------------- |
-| `/lexis-two` | Mode switch — `lite`, `full` (default), `ultra`, `off` |
-| `/lexis-two-review` | `skills/lexis-two-review/` — diff review for over-engineering |
-| `/lexis-two-audit` | `skills/lexis-two-audit/` — full repo audit |
-| `/lexis-two-debt` | `skills/lexis-two-debt/` — harvest `// lexis:` comments |
-| `/lexis-two-plan` | `skills/lexis-two-plan/` — plan before coding |
-| `/lexis-two-security` | `skills/lexis-two-security/` — security audit (Node/TS stack default) |
-| `/lexis-two-help` | Quick reference card |
-
-Gemini CLI: `commands/lexis-two*.toml`. OpenCode: `.opencode/command/lexis-two*.md`.
-
-## Portable Skills
-
-| Skill | What it does |
-| ----- | ------------ |
-| `skills/lexis-two/` | Core ruleset + intensity levels |
-| `skills/lexis-two-review/` | Diff review for over-engineering |
-| `skills/lexis-two-audit/` | Full repo audit |
-| `skills/lexis-two-debt/` | Harvest `// lexis:` comments into debt ledger |
-| `skills/lexis-two-plan/` | Feature planning before coding |
-| `skills/lexis-two-security/` | Security audit (default: Node.js / Next.js / MongoDB) |
-
-Adapt skill shell commands for other stacks — see README **Adapting Lexis-Two to Any Stack**.
-
-## Project Install
-
-```bash
-git clone https://github.com/nitdraig/lexis-two.git ~/lexis-two
-```
-
-### OpenCode
-
-Add to `opencode.json` in the project (or `~/.config/opencode/opencode.json` globally):
-
-```jsonc
-{
-  "plugin": ["~/lexis-two/.opencode/plugins/lexis-two.mjs"],
-  "instructions": ["~/lexis-two/AGENTS.md"]
-}
-```
-
-### Cursor
-
-```bash
-cp ~/lexis-two/.cursor/rules/lexis-two.mdc .cursor/rules/lexis-two.mdc
-```
-
-### Windsurf / Cline / Kiro
-
-Copy the matching rule file into your project:
-
-```bash
-cp ~/lexis-two/.windsurf/rules/lexis-two.md .windsurf/rules/
-cp ~/lexis-two/.clinerules/lexis-two.md .clinerules/
-cp ~/lexis-two/.kiro/steering/lexis-two.md .kiro/steering/
-```
-
-### Gemini CLI
-
-Run from the cloned repo root (manifest auto-discovers `commands/` and `AGENTS.md`):
-
-```bash
-cd ~/lexis-two
-# Follow Gemini CLI extension install for gemini-extension.json
-```
-
-### pi
-
-Install as a pi package from the repo root (`package.json` declares `"pi"` extensions and skills).
-
-## Global Install (rules-only hosts)
-
-```bash
-# Cursor (global)
-cp ~/lexis-two/.cursor/rules/lexis-two.mdc ~/.cursor/rules/lexis-two.mdc
-
-# GitHub Copilot CLI (global)
-cp ~/lexis-two/AGENTS.md ~/.copilot/copilot-instructions.md
-
-# VS Code + Codex (global)
-cp ~/lexis-two/AGENTS.md ~/.codex/AGENTS.md
-
-# OpenCode (global) — add to ~/.config/opencode/opencode.json:
-# { "plugin": ["~/lexis-two/.opencode/plugins/lexis-two.mjs"] }
-```
-
-## Config
-
-Default mode resolution (hooks + pi + OpenCode plugin):
-
-1. `LEXIS_TWO_DEFAULT_MODE` env var (`off` \| `lite` \| `full` \| `ultra`)
-2. Config file: `~/.config/lexis-two/config.json` (Windows: `%APPDATA%\lexis-two\config.json`) with `{ "defaultMode": "full" }`
-3. Fallback: `full`
-
-Active mode flag (Claude Code): `~/.claude/.lexis-two-active`. OpenCode: `~/.config/opencode/.lexis-two-active`.

package/docs/site.md

@@ -1,52 +0,0 @@
-# Site — lexis-two.excelso.xyz
-
-Astro static site in `site/`. Deployed to GitHub Pages via `.github/workflows/deploy-site.yml`.
-
-**Primary goal:** showcase the project and drive clones/stars.  
-**Secondary goal:** publish benchmark charts at `/benchmarks/`.
-
-## Local dev
-
-```bash
-npm run site:dev
-# → http://localhost:4321
-
-# After a benchmark run:
-npm run benchmark:report   # syncs JSON → site/src/data/
-npm run site:build
-```
-
-## Hosting
-
-GitHub Pages + custom domain `lexis-two.excelso.xyz`.
-
-| Piece | Location |
-| ----- | -------- |
-| Astro app | `site/` |
-| Build output | `site/dist/` |
-| CNAME | `site/public/CNAME` |
-| CI deploy | `.github/workflows/deploy-site.yml` (push to `main` under `site/**`) |
-
-DNS: CNAME `lexis-two` → `<user>.github.io`.
-
-## Content map
-
-| Section | Source |
-| ------- | ------ |
-| Hero + benchmarks CTA | `site/src/components/Home.astro` + i18n |
-| Philosophy ladder | `site/src/i18n/*.ts` |
-| Hosts / commands / install | i18n dictionaries |
-| Benchmark charts | `site/src/pages/benchmarks.astro` + `site/src/data/opencode-go-benchmark.json` |
-| Portability docs | `docs/portability.md` on GitHub (linked, not duplicated) |
-
-## Checklist
-
-- [x] Astro site in `site/`
-- [x] `site/public/CNAME` → `lexis-two.excelso.xyz`
-- [x] Benchmark page at `/benchmarks/`
-- [ ] GitHub Pages enabled (Settings → Pages → deploy from Actions / gh-pages branch)
-- [ ] DNS CNAME live; HTTPS green
-
-## Legacy
-
-`docs/index.html` and `docs/styles.css` were removed — use `site/` instead. `docs/portability.md` stays in repo for GitHub linking.

package/examples/api-endpoint.md

@@ -1,68 +0,0 @@
-# API Endpoint
-
-**Task:** "Add an endpoint that returns a user by id."
-
-## Without Lexis
-
-```
-app/
-├── controllers/user_controller.py
-├── services/user_service.py
-├── repositories/user_repository.py
-├── schemas/user_schemas.py
-└── exceptions/user_exceptions.py
-```
-
-```python
-# schemas/user_schemas.py
-class UserResponseDTO(BaseModel):
-    id: int
-    name: str
-    email: str
-
-# repositories/user_repository.py
-class UserRepository:
-    def __init__(self, db: Session):
-        self.db = db
-    def find_by_id(self, user_id: int) -> User | None:
-        return self.db.get(User, user_id)
-
-# services/user_service.py
-class UserService:
-    def __init__(self, repo: UserRepository):
-        self.repo = repo
-    def get_user(self, user_id: int) -> User:
-        user = self.repo.find_by_id(user_id)
-        if user is None:
-            raise UserNotFoundError(user_id)
-        return user
-
-# controllers/user_controller.py
-@router.get("/users/{user_id}", response_model=UserResponseDTO)
-def get_user(user_id: int, service: UserService = Depends(get_user_service)):
-    try:
-        return service.get_user(user_id)
-    except UserNotFoundError:
-        raise HTTPException(status_code=404, detail="User not found")
-```
-
-Five files, three classes, a custom exception, and a dependency-injection chain, wrapping one database call.
-
-## With Lexis
-
-```python
-# lexis: drop the layers; keep the response schema, it whitelists what leaves the API
-class UserOut(BaseModel):
-    id: int
-    name: str
-    email: str
-
-@app.get("/users/{user_id}", response_model=UserOut)
-def get_user(user_id: int, db: Session = Depends(get_db)):
-    user = db.get(User, user_id)
-    if not user:
-        raise HTTPException(404)
-    return user
-```
-
-**5 files → 9 lines.** The repository, service, and custom exception were ceremony. The response schema was not: it whitelists which fields leave the API, so it stays. Returning the raw ORM model (`return user`) would leak every column, including the ones you never meant to expose. That is the line Lexis draws, and it is the same one the skill draws in "when NOT to be lazy": cut the layers, keep the trust boundary. Add a service layer when a second caller shows up, if it ever does.

package/examples/caching.md

@@ -1,74 +0,0 @@
-# Caching System
-
-**Task:** "We should cache these API responses."
-
-## Without Lexis
-
-```python
-import time
-import threading
-from collections import OrderedDict
-from dataclasses import dataclass
-from typing import Any, Optional
-
-
-@dataclass
-class CacheEntry:
-    value: Any
-    expires_at: float
-
-
-class TTLCache:
-    """Thread-safe LRU cache with per-entry TTL and max size."""
-
-    def __init__(self, max_size: int = 1000, default_ttl: float = 300.0):
-        self._store: OrderedDict[str, CacheEntry] = OrderedDict()
-        self._lock = threading.Lock()
-        self.max_size = max_size
-        self.default_ttl = default_ttl
-        self.hits = 0
-        self.misses = 0
-
-    def get(self, key: str) -> Optional[Any]:
-        with self._lock:
-            entry = self._store.get(key)
-            if entry is None or entry.expires_at < time.monotonic():
-                self.misses += 1
-                self._store.pop(key, None)
-                return None
-            self._store.move_to_end(key)
-            self.hits += 1
-            return entry.value
-
-    def set(self, key: str, value: Any, ttl: Optional[float] = None) -> None:
-        with self._lock:
-            if len(self._store) >= self.max_size:
-                self._store.popitem(last=False)
-            self._store[key] = CacheEntry(
-                value, time.monotonic() + (ttl or self.default_ttl)
-            )
-
-    # ... plus invalidation, stats endpoint, and unit tests for all of it
-```
-
-120 lines of custom infrastructure for a problem nobody has measured yet.
-
-## With Lexis
-
-First question: **do you actually need a cache?**
-
-- **Unsure?** Ship without it. Add it when you measure the problem. (YAGNI)
-- **Pure function, hot path?** The standard library has it:
-
-  ```python
-  # lexis: stdlib covers this
-  from functools import lru_cache
-
-  @lru_cache(maxsize=1000)
-  def fetch(key): ...
-  ```
-
-- **Real distributed caching needs?** Use Redis / memcached / your platform's
-  cache. Infrastructure problems get infrastructure, not a homemade class.
-
-**120 lines → 0–3 lines.** The fastest cache is the one you didn't have to debug.

package/examples/date-picker.md

@@ -1,48 +0,0 @@
-# Date Picker
-
-**Task:** "Add a date picker to this form."
-
-## Without Lexis
-
-```bash
-npm install flatpickr
-```
-
-```jsx
-import flatpickr from "flatpickr";
-import "flatpickr/dist/flatpickr.min.css";
-import { useEffect, useRef } from "react";
-
-export default function DatePicker({ value, onChange, minDate, maxDate }) {
-  const inputRef = useRef(null);
-  const instanceRef = useRef(null);
-
-  useEffect(() => {
-    instanceRef.current = flatpickr(inputRef.current, {
-      defaultDate: value,
-      minDate,
-      maxDate,
-      dateFormat: "Y-m-d",
-      onChange: ([date]) => onChange(date),
-    });
-    return () => instanceRef.current?.destroy();
-  }, []);
-
-  useEffect(() => {
-    instanceRef.current?.setDate(value, false);
-  }, [value]);
-
-  return <input ref={inputRef} className="date-picker" />;
-}
-```
-
-One dependency, one wrapper component, two `useEffect` hooks, a cleanup function, and a CSS import, to pick a date.
-
-## With Lexis
-
-```html
-<!-- lexis: browser has one -->
-<input type="date">
-```
-
-**1 dependency + 30 lines → 0 dependencies + 1 line.** Native, accessible, localized, keyboard-navigable, mobile-friendly. The browser team already did the work.

package/examples/email-validation.md

@@ -1,51 +0,0 @@
-# Email Validation
-
-**Task:** "Validate an email address in Python."
-
-## Without Lexis
-
-```python
-import re
-
-EMAIL_PATTERN = re.compile(
-    r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$'
-)
-
-class EmailValidator:
-    """Validates email addresses against RFC-like rules."""
-
-    def __init__(self, pattern: re.Pattern = EMAIL_PATTERN):
-        self.pattern = pattern
-
-    def validate(self, email: str) -> bool:
-        if not isinstance(email, str):
-            raise TypeError("email must be a string")
-        email = email.strip()
-        if not email:
-            return False
-        return bool(self.pattern.match(email))
-
-
-def validate_email(email: str) -> bool:
-    """Convenience wrapper around EmailValidator."""
-    return EmailValidator().validate(email)
-```
-
-A class, a wrapper, a regex that still rejects valid addresses and accepts invalid ones. Regex cannot validate email. Only a delivery attempt can.
-
-## With Lexis
-
-```python
-# lexis: good enough, real validation is sending the mail
-"@" in email and "." in email.split("@")[-1]
-```
-
-Or, if it must be thorough, the standard library has it:
-
-```python
-# lexis: stdlib covers this
-from email.utils import parseaddr
-"@" in parseaddr(email)[1]
-```
-
-**27 lines → 1 line.** And the honest answer: let the confirmation email reject it. That's what confirmation emails are for.

package/examples/sorting.md

@@ -1,42 +0,0 @@
-# Sorting
-
-**Task:** "Sort this array of numbers."
-
-## Without Lexis
-
-```js
-function quickSort(arr, compareFn = (a, b) => a - b) {
-  if (arr.length <= 1) return arr;
-
-  const pivot = arr[Math.floor(arr.length / 2)];
-  const left = [];
-  const right = [];
-  const equal = [];
-
-  for (const item of arr) {
-    const cmp = compareFn(item, pivot);
-    if (cmp < 0) left.push(item);
-    else if (cmp > 0) right.push(item);
-    else equal.push(item);
-  }
-
-  return [
-    ...quickSort(left, compareFn),
-    ...equal,
-    ...quickSort(right, compareFn),
-  ];
-}
-
-const sorted = quickSort(numbers);
-```
-
-A hand-rolled quicksort. It allocates three arrays per recursion level, blows the stack on large inputs, and replaces an engine-optimized native sort with homework.
-
-## With Lexis
-
-```js
-// lexis: this exists
-numbers.sort((a, b) => a - b)
-```
-
-**24 lines → 1 line.** Every runtime ships a sort tuned by people whose whole job is sorting. Use it.

package/gemini-extension.json

@@ -1,7 +0,0 @@
-{
-  "name": "lexis-two",
-  "version": "1.0.0",
-  "description": "The simple way to obtain the best code. Portable rules, skills, and slash commands for AI agents with lowest tokens usage.",
-  "contextFileName": "AGENTS.md",
-  "commands": "commands/"
-}

package/opencode.json

@@ -1,4 +0,0 @@
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["./.opencode/plugins/lexis-two.mjs"]
-}