feat(#208): TS MetaSource @sql/@Unmanaged resolving accessors

Task 2 — add `sqlBody` (the @SQL hand-written body, narrowed to a non-empty
string) and `isUnmanaged` (the @Unmanaged flag) resolving accessors to the TS
MetaSource, next to effectiveKind/role. RESOLVING (ADR-0039) — sources are
inheritable, so these read the effective attr via attr(...), not own-only.
Consumed by the loader validation, suppression, and migrate tasks that follow.

Gated by a new TDD test; full metadata suite 2188/2188 + typecheck clean.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NGQ7oSuNcjhsMHWwZzhBwr

Author: dmealing

server/typescript/packages/metadata/src/persistence/source/meta-source.ts

@@ -15,6 +15,8 @@ import {
   SOURCE_ATTR_FUNCTION,
   SOURCE_ATTR_KIND,
   SOURCE_ATTR_ROLE,
+  SOURCE_ATTR_SQL,
+  SOURCE_ATTR_UNMANAGED,
   SOURCE_READ_ONLY_KINDS,
   DEFAULT_SOURCE_KIND,
   DEFAULT_SOURCE_ROLE,
@@ -59,6 +61,27 @@ export class MetaSource extends MetaData {
     return typeof v === "string" && v !== "" ? v : DEFAULT_SOURCE_ROLE;
   }
 
+  /**
+   * FR-024/#208 — the hand-written SQL body for this source's DB object, when
+   * declared via `@sql`. The tool registers + fingerprints + drift-checks this
+   * body but never authors or parses it.
+   */
+  get sqlBody(): string | undefined {
+    // ADR-0039: resolving — an inherited source's @sql lives on the super node.
+    const v = this.attr(SOURCE_ATTR_SQL);
+    return typeof v === "string" && v !== "" ? v : undefined;
+  }
+
+  /**
+   * FR-024/#208 — true when this source's DB object is managed elsewhere
+   * (Flyway / a hand-migration owns its DDL); `meta migrate` does not
+   * create/drop/drift-check it.
+   */
+  get isUnmanaged(): boolean {
+    // ADR-0039: resolving — an inherited source's @unmanaged lives on the super node.
+    return this.attr(SOURCE_ATTR_UNMANAGED) === true;
+  }
+
   /**
    * True when this source's effective kind is read-only (view, materializedView,
    * storedProc, tableFunction). Derived from the @kind attr on source.rdb.

server/typescript/packages/metadata/test/meta-source-sql-unmanaged.test.ts

@@ -0,0 +1,23 @@
+// #208 Task 2 — MetaSource resolving accessors for @sql / @unmanaged
+// (registered in Task 1, commit 5ecacb01). Mirrors the effectiveKind/role
+// accessor test pattern in test/source-rdb.test.ts.
+
+import { expect, test } from "bun:test";
+import { loadString } from "../src/index.js";
+import { MetaSource } from "../src/persistence/source/meta-source.js";
+
+test("MetaSource exposes @sql body and @unmanaged flag (resolving)", async () => {
+  const { root } = await loadString(
+    `{"metadata.root":{"package":"t","children":[
+      {"object.projection":{"name":"R","children":[
+        {"source.rdb":{"@kind":"view","@view":"v_r","@sql":"SELECT 1"}},
+        {"field.int":{"name":"x"}}]}}]}}`,
+    "json",
+  );
+  const src = root
+    .findObject("R")!
+    .ownChildren()
+    .find((c) => c instanceof MetaSource)! as MetaSource;
+  expect(src.sqlBody).toBe("SELECT 1");
+  expect(src.isUnmanaged).toBe(false);
+});