@draig/lexis-two 1.0.0 → 1.0.3

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/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/pi-extension/index.js

@@ -1,161 +0,0 @@
-import { createRequire } from "node:module";
-
-const require = createRequire(import.meta.url);
-const {
-  DEFAULT_MODE,
-  getDefaultMode,
-  normalizeMode,
-  normalizeConfigMode,
-  normalizePersistedMode,
-  writeDefaultMode,
-} = require("../hooks/lexis-two-config.js");
-const { getLexisInstructions, filterSkillBodyForMode } = require("../hooks/lexis-two-instructions.js");
-
-export { filterSkillBodyForMode };
-export const readDefaultMode = getDefaultMode;
-
-export function resolveSessionMode(entries, fallbackMode = DEFAULT_MODE) {
-  const fallback = normalizePersistedMode(fallbackMode) || DEFAULT_MODE;
-  if (!Array.isArray(entries)) return fallback;
-
-  for (let i = entries.length - 1; i >= 0; i -= 1) {
-    const entry = entries[i];
-    if (entry?.type !== "custom" || entry?.customType !== "lexis-two-mode") continue;
-
-    const mode = normalizePersistedMode(entry?.data?.mode);
-    if (mode) return mode;
-  }
-
-  return fallback;
-}
-
-export function parseLexisCommand(text, defaultMode = DEFAULT_MODE) {
-  const fallback = normalizePersistedMode(defaultMode) || DEFAULT_MODE;
-  const normalizedText = String(text || "").trim().toLowerCase();
-
-  if (!normalizedText) {
-    return { type: "set-mode", mode: fallback === "off" ? "full" : fallback };
-  }
-
-  const [primary, secondary] = normalizedText.split(/\s+/);
-
-  if (primary === "status") return { type: "status" };
-
-  if (primary === "default") {
-    const mode = normalizeConfigMode(secondary);
-    return mode ? { type: "set-default", mode } : { type: "invalid", reason: "invalid-default-mode" };
-  }
-
-  const mode = normalizeMode(primary);
-  return mode ? { type: "set-mode", mode } : { type: "invalid", reason: "invalid-mode", mode: primary };
-}
-
-export { writeDefaultMode };
-
-export default function lexisExtension(pi) {
-  let currentMode = DEFAULT_MODE;
-  let configuredDefaultMode = getDefaultMode();
-
-  const setMode = (mode, ctx) => {
-    const normalized = normalizePersistedMode(mode);
-    if (!normalized) return;
-
-    currentMode = normalized;
-    pi.appendEntry("lexis-two-mode", { mode: normalized });
-    ctx?.ui?.notify?.(`Lexis-Two mode set to ${normalized}.`, "info");
-  };
-
-  const sendAlias = (skillName, args, ctx) => {
-    const normalized = String(args || "").trim();
-    const message = normalized ? `${skillName} ${normalized}` : skillName;
-
-    if (ctx?.isIdle?.() === false) {
-      pi.sendUserMessage(message, { deliverAs: "followUp" });
-      ctx?.ui?.notify?.(`${skillName} queued as follow-up.`, "info");
-      return;
-    }
-
-    pi.sendUserMessage(message);
-  };
-
-  pi.registerCommand("lexis-two", {
-    description: "Set or report Lexis-Two mode",
-    handler: async (args, ctx) => {
-      const parsed = parseLexisCommand(args, configuredDefaultMode);
-
-      if (parsed.type === "status") {
-        ctx?.ui?.notify?.(`Lexis-Two: current ${currentMode} • default ${configuredDefaultMode}`, "info");
-        return;
-      }
-
-      if (parsed.type === "set-default") {
-        const written = writeDefaultMode(parsed.mode);
-        if (written) {
-          configuredDefaultMode = getDefaultMode();
-          const message = configuredDefaultMode === written
-            ? `Default Lexis-Two mode set to ${written}.`
-            : `Saved default ${written}, but env override keeps default at ${configuredDefaultMode}.`;
-          ctx?.ui?.notify?.(message, "info");
-        }
-        return;
-      }
-
-      if (parsed.type === "set-mode") {
-        setMode(parsed.mode, ctx);
-        return;
-      }
-
-      ctx?.ui?.notify?.("Unknown or unsupported /lexis-two mode.", "warning");
-    },
-  });
-
-  pi.registerCommand("lexis-two-review", {
-    description: "Run /skill:lexis-two-review",
-    handler: (_args, ctx) => sendAlias("/skill:lexis-two-review", "", ctx),
-  });
-
-  pi.registerCommand("lexis-two-audit", {
-    description: "Run /skill:lexis-two-audit",
-    handler: (_args, ctx) => sendAlias("/skill:lexis-two-audit", "", ctx),
-  });
-
-  pi.registerCommand("lexis-two-debt", {
-    description: "Run /skill:lexis-two-debt",
-    handler: (_args, ctx) => sendAlias("/skill:lexis-two-debt", "", ctx),
-  });
-
-  pi.registerCommand("lexis-two-plan", {
-    description: "Run /skill:lexis-two-plan",
-    handler: (_args, ctx) => sendAlias("/skill:lexis-two-plan", "", ctx),
-  });
-
-  pi.registerCommand("lexis-two-security", {
-    description: "Run /skill:lexis-two-security",
-    handler: (_args, ctx) => sendAlias("/skill:lexis-two-security", "", ctx),
-  });
-
-  pi.registerCommand("lexis-two-help", {
-    description: "Run /skill:lexis-two-help",
-    handler: (_args, ctx) => sendAlias("/skill:lexis-two-help", "", ctx),
-  });
-
-  pi.on("input", async (event) => {
-    if (event?.source === "extension") return;
-
-    const text = String(event?.text || "");
-    if (currentMode !== "off" && /\b(stop lexis|normal mode)\b/i.test(text)) {
-      setMode("off");
-    }
-  });
-
-  pi.on("session_start", async (_event, ctx) => {
-    const entries = ctx?.sessionManager?.getBranch?.() || ctx?.sessionManager?.getEntries?.() || [];
-    configuredDefaultMode = getDefaultMode();
-    currentMode = resolveSessionMode(entries, configuredDefaultMode);
-  });
-
-  pi.on("before_agent_start", async (event) => {
-    if (!currentMode || currentMode === "off") return;
-    return { systemPrompt: `${event.systemPrompt}\n\n${getLexisInstructions(currentMode)}` };
-  });
-}

