refactor(scalar-arrays): drop comments describing cross-codebase field usage

Remove the capability-matrix field JSDocs (and the scalar-list gate comment)
that described how the field is produced (control stack / enrichContract) and
consumed (authoring-time gating) elsewhere. The `capabilities: CapabilityMatrix`
field and the gate diagnostic are self-documenting.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Serhii Tatarintsev <tatarintsev@prisma.io>

Author: SevInf

packages/1-framework/1-core/config/src/contract-source-types.ts

@@ -46,12 +46,6 @@ export interface ContractSourceContext {
   readonly codecLookup: CodecLookup;
   readonly controlMutationDefaults: ControlMutationDefaults;
   readonly resolvedInputs: readonly string[];
-  /**
-   * Merged capability matrix from the control stack's `[target, adapter, ...extensionPacks]`
-   * descriptors — the same merge `enrichContract` performs at emit time. Authoring-time
-   * gating (e.g. scalar lists) reads `capabilities.sql?.scalarList`; an empty matrix
-   * fails closed and rejects gated features. The control stack always populates it.
-   */
   readonly capabilities: CapabilityMatrix;
 }
 

packages/1-framework/1-core/framework-components/src/control/control-stack.ts

@@ -64,13 +64,6 @@ export interface ControlStack<
   readonly authoringContributions: AssembledAuthoringContributions;
   readonly scalarTypeDescriptors: ReadonlyMap<string, string>;
   readonly controlMutationDefaults: ControlMutationDefaults;
-  /**
-   * Merged capability matrix folded from the `[target, adapter, ...extensionPacks]`
-   * descriptors — the same merge `enrichContract` performs at emit time. Authoring
-   * paths read this to gate features (e.g. scalar lists) before the contract is
-   * produced, so an unsupported construct is rejected with a diagnostic rather than
-   * silently emitted.
-   */
   readonly capabilities: CapabilityMatrix;
 }
 

packages/2-sql/2-authoring/contract-psl/src/interpreter.ts

@@ -133,12 +133,6 @@ export interface InterpretPslDocumentToSqlContractInput {
   readonly createNamespace: (input: SqlNamespaceInput) => SqlNamespaceBase;
   readonly codecLookup?: CodecLookup;
   readonly seedDiagnostics?: readonly ContractSourceDiagnostic[];
-  /**
-   * Merged capability matrix from the control stack's
-   * `[target, adapter, ...extensionPacks]` descriptors. Authoring-time gating
-   * (e.g. scalar lists) reads `capabilities.sql?.scalarList`; an empty matrix
-   * fails closed and rejects gated features. The control stack always populates it.
-   */
   readonly capabilities: CapabilityMatrix;
 }
 

packages/2-sql/2-authoring/contract-psl/src/psl-field-resolution.ts

@@ -148,11 +148,6 @@ export interface CollectResolvedFieldsInput {
   readonly sourceId: string;
   readonly scalarTypeDescriptors: ReadonlyMap<string, ColumnDescriptor>;
   readonly enumHandles?: ReadonlyMap<string, EnumTypeHandle>;
-  /**
-   * Merged adapter capability matrix. A scalar list field whose target does not
-   * report `sql.scalarList` is rejected with `PSL_SCALAR_LIST_UNSUPPORTED_TARGET`;
-   * an empty matrix fails closed and rejects scalar lists.
-   */
   readonly capabilities: CapabilityMatrix;
 }
 
@@ -360,9 +355,6 @@ export function collectResolvedFields(input: CollectResolvedFieldsInput): Resolv
     if (isValueObjectField) {
       descriptor = scalarTypeDescriptors.get('Json');
     } else if (isListField) {
-      // Scalar lists lower to a native array storage column; gate them on the
-      // adapter-reported `sql.scalarList` capability. The gate fails closed: a
-      // matrix that omits the capability (SQLite, or an empty matrix) rejects.
       if (capabilities['sql']?.['scalarList'] !== true) {
         diagnostics.push({
           code: 'PSL_SCALAR_LIST_UNSUPPORTED_TARGET',