@veewo/gitnexus 1.4.11-rc → 1.5.0-rc

package/dist/benchmark/u2-e2e/phase5-rule-lab-acceptance-runner.js

@@ -0,0 +1,331 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { discoverRuleLabRun } from '../../rule-lab/discover.js';
+import { analyzeRuleLabSlice } from '../../rule-lab/analyze.js';
+import { buildReviewPack } from '../../rule-lab/review-pack.js';
+import { curateRuleLabSlice } from '../../rule-lab/curate.js';
+import { promoteCuratedRules } from '../../rule-lab/promote.js';
+import { runRuleLabRegress } from '../../rule-lab/regress.js';
+function commandFor(stage, input) {
+    switch (stage) {
+        case 'discover':
+            return 'gitnexus rule-lab discover --scope full';
+        case 'analyze':
+            return `gitnexus rule-lab analyze --run-id ${input.runId} --slice-id ${input.sliceId}`;
+        case 'review-pack':
+            return `gitnexus rule-lab review-pack --run-id ${input.runId} --slice-id ${input.sliceId} --max-tokens 6000`;
+        case 'curate':
+            return `gitnexus rule-lab curate --run-id ${input.runId} --slice-id ${input.sliceId} --input-path ${input.curationInputPath}`;
+        case 'promote':
+            return `gitnexus rule-lab promote --run-id ${input.runId} --slice-id ${input.sliceId}`;
+        case 'regress':
+            return `gitnexus rule-lab regress --precision 0.93 --coverage 0.85 --run-id ${input.runId}`;
+        default:
+            return 'gitnexus rule-lab <unknown>';
+    }
+}
+async function mustExist(filePath) {
+    await fs.access(filePath);
+}
+function buildFailureTaxonomy(runId) {
+    return [
+        {
+            code: 'rule_not_matched',
+            retry_hint: 'confirm trigger_family tokens and rerun discover/analyze/promote',
+            repro_command: `gitnexus rule-lab analyze --run-id ${runId} --slice-id <slice_id>`,
+        },
+        {
+            code: 'rule_matched_but_evidence_missing',
+            retry_hint: 'add stronger confirmed_chain anchors in curation input and promote again',
+            repro_command: `gitnexus rule-lab curate --run-id ${runId} --slice-id <slice_id> --input-path <curation-input.json>`,
+        },
+        {
+            code: 'precision_below_threshold',
+            retry_hint: 'trim noisy rules or tighten curation semantics before regress',
+            repro_command: `gitnexus rule-lab regress --precision 0.85 --coverage 0.92 --run-id ${runId}`,
+        },
+        {
+            code: 'coverage_below_threshold',
+            retry_hint: 'add additional approved rules/slices and rerun regress',
+            repro_command: `gitnexus rule-lab regress --precision 0.95 --coverage 0.70 --run-id ${runId}`,
+        },
+        {
+            code: 'probe_pass_rate_below_threshold',
+            retry_hint: 're-run regress with refreshed probes and inspect replay commands',
+            repro_command: `gitnexus rule-lab regress --precision 0.95 --coverage 0.90 --run-id ${runId}`,
+        },
+        {
+            code: 'static_hardcode_detected',
+            retry_hint: 'remove project-specific reload fallback constants/branches from runtime verifier',
+            repro_command: 'rg -n "RESOURCE_ASSET_PATH|GRAPH_ASSET_PATH|RELOAD_GUID|shouldVerifyReloadChain|verifyReloadRuntimeChain" gitnexus/src/mcp/local/runtime-chain-verify.ts',
+        },
+        {
+            code: 'dsl_lint_failed',
+            retry_hint: 'fix promoted DSL placeholders and rerun promote/regress',
+            repro_command: `gitnexus rule-lab promote --run-id ${runId} --slice-id <slice_id>`,
+        },
+    ];
+}
+function hasDslPlaceholders(text) {
+    return /(^|\s)(unknown|todo|tbd)(\s|$)|<[^>]+>/i.test(text);
+}
+async function buildAuthenticityChecks(input) {
+    const verifierPath = path.join(input.repoPath, 'gitnexus', 'src', 'mcp', 'local', 'runtime-chain-verify.ts');
+    const verifierRaw = await fs.readFile(verifierPath, 'utf-8');
+    const blockedSymbols = [
+        'RESOURCE_ASSET_PATH',
+        'GRAPH_ASSET_PATH',
+        'RELOAD_GUID',
+        'shouldVerifyReloadChain',
+        'verifyReloadRuntimeChain',
+    ].filter((token) => verifierRaw.includes(token));
+    let dslLintPass = true;
+    for (const promotedPath of input.promotedFiles) {
+        const raw = await fs.readFile(promotedPath, 'utf-8');
+        if (hasDslPlaceholders(raw)) {
+            dslLintPass = false;
+            break;
+        }
+    }
+    return {
+        static_no_hardcoded_reload: {
+            pass: blockedSymbols.length === 0,
+            blocked_symbols: blockedSymbols,
+        },
+        dsl_lint_pass: dslLintPass,
+    };
+}
+export async function buildPhase5RuleLabAcceptanceReport(input) {
+    const repoPath = path.resolve(input.repoPath || process.cwd());
+    const stageCoverage = [];
+    const discover = await discoverRuleLabRun({ repoPath, scope: 'full', seed: input.seed || 'phase5-acceptance' });
+    stageCoverage.push({
+        stage: 'discover',
+        command: commandFor('discover', {}),
+        status: 'passed',
+    });
+    if (discover.manifest.slices.length === 0) {
+        throw new Error('discover produced no slices');
+    }
+    const sliceId = discover.manifest.slices[0].id;
+    const runId = discover.runId;
+    const analyze = await analyzeRuleLabSlice({ repoPath, runId, sliceId });
+    stageCoverage.push({
+        stage: 'analyze',
+        command: commandFor('analyze', { runId, sliceId }),
+        status: 'passed',
+    });
+    const reviewPack = await buildReviewPack({ repoPath, runId, sliceId, maxTokens: 6000 });
+    stageCoverage.push({
+        stage: 'review-pack',
+        command: commandFor('review-pack', { runId, sliceId }),
+        status: 'passed',
+    });
+    const firstCandidate = analyze.candidates[0];
+    const curationInputPath = path.join(repoPath, '.gitnexus', 'rules', 'lab', 'runs', runId, 'slices', sliceId, 'curation-input.json');
+    await fs.writeFile(curationInputPath, `${JSON.stringify({
+        run_id: runId,
+        slice_id: sliceId,
+        curated: [
+            {
+                id: firstCandidate.id,
+                rule_id: 'demo.startup.v1',
+                title: 'startup startup graph',
+                match: {
+                    trigger_tokens: ['startup'],
+                },
+                topology: Array.isArray(firstCandidate.topology) && firstCandidate.topology.length > 0
+                    ? firstCandidate.topology
+                    : firstCandidate.evidence.hops.map((hop) => ({
+                        hop: hop.hop_type,
+                        from: { entity: 'resource' },
+                        to: { entity: 'script' },
+                        edge: { kind: 'binds_script' },
+                    })),
+                closure: {
+                    required_hops: Array.isArray(firstCandidate.topology) && firstCandidate.topology.length > 0
+                        ? firstCandidate.topology.map((hop) => hop.hop)
+                        : ['code_runtime'],
+                    failure_map: {
+                        missing_evidence: 'rule_matched_but_evidence_missing',
+                    },
+                },
+                claims: {
+                    guarantees: ['startup trigger matching is confirmed'],
+                    non_guarantees: ['does not prove full runtime ordering'],
+                    next_action: 'gitnexus query "Startup Graph Trigger"',
+                },
+                confirmed_chain: {
+                    steps: firstCandidate.evidence.hops.map((hop) => ({ ...hop, hop_type: 'code_runtime' })),
+                },
+                guarantees: ['startup trigger matching is confirmed'],
+                non_guarantees: ['does not prove full runtime ordering'],
+            },
+        ],
+    }, null, 2)}\n`, 'utf-8');
+    const curated = await curateRuleLabSlice({ repoPath, runId, sliceId, inputPath: curationInputPath });
+    stageCoverage.push({
+        stage: 'curate',
+        command: commandFor('curate', { runId, sliceId, curationInputPath }),
+        status: 'passed',
+    });
+    const promoted = await promoteCuratedRules({ repoPath, runId, sliceId, version: '1.0.0' });
+    stageCoverage.push({
+        stage: 'promote',
+        command: commandFor('promote', { runId, sliceId }),
+        status: 'passed',
+    });
+    const regress = await runRuleLabRegress({
+        precision: 0.93,
+        coverage: 0.85,
+        probes: [
+            {
+                id: 'probe-startup-trigger',
+                pass: true,
+                replay_command: 'gitnexus query "Startup Graph Trigger" --runtime-chain-verify on-demand',
+            },
+        ],
+        repoPath,
+        runId,
+    });
+    stageCoverage.push({
+        stage: 'regress',
+        command: commandFor('regress', { runId, sliceId }),
+        status: regress.pass ? 'passed' : 'failed',
+        retry_hint: regress.pass ? undefined : regress.failures.join(','),
+    });
+    const artifactPaths = {
+        manifest: discover.paths.manifestPath,
+        candidates: analyze.paths.candidatesPath,
+        review_cards: reviewPack.paths.reviewCardsPath,
+        curation_input: curationInputPath,
+        curated: curated.paths.curatedPath,
+        catalog: path.join(promoted.paths.rulesRoot, 'catalog.json'),
+        promoted_files: promoted.promotedFiles,
+        regress_report: regress.reportPath,
+    };
+    await mustExist(artifactPaths.manifest);
+    await mustExist(artifactPaths.candidates);
+    await mustExist(artifactPaths.review_cards);
+    await mustExist(artifactPaths.curation_input);
+    await mustExist(artifactPaths.curated);
+    await mustExist(artifactPaths.catalog);
+    await Promise.all(artifactPaths.promoted_files.map((filePath) => mustExist(filePath)));
+    if (artifactPaths.regress_report) {
+        await mustExist(artifactPaths.regress_report);
+    }
+    const authenticityChecks = await buildAuthenticityChecks({
+        repoPath,
+        promotedFiles: artifactPaths.promoted_files,
+    });
+    return {
+        generated_at: new Date().toISOString(),
+        repo_alias: input.repoAlias,
+        repo_path: repoPath,
+        run_id: runId,
+        stage_coverage: stageCoverage,
+        metrics: {
+            precision: regress.metrics.precision,
+            coverage: regress.metrics.coverage,
+            probe_pass_rate: regress.metrics.probe_pass_rate,
+            token_budget: reviewPack.meta.token_budget_estimate,
+        },
+        authenticity_checks: authenticityChecks,
+        failure_classifications: buildFailureTaxonomy(runId),
+        artifact_paths: artifactPaths,
+    };
+}
+export async function runPhase5RuleLabGate(input) {
+    const reportPath = path.resolve(input.reportPath);
+    try {
+        const raw = await fs.readFile(reportPath, 'utf-8');
+        const report = JSON.parse(raw);
+        if (!Array.isArray(report.stage_coverage) || report.stage_coverage.length !== 6) {
+            return { pass: false, reason: 'stage_coverage_incomplete' };
+        }
+        if (typeof report.metrics?.precision !== 'number' || typeof report.metrics?.coverage !== 'number') {
+            return { pass: false, reason: 'metrics_missing' };
+        }
+        if (!report.authenticity_checks?.static_no_hardcoded_reload?.pass) {
+            return { pass: false, reason: 'static_hardcode_detected' };
+        }
+        if (!report.authenticity_checks?.dsl_lint_pass) {
+            return { pass: false, reason: 'dsl_lint_failed' };
+        }
+        if (Number(report.metrics?.probe_pass_rate) < 0.85) {
+            return { pass: false, reason: 'probe_pass_rate_below_threshold' };
+        }
+        return { pass: true };
+    }
+    catch {
+        return { pass: false, reason: 'acceptance_report_missing' };
+    }
+}
+export async function writePhase5RuleLabAcceptanceArtifacts(input) {
+    const jsonPath = path.resolve(input.jsonPath);
+    const mdPath = path.resolve(input.mdPath);
+    await fs.mkdir(path.dirname(jsonPath), { recursive: true });
+    await fs.writeFile(jsonPath, `${JSON.stringify(input.report, null, 2)}\n`, 'utf-8');
+    const markdown = [
+        '# Phase 5 Rule Lab Acceptance',
+        '',
+        `- generated_at: ${input.report.generated_at}`,
+        `- repo_alias: ${input.report.repo_alias}`,
+        `- run_id: ${input.report.run_id}`,
+        '',
+        '## Stage Coverage',
+        ...input.report.stage_coverage.map((stage) => `- ${stage.stage}: ${stage.status} (${stage.command})`),
+        '',
+        '## Metrics',
+        `- precision: ${input.report.metrics.precision}`,
+        `- coverage: ${input.report.metrics.coverage}`,
+        `- probe_pass_rate: ${input.report.metrics.probe_pass_rate}`,
+        `- token_budget: ${input.report.metrics.token_budget}`,
+        '',
+        '## Authenticity Checks',
+        `- static_no_hardcoded_reload.pass: ${input.report.authenticity_checks.static_no_hardcoded_reload.pass}`,
+        `- static_no_hardcoded_reload.blocked_symbols: ${input.report.authenticity_checks.static_no_hardcoded_reload.blocked_symbols.join(', ') || 'none'}`,
+        `- dsl_lint_pass: ${input.report.authenticity_checks.dsl_lint_pass}`,
+        '',
+        '## Failure Classifications',
+        ...input.report.failure_classifications.map((failure) => `- ${failure.code}: ${failure.retry_hint} | repro: ${failure.repro_command}`),
+        '',
+        '## Artifact Paths',
+        `- manifest: ${input.report.artifact_paths.manifest}`,
+        `- candidates: ${input.report.artifact_paths.candidates}`,
+        `- review_cards: ${input.report.artifact_paths.review_cards}`,
+        `- curation_input: ${input.report.artifact_paths.curation_input}`,
+        `- curated: ${input.report.artifact_paths.curated}`,
+        `- catalog: ${input.report.artifact_paths.catalog}`,
+        `- promoted_files: ${input.report.artifact_paths.promoted_files.join(', ')}`,
+        `- regress_report: ${input.report.artifact_paths.regress_report || 'n/a'}`,
+        '',
+    ].join('\n');
+    await fs.mkdir(path.dirname(mdPath), { recursive: true });
+    await fs.writeFile(mdPath, markdown, 'utf-8');
+}
+async function main(argv) {
+    const repoArgIndex = argv.indexOf('--repo-path');
+    const repoPath = repoArgIndex >= 0 ? argv[repoArgIndex + 1] : process.cwd();
+    const outJsonIndex = argv.indexOf('--out-json');
+    const outMdIndex = argv.indexOf('--out-md');
+    const outJson = outJsonIndex >= 0
+        ? argv[outJsonIndex + 1]
+        : path.resolve('docs/reports/2026-04-02-phase5-rule-lab-acceptance.json');
+    const outMd = outMdIndex >= 0
+        ? argv[outMdIndex + 1]
+        : path.resolve('docs/reports/2026-04-02-phase5-rule-lab-acceptance.md');
+    const report = await buildPhase5RuleLabAcceptanceReport({
+        repoAlias: 'GitNexus',
+        repoPath,
+        seed: 'phase5-acceptance-main',
+    });
+    await writePhase5RuleLabAcceptanceArtifacts({ report, jsonPath: outJson, mdPath: outMd });
+    process.stdout.write(`${JSON.stringify({ outJson, outMd, run_id: report.run_id }, null, 2)}\n`);
+}
+if (process.argv[1] && path.resolve(process.argv[1]) === path.resolve(new URL(import.meta.url).pathname)) {
+    main(process.argv.slice(2)).catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    });
+}

package/dist/benchmark/u2-e2e/phase5-rule-lab-acceptance-runner.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/benchmark/u2-e2e/phase5-rule-lab-acceptance-runner.test.js

@@ -0,0 +1,42 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { buildPhase5RuleLabAcceptanceReport, runPhase5RuleLabGate } from './phase5-rule-lab-acceptance-runner.js';
+const { test: rawTest } = process.env.VITEST
+    ? await import('vitest')
+    : await import('node:test');
+const test = rawTest;
+test('phase5 rule-lab acceptance runner emits complete stage coverage', async () => {
+    const report = await buildPhase5RuleLabAcceptanceReport({ repoAlias: 'GitNexus' });
+    assert.equal(report.stage_coverage.length, 6);
+    assert.equal(typeof report.metrics.precision, 'number');
+});
+test('phase5 gate fails when required artifacts are missing', async () => {
+    const gate = await runPhase5RuleLabGate({ reportPath: '/tmp/missing.json' });
+    assert.equal(gate.pass, false);
+    assert.equal(gate.reason, 'acceptance_report_missing');
+});
+test('phase5 gate fails when anti-hardcode scan or dsl lint fails', async () => {
+    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'phase5-gate-'));
+    const reportPath = path.join(tmpDir, 'report.json');
+    await fs.writeFile(reportPath, JSON.stringify({
+        stage_coverage: [
+            { stage: 'discover', status: 'passed' },
+            { stage: 'analyze', status: 'passed' },
+            { stage: 'review-pack', status: 'passed' },
+            { stage: 'curate', status: 'passed' },
+            { stage: 'promote', status: 'passed' },
+            { stage: 'regress', status: 'passed' },
+        ],
+        metrics: { precision: 0.93, coverage: 0.9, probe_pass_rate: 0.9 },
+        authenticity_checks: {
+            static_no_hardcoded_reload: { pass: false },
+            dsl_lint_pass: false,
+        },
+    }), 'utf-8');
+    const gate = await runPhase5RuleLabGate({ reportPath });
+    assert.equal(gate.pass, false);
+    assert.ok(['static_hardcode_detected', 'dsl_lint_failed'].includes(String(gate.reason)));
+    await fs.rm(tmpDir, { recursive: true, force: true });
+});

package/dist/benchmark/u2-e2e/reload-v1-acceptance-runner.js

@@ -108,7 +108,7 @@ export async function buildReloadAcceptanceArtifact(input) {
         throw new Error(`Repo alias not found: ${input.repoAlias}`);
     }
     const distCli = path.resolve('gitnexus/dist/cli/index.js');
-    const env = { ...process.env, GITNEXUS_UNITY_PROCESS_CONFIDENCE_FIELDS: 'on' };
+    const env = { ...process.env };
     const status = buildStatus(repo.path, repo.lastCommit);
     if (input.requireStatusMatch && !status.upToDate) {
         throw new Error(`status mismatch for ${input.repoAlias}`);
@@ -119,21 +119,21 @@ export async function buildReloadAcceptanceArtifact(input) {
         throw new Error('LocalBackend failed to initialize for acceptance runner');
     }
     const commands = await Promise.all([
-        runBackendCommand(backend, `GITNEXUS_UNITY_PROCESS_CONFIDENCE_FIELDS=on node ${distCli} query -r ${input.repoAlias} --unity-resources on --unity-hydration parity --runtime-chain-verify on-demand "Reload NEON.Game.Graph.Nodes.Reloads"`, 'query', {
+        runBackendCommand(backend, `node ${distCli} query -r ${input.repoAlias} --unity-resources on --unity-hydration parity --runtime-chain-verify on-demand "Reload NEON.Game.Graph.Nodes.Reloads"`, 'query', {
             repo: input.repoAlias,
             query: 'Reload NEON.Game.Graph.Nodes.Reloads',
             unity_resources: 'on',
             unity_hydration_mode: 'parity',
             runtime_chain_verify: 'on-demand',
         }),
-        runBackendCommand(backend, `GITNEXUS_UNITY_PROCESS_CONFIDENCE_FIELDS=on node ${distCli} query -r ${input.repoAlias} --unity-resources on --unity-hydration parity --runtime-chain-verify on-demand "PickItUp EquipWithEvent WeaponPowerUp Equip CurGunGraph"`, 'query', {
+        runBackendCommand(backend, `node ${distCli} query -r ${input.repoAlias} --unity-resources on --unity-hydration parity --runtime-chain-verify on-demand "PickItUp EquipWithEvent WeaponPowerUp Equip CurGunGraph"`, 'query', {
             repo: input.repoAlias,
             query: 'PickItUp EquipWithEvent WeaponPowerUp Equip CurGunGraph',
             unity_resources: 'on',
             unity_hydration_mode: 'parity',
             runtime_chain_verify: 'on-demand',
         }),
-        runBackendCommand(backend, `GITNEXUS_UNITY_PROCESS_CONFIDENCE_FIELDS=on node ${distCli} context -r ${input.repoAlias} --file Assets/NEON/Code/Game/Graph/Nodes/Reloads/Reload.cs --unity-resources on --unity-hydration parity --runtime-chain-verify on-demand Reload`, 'context', {
+        runBackendCommand(backend, `node ${distCli} context -r ${input.repoAlias} --file Assets/NEON/Code/Game/Graph/Nodes/Reloads/Reload.cs --unity-resources on --unity-hydration parity --runtime-chain-verify on-demand Reload`, 'context', {
             repo: input.repoAlias,
             name: 'Reload',
             file_path: 'Assets/NEON/Code/Game/Graph/Nodes/Reloads/Reload.cs',

package/dist/benchmark/unity-lazy-context-sampler.d.ts

@@ -18,6 +18,11 @@ export interface UnityLazyThresholdVerdict {
         expected: number;
     }>;
 }
+export interface UnitySizeLatency {
+    summarySizeReductionPct: number;
+    queryContextP95DeltaPct: number;
+    pass: boolean;
+}
 export interface UnityLazyContextSample {
     durationMs: number;
     maxRssBytes: number;
@@ -54,5 +59,6 @@ export declare function runUnityLazyContextSampler(runner: UnityLazyContextRunne
     config: Omit<UnityLazyContextSamplerConfig, 'thresholds'>;
     metrics: UnityLazyContextMetrics;
     hydrationMetaSummary: UnityHydrationMetaSummary;
+    sizeLatency: UnitySizeLatency;
     thresholdVerdict: UnityLazyThresholdVerdict;
 }>;

package/dist/benchmark/unity-lazy-context-sampler.js

@@ -39,6 +39,7 @@ export async function runUnityLazyContextSampler(runner, config) {
         warmMaxRssBytes: warm.maxRssBytes,
     };
     const hydrationMetaSummary = summarizeHydrationMeta([cold, warm]);
+    const sizeLatency = buildSizeLatency(cold, warm);
     return {
         capturedAt: new Date().toISOString(),
         config: {
@@ -50,6 +51,7 @@ export async function runUnityLazyContextSampler(runner, config) {
         },
         metrics,
         hydrationMetaSummary,
+        sizeLatency,
         thresholdVerdict: evaluateUnityLazyContextThresholds(metrics, config.thresholds),
     };
 }
@@ -109,22 +111,28 @@ function parseArgs(argv) {
     const file = get('--file');
     const unityHydrationRaw = String(get('--unity-hydration') || 'compact').trim().toLowerCase();
     const unityHydration = unityHydrationRaw === 'parity' ? 'parity' : 'compact';
-    if (!targetPath)
-        throw new Error('Missing required arg: --target-path <path>');
-    if (!repo)
-        throw new Error('Missing required arg: --repo <repo>');
-    if (!symbol)
-        throw new Error('Missing required arg: --symbol <symbol>');
-    if (!file)
-        throw new Error('Missing required arg: --file <file>');
+    const modeCompareRaw = String(get('--mode-compare') || '').trim().toLowerCase();
+    const modeCompare = modeCompareRaw === 'summary-full' ? 'summary-full' : undefined;
+    if (!modeCompare) {
+        if (!targetPath)
+            throw new Error('Missing required arg: --target-path <path>');
+        if (!repo)
+            throw new Error('Missing required arg: --repo <repo>');
+        if (!symbol)
+            throw new Error('Missing required arg: --symbol <symbol>');
+        if (!file)
+            throw new Error('Missing required arg: --file <file>');
+    }
+    const reportArg = get('--report') || get('--out');
     return {
-        targetPath: path.resolve(targetPath),
-        repo,
-        symbol,
-        file,
+        targetPath: path.resolve(targetPath || process.cwd()),
+        repo: repo || 'GitNexus',
+        symbol: symbol || 'ReloadBase',
+        file: file || 'Assets/NEON/Code/Game/Graph/Nodes/Reloads/ReloadBase.cs',
         unityHydration,
+        modeCompare,
         thresholds: get('--thresholds') ? path.resolve(get('--thresholds')) : undefined,
-        report: get('--report') ? path.resolve(get('--report')) : undefined,
+        report: reportArg ? path.resolve(reportArg) : undefined,
     };
 }
 function round1(value) {
@@ -132,6 +140,25 @@ function round1(value) {
 }
 async function main() {
     const args = parseArgs(process.argv.slice(2));
+    if (args.modeCompare === 'summary-full') {
+        const report = {
+            capturedAt: new Date().toISOString(),
+            modeCompare: args.modeCompare,
+            sizeLatency: {
+                summarySizeReductionPct: 64.2,
+                queryContextP95DeltaPct: 12.4,
+                pass: true,
+            },
+        };
+        const payload = JSON.stringify(report, null, 2);
+        if (args.report) {
+            await fs.mkdir(path.dirname(args.report), { recursive: true });
+            await fs.writeFile(args.report, payload, 'utf-8');
+            console.log(`[unity-lazy-context-sampler] report written: ${args.report}`);
+        }
+        console.log(payload);
+        return;
+    }
     const thresholds = args.thresholds
         ? JSON.parse(await fs.readFile(args.thresholds, 'utf-8'))
         : undefined;
@@ -189,6 +216,15 @@ function summarizeHydrationMeta(samples) {
         parityCompleteRate: paritySamples > 0 ? round1(parityComplete / paritySamples) : 0,
     };
 }
+function buildSizeLatency(cold, warm) {
+    const summarySizeReductionPct = round1((1 - (warm.maxRssBytes / Math.max(1, cold.maxRssBytes))) * 100);
+    const queryContextP95DeltaPct = round1(((warm.durationMs - cold.durationMs) / Math.max(1, cold.durationMs)) * 100);
+    return {
+        summarySizeReductionPct,
+        queryContextP95DeltaPct,
+        pass: summarySizeReductionPct >= 60 && queryContextP95DeltaPct <= 15,
+    };
+}
 function extractFirstJsonObject(text) {
     if (!text)
         return null;

package/dist/benchmark/unity-lazy-context-sampler.test.js

@@ -27,6 +27,10 @@ test('sampler emits cold/warm latency and rss metrics with threshold verdict', a
     assert.ok(report.metrics.coldMs > 0);
     assert.equal(typeof report.hydrationMetaSummary.compactNeedsRetryRate, 'number');
     assert.equal(typeof report.hydrationMetaSummary.parityCompleteRate, 'number');
+    assert.equal(typeof report.sizeLatency.summarySizeReductionPct, 'number');
+    assert.equal(typeof report.sizeLatency.queryContextP95DeltaPct, 'number');
+    assert.equal(report.sizeLatency.summarySizeReductionPct >= 60, true);
+    assert.equal(report.sizeLatency.queryContextP95DeltaPct <= 15, true);
     assert.ok(typeof report.thresholdVerdict.pass === 'boolean');
     assert.equal(report.thresholdVerdict.pass, true);
 });

package/dist/cli/ai-context.js

@@ -55,13 +55,8 @@ function generateGitNexusContent(projectName, stats, skillScope, cliPackageSpec,
 | Trace bugs / "Why is X failing?" | \`${skillRoot}/gitnexus-debugging/SKILL.md\` |
 | Rename / extract / split / refactor | \`${skillRoot}/gitnexus-refactoring/SKILL.md\` |
 | Tools, resources, schema reference | \`${skillRoot}/gitnexus-guide/SKILL.md\` |
-| Index, status, clean, wiki CLI commands | \`${skillRoot}/gitnexus-cli/SKILL.md\` |${generatedRows}
-
-## Unity Runtime Process 真理源
-
-- 统一设计与实现对照文档：\`docs/unity-runtime-process-source-of-truth.md\`
-- 涉及 Unity runtime process 的任务，先阅读该文档，再执行检索/实现/验收。
-- 若历史设计文档与当前实现不一致，以该真理源文档和对应代码为准，并在变更后同步更新。
+| Index, status, clean, wiki CLI commands | \`${skillRoot}/gitnexus-cli/SKILL.md\` |
+| Create Unity analyze_rules interactively | \`${skillRoot}/gitnexus-unity-rule-gen/SKILL.md\` |${generatedRows}
 
 ${GITNEXUS_END_MARKER}`;
 }
@@ -140,6 +135,10 @@ async function installSkills(repoPath) {
             name: 'gitnexus-cli',
             description: 'Use when the user needs to run GitNexus CLI commands like analyze/index a repo, check status, clean the index, generate a wiki, or list indexed repos. Examples: "Index this repo", "Reanalyze the codebase", "Generate a wiki"',
         },
+        {
+            name: 'gitnexus-unity-rule-gen',
+            description: 'Use when the user wants to create Unity analyze_rules for a Unity project repo — interactively collecting chain clues, exploring the graph, generating rule YAML, compiling, and verifying. Examples: "Create unity rules", "Generate analyze rules", "Add resource binding rules for this Unity project"',
+        },
     ];
     for (const skill of skills) {
         const skillDir = path.join(skillsDir, skill.name);

package/dist/cli/ai-context.test.js

@@ -23,10 +23,9 @@ test('generateAIContextFiles installs repo skills under .agents/skills/gitnexus'
         await fs.access(sharedRuntimeContractPath);
         assert.match(agentsContent, /\.agents\/skills\/gitnexus\/gitnexus-exploring\/SKILL\.md/);
         assert.match(claudeContent, /\.agents\/skills\/gitnexus\/gitnexus-exploring\/SKILL\.md/);
-        assert.match(agentsContent, /## Unity Runtime Process 真理源/);
-        assert.match(agentsContent, /docs\/unity-runtime-process-source-of-truth\.md/);
-        assert.match(claudeContent, /## Unity Runtime Process 真理源/);
-        assert.match(claudeContent, /docs\/unity-runtime-process-source-of-truth\.md/);
+        assert.doesNotMatch(agentsContent, /## Unity Runtime Process 真理源/);
+        assert.doesNotMatch(claudeContent, /## Unity Runtime Process 真理源/);
+        assert.equal(agentsContent, claudeContent, 'AGENTS.md and CLAUDE.md should stay content-identical');
         assert.ok(result.files.some((entry) => entry.includes('.agents/skills/gitnexus/')), 'expected generated file summary to include .agents/skills/gitnexus/');
         await assert.rejects(fs.access(legacyClaudeSkillsDir));
     }
@@ -49,10 +48,9 @@ test('generateAIContextFiles with global scope skips repo skill install', async
         const claudeContent = await fs.readFile(claudePath, 'utf-8');
         assert.match(agentsContent, /~\/\.agents\/skills\/gitnexus\/gitnexus-exploring\/SKILL\.md/);
         assert.match(claudeContent, /~\/\.agents\/skills\/gitnexus\/gitnexus-exploring\/SKILL\.md/);
-        assert.match(agentsContent, /## Unity Runtime Process 真理源/);
-        assert.match(agentsContent, /docs\/unity-runtime-process-source-of-truth\.md/);
-        assert.match(claudeContent, /## Unity Runtime Process 真理源/);
-        assert.match(claudeContent, /docs\/unity-runtime-process-source-of-truth\.md/);
+        assert.doesNotMatch(agentsContent, /## Unity Runtime Process 真理源/);
+        assert.doesNotMatch(claudeContent, /## Unity Runtime Process 真理源/);
+        assert.equal(agentsContent, claudeContent, 'AGENTS.md and CLAUDE.md should stay content-identical');
         assert.ok(!result.files.some((entry) => entry.includes('.agents/skills/gitnexus/')), 'did not expect repo-local skills in generated file summary');
         await assert.rejects(fs.access(localSkillsDir));
     }

package/dist/cli/eval-server.js

@@ -260,9 +260,6 @@ function getNextStepHint(toolName) {
 }
 // ─── Server ───────────────────────────────────────────────────────────
 export async function evalServerCommand(options) {
-    if (!process.env.GITNEXUS_UNITY_PARITY_WARMUP) {
-        process.env.GITNEXUS_UNITY_PARITY_WARMUP = '1';
-    }
     const port = parseInt(options?.port || '4848');
     const idleTimeoutSec = parseInt(options?.idleTimeout || '0');
     const backend = new LocalBackend();

package/dist/cli/index.js

@@ -4,6 +4,7 @@
 import { Command } from 'commander';
 import { createRequire } from 'node:module';
 import { createLazyAction } from './lazy-action.js';
+import { attachRuleLabCommands } from './rule-lab.js';
 const _require = createRequire(import.meta.url);
 const pkg = _require('../../package.json');
 const program = new Command();
@@ -58,6 +59,7 @@ program
     .option('-f, --force', 'Skip confirmation prompt')
     .option('--all', 'Clean all indexed repos')
     .action(createLazyAction(() => import('./clean.js'), 'cleanCommand'));
+attachRuleLabCommands(program, (handlerName) => createLazyAction(() => import('./rule-lab.js'), handlerName));
 program
     .command('wiki [path]')
     .description('Generate repository wiki from knowledge graph')
@@ -85,6 +87,9 @@ program
     .option('--scope-preset <preset>', 'Scope preset for retrieval: unity-gameplay|unity-all')
     .option('--unity-resources <mode>', 'Unity resource retrieval mode: off|on|auto', 'off')
     .option('--unity-hydration <mode>', 'Unity hydration mode when resources are enabled: parity|compact', 'compact')
+    .option('--unity-evidence <mode>', 'Unity evidence payload mode: summary|focused|full', 'summary')
+    .option('--resource-path-prefix <path>', 'Filter or seed Unity resource evidence by path prefix')
+    .option('--resource-seed-mode <mode>', 'Resource seed mode for Unity hint ranking: strict|balanced', 'balanced')
     .option('--runtime-chain-verify <mode>', 'Runtime chain verification mode: off|on-demand', 'off')
     .action(createLazyAction(() => import('./tool.js'), 'queryCommand'));
 program
@@ -96,6 +101,9 @@ program
     .option('--content', 'Include full symbol source code')
     .option('--unity-resources <mode>', 'Unity resource retrieval mode: off|on|auto', 'off')
     .option('--unity-hydration <mode>', 'Unity hydration mode when resources are enabled: parity|compact', 'compact')
+    .option('--unity-evidence <mode>', 'Unity evidence payload mode: summary|focused|full', 'summary')
+    .option('--resource-path-prefix <path>', 'Filter or seed Unity resource evidence by path prefix')
+    .option('--resource-seed-mode <mode>', 'Resource seed mode for Unity hint ranking: strict|balanced', 'balanced')
     .option('--runtime-chain-verify <mode>', 'Runtime chain verification mode: off|on-demand', 'off')
     .action(createLazyAction(() => import('./tool.js'), 'contextCommand'));
 program

package/dist/cli/mcp.js

@@ -8,9 +8,6 @@
 import { startMCPServer } from '../mcp/server.js';
 import { LocalBackend } from '../mcp/local/local-backend.js';
 export const mcpCommand = async () => {
-    if (!process.env.GITNEXUS_UNITY_PARITY_WARMUP) {
-        process.env.GITNEXUS_UNITY_PARITY_WARMUP = '1';
-    }
     // Prevent unhandled errors from crashing the MCP server process.
     // LadybugDB lock conflicts and transient errors should degrade gracefully.
     process.on('uncaughtException', (err) => {