package/pi-extension/package.json

@@ -1,8 +0,0 @@
-{
-  "name": "lexis-two-pi-extension-dev",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "test": "node --test ./test/*.test.js"
-  }
-}

package/pi-extension/test/extension.test.js

@@ -1,89 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import lexisExtension from "../index.js";
-
-class MockPi {
-  constructor() {
-    this.commands = {};
-    this.listeners = {};
-    this.entries = [];
-    this.userMessages = [];
-  }
-
-  registerCommand(name, config) {
-    this.commands[name] = config;
-  }
-
-  on(event, handler) {
-    this.listeners[event] = handler;
-  }
-
-  appendEntry(type, data) {
-    this.entries.push({ type, data });
-  }
-
-  sendUserMessage(text, options) {
-    this.userMessages.push({ text, options });
-  }
-}
-
-test("lexisExtension registers commands and listeners", () => {
-  const pi = new MockPi();
-  lexisExtension(pi);
-
-  assert.ok(pi.commands["lexis-two"]);
-  assert.ok(pi.commands["lexis-two-review"]);
-  assert.ok(pi.commands["lexis-two-audit"]);
-  assert.ok(pi.commands["lexis-two-debt"]);
-  assert.ok(pi.commands["lexis-two-plan"]);
-  assert.ok(pi.commands["lexis-two-security"]);
-  assert.ok(pi.commands["lexis-two-help"]);
-
-  assert.ok(pi.listeners["input"]);
-  assert.ok(pi.listeners["session_start"]);
-  assert.ok(pi.listeners["before_agent_start"]);
-});
-
-test("lexisExtension command handlers trigger correctly", async () => {
-  const pi = new MockPi();
-  lexisExtension(pi);
-
-  let notified = null;
-  const ctx = {
-    ui: {
-      notify: (msg, type) => {
-        notified = { msg, type };
-      },
-    },
-  };
-
-  await pi.commands["lexis-two"].handler("lite", ctx);
-  assert.equal(pi.entries[0].type, "lexis-two-mode");
-  assert.equal(pi.entries[0].data.mode, "lite");
-  assert.equal(notified.msg, "Lexis-Two mode set to lite.");
-
-  pi.commands["lexis-two-review"].handler("", ctx);
-  assert.equal(pi.userMessages[0].text, "/skill:lexis-two-review");
-});
-
-test("lexisExtension input listener detects deactivation", async () => {
-  const pi = new MockPi();
-  lexisExtension(pi);
-
-  let notified = null;
-  const ctx = {
-    ui: {
-      notify: (msg, type) => {
-        notified = { msg, type };
-      },
-    },
-  };
-
-  // Set mode to full first
-  await pi.commands["lexis-two"].handler("full", ctx);
-  assert.equal(pi.entries[0].data.mode, "full");
-
-  // Send input "stop lexis"
-  await pi.listeners["input"]({ text: "Please stop lexis now" });
-  assert.equal(pi.entries[1].data.mode, "off");
-});

package/pi-extension/test/helpers.test.js

