testeranto 0.79.69 → 0.81.0

package/.aider.input.history

@@ -0,0 +1,87 @@
+
+# 2025-03-02 06:47:48.104216
++y
+
+# 2025-03-02 06:51:16.536602
++make a text file with a filename which is also a fruit
+
+# 2025-03-02 06:53:21.037663
++make a text file in the root of the repo with a filename which is also a fruit
+
+# 2025-03-02 06:53:53.958525
++y
+
+# 2025-03-02 07:06:36.699284
++aider src/LoginButton.tsx
+
+# 2025-03-02 07:06:40.633909
++y
+
+# 2025-03-02 07:09:52.770402
++docs/web/src/LoginButton.test/log.txt
+
+# 2025-03-02 07:09:54.976990
++y
+
+# 2025-03-02 07:30:48.606018
++n
+
+# 2025-03-02 07:46:19.985990
++fix this bug
+
+# 2025-03-02 07:46:19.986163
++fix this bug
+
+# 2025-03-02 08:01:01.656853
++d
+
+# 2025-03-02 11:28:10.700252
++0:{"name":"my first feature","body":"Initialize the project. Create a new git repo and yarn package"}
+
+# 2025-03-02 11:28:10.700442
++0:{"name":"my first feature","body":"Initialize the project. Create a new git repo and yarn package"}
+
+# 2025-03-02 11:30:08.411326
++0:{"name":"my first feature","body":"Initialize the project. Create a new git repo and yarn package"}
+
+# 2025-03-02 11:30:08.411515
++0:{"name":"my first feature","body":"Initialize the project. Create a new git repo and yarn package"}
+
+# 2025-03-02 11:30:38.350786
++0:{"name":"my first feature","body":"Initialize the project. Create a new git repo and yarn package"}
+
+# 2025-03-02 11:30:38.350951
++0:{"name":"my first feature","body":"Initialize the project. Create a new git repo and yarn package"}
+
+# 2025-03-02 11:30:46.645487
++0:{"name":"my first feature","body":"Initialize the project. Create a new git repo and yarn package"}
+
+# 2025-03-02 11:30:46.645711
++0:{"name":"my first feature","body":"Initialize the project. Create a new git repo and yarn package"}
+
+# 2025-03-02 11:32:12.271324
++n
+
+# 2025-03-02 11:35:00.822199
++0:{"name":"my first feature","body":"Initialize the project. Create a new git repo and yarn package"}
+
+# 2025-03-02 11:35:00.822378
++0:{"name":"my first feature","body":"Initialize the project. Create a new git repo and yarn package"}
+
+# 2025-03-02 11:38:40.364494
++Fix the failing tests
+
+# 2025-03-02 11:38:40.364761
++Fix the failing tests
+
+# 2025-03-02 11:47:31.505518
++"Fix
+
+# 2025-03-02 11:47:31.505814
++"Fix
+
+# 2025-03-02 11:50:27.903159
++"Fix
+
+# 2025-03-02 11:50:27.903469
++"Fix

package/.eslintrc.js

@@ -17,12 +17,15 @@ module.exports = {
     },
     "plugins": [
         "react",
-        "@typescript-eslint"
+        "@typescript-eslint",
+        "react-hooks"
     ],
     "rules": {
         "@typescript-eslint/ban-ts-comment": "warn",
         "prefer-const": "warn",
-        "@typescript-eslint/no-unused-vars": "warn"
+        "@typescript-eslint/no-unused-vars": "warn",
+        "react-hooks/rules-of-hooks": "error", // Checks rules of Hooks
+        "react-hooks/exhaustive-deps": "warn" // Checks effect dependencies
     }
 }
 

package/README.md

@@ -12,119 +12,22 @@ dev: [github.dev/adamwong246/testeranto](https://github.dev/adamwong246/testeran
 
 example repo: [kokomo bay](https://github.com/ChromaPDX/kokomoBay)
 
-## tl;dr
+## Demo
 
-- Do you like TDD/BDD?
-- Do you love Typescript?
-- Do you hate Jira?
+<video src="demo.mov" width="1200" height="600" controls></video>
 
-If so, then testeranto might be the testing tool you have been looking for!
+## What is testeranto?
 
-## about
-
-Testeranto.ts an typescript Acceptance Test Driven Development ([ATDD](https://en.wikipedia.org/wiki/Acceptance_test-driven_development)) framework. It includes a library of common patterns to help write your tests, a test runner to schedule the tests and a reporter to display the results. The tests are specified in a strongly-typed gherkin-like syntax. Features are tracked _as code_, rather than living in a separate app. Tests can be run in the browser frontend or the node backend, or both! Testeranto can be used to test _anything_ that can be bundled with esbuild.
-
-## Getting started
-
-1. Write some code.
-2. Write some tests of that code.
-3. Write some features of that code.
-4. Write a `testeranto.mts`, which acts as a config file.
-5. Launch testeranto. The test runner is now rebuilding the docs folder.
-6. Commit the results of those tests.
-7. Your github pages now shows your report, showing your features, linked with your test results.
-8. Optionally add testeranto to your CI.
+- Testeranto.ts an AI-first, Acceptance Test Driven Development ([ATDD](https://en.wikipedia.org/wiki/Acceptance_test-driven_development)) framework for typescript projects.
+- Testeranto produces test results which can be fed to Aider.ai to automatically fix failing tests.
+- Testeranto tests are specified in a strongly-typed gherkin-like syntax. Rather than testing your code directly, Testeranto requires you wrap your code with a semantic interface which is based on TS type signatures.
+- Testeranto can be run in the frontend or the backend, or both.
+- Testeranto can be used to test anything that can be bundled with esbuild.
 
 ## tech of note
 
-- esm - Testeranto uses modern js.
+- esm - Testeranto uses modern js
 - typescript - tests are functions with type parameters
 - puppeteer - provides access to both node and chrome runtimes
 - esbuild - used to quickly generate test bundles
-- graphology - used to store features within a semantic network
-
-## 3 distinguishing features of testeranto
-
-1. Rather than testing your code directly, Testeranto requires you wrap your code with a semantic interface which is based on TS type signatures. These interfaces can be shared and your code is tested through the gherkin-ish directives provided by that interface.
-
-2. Testeranto tracks features and tests results directly in the source code. You may be accustomed to using tools like Jira and Trello to define user stories and assign story points. Using Testeranto, this data lives within the code base _as_ typescript code. Features are defined as nodes within a directed graph, allowing the reporter to summarize these features and their test results.
-
-3. Testeranto is designed for both the backend and the frontend. It leverages puppeteer to provide both of these runtimes. Each of your tests can be executed in the backend node runtime, within the frontend chromium browser runtime, or both.
-
-## the good parts
-
-Your tests can be run in node, chromium, or both.
-
-Testeranto includes a test runner which bundles and executes your tests, taking care to only run the tests which have changed.
-
-Testeranto includes a test reporter which displays the state of your code in a web app. ([see example](https://chromapdx.github.io/kokomoBay/report.html)) This reporter can also be run locally for the developer's convenience.
-
-Testeranto exposes an extended gherkin syntax. You can use the given-when-then lingua-franca, AND you can also use an imperative `Check` which is a bit more flexible.
-
-Rather than the traditional method of specifying tests in plain text, Testeranto tests and features are just TS, editable and type-checkable from [github's online editor](https://github.dev/ChromaPDX/kokomoBay)!
-
-## the bad parts
-
-Testeranto is very flexible and unopinionated, but not designed to maximize performance.
-
-Testeranto does not (yet!) allow a means of allowing non-coders to affect changes so, as they say, "git good 💪!"
-
-Testeranto uses ONLY node v8 and chromium. It does not support bun or deno, nor firefox nor safari.
-
-## How it works
-
-Testeranto is comprised of 3 parts
-
-1. The build process reads a config and builds the docs folder, then launches 3 esbuild build processes.
-
-- Build the features for the html report
-- Build the node-style tests
-- Build the web-style tests
-
-2. The test runner watches the output of those build processes and launches the tests as those files change. It uses puppeteer to run web tests in chromium. It uses dynamic loading to import the node tests directly into the node v8 process.
-
-3. A Report which links your features, your tests and the results of those tests into a handy website.
-
-## CLI
-
-There are 3 commands you should add to your `package.json`
-
-```
-// build the tests once
-"testeranto-esbuild": "ts-node-esm testeranto.mts",
-
-// build the tests, watching for changes
-"testeranto-esbuild-dev": "ts-node-esm testeranto.mts",
-
-// run the tests
-"testeranto-puppeteer":"ts-node-esm node_modules/testeranto/dist/module/Puppeteer.js",
-```
-
-## Hybrid tests
-
-Consider the a scenario: You have an http server which serves a frontend react component. You have multiple ways you can test this.
-
-- A node test of the logic of the http server.
-- A node test of the full http server, tested over http request.
-- A node test of the react component with react-test-render
-- A web test of the react component rendering it to the dom.
-- A node test of the logic of the server, rending the component as a paired artifact and communicated over IPC.
-- A node test of the full server, invoking puppeteer to drive the browser.
-- A web test, invoking the server as a shared artifact, serving http to the browser.
-
-## API
-
-Testeranto's main API interface is 2 functions, 1 for each run time. You must pass to this function the following arguments
-
-- The "shape" - a TS type signature to which the other arguments must conform.
-- The "input" - the test subject. The "thing that is to be tested"
-- the "specification" - This is the Cucumber-style Given/When/Then steps.
-- the "implementation" - This is the code which implements the "test specification" in code.
-- the "interface" - The code which sets up the test.
-
-This is designed so that each piece can be worked upon separately. You can think of each argument as the responsibility of a different member of your team.
-
-- "Senior Engineer" handles the "shape" and "input"
-- "Product Manager" handles the "specification"
-- "Middle Engineer" handles the "interface"
-- "Junior Engineer" handles the "implementation"
+- aider - AI to automatically fix broken tests

package/build-tests.ts

@@ -0,0 +1,16 @@
+// import { ITProject } from "./src/Project.js";
+
+// import Project from "./testeranto.js";
+
+import process from "process";
+import { ITProject } from "./src/Project";
+// import { ITProject } from "testeranto/src/Project";
+
+// process.chdir(__dirname);
+
+// import Puppeteer from "./src/Puppeteer.js";
+
+console.log(process.argv);
+const Project = await import(process.argv[2]);
+
+export default new ITProject(Project as any);

package/dist/common/build-tests.js

@@ -0,0 +1,38 @@
+"use strict";
+// import { ITProject } from "./src/Project.js";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// import Project from "./testeranto.js";
+const process_1 = __importDefault(require("process"));
+const Project_1 = require("./src/Project");
+// import { ITProject } from "testeranto/src/Project";
+// process.chdir(__dirname);
+// import Puppeteer from "./src/Puppeteer.js";
+console.log(process_1.default.argv);
+const Project = await Promise.resolve().then(() => __importStar(require(process_1.default.argv[2])));
+exports.default = new Project_1.ITProject(Project);

package/dist/common/init-docs.js

@@ -0,0 +1,8 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Init_js_1 = __importDefault(require("./src/Init.js"));
+const testeranto_js_1 = __importDefault(require("./testeranto.js"));
+exports.default = (0, Init_js_1.default)(testeranto_js_1.default);

package/dist/common/run-tests.js

@@ -0,0 +1,34 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const process_1 = __importDefault(require("process"));
+process_1.default.chdir(__dirname);
+const Puppeteer_js_1 = __importDefault(require("./src/Puppeteer.js"));
+console.log(process_1.default.argv);
+const Project = await Promise.resolve().then(() => __importStar(require(process_1.default.argv[2])));
+exports.default = (0, Puppeteer_js_1.default)(Project);

package/dist/common/src/Aider.js

@@ -0,0 +1,143 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execCommand = void 0;
+const fs_1 = __importDefault(require("fs"));
+const child_process_1 = require("child_process");
+const execCommand = async (command) => {
+    const ls = (0, child_process_1.spawn)(command.split(" ")[0], command.split(" ").slice(1, -1));
+    process.stdin.pipe(ls.stdin);
+    ls.stdout.pipe(process.stdout);
+    ls.stderr.pipe(process.stdout);
+    // ls.stdout.on("data", function (data) {
+    //   console.log("stdout: " + data.toString());
+    // });
+    // ls.stderr.on("data", function (data) {
+    //   console.log("stderr: " + data.toString());
+    // });
+    ls.on("exit", function (code) {
+        console.log("child process exited with code " + (code === null || code === void 0 ? void 0 : code.toString()) || -1);
+    });
+    // return new Promise<void>((resolve, reject) => {
+    //   const [cmd, ...args] = command.split(" ");
+    //   const childProcess = spawn(cmd, args);
+    //   childProcess.stdout.on("data", (data) => {
+    //     process.stdout.write(data.toString());
+    //   });
+    //   childProcess.stderr.on("data", (data) => {
+    //     process.stderr.write(data.toString());
+    //   });
+    //   childProcess.on("error", (error) => {
+    //     reject(error);
+    //   });
+    //   childProcess.on("exit", (code) => {
+    //     if (code === 0) {
+    //       resolve();
+    //     } else {
+    //       reject(new Error(`Command exited with code ${code}.`));
+    //     }
+    //   });
+    // });
+};
+exports.execCommand = execCommand;
+const key = process.argv[2];
+console.log(key);
+const exitcode = fs_1.default.readFileSync(`${key}/exitcode`).toString();
+console.log("exitcode", exitcode);
+// if (exitcode != "0") {
+if (exitcode != "0") {
+    const inputFiles = JSON.parse(fs_1.default.readFileSync(`${key}/inputFiles.json`).toString());
+    inputFiles.push(`${key}/tests.json`);
+    // const features = await await Promise.all(
+    //   Array.from(
+    //     new Set(
+    //       JSON.parse(fs.readFileSync(`${key}/tests.json`).toString())
+    //         .givens.reduce((mm: any[], lm: { features: any[] }) => {
+    //           mm.push(
+    //             lm.features.reduce((mm2: any[], lm2: any) => {
+    //               mm2.push(lm2);
+    //               return mm2;
+    //             }, [])
+    //           );
+    //           return mm;
+    //         }, [])
+    //         .flat()
+    //         .flat()
+    //     )
+    //   ) as string[]
+    // );
+    // const final = features.reduce((mm, [k, v], ndx) => {
+    //   mm[k] = v;
+    //   return mm;
+    // }, {});
+    // const as = JSON.stringify(final);
+    // const scriptCommand = `aider --model deepseek --api-key deepseek=${
+    //   process.env.DEEPSEEK_KEY
+    // } --message "Fix the failing tests" --read ${key}/inputFiles.json ${inputFiles
+    //   .map((i) => `--file ${i}`)
+    //   .join(" ")}`;
+    const scriptCommand = `aider --message "Fix the failing tests" --model deepseek --api-key deepseek=${process.env.DEEPSEEK_KEY} --file ./${inputFiles.join(" ./")}`;
+    console.log("scriptCommand", scriptCommand);
+    (0, exports.execCommand)(scriptCommand);
+    // fs.writeFile(`./${key}/features.json`, as, () => {
+    //   inputFiles.push(`./${key}/features.json`);
+    //   // itermTab(scriptCommand).then(() => console.log("yay"));
+    //   // const child = spawn("xterm -e", scriptCommand.split(" "), {
+    //   //   detached: true,
+    //   //   stdio: "ignore",
+    //   // });
+    //   // runCommandInITerm(scriptCommand);
+    // });
+    // .reduce(async (mm, feature) => {
+    //   const req = await octokit.request(
+    //     `GET /repos/adamwong246/kokomobay-taskman/contents/Task/${feature}.json`,
+    //     {
+    //       owner: "adamwong246",
+    //       repo: "kokomoBay-taskman",
+    //       path: `Task/${feature}.json`,
+    //       headers: {
+    //         "X-GitHub-Api-Version": "2022-11-28",
+    //       },
+    //     }
+    //   );
+    //   const j = JSON.parse(atob(req.data.content));
+    //   (await mm).push([
+    //     feature,
+    //     JSON.stringify({
+    //       name: j.name,
+    //       body: j.body,
+    //     }),
+    //   ]);
+    //   return mm;
+    // }, Promise.resolve<[string, string][]>([]))
+    // .then((z) => {
+    //   const final = z.reduce((mm, [k, v], ndx) => {
+    //     mm[k] = v;
+    //     return mm;
+    //   }, {});
+    //   const as = JSON.stringify(final);
+    //   fs.writeFile(`./${key}/features.json`, as, () => {
+    //     inputFiles.push(`./${key}/features.json`);
+    //     const scriptCommand = `aider --model deepseek --api-key deepseek=${
+    //       process.env.DEEPSEEK_KEY
+    //     } --message "Fix the failing tests" ${inputFiles.join(" ")}`;
+    //     console.log("scriptCommand", scriptCommand);
+    //     execCommand(scriptCommand);
+    //     // itermTab(scriptCommand).then(() => console.log("yay"));
+    //     // const child = spawn("xterm -e", scriptCommand.split(" "), {
+    //     //   detached: true,
+    //     //   stdio: "ignore",
+    //     // });
+    //     // runCommandInITerm(scriptCommand);
+    //   });
+    //   //
+    // });
+    // features.then((x) => {
+    //   console.log("done", x);
+    // });
+}
+else {
+    console.log("that test is not failing");
+}

package/dist/common/src/Init.js

@@ -0,0 +1,10 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+exports.default = async (partialConfig) => {
+    const config = Object.assign(Object.assign({}, partialConfig), { buildDir: process.cwd() + "/" + partialConfig.outdir });
+    fs_1.default.writeFileSync(`${config.outdir}/testeranto.json`, JSON.stringify(Object.assign(Object.assign({}, config), { buildDir: process.cwd() + "/" + config.outdir }), null, 2));
+};