@neocompose/cli 0.30.1 → 0.30.3

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## [0.30.3] - 2026-08-13
+
+### Fixed
+
+- Identify stored dialogue and migration bodies in `neo script check --all`
+  compile failures and print each in-body source position once. The command
+  also accepts existing delegate and action types in constructor signatures.
+
+## [0.30.2] - 2026-08-13
+
+### Fixed
+
+- Pull instance-bound `NeoAction` listeners through their deterministic
+  `root.*` receiver paths and lower those paths back to the same listener
+  identity. Web-authored actions such as `[root.Assets.OnDamage]` now pull and
+  push without losing the receiver or leaving a phantom member change.
+
 ## [0.30.1] - 2026-08-13
 
 ### Fixed

package/dist/neo.mjs

@@ -29717,6 +29717,38 @@ function substituteManifestType(type, genericEnvironment, environment, seenParam
       )
     };
   }
+  if (type.kind === "delegate") {
+    return {
+      ...type,
+      returnType: substituteManifestType(
+        type.returnType,
+        genericEnvironment,
+        environment,
+        seenParameters
+      ),
+      parameterTypes: type.parameterTypes.map(
+        (parameter4) => substituteManifestType(
+          parameter4,
+          genericEnvironment,
+          environment,
+          seenParameters
+        )
+      )
+    };
+  }
+  if (type.kind === "action") {
+    return {
+      ...type,
+      parameterTypes: type.parameterTypes.map(
+        (parameter4) => substituteManifestType(
+          parameter4,
+          genericEnvironment,
+          environment,
+          seenParameters
+        )
+      )
+    };
+  }
   return type;
 }
 function substituteManifestSymbol(symbol, genericEnvironment, environment) {
@@ -30040,6 +30072,37 @@ function manifestType2(value, environment, field) {
       nullable
     };
   }
+  if (kind === "delegate") {
+    return {
+      kind: "delegate",
+      returnType: manifestReturnType(
+        type.returnType,
+        environment,
+        `${field}.returnType`
+      ),
+      parameterTypes: records(type.argumentTypes, `${field}.argumentTypes`).map(
+        (argument2, index) => manifestType2(
+          argument2,
+          environment,
+          `${field}.argumentTypes[${index}]`
+        )
+      ),
+      nullable
+    };
+  }
+  if (kind === "action") {
+    return {
+      kind: "action",
+      parameterTypes: records(type.argumentTypes, `${field}.argumentTypes`).map(
+        (argument2, index) => manifestType2(
+          argument2,
+          environment,
+          `${field}.argumentTypes[${index}]`
+        )
+      ),
+      nullable
+    };
+  }
   throw new Error(
     `${field}.kind has unsupported schema type ${JSON.stringify(kind)}.`
   );
@@ -47422,12 +47485,26 @@ function renderActionListeners(context, member, value) {
         `NeoAction member ${member.name} listener ${index} is missing memberId.`
       );
     }
-    if (listener.valueId !== null && listener.valueId !== void 0) {
+    const target = required(
+      context.members,
+      listener.memberId,
+      "action listener"
+    );
+    if (listener.valueId === null || listener.valueId === void 0) {
+      return target.name;
+    }
+    if (typeof listener.valueId !== "string") {
+      throw new Error(
+        `NeoAction member ${member.name} listener ${index} has a non-string receiver valueId.`
+      );
+    }
+    const receiver = context.collectionValuePaths.get(listener.valueId);
+    if (receiver === void 0) {
       throw new Error(
-        `NeoAction member ${member.name} listener ${index} is instance-bound, which no declaration default can spell.`
+        `NeoAction member ${member.name} listener ${index} is bound to value ${listener.valueId}, which has no deterministic root path.`
       );
     }
-    return required(context.members, listener.memberId, "action listener").name;
+    return `${receiver}.${target.name}`;
   });
   return `[${names.join(", ")}]`;
 }
@@ -53431,6 +53508,7 @@ function lowerFieldMember(context, ownerClass, declaration, id2, commonInput, ba
         `NeoAction member ${ownerClass.name}.${declaration.name} cannot be nullable; an action's rest state is an empty listener list.`
       );
     }
+    const baseAction = base?.kind === "action" ? base : void 0;
     return {
       ...common,
       kind: "action",
@@ -53439,7 +53517,10 @@ function lowerFieldMember(context, ownerClass, declaration, id2, commonInput, ba
       // fixed false because nullability has no meaning here (P62 §2.1).
       required: false,
       arguments: fieldType.arguments.map((argumentType, index) => ({
-        name: `p${index + 1}`,
+        // NeoAction's generic spelling carries types but no parameter names.
+        // Preserve a pulled name when this stable declaration already exists;
+        // `pN` remains the deterministic name for a newly authored action.
+        name: baseAction?.arguments[index]?.name ?? `p${index + 1}`,
         type: lowerType(context, argumentType, ownerClass),
         default: null,
         source: span(declaration),
@@ -54168,23 +54249,24 @@ function lowerActionDefault(context, expression, ownerClass, path) {
   const listeners = [];
   const identities = /* @__PURE__ */ new Set();
   elements.forEach((element, index) => {
-    const memberId = lowerActionListenerId(
+    const listener = lowerActionListener(
       context,
       element,
       ownerClass,
       `${path}[${index}]`
     );
-    if (identities.has(memberId)) {
+    const identity2 = `${listener.memberId}\0${listener.valueId ?? ""}`;
+    if (identities.has(identity2)) {
       throw new Error(
         `NeoAction listener ${path}[${index}] repeats an earlier listener; a listener set holds each target once.`
       );
     }
-    identities.add(memberId);
-    listeners.push({ memberId, valueId: null });
+    identities.add(identity2);
+    listeners.push(listener);
   });
   return { listeners };
 }
-function lowerActionListenerId(context, element, ownerClass, path) {
+function lowerActionListener(context, element, ownerClass, path) {
   let current = element;
   while (current.kind === "annotated") current = current.expression;
   if (current.kind === "lambda") {
@@ -54192,21 +54274,26 @@ function lowerActionListenerId(context, element, ownerClass, path) {
       `NeoAction listener ${path} is a lambda. A listener must be a member reference: extract the body to an NSFunction member and subscribe that member instead.`
     );
   }
-  const name = actionListenerSymbol(current);
-  if (name === null) {
+  const target = actionListenerTarget(context, current, ownerClass);
+  if (target === null) {
     throw new Error(
-      `NeoAction listener ${path} must name a callable member on the current Class.`
+      `NeoAction listener ${path} must name a callable member on the current Class or a receiver reachable through root.`
     );
   }
-  const classId = materializedId(ownerClass, "class", ownerClass.name);
-  const memberId = effectiveMemberIdByName(context, classId, name);
+  const memberId = effectiveMemberIdByName(
+    context,
+    target.classId,
+    target.memberName
+  );
   if (memberId === null) {
     throw new Error(
-      `NeoAction listener ${path} names ${JSON.stringify(name)}, which ${ownerClass.name} does not declare or inherit.`
+      `NeoAction listener ${path} names ${JSON.stringify(target.memberName)}, which its receiver Class does not declare or inherit.`
     );
   }
   const declaration = context.sourceMembersById.get(memberId)?.member;
-  if (declaration === void 0) return memberId;
+  if (declaration === void 0) {
+    return { memberId, valueId: target.valueId };
+  }
   if (declaration.kind === "function") {
     if (declaration.type.name !== "void") {
       throw new Error(
@@ -54218,21 +54305,46 @@ function lowerActionListenerId(context, element, ownerClass, path) {
         `NeoAction listener ${path} targets deferred ${declaration.name}; listeners are immediate-only.`
       );
     }
-    return memberId;
+    return { memberId, valueId: target.valueId };
   }
   if (declaration.type.name !== "NeoAction" && declaration.type.name !== "NeoDelegate") {
     throw new Error(
       `NeoAction listener ${path} targets ${declaration.name}, which is not a function, NSFunction, NSDelegate, or NeoAction member.`
     );
   }
-  return memberId;
+  return { memberId, valueId: target.valueId };
 }
-function actionListenerSymbol(expression) {
+function actionListenerTarget(context, expression, ownerClass) {
+  const expressionPath2 = actionListenerPath(expression);
+  if (expressionPath2 === null) return null;
+  if (!expressionPath2.includes(".")) {
+    return {
+      classId: materializedId(ownerClass, "class", ownerClass.name),
+      memberName: expressionPath2,
+      valueId: null
+    };
+  }
+  if (expressionPath2.startsWith("this.")) {
+    const memberName2 = expressionPath2.slice("this.".length);
+    if (memberName2.includes(".")) return null;
+    return {
+      classId: materializedId(ownerClass, "class", ownerClass.name),
+      memberName: memberName2,
+      valueId: null
+    };
+  }
+  const separator = expressionPath2.lastIndexOf(".");
+  const receiverPath = expressionPath2.slice(0, separator);
+  const memberName = expressionPath2.slice(separator + 1);
+  const receiver = context.rootValueTargetsByPath.get(receiverPath);
+  if (receiver === void 0) return null;
+  return { ...receiver, memberName };
+}
+function actionListenerPath(expression) {
   if (expression.kind === "ident") return expression.name;
   if (expression.kind !== "member") return null;
-  if (expression.receiver.kind !== "ident") return null;
-  if (expression.receiver.name !== "this") return null;
-  return expression.name;
+  const receiver = actionListenerPath(expression.receiver);
+  return receiver === null ? null : `${receiver}.${expression.name}`;
 }
 function lowerExpressionValue(context, expression, declaredExpected, ownerClass, path, genericEnvironment = EMPTY_GENERIC_TYPE_ENVIRONMENT, sourceText) {
   const expected = substituteGenericTypeNames(
@@ -55283,6 +55395,81 @@ var init_lower_members = __esm({
   }
 });
 
+// src/project-source/root-value-paths.ts
+function rootValuePathsByValueId(records2) {
+  const indexed = indexRecords(records2);
+  const paths = /* @__PURE__ */ new Map();
+  const queue = [];
+  for (const [field, slot] of ROOT_PROJECT_FIELDS) {
+    const memberId = indexed.project?.[field];
+    const member = typeof memberId === "string" ? indexed.members.get(memberId) : void 0;
+    const valueId = member?.valueId;
+    if (typeof valueId === "string") {
+      queue.push({ id: valueId, path: `root.${slot}` });
+    }
+  }
+  while (queue.length > 0) {
+    const next = queue.shift();
+    if (next === void 0) break;
+    if (paths.has(next.id)) continue;
+    paths.set(next.id, next.path);
+    const body = indexed.values.get(next.id)?.value;
+    if (!isObjectRecord3(body)) continue;
+    for (const [schemaKey, child] of Object.entries(body)) {
+      if (typeof child !== "string") continue;
+      if (!indexed.values.has(child)) continue;
+      queue.push({ id: child, path: `${next.path}.${schemaKey}` });
+    }
+  }
+  return paths;
+}
+function rootValueTargetsByPath(records2) {
+  const allRecords = [...records2];
+  const paths = rootValuePathsByValueId(allRecords);
+  const values = new Map(
+    allRecords.flatMap(
+      (record3) => !record3.deleted && record3.recordKind === "value" && isObjectRecord3(record3.data) ? [[record3.recordId, record3.data]] : []
+    )
+  );
+  const targets = /* @__PURE__ */ new Map();
+  for (const [valueId, path] of paths) {
+    const classId = values.get(valueId)?.classId;
+    if (typeof classId === "string") {
+      targets.set(path, { valueId, classId });
+    }
+  }
+  return targets;
+}
+function indexRecords(records2) {
+  let project;
+  const members = /* @__PURE__ */ new Map();
+  const values = /* @__PURE__ */ new Map();
+  for (const record3 of records2) {
+    if (record3.deleted || !isObjectRecord3(record3.data)) continue;
+    if (record3.recordKind === "project") project ??= record3.data;
+    else if (record3.recordKind === "member") {
+      members.set(record3.recordId, record3.data);
+    } else if (record3.recordKind === "value") {
+      values.set(record3.recordId, record3.data);
+    }
+  }
+  return { project, members, values };
+}
+function isObjectRecord3(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var ROOT_PROJECT_FIELDS;
+var init_root_value_paths = __esm({
+  "src/project-source/root-value-paths.ts"() {
+    "use strict";
+    ROOT_PROJECT_FIELDS = [
+      ["rootAssetsMemberId", "Assets"],
+      ["rootSaveFileMemberId", "Save"],
+      ["rootSessionMemberId", "Session"]
+    ];
+  }
+});
+
 // ../src/models/members/member-value-id.ts
 function derivedMemberValueId(memberId) {
   return inSystemRecordNamespaceOf(
@@ -70905,6 +71092,7 @@ function lowerProjectSchemaV4(base, analysis, options = {}) {
     ),
     projectFileIdsBySymbol: options.projectFileIdsBySymbol ?? /* @__PURE__ */ new Map(),
     rowBackedDefaultMemberIds: options.rowBackedDefaultMemberIds ?? /* @__PURE__ */ new Set(),
+    rootValueTargetsByPath: options.rootValueTargetsByPath ?? /* @__PURE__ */ new Map(),
     declaredConstructors: buildDeclaredConstructorIndex(analysis),
     compiledFunctionBodiesByMemberId: new Map(
       analysis.compiledBodies.filter((body) => body.unit === "function").map((body) => [body.memberId, body.ir])
@@ -73404,7 +73592,7 @@ function validateProjectRootEnvelopeV4(state, analysis) {
   return { expectedIds, global, slots };
 }
 function rootMemberIds(project) {
-  return ROOT_PROJECT_FIELDS.map((field) => {
+  return ROOT_PROJECT_FIELDS2.map((field) => {
     const id2 = project[field];
     if (typeof id2 !== "string" || id2.length === 0) {
       throw new Error(`Project record has no ${field}.`);
@@ -73507,47 +73695,16 @@ function walkRootValuePath(path, state, registry, fail) {
   }
   return cursor;
 }
-function rootValuePathsByValueId(records2) {
-  const paths = /* @__PURE__ */ new Map();
-  const project = [...records2.values()].find(
-    (record3) => record3.recordKind === "project"
-  );
-  if (project === void 0 || !isObjectRecord2(project.data)) return paths;
-  const queue = [];
-  ROOT_PROJECT_FIELDS.forEach((field, index) => {
-    const slot = PROJECT_ROOT_SOURCE_SLOTS[index];
-    const memberId = isObjectRecord2(project.data) ? project.data[field] : void 0;
-    if (slot === void 0 || typeof memberId !== "string") return;
-    const member = records2.get(`member:${memberId}`);
-    const valueId = isObjectRecord2(member?.data) ? member.data.valueId : void 0;
-    if (typeof valueId !== "string") return;
-    queue.push({ id: valueId, path: `root.${slot.name}` });
-  });
-  while (queue.length > 0) {
-    const next = queue.shift();
-    if (next === void 0) break;
-    if (paths.has(next.id)) continue;
-    paths.set(next.id, next.path);
-    const row = records2.get(`value:${next.id}`);
-    const body = isObjectRecord2(row?.data) ? row.data.value : void 0;
-    if (!isObjectRecord2(body)) continue;
-    for (const [schemaKey, child] of Object.entries(body)) {
-      if (typeof child !== "string") continue;
-      if (!records2.has(`value:${child}`)) continue;
-      queue.push({ id: child, path: `${next.path}.${schemaKey}` });
-    }
-  }
-  return paths;
-}
-var ROOT_PROJECT_FIELDS, ROOT_PATH_PENDING_PREFIX;
+var ROOT_PROJECT_FIELDS2, ROOT_PATH_PENDING_PREFIX;
 var init_root_source = __esm({
   "src/project-source/root-source.ts"() {
     "use strict";
     init_src();
     init_projection();
     init_value_sources();
+    init_root_value_paths();
     init_source_format();
-    ROOT_PROJECT_FIELDS = [
+    ROOT_PROJECT_FIELDS2 = [
       "rootAssetsMemberId",
       "rootSaveFileMemberId",
       "rootSessionMemberId"
@@ -75329,19 +75486,19 @@ function neoScriptSchemaContractProjection(kind, value) {
   if (kind === "enum") ignored.add("optionKeyOrder");
   if (kind === "interface") ignored.add("memberKeyOrder");
   const projected = withoutFields(value, ignored);
-  if (kind === "enum" && isObjectRecord3(projected.options)) {
+  if (kind === "enum" && isObjectRecord4(projected.options)) {
     projected.options = Object.fromEntries(
       Object.entries(projected.options).map(([id2, option]) => [
         id2,
-        isObjectRecord3(option) ? { id: option.id, name: option.name } : option
+        isObjectRecord4(option) ? { id: option.id, name: option.name } : option
       ])
     );
   }
-  if (kind === "interface" && isObjectRecord3(projected.members)) {
+  if (kind === "interface" && isObjectRecord4(projected.members)) {
     projected.members = Object.fromEntries(
       Object.entries(projected.members).map(([key, member]) => [
         key,
-        isObjectRecord3(member) ? withoutFields(member, /* @__PURE__ */ new Set(["docsText"])) : member
+        isObjectRecord4(member) ? withoutFields(member, /* @__PURE__ */ new Set(["docsText"])) : member
       ])
     );
   }
@@ -75496,7 +75653,7 @@ function selectedRecordIds(records2, explicitIds, impactedIds, impactedTypeNames
   return selected;
 }
 function recordDependsOnChangedContract(record3, impactedIds, impactedTypeNames, constructedClassIds, impactedSourceNames) {
-  const recordId = isObjectRecord3(record3) ? record3.id : void 0;
+  const recordId = isObjectRecord4(record3) ? record3.id : void 0;
   if (typeof recordId === "string" && impactedIds.has(recordId)) return true;
   if (intersects(collectCompilerReferenceIds(record3), impactedIds)) return true;
   if (intersects(collectCompilerReferenceNames(record3), impactedTypeNames)) {
@@ -75572,7 +75729,7 @@ function collectDeclaredSourceNames(value, names) {
     for (const child of value) collectDeclaredSourceNames(child, names);
     return;
   }
-  if (!isObjectRecord3(value)) return;
+  if (!isObjectRecord4(value)) return;
   for (const [field, child] of Object.entries(value)) {
     if (typeof child === "string" && (field === "name" || field === "sourceName" || field === "sourceFunctionName" || field === "declaredTypeName" || field === "typeName")) {
       names.add(child);
@@ -75589,7 +75746,7 @@ function collectAuthoredNeoScriptSourceIdentifiers(value) {
       for (const entry of child) collect(entry);
       return;
     }
-    if (!isObjectRecord3(child)) return;
+    if (!isObjectRecord4(child)) return;
     for (const [field, nested] of Object.entries(child)) {
       if ((field === "code" || field === "setterCode") && typeof nested === "string") {
         const result = lex(nested);
@@ -75613,7 +75770,7 @@ function containsAuthoredNeoScriptSource(value) {
   if (Array.isArray(value)) {
     return value.some(containsAuthoredNeoScriptSource);
   }
-  if (!isObjectRecord3(value)) return false;
+  if (!isObjectRecord4(value)) return false;
   for (const [field, child] of Object.entries(value)) {
     if ((field === "code" || field === "setterCode") && typeof child === "string" && child.trim().length > 0) {
       return true;
@@ -75624,13 +75781,13 @@ function containsAuthoredNeoScriptSource(value) {
 }
 function containsCompiledNeoScriptBody(value) {
   if (Array.isArray(value)) return value.some(containsCompiledNeoScriptBody);
-  if (!isObjectRecord3(value)) return false;
-  if (Array.isArray(value.parameters) && Array.isArray(value.instructions) && isObjectRecord3(value.typeInfo)) {
+  if (!isObjectRecord4(value)) return false;
+  if (Array.isArray(value.parameters) && Array.isArray(value.instructions) && isObjectRecord4(value.typeInfo)) {
     return true;
   }
   return Object.values(value).some(containsCompiledNeoScriptBody);
 }
-function isObjectRecord3(value) {
+function isObjectRecord4(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function constructorOwners(document) {
@@ -86799,6 +86956,9 @@ function computeWorkspaceStatus(workspace, options) {
       ),
       rowBackedDefaultMemberIds: rowBackedDefaultMemberIdsV4(
         workspace.state.records
+      ),
+      rootValueTargetsByPath: rootValueTargetsByPath(
+        Object.values(workspace.state.records)
       )
     });
     memberDefaults = lowerMemberDefaultSourcesV4(
@@ -87828,6 +87988,7 @@ var init_workspace_status_core = __esm({
     init_core();
     init_value_sources();
     init_root_source();
+    init_root_value_paths();
     init_project_documents();
     init_animation_clips();
     init_classes();
@@ -89089,6 +89250,7 @@ function buildValueEmitContext(records2, manifest) {
     localizedTexts,
     mainLocale: projectMainLocale(records2),
     symbolsByValueId,
+    rootPathsByValueId: rootValuePathsByValueId(records2.values()),
     symbolsByDialogueId: new Map(
       [...dialogues].flatMap(
         ([id2, dialogue]) => typeof dialogue.sourceName === "string" ? [[id2, dialogue.sourceName]] : []
@@ -89458,6 +89620,7 @@ function buildValueLowerContext(state, manifest, options = {}) {
       ])
     ),
     staticValueIdsBySymbol: staticTargets,
+    rootValueTargetsByPath: rootValueTargetsByPath(Object.values(state)),
     dialogueTargetsBySymbol: dialogueTargetsBySymbol(options.analysis),
     projectFileIdsBySymbol: projectFileIdsBySymbol(state, options.analysis),
     mainLocale: projectMainLocaleFromState(state),
@@ -93127,18 +93290,19 @@ function lowerActionValue(context, expression, ownerClassId) {
   const listeners = [];
   const identities = /* @__PURE__ */ new Set();
   elements.forEach((element, index) => {
-    const listener = lowerActionListener(context, element, ownerClassId, index);
-    if (identities.has(listener.memberId)) {
+    const listener = lowerActionListener2(context, element, ownerClassId, index);
+    const identity2 = `${listener.memberId}\0${listener.valueId ?? ""}`;
+    if (identities.has(identity2)) {
       throw new Error(
         `NeoAction listener ${index} repeats an earlier listener; a listener set holds each target once.`
       );
     }
-    identities.add(listener.memberId);
+    identities.add(identity2);
     listeners.push(listener);
   });
   return { listeners };
 }
-function lowerActionListener(context, element, ownerClassId, index) {
+function lowerActionListener2(context, element, ownerClassId, index) {
   const { expression } = annotatedValue(element);
   if (expression.kind === "lambda") {
     throw new Error(
@@ -93146,35 +93310,51 @@ function lowerActionListener(context, element, ownerClassId, index) {
     );
   }
   const path = memberPath(expression);
-  const symbol = path?.startsWith("this.") ? path.slice("this.".length) : path;
-  if (symbol === null || symbol === void 0 || symbol.includes(".")) {
+  if (path === null) {
     throw new Error(
-      `NeoAction listener ${index} must name a function, NSFunction, NSDelegate, or NeoAction member on the current Class.`
+      `NeoAction listener ${index} must name a function, NSFunction, NSDelegate, or NeoAction member on the current Class or a receiver reachable through root.`
     );
   }
-  if (ownerClassId === void 0) {
-    throw new Error(
-      `NeoAction listener ${symbol} cannot be resolved without its owning Class.`
-    );
+  const localSymbol2 = path.startsWith("this.") ? path.slice("this.".length) : path;
+  let target;
+  let valueId = null;
+  if (!localSymbol2.includes(".")) {
+    if (ownerClassId === void 0) {
+      throw new Error(
+        `NeoAction listener ${localSymbol2} cannot be resolved without its owning Class.`
+      );
+    }
+    target = classMemberByName(context, ownerClassId, localSymbol2);
+  } else {
+    const separator = path.lastIndexOf(".");
+    const receiverPath = path.slice(0, separator);
+    const memberName = path.slice(separator + 1);
+    const receiver = context.rootValueTargetsByPath.get(receiverPath);
+    if (receiver === void 0) {
+      throw new Error(
+        `NeoAction listener ${index} receiver ${receiverPath} is not reachable through a deterministic root path.`
+      );
+    }
+    target = classMemberByName(context, receiver.classId, memberName);
+    valueId = receiver.valueId;
   }
-  const target = classMemberByName(context, ownerClassId, symbol);
-  if (target.kind === "action") return { memberId: target.id, valueId: null };
+  if (target.kind === "action") return { memberId: target.id, valueId };
   if (target.kind !== "function" && target.kind !== "scriptFunction" && target.kind !== "delegate") {
     throw new Error(
-      `NeoAction listener ${symbol} does not resolve to a function, NSFunction, NSDelegate, or NeoAction member.`
+      `NeoAction listener ${path} does not resolve to a function, NSFunction, NSDelegate, or NeoAction member.`
     );
   }
   if (target.returnType.kind !== "void") {
     throw new Error(
-      `NeoAction listener ${symbol} returns a value; a listener must be void.`
+      `NeoAction listener ${path} returns a value; a listener must be void.`
     );
   }
   if (target.kind !== "delegate" && target.deferred) {
     throw new Error(
-      `NeoAction listener ${symbol} is deferred; listeners are immediate-only.`
+      `NeoAction listener ${path} is deferred; listeners are immediate-only.`
     );
   }
-  return { memberId: target.id, valueId: null };
+  return { memberId: target.id, valueId };
 }
 function lowerDelegateValue(context, expression, ownerClassId, authoredSlice) {
   if (expression.kind === "lambda") {
@@ -94723,11 +94903,6 @@ function actionListenerName(context, listener, index) {
   if (typeof listener.memberId !== "string") {
     throw new Error(`NSAction listener ${index} is missing memberId.`);
   }
-  if (listener.valueId !== null && listener.valueId !== void 0) {
-    throw new Error(
-      `NSAction listener ${index} is instance-bound and cannot be represented by current project source.`
-    );
-  }
   const target = context.members.get(listener.memberId);
   if (target === void 0 || typeof target.name !== "string") {
     throw new Error(`NSAction listener ${listener.memberId} was not pulled.`);
@@ -94736,7 +94911,19 @@ function actionListenerName(context, listener, index) {
   if (kind !== 13 && kind !== 23 && kind !== 25 && kind !== 26) {
     throw new Error(`NSAction listener ${listener.memberId} is not callable.`);
   }
-  return target.name;
+  if (listener.valueId === null || listener.valueId === void 0) {
+    return target.name;
+  }
+  if (typeof listener.valueId !== "string") {
+    throw new Error(`NSAction listener ${index} has a non-string valueId.`);
+  }
+  const receiver = context.rootPathsByValueId.get(listener.valueId);
+  if (receiver === void 0) {
+    throw new Error(
+      `NSAction listener ${index} is bound to value ${listener.valueId}, which has no deterministic root path.`
+    );
+  }
+  return `${receiver}.${target.name}`;
 }
 function fileValue(context, kind, label, body, required2) {
   if (body === null || body === void 0) {
@@ -94939,6 +95126,7 @@ var init_value_sources = __esm({
     init_declared_constructors2();
     init_init_source();
     init_source_format();
+    init_root_value_paths();
     init_world_system_classes();
     init_member_value_id();
     init_members();
@@ -94981,7 +95169,7 @@ function emitProjectDocumentFilesV4(records2) {
     defaultInitializers: memberDefaults.initializers,
     fileSymbols: qualifiedProjectFileSymbolsV4(records2),
     relationEndpointExpressions: relationEndpointExpressions(records2),
-    collectionValuePaths: rootValuePathsByValueId(records2)
+    collectionValuePaths: rootValuePathsByValueId(records2.values())
   });
   const source = {
     ...baseSource,
@@ -95110,6 +95298,7 @@ var init_project_documents = __esm({
     init_dialogue_sources();
     init_value_sources();
     init_root_source();
+    init_root_value_paths();
     init_source_diagnostics();
     init_source_format();
     PROJECT_SOURCE_ANALYSIS_V4_CACHE_PATH = ".neo/project-source-analysis-v4.json";
@@ -99388,6 +99577,9 @@ function describeBodySite(site) {
     return `Migration '${site.memberName}' (target ${site.ownerName})`;
   }
   const unit = unitLabel(site.unit);
+  if ("recordName" in site) {
+    return `${unit} '${site.recordName}'`;
+  }
   if (site.ownerName === null) {
     return `${unit} '${site.memberName}' (member ${site.recordId}, whose declaring class is not in this push's schema)`;
   }
@@ -100413,6 +100605,13 @@ function buildStoredNeoScriptChecks(document) {
         name: nodeId,
         unit: "condition",
         path: `dialogueNodes.${nodeId}`,
+        bodySite: {
+          recordKind: "dialogue-node",
+          recordId: nodeId,
+          recordName: nodeId,
+          unit: "getter",
+          code: ""
+        },
         run: () => {
           throw new Error(
             `Dialogue node "${nodeId}" references missing dialogue "${String(node.dialogueId)}".`
@@ -100443,6 +100642,13 @@ function buildStoredNeoScriptChecks(document) {
             name: recordName,
             unit: "condition",
             path: `${path}.${index}`,
+            bodySite: {
+              recordKind: "dialogue-node",
+              recordId: nodeId,
+              recordName,
+              unit: "getter",
+              code: typeof conditionValue.code === "string" ? conditionValue.code : ""
+            },
             run: () => {
               compileDialogueLogicWithProjectData(
                 {
@@ -100469,6 +100675,13 @@ function buildStoredNeoScriptChecks(document) {
             name: recordName,
             unit: "text-variable",
             path: `${path}.${variableKey}`,
+            bodySite: {
+              recordKind: "dialogue-node",
+              recordId: nodeId,
+              recordName,
+              unit: "getter",
+              code: ""
+            },
             run: () => {
               compileDialogueLogicWithProjectData(
                 {
@@ -100544,6 +100757,13 @@ function buildStoredNeoScriptChecks(document) {
             name: recordName,
             unit: "action",
             path: `${nodePath}.actions.${actionId}.logic`,
+            bodySite: {
+              recordKind: "dialogue-node",
+              recordId: nodeId,
+              recordName,
+              unit: "action",
+              code: typeof logic.code === "string" ? logic.code : ""
+            },
             run: () => {
               compileDialogueLogicWithProjectData(
                 {
@@ -100588,6 +100808,13 @@ function buildStoredNeoScriptChecks(document) {
         name: groupName,
         unit: "condition",
         path: `dialogueGroups.${groupId}.conditions.${index}`,
+        bodySite: {
+          recordKind: "dialogue-group",
+          recordId: groupId,
+          recordName: groupName,
+          unit: "getter",
+          code: typeof conditionValue.code === "string" ? conditionValue.code : ""
+        },
         run: () => {
           compileDialogueLogicWithProjectData(
             {
@@ -100615,6 +100842,14 @@ function buildStoredNeoScriptChecks(document) {
       name: migrationName,
       unit: "migration",
       path: `migrations.${migrationId}.code`,
+      bodySite: {
+        recordKind: "migration",
+        recordId: migrationId,
+        ownerName: null,
+        memberName: migrationName,
+        unit: "migration",
+        code: typeof migration.code === "string" ? migration.code : ""
+      },
       run: () => {
         if (typeof migration.code !== "string") {
           throw new Error(`Migration "${migrationId}" is missing source code.`);
@@ -100659,9 +100894,6 @@ function optionalString4(value) {
   return typeof value === "string" ? value : null;
 }
 function neoScriptCheckErrorMessage(error) {
-  if (error instanceof CompileError) {
-    return `${error.line}:${error.column} ${error.message}`;
-  }
   return error instanceof Error ? error.message : String(error);
 }
 function resolveLocalScriptMember(manifest, memberRef) {
@@ -100906,7 +101138,7 @@ function runCheckAll(document, manifest, options) {
   for (const check of buildStoredNeoScriptChecks(document)) {
     checked += 1;
     try {
-      check.run();
+      compileNeoScriptBodyOrThrow(check.run, check.bodySite, null);
       results.push({
         id: check.id,
         name: check.name,
@@ -101668,11 +101900,11 @@ function assertProjectFileAuthoringRecordIdentifiers(recordKind, data) {
   if (recordKind !== "unity-texture-template" && recordKind !== "unity-audio-clip-template") {
     return;
   }
-  if (!isObjectRecord4(data) || typeof data.name !== "string") return;
+  if (!isObjectRecord5(data) || typeof data.name !== "string") return;
   const label = recordKind === "unity-texture-template" ? "Unity texture template name" : "Unity audio clip template name";
   assertProjectFileAuthoringIdentifier(data.name, label);
 }
-function isObjectRecord4(value) {
+function isObjectRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var init_project_file_authoring_identifiers = __esm({
@@ -104614,7 +104846,7 @@ var init_registry2 = __esm({
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
       formatVersion: 3,
       contractVersion: "3.11",
-      cliVersion: "0.30.1",
+      cliVersion: "0.30.3",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -111182,7 +111414,7 @@ There is no --keep-current: preserving current semantic state defines flatten.
 async function main() {
   const args = parseArgs(process.argv.slice(2));
   if (args.command === "--version") {
-    console.log("0.30.1");
+    console.log("0.30.3");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.30.1",
+  "version": "0.30.3",
   "description": "Neo Compose native project-source CLI with bidirectional sync.",
   "license": "MIT",
   "type": "module",

package/skills/neocompose-cli/SKILL.md

@@ -9,7 +9,7 @@ description: >-
   `@neocompose/cli` or `node cli/bin/neo.mjs` in the neo-compose repository.
 ---
 
-<!-- reviewed-through-cli: 0.30.1 -->
+<!-- reviewed-through-cli: 0.30.3 -->
 
 # Neo Compose CLI
 

package/skills/neocompose-cli/references/cli-development.md

@@ -83,7 +83,7 @@ wrappers.
 The marker near the top of `SKILL.md` must exactly match the package version:
 
 ```html
-<!-- reviewed-through-cli: 0.30.1 -->
+<!-- reviewed-through-cli: 0.30.3 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

package/skills/neocompose-cli/references/declarations-and-construction.md

@@ -110,6 +110,12 @@ empty set.
 public NeoAction<int> OnDamaged = [PlayHitFlash, ApplyDamage];
 ```
 
+An instance-bound listener reachable through a stable project root keeps its
+receiver path, for example `public NeoAction<int> OnDamaged =
+[root.Assets.OnDamage];`. Pull refuses a bound receiver that has no
+deterministic `root.*` path instead of emitting a source expression that would
+silently change the target.
+
 Subscribe and unsubscribe with `+=` and `-=` against the member reference
 itself; both are durable writes deduplicated by target identity, so
 re-running a subscription cannot double-subscribe. Invoke it as a statement —