@ngocsangairvds/vsaf 4.0.16 → 4.1.0

package/packages/core/dist/store/wal.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WAL = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const atomic_js_1 = require("./atomic.js");
+const types_js_1 = require("./types.js");
+const OUTPUT_THRESHOLD = 4096;
+class WAL {
+    walPath;
+    runDir;
+    seq;
+    outputDirCreated = false;
+    cachedContent = null;
+    constructor(runDir) {
+        this.runDir = runDir;
+        this.walPath = (0, path_1.join)(runDir, 'wal.jsonl');
+        (0, fs_1.mkdirSync)(runDir, { recursive: true });
+        this.seq = this.loadLastSeq();
+    }
+    get currentSeq() {
+        return this.seq;
+    }
+    append(partial) {
+        const nextSeq = this.seq + 1;
+        const event = {
+            seq: nextSeq,
+            ts: new Date().toISOString(),
+            ...partial,
+        };
+        const line = JSON.stringify(event) + '\n';
+        try {
+            (0, fs_1.appendFileSync)(this.walPath, line, { encoding: 'utf-8', mode: 0o600 });
+        }
+        catch (err) {
+            const e = err;
+            if (e.code === 'ENOSPC') {
+                throw new types_js_1.StorageError('Disk full — cannot append WAL', 'DISK_FULL', this.walPath, e);
+            }
+            throw e;
+        }
+        this.cachedContent = null; // Invalidate cache — file content changed
+        this.seq = nextSeq;
+        return event;
+    }
+    ensureOutputDir() {
+        if (!this.outputDirCreated) {
+            (0, fs_1.mkdirSync)((0, path_1.join)(this.runDir, 'outputs'), { recursive: true });
+            this.outputDirCreated = true;
+        }
+    }
+    readWALContent() {
+        if (!(0, fs_1.existsSync)(this.walPath))
+            return null;
+        const content = (0, atomic_js_1.safeReadSync)(this.walPath);
+        if (content instanceof types_js_1.StorageError)
+            return null;
+        return content;
+    }
+    replay(afterSeq = 0) {
+        const content = this.cachedContent ?? this.readWALContent();
+        this.cachedContent = null; // Free after use
+        if (!content)
+            return [];
+        const events = [];
+        for (const line of content.split('\n')) {
+            if (!line.trim())
+                continue;
+            try {
+                const event = JSON.parse(line);
+                if (event.seq > afterSeq) {
+                    events.push(event);
+                }
+            }
+            catch {
+                // Skip corrupt lines (spec: replay partial)
+                continue;
+            }
+        }
+        return events;
+    }
+    persistOutput(nodeId, output) {
+        if (output.length <= OUTPUT_THRESHOLD)
+            return output;
+        const refPath = `outputs/${nodeId}.txt`;
+        this.ensureOutputDir();
+        (0, atomic_js_1.atomicWriteSync)((0, path_1.join)(this.runDir, refPath), output);
+        return { __vsaf_ref: refPath };
+    }
+    persistStructuredOutput(nodeId, data) {
+        const json = JSON.stringify(data);
+        if (json.length <= OUTPUT_THRESHOLD)
+            return data;
+        const refPath = `outputs/${nodeId}.json`;
+        this.ensureOutputDir();
+        (0, atomic_js_1.atomicWriteSync)((0, path_1.join)(this.runDir, refPath), json);
+        return { __vsaf_ref: refPath };
+    }
+    getOutputRef(nodeId, output) {
+        if (output.length <= OUTPUT_THRESHOLD)
+            return output;
+        return { __vsaf_ref: `outputs/${nodeId}.txt` };
+    }
+    getStructuredOutputRef(nodeId, data) {
+        const json = JSON.stringify(data);
+        if (json.length <= OUTPUT_THRESHOLD)
+            return data;
+        return { __vsaf_ref: `outputs/${nodeId}.json` };
+    }
+    resolveOutput(stored) {
+        if (typeof stored === 'string')
+            return stored;
+        const refPath = '__vsaf_ref' in stored ? stored.__vsaf_ref : stored.ref;
+        const content = (0, atomic_js_1.safeReadSync)((0, path_1.join)(this.runDir, refPath));
+        if (content instanceof types_js_1.StorageError) {
+            console.error(`[WAL] Warning: output file missing: ${refPath}`);
+            return '';
+        }
+        return content;
+    }
+    resolveStructuredOutput(stored) {
+        // Check for new sentinel first
+        if ('__vsaf_ref' in stored) {
+            const refPath = stored.__vsaf_ref;
+            const content = (0, atomic_js_1.safeReadSync)((0, path_1.join)(this.runDir, refPath));
+            if (content instanceof types_js_1.StorageError) {
+                console.error(`[WAL] Warning: structured output file missing: ${refPath}`);
+                return {};
+            }
+            try {
+                return JSON.parse(content);
+            }
+            catch {
+                console.error(`[WAL] Warning: corrupted structured output: ${refPath}`);
+                return {};
+            }
+        }
+        // Legacy sentinel: { ref: string } with exactly one key
+        if ('ref' in stored && typeof stored.ref === 'string' && Object.keys(stored).length === 1) {
+            const refPath = stored.ref;
+            if (!refPath.startsWith('outputs/')) {
+                return stored;
+            }
+            const content = (0, atomic_js_1.safeReadSync)((0, path_1.join)(this.runDir, refPath));
+            if (content instanceof types_js_1.StorageError) {
+                console.error(`[WAL] Warning: structured output file missing: ${refPath}`);
+                return {};
+            }
+            try {
+                return JSON.parse(content);
+            }
+            catch {
+                console.error(`[WAL] Warning: corrupted structured output: ${refPath}`);
+                return {};
+            }
+        }
+        return stored;
+    }
+    loadLastSeq() {
+        const content = this.readWALContent();
+        if (!content)
+            return 0;
+        this.cachedContent = content; // Cache for subsequent replay()
+        const lines = content.trim().split('\n').filter(Boolean);
+        if (lines.length === 0)
+            return 0;
+        // Read last valid line
+        for (let i = lines.length - 1; i >= 0; i--) {
+            try {
+                const event = JSON.parse(lines[i]);
+                return event.seq;
+            }
+            catch {
+                continue;
+            }
+        }
+        return 0;
+    }
+    static hasTerminalAfter(runDir, afterSeq) {
+        const walPath = (0, path_1.join)(runDir, 'wal.jsonl');
+        if (!(0, fs_1.existsSync)(walPath))
+            return false;
+        const content = (0, atomic_js_1.safeReadSync)(walPath);
+        if (content instanceof types_js_1.StorageError)
+            return false;
+        for (const line of content.split('\n')) {
+            if (!line.trim())
+                continue;
+            try {
+                const event = JSON.parse(line);
+                if (event.seq > afterSeq && (event.type === 'run:complete' || event.type === 'run:fail')) {
+                    return true;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return false;
+    }
+}
+exports.WAL = WAL;
+//# sourceMappingURL=wal.js.map

package/packages/core/dist/store/wal.js.map

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

package/packages/core/dist/types/dag.d.ts

@@ -2,6 +2,7 @@ import type { ErrorStrategy, OutputFormat, InputParamDef } from './workflow.js';
 export type NodeStatus = 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
 export interface DAGNode {
     id: string;
+    description?: string;
     type: 'prompt' | 'bash' | 'command';
     content: string;
     dependsOn: string[];
@@ -17,7 +18,9 @@ export interface DAGNode {
     structuredOutput?: Record<string, unknown>;
     durationMs?: number;
     error?: string;
+    idempotent: boolean;
     errorStrategy: ErrorStrategy;
+    timeout?: number;
     loop?: {
         onFail: string;
         maxRetries: number;

package/packages/core/dist/types/dag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../../src/types/dag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEhF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpF,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,aAAa,GAAG,aAAa,CAAC;IAC3C,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"dag.d.ts","sourceRoot":"","sources":["../../src/types/dag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEhF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpF,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,aAAa,GAAG,aAAa,CAAC;IAC3C,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B"}

package/packages/core/dist/types/workflow.d.ts

@@ -22,6 +22,7 @@ export interface LoopConfig {
 }
 export interface NodeDefinition {
     id: string;
+    description?: string;
     prompt?: string;
     bash?: string;
     command?: string;
@@ -35,12 +36,14 @@ export interface NodeDefinition {
     workspace?: boolean;
     loop?: LoopConfig;
     on_error?: ErrorStrategy;
+    idempotent?: boolean;
+    timeout?: number;
 }
 export interface WorkflowDefinition {
     name: string;
-    description: string;
-    provider: string;
-    model: string;
+    description?: string;
+    provider?: string;
+    model?: string;
     inputs?: Record<string, InputParamDef>;
     nodes: NodeDefinition[];
 }

package/packages/core/dist/types/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/types/workflow.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,eAAe,GAAG,UAAU,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/types/workflow.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,eAAe,GAAG,UAAU,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB"}

package/skills/sdlc/workflows/hotfix-tdd.yaml

@@ -3,14 +3,17 @@ description: "Sub-flow: TDD RED → GREEN → Test Gate — write failing test,
 
 nodes:
   - id: red
+    description: "RED: write failing test that reproduces the bug"
     command: sdlc-hotfix-red
     depends_on: []
 
   - id: green
+    description: "GREEN: implement minimal fix to make the test pass"
     command: sdlc-hotfix-green
     depends_on: [red]
 
   - id: test-gate
+    description: "Test Gate: run full test suite to verify fix and catch regressions"
     bash: |
       cd $WORKSPACE && npm test 2>&1
     depends_on: [green]

package/skills/sdlc/workflows/master-sdlc.yaml

@@ -2,28 +2,35 @@ name: master-sdlc
 description: "Full SDLC pipeline — Discovery → PRD → Architecture → SRS → Test Design → Implement → Review → Feature Complete → Ship"
 nodes:
   - id: discovery
+    description: "Phase 1 — Discovery: analyze requirements, grill stakeholders, brainstorm solutions"
     command: sdlc-discovery
     workspace: false
   - id: prd
+    description: "Phase 2 — PRD: write Product Requirements Document from discovery output"
     command: sdlc-prd
     depends_on: [discovery]
     workspace: false
   - id: architecture
+    description: "Phase 3 — Architecture: design solution architecture and write ADR + epic breakdown"
     command: sdlc-architecture
     depends_on: [prd]
     workspace: false
   - id: srs
+    description: "Phase 4 — SRS: write Software Requirements Specification with API contracts"
     command: sdlc-srs
     depends_on: [architecture]
     workspace: false
   - id: test-design
+    description: "Phase 5 — Test Design: generate test cases from SRS (tests before code)"
     command: sdlc-test-design
     depends_on: [srs]
     workspace: false
   - id: implement
+    description: "Phase 6 — Implement: TDD implementation per vertical slice"
     command: sdlc-implement
     depends_on: [test-design]
   - id: test-gate
+    description: "Phase 6b — Test Gate: run automated tests to verify implementation"
     bash: |
       cd $WORKSPACE && npm test 2>&1
     depends_on: [implement]
@@ -32,14 +39,17 @@ nodes:
       max_retries: 3
       inject_error: true
   - id: review
+    description: "Phase 7 — Review: code review against SRS, architecture, and best practices"
     command: sdlc-review
     depends_on: [test-gate]
     workspace: false
   - id: complete
+    description: "Phase 8 — Feature Complete: update knowledge base and project documentation"
     command: sdlc-feature-complete
     depends_on: [review]
     workspace: false
   - id: ship
+    description: "Phase 9 — Ship: create PR, final checks, deploy"
     command: sdlc-ship
     depends_on: [complete]
     workspace: false

package/skills/sdlc/workflows/onboarding.yaml

@@ -2,8 +2,10 @@ name: onboarding
 description: "Utility — Onboarding: docs graph + code graph + env setup (not part of main flow)"
 nodes:
   - id: docs
+    description: "Onboard Docs: build documentation knowledge graph"
     command: sdlc-onboard-docs
     workspace: false
   - id: code
+    description: "Onboard Code: analyze codebase structure and conventions"
     command: sdlc-onboard-code
     workspace: false

package/skills/sdlc/workflows/sdlc-build.yaml

@@ -3,10 +3,12 @@ description: "Sub-flow: Implement → Test Gate — TDD code + automated test ve
 
 nodes:
   - id: implement
+    description: "Implement: TDD implementation per vertical slice"
     command: sdlc-implement
     depends_on: []
 
   - id: test-gate
+    description: "Test Gate: run automated tests to verify implementation"
     bash: |
       cd $WORKSPACE && npm test 2>&1
     depends_on: [implement]

package/skills/sdlc/workflows/sdlc-design.yaml

@@ -3,10 +3,12 @@ description: "Sub-flow: Architecture → SRS — design solution and write detai
 
 nodes:
   - id: architecture
+    description: "Architecture: design solution architecture and write ADR + epic breakdown"
     command: sdlc-architecture
     workspace: false
 
   - id: srs
+    description: "SRS: write Software Requirements Specification with API contracts"
     command: sdlc-srs
     depends_on: [architecture]
     workspace: false

package/skills/sdlc/workflows/sdlc-qa.yaml

@@ -3,15 +3,18 @@ description: "Sub-flow: Review → Feature Complete → Ship — quality gate +
 
 nodes:
   - id: review
+    description: "Review: code review against SRS, architecture, and best practices"
     command: sdlc-review
     workspace: false
 
   - id: complete
+    description: "Feature Complete: update knowledge base and project documentation"
     command: sdlc-feature-complete
     depends_on: [review]
     workspace: false
 
   - id: ship
+    description: "Ship: create PR, final checks, deploy"
     command: sdlc-ship
     depends_on: [complete]
     workspace: false

package/skills/sdlc/workflows/sdlc-testcase.yaml

@@ -3,5 +3,6 @@ description: "Sub-flow: Test Design — generate test cases from SRS (tests befo
 
 nodes:
   - id: test-design
+    description: "Test Design: generate test cases from SRS (tests before code)"
     command: sdlc-test-design
     workspace: false

package/packages/core/dist/store/event-log.d.ts

@@ -1,8 +0,0 @@
-import type { WorkflowEvent } from './types.js';
-export declare class EventLog {
-    private readonly filePath;
-    constructor(runDir: string);
-    append(event: Omit<WorkflowEvent, 'timestamp'>): void;
-    readAll(): WorkflowEvent[];
-}
-//# sourceMappingURL=event-log.d.ts.map

package/packages/core/dist/store/event-log.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../../src/store/event-log.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,MAAM,EAAE,MAAM;IAI1B,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,IAAI;IAQrD,OAAO,IAAI,aAAa,EAAE;CAQ3B"}

package/packages/core/dist/store/event-log.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EventLog = void 0;
-const fs_1 = require("fs");
-const path_1 = require("path");
-class EventLog {
-    filePath;
-    constructor(runDir) {
-        this.filePath = (0, path_1.join)(runDir, 'events.jsonl');
-    }
-    append(event) {
-        const entry = {
-            timestamp: new Date().toISOString(),
-            ...event,
-        };
-        (0, fs_1.appendFileSync)(this.filePath, JSON.stringify(entry) + '\n', 'utf-8');
-    }
-    readAll() {
-        if (!(0, fs_1.existsSync)(this.filePath))
-            return [];
-        const content = (0, fs_1.readFileSync)(this.filePath, 'utf-8').trim();
-        if (!content)
-            return [];
-        return content
-            .split('\n')
-            .map(line => JSON.parse(line));
-    }
-}
-exports.EventLog = EventLog;
-//# sourceMappingURL=event-log.js.map

package/packages/core/dist/store/event-log.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-log.js","sourceRoot":"","sources":["../../src/store/event-log.ts"],"names":[],"mappings":";;;AAAA,2BAA8D;AAC9D,+BAA4B;AAG5B,MAAa,QAAQ;IACF,QAAQ,CAAS;IAElC,YAAY,MAAc;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAA,WAAI,EAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,KAAuC;QAC5C,MAAM,KAAK,GAAkB;YAC3B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,GAAG,KAAK;SACT,CAAC;QACF,IAAA,mBAAc,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACxB,OAAO,OAAO;aACX,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC,CAAC;IACpD,CAAC;CACF;AAvBD,4BAuBC"}