@litfamily/litopencode 1.0.1 → 1.0.3

package/docs/lit-mark.md

@@ -31,16 +31,20 @@ non-TTY output and JSON also disable ANSI. A non-UTF-8 locale or `TERM=dumb` sel
 Locale precedence is `LC_ALL`, `LC_CTYPE`, then `LANG`; an absent locale is conservative.
 
 OpenCode's first `experimental.text.complete` for each session displays the standard
-mark. Each later completion displays micro with `litopencode · <discipline>`. The
-completion hook is the session-start surface because plugin initialization has no
-session ID. Deleting a session clears both its first-completion and discipline state;
-plugin disposal clears all state. A new root user turn resets the prior discipline,
+mark. Each later completion displays micro with `🔥 LIT IGNITED · <discipline> 🔥`
+after its middle row. The completion hook is the session-start surface because plugin
+initialization has no session ID. Deleting a session clears both its first-completion
+and discipline state; plugin disposal clears all state. A new root user turn resets the prior discipline,
 and a trusted chat, command, or successful activation-tool result selects the current
 one. Status and blocked tool results do not change the discipline. Unactivated turns use `lit-loop`.
 Marks are fenced Markdown without ANSI because OpenCode renders completion text as
 Markdown, including when its process owns a colored terminal.
 
-The model must begin its reply with exactly one `▲ LIT · <discipline>` line. Prompts
-require this explicitly. The completion hook adds the separate harness mark and
-preserves the model's response, including a missing or malformed probe, so the harness
-cannot manufacture evidence that the model obeyed the prompt.
+The model must begin its reply with exactly one `🔥 **LIT IGNITED · <discipline>** 🔥` line. Prompts
+require this explicitly. Activation messages use the plain `🔥 LIT IGNITED · <discipline> 🔥`
+banner. On successful activation, the plugin also requests a six-second warning toast titled
+`🔥 LIT IGNITED` with the five trimmed micro rows followed by that label when the environment
+supports mark glyphs; otherwise it shows only the label. Toast messages never contain ANSI. A
+missing or failing TUI client never blocks prompt injection. The completion hook adds the separate
+harness mark and preserves the model's response, including a missing or malformed probe, so the
+harness cannot manufacture evidence that the model obeyed the prompt.

package/docs/privacy.md

@@ -12,7 +12,7 @@ providers, npm, and other tools have their own behavior and policies.
 | --- | --- |
 | Project `.litopencode/config.json` and `state.json` | Project configuration and runtime state. |
 | Project `.litopencode/litgoal/lit-loop/` | Goals, criteria, checkpoints, session identifiers, evidence references, a brief, ledger events, and bounded lifecycle state used to resume work. Evidence files can contain commands, output, or project material. |
-| Project `.litopencode/knowledge/` and skill-learning state | Locally captured knowledge, reviews, proposals, and mutation/rollback records when those features are used. |
+| Project `.litopencode/knowledge/` | Locally captured knowledge claims and review state. Legacy skill-learning files from earlier releases are left untouched and are no longer read. |
 | Project `.litopencode/logs/litopencode.log` | The logger's JSON-lines destination for timestamps, levels, and messages when explicitly enabled. The current server creates the logger with logging disabled by default. |
 | OpenCode config root | Plugin registration, `litopencode.json` routes and choices, and installed command/skill files. The default is `~/.config/opencode`; `XDG_CONFIG_HOME` or a CLI `--root` changes the applicable root. |
 | Home `~/.litopencode/` | Update cache, locks, transaction journal and receipt, and retained recovery backups after an unsuccessful automatic update. Backups can contain OpenCode configuration and installed command/skill content. |
