deepflow 0.1.70 → 0.1.71

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
@@ -77,10 +77,8 @@ You write the specs, then walk away. The AI runs the full pipeline — hypothesi
77
77
  ```bash
78
78
  # You define WHAT (the specs), the AI figures out HOW, overnight
79
79
 
80
- # Requires Agent Teams (experimental feature)
81
- export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
82
-
83
- deepflow auto # process all specs in specs/
80
+ # Inside Claude Code (requires Agent Teams)
81
+ /df:auto # process all specs in specs/
84
82
  ```
85
83
 
86
84
  **What the AI does alone:**
@@ -93,7 +91,7 @@ deepflow auto # process all specs in specs/
93
91
  7. If rejected: generates new hypotheses, retries (up to max-cycles)
94
92
  8. On convergence: verifies (L0-L4 gates), creates PR, merges to main
95
93
 
96
- **What you do:** Write specs (via interactive mode or manually) in `specs/`, run `deepflow auto`, read the morning report at `.deepflow/auto-report.md`. No need to run `/df:plan` first — auto mode promotes plain specs to `doing-*` automatically.
94
+ **What you do:** Write specs (via interactive mode or manually) in `specs/`, run `/df:auto` inside Claude Code, read the report at `.deepflow/auto-report.md`. No need to run `/df:plan` first — auto mode promotes plain specs to `doing-*` automatically.
97
95
 
98
96
  **How to use:**
99
97
  ```bash
@@ -103,15 +101,16 @@ $ claude
103
101
  > /df:spec auth # creates specs/auth.md
104
102
  > /exit
105
103
 
106
- # In your terminalenable agent teams and run auto mode
107
- $ export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
108
- $ deepflow auto
104
+ # Inside Claude Code — run auto mode
105
+ > /df:auto
109
106
 
110
107
  # Next morning — check what happened
111
108
  $ cat .deepflow/auto-report.md
112
109
  $ git log --oneline
113
110
  ```
114
111
 
112
+ **Requires:** `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` in your environment (agent teams is an experimental Claude Code feature).
113
+
115
114
  **Safety:** Never pushes to remote. Failed approaches recorded in `.deepflow/experiments/` and never repeated. Specs validated before processing (malformed specs are skipped).
116
115
 
117
116
  ### The Boundary
@@ -166,7 +165,7 @@ $ git log --oneline
166
165
  ## The Flow (Autonomous)
167
166
 
168
167
  ```
169
- deepflow auto
168
+ /df:auto
170
169
  | Discover specs (auto-promote, topological sort by depends_on)
171
170
  | For each doing-* spec:
172
171
  |
@@ -225,7 +224,7 @@ Execution happens in an isolated git worktree:
225
224
 
226
225
  ## LSP Integration
227
226
 
228
- deepflow automatically enables Claude Code's LSP tools during install, giving agents access to `goToDefinition`, `findReferences`, and `workspaceSymbol` for precise code navigation instead of grep-based searching.
227
+ /df:automatically enables Claude Code's LSP tools during install, giving agents access to `goToDefinition`, `findReferences`, and `workspaceSymbol` for precise code navigation instead of grep-based searching.
229
228
 
230
229
  - **Global install:** sets `ENABLE_LSP_TOOL=1` in `~/.claude/settings.json`
231
230
  - **Project install:** sets it in `.claude/settings.local.json`
@@ -235,7 +234,7 @@ Agents prefer LSP tools when available and fall back to Grep/Glob silently. You'
235
234
 
236
235
  ## Spec Validation
237
236
 
238
- Specs are validated before downstream consumption by `/df:spec`, `/df:plan`, and `deepflow auto`:
237
+ Specs are validated before downstream consumption by `/df:spec`, `/df:plan`, and `/df:auto`:
239
238
 
240
239
  - **Hard invariants** (block on failure): required sections present, REQ-N prefixes, checkbox ACs, no duplicate IDs
241
240
  - **Advisory warnings** (warn interactively, block in auto mode): long specs, orphaned requirements, excessive technical notes
@@ -263,7 +262,7 @@ Statusline shows context usage. At >=50%:
263
262
  | `/df:consolidate` | Deduplicate and clean up decisions.md |
264
263
  | `/df:resume` | Session continuity briefing |
265
264
  | `/df:update` | Update deepflow to latest |
266
- | `deepflow auto` | Autonomous overnight execution (no human needed) |
265
+ | `/df:auto` | Autonomous execution via agent teams (no human needed) |
267
266
 
268
267
  ## File Structure
269
268
 
package/bin/install.js CHANGED
@@ -10,25 +10,15 @@ const os = require('os');
10
10
  const readline = require('readline');
11
11
  const { execFileSync } = require('child_process');
12
12
 
13
- // Subcommand routing: `deepflow auto [...]` -> claude --agent .claude/agents/deepflow-auto.md
13
+ // Legacy subcommand: `deepflow auto` is now `/df:auto` inside Claude Code
14
14
  if (process.argv[2] === 'auto') {
15
- if (!process.env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS) {
16
- console.error('Error: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS environment variable is not set.');
17
- console.error('');
18
- console.error('The `deepflow auto` command now uses Claude Code Agent Teams.');
19
- console.error('To enable it, set the environment variable before running:');
20
- console.error('');
21
- console.error(' export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1');
22
- console.error(' deepflow auto');
23
- console.error('');
24
- process.exit(1);
25
- }
26
- try {
27
- execFileSync('claude', ['--agent', '.claude/agents/deepflow-auto.md', '-p', 'Run the full autonomous cycle now. Auto-promote unprefixed specs to doing-*, then process all doing-* specs through every phase. Do not ask questions — act autonomously.', ...process.argv.slice(3)], { stdio: 'inherit' });
28
- } catch (e) {
29
- process.exit(e.status || 1);
30
- }
31
- process.exit(0);
15
+ console.error('`deepflow auto` has moved inside Claude Code for better visibility.');
16
+ console.error('');
17
+ console.error('Usage:');
18
+ console.error(' 1. Open Claude Code: claude');
19
+ console.error(' 2. Run: /df:auto');
20
+ console.error('');
21
+ process.exit(1);
32
22
  }
33
23
 
34
24
  // Colors
@@ -196,9 +186,9 @@ async function main() {
196
186
  console.log(`${c.green}Installation complete!${c.reset}`);
197
187
  console.log('');
198
188
  console.log(`Installed to ${c.cyan}${CLAUDE_DIR}${c.reset}:`);
199
- console.log(' commands/df/ — /df:discover, /df:debate, /df:spec, /df:plan, /df:execute, /df:verify, /df:note, /df:resume, /df:update');
189
+ console.log(' commands/df/ — /df:discover, /df:debate, /df:spec, /df:plan, /df:execute, /df:verify, /df:auto, /df:note, /df:resume, /df:update');
200
190
  console.log(' skills/ — gap-discovery, atomic-commits, code-completeness');
201
- console.log(' agents/ — reasoner, deepflow-auto (autonomous overnight execution)');
191
+ console.log(' agents/ — reasoner, deepflow-auto (/df:auto — autonomous execution)');
202
192
  if (level === 'global') {
203
193
  console.log(' hooks/ — statusline, update checker');
204
194
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "deepflow",
3
- "version": "0.1.70",
3
+ "version": "0.1.71",
4
4
  "description": "Stay in flow state - lightweight spec-driven task orchestration for Claude Code",
5
5
  "keywords": [
6
6
  "claude",
@@ -0,0 +1,16 @@
1
+ # /df:auto — Autonomous Mode
2
+
3
+ Run the full autonomous cycle via agent teams. Auto-promotes unprefixed specs to `doing-*`, then processes all `doing-*` specs through every phase: discover, pre-check, hypothesize, spike, implement, select, verify, PR, report.
4
+
5
+ ## Usage
6
+ ```
7
+ /df:auto # process all specs
8
+ ```
9
+
10
+ ## Behavior
11
+
12
+ Load and execute the lead agent at `.claude/agents/deepflow-auto.md`.
13
+
14
+ Run the full autonomous cycle now. Auto-promote unprefixed specs to `doing-*`, then process all `doing-*` specs through every phase. Do not ask questions — act autonomously.
15
+
16
+ Output progress as each phase completes. Generate `.deepflow/auto-report.md` at the end.