@flowmind/cli 0.3.8 → 0.3.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -181,13 +181,15 @@ An ordinary prompt and stop still count; a restart or a gap longer than 12 hours
181
181
 
182
182
  Upgrading from 0.3.7 needs no new sign-in. A never-bound profile asks the API which account owns its
183
183
  stored key (`GET /v1/me`, once). A previously bound key whose credential or origin no longer matches
184
- is refused locally. Every 0.3.7 proof stays in its original location regardless of timestamps. The
185
- `unowned` list in `agent pending` shows only neutral metadata. Check Activity before adopting a proof
186
- that is yours with `flowmind agent adopt <id>`. Only then can it replay its original origin, body and key.
187
- Use `flowmind agent discard <id>` to delete an unowned proof without sending it. Session
188
- time recorded by 0.3.7 is not adopted. A revoked key asks you to sign in; an unreachable API reports that the
189
- account could not be verified and changes nothing. On POSIX the config directory is 0700 and its credential file
190
- is 0600, including when repairing an older config.
184
+ is refused locally. While a profile has only ever been signed in to one account, which is the normal case
185
+ of one person on their own machine, the session time and saved proofs that 0.3.7 recorded become that
186
+ account's on the first command or hook after the upgrade: an agent session that was running during the
187
+ upgrade stages its whole time as before, and saved proofs are sent with the others. On a profile that has
188
+ switched accounts, 0.3.7 proofs stay in their original location and the `unowned` list in `agent pending`
189
+ shows only neutral metadata. Check Activity before adopting a proof that is yours with
190
+ `flowmind agent adopt <id>`, or delete it unsent with `flowmind agent discard <id>`. A revoked key asks you to
191
+ sign in; an unreachable API reports that the account could not be verified and changes nothing. On POSIX the
192
+ config directory is 0700 and its credential file is 0600, including when repairing an older config.
191
193
 
192
194
  ## Momentum brief
193
195
 
@@ -251,7 +253,7 @@ A valid API rejection also exits with status 1.
251
253
  One diagnostic names the action, operation, schema location, and request ID when available.
252
254
  Diagnostics omit response values, credentials, query values, and server messages.
253
255
 
254
- A personal log with a transport failure, timeout, or unreadable response is not confirmed. The CLI does not retry it automatically. Run the same log command to replay its saved fields and key. A natural log reuses what you already reviewed. After the 24-hour receipt window the same command is refused, because the server may no longer recognize the key. Check Activity, then close the saved log with `flowmind pending-logs done <id>` when the entry is there, or `flowmind pending-logs discard <id>` to log the work again. `flowmind pending-logs` lists the saved logs; neither action posts anything. Supply hours as a decimal such as `1.5`; commas and unit suffixes are refused.
256
+ A personal log with a transport failure, timeout, or unreadable response is not confirmed. The CLI does not retry it automatically. Run the same log command to replay its saved fields and key. A natural log reuses what you already reviewed. After the 24-hour receipt window the same command is refused, because the server may no longer recognize the key. Check Activity, then close the saved log with `flowmind pending-logs done <id>` when the entry is there, or `flowmind pending-logs discard <id>` to log the work again. `flowmind pending-logs` lists the saved logs; neither action posts anything. `--hours` takes hours or minutes: `1.5`, `1,5`, `2h`, `90m` or `1h30m`, rounded to the nearest minute. Anything else is refused before a request.
255
257
  Authentication stops immediately on a failed poll. Pending authorization continues polling.
256
258
  Expired authorization exits with status 1. No failed authorization saves a credential.
257
259
  Use `fm auth login --no-browser` to open the printed authorization URL yourself.
@@ -61,7 +61,7 @@ flowmind agent stage --intention "<what you set out to do>" --outcome "<one line
61
61
  - `"reason": "saved"` means that the server did not take the proof yet, for example because Flowmind was unreachable, a limit was reached, or its answer could not be read. The CLI saved it on this machine and sends it automatically: after the next accepted stage, or in the background from the session hooks. Its time already counts as staged. Do not stage it again, do not invent another `--idempotency-key`, and tell the user it waits to be sent.
62
62
  - A refused credential also keeps the proof saved, but exits with an error: the user must run `flowmind auth login`. A proof that the server refuses for its content (too long, unknown project) is not saved; fix it and stage again.
63
63
  - A stage key conflict means delivery is unknown. The file and its time stay reserved. Tell the owner to check Activity, then retry with the original credential or discard the file with `flowmind agent discard <id>`. Do not stage the same work again. `agent retry --json` lists unresolved `conflicts`.
64
- - `flowmind agent pending --json` lists this signed-in account’s proofs saved on this machine; `flowmind agent retry --json` sends them now. `unowned` lists neutral metadata for every proof saved by the older CLI; tell the user, who decides with `flowmind agent adopt <id>` or `flowmind agent discard <id>`.
64
+ - `flowmind agent pending --json` lists this signed-in account’s proofs saved on this machine; `flowmind agent retry --json` sends them now. Proofs and session time from CLI 0.3.7 join the account automatically on a machine that has only used one account. `unowned` appears only after an account switch: it lists neutral metadata for proofs saved by the older CLI; tell the user, who decides with `flowmind agent adopt <id>` or `flowmind agent discard <id>`.
65
65
  - 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.
66
66
  - Add `--dry-run` to preview the project and minutes without staging.
67
67
  - Pass `--project`, `--minutes`, and `--started-at` only when no session record exists. Use observed times only. Never estimate time from tokens or tool calls.