cgraphx 1.2.0 → 1.3.0

package/dist/api-test/snapshot.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * L-T-50: snapshot — capture dep_tables row snapshots before `bru run`,
+ * stored as `.cgraphx/api-test/runs/<run-id>-before.json`.
+ *
+ * Part of the single-endpoint closed loop (enhance → snapshot → bru run → verify).
+ * Mechanical subcommand — no AI logic.
+ *
+ * Spec: docs/features/2026-07-07-api-test-skill-bruno自动化接口测试/api-test-layer2-spec.md §7.1 (snapshot is the
+ * realization of decision #2 option (d): skill calls snapshot before bru run, verify-prepare reads it)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__INTERNAL_SNAPSHOT = void 0;
+exports.snapshot = snapshot;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const report_1 = require("./report");
+const db_query_cli_1 = require("./db-query-cli");
+const DEFAULT_DOCS_DIR = 'docs';
+const DEFAULT_API_TEST_DIR = 'api-test';
+const DEFAULT_SERVICE = 'inst-service';
+const RUNS_SUBDIR = 'runs';
+const SNAPSHOT_LIMIT = 5;
+async function snapshot(projectRoot, endpoint, runId, service = DEFAULT_SERVICE) {
+    const resolvedRoot = path.resolve(projectRoot);
+    // 1. Read .md frontmatter for dep_tables
+    const mdPath = path.join(resolvedRoot, DEFAULT_DOCS_DIR, DEFAULT_API_TEST_DIR, service, `${endpoint}.md`);
+    if (!fs.existsSync(mdPath)) {
+        throw new Error(`[snapshot] .md not found: ${mdPath}`);
+    }
+    const mdContent = fs.readFileSync(mdPath, 'utf8');
+    const fm = (0, report_1.parseFrontmatter)(mdContent);
+    const depTablesRaw = fm.dep_tables ?? '';
+    const depTables = parseDepTables(depTablesRaw, mdContent);
+    // 2. Snapshot each dep_table
+    const snapshots = {};
+    const errors = [];
+    for (const table of depTables) {
+        if (!table)
+            continue;
+        const sql = `SELECT * FROM ${table} LIMIT ${SNAPSHOT_LIMIT}`;
+        const result = await (0, db_query_cli_1.runDbQueryCli)(sql, resolvedRoot);
+        if (result.ok) {
+            snapshots[table] = result.rows;
+        }
+        else {
+            snapshots[table] = [];
+            errors.push(`db query failed for ${table}: ${result.reason}`);
+        }
+    }
+    // 3. Write before.json
+    const snapshotAt = new Date().toISOString();
+    const runsDir = path.join(resolvedRoot, '.cgraphx', DEFAULT_API_TEST_DIR, RUNS_SUBDIR);
+    fs.mkdirSync(runsDir, { recursive: true });
+    const beforeJsonPath = path.join(runsDir, `${runId}-before.json`);
+    const payload = {
+        endpoint,
+        runId,
+        depTables,
+        snapshots,
+        snapshotAt,
+    };
+    fs.writeFileSync(beforeJsonPath, JSON.stringify(payload, null, 2) + '\n', 'utf8');
+    return {
+        endpoint,
+        runId,
+        depTables,
+        snapshots,
+        snapshotAt,
+        beforeJsonPath,
+        errors,
+    };
+}
+/**
+ * Parse dep_tables from frontmatter. parseFrontmatter returns a flat string map,
+ * so arrays like `dep_tables: [cust, order]` or multi-line YAML lists need special handling.
+ * Fall back to scanning the raw .md content for `- <table>` lines under `dep_tables:`.
+ */
+function parseDepTables(rawValue, fullMdContent) {
+    // Try the flat value first (single-table case: `dep_tables: cust`)
+    if (rawValue && rawValue.trim() && !rawValue.includes('[')) {
+        return [rawValue.trim()];
+    }
+    // Try inline array: `dep_tables: [cust, order]`
+    if (rawValue && rawValue.includes('[')) {
+        const inner = rawValue.replace(/^\[/, '').replace(/\]$/, '');
+        return inner.split(',').map((s) => s.trim()).filter(Boolean);
+    }
+    // Fall back to scanning multi-line YAML list in full content
+    const tables = [];
+    const lines = fullMdContent.split('\n');
+    let inDepTables = false;
+    for (const line of lines) {
+        if (/^dep_tables:/.test(line)) {
+            inDepTables = true;
+            continue;
+        }
+        if (inDepTables) {
+            if (/^\s+-\s+/.test(line)) {
+                const t = line.replace(/^\s+-\s+/, '').trim().replace(/['"]/g, '');
+                if (t)
+                    tables.push(t);
+            }
+            else if (/^\S/.test(line)) {
+                // Next field starts — stop
+                break;
+            }
+        }
+    }
+    return tables;
+}
+exports.__INTERNAL_SNAPSHOT = {
+    DEFAULT_SERVICE,
+    RUNS_SUBDIR,
+    SNAPSHOT_LIMIT,
+};
+//# sourceMappingURL=snapshot.js.map

package/dist/api-test/snapshot.js.map

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

package/dist/api-test/test-history.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Test history — JSONL append for every test run (spec §5.5).
+ *
+ * One file per day: `.cgraphx/api-test/runs/YYYY-MM-DD.jsonl`. Each line is a
+ * single `TestRun` record. Append-only — never rewrites history.
+ *
+ * Independent subsystem — only depends on `node:fs` / `node:path` and the
+ * subsystem's own `types.ts`. No imports from `src/extraction/` /
+ * `src/resolution/` / `src/db/`.
+ */
+import type { TestRun } from './types';
+/**
+ * Append a single `TestRun` record to the day's JSONL file.
+ *
+ * File path: `<projectRoot>/.cgraphx/api-test/runs/YYYY-MM-DD.jsonl` where
+ * the date is taken from `run.ranAt` (ISO-8601). The directory tree is
+ * created on demand. Existing files are appended to (never truncated).
+ *
+ * Each line is a compact JSON object with stable key order matching spec §5.5:
+ *   {"endpoint":"...","service":"...","ran_at":"...","http_status":200,
+ *    "biz_code":"0","duration_ms":234,"passed":true,"error":null}
+ */
+export declare function appendTestRun(run: TestRun, projectRoot: string): Promise<void>;
+/** Synchronous variant — used by the CLI layer to avoid an unawaited write. */
+export declare function appendTestRunSync(run: TestRun, projectRoot: string): void;
+/** Resolve the runs directory path for a project root. */
+export declare function runsDirPath(projectRoot: string): string;
+/**
+ * Extract the `YYYY-MM-DD` date segment from an ISO-8601 timestamp.
+ * Falls back to `1970-01-01` when the input is malformed.
+ */
+declare function dateFromIso(iso: string): string;
+/**
+ * Serialize a `TestRun` into the spec §5.5 JSONL line format.
+ * Key order is fixed to match the spec example.
+ */
+declare function serializeRun(run: TestRun): string;
+/** Internal helpers re-exported for tests. */
+export declare const __INTERNAL_TEST_HISTORY: {
+    runsDirPath: typeof runsDirPath;
+    dateFromIso: typeof dateFromIso;
+    serializeRun: typeof serializeRun;
+    RUNS_DIRNAME: string;
+    DATA_DIR: string;
+    API_TEST_DIR: string;
+};
+export {};
+//# sourceMappingURL=test-history.d.ts.map

package/dist/api-test/test-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-history.d.ts","sourceRoot":"","sources":["../../src/api-test/test-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AASvC;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,OAAO,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAMzE;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,iBAAS,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGxC;AAED;;;GAGG;AACH,iBAAS,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAY1C;AAED,8CAA8C;AAC9C,eAAO,MAAM,uBAAuB;;;;;;;CAOnC,CAAC"}

package/dist/api-test/test-history.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * Test history — JSONL append for every test run (spec §5.5).
+ *
+ * One file per day: `.cgraphx/api-test/runs/YYYY-MM-DD.jsonl`. Each line is a
+ * single `TestRun` record. Append-only — never rewrites history.
+ *
+ * Independent subsystem — only depends on `node:fs` / `node:path` and the
+ * subsystem's own `types.ts`. No imports from `src/extraction/` /
+ * `src/resolution/` / `src/db/`.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__INTERNAL_TEST_HISTORY = void 0;
+exports.appendTestRun = appendTestRun;
+exports.appendTestRunSync = appendTestRunSync;
+exports.runsDirPath = runsDirPath;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/** Directory under the project root where run history lives. */
+const RUNS_DIRNAME = 'runs';
+/** Project data root directory (fork renamed `.codegraph` → `.cgraphx`). */
+const DATA_DIR = '.cgraphx';
+/** api-test subsystem directory under the data root. */
+const API_TEST_DIR = 'api-test';
+/**
+ * Append a single `TestRun` record to the day's JSONL file.
+ *
+ * File path: `<projectRoot>/.cgraphx/api-test/runs/YYYY-MM-DD.jsonl` where
+ * the date is taken from `run.ranAt` (ISO-8601). The directory tree is
+ * created on demand. Existing files are appended to (never truncated).
+ *
+ * Each line is a compact JSON object with stable key order matching spec §5.5:
+ *   {"endpoint":"...","service":"...","ran_at":"...","http_status":200,
+ *    "biz_code":"0","duration_ms":234,"passed":true,"error":null}
+ */
+async function appendTestRun(run, projectRoot) {
+    const dir = runsDirPath(projectRoot);
+    await fs.promises.mkdir(dir, { recursive: true });
+    const filePath = path.join(dir, `${dateFromIso(run.ranAt)}.jsonl`);
+    const line = serializeRun(run) + '\n';
+    await fs.promises.appendFile(filePath, line, 'utf8');
+}
+/** Synchronous variant — used by the CLI layer to avoid an unawaited write. */
+function appendTestRunSync(run, projectRoot) {
+    const dir = runsDirPath(projectRoot);
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = path.join(dir, `${dateFromIso(run.ranAt)}.jsonl`);
+    const line = serializeRun(run) + '\n';
+    fs.appendFileSync(filePath, line, 'utf8');
+}
+/** Resolve the runs directory path for a project root. */
+function runsDirPath(projectRoot) {
+    return path.join(projectRoot, DATA_DIR, API_TEST_DIR, RUNS_DIRNAME);
+}
+/**
+ * Extract the `YYYY-MM-DD` date segment from an ISO-8601 timestamp.
+ * Falls back to `1970-01-01` when the input is malformed.
+ */
+function dateFromIso(iso) {
+    const m = /^(\d{4}-\d{2}-\d{2})/.exec(iso);
+    return m && m[1] ? m[1] : '1970-01-01';
+}
+/**
+ * Serialize a `TestRun` into the spec §5.5 JSONL line format.
+ * Key order is fixed to match the spec example.
+ */
+function serializeRun(run) {
+    const obj = {
+        endpoint: run.endpoint,
+        service: run.service,
+        ran_at: run.ranAt,
+        http_status: run.httpStatus,
+        biz_code: run.bizCode,
+        duration_ms: run.durationMs,
+        passed: run.passed,
+        error: run.error,
+    };
+    return JSON.stringify(obj);
+}
+/** Internal helpers re-exported for tests. */
+exports.__INTERNAL_TEST_HISTORY = {
+    runsDirPath,
+    dateFromIso,
+    serializeRun,
+    RUNS_DIRNAME,
+    DATA_DIR,
+    API_TEST_DIR,
+};
+//# sourceMappingURL=test-history.js.map

package/dist/api-test/test-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-history.js","sourceRoot":"","sources":["../../src/api-test/test-history.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBH,sCASC;AAGD,8CAMC;AAGD,kCAEC;AA9CD,4CAA8B;AAC9B,gDAAkC;AAIlC,gEAAgE;AAChE,MAAM,YAAY,GAAG,MAAM,CAAC;AAC5B,4EAA4E;AAC5E,MAAM,QAAQ,GAAG,UAAU,CAAC;AAC5B,wDAAwD;AACxD,MAAM,YAAY,GAAG,UAAU,CAAC;AAEhC;;;;;;;;;;GAUG;AACI,KAAK,UAAU,aAAa,CACjC,GAAY,EACZ,WAAmB;IAEnB,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACtC,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,+EAA+E;AAC/E,SAAgB,iBAAiB,CAAC,GAAY,EAAE,WAAmB;IACjE,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACrC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IACtC,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,0DAA0D;AAC1D,SAAgB,WAAW,CAAC,WAAmB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,CAAC,GAAG,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,GAAY;IAChC,MAAM,GAAG,GAA4B;QACnC,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,GAAG,CAAC,KAAK;QACjB,WAAW,EAAE,GAAG,CAAC,UAAU;QAC3B,QAAQ,EAAE,GAAG,CAAC,OAAO;QACrB,WAAW,EAAE,GAAG,CAAC,UAAU;QAC3B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,KAAK,EAAE,GAAG,CAAC,KAAK;KACjB,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,8CAA8C;AACjC,QAAA,uBAAuB,GAAG;IACrC,WAAW;IACX,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,QAAQ;IACR,YAAY;CACb,CAAC"}

package/dist/api-test/types.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Type definitions for the api-test subsystem.
+ *
+ * Independent subsystem — does NOT import from `src/extraction/`,
+ * `src/resolution/`, or `src/db/`. The Java parser (T-11) will live in
+ * `src/api-test/` and reuse only the `tree-sitter-java.wasm` grammar, never
+ * the main code-graph extractor.
+ *
+ * Spec: docs/features/2026-07-07-api-test-skill-bruno自动化接口测试/
+ */
+/**
+ * A discovered HTTP endpoint (one row in the eventual `.bru`/`.md` pair).
+ *
+ * `svcId` is the short numeric id encoded into the URL template's `{svc_id}`
+ * placeholder (hx convention — derived from the `@Center` annotation's `id`
+ * attribute). `service` is the resolved service-group name (e.g.
+ * `order-service`) computed by applying `serviceGroupingRegex` +
+ * `serviceNameMap` to the interface's package.
+ */
+export interface Endpoint {
+    svcId: string;
+    service: string;
+    interfaceFqn: string;
+    method: string;
+    signature: string;
+    urlPattern: string;
+    httpMethod: string;
+    status: 'active' | 'skip';
+    skipReason: string | null;
+    authRequired: boolean;
+    /** Tables referenced (directly or transitively) by the method body. */
+    depTables: string[];
+    fields: Field[];
+    /** Qualified call chain leading from the controller method to DB access. */
+    callChain: string[];
+    javadoc: string | null;
+    notes: string | null;
+    /**
+     * `@MethodAttr` annotation attributes on the interface method (hx convention).
+     * Controls request construction in the assemble phase. Defaults reflect a
+     * missing annotation or unset attributes.
+     */
+    methodAttr: {
+        resolveParam: boolean;
+        handleReturn: boolean;
+        open: boolean;
+    };
+    bruPath: string;
+    mdPath: string;
+}
+/**
+ * A single method parameter and how its value is sourced at test time.
+ *
+ * Exactly one of `literal` / `sourceTable`+`sourceColumn` / `sourceFilter`
+ * is expected to be set; `fixtureOnly` marks params that must come from a
+ * manual fixture entry (no automatic source).
+ */
+export interface Field {
+    paramIndex: number;
+    name: string;
+    javaType: string;
+    sourceTable: string | null;
+    sourceColumn: string | null;
+    /** A filter expression used to select the source row, e.g. `status=1 LIMIT 1`. */
+    sourceFilter: string | null;
+    /** Inline literal value (used by `bodyTemplate` or fixed-value params). */
+    literal: string | null;
+    /** True when no automatic source was discoverable — fixture must supply it. */
+    fixtureOnly: boolean;
+    required: boolean;
+}
+/** Result of running one endpoint against the live target. */
+export interface TestRun {
+    endpoint: string;
+    service: string;
+    /** ISO-8601 timestamp of when the request was fired. */
+    ranAt: string;
+    httpStatus: number;
+    /** Business code extracted from the response body via `bizCodeField`. */
+    bizCode: string | null;
+    durationMs: number;
+    passed: boolean;
+    error: string | null;
+}
+/**
+ * Static, project-wide config — controls scan + assemble behavior.
+ * Lives in `.cgraphx/api-test/config.json`. Missing file falls back to
+ * `DEFAULT_CONFIG`. Existing file with a missing/typo'd required field is a
+ * hard `ConfigError` (spec §5.6).
+ */
+export interface ApiTestConfig {
+    /** Fully-qualified Java annotation that marks a service interface. */
+    providerAnnotationFqn: string;
+    /** Regex with one capture group — extracts the service-group key from the
+     *  interface's package name. */
+    serviceGroupingRegex: string;
+    /** Maps the captured group → concrete service hostname (e.g. `order` → `order-service`). */
+    serviceNameMap: Record<string, string>;
+    /** URL template. `{{baseUrl}}`, `{service}`, `{pathSegment}`, `{svc_id}`, `{methodName}` are substituted. */
+    urlTemplate: string;
+    /** Per-service URL path segment (e.g. `inst-service` → `service`, `so-pub-service` → `openapi`).
+     *  Falls back to `service` when service not listed. hx: east-west (inst) uses `service`,
+     *  north-south (so-pub, external web) uses `openapi`. */
+    serviceUrlPaths?: Record<string, string>;
+    defaultHttpMethod: string;
+    defaultHeaders: Record<string, string>;
+    /** Body template — a JSON string, usually `"[{}]"` for hx's array-wrapped convention. */
+    bodyTemplate: string;
+}
+/**
+ * Per-environment runtime profile — base URL, auth variables, biz-code rule.
+ * Lives in `.cgraphx/api-test/profile.json`. REQUIRED — missing file (in both
+ * project and user tier) is a `ConfigError`, no silent default.
+ */
+export interface ApiTestProfile {
+    env: string;
+    baseUrl: string;
+    /** Variables substituted into `defaultHeaders` / `urlTemplate` via `{{var}}`. */
+    variables: Record<string, string>;
+    /** JSON key in the response body that carries the business status code.
+     *  `null` means "don't check biz code, rely on HTTP status only". */
+    bizCodeField: string | null;
+    /** Values of `bizCodeField` considered a success. */
+    bizCodeSuccessValues: string[];
+}
+/** One fixture entry — overrides / supplies values for a specific endpoint. */
+export interface FixtureEntry {
+    /** Positional parameter values, in method-declaration order. */
+    params: unknown[];
+    headers?: Record<string, string>;
+    notes?: string;
+}
+/** Fixtures map keyed by endpoint identifier (`<service>.<method>`). */
+export type Fixtures = Record<string, FixtureEntry>;
+/**
+ * Result of the `enhance-prepare` phase (L-T-10). Aggregates everything an
+ * AI needs to infer `fields` for one endpoint: the catalog metadata from the
+ * Layer 1 scan `.md` file, the impl class file path (located via
+ * `findImplFor`), sample rows from each dependent table, and any previously
+ * AI-inferred fields persisted in `.cgraphx/api-test/ai-fields/`.
+ */
+export interface EnhancePrepareResult {
+    /** Endpoint identifier: `<svc_id>_<method>` (the .md filename stem). */
+    endpoint: string;
+    service: string;
+    interfaceFqn: string;
+    method: string;
+    signature: string;
+    urlPattern: string;
+    /** `@MethodAttr` attributes parsed from the frontmatter `method_attr` block. */
+    methodAttr: {
+        resolveParam: boolean;
+        handleReturn: boolean;
+        open: boolean;
+    };
+    /** Fields from the .md `fields:` block (empty when scan left them `[]`). */
+    fields: Field[];
+    /** Qualified call chain strings. */
+    callChain: string[];
+    /** Tables referenced by the impl method (from the .md `dep_tables:`). */
+    depTables: string[];
+    javadoc: string | null;
+    /** Absolute path to the impl `.java` file, or null when no impl found. */
+    implPath: string | null;
+    /** Sample rows per dep table (up to 5). Empty array on query failure. */
+    dbSamples: Record<string, unknown[]>;
+}
+/** Persisted AI-inferred fields for one endpoint, written by the enhance phase. */
+export interface AiFields {
+    endpoint: string;
+    fields: Field[];
+    updatedAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api-test/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api-test/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,uEAAuE;IACvE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;OAIG;IACH,UAAU,EAAE;QACV,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,OAAO,CAAC;QACtB,IAAI,EAAE,OAAO,CAAC;KACf,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,KAAK;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kFAAkF;IAClF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,+EAA+E;IAC/E,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,8DAA8D;AAC9D,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,qBAAqB,EAAE,MAAM,CAAC;IAC9B;oCACgC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,4FAA4F;IAC5F,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,6GAA6G;IAC7G,WAAW,EAAE,MAAM,CAAC;IACpB;;6DAEyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,yFAAyF;IACzF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;yEACqE;IACrE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qDAAqD;IACrD,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wEAAwE;AACxE,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,UAAU,EAAE;QAAE,YAAY,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5E,4EAA4E;IAC5E,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,oCAAoC;IACpC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yEAAyE;IACzE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;CACtC;AAED,mFAAmF;AACnF,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/api-test/types.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Type definitions for the api-test subsystem.
+ *
+ * Independent subsystem — does NOT import from `src/extraction/`,
+ * `src/resolution/`, or `src/db/`. The Java parser (T-11) will live in
+ * `src/api-test/` and reuse only the `tree-sitter-java.wasm` grammar, never
+ * the main code-graph extractor.
+ *
+ * Spec: docs/features/2026-07-07-api-test-skill-bruno自动化接口测试/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/api-test/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api-test/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/dist/api-test/verify-prepare.d.ts

@@ -0,0 +1,30 @@
+/**
+ * L-T-30: verify-prepare — read bru run report + before.json + post-run db snapshot,
+ * output structured JSON for AI to infer db_verify expectations.
+ *
+ * Mechanical subcommand — no AI logic.
+ *
+ * Spec: docs/features/2026-07-07-api-test-skill-bruno自动化接口测试/api-test-layer2-spec.md §7.1.3
+ */
+export interface VerifyPrepareResult {
+    endpoint: string;
+    service: string;
+    implPath: string | null;
+    response: {
+        httpStatus: number;
+        body: string;
+        tests: unknown[];
+        durationMs: number;
+        error: string | null;
+    };
+    dbBefore: Record<string, unknown[]> | null;
+    dbAfter: Record<string, unknown[]>;
+    depTables: string[];
+}
+export declare function verifyPrepare(projectRoot: string, endpoint: string, resultsFile: string, runId: string, service?: string): Promise<VerifyPrepareResult>;
+export declare const __INTERNAL_VERIFY_PREPARE: {
+    DEFAULT_SERVICE: string;
+    RUNS_SUBDIR: string;
+    SNAPSHOT_LIMIT: number;
+};
+//# sourceMappingURL=verify-prepare.d.ts.map

package/dist/api-test/verify-prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-prepare.d.ts","sourceRoot":"","sources":["../../src/api-test/verify-prepare.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,EAAE,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAwB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CA6D9B;AA8BD,eAAO,MAAM,yBAAyB;;;;CAIrC,CAAC"}