@zigrivers/scaffold 3.16.0 → 3.18.0

package/dist/e2e/service-manifest.test.js

@@ -0,0 +1,166 @@
+/**
+ * E2E smoke test: scaffold init --from <nibble.yml>
+ *
+ * Proves the full declarative init path works end-to-end with a 5-service
+ * manifest shaped like a real multi-service project (nibble). The test uses
+ * a real tmpdir and calls initCommand.handler directly — no mocking of the
+ * modules under test.
+ *
+ * External collaborators that are NOT mocked (real behaviour verified):
+ *   - materializeScaffoldProject
+ *   - StateManager / initializeState
+ *   - ConfigSchema.parse (round-trip normalization)
+ *
+ * Mocked (to keep the test hermetic in CI):
+ *   - runBuild — requires built pipeline artifacts; mocked to exit 0 + empty data
+ *   - syncSkillsIfNeeded — requires .claude-plugin; mocked best-effort no-op
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { parse as parseYaml } from 'yaml';
+import { ConfigSchema } from '../config/schema.js';
+// ---------------------------------------------------------------------------
+// Hoisted mocks — must be declared before real imports
+// ---------------------------------------------------------------------------
+vi.mock('../cli/commands/build.js', () => ({
+    runBuild: vi.fn().mockResolvedValue({
+        exitCode: 0,
+        data: {
+            stepsTotal: 0,
+            stepsEnabled: 0,
+            platforms: ['claude-code'],
+            generatedFiles: 0,
+            buildTimeMs: 1,
+        },
+    }),
+    default: {
+        handler: vi.fn().mockResolvedValue(undefined),
+    },
+}));
+vi.mock('../core/skills/sync.js', () => ({
+    syncSkillsIfNeeded: vi.fn(),
+}));
+// ---------------------------------------------------------------------------
+// Real imports (after mock declarations)
+// ---------------------------------------------------------------------------
+import initCommand from '../cli/commands/init.js';
+import runCommand from '../cli/commands/run.js';
+// ---------------------------------------------------------------------------
+// Nibble-shaped 5-service manifest
+// ---------------------------------------------------------------------------
+const nibbleManifest = `version: 2
+methodology: deep
+platforms: [claude-code]
+project:
+  services:
+    - name: strategy-evaluator
+      projectType: library
+      libraryConfig:
+        visibility: internal
+        documentationLevel: api-docs
+      path: shared/strategy_evaluator
+    - name: research-engine
+      projectType: backend
+      backendConfig:
+        apiStyle: rest
+        dataStore: [relational]
+        authMechanism: apikey
+        asyncMessaging: none
+        deployTarget: container
+        domain: fintech
+      path: services/research
+    - name: backtesting-engine
+      projectType: backend
+      backendConfig:
+        apiStyle: rest
+        dataStore: [relational]
+        authMechanism: apikey
+        asyncMessaging: none
+        deployTarget: container
+        domain: fintech
+      path: services/backtesting
+    - name: trading-bot
+      projectType: backend
+      backendConfig:
+        apiStyle: rest
+        dataStore: [relational]
+        authMechanism: oauth
+        asyncMessaging: event-driven
+        deployTarget: container
+        domain: fintech
+      path: services/trading-bot
+    - name: dashboard
+      projectType: web-app
+      webAppConfig:
+        renderingStrategy: ssr
+        deployTarget: container
+        realtime: websocket
+        authFlow: oauth
+      path: apps/dashboard
+`;
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('E2E: scaffold init --from <nibble.yml>', () => {
+    let root;
+    let manifestPath;
+    beforeEach(() => {
+        root = fs.mkdtempSync(path.join(os.tmpdir(), 'e2e-nibble-'));
+        manifestPath = path.join(root, 'services.yml');
+        fs.writeFileSync(manifestPath, nibbleManifest, 'utf-8');
+        process.exitCode = 0;
+        vi.spyOn(process, 'exit').mockImplementation((() => { }));
+        vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        vi.spyOn(process.stderr, 'write').mockImplementation(() => true);
+    });
+    afterEach(() => {
+        fs.rmSync(root, { recursive: true, force: true });
+        vi.restoreAllMocks();
+        process.exitCode = undefined;
+    });
+    it('materializes a nibble-shaped multi-service project', async () => {
+        // Phase 1: scaffold init --from services.yml --root <tmpdir> --auto
+        await initCommand.handler({
+            _: [],
+            $0: 'scaffold',
+            from: manifestPath,
+            root,
+            auto: true,
+            force: false,
+            format: undefined,
+            verbose: false,
+        });
+        const configPath = path.join(root, '.scaffold', 'config.yml');
+        const statePath = path.join(root, '.scaffold', 'state.json');
+        const decisionsPath = path.join(root, '.scaffold', 'decisions.jsonl');
+        // All three scaffold files must exist
+        expect(fs.existsSync(configPath)).toBe(true);
+        expect(fs.existsSync(statePath)).toBe(true);
+        expect(fs.existsSync(decisionsPath)).toBe(true);
+        // Config round-trips through Zod normalization: what was written equals
+        // ConfigSchema.parse(input) — defaults filled in, structure normalized.
+        const parsedWritten = parseYaml(fs.readFileSync(configPath, 'utf8'));
+        const parsedInput = parseYaml(nibbleManifest);
+        const normalizedInput = ConfigSchema.parse(parsedInput);
+        expect(parsedWritten).toEqual(normalizedInput);
+        // State emits schema-version 2 because services[] is present.
+        const state = JSON.parse(fs.readFileSync(statePath, 'utf8'));
+        expect(state['schema-version']).toBe(2);
+        // decisions.jsonl is empty (current behavior preserved).
+        expect(fs.readFileSync(decisionsPath, 'utf8')).toBe('');
+        // Phase 2: scaffold run implementation-plan (a per-service step) should
+        // exit 2 because no --service flag is provided. Global steps like
+        // create-prd now run without --service; per-service steps require it.
+        process.exitCode = 0;
+        await runCommand.handler({
+            root,
+            _: ['implementation-plan'],
+            step: 'implementation-plan',
+            $0: 'scaffold',
+        });
+        expect(process.exitCode).toBe(2);
+    });
+});
+//# sourceMappingURL=service-manifest.test.js.map

package/dist/e2e/service-manifest.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-manifest.test.js","sourceRoot":"","sources":["../../src/e2e/service-manifest.test.ts"],"names":[],"mappings":"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"}