@flowmind/cli 0.2.1 → 0.2.2

package/README.md

@@ -18,7 +18,9 @@ because hooks start without your shell profile and a version manager may not put
 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.
+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.

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 }));
@@ -3492,15 +3507,14 @@ function hookCommand(agent) {
   const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
   return `${quote(node)} ${quote(cli)} ${args}`;
 }
-var handler = (agent, timeout, background = false) => ({
+var handler = (agent, timeout) => ({
   type: "command",
   command: hookCommand(agent),
-  timeout,
-  ...background ? { async: true } : {}
+  timeout
 });
 var hookEvents = (agent) => agent === "codex" ? {
   SessionStart: { hooks: [handler("codex", 10)] },
-  UserPromptSubmit: { hooks: [handler("codex", 10, true)] },
+  UserPromptSubmit: { hooks: [handler("codex", 10)] },
   Stop: { hooks: [handler("codex", 10)] },
   Interrupt: { hooks: [handler("codex", 3)] }
 } : {
@@ -5269,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.1").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.1",
+  "version": "0.2.2",
   "description": "CLI for Flowmind — proof-of-effort hour ledger",
   "homepage": "https://www.flowmind.pro",
   "repository": {