@@ -76,7 +76,7 @@ See the [removal reference](reference.md#remove) and [security reporting](../SEC
 
 In a source checkout, the relevant implementations are `src/state.ts`,
 `src/logger.ts`, `src/server.ts`, `src/ledger.ts`, `src/knowledge.ts`,
-`src/skill-loop/`, `src/cli/update-notifier.ts`, `src/cli/auto-update.ts`,
+`src/cli/update-notifier.ts`, `src/cli/auto-update.ts`,
 `src/cli/model-catalog.ts`, and `src/lit-fetch*.ts`. Source files are excluded from
 the npm payload; package users receive the compiled runtime. These boundaries
 should be reviewed whenever storage, update, or retrieval behavior changes.

package/docs/reference.md

@@ -189,54 +189,12 @@ Native goal verdict: the OpenCode host surface does not currently expose a nativ
 LitOpenCode uses `.litopencode/litgoal` instead. Static skills are installed under
 `skills/*/SKILL.md` and remain documentation unless a documented OpenCode route selects them.
 
-## Skill learning loop
+## Skill learning state
 
-Skill Observer can turn bounded observations and a per-session tool-iteration reminder into
-pending skill proposals. The hook only updates project-local counters and surfaces a notice; it
-does not call a model or edit a skill. Review remains a foreground user action:
-
-```sh
-litopencode skill-loop review
-litopencode skill-loop propose <proposal.json>
-litopencode skill-loop list
-litopencode skill-loop apply <proposal-id>
-litopencode skill-loop reject <proposal-id>
-litopencode skill-loop rollback <ledger-id>
-litopencode skill-curator status
-litopencode skill-curator run
-```
-
-Nothing is applied without the explicit `skill-loop apply` command; shipped configuration keeps
-`autoApply: false`. New skills are written only to the OpenCode user skill root —
-`$XDG_CONFIG_HOME/opencode/skills/<name>/`, or `~/.config/opencode/skills/<name>/` when XDG is
-unset — with the distinct `metadata.litopencodeAgentGenerated: "true"` marker. Shipped,
-installer-managed, unmarked, and unsafe targets are refused.
-
-`skill-loop review` runs in an empty temporary home/config directory with tools and permissions
-denied, on the configured `review` category route (provider, model, and effort from
-`litopencode.json`) so a Grok-configured install never needs an OpenAI token. Set
-`LITOPENCODE_REVIEW_HOST` only to an absolute OpenCode launcher you intend LitOpenCode
-to pin and execute. If a host-native credential is already available as a narrow environment
-variable, opt in by naming it with `LITOPENCODE_REVIEW_CREDENTIAL_ENV=NAME[,NAME...]`; when that
-descriptor is unset, the configured review provider's own variable (for example `XAI_API_KEY`)
-is forwarded if present. OAuth-only hosts can opt in with `LITOPENCODE_REVIEW_AUTH=host`, which
-copies exactly the configured review provider's entry from the OpenCode auth store into the
-isolated child — nothing else. Help probes remain credential-free, and credential values are
-never placed in arguments, prompts, logs, or evidence.
-
-The learning loop's review, user-skill mutation, rollback, and curator boundaries currently support
-POSIX hosts (including macOS and Linux). On Windows those global/model boundaries fail closed with
-`WINDOWS_SKILL_LOOP_UNSUPPORTED` pending native handle and ACL support. Project-local listing and
-proposal intake remain available; this limitation does not affect install, doctor, or other passive
-LitOpenCode surfaces.
-
-Each successful mutation records content-addressed before/after state in the project-local
-`.litopencode/skill-ledger.jsonl`; rollback first verifies that current bytes still match the
-recorded after-image. The shipped config records a seven-day curator interval and a two-hour idle
-window for callers, but this release starts no background scheduler. A user-invoked
-`skill-curator run` marks eligible active entries stale after 30 days and moves already-stale
-entries to a recoverable archive after 90 days. Pinned entries are skipped, and archive transitions
-preserve bytes rather than deleting them.
+Earlier releases wrote observation, review, and mutation records under project `.litopencode`
+directories. Current LitOpenCode does not read, modify, or remove those legacy files; they are inert
+and remain under the project owner's control. Other project-local state such as the goal ledger and
+knowledge store continues to work independently.
 
 ## Runtime Skills
 
@@ -292,7 +250,6 @@ flowchart LR
 - <code>review-work</code>
 - <code>rules</code>
 - <code>search-workflow-ideas</code>
-- <code>skill-observer</code>
 - <code>start-work</code>
 - <code>structural-search</code>
 - <code>lit-korean</code>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@litfamily/litopencode",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "LitOpenCode OpenCode plugin bootstrap package.",
   "license": "MIT",
   "repository": {
@@ -30,6 +30,7 @@
     "check:version": "node tools/check-version-lockstep.mjs",
     "check:managed-skill-manifest": "node tools/gen-managed-skill-manifest.mjs --check",
     "gen:managed-skill-manifest": "node tools/gen-managed-skill-manifest.mjs",
+    "prepublishOnly": "node tools/prepublish-test-gate.mjs",
     "prepack": "npm run build",
     "pretest": "npm run build",
     "qa:behavior-replacement": "node tools/run-behavior-replacement-probes.mjs",

package/skills/frontend-ui-ux/references/complete-contract.md

@@ -254,7 +254,7 @@ $ opencode debug skill                            # OpenCode 1.18.4
 frontend-ui-ux -> $ISO_ROOT/skills/frontend-ui-ux/SKILL.md
 
 $ opencode debug config
-plugin: ["file:///.../32_litopencode"]
+plugin: ["file:///path/to/litopencode"]
 mcp: []
 command count: 18
 lit-plan permission: {"edit": "deny", "bash": "deny", "task": "deny"}

package/skills/lit-handoff/SKILL.md

@@ -6,7 +6,7 @@ description: "OpenCode-native adapter for the exact Lit Handoff continuation con
 # Lit Handoff
 
 > [!IMPORTANT]
-> On activation, the first model-emitted line must be exactly `▲ LIT · lit-handoff`.
+> On activation, the first model-emitted line must be exactly `🔥 **LIT IGNITED · lit-handoff** 🔥`.
 
 ## #contract.activation
 
@@ -17,7 +17,7 @@ skill_name: lit-handoff
 host: OpenCode
 native_entrypoint: skills/lit-handoff/SKILL.md
 exact_source_root: ../../vendor/handoff
-activation_banner: "▲ LIT · lit-handoff"
+activation_banner: "🔥 **LIT IGNITED · lit-handoff** 🔥"
 routes:
   - /lit-handoff
   - exact bare handoff chat message
@@ -62,7 +62,7 @@ mentioned during diagnosis or review.
 
 ## #contract.procedure
 
-1. Emit `▲ LIT · lit-handoff` exactly once before any other model-emitted text. The harness renders the logo separately.
+1. Emit `🔥 **LIT IGNITED · lit-handoff** 🔥` exactly once before any other model-emitted text. The harness renders its plain activation banner and logo separately.
 2. Read `../../vendor/handoff/SKILL.md` completely. Treat its destination resolution, existing-file
    classification, evidence rules, required sections, and resumability audit as binding.
 3. Resolve `SKILL_ROOT` to `../../vendor/handoff/` and read `../../vendor/handoff/templates/HANDOFF.md` before

package/skills/lit-plan/SKILL.md

@@ -348,4 +348,4 @@ Do not call OpenCode's task tool from `lit-plan`, even for a nominally read-only
 
 ## Approval Language
 
-End planning with a clear boundary. Example: “If you approve this plan, run `/start-work`; implementation should stay within `32_litopencode`, change docs/tests only, run targeted tests, then run `npm test`, and stop before any version bump, commit, tag, push, publish, or release.” This sentence prevents accidental mutation from planning mode and gives the next agent a precise starting point.
+End planning with a clear boundary. Example: “If you approve this plan, run `/start-work`; implementation should stay within this product checkout, change docs/tests only, run targeted tests, then run `npm test`, and stop before any version bump, commit, tag, push, publish, or release.” This sentence prevents accidental mutation from planning mode and gives the next agent a precise starting point.

package/skills/lit-scientific-visualization/SKILL.md

@@ -6,7 +6,7 @@ description: "OpenCode-native adapter for the exact scientific-visualization ski
 # Lit Scientific Visualization
 
 > [!IMPORTANT]
-> On activation, the first model-emitted line must be exactly `▲ LIT · lit-scientific-visualization`.
+> On activation, the first model-emitted line must be exactly `🔥 **LIT IGNITED · lit-scientific-visualization** 🔥`.
 
 ## #contract.activation
 
@@ -17,7 +17,7 @@ skill_name: lit-scientific-visualization
 host: OpenCode
 native_entrypoint: skills/lit-scientific-visualization/SKILL.md
 exact_source_root: ../../vendor/scientific-visualization
-activation_banner: "▲ LIT · lit-scientific-visualization"
+activation_banner: "🔥 **LIT IGNITED · lit-scientific-visualization** 🔥"
 routes:
   - /lit-scientific-visualization
   - exact bare lit-scientific-visualization
@@ -139,7 +139,7 @@ limitations_channel: reply
 - Route safety: only `/lit-scientific-visualization`, exact bare
   `lit-scientific-visualization`, and native discovery invoke the adapter; generic,
   quoted, fenced, multipart mixed, and near-miss forms remain inert.
-- Probe safety: the model emits `▲ LIT · lit-scientific-visualization` exactly once as
+- Probe safety: the model emits `🔥 **LIT IGNITED · lit-scientific-visualization** 🔥` exactly once as
   its first reply line. The OpenCode completion hook renders a standard mark for the
   first session completion and micro marks later, without fabricating the model probe
   or sharing activation state across sessions.

package/skills/managed-skill-manifest.json

@@ -189,7 +189,7 @@
         },
         {
           "path": "references/complete-contract.md",
-          "sha256": "792df3962f252cb0625879aaa87daf362e290b4ca19ef92f852f4315fe3f4fb5"
+          "sha256": "74732c1ae7c720133a7c20c2cc1836453393a5a61ef556f62dcc8162116b8401"
         },
         {
           "path": "references/composition.md",
@@ -992,7 +992,7 @@
         },
         {
           "path": "references/complete-contract.md",
-          "sha256": "c9f472ddd692851601414cb1eef2564fa9935edb9f382e33b3cd38650e97cd3b"
+          "sha256": "0dd57b7340d9d0488aa88909f7bafcd8aac859c6fc36344e994f71f9c5667ecf"
         },
         {
           "path": "schemas/evidence-manifest-v1alpha1.json",
@@ -1364,13 +1364,6 @@
           "sha256": "f624ad714f2c2420d9b1050dfecfa6dfa8384197bc2ea3822d8e73cc3fd7f28e"
         }
       ]
-    },
-    "skill-observer": {
-      "distributionFiles": [
-        "SKILL.md",
-        "references/review-contract.md"
-      ],
-      "canonicalFiles": []
     }
   },
   "renamedSkills": {

package/skills/visual-qa/references/complete-contract.md

@@ -354,7 +354,7 @@ $ opencode debug skill                            # OpenCode 1.18.4
 visual-qa -> $ISO_ROOT/skills/visual-qa/SKILL.md
 
 $ opencode debug config
-plugin: ["file:///.../32_litopencode"]
+plugin: ["file:///path/to/litopencode"]
 mcp: []
 command count: 18
 lit-plan permission: {"edit": "deny", "bash": "deny", "task": "deny"}

package/tools/check-payload-substance.mjs

@@ -33,13 +33,66 @@ const PACKED_REFERENCE_ROOTS = new Set(["references", "scripts", "assets", "temp
 export const PARITY_FRACTION = 0.5;
 const PRODUCT_ID = "p32";
 const P31_PUBLISHED_PACKAGE_RELATIVE = join("packages", "litcodex-ai");
-const FAMILY_LAYOUT = Object.freeze([
-  { id: "p27", packageRelative: ["27_PRIVATE_litclaude"], skillRootRelative: join("plugins", "litclaude", "skills"), packPrefix: "plugins/litclaude/skills" },
-  { id: "p28", packageRelative: ["28_PRIVATE_lithermes", "packages", "lithermes-installer"], skillRootRelative: join("assets", "lithermes-plugin", "skills"), packPrefix: "assets/lithermes-plugin/skills" },
-  { id: "p31", packageRelative: ["31_litcodex", "litcodex"], packRootRelative: ["31_litcodex", "litcodex", "packages", "litcodex-ai"], packWithScripts: true, skillRootRelative: join("plugins", "litcodex", "skills") },
-  { id: "p32", packageRelative: ["32_litopencode"], skillRootRelative: "skills", packPrefix: "skills" },
-  { id: "p33", packageRelative: ["33_litgrok"], skillRootRelative: join(".grok", "skills"), packPrefix: ".grok/skills" },
-]);
+const PRODUCT_IDS = Object.freeze(["p27", "p28", "p31", "p32", "p33"]);
+
+function validateRelativePath(value, field) {
+  if (typeof value !== "string" || value.length === 0 || value.startsWith("/") || value.includes("\\")) {
+    throw new Error(`PAYLOAD_FAMILY_LAYOUT_INVALID: ${field} must be a relative path`);
+  }
+  const parts = value.split("/");
+  if (parts.some((part) => part === "" || part === "." || part === "..")) {
+    throw new Error(`PAYLOAD_FAMILY_LAYOUT_INVALID: ${field} must not contain empty or parent segments`);
+  }
+  return value;
+}
+
+function validateRelativeParts(value, field) {
+  if (!Array.isArray(value) || value.length === 0 || value.some((part) => typeof part !== "string" || part.length === 0 || part === "." || part === ".." || part.includes("/") || part.includes("\\"))) {
+    throw new Error(`PAYLOAD_FAMILY_LAYOUT_INVALID: ${field} must be a non-empty relative path-part array`);
+  }
+  return value;
+}
+
+function normalizeFamilyLayout(value) {
+  if (!Array.isArray(value)) throw new Error("PAYLOAD_FAMILY_LAYOUT_INVALID: expected an array");
+  const seen = new Set();
+  const layout = value.map((entry, index) => {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) throw new Error(`PAYLOAD_FAMILY_LAYOUT_INVALID: entry ${index} must be an object`);
+    const id = entry.id;
+    if (!PRODUCT_IDS.includes(id) || seen.has(id)) throw new Error(`PAYLOAD_FAMILY_LAYOUT_INVALID: unknown or duplicate product id ${id}`);
+    seen.add(id);
+    const normalized = {
+      id,
+      packageRelative: validateRelativeParts(entry.packageRelative, `${id}.packageRelative`),
+      skillRootRelative: validateRelativePath(entry.skillRootRelative, `${id}.skillRootRelative`),
+    };
+    if (entry.packWithScripts === true) normalized.packWithScripts = true;
+    if (entry.packRootRelative !== undefined) normalized.packRootRelative = validateRelativeParts(entry.packRootRelative, `${id}.packRootRelative`);
+    if (!normalized.packWithScripts) normalized.packPrefix = validateRelativePath(entry.packPrefix, `${id}.packPrefix`);
+    return normalized;
+  });
+  if (seen.size !== PRODUCT_IDS.length || PRODUCT_IDS.some((id) => !seen.has(id))) {
+    throw new Error(`PAYLOAD_FAMILY_LAYOUT_INVALID: expected product ids ${PRODUCT_IDS.join(",")}`);
+  }
+  return Object.freeze(layout);
+}
+
+export function loadFamilyLayout(source) {
+  if (typeof source !== "string" || source.trim().length === 0) {
+    throw new Error("PAYLOAD_FAMILY_LAYOUT_REQUIRED: pass --family-layout or set LITOPENCODE_FAMILY_LAYOUT");
+  }
+  const candidate = source.trim();
+  let raw = candidate;
+  const candidatePath = resolve(process.cwd(), candidate);
+  if (existsSync(candidatePath) && lstatSync(candidatePath).isFile()) raw = readFileSync(candidatePath, "utf8");
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    throw new Error(`PAYLOAD_FAMILY_LAYOUT_INVALID: expected JSON text or a JSON file (${error.message})`);
+  }
+  return normalizeFamilyLayout(parsed);
+}
 
 function regularFiles(directory, relativePath = "") {
   const files = [];
@@ -117,7 +170,7 @@ export function loadParityManifest(filePath) {
   if (!validIsoDate(parsed.generatedAt)) throw new Error("PARITY_MANIFEST_DATE_INVALID");
   if (typeof parsed.fraction !== "number" || !Number.isFinite(parsed.fraction) || parsed.fraction !== PARITY_FRACTION) throw new Error("PARITY_MANIFEST_FRACTION_INVALID");
   if (parsed.scope !== "parity-enrolled") throw new Error("PARITY_MANIFEST_SCOPE_INVALID");
-  const productIds = FAMILY_LAYOUT.map(({ id }) => id);
+  const productIds = PRODUCT_IDS;
   const actualProductIds = Object.keys(parsed.products).sort();
   if (actualProductIds.join(",") !== [...productIds].sort().join(",")) throw new Error("PARITY_MANIFEST_PRODUCTS_INVALID");
   const products = new Map();
@@ -583,8 +636,8 @@ function measureProduct(familyRoot, layout) {
   return { id: layout.id, productRoot, skills: resolveClosures(productRoot, skillRoot, skills, packPaths, packPrefix), divergences };
 }
 
-export function measureFamily(familyRoot) {
-  return FAMILY_LAYOUT.map((layout) => measureProduct(familyRoot, layout));
+export function measureFamily(familyRoot, familyLayout) {
+  return familyLayout.map((layout) => measureProduct(familyRoot, layout));
 }
 
 function median(values) {
@@ -661,19 +714,9 @@ export function evaluateManifestFreshness({ manifest, measurements }) {
   return { failures };
 }
 
-function findFamilyRoot(start) {
-  let cursor = resolve(start);
-  for (;;) {
-    if (FAMILY_LAYOUT.every((layout) => existsSync(resolve(cursor, ...layout.packageRelative)))) return cursor;
-    const parent = dirname(cursor);
-    if (parent === cursor) return undefined;
-    cursor = parent;
-  }
-}
-
-function matchingProductId(familyRoot, productRoot) {
+function matchingProductId(familyRoot, productRoot, familyLayout) {
   const resolvedProduct = resolve(productRoot);
-  return FAMILY_LAYOUT.find((layout) => resolve(familyRoot, ...layout.packageRelative) === resolvedProduct)?.id;
+  return familyLayout.find((layout) => resolve(familyRoot, ...layout.packageRelative) === resolvedProduct)?.id;
 }
 
 function option(argv, name) {
@@ -685,7 +728,7 @@ function option(argv, name) {
 }
 
 export function run(argv = process.argv.slice(2)) {
-  const allowed = new Set(["--skill-root", "--allowlist-file", "--pack-json", "--family-root", "--product-root", "--product-id", "--parity-manifest", "--reference-exemptions"]);
+  const allowed = new Set(["--skill-root", "--allowlist-file", "--pack-json", "--family-root", "--family-layout", "--product-root", "--product-id", "--parity-manifest", "--reference-exemptions"]);
   for (const arg of argv) if (arg.startsWith("--") && !allowed.has(arg)) throw new Error(`UNKNOWN_OPTION: ${arg}`);
   const productRoot = resolve(option(argv, "--product-root") ?? PRODUCT_ROOT);
   const skillRoot = resolve(productRoot, option(argv, "--skill-root") ?? SKILL_ROOT_RELATIVE);
@@ -706,12 +749,15 @@ export function run(argv = process.argv.slice(2)) {
     if (!targetId) throw new Error("PAYLOAD_PARITY_TARGET_UNKNOWN: pass --product-id for a product outside the family root");
     parity = evaluateManifestParity({ manifest, targetId, productRoot, skillRoot, packPaths, packPrefix: PACK_PREFIX, divergences: loadParityDivergences(allowlistPath) });
   }
-  const requestedFamilyRoot = option(argv, "--family-root");
-  const familyRoot = requestedFamilyRoot ? resolve(process.cwd(), requestedFamilyRoot) : (customInputs ? undefined : findFamilyRoot(productRoot));
+  const requestedFamilyRoot = option(argv, "--family-root") ?? process.env.LITOPENCODE_FAMILY_ROOT;
+  const requestedFamilyLayout = option(argv, "--family-layout") ?? process.env.LITOPENCODE_FAMILY_LAYOUT;
+  if (Boolean(requestedFamilyRoot) !== Boolean(requestedFamilyLayout)) throw new Error("FAMILY_LAYOUT_REQUIRED: provide both --family-root and --family-layout");
+  const familyRoot = requestedFamilyRoot ? resolve(process.cwd(), requestedFamilyRoot) : undefined;
   if (!familyRoot) return { ...report, references, parity, freshness: undefined };
-  const targetId = option(argv, "--product-id") ?? matchingProductId(familyRoot, productRoot) ?? (productRoot === PRODUCT_ROOT ? PRODUCT_ID : undefined);
+  const familyLayout = loadFamilyLayout(requestedFamilyLayout);
+  const targetId = option(argv, "--product-id") ?? matchingProductId(familyRoot, productRoot, familyLayout) ?? (productRoot === PRODUCT_ROOT ? PRODUCT_ID : undefined);
   if (!targetId) throw new Error("PAYLOAD_PARITY_TARGET_UNKNOWN: pass --product-id for a product outside the family root");
-  const measurements = measureFamily(familyRoot);
+  const measurements = measureFamily(familyRoot, familyLayout);
   return { ...report, references, parity, freshness: evaluateManifestFreshness({ manifest: loadParityManifest(parityManifestPath), measurements }) };
 }
 
@@ -730,6 +776,7 @@ if (resolve(process.argv[1] ?? "") === fileURLToPath(import.meta.url)) {
         for (const row of report.parity.rows) process.stdout.write(`${row}\n`);
       }
       if (report.freshness) process.stdout.write("PAYLOAD_PARITY_FRESHNESS_PASS: family-manifest\n");
+      else process.stdout.write("PAYLOAD_PARITY_FRESHNESS_SKIP: family-layout not configured\n");
     }
   } catch (error) {
     process.stderr.write(`PAYLOAD_SUBSTANCE_ERROR: ${error instanceof Error ? error.message : String(error)}\n`);

package/tools/harness-speed-local.mjs

@@ -5,10 +5,11 @@ import path from "node:path";
 import process from "node:process";
 import { pathToFileURL } from "node:url";
 import { validateScenarioBytes } from "../qa/harness-speed-contract.mjs";
+import { activationBanner as renderActivationBanner } from "../src/activation-probe.ts";
 
 const receiptSchema = "litfamily.harness-speed-local/v1";
 const expectedProduct = "litopencode";
-const activationBanner = "▲ LIT · lit-loop";
+const activationBanner = renderActivationBanner("lit-loop");
 const phaseNames = Object.freeze([
   "packed_startup_config",
   "rules_transform",

package/tools/payload-substance-parity.json

@@ -35,15 +35,14 @@
         "refactor",
         "review-work",
         "rules",
-        "skill-observer",
         "start-work",
         "structural-search",
         "visual-qa",
         "wikify"
       ],
       "inventory": {
-        "count": 34,
-        "sha256": "9eecdbe41a48709db65188f0c6f4eee2247d27aaa33112977b49219d248fae29"
+        "count": 33,
+        "sha256": "e89f1e4756229b543d5852a7e30264a7aa119d2ed37516db8a8cde10660ddda0"
       }
     },
     "p28": {
@@ -75,15 +74,14 @@
         "refactor",
         "review-work",
         "rules",
-        "skill-observer",
         "start-work",
         "structural-search",
         "visual-qa",
         "wikify"
       ],
       "inventory": {
-        "count": 32,
-        "sha256": "0bef1ca66b2c8b7d54f175bc0b3f6046cd854dbd34c637819b697ed776858cc6"
+        "count": 31,
+        "sha256": "9676a2699c14e7c2901e6ae2bbe8a5b9df4357dc6dd8de79ff8f766d09c72b6c"
       }
     },
     "p31": {
@@ -122,15 +120,14 @@
         "refactor",
         "review-work",
         "rules",
-        "skill-observer",
         "start-work",
         "structural-search",
         "visual-qa",
         "wikify"
       ],
       "inventory": {
-        "count": 39,
-        "sha256": "79975bab9d38c00e3289d307a5e12543556f11262cd00054ef00cb8df2afba79"
+        "count": 38,
+        "sha256": "42876fd3b6b0a269ddc97a8c378866211b863100fac2a1f79fb1c49ea61973ae"
       }
     },
     "p32": {
@@ -169,7 +166,6 @@
         "review-work",
         "rules",
         "search-workflow-ideas",
-        "skill-observer",
         "start-work",
         "structural-search",
         "tool-guards",
@@ -178,8 +174,8 @@
         "workflow-loop"
       ],
       "inventory": {
-        "count": 41,
-        "sha256": "2ad9db6ffd956813ad489233343f1e91f52b2cf21a7a206880da011eb9995ccb"
+        "count": 40,
+        "sha256": "526fa688a02750abda27581bd3058c55a7445f825bd8445067ce2abe13758ebd"
       }
     },
     "p33": {
@@ -213,15 +209,14 @@
         "refactor",
         "review-work",
         "rules",
-        "skill-observer",
         "start-work",
         "structural-search",
         "visual-qa",
         "wikify"
       ],
       "inventory": {
-        "count": 34,
-        "sha256": "e8f5cf6ae90df8bf89d0bd6b6a4634644c602d047025832a0ace2a3e93186d82"
+        "count": 33,
+        "sha256": "0a21d1b6314c3f1f6e20d78bcd7a2d236aa8944158246e82542012c954c497d3"
       }
     }
   },
@@ -517,16 +512,6 @@
         "p33": 3
       }
     },
-    "skill-observer": {
-      "median": 3,
-      "closures": {
-        "p27": 3,
-        "p28": 2,
-        "p31": 3,
-        "p32": 2,
-        "p33": 6
-      }
-    },
     "start-work": {
       "median": 1,
       "closures": {

package/tools/version-manifests.json

@@ -11,13 +11,13 @@
     {
       "path": "README-Ko-KR.md",
       "kind": "pinned",
-      "occurrences": 9,
+      "occurrences": 11,
       "why": "The landing page identifies the current checkout version; the repository-owned cover is version-free."
     },
     {
       "path": "README.md",
       "kind": "pinned",
-      "occurrences": 9,
+      "occurrences": 11,
       "why": "The landing page identifies the current checkout version; the repository-owned cover is version-free."
     },
     {

package/dist/cli/skill-loop.d.ts

@@ -1,3 +0,0 @@
-import type { CliResult } from "./types.ts";
-export declare function runSkillLoopCli(argv: readonly string[]): Promise<CliResult>;
-export declare function runSkillCuratorCli(argv: readonly string[]): Promise<CliResult>;