sflow-journal
Review and manage the private machine-local My Work journal.
SKILL.mdplugin/skills/sflow-journal/SKILL.md
GitHubLocal work journal
<!-- sflow-copilot-pause -->Before any boundary lookup or SFlow action, run singularity-flow pause status --json and follow its data.agentInstruction. If data.paused, answer as native Copilot, only offer /sf-pause off and never resume implicitly.
Output contract: Collect every required choice explicitly; never infer or preselect; preserve errors, artifacts, and next actions. Summarize artifacts with verified Markdown-preview links; never paste document bodies, code or diffs into Copilot. For code, list touched paths and observed added/deleted/created line counts; unavailable stays unavailable. Use existing evidence, not extra calls solely for display. Summaries, links and opened previews are not human review or approval. For every next action, honor returned commandGuidance in order: Copilot, Shell, VS Code (model-free) using modelFreeCommand; if absent, say "not available for this action". Missing Copilot: "no verified equivalent". Never invent routes.
Boundary: machine-local; no repository or Story required. Use explicit arguments or SFlow-returned paths; never search $HOME or infer a repository. Use exact CLI-returned paths. repositoryPath is command cwd, not a prefix for absolute file paths. Never rebase paths or strip .git/worktrees. Issued private/external files are exact exceptions to repository confinement, not wider read/write permission; writes still need authorization. Resolve relative paths only against their declared base. On failure, preserve the path and error; never search or recreate it.
The journal is advisory return memory. It is never governance evidence, approval authority, a productivity score, or a remote source of truth.
- With no requested action, run
singularity-flow journal today --json. Explain that the result is stored locally and never pushed. - Use
singularity-flow journal refresh --jsononly after the user asks to refresh local facts. It reads local Git state without fetching, pushing, or contacting a remote. - Use
singularity-flow journal settings --jsonto inspect capture. Change mode, retention, or time zone only after showing the exact proposed settings and receiving explicit confirmation. singularity-flow journal pauseandsingularity-flow journal resumechange only future local capture. They do not alter governed work or delete history.- For day deletion, require the date twice:
singularity-flow journal delete --date YYYY-MM-DD --confirm YYYY-MM-DD --json. For all history, require the exact phraseDELETE LOCAL JOURNAL. - Export only a reviewed summary, never raw events. The CLI refuses export inside a registered workspace so it cannot be staged accidentally.
- Preserve refusals and diagnostics verbatim. Never describe locally observed remote-tracking refs as a live remote check.
Do not infer work duration, effort, attendance, or individual performance from journal records.