@@ -1,35 +0,0 @@
-import test from "node:test";
-import assert from "node:assert/strict";
-import { resolveSessionMode, parseLexisCommand } from "../index.js";
-
-test("resolveSessionMode resolves mode from branch entries", () => {
-  const entries = [
-    { type: "user-message", text: "hello" },
-    { type: "custom", customType: "lexis-two-mode", data: { mode: "lite" } },
-    { type: "assistant-message", text: "world" },
-  ];
-  assert.equal(resolveSessionMode(entries, "full"), "lite");
-});
-
-test("resolveSessionMode falls back to default mode if no entries", () => {
-  assert.equal(resolveSessionMode([], "lite"), "lite");
-});
-
-test("parseLexisCommand parses empty command as default toggle", () => {
-  assert.deepEqual(parseLexisCommand("", "full"), { type: "set-mode", mode: "full" });
-  assert.deepEqual(parseLexisCommand("  ", "off"), { type: "set-mode", mode: "full" });
-});
-
-test("parseLexisCommand parses status command", () => {
-  assert.deepEqual(parseLexisCommand("status"), { type: "status" });
-});
-
-test("parseLexisCommand parses default command", () => {
-  assert.deepEqual(parseLexisCommand("default lite"), { type: "set-default", mode: "lite" });
-  assert.deepEqual(parseLexisCommand("default invalid"), { type: "invalid", reason: "invalid-default-mode" });
-});
-
-test("parseLexisCommand parses mode command", () => {
-  assert.deepEqual(parseLexisCommand("ultra"), { type: "set-mode", mode: "ultra" });
-  assert.deepEqual(parseLexisCommand("invalid"), { type: "invalid", reason: "invalid-mode", mode: "invalid" });
-});

package/scripts/check-rule-copies.js

@@ -1,82 +0,0 @@
-#!/usr/bin/env node
-// lexis-two — rule copy integrity check
-//
-// To avoid runtime overhead, instruction-tier hosts (Windsurf, Cline, Kiro,
-// Cursor) load static copies of the rules. This script acts as a build/CI guard
-// to ensure those copies never drift from the canonical source (AGENTS.md).
-//
-// It asserts that:
-//   1. Every rule copy file exists.
-//   2. Every copy is completely identical to AGENTS.md (ignoring host-specific frontmatter).
-//   3. The canonical AGENTS.md itself contains the load-bearing Lexis-Two rules.
-
-const fs = require('fs');
-const path = require('path');
-
-const root = path.join(__dirname, '..');
-
-// Canonical source of truth
-const SOURCE_FILE = 'AGENTS.md';
-
-// Static copies to validate
-const COPIES = [
-  '.windsurf/rules/lexis-two.md',
-  '.clinerules/lexis-two.md',
-  '.kiro/steering/lexis-two.md',
-  '.cursor/rules/lexis-two.mdc',
-];
-
-// Load-bearing phrases that MUST exist in the source of truth. If these are
-// missing, the source file has been gutted, and the copies are validating
-// against an empty shell.
-const INVARIANTS = [
-  'lazy senior',
-  'Input validation at trust boundaries',
-  'YAGNI',
-];
-
-function read(relPath) {
-  try {
-    return fs.readFileSync(path.join(root, relPath), 'utf8');
-  } catch (e) {
-    console.error(`Error: failed to read ${relPath}`);
-    process.exit(1);
-  }
-}
-
-// 1. Validate canonical source
-const source = read(SOURCE_FILE);
-for (const phrase of INVARIANTS) {
-  if (!source.includes(phrase)) {
-    console.error(`Error: canonical source (${SOURCE_FILE}) is missing load-bearing rule: "${phrase}"`);
-    process.exit(1);
-  }
-}
-
-// Helper to strip frontmatter (metadata blocks between '---' at start of file)
-function stripFrontmatter(content) {
-  return content.replace(/^---[\s\S]*?---\s*/, '');
-}
-
-// 2. Validate copies
-let failed = false;
-const canonicalBody = stripFrontmatter(source).trim();
-
-for (const copyPath of COPIES) {
-  const copyContent = read(copyPath);
-  const copyBody = stripFrontmatter(copyContent).trim();
-
-  if (copyBody !== canonicalBody) {
-    console.error(`Drift detected: ${copyPath} does not match ${SOURCE_FILE}`);
-    failed = true;
-  }
-}
-
-if (failed) {
-  console.error('\nIntegrity check FAILED. Rule copies have drifted from AGENTS.md.');
-  console.error('To fix, copy AGENTS.md content into the drifted files, preserving their frontmatter if any.');
-  process.exit(1);
-}
-
-console.log('Rule copy integrity check PASSED.');
-process.exit(0);

package/site/astro.config.mjs

@@ -1,18 +0,0 @@
-import { defineConfig } from "astro/config";
-import sitemap from "@astrojs/sitemap";
-
-export default defineConfig({
-  site: "https://lexis-two.excelso.xyz",
-  output: "static",
-  i18n: {
-    defaultLocale: "en",
-    locales: ["en", "es"],
-    routing: {
-      prefixDefaultLocale: false,
-    },
-  },
-  build: {
-    format: "directory",
-  },
-  integrations: [sitemap()],
-});