@flowmind/cli 0.2.0 → 0.2.2

package/README.md

@@ -13,8 +13,14 @@ flowmind hooks install
 
 `hooks install` copies the Flowmind skill to Codex and Claude Code and adds session hooks to
 `~/.codex/hooks.json` and `~/.claude/settings.json`. Other hooks in those files stay as they are.
-The hooks run `flowmind agent hook`, which records each agent turn under the CLI config folder.
-In a linked repository, the session-start hook tells the agent which project it works on.
+The hooks run `agent hook` through the absolute paths of the installing Node binary and CLI file,
+because hooks start without your shell profile and a version manager may not put `node` on PATH.
+Codex on Windows gets a PowerShell command (`& '<node>' '<cli>' agent hook --agent codex`).
+After you upgrade Node or move the CLI, `hooks status` shows `outdated`; run `hooks install` again
+and trust the changed hooks. The hook records each agent turn under the CLI config folder.
+In a linked repository, the session-start hook tells the agent which project it works on. Once 20 or more minutes of
+finished agent turns are unstaged, each prompt also carries a reminder with the minutes and the
+staging command. A successful `agent stage` resets the count.
 Codex runs new hooks only after you trust them once in `/hooks`. `hooks status` shows both installs,
 and `hooks uninstall` removes only the Flowmind entries.
 

package/dist/flowmind/SKILL.md

@@ -36,6 +36,7 @@ flowmind agent stage --intention "<what you set out to do>" --outcome "<what cha
 ```
 
 - The CLI reads the project from `.flowmind.json` and the time from the session record. A second stage in the same session covers only the time after the first.
+- After 20 minutes of unstaged agent time, each prompt in a linked repository carries a reminder with the unstaged minutes. Stage when the current unit of work is complete; a stage with explicit times also resets the count.
 - Add `--dry-run` to preview the project and minutes without staging.
 - Pass `--project`, `--minutes`, and `--started-at` only when no session record exists. Use observed times only. Never estimate time from tokens or tool calls.
 - Write the intention and the outcome as one short sentence each. Never paste transcripts, terminal output, commit messages, issue titles, emails, or secrets.
@@ -63,6 +64,7 @@ Ask only for missing fields. A natural-language entry (`flowmind log "2h on the
 
 - `flowmind auth status` shows the API URL. A normal install uses `https://api.flowmind.pro`.
 - `flowmind hooks status` shows whether the skill and hooks are installed for Codex and Claude Code.
+- `outdated` hooks: run `flowmind hooks install` again (for example after a Node upgrade) and trust the changed hooks.
 - "No recorded agent time": the hooks are missing or not trusted, or the session started before installation. Stage with observed `--minutes` and `--started-at`, or stage in the next session.
 - "Several agent sessions have a turn in progress": pass `--session-id`.
 - "No project given": run `flowmind link <project>` in the repository, or pass `--project`.

package/dist/index.js

