@invokable/conformance 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Invokable
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# @invokable/conformance
+
+Checks that a CLI honours the [invokable](https://github.com/beinvokable/invokable)
+agent contract.
+
+```console
+$ npx invokable-test node bin/mytool.mjs
+
+  ✓ `--version --json` returns a valid ok envelope
+  ✓ `--help --json` returns a command manifest
+  ✓ An unknown command exits 2 with an error envelope
+  ✓ A bare invocation does not exit 0
+  ✓ `doctor --json` reports auth and config state
+  ✓ Every exit code is reserved or in 30-99
+  ✓ `--json` puts exactly one JSON document on stdout
+  ✓ No credential-shaped strings on stdout
+  ✓ Errors carry a `remediation`
+
+  9 passed
+```
+
+Exit 0 when everything passes, 1 otherwise. It works on **any** CLI, not just one
+built with `@invokable/core`: the contract is the product, and the library is one
+way of satisfying it.
+
+## What it will not do
+
+**It never runs a command from your manifest.** Only `--help`, `--version`,
+`doctor` and deliberately invalid invocations are executed. A runner that
+executed every listed command could deploy something or spend the user's money,
+and tools where that matters are exactly the ones this suite exists for.
+
+To include a command you know is safe:
+
+```bash
+invokable-test node bin/mytool.mjs --safe-command "projects list"
+```
+
+**It never reproduces a credential.** The secret-leak check reports the shape and
+the prefix — `a token-shaped string: prefix "mtl_", 36 characters` — never the
+material, because a report gets pasted into issues and CI logs.
+
+## Options
+
+| Option | Effect |
+|---|---|
+| `--json` | Emit the report as JSON on stdout instead of text on stderr. |
+| `--safe-command <cmd>` | Also run this command. Repeatable. |
+| `--timeout <ms>` | Per-invocation timeout. Default 30000. |
+
+## In CI
+
+```yaml
+- run: npx invokable-test node bin/mytool.mjs
+```
+
+A failing check prints why an agent depends on it and a command to reproduce it.

package/bin/invokable-test.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { conformanceMain } from '../dist/index.js';
+
+process.exitCode = await conformanceMain({ argv: process.argv.slice(2) });

package/dist/checks.d.ts

@@ -0,0 +1,25 @@
+import { type ExecOptions } from './exec.js';
+export type CheckStatus = 'pass' | 'fail' | 'warn' | 'skip';
+export interface CheckResult {
+    id: string;
+    title: string;
+    status: CheckStatus;
+    /** What went wrong, or what was observed. */
+    detail?: string;
+    /** Why an agent depends on this. Shown for failures. */
+    rationale: string;
+    invocations: string[];
+}
+export interface CheckContext extends ExecOptions {
+    /** Commands the runner may execute beyond the always-safe set. */
+    extraSafeCommands: readonly string[];
+}
+/**
+ * Every check runs the tool for real. Only commands that cannot change anything
+ * are executed: `--help`, `--version`, `doctor`, and deliberately invalid
+ * invocations. A conformance runner that executed arbitrary commands from the
+ * manifest could deploy something or spend the user's money — the tools this
+ * suite exists to validate are exactly the ones where that matters.
+ */
+export declare function runChecks(ctx: CheckContext): Promise<CheckResult[]>;
+//# sourceMappingURL=checks.d.ts.map

package/dist/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,KAAK,WAAW,EAAmB,MAAM,WAAW,CAAC;AAEtE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,kEAAkE;IAClE,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAkFD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAyLzE"}

package/dist/checks.js

@@ -0,0 +1,231 @@
+import { EXIT, EXIT_NAME, CUSTOM_EXIT_RANGE } from '@invokable/core';
+import { invoke } from './exec.js';
+const VALID_EXIT_CODES = new Set(Object.values(EXIT));
+function isValidExitCode(code) {
+    if (code === null)
+        return false;
+    if (VALID_EXIT_CODES.has(code))
+        return true;
+    return code >= CUSTOM_EXIT_RANGE.min && code <= CUSTOM_EXIT_RANGE.max;
+}
+/** Exactly one JSON document, nothing else. */
+function parseSingleDocument(stdout) {
+    const trimmed = stdout.trim();
+    if (trimmed === '')
+        return { ok: false, reason: 'stdout was empty' };
+    try {
+        return { ok: true, value: JSON.parse(trimmed) };
+    }
+    catch {
+        const lines = trimmed.split('\n').filter((l) => l.trim() !== '');
+        if (lines.length > 1) {
+            return {
+                ok: false,
+                reason: `stdout had ${lines.length} lines and is not one JSON document. ` +
+                    `First line: ${JSON.stringify(lines[0].slice(0, 120))}`,
+            };
+        }
+        return { ok: false, reason: `stdout is not valid JSON: ${JSON.stringify(trimmed.slice(0, 200))}` };
+    }
+}
+function isRecord(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/**
+ * Strings that look like credentials, which must never reach stdout.
+ *
+ * The finding describes the shape and never quotes the material. A report that
+ * reprinted the secret would copy it into CI logs and pasted transcripts — the
+ * exact spread this check exists to prevent.
+ */
+function looksLikeSecret(text) {
+    const patterns = [
+        [
+            /\b([a-z]{2,10})_[A-Za-z0-9]{24,}\b/,
+            (m) => `a token-shaped string: prefix "${m.split('_')[0]}_", ${m.length} characters`,
+        ],
+        [/\bBearer\s+[A-Za-z0-9._-]{16,}/i, (m) => `a Bearer credential, ${m.length} characters`],
+        [/-----BEGIN [A-Z ]*PRIVATE KEY-----/, () => 'a PEM private key block'],
+    ];
+    for (const [re, describe] of patterns) {
+        const m = re.exec(text);
+        if (m)
+            return describe(m[0]);
+    }
+    return null;
+}
+function result(id, title, rationale, status, invocations, detail) {
+    return {
+        id,
+        title,
+        status,
+        rationale,
+        invocations: invocations.map((i) => i.commandLine),
+        ...(detail !== undefined ? { detail } : {}),
+    };
+}
+/**
+ * Every check runs the tool for real. Only commands that cannot change anything
+ * are executed: `--help`, `--version`, `doctor`, and deliberately invalid
+ * invocations. A conformance runner that executed arbitrary commands from the
+ * manifest could deploy something or spend the user's money — the tools this
+ * suite exists to validate are exactly the ones where that matters.
+ */
+export async function runChecks(ctx) {
+    const results = [];
+    const runs = [];
+    const run = async (args) => {
+        const inv = await invoke(ctx, args);
+        runs.push(inv);
+        return inv;
+    };
+    // ---- 1. --version --------------------------------------------------------
+    const version = await run(['--version', '--json']);
+    {
+        const parsed = parseSingleDocument(version.stdout);
+        if (version.timedOut) {
+            results.push(result('version', '`--version --json` responds', RATIONALE.responds, 'fail', [version], 'The process timed out.'));
+        }
+        else if (!parsed.ok) {
+            results.push(result('version', '`--version --json` emits one JSON document', RATIONALE.singleDoc, 'fail', [version], parsed.reason));
+        }
+        else if (!isRecord(parsed.value) || parsed.value['status'] !== 'ok') {
+            results.push(result('version', '`--version --json` returns status ok', RATIONALE.envelope, 'fail', [version], `status was ${JSON.stringify(parsed.value?.['status'])}`));
+        }
+        else {
+            results.push(result('version', '`--version --json` returns a valid ok envelope', RATIONALE.envelope, 'pass', [version]));
+        }
+    }
+    // ---- 2. --help --json is a machine-readable manifest ---------------------
+    const help = await run(['--help', '--json']);
+    {
+        const parsed = parseSingleDocument(help.stdout);
+        const data = isRecord(parsed.value) ? parsed.value['data'] : undefined;
+        const commands = isRecord(data) ? data['commands'] : undefined;
+        if (!parsed.ok) {
+            results.push(result('help', '`--help --json` emits one JSON document', RATIONALE.singleDoc, 'fail', [help], parsed.reason));
+        }
+        else if (!Array.isArray(commands) || commands.length === 0) {
+            results.push(result('help', '`--help --json` lists commands', RATIONALE.manifest, 'fail', [help], 'data.commands was missing or empty. An agent cannot discover the surface.'));
+        }
+        else {
+            results.push(result('help', '`--help --json` returns a command manifest', RATIONALE.manifest, 'pass', [help], `${commands.length} commands`));
+        }
+    }
+    // ---- 3. An unknown command is a usage error, not a crash ----------------
+    const unknown = await run(['definitely-not-a-real-command-xyz', '--json']);
+    {
+        const parsed = parseSingleDocument(unknown.stdout);
+        const env = isRecord(parsed.value) ? parsed.value : undefined;
+        const problems = [];
+        if (unknown.exitCode !== EXIT.usage) {
+            problems.push(`exit was ${unknown.exitCode}, expected ${EXIT.usage} (usage)`);
+        }
+        if (!parsed.ok)
+            problems.push(parsed.reason ?? 'stdout was not one JSON document');
+        else {
+            if (env?.['status'] !== 'error')
+                problems.push(`status was ${JSON.stringify(env?.['status'])}, expected "error"`);
+            if (typeof env?.['code'] !== 'string')
+                problems.push('error envelope has no string `code`');
+            if (typeof env?.['message'] !== 'string')
+                problems.push('error envelope has no string `message`');
+            if (typeof env?.['retryable'] !== 'boolean')
+                problems.push('error envelope has no boolean `retryable`');
+        }
+        results.push(problems.length
+            ? result('unknown-command', 'An unknown command exits 2 with an error envelope', RATIONALE.usage, 'fail', [unknown], problems.join('; '))
+            : result('unknown-command', 'An unknown command exits 2 with an error envelope', RATIONALE.usage, 'pass', [unknown]));
+    }
+    // ---- 4. A bare invocation does not look like success ---------------------
+    const bare = await run(['--json']);
+    {
+        results.push(bare.exitCode === EXIT.ok
+            ? result('bare', 'A bare invocation does not exit 0', RATIONALE.bare, 'fail', [bare], 'Exit 0 with no command tells an agent the work succeeded when nothing ran.')
+            : result('bare', 'A bare invocation does not exit 0', RATIONALE.bare, 'pass', [bare], `exit ${bare.exitCode}`));
+    }
+    // ---- 5. doctor -----------------------------------------------------------
+    const doctor = await run(['doctor', '--json']);
+    {
+        const parsed = parseSingleDocument(doctor.stdout);
+        const data = isRecord(parsed.value) ? parsed.value['data'] : undefined;
+        if (doctor.timedOut) {
+            results.push(result('doctor', '`doctor --json` responds', RATIONALE.doctor, 'fail', [doctor], 'The process timed out.'));
+        }
+        else if (!parsed.ok) {
+            results.push(result('doctor', '`doctor --json` emits one JSON document', RATIONALE.singleDoc, 'fail', [doctor], parsed.reason));
+        }
+        else if (!isRecord(data) || !isRecord(data['auth']) || !isRecord(data['config'])) {
+            results.push(result('doctor', '`doctor --json` reports auth and config', RATIONALE.doctor, 'fail', [doctor], 'Expected data.auth and data.config. An agent uses these to tell "not logged in" from "service down".'));
+        }
+        else {
+            results.push(result('doctor', '`doctor --json` reports auth and config state', RATIONALE.doctor, 'pass', [doctor]));
+        }
+    }
+    // ---- 6. Optional user-nominated safe commands ----------------------------
+    for (const command of ctx.extraSafeCommands) {
+        const args = command.split(/\s+/).filter(Boolean);
+        const inv = await run([...args, '--json']);
+        const parsed = parseSingleDocument(inv.stdout);
+        results.push(parsed.ok
+            ? result(`safe:${command}`, `\`${command} --json\` emits one JSON document`, RATIONALE.singleDoc, 'pass', [inv])
+            : result(`safe:${command}`, `\`${command} --json\` emits one JSON document`, RATIONALE.singleDoc, 'fail', [inv], parsed.reason));
+    }
+    // ---- 7. Cross-cutting: exit codes ---------------------------------------
+    {
+        const bad = runs.filter((r) => !isValidExitCode(r.exitCode));
+        results.push(bad.length
+            ? result('exit-codes', 'Every exit code is reserved or in 30-99', RATIONALE.exitCodes, 'fail', bad, bad.map((r) => `\`${r.commandLine}\` exited ${r.exitCode ?? 'by signal/timeout'}`).join('; '))
+            : result('exit-codes', 'Every exit code is reserved or in 30-99', RATIONALE.exitCodes, 'pass', [], [...new Set(runs.map((r) => r.exitCode))]
+                .sort((a, b) => (a ?? 0) - (b ?? 0))
+                .map((c) => `${c}${c !== null && EXIT_NAME[c] ? ` (${EXIT_NAME[c]})` : ''}`)
+                .join(', ')));
+    }
+    // ---- 8. Cross-cutting: --json stdout purity ------------------------------
+    {
+        const impure = runs.filter((r) => {
+            if (!r.argv.includes('--json') || r.timedOut)
+                return false;
+            return !parseSingleDocument(r.stdout).ok;
+        });
+        results.push(impure.length
+            ? result('json-purity', '`--json` puts exactly one JSON document on stdout', RATIONALE.singleDoc, 'fail', impure, impure.map((r) => `\`${r.commandLine}\`: ${parseSingleDocument(r.stdout).reason}`).join('; '))
+            : result('json-purity', '`--json` puts exactly one JSON document on stdout', RATIONALE.singleDoc, 'pass', []));
+    }
+    // ---- 9. Cross-cutting: no credentials on stdout -------------------------
+    {
+        const leaks = runs
+            .map((r) => ({ run: r, found: looksLikeSecret(r.stdout) }))
+            .filter((x) => x.found !== null);
+        results.push(leaks.length
+            ? result('no-secrets', 'No credential-shaped strings on stdout', RATIONALE.secrets, 'fail', leaks.map((l) => l.run), leaks.map((l) => `\`${l.run.commandLine}\` printed ${l.found}`).join('; '))
+            : result('no-secrets', 'No credential-shaped strings on stdout', RATIONALE.secrets, 'pass', []));
+    }
+    // ---- 10. Cross-cutting: errors carry remediation -------------------------
+    {
+        const errors = runs
+            .filter((r) => r.argv.includes('--json'))
+            .map((r) => parseSingleDocument(r.stdout).value)
+            .filter((v) => isRecord(v) && v['status'] === 'error');
+        const missing = errors.filter((e) => typeof e['remediation'] !== 'string');
+        results.push(errors.length === 0
+            ? result('remediation', 'Errors carry a `remediation`', RATIONALE.remediation, 'skip', [], 'No error envelopes were produced.')
+            : missing.length
+                ? result('remediation', 'Errors carry a `remediation`', RATIONALE.remediation, 'warn', [], `${missing.length} of ${errors.length} error envelopes had no remediation.`)
+                : result('remediation', 'Errors carry a `remediation`', RATIONALE.remediation, 'pass', []));
+    }
+    return results;
+}
+const RATIONALE = {
+    responds: 'An agent that gets no response cannot tell a hang from a failure.',
+    singleDoc: 'The agent parses stdout as one JSON document. A stray log line makes the parse fail, and the agent reports a broken tool rather than the real result.',
+    envelope: 'The agent reads `status` before anything else.',
+    manifest: '`--help --json` is how an agent discovers commands and options instead of guessing them.',
+    usage: 'A mistyped command must be distinguishable from a real failure, or the agent retries something that can never work.',
+    bare: 'Exit 0 with no command run tells the agent the task is done.',
+    doctor: '`doctor` is how an agent tells "not logged in" from "service unreachable" — the two failures that look identical from outside.',
+    exitCodes: 'The agent decides what to do next from the exit code alone. An unreserved code means it has no rule to apply.',
+    secrets: 'stdout is captured, logged and often echoed back into a transcript.',
+    remediation: 'Without it the agent has to invent the next command.',
+};
+//# sourceMappingURL=checks.js.map

package/dist/checks.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+export interface MainOptions {
+    argv: readonly string[];
+    stdout?: (s: string) => void;
+    stderr?: (s: string) => void;
+}
+/** Returns the process exit code. */
+export declare function conformanceMain(options: MainOptions): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAsBD,qCAAqC;AACrC,wBAAsB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CA0D3E"}

package/dist/cli.js

@@ -0,0 +1,80 @@
+import { runChecks } from './checks.js';
+import { renderReport, summarise } from './report.js';
+const USAGE = `Usage: invokable-test <command> [args...] [options]
+
+Checks that a CLI honours the invokable agent contract.
+
+  invokable-test ./bin/mytool.mjs
+  invokable-test node ./bin/mytool.mjs
+  invokable-test npx mytool
+
+Options:
+      --json                 Emit the report as JSON on stdout.
+      --safe-command <cmd>   Additionally run this command (repeatable).
+                             Only pass commands that change nothing.
+      --timeout <ms>         Per-invocation timeout. Default 30000.
+  -h, --help                 Show this help.
+
+Only commands that cannot change anything are run: --help, --version, doctor,
+and deliberately invalid invocations. Commands from the manifest are never
+executed on their own, because one of them may spend the user's money.
+`;
+/** Returns the process exit code. */
+export async function conformanceMain(options) {
+    const stdout = options.stdout ?? ((s) => process.stdout.write(s));
+    const stderr = options.stderr ?? ((s) => process.stderr.write(s));
+    const argv = [...options.argv];
+    let json = false;
+    let timeoutMs = 30_000;
+    const safeCommands = [];
+    const target = [];
+    for (let i = 0; i < argv.length; i++) {
+        const token = argv[i];
+        if (token === '--json') {
+            json = true;
+        }
+        else if (token === '--help' || token === '-h') {
+            stderr(USAGE);
+            return 0;
+        }
+        else if (token === '--safe-command') {
+            const value = argv[++i];
+            if (value === undefined) {
+                stderr('error: --safe-command needs a value\n');
+                return 2;
+            }
+            safeCommands.push(value);
+        }
+        else if (token === '--timeout') {
+            const value = Number(argv[++i]);
+            if (!Number.isFinite(value) || value <= 0) {
+                stderr('error: --timeout must be a positive number of milliseconds\n');
+                return 2;
+            }
+            timeoutMs = value;
+        }
+        else {
+            target.push(token);
+        }
+    }
+    const command = target[0];
+    if (command === undefined) {
+        stderr(USAGE);
+        return 2;
+    }
+    const checks = await runChecks({
+        command,
+        baseArgs: target.slice(1),
+        timeoutMs,
+        extraSafeCommands: safeCommands,
+    });
+    const report = summarise(target.join(' '), checks);
+    if (json) {
+        stdout(JSON.stringify(report) + '\n');
+    }
+    else {
+        stderr(renderReport(report));
+    }
+    return report.ok ? 0 : 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/exec.d.ts

@@ -0,0 +1,27 @@
+export interface Invocation {
+    /** Args passed after the base command. */
+    argv: readonly string[];
+    /** The full command line, for reproducing the run. */
+    commandLine: string;
+    stdout: string;
+    stderr: string;
+    /** Null when the process was killed by a signal or timed out. */
+    exitCode: number | null;
+    timedOut: boolean;
+    durationMs: number;
+}
+export interface ExecOptions {
+    command: string;
+    baseArgs: readonly string[];
+    timeoutMs?: number;
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+}
+/**
+ * Runs the tool under test as a real subprocess.
+ *
+ * Everything is measured on actual file descriptors: stdout purity is only
+ * meaningful at the process boundary, which is where the agent reads it.
+ */
+export declare function invoke(opts: ExecOptions, args: readonly string[]): Promise<Invocation>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAoCtF"}

package/dist/exec.js

@@ -0,0 +1,39 @@
+import { execFile } from 'node:child_process';
+/**
+ * Runs the tool under test as a real subprocess.
+ *
+ * Everything is measured on actual file descriptors: stdout purity is only
+ * meaningful at the process boundary, which is where the agent reads it.
+ */
+export function invoke(opts, args) {
+    const argv = [...opts.baseArgs, ...args];
+    const started = Date.now();
+    return new Promise((resolve) => {
+        execFile(opts.command, argv, {
+            timeout: opts.timeoutMs ?? 30_000,
+            maxBuffer: 16 * 1024 * 1024,
+            ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
+            env: {
+                ...process.env,
+                ...opts.env,
+                // Keep the tool from picking up ambient credentials or an interactive
+                // path: a conformance run must be reproducible on any machine.
+                NO_COLOR: '1',
+                CI: '1',
+            },
+        }, (error, stdout, stderr) => {
+            const err = error;
+            const timedOut = Boolean(err?.killed) || err?.code === 'ETIMEDOUT';
+            resolve({
+                argv,
+                commandLine: [opts.command, ...argv].join(' '),
+                stdout: String(stdout),
+                stderr: String(stderr),
+                exitCode: timedOut ? null : typeof err?.code === 'number' ? err.code : 0,
+                timedOut,
+                durationMs: Date.now() - started,
+            });
+        });
+    });
+}
+//# sourceMappingURL=exec.js.map

package/dist/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../src/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAuB9C;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,IAAiB,EAAE,IAAuB;IAC/D,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,QAAQ,CACN,IAAI,CAAC,OAAO,EACZ,IAAI,EACJ;YACE,OAAO,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM;YACjC,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;YAC3B,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,GAAG,IAAI,CAAC,GAAG;gBACX,sEAAsE;gBACtE,+DAA+D;gBAC/D,QAAQ,EAAE,GAAG;gBACb,EAAE,EAAE,GAAG;aACR;SACF,EACD,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACxB,MAAM,GAAG,GAAG,KAAsE,CAAC;YACnF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,GAAG,EAAE,IAAI,KAAK,WAAW,CAAC;YACnE,OAAO,CAAC;gBACN,IAAI;gBACJ,WAAW,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;gBACtB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;gBACtB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACxE,QAAQ;gBACR,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;aACjC,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { runChecks } from './checks.js';
+export type { CheckResult, CheckStatus, CheckContext } from './checks.js';
+export { summarise, renderReport } from './report.js';
+export type { Report } from './report.js';
+export { invoke } from './exec.js';
+export type { Invocation, ExecOptions } from './exec.js';
+export { conformanceMain } from './cli.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { runChecks } from './checks.js';
+export { summarise, renderReport } from './report.js';
+export { invoke } from './exec.js';
+export { conformanceMain } from './cli.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGtD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/report.d.ts

@@ -0,0 +1,13 @@
+import type { CheckResult } from './checks.js';
+export interface Report {
+    command: string;
+    passed: number;
+    failed: number;
+    warnings: number;
+    skipped: number;
+    ok: boolean;
+    checks: CheckResult[];
+}
+export declare function summarise(command: string, checks: CheckResult[]): Report;
+export declare function renderReport(report: Report): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,aAAa,CAAC;AAE5D,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAYxE;AASD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAgCnD"}

package/dist/report.js

@@ -0,0 +1,74 @@
+export function summarise(command, checks) {
+    const count = (s) => checks.filter((c) => c.status === s).length;
+    const failed = count('fail');
+    return {
+        command,
+        passed: count('pass'),
+        failed,
+        warnings: count('warn'),
+        skipped: count('skip'),
+        ok: failed === 0,
+        checks,
+    };
+}
+const GLYPH = {
+    pass: '✓',
+    fail: '✗',
+    warn: '!',
+    skip: '–',
+};
+export function renderReport(report) {
+    const lines = [];
+    lines.push('');
+    lines.push(`invokable conformance — ${report.command}`);
+    lines.push('');
+    for (const check of report.checks) {
+        lines.push(`  ${GLYPH[check.status]} ${check.title}`);
+        if (check.detail && check.status !== 'pass') {
+            for (const line of wrap(check.detail, 70))
+                lines.push(`      ${line}`);
+        }
+        else if (check.detail) {
+            lines.push(`      ${check.detail}`);
+        }
+        // The rationale is shown only on failure: it is the part that tells someone
+        // why the contract cares, which is what they need when deciding to fix it.
+        if (check.status === 'fail' || check.status === 'warn') {
+            for (const line of wrap(`Why: ${check.rationale}`, 70))
+                lines.push(`      ${line}`);
+            if (check.invocations.length) {
+                lines.push(`      Reproduce: ${check.invocations[0]}`);
+            }
+            lines.push('');
+        }
+    }
+    lines.push('');
+    const parts = [`${report.passed} passed`];
+    if (report.failed)
+        parts.push(`${report.failed} failed`);
+    if (report.warnings)
+        parts.push(`${report.warnings} warning${report.warnings === 1 ? '' : 's'}`);
+    if (report.skipped)
+        parts.push(`${report.skipped} skipped`);
+    lines.push(`  ${parts.join(', ')}`);
+    lines.push('');
+    return lines.join('\n');
+}
+function wrap(text, width) {
+    const out = [];
+    let line = '';
+    for (const word of text.split(/\s+/)) {
+        if (line === '')
+            line = word;
+        else if ((line + ' ' + word).length <= width)
+            line += ' ' + word;
+        else {
+            out.push(line);
+            line = word;
+        }
+    }
+    if (line)
+        out.push(line);
+    return out;
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@invokable/conformance",
+  "version": "0.1.0",
+  "description": "Checks that a CLI honours the invokable agent contract.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "invokable-test": "./bin/invokable-test.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "bin",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@invokable/core": "^0.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/beinvokable/invokable.git",
+    "directory": "packages/conformance"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}