'use strict'; /** * Regression tests for #2658 — Trae runtime not detected in workflow * runtime-detection blocks (falls back to claude), and the install-time * `CLAUDE.md` path rewrite mutilates the claude fallback into a malformed * path instead of resolving to the Trae rules file. * * Defects collided (see * .gsd/bug/fix-2658-trae-runtime-not-detected-falls-back-to-/10-diagnosis.md): * * 1. `gsd-core/workflows/new-project.md` AND `gsd-core/workflows/ingest-docs.md` * (found during this remediation — same pattern, same gap, not just * new-project.md as originally reported) never recognized trae (path * `/.trae/` or env `TRAE_CONFIG_DIR`) in their runtime-detection blocks — * fell through to `RUNTIME=claude`. * 2. The `trae.js` entry in `bin/install.js`'s `RUNTIME_CONTENT_DISPATCH` * replaced bare `CLAUDE.md` first, leaving a stale `.claude/` prefix: * `.claude/CLAUDE.md` -> `.claude/.trae/rules/`. * 3. `convertClaudeToTraeMarkdown` (mirrored in `bin/install.js` and * `src/runtime-artifact-conversion.cts`) had the same class of bug but a * DIFFERENT wrong output (`.trae/.trae/rules/`), because its generic * `.claude/` -> `.trae/` rewrite ran after the bare `CLAUDE.md` rewrite * and re-mutated the leftover prefix. * 4. `capabilities/trae/capability.json` didn't declare * `hostBehaviors.projectInstructionFile`, so even a correctly-detected * trae runtime resolved to the generic `AGENTS.md` default via * `getProjectInstructionFile`. * 5. Found by the end-to-end install test below, one level deeper than the * static trace: `copyWithPathReplacement` (bin/install.js) runs a * GENERIC `~/.claude/` / `$HOME/.claude/` / `./.claude/` -> runtime-dir * rewrite on every .md file BEFORE calling `convertClaudeToTraeMarkdown`, * substituting a `pathPrefix` the converter is never given (it differs * per install: relative for a project-local install, an arbitrary * absolute path for a local install rooted elsewhere, `~/.trae/` for a * global one). The converter's `.claude/CLAUDE.md`-specific patterns * (defect 3's fix) never fire on that already-rewritten text, and the * bare fallback still doubles the prefix — a first attempt at fixing * this handled only the `./.trae/CLAUDE.md` shape and missed the * `~/.claude/` / `$HOME/.claude/` forms `gsd-core/workflows/profile-user.md` * actually uses, caught by row 12 (the real spawned install) below on a * second run. Fixed with a prefix-preserving pattern (capture whatever * precedes a `.trae/` tail, keep it, fix only the filename suffix) * instead of assuming one fixed shape. */ const { test, describe } = require('node:test'); const assert = require('node:assert/strict'); const fs = require('node:fs'); const path = require('node:path'); const fc = require('fast-check'); process.env['GSD_TEST_MODE'] = '1'; const { getProjectInstructionFile } = require('../gsd-core/bin/lib/runtime-name-policy.cjs'); const { convertClaudeToTraeMarkdown } = require('../bin/install.js'); const runtimeArtifactConversion = require('../gsd-core/bin/lib/runtime-artifact-conversion.cjs'); const { runMinimalInstall, walk } = require('./helpers/install-shared.cjs'); const { cleanup } = require('./helpers.cjs'); const REPO_ROOT = path.join(__dirname, '..'); const MALFORMED_SINGLE = '.claude/.trae/rules'; const MALFORMED_DOUBLE = '.trae/.trae/rules'; const EXPECTED_PATH = '.trae/rules/rules.md'; describe('#2658 acceptance criterion 2: getProjectInstructionFile resolves trae to a concrete file', () => { test('trae maps to .trae/rules/rules.md (not the generic AGENTS.md default)', () => { assert.strictEqual(getProjectInstructionFile('trae'), EXPECTED_PATH); }); test('capability descriptor declares the same path getProjectInstructionFile returns', () => { const cap = JSON.parse( fs.readFileSync(path.join(REPO_ROOT, 'capabilities', 'trae', 'capability.json'), 'utf8'), ); assert.strictEqual(cap.runtime.hostBehaviors.projectInstructionFile, EXPECTED_PATH); assert.strictEqual(getProjectInstructionFile('trae'), cap.runtime.hostBehaviors.projectInstructionFile); }); test('the declared path is a concrete file, not a bare directory (acceptance criterion 2)', () => { assert.ok(!EXPECTED_PATH.endsWith('/'), 'must not be directory-terminated'); assert.ok(/\.md$/.test(EXPECTED_PATH), 'must name a concrete markdown file'); }); }); describe('#2658: convertClaudeToTraeMarkdown never mutilates the CLAUDE.md path (bin/install.js)', () => { const cases = [ ['bare CLAUDE.md', 'See CLAUDE.md for details.'], ['./CLAUDE.md', 'Read ./CLAUDE.md before starting.'], ['backtick-wrapped `CLAUDE.md`', 'The file `CLAUDE.md` is authoritative.'], ['the exact reported-bug input: .claude/CLAUDE.md', 'Fallback path is .claude/CLAUDE.md by default.'], ['backtick-wrapped .claude/CLAUDE.md', 'Fallback: `.claude/CLAUDE.md`.'], ['./.claude/CLAUDE.md', 'From root: ./.claude/CLAUDE.md'], ]; for (const [label, input] of cases) { test(`${label} -> ${EXPECTED_PATH}, no malformed output`, () => { const out = convertClaudeToTraeMarkdown(input); assert.ok(!out.includes(MALFORMED_SINGLE), `output must not contain "${MALFORMED_SINGLE}": ${out}`); assert.ok(!out.includes(MALFORMED_DOUBLE), `output must not contain "${MALFORMED_DOUBLE}": ${out}`); assert.ok(out.includes(EXPECTED_PATH), `output must contain "${EXPECTED_PATH}": ${out}`); }); } test('fast-check property: any surrounding text around .claude/CLAUDE.md never yields a malformed path', () => { fc.assert( fc.property( fc.string({ maxLength: 40 }), fc.string({ maxLength: 40 }), (prefix, suffix) => { const content = `${prefix}.claude/CLAUDE.md${suffix}`; const out = convertClaudeToTraeMarkdown(content); assert.ok(!out.includes(MALFORMED_SINGLE)); assert.ok(!out.includes(MALFORMED_DOUBLE)); }, ), { numRuns: 200 }, ); }); }); describe('#2658 defect 5: post-generic-rewrite ".trae/"-prefixed forms preserve their prefix instead of doubling it', () => { // These simulate the text `copyWithPathReplacement`'s generic `~/.claude/` / // `$HOME/.claude/` / `./.claude/` -> runtime-dir pass hands to // convertClaudeToTraeMarkdown — the converter never sees the original // `.claude/`-prefixed source in this pipeline, only these already-rewritten // shapes. A fixed-shape patch that only handled the local relative form // left the local-install-absolute-path and global tilde forms broken. const cases = [ ['local relative (post "./.claude/" -> "./.trae/" rewrite)', './.trae/CLAUDE.md', './.trae/rules/rules.md'], [ 'local install absolute path (post "./.claude/" -> "/.trae/" rewrite)', '/private/var/folders/xx/gsd-trae-local-abc123/.trae/CLAUDE.md', '/private/var/folders/xx/gsd-trae-local-abc123/.trae/rules/rules.md', ], ['global tilde (post "~/.claude/" -> "~/.trae/" rewrite)', '~/.trae/CLAUDE.md', '~/.trae/rules/rules.md'], ['backtick-wrapped local relative', '`./.trae/CLAUDE.md`', '`./.trae/rules/rules.md`'], ]; for (const [label, input, expected] of cases) { test(`${label} -> prefix preserved, no malformed path`, () => { const out = convertClaudeToTraeMarkdown(input); assert.ok(!out.includes(MALFORMED_SINGLE), `output must not contain "${MALFORMED_SINGLE}": ${out}`); assert.ok(!out.includes(MALFORMED_DOUBLE), `output must not contain "${MALFORMED_DOUBLE}": ${out}`); assert.strictEqual(out, expected); }); } test('fast-check property: any arbitrary path ending in .trae/ never yields a doubled prefix', () => { fc.assert( fc.property( fc.string({ maxLength: 30 }).filter((s) => !s.includes('`') && !/\s/.test(s)), (prefix) => { const content = `${prefix}.trae/CLAUDE.md`; const out = convertClaudeToTraeMarkdown(content); assert.ok(!out.includes(MALFORMED_SINGLE)); assert.ok(!out.includes(MALFORMED_DOUBLE)); }, ), { numRuns: 200 }, ); }); }); describe('#2658 output parity: bin/install.js vs runtime-artifact-conversion.cjs convertClaudeToTraeMarkdown (#2094 mirror)', () => { // Parity must hold for the pre-existing reported-bug input AND for every // arbitrary-prefix ".trae/"-tail shape the prefix-preserving regex // (bin/install.js:2747-2748, mirrored byte-for-byte at // src/runtime-artifact-conversion.cts:1357-1358) was added to handle. A // change to only one copy of that regex would otherwise pass every other // test in this file — none of the defect-5 cases above call the mirror — // while silently diverging from the other copy. const parityCases = [ ['the reported-bug input (bare .claude/ prefix)', 'Fallback path is .claude/CLAUDE.md by default.'], ['local relative prefix (post "./.claude/" -> "./.trae/" rewrite)', './.trae/CLAUDE.md'], [ 'nested project-path absolute prefix (post "./.claude/" -> "/.trae/" rewrite)', '/private/var/folders/xx/gsd-trae-local-abc123/.trae/CLAUDE.md', ], ['global tilde prefix (post "~/.claude/" -> "~/.trae/" rewrite)', '~/.trae/CLAUDE.md'], ['$HOME-variable prefix (post "$HOME/.claude/" -> "$HOME/.trae/" rewrite)', '$HOME/.trae/CLAUDE.md'], ['backtick-wrapped local relative prefix', '`./.trae/CLAUDE.md`'], ]; for (const [label, input] of parityCases) { test(`identical output for ${label}`, () => { assert.strictEqual( convertClaudeToTraeMarkdown(input), runtimeArtifactConversion.convertClaudeToTraeMarkdown(input), ); }); } test('fast-check property: any arbitrary ".trae/"-tail path produces identical output in both implementations', () => { fc.assert( fc.property( fc.string({ maxLength: 30 }).filter((s) => !s.includes('`') && !/\s/.test(s)), (prefix) => { const content = `${prefix}.trae/CLAUDE.md`; assert.strictEqual( convertClaudeToTraeMarkdown(content), runtimeArtifactConversion.convertClaudeToTraeMarkdown(content), ); }, ), { numRuns: 200 }, ); }); }); describe('#2658: end-to-end --trae install never emits the malformed path (acceptance criterion 1)', () => { test('local install: no emitted .md/.js/.cjs file contains the malformed strings; the rules file is concrete', () => { const { configDir, root } = runMinimalInstall({ runtime: 'trae', scope: 'local' }); try { const files = walk(configDir) .filter((f) => /\.(md|js|cjs)$/.test(f)) // gsd-core/CHANGELOG.md is excluded by exact relative path (not a blanket // .md skip — the emitted agent/command/workflow markdown this gate exists // to guard stays fully scanned). CHANGELOG.md legitimately QUOTES the // malformed `.claude/.trae/rules` / `.trae/.trae/rules` strings while // documenting the #2658 fix itself (#3006) — that historical-value // citation is not a regression of the installer's actual output. Verified // empirically: excluding only this one file drops the hit count to zero // across all 620 other emitted files. .filter((f) => f.split(path.sep).join('/').indexOf('gsd-core/CHANGELOG.md') === -1); assert.ok(files.length > 0, 'expected at least one emitted .md/.js/.cjs file'); for (const file of files) { const content = fs.readFileSync(file, 'utf8'); assert.ok(!content.includes(MALFORMED_SINGLE), `${file} must not contain "${MALFORMED_SINGLE}"`); assert.ok(!content.includes(MALFORMED_DOUBLE), `${file} must not contain "${MALFORMED_DOUBLE}"`); } } finally { cleanup(root); } }); }); describe('#2658 acceptance criterion 3: new-project.md / ingest-docs.md detect trae before falling back to claude', () => { const workflowsDir = path.join(REPO_ROOT, 'gsd-core', 'workflows'); test('new-project.md recognizes /.trae/ path and TRAE_CONFIG_DIR before the claude fallback', () => { const content = fs.readFileSync(path.join(workflowsDir, 'new-project.md'), 'utf8'); const pathBlock = content.match(/Derive `RUNTIME`[\s\S]*?Otherwise → `RUNTIME=claude`/); assert.ok(pathBlock, 'runtime-detection path block must exist'); assert.ok( /Path contains `\/\.trae\/` → `RUNTIME=trae`/.test(pathBlock[0]), 'path-based detection must recognize /.trae/ before the claude fallback', ); const envBlock = content.match(/if \[ -n "\$CODEX_HOME" \][\s\S]*?else RUNTIME="claude"; fi/); assert.ok(envBlock, 'env-var fallback block must exist'); assert.ok( /TRAE_CONFIG_DIR/.test(envBlock[0]), 'env-var fallback must recognize TRAE_CONFIG_DIR before the claude fallback', ); }); test('ingest-docs.md carries the same trae detection (found during this remediation, not just new-project.md)', () => { const content = fs.readFileSync(path.join(workflowsDir, 'ingest-docs.md'), 'utf8'); const block = content.match(/\*\*Detect runtime\*\*[\s\S]*?else → `RUNTIME=claude`/); assert.ok(block, 'runtime-detection block must exist'); assert.ok( /`\/\.trae\/` → `RUNTIME=trae`/.test(block[0]), 'ingest-docs.md must also recognize /.trae/ before the claude fallback', ); assert.ok(/TRAE_CONFIG_DIR/.test(content), 'env-var fallback mention must include TRAE_CONFIG_DIR'); }); });