@adhamalkhaja/seyola-runtime 0.12.2 → 0.13.0

package/dist/verify-write-count/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * seyola-runtime verify-write-count — generic Phase-6 self-check.
+ *
+ * The I-008 fix codified as a runtime check. Skills like
+ * /sales-infrastructure write exactly 3 (or 5 for sales_email) files in
+ * their Phase 6. If duplicate writes happen, I-008 reproduces and
+ * downstream skills get confused.
+ *
+ * This command counts files written to specific paths within a recent
+ * time window + verifies the count matches expected. Returns structured
+ * verdict.
+ *
+ * Usage:
+ *   seyola-runtime verify-write-count --expected 3 --workspace .
+ *     --paths outreach/reply-playbook.md,outreach/lead-tracker.md,outreach/booking-flow-setup.md
+ *     --since 2026-05-24T10:00:00Z
+ *
+ * Returns: {verdict, actual_count, expected_count, files_found, duplicates_detected}
+ *
+ * Note: this command operates on filesystem state, not session history.
+ * If a skill writes a file twice in the SAME session, only the latest
+ * version exists on disk — so this won't directly catch "wrote it twice."
+ * But it WILL catch "wrote a file that shouldn't exist" or "didn't write
+ * a file that should." For genuine duplicate-write detection, the skill
+ * must log its Write tool calls separately and pass --log <path>.
+ */
+export interface VerifyWriteCountInputs {
+    workspacePath: string;
+    expected: number;
+    paths?: string[];
+    since?: string;
+    json?: boolean;
+}
+export interface VerifyWriteCountResult {
+    exitCode: number;
+    expected_count: number;
+    actual_count: number;
+    verdict: "pass" | "fail";
+    files_found: Array<{
+        path: string;
+        modified: string;
+        size_bytes: number;
+    }>;
+    files_missing: string[];
+    unexpected_files: string[];
+    duration_ms: number;
+}
+export declare function runVerifyWriteCount(inputs: VerifyWriteCountInputs): Promise<VerifyWriteCountResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/verify-write-count/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/verify-write-count/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAuEzG"}

package/dist/verify-write-count/index.js

@@ -0,0 +1,96 @@
+/**
+ * seyola-runtime verify-write-count — generic Phase-6 self-check.
+ *
+ * The I-008 fix codified as a runtime check. Skills like
+ * /sales-infrastructure write exactly 3 (or 5 for sales_email) files in
+ * their Phase 6. If duplicate writes happen, I-008 reproduces and
+ * downstream skills get confused.
+ *
+ * This command counts files written to specific paths within a recent
+ * time window + verifies the count matches expected. Returns structured
+ * verdict.
+ *
+ * Usage:
+ *   seyola-runtime verify-write-count --expected 3 --workspace .
+ *     --paths outreach/reply-playbook.md,outreach/lead-tracker.md,outreach/booking-flow-setup.md
+ *     --since 2026-05-24T10:00:00Z
+ *
+ * Returns: {verdict, actual_count, expected_count, files_found, duplicates_detected}
+ *
+ * Note: this command operates on filesystem state, not session history.
+ * If a skill writes a file twice in the SAME session, only the latest
+ * version exists on disk — so this won't directly catch "wrote it twice."
+ * But it WILL catch "wrote a file that shouldn't exist" or "didn't write
+ * a file that should." For genuine duplicate-write detection, the skill
+ * must log its Write tool calls separately and pass --log <path>.
+ */
+import { existsSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+export async function runVerifyWriteCount(inputs) {
+    const start = Date.now();
+    const workspace = resolve(inputs.workspacePath);
+    const expectedPaths = inputs.paths ?? [];
+    let sinceDate = null;
+    if (inputs.since) {
+        sinceDate = new Date(inputs.since);
+        if (isNaN(sinceDate.getTime())) {
+            const result = {
+                exitCode: 2,
+                expected_count: inputs.expected,
+                actual_count: 0,
+                verdict: "fail",
+                files_found: [],
+                files_missing: [],
+                unexpected_files: [],
+                duration_ms: Date.now() - start,
+            };
+            if (inputs.json)
+                console.log(JSON.stringify({ ...result, error: "Invalid --since date" }, null, 2));
+            else
+                console.error(`verify-write-count: invalid --since date '${inputs.since}'`);
+            return result;
+        }
+    }
+    const filesFound = [];
+    const filesMissing = [];
+    for (const relPath of expectedPaths) {
+        const absPath = join(workspace, relPath);
+        if (!existsSync(absPath)) {
+            filesMissing.push(relPath);
+            continue;
+        }
+        const stat = statSync(absPath);
+        if (sinceDate && stat.mtime < sinceDate) {
+            // File exists but was written before the --since cutoff. Treat as missing for this check.
+            filesMissing.push(`${relPath} (modified before --since cutoff)`);
+            continue;
+        }
+        filesFound.push({
+            path: relPath,
+            modified: stat.mtime.toISOString(),
+            size_bytes: stat.size,
+        });
+    }
+    const actualCount = filesFound.length;
+    const verdict = actualCount === inputs.expected && filesMissing.length === 0 ? "pass" : "fail";
+    const result = {
+        exitCode: verdict === "pass" ? 0 : 1,
+        expected_count: inputs.expected,
+        actual_count: actualCount,
+        verdict,
+        files_found: filesFound,
+        files_missing: filesMissing,
+        unexpected_files: [], // could extend to scan for files that shouldn't exist
+        duration_ms: Date.now() - start,
+    };
+    if (inputs.json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        console.error(`verify-write-count: ${verdict} (${actualCount}/${inputs.expected}` +
+            (filesMissing.length > 0 ? `, missing: ${filesMissing.join(", ")}` : "") +
+            `)`);
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/verify-write-count/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhamalkhaja/seyola-runtime",
-  "version": "0.12.2",
+  "version": "0.13.0",
   "description": "Local CLI runtime for the Seyola business operating system. Reads contracts from a Seyola pack and executes them against a runtime backend (claude-code-local).",
   "keywords": [
     "seyola",