@@ -2609,6 +2609,7 @@ ${list}` : " No active projects exist.")
 // src/agent-session.ts
 var RETENTION_MS = 30 * 24 * 60 * 60 * 1e3;
 var ACTIVE_WINDOW_MS = 2 * 24 * 60 * 60 * 1e3;
+var REMINDER_MINUTES = 20;
 var OPEN_TURN_LIMIT_MS = 12 * 60 * 60 * 1e3;
 var EVENTS = /* @__PURE__ */ new Set(["session", "start", "stop", "staged"]);
 var sessionsDir = () => join2(dirname2(config.path), "agent-sessions");
@@ -2665,6 +2666,14 @@ function sessionContext(projectName) {
     "Do not use `flowmind log` for agent work."
   ].join(" ");
 }
+function unstagedReminder(projectName, minutes) {
+  return [
+    `Flowmind: ${minutes} minutes of agent work in this session are not staged yet for "${plainText(projectName)}".`,
+    "When the current unit of work is complete, stage it with",
+    '`flowmind agent stage --intention "<goal>" --outcome "<what changed>" --json`',
+    "and share the review URL."
+  ].join(" ");
+}
 async function pruneOldSessions(now) {
   let names;
   try {
@@ -2697,7 +2706,7 @@ async function handleHook(agent, raw, now = /* @__PURE__ */ new Date()) {
         cwd: input2.cwd,
         turnId: input2.turnId
       });
-      return "";
+      return promptReminder(input2.sessionId, input2.cwd, now);
     case "Stop":
     case "Interrupt":
       await append(input2.sessionId, { event: "stop", at, turnId: input2.turnId });
@@ -2736,6 +2745,12 @@ async function recordedTime(sessionId, now = /* @__PURE__ */ new Date()) {
   const events = await readEventsAt(sessionFile(sessionId));
   return events ? measureRecordedTime(events, now) : null;
 }
+async function promptReminder(sessionId, cwd, now) {
+  const link = await readLink(cwd);
+  if (!link) return "";
+  const recorded = await recordedTime(sessionId, now);
+  return recorded && recorded.minutes >= REMINDER_MINUTES ? unstagedReminder(link.name, recorded.minutes) : "";
+}
 async function markStaged(sessionId, cutoff, proposalId) {
   await append(sessionId, { event: "staged", at: cutoff, proposalId });
 }
@@ -3069,7 +3084,7 @@ agentCommand.command("stage").description("Stage completed agent work as a proje
     }
     spinner = options.json ? null : ora("Staging agent proof...").start();
     const proposal = await createAgentLogProposal(input2, idempotencyKey);
-    if (recorded && sessionId) await markStaged(sessionId, recorded.cutoff, proposal.id);
+    if (sessionId) await markStaged(sessionId, recorded?.cutoff ?? now.toISOString(), proposal.id);
     spinner?.succeed("Agent proof staged");
     if (options.json) {
       console.log(JSON.stringify({ idempotencyKey, proposal }));
@@ -3440,9 +3455,11 @@ var logCommand = new Command3("log").description("Log time with natural language
 
 // src/commands/hooks.ts
 import { createHash as createHash3 } from "node:crypto";
+import { realpathSync } from "node:fs";
 import { readFile as readFile3, lstat, mkdir as mkdir2, rm as rm2, writeFile as writeFile2 } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname as dirname3, join as join3 } from "node:path";
+import { fileURLToPath } from "node:url";
 import { Command as Command4, InvalidArgumentError as InvalidArgumentError2 } from "commander";
 var agents = ["codex", "claude"];
 var installedHashFile = ".flowmind-installed.sha256";
@@ -3477,31 +3494,39 @@ async function inspect(agent) {
   }
   return { state: savedHash === contentHash ? "installed" : "modified", path, markerPath, contentHash };
 }
-var HOOK_COMMAND = "flowmind agent hook";
-var handler = (agent, timeout, background = false) => ({
+var FLOWMIND_HOOK = /(?:^flowmind|index\.js') agent hook --agent (?:codex|claude)$/;
+var portablePath = (path) => realpathSync(path).replaceAll("\\", "/");
+function hookCommand(agent) {
+  const node = portablePath(process.execPath);
+  const cli = portablePath(fileURLToPath(import.meta.url));
+  const args = `agent hook --agent ${agent}`;
+  if (process.platform === "win32" && agent === "codex") {
+    const quote2 = (value) => `'${value.replaceAll("'", "''")}'`;
+    return `& ${quote2(node)} ${quote2(cli)} ${args}`;
+  }
+  const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+  return `${quote(node)} ${quote(cli)} ${args}`;
+}
+var handler = (agent, timeout) => ({
   type: "command",
-  command: `${HOOK_COMMAND} --agent ${agent}`,
-  timeout,
-  ...background ? { async: true } : {}
+  command: hookCommand(agent),
+  timeout
 });
-var hookEvents = {
-  codex: {
-    SessionStart: { hooks: [handler("codex", 10)] },
-    UserPromptSubmit: { hooks: [handler("codex", 10, true)] },
-    Stop: { hooks: [handler("codex", 10)] },
-    Interrupt: { hooks: [handler("codex", 3)] }
-  },
-  claude: {
-    SessionStart: { hooks: [handler("claude", 10)] },
-    UserPromptSubmit: { hooks: [handler("claude", 10)] },
-    Stop: { hooks: [handler("claude", 10)] }
-  }
+var hookEvents = (agent) => agent === "codex" ? {
+  SessionStart: { hooks: [handler("codex", 10)] },
+  UserPromptSubmit: { hooks: [handler("codex", 10)] },
+  Stop: { hooks: [handler("codex", 10)] },
+  Interrupt: { hooks: [handler("codex", 3)] }
+} : {
+  SessionStart: { hooks: [handler("claude", 10)] },
+  UserPromptSubmit: { hooks: [handler("claude", 10)] },
+  Stop: { hooks: [handler("claude", 10)] }
 };
 function hookConfigPath(agent) {
   return agent === "codex" ? join3(homedir(), ".codex", "hooks.json") : join3(homedir(), ".claude", "settings.json");
 }
 var isObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-var isFlowmindGroup = (group) => isObject(group) && Array.isArray(group.hooks) && group.hooks.length > 0 && group.hooks.every((hook) => isObject(hook) && typeof hook.command === "string" && hook.command.startsWith(HOOK_COMMAND));
+var isFlowmindGroup = (group) => isObject(group) && Array.isArray(group.hooks) && group.hooks.length > 0 && group.hooks.every((hook) => isObject(hook) && typeof hook.command === "string" && FLOWMIND_HOOK.test(hook.command));
 async function readHookConfig(agent) {
   const path = hookConfigPath(agent);
   let text;
@@ -3532,7 +3557,7 @@ function hookState(config2, agent) {
     ([event, groups]) => groups.filter(isFlowmindGroup).map((group) => `${event}:${JSON.stringify(group)}`)
   );
   if (ours.length === 0) return "absent";
-  const expected = Object.entries(hookEvents[agent]).map(([event, group]) => `${event}:${JSON.stringify(group)}`);
+  const expected = Object.entries(hookEvents(agent)).map(([event, group]) => `${event}:${JSON.stringify(group)}`);
   const exact = ours.length === expected.length && expected.every((entry) => ours.includes(entry));
   return exact ? "installed" : "outdated";
 }
@@ -3551,7 +3576,7 @@ function withoutFlowmindHooks(config2) {
 function withFlowmindHooks(config2, agent) {
   const next = withoutFlowmindHooks(config2);
   const hooks = isObject(next.hooks) ? { ...next.hooks } : {};
-  for (const [event, group] of Object.entries(hookEvents[agent])) {
+  for (const [event, group] of Object.entries(hookEvents(agent))) {
     hooks[event] = [...hooks[event] ?? [], group];
   }
   return { ...next, hooks };
@@ -5258,7 +5283,7 @@ var shipLogCommand = new Command10("ship-log").description("Read a project ship
 
 // src/index.ts
 var program = new Command11();
-program.name("flowmind").description("Flowmind CLI (also installed as fm)").version("0.2.0").enablePositionalOptions();
+program.name("flowmind").description("Flowmind CLI (also installed as fm)").version("0.2.2").enablePositionalOptions();
 program.addCommand(agentCommand);
 program.addCommand(authCommand);
 program.addCommand(logCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowmind/cli",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "CLI for Flowmind — proof-of-effort hour ledger",
   "homepage": "https://www.flowmind.pro",
   "repository": {
@@ -14,10 +14,13 @@
   "publishConfig": {
     "access": "public"
   },
-  "files": ["dist/index.js", "dist/flowmind/SKILL.md"],
+  "files": [
+    "dist/index.js",
+    "dist/flowmind/SKILL.md"
+  ],
   "bin": {
-    "fm": "./dist/index.js",
-    "flowmind": "./dist/index.js"
+    "fm": "dist/index.js",
+    "flowmind": "dist/index.js"
   },
   "type": "module",
   "scripts": {