@sungen/driver-api 3.1.2-beta.114 → 3.1.2-beta.116

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sungen/driver-api",
-  "version": "3.1.2-beta.114",
+  "version": "3.1.2-beta.116",
   "description": "Sungen API capability — the @api annotation, API catalog, OpenAPI import + `sungen api import`, and the specs/api.ts runtime template. Plugs into @sun-asterisk/sungen via the capability SPI.",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -13,7 +13,7 @@
   "author": "eqe team (engineer & quality) — Sun Asterisk",
   "license": "MIT",
   "dependencies": {
-    "@sun-asterisk/sungen": "3.1.2-beta.114",
+    "@sun-asterisk/sungen": "3.1.2-beta.116",
     "commander": "^14.0.2",
     "yaml": "^2.8.2"
   },

package/src/api-catalog.ts

@@ -52,7 +52,9 @@ const _cache = new Map<string, LoadedApiCatalog>();
 export function findApiCatalogFiles(screenName: string, cwd: string = process.cwd()): ApiCatalogFiles {
   const out: ApiCatalogFiles = {};
   if (!screenName) return out;
-  const screenDir = screenName.startsWith('flows/')
+  // `screenName` is a unit id relative to qa/: `<screen>` (→ qa/screens/<screen>), `flows/<flow>`,
+  // or an api-first unit `api/<area>` / `api/flows/<flow>` (→ qa/<screenName>).
+  const screenDir = screenName.startsWith('flows/') || screenName.startsWith('api/')
     ? path.join(cwd, 'qa', screenName)
     : path.join(cwd, 'qa', 'screens', screenName);
   const screenFile = path.join(screenDir, 'api', 'apis.yaml');

package/src/cli-import.ts

@@ -157,20 +157,29 @@ export function registerApiCommand(program: Command): void {
           writeCatalog(f, entries, !!opts.merge);
           written.push(rel(f));
         } else {
-          // group by area → qa/api/<area>/api/apis.yaml
+          // group by area → qa/api/<area>/api/apis.yaml + a runnable contract-scenario stub.
           const byArea: Record<string, Record<string, ImportedApiEntry>> = {};
           for (const [name, e] of Object.entries(entries)) (byArea[e.area || 'root'] ||= {})[name] = e;
           for (const [area, group] of Object.entries(byArea)) {
             const f = path.join(process.cwd(), 'qa', 'api', area, 'api', 'apis.yaml');
             writeCatalog(f, group, !!opts.merge);
             written.push(`${rel(f)} (${Object.keys(group).length})`);
+            // Scaffold the feature so `sungen generate --api <area>` has something to compile — one
+            // happy-path contract scenario per endpoint (the 70% baseline). Don't clobber edits.
+            const featFile = path.join(process.cwd(), 'qa', 'api', area, 'features', `${area}.feature`);
+            if (!fs.existsSync(featFile)) {
+              fs.mkdirSync(path.dirname(featFile), { recursive: true });
+              fs.writeFileSync(featFile, importedFeatureStub(area, group));
+              written.push(`${rel(featFile)} (${Object.keys(group).length} contract scenario(s))`);
+            }
           }
         }
 
         console.log(`\n✓ Imported ${count} endpoint(s) from ${kind} source:`);
         for (const w of written) console.log(`   → ${w}`);
         if (skipped.length) console.log(`\n⚠ Skipped: ${skipped.slice(0, 10).join('; ')}${skipped.length > 10 ? ` … (+${skipped.length - 10})` : ''}`);
-        console.log('\nNext: wire the `datasource` base_url + auth in datasources.yaml, then `@api:<name>` in a scenario.\n');
+        console.log('\nNext: wire the `datasource` base_url + auth in datasources.yaml, refine the scenarios,');
+        console.log('then `sungen generate --api <area>` → `npx playwright test`.\n');
       } catch (e) { fail(e); }
     });
 }
@@ -183,6 +192,29 @@ function upsertEnv(file: string, key: string, value: string): void {
   fs.writeFileSync(file, content.replace(/\n?$/, '\n') + line + '\n');
 }
 
+/** A runnable feature from imported endpoints: one happy-path contract scenario each (the 70% baseline). */
+function importedFeatureStub(area: string, group: Record<string, ImportedApiEntry>): string {
+  const lines = [
+    `@parallel @area:${area}`,
+    `Feature: ${area} API`,
+    '',
+    '  # Auto-scaffolded from the imported catalog — one contract check per endpoint. Refine these:',
+    '  # add error cases with @cases, flows with ordered @api tags, idempotency with @concurrent:N.',
+    '  # `sungen audit` flags missing error/idempotency coverage on mutating endpoints.',
+    '',
+  ];
+  let i = 1;
+  for (const [name, e] of Object.entries(group)) {
+    const status = e.expect?.status ?? 200;
+    const seq = String(i++).padStart(3, '0');
+    lines.push(`  @high @api:${name}`);
+    lines.push(`  Scenario: VP-API-${seq} ${e.method} ${e.path} returns ${status}`);
+    lines.push(`    Then expect {{${name}.status}} is ${status}`);
+    lines.push('');
+  }
+  return lines.join('\n');
+}
+
 function featureStub(area: string): string {
   return [
     `@area:${area}`,