Wire up ADS submodule, codegen, runtime path aliases (no behavioral swap yet)

Sets the foundation for the cross-language Airframes Decoder Spec (ADS)
unification by integrating airframes-decoder into this repo as a git
submodule, without yet replacing any hand-written plugins. Behavior is
identical to master after this PR.

What this PR does:

- Add `vendor/airframes-decoder` as a git submodule (pinned to its
  init/ads-v1 branch).
- Add tsconfig path aliases (`@airframes/ads-runtime-ts` and friends)
  resolving into the submodule's runtimes/typescript/.
- Add npm scripts:
    npm run ads:codegen-build  — build the codegen tool
    npm run ads:generate       — emit lib/plugins/generated/*.ts from spec
    npm run ads:check          — fail if generated tree is out-of-date
- Generate the 68 plugins into lib/plugins/generated/ and commit them
  (avoids requiring the codegen toolchain in every contributor's env).
- Exclude vendor/ and lib/plugins/generated/ from ESLint.
- Exclude vendor/ from Jest test discovery.
- Add .github/workflows/ads-check.yml that calls the central reusable
  `codegen-check.yml` workflow (single source of CI logic across repos).

What this PR does NOT do (intentionally — separate Stage 2.5 PR):

- Does NOT register generated plugins in MessageDecoder.ts. The current
  emitter double-bookkeeps `raw` fields (field assignments + formatter
  writes), which would diverge from existing test expectations. Resolving
  this needs an emitter design pass (track which raw keys the formatter
  owns, suppress auto-emit in those cases) before a behavioral swap
  is safe.
- Does NOT remove the original lib/utils/*.ts helpers yet. The runtime
  is duplicated between this repo and the submodule until Stage 2.5
  swaps imports.

Verification:
- All 407 existing tests pass.
- `npm run ads:generate` produces 68 .ts files with no diff vs committed.
- Generated files compile against `@airframes/ads-runtime-ts` path
  aliases (resolution verified via tsc paths).

See airframesio/acars-decoder#1 for the central spec, codegen, runtimes,
docs, and 288-sample corpus this submodule references.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: kevinelliott

.github/workflows/ads-check.yml

@@ -0,0 +1,16 @@
+name: ADS check
+
+on:
+  push:
+    branches: [master, dsl/adopt-v1]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  ads-generated-up-to-date:
+    uses: airframesio/acars-decoder/.github/workflows/codegen-check.yml@init/ads-v1
+    with:
+      language: ts
+      generated-path: lib/plugins/generated
+      spec-path: vendor/airframes-decoder/spec
+      codegen-path: vendor/airframes-decoder/codegen

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "vendor/airframes-decoder"]
+	path = vendor/airframes-decoder
+	url = https://github.com/airframesio/acars-decoder.git

eslint.config.mts

@@ -6,6 +6,10 @@ import importPlugin from 'eslint-plugin-import';
 import stylistic from '@stylistic/eslint-plugin';
 
 export default [
+  {
+    // Skip the vendored submodule and the auto-generated plugins from linting.
+    ignores: ['vendor/**', 'lib/plugins/generated/**'],
+  },
   {
     files: ['**/*.ts'],
 

jest.config.ts

@@ -159,9 +159,10 @@ export default {
   // ],
 
   // An array of regexp pattern strings that are matched against all test paths, matched tests are skipped
-  // testPathIgnorePatterns: [
-  //   "/node_modules/"
-  // ],
+  testPathIgnorePatterns: [
+    "/node_modules/",
+    "/vendor/", // skip vendored airframes-decoder submodule's tests
+  ],
 
   // The regexp pattern or array of patterns that Jest uses to detect test files
   // testRegex: [],

lib/plugins/generated/ARINC_702.ts

@@ -0,0 +1,25 @@
+// AUTO-GENERATED from /Users/kevin/Cloud/Dropbox/work/airframes/acars-decoder-typescript/vendor/airframes-decoder/spec/wildcards/arinc_702.yaml. Do not edit.
+// Plugin: ARINC_702
+// Docs: https://github.com/airframesio/acars-message-documentation/blob/main/research/ARINC_702.md
+
+import { DecoderPlugin } from "@airframes/ads-runtime-ts";
+import type { DecodeResult, Message, Options } from "@airframes/ads-runtime-ts";
+import { ResultFormatter } from "@airframes/ads-runtime-ts";
+import * as helpers from "@airframes/ads-runtime-ts/helpers";
+import * as hatches from "../escape_hatches";
+
+export class ARINC_702 extends DecoderPlugin {
+  name = "arinc-702";
+
+  qualifiers() {
+    return {
+      labels: ["*"],
+    };
+  }
+
+  decode(message: Message, options: Options = {}): DecodeResult {
+    const result = this.initResult(message, "ARINC 702 Message");
+
+    return hatches.arinc_702_dispatch(this, message, result, options);
+  }
+}

lib/plugins/generated/CBand.ts

@@ -0,0 +1,24 @@
+// AUTO-GENERATED from /Users/kevin/Cloud/Dropbox/work/airframes/acars-decoder-typescript/vendor/airframes-decoder/spec/wildcards/cband.yaml. Do not edit.
+// Plugin: CBand
+
+import { DecoderPlugin } from "@airframes/ads-runtime-ts";
+import type { DecodeResult, Message, Options } from "@airframes/ads-runtime-ts";
+import { ResultFormatter } from "@airframes/ads-runtime-ts";
+import * as helpers from "@airframes/ads-runtime-ts/helpers";
+import * as hatches from "../escape_hatches";
+
+export class CBand extends DecoderPlugin {
+  name = "cband";
+
+  qualifiers() {
+    return {
+      labels: ["*"],
+    };
+  }
+
+  decode(message: Message, options: Options = {}): DecodeResult {
+    const result = this.initResult(message, "C-Band Message");
+
+    return hatches.cband_dispatch(this, message, result, options);
+  }
+}

lib/plugins/generated/Label_10_LDR.ts

@@ -0,0 +1,25 @@
+// AUTO-GENERATED from /Users/kevin/Cloud/Dropbox/work/airframes/acars-decoder-typescript/vendor/airframes-decoder/spec/labels/10/LDR.yaml. Do not edit.
+// Plugin: Label_10_LDR
+
+import { DecoderPlugin } from "@airframes/ads-runtime-ts";
+import type { DecodeResult, Message, Options } from "@airframes/ads-runtime-ts";
+import { ResultFormatter } from "@airframes/ads-runtime-ts";
+import * as helpers from "@airframes/ads-runtime-ts/helpers";
+import * as hatches from "../escape_hatches";
+
+export class Label_10_LDR extends DecoderPlugin {
+  name = "label-10-ldr";
+
+  qualifiers() {
+    return {
+      labels: ["10"],
+      preambles: ["LDR"],
+    };
+  }
+
+  decode(message: Message, options: Options = {}): DecodeResult {
+    const result = this.initResult(message, "Position Report");
+
+    return hatches.label_10_ldr_decode(this, message, result, options);
+  }
+}

lib/plugins/generated/Label_10_POS.ts

@@ -0,0 +1,40 @@
+// AUTO-GENERATED from /Users/kevin/Cloud/Dropbox/work/airframes/acars-decoder-typescript/vendor/airframes-decoder/spec/labels/10/POS.yaml. Do not edit.
+// Plugin: Label_10_POS
+// Docs: https://github.com/airframesio/acars-message-documentation/blob/main/research/10/POS.md
+
+import { DecoderPlugin } from "@airframes/ads-runtime-ts";
+import type { DecodeResult, Message, Options } from "@airframes/ads-runtime-ts";
+import { ResultFormatter } from "@airframes/ads-runtime-ts";
+import * as helpers from "@airframes/ads-runtime-ts/helpers";
+import * as hatches from "../escape_hatches";
+
+export class Label_10_POS extends DecoderPlugin {
+  name = "label-10-pos";
+
+  qualifiers() {
+    return {
+      labels: ["10"],
+      preambles: ["POS"],
+    };
+  }
+
+  decode(message: Message, options: Options = {}): DecodeResult {
+    const result = this.initResult(message, "Position Report");
+
+    const parts = message.text.split(",");
+    if (parts.length !== 12) {
+      return this.failUnknown(result, message.text, options);
+    }
+    const latitude = helpers.coordinate(parts[1], {"style":"single_axis","axis":"latitude","prefix_chars":["N","S"],"digits":5,"divisor":100});
+    result.raw.latitude = latitude;
+    const longitude = helpers.coordinate(parts[2], {"style":"single_axis","axis":"longitude","prefix_chars":["E","W"],"digits":5,"divisor":100});
+    result.raw.longitude = longitude;
+    const altitude = helpers.integer(parts[7]);
+    result.raw.altitude = altitude;
+    ResultFormatter.position(result, { latitude: latitude, longitude: longitude });
+    ResultFormatter.altitude(result, altitude);
+    ResultFormatter.unknownArr(result, [parts[0], parts[3], parts[4], parts[5], parts[6], parts[8], parts[9], parts[10], parts[11]]);
+    this.setDecodeLevel(result, true, 'partial');
+    return result;
+  }
+}

lib/plugins/generated/Label_10_Slash.ts

@@ -0,0 +1,25 @@
+// AUTO-GENERATED from /Users/kevin/Cloud/Dropbox/work/airframes/acars-decoder-typescript/vendor/airframes-decoder/spec/labels/10/Slash.yaml. Do not edit.
+// Plugin: Label_10_Slash
+
+import { DecoderPlugin } from "@airframes/ads-runtime-ts";
+import type { DecodeResult, Message, Options } from "@airframes/ads-runtime-ts";
+import { ResultFormatter } from "@airframes/ads-runtime-ts";
+import * as helpers from "@airframes/ads-runtime-ts/helpers";
+import * as hatches from "../escape_hatches";
+
+export class Label_10_Slash extends DecoderPlugin {
+  name = "label-10-slash";
+
+  qualifiers() {
+    return {
+      labels: ["10"],
+      preambles: ["/"],
+    };
+  }
+
+  decode(message: Message, options: Options = {}): DecodeResult {
+    const result = this.initResult(message, "Position Report");
+
+    return hatches.label_10_slash_decode(this, message, result, options);
+  }
+}

lib/plugins/generated/Label_12_N_Space.ts

@@ -0,0 +1,25 @@
+// AUTO-GENERATED from /Users/kevin/Cloud/Dropbox/work/airframes/acars-decoder-typescript/vendor/airframes-decoder/spec/labels/12/N_Space.yaml. Do not edit.
+// Plugin: Label_12_N_Space
+
+import { DecoderPlugin } from "@airframes/ads-runtime-ts";
+import type { DecodeResult, Message, Options } from "@airframes/ads-runtime-ts";
+import { ResultFormatter } from "@airframes/ads-runtime-ts";
+import * as helpers from "@airframes/ads-runtime-ts/helpers";
+import * as hatches from "../escape_hatches";
+
+export class Label_12_N_Space extends DecoderPlugin {
+  name = "label-12-n-space";
+
+  qualifiers() {
+    return {
+      labels: ["12"],
+      preambles: ["N ","S "],
+    };
+  }
+
+  decode(message: Message, options: Options = {}): DecodeResult {
+    const result = this.initResult(message, "Position Report");
+
+    return hatches.label_12_n_space_decode(this, message, result, options);
+  }
+}