hngr 0.9.0 → 0.10.0

package/dist/sync-D25awtDG.mjs

@@ -0,0 +1,278 @@
+import { C as HngrError, g as resolveConnection, n as apiGet, r as apiRequest } from "./http-CLG2jrIE.mjs";
+// src/commands/sync.ts
+const TERMINAL = /* @__PURE__ */ new Set([
+	"succeeded",
+	"partial",
+	"failed",
+	"interrupted",
+	"skipped_overlap"
+]);
+const POLL_INTERVAL_MS = 2e3;
+const WAIT_TIMEOUT_MS = 6e5;
+function usage(title, detail) {
+	return new HngrError({
+		type: "usage",
+		title,
+		detail
+	});
+}
+function stringFlag(argv, name) {
+	const value = argv[name];
+	return typeof value === "string" && value !== "" ? value : void 0;
+}
+function boolFlag(argv, name) {
+	return argv[name] === true;
+}
+function numberFlag(argv, name) {
+	const value = argv[name];
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function stringArrayFlag(argv, name) {
+	const value = argv[name];
+	if (value === void 0) return [];
+	return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+function parseInterval(raw) {
+	if (raw === void 0) return void 0;
+	if (/^\d+$/.test(raw)) return Number(raw);
+	const match = /^(\d+)(m|h)$/.exec(raw);
+	if (!match) throw usage("--interval must be minutes or a value such as 5m, 15m, 1h, 6h or 24h");
+	const amount = Number(match[1]);
+	return match[2] === "h" ? amount * 60 : amount;
+}
+function parseVisibility(raw) {
+	if (raw === void 0) return void 0;
+	if (raw !== "public" && raw !== "internal" && raw !== "private") throw usage("--visibility must be public, internal or private");
+	return raw;
+}
+async function connection(ctx) {
+	return resolveConnection(ctx.flags, ctx.env);
+}
+async function requestJSON(conn, method, path, body) {
+	const response = await apiRequest(conn, {
+		method,
+		path,
+		body
+	});
+	if (response.status === 204) return void 0;
+	return await response.json();
+}
+function taskLine(task) {
+	const last = task.last_run ? `${task.last_run.status} ${task.last_run.started_at}` : "-";
+	const next = task.next_run_at ?? "-";
+	return [
+		task.id,
+		`${task.namespace} (${task.namespace_kind})`,
+		`${task.interval_minutes}m`,
+		task.enabled ? "enabled" : "disabled",
+		task.default_visibility,
+		last,
+		next,
+		task.degraded ? "DEGRADED" : "",
+		task.deleted_at ? "deleted" : ""
+	].join("	");
+}
+function printTask(ctx, task) {
+	if (ctx.flags.json) {
+		ctx.writePayload(task);
+		return;
+	}
+	ctx.io.stdout.write(`${taskLine(task)}\n`);
+	ctx.io.stdout.write(`agent: ${task.agent.username}\n`);
+	const counts = Object.entries(task.item_counts).map(([state, count]) => `${state}=${count}`).join(" ");
+	if (counts) ctx.io.stdout.write(`items: ${counts}\n`);
+	if (task.last_run) ctx.io.stdout.write(`last run: ${runSummaryLine(task.last_run)}\n`);
+}
+function runSummaryLine(run) {
+	const counts = run.counts;
+	return [
+		run.id,
+		run.trigger,
+		run.dry_run ? "dry-run" : "apply",
+		run.status,
+		run.started_at,
+		`added=${counts.added} updated=${counts.updated} skipped=${counts.skipped} conflict=${counts.conflict} missing=${counts.missing} failed=${counts.failed} deleted_locally=${counts.deleted_locally}`
+	].join("	");
+}
+async function list(ctx, argv) {
+	const conn = await connection(ctx);
+	const list = await apiGet(conn, "/api/v1/sync-tasks", {
+		include_deleted: boolFlag(argv, "includeDeleted") || boolFlag(argv, "include-deleted") || void 0,
+		limit: numberFlag(argv, "limit")
+	});
+	if (ctx.flags.json) {
+		ctx.writePayload(list);
+		return 0;
+	}
+	if (list.items.length === 0) {
+		ctx.io.stdout.write("no sync tasks\n");
+		return 0;
+	}
+	ctx.io.stdout.write("id	target	interval	enabled	visibility	last run	next run	flags\n");
+	for (const task of list.items) ctx.io.stdout.write(`${taskLine(task)}\n`);
+	return 0;
+}
+async function create(ctx, argv) {
+	const namespace = stringFlag(argv, "namespace");
+	if (namespace === void 0) throw usage("--namespace is required", "Example: hngr sync create --namespace seek");
+	const interval = parseInterval(stringFlag(argv, "interval"));
+	const visibility = parseVisibility(stringFlag(argv, "visibility"));
+	const enable = boolFlag(argv, "enable");
+	const task = await requestJSON(await connection(ctx), "POST", "/api/v1/sync-tasks", {
+		namespace,
+		interval_minutes: interval,
+		default_visibility: visibility,
+		enabled: enable
+	});
+	if (task === void 0) throw new HngrError({
+		type: "api",
+		title: "the server returned no sync task"
+	});
+	if (enable) ctx.summary("task created enabled; run a dry-run first if you have not reviewed the diff");
+	printTask(ctx, task);
+	return 0;
+}
+async function show(ctx, argv) {
+	const id = stringFlag(argv, "taskId") ?? stringFlag(argv, "task-id");
+	if (id === void 0) throw usage("a task id is required");
+	const task = await requestJSON(await connection(ctx), "GET", `/api/v1/sync-tasks/${id}`);
+	if (task === void 0) throw new HngrError({
+		type: "api",
+		title: "the server returned no sync task"
+	});
+	printTask(ctx, task);
+	return 0;
+}
+async function update(ctx, argv) {
+	const id = stringFlag(argv, "taskId") ?? stringFlag(argv, "task-id");
+	if (id === void 0) throw usage("a task id is required");
+	const body = {};
+	if (boolFlag(argv, "enable")) body.enabled = true;
+	if (boolFlag(argv, "disable")) body.enabled = false;
+	const interval = parseInterval(stringFlag(argv, "interval"));
+	if (interval !== void 0) body.interval_minutes = interval;
+	const visibility = parseVisibility(stringFlag(argv, "visibility"));
+	if (visibility !== void 0) body.default_visibility = visibility;
+	if (Object.keys(body).length === 0) throw usage("pass --enable, --disable, --interval or --visibility");
+	const task = await requestJSON(await connection(ctx), "PATCH", `/api/v1/sync-tasks/${id}`, body);
+	if (task === void 0) throw new HngrError({
+		type: "api",
+		title: "the server returned no sync task"
+	});
+	printTask(ctx, task);
+	return 0;
+}
+async function remove(ctx, argv) {
+	const id = stringFlag(argv, "taskId") ?? stringFlag(argv, "task-id");
+	if (id === void 0) throw usage("a task id is required");
+	if (!ctx.flags.force) {
+		const confirm = ctx.io.prompts?.confirm;
+		if (!ctx.io.stdin.isTTY || !confirm) throw usage("refusing to delete without --force in a non-interactive session", "The task is soft-deleted and its Capabilities are kept.");
+		if (!await confirm(`Delete sync task ${id}? Capabilities are not deleted.`, false)) return 0;
+	}
+	await requestJSON(await connection(ctx), "DELETE", `/api/v1/sync-tasks/${id}`);
+	ctx.summary(`deleted sync task ${id}; its Capabilities were kept`);
+	return 0;
+}
+async function run(ctx, argv) {
+	const id = stringFlag(argv, "taskId") ?? stringFlag(argv, "task-id");
+	if (id === void 0) throw usage("a task id is required");
+	const conn = await connection(ctx);
+	const summary = await requestJSON(conn, "POST", `/api/v1/sync-tasks/${id}/runs`, { dry_run: ctx.flags.dryRun });
+	if (summary === void 0) throw new HngrError({
+		type: "api",
+		title: "the server returned no sync run"
+	});
+	if (!boolFlag(argv, "wait")) {
+		if (ctx.flags.json) ctx.writePayload(summary);
+		else ctx.io.stdout.write(`${runSummaryLine(summary)}\n`);
+		return 0;
+	}
+	ctx.progress(`run ${summary.id} started; waiting for completion`);
+	const final = await waitForRun(ctx, conn, id, summary.id);
+	if (ctx.flags.json) ctx.writePayload(final);
+	else {
+		ctx.io.stdout.write(`${runSummaryLine(final)}\n`);
+		for (const item of final.items) ctx.io.stdout.write(`${item.status}\t${item.upstream_name}\t${item.name ?? ""}\t${item.version ?? ""}\t${item.error ?? ""}\n`);
+	}
+	return final.status === "failed" ? 1 : 0;
+}
+async function waitForRun(ctx, conn, taskID, runID) {
+	const sleep = ctx.io.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+	const now = ctx.io.now ?? Date.now;
+	const started = now();
+	for (;;) {
+		const run = await requestJSON(conn, "GET", `/api/v1/sync-tasks/${taskID}/runs/${runID}`);
+		if (run === void 0) throw new HngrError({
+			type: "api",
+			title: "the server returned no sync run"
+		});
+		if (TERMINAL.has(run.status)) return run;
+		if (now() - started > WAIT_TIMEOUT_MS) throw new HngrError({
+			type: "network",
+			title: "timed out waiting for the sync run"
+		});
+		await sleep(POLL_INTERVAL_MS);
+	}
+}
+async function runs(ctx, argv) {
+	const id = stringFlag(argv, "taskId") ?? stringFlag(argv, "task-id");
+	if (id === void 0) throw usage("a task id is required");
+	const payload = await requestJSON(await connection(ctx), "GET", `/api/v1/sync-tasks/${id}/runs?limit=${numberFlag(argv, "limit") ?? 20}`);
+	if (payload === void 0) throw new HngrError({
+		type: "api",
+		title: "the server returned no runs"
+	});
+	if (ctx.flags.json) {
+		ctx.writePayload(payload);
+		return 0;
+	}
+	if (payload.items.length === 0) {
+		ctx.io.stdout.write("no runs\n");
+		return 0;
+	}
+	for (const summary of payload.items) ctx.io.stdout.write(`${runSummaryLine(summary)}\n`);
+	return 0;
+}
+async function runShow(ctx, argv) {
+	const id = stringFlag(argv, "taskId") ?? stringFlag(argv, "task-id");
+	const runID = stringFlag(argv, "runId") ?? stringFlag(argv, "run-id");
+	if (id === void 0 || runID === void 0) throw usage("a task id and a run id are required");
+	const run = await requestJSON(await connection(ctx), "GET", `/api/v1/sync-tasks/${id}/runs/${runID}`);
+	if (run === void 0) throw new HngrError({
+		type: "api",
+		title: "the server returned no sync run"
+	});
+	if (ctx.flags.json) {
+		ctx.writePayload(run);
+		return 0;
+	}
+	ctx.io.stdout.write(`${runSummaryLine(run)}\n`);
+	if (run.error_summary) ctx.io.stdout.write(`error: ${run.error_summary}\n`);
+	for (const item of run.items) ctx.io.stdout.write(`${item.status}\t${item.upstream_name}\t${item.name ?? ""}\t${item.version ?? ""}\t${item.error ?? ""}\n`);
+	return 0;
+}
+async function items(ctx, argv) {
+	const id = stringFlag(argv, "taskId") ?? stringFlag(argv, "task-id");
+	if (id === void 0) throw usage("a task id is required");
+	const states = stringArrayFlag(argv, "state");
+	const limit = numberFlag(argv, "limit") ?? 50;
+	const query = states.map((state) => `state=${encodeURIComponent(state)}`).join("&");
+	const path = `/api/v1/sync-tasks/${id}/items?limit=${limit}${query ? `&${query}` : ""}`;
+	const payload = await requestJSON(await connection(ctx), "GET", path);
+	if (payload === void 0) throw new HngrError({
+		type: "api",
+		title: "the server returned no items"
+	});
+	if (ctx.flags.json) {
+		ctx.writePayload(payload);
+		return 0;
+	}
+	if (payload.items.length === 0) {
+		ctx.io.stdout.write("no items\n");
+		return 0;
+	}
+	for (const item of payload.items) ctx.io.stdout.write(`${item.state}\t${item.upstream_name}\t${item.name ?? ""}\t${item.path ?? ""}\t${item.last_synced_at ?? "-"}\t${item.error ?? ""}\n`);
+	return 0;
+}
+export { create, items, list, remove, run, runShow, runs, show, update };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hngr",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "The Hangar CLI: install skills and MCP servers into coding agents, and drive the Management API.",
   "keywords": [
     "hangar",