@izkac/forgekit 0.3.7 → 0.3.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@izkac/forgekit",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "Forgekit CLIs — forgekit (install), forge (workflow), review (code review)",
   "type": "module",
   "bin": {

package/src/brief-cli.mjs

@@ -3,9 +3,9 @@
  * Operator-brief CLI (core in brief.mjs).
  *
  * Usage:
- *   forge brief stamp [--session <id>] [--no-open]   stamp freshness hash + open in browser
- *   forge brief check [--session <id>]               exit 1 when missing/stale/unstamped
- *   forge brief open  [--session <id>]               open in default browser
+ *   forge brief stamp [--session <id>]   stamp freshness hash (never auto-opens)
+ *   forge brief check [--session <id>]   exit 1 when missing/stale/unstamped
+ *   forge brief open  [--session <id>]   open in default browser (explicit only)
  */
 
 import fs from 'node:fs';
@@ -16,7 +16,7 @@ import { BRIEF_FILE, briefPath, checkBrief, openInBrowser, stampBrief } from './
 const [cmd, ...rest] = process.argv.slice(2);
 if (!cmd || !['stamp', 'check', 'open'].includes(cmd)) {
   process.stderr.write(
-    'Usage: forge brief stamp [--session <id>] [--no-open] | check [--session <id>] | open [--session <id>]\n',
+    'Usage: forge brief stamp [--session <id>] | check [--session <id>] | open [--session <id>]\n',
   );
   process.exit(1);
 }
@@ -45,12 +45,13 @@ if (!changeDir) {
 }
 
 if (cmd === 'stamp') {
+  // Never auto-open: re-stamps happen several times a session and each open
+  // stole the operator's focus. `forge brief open` is the explicit opt-in.
   const hash = stampBrief(changeDir);
   process.stdout.write(`Stamped ${briefPath(changeDir)} (specs hash ${hash})\n`);
-  if (!rest.includes('--no-open')) {
-    openInBrowser(briefPath(changeDir));
-    process.stdout.write('Opened in default browser.\n');
-  }
+  process.stdout.write(
+    `Operator: review the brief at ${briefPath(changeDir)} — open it with \`forge brief open\`.\n`,
+  );
 } else {
   const file = briefPath(changeDir);
   if (!fs.existsSync(file)) {

package/vendor/skills/forge/phases/plan-openspec.md

@@ -37,7 +37,7 @@ Thin wrapper around the project **`openspec-propose`** skill (or `/opsx:propose`
    where helpful), then:
 
    ```bash
-   forge brief stamp    # records specs hash + opens it in the operator's browser
+   forge brief stamp    # records specs hash (does NOT auto-open)
    ```
 
    `forge phase implement` hard-refuses while the brief is missing or stale
@@ -51,7 +51,8 @@ Thin wrapper around the project **`openspec-propose`** skill (or `/opsx:propose`
    Count tasks from `tasks.md` checkboxes.
 
 7. Get user approval to proceed to implement (unless they already said "go").
-   The brief (opened by `forge brief stamp`) is what the operator reviews.
+   The brief is what the operator reviews — tell them its path and that
+   `forge brief open` launches it; never open it for them.
 
 ## Session tracking
 

package/vendor/skills/forge/phases/plan-specs.md

@@ -85,7 +85,7 @@ OpenSpec propose flow without the vendor CLI. Change lives under
    where helpful), then:
 
    ```bash
-   forge brief stamp    # records specs hash + opens it in the operator's browser
+   forge brief stamp    # records specs hash (does NOT auto-open)
    ```
 
    `forge phase implement` hard-refuses while the brief is missing or stale
@@ -102,7 +102,8 @@ OpenSpec propose flow without the vendor CLI. Change lives under
    name for both engines.)
 
 7. Get user approval on the artefacts before implementing (unless they already said "go").
-   The brief (opened by `forge brief stamp`) is what the operator reviews.
+   The brief is what the operator reviews — tell them its path and that
+   `forge brief open` launches it; never open it for them.
 
 ## Compatibility
 

package/vendor/skills/forge/references/operator-brief.md

@@ -21,7 +21,8 @@ freshness and opens the file.
 ```bash
 # 1. specs are final (proposal.md / design.md / tasks.md)
 # 2. write <changeDir>/brief.html   (structure below)
-forge brief stamp        # records specs hash + opens it in the operator's browser
+forge brief stamp        # records specs hash — tell the operator where the brief is
+                         # (it is NOT auto-opened; they can run `forge brief open`)
 forge phase implement --tasks-total <N>   # hard-gated on a fresh stamped brief
 ```