docstar-cli 1.2.1 → 1.4.0

package/README.md

@@ -1,12 +1,12 @@
 # docstar-cli
 
-A CLI for calling published DocStar API endpoints directly from your terminal, without leaving the shell to read docs. Point it at a DocStar docs site, pick which modules (e.g. "Slack") you want, and it turns each published endpoint into a real command you can run. You can install from multiple docs sites/collections at once — each is kept separate under its own **CLI name**.
+A CLI for calling published DocStar API endpoints directly from your terminal, without leaving the shell to read docs. Point it at a DocStar docs site, pick which modules (e.g. "Slack") you want, and it turns each published endpoint into a real command you can run. You can install from multiple docs sites/collections at once — each is kept separate under its own **slug**.
 
 ## Concepts: collection → module → endpoint
 
 Every command follows a fixed three-level hierarchy:
 
-1. **Collection** — a docs site, identified by its **CLI name** (e.g. `msg91`). This is what `docstar-cli init` installs.
+1. **Collection** — a docs site, identified by its **slug** (e.g. `msg91`). This is what `docstar-cli init` installs.
 2. **Module** — a top-level section within that collection (e.g. `slack`).
 3. **Endpoint** — one published API within a module, turned into a command (e.g. `send-message-1`).
 
@@ -38,10 +38,10 @@ docstar-cli init localhost:3000 --collectionId paM4R4A26Hvb
 
 This fetches the list of published modules for that collection and shows an interactive checklist (nothing checked by default — press `space` to toggle a module, or select the **"Select all modules"** entry at the bottom of the list to install everything, then `enter` to confirm). For each selected module it:
 
-- saves its full endpoint contract to `~/.docstar/modules/<cli-name>/<module>.json`
-- registers a real CLI command for every endpoint: `docstar-cli <cli-name> <module> <command>`
+- saves its full endpoint contract to `~/.docstar/modules/<slug>/<module>.json`
+- registers a real CLI command for every endpoint: `docstar-cli <slug> <module> <command>`
 
-The **CLI name** comes from the collection's settings (set it under the collection's Domain settings in the docs editor — lowercase letters, numbers, `-` and `_` only; auto-generated from the collection name if not set yet). Running `init` against a different domain/collection adds it alongside any others already installed — nothing gets overwritten.
+The **slug** is chosen when the collection is created in DocStar (lowercase letters, numbers, `-` and `_` only) and never changes afterwards; the same slug identifies the collection for MCP. Running `init` against a different domain/collection adds it alongside any others already installed — nothing gets overwritten.
 
 Everything is saved to `~/.docstar/config.json`, grouped by collection.
 
@@ -128,9 +128,9 @@ there's at least one installed module for `mcp` to expose.
 
 ## How it works
 
-- `docstar-cli init` talks to `GET /p/module.json?collectionId=...` (the collection's name, CLI name, and list of modules) and `GET /p/<module>/module.json?collectionId=...` (a module's endpoint contract) on the docs site.
+- `docstar-cli init` talks to `GET /p/module.json?collectionId=...` (the collection's name, slug, and list of modules) and `GET /p/<module>/module.json?collectionId=...` (a module's endpoint contract) on the docs site.
 - Each endpoint's contract (method, url, base url, headers, body, and CLI parameter names) is saved locally and used to build the real HTTP request when you run its command — no network round-trip to the docs site is needed to run a command once a module is installed.
-- Commands are generated as real files on disk under this repo's `dist/commands/<cli-name>/<module>/`, which is why `npm run build` (it wipes `dist/`) requires re-running `docstar-cli init` for each installed collection afterwards to reinstall your modules.
+- Commands are generated as real files on disk under this repo's `dist/commands/<slug>/<module>/`, which is why `npm run build` (it wipes `dist/`) requires re-running `docstar-cli init` for each installed collection afterwards to reinstall your modules.
 
 ## Development
 

package/dist/commands/api-test/whatsapp/send-message.js

@@ -0,0 +1,35 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["integrated_number","content_type","payload"]
+
+export default class Generated extends Command {
+  static description = "send message"
+  static aliases = []
+  static flags = {
+    "integrated_number": Flags.string({description: "Required parameter"}),
+    "content_type": Flags.string({description: "Required parameter"}),
+    "payload": Flags.string({description: "Required parameter"}),
+    "Content-Type": Flags.string({description: 'Header value'}),
+    "authkey": Flags.string({description: 'Header value'}),
+    "content-type": Flags.string({description: 'Header value'}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("api-test", "whatsapp", "send-message", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/config/get.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class ConfigGet extends Command {
+    static args: {
+        cliName: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        key: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/config/get.js

@@ -0,0 +1,43 @@
+import { Args, Command } from '@oclif/core';
+import { readFile } from 'node:fs/promises';
+import { configPath } from '../../lib/paths.js';
+export default class ConfigGet extends Command {
+    static args = {
+        cliName: Args.string({ description: 'Installed collection (CLI name), e.g. msg91', required: true }),
+        key: Args.string({ description: 'Credential name to look up, e.g. authkey. Omit to show all saved credentials.', required: false }),
+    };
+    static description = 'Show saved credentials for a collection, or a single credential value';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> msg91           # show all credentials saved for "msg91"',
+        '<%= config.bin %> <%= command.id %> msg91 authkey    # show just the "authkey" value',
+    ];
+    async run() {
+        const { args } = await this.parse(ConfigGet);
+        let savedConfig;
+        try {
+            savedConfig = JSON.parse(await readFile(configPath(), 'utf8'));
+        }
+        catch {
+            this.error('No installed modules found. Run `docstar-cli init <domain>` first.');
+        }
+        const collection = savedConfig.collections.find((c) => c.cliName === args.cliName);
+        if (!collection) {
+            this.error(`Collection "${args.cliName}" isn't installed. Run \`docstar-cli list\` to see installed collections.`);
+        }
+        const credentials = collection.credentials || {};
+        if (args.key) {
+            if (!(args.key in credentials)) {
+                this.error(`No credential named "${args.key}" saved for collection "${args.cliName}".`);
+            }
+            this.log(credentials[args.key]);
+            return;
+        }
+        const entries = Object.entries(credentials);
+        if (entries.length === 0) {
+            this.log(`No credentials saved for collection "${args.cliName}".`);
+            return;
+        }
+        for (const [key, value] of entries)
+            this.log(`${key}=${value}`);
+    }
+}

package/dist/commands/config/set.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class ConfigSet extends Command {
+    static args: {
+        cliName: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        key: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        value: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/config/set.js

@@ -0,0 +1,33 @@
+import { Args, Command } from '@oclif/core';
+import { readFile, writeFile } from 'node:fs/promises';
+import { configPath } from '../../lib/paths.js';
+export default class ConfigSet extends Command {
+    static args = {
+        cliName: Args.string({ description: 'Installed collection (CLI name), e.g. msg91', required: true }),
+        key: Args.string({ description: 'Credential name, matching a header/param name, e.g. authkey', required: true }),
+        value: Args.string({ description: 'Value to store', required: true }),
+    };
+    static description = [
+        'Save a per-collection credential (e.g. an API/auth key) so it is injected into every request',
+        'automatically, instead of having to pass it as a flag on every command.',
+        'An explicit `--<key> value` flag on a command still overrides the saved credential.',
+    ].join('\n');
+    static examples = ['<%= config.bin %> <%= command.id %> msg91 authkey 279417Ac93k5fIO5qG6a9e6a8eP1'];
+    async run() {
+        const { args } = await this.parse(ConfigSet);
+        let savedConfig;
+        try {
+            savedConfig = JSON.parse(await readFile(configPath(), 'utf8'));
+        }
+        catch {
+            this.error('No installed modules found. Run `docstar-cli init <domain>` first.');
+        }
+        const collection = savedConfig.collections.find((c) => c.cliName === args.cliName);
+        if (!collection) {
+            this.error(`Collection "${args.cliName}" isn't installed. Run \`docstar-cli list\` to see installed collections.`);
+        }
+        collection.credentials = { ...collection.credentials, [args.key]: args.value };
+        await writeFile(configPath(), JSON.stringify(savedConfig, null, 2));
+        this.log(`Saved "${args.key}" for collection "${args.cliName}".`);
+    }
+}

package/dist/commands/dump-test/parent-page/collection.js

@@ -0,0 +1,33 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["username","password","this is a"]
+
+export default class Generated extends Command {
+  static description = "this is the collection for api testing"
+  static aliases = []
+  static flags = {
+    "username": Flags.string({description: "Required parameter"}),
+    "password": Flags.string({description: "Required parameter"}),
+    "this is a": Flags.string({description: "Required parameter"}),
+    "content-type": Flags.string({description: 'Header value'}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("dump-test", "parent-page", "collection", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/add-repo-to-installation-for-authenticated-user.js

@@ -0,0 +1,31 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["0","1"]
+
+export default class Generated extends Command {
+  static description = "Add a single repository to an installation. The authenticated user must have admin access to the repository.\n\nYou must use a personal access token (which you can create via the [command line](https://docs.github.com/github/authenticating-to-github/creating-a-personal-access-token) or [Basic Authentication](https://docs.github.com/rest/overview/other-authentication-methods#basic-authentication)) to access this endpoint."
+  static aliases = []
+  static flags = {
+    "0": Flags.string({description: "Required parameter"}),
+    "1": Flags.string({description: "Required parameter"}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "add-repo-to-installation-for-authenticated-user", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/check-authorization.js

@@ -0,0 +1,31 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["0","1"]
+
+export default class Generated extends Command {
+  static description = "**Deprecation Notice:** GitHub will discontinue OAuth endpoints that contain `access_token` in the path parameter. We have introduced new endpoints that allow you to securely manage tokens for OAuth Apps by moving `access_token` to the request body. For more information, see the [blog post](https://developer.github.com/changes/2020-02-14-deprecating-oauth-app-endpoint/).\n\nOAuth applications can use a special API method for checking OAuth token validity without exceeding the normal rate limits for failed login attempts. Authentication works differently with this particular endpoint. You must use [Basic Authentication](https://docs.github.com/rest/overview/other-authentication-methods#basic-authentication) when accessing this endpoint, using the OAuth application's `client_id` and `client_secret` as the username and password. Invalid tokens will return `404 NOT FOUND`."
+  static aliases = []
+  static flags = {
+    "0": Flags.string({description: "Required parameter"}),
+    "1": Flags.string({description: "Required parameter"}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "check-authorization", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/check-token.js

@@ -0,0 +1,30 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["0"]
+
+export default class Generated extends Command {
+  static description = "OAuth applications can use a special API method for checking OAuth token validity without exceeding the normal rate limits for failed login attempts. Authentication works differently with this particular endpoint. You must use [Basic Authentication](https://docs.github.com/rest/overview/other-authentication-methods#basic-authentication) to use this endpoint, where the username is the OAuth application `client_id` and the password is its `client_secret`. Invalid tokens will return `404 NOT FOUND`."
+  static aliases = []
+  static flags = {
+    "0": Flags.string({description: "Required parameter"}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "check-token", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/create-content-attachment.js

@@ -0,0 +1,30 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["0"]
+
+export default class Generated extends Command {
+  static description = "Creates an attachment under a content reference URL in the body or comment of an issue or pull request. Use the `id` of the content reference from the [`content_reference` event](https://docs.github.com/webhooks/event-payloads/#content_reference) to create an attachment.\n\nThe app must create a content attachment within six hours of the content reference URL being posted. See \"[Using content attachments](https://docs.github.com/apps/using-content-attachments/)\" for details about content attachments.\n\nYou must use an [installation access token](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation) to access this endpoint."
+  static aliases = []
+  static flags = {
+    "0": Flags.string({description: "Required parameter"}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "create-content-attachment", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/create-from-manifest.js

@@ -0,0 +1,30 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["0"]
+
+export default class Generated extends Command {
+  static description = "Use this endpoint to complete the handshake necessary when implementing the [GitHub App Manifest flow](https://docs.github.com/apps/building-github-apps/creating-github-apps-from-a-manifest/). When you create a GitHub App with the manifest flow, you receive a temporary `code` used to retrieve the GitHub App's `id`, `pem` (private key), and `webhook_secret`."
+  static aliases = []
+  static flags = {
+    "0": Flags.string({description: "Required parameter"}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "create-from-manifest", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/create-installation-access-token.js

@@ -0,0 +1,30 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["0"]
+
+export default class Generated extends Command {
+  static description = "Creates an installation access token that enables a GitHub App to make authenticated API requests for the app's installation on an organization or individual account. Installation tokens expire one hour from the time you create them. Using an expired token produces a status code of `401 - Unauthorized`, and requires creating a new installation token. By default the installation token has access to all repositories that the installation can access. To restrict the access to specific repositories, you can provide the `repository_ids` when creating the token. When you omit `repository_ids`, the response does not contain the `repositories` key.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint."
+  static aliases = []
+  static flags = {
+    "0": Flags.string({description: "Required parameter"}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "create-installation-access-token", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/delete-authorization.js

@@ -0,0 +1,30 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["0"]
+
+export default class Generated extends Command {
+  static description = "OAuth application owners can revoke a grant for their OAuth application and a specific user. You must use [Basic Authentication](https://docs.github.com/rest/overview/other-authentication-methods#basic-authentication) when accessing this endpoint, using the OAuth application's `client_id` and `client_secret` as the username and password. You must also provide a valid OAuth `access_token` as an input parameter and the grant for the token's owner will be deleted.\nDeleting an OAuth application's grant will also delete all OAuth tokens associated with the application for the user. Once deleted, the application will have no access to the user's account and will no longer be listed on [the application authorizations settings screen within GitHub](https://github.com/settings/applications#authorized)."
+  static aliases = []
+  static flags = {
+    "0": Flags.string({description: "Required parameter"}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "delete-authorization", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/delete-installation.js

@@ -0,0 +1,30 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["0"]
+
+export default class Generated extends Command {
+  static description = "Uninstalls a GitHub App on a user, organization, or business account. If you prefer to temporarily suspend an app's access to your account's resources, then we recommend the \"[Suspend an app installation](https://docs.github.com/rest/reference/apps/#suspend-an-app-installation)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint."
+  static aliases = []
+  static flags = {
+    "0": Flags.string({description: "Required parameter"}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "delete-installation", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/delete-token.js

@@ -0,0 +1,30 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["0"]
+
+export default class Generated extends Command {
+  static description = "OAuth application owners can revoke a single token for an OAuth application. You must use [Basic Authentication](https://docs.github.com/rest/overview/other-authentication-methods#basic-authentication) when accessing this endpoint, using the OAuth application's `client_id` and `client_secret` as the username and password."
+  static aliases = []
+  static flags = {
+    "0": Flags.string({description: "Required parameter"}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "delete-token", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/get-authenticated.js

@@ -0,0 +1,30 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = []
+
+export default class Generated extends Command {
+  static description = "Returns the GitHub App associated with the authentication credentials used. To see how many app installations are associated with this GitHub App, see the `installations_count` in the response. For more details about your app's installations, see the \"[List installations for the authenticated app](https://docs.github.com/rest/reference/apps#list-installations-for-the-authenticated-app)\" endpoint.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint."
+  static aliases = []
+  static flags = {
+
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "get-authenticated", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/get-by-slug.js

@@ -0,0 +1,30 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["0"]
+
+export default class Generated extends Command {
+  static description = "**Note**: The `:app_slug` is just the URL-friendly name of your GitHub App. You can find this on the settings page for your GitHub App (e.g., `https://github.com/settings/apps/:app_slug`).\n\nIf the GitHub App you specify is public, you can access this endpoint without authenticating. If the GitHub App you specify is private, you must authenticate with a [personal access token](https://docs.github.com/articles/creating-a-personal-access-token-for-the-command-line/) or an [installation access token](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation) to access this endpoint."
+  static aliases = []
+  static flags = {
+    "0": Flags.string({description: "Required parameter"}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "get-by-slug", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/get-installation.js

@@ -0,0 +1,30 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["0"]
+
+export default class Generated extends Command {
+  static description = "Enables an authenticated GitHub App to find an installation's information using the installation id.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint."
+  static aliases = []
+  static flags = {
+    "0": Flags.string({description: "Required parameter"}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "get-installation", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}

package/dist/commands/github/apps/get-org-installation.js

@@ -0,0 +1,30 @@
+import {Command, Flags} from '@oclif/core'
+import {executeCliCommand} from '../../../lib/http.js'
+import {promptForMissingParams} from '../../../lib/prompt.js'
+
+const REQUIRED_PARAMS = ["0"]
+
+export default class Generated extends Command {
+  static description = "Enables an authenticated GitHub App to find the organization's installation information.\n\nYou must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app) to access this endpoint."
+  static aliases = []
+  static flags = {
+    "0": Flags.string({description: "Required parameter"}),
+  }
+
+  async run() {
+    const {flags} = await this.parse(Generated)
+    const params = {}
+    for (const [key, value] of Object.entries(flags)) {
+      if (value !== undefined) params[key] = value
+    }
+
+    Object.assign(params, await promptForMissingParams(REQUIRED_PARAMS, params))
+
+    try {
+      const result = await executeCliCommand("github", "apps", "get-org-installation", params)
+      this.log(JSON.stringify(result, null, 2))
+    } catch (error) {
+      this.error(error.message)
+    }
+  }
+}