litcodex-ai 0.3.0

package/node_modules/@litcodex/lit-loop/dist/trigger.js

@@ -0,0 +1,75 @@
+// src/trigger.ts — M05 bounded lit trigger parser.
+//
+// Single source of truth for deciding whether a user prompt activates the LitCodex `lit-loop`
+// workflow. Pure, side-effect-free, Unicode-aware. Accepts the bounded tokens `lit`, `lit-loop`,
+// and `litcodex` (case-insensitive) and rejects every substring collision (`split`, `literal`,
+// `litmus`, `lithium`, `glitter`, `flit`, `slit`, `litter`, …) while respecting Korean (Hangul)
+// and English boundaries.
+//
+// This module imports NOTHING from `state-store`, `directive`, `guards`, `markers`, or
+// `codex-hook` (one-way: hook → trigger, never the reverse). It reads no files, touches no state,
+// emits no hook JSON, and never mutates the prompt. (A3 C9 flat layout; A2 §2.1 export surface.)
+/**
+ * Frozen tuple of the accepted tokens in match-priority (longest-first) order.
+ * Exported so tests and the mode router (modes.ts) can enumerate without re-deriving.
+ */
+export const LIT_TRIGGER_TOKENS = Object.freeze([
+    "lit-loop",
+    "lit-plan",
+    "litcodex",
+    "litgoal",
+    "litwork",
+    "lit",
+]);
+/**
+ * The single canonical matcher. Unicode + case-insensitive, NON-global, NON-sticky.
+ * Boundaries: a token must be preceded by start-of-string OR a non `[letter|number|_]`
+ * code point, and must NOT be followed by `[letter|number|_|-]`.
+ *
+ * MUST NOT carry the /g or /y flag: a global regex retains `lastIndex` between calls and would
+ * make `.test()` return alternating results for the same input. Longest-first alternation
+ * (`lit-loop|lit-plan|litcodex|litgoal|litwork|lit`) guarantees a longer family token wins over a
+ * bare `lit` at the same start; the trailing-`-` lookahead means `lit work` (space) is a bare `lit`
+ * while `litwork` (glued) is the work mode. No nested quantifiers / no backreferences ⇒ ReDoS-free.
+ */
+export const LIT_TRIGGER_PATTERN = /(?:^|[^\p{L}\p{N}_])(lit-loop|lit-plan|litcodex|litgoal|litwork|lit)(?![\p{L}\p{N}_-])/iu;
+const NOT_A_STRING = "lit trigger: prompt must be a string";
+/**
+ * Returns true iff `prompt` contains at least one bounded lit trigger.
+ *
+ * @param prompt Arbitrary untrusted user text (may be empty, multi-line, mixed-script).
+ * @throws TypeError if `prompt` is not a string (defensive guard for `unknown` callers).
+ */
+export function isLitTriggerPrompt(prompt) {
+    if (typeof prompt !== "string") {
+        throw new TypeError(NOT_A_STRING);
+    }
+    // Non-global pattern ⇒ lastIndex is always 0 ⇒ idempotent across repeated calls.
+    return LIT_TRIGGER_PATTERN.test(prompt);
+}
+/**
+ * Returns the FIRST bounded lit trigger match in document order, or null if none.
+ * Deterministic: identical input always yields the identical result.
+ *
+ * @param prompt Arbitrary untrusted user text.
+ * @returns LitTriggerMatch for the earliest match (lowest `index`), else null.
+ * @throws TypeError if `prompt` is not a string.
+ */
+export function matchLitTrigger(prompt) {
+    if (typeof prompt !== "string") {
+        throw new TypeError(NOT_A_STRING);
+    }
+    const m = prompt.match(LIT_TRIGGER_PATTERN);
+    if (m === null) {
+        return null;
+    }
+    const raw = m[1];
+    if (raw === undefined) {
+        // Unreachable: a successful match always populates capture group 1.
+        return null;
+    }
+    const token = raw.toLowerCase();
+    // Strip the optional leading boundary char so `index` points at the token's first char.
+    const index = (m.index ?? 0) + m[0].length - raw.length;
+    return { token, raw, index };
+}

package/node_modules/@litcodex/lit-loop/package.json

@@ -0,0 +1,27 @@
+{
+	"name": "@litcodex/lit-loop",
+	"version": "0.3.0",
+	"description": "LitCodex Lit-Loop runtime: durable repo-native multi-goal orchestration with embedded success criteria and observable evidence audit.",
+	"type": "module",
+	"bin": {
+		"litcodex-lit-loop": "./dist/cli.js"
+	},
+	"files": [
+		"dist",
+		"directives",
+		"agents",
+		"directive.md",
+		"LICENSE",
+		"NOTICE",
+		"README.md",
+		"CHANGELOG.md"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"typecheck": "tsc --noEmit",
+		"test": "vitest --run"
+	},
+	"engines": {
+		"node": ">=20.0.0"
+	}
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+	"name": "litcodex-ai",
+	"version": "0.3.0",
+	"description": "Codex loop harness installer. Run `npx litcodex-ai install` to set up the LitCodex Codex platform: the bare `lit` hook and the durable lit-loop runtime.",
+	"keywords": ["codex", "litcodex", "lit-loop", "ai-agents", "orchestration"],
+	"author": "LitCodex Authors",
+	"license": "MIT",
+	"repository": { "type": "git", "url": "git+https://github.com/<OWNER_PLACEHOLDER>/litcodex.git" },
+	"bugs": { "url": "https://github.com/<OWNER_PLACEHOLDER>/litcodex/issues" },
+	"homepage": "https://github.com/<OWNER_PLACEHOLDER>/litcodex#readme",
+	"type": "module",
+	"bin": {
+		"litcodex": "bin/litcodex.js"
+	},
+	"files": ["bin", "dist", "model-catalog.json", "README.md", "LICENSE"],
+	"dependencies": {
+		"@litcodex/lit-loop": "0.3.0"
+	},
+	"bundledDependencies": ["@litcodex/lit-loop"],
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"typecheck": "tsc --noEmit",
+		"test": "vitest --run",
+		"prepack": "node ../../scripts/prepack-bundle-component.mjs",
+		"postpack": "node ../../scripts/postpack-clean-component.mjs"
+	},
+	"engines": {
+		"node": ">=20.0.0"
+	}
+}