@hardfin/cli 0.1.1-dev.59 → 0.1.1-dev.61

package/README.md

@@ -131,6 +131,10 @@ for.
 A person at a terminal reads one plain line on stderr. Anything else reads JSON, also on
 stderr, so a pipe still carries only the result.
 
+JSON is written on one line when a program reads it, and indented when a terminal shows it.
+The indentation of a page of records is close to half its size, which an agent would
+otherwise have to read. Pipe a result through `jq .` to read it indented.
+
 | Field       | Holds                                                                    |
 | ----------- | ------------------------------------------------------------------------ |
 | `code`      | A fixed name for the failure, such as `not_found` or `missing_flag`      |
@@ -446,6 +450,7 @@ types are stale.
 ```sh
 hardfin init            # the working directory
 hardfin init --dry-run  # what it would write, writing nothing
+hardfin init --local    # set up the server this CLI runs, in place of the hosted one
 ```
 
 `hardfin init` gets a project ready for a coding agent to use Hardfin, the way EmDash's starter
@@ -465,6 +470,11 @@ by default. [Serving an agent](#serving-an-agent) says how it differs from the l
 this CLI runs. Every other server in an MCP config, and everything in `AGENTS.md` outside the
 markers, is left as it was. A config that does not hold JSON is skipped, never overwritten.
 
+`hardfin init --local` writes the local server in its place: the command `hardfin mcp`, which
+each client starts by name. It needs `hardfin` on the `PATH` of whoever opens the project, and
+it writes no address, so it works in a folder set up for a local build. Run `init` again
+without `--local` to go back to the hosted server.
+
 `init` refuses an address that `config.local.json` or `.env` in the folder chose, because the
 address goes into files every agent in the project reads. Pass `--issuer-url` to use it. The
 address must be https, or this machine.
@@ -477,16 +487,16 @@ package, so `init` writes the copy that matches the installed CLI.
 Hardfin has two MCP servers, and an agent needs only one of them. Hardfin hosts one. The
 other is this CLI, run on your machine. Read this section to choose between them.
 
-|                       | The hosted server                                                    | The local server                                       |
-| --------------------- | -------------------------------------------------------------------- | ------------------------------------------------------ |
-| Runs                  | At Hardfin, at `https://api.hardfin.com/mcp`                         | On your machine, started by the agent's client         |
-| Needs installed       | Nothing                                                              | This CLI, and Node 20.12 or later                      |
-| Set up by             | `hardfin init`                                                       | `claude mcp add hardfin -- hardfin mcp`                |
-| Signs in as           | Whoever signs in to Hardfin from the client                          | Whoever ran `hardfin login` here, or `HARDFIN_API_KEY` |
-| Tools                 | `hardfin_read`, `hardfin_create`, `hardfin_update`, `hardfin_delete` | `hardfin_read`, `hardfin_write`, `hardfin_delete`      |
-| A call names          | An operation from the API reference, with its parameters and body    | A command, as the words typed after `hardfin`          |
-| Read-only when        | The sign in was not granted `hardfin:write`                          | The same, or it was started with `--read-only`         |
-| Files on your machine | Out of reach                                                         | Uploaded and downloaded, inside the folder it runs in  |
+|                       | The hosted server                                                    | The local server                                                   |
+| --------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| Runs                  | At Hardfin, at `https://api.hardfin.com/mcp`                         | On your machine, started by the agent's client                     |
+| Needs installed       | Nothing                                                              | This CLI, and Node 20.12 or later                                  |
+| Set up by             | `hardfin init`                                                       | `hardfin init --local`, or `claude mcp add hardfin -- hardfin mcp` |
+| Signs in as           | Whoever signs in to Hardfin from the client                          | Whoever ran `hardfin login` here, or `HARDFIN_API_KEY`             |
+| Tools                 | `hardfin_read`, `hardfin_create`, `hardfin_update`, `hardfin_delete` | `hardfin_read`, `hardfin_write`, `hardfin_delete`                  |
+| A call names          | An operation from the API reference, with its parameters and body    | A command, as the words typed after `hardfin`                      |
+| Read-only when        | The sign in was not granted `hardfin:write`                          | The same, or it was started with `--read-only`                     |
+| Files on your machine | Out of reach                                                         | Uploaded and downloaded, inside the folder it runs in              |
 
 Choose the hosted server unless one of these holds.
 
@@ -548,13 +558,17 @@ connector directory requires.
 A tool call runs the CLI itself, so an agent and a person get identical parsing, output and
 exit codes. Each call has these limits:
 
-| Limit            | Value                                   | Past it                                    |
-| ---------------- | --------------------------------------- | ------------------------------------------ |
-| Time             | 120 seconds                             | The command is stopped, and the call fails |
-| Commands running | 4 at once                               | The next call waits for one to finish      |
-| One argument     | 128 KiB                                 | Refused, pointing at the `input` argument  |
-| Standard input   | The call's `input` argument, or nothing | Always closed, so `--input -` never waits  |
-| One result       | 200,000 characters                      | Cut, with a line saying it is not complete |
+| Limit            | Value                                   | Past it                                                  |
+| ---------------- | --------------------------------------- | -------------------------------------------------------- |
+| Time             | 120 seconds                             | The command is stopped, and the call fails               |
+| Commands running | 4 at once                               | The next call waits for one to finish                    |
+| One argument     | 128 KiB                                 | Refused, pointing at the `input` argument                |
+| Standard input   | The call's `input` argument, or nothing | Always closed, so `--input -` never waits                |
+| One result       | 200,000 characters                      | A list is shortened to the records that fit, and says so |
+
+A list that is too long comes back as valid JSON holding the records that fit, with
+`truncated` saying how many were shown, how many were asked for, and to narrow the list or
+count with `--limit 1`. An asset is about 6 kB, so 30 fit in one result.
 
 A failed call also carries the failure as `structuredContent`, with the same `code`,
 `message`, `errors`, `requestId` and `status` the CLI prints, plus `exitCode`. A file that is

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]="0244e0c8-4f66-5b42-b025-5f487baeab82")}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]="d233e4e5-e149-5533-80be-917bfd948db3")}catch(e){}}();
 import module from "node:module";
 //#region src/cli.ts
 module.enableCompileCache?.();
@@ -14,7 +14,7 @@ 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-DJuADiEQ.js");
+		const { toCli, toParseExitCode, wasReportAttempted } = await import("./program-CkKf46kC.js");
 		try {
 			await toCli().parseAsync(process.argv);
 		} catch (error) {
@@ -33,7 +33,7 @@ async function toCrash(error) {
 	isCrashing = true;
 	const isJSON = process.argv.includes("--json") || !process.stdout.isTTY;
 	try {
-		const { toReported, writeCrash } = await import("./program-DJuADiEQ.js");
+		const { toReported, writeCrash } = await import("./program-CkKf46kC.js");
 		writeCrash(error, isJSON);
 		await toReported(error, isJSON, void 0, "fatal");
 	} catch {
@@ -54,4 +54,4 @@ async function toQuickAnswer(args) {
 export {};
 
 //# sourceMappingURL=cli.js.map
-//# debugId=0244e0c8-4f66-5b42-b025-5f487baeab82
+//# debugId=d233e4e5-e149-5533-80be-917bfd948db3