@flowmind/cli 0.3.0 → 0.3.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abdullah Faruk Gonullu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -13,6 +13,9 @@ 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.
+When the Flowmind Claude Code plugin (`flowmind@flowmind` from `afgonullu/flowmind-skill`) is
+installed and enabled, the plugin provides the skill in Claude Code: `hooks install` writes no
+copy to `~/.claude/skills`, removes an unmodified copy it wrote earlier, and still adds the hooks.
 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`).
@@ -96,9 +99,13 @@ flowmind agent stage --intention "Finish the reader" --outcome "Shipped the read
 ```
 
 The CLI reads the project from `.flowmind.json` and the session from `CODEX_THREAD_ID` or the one
-session with a turn in progress in the repository. The duration is the recorded agent turn time
-since the session's last staged proof; idle time between turns does not count. Fewer than one
-recorded minute is an error. The source kind is `codex` or `claude_code` from the recording host.
+session with a turn in progress in the repository. The duration is the main agent's recorded turn
+time since the session's last staged proof, in whole minutes; the remaining seconds carry over to
+the next proof. Idle time between turns does not count, and neither does sleep: the hooks read the
+awake clock that Codex uses for "Worked for". Subagent prompts never start a turn, because the main
+agent's turn already contains their work. When nothing new is recorded, or when a Codex subagent
+calls the command, it stages nothing, prints `"staged": false` with a `reason` and a `message`,
+and exits 0. The source kind is `codex` or `claude_code` from the recording host.
 `--dry-run` prints the request and its retry key without staging anything.
 
 Without hooks, pass observed values:

package/dist/flowmind/SKILL.md

@@ -46,13 +46,17 @@ To find gaps across the user's folders, run `flowmind link --scan <dir...>`. It
 
 ## Log agent work
 
-In a linked repository, the session hooks record how long each agent turn runs. When you finish a material unit of work, such as a feature, fix, investigation, or document, stage it. Do not stage every turn.
+In a linked repository, the session hooks record how long the main agent's turns run. When you finish a material unit of work, such as a feature, fix, investigation, or document, stage it before you start the next one. Do not stage every turn.
 
 ```bash
 flowmind agent stage --intention "<what you set out to do>" --outcome "<what changed or shipped>" --artifact-url <commit, PR, or document URL> --json
 ```
 
-- 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.
+- The CLI reads the project from `.flowmind.json` and the time from the session record. The time is the main agent's turn time on the awake clock that Codex uses for "Worked for", so sleep does not count. It includes the time that subagents work during the turn.
+- A stage covers the whole minutes since the session's last proof. The remaining seconds carry over to the next proof.
+- When several units of work finish together, stage them as one proof that names them all. A second stage right after the first has no new time.
+- Subagents do not stage. In a Codex subagent, `flowmind agent stage` stages nothing and tells the subagent to report its outcome to the main agent.
+- `"staged": false` in the JSON output means that nothing was staged, and it is not an error. `reason` is `no-new-time` when the last proof (`lastProposalId`) already holds the session's time, or `subagent`. Tell the user which proof covers the work.
 - 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.