filegrc 0.6.0 → 0.6.1

package/README.md

@@ -60,7 +60,7 @@ npx filegrc migrate --to-model 2 --preview --json
 
 Follow the [model v2 upgrade guide](https://github.com/Alignbase/filegrc/blob/main/docs/upgrading-to-model-v2.md), then run the model v3 and v4 previews in order.
 
-`filegrc serve --help` prints bind, port, environment, and safety options without starting the server. The editable server defaults to `127.0.0.1:8787`; set `FILEGRC_HOST`, `FILEGRC_PORT`, or the matching flags when needed. In trunk mode, browser saves synchronize, commit, and push from the authoritative branch. Use `--allow-non-authoritative-writes` for local development in a task checkout; the override never commits or pushes.
+`filegrc serve --help` prints bind, port, environment, and safety options without starting the server. The editable server prefers `127.0.0.1:8787` and chooses another available port when that port is occupied. Set `FILEGRC_HOST`, `FILEGRC_PORT`, or the matching flags when needed. In trunk mode, browser saves synchronize, commit, and push from the authoritative branch. Use `--allow-non-authoritative-writes` for local development in a task checkout; the override never commits or pushes.
 
 `filegrc setup` provides the headless equivalent of browser onboarding. Run it without arguments for guided terminal setup, or pass all initial service-boundary fields and a management program goal as flags or a JSON payload. Add `--preview` to validate and inspect the planned System and Program writes without saving. Add `--summary --json` for compact agent output. Selecting Type 1 or Type 2 updates the Program goal and selected Systems. Setup does not select Framework records, link Controls, create Evidence Artifacts, or create an Audit record.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "filegrc",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Zero-dependency Git-native GRC engine",
   "license": "MIT",
   "repository": {

package/src/cli.js

@@ -96,6 +96,7 @@ export async function runCli(argv = process.argv.slice(2)) {
     const result = await serveWorkspace(positionals[0] ?? root, {
       host: flags.host ?? process.env.FILEGRC_HOST,
       port: flags.port ?? process.env.FILEGRC_PORT,
+      fallbackToAvailablePort: true,
       allowNonAuthoritativeWrites: flags["allow-non-authoritative-writes"] === true
     });
     const stopped = new Promise((resolvePromise) => {
@@ -107,6 +108,9 @@ export async function runCli(argv = process.argv.slice(2)) {
       process.once("SIGINT", stop);
       process.once("SIGTERM", stop);
     });
+    if (result.usedFallbackPort) {
+      console.log(`Port ${result.requestedPort} is already in use. Using ${result.address.port} instead.`);
+    }
     console.log(`filegrc workspace: ${result.url}`);
     console.log(`Data: ${result.root}/data`);
     printGithubStarMessage();
@@ -1048,7 +1052,8 @@ function printCommandHelp(command) {
 
 Options:
   --host <address>  Bind address. Defaults to FILEGRC_HOST or 127.0.0.1.
-  --port <number>   Port. Defaults to FILEGRC_PORT or 8787. Use 0 for an available port.
+  --port <number>   Preferred port. Defaults to FILEGRC_PORT or 8787. If occupied,
+                    the server uses an available port. Use 0 to choose one directly.
   --root <path>     Workspace path when no positional root is given.
   --allow-non-authoritative-writes
                      Allow local browser writes from a task checkout. This explicit