@codyswann/lisa 2.269.0 → 2.269.1

package/plugins/lisa-wiki-cursor/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-wiki",
-  "version": "2.269.0",
+  "version": "2.269.1",
   "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-wiki-cursor/skills/lisa-wiki-add-role/SKILL.md

@@ -21,6 +21,11 @@ agent-team routing, private notebooks) is out of scope** — this skill only cre
 4. **Brain-pointed, not baked:** the subagent's instructions say *"your domain is `wiki/<owned>/`;
    `/query` it first, contribute via `/ingest`; stay in your lane."* It points at the live wiki so it
    never goes stale. Only its one-line `description` is synthesized from the wiki at generation time.
+5. **Serialize the description before rendering:** derive `roleDescriptionSerialized` with
+   `JSON.stringify(roleDescription)` or an exact equivalent that emits one JSON string literal on one
+   physical line. Substitute that serialized literal, including its surrounding quotes, directly for
+   `{{roleDescriptionSerialized}}` in both templates. Do not add another layer of quotes. This keeps
+   colon-space sequences, quotes, backslashes, and runtime newlines exact in both YAML and TOML.
 
 ## Rules
 - v1 instructs lane-keeping but does not *enforce* per-role write isolation (deferred).

package/plugins/lisa-wiki-cursor/templates/agents/role-agent.claude.md

@@ -1,6 +1,6 @@
 ---
 name: {{id}}
-description: {{roleDescription}}
+description: {{roleDescriptionSerialized}}
 ---
 
 You are **{{role}}** for {{org}} — the domain expert for {{expertise}}.

package/plugins/lisa-wiki-cursor/templates/agents/role-agent.codex.toml

@@ -1,5 +1,5 @@
 name = "{{id}}"
-description = "{{roleDescription}}"
+description = {{roleDescriptionSerialized}}
 developer_instructions = """
 You are {{role}} for {{org}} — the domain expert for {{expertise}}.
 

package/plugins/src/base/agents/learner.md

@@ -1,6 +1,6 @@
 ---
 name: learner
-description: Post-implementation learning agent. Capture-only — collects task learnings, builds seven-field entries, and persists them to the machine-managed ledger through the executable contract with provenance. Never promotes: it creates no skills, appends no rules, files no upstream issues; promotion is exclusively the gardener's ticket-gated job.
+description: "Post-implementation learning agent. Capture-only — collects task learnings, builds seven-field entries, and persists them to the machine-managed ledger through the executable contract with provenance. Never promotes: it creates no skills, appends no rules, files no upstream issues; promotion is exclusively the gardener's ticket-gated job."
 ---
 
 # Learner Agent

package/plugins/src/wiki/skills/lisa-wiki-add-role/SKILL.md

@@ -21,6 +21,11 @@ agent-team routing, private notebooks) is out of scope** — this skill only cre
 4. **Brain-pointed, not baked:** the subagent's instructions say *"your domain is `wiki/<owned>/`;
    `/query` it first, contribute via `/ingest`; stay in your lane."* It points at the live wiki so it
    never goes stale. Only its one-line `description` is synthesized from the wiki at generation time.
+5. **Serialize the description before rendering:** derive `roleDescriptionSerialized` with
+   `JSON.stringify(roleDescription)` or an exact equivalent that emits one JSON string literal on one
+   physical line. Substitute that serialized literal, including its surrounding quotes, directly for
+   `{{roleDescriptionSerialized}}` in both templates. Do not add another layer of quotes. This keeps
+   colon-space sequences, quotes, backslashes, and runtime newlines exact in both YAML and TOML.
 
 ## Rules
 - v1 instructs lane-keeping but does not *enforce* per-role write isolation (deferred).

package/plugins/src/wiki/templates/agents/role-agent.claude.md

@@ -1,6 +1,6 @@
 ---
 name: {{id}}
-description: {{roleDescription}}
+description: {{roleDescriptionSerialized}}
 ---
 
 You are **{{role}}** for {{org}} — the domain expert for {{expertise}}.

package/plugins/src/wiki/templates/agents/role-agent.codex.toml

@@ -1,5 +1,5 @@
 name = "{{id}}"
-description = "{{roleDescription}}"
+description = {{roleDescriptionSerialized}}
 developer_instructions = """
 You are {{role}} for {{org}} — the domain expert for {{expertise}}.
 

package/scripts/verify-learner-frontmatter-built.mjs

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+/** Empirical proof that built Codex and OpenCode installers preserve learner metadata. */
+import assert from "node:assert/strict";
+import { execFile } from "node:child_process";
+import { mkdtemp, readFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+import { load as loadYaml } from "js-yaml";
+import { parse as parseToml } from "smol-toml";
+import { discoverAndInstallAgents as installOpencodeAgents } from "../dist/opencode/agent-installer.js";
+
+const EXPECTED_DESCRIPTION =
+  "Post-implementation learning agent. Capture-only — collects task learnings, builds seven-field entries, and persists them to the machine-managed ledger through the executable contract with provenance. Never promotes: it creates no skills, appends no rules, files no upstream issues; promotion is exclusively the gardener's ticket-gated job.";
+const executeFile = promisify(execFile);
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const destination = await mkdtemp(
+  path.join(tmpdir(), "lisa-learner-frontmatter-built-")
+);
+
+try {
+  const codexOverlay = await executeFile(
+    process.execPath,
+    [path.join(root, "dist", "codex", "project-overlay.js"), destination],
+    { cwd: root }
+  );
+  const opencodeResult = await installOpencodeAgents(root, destination, []);
+
+  assert.match(
+    codexOverlay.stderr,
+    /Lisa Codex overlay: \d+ native skills from \d+ project plugins\./
+  );
+  assert.equal(
+    opencodeResult.installed.some(agent => agent.id === "learner"),
+    true
+  );
+
+  const codexAgent = parseToml(
+    await readFile(
+      path.join(destination, ".codex", "agents", "lisa", "learner.toml"),
+      "utf8"
+    )
+  );
+  assert.equal(codexAgent.name, "lisa-learner");
+  assert.equal(codexAgent.description, EXPECTED_DESCRIPTION);
+
+  const opencodeMarkdown = await readFile(
+    path.join(destination, ".opencode", "agents", "lisa-learner.md"),
+    "utf8"
+  );
+  const frontmatter = /^---\r?\n([\s\S]*?)\r?\n---/.exec(opencodeMarkdown);
+  assert.notEqual(frontmatter, null);
+  const opencodeAgent = loadYaml(frontmatter?.[1] ?? "");
+  assert.equal(typeof opencodeAgent, "object");
+  assert.notEqual(opencodeAgent, null);
+  assert.equal(opencodeAgent.description, EXPECTED_DESCRIPTION);
+  assert.equal(opencodeAgent.mode, "subagent");
+
+  console.log(
+    "[EVIDENCE: learner-frontmatter-built] codex=preserved opencode=preserved"
+  );
+} finally {
+  await rm(destination, { recursive: true, force: true });
+}