deepflow 0.1.89 → 0.1.90

package/src/commands/df/report.md

@@ -1,75 +0,0 @@
----
-name: df:report
-description: Generate session cost report with token usage, cache hit ratio, per-task costs, and quota impact
-allowed-tools: [Read, Write, Bash]
----
-
-# /df:report — Session Cost Report
-
-> **DEPRECATED:** Use `/df:dashboard` instead to view deepflow metrics and status.
-
-## Orchestrator Role
-
-Aggregate token usage data and produce a structured report.
-
-**NEVER:** Spawn agents, use Task tool, use AskUserQuestion, run git, EnterPlanMode, ExitPlanMode
-
-**ONLY:** Read data files, compute aggregates, write `.deepflow/report.json` and `.deepflow/report.md`
-
-## Behavior
-
-### 1. LOAD DATA SOURCES
-
-Read each source gracefully — missing files yield zero/empty values, never error out.
-
-| Source | Path | Shell injection | Key fields |
-|--------|------|-----------------|------------|
-| Token history | `.deepflow/token-history.jsonl` | `` !`cat .deepflow/token-history.jsonl 2>/dev/null \|\| echo ''` `` | `timestamp`, `input_tokens`, `cache_creation_input_tokens`, `cache_read_input_tokens`, `used_percentage`, `model`, `session_id` |
-| Quota history | `~/.claude/quota-history.jsonl` | `` !`tail -5 ~/.claude/quota-history.jsonl 2>/dev/null \|\| echo ''` `` | `timestamp`, `event`, API payload |
-| Task results | `.deepflow/results/T*.yaml` | `` !`ls .deepflow/results/T*.yaml 2>/dev/null \|\| echo ''` `` | `tokens` block: `start_percentage`, `end_percentage`, `delta_percentage`, `input_tokens`, `cache_creation_input_tokens`, `cache_read_input_tokens` |
-| Session metadata | `.deepflow/auto-memory.yaml` | `` !`cat .deepflow/auto-memory.yaml 2>/dev/null \|\| echo ''` `` | session_id, start time (optional) |
-
-### 2. COMPUTE AGGREGATES
-
-```
-total_input_tokens  = sum(input_tokens)
-total_cache_creation = sum(cache_creation_input_tokens)
-total_cache_read    = sum(cache_read_input_tokens)
-total_tokens_all    = total_input_tokens + total_cache_creation + total_cache_read
-cache_hit_ratio     = total_cache_read / total_tokens_all  (0 if denominator=0, clamp [0,1], round 4 decimals)
-peak_context_percentage = max(used_percentage)
-model               = most recent line's model
-```
-
-### 3. WRITE `.deepflow/report.json`
-
-Structure: `{ version: 1, generated: ISO-8601-UTC, session_summary: {total_input_tokens, total_cache_creation, total_cache_read, cache_hit_ratio, peak_context_percentage, model}, tasks: [{task_id, start_percentage, end_percentage, delta_percentage, input_tokens, cache_creation, cache_read}], quota: {available: bool, ...API fields if available} }`
-
-Rules: `version` always 1. `tasks` = `[]` if no results found. `quota.available` = false if missing. All token fields integers >= 0. `cache_hit_ratio` float in [0,1].
-
-### 4. WRITE `.deepflow/report.md`
-
-Required sections with exact headings:
-
-**## Session Summary** — Table: Model, Total Input Tokens, Cache Creation Tokens, Cache Read Tokens, Cache Hit Ratio (with %), Peak Context Usage %.
-
-**## Per-Task Costs** — Table: Task, Start %, End %, Delta %, Input Tokens, Cache Creation, Cache Read. Show `_(No task data available)_` if empty.
-
-**## Quota Impact** — Quota fields table if `quota.available=true`, else exactly: `Not available (non-macOS or no token)`.
-
-### 5. CONFIRM
-
-```
-Report generated:
-  .deepflow/report.json  — machine-readable (version=1)
-  .deepflow/report.md    — human-readable summary
-```
-
-List missing data sources as a note if any were absent.
-
-## Rules
-
-- Graceful degradation — missing files yield zero/empty, never error
-- No hallucination — only values from actual file contents; 0 for missing fields
-- Idempotent — re-running overwrites both files with fresh data
-- ISO 8601 UTC timestamps for `generated` field

package/src/commands/df/resume.md

@@ -1,47 +0,0 @@
----
-name: df:resume
-description: Synthesize project state into a briefing covering what happened, current decisions, and next steps
-allowed-tools: [Read, Grep, Glob, Bash]
----
-
-# /df:resume — Session Continuity Briefing
-
-## Orchestrator Role
-
-Read project state from multiple sources, produce a concise briefing for resuming work. Pure read-only.
-
-**NEVER:** Write/create/modify files, run git write ops, use AskUserQuestion, spawn agents, use TaskOutput, EnterPlanMode, ExitPlanMode
-
-**ONLY:** Read files (Bash read-only git commands, Read, Glob, Grep), write briefing to stdout
-
-## Behavior
-
-### 1. GATHER SOURCES (parallel, all reads)
-
-| Source | Command/Path | Purpose |
-|--------|-------------|---------|
-| Git timeline | `` !`git log --oneline -20` `` | What changed and when |
-| Decisions | `` !`cat .deepflow/decisions.md 2>/dev/null \|\| echo 'NOT_FOUND'` `` | Live [APPROACH], [PROVISIONAL], [ASSUMPTION] entries |
-| Plan | `` !`cat PLAN.md 2>/dev/null \|\| echo 'NOT_FOUND'` `` | Task status (checked vs unchecked) |
-| Spec headers | `` !`head -20 specs/doing-*.md 2>/dev/null \|\| echo 'NOT_FOUND'` `` | In-flight features |
-| Experiments | `` !`ls .deepflow/experiments/ 2>/dev/null \|\| echo 'NOT_FOUND'` `` | Validated/failed approaches |
-
-Token budget: ~2500 tokens input. Skip missing sources silently.
-
-### 2. SYNTHESIZE BRIEFING (200-500 words, 3 sections)
-
-**## Timeline** — 3-6 sentences: arc of work from git log + spec/PLAN state. What completed, in-flight, notable milestones. Reference dates/commits where informative.
-
-**## Live Decisions** — All `[APPROACH]`, `[PROVISIONAL]`, `[ASSUMPTION]` from `.deepflow/decisions.md` as bullets with tag + text + rationale. Show newest entry per topic if contradictions exist. State "No decisions recorded yet." if absent/empty.
-
-**## Next Steps** — From PLAN.md: unblocked `- [ ]` tasks first, then blocked tasks with blockers. If no PLAN.md: suggest `/df:plan`.
-
-### 3. OUTPUT
-
-Print briefing to stdout. No file writes.
-
-## Rules
-
-- Read sources in a single pass — no re-reads
-- Contradicted decisions: show newest per topic only
-- Token budget: ~2500 input tokens to produce ~500 words output