@hardfin/cli 0.1.1-dev.72 → 0.1.1-dev.74

package/README.md

@@ -18,6 +18,23 @@ npm install -g @hardfin/cli
 
 It needs Node 20.12 or later.
 
+### For an agent
+
+After installing, run `hardfin init` in the project the agent works in, then sign in:
+
+```sh
+hardfin init
+hardfin login
+```
+
+`init` writes the `hardfin-cli` skill and a Hardfin section in `AGENTS.md`. Coding agents
+load both on their own. The skill says how to find records, count them, and read errors.
+[Setting up a project for agents](#setting-up-a-project-for-agents) lists every file `init`
+writes.
+
+Outside a project, an agent reads `hardfin agent-guide <command>` before calling that
+command. `hardfin agent-guide` with no command describes every command, in about 3,000 lines.
+
 Previews of unreleased work are published from the `dev` branch.
 
 ```sh
@@ -289,6 +306,7 @@ Each command names its `path`, its `endpoint`, whether it `runs`, and its flags.
 | `negatable`       | Present when a boolean also takes a `--no-` form                            |
 | `element`         | The fields one value carries as `key=value`, for an array of objects        |
 | `elementRequired` | The fields of `element` every value must carry                              |
+| `elementUuids`    | The fields of `element` that take a UUID                                    |
 | `default`         | The value used when the flag is not given                                   |
 
 A part that is absent means no. The description is read from the same declarations the parser
@@ -384,7 +402,6 @@ so a new document cannot leave requests naming the version before it.
 
 ```sh
 hardfin login            # approve this CLI in a browser
-hardfin login --device   # approve on another machine, by typing a code
 hardfin login --read-only  # sign in so that nothing can be changed
 hardfin status           # what the CLI is configured with and signed in as
 hardfin logout           # forget this machine, and ask Hardfin to revoke it
@@ -461,27 +478,13 @@ An agent that runs `hardfin login` reads its stderr, and you only see what the a
 on. So when output is JSON, which it is whenever stdout is not a terminal, the command writes
 one line of JSON on stderr before it starts waiting.
 
-| `event`       | Also carries                                                         | The agent should                                    |
-| ------------- | -------------------------------------------------------------------- | --------------------------------------------------- |
-| `sign_in_url` | `url`, `browserOpened`, `waitSeconds`                                | Show you `url`, saying whether a browser tab opened |
-| `device_code` | `userCode`, `verificationUri`, `url`, `browserOpened`, `waitSeconds` | Show you the code and where to enter it             |
+| `event`       | Also carries                          | The agent should                                    |
+| ------------- | ------------------------------------- | --------------------------------------------------- |
+| `sign_in_url` | `url`, `browserOpened`, `waitSeconds` | Show you `url`, saying whether a browser tab opened |
 
 The command then waits up to `waitSeconds` for you to approve, so the agent has to let it run
-that long. An agent with no way to open your browser, such as one in a cloud sandbox, signs
-in with `--device`.
-
-### Signing in from a machine with no browser
-
-`hardfin login --device` prints a short code and a page to enter it on, and waits. Approve
-on your phone or any other machine, and the terminal finishes on its own.
-
-```
-  Code  WDJB-MJHT
-  At    https://app.hardfin.com/device
-```
-
-The CLI refuses `--device` when the authorization server does not offer that grant, rather
-than waiting for an endpoint that is not there.
+that long. An agent in a sandbox on your own machine signs in this way too. An agent whose
+machine cannot reach your browser, such as one in a cloud sandbox, needs an API key.
 
 ### When a sign in stops working
 

package/dist/{check-CvjTUx-K.js → check-8Ta7vSnU.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4a31fc43-cc3a-59be-a501-eb86f4115b3f")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="69a10817-e39f-57d1-8273-c76a835baa09")}catch(e){}}();
 import { createRequire } from "node:module";
 import { z } from "zod";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
@@ -496,7 +496,7 @@ function writeCache(cache) {
 	} catch {}
 }
 //#endregion
-export { ExpectedFailure as C, TimedOut as E, version$1 as S, LockHeld as T, CONFIG_FILE as _, isShipped as a, API_VERSION as b, toOutdatedTo as c, toJSON as d, toLastFailureCode as f, writeFailure as g, writeData as h, toUpdateCheckRefusal as i, toStateDirectory as l, toText as m, isReminderDue as n, toPackageDirectory as o, toPrintable as p, toCheck as r, noteNotices as s, PACKAGE as t, isJSONOutput as u, ConfigFailure as v, Interrupted as w, toTelemetry as x, toSettings as y };
+export { Interrupted as C, ExpectedFailure as S, TimedOut as T, ConfigFailure as _, isShipped as a, toTelemetry as b, toOutdatedTo as c, toJSON as d, toLastFailureCode as f, CONFIG_FILE as g, writeFailure as h, toUpdateCheckRefusal as i, toStateDirectory as l, writeData as m, isReminderDue as n, toPackageDirectory as o, toText as p, toCheck as r, noteNotices as s, PACKAGE as t, isJSONOutput as u, toSettings as v, LockHeld as w, version$1 as x, API_VERSION as y };
 
-//# sourceMappingURL=check-CvjTUx-K.js.map
-//# debugId=4a31fc43-cc3a-59be-a501-eb86f4115b3f
+//# sourceMappingURL=check-8Ta7vSnU.js.map
+//# debugId=69a10817-e39f-57d1-8273-c76a835baa09

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3bf6cdf0-d851-549b-9a43-bb3c8520e8ff")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="f934d0aa-2ea6-57c6-811a-3942d764792d")}catch(e){}}();
 import module from "node:module";
 //#region src/cli.ts
 module.enableCompileCache?.();
@@ -14,8 +14,8 @@ process.on("unhandledRejection", (error) => void toCrash(error));
 try {
 	const answer = await toQuickAnswer(process.argv.slice(2));
 	if (answer === void 0) {
-		const { toCli, toParseExitCode, wasReportAttempted } = await import("./program-CC8Iqb14.js");
-		const { startUpdateCheck, writeUpdateNotice } = await import("./notice-D6mbHF9O.js");
+		const { toCli, toParseExitCode, wasReportAttempted } = await import("./program-CuFKCoDH.js");
+		const { startUpdateCheck, writeUpdateNotice } = await import("./notice-DWvcEHhw.js");
 		const pending = startUpdateCheck(process.argv.slice(2));
 		try {
 			await toCli().parseAsync(process.argv);
@@ -36,7 +36,7 @@ async function toCrash(error) {
 	isCrashing = true;
 	const isJSON = process.argv.includes("--json") || !process.stdout.isTTY;
 	try {
-		const { toReported, writeCrash } = await import("./program-CC8Iqb14.js");
+		const { toReported, writeCrash } = await import("./program-CuFKCoDH.js");
 		writeCrash(error, isJSON);
 		await toReported(error, isJSON, void 0, "fatal");
 	} catch {
@@ -57,4 +57,4 @@ async function toQuickAnswer(args) {
 export {};
 
 //# sourceMappingURL=cli.js.map
-//# debugId=3bf6cdf0-d851-549b-9a43-bb3c8520e8ff
+//# debugId=f934d0aa-2ea6-57c6-811a-3942d764792d