@cleocode/cleo-os 2026.4.13 → 2026.4.17

package/bin/postinstall.js

@@ -1,94 +1,208 @@
-#!/usr/bin/env node
 /**
- * CleoOS postinstall — scaffolds global XDG hub and deploys extensions.
+ * CleoOS postinstall — scaffolds the global XDG hub and deploys extensions.
  *
  * Runs automatically after `npm install -g @cleocode/cleo-os`.
- * Creates XDG-compliant directory structure and copies the CANT bridge
- * extension template into the extensions directory.
+ * Creates an XDG-compliant directory structure, copies the compiled CANT
+ * bridge extension to the extensions directory, and optionally invokes
+ * `cleo skills install` for any bundled CleoOS skills.
  *
- * Skips during workspace/dev installs (non-global).
+ * Behaviour:
+ *   - Skips silently during workspace/dev installs (non-global).
+ *   - All directory creation is idempotent (no-op if directory exists).
+ *   - All file copies are idempotent (only copies if target is missing).
+ *   - Skill install is best-effort; failures are logged but not fatal.
+ *   - Missing `@mariozechner/pi-coding-agent` is handled gracefully.
  *
- * This file is plain JS (not compiled from src/) so it can run before
- * the package is built, matching the @cleocode/cleo postinstall pattern.
+ * This source compiles to `bin/postinstall.js` via a dedicated tsconfig
+ * (see `tsconfig.postinstall.json`). The `postinstall` script in
+ * `package.json` references the compiled output at `bin/postinstall.js`.
+ *
+ * @packageDocumentation
  */
-
-import { existsSync, mkdirSync, cpSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { cpSync, existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { homedir } from 'node:os';
-
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-
+// ---------------------------------------------------------------------------
+// XDG path resolution (inline copy — avoids importing from dist/ which may
+// not exist when this script runs for the first time)
+// ---------------------------------------------------------------------------
+/**
+ * Inline XDG path resolution that mirrors `src/xdg.ts`.
+ *
+ * Uses an inline copy here so the postinstall script can run before
+ * the compiled `dist/` tree is available on a fresh install.
+ *
+ * @returns Resolved CleoOS XDG directory paths.
+ */
+function resolveCleoOsPaths() {
+    const home = homedir();
+    const xdgData = process.env['XDG_DATA_HOME'] ?? join(home, '.local', 'share');
+    const xdgConfig = process.env['XDG_CONFIG_HOME'] ?? join(home, '.config');
+    const data = join(xdgData, 'cleo');
+    const config = join(xdgConfig, 'cleo');
+    return {
+        data,
+        config,
+        agentDir: data,
+        extensions: join(data, 'extensions'),
+        cant: join(data, 'cant'),
+        auth: join(config, 'auth'),
+    };
+}
+// ---------------------------------------------------------------------------
+// Global install detection
+// ---------------------------------------------------------------------------
 /**
- * Detect if this is a global npm install (not a workspace/dev install).
+ * Detect whether this is a global npm / pnpm install.
+ *
+ * Uses four heuristics in priority order:
+ *  1. `npm_config_global=true` env var (set by npm/pnpm for global installs)
+ *  2. Package path contains `lib/node_modules/` (npm global pattern)
+ *  3. Package path starts with `npm_config_prefix` (npm prefix-based check)
+ *  4. Presence of `pnpm-workspace.yaml` two levels up (workspace = dev)
+ *
+ * @returns `true` if the install appears to be a global install.
  */
 function isGlobalInstall() {
-  const pkgRoot = resolve(__dirname, '..');
-
-  // Signal 1: npm_config_global env var (set by npm during global installs)
-  if (process.env.npm_config_global === 'true') return true;
-
-  // Signal 2: path contains a global node_modules (npm, pnpm, yarn)
-  if (/[/\\]lib[/\\]node_modules[/\\]/.test(pkgRoot)) return true;
-
-  // Signal 3: npm_config_prefix matches the package path
-  const prefix = process.env.npm_config_prefix;
-  if (prefix && pkgRoot.startsWith(prefix)) return true;
-
-  // Signal 4: inside a pnpm workspace — definitely not global
-  const workspaceMarker = join(pkgRoot, '..', '..', 'pnpm-workspace.yaml');
-  if (existsSync(workspaceMarker)) return false;
-
-  return false;
+    const pkgRoot = resolve(__dirname, '..');
+    // Signal 1: npm_config_global env var (set by npm during global installs)
+    if (process.env['npm_config_global'] === 'true')
+        return true;
+    // Signal 2: path contains a global node_modules (npm, pnpm, yarn)
+    if (/[/\\]lib[/\\]node_modules[/\\]/.test(pkgRoot))
+        return true;
+    // Signal 3: npm_config_prefix matches the package path
+    const prefix = process.env['npm_config_prefix'];
+    if (prefix !== undefined && pkgRoot.startsWith(prefix))
+        return true;
+    // Signal 4: inside a pnpm workspace — definitely not global
+    const workspaceMarker = join(pkgRoot, '..', '..', 'pnpm-workspace.yaml');
+    if (existsSync(workspaceMarker))
+        return false;
+    return false;
 }
-
+// ---------------------------------------------------------------------------
+// Directory scaffolding
+// ---------------------------------------------------------------------------
 /**
- * Inline XDG path resolution (avoids importing from dist/ which may not exist).
+ * Idempotently create a directory if it does not already exist.
+ *
+ * @param dir - Absolute path to the directory to create.
  */
-function resolveCleoOsPaths() {
-  const home = homedir();
-  const xdgData = process.env.XDG_DATA_HOME ?? join(home, '.local', 'share');
-  const xdgConfig = process.env.XDG_CONFIG_HOME ?? join(home, '.config');
-
-  const data = join(xdgData, 'cleo');
-  const config = join(xdgConfig, 'cleo');
-
-  return {
-    data,
-    config,
-    agentDir: data,
-    extensions: join(data, 'extensions'),
-    cant: join(data, 'cant'),
-    auth: join(config, 'auth'),
-  };
+function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+        process.stdout.write(`CleoOS: created ${dir}\n`);
+    }
 }
-
+// ---------------------------------------------------------------------------
+// Extension deployment
+// ---------------------------------------------------------------------------
+/**
+ * Copy a compiled extension to the XDG extensions directory.
+ *
+ * Only copies if the target does not already exist (idempotent). The
+ * source is the compiled `.js` file in the package's `extensions/` folder.
+ *
+ * @param extensionName - Filename without the `.js` extension.
+ * @param pkgRoot - Absolute path to the installed package root.
+ * @param extensionsDir - Absolute path to the XDG extensions directory.
+ */
+function deployExtension(extensionName, pkgRoot, extensionsDir) {
+    const src = join(pkgRoot, 'extensions', `${extensionName}.js`);
+    const dest = join(extensionsDir, `${extensionName}.js`);
+    if (!existsSync(src)) {
+        process.stdout.write(`CleoOS: skipping ${extensionName}.js (source not found at ${src})\n`);
+        return;
+    }
+    if (existsSync(dest)) {
+        // Already deployed — idempotent, skip.
+        return;
+    }
+    cpSync(src, dest, { force: false });
+    process.stdout.write(`CleoOS: deployed ${extensionName}.js to ${dest}\n`);
+}
+// ---------------------------------------------------------------------------
+// Default CANT file scaffolding
+// ---------------------------------------------------------------------------
+/**
+ * Write a default `model-routing.cant` stub to the XDG CANT directory if
+ * no `.cant` files are present. This gives the user a starting point for
+ * CANT declarations without overwriting any existing work.
+ *
+ * @param cantDir - Absolute path to the XDG CANT directory.
+ */
+function scaffoldDefaultCant(cantDir) {
+    const modelRoutingPath = join(cantDir, 'model-routing.cant');
+    if (existsSync(modelRoutingPath))
+        return;
+    const stub = [
+        '# CleoOS default model-routing.cant',
+        '# Declare agents, teams, and routing rules here.',
+        '# See: https://github.com/kryptobaseddev/cleo/blob/main/docs/cant-dsl.md',
+        '',
+    ].join('\n');
+    try {
+        writeFileSync(modelRoutingPath, stub, 'utf-8');
+        process.stdout.write(`CleoOS: created default ${modelRoutingPath}\n`);
+    }
+    catch {
+        // Best-effort: non-fatal.
+    }
+}
+// ---------------------------------------------------------------------------
+// Skill installation
+// ---------------------------------------------------------------------------
+/**
+ * Invoke `cleo skills install` via `execFileSync` to register the CleoOS
+ * bundled skills with the project. This is best-effort — if `cleo` is not
+ * on PATH or the command fails, we log and continue.
+ *
+ * Uses `execFileSync` (not `exec`) to prevent shell injection: the command
+ * and arguments are passed as separate parameters so no shell is spawned.
+ */
+function installSkills() {
+    try {
+        execFileSync('cleo', ['skills', 'install'], { stdio: 'inherit' });
+        process.stdout.write('CleoOS: skills install complete\n');
+    }
+    catch {
+        // cleo may not be installed or skills may already be up to date.
+        process.stdout.write('CleoOS: skipping skills install (cleo not found or already installed)\n');
+    }
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+/**
+ * Entry point for the CleoOS postinstall script.
+ *
+ * Orchestrates directory scaffolding, extension deployment, CANT stub
+ * creation, and optional skill installation. All operations are idempotent.
+ */
 function main() {
-  if (!isGlobalInstall()) {
-    console.log('CleoOS: skipping postinstall (not global install)');
-    return;
-  }
-
-  const paths = resolveCleoOsPaths();
-
-  // Scaffold directories
-  for (const dir of [paths.data, paths.config, paths.extensions, paths.cant, paths.auth]) {
-    if (!existsSync(dir)) {
-      mkdirSync(dir, { recursive: true });
-      console.log(`CleoOS: created ${dir}`);
+    if (!isGlobalInstall()) {
+        process.stdout.write('CleoOS: skipping postinstall (not global install)\n');
+        return;
+    }
+    const paths = resolveCleoOsPaths();
+    const pkgRoot = resolve(__dirname, '..');
+    // 1. Scaffold XDG directories
+    for (const dir of [paths.data, paths.config, paths.extensions, paths.cant, paths.auth]) {
+        ensureDir(dir);
     }
-  }
-
-  // Deploy bridge extension from package template
-  const bridgeTemplate = join(__dirname, '..', 'extensions', 'cleo-cant-bridge.js');
-  const bridgeTarget = join(paths.extensions, 'cleo-cant-bridge.js');
-  if (existsSync(bridgeTemplate)) {
-    cpSync(bridgeTemplate, bridgeTarget, { force: true });
-    console.log(`CleoOS: deployed bridge extension to ${bridgeTarget}`);
-  }
-
-  console.log('CleoOS: postinstall complete');
+    // 2. Deploy compiled extensions
+    deployExtension('cleo-cant-bridge', pkgRoot, paths.extensions);
+    deployExtension('cleo-chatroom', pkgRoot, paths.extensions);
+    // 3. Write default CANT stub (only if file does not exist)
+    scaffoldDefaultCant(paths.cant);
+    // 4. Install CleoOS skills (best-effort)
+    installSkills();
+    process.stdout.write('CleoOS: postinstall complete\n');
 }
-
 main();
+//# sourceMappingURL=postinstall.js.map

package/bin/postinstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * CleoOS launcher — the batteries-included agentic development environment.
+ *
+ * Wraps Pi's `main()` entry point with the cleo-cant-bridge pre-loaded
+ * as an extension. Pi stays upstream (ULTRAPLAN L1). This is a thin
+ * launcher that injects CleoOS extensions into Pi's CLI argument list.
+ *
+ * Usage: `cleoos [pi-args...]` — launches Pi with CANT bridge extension.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}

package/dist/cli.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/**
+ * CleoOS launcher — the batteries-included agentic development environment.
+ *
+ * Wraps Pi's `main()` entry point with the cleo-cant-bridge pre-loaded
+ * as an extension. Pi stays upstream (ULTRAPLAN L1). This is a thin
+ * launcher that injects CleoOS extensions into Pi's CLI argument list.
+ *
+ * Usage: `cleoos [pi-args...]` — launches Pi with CANT bridge extension.
+ *
+ * @packageDocumentation
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveCleoOsPaths } from './xdg.js';
+/**
+ * Collect CleoOS extension paths that exist on disk.
+ *
+ * Resolves the CANT bridge extension from the XDG data directory.
+ * Only returns paths for extensions that actually exist on the filesystem.
+ *
+ * @returns Array of absolute extension file paths.
+ */
+function collectExtensionPaths() {
+    const paths = resolveCleoOsPaths();
+    const extensions = [];
+    const bridgePath = join(paths.extensions, 'cleo-cant-bridge.js');
+    if (existsSync(bridgePath)) {
+        extensions.push(bridgePath);
+    }
+    return extensions;
+}
+/**
+ * Build the argument list for Pi's `main()`, injecting CleoOS extensions.
+ *
+ * Takes the user's CLI arguments (everything after `cleoos`) and prepends
+ * `--extension <path>` flags for each discovered CleoOS extension.
+ *
+ * @param userArgs - Arguments passed to `cleoos` by the user.
+ * @param extensionPaths - Resolved extension paths to inject.
+ * @returns Combined argument array for Pi's `main()`.
+ */
+function buildArgs(userArgs, extensionPaths) {
+    const extensionFlags = extensionPaths.flatMap((p) => ['--extension', p]);
+    return [...extensionFlags, ...userArgs];
+}
+/**
+ * Entry point for the `cleoos` binary.
+ *
+ * Dynamically imports Pi's coding agent (peerDependency), resolves CleoOS
+ * extension paths, and delegates to Pi's `main()` with the bridge extension
+ * injected into the argument list.
+ *
+ * Exits with code 1 if Pi is not installed, providing install instructions.
+ */
+async function main() {
+    // Dynamically import Pi — it's a peerDependency, may not be installed
+    let piMain;
+    try {
+        const pi = await import('@mariozechner/pi-coding-agent');
+        piMain = pi.main;
+    }
+    catch {
+        console.error('CleoOS requires Pi Coding Agent to be installed.\n' +
+            'Run: npm install -g @mariozechner/pi-coding-agent\n' +
+            'Then try again: cleoos');
+        process.exit(1);
+    }
+    const extensionPaths = collectExtensionPaths();
+    const args = buildArgs(process.argv.slice(2), extensionPaths);
+    await piMain(args);
+}
+main().catch((err) => {
+    console.error('CleoOS fatal:', err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;GAOG;AACH,SAAS,qBAAqB;IAC5B,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAC;IACjE,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,SAAS,CAAC,QAAkB,EAAE,cAAwB;IAC7D,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,cAAc,EAAE,GAAG,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,IAAI;IACjB,sEAAsE;IACtE,IAAI,MAAyC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;QACzD,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CACX,oDAAoD;YAClD,qDAAqD;YACrD,wBAAwB,CAC3B,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAE9D,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/keystore.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CleoOS keystore — Pi API key management with XDG-compliant storage.
+ *
+ * Wraps Pi's `FileAuthStorageBackend` with a CleoOS-specific XDG path so
+ * that credentials are persisted at `~/.config/cleo/auth/auth.json` (the
+ * `auth` sub-path of the CleoOS XDG config directory) rather than Pi's
+ * default location.
+ *
+ * This ensures:
+ *   - Credentials survive `cleoos` reinstalls (XDG is outside the package).
+ *   - Multiple CleoOS installations on the same host share credentials.
+ *   - The auth file lives under the XDG Config spec (`~/.config/cleo/`).
+ *
+ * @packageDocumentation
+ */
+import { FileAuthStorageBackend } from '@mariozechner/pi-coding-agent';
+/**
+ * Resolve a `FileAuthStorageBackend` configured to use the CleoOS XDG
+ * auth directory (`~/.config/cleo/auth/auth.json`).
+ *
+ * The directory is NOT created here — that is handled by the postinstall
+ * script so that directory creation is a one-time operation.
+ *
+ * @returns A `FileAuthStorageBackend` pointed at the XDG-compliant path.
+ */
+export declare function resolveKeystore(): FileAuthStorageBackend;
+//# sourceMappingURL=keystore.d.ts.map

package/dist/keystore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keystore.d.ts","sourceRoot":"","sources":["../src/keystore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAMvE;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,sBAAsB,CAIxD"}

package/dist/keystore.js

@@ -0,0 +1,35 @@
+/**
+ * CleoOS keystore — Pi API key management with XDG-compliant storage.
+ *
+ * Wraps Pi's `FileAuthStorageBackend` with a CleoOS-specific XDG path so
+ * that credentials are persisted at `~/.config/cleo/auth/auth.json` (the
+ * `auth` sub-path of the CleoOS XDG config directory) rather than Pi's
+ * default location.
+ *
+ * This ensures:
+ *   - Credentials survive `cleoos` reinstalls (XDG is outside the package).
+ *   - Multiple CleoOS installations on the same host share credentials.
+ *   - The auth file lives under the XDG Config spec (`~/.config/cleo/`).
+ *
+ * @packageDocumentation
+ */
+import { join } from 'node:path';
+import { FileAuthStorageBackend } from '@mariozechner/pi-coding-agent';
+import { resolveCleoOsPaths } from './xdg.js';
+/** Default auth file name inside the keystore directory. */
+const AUTH_FILENAME = 'auth.json';
+/**
+ * Resolve a `FileAuthStorageBackend` configured to use the CleoOS XDG
+ * auth directory (`~/.config/cleo/auth/auth.json`).
+ *
+ * The directory is NOT created here — that is handled by the postinstall
+ * script so that directory creation is a one-time operation.
+ *
+ * @returns A `FileAuthStorageBackend` pointed at the XDG-compliant path.
+ */
+export function resolveKeystore() {
+    const paths = resolveCleoOsPaths();
+    const authFilePath = join(paths.auth, AUTH_FILENAME);
+    return new FileAuthStorageBackend(authFilePath);
+}
+//# sourceMappingURL=keystore.js.map

package/dist/keystore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keystore.js","sourceRoot":"","sources":["../src/keystore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,4DAA4D;AAC5D,MAAM,aAAa,GAAG,WAAW,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACrD,OAAO,IAAI,sBAAsB,CAAC,YAAY,CAAC,CAAC;AAClD,CAAC"}

package/dist/postinstall.d.ts

@@ -0,0 +1,23 @@
+/**
+ * CleoOS postinstall — scaffolds the global XDG hub and deploys extensions.
+ *
+ * Runs automatically after `npm install -g @cleocode/cleo-os`.
+ * Creates an XDG-compliant directory structure, copies the compiled CANT
+ * bridge extension to the extensions directory, and optionally invokes
+ * `cleo skills install` for any bundled CleoOS skills.
+ *
+ * Behaviour:
+ *   - Skips silently during workspace/dev installs (non-global).
+ *   - All directory creation is idempotent (no-op if directory exists).
+ *   - All file copies are idempotent (only copies if target is missing).
+ *   - Skill install is best-effort; failures are logged but not fatal.
+ *   - Missing `@mariozechner/pi-coding-agent` is handled gracefully.
+ *
+ * This source compiles to `bin/postinstall.js` via a dedicated tsconfig
+ * (see `tsconfig.postinstall.json`). The `postinstall` script in
+ * `package.json` references the compiled output at `bin/postinstall.js`.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=postinstall.d.ts.map

package/dist/postinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.d.ts","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}