delimit-cli 2.1.1 → 2.2.0

package/bin/delimit-cli.js

@@ -783,20 +783,66 @@ rules: []
     });
 
 // Lint command — diff + policy (primary command)
+// Supports zero-spec mode: `delimit lint` (no args) auto-extracts from FastAPI
 program
-    .command('lint <old_spec> <new_spec>')
+    .command('lint [old_spec] [new_spec]')
     .description('Lint API specs for breaking changes and policy violations')
     .option('-p, --policy <file>', 'Custom policy file')
     .option('--current-version <ver>', 'Current API version for semver bump')
     .option('-n, --name <name>', 'API name for context')
     .option('--json', 'Output raw JSON')
+    .option('-d, --dir <path>', 'Project directory for zero-spec mode', '.')
     .action(async (oldSpec, newSpec, options) => {
         try {
-            const result = apiEngine.lint(
-                path.resolve(oldSpec),
-                path.resolve(newSpec),
-                { policy: options.policy, version: options.currentVersion, name: options.name }
-            );
+            let result;
+
+            if (!oldSpec || !newSpec) {
+                // Zero-spec mode: extract from framework source
+                console.log(chalk.gray('No spec files provided — detecting framework...'));
+                const zeroResult = apiEngine.zeroSpec(path.resolve(options.dir));
+
+                if (!zeroResult.success) {
+                    console.error(chalk.red(`\n  ${zeroResult.error}\n`));
+                    if (zeroResult.error_type === 'no_framework') {
+                        console.log('  Usage: delimit lint <old_spec> <new_spec>');
+                        console.log('  Or run from a FastAPI project directory.\n');
+                    }
+                    process.exit(1);
+                    return;
+                }
+
+                console.log(chalk.green(`  ${zeroResult.message}`));
+                console.log(`  Extracted: ${zeroResult.paths_count} paths, ${zeroResult.schemas_count} schemas`);
+                console.log(`  Spec: ${zeroResult.spec_path}\n`);
+
+                // Check for baseline
+                const baselineDir = path.join(path.resolve(options.dir), '.delimit');
+                const baselinePath = path.join(baselineDir, 'baseline.yaml');
+
+                if (!fs.existsSync(baselinePath)) {
+                    // First run: save baseline
+                    fs.mkdirSync(baselineDir, { recursive: true });
+                    const yaml = require('js-yaml');
+                    fs.writeFileSync(baselinePath, yaml.dump(zeroResult.spec));
+                    console.log(chalk.green('  Saved baseline to .delimit/baseline.yaml'));
+                    console.log('  Run again after making changes to see the diff.\n');
+                    process.exit(0);
+                    return;
+                }
+
+                // Compare against baseline
+                result = apiEngine.lint(
+                    baselinePath,
+                    zeroResult.spec_path,
+                    { policy: options.policy, version: options.currentVersion, name: options.name }
+                );
+            } else {
+                result = apiEngine.lint(
+                    path.resolve(oldSpec),
+                    path.resolve(newSpec),
+                    { policy: options.policy, version: options.currentVersion, name: options.name }
+                );
+            }
 
             if (options.json) {
                 console.log(JSON.stringify(result, null, 2));

package/lib/api-engine.js

@@ -153,4 +153,42 @@ function semver(oldSpec, newSpec, currentVersion) {
     ].join('\n'));
 }
 
-module.exports = { lint, diff, explain, semver, GATEWAY_ROOT };
+/**
+ * delimit zero-spec — extract OpenAPI from framework source code
+ */
+function zeroSpec(projectDir, opts = {}) {
+    const args = [];
+    if (opts.pythonBin) args.push(`python_bin=${pyStr(opts.pythonBin)}`);
+
+    return runGateway([
+        'import json, sys',
+        'sys.path.insert(0, ".")',
+        'from core.zero_spec.detector import detect_framework, Framework',
+        'from core.zero_spec.fastapi_extractor import extract_fastapi_spec',
+        'from core.zero_spec.nestjs_extractor import extract_nestjs_spec',
+        'from core.zero_spec.express_extractor import extract_express_spec',
+        `info = detect_framework(${pyStr(projectDir)})`,
+        'r = {"framework": info.framework.value, "confidence": info.confidence, "message": info.message}',
+        'if info.framework == Framework.FASTAPI:',
+        `    ext = extract_fastapi_spec(info, ${pyStr(projectDir)}${opts.pythonBin ? `, python_bin=${pyStr(opts.pythonBin)}` : ''})`,
+        '    r.update(ext)',
+        '    if ext.get("success") and info.app_locations:',
+        '        r["app_file"] = info.app_locations[0].file',
+        'elif info.framework == Framework.NESTJS:',
+        `    ext = extract_nestjs_spec(info, ${pyStr(projectDir)})`,
+        '    r.update(ext)',
+        '    if ext.get("success") and info.app_locations:',
+        '        r["app_file"] = info.app_locations[0].file',
+        'elif info.framework == Framework.EXPRESS:',
+        `    ext = extract_express_spec(info, ${pyStr(projectDir)})`,
+        '    r.update(ext)',
+        '    if ext.get("success") and info.app_locations:',
+        '        r["app_file"] = info.app_locations[0].file',
+        'else:',
+        '    r["success"] = False',
+        '    r["error"] = "No supported API framework detected"',
+        'print(json.dumps(r, default=str))',
+    ].join('\n'));
+}
+
+module.exports = { lint, diff, explain, semver, zeroSpec, GATEWAY_ROOT };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "delimit-cli",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "ESLint for API contracts — detect breaking changes, enforce semver, and generate migration guides for OpenAPI specs",
   "main": "index.js",
   "bin": {