@index365/cli 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@index365/cli",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"description": "index365 CLI - run AI-readiness and marketing-signal audits and read findings from your terminal, CI, or agents. Wraps the public /api/v1.",
 	"type": "module",
 	"license": "MIT",

package/src/cli.mjs

@@ -12,7 +12,7 @@ import {
 	writeConfigFile,
 } from "./config.mjs";
 
-export const CLI_VERSION = "0.1.0";
+export const CLI_VERSION = "0.1.2";
 
 const HELP = `index365 - website audits from your terminal, CI, or agents
 
@@ -24,13 +24,15 @@ COMMANDS
   logout             Remove the saved API key
   doctor             Verify auth, scopes, API reachability, contract version
   projects list      List projects in your organization
-  runs start         Start a paid AI-readiness audit (--project <id>, optional --wait)
+  projects create    Create a project (--domain <domain> [--name <name>])
+  projects delete    Delete a project (<projectId> --confirm <domain>)
+  runs start         Start a paid AI-readiness audit (--project <id>, repeatable --page <path>, optional --wait)
   runs get           Show one run (<runId>)
   findings list      List findings for a run (--run <id>)
   findings get       Show one finding (--run <id> <findingId>)
   reports context    Compact agent report context for a run (<runId>)
   reports download   Download the PDF report to .index365/ (<runId> [--output <file>])
-  marketing run      Start a Marketing Signal audit (--project <id>, optional --wait)
+  marketing run      Start a Marketing Signal audit (--project <id>, repeatable --page <path>, optional --wait)
   marketing report   Latest Marketing Signal report for a project (--project <id>)
   marketing findings Marketing findings (--run <id> | --project <id>, optional --stage)
   integrations list  Connected-signal providers + status (--project <id>)
@@ -45,7 +47,7 @@ EXIT CODES
   0 ok · 1 error · 2 usage · 3 auth · 4 not found · 5 quota/conflict/rate
 
 AUTH
-  Keys are created from an active Agency workspace in the dashboard
+  Keys are created from any active paid plan's workspace in the dashboard
   (Org settings -> API keys) and stored at ~/.config/index365/config.json
   (0600). INDEX365_API_KEY overrides the file.
 `;
@@ -185,7 +187,13 @@ async function cmdDoctor(argv, io, env) {
 
 async function cmdProjects(argv, io, env) {
 	const [sub, ...rest] = argv;
-	if (sub !== "list") throw new CliError("Usage: index365 projects list", EXIT.USAGE);
+	if (sub === "list") return cmdProjectsList(rest, io, env);
+	if (sub === "create") return cmdProjectsCreate(rest, io, env);
+	if (sub === "delete") return cmdProjectsDelete(rest, io, env);
+	throw new CliError("Usage: index365 projects <list|create|delete>", EXIT.USAGE);
+}
+
+async function cmdProjectsList(rest, io, env) {
 	const { values } = parse(rest, {
 		limit: { type: "string" },
 		cursor: { type: "string" },
@@ -207,6 +215,77 @@ async function cmdProjects(argv, io, env) {
 	return EXIT.OK;
 }
 
+async function cmdProjectsCreate(rest, io, env) {
+	const { values } = parse(rest, {
+		domain: { type: "string" },
+		name: { type: "string" },
+	});
+	if (!values.domain) {
+		throw new CliError(
+			"Usage: index365 projects create --domain <domain> [--name <name>]",
+			EXIT.USAGE,
+		);
+	}
+	const settings = settingsFor(values, env);
+	const project = await apiRequest(settings, "POST", "/api/v1/projects", {
+		body: { domain: values.domain, name: values.name },
+		fetchImpl: io.fetch,
+	});
+	if (values.json) {
+		printJson(io, project);
+	} else {
+		const suffix = project.idempotent ? " [already existed]" : "";
+		out(
+			io,
+			`${project.projectId}  ${project.domain}  (${project.name}, ${project.status})${suffix}`,
+		);
+	}
+	return EXIT.OK;
+}
+
+async function cmdProjectsDelete(rest, io, env) {
+	const { values, positionals } = parse(rest, { confirm: { type: "string" } });
+	const projectId = positionals[0];
+	if (!projectId) {
+		throw new CliError(
+			"Usage: index365 projects delete <projectId> --confirm <domain>",
+			EXIT.USAGE,
+		);
+	}
+	const settings = settingsFor(values, env);
+	// Read-before-destroy: fetch the project so we confirm the exact domain first.
+	const project = await apiRequest(settings, "GET", `/api/v1/projects/${projectId}`, {
+		fetchImpl: io.fetch,
+	});
+	let confirm = values.confirm;
+	if (!confirm) {
+		if (input.isTTY) {
+			out(
+				io,
+				`About to permanently delete ${project.domain} (${project.projectId}). This cannot be undone.`,
+			);
+			const rl = createInterface({ input, output });
+			try {
+				confirm = (await rl.question(`Type the domain (${project.domain}) to confirm: `)).trim();
+			} finally {
+				rl.close();
+			}
+		} else {
+			throw new CliError(
+				`Refusing to delete ${project.domain} without confirmation. Re-run with --confirm ${project.domain}.`,
+				EXIT.USAGE,
+			);
+		}
+	}
+	const result = await apiRequest(settings, "DELETE", `/api/v1/projects/${projectId}`, {
+		query: { confirm },
+		fetchImpl: io.fetch,
+	});
+	if (values.json) printJson(io, result);
+	else out(io, `Deleted ${project.domain} (${projectId}).`);
+	return EXIT.OK;
+}
+
 const WAIT_POLL_MS = 5_000;
 const WAIT_TIMEOUT_MS = 15 * 60_000;
 const TERMINAL_STATUSES = new Set(["completed", "failed", "failed_auto_credit", "refunded"]);
@@ -216,11 +295,15 @@ async function cmdRuns(argv, io, env) {
 	if (sub === "start") {
 		const { values } = parse(rest, {
 			project: { type: "string" },
+			page: { type: "string", multiple: true },
 			"idempotency-key": { type: "string" },
 			wait: { type: "boolean", default: false },
 		});
 		if (!values.project) {
-			throw new CliError("Usage: index365 runs start --project <projectId> [--wait]", EXIT.USAGE);
+			throw new CliError(
+				"Usage: index365 runs start --project <projectId> [--page <path> ...] [--wait]",
+				EXIT.USAGE,
+			);
 		}
 		return startRunAndMaybeWait(values, io, env, "paid_ai_readiness");
 	}
@@ -347,8 +430,12 @@ async function cmdReports(argv, io, env) {
 /** Shared run-start + optional poll loop (AI-readiness and Marketing Signal). */
 async function startRunAndMaybeWait(values, io, env, scanMode) {
 	const settings = settingsFor(values, env);
+	// `--page` is repeatable (parseArgs multiple:true), so values.page is a
+	// string[] of extra same-origin pages to scan beyond the homepage. Omitted =
+	// homepage only. The engine resolves/validates same-origin + caps the set.
+	const pages = Array.isArray(values.page) ? values.page : [];
 	let run = await apiRequest(settings, "POST", "/api/v1/runs", {
-		body: { projectId: values.project, scanMode },
+		body: { projectId: values.project, scanMode, ...(pages.length ? { pages } : {}) },
 		idempotencyKey: values["idempotency-key"],
 		fetchImpl: io.fetch,
 	});
@@ -382,6 +469,7 @@ async function cmdMarketing(argv, io, env) {
 	if (sub === "run") {
 		const { values } = parse(rest, {
 			project: { type: "string" },
+			page: { type: "string", multiple: true },
 			"idempotency-key": { type: "string" },
 			wait: { type: "boolean", default: false },
 		});

package/src/client.mjs

@@ -50,8 +50,14 @@ export async function apiRequest(settings, method, apiPath, options = {}) {
 
 	const headers = {
 		authorization: `Bearer ${settings.apiKey}`,
-		"user-agent": "index365-cli/0.1.0",
+		"user-agent": "index365-cli/0.1.2",
 	};
+	// Optional source tag so a wrapping skill can attribute its traffic
+	// (e.g. INDEX365_CLIENT=skill/index365-audit-and-fix). The server validates it.
+	const clientTag = process.env.INDEX365_CLIENT;
+	if (typeof clientTag === "string" && clientTag.trim()) {
+		headers["x-index365-client"] = clientTag.trim();
+	}
 	if (body !== undefined) headers["content-type"] = "application/json";
 	if (idempotencyKey) headers["idempotency-key"] = idempotencyKey;