Add comments, shebang, chmod scripts in repo (#2980)

Author: jakebailey

_packages/api/scripts/generateSync.ts

@@ -1,3 +1,5 @@
+#!/usr/bin/env -S node --experimental-strip-types --no-warnings
+
 /**
  * Generates sync API from async API source files.
  *
@@ -16,7 +18,7 @@
  *   - Unwrap `Promise<T>` → `T` in type references
  *
  * Usage:
- *   node --experimental-strip-types --no-warnings scripts/generate.ts
+ *   node --experimental-strip-types --no-warnings generateSync.ts
  */
 
 import { execaSync } from "execa";

_packages/ast/scripts/generateFactory.ts

@@ -1,10 +1,10 @@
-#!/usr/bin/env node
+#!/usr/bin/env -S node --conditions=@typescript/source --experimental-strip-types --no-warnings
 
 /**
  * Code generator for the monomorphic NodeObject class and factory functions.
  *
  * Usage:
- *   node _packages/ast/scripts/generateFactory.ts
+ *   node --conditions=@typescript/source --experimental-strip-types --no-warnings generateFactory.ts
  *
  * Reads:  _packages/ast/src/nodes.ts
  * Writes: _packages/ast/src/factory.ts

internal/fourslash/_scripts/convertFourslash.mts

@@ -1,3 +1,7 @@
+#!/usr/bin/env -S node --experimental-strip-types --no-warnings
+
+// Usage: node --experimental-strip-types --no-warnings convertFourslash.mts [inputFileList]
+
 import * as cp from "child_process";
 import * as fs from "fs";
 import * as path from "path";

internal/fourslash/_scripts/makeManual.mts

@@ -1,3 +1,7 @@
+#!/usr/bin/env -S node --experimental-strip-types --no-warnings
+
+// Usage: node --experimental-strip-types --no-warnings makeManual.mts <testName> [...testNames]
+
 import * as fs from "fs";
 import * as path from "path";
 

internal/fourslash/_scripts/updateFailing.mts

@@ -1,3 +1,7 @@
+#!/usr/bin/env -S node --experimental-strip-types --no-warnings
+
+// Usage: node --experimental-strip-types --no-warnings updateFailing.mts
+
 import * as cp from "child_process";
 import * as fs from "fs";
 import path from "path";

internal/lsp/lsproto/_generate/fetchModel.mts

@@ -1,3 +1,7 @@
+#!/usr/bin/env -S node --experimental-strip-types
+
+// Usage: node --experimental-strip-types fetchModel.mts
+
 import fs from "node:fs";
 import path from "node:path";
 import url from "node:url";

internal/lsp/lsproto/_generate/generate.mts

@@ -1,4 +1,6 @@
-#!/usr/bin/env node
+#!/usr/bin/env -S node --experimental-strip-types
+
+// Usage: node --experimental-strip-types generate.mts
 
 import cp from "node:child_process";
 import fs from "node:fs";