cognitive-modules-cli 2.2.10 → 2.2.12

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to this package are documented in this file.
 
+## 2.2.12 - 2026-02-08
+
+- Conformance: add `runtime` suite (offline, deterministic vectors) to validate publish-grade JSON parsing and profile gates.
+- UX: conformance help/usage now documents `--suite runtime` explicitly.
+
+## 2.2.11 - 2026-02-07
+
+- Fix: Gemini `responseSchema` compatibility by dropping non-string `enum`/`const` constraints (Gemini rejects boolean enums).
+
 ## 2.2.10 - 2026-02-07
 
 - Fix: Gemini `responseSchema` compatibility by converting JSON-Schema `const` to `enum`.

package/README.md

@@ -2,20 +2,19 @@
 
 [![npm version](https://badge.fury.io/js/cognitive-modules-cli.svg)](https://www.npmjs.com/package/cognitive-modules-cli)
 
-Node.js/TypeScript 版本的 Cognitive Modules CLI，提供 `cog` 命令。
+Node.js/TypeScript 版本的 Cognitive Modules CLI。文档统一使用明确入口 `npx cogn@2.2.12 ...`，避免 PATH/命令冲突。
 
 > 这是 [cognitive-modules](../../README.md) monorepo 的一部分。
 
 ## 安装
 
 ```bash
-# 全局安装（推荐）
-npm install -g cogn@2.2.10
-# 或使用完整包名（同样提供 `cog` 命令）
-# npm install -g cognitive-modules-cli@2.2.10
+# 零安装（推荐）
+npx cogn@2.2.12 --help
 
-# 或使用 npx 零安装
-npx cogn@2.2.10 --help
+# 全局安装（可选）
+npm install -g cogn@2.2.12
+# 或：npm install -g cognitive-modules-cli@2.2.12
 ```
 
 ## 快速开始
@@ -24,14 +23,17 @@ npx cogn@2.2.10 --help
 # 配置 LLM
 export OPENAI_API_KEY=sk-xxx
 
+# 查看 providers 能力矩阵（结构化输出/流式）
+npx cogn@2.2.12 providers --pretty
+
 # 运行模块
-cog run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
+npx cogn@2.2.12 run code-reviewer --args "def login(u,p): return db.query(f'SELECT * FROM users WHERE name={u}')" --pretty
 
 # 列出模块
-cog list
+npx cogn@2.2.12 list
 
 # 管道模式
-echo "review this code" | cog pipe --module code-reviewer
+echo "review this code" | npx cogn@2.2.12 pipe --module code-reviewer
 ```
 
 ## 支持的 Provider
@@ -51,53 +53,58 @@ echo "review this code" | cog pipe --module code-reviewer
 
 ```bash
 # Core（单文件极简路径）
-cog core new                       # 生成 demo.md
-cog core run demo.md --args "..."  # 运行单文件模块
-cog core promote demo.md           # 升级为 v2 模块目录
+npx cogn@2.2.12 core new                       # 生成 demo.md
+npx cogn@2.2.12 core run demo.md --args "..."  # 运行单文件模块
+npx cogn@2.2.12 core promote demo.md           # 升级为 v2 模块目录
 
 # 渐进复杂度（Profiles）
-cog run code-reviewer --args "..." --profile core       # 极简：跳过校验
-cog run code-reviewer --args "..." --profile default    # 默认：开启校验
-cog run code-reviewer --args "..." --profile strict     # 更严格：开启校验（更强门禁）
-cog run code-reviewer --args "..." --profile certified  # 最严格：v2.2 + 审计 + registry provenance/完整性门禁
-# 覆盖开关：--validate auto|on|off，--audit（写入 ~/.cognitive/audit/）
+npx cogn@2.2.12 run code-reviewer --args "..." --profile core       # 极简：跳过校验
+npx cogn@2.2.12 run code-reviewer --args "..." --profile standard   # 推荐：日常默认
+npx cogn@2.2.12 run code-reviewer --args "..." --profile certified  # 最严格：v2.2 + 审计 + registry provenance/完整性门禁
+# 兼容别名（不推荐写进新文档）：
+# - default -> standard
+# - strict  -> standard（deprecated preset）
+# 覆盖开关：
+# - --validate auto|on|off
+# - --structured auto|off|prompt|native（provider 层结构化输出策略）
+# - --audit（写入 ~/.cognitive/audit/）
 
 # 模块操作
-cog list                      # 列出模块
-cog run <module> --args "..." # 运行模块
-cog add <url> -m <module>     # 从 GitHub 添加模块
-cog update <module>           # 更新模块
-cog remove <module>           # 删除模块
-cog versions <url>            # 查看可用版本
-cog init <name>               # 创建新模块
-cog pipe --module <name>      # 管道模式
+npx cogn@2.2.12 list                      # 列出模块
+npx cogn@2.2.12 run <module> --args "..." # 运行模块
+npx cogn@2.2.12 add <url> -m <module>     # 从 GitHub 添加模块
+npx cogn@2.2.12 update <module>           # 更新模块
+npx cogn@2.2.12 remove <module>           # 删除模块
+npx cogn@2.2.12 versions <url>            # 查看可用版本
+npx cogn@2.2.12 init <name>               # 创建新模块
+npx cogn@2.2.12 pipe --module <name>      # 管道模式
 
 # 组合执行
-cog compose <module> --args "..."
-cog compose-info <module>
+npx cogn@2.2.12 compose <module> --args "..."
+npx cogn@2.2.12 compose-info <module>
 
 # 校验与迁移
-cog validate <module> --v22
-cog validate --all
-cog migrate <module> --dry-run
-cog migrate --all --no-backup
+npx cogn@2.2.12 validate <module> --v22
+npx cogn@2.2.12 validate --all
+npx cogn@2.2.12 migrate <module> --dry-run
+npx cogn@2.2.12 migrate --all --no-backup
 
 # 服务器
-cog serve --port 8000         # 启动 HTTP API 服务
-cog mcp                       # 启动 MCP 服务（Claude Code / Cursor）
+npx cogn@2.2.12 serve --port 8000         # 启动 HTTP API 服务
+npx cogn@2.2.12 mcp                       # 启动 MCP 服务（Claude Code / Cursor）
 
 # 环境检查
-cog doctor
+npx cogn@2.2.12 doctor
 
 # Registry（索引与分发）
 # 默认 registry index（latest）：
 #   https://github.com/Cognary/cognitive/releases/latest/download/cognitive-registry.v2.json
 # 可通过环境变量或全局参数覆盖：
-COGNITIVE_REGISTRY_URL=... cog search
-COGNITIVE_REGISTRY_TIMEOUT_MS=15000 COGNITIVE_REGISTRY_MAX_BYTES=2097152 cog search
-cog search --registry https://github.com/Cognary/cognitive/releases/download/v2.2.10/cognitive-registry.v2.json
-cog registry verify --remote --index https://github.com/Cognary/cognitive/releases/latest/download/cognitive-registry.v2.json
-cog registry verify --remote --concurrency 2
+COGNITIVE_REGISTRY_URL=... npx cogn@2.2.12 search
+COGNITIVE_REGISTRY_TIMEOUT_MS=15000 COGNITIVE_REGISTRY_MAX_BYTES=2097152 npx cogn@2.2.12 search
+npx cogn@2.2.12 search --registry https://github.com/Cognary/cognitive/releases/download/vX.Y.Z/cognitive-registry.v2.json
+npx cogn@2.2.12 registry verify --remote --index https://github.com/Cognary/cognitive/releases/latest/download/cognitive-registry.v2.json
+npx cogn@2.2.12 registry verify --remote --concurrency 2
 ```
 
 ## 开发

package/dist/cli-args.d.ts

@@ -0,0 +1,34 @@
+export type CliParseResult = {
+    command?: string;
+    /**
+     * Positionals after the command (subcommand/module name/query words).
+     * This intentionally matches the historical meaning of `positionals` in `cli.ts`
+     * (i.e., it does NOT include the command itself).
+     */
+    positionals: string[];
+    /**
+     * Convenience array shaped like `process.argv.slice(2)` used to be:
+     * args[0] = command, args[1] = first positional after command.
+     */
+    args: string[];
+    values: Record<string, unknown>;
+};
+/**
+ * Recover from `npx`/`npm exec` swallowing unknown flags.
+ *
+ * Example user intent:
+ *   npx cogn@X --provider minimax --model MiniMax-M2.1 core run --stdin ...
+ *
+ * Some `npx` flows interpret `--provider/--model` as `npx` flags and strip them,
+ * leaving the values as positionals:
+ *   minimax MiniMax-M2.1 core run --stdin ...
+ *
+ * This normalization attempts to restore:
+ * - command = core
+ * - values.provider/model = prelude tokens
+ * - positionals = remaining args after core
+ *
+ * We intentionally scope the recovery to the "core" entrypoint to avoid masking real typos.
+ */
+export declare function normalizeCliParseResult(parsed: CliParseResult): CliParseResult;
+export declare function parseCliArgs(argv: string[]): CliParseResult;

package/dist/cli-args.js

@@ -0,0 +1,149 @@
+import { parseArgs } from 'node:util';
+const KNOWN_COMMANDS = new Set([
+    'run',
+    'list',
+    'pipe',
+    'init',
+    'add',
+    'update',
+    'remove',
+    'versions',
+    'compose',
+    'compose-info',
+    'validate',
+    'migrate',
+    'test',
+    'conformance',
+    'search',
+    'categories',
+    'info',
+    'providers',
+    'registry',
+    'serve',
+    'doctor',
+    'mcp',
+    'core',
+]);
+/**
+ * Recover from `npx`/`npm exec` swallowing unknown flags.
+ *
+ * Example user intent:
+ *   npx cogn@X --provider minimax --model MiniMax-M2.1 core run --stdin ...
+ *
+ * Some `npx` flows interpret `--provider/--model` as `npx` flags and strip them,
+ * leaving the values as positionals:
+ *   minimax MiniMax-M2.1 core run --stdin ...
+ *
+ * This normalization attempts to restore:
+ * - command = core
+ * - values.provider/model = prelude tokens
+ * - positionals = remaining args after core
+ *
+ * We intentionally scope the recovery to the "core" entrypoint to avoid masking real typos.
+ */
+export function normalizeCliParseResult(parsed) {
+    const command = parsed.command;
+    if (!command)
+        return parsed;
+    if (KNOWN_COMMANDS.has(command))
+        return parsed;
+    const allPositionals = [command, ...parsed.positionals];
+    const coreIdx = allPositionals.indexOf('core');
+    if (coreIdx <= 0)
+        return parsed;
+    const prelude = allPositionals.slice(0, coreIdx);
+    const rest = allPositionals.slice(coreIdx + 1);
+    const values = { ...parsed.values };
+    if (values.provider === undefined && prelude[0])
+        values.provider = prelude[0];
+    if (values.model === undefined && prelude[1])
+        values.model = prelude[1];
+    return {
+        command: 'core',
+        positionals: rest,
+        args: ['core', ...rest],
+        values,
+    };
+}
+export function parseCliArgs(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: {
+            help: { type: 'boolean', short: 'h', default: false },
+            version: { type: 'boolean', short: 'v', default: false },
+            stdin: { type: 'boolean', default: false }, // core: read module prompt from stdin
+            force: { type: 'boolean', default: false }, // core promote: overwrite existing target dir
+            profile: { type: 'string' }, // progressive complexity profile
+            validate: { type: 'string' }, // auto|on|off (overrides --no-validate)
+            audit: { type: 'boolean', default: false }, // write audit record to ~/.cognitive/audit/
+            structured: { type: 'string' }, // auto|off|prompt|native (provider structured output strategy)
+            args: { type: 'string', short: 'a' },
+            input: { type: 'string', short: 'i' },
+            module: { type: 'string', short: 'm' },
+            model: { type: 'string', short: 'M' },
+            provider: { type: 'string', short: 'p' },
+            pretty: { type: 'boolean', default: false },
+            verbose: { type: 'boolean', short: 'V', default: false },
+            'no-validate': { type: 'boolean', default: false },
+            stream: { type: 'boolean', default: false },
+            // Add/update options
+            name: { type: 'string', short: 'n' },
+            tag: { type: 'string', short: 't' },
+            branch: { type: 'string', short: 'b' },
+            limit: { type: 'string', short: 'l' },
+            // Server options
+            host: { type: 'string', short: 'H' },
+            port: { type: 'string', short: 'P' },
+            // Compose options
+            'max-depth': { type: 'string', short: 'd' },
+            timeout: { type: 'string', short: 'T' },
+            trace: { type: 'boolean', default: false },
+            // Conformance (spec vectors)
+            conformance: { type: 'boolean', default: false }, // test: run official spec vectors
+            suite: { type: 'string' }, // envelope|stream|registry|all
+            level: { type: 'string' }, // 1|2|3
+            'spec-dir': { type: 'string' }, // repo root or <root>/spec
+            json: { type: 'boolean', default: false }, // conformance: machine-readable output
+            // Validate/migrate options
+            v22: { type: 'boolean', default: false },
+            'dry-run': { type: 'boolean', default: false },
+            'no-backup': { type: 'boolean', default: false },
+            all: { type: 'boolean', default: false },
+            format: { type: 'string', short: 'f' },
+            // Search options
+            category: { type: 'string', short: 'c' },
+            registry: { type: 'string' }, // override registry index URL (or use env COGNITIVE_REGISTRY_URL)
+            'registry-timeout-ms': { type: 'string' },
+            'registry-max-bytes': { type: 'string' },
+            // Registry build/verify options
+            'modules-dir': { type: 'string' },
+            'v1-registry': { type: 'string' },
+            'out-dir': { type: 'string' },
+            'registry-out': { type: 'string' },
+            namespace: { type: 'string' },
+            'runtime-min': { type: 'string' },
+            repository: { type: 'string' },
+            homepage: { type: 'string' },
+            license: { type: 'string' },
+            timestamp: { type: 'string' },
+            only: { type: 'string', multiple: true },
+            index: { type: 'string' },
+            'assets-dir': { type: 'string' },
+            'tarball-base-url': { type: 'string' },
+            remote: { type: 'boolean', default: false }, // registry verify: fetch index + tarballs over network
+            'fetch-timeout-ms': { type: 'string' },
+            'max-index-bytes': { type: 'string' },
+            'max-tarball-bytes': { type: 'string' },
+            concurrency: { type: 'string' },
+        },
+        allowPositionals: true,
+    });
+    const command = positionals[0];
+    const rest = positionals.slice(1);
+    return {
+        command,
+        positionals: rest,
+        args: command ? [command, ...rest] : [],
+        values: values,
+    };
+}

package/dist/cli.js

@@ -13,90 +13,28 @@
  *
  * npx cognitive-modules add ziel-io/cognitive-modules -m code-simplifier
  */
-import { parseArgs } from 'node:util';
+import { normalizeCliParseResult, parseCliArgs } from './cli-args.js';
 import { getProvider, listProviders } from './providers/index.js';
-import { run, list, pipe, init, add, update, remove, versions, compose, composeInfo, validate, validateAll, migrate, migrateAll, test, testAll, search, listCategories, info, core } from './commands/index.js';
+import { run, list, pipe, init, add, update, remove, versions, compose, composeInfo, validate, validateAll, migrate, migrateAll, test, testAll, conformance, search, listCategories, info, core } from './commands/index.js';
 import { listModules, getDefaultSearchPaths } from './modules/loader.js';
 import { VERSION } from './version.js';
 import { resolveExecutionPolicy } from './profile.js';
 import { buildRegistryAssets, verifyRegistryAssets } from './registry/assets.js';
 import { DEFAULT_REGISTRY_URL } from './registry/client.js';
 async function main() {
-    const args = process.argv.slice(2);
-    const command = args[0];
-    if (!command || command === '--help' || command === '-h') {
-        printHelp();
+    const parsed = normalizeCliParseResult(parseCliArgs(process.argv.slice(2)));
+    const values = parsed.values;
+    const positionals = parsed.positionals;
+    const args = parsed.args;
+    const command = parsed.command;
+    if (values.version) {
+        console.log(`Cognitive Runtime v${VERSION}`);
         process.exit(0);
     }
-    if (command === '--version' || command === '-v') {
-        console.log(`Cognitive Runtime v${VERSION}`);
+    if (!command) {
+        printHelp();
         process.exit(0);
     }
-    // Parse common options
-    const { values, positionals } = parseArgs({
-        args: args.slice(1),
-        options: {
-            help: { type: 'boolean', short: 'h', default: false },
-            stdin: { type: 'boolean', default: false }, // core: read module prompt from stdin
-            force: { type: 'boolean', default: false }, // core promote: overwrite existing target dir
-            profile: { type: 'string' }, // progressive complexity profile
-            validate: { type: 'string' }, // auto|on|off (overrides --no-validate)
-            audit: { type: 'boolean', default: false }, // write audit record to ~/.cognitive/audit/
-            args: { type: 'string', short: 'a' },
-            input: { type: 'string', short: 'i' },
-            module: { type: 'string', short: 'm' },
-            model: { type: 'string', short: 'M' },
-            provider: { type: 'string', short: 'p' },
-            pretty: { type: 'boolean', default: false },
-            verbose: { type: 'boolean', short: 'V', default: false },
-            'no-validate': { type: 'boolean', default: false },
-            stream: { type: 'boolean', default: false },
-            // Add/update options
-            name: { type: 'string', short: 'n' },
-            tag: { type: 'string', short: 't' },
-            branch: { type: 'string', short: 'b' },
-            limit: { type: 'string', short: 'l' },
-            // Server options
-            host: { type: 'string', short: 'H' },
-            port: { type: 'string', short: 'P' },
-            // Compose options
-            'max-depth': { type: 'string', short: 'd' },
-            timeout: { type: 'string', short: 'T' },
-            trace: { type: 'boolean', default: false },
-            // Validate/migrate options
-            v22: { type: 'boolean', default: false },
-            'dry-run': { type: 'boolean', default: false },
-            'no-backup': { type: 'boolean', default: false },
-            all: { type: 'boolean', default: false },
-            format: { type: 'string', short: 'f' },
-            // Search options
-            category: { type: 'string', short: 'c' },
-            registry: { type: 'string' }, // override registry index URL (or use env COGNITIVE_REGISTRY_URL)
-            'registry-timeout-ms': { type: 'string' },
-            'registry-max-bytes': { type: 'string' },
-            // Registry build/verify options
-            'modules-dir': { type: 'string' },
-            'v1-registry': { type: 'string' },
-            'out-dir': { type: 'string' },
-            'registry-out': { type: 'string' },
-            namespace: { type: 'string' },
-            'runtime-min': { type: 'string' },
-            repository: { type: 'string' },
-            homepage: { type: 'string' },
-            license: { type: 'string' },
-            timestamp: { type: 'string' },
-            only: { type: 'string', multiple: true },
-            index: { type: 'string' },
-            'assets-dir': { type: 'string' },
-            'tarball-base-url': { type: 'string' },
-            remote: { type: 'boolean', default: false }, // registry verify: fetch index + tarballs over network
-            'fetch-timeout-ms': { type: 'string' },
-            'max-index-bytes': { type: 'string' },
-            'max-tarball-bytes': { type: 'string' },
-            concurrency: { type: 'string' },
-        },
-        allowPositionals: true,
-    });
     if (values.help) {
         if (command === 'core') {
             console.log(JSON.stringify({
@@ -140,12 +78,30 @@ async function main() {
             validate: values.validate,
             noValidate: values['no-validate'],
             audit: values.audit,
+            structured: values.structured,
         });
     }
     catch (e) {
         console.error(`Error: ${e instanceof Error ? e.message : String(e)}`);
         process.exit(1);
     }
+    // Progressive Complexity: `cog core ...` defaults to the `core` profile unless explicitly overridden.
+    // This keeps the "5-minute path" minimal by default (no schema enforcement unless requested).
+    if (command === 'core' && (values.profile === undefined || values.profile === null || String(values.profile).trim() === '')) {
+        try {
+            policy = resolveExecutionPolicy({
+                profile: 'core',
+                validate: values.validate,
+                noValidate: values['no-validate'],
+                audit: values.audit,
+                structured: values.structured,
+            });
+        }
+        catch (e) {
+            console.error(`Error: ${e instanceof Error ? e.message : String(e)}`);
+            process.exit(1);
+        }
+    }
     const parsePositive = (key, raw) => {
         if (raw === undefined || raw === null || raw === '')
             return undefined;
@@ -299,6 +255,8 @@ async function main() {
                     const apiKeyStatus = p.configured ? 'API key set' : 'not configured';
                     console.log(`  ${status} ${p.name}`);
                     console.log(`      Model: ${p.model}`);
+                    console.log(`      Structured output: ${p.structuredOutput}`);
+                    console.log(`      Streaming: ${p.streaming ? 'yes' : 'no'}`);
                     console.log(`      Status: ${apiKeyStatus}`);
                     if (p.configured)
                         hasConfiguredProvider = true;
@@ -396,6 +354,11 @@ async function main() {
                 console.log('For more help: cog --help');
                 break;
             }
+            case 'providers': {
+                const providers = listProviders();
+                console.log(JSON.stringify({ providers }, null, values.pretty ? 2 : 0));
+                break;
+            }
             case 'add': {
                 const url = args[1];
                 if (!url || url.startsWith('-')) {
@@ -689,6 +652,43 @@ async function main() {
             }
             case 'test': {
                 const target = args[1];
+                if (values.conformance) {
+                    const result = await conformance(ctx, {
+                        specDir: values['spec-dir'],
+                        suite: values.suite,
+                        level: values.level ? parseInt(values.level, 10) : undefined,
+                        verbose: values.verbose,
+                        json: values.json,
+                    });
+                    if (!result.success && !result.data) {
+                        console.error(`Error: ${result.error ?? 'Unknown error'}`);
+                        process.exit(1);
+                    }
+                    if (values.json || values.pretty) {
+                        console.log(JSON.stringify(result.data, null, values.pretty ? 2 : 0));
+                        process.exit(result.success ? 0 : 1);
+                    }
+                    const data = result.data;
+                    console.log('═══════════════════════════════════════════════════════════');
+                    console.log('Conformance Vectors');
+                    console.log('═══════════════════════════════════════════════════════════');
+                    console.log(`Suite: ${data.suite}  Level: ${data.level}`);
+                    console.log(`Spec:  ${data.spec_dir}`);
+                    console.log(`Total: ${data.total}, Passed: ${data.passed}, Failed: ${data.failed}`);
+                    if (data.failed > 0) {
+                        console.log('');
+                        console.log('Failures:');
+                        for (const r of data.results) {
+                            if (r.passed)
+                                continue;
+                            const phase = r.phase ? ` (${r.phase})` : '';
+                            console.log(`  ✗ ${r.file}${phase}`);
+                            if (r.error)
+                                console.log(`    ${r.error}`);
+                        }
+                    }
+                    process.exit(result.success ? 0 : 1);
+                }
                 if (values.all) {
                     // Test all modules
                     console.log('→ Running tests for all modules...\n');
@@ -720,7 +720,8 @@ async function main() {
                     process.exit(result.success ? 0 : 1);
                 }
                 if (!target || target.startsWith('-')) {
-                    console.error('Usage: cog test <module> [--all] [--verbose] [--timeout <ms>]');
+                    console.error('Usage: cog test <module> [--all] [--verbose] [--timeout <ms>]\n' +
+                        '       cog test --conformance [--suite envelope|runtime|stream|registry|all] [--level 1|2|3] [--spec-dir <path>] [--json]');
                     process.exit(1);
                 }
                 console.log(`→ Running tests for module: ${target}\n`);
@@ -975,6 +976,7 @@ USAGE:
 
 COMMANDS:
   core <cmd>          Minimal "one-file" workflow (new, schema, run)
+  providers           List providers (capabilities + configuration)
   run <module>        Run a Cognitive Module
   test <module>       Run golden tests for a module
   compose <module>    Execute a composed module workflow
@@ -995,8 +997,9 @@ COMMANDS:
   doctor              Check environment and configuration
 
 OPTIONS:
-  --profile <name>     Progressive complexity profile: core|default|strict|certified
+  --profile <name>     Progressive complexity profile: core|standard|certified (aliases: default, strict)
   --validate <mode>    Validation mode: auto|on|off (overrides --no-validate)
+  --structured <mode>  Structured output strategy: auto|off|prompt|native
   --audit              Write an audit record to ~/.cognitive/audit/ (stderr prints path)
   -a, --args <str>      Arguments to pass to module
   -i, --input <json>    JSON input for module
@@ -1020,6 +1023,11 @@ OPTIONS:
   --dry-run             Show what would be done without changes (for migrate)
   --no-backup           Skip backup before migration (for migrate)
   --all                 Process all modules (for validate/migrate)
+  --conformance         Run official spec vectors (for test)
+  --suite <name>        Conformance suite: envelope|runtime|stream|registry|all
+  --level <n>           Conformance level: 1|2|3
+  --spec-dir <path>     Repo root or spec dir (defaults: auto-detect)
+  --json                Machine-readable JSON output (for conformance)
   -f, --format <fmt>    Output format: text or json (for validate)
   -c, --category <cat>  Filter by category (for search)
   --registry <url>      Override registry index URL (or set env COGNITIVE_REGISTRY_URL)
@@ -1062,6 +1070,9 @@ EXAMPLES:
   cog test code-simplifier              # Run golden tests
   cog test code-simplifier --verbose    # With detailed output
   cog test --all                        # Test all modules
+  cog test --conformance --suite envelope --level 1  # Minimal conformance (envelope only)
+  cog test --conformance --suite all --level 2       # Level 2 contract (envelope+runtime)
+  cog test --conformance --suite all --level 3       # Full conformance (envelope+runtime+stream+registry)
   cog migrate code-reviewer --dry-run
   cog migrate code-reviewer
   cog migrate --all --no-backup

package/dist/commands/add.js

@@ -367,7 +367,7 @@ export async function addFromRegistry(moduleSpec, ctx, options = {}) {
                     success: false,
                     error: `Certified profile requires registry tarball provenance.\n` +
                         `Registry entry for '${moduleName}' resolves to a GitHub source, which is not allowed in --profile certified.\n` +
-                        `Use a tarball-based registry entry (distribution.tarball + checksum), or run with --profile strict/default.`,
+                        `Use a tarball-based registry entry (distribution.tarball + checksum), or rerun with --profile standard.`,
                 };
             }
             const { org, repo, path, ref } = downloadInfo.githubInfo;
@@ -549,7 +549,7 @@ export async function addFromGitHub(url, ctx, options = {}) {
         return {
             success: false,
             error: `Certified profile requires registry tarball provenance; GitHub installs are not allowed.\n` +
-                `Use 'cog add <module>' against a tarball-based registry entry, or run with --profile strict/default.`,
+                `Use 'cog add <module>' against a tarball-based registry entry, or rerun with --profile standard.`,
         };
     }
     // Determine ref (tag takes priority)

package/dist/commands/compose.js

@@ -40,7 +40,7 @@ export async function compose(moduleName, ctx, options = {}) {
             const errorEnvelope = attachContext(makeErrorEnvelope({
                 code: ErrorCodes.INVALID_INPUT,
                 message: `Certified profile requires v2.2 modules; got: ${module.formatVersion ?? 'unknown'} (${module.format})`,
-                suggestion: "Migrate the module to v2.2, or run with `--profile strict` / `--profile default`",
+                suggestion: "Migrate the module to v2.2, or rerun with `--profile standard`",
             }), { module: moduleName, provider: ctx.provider.name });
             return { success: false, error: errorEnvelope.error.message, data: errorEnvelope };
         }
@@ -82,29 +82,6 @@ export async function compose(moduleName, ctx, options = {}) {
             maxDepth: options.maxDepth,
             timeoutMs: options.timeout,
             policy,
-            validateInput: (() => {
-                if (options.noValidate)
-                    return false;
-                if (!policy)
-                    return true;
-                if (policy.validate === 'off')
-                    return false;
-                if (policy.validate === 'on')
-                    return true;
-                return policy.profile !== 'core';
-            })(),
-            validateOutput: (() => {
-                if (options.noValidate)
-                    return false;
-                if (!policy)
-                    return true;
-                if (policy.validate === 'off')
-                    return false;
-                if (policy.validate === 'on')
-                    return true;
-                return policy.profile !== 'core';
-            })(),
-            enableRepair: policy?.enableRepair ?? true,
         });
         if (options.verbose) {
             console.error('--- Composition Trace ---');