@iservu-inc/adf-cli 0.12.12 → 0.14.0
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/.claude/settings.local.json +6 -1
- package/.context/memory/architecture.md +40 -0
- package/.context/memory/glossary.md +19 -0
- package/.project/docs/VERSIONING-GUIDE.md +127 -0
- package/AGENTS.md +53 -0
- package/CHANGELOG.md +149 -0
- package/bin/adf.js +10 -0
- package/conductor/archive/context_synthesis_20260112/metadata.json +8 -0
- package/conductor/archive/context_synthesis_20260112/plan.md +40 -0
- package/conductor/archive/context_synthesis_20260112/spec.md +43 -0
- package/conductor/archive/verify_opencode_20260111/metadata.json +8 -0
- package/conductor/archive/verify_opencode_20260111/plan.md +34 -0
- package/conductor/archive/verify_opencode_20260111/spec.md +25 -0
- package/conductor/code_styleguides/javascript.md +51 -0
- package/conductor/product-guidelines.md +26 -0
- package/conductor/product.md +25 -0
- package/conductor/setup_state.json +1 -0
- package/conductor/tech-stack.md +28 -0
- package/conductor/tracks/bootstrap_agents_20260111/metadata.json +8 -0
- package/conductor/tracks/bootstrap_agents_20260111/plan.md +17 -0
- package/conductor/tracks/bootstrap_agents_20260111/spec.md +27 -0
- package/conductor/tracks.md +9 -0
- package/conductor/workflow.md +333 -0
- package/lib/analysis/ai-gap-analyzer.js +66 -0
- package/lib/analysis/dynamic-question-generator.js +55 -0
- package/lib/analysis/heuristic-gap-analyzer.js +45 -0
- package/lib/analysis/synthesis-engine.js +142 -0
- package/lib/commands/deploy.js +28 -2
- package/lib/commands/guide.js +173 -150
- package/lib/commands/tools.js +38 -0
- package/lib/generators/codex-cli-generator.js +41 -0
- package/lib/generators/index.js +33 -0
- package/lib/generators/kiro-generator.js +49 -0
- package/lib/generators/opencode-generator.js +332 -153
- package/lib/generators/trae-generator.js +34 -0
- package/lib/templates/scripts/analyze-framework-updates.js +361 -0
- package/lib/templates/scripts/build.js +608 -0
- package/lib/templates/scripts/check-framework-updates.js +118 -0
- package/lib/templates/scripts/config-helpers.js +1 -1
- package/lib/templates/scripts/deploy.js +13 -28
- package/lib/templates/scripts/init.js +110 -220
- package/lib/templates/scripts/postinstall.js +13 -0
- package/lib/templates/scripts/update-frameworks.js +28 -0
- package/lib/templates/scripts/validate-env.js +428 -0
- package/lib/templates/scripts/validate-mcp.js +471 -0
- package/lib/templates/scripts/validate.js +482 -0
- package/lib/templates/shared/agents/analyst.md +1 -1
- package/lib/templates/shared/agents/architect.md +13 -17
- package/lib/templates/shared/agents/dev.md +2 -2
- package/lib/templates/shared/agents/pm.md +1 -1
- package/lib/templates/shared/agents/qa.md +1 -1
- package/lib/templates/shared/agents/sm.md +2 -2
- package/lib/templates/shared/templates/README.md +2 -2
- package/lib/templates/shared/templates/openspec-proposal.md +2 -2
- package/lib/templates/shared/templates/prd-template.md +1 -1
- package/lib/templates/shared/templates/story-template.md +1 -1
- package/lib/utils/context-extractor.js +157 -0
- package/lib/utils/framework-detector.js +54 -0
- package/lib/utils/tool-feature-registry.js +102 -0
- package/package.json +1 -1
- package/tests/ai-gap-analyzer.test.js +38 -0
- package/tests/codex-cli-generator.test.js +29 -0
- package/tests/context-extractor.test.js +70 -0
- package/tests/deploy-integration.test.js +36 -0
- package/tests/deploy.test.js +57 -0
- package/tests/dynamic-question-generator.test.js +29 -0
- package/tests/framework-detector.test.js +55 -0
- package/tests/heuristic-gap-analyzer.test.js +46 -0
- package/tests/kiro-trae-generators.test.js +43 -0
- package/tests/opencode-generator.test.js +113 -0
- package/tests/synthesis-engine.test.js +52 -0
- package/tests/tool-feature-registry.test.js +23 -0
package/lib/commands/guide.js
CHANGED
|
@@ -7,57 +7,68 @@ const TOOL_GUIDES = {
|
|
|
7
7
|
name: 'Codeium Windsurf',
|
|
8
8
|
files: [
|
|
9
9
|
{ path: '.windsurfrules', desc: 'Legacy rules file (deprecated)' },
|
|
10
|
-
{ path: '.windsurf/rules/*.md', desc: 'Modular rules (
|
|
10
|
+
{ path: '.windsurf/rules/*.md', desc: 'Modular rules (max 12000 chars per file)' },
|
|
11
11
|
{ path: '.windsurf/workflows/*.md', desc: 'Workflow definitions' },
|
|
12
12
|
{ path: 'AGENTS.md', desc: 'Universal agent manifest (ANDF standard)' }
|
|
13
13
|
],
|
|
14
14
|
setup: [
|
|
15
|
-
'1.
|
|
16
|
-
'2.
|
|
17
|
-
'3.
|
|
18
|
-
'4.
|
|
15
|
+
'1. Download and install Windsurf from: https://codeium.com/windsurf',
|
|
16
|
+
'2. Open your project in Windsurf IDE',
|
|
17
|
+
'3. Create .windsurf/rules/ directory for modular rules',
|
|
18
|
+
'4. Each .md file in rules/ directory auto-loaded (max 12000 chars)',
|
|
19
|
+
'5. Rules active immediately in Cascade AI'
|
|
19
20
|
],
|
|
20
21
|
usage: [
|
|
21
|
-
'•
|
|
22
|
-
'•
|
|
23
|
-
'•
|
|
24
|
-
'•
|
|
22
|
+
'• Cmd/Ctrl+L - Open Cascade AI chat',
|
|
23
|
+
'• Rules from .windsurf/rules/*.md applied automatically',
|
|
24
|
+
'• Character limit: 12000 chars per rule file',
|
|
25
|
+
'• Split large agents across multiple .md files if needed',
|
|
26
|
+
'• Use @agents.md to reference manifest explicitly',
|
|
27
|
+
'• Workflows in .windsurf/workflows/ directory',
|
|
28
|
+
'• Docs: https://docs.windsurf.com/windsurf/cascade/memories'
|
|
25
29
|
],
|
|
26
30
|
mcpServers: [],
|
|
27
31
|
troubleshooting: [
|
|
28
|
-
'• Rules not loading? Check
|
|
29
|
-
'•
|
|
30
|
-
'•
|
|
32
|
+
'• Rules not loading? Check each .md file is ≤12000 characters',
|
|
33
|
+
'• Verify .windsurf/rules/ directory exists',
|
|
34
|
+
'• Restart Windsurf IDE after adding new rules',
|
|
35
|
+
'• Check View → Output → Windsurf for parsing errors'
|
|
31
36
|
]
|
|
32
37
|
},
|
|
33
38
|
|
|
34
39
|
'cursor': {
|
|
35
40
|
name: 'Cursor AI IDE',
|
|
36
41
|
files: [
|
|
37
|
-
{ path: '.cursor/rules', desc: 'Cursor rules
|
|
38
|
-
{ path: '.cursorrules', desc: '
|
|
42
|
+
{ path: '.cursor/rules/*.mdc', desc: 'Cursor rules with YAML frontmatter' },
|
|
43
|
+
{ path: '.cursorrules', desc: 'Legacy single-file rules (deprecated)' },
|
|
39
44
|
{ path: 'AGENTS.md', desc: 'Universal agent manifest' },
|
|
40
45
|
{ path: '.context/', desc: 'Deep context (architecture, glossary)' }
|
|
41
46
|
],
|
|
42
47
|
setup: [
|
|
43
|
-
'1.
|
|
44
|
-
'2.
|
|
45
|
-
'3.
|
|
46
|
-
'4.
|
|
48
|
+
'1. Download and install Cursor from: https://cursor.sh',
|
|
49
|
+
'2. Open your project in Cursor',
|
|
50
|
+
'3. Create .cursor/rules/ directory',
|
|
51
|
+
'4. Add .mdc files with YAML frontmatter (see usage)',
|
|
52
|
+
'5. Rules auto-apply to Agent (Cmd/Ctrl+L) and Cmd+K'
|
|
47
53
|
],
|
|
48
54
|
usage: [
|
|
49
|
-
'• Cmd/Ctrl+K - Inline
|
|
50
|
-
'• Cmd/Ctrl+L - Chat with
|
|
51
|
-
'•
|
|
52
|
-
'
|
|
55
|
+
'• Cmd/Ctrl+K - Inline editing with rules applied',
|
|
56
|
+
'• Cmd/Ctrl+L - Chat (Agent) with rules applied',
|
|
57
|
+
'• Rules format (.mdc file):',
|
|
58
|
+
' ---',
|
|
59
|
+
' title: Developer Agent',
|
|
60
|
+
' description: Development guidelines',
|
|
61
|
+
' ---',
|
|
62
|
+
' [Your agent instructions here]',
|
|
63
|
+
'• Use @AGENTS.md to reference manifest',
|
|
53
64
|
'• Tab to accept AI suggestions'
|
|
54
65
|
],
|
|
55
66
|
mcpServers: [],
|
|
56
67
|
troubleshooting: [
|
|
57
|
-
'• Rules not active? Check .cursor/rules exists',
|
|
58
|
-
'• Verify
|
|
59
|
-
'• Restart Cursor
|
|
60
|
-
'• Check Settings → Features → Rules enabled'
|
|
68
|
+
'• Rules not active? Check .cursor/rules/ directory exists',
|
|
69
|
+
'• Verify .mdc files have valid YAML frontmatter',
|
|
70
|
+
'• Restart Cursor after adding new rules',
|
|
71
|
+
'• Check Cursor Settings → Features → Rules enabled'
|
|
61
72
|
]
|
|
62
73
|
},
|
|
63
74
|
|
|
@@ -65,103 +76,106 @@ const TOOL_GUIDES = {
|
|
|
65
76
|
name: 'Visual Studio Code (GitHub Copilot)',
|
|
66
77
|
files: [
|
|
67
78
|
{ path: '.github/copilot-instructions.md', desc: 'GitHub Copilot custom instructions' },
|
|
68
|
-
{ path: '.vscode/settings.json', desc: '
|
|
79
|
+
{ path: '.vscode/settings.json', desc: 'Workspace settings' },
|
|
69
80
|
{ path: 'AGENTS.md', desc: 'Universal agent manifest' },
|
|
70
81
|
{ path: '.context/', desc: 'Deep context directory' }
|
|
71
82
|
],
|
|
72
83
|
setup: [
|
|
73
|
-
'1.
|
|
74
|
-
'2.
|
|
75
|
-
'3.
|
|
76
|
-
'4.
|
|
84
|
+
'1. Download VS Code from: https://code.visualstudio.com',
|
|
85
|
+
'2. Install GitHub Copilot extension from marketplace',
|
|
86
|
+
'3. Create .github/copilot-instructions.md in project root',
|
|
87
|
+
'4. Copilot automatically reads instructions on chat start',
|
|
88
|
+
'5. No restart needed - instructions load per conversation'
|
|
77
89
|
],
|
|
78
90
|
usage: [
|
|
79
|
-
'•
|
|
91
|
+
'• Cmd/Ctrl+I - Inline Copilot chat',
|
|
92
|
+
'• Cmd/Ctrl+Shift+I - Copilot panel (sidebar)',
|
|
80
93
|
'• Copilot reads .github/copilot-instructions.md automatically',
|
|
81
|
-
'•
|
|
82
|
-
'
|
|
83
|
-
'
|
|
84
|
-
'
|
|
85
|
-
'• Inline suggestions follow your project\'s patterns'
|
|
94
|
+
'• Use @workspace to include entire workspace context',
|
|
95
|
+
'• Reference specific files: @filename.js',
|
|
96
|
+
'• Instructions format: Plain markdown in copilot-instructions.md',
|
|
97
|
+
'• Documentation: https://docs.github.com/copilot'
|
|
86
98
|
],
|
|
87
99
|
mcpServers: [],
|
|
88
100
|
troubleshooting: [
|
|
89
|
-
'• Instructions not
|
|
90
|
-
'•
|
|
91
|
-
'•
|
|
92
|
-
'•
|
|
101
|
+
'• Instructions not loading? Verify .github/ directory exists',
|
|
102
|
+
'• Check Copilot status icon in bottom-right corner',
|
|
103
|
+
'• Restart Copilot: Cmd/Ctrl+Shift+P → "Copilot: Restart"',
|
|
104
|
+
'• Verify GitHub Copilot subscription is active'
|
|
93
105
|
]
|
|
94
106
|
},
|
|
95
107
|
|
|
96
108
|
'zed': {
|
|
97
109
|
name: 'Zed Editor',
|
|
98
110
|
files: [
|
|
99
|
-
{ path: '.zed/settings.json', desc: '
|
|
100
|
-
{ path: '.zed/keymap.json', desc: 'Agent switching shortcuts' },
|
|
101
|
-
{ path: '.zed/rules', desc: 'Symlink to AGENTS.md' },
|
|
111
|
+
{ path: '.zed/settings.json', desc: 'Project-specific settings' },
|
|
102
112
|
{ path: 'AGENTS.md', desc: 'Universal agent manifest' },
|
|
103
|
-
{ path: '.context/', desc: 'Deep context
|
|
113
|
+
{ path: '.context/', desc: 'Deep context directory' }
|
|
104
114
|
],
|
|
105
115
|
setup: [
|
|
106
|
-
'1.
|
|
107
|
-
'2.
|
|
108
|
-
'3.
|
|
109
|
-
'4.
|
|
116
|
+
'1. Download and install Zed from: https://zed.dev',
|
|
117
|
+
'2. Open your project in Zed',
|
|
118
|
+
'3. Create .zed/settings.json in project root (optional)',
|
|
119
|
+
'4. Global settings at: ~/.config/zed/settings.json',
|
|
120
|
+
'5. MCP servers configured in settings.json'
|
|
110
121
|
],
|
|
111
122
|
usage: [
|
|
112
|
-
'•
|
|
113
|
-
'• Ctrl+Enter -
|
|
114
|
-
'•
|
|
115
|
-
'
|
|
116
|
-
'
|
|
123
|
+
'• /assistant - Open AI assistant panel',
|
|
124
|
+
'• Cmd/Ctrl+Enter - Submit to assistant',
|
|
125
|
+
'• Configure MCP servers in settings.json:',
|
|
126
|
+
' {',
|
|
127
|
+
' "context_servers": {',
|
|
128
|
+
' "project": {',
|
|
129
|
+
' "command": "npx",',
|
|
130
|
+
' "args": ["@modelcontextprotocol/server-filesystem", ".context"]',
|
|
131
|
+
' }',
|
|
132
|
+
' }',
|
|
133
|
+
' }',
|
|
134
|
+
'• Reference AGENTS.md manually in conversation'
|
|
117
135
|
],
|
|
118
136
|
mcpServers: [
|
|
119
137
|
{
|
|
120
|
-
name: '
|
|
121
|
-
command: 'npx @modelcontextprotocol/server-filesystem
|
|
122
|
-
desc: 'Provides
|
|
123
|
-
},
|
|
124
|
-
{
|
|
125
|
-
name: 'archon',
|
|
126
|
-
url: 'http://archon.ad.iservu.cc:8051/mcp',
|
|
127
|
-
desc: 'Internal API documentation and RAG (if available)'
|
|
138
|
+
name: 'filesystem',
|
|
139
|
+
command: 'npx @modelcontextprotocol/server-filesystem',
|
|
140
|
+
desc: 'Provides file access via MCP protocol'
|
|
128
141
|
}
|
|
129
142
|
],
|
|
130
143
|
troubleshooting: [
|
|
131
|
-
'•
|
|
132
|
-
'•
|
|
133
|
-
'•
|
|
134
|
-
'•
|
|
144
|
+
'• MCP servers not starting? Check Node.js installed',
|
|
145
|
+
'• Verify settings.json syntax is valid JSON',
|
|
146
|
+
'• Check Zed logs: View → Debug → Developer Tools',
|
|
147
|
+
'• Documentation: https://zed.dev/docs'
|
|
135
148
|
]
|
|
136
149
|
},
|
|
137
150
|
|
|
138
151
|
'antigravity': {
|
|
139
152
|
name: 'Google Antigravity',
|
|
140
153
|
files: [
|
|
141
|
-
{ path: '.
|
|
142
|
-
{ path: 'AGENTS.md', desc: 'Universal agent manifest (mounted in container)' },
|
|
154
|
+
{ path: 'AGENTS.md', desc: 'Universal agent manifest' },
|
|
143
155
|
{ path: '.context/', desc: 'Deep context (architecture, glossary)' }
|
|
144
156
|
],
|
|
145
157
|
setup: [
|
|
146
|
-
'1.
|
|
147
|
-
'2.
|
|
148
|
-
'3.
|
|
149
|
-
'4.
|
|
150
|
-
'5.
|
|
158
|
+
'1. Access Antigravity (Google internal tool)',
|
|
159
|
+
'2. Open your project or codebase',
|
|
160
|
+
'3. Click ... menu → Customizations',
|
|
161
|
+
'4. Add Rules and Workflows via customization UI',
|
|
162
|
+
'5. Rules and workflows saved automatically'
|
|
151
163
|
],
|
|
152
164
|
usage: [
|
|
153
|
-
'•
|
|
154
|
-
'•
|
|
155
|
-
'•
|
|
156
|
-
'•
|
|
157
|
-
'•
|
|
165
|
+
'• Access customizations: Click ... → Customizations',
|
|
166
|
+
'• Rules: Add custom instructions for AI behavior',
|
|
167
|
+
'• Workflows: Define multi-step processes',
|
|
168
|
+
'• Reference project files in conversation',
|
|
169
|
+
'• Use "Read AGENTS.md" to access agent manifest',
|
|
170
|
+
'• Conversational commands: "Follow dev workflow"',
|
|
171
|
+
'• .context/ directory accessible for detailed docs'
|
|
158
172
|
],
|
|
159
173
|
mcpServers: [],
|
|
160
174
|
troubleshooting: [
|
|
161
|
-
'•
|
|
162
|
-
'•
|
|
163
|
-
'•
|
|
164
|
-
'•
|
|
175
|
+
'• Customizations not applying? Check ... → Customizations menu',
|
|
176
|
+
'• Restart Antigravity session if changes not reflected',
|
|
177
|
+
'• Verify rules syntax is correct in customization UI',
|
|
178
|
+
'• Contact Google internal support for Antigravity issues'
|
|
165
179
|
]
|
|
166
180
|
},
|
|
167
181
|
|
|
@@ -169,77 +183,84 @@ const TOOL_GUIDES = {
|
|
|
169
183
|
name: 'Claude Code CLI',
|
|
170
184
|
files: [
|
|
171
185
|
{ path: '.framework/agents/*.md', desc: 'Agent definition files (analyst, pm, dev, qa, etc.)' },
|
|
186
|
+
{ path: '.claude/commands/', desc: 'Custom commands directory' },
|
|
172
187
|
{ path: 'AGENTS.md', desc: 'Universal agent manifest' },
|
|
173
188
|
{ path: '.context/', desc: 'Deep context directory' }
|
|
174
189
|
],
|
|
175
190
|
setup: [
|
|
176
|
-
'1.
|
|
177
|
-
'2.
|
|
178
|
-
'3.
|
|
179
|
-
'
|
|
180
|
-
'
|
|
181
|
-
' }',
|
|
182
|
-
'4. Claude Code loads agents automatically'
|
|
191
|
+
'1. Install Claude Code: curl -fsSL https://claude.ai/install.sh | bash',
|
|
192
|
+
'2. Authenticate: Follow prompts after installation',
|
|
193
|
+
'3. Navigate to your project directory',
|
|
194
|
+
'4. Custom commands in .claude/commands/ (optional)',
|
|
195
|
+
'5. Reference agent files manually in conversation'
|
|
183
196
|
],
|
|
184
197
|
usage: [
|
|
185
198
|
'• Start chat: claude-code',
|
|
186
|
-
'•
|
|
187
|
-
'
|
|
188
|
-
'
|
|
189
|
-
'
|
|
190
|
-
'•
|
|
191
|
-
'•
|
|
199
|
+
'• Interactive terminal-based chat with Claude',
|
|
200
|
+
'• Reference project files: "read .framework/agents/dev.md"',
|
|
201
|
+
'• Access AGENTS.md: "follow instructions in AGENTS.md"',
|
|
202
|
+
'• Custom commands: Place scripts in .claude/commands/',
|
|
203
|
+
'• Requirements: "show .adf/sessions/*/outputs/"',
|
|
204
|
+
'• Documentation: https://claude.ai/code'
|
|
192
205
|
],
|
|
193
206
|
mcpServers: [
|
|
194
207
|
{
|
|
195
208
|
name: 'filesystem',
|
|
196
|
-
desc: 'Can be configured
|
|
197
|
-
command: '
|
|
209
|
+
desc: 'Can be configured via .claude/settings.json',
|
|
210
|
+
command: 'Configure MCP servers in settings file'
|
|
198
211
|
}
|
|
199
212
|
],
|
|
200
213
|
troubleshooting: [
|
|
201
|
-
'•
|
|
202
|
-
'•
|
|
203
|
-
'•
|
|
204
|
-
'•
|
|
214
|
+
'• Installation issues? Check: https://claude.ai/code',
|
|
215
|
+
'• Command not found? Restart terminal after install',
|
|
216
|
+
'• Authentication failed? Run installation script again',
|
|
217
|
+
'• Custom commands not working? Check .claude/commands/ permissions'
|
|
205
218
|
]
|
|
206
219
|
},
|
|
207
220
|
|
|
208
221
|
'opencode': {
|
|
209
222
|
name: 'OpenCode CLI',
|
|
210
223
|
files: [
|
|
211
|
-
{ path: '.opencode.json', desc: 'OpenCode
|
|
212
|
-
{ path: 'AGENTS.md', desc: 'Universal agent manifest' },
|
|
224
|
+
{ path: '.opencode.json', desc: 'OpenCode multi-agent configuration' },
|
|
225
|
+
{ path: 'AGENTS.md', desc: 'Universal agent manifest (auto-referenced)' },
|
|
213
226
|
{ path: '.context/', desc: 'Deep context directory' }
|
|
214
227
|
],
|
|
215
228
|
setup: [
|
|
216
|
-
'1.
|
|
217
|
-
'2.
|
|
218
|
-
'3.
|
|
219
|
-
'4.
|
|
220
|
-
'5.
|
|
229
|
+
'1. Install: npm install -g opencode-ai@latest',
|
|
230
|
+
'2. Or quick install: curl -fsSL https://opencode.ai/install | bash',
|
|
231
|
+
'3. Authenticate: opencode (interactive provider setup)',
|
|
232
|
+
'4. Navigate to your project directory',
|
|
233
|
+
'5. OpenCode reads .opencode.json automatically'
|
|
221
234
|
],
|
|
222
235
|
usage: [
|
|
223
|
-
'• Start
|
|
224
|
-
'•
|
|
225
|
-
'•
|
|
226
|
-
'•
|
|
227
|
-
'
|
|
228
|
-
'
|
|
229
|
-
'
|
|
236
|
+
'• Start session: opencode',
|
|
237
|
+
'• Terminal-based AI coding agent (TUI)',
|
|
238
|
+
'• Supports multiple AI providers (Anthropic, OpenAI, Google, OpenRouter)',
|
|
239
|
+
'• Multi-agent system with specialized agents:',
|
|
240
|
+
' - dev (primary): Senior software engineer',
|
|
241
|
+
' - analyst: Business analyst for requirements',
|
|
242
|
+
' - pm: Product manager for planning',
|
|
243
|
+
' - architect: Solutions architect for design',
|
|
244
|
+
' - qa: QA engineer for testing',
|
|
245
|
+
' - sm: Scrum master for agile workflow',
|
|
246
|
+
'• Configuration schema: https://opencode.ai/config.json',
|
|
247
|
+
'• Auto-loads AGENTS.md and session outputs',
|
|
248
|
+
'• Documentation: https://opencode.ai/docs'
|
|
230
249
|
],
|
|
231
250
|
mcpServers: [
|
|
232
251
|
{
|
|
233
|
-
name: '
|
|
234
|
-
|
|
235
|
-
|
|
252
|
+
name: 'project_filesystem',
|
|
253
|
+
desc: 'Provides project file access via MCP protocol',
|
|
254
|
+
command: 'npx -y @modelcontextprotocol/server-filesystem'
|
|
236
255
|
}
|
|
237
256
|
],
|
|
238
257
|
troubleshooting: [
|
|
239
|
-
'•
|
|
240
|
-
'•
|
|
241
|
-
'•
|
|
242
|
-
'•
|
|
258
|
+
'• Command not found? Restart terminal after install',
|
|
259
|
+
'• Config errors? Validate against: https://opencode.ai/config.json',
|
|
260
|
+
'• Provider auth issues? Run: opencode (interactive setup)',
|
|
261
|
+
'• Check version: opencode --version',
|
|
262
|
+
'• Documentation: https://opencode.ai/docs',
|
|
263
|
+
'• GitHub: https://github.com/anomalyco/opencode/issues'
|
|
243
264
|
]
|
|
244
265
|
},
|
|
245
266
|
|
|
@@ -251,26 +272,26 @@ const TOOL_GUIDES = {
|
|
|
251
272
|
{ path: '.context/', desc: 'Deep context directory' }
|
|
252
273
|
],
|
|
253
274
|
setup: [
|
|
254
|
-
'1. Install Gemini CLI: npm install -g @google/
|
|
255
|
-
'2. Configure API key:
|
|
256
|
-
'3.
|
|
257
|
-
'4.
|
|
275
|
+
'1. Install Gemini CLI: npm install -g @google/gemini-cli',
|
|
276
|
+
'2. Configure API key: gemini auth (interactive setup)',
|
|
277
|
+
'3. Or set manually: export GOOGLE_API_KEY=your_key',
|
|
278
|
+
'4. Navigate to your project directory',
|
|
279
|
+
'5. Start CLI: gemini (not gemini-cli)'
|
|
258
280
|
],
|
|
259
281
|
usage: [
|
|
260
|
-
'• Start session: gemini
|
|
261
|
-
'•
|
|
262
|
-
'• Reference project
|
|
263
|
-
'
|
|
264
|
-
'
|
|
265
|
-
'•
|
|
266
|
-
'• Agent adapts based on your workflow level'
|
|
282
|
+
'• Start session: gemini',
|
|
283
|
+
'• Interactive chat interface with Google Gemini models',
|
|
284
|
+
'• Reference project files: gemini --file path/to/file',
|
|
285
|
+
'• Use GEMINI.md for project context (reference manually)',
|
|
286
|
+
'• Access requirements: "Read .adf/sessions/*/outputs/"',
|
|
287
|
+
'• Documentation: https://geminicli.com'
|
|
267
288
|
],
|
|
268
289
|
mcpServers: [],
|
|
269
290
|
troubleshooting: [
|
|
270
|
-
'•
|
|
271
|
-
'• API key issues?
|
|
272
|
-
'• Check
|
|
273
|
-
'•
|
|
291
|
+
'• Command not found? Verify npm global install path in PATH',
|
|
292
|
+
'• API key issues? Run: gemini auth',
|
|
293
|
+
'• Check installation: gemini --version',
|
|
294
|
+
'• Documentation: https://geminicli.com/docs'
|
|
274
295
|
]
|
|
275
296
|
},
|
|
276
297
|
|
|
@@ -282,24 +303,26 @@ const TOOL_GUIDES = {
|
|
|
282
303
|
{ path: 'AGENTS.md', desc: 'Universal agent manifest' }
|
|
283
304
|
],
|
|
284
305
|
setup: [
|
|
285
|
-
'1. Install
|
|
286
|
-
'2.
|
|
287
|
-
'3.
|
|
288
|
-
'4.
|
|
306
|
+
'1. Install Abacus.ai CLI: npm install -g @abacus-ai/cli',
|
|
307
|
+
'2. Authenticate: abacusai login',
|
|
308
|
+
'3. Navigate to your project directory',
|
|
309
|
+
'4. DeepAgent configurations in .deepagent/ directory',
|
|
310
|
+
'5. Use command: abacusai (not deepagent)'
|
|
289
311
|
],
|
|
290
312
|
usage: [
|
|
291
|
-
'• Start session:
|
|
292
|
-
'•
|
|
293
|
-
'•
|
|
294
|
-
'•
|
|
295
|
-
'•
|
|
313
|
+
'• Start session: abacusai',
|
|
314
|
+
'• Terminal/CLI interface for Abacus.ai platform',
|
|
315
|
+
'• Access DeepAgent features via CLI commands',
|
|
316
|
+
'• Agent markdown files can be referenced manually',
|
|
317
|
+
'• Check available commands: abacusai --help',
|
|
318
|
+
'• Documentation: https://abacus.ai/docs'
|
|
296
319
|
],
|
|
297
320
|
mcpServers: [],
|
|
298
321
|
troubleshooting: [
|
|
299
|
-
'•
|
|
300
|
-
'•
|
|
301
|
-
'• Check
|
|
302
|
-
'•
|
|
322
|
+
'• Command not found? Verify npm global install: npm list -g @abacus-ai/cli',
|
|
323
|
+
'• Authentication issues? Run: abacusai login',
|
|
324
|
+
'• Check CLI version: abacusai --version',
|
|
325
|
+
'• Documentation: https://abacus.ai/docs'
|
|
303
326
|
]
|
|
304
327
|
}
|
|
305
328
|
};
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
const chalk = require('chalk');
|
|
2
|
+
const ToolFeatureRegistry = require('../utils/tool-feature-registry');
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* Tools Audit Command
|
|
6
|
+
* Displays a report of supported tools and their features.
|
|
7
|
+
*/
|
|
8
|
+
async function audit() {
|
|
9
|
+
const report = ToolFeatureRegistry.audit();
|
|
10
|
+
|
|
11
|
+
console.log(chalk.cyan.bold('\n🛠️ ADF Tool Support Audit\n'));
|
|
12
|
+
console.log(chalk.gray(`Total Tools: ${report.totalCount}`));
|
|
13
|
+
console.log(chalk.gray(`Timestamp: ${new Date(report.timestamp).toLocaleString()}\n`));
|
|
14
|
+
|
|
15
|
+
console.log(chalk.white.bold('ID'.padEnd(15)) + chalk.white.bold('Name'.padEnd(20)) + chalk.white.bold('Status'));
|
|
16
|
+
console.log(chalk.gray('─'.repeat(50)));
|
|
17
|
+
|
|
18
|
+
for (const [id, tool] of Object.entries(report.tools)) {
|
|
19
|
+
let statusColor = chalk.green;
|
|
20
|
+
if (tool.status === 'partial') statusColor = chalk.yellow;
|
|
21
|
+
if (tool.status === 'deprecated') statusColor = chalk.red;
|
|
22
|
+
|
|
23
|
+
console.log(
|
|
24
|
+
chalk.cyan(id.padEnd(15)) +
|
|
25
|
+
chalk.white(tool.name.padEnd(20)) +
|
|
26
|
+
statusColor(tool.status)
|
|
27
|
+
);
|
|
28
|
+
|
|
29
|
+
if (tool.features && tool.features.length > 0) {
|
|
30
|
+
console.log(chalk.gray(` Features: ${tool.features.join(', ')}`));
|
|
31
|
+
}
|
|
32
|
+
console.log('');
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
console.log(chalk.yellow('💡 Use "adf deploy <tool>" to configure any of these targets.\n'));
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
module.exports = audit;
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
const ToolConfigGenerator = require('./tool-config-generator');
|
|
2
|
+
const path = require('path');
|
|
3
|
+
const fs = require('fs-extra');
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Generator for Codex CLI
|
|
7
|
+
*/
|
|
8
|
+
class CodexCLIGenerator extends ToolConfigGenerator {
|
|
9
|
+
async generate() {
|
|
10
|
+
await this.initialize();
|
|
11
|
+
await this.ensureDir('.codex');
|
|
12
|
+
|
|
13
|
+
const projectContext = await this.getProjectContext();
|
|
14
|
+
|
|
15
|
+
const config = `# Codex CLI Configuration
|
|
16
|
+
# AgentDevFramework
|
|
17
|
+
|
|
18
|
+
[framework]
|
|
19
|
+
name = "AgentDevFramework"
|
|
20
|
+
version = "1.0.0"
|
|
21
|
+
project = "${projectContext.name}"
|
|
22
|
+
|
|
23
|
+
[project_structure]
|
|
24
|
+
framework = ".adf/"
|
|
25
|
+
docs = "docs/"
|
|
26
|
+
specs = "specs/"
|
|
27
|
+
`;
|
|
28
|
+
|
|
29
|
+
await this.writeToProject('.codex/config.toml', config);
|
|
30
|
+
|
|
31
|
+
const instructions = `# Codex Instructions - ${projectContext.name}
|
|
32
|
+
Follow AgentDevFramework standards for all development.
|
|
33
|
+
Always prioritize TDD and high code coverage.
|
|
34
|
+
`;
|
|
35
|
+
await this.writeToProject('.codex/instructions.md', instructions);
|
|
36
|
+
|
|
37
|
+
return { config: '.codex/config.toml' };
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
module.exports = CodexCLIGenerator;
|
package/lib/generators/index.js
CHANGED
|
@@ -12,6 +12,9 @@ const AntigravityGenerator = require('./antigravity-generator');
|
|
|
12
12
|
const OpenCodeGenerator = require('./opencode-generator');
|
|
13
13
|
const GeminiCLIGenerator = require('./gemini-cli-generator');
|
|
14
14
|
const DeepAgentGenerator = require('./deepagent-generator');
|
|
15
|
+
const KiroGenerator = require('./kiro-generator');
|
|
16
|
+
const TraeGenerator = require('./trae-generator');
|
|
17
|
+
const CodexCLIGenerator = require('./codex-cli-generator');
|
|
15
18
|
const ToolConfigGenerator = require('./tool-config-generator');
|
|
16
19
|
|
|
17
20
|
/**
|
|
@@ -129,6 +132,30 @@ async function generateDeepAgent(sessionPath, projectPath, framework) {
|
|
|
129
132
|
return await generator.generate();
|
|
130
133
|
}
|
|
131
134
|
|
|
135
|
+
/**
|
|
136
|
+
* Generate Kiro configurations
|
|
137
|
+
*/
|
|
138
|
+
async function generateKiro(sessionPath, projectPath, framework) {
|
|
139
|
+
const generator = new KiroGenerator(sessionPath, projectPath, framework);
|
|
140
|
+
return await generator.generate();
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* Generate Trae configurations
|
|
145
|
+
*/
|
|
146
|
+
async function generateTrae(sessionPath, projectPath, framework) {
|
|
147
|
+
const generator = new TraeGenerator(sessionPath, projectPath, framework);
|
|
148
|
+
return await generator.generate();
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* Generate Codex CLI configurations
|
|
153
|
+
*/
|
|
154
|
+
async function generateCodexCLI(sessionPath, projectPath, framework) {
|
|
155
|
+
const generator = new CodexCLIGenerator(sessionPath, projectPath, framework);
|
|
156
|
+
return await generator.generate();
|
|
157
|
+
}
|
|
158
|
+
|
|
132
159
|
module.exports = {
|
|
133
160
|
generateAll,
|
|
134
161
|
generateAgentsMd,
|
|
@@ -140,6 +167,9 @@ module.exports = {
|
|
|
140
167
|
generateOpenCode,
|
|
141
168
|
generateGeminiCLI,
|
|
142
169
|
generateDeepAgent,
|
|
170
|
+
generateKiro,
|
|
171
|
+
generateTrae,
|
|
172
|
+
generateCodexCLI,
|
|
143
173
|
AgentsMdGenerator,
|
|
144
174
|
WindsurfGenerator,
|
|
145
175
|
CursorGenerator,
|
|
@@ -149,5 +179,8 @@ module.exports = {
|
|
|
149
179
|
OpenCodeGenerator,
|
|
150
180
|
GeminiCLIGenerator,
|
|
151
181
|
DeepAgentGenerator,
|
|
182
|
+
KiroGenerator,
|
|
183
|
+
TraeGenerator,
|
|
184
|
+
CodexCLIGenerator,
|
|
152
185
|
ToolConfigGenerator
|
|
153
186
|
};
|