@cat-factory/agents 0.54.12 → 0.55.0

package/dist/agents/prompts/testing.d.ts

@@ -5,12 +5,13 @@ export declare function isTestingKind(kind: AgentKind): boolean;
 /** The built-out system prompt for a Tester/Fixer kind, or undefined otherwise. */
 export declare function testingSystemPrompt(kind: AgentKind): string | undefined;
 /**
- * The "which environment to run in" section for a Tester step, rendered from the service's
- * declared provision type AND whether the run provisioned an environment: a `kubernetes`/
- * `custom` service — or ANY run that provisioned an env URL (e.g. a `deployer` step) — runs
- * against that ephemeral environment; a `docker-compose` service has its dependencies stood
- * up locally; an `infraless` service (or none declared) stands nothing up. Empty for
- * non-tester kinds, so callers can append it unconditionally. Kept in lock-step with
+ * The "which environment to run in" section for a Tester step, rendered from the frame's
+ * capability profile + its declared provision type: a `library` frame (not `deployable`) runs
+ * the suite in-container (any repo-local compose stood up on localhost, else its lifecycle
+ * scripts); a `kubernetes`/`custom` service — or ANY run that provisioned an env URL (e.g. a
+ * `deployer` step) — runs against that ephemeral environment; a `docker-compose` service has its
+ * dependencies stood up locally; an `infraless` service (or none declared) stands nothing up.
+ * Empty for non-tester kinds, so callers can append it unconditionally. Kept in lock-step with
  * {@link testerInfraSpec} (server) so the prompt and the harness `infra` spec never disagree.
  */
 export declare function testerEnvironmentSection(context: AgentRunContext): string;

package/dist/agents/prompts/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AA0HrE,eAAO,MAAM,uBAAuB,QAkBxB,CAAA;AAqBZ,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAEtD;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAYzE"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AA6HrE,eAAO,MAAM,uBAAuB,QAkBxB,CAAA;AAqBZ,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAEtD;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAKvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CA6BzE"}

package/dist/agents/prompts/testing.js

@@ -1,3 +1,4 @@
+import { frameProfile } from '@cat-factory/contracts';
 import { FINAL_ANSWER_IN_REPLY, STANDARDS_FOOTER } from './shared.js';
 // Built-out role prompts for the Tester → Fixer loop. The `tester` clones the PR
 // branch, brings its dependencies up (locally via docker-compose for a `docker-compose`
@@ -32,6 +33,8 @@ const TESTER_SYSTEM_PROMPT = [
     'You are a meticulous test engineer doing EXPLORATORY testing of a pull request before release.',
     'You actually run the software and observe its behaviour — you do NOT pass judgement by reading the diff or restating what the implementer says they did. A greenlight that is not backed by something you actually exercised is worthless.',
     '',
+    'If "Run mode" below says this is a LIBRARY test suite, there is no running system to probe: your job shifts to the suite — install and build the package, bring up any test dependencies, run the unit + integration tests, assess how well they cover the public API surface for THIS change, and author the missing unit/integration tests on the branch. The rules below (base every outcome on something you observed; a failed outcome blocks the greenlight; abort rather than guess if you truly cannot run the suite) apply unchanged.',
+    '',
     'Bootstrap your environment from the repository:',
     "- Read the repo's README.md (and any CONTRIBUTING / docs it points to) to learn how to install dependencies, configure the service, run migrations and start it.",
     "- Local mode: the platform has stood up the service's infra dependencies from its docker-compose file (including the WireMock mocks the mocker step added for the service's external dependencies) and exposed them on localhost. Connect to them, run any DB migrations, then start the service and exercise it against those mocks. If the service was marked as having no infra dependencies, just run the suite directly.",
@@ -163,17 +166,33 @@ export function testingSystemPrompt(kind) {
     return undefined;
 }
 /**
- * The "which environment to run in" section for a Tester step, rendered from the service's
- * declared provision type AND whether the run provisioned an environment: a `kubernetes`/
- * `custom` service — or ANY run that provisioned an env URL (e.g. a `deployer` step) — runs
- * against that ephemeral environment; a `docker-compose` service has its dependencies stood
- * up locally; an `infraless` service (or none declared) stands nothing up. Empty for
- * non-tester kinds, so callers can append it unconditionally. Kept in lock-step with
+ * The "which environment to run in" section for a Tester step, rendered from the frame's
+ * capability profile + its declared provision type: a `library` frame (not `deployable`) runs
+ * the suite in-container (any repo-local compose stood up on localhost, else its lifecycle
+ * scripts); a `kubernetes`/`custom` service — or ANY run that provisioned an env URL (e.g. a
+ * `deployer` step) — runs against that ephemeral environment; a `docker-compose` service has its
+ * dependencies stood up locally; an `infraless` service (or none declared) stands nothing up.
+ * Empty for non-tester kinds, so callers can append it unconditionally. Kept in lock-step with
  * {@link testerInfraSpec} (server) so the prompt and the harness `infra` spec never disagree.
  */
 export function testerEnvironmentSection(context) {
     if (context.agentKind !== TESTER_AGENT_KIND && context.agentKind !== UI_TESTER_AGENT_KIND)
         return '';
+    // A `library` frame runs the tester in `suite` posture: no deployment and no running system to
+    // probe, so the tester runs the suite in-container. When the frame declares a repo/package-local
+    // compose file it has been stood up on localhost (the harness `standUpInfra` path); otherwise the
+    // agent self-manages test deps via the repo's `pretest:ci`/`test:ci`/`posttest:ci` lifecycle
+    // scripts. Keyed off the profile's `testPosture` (the field named for exactly this choice) so it
+    // stays in lock-step with `testerInfraSpec` (server), which keys the wire spec off the same flag.
+    const frameType = context.service?.type;
+    if (frameType && frameProfile(frameType).testPosture === 'suite') {
+        return ('\nRun mode: library test suite — this is a published package with no deployment and no ' +
+            'running system. Install and build the package; if this run stood up repo-local test ' +
+            'dependencies they are on localhost (connect to them), otherwise run the repo’s ' +
+            '`pretest:ci` / `test:ci` / `posttest:ci` lifecycle scripts (where present) to self-manage ' +
+            'them. Then run the unit + integration suite, assess coverage of the public API surface ' +
+            'against this change, and add the missing unit/integration tests on the branch.');
+    }
     const type = context.service?.provisioning?.type;
     if (type === 'kubernetes' || type === 'custom' || context.environment?.url) {
         return '\nRun mode: ephemeral environment — test against the environment described under "Ephemeral environment under test" above (URL/host/port + any credentials); do not start the service locally.';

package/dist/agents/prompts/testing.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/agents",
-  "version": "0.54.12",
+  "version": "0.55.0",
   "description": "Agent catalog, routing, prompts and fragment library for the Agent Architecture Board.",
   "repository": {
     "type": "git",
@@ -31,14 +31,14 @@
     "ai": "^6.0.224",
     "handlebars": "^4.7.9",
     "valibot": "^1.4.2",
-    "@cat-factory/contracts": "0.128.2",
-    "@cat-factory/kernel": "0.124.0",
-    "@cat-factory/prompt-fragments": "0.13.17"
+    "@cat-factory/contracts": "0.129.0",
+    "@cat-factory/kernel": "0.125.0",
+    "@cat-factory/prompt-fragments": "0.13.18"
   },
   "devDependencies": {
     "typescript": "7.0.2",
     "vitest": "^4.1.10",
-    "@cat-factory/caching": "0.7.0"
+    "@cat-factory/caching": "0.8.0"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",