@paths.design/caws-cli 3.1.1 → 3.2.1
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/dist/commands/provenance.d.ts +10 -0
- package/dist/commands/provenance.d.ts.map +1 -1
- package/dist/commands/provenance.js +388 -3
- package/dist/generators/working-spec.js +21 -21
- package/dist/index.js +113 -7
- package/dist/scaffold/git-hooks.d.ts +20 -0
- package/dist/scaffold/git-hooks.d.ts.map +1 -0
- package/dist/scaffold/git-hooks.js +417 -0
- package/dist/scaffold/index.d.ts.map +1 -1
- package/dist/scaffold/index.js +19 -19
- package/package.json +1 -1
- package/dist/index-new.d.ts +0 -5
- package/dist/index-new.d.ts.map +0 -1
- package/dist/index-new.js +0 -317
- package/dist/index.js.backup +0 -4711
- package/templates/apps/tools/caws/prompt-lint.js.backup +0 -274
- package/templates/apps/tools/caws/provenance.js.backup +0 -73
package/dist/index-new.js
DELETED
|
@@ -1,317 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* @fileoverview CAWS CLI - Scaffolding tool for Coding Agent Workflow System
|
|
5
|
-
* Provides commands to initialize new projects and scaffold existing ones with CAWS
|
|
6
|
-
* @author @darianrosebrook
|
|
7
|
-
*/
|
|
8
|
-
|
|
9
|
-
const { Command } = require('commander');
|
|
10
|
-
const fs = require('fs-extra');
|
|
11
|
-
const path = require('path');
|
|
12
|
-
const yaml = require('js-yaml');
|
|
13
|
-
const chalk = require('chalk');
|
|
14
|
-
|
|
15
|
-
// Import configuration and utilities
|
|
16
|
-
const {
|
|
17
|
-
CLI_VERSION,
|
|
18
|
-
initializeGlobalSetup,
|
|
19
|
-
loadProvenanceTools,
|
|
20
|
-
initializeLanguageSupport,
|
|
21
|
-
} = require('./config');
|
|
22
|
-
|
|
23
|
-
// Import command handlers
|
|
24
|
-
const { initProject } = require('./commands/init');
|
|
25
|
-
|
|
26
|
-
// Import scaffold functionality
|
|
27
|
-
const { scaffoldProject, setScaffoldDependencies } = require('./scaffold');
|
|
28
|
-
|
|
29
|
-
// Import validation functionality
|
|
30
|
-
const { validateWorkingSpecWithSuggestions } = require('./validation/spec-validation');
|
|
31
|
-
|
|
32
|
-
// Import finalization utilities
|
|
33
|
-
const {
|
|
34
|
-
finalizeProject,
|
|
35
|
-
continueToSuccess,
|
|
36
|
-
setFinalizationDependencies,
|
|
37
|
-
} = require('./utils/finalization');
|
|
38
|
-
|
|
39
|
-
// Import generators
|
|
40
|
-
const { generateWorkingSpec, validateGeneratedSpec } = require('./generators/working-spec');
|
|
41
|
-
|
|
42
|
-
// Import tool system
|
|
43
|
-
const ToolLoader = require('./tool-loader');
|
|
44
|
-
const ToolValidator = require('./tool-validator');
|
|
45
|
-
|
|
46
|
-
// Initialize global configuration
|
|
47
|
-
const program = new Command();
|
|
48
|
-
|
|
49
|
-
// Initialize global state
|
|
50
|
-
const cawsSetup = initializeGlobalSetup();
|
|
51
|
-
const languageSupport = initializeLanguageSupport();
|
|
52
|
-
|
|
53
|
-
// Set up dependencies for modules that need them
|
|
54
|
-
setScaffoldDependencies({
|
|
55
|
-
cawsSetup,
|
|
56
|
-
loadProvenanceTools,
|
|
57
|
-
});
|
|
58
|
-
|
|
59
|
-
setFinalizationDependencies({
|
|
60
|
-
languageSupport,
|
|
61
|
-
loadProvenanceTools,
|
|
62
|
-
});
|
|
63
|
-
|
|
64
|
-
// Tool system state
|
|
65
|
-
let toolLoader = null;
|
|
66
|
-
let toolValidator = null;
|
|
67
|
-
|
|
68
|
-
/**
|
|
69
|
-
* Initialize tool system
|
|
70
|
-
*/
|
|
71
|
-
async function initializeToolSystem() {
|
|
72
|
-
if (toolLoader) return toolLoader;
|
|
73
|
-
|
|
74
|
-
try {
|
|
75
|
-
toolLoader = new ToolLoader({
|
|
76
|
-
toolsDir: path.join(process.cwd(), 'apps/tools/caws'),
|
|
77
|
-
});
|
|
78
|
-
|
|
79
|
-
toolValidator = new ToolValidator();
|
|
80
|
-
|
|
81
|
-
// Set up event listeners for tool system
|
|
82
|
-
toolLoader.on('discovery:complete', ({ tools: _tools, count }) => {
|
|
83
|
-
if (count > 0) {
|
|
84
|
-
console.log(chalk.blue(`🔧 Discovered ${count} tools`));
|
|
85
|
-
}
|
|
86
|
-
});
|
|
87
|
-
|
|
88
|
-
toolLoader.on('tool:loaded', ({ id, metadata }) => {
|
|
89
|
-
console.log(chalk.gray(` ✓ Loaded tool: ${metadata.name} (${id})`));
|
|
90
|
-
});
|
|
91
|
-
|
|
92
|
-
toolLoader.on('tool:error', ({ id, error }) => {
|
|
93
|
-
console.warn(chalk.yellow(`⚠️ Failed to load tool ${id}: ${error}`));
|
|
94
|
-
});
|
|
95
|
-
|
|
96
|
-
// Auto-discover tools on initialization
|
|
97
|
-
await toolLoader.discoverTools();
|
|
98
|
-
|
|
99
|
-
return toolLoader;
|
|
100
|
-
} catch (error) {
|
|
101
|
-
console.warn(chalk.yellow('⚠️ Tool system initialization failed:'), error.message);
|
|
102
|
-
console.warn(chalk.blue('💡 Continuing without dynamic tools'));
|
|
103
|
-
return null;
|
|
104
|
-
}
|
|
105
|
-
}
|
|
106
|
-
|
|
107
|
-
/**
|
|
108
|
-
* Validate command handler
|
|
109
|
-
*/
|
|
110
|
-
async function validateCommand(specFile, options) {
|
|
111
|
-
try {
|
|
112
|
-
let specPath = specFile || path.join('.caws', 'working-spec.yaml');
|
|
113
|
-
|
|
114
|
-
if (!fs.existsSync(specPath)) {
|
|
115
|
-
console.error(chalk.red(`❌ Spec file not found: ${specPath}`));
|
|
116
|
-
console.error(chalk.blue('💡 Run "caws init" first to create a working spec'));
|
|
117
|
-
process.exit(1);
|
|
118
|
-
}
|
|
119
|
-
|
|
120
|
-
const specContent = fs.readFileSync(specPath, 'utf8');
|
|
121
|
-
const spec = yaml.load(specContent);
|
|
122
|
-
|
|
123
|
-
console.log(chalk.cyan('🔍 Validating CAWS working spec...'));
|
|
124
|
-
|
|
125
|
-
const result = validateWorkingSpecWithSuggestions(spec, {
|
|
126
|
-
autoFix: options.autoFix,
|
|
127
|
-
suggestions: !options.quiet,
|
|
128
|
-
});
|
|
129
|
-
|
|
130
|
-
if (result.valid) {
|
|
131
|
-
console.log(chalk.green('✅ Working spec validation passed'));
|
|
132
|
-
if (!options.quiet) {
|
|
133
|
-
console.log(chalk.gray(` Risk tier: ${spec.risk_tier}`));
|
|
134
|
-
console.log(chalk.gray(` Mode: ${spec.mode}`));
|
|
135
|
-
if (spec.title) {
|
|
136
|
-
console.log(chalk.gray(` Title: ${spec.title}`));
|
|
137
|
-
}
|
|
138
|
-
}
|
|
139
|
-
} else {
|
|
140
|
-
console.log(chalk.red('❌ Working spec validation failed'));
|
|
141
|
-
|
|
142
|
-
// Show errors
|
|
143
|
-
result.errors.forEach((error, index) => {
|
|
144
|
-
console.log(` ${index + 1}. ${chalk.red(error.message)}`);
|
|
145
|
-
if (error.suggestion) {
|
|
146
|
-
console.log(` ${chalk.blue('💡 ' + error.suggestion)}`);
|
|
147
|
-
}
|
|
148
|
-
});
|
|
149
|
-
|
|
150
|
-
// Show warnings
|
|
151
|
-
if (result.warnings && result.warnings.length > 0) {
|
|
152
|
-
console.log(chalk.yellow('\n⚠️ Warnings:'));
|
|
153
|
-
result.warnings.forEach((warning, index) => {
|
|
154
|
-
console.log(` ${index + 1}. ${chalk.yellow(warning.message)}`);
|
|
155
|
-
});
|
|
156
|
-
}
|
|
157
|
-
|
|
158
|
-
process.exit(1);
|
|
159
|
-
}
|
|
160
|
-
} catch (error) {
|
|
161
|
-
console.error(chalk.red('❌ Error during validation:'), error.message);
|
|
162
|
-
process.exit(1);
|
|
163
|
-
}
|
|
164
|
-
}
|
|
165
|
-
|
|
166
|
-
/**
|
|
167
|
-
* Tool execution command handler
|
|
168
|
-
*/
|
|
169
|
-
async function executeTool(toolId, options) {
|
|
170
|
-
try {
|
|
171
|
-
// Initialize tool system
|
|
172
|
-
const loader = await initializeToolSystem();
|
|
173
|
-
|
|
174
|
-
if (!loader) {
|
|
175
|
-
console.error(chalk.red('❌ Tool system not available'));
|
|
176
|
-
process.exit(1);
|
|
177
|
-
}
|
|
178
|
-
|
|
179
|
-
// Load all tools first
|
|
180
|
-
await loader.loadAllTools();
|
|
181
|
-
const tool = loader.getTool(toolId);
|
|
182
|
-
|
|
183
|
-
if (!tool) {
|
|
184
|
-
console.error(chalk.red(`❌ Tool '${toolId}' not found`));
|
|
185
|
-
console.log(chalk.blue('💡 Available tools:'));
|
|
186
|
-
const tools = loader.getAllTools();
|
|
187
|
-
for (const [id, t] of tools) {
|
|
188
|
-
console.log(` - ${id}: ${t.metadata.name}`);
|
|
189
|
-
}
|
|
190
|
-
process.exit(1);
|
|
191
|
-
}
|
|
192
|
-
|
|
193
|
-
// Validate tool before execution
|
|
194
|
-
const validation = await toolValidator.validateTool(tool);
|
|
195
|
-
if (!validation.valid) {
|
|
196
|
-
console.error(chalk.red('❌ Tool validation failed:'));
|
|
197
|
-
validation.errors.forEach((error) => {
|
|
198
|
-
console.error(` ${chalk.red('✗')} ${error}`);
|
|
199
|
-
});
|
|
200
|
-
process.exit(1);
|
|
201
|
-
}
|
|
202
|
-
|
|
203
|
-
// Parse parameters
|
|
204
|
-
let params = {};
|
|
205
|
-
if (options.params) {
|
|
206
|
-
try {
|
|
207
|
-
params = JSON.parse(options.params);
|
|
208
|
-
} catch (error) {
|
|
209
|
-
console.error(chalk.red('❌ Invalid JSON parameters:'), error.message);
|
|
210
|
-
process.exit(1);
|
|
211
|
-
}
|
|
212
|
-
}
|
|
213
|
-
|
|
214
|
-
console.log(chalk.blue(`🚀 Executing tool: ${tool.metadata.name}`));
|
|
215
|
-
|
|
216
|
-
// Execute tool
|
|
217
|
-
const result = await tool.module.execute(params, {
|
|
218
|
-
workingDirectory: process.cwd(),
|
|
219
|
-
timeout: options.timeout,
|
|
220
|
-
});
|
|
221
|
-
|
|
222
|
-
// Display results
|
|
223
|
-
if (result.success) {
|
|
224
|
-
console.log(chalk.green('✅ Tool execution successful'));
|
|
225
|
-
if (result.output && typeof result.output === 'object') {
|
|
226
|
-
console.log(chalk.gray('Output:'), JSON.stringify(result.output, null, 2));
|
|
227
|
-
}
|
|
228
|
-
} else {
|
|
229
|
-
console.error(chalk.red('❌ Tool execution failed'));
|
|
230
|
-
result.errors.forEach((error) => {
|
|
231
|
-
console.error(` ${chalk.red('✗')} ${error}`);
|
|
232
|
-
});
|
|
233
|
-
process.exit(1);
|
|
234
|
-
}
|
|
235
|
-
} catch (error) {
|
|
236
|
-
console.error(chalk.red(`❌ Error executing tool ${toolId}:`), error.message);
|
|
237
|
-
process.exit(1);
|
|
238
|
-
}
|
|
239
|
-
}
|
|
240
|
-
|
|
241
|
-
// Setup CLI program
|
|
242
|
-
program.name('caws').description('CAWS - Coding Agent Workflow System CLI').version(CLI_VERSION);
|
|
243
|
-
|
|
244
|
-
// Init command
|
|
245
|
-
program
|
|
246
|
-
.command('init')
|
|
247
|
-
.description('Initialize a new project with CAWS')
|
|
248
|
-
.argument('[project-name]', 'Name of the project to create (use "." for current directory)')
|
|
249
|
-
.option('-i, --interactive', 'Run interactive setup wizard', true)
|
|
250
|
-
.option('--non-interactive', 'Skip interactive prompts (use defaults)', false)
|
|
251
|
-
.option('--template <template>', 'Use specific project template')
|
|
252
|
-
.action(initProject);
|
|
253
|
-
|
|
254
|
-
// Scaffold command
|
|
255
|
-
program
|
|
256
|
-
.command('scaffold')
|
|
257
|
-
.description('Add CAWS components to existing project')
|
|
258
|
-
.option('-f, --force', 'Overwrite existing files', false)
|
|
259
|
-
.option('--minimal', 'Only essential components', false)
|
|
260
|
-
.option('--with-codemods', 'Include codemod scripts', false)
|
|
261
|
-
.option('--with-oidc', 'Include OIDC trusted publisher setup', false)
|
|
262
|
-
.action(scaffoldProject);
|
|
263
|
-
|
|
264
|
-
// Validate command
|
|
265
|
-
program
|
|
266
|
-
.command('validate')
|
|
267
|
-
.description('Validate CAWS working spec with suggestions')
|
|
268
|
-
.argument('[spec-file]', 'Path to working spec file (default: .caws/working-spec.yaml)')
|
|
269
|
-
.option('-q, --quiet', 'Suppress suggestions and warnings', false)
|
|
270
|
-
.option('--auto-fix', 'Automatically fix safe validation issues', false)
|
|
271
|
-
.action(validateCommand);
|
|
272
|
-
|
|
273
|
-
// Tool command
|
|
274
|
-
program
|
|
275
|
-
.command('tool')
|
|
276
|
-
.description('Execute CAWS tools programmatically')
|
|
277
|
-
.argument('<tool-id>', 'ID of the tool to execute')
|
|
278
|
-
.option('-p, --params <json>', 'Parameters as JSON string', '{}')
|
|
279
|
-
.option('-t, --timeout <ms>', 'Execution timeout in milliseconds', parseInt, 30000)
|
|
280
|
-
.action(executeTool);
|
|
281
|
-
|
|
282
|
-
// Error handling
|
|
283
|
-
program.exitOverride((err) => {
|
|
284
|
-
if (
|
|
285
|
-
err.code === 'commander.help' ||
|
|
286
|
-
err.code === 'commander.version' ||
|
|
287
|
-
err.message.includes('outputHelp')
|
|
288
|
-
) {
|
|
289
|
-
process.exit(0);
|
|
290
|
-
}
|
|
291
|
-
console.error(chalk.red('❌ Error:'), err.message);
|
|
292
|
-
process.exit(1);
|
|
293
|
-
});
|
|
294
|
-
|
|
295
|
-
// Parse and run
|
|
296
|
-
if (require.main === module) {
|
|
297
|
-
try {
|
|
298
|
-
program.parse();
|
|
299
|
-
} catch (error) {
|
|
300
|
-
if (
|
|
301
|
-
error.code === 'commander.help' ||
|
|
302
|
-
error.code === 'commander.version' ||
|
|
303
|
-
error.message.includes('outputHelp')
|
|
304
|
-
) {
|
|
305
|
-
process.exit(0);
|
|
306
|
-
} else {
|
|
307
|
-
console.error(chalk.red('❌ Error:'), error.message);
|
|
308
|
-
process.exit(1);
|
|
309
|
-
}
|
|
310
|
-
}
|
|
311
|
-
}
|
|
312
|
-
|
|
313
|
-
// Export functions for testing
|
|
314
|
-
module.exports = {
|
|
315
|
-
generateWorkingSpec,
|
|
316
|
-
validateGeneratedSpec,
|
|
317
|
-
};
|