@kinosec/cli 0.1.2 → 0.1.4

package/README.md

@@ -25,22 +25,22 @@ See [docs/install.md](docs/install.md) for all installation methods.
 
 ```bash
 # Authenticate with a Personal Access Token
-kns auth login
+kinosec auth login
 
 # List your assets
-kns asset list
+kinosec asset list
 
 # Run a quick pentest
-kns scan create --asset <id> --mode quick
+kinosec scan create --asset <id> --mode quick
 
 # Watch progress in real-time
-kns scan watch <scan-id>
+kinosec scan watch <scan-id>
 
 # View findings
-kns finding list --scan <scan-id>
+kinosec finding list --scan <scan-id>
 
 # Export a report
-kns report export --scan <report-id> --format markdown > report.md
+kinosec report export --scan <report-id> --format markdown > report.md
 ```
 
 See [docs/quickstart.md](docs/quickstart.md) for a full walkthrough.
@@ -48,15 +48,15 @@ See [docs/quickstart.md](docs/quickstart.md) for a full walkthrough.
 ## Commands
 
 ```
-kns auth login|status|logout        Manage authentication
-kns config set|get|list             Manage CLI configuration
-kns me                              Show authenticated user info
-
-kns asset list|get|create|delete|verify   Manage assets
-kns scan list|get|create|cancel|watch     Manage security scans
-kns finding list|get|update|retest        Manage findings
-kns report list|get|export                Manage reports
-kns token list|create|revoke              Manage API tokens
+kinosec auth login|status|logout        Manage authentication
+kinosec config set|get|list             Manage CLI configuration
+kinosec me                              Show authenticated user info
+
+kinosec asset list|get|create|delete|verify   Manage assets
+kinosec scan list|get|create|cancel|watch     Manage security scans
+kinosec finding list|get|update|retest        Manage findings
+kinosec report list|get|export                Manage reports
+kinosec token list|create|revoke              Manage API tokens
 ```
 
 Every command supports `--json` for machine-readable output and `--help` for usage details.
@@ -69,24 +69,24 @@ The CLI authenticates via Personal Access Tokens (PATs). Tokens are resolved in
 
 1. `--token` flag
 2. `KINOSEC_TOKEN` environment variable
-3. `~/.config/kinosec/credentials.json` (saved by `kns auth login`)
+3. `~/.config/kinosec/credentials.json` (saved by `kinosec auth login`)
 
 See [docs/authentication.md](docs/authentication.md) for details.
 
 ## Example
 
 ```bash
-$ kns auth login
+$ kinosec auth login
 Paste your API token: ****
 ✓ Authenticated as you@example.com
   Plan: security_pro (pro)
   Org: Acme Inc
 
-$ kns scan list
+$ kinosec scan list
 ID                                   Target         Mode   Status      Created
 bc6b13bc-1234-5678-9abc-def012345678 example.com    quick  Completed   5/1/2026
 
-$ kns finding list --scan bc6b13bc-1234-5678-9abc-def012345678
+$ kinosec finding list --scan bc6b13bc-1234-5678-9abc-def012345678
 ID                                   Name              Severity  Status  Phase
 f1a2b3c4-...                         SQL Injection     Critical  open    active_scan
 ```

package/dist/cli.js

@@ -7781,7 +7781,7 @@ var KinoSecClient = class {
     this.api = distribution_default.create({
       prefixUrl: config.apiUrl,
       headers: {
-        "user-agent": config.userAgent ?? `kns/0.1.0 (${process.platform})`
+        "user-agent": config.userAgent ?? `kinosec/0.1.0 (${process.platform})`
       },
       hooks: {
         beforeRequest: [
@@ -8102,12 +8102,12 @@ var DEFAULT_API_URL = "https://api.kinosec.ai/v1";
 function resolveToken(options) {
   const token = options.token ?? process.env.KINOSEC_TOKEN ?? readCredentials()?.token;
   if (!token) {
-    console.error('Not authenticated. Run "kns auth login" or set KINOSEC_TOKEN.');
+    console.error('Not authenticated. Run "kinosec auth login" or set KINOSEC_TOKEN.');
     process.exit(77);
   }
   if (options.token) {
     console.error(
-      "Warning: passing a token via --token exposes it in shell history. Prefer: kns auth login (interactive), KINOSEC_TOKEN env var, or stdin pipe."
+      "Warning: passing a token via --token exposes it in shell history. Prefer: kinosec auth login (interactive), KINOSEC_TOKEN env var, or stdin pipe."
     );
   }
   const apiUrl = options.apiUrl ?? process.env.KINOSEC_API_URL ?? getConfigValue("api_url") ?? DEFAULT_API_URL;
@@ -8132,14 +8132,14 @@ function registerAuthCommand(program3) {
   const auth = program3.command("auth").description("Manage authentication");
   auth.command("login").description("Authenticate with a KinoSec API token").addHelpText("after", `
 Examples:
-  $ kns auth login                    # interactive prompt
-  $ kns auth login --token kns_live_pat_...
-  $ echo $TOKEN | kns auth login      # pipe from stdin`).action(async () => {
+  $ kinosec auth login                    # interactive prompt
+  $ kinosec auth login --token kns_live_pat_...
+  $ echo $TOKEN | kinosec auth login      # pipe from stdin`).action(async () => {
     try {
       let token = program3.opts().token;
       if (token) {
         console.error(
-          "Warning: passing a token via --token exposes it in shell history. Prefer: kns auth login (interactive), KINOSEC_TOKEN env var, or stdin pipe."
+          "Warning: passing a token via --token exposes it in shell history. Prefer: kinosec auth login (interactive), KINOSEC_TOKEN env var, or stdin pipe."
         );
       }
       if (!token) {
@@ -8178,11 +8178,11 @@ Examples:
   });
   auth.command("status").description("Show current authentication status").addHelpText("after", `
 Examples:
-  $ kns auth status`).action(async () => {
+  $ kinosec auth status`).action(async () => {
     try {
       const creds = readCredentials();
       if (!creds) {
-        console.error('Not authenticated. Run "kns auth login" or set KINOSEC_TOKEN.');
+        console.error('Not authenticated. Run "kinosec auth login" or set KINOSEC_TOKEN.');
         process.exit(77);
       }
       const apiUrl = program3.opts().apiUrl ?? getConfigValue("api_url") ?? DEFAULT_API_URL;
@@ -8211,7 +8211,7 @@ Examples:
   });
   auth.command("logout").description("Remove stored credentials").addHelpText("after", `
 Examples:
-  $ kns auth logout`).action(() => {
+  $ kinosec auth logout`).action(() => {
     deleteCredentials();
     printSuccess("Logged out. Credentials removed.");
   });
@@ -8223,8 +8223,8 @@ function registerConfigCommand(program3) {
   const config = program3.command("config").description("Manage CLI configuration");
   config.command("set").description("Set a config value").argument("<key>", `Config key (${VALID_KEYS.join(", ")})`).argument("<value>", "Config value").addHelpText("after", `
 Examples:
-  $ kns config set api_url https://custom.api.url/v1
-  $ kns config set output json`).action((key, value) => {
+  $ kinosec config set api_url https://custom.api.url/v1
+  $ kinosec config set output json`).action((key, value) => {
     if (!VALID_KEYS.includes(key)) {
       console.error(`Invalid config key "${key}". Valid keys: ${VALID_KEYS.join(", ")}`);
       process.exit(2);
@@ -8234,7 +8234,7 @@ Examples:
   });
   config.command("get").description("Get a config value").argument("<key>", "Config key").addHelpText("after", `
 Examples:
-  $ kns config get api_url`).action((key) => {
+  $ kinosec config get api_url`).action((key) => {
     const value = getConfigValue(key);
     if (value === void 0) {
       console.error(`Config key "${key}" is not set.`);
@@ -8244,7 +8244,7 @@ Examples:
   });
   config.command("list").description("List all config values").addHelpText("after", `
 Examples:
-  $ kns config list`).action(() => {
+  $ kinosec config list`).action(() => {
     const cfg = readConfig();
     const opts = program3.opts();
     if (opts.json || opts.output === "json") {
@@ -8265,8 +8265,8 @@ Examples:
 function registerMeCommand(program3) {
   program3.command("me").description("Show authenticated user info").addHelpText("after", `
 Examples:
-  $ kns me
-  $ kns me --json`).action(async () => {
+  $ kinosec me
+  $ kinosec me --json`).action(async () => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -9718,8 +9718,8 @@ function registerScanCommand(program3) {
   const scan = program3.command("scan").description("Manage security scans");
   scan.command("list").description("List scans").option("--limit <n>", "Max results per page", "20").option("--cursor <cursor>", "Pagination cursor").addHelpText("after", `
 Examples:
-  $ kns scan list
-  $ kns scan list --limit 5 --json`).action(async (options) => {
+  $ kinosec scan list
+  $ kinosec scan list --limit 5 --json`).action(async (options) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -9756,8 +9756,8 @@ More results available. Use --cursor ${result.next_cursor}`));
   });
   scan.command("get").description("Get scan details").argument("<id>", "Scan profile ID").addHelpText("after", `
 Examples:
-  $ kns scan get abc123
-  $ kns scan get abc123 --json`).action(async (id) => {
+  $ kinosec scan get abc123
+  $ kinosec scan get abc123 --json`).action(async (id) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -9786,8 +9786,8 @@ Examples:
   });
   scan.command("create").description("Start a new scan").option("--asset <id>", "Asset ID to scan").option("--profile <id>", "Scan profile ID (alternative to --asset)").option("--mode <mode>", "Scan mode: quick or full", "quick").addHelpText("after", `
 Examples:
-  $ kns scan create --asset abc123 --mode quick
-  $ kns scan create --profile def456`).action(async (options) => {
+  $ kinosec scan create --asset abc123 --mode quick
+  $ kinosec scan create --profile def456`).action(async (options) => {
     if (!options.asset && !options.profile) {
       console.error("Provide --asset <id> or --profile <id>.");
       process.exit(2);
@@ -9797,7 +9797,7 @@ Examples:
     if (!uuidRe.test(idValue)) {
       console.error(`Invalid ID format: "${idValue}"`);
       console.error("IDs are UUIDs (e.g. 550e8400-e29b-41d4-a716-446655440000).");
-      console.error("Run kns asset list to find your asset ID.");
+      console.error("Run kinosec asset list to find your asset ID.");
       process.exit(2);
     }
     try {
@@ -9815,14 +9815,14 @@ Examples:
       console.log(`  Mode: ${result.scan_mode}`);
       console.log(`  Status: ${result.scan_status}`);
       console.log(`
-Watch progress: kns scan watch ${result.scan_profile_id}`);
+Watch progress: kinosec scan watch ${result.scan_profile_id}`);
     } catch (error) {
       handleError(error);
     }
   });
   scan.command("cancel").description("Cancel a running scan").argument("<id>", "Scan profile ID").addHelpText("after", `
 Examples:
-  $ kns scan cancel abc123`).action(async (id) => {
+  $ kinosec scan cancel abc123`).action(async (id) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -9839,9 +9839,9 @@ Examples:
   });
   scan.command("watch").description("Watch scan progress in real-time").argument("<id>", "Scan profile ID").option("--timeout <seconds>", "Max time to watch", "1800").option("--interval <seconds>", "Poll interval", "5").addHelpText("after", `
 Examples:
-  $ kns scan watch abc123
-  $ kns scan watch abc123 --timeout 600
-  $ kns scan watch abc123 --json`).action(async (id, options) => {
+  $ kinosec scan watch abc123
+  $ kinosec scan watch abc123 --timeout 600
+  $ kinosec scan watch abc123 --json`).action(async (id, options) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -9895,14 +9895,14 @@ Scan failed: ${scanDetail.failure_reason || "unknown reason"}`));
           }
           console.log(import_picocolors3.default.green(`
 Scan completed: ${scanDetail.domain_or_ip}`));
-          console.log(`  View findings: kns finding list --scan ${id}`);
+          console.log(`  View findings: kinosec finding list --scan ${id}`);
           break;
         }
         if (Date.now() - startTime > timeoutMs) {
           cleanup();
           console.error(`
 Timeout: scan still running after ${options.timeout}s.`);
-          console.error(`Check status: kns scan get ${id}`);
+          console.error(`Check status: kinosec scan get ${id}`);
           process.exit(3);
         }
         await new Promise((resolve) => setTimeout(resolve, intervalMs));
@@ -9940,8 +9940,8 @@ function registerAssetCommand(program3) {
   const asset = program3.command("asset").description("Manage assets");
   asset.command("list").description("List assets").option("--limit <n>", "Max results per page", "20").option("--cursor <cursor>", "Pagination cursor").addHelpText("after", `
 Examples:
-  $ kns asset list
-  $ kns asset list --limit 50 --json`).action(async (options) => {
+  $ kinosec asset list
+  $ kinosec asset list --limit 50 --json`).action(async (options) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -9978,8 +9978,8 @@ More results available. Use --cursor ${result.next_cursor}`));
   });
   asset.command("get").description("Get asset details").argument("<id>", "Asset ID").addHelpText("after", `
 Examples:
-  $ kns asset get abc123
-  $ kns asset get abc123 --json`).action(async (id) => {
+  $ kinosec asset get abc123
+  $ kinosec asset get abc123 --json`).action(async (id) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -10007,8 +10007,8 @@ Examples:
   });
   asset.command("create").description("Create a new asset").requiredOption("--type <type>", "Asset type (domain, subdomain, ip)").requiredOption("--value <value>", "Asset value (e.g. example.com)").requiredOption("--verify-method <method>", "Verification method: dns or file").option("--parent <domain>", "Parent domain (for subdomains)").addHelpText("after", `
 Examples:
-  $ kns asset create --type domain --value example.com --verify-method dns
-  $ kns asset create --type subdomain --value api.example.com --verify-method file --parent example.com`).action(async (options) => {
+  $ kinosec asset create --type domain --value example.com --verify-method dns
+  $ kinosec asset create --type subdomain --value api.example.com --verify-method file --parent example.com`).action(async (options) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -10028,15 +10028,15 @@ Examples:
       console.log(`  Type: ${result.asset_type}`);
       console.log(`  Status: ${result.verification_status}`);
       console.log(`
-Verify: kns asset verify ${result.id}`);
+Verify: kinosec asset verify ${result.id}`);
     } catch (error) {
       handleError(error);
     }
   });
   asset.command("delete").description("Delete an asset").argument("<id>", "Asset ID").option("-y, --yes", "Skip confirmation prompt").addHelpText("after", `
 Examples:
-  $ kns asset delete abc123
-  $ kns asset delete abc123 --yes`).action(async (id, options) => {
+  $ kinosec asset delete abc123
+  $ kinosec asset delete abc123 --yes`).action(async (id, options) => {
     try {
       await confirmDestructive(`Delete asset ${id}?`, Boolean(options.yes));
       const opts = program3.opts();
@@ -10054,8 +10054,8 @@ Examples:
   });
   asset.command("verify").description("Trigger asset verification").argument("<id>", "Asset ID").addHelpText("after", `
 Examples:
-  $ kns asset verify abc123
-  $ kns asset verify abc123 --json`).action(async (id) => {
+  $ kinosec asset verify abc123
+  $ kinosec asset verify abc123 --json`).action(async (id) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -10103,8 +10103,8 @@ function registerFindingCommand(program3) {
   const finding = program3.command("finding").description("Manage findings");
   finding.command("list").description("List findings").option("--scan <id>", "Filter by scan profile ID").option("--limit <n>", "Max results per page", "20").option("--cursor <cursor>", "Pagination cursor").addHelpText("after", `
 Examples:
-  $ kns finding list --scan abc123
-  $ kns finding list --limit 50 --json`).action(async (options) => {
+  $ kinosec finding list --scan abc123
+  $ kinosec finding list --limit 50 --json`).action(async (options) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -10142,8 +10142,8 @@ More results available. Use --cursor ${result.next_cursor}`));
   });
   finding.command("get").description("Get finding details").argument("<id>", "Finding ID").addHelpText("after", `
 Examples:
-  $ kns finding get abc123
-  $ kns finding get abc123 --json`).action(async (id) => {
+  $ kinosec finding get abc123
+  $ kinosec finding get abc123 --json`).action(async (id) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -10173,8 +10173,8 @@ Examples:
   });
   finding.command("update").description("Update finding status").argument("<id>", "Finding ID").requiredOption("--status <status>", "New status: open, fixed, false_positive, investigating, wont_fix").addHelpText("after", `
 Examples:
-  $ kns finding update abc123 --status false_positive
-  $ kns finding update abc123 --status fixed`).action(async (id, options) => {
+  $ kinosec finding update abc123 --status false_positive
+  $ kinosec finding update abc123 --status fixed`).action(async (id, options) => {
     if (!VALID_STATUSES.includes(options.status)) {
       console.error(`Invalid status "${options.status}". Valid: ${VALID_STATUSES.join(", ")}`);
       process.exit(2);
@@ -10197,8 +10197,8 @@ Examples:
   });
   finding.command("retest").description("Trigger a retest for a finding").argument("<id>", "Finding ID").addHelpText("after", `
 Examples:
-  $ kns finding retest abc123
-  $ kns finding retest abc123 --json`).action(async (id) => {
+  $ kinosec finding retest abc123
+  $ kinosec finding retest abc123 --json`).action(async (id) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -10266,8 +10266,8 @@ function registerReportCommand(program3) {
   const report = program3.command("report").description("Manage reports");
   report.command("list").description("List reports").option("--limit <n>", "Max results per page", "20").option("--cursor <cursor>", "Pagination cursor").addHelpText("after", `
 Examples:
-  $ kns report list
-  $ kns report list --limit 10 --json`).action(async (options) => {
+  $ kinosec report list
+  $ kinosec report list --limit 10 --json`).action(async (options) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -10306,8 +10306,8 @@ More results available. Use --cursor ${result.next_cursor}`));
   });
   report.command("get").description("Get report details").argument("<id>", "Report ID").addHelpText("after", `
 Examples:
-  $ kns report get abc123
-  $ kns report get abc123 --json`).action(async (id) => {
+  $ kinosec report get abc123
+  $ kinosec report get abc123 --json`).action(async (id) => {
     try {
       const opts = program3.opts();
       const { token, apiUrl } = resolveToken(opts);
@@ -10341,8 +10341,8 @@ Examples:
   });
   report.command("export").description("Export a scan report").requiredOption("--scan <id>", "Scan report ID").option("--format <format>", "Export format: json or markdown", "json").addHelpText("after", `
 Examples:
-  $ kns report export --scan abc123 --format json > report.json
-  $ kns report export --scan abc123 --format markdown > report.md`).action(async (options) => {
+  $ kinosec report export --scan abc123 --format json > report.json
+  $ kinosec report export --scan abc123 --format markdown > report.md`).action(async (options) => {
     const validFormats = ["json", "markdown"];
     if (!validFormats.includes(options.format)) {
       console.error(`Invalid format "${options.format}". Valid: ${validFormats.join(", ")}`);
@@ -10373,8 +10373,8 @@ function registerTokenCommand(program3) {
   const token = program3.command("token").description("Manage API tokens");
   token.command("list").description("List API tokens").option("--limit <n>", "Max results per page", "20").option("--cursor <cursor>", "Pagination cursor").addHelpText("after", `
 Examples:
-  $ kns token list
-  $ kns token list --json`).action(async (options) => {
+  $ kinosec token list
+  $ kinosec token list --json`).action(async (options) => {
     try {
       const opts = program3.opts();
       const { token: authToken, apiUrl } = resolveToken(opts);
@@ -10412,8 +10412,8 @@ More results available. Use --cursor ${result.next_cursor}`));
   });
   token.command("create").description("Create a new API token").requiredOption("--name <name>", "Token name").requiredOption("--scopes <scopes>", "Comma-separated scopes (e.g. assets:read,scans:create)").option("--expires <days>", "Days until expiry", "90").addHelpText("after", `
 Examples:
-  $ kns token create --name "CI" --scopes assets:read,scans:create
-  $ kns token create --name "Full" --scopes assets:read,scans:read --expires 30`).action(async (options) => {
+  $ kinosec token create --name "CI" --scopes assets:read,scans:create
+  $ kinosec token create --name "Full" --scopes assets:read,scans:read --expires 30`).action(async (options) => {
     try {
       const opts = program3.opts();
       const { token: authToken, apiUrl } = resolveToken(opts);
@@ -10442,8 +10442,8 @@ Examples:
   });
   token.command("revoke").description("Revoke an API token").argument("<id>", "Token ID").option("-y, --yes", "Skip confirmation prompt").addHelpText("after", `
 Examples:
-  $ kns token revoke abc123
-  $ kns token revoke abc123 --yes`).action(async (id, options) => {
+  $ kinosec token revoke abc123
+  $ kinosec token revoke abc123 --yes`).action(async (id, options) => {
     try {
       await confirmDestructive(`Revoke token ${id}?`, Boolean(options.yes));
       const opts = program3.opts();
@@ -10464,7 +10464,7 @@ Examples:
 // src/cli.ts
 var VERSION = "0.1.0";
 var program2 = new Command();
-program2.name("kns").description("KinoSec CLI \u2014 run pentests from your terminal").version(VERSION, "-v, --version").option("--token <pat>", "API token (overrides KINOSEC_TOKEN and config)").option("--api-url <url>", "API base URL (overrides config)").option("--output <format>", "Output format: text or json", "text").option("--json", "Shorthand for --output json").option("--no-color", "Disable colors");
+program2.name("kinosec").description("KinoSec CLI \u2014 run pentests from your terminal").version(VERSION, "-v, --version").option("--token <pat>", "API token (overrides KINOSEC_TOKEN and config)").option("--api-url <url>", "API base URL (overrides config)").option("--output <format>", "Output format: text or json", "text").option("--json", "Shorthand for --output json").option("--no-color", "Disable colors");
 registerAuthCommand(program2);
 registerConfigCommand(program2);
 registerMeCommand(program2);