Ny and Matrix need one semantic view across compilation, analysis, navigation and editing. The compiler is the source of truth for language meaning. Editor services should consume its results while retaining tolerant parsing for incomplete code.
The compiler provides parse, import, type and ownership diagnostics, declaration
reflection, and a built-in analyzer with stable rule codes. nilbuild supplies
an explicit local project configuration and requires checking before building
or running. VS Code consumes that configuration for live analysis and project
tasks, displays matching imported-file diagnostics, and offers guarded style
fixes. See projects and the analysis API.
niltest now uses compiler-backed discovery and isolated per-case execution for
Ny and Matrix. nilbuild test shares the project entrypoint and import settings,
and VS Code's Testing view provides interpreter/native run profiles for saved
sources in trusted workspaces. Colocated and inline lexical test blocks are
excluded from production compilation. Assertions and nil.std.testing helpers
supply the initial checked test API. See the testing guide
for syntax, reports, process limits, and the current scope; property generators,
coverage, and test-debug profiles remain future work.
Project manifests now default to NILData. Local project references establish dependency ordering, and bounded parallel jobs build independent projects and VM/native targets. SHA-256 input and artifact identities avoid redundant compilation only when the compiler certifies its source and loaded-code input graphs; native reuse also requires a complete linker/toolchain graph. Every invocation still performs fresh analysis. Darwin now hashes admitted loaded images, shared-cache backing files and native linker inputs; actual VM/native reuse and invalidation pass on both Mac architectures. Unsupported profiles rebuild, preserving source protection checks. See the incremental build contract. A single executable remains one compiler job over its complete import graph.
Source debugging is implemented through nildebugger --dap and VS Code launch
configurations for Ny, Matrix and debug-enabled NIL. Source breakpoints,
stepping, frames, locals and streamed output use the interpreter's actual
execution state. Development SDKs on Linux, Windows and both Mac architectures
pass installed debugger and same-process execution-checkpoint acceptance.
See platform support for separate installed editor
results and remaining checks, and the
source-debugging guide.
Workspace source requests now let the compiler analyze open unsaved dependencies
alongside the primary buffer. Import resolution and Ny textual includes consume
those snapshots, and the editor invalidates results when any input changes.
The optional nil.semantic.v1 index now adds original UTF-8 name locations and
snapshot-local symbol IDs. The checker retains supported declaration/reference
links at resolution time. VS Code uses those links for Go to Definition across
the two frontends, including unsaved imports and lexical shadowing, after
validating the entire native input set. Textual include snapshots are watched
and checked even when their extensions cannot participate in overlays.
The compiler now certifies complete occurrence sets for eligible lexical local variables and loop binders. VS Code uses those explicit capabilities for Find All References and local rename. Rename follows compiler-provided identifier and reserved-name policy, then checks the proposed source and verifies every retained binding before returning an edit. Named parameters, functions and globals still need a graph that includes their external callers. See F42 in the findings.
The compiler also supplies bounded completion queries for nonempty value and supported receiver-member prefixes. Candidates follow checked bindings, imports, declaration order and receiver types. Signature queries retain original argument slots and Matrix labels, then describe the selected callable. VS Code validates the consumed source snapshots before displaying either result. See NIL-0011 and NIL-0012 for their supported profiles.
The language server retains a separate tolerant, document-local index. It supplies fallback completion, hover and outline information, but it does not have the compiler's resolved import graph or reference bindings. Its definition, references and rename providers are suppressed while compiler analysis is enabled; disabling analysis retains that fallback. Declaration snapshots alone are insufficient to implement reliable cross-file rename, references or semantic completion.
The new index is explicitly partial. It covers supported source functions,
variables, parameters and loop binders; member/type/pattern occurrences and
failed-code recovery are still incomplete. It requires a successful check and
is withheld for binary-library dependencies, representation limits, or inputs
whose identity cannot be validated. Function type values describe returns,
not complete signatures or a stable type graph. See
NIL-0010 for the boundary.
| Stage | Deliverable | Acceptance evidence |
|---|---|---|
| Complete semantic coverage | Extend the implemented partial index to fields, methods, type uses, pattern bindings, precise generic/overload identities, and recoverable incomplete code. Add binary dependency identity and generated-source maps. | Mixed Ny/Matrix projects, dirty imports, deletion/rename, shadowing, overloads, generics and incomplete code cannot produce stale or guessed bindings. |
| Semantic editing | Extend member/signature queries to unsupported contexts and general parser recovery; add explicitly scoped cross-file references and transactional rename. Extend existing compiler-backed definition navigation as coverage grows. | Real extension-host tests exercise edit/undo, Unicode offsets, cancellation and multi-root workspaces against an installed SDK. |
| Analyzer extensions | Versioned read-only semantic queries and an explicit, bounded host for language-authored analyzers; shared diagnostics, configuration and fix protocol. | Malformed output, limits, analyzer failure and source-version mismatch cannot apply incorrect edits or corrupt compilation. |
| Separate compilation | Extend the implemented local project graph and content cache with reusable library targets and a compiler-owned separate compilation contract. | Module interfaces, dependency changes and artifact reuse remain consistent across VM and native targets; a failed build cannot run stale artifacts. |
| Extend debugging | Build on the implemented source maps, VS Code/DAP launches and interpreter inspection with project-aware launch configuration, richer variable inspection and native-debugger integration. | Extend existing source-debugger tests to each newly supported configuration and execution route. |
NIL-0013 proposes the entrypoint-graph scope, source roles and transactional checks required for cross-file editing. It does not expand the currently shipped local rename capability.
Package resolution, lock files and distribution publication are separate from the local build driver. Their contracts belong to the package-manager design. Native compiler plugins are not a prerequisite for a useful analyzer host.
The near-term priority is expanding retained binding coverage beyond certified locals and extending completion/signature coverage beyond the supported contexts. Both frontends now preserve supported original-source name spans, and the checker retains local bindings after their scopes are discarded. Type strings and declaration names still cannot stand in for a complete symbol/type model. Expanded/generated locations remain non-editable until source maps exist. Matrix rename also needs richer spelling rules beyond the initial explicit replacement of certified local occurrences, including cross-language declarations and named argument labels.
Adding editor-only heuristics for references or rename would create a third interpretation of the languages and make those features difficult to trust. Each stage should ship with a small set of executable acceptance tests before its support claim grows.