@bulkgrid/cli 0.2.0 → 0.4.0

package/dist/cli.js

@@ -24,26 +24,44 @@ function registerSourceCommands(program, clientFactory = createSourceClient) {
 	const sources = program.command("sources").description("Inspect and manage sources with a scoped API key; outputs JSON");
 	const command = (name, description) => sources.command(name).description(description).option("--url <url>", "Bulkgrid origin; defaults to BULKGRID_URL or https://bulkgrid.com");
 	const print = (result) => console.log(JSON.stringify(result, null, 2));
-	command("find <query>", "Find existing sources before adding one").action(async (query, options) => print(await clientFactory(options).sources.search(query)));
-	command("analyze <sourceUrl>", "Start deeper analysis; may create a crawl run and consume resources").action(async (url, options) => print(await clientFactory(options).sources.analyze({ url })));
-	command("analysis-status <analysisId>", "Read analysis progress and warnings").action(async (analysisId, options) => print(await clientFactory(options).sources.getAnalysis(uuid.parse(analysisId))));
+	command("find <query>", "Find existing sources before adding one").action(async (query, options) => print(await clientFactory(options).index.sources.search(query)));
+	command("analyze <sourceUrl>", "Start deeper analysis; may create a crawl run and consume resources").action(async (url, options) => print(await clientFactory(options).index.sources.analyze({ url })));
+	command("analysis-status <analysisId>", "Read analysis progress and warnings").action(async (analysisId, options) => print(await clientFactory(options).index.sources.getAnalysis(uuid.parse(analysisId))));
 	command("add", "Create or subscribe to a source; may initiate ongoing ingestion").requiredOption("--input <json>", "Source configuration JSON including explicit visibility, boundaries and refresh interval").action(async (options) => {
 		const input = sourceInputSchemas.create.safeExtend({ visibility: z.enum(["public", "private"]) }).parse(JSON.parse(options.input ?? "{}"));
-		print(await clientFactory(options).sources.create(input));
+		print(await clientFactory(options).index.sources.create(input));
 	});
-	command("status <sourceId>", "Read crawl status, errors, size and indexed item counts").action(async (sourceId, options) => print(await clientFactory(options).sources.status(uuid.parse(sourceId))));
-	command("recrawl <sourceId>", "Start a manual refresh using saved configuration; may consume credits").action(async (sourceId, options) => print(await clientFactory(options).sources.recrawl(uuid.parse(sourceId))));
-	command("collections", "List collections available for source management").action(async (options) => print(await clientFactory(options).collections.list()));
-	command("rules <collectionId>", "Inspect collection rules before changing membership").action(async (collectionId, options) => print(await clientFactory(options).collections.rules(uuid.parse(collectionId))));
-	command("include <sourceId> <collectionId>", "Include the entire source in a collection, broadening its retrieval coverage").action(async (sourceId, collectionId, options) => print(await clientFactory(options).collections.addSource({
+	command("github-connections", "List workspace GitHub connections and permitted repositories").action(async (options) => print(await clientFactory(options).index.sources.githubConnections()));
+	command("subscribe <sourceId>", "Subscribe to an existing public source without starting ingestion").action(async (sourceId, options) => print(await clientFactory(options).index.sources.subscribe(uuid.parse(sourceId))));
+	command("add-github", "Create a GitHub source; private repositories require a workspace connection").requiredOption("--input <json>", "Repository URL, explicit visibility, connection_id for private repositories and indexing settings").action(async (options) => {
+		const input = sourceInputSchemas.createGithub.extend({
+			repositoryUrl: z.url(),
+			visibility: z.enum(["public", "private"])
+		}).parse(JSON.parse(options.input ?? "{}"));
+		sourceInputSchemas.createGithub.parse(input);
+		print(await clientFactory(options).index.sources.createGithub(input));
+	});
+	command("analyze-github", "Analyze documentation paths in a permitted GitHub repository").requiredOption("--input <json>", "Repository URL and optional connection_id and ref").action(async (options) => {
+		const input = sourceInputSchemas.analyzeGithub.extend({ repositoryUrl: z.url() }).parse(JSON.parse(options.input ?? "{}"));
+		sourceInputSchemas.analyzeGithub.parse(input);
+		print(await clientFactory(options).index.sources.analyzeGithub(input));
+	});
+	command("status <sourceId>", "Read crawl status, errors, size and indexed item counts").action(async (sourceId, options) => print(await clientFactory(options).index.sources.status(uuid.parse(sourceId))));
+	command("recrawl <sourceId>", "Start a manual refresh using saved configuration; may consume credits").action(async (sourceId, options) => print(await clientFactory(options).index.sources.recrawl(uuid.parse(sourceId))));
+	command("collections", "List collections available for source management").action(async (options) => print(await clientFactory(options).index.collections.list()));
+	command("rules <collectionId>", "Inspect collection rules before changing membership").action(async (collectionId, options) => print(await clientFactory(options).index.collections.rules(uuid.parse(collectionId))));
+	command("include <sourceId> <collectionId>", "Include the entire source in a collection, broadening its retrieval coverage").action(async (sourceId, collectionId, options) => print(await clientFactory(options).index.collections.addSource({
 		sourceId: uuid.parse(sourceId),
 		collectionId: uuid.parse(collectionId)
 	})));
 }
 //#endregion
+//#region package.json
+var version = "0.4.0";
+//#endregion
 //#region src/cli.ts
 const program = new Command();
-program.name("bulkgrid").description("Bulkgrid developer tooling").version("0.1.0");
+program.name("bulkgrid").description("Bulkgrid developer tooling").version(version);
 const auth = new CliAuth();
 program.command("login").description("Sign in to Bulkgrid in your browser").option("--url <url>", "Bulkgrid base URL; defaults to BULKGRID_URL or https://bulkgrid.com").option("--no-browser", "print the login URL without opening a browser").action(async (options) => {
 	const session = await auth.login(options);

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","names":[],"sources":["../src/sources.ts","../src/cli.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { BulkgridClient, sourceInputSchemas } from '@bulkgrid/sdk';\nimport { z } from 'zod';\n\ninterface SourceCommandOptions {\n  url?: string;\n  input?: string;\n}\ntype ClientFactory = (options: SourceCommandOptions) => BulkgridClient;\nconst uuid = z.uuid();\n\nexport function createSourceClient(options: SourceCommandOptions): BulkgridClient {\n  const apiKey = process.env.BULKGRID_API_KEY;\n  if (!apiKey) {\n    throw new Error(\n      'Source commands require BULKGRID_API_KEY with explicit source/collection scopes. CLI OAuth login remains search-only.',\n    );\n  }\n  const baseUrl = new URL(options.url ?? process.env.BULKGRID_URL ?? 'https://bulkgrid.com');\n  if (baseUrl.username || baseUrl.password || baseUrl.search || baseUrl.hash || baseUrl.pathname !== '/') {\n    throw new Error('Use a Bulkgrid origin URL without credentials, a path, query, or fragment.');\n  }\n  if (\n    baseUrl.protocol !== 'https:' &&\n    !(baseUrl.protocol === 'http:' && ['localhost', '127.0.0.1', '[::1]'].includes(baseUrl.hostname))\n  ) {\n    throw new Error('Remote Bulkgrid deployments require HTTPS.');\n  }\n  return new BulkgridClient({ apiKey, baseUrl: baseUrl.origin });\n}\n\nexport function registerSourceCommands(program: Command, clientFactory: ClientFactory = createSourceClient): void {\n  const sources = program.command('sources').description('Inspect and manage sources with a scoped API key; outputs JSON');\n  const command = (name: string, description: string) =>\n    sources\n      .command(name)\n      .description(description)\n      .option('--url <url>', 'Bulkgrid origin; defaults to BULKGRID_URL or https://bulkgrid.com');\n  const print = (result: unknown) => console.log(JSON.stringify(result, null, 2));\n  command('find <query>', 'Find existing sources before adding one').action(\n    async (query: string, options: SourceCommandOptions) => print(await clientFactory(options).sources.search(query)),\n  );\n  command('analyze <sourceUrl>', 'Start deeper analysis; may create a crawl run and consume resources').action(\n    async (url: string, options: SourceCommandOptions) => print(await clientFactory(options).sources.analyze({ url })),\n  );\n  command('analysis-status <analysisId>', 'Read analysis progress and warnings').action(\n    async (analysisId: string, options: SourceCommandOptions) =>\n      print(await clientFactory(options).sources.getAnalysis(uuid.parse(analysisId))),\n  );\n  command('add', 'Create or subscribe to a source; may initiate ongoing ingestion')\n    .requiredOption('--input <json>', 'Source configuration JSON including explicit visibility, boundaries and refresh interval')\n    .action(async (options: SourceCommandOptions) => {\n      const input = sourceInputSchemas.create\n        .safeExtend({ visibility: z.enum(['public', 'private']) })\n        .parse(JSON.parse(options.input ?? '{}'));\n      print(await clientFactory(options).sources.create(input));\n    });\n  command('status <sourceId>', 'Read crawl status, errors, size and indexed item counts').action(\n    async (sourceId: string, options: SourceCommandOptions) =>\n      print(await clientFactory(options).sources.status(uuid.parse(sourceId))),\n  );\n  command('recrawl <sourceId>', 'Start a manual refresh using saved configuration; may consume credits').action(\n    async (sourceId: string, options: SourceCommandOptions) =>\n      print(await clientFactory(options).sources.recrawl(uuid.parse(sourceId))),\n  );\n  command('collections', 'List collections available for source management').action(async (options: SourceCommandOptions) =>\n    print(await clientFactory(options).collections.list()),\n  );\n  command('rules <collectionId>', 'Inspect collection rules before changing membership').action(\n    async (collectionId: string, options: SourceCommandOptions) =>\n      print(await clientFactory(options).collections.rules(uuid.parse(collectionId))),\n  );\n  command(\n    'include <sourceId> <collectionId>',\n    'Include the entire source in a collection, broadening its retrieval coverage',\n  ).action(async (sourceId: string, collectionId: string, options: SourceCommandOptions) =>\n    print(\n      await clientFactory(options).collections.addSource({\n        sourceId: uuid.parse(sourceId),\n        collectionId: uuid.parse(collectionId),\n      }),\n    ),\n  );\n}\n","#!/usr/bin/env node\nimport { registerSourceCommands } from './sources.js';\nimport { Command } from 'commander';\n\nimport { CliAuth } from './auth.js';\n\nimport { runInitCommand } from './init.js';\n\nconst program = new Command();\n\nprogram.name('bulkgrid').description('Bulkgrid developer tooling').version('0.1.0');\n\nconst auth = new CliAuth();\n\nprogram\n  .command('login')\n  .description('Sign in to Bulkgrid in your browser')\n  .option('--url <url>', 'Bulkgrid base URL; defaults to BULKGRID_URL or https://bulkgrid.com')\n  .option('--no-browser', 'print the login URL without opening a browser')\n  .action(async options => {\n    const session = await auth.login(options);\n    console.log(`Logged in to workspace ${session.workspaceId}. Manage access in Settings → Connected Apps.`);\n  });\n\nprogram\n  .command('status')\n  .description('Verify the saved CLI connection and show its access')\n  .option('--url <url>', 'Bulkgrid base URL; defaults to BULKGRID_URL or https://bulkgrid.com')\n  .action(async options => {\n    const session = await auth.status(options.url);\n    console.log(`Connected as ${session.userId} to workspace ${session.workspaceId}.`);\n    console.log(`Permissions: ${session.scopes.join(', ')}; collections: ${session.collectionScope}.`);\n  });\n\nprogram\n  .command('logout')\n  .description('Revoke this CLI connection and remove its saved tokens')\n  .option('--url <url>', 'Bulkgrid base URL; defaults to BULKGRID_URL or https://bulkgrid.com')\n  .option('--local', 'only remove local tokens; revoke access separately in Connected Apps')\n  .action(async options => {\n    await auth.logout(options);\n    console.log(options.local ? 'Local credentials removed. Server access was not revoked.' : 'Logged out.');\n  });\n\nprogram\n  .command('init')\n  .description('Configure the Bulkgrid MCP server')\n  .option('--all', 'configure all supported agents')\n  .option('--cursor', 'configure Cursor')\n  .option('--vscode', 'configure VS Code')\n  .option('--claude', 'configure Claude Code')\n  .option('--codex', 'configure Codex')\n  .option('--mcp-url <url>', 'Bulkgrid MCP server URL')\n  .option('--api-key <key>', 'Bulkgrid API key; defaults to BULKGRID_API_KEY')\n  .option('--global', 'write global user configuration where supported')\n  .option('--project', 'write project configuration where supported')\n  .option('--yes', 'do not prompt for missing values')\n  .option('--write-api-key', 'write the API key into generated JSON config files')\n  .option('--install-global', 'install @bulkgrid/cli globally before configuring agents')\n  .option('--auth <mode>', 'authentication mode: browser, manual, or skip')\n  .action(async options => {\n    try {\n      const results = await runInitCommand(options);\n      if (results.length === 0) {\n        console.log('No MCP clients configured.');\n        return;\n      }\n      for (const result of results) {\n        const marker = result.status === 'configured' ? 'configured' : 'skipped';\n        console.log(`${result.agent}: ${marker} - ${result.message}`);\n      }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      console.error(`bulkgrid init failed: ${message}`);\n      process.exitCode = 1;\n    }\n  });\n\nregisterSourceCommands(program);\n\nprogram.parseAsync().catch(error => {\n  console.error(`bulkgrid: ${error instanceof Error ? error.message : 'Command failed'}`);\n  process.exitCode = 1;\n});\n"],"mappings":"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"}
+{"version":3,"file":"cli.js","names":["packageMetadata.version"],"sources":["../src/sources.ts","../package.json","../src/cli.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { BulkgridClient, sourceInputSchemas } from '@bulkgrid/sdk';\nimport { z } from 'zod';\n\ninterface SourceCommandOptions {\n  url?: string;\n  input?: string;\n}\ntype ClientFactory = (options: SourceCommandOptions) => BulkgridClient;\nconst uuid = z.uuid();\n\nexport function createSourceClient(options: SourceCommandOptions): BulkgridClient {\n  const apiKey = process.env.BULKGRID_API_KEY;\n  if (!apiKey) {\n    throw new Error(\n      'Source commands require BULKGRID_API_KEY with explicit source/collection scopes. CLI OAuth login remains search-only.',\n    );\n  }\n  const baseUrl = new URL(options.url ?? process.env.BULKGRID_URL ?? 'https://bulkgrid.com');\n  if (baseUrl.username || baseUrl.password || baseUrl.search || baseUrl.hash || baseUrl.pathname !== '/') {\n    throw new Error('Use a Bulkgrid origin URL without credentials, a path, query, or fragment.');\n  }\n  if (\n    baseUrl.protocol !== 'https:' &&\n    !(baseUrl.protocol === 'http:' && ['localhost', '127.0.0.1', '[::1]'].includes(baseUrl.hostname))\n  ) {\n    throw new Error('Remote Bulkgrid deployments require HTTPS.');\n  }\n  return new BulkgridClient({ apiKey, baseUrl: baseUrl.origin });\n}\n\nexport function registerSourceCommands(program: Command, clientFactory: ClientFactory = createSourceClient): void {\n  const sources = program.command('sources').description('Inspect and manage sources with a scoped API key; outputs JSON');\n  const command = (name: string, description: string) =>\n    sources\n      .command(name)\n      .description(description)\n      .option('--url <url>', 'Bulkgrid origin; defaults to BULKGRID_URL or https://bulkgrid.com');\n  const print = (result: unknown) => console.log(JSON.stringify(result, null, 2));\n  command('find <query>', 'Find existing sources before adding one').action(\n    async (query: string, options: SourceCommandOptions) => print(await clientFactory(options).index.sources.search(query)),\n  );\n  command('analyze <sourceUrl>', 'Start deeper analysis; may create a crawl run and consume resources').action(\n    async (url: string, options: SourceCommandOptions) => print(await clientFactory(options).index.sources.analyze({ url })),\n  );\n  command('analysis-status <analysisId>', 'Read analysis progress and warnings').action(\n    async (analysisId: string, options: SourceCommandOptions) =>\n      print(await clientFactory(options).index.sources.getAnalysis(uuid.parse(analysisId))),\n  );\n  command('add', 'Create or subscribe to a source; may initiate ongoing ingestion')\n    .requiredOption('--input <json>', 'Source configuration JSON including explicit visibility, boundaries and refresh interval')\n    .action(async (options: SourceCommandOptions) => {\n      const input = sourceInputSchemas.create\n        .safeExtend({ visibility: z.enum(['public', 'private']) })\n        .parse(JSON.parse(options.input ?? '{}'));\n      print(await clientFactory(options).index.sources.create(input));\n    });\n  command('github-connections', 'List workspace GitHub connections and permitted repositories').action(\n    async (options: SourceCommandOptions) => print(await clientFactory(options).index.sources.githubConnections()),\n  );\n  command('subscribe <sourceId>', 'Subscribe to an existing public source without starting ingestion').action(\n    async (sourceId: string, options: SourceCommandOptions) =>\n      print(await clientFactory(options).index.sources.subscribe(uuid.parse(sourceId))),\n  );\n  command('add-github', 'Create a GitHub source; private repositories require a workspace connection')\n    .requiredOption(\n      '--input <json>',\n      'Repository URL, explicit visibility, connection_id for private repositories and indexing settings',\n    )\n    .action(async (options: SourceCommandOptions) => {\n      const input = sourceInputSchemas.createGithub\n        .extend({ repositoryUrl: z.url(), visibility: z.enum(['public', 'private']) })\n        .parse(JSON.parse(options.input ?? '{}'));\n      sourceInputSchemas.createGithub.parse(input);\n      print(await clientFactory(options).index.sources.createGithub(input));\n    });\n  command('analyze-github', 'Analyze documentation paths in a permitted GitHub repository')\n    .requiredOption('--input <json>', 'Repository URL and optional connection_id and ref')\n    .action(async (options: SourceCommandOptions) => {\n      const input = sourceInputSchemas.analyzeGithub.extend({ repositoryUrl: z.url() }).parse(JSON.parse(options.input ?? '{}'));\n      sourceInputSchemas.analyzeGithub.parse(input);\n      print(await clientFactory(options).index.sources.analyzeGithub(input));\n    });\n  command('status <sourceId>', 'Read crawl status, errors, size and indexed item counts').action(\n    async (sourceId: string, options: SourceCommandOptions) =>\n      print(await clientFactory(options).index.sources.status(uuid.parse(sourceId))),\n  );\n  command('recrawl <sourceId>', 'Start a manual refresh using saved configuration; may consume credits').action(\n    async (sourceId: string, options: SourceCommandOptions) =>\n      print(await clientFactory(options).index.sources.recrawl(uuid.parse(sourceId))),\n  );\n  command('collections', 'List collections available for source management').action(async (options: SourceCommandOptions) =>\n    print(await clientFactory(options).index.collections.list()),\n  );\n  command('rules <collectionId>', 'Inspect collection rules before changing membership').action(\n    async (collectionId: string, options: SourceCommandOptions) =>\n      print(await clientFactory(options).index.collections.rules(uuid.parse(collectionId))),\n  );\n  command(\n    'include <sourceId> <collectionId>',\n    'Include the entire source in a collection, broadening its retrieval coverage',\n  ).action(async (sourceId: string, collectionId: string, options: SourceCommandOptions) =>\n    print(\n      await clientFactory(options).index.collections.addSource({\n        sourceId: uuid.parse(sourceId),\n        collectionId: uuid.parse(collectionId),\n      }),\n    ),\n  );\n}\n","","#!/usr/bin/env node\nimport { registerSourceCommands } from './sources.js';\nimport packageMetadata from '../package.json' with { type: 'json' };\nimport { Command } from 'commander';\n\nimport { CliAuth } from './auth.js';\n\nimport { runInitCommand } from './init.js';\n\nconst program = new Command();\n\nprogram.name('bulkgrid').description('Bulkgrid developer tooling').version(packageMetadata.version);\n\nconst auth = new CliAuth();\n\nprogram\n  .command('login')\n  .description('Sign in to Bulkgrid in your browser')\n  .option('--url <url>', 'Bulkgrid base URL; defaults to BULKGRID_URL or https://bulkgrid.com')\n  .option('--no-browser', 'print the login URL without opening a browser')\n  .action(async options => {\n    const session = await auth.login(options);\n    console.log(`Logged in to workspace ${session.workspaceId}. Manage access in Settings → Connected Apps.`);\n  });\n\nprogram\n  .command('status')\n  .description('Verify the saved CLI connection and show its access')\n  .option('--url <url>', 'Bulkgrid base URL; defaults to BULKGRID_URL or https://bulkgrid.com')\n  .action(async options => {\n    const session = await auth.status(options.url);\n    console.log(`Connected as ${session.userId} to workspace ${session.workspaceId}.`);\n    console.log(`Permissions: ${session.scopes.join(', ')}; collections: ${session.collectionScope}.`);\n  });\n\nprogram\n  .command('logout')\n  .description('Revoke this CLI connection and remove its saved tokens')\n  .option('--url <url>', 'Bulkgrid base URL; defaults to BULKGRID_URL or https://bulkgrid.com')\n  .option('--local', 'only remove local tokens; revoke access separately in Connected Apps')\n  .action(async options => {\n    await auth.logout(options);\n    console.log(options.local ? 'Local credentials removed. Server access was not revoked.' : 'Logged out.');\n  });\n\nprogram\n  .command('init')\n  .description('Configure the Bulkgrid MCP server')\n  .option('--all', 'configure all supported agents')\n  .option('--cursor', 'configure Cursor')\n  .option('--vscode', 'configure VS Code')\n  .option('--claude', 'configure Claude Code')\n  .option('--codex', 'configure Codex')\n  .option('--mcp-url <url>', 'Bulkgrid MCP server URL')\n  .option('--api-key <key>', 'Bulkgrid API key; defaults to BULKGRID_API_KEY')\n  .option('--global', 'write global user configuration where supported')\n  .option('--project', 'write project configuration where supported')\n  .option('--yes', 'do not prompt for missing values')\n  .option('--write-api-key', 'write the API key into generated JSON config files')\n  .option('--install-global', 'install @bulkgrid/cli globally before configuring agents')\n  .option('--auth <mode>', 'authentication mode: browser, manual, or skip')\n  .action(async options => {\n    try {\n      const results = await runInitCommand(options);\n      if (results.length === 0) {\n        console.log('No MCP clients configured.');\n        return;\n      }\n      for (const result of results) {\n        const marker = result.status === 'configured' ? 'configured' : 'skipped';\n        console.log(`${result.agent}: ${marker} - ${result.message}`);\n      }\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      console.error(`bulkgrid init failed: ${message}`);\n      process.exitCode = 1;\n    }\n  });\n\nregisterSourceCommands(program);\n\nprogram.parseAsync().catch(error => {\n  console.error(`bulkgrid: ${error instanceof Error ? error.message : 'Command failed'}`);\n  process.exitCode = 1;\n});\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bulkgrid/cli",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "exports": {
     ".": {
@@ -28,7 +28,7 @@
     "@inquirer/prompts": "7.10.1",
     "commander": "14.0.3",
     "zod": "4.4.3",
-    "@bulkgrid/sdk": "^0.2.0"
+    "@bulkgrid/sdk": "^0.4.0"
   },
   "devDependencies": {
     "@repo/eslint-config": "*",