@innovatorstack/harness 0.0.0-stage → 0.1.1

package/dist/verification/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/verification/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,oBAAY,gBAAgB;IACxB,oBAAoB,0BAA0B;IAC9C,YAAY,kBAAkB;IAC9B,UAAU,gBAAgB;IAC1B,iBAAiB,uBAAuB;IACxC,iBAAiB,uBAAuB;IACxC,QAAQ,aAAa;IACrB,kBAAkB,wBAAwB;IAC1C,YAAY,kBAAkB;CACjC;AAED,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CACpD,cAAc,EACd,KAAK,GAAG,QAAQ,GAAG,UAAU,CAChC;CAAG;AAEJ,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,SAAS,cAAc,EAAE,CAAC;IACnD,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CACzC;AAED,yFAAyF;AACzF,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACtC,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACrD,QAAQ,CAAC,SAAS,EAAE,SAAS;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KAC3B,EAAE,CAAC;IACJ,QAAQ,CAAC,OAAO,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACtD,QAAQ,CAAC,GAAG,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAClD;AAED,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/verification/types.js

@@ -0,0 +1,12 @@
+export var PackageIssueCode;
+(function (PackageIssueCode) {
+    PackageIssueCode["InvalidConfiguration"] = "INVALID_CONFIGURATION";
+    PackageIssueCode["InvalidInput"] = "INVALID_INPUT";
+    PackageIssueCode["InvalidXml"] = "INVALID_XML";
+    PackageIssueCode["InvalidDefinition"] = "INVALID_DEFINITION";
+    PackageIssueCode["MissingDependency"] = "MISSING_DEPENDENCY";
+    PackageIssueCode["Conflict"] = "CONFLICT";
+    PackageIssueCode["UnsupportedFeature"] = "UNSUPPORTED_FEATURE";
+    PackageIssueCode["ImportFailed"] = "IMPORT_FAILED";
+})(PackageIssueCode || (PackageIssueCode = {}));
+//# sourceMappingURL=types.js.map

package/dist/verification/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/verification/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAN,IAAY,gBASX;AATD,WAAY,gBAAgB;IACxB,kEAA8C,CAAA;IAC9C,kDAA8B,CAAA;IAC9B,8CAA0B,CAAA;IAC1B,4DAAwC,CAAA;IACxC,4DAAwC,CAAA;IACxC,yCAAqB,CAAA;IACrB,8DAA0C,CAAA;IAC1C,kDAA8B,CAAA;AAClC,CAAC,EATW,gBAAgB,KAAhB,gBAAgB,QAS3B"}

package/dist/verification/verify.d.ts

@@ -0,0 +1,4 @@
+import type { PackageVerificationOptions, PackageVerificationReport } from "./types.js";
+/** Inspect configured package XML without loading fixtures or executing Methods. */
+export declare function verifyPackages(options?: PackageVerificationOptions): Promise<PackageVerificationReport>;
+//# sourceMappingURL=verify.d.ts.map

package/dist/verification/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/verification/verify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAExF,oFAAoF;AACpF,wBAAsB,cAAc,CAChC,OAAO,GAAE,0BAA+B,GACzC,OAAO,CAAC,yBAAyB,CAAC,CAIpC"}

package/dist/verification/verify.js

@@ -0,0 +1,69 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { inspectPackages } from "./inspection.js";
+/** Inspect configured package XML without loading fixtures or executing Methods. */
+export async function verifyPackages(options = {}) {
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        const inspection = __addDisposableResource(env_1, await inspectPackages(options), false);
+        return inspection.report;
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        __disposeResources(env_1);
+    }
+}
+//# sourceMappingURL=verify.js.map

package/dist/verification/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/verification/verify.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,OAAO,GAA+B,EAAE;;;QAExC,MAAM,UAAU,kCAAG,MAAM,eAAe,CAAC,OAAO,CAAC,QAAA,CAAC;QAElD,OAAO,UAAU,CAAC,MAAM,CAAC;;;;;;;;;AAC7B,CAAC"}

package/examples/basic/.harness/fixtures.ts

@@ -0,0 +1,5 @@
+import type { Fixtures } from "@innovatorstack/harness";
+
+export default {
+    ExampleDocument: [{ name: "Specification", remark: "Original" }],
+} satisfies Fixtures;

package/examples/basic/.harness/packages/documents.xml

@@ -0,0 +1,16 @@
+<AML>
+    <Item type="ItemType" action="add" id="4F4DA622F7A68C6EC87729C237BAD86A">
+        <name>ExampleDocument</name>
+        <Relationships>
+            <Item type="Property" action="add">
+                <name>name</name>
+                <data_type>string</data_type>
+                <is_required>1</is_required>
+            </Item>
+            <Item type="Property" action="add">
+                <name>remark</name>
+                <data_type>string</data_type>
+            </Item>
+        </Relationships>
+    </Item>
+</AML>

package/examples/basic/README.md

@@ -0,0 +1,13 @@
+# Basic example
+
+Build and pack Harness at the repository root using the [installation steps](../../README.md).
+Then run in this directory:
+
+```sh
+bun add --dev ../../innovatorstack-harness-0.1.0.tgz
+bun test
+```
+
+The package defines `ExampleDocument`; fixtures supply its starting record. The test
+updates it, reads the saved value and resets to the original state. Configuration is optional.
+This example uses no C# execution or server connection.

package/examples/basic/package.json

@@ -0,0 +1,12 @@
+{
+    "name": "harness-basic-example",
+    "private": true,
+    "type": "module",
+    "scripts": {
+        "test": "bun test"
+    },
+    "devDependencies": {
+        "@innovatorstack/harness": "^0.1.0",
+        "@types/bun": "^1.4.4"
+    }
+}

package/examples/basic/tests/documents.test.ts

@@ -0,0 +1,19 @@
+import { expect, test } from "bun:test";
+
+import { createHarness } from "@innovatorstack/harness";
+
+test("updates the seeded document and resets to its starting state", async () => {
+    using harness = await createHarness();
+    const document = await harness.getOne("ExampleDocument", { name: "Specification" });
+
+    await harness.update(document, { remark: "Reviewed" });
+
+    const saved = await harness.getOne("ExampleDocument", { name: "Specification" });
+    expect(saved.properties.remark).toBe("Reviewed");
+
+    harness.reset();
+    expect(harness.executions).toEqual([]);
+
+    const original = await harness.getOne("ExampleDocument", { name: "Specification" });
+    expect(original.properties.remark).toBe("Original");
+});

package/examples/basic/tsconfig.json

@@ -0,0 +1,15 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "Preserve",
+        "moduleResolution": "Bundler",
+        "types": ["bun"],
+        "strict": true,
+        "noUncheckedIndexedAccess": true,
+        "exactOptionalPropertyTypes": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "skipLibCheck": true
+    },
+    "include": ["tests/**/*.ts", ".harness/**/*.ts"]
+}

package/examples/server-methods/.harness/fixtures.ts

@@ -0,0 +1,18 @@
+import type { Fixtures } from "@innovatorstack/harness";
+
+export default {
+    ExampleReview: [
+        {
+            name: "Incomplete review",
+            remark: "Original",
+            missing_info: "A required attachment is missing",
+            approved_on: "2026-01-01T00:00:00",
+        },
+        {
+            name: "Complete review",
+            remark: "Original",
+            missing_info: "",
+            approved_on: "2026-01-01T00:00:00",
+        },
+    ],
+} satisfies Fixtures;

package/examples/server-methods/.harness/mocks.json

@@ -0,0 +1,6 @@
+[
+    {
+        "method": "ReadReviewRules",
+        "response": { "json": { "allow_review": true } }
+    }
+]

package/examples/server-methods/.harness/packages/review.xml

@@ -0,0 +1,69 @@
+<AML>
+    <Item type="ItemType" action="add" id="878D338EDB198A48275F358B66D7D18E">
+        <name>ExampleReview</name>
+        <Relationships>
+            <Item type="Property" action="add">
+                <name>name</name>
+                <data_type>string</data_type>
+                <is_required>1</is_required>
+            </Item>
+            <Item type="Property" action="add">
+                <name>remark</name>
+                <data_type>string</data_type>
+            </Item>
+            <Item type="Property" action="add">
+                <name>missing_info</name>
+                <data_type>string</data_type>
+            </Item>
+            <Item type="Property" action="add">
+                <name>approved_on</name>
+                <data_type>date</data_type>
+            </Item>
+            <Item type="Server Event" action="add">
+                <server_event>onBeforeUpdate</server_event>
+                <related_id>20AA2FB54527869C1283EE80FC4F86BD</related_id>
+                <sort_order>10</sort_order>
+            </Item>
+        </Relationships>
+    </Item>
+    <Item type="Method" action="add" id="20AA2FB54527869C1283EE80FC4F86BD">
+        <name>GuardReview</name>
+        <method_type>C#</method_type>
+        <method_code><![CDATA[
+var query = this.newItem("ExampleReview", "get");
+query.setID(this.getID());
+var original = query.apply();
+
+if (original.isError())
+{
+    return original;
+}
+
+if (!string.IsNullOrEmpty(original.getProperty("missing_info")))
+{
+    this.removeProperty("approved_on");
+}
+
+return this;
+]]></method_code>
+    </Item>
+    <Item type="Method" action="add" id="F1C6AD0E4C9D5002DB932D5C5332E0F2">
+        <name>SubmitReview</name>
+        <method_type>C#</method_type>
+        <method_code><![CDATA[
+var rules = this.getInnovator().applyMethod("ReadReviewRules", "");
+
+if (rules.isError())
+{
+    return rules;
+}
+
+var update = this.newItem("ExampleReview", "edit");
+update.setID(this.getProperty("review_id"));
+update.setProperty("remark", this.getProperty("remark"));
+update.setProperty("approved_on", this.getProperty("approved_on"));
+
+return update.apply();
+]]></method_code>
+    </Item>
+</AML>

package/examples/server-methods/README.md

@@ -0,0 +1,14 @@
+# Server Methods example
+
+Install the .NET 10 SDK and build the archive using the [installation steps](../../README.md).
+Then run in this directory:
+
+```sh
+bun add --dev ../../innovatorstack-harness-0.1.0.tgz
+bun test
+```
+
+The original example export defines `SubmitReview` and its `onBeforeUpdate` guard.
+Tests verify permitted changes, a protected approval date and rollback after a failed save.
+Only `ReadReviewRules` is mocked; the submit Method and guard execute their C# source.
+All names, records and source in this example were written for Harness.

package/examples/server-methods/package.json

@@ -0,0 +1,12 @@
+{
+    "name": "harness-server-methods-example",
+    "private": true,
+    "type": "module",
+    "scripts": {
+        "test": "bun test"
+    },
+    "devDependencies": {
+        "@innovatorstack/harness": "^0.1.0",
+        "@types/bun": "^1.4.4"
+    }
+}

package/examples/server-methods/tests/submission.test.ts

@@ -0,0 +1,60 @@
+import { expect, test } from "bun:test";
+
+import { createHarness, FailurePoint, ItemAction } from "@innovatorstack/harness";
+
+test("an incomplete review saves its remark while preserving its approval date", async () => {
+    using harness = await createHarness();
+    const before = await harness.getOne("ExampleReview", { name: "Incomplete review" });
+
+    const response = await harness.callMethod("SubmitReview", {
+        review_id: before.id,
+        remark: "A permitted change",
+        approved_on: "2026-02-01T00:00:00",
+    });
+
+    expect(response.isError()).toBe(false);
+    const after = await harness.getOne("ExampleReview", { name: "Incomplete review" });
+    expect(after.properties.remark).toBe("A permitted change");
+    expect(after.properties.approved_on).toBe(before.properties.approved_on);
+
+    const methods = harness.trace.filter((event) => event.kind === "method");
+    expect(methods.map((event) => event.name)).toContain("SubmitReview");
+    expect(methods.map((event) => event.name)).toContain("GuardReview");
+});
+
+test("a complete review accepts its approval date", async () => {
+    using harness = await createHarness();
+    const before = await harness.getOne("ExampleReview", { name: "Complete review" });
+
+    const response = await harness.callMethod("SubmitReview", {
+        review_id: before.id,
+        remark: "Approved",
+        approved_on: "2026-02-01T00:00:00",
+    });
+
+    expect(response.isError()).toBe(false);
+    const after = await harness.getOne("ExampleReview", { name: "Complete review" });
+    expect(after.properties.approved_on).toBe("2026-02-01T00:00:00");
+});
+
+test("a failed update rolls back its stored changes", async () => {
+    using harness = await createHarness();
+    const before = await harness.getOne("ExampleReview", { name: "Complete review" });
+    using failure = harness.injectFailure({
+        type: "ExampleReview",
+        action: ItemAction.Edit,
+        at: FailurePoint.AfterCall,
+        error: new Error("The save failed"),
+    });
+
+    await expect(
+        harness.callMethod("SubmitReview", {
+            review_id: before.id,
+            remark: "Must roll back",
+            approved_on: "2026-02-01T00:00:00",
+        }),
+    ).rejects.toThrow("The save failed");
+
+    expect(failure.triggered).toBe(true);
+    expect(await harness.getOne("ExampleReview", { name: "Complete review" })).toEqual(before);
+});

package/examples/server-methods/tsconfig.json

@@ -0,0 +1,15 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "Preserve",
+        "moduleResolution": "Bundler",
+        "types": ["bun"],
+        "strict": true,
+        "noUncheckedIndexedAccess": true,
+        "exactOptionalPropertyTypes": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "skipLibCheck": true
+    },
+    "include": ["tests/**/*.ts", ".harness/**/*.ts"]
+}

package/package.json

@@ -1,6 +1,107 @@
 {
-  "name": "@innovatorstack/harness",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "@innovatorstack/harness",
+    "version": "0.1.1",
+    "private": false,
+    "description": "Local testing and instrumentation for Aras Innovator, built with Bun and TypeScript",
+    "keywords": [
+        "aml",
+        "aras",
+        "aras-innovator",
+        "bun",
+        "csharp",
+        "innovator",
+        "instrumentation",
+        "integration-testing",
+        "mocking",
+        "plm",
+        "sqlite",
+        "test-harness",
+        "testing",
+        "typescript"
+    ],
+    "homepage": "https://innovatorstack.github.io/Harness/",
+    "bugs": {
+        "url": "https://github.com/InnovatorStack/Harness/issues"
+    },
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/InnovatorStack/Harness.git"
+    },
+    "files": [
+        "dist",
+        "src/**/*.ts",
+        "src/baseline/data/*.json",
+        "README.md",
+        "LICENSE",
+        "assets/brand",
+        "examples",
+        "skills"
+    ],
+    "type": "module",
+    "exports": {
+        "./engine": {
+            "types": "./dist/engine.d.ts",
+            "import": "./dist/engine.js"
+        },
+        "./items": {
+            "types": "./dist/items/item.d.ts",
+            "import": "./dist/items/item.js"
+        },
+        "./methods": {
+            "types": "./dist/methods/types.d.ts",
+            "import": "./dist/methods/types.js"
+        },
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./core": {
+            "types": "./dist/core/index.d.ts",
+            "import": "./dist/core/index.js"
+        },
+        "./storage/sqlite": {
+            "types": "./dist/storage/sqlite/index.d.ts",
+            "import": "./dist/storage/sqlite/index.js"
+        },
+        "./packages": {
+            "types": "./dist/packages/index.d.ts",
+            "import": "./dist/packages/index.js"
+        },
+        "./csharp": {
+            "types": "./dist/methods/csharp/index.d.ts",
+            "import": "./dist/methods/csharp/index.js"
+        }
+    },
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    },
+    "scripts": {
+        "build": "bun run scripts/build.ts",
+        "release:check": "bun run scripts/release-check.ts",
+        "check": "bun run scripts/check.ts",
+        "lint": "bun run scripts/style/check.ts",
+        "typecheck": "bun --bun run tsc --noEmit",
+        "format": "bun run scripts/style/format.ts --write",
+        "format:check": "bun run scripts/style/format.ts",
+        "test": "bun run scripts/run-tests.ts"
+    },
+    "dependencies": {
+        "es-module-lexer": "3.0.4",
+        "sax": "^1.6.1"
+    },
+    "devDependencies": {
+        "@types/bun": "^1.4.4",
+        "@types/sax": "^1.2.7",
+        "oxfmt": "0.78.0",
+        "oxlint": "1.93.0",
+        "oxlint-plugin-complexity": "4.1.0",
+        "oxlint-tsgolint": "7.0.2006",
+        "typescript": "7.0.2",
+        "ultracite": "8.1.1"
+    },
+    "engines": {
+        "bun": ">=1.3.13"
+    }
+}

package/skills/innovator-harness/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: innovator-harness
+description: Set up and debug source-backed Aras solution tests with InnovatorHarness, using Bun, AML exports, automatic fixtures, selective mocks and stored-state assertions.
+---
+
+Use the installed `@innovatorstack/harness` public exports. Read the project's existing
+`.harness` setup and the relevant original Method/event source before changing a test.
+Consult the installed package's README and declarations for options beyond these examples.
+
+Write readable tests: 4 spaces, a 100-column measure, braces and blank lines between phases.
+Keep functions within 70 physical lines. Avoid non-null assertions, unchecked casts and
+recursive report walkers; use explicit guards and bounded iteration when inspecting a tree.
+Keep assertions local to the behavior being tested. Add execution-report helpers when their
+evidence is needed, rather than turning every business test into a framework audit.
+
+## Set up the solution
+
+- Run with Bun. C# execution additionally needs the .NET 10 SDK; TypeScript and AML tests
+  do not require it. Harness is a local library, with no Aras server to start.
+- Put normal exports under `.harness/packages/`. XML is discovered recursively;
+  `imports.mf` is not followed automatically. Configured extra package paths are relative
+  to `.harness/config.ts`. Use the project's existing export layout.
+- Packages own schema, Methods, events, lifecycles and their ordering. Supply missing
+  dependency exports or report the unresolved references. Do not invent prerequisites,
+  patch original Methods, or remove package content to get a passing test.
+- Shared starting data goes in `.harness/fixtures.ts` or `.harness/fixtures/` and loads
+  automatically. Use imported property names and meaningful reference selectors. Fixtures
+  bypass business hooks; call a normal action when creation behavior is under test.
+- Keep tests and project helpers outside `.harness`. Configuration is optional. Preserve
+  existing session and authorization settings; use exported enums for declared modes.
+
+```ts
+// .harness/fixtures.ts — ExampleReview must exist in the supplied export.
+import type { Fixtures } from "@innovatorstack/harness";
+
+export default {
+    ExampleReview: [{ name: "Incomplete", missing_info: "Required attachment", remark: "Before" }],
+} satisfies Fixtures;
+```
+
+## Exercise the real path
+
+Call the application's entry Method or action, then query the database again. A successful
+return or compilation alone does not establish the business result. For versionable items,
+read the current record through its stable business key or `config_id` and `is_current`;
+an old ID can still identify the previous generation. Inspect the imported version policy.
+
+```ts
+// tests/submission.test.ts — adapt Method and property names to the original source.
+import { expect, test } from "bun:test";
+
+import { createHarness } from "@innovatorstack/harness";
+
+test("saves permitted changes without setting an incomplete review's date", async () => {
+    using harness = await createHarness();
+    const before = await harness.getOne("ExampleReview", { name: "Incomplete" });
+
+    const response = await harness.callMethod("SubmitReview", {
+        review_id: before.id,
+        remark: "After",
+        approved_on: "2026-02-01T00:00:00",
+    });
+
+    expect(response.isError()).toBe(false);
+    const after = await harness.getOne("ExampleReview", { name: "Incomplete" });
+    expect(after.properties.remark).toBe("After");
+    expect(after.properties.approved_on).toBe(before.properties.approved_on);
+});
+```
+
+For a rule, cover its permitted and rejected branches. For transactional behavior, inspect
+stored changes and related records after a failure. `harness.state` bypasses get hooks for raw
+inspection; normal `get`/`getOne` runs them. `harness.executions` and `harness.trace` distinguish
+source execution, replaced calls, mutations and transaction outcomes.
+
+`using` disposes each world. `reset()` restores setup data, controlled clock/ID positions and
+reports. Do not share a live world across concurrent tests or clone database files per test.
+
+## Replace only the selected boundary
+
+Shared mocks live in `.harness/mocks.json`; response files live beside them. A per-test
+`createHarness({ mocks: [...] })` override replaces matching calls while retaining other
+shared mocks. An explicit empty list disables shared mocks.
+
+- `{ method: "ReadReviewRules", response: { json: { allow_review: true } } }` replaces that
+  Method without executing its body. Everything unmatched runs normally.
+- `{ sql: "SearchCatalog", response: "./responses/catalog.xml" }` replaces a named SQL call.
+- `{ sql: true, when: { method: "LoadCatalog" }, response: "./responses/catalog.xml" }`
+  replaces inline SQL called from that Method. Narrow matching using actual call parameters.
+
+Captured responses are mocks, not stored fixture records. Seed records separately when the
+real Methods query or update them. Do not mock the entry Method or validation hook whose
+behavior the test is intended to establish. SQL and JavaScript execution are not provided;
+unmatched unsupported calls must remain visible rather than silently succeeding.
+
+## Diagnose and verify
+
+Use `verifyPackages()` for import diagnostics and source inventories. Use
+`checkCompatibility()` for detected capability gaps; optional `{ compile: true }` compiles
+unmocked C# without executing business Methods. Neither report proves every runtime branch
+works or establishes parity with a native release.
+
+Run the affected `bun test` commands and the project's existing type, lint and format checks.
+Report checks that the environment cannot run. Prefer plain field comparisons and
+`toMatchObject` when typed collections reject Bun asymmetric matchers that expose `any`.
+Inspect stored outcomes, source execution and mock provenance. Keep customer packages,
+captures, credentials, connection details and test data
+out of published artifacts. Live connections require their own authorization; local testing
+does not authorize changing a server or invoking a remote custom Method.

package/skills/innovator-harness/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+    display_name: "Harness"
+    short_description: "Write source-backed Bun tests with Harness"
+    icon_small: "./assets/icon-small.png"
+    icon_large: "./assets/icon.png"
+    brand_color: "#FF4B1A"
+    default_prompt: "Use $innovator-harness to test this solution through its original Methods and inspect the stored result."