@levr-one/cli 0.12.4 → 0.12.6

package/dist/{addHandler-LO6SChns.js → addHandler-ybX54_3f.js}

@@ -1,10 +1,10 @@
-import { configureClient } from "./sdk-client-B4FMd_Fa.js";
-import { getApiUrl } from "./env-CvjMSRd7.js";
-import "./token-refresh-CJB7Qlxy.js";
-import { resolveToken } from "./resolve-token-ByZq05Us.js";
+import { configureClient } from "./sdk-client-BgzKzVIR.js";
+import "./token-refresh-BpFuU4Ij.js";
+import { getApiUrl } from "./env-DjeRwmZ7.js";
+import { resolveToken } from "./resolve-token-DKEXT7SA.js";
 import "./workspace-store-Bmw104Qa.js";
-import { fetchSites } from "./resolve-workspace-BbK3uYQc.js";
-import { describeWorkspaces, findWorkspaceByKeyOrName, isScopedMcpUrl, resolveMcpUrl, scopedMcpUrl, servedBySessionApi } from "./find-workspace-Bl4rfr73.js";
+import { fetchSites } from "./resolve-workspace-D8y7twod.js";
+import { describeWorkspaces, findWorkspaceByKeyOrName, isScopedMcpUrl, resolveMcpUrl, scopedMcpUrl, servedBySessionApi } from "./find-workspace-4Us2vEb7.js";
 import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { basename, delimiter, dirname, join, resolve } from "node:path";
 import { homedir } from "node:os";

package/dist/{appendHandler-DtxLpPu6.js → appendHandler-CKkl9ymw.js}

@@ -1,12 +1,12 @@
-import { appendActualResult } from "./sdk-client-B4FMd_Fa.js";
-import "./env-CvjMSRd7.js";
-import "./token-refresh-CJB7Qlxy.js";
-import "./resolve-token-ByZq05Us.js";
+import { appendActualResult } from "./sdk-client-BgzKzVIR.js";
+import "./token-refresh-BpFuU4Ij.js";
+import "./env-DjeRwmZ7.js";
+import "./resolve-token-DKEXT7SA.js";
 import "./workspace-store-Bmw104Qa.js";
-import "./resolve-workspace-BbK3uYQc.js";
-import { connect } from "./connect-DVjgyfls.js";
+import "./resolve-workspace-D8y7twod.js";
+import { connect } from "./connect-yq3fGXkW.js";
 import "./sleep-CGBHjsj5.js";
-import { embedMarkdown, parseTarget, uploadArtifactFile } from "./artifact-upload-BvBSevIx.js";
+import { embedMarkdown, parseTarget, uploadArtifactFile } from "./artifact-upload-Ba801tb6.js";
 import { readFileSync } from "node:fs";
 import { basename } from "node:path";
 

package/dist/{artifact-upload-BvBSevIx.js → artifact-upload-Ba801tb6.js}

@@ -1,4 +1,4 @@
-import { uploadAttachment } from "./sdk-client-B4FMd_Fa.js";
+import { uploadAttachment } from "./sdk-client-BgzKzVIR.js";
 import { sleep } from "./sleep-CGBHjsj5.js";
 import { constants, promises, readlinkSync, realpathSync, statSync } from "node:fs";
 import path from "node:path";

package/dist/{attachHandler-DXZi2ILT.js → attachHandler-CfNvVAV2.js}

@@ -1,12 +1,12 @@
-import { appendActualResult, createComment } from "./sdk-client-B4FMd_Fa.js";
-import "./env-CvjMSRd7.js";
-import "./token-refresh-CJB7Qlxy.js";
-import "./resolve-token-ByZq05Us.js";
+import { appendActualResult, createComment } from "./sdk-client-BgzKzVIR.js";
+import "./token-refresh-BpFuU4Ij.js";
+import "./env-DjeRwmZ7.js";
+import "./resolve-token-DKEXT7SA.js";
 import "./workspace-store-Bmw104Qa.js";
-import "./resolve-workspace-BbK3uYQc.js";
-import { connect } from "./connect-DVjgyfls.js";
+import "./resolve-workspace-D8y7twod.js";
+import { connect } from "./connect-yq3fGXkW.js";
 import "./sleep-CGBHjsj5.js";
-import { TargetParseError, embedMarkdown, parseTarget, uploadArtifactFile } from "./artifact-upload-BvBSevIx.js";
+import { TargetParseError, embedMarkdown, parseTarget, uploadArtifactFile } from "./artifact-upload-Ba801tb6.js";
 import { readFileSync } from "node:fs";
 import { basename } from "node:path";
 

package/dist/cli.js

@@ -224,7 +224,7 @@ Examples:
 		aliases: { y: "yes" }
 	},
 	loader: async () => {
-		const { mcpAddHandler } = await import("./addHandler-LO6SChns.js");
+		const { mcpAddHandler } = await import("./addHandler-ybX54_3f.js");
 		return mcpAddHandler;
 	}
 });
@@ -273,7 +273,7 @@ Examples:
 		aliases: { d: "device-code" }
 	},
 	loader: async () => {
-		const { loginHandler } = await import("./loginHandler-C9Oi92IY.js");
+		const { loginHandler } = await import("./loginHandler-PbKmDAGo.js");
 		return loginHandler;
 	}
 });
@@ -292,7 +292,7 @@ Examples:
 	},
 	parameters: {},
 	loader: async () => {
-		const { logoutHandler } = await import("./logoutHandler-Cf5aI1wq.js");
+		const { logoutHandler } = await import("./logoutHandler-DxnzGPYx.js");
 		return logoutHandler;
 	}
 });
@@ -312,7 +312,7 @@ Examples:
 	},
 	parameters: {},
 	loader: async () => {
-		const { statusHandler } = await import("./statusHandler-BQXn93-r.js");
+		const { statusHandler } = await import("./statusHandler-Dnnh80ZN.js");
 		return statusHandler;
 	}
 });
@@ -367,7 +367,7 @@ levr attach --manifest or later uploads.`
 			"workspace-id": {
 				kind: "parsed",
 				parse: String,
-				brief: "Workspace ID (required for multi-workspace JWT auth)",
+				brief: "Workspace ID: needed with a login token and several workspaces; a personal access token is bound to its own",
 				placeholder: "uuid",
 				optional: true
 			},
@@ -441,7 +441,7 @@ levr attach --manifest or later uploads.`
 		}
 	},
 	loader: async () => {
-		const { pushHandler } = await import("./pushHandler-CXFZt3SO.js");
+		const { pushHandler } = await import("./pushHandler-BulraEwP.js");
 		return pushHandler;
 	}
 });
@@ -482,7 +482,7 @@ Examples:
 			"workspace-id": {
 				kind: "parsed",
 				parse: String,
-				brief: "Workspace ID (required for multi-workspace JWT auth)",
+				brief: "Workspace ID: needed with a login token and several workspaces; a personal access token is bound to its own",
 				placeholder: "uuid",
 				optional: true
 			},
@@ -561,7 +561,7 @@ Examples:
 		}
 	},
 	loader: async () => {
-		const { importHandler } = await import("./importHandler-uFdalKtw.js");
+		const { importHandler } = await import("./importHandler-bYBWYC_0.js");
 		return importHandler;
 	}
 });
@@ -582,7 +582,7 @@ Examples:
 	},
 	parameters: {},
 	loader: async () => {
-		const { listHandler } = await import("./listHandler-BW92JLCl.js");
+		const { listHandler } = await import("./listHandler-Du_YGzre.js");
 		return listHandler;
 	}
 });
@@ -620,7 +620,7 @@ Examples:
 		flags: {}
 	},
 	loader: async () => {
-		const { selectHandler } = await import("./selectHandler-D6cvq60S.js");
+		const { selectHandler } = await import("./selectHandler-C0gs-Q70.js");
 		return selectHandler;
 	}
 });
@@ -637,11 +637,69 @@ Examples:
 	},
 	parameters: {},
 	loader: async () => {
-		const { currentHandler } = await import("./currentHandler-QhCywr3S.js");
+		const { currentHandler } = await import("./currentHandler-PaLZKLGF.js");
 		return currentHandler;
 	}
 });
 
+//#endregion
+//#region src/commands/gates/refs.ts
+const gatesRefsCommand = buildCommand({
+	docs: {
+		brief: "Check that a symbol is declared in a scope and referenced elsewhere",
+		fullDescription: `Find where a symbol is declared under --scope and count the references to it
+from other modules, through the language's own tooling. This is the command a
+symbol_referenced gate runs.
+
+Exit code 0 when the symbol is declared in the scope and referenced from
+outside its declaring file, 1 when it is not referenced or not found, and 2 for
+a usage, scope or toolchain error.
+
+--scope must be a directory (or file) inside the repository, narrower than the
+repository root. References from test code are not counted unless
+--include-tests is set.
+
+Languages:
+  ts    tsgo --lsp. Needs typescript and @typescript/native-preview installed
+        in the checkout.
+  rust  rust-analyzer. Needs \`rustup component add rust-analyzer\`; waits for
+        indexing to finish (CODE_INTEL_RA_TIMEOUT_MS, default 300000).
+
+Examples:
+  levr gates refs --lang ts --symbol GateDefinitionSeeder --scope packages/db-core/src
+  levr gates refs --lang rust --symbol used_helper --scope crates/core/src`
+	},
+	parameters: { flags: {
+		lang: {
+			kind: "parsed",
+			parse: String,
+			brief: "Language engine: ts or rust",
+			placeholder: "lang"
+		},
+		symbol: {
+			kind: "parsed",
+			parse: String,
+			brief: "Symbol name to resolve",
+			placeholder: "name"
+		},
+		scope: {
+			kind: "parsed",
+			parse: String,
+			brief: "Directory to search for the declaration, inside the repository",
+			placeholder: "dir"
+		},
+		"include-tests": {
+			kind: "boolean",
+			default: false,
+			brief: "Count references from test code"
+		}
+	} },
+	loader: async () => {
+		const { gatesRefsHandler } = await import("./refsHandler-DtcceTRP.js");
+		return gatesRefsHandler;
+	}
+});
+
 //#endregion
 //#region src/commands/gates/run.ts
 const gatesRunCommand = buildCommand({
@@ -687,7 +745,7 @@ Examples:
 			"workspace-id": {
 				kind: "parsed",
 				parse: String,
-				brief: "Workspace ID (required for multi-workspace JWT auth)",
+				brief: "Workspace ID: needed with a login token and several workspaces; a personal access token is bound to its own",
 				placeholder: "uuid",
 				optional: true
 			},
@@ -718,7 +776,7 @@ Examples:
 		}
 	},
 	loader: async () => {
-		const { gatesRunHandler } = await import("./runHandler-IyPhhiGs.js");
+		const { gatesRunHandler } = await import("./runHandler-B-u-0eRk.js");
 		return gatesRunHandler;
 	}
 });
@@ -784,7 +842,7 @@ Examples:
 			"workspace-id": {
 				kind: "parsed",
 				parse: String,
-				brief: "Workspace ID (required for multi-workspace JWT auth)",
+				brief: "Workspace ID: needed with a login token and several workspaces; a personal access token is bound to its own",
 				placeholder: "uuid",
 				optional: true
 			},
@@ -831,7 +889,7 @@ Examples:
 		}
 	},
 	loader: async () => {
-		const { attachHandler } = await import("./attachHandler-DXZi2ILT.js");
+		const { attachHandler } = await import("./attachHandler-CfNvVAV2.js");
 		return attachHandler;
 	}
 });
@@ -866,7 +924,7 @@ Examples:
 			"workspace-id": {
 				kind: "parsed",
 				parse: String,
-				brief: "Workspace ID (required for multi-workspace JWT auth)",
+				brief: "Workspace ID: needed with a login token and several workspaces; a personal access token is bound to its own",
 				placeholder: "uuid",
 				optional: true
 			},
@@ -907,14 +965,14 @@ Examples:
 		}
 	},
 	loader: async () => {
-		const { resultAppendHandler } = await import("./appendHandler-DtxLpPu6.js");
+		const { resultAppendHandler } = await import("./appendHandler-CKkl9ymw.js");
 		return resultAppendHandler;
 	}
 });
 
 //#endregion
 //#region package.json
-var version = "0.12.4";
+var version = "0.12.6";
 
 //#endregion
 //#region src/app.ts
@@ -937,6 +995,7 @@ const workspaceRoutes = buildRouteMap({
 const gatesRoutes = buildRouteMap({
 	routes: {
 		inspect: gatesInspectCommand,
+		refs: gatesRefsCommand,
 		run: gatesRunCommand
 	},
 	docs: { brief: "Run a deliverable's gates and report the raw results" }

package/dist/{connect-DVjgyfls.js → connect-yq3fGXkW.js}

@@ -1,12 +1,13 @@
-import { client, configureClient } from "./sdk-client-B4FMd_Fa.js";
-import { resolveToken } from "./resolve-token-ByZq05Us.js";
-import { resolveWorkspace } from "./resolve-workspace-BbK3uYQc.js";
+import { client, configureClient } from "./sdk-client-BgzKzVIR.js";
+import { resolveToken } from "./resolve-token-DKEXT7SA.js";
+import { resolveWorkspaceFor } from "./resolve-workspace-D8y7twod.js";
 
 //#region src/utils/connect.ts
 /**
 * Authenticate the SDK client for a command (ENG-6164): resolve the token,
-* and for a JWT the workspace. Reports the failure and sets exit code 1;
-* returns false when the command must stop.
+* then the workspace — looked up for a JWT, taken from an explicit flag or
+* `LEVR_WORKSPACE_ID` for a PAT (ENG-6068). Reports the failure and sets exit
+* code 1; returns false when the command must stop.
 */
 async function connect(ctx, workspaceIdFlag) {
 	let auth;
@@ -18,9 +19,9 @@ async function connect(ctx, workspaceIdFlag) {
 		return false;
 	}
 	configureClient(auth);
-	if (auth.type === "jwt") try {
-		const ws = await resolveWorkspace(workspaceIdFlag);
-		client.setConfig({
+	try {
+		const ws = await resolveWorkspaceFor(auth, workspaceIdFlag);
+		if (ws) client.setConfig({
 			...client.getConfig(),
 			workspaceId: ws.workspaceId
 		});

package/dist/{find-workspace-Bl4rfr73.js → find-workspace-4Us2vEb7.js}

@@ -1,4 +1,4 @@
-import { getApiUrl } from "./env-CvjMSRd7.js";
+import { getApiUrl } from "./env-DjeRwmZ7.js";
 
 //#region src/mcp/url.ts
 const KNOWN_MCP_URLS = {

package/dist/{importHandler-uFdalKtw.js → importHandler-bYBWYC_0.js}

@@ -1,9 +1,9 @@
-import { authGetProfileV1, client, configureClient } from "./sdk-client-B4FMd_Fa.js";
-import { getApiUrl, getTeamId } from "./env-CvjMSRd7.js";
-import "./token-refresh-CJB7Qlxy.js";
-import { resolveToken } from "./resolve-token-ByZq05Us.js";
+import { authGetProfileV1, client, configureClient } from "./sdk-client-BgzKzVIR.js";
+import "./token-refresh-BpFuU4Ij.js";
+import { getApiUrl, getTeamId } from "./env-DjeRwmZ7.js";
+import { resolveToken } from "./resolve-token-DKEXT7SA.js";
 import "./workspace-store-Bmw104Qa.js";
-import { resolveWorkspace } from "./resolve-workspace-BbK3uYQc.js";
+import { resolveWorkspaceFor } from "./resolve-workspace-D8y7twod.js";
 import chalk from "chalk";
 import { createReadStream } from "node:fs";
 import { basename } from "node:path";
@@ -373,16 +373,16 @@ async function importHandler(flags, file) {
 		this.logger.debug(`Auth: ${auth.type.toUpperCase()}`);
 		this.logger.debug(`API:  ${getApiUrl()}`);
 	}
-	if (auth.type === "jwt") {
+	{
 		let workspace;
 		try {
-			workspace = await resolveWorkspace.call(this, flags["workspace-id"]);
+			workspace = await resolveWorkspaceFor(auth, flags["workspace-id"]);
 		} catch (err) {
 			this.logger.error(err instanceof Error ? err.message : "Could not resolve the workspace.");
 			this.process.exitCode = 1;
 			return;
 		}
-		configureClient(auth, workspace.workspaceId);
+		if (workspace) configureClient(auth, workspace.workspaceId);
 	}
 	let teamId;
 	try {

package/dist/{listHandler-BW92JLCl.js → listHandler-Du_YGzre.js}

@@ -1,7 +1,7 @@
-import { authGetSitesV1, configureClient } from "./sdk-client-B4FMd_Fa.js";
-import "./env-CvjMSRd7.js";
-import "./token-refresh-CJB7Qlxy.js";
-import { resolveToken } from "./resolve-token-ByZq05Us.js";
+import { authGetSitesV1, configureClient } from "./sdk-client-BgzKzVIR.js";
+import "./token-refresh-BpFuU4Ij.js";
+import "./env-DjeRwmZ7.js";
+import { resolveToken } from "./resolve-token-DKEXT7SA.js";
 import { loadWorkspace } from "./workspace-store-Bmw104Qa.js";
 
 //#region src/commands/workspace/listHandler.ts

package/dist/{loginHandler-C9Oi92IY.js → loginHandler-PbKmDAGo.js}

@@ -1,9 +1,9 @@
-import { configureClient } from "./sdk-client-B4FMd_Fa.js";
-import { CLI_CLIENT_ID, getApiUrl, getAuthUrl, setSessionApiUrl, writeCredentials } from "./env-CvjMSRd7.js";
+import { configureClient } from "./sdk-client-BgzKzVIR.js";
+import { CLI_CLIENT_ID, getApiUrl, getAuthUrl, setSessionApiUrl, writeCredentials } from "./env-DjeRwmZ7.js";
 import { saveWorkspace } from "./workspace-store-Bmw104Qa.js";
-import { autoSelectWorkspace, fetchSites } from "./resolve-workspace-BbK3uYQc.js";
+import { autoSelectWorkspace, fetchSites } from "./resolve-workspace-D8y7twod.js";
 import { sleep } from "./sleep-CGBHjsj5.js";
-import { findWorkspaceByKeyOrName, looksLikeUrlKey, resolveMcpUrl, scopedMcpUrl } from "./find-workspace-Bl4rfr73.js";
+import { findWorkspaceByKeyOrName, looksLikeUrlKey, resolveMcpUrl, scopedMcpUrl } from "./find-workspace-4Us2vEb7.js";
 import chalk from "chalk";
 import { createHash, randomBytes } from "node:crypto";
 import { createServer } from "node:http";

package/dist/{logoutHandler-Cf5aI1wq.js → logoutHandler-DxnzGPYx.js}

@@ -1,4 +1,4 @@
-import { deleteCredentials, getPatToken } from "./env-CvjMSRd7.js";
+import { deleteCredentials, getPatToken } from "./env-DjeRwmZ7.js";
 import { clearWorkspace } from "./workspace-store-Bmw104Qa.js";
 
 //#region src/commands/auth/logoutHandler.ts

package/dist/{pushHandler-CXFZt3SO.js → pushHandler-BulraEwP.js}

@@ -1,11 +1,11 @@
-import { client, configureClient, uploadImport } from "./sdk-client-B4FMd_Fa.js";
-import { getApiUrl, getAutomationSourceIdOverride, getSourceOverride, getTeamId } from "./env-CvjMSRd7.js";
-import "./token-refresh-CJB7Qlxy.js";
-import { resolveToken } from "./resolve-token-ByZq05Us.js";
+import { client, configureClient, uploadImport } from "./sdk-client-BgzKzVIR.js";
+import "./token-refresh-BpFuU4Ij.js";
+import { getApiUrl, getAutomationSourceIdOverride, getSourceOverride, getTeamId } from "./env-DjeRwmZ7.js";
+import { resolveToken } from "./resolve-token-DKEXT7SA.js";
 import "./workspace-store-Bmw104Qa.js";
-import { resolveWorkspace } from "./resolve-workspace-BbK3uYQc.js";
+import { resolveWorkspaceFor } from "./resolve-workspace-D8y7twod.js";
 import "./sleep-CGBHjsj5.js";
-import { resolveArtifactPath, uploadArtifactFile } from "./artifact-upload-BvBSevIx.js";
+import { resolveArtifactPath, uploadArtifactFile } from "./artifact-upload-Ba801tb6.js";
 import { readFileSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, resolve } from "node:path";
 import { execSync } from "node:child_process";
@@ -474,13 +474,15 @@ async function pushHandler(flags, file) {
 		this.logger.debug(`Auth: ${auth.type.toUpperCase()}`);
 		this.logger.debug(`API:  ${getApiUrl()}`);
 	}
-	if (auth.type === "jwt") try {
-		const ws = await resolveWorkspace(flags["workspace-id"]);
-		client.setConfig({
-			...client.getConfig(),
-			workspaceId: ws.workspaceId
-		});
-		if (flags.verbose) this.logger.debug(`Workspace: ${ws.workspaceId} (${ws.source})`);
+	try {
+		const ws = await resolveWorkspaceFor(auth, flags["workspace-id"]);
+		if (ws) {
+			client.setConfig({
+				...client.getConfig(),
+				workspaceId: ws.workspaceId
+			});
+			if (flags.verbose) this.logger.debug(`Workspace: ${ws.workspaceId} (${ws.source})`);
+		} else if (flags.verbose) this.logger.debug("Workspace: the token's own");
 	} catch (err) {
 		this.logger.error(err instanceof Error ? err.message : "Workspace resolution failed.");
 		this.process.exitCode = 1;