testeranto 0.160.0 → 0.163.0

package/docs/index.md

@@ -35,7 +35,7 @@ async <I extends Ibdd_in_any, O extends Ibdd_out, M>(
   input: I["iinput"],
   testSpecification: ITestSpecification<I, O>,
   testImplementation: ITestImplementation<I, O, M>,
-  testInterface: Partial<ITestInterface<I>>,
+  testAdapter: Partial<ITestInterface<I>>,
   testResourceRequirement: ITTestResourceRequest = defaultTestResourceRequirement
 ): Promise<Testeranto<I, O, M>>
 ```
@@ -175,7 +175,6 @@ The Implementation provides the concrete operations that bring specifications to
 - `givens`: Initial test states/setup
 - `whens`: Actions that change state
 - `thens`: Assertions and validations
-- `checks`: Additional verification points
 
 ```ts
 import {
@@ -227,11 +226,7 @@ export const implementation: ITestImplementation<
       assert.equal(rectangle.circumference(), circumference);
       return rectangle;
     },
-  },
-
-  checks: {
-    Default: () => new Rectangle(2, 2),
-  },
+  }
 };
 ```
 
@@ -246,7 +241,7 @@ import {
 } from "testeranto/src/CoreTypes";
 
 //  Note the type parameter. This is important!
-export const testInterface: ITestInterface<
+export const testAdapter: ITestInterface<
   I extends Ibdd_in,
 > = {
   beforeEach: async (subject, i) => {
@@ -445,7 +440,7 @@ type M = {
   };
 };
 
-const testInterface: ITestInterface<
+const testAdapter: ITestInterface<
   I extends Ibdd_in,
 > = {
   beforeEach: async (subject, i) => {
@@ -506,11 +501,7 @@ const testImplementation: ITestImplementation<
       assert.equal(rectangle.circumference(), circumference);
       return rectangle;
     },
-  },
-
-  checks: {
-    Default: () => new Rectangle(2, 2),
-  },
+  }
 };
 
 const testSpecification: ITestSpecification<

package/docs.html

@@ -65,7 +65,7 @@
   input: I["iinput"],
   testSpecification: ITestSpecification<I, O>,
   testImplementation: ITestImplementation<I, O, M>,
-  testInterface: Partial<ITestInterface<I>>,
+  testAdapter: Partial<ITestInterface<I>>,
   testResourceRequirement: ITTestResourceRequest = defaultTestResourceRequirement
 ): Promise<Testeranto<I, O, M>></pre><h3>Testeranto&#39;s 3 runtimes</h3>
 <p>For each of testeranto&#39;s runtime, there is a specific Testeranto main function. Each is it&#39;s own import but all 3 are called in the same way.</p>
@@ -177,7 +177,6 @@ export const specification: ITestSpecification<
 <li><code>givens</code>: Initial test states/setup</li>
 <li><code>whens</code>: Actions that change state</li>
 <li><code>thens</code>: Assertions and validations</li>
-<li><code>checks</code>: Additional verification points</li>
 </ul>
 <pre>import {
   Ibdd_in,
@@ -228,11 +227,7 @@ export const implementation: ITestImplementation<
       assert.equal(rectangle.circumference(), circumference);
       return rectangle;
     },
-  },
-
-  checks: {
-    Default: () => new Rectangle(2, 2),
-  },
+  }
 };</pre><h4>The Interface aka ITestInterface</h4>
 <p>The test interface is code which is NOT business logic. The interface adapts your test subject so that the BDD hooks can be applied. The interface implements the traditional BDD steps &quot;before all&quot;, &quot;after all&quot;, &quot;before each&quot;, &quot;after each&quot;, etc</p>
 <pre>import {
@@ -241,7 +236,7 @@ export const implementation: ITestImplementation<
 } from "testeranto/src/CoreTypes";
 
 //  Note the type parameter. This is important!
-export const testInterface: ITestInterface<
+export const testAdapter: ITestInterface<
   I extends Ibdd_in,
 > = {
   beforeEach: async (subject, i) => {
@@ -416,7 +411,7 @@ type M = {
   };
 };
 
-const testInterface: ITestInterface<
+const testAdapter: ITestInterface<
   I extends Ibdd_in,
 > = {
   beforeEach: async (subject, i) => {
@@ -477,11 +472,7 @@ const testImplementation: ITestImplementation<
       assert.equal(rectangle.circumference(), circumference);
       return rectangle;
     },
-  },
-
-  checks: {
-    Default: () => new Rectangle(2, 2),
-  },
+  }
 };
 
 const testSpecification: ITestSpecification<

package/index.html

@@ -46,7 +46,7 @@
 <h4>🚧 Testeranto is still under development but a beta version will be released soon. If you are interested in joining the beta program, send an email to <a href="mailto:testeranto.dev@gmail.com">testeranto.dev@gmail.com</a>. 🚧</h4>
 <h2>quick links</h2>
 <ul>
-<li>an example of the reports generated: <a href="https://adamwong246.github.io/testeranto/testeranto/index.html">adamwong246.github.io/testeranto/testeranto</a></li>
+<li>an example of the reports generated: <a href="/testeranto/projects.html">adamwong246.github.io/testeranto/testeranto</a></li>
 <li>demo of me using testeranto to fix a bug: <a href="https://www.youtube.com/embed/WvU5xMqGi6Q">youtube</a></li>
 <li>a starter testeranto project: <a href="https://github.com/adamwong246/testeranto-starter">testeranto-starter</a></li>
 </ul>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "testeranto",
   "description": "the AI powered BDD test framework for typescript projects",
-  "version": "0.160.0",
+  "version": "0.163.0",
   "engines": {
     "node": "18.18.0"
   },

package/src/PM/PM_WithEslintAndTsc.ts

@@ -210,6 +210,11 @@ ${addableFiles
   })
   .join("\n")}
 
+/read node_modules/testeranto/docs/index.md
+/read node_modules/testeranto/docs/style.md
+/read node_modules/testeranto/docs/testing.ai.txt
+/read node_modules/testeranto/src/CoreTypes.ts
+
 /read ${testPaths}
 /read ${logPath}
 /read ${typePath}
@@ -219,7 +224,9 @@ ${addableFiles
 
     fs.writeFileSync(
       messagePath,
-      `Fix the failing tests described in ${testPaths} and ${logPath}. DO NOT refactor beyond what is necessary. Always prefer minimal changes, focusing mostly on keeping the BDD tests passing`
+      `
+Fix the failing tests described in ${testPaths} and ${logPath}. Focus on the bdd tests before all other concerns. You may add any debugging you think is necessary.
+`
     );
 
     this.summary[

package/src/lib/baseBuilder.test/baseBuilder.test.implementation.ts

@@ -15,16 +15,22 @@ export const implementation: ITestImplementation<I, O, {}> = {
 
   givens: {
     Default: () => {
-      return new MockBaseBuilder(
-        {},
-        {},
-        {},
-        {},
-        {},
-        {},
-        { ports: [] },
-        () => []
+      const builder = new MockBaseBuilder(
+        {}, // input
+        {}, // suitesOverrides
+        {}, // givenOverrides 
+        {}, // whenOverrides
+        {}, // thenOverrides
+        { ports: [0] }, // testResourceRequirement
+        () => [] // testSpecification
       );
+      
+      // Initialize required arrays
+      builder.artifacts = [];
+      builder.testJobs = [];
+      builder.specs = [];
+      
+      return builder;
     },
     WithCustomInput: (input: any) => {
       return new MockBaseBuilder(

package/src/lib/baseBuilder.test/baseBuilder.test.mock.ts

@@ -40,9 +40,12 @@ export class MockBaseBuilder<
     givenOverrides: Record<keyof GivenExtensions, IGivenKlasser<I>> = {} as any,
     whenOverrides: Record<keyof WhenExtensions, IWhenKlasser<I>> = {} as any,
     thenOverrides: Record<keyof ThenExtensions, IThenKlasser<I>> = {} as any,
-    testResourceRequirement: ITTestResourceRequest = { ports: [] },
+    testResourceRequirement: ITTestResourceRequest = { ports: [0] },
     testSpecification: ITestSpecification<I, O> = () => []
   ) {
+    // Initialize required arrays
+    this.artifacts = [];
+    this.testJobs = [];
     super(
       input,
       suitesOverrides,

package/src/lib/baseBuilder.test/baseBuilder.test.specification.ts

@@ -15,7 +15,12 @@ export const specification: ITestSpecification<I, O> = (
         testInitialization: Given.Default(
           ["BaseBuilder should initialize correctly"],
           [],
-          [Then.initializedProperly()]
+          [
+            Then.initializedProperly(),
+            Then.artifactsTracked(),
+            Then.jobsCreated(),
+            Then.specsGenerated()
+          ]
         ),
         testSpecsGeneration: Given.Default(
           ["BaseBuilder should generate specs from test specification"],

package/src/lib/classBuilder.test/classBuilder.test.implementation.ts

@@ -4,6 +4,7 @@ import { PassThrough } from "stream";
 
 import { ITestImplementation, ITestSpecification } from "../../CoreTypes";
 import mock from "./mock";
+import { TestClassBuilder } from "../classBuilder";
 
 import { I, O, M } from "./classBuilder.test.types";
 
@@ -19,18 +20,19 @@ export const implementation: ITestImplementation<I, O, M> = {
 
   givens: {
     Default: () => {
-      return new mock(
+      console.log('Creating default test builder instance');
+      const builder = new mock(
         implementation, // Use the current implementation
         specification, // Use the current specification
         {}, // Default input
         MockSuite,
-        // class {}, // suiteKlasser
         class {}, // givenKlasser
         class {}, // whenKlasser
         class {}, // thenKlasser
-        class {}, // checkKlasser
         { ports: [] } // Default resource requirements
       );
+      console.log('Builder created:', builder);
+      return builder;
     },
     WithCustomInput: (input: any) => {
       return new mock(
@@ -110,8 +112,9 @@ export const implementation: ITestImplementation<I, O, M> = {
 
   thens: {
     initializedProperly: () => (builder: any) => {
-      if (!(builder instanceof TestClassBuilder)) {
-        throw new Error("Builder was not properly initialized");
+      console.log('Checking builder initialization:', builder);
+      if (!(builder instanceof mock)) {
+        throw new Error(`Builder was not properly initialized. Expected mock instance but got ${builder?.constructor?.name}`);
       }
       return builder;
     },

package/testeranto/bundles/node/allTests/metafile.json

@@ -357,7 +357,7 @@
         "format": "esm"
       },
       "src/lib/classBuilder.test/classBuilder.test.implementation.ts": {
-        "bytes": 5476,
+        "bytes": 5711,
         "imports": [
           {
             "path": "stream",
@@ -374,6 +374,11 @@
             "kind": "import-statement",
             "original": "./mock"
           },
+          {
+            "path": "../classBuilder",
+            "kind": "import-statement",
+            "external": true
+          },
           {
             "path": "./classBuilder.test.types",
             "kind": "import-statement",
@@ -502,7 +507,7 @@
         "format": "esm"
       },
       "src/lib/baseBuilder.test/baseBuilder.test.specification.ts": {
-        "bytes": 802,
+        "bytes": 930,
         "imports": [
           {
             "path": "../../CoreTypes",
@@ -518,7 +523,7 @@
         "format": "esm"
       },
       "src/lib/baseBuilder.test/baseBuilder.test.mock.ts": {
-        "bytes": 1917,
+        "bytes": 2001,
         "imports": [
           {
             "path": "../../CoreTypes",
@@ -544,7 +549,7 @@
         "format": "esm"
       },
       "src/lib/baseBuilder.test/baseBuilder.test.implementation.ts": {
-        "bytes": 3194,
+        "bytes": 3478,
         "imports": [
           {
             "path": "../../CoreTypes",
@@ -671,7 +676,7 @@
             "bytesInOutput": 1162
           },
           "src/lib/classBuilder.test/classBuilder.test.implementation.ts": {
-            "bytesInOutput": 5074
+            "bytesInOutput": 5256
           },
           "src/lib/classBuilder.test/classBuilder.test.adapter.ts": {
             "bytesInOutput": 405
@@ -680,7 +685,7 @@
             "bytesInOutput": 124
           }
         },
-        "bytes": 18251
+        "bytes": 18433
       },
       "testeranto/bundles/node/allTests/src/lib/baseBuilder.test/baseBuilder.test.node.mjs": {
         "imports": [
@@ -701,13 +706,13 @@
             "bytesInOutput": 862
           },
           "src/lib/baseBuilder.test/baseBuilder.test.specification.ts": {
-            "bytesInOutput": 650
+            "bytesInOutput": 778
           },
           "src/lib/baseBuilder.test/baseBuilder.test.mock.ts": {
-            "bytesInOutput": 927
+            "bytesInOutput": 977
           },
           "src/lib/baseBuilder.test/baseBuilder.test.implementation.ts": {
-            "bytesInOutput": 2595
+            "bytesInOutput": 2885
           },
           "src/lib/baseBuilder.test/baseBuilder.test.adapter.ts": {
             "bytesInOutput": 373
@@ -716,7 +721,7 @@
             "bytesInOutput": 131
           }
         },
-        "bytes": 9257
+        "bytes": 9725
       },
       "testeranto/bundles/node/allTests/chunk-4NYHHJ7H.mjs": {
         "imports": [],

package/testeranto/bundles/node/allTests/src/lib/baseBuilder.test/baseBuilder.test.node.mjs

@@ -176,7 +176,12 @@ var specification = (Suite, Given, When, Then) => {
         testInitialization: Given.Default(
           ["BaseBuilder should initialize correctly"],
           [],
-          [Then.initializedProperly()]
+          [
+            Then.initializedProperly(),
+            Then.artifactsTracked(),
+            Then.jobsCreated(),
+            Then.specsGenerated()
+          ]
         ),
         testSpecsGeneration: Given.Default(
           ["BaseBuilder should generate specs from test specification"],
@@ -196,7 +201,9 @@ var specification = (Suite, Given, When, Then) => {
 
 // src/lib/baseBuilder.test/baseBuilder.test.mock.ts
 var MockBaseBuilder = class extends BaseBuilder {
-  constructor(input, suitesOverrides = {}, givenOverrides = {}, whenOverrides = {}, thenOverrides = {}, testResourceRequirement = { ports: [] }, testSpecification = () => []) {
+  constructor(input, suitesOverrides = {}, givenOverrides = {}, whenOverrides = {}, thenOverrides = {}, testResourceRequirement = { ports: [0] }, testSpecification = () => []) {
+    this.artifacts = [];
+    this.testJobs = [];
     super(
       input,
       suitesOverrides,
@@ -239,16 +246,26 @@ var implementation = {
   },
   givens: {
     Default: () => {
-      return new MockBaseBuilder(
-        {},
+      const builder = new MockBaseBuilder(
         {},
+        // input
         {},
+        // suitesOverrides
         {},
+        // givenOverrides 
         {},
+        // whenOverrides
         {},
-        { ports: [] },
+        // thenOverrides
+        { ports: [0] },
+        // testResourceRequirement
         () => []
+        // testSpecification
       );
+      builder.artifacts = [];
+      builder.testJobs = [];
+      builder.specs = [];
+      return builder;
     },
     WithCustomInput: (input) => {
       return new MockBaseBuilder(

package/testeranto/bundles/node/allTests/src/lib/classBuilder.test/classBuilder.test.mjs

@@ -448,7 +448,8 @@ var implementation = {
   },
   givens: {
     Default: () => {
-      return new TestClassBuilderMock(
+      console.log("Creating default test builder instance");
+      const builder = new TestClassBuilderMock(
         implementation,
         // Use the current implementation
         specification,
@@ -456,7 +457,6 @@ var implementation = {
         {},
         // Default input
         MockSuite,
-        // class {}, // suiteKlasser
         class {
         },
         // givenKlasser
@@ -466,12 +466,11 @@ var implementation = {
         class {
         },
         // thenKlasser
-        class {
-        },
-        // checkKlasser
         { ports: [] }
         // Default resource requirements
       );
+      console.log("Builder created:", builder);
+      return builder;
     },
     WithCustomInput: (input) => {
       return new TestClassBuilderMock(
@@ -569,8 +568,9 @@ var implementation = {
   },
   thens: {
     initializedProperly: () => (builder) => {
-      if (!(builder instanceof TestClassBuilder)) {
-        throw new Error("Builder was not properly initialized");
+      console.log("Checking builder initialization:", builder);
+      if (!(builder instanceof TestClassBuilderMock)) {
+        throw new Error(`Builder was not properly initialized. Expected mock instance but got ${builder?.constructor?.name}`);
       }
       return builder;
     },

package/testeranto/bundles/pure/allTests/metafile.json

@@ -360,7 +360,7 @@
         "format": "esm"
       },
       "src/lib/baseBuilder.test/baseBuilder.test.specification.ts": {
-        "bytes": 802,
+        "bytes": 930,
         "imports": [
           {
             "path": "../../CoreTypes",
@@ -376,7 +376,7 @@
         "format": "esm"
       },
       "src/lib/baseBuilder.test/baseBuilder.test.mock.ts": {
-        "bytes": 1917,
+        "bytes": 2001,
         "imports": [
           {
             "path": "../../CoreTypes",
@@ -402,7 +402,7 @@
         "format": "esm"
       },
       "src/lib/baseBuilder.test/baseBuilder.test.implementation.ts": {
-        "bytes": 3194,
+        "bytes": 3478,
         "imports": [
           {
             "path": "../../CoreTypes",
@@ -524,13 +524,13 @@
             "bytesInOutput": 862
           },
           "src/lib/baseBuilder.test/baseBuilder.test.specification.ts": {
-            "bytesInOutput": 650
+            "bytesInOutput": 778
           },
           "src/lib/baseBuilder.test/baseBuilder.test.mock.ts": {
-            "bytesInOutput": 927
+            "bytesInOutput": 977
           },
           "src/lib/baseBuilder.test/baseBuilder.test.implementation.ts": {
-            "bytesInOutput": 2595
+            "bytesInOutput": 2885
           },
           "src/lib/baseBuilder.test/baseBuilder.test.adapter.ts": {
             "bytesInOutput": 373
@@ -539,7 +539,7 @@
             "bytesInOutput": 131
           }
         },
-        "bytes": 25213
+        "bytes": 25681
       }
     }
   }

package/testeranto/bundles/pure/allTests/src/lib/baseBuilder.test/baseBuilder.test.pure.mjs

@@ -815,7 +815,12 @@ var specification = (Suite, Given, When, Then) => {
         testInitialization: Given.Default(
           ["BaseBuilder should initialize correctly"],
           [],
-          [Then.initializedProperly()]
+          [
+            Then.initializedProperly(),
+            Then.artifactsTracked(),
+            Then.jobsCreated(),
+            Then.specsGenerated()
+          ]
         ),
         testSpecsGeneration: Given.Default(
           ["BaseBuilder should generate specs from test specification"],
@@ -835,7 +840,9 @@ var specification = (Suite, Given, When, Then) => {
 
 // src/lib/baseBuilder.test/baseBuilder.test.mock.ts
 var MockBaseBuilder = class extends BaseBuilder {
-  constructor(input, suitesOverrides = {}, givenOverrides = {}, whenOverrides = {}, thenOverrides = {}, testResourceRequirement = { ports: [] }, testSpecification = () => []) {
+  constructor(input, suitesOverrides = {}, givenOverrides = {}, whenOverrides = {}, thenOverrides = {}, testResourceRequirement = { ports: [0] }, testSpecification = () => []) {
+    this.artifacts = [];
+    this.testJobs = [];
     super(
       input,
       suitesOverrides,
@@ -878,16 +885,26 @@ var implementation = {
   },
   givens: {
     Default: () => {
-      return new MockBaseBuilder(
-        {},
+      const builder = new MockBaseBuilder(
         {},
+        // input
         {},
+        // suitesOverrides
         {},
+        // givenOverrides 
         {},
+        // whenOverrides
         {},
-        { ports: [] },
+        // thenOverrides
+        { ports: [0] },
+        // testResourceRequirement
         () => []
+        // testSpecification
       );
+      builder.artifacts = [];
+      builder.testJobs = [];
+      builder.specs = [];
+      return builder;
     },
     WithCustomInput: (input) => {
       return new MockBaseBuilder(

package/testeranto/bundles/web/allTests/metafile.json

@@ -519,7 +519,7 @@
         "format": "esm"
       },
       "src/lib/baseBuilder.test/baseBuilder.test.specification.ts": {
-        "bytes": 802,
+        "bytes": 930,
         "imports": [
           {
             "path": "../../CoreTypes",
@@ -550,7 +550,7 @@
         "format": "esm"
       },
       "src/lib/baseBuilder.test/baseBuilder.test.mock.ts": {
-        "bytes": 1917,
+        "bytes": 2001,
         "imports": [
           {
             "path": "../../CoreTypes",
@@ -591,7 +591,7 @@
         "format": "esm"
       },
       "src/lib/baseBuilder.test/baseBuilder.test.implementation.ts": {
-        "bytes": 3194,
+        "bytes": 3478,
         "imports": [
           {
             "path": "../../CoreTypes",
@@ -758,13 +758,13 @@
             "bytesInOutput": 1710
           },
           "src/lib/baseBuilder.test/baseBuilder.test.specification.ts": {
-            "bytesInOutput": 650
+            "bytesInOutput": 778
           },
           "src/lib/baseBuilder.test/baseBuilder.test.mock.ts": {
-            "bytesInOutput": 927
+            "bytesInOutput": 977
           },
           "src/lib/baseBuilder.test/baseBuilder.test.implementation.ts": {
-            "bytesInOutput": 2595
+            "bytesInOutput": 2885
           },
           "src/lib/baseBuilder.test/baseBuilder.test.adapter.ts": {
             "bytesInOutput": 373
@@ -773,7 +773,7 @@
             "bytesInOutput": 129
           }
         },
-        "bytes": 25925
+        "bytes": 26393
       }
     }
   }

package/testeranto/bundles/web/allTests/src/lib/baseBuilder.test/baseBuilder.test.web.mjs

@@ -837,7 +837,12 @@ var specification = (Suite, Given, When, Then) => {
         testInitialization: Given.Default(
           ["BaseBuilder should initialize correctly"],
           [],
-          [Then.initializedProperly()]
+          [
+            Then.initializedProperly(),
+            Then.artifactsTracked(),
+            Then.jobsCreated(),
+            Then.specsGenerated()
+          ]
         ),
         testSpecsGeneration: Given.Default(
           ["BaseBuilder should generate specs from test specification"],
@@ -857,7 +862,9 @@ var specification = (Suite, Given, When, Then) => {
 
 // src/lib/baseBuilder.test/baseBuilder.test.mock.ts
 var MockBaseBuilder = class extends BaseBuilder {
-  constructor(input, suitesOverrides = {}, givenOverrides = {}, whenOverrides = {}, thenOverrides = {}, testResourceRequirement = { ports: [] }, testSpecification = () => []) {
+  constructor(input, suitesOverrides = {}, givenOverrides = {}, whenOverrides = {}, thenOverrides = {}, testResourceRequirement = { ports: [0] }, testSpecification = () => []) {
+    this.artifacts = [];
+    this.testJobs = [];
     super(
       input,
       suitesOverrides,
@@ -900,16 +907,26 @@ var implementation = {
   },
   givens: {
     Default: () => {
-      return new MockBaseBuilder(
-        {},
+      const builder = new MockBaseBuilder(
         {},
+        // input
         {},
+        // suitesOverrides
         {},
+        // givenOverrides 
         {},
+        // whenOverrides
         {},
-        { ports: [] },
+        // thenOverrides
+        { ports: [0] },
+        // testResourceRequirement
         () => []
+        // testSpecification
       );
+      builder.artifacts = [];
+      builder.testJobs = [];
+      builder.specs = [];
+      return builder;
     },
     WithCustomInput: (input) => {
       return new MockBaseBuilder(