Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
test: cover README_JA.md in the README maintenance contract
Ikko Eltociear Ashiminee7c7d137a809
diff --git a/archify/test/automatic-port-spread.test.mjs b/archify/test/automatic-port-spread.test.mjsindex a73bbf72..b434c50d 100644--- a/archify/test/automatic-port-spread.test.mjs+++ b/archify/test/automatic-port-spread.test.mjs@@ -375,4 +375,5 @@ test('skill and READMEs describe automatic port spread as bounded default behaviassert.match(fs.readFileSync(path.join(repoRoot, file), 'utf8'), /shared automatic endpoints spread deterministically/);}assert.match(fs.readFileSync(path.join(repoRoot, 'README_ZH.md'), 'utf8'), /共享的自动端点会确定性展开/);+ assert.match(fs.readFileSync(path.join(repoRoot, 'README_JA.md'), 'utf8'), /共有される自動接続点は決定論的に分散/);});diff --git a/archify/test/community-proof-intake.test.mjs b/archify/test/community-proof-intake.test.mjsindex 297bca8f..e13fefe2 100644--- a/archify/test/community-proof-intake.test.mjs+++ b/archify/test/community-proof-intake.test.mjs@@ -36,7 +36,7 @@ test('showcase intake requires reproducible proof, redaction, and explicit publiassert.match(template, /required:\s*true/g);const submissionUrl = 'https://github.com/tt-a1i/archify/issues/new?template=showcase.yml';- for (const readme of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ for (const readme of ['README.md', 'README_EN.md', 'README_ZH.md', 'README_JA.md']) {assert.match(read(readme), new RegExp(submissionUrl.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')), `${readme}: direct showcase link`);}});diff --git a/archify/test/cursor-onboarding.test.mjs b/archify/test/cursor-onboarding.test.mjsindex 344da9c4..73e0bc1a 100644--- a/archify/test/cursor-onboarding.test.mjs+++ b/archify/test/cursor-onboarding.test.mjs@@ -15,6 +15,7 @@ test('Cursor onboarding stays explicit, bilingual, and backed by the same Skill'const english = fs.readFileSync(path.join(repoRoot, 'README.md'), 'utf8');const englishMirror = fs.readFileSync(path.join(repoRoot, 'README_EN.md'), 'utf8');const chinese = fs.readFileSync(path.join(repoRoot, 'README_ZH.md'), 'utf8');+ const japanese = fs.readFileSync(path.join(repoRoot, 'README_JA.md'), 'utf8');const start = fs.readFileSync(path.join(repoRoot, 'docs', 'start.html'), 'utf8');const landing = fs.readFileSync(path.join(repoRoot, 'docs', 'index.html'), 'utf8');@@ -22,9 +23,10 @@ test('Cursor onboarding stays explicit, bilingual, and backed by the same Skill'for (const agent of ['Cursor', 'Claude Code', 'Codex CLI', 'OpenCode']) {assert.ok(english.includes(agent), `English README must name ${agent}`);assert.ok(chinese.includes(agent), `Chinese README must name ${agent}`);+ assert.ok(japanese.includes(agent), `Japanese README must name ${agent}`);}- for (const surface of [english, chinese, landing]) assert.ok(surface.includes(cursorCommand));- for (const surface of [english, chinese, start, landing]) {+ for (const surface of [english, chinese, japanese, landing]) assert.ok(surface.includes(cursorCommand));+ for (const surface of [english, chinese, japanese, start, landing]) {assert.doesNotMatch(surface, /skills use[^\n<]*--agent cursor/);assert.doesNotMatch(surface, /~\/\.cursor\/skills\/archify/);assert.doesNotMatch(surface, /all Cursor models|every Cursor model/i);diff --git a/archify/test/golden.mjs b/archify/test/golden.mjsindex bbdae366..ae120315 100644--- a/archify/test/golden.mjs+++ b/archify/test/golden.mjs@@ -183,7 +183,7 @@ check('SKILL.md metadata version matches package.json major.minor',!!packageMajorMinor && skillVersion === packageMajorMinor,`SKILL.md says ${skillVersion}, package.json says ${pkg.version}`);-for (const readmeName of ['README.md', 'README_EN.md', 'README_ZH.md']) {+for (const readmeName of ['README.md', 'README_EN.md', 'README_ZH.md', 'README_JA.md']) {const readme = fs.readFileSync(path.join(repoRoot, readmeName), 'utf8');const badgeVersions = shieldsBadgeMessages(readme, 'version');check(`${readmeName} badge matches package.json version`,diff --git a/archify/test/preview-contract.test.mjs b/archify/test/preview-contract.test.mjsindex ccf5bb26..6342bd5b 100644--- a/archify/test/preview-contract.test.mjs+++ b/archify/test/preview-contract.test.mjs@@ -12,6 +12,7 @@ const delivery = fs.readFileSync(path.join(skillRoot, 'references', 'delivery-coconst readme = fs.readFileSync(path.join(repoRoot, 'README.md'), 'utf8');const english = fs.readFileSync(path.join(repoRoot, 'README_EN.md'), 'utf8');const chinese = fs.readFileSync(path.join(repoRoot, 'README_ZH.md'), 'utf8');+const japanese = fs.readFileSync(path.join(repoRoot, 'README_JA.md'), 'utf8');test('preview contract: the skill keeps live preview explicit, desktop-only, and last-good', () => {assert.match(delivery, /archify\.mjs preview <type> <input>\.json <output>\.html/);@@ -24,7 +25,7 @@ test('preview contract: the skill keeps live preview explicit, desktop-only, andtest('preview contract: all README languages document the same optional command without changing the hero', () => {assert.equal(readme, english);- for (const text of [readme, chinese]) {+ for (const text of [readme, chinese, japanese]) {assert.match(text, /bin\/archify\.mjs preview workflow/);assert.match(text, /--no-open/);assert.match(text, /127\.0\.0\.1/);diff --git a/archify/test/reach-share-card.test.mjs b/archify/test/reach-share-card.test.mjsindex d98342d7..6e5f06a7 100644--- a/archify/test/reach-share-card.test.mjs+++ b/archify/test/reach-share-card.test.mjs@@ -129,7 +129,7 @@ test('Skill, product docs, and READMEs keep the optional truthful boundary expliassert.match(viewer, /authored reachability/i);assert.match(viewer, /download-only/i);- for (const readme of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ for (const readme of ['README.md', 'README_EN.md', 'README_ZH.md', 'README_JA.md']) {const text = fs.readFileSync(path.join(repoRoot, readme), 'utf8');assert.match(text, /Reach Share Card/, readme);assert.match(text, /docs\/assets\/mco-runtime-reach-share-card\.png/, readme);diff --git a/archify/test/readme-showcase.test.mjs b/archify/test/readme-showcase.test.mjsindex a32de60f..255159bd 100644--- a/archify/test/readme-showcase.test.mjs+++ b/archify/test/readme-showcase.test.mjs@@ -13,6 +13,55 @@ const repoRoot = path.resolve(skillRoot, '..');const assetPath = path.join(repoRoot, 'docs', 'assets', 'archify-live-proof.gif');const receiptPath = path.join(repoRoot, 'docs', 'assets', 'archify-live-proof.json');+const readmeLanguages = [+ {+ file: 'README.md',+ href: './README.md',+ label: 'English',+ demos: '## See Archify in action',+ preview: '## Preview',+ quickStart: '## Quick start',+ contributing: '## Contributing',+ noRepository: /No repository is required/,+ },+ {+ file: 'README_EN.md',+ href: './README.md',+ label: 'English',+ demos: '## See Archify in action',+ preview: '## Preview',+ quickStart: '## Quick start',+ contributing: '## Contributing',+ noRepository: /No repository is required/,+ },+ {+ file: 'README_ZH.md',+ href: './README_ZH.md',+ label: '简体中文',+ demos: '## 看看 Archify 能做什么',+ preview: '## 预览',+ quickStart: '## 快速开始',+ contributing: '## 参与贡献',+ noRepository: /不需要绑定代码库/,+ },+ {+ file: 'README_JA.md',+ href: './README_JA.md',+ label: '日本語',+ demos: '## 実際の Archify',+ preview: '## プレビュー',+ quickStart: '## クイックスタート',+ contributing: '## コントリビュート',+ noRepository: /リポジトリは不要です/,+ },+];++function sectionIndex(readme, filename, heading) {+ const index = readme.indexOf(heading);+ assert.ok(index >= 0, `${filename}: section heading ${heading} is missing`);+ return index;+}+function sha256(file) {return crypto.createHash('sha256').update(fs.readFileSync(file)).digest('hex');}@@ -117,8 +166,28 @@ test('README motion proof is compact, looping, and backed by current gallery art}});+test('every README header links to the other languages', () => {+ const languageLinks = [];+ for (const { href, label } of readmeLanguages) {+ if (!languageLinks.some((entry) => entry.href === href)) languageLinks.push({ href, label });+ }+ for (const language of readmeLanguages) {+ const readme = fs.readFileSync(path.join(repoRoot, language.file), 'utf8');+ const header = readme.slice(0, sectionIndex(readme, language.file, language.demos));+ for (const { href, label } of languageLinks) {+ const anchor = `<a href="${href}"><strong>${label}</strong></a>`;+ if (href === language.href) {+ assert.ok(!header.includes(anchor), `${language.file}: header must not link its own language`);+ } else {+ assert.ok(header.includes(anchor), `${language.file}: header must link ${label} (${href})`);+ }+ }+ }+});+test('all README languages show the brand mark and retain the verified animated proof', () => {- for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ for (const language of readmeLanguages) {+ const filename = language.file;const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');const markIndex = readme.indexOf('docs/assets/archify-lockup-light.svg');const heroPath = 'docs/assets/archify-readme-hero.png';@@ -129,7 +198,7 @@ test('all README languages show the brand mark and retain the verified animatedassert.ok(heroIndex < readme.indexOf('<strong>', taglineEnd), `${filename}: hero must precede navigation`);assert.match(readme.slice(taglineEnd + 5), /^\s*<p align="center"><img src="docs\/assets\/archify-readme-hero\.png"/);const proofIndex = readme.indexOf('docs/assets/archify-live-proof.gif');- const demosIndex = Math.max(readme.indexOf('## See Archify in action'), readme.indexOf('## 看看 Archify 能做什么'));+ const demosIndex = sectionIndex(readme, filename, language.demos);assert.ok(markIndex >= 0 && markIndex < demosIndex, `${filename}: brand lockup is missing before the demos`);assert.ok(proofIndex > demosIndex, `${filename}: animated proof must live in the demo section`);assert.match(readme, /docs\/assets\/archify-live-proof\.gif/);@@ -143,7 +212,7 @@ test('all README languages show the brand mark and retain the verified animated});test('README installation tables contain a complete DeepSeek Harness row', () => {- for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ for (const { file: filename } of readmeLanguages) {const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');const row = readme.split('\n').find((line) => line.startsWith('| **DeepSeek Harness** |'));assert.ok(row, `${filename}: DeepSeek Harness must be an installation table row`);@@ -164,7 +233,7 @@ test('README installation tables contain a complete DeepSeek Harness row', () =>});test('README installation tables include Hermes Agent before DeepSeek Harness', () => {- for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ for (const { file: filename } of readmeLanguages) {const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');const hermes = readme.split('\n').find((line) => line.startsWith('| **Hermes Agent** |'));const dsh = readme.split('\n').find((line) => line.startsWith('| **DeepSeek Harness** |'));@@ -208,13 +277,14 @@ test('README demos use checked-in captures and live deep links below the existinassert.ok(buffer.byteLength < 400 * 1024, `${demo.asset}: capture is too large`);}- for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ for (const language of readmeLanguages) {+ const filename = language.file;const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');const markIndex = readme.indexOf('docs/assets/archify-lockup-light.svg');const proofIndex = readme.indexOf('docs/assets/archify-live-proof.gif');- const previewIndex = Math.max(readme.indexOf('## Preview'), readme.indexOf('## 预览'));- const demosIndex = Math.max(readme.indexOf('## See Archify in action'), readme.indexOf('## 看看 Archify 能做什么'));- const quickStartIndex = Math.max(readme.indexOf('## Quick start'), readme.indexOf('## 快速开始'));+ const previewIndex = sectionIndex(readme, filename, language.preview);+ const demosIndex = sectionIndex(readme, filename, language.demos);+ const quickStartIndex = sectionIndex(readme, filename, language.quickStart);assert.ok(markIndex >= 0 && markIndex < demosIndex, `${filename}: brand mark must precede the demos`);assert.ok(demosIndex < previewIndex && previewIndex < quickStartIndex, `${filename}: demo section is misplaced`);assert.ok(demosIndex < proofIndex && proofIndex < previewIndex, `${filename}: animated proof is outside the demo section`);@@ -244,12 +314,12 @@ test('README preserves the visual proof set and key content', () => {'archify-lifecycle.png',];- for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ for (const { file: filename, noRepository } of readmeLanguages) {const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');const supercode = readme.indexOf('https://supercode.sh/?utm_source=archify');const evermind = readme.indexOf('docs/assets/sponsors/evermind-archify-raven.png');assert.ok(supercode >= 0 && evermind > supercode, `${filename}: EverMind must follow Supercode`);- assert.match(readme, filename === 'README_ZH.md' ? /不需要绑定代码库/ : /No repository is required/);+ assert.match(readme, noRepository, `${filename}: the no-repository entry point is missing`);for (const asset of commonAssets) {assert.ok(readme.includes(`docs/assets/${asset}`), `${filename}: visual proof ${asset} was removed`);}@@ -262,11 +332,12 @@ test('all README languages end with the self-hosted star history chart', () => {const darkChart = 'https://raw.githubusercontent.com/tt-a1i/archify/star-history/assets/star-history-dark.svg';const workflow = fs.readFileSync(path.join(repoRoot, '.github', 'workflows', 'star-history.yml'), 'utf8');- for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ for (const language of readmeLanguages) {+ const filename = language.file;const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');- const sectionIndex = readme.lastIndexOf('## Star History');- const contributingIndex = Math.max(readme.indexOf('## Contributing'), readme.indexOf('## 参与贡献'));- assert.ok(sectionIndex > contributingIndex, `${filename}: Star History must follow Contributing`);+ const starHistoryIndex = readme.lastIndexOf('## Star History');+ const contributingIndex = sectionIndex(readme, filename, language.contributing);+ assert.ok(starHistoryIndex > contributingIndex, `${filename}: Star History must follow Contributing`);assert.ok(readme.includes(lightChart), `${filename}: missing light star history chart`);assert.ok(readme.includes(darkChart), `${filename}: missing dark star history chart`);assert.equal(readme.trimEnd().endsWith('</p>'), true, `${filename}: Star History must remain the final section`);diff --git a/archify/test/real-repository-proof.test.mjs b/archify/test/real-repository-proof.test.mjsindex a6597f10..db2f5707 100644--- a/archify/test/real-repository-proof.test.mjs+++ b/archify/test/real-repository-proof.test.mjs@@ -198,7 +198,7 @@ test('MCO public proof is source-backed, valid, and linked from every README', (const repositorySlug = new URL(source.meta.repository.url).pathname.replace(/^\/|\/$/g, '');const shortRevision = source.meta.repository.revision.slice(0, 7);- for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md', 'README_JA.md']) {const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');assert.match(readme, /docs\/assets\/mco-runtime-share-card\.png/);assert.match(readme, /cases\/mco-runtime\.architecture\.html\?theme=dark&present=1#view=dispatch-path/);diff --git a/archify/test/release-identity.test.mjs b/archify/test/release-identity.test.mjsindex ca7232c4..0c8e1fe5 100644--- a/archify/test/release-identity.test.mjs+++ b/archify/test/release-identity.test.mjs@@ -57,6 +57,13 @@ function writeValidDevelopmentFixture(root, overrides = {}) {'','Raven 使用 ZIP 手动安装:将 archify.zip 解压到 `~/.raven/workspace/skills`,解压后会得到 `~/.raven/workspace/skills/archify`;Raven 不属于 Agent 切换器目标。',].join('\n');+ const japanese = [+ '',+ '',+ `現在の開発版: \`v${version}\``,+ '',+ 'Raven は手動 ZIP インストールのみです: `archify.zip` を `~/.raven/workspace/skills` に展開してください。`~/.raven/workspace/skills/archify` が作成されます。Raven はエージェント切り替えの対象ではありません。',+ ].join('\n');const files = {'archify/package.json': JSON.stringify({ version }),'archify/package-lock.json': JSON.stringify({ version, packages: { '': { version } } }),@@ -87,6 +94,7 @@ function writeValidDevelopmentFixture(root, overrides = {}) {'README.md': english,'README_EN.md': english,'README_ZH.md': chinese,+ 'README_JA.md': japanese,'scripts/start-template.html': 'development · 开发版 · [[ARCHIFY_VERSION]]','scripts/guide-template.html': 'development · 开发版 · [[ARCHIFY_VERSION]]','scripts/gallery-template.html': 'development · 开发版 · [[ARCHIFY_VERSION]]',@@ -115,6 +123,13 @@ function writeValidStableFixture(root, overrides = {}) {'','Raven 使用 ZIP 手动安装:将 archify.zip 解压到 `~/.raven/workspace/skills`,解压后会得到 `~/.raven/workspace/skills/archify`;Raven 不属于 Agent 切换器目标。',].join('\n');+ const japanese = [+ '',+ '',+ `現在の安定版: \`v${version}\``,+ '',+ 'Raven は手動 ZIP インストールのみです: `archify.zip` を `~/.raven/workspace/skills` に展開してください。`~/.raven/workspace/skills/archify` が作成されます。Raven はエージェント切り替えの対象ではありません。',+ ].join('\n');const files = {'archify/package.json': JSON.stringify({ version }),'archify/package-lock.json': JSON.stringify({ version, packages: { '': { version } } }),@@ -141,6 +156,7 @@ function writeValidStableFixture(root, overrides = {}) {'README.md': english,'README_EN.md': english,'README_ZH.md': chinese,+ 'README_JA.md': japanese,'scripts/start-template.html': 'stable · 稳定版 · [[ARCHIFY_VERSION]]','scripts/guide-template.html': 'stable · 稳定版 · [[ARCHIFY_VERSION]]','scripts/gallery-template.html': 'stable · 稳定版 · [[ARCHIFY_VERSION]]',@@ -348,6 +364,7 @@ test('package, lockfile, Skill metadata, escaped Shields badge, and public docswriteFile(fixture, 'README.md', staleEnglish);writeFile(fixture, 'README_EN.md', staleEnglish);writeFile(fixture, 'README_ZH.md', '\n\nArchify 2.12 包含未发布能力。\n');+ writeFile(fixture, 'README_JA.md', '\n\nArchify 2.12 は未リリース機能を含みます。\n');writeFile(fixture, 'docs/index.html', '<span>Agent Skill · v2.12.0</span>');writeFile(fixture, 'docs/start.html', '<span>Archify v2.12.0</span>');@@ -356,6 +373,7 @@ test('package, lockfile, Skill metadata, escaped Shields badge, and public docsassert.match(result.stderr, /package-lock\.json must match 2\.13\.0-dev\.0/);assert.match(result.stderr, /SKILL\.md metadata version 2\.12 must map to package 2\.13\.0-dev\.0/);assert.match(result.stderr, /README\.md must advertise development identity v2\.13\.0-dev\.0/);+ assert.match(result.stderr, /README_JA\.md must advertise development identity v2\.13\.0-dev\.0/);assert.match(result.stderr, /docs\/index\.html must advertise development identity v2\.13\.0-dev\.0/);assert.match(result.stderr, /docs\/start\.html must advertise development identity v2\.13\.0-dev\.0/);} finally {@@ -439,6 +457,48 @@ test('Raven instructions reject extracting the archive into the final Skill dire}});+test('Japanese Raven instructions reject extracting the archive into the final Skill directory', () => {+ const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-release-identity-'));+ try {+ writeValidDevelopmentFixture(fixture, {+ 'README_JA.md': [+ '',+ '',+ '現在の開発版: `v2.13.0-dev.0`',+ '',+ 'Raven は手動 ZIP インストールのみです: `archify.zip` を `~/.raven/workspace/skills/archify` に展開してください。Raven はエージェント切り替えの対象ではありません。',+ ].join('\n'),+ });++ const result = runCheck(fixture);+ assert.notEqual(result.status, 0);+ assert.match(result.stderr, /README_JA\.md: Raven must remain a manual ZIP installation outside the agent switcher/);+ } finally {+ fs.rmSync(fixture, { recursive: true, force: true });+ }+});++test('the Japanese README must carry its own development marker, not the English one', () => {+ const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-release-identity-'));+ try {+ writeValidDevelopmentFixture(fixture, {+ 'README_JA.md': [+ '',+ '',+ 'Current development version: `v2.13.0-dev.0`',+ '',+ 'Raven は手動 ZIP インストールのみです: `archify.zip` を `~/.raven/workspace/skills` に展開してください。`~/.raven/workspace/skills/archify` が作成されます。Raven はエージェント切り替えの対象ではありません。',+ ].join('\n'),+ });++ const result = runCheck(fixture);+ assert.notEqual(result.status, 0);+ assert.match(result.stderr, /README_JA\.md must advertise development identity v2\.13\.0-dev\.0/);+ } finally {+ fs.rmSync(fixture, { recursive: true, force: true });+ }+});+test('renderer template generator carries the complete package prerelease identity', () => {const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-release-identity-'));try {diff --git a/archify/test/route-share-card.test.mjs b/archify/test/route-share-card.test.mjsindex b501112f..49ca0dd7 100644--- a/archify/test/route-share-card.test.mjs+++ b/archify/test/route-share-card.test.mjs@@ -147,7 +147,7 @@ test('skill and READMEs describe the optional Export variant and show one real cassert.match(viewer, /data-share-route-\*/);assert.match(viewer, /download-only/i);- for (const readme of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ for (const readme of ['README.md', 'README_EN.md', 'README_ZH.md', 'README_JA.md']) {const text = fs.readFileSync(path.join(repoRoot, readme), 'utf8');assert.match(text, /Export → Route Share Card/, readme);assert.match(text, /docs\/assets\/archify-route-share-card\.png/, readme);diff --git a/archify/test/share-card-export.test.mjs b/archify/test/share-card-export.test.mjsindex 52977011..6ac8a3b3 100644--- a/archify/test/share-card-export.test.mjs+++ b/archify/test/share-card-export.test.mjs@@ -121,7 +121,7 @@ test('the skill and every README make the optional Share Card discoverable', ()assert.match(viewer, /never claim(?:s|ing)? validation/i);assert.match(viewer, /Copy Share Card/i);- for (const readme of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ for (const readme of ['README.md', 'README_EN.md', 'README_ZH.md', 'README_JA.md']) {const text = fs.readFileSync(path.join(repoRoot, readme), 'utf8');assert.match(text, /Share Card/i, readme);assert.match(text, /1200(?:×|x)630/, readme);diff --git a/integrations/deepseek-harness/test/docs-contract.test.mjs b/integrations/deepseek-harness/test/docs-contract.test.mjsindex b676dba9..c35cfe7b 100644--- a/integrations/deepseek-harness/test/docs-contract.test.mjs+++ b/integrations/deepseek-harness/test/docs-contract.test.mjs@@ -50,16 +50,18 @@ test('DSH documentation identifies the published release and pinned candidate snassert.match(integration, /rather than entirely declarative data/);});-test('English and Chinese docs cover install, invoke, uninstall, community wording, and Produced Files', () => {+test('English, Chinese, and Japanese docs cover install, invoke, uninstall, community wording, and Produced Files', () => {const englishRoot = read('README.md');const chineseRoot = read('README_ZH.md');+ const japaneseRoot = read('README_JA.md');const integration = read('integrations/deepseek-harness/README.md');const english = [englishRoot, integration].join('\n');const chinese = [chineseRoot, integration].join('\n');+ const japanese = [japaneseRoot, integration].join('\n');const publishedInstall = `dsh plugin --profile web add @tt-a1i/archify-dsh@${published.adapterVersion}`;const candidateInstall = `dsh plugin --profile web add @tt-a1i/archify-dsh@${candidate.adapterVersion}`;- for (const source of [english, chinese, englishRoot, chineseRoot]) {+ for (const source of [english, chinese, japanese, englishRoot, chineseRoot, japaneseRoot]) {assert.ok(source.includes(publishedInstall));assert.ok(!source.includes(candidateInstall));assert.ok(source.includes(`@deepseek-ai/dsh@${published.dshVersion}`));@@ -84,15 +86,25 @@ test('English and Chinese docs cover install, invoke, uninstall, community wordiassert.match(chinese, /Produced Files/);assert.match(chinese, /精确工作区路径/);assert.match(chinese, /遥测/);++ assert.match(japanese, /コミュニティ統合/);+ assert.match(japanese, /開発者プレビュー/);+ assert.match(japanese, /DeepSeek 公式製品ではなく/);+ assert.match(japanese, /Produced Files/);+ assert.match(japanese, /正確なワークスペースパス/);+ assert.match(japanese, /テレメトリ/);});test('Skills CLI, Cursor, Codex, Claude Code, OpenCode, and Raven remain the default main path', () => {const english = read('README.md');const chinese = read('README_ZH.md');+ const japanese = read('README_JA.md');assert.match(english, /^```bash\nnpx skills add tt-a1i\/archify -g\n```$/m);assert.match(chinese, /^```bash\nnpx skills add tt-a1i\/archify -g\n```$/m);+ assert.match(japanese, /^```bash\nnpx skills add tt-a1i\/archify -g\n```$/m);assert.match(english, /## Quick start/);assert.match(chinese, /## 快速开始/);+ assert.match(japanese, /## クイックスタート/);const dshEnglishIndex = english.indexOf('DeepSeek Harness');const quickStartIndex = english.indexOf('## Quick start');assert.ok(dshEnglishIndex > quickStartIndex, 'DSH docs must not precede the default quick start');diff --git a/integrations/hermes-agent/test/plugin-contract.test.mjs b/integrations/hermes-agent/test/plugin-contract.test.mjsindex 2dbecbe9..7783e23e 100644--- a/integrations/hermes-agent/test/plugin-contract.test.mjs+++ b/integrations/hermes-agent/test/plugin-contract.test.mjs@@ -77,9 +77,11 @@ test('docs stay community opt-in, cover Windows, and refuse a Python rewrite', (test('README install tables mention Hermes without adding a switcher agent', () => {const english = fs.readFileSync(path.join(repoRoot, 'README.md'), 'utf8');const chinese = fs.readFileSync(path.join(repoRoot, 'README_ZH.md'), 'utf8');+ const japanese = fs.readFileSync(path.join(repoRoot, 'README_JA.md'), 'utf8');const start = fs.readFileSync(path.join(repoRoot, 'docs', 'start.html'), 'utf8');assert.match(english, /\| \*\*Hermes Agent\*\* \|/);assert.match(chinese, /\| \*\*Hermes Agent\*\* \|/);+ assert.match(japanese, /\| \*\*Hermes Agent\*\* \|/);assert.match(english, /integrations\/hermes-agent\/README\.md/);assert.match(english, /hermes skills install skills-sh\/tt-a1i\/archify\/archify -y/);const skill = fs.readFileSync(path.join(repoRoot, 'archify', 'SKILL.md'), 'utf8');diff --git a/scripts/check-release-identity.mjs b/scripts/check-release-identity.mjsindex 8aa7e0c8..699cf642 100644--- a/scripts/check-release-identity.mjs+++ b/scripts/check-release-identity.mjs@@ -78,11 +78,15 @@ function versionLabels(source) {.map((match) => match[1]);}+const readmeMarkers = {+ en: { development: 'Current development version:', stable: 'Current stable version:' },+ zh: { development: '当前开发版本:', stable: '当前稳定版本:' },+ ja: { development: '現在の開発版:', stable: '現在の安定版:' },+};+function checkReadme(relativePath, source, version, language, isDevelopment) {const badge = `/badge/version-${shieldEscape(version)}-`;- const markerLabel = language === 'zh'- ? isDevelopment ? '当前开发版本:' : '当前稳定版本:'- : isDevelopment ? 'Current development version:' : 'Current stable version:';+ const markerLabel = readmeMarkers[language][isDevelopment ? 'development' : 'stable'];const identity = isDevelopment ? 'development' : 'stable';const hasMarker = source.split('\n').some((line) => line.includes(markerLabel) && line.includes(`\`v${version}\``));if (!source.includes(badge) || !hasMarker) {@@ -107,9 +111,12 @@ function checkRavenBoundary(relativePath, source, language) {const pathBoundary = String.raw`(?=$|[\s\x60'"<>,.;:,;。])`;const hasEnglishManual = /manual ZIP/i.test(source);const hasChineseManual = /(?:手动[^\n<]{0,40}ZIP|ZIP[^\n<]{0,40}手动)/i.test(source);+ const hasJapaneseManual = /(?:手動[^\n<]{0,40}ZIP|ZIP[^\n<]{0,40}手動)/i.test(source);const hasRequiredCopy = language === 'both'? hasEnglishManual && hasChineseManual- : language === 'zh' ? hasChineseManual : hasEnglishManual;+ : language === 'zh' ? hasChineseManual+ : language === 'ja' ? hasJapaneseManual+ : hasEnglishManual;const englishExtractsIntoParent = new RegExp(String.raw`(?:extract|unpack)[^\n]{0,180}archify\.zip[^\n]{0,180}(?:into|to)\s*[\x60'"<]*${installParent}${pathBoundary}`,'i',@@ -126,16 +133,30 @@ function checkRavenBoundary(relativePath, source, language) {String.raw`(?:得到|生成|产生|最终位于)[^\n]{0,120}${installedRoot}`,'i',).test(source);+ const japaneseExtractsIntoParent = new RegExp(+ String.raw`archify\.zip[^\n]{0,120}[\x60'"<]*${installParent}${pathBoundary}[^\n]{0,20}(?:に|へ)\s*(?:展開|解凍)`,+ 'i',+ ).test(source);+ const japaneseExplainsInstalledRoot = new RegExp(+ String.raw`${installedRoot}[^\n]{0,40}(?:が|は)[^\n]{0,20}(?:作成|生成|でき)`,+ 'i',+ ).test(source);const hasCorrectDestination = language === 'both'? englishExtractsIntoParent && englishExplainsInstalledRoot&& chineseExtractsIntoParent && chineseExplainsInstalledRoot: language === 'zh'? chineseExtractsIntoParent && chineseExplainsInstalledRoot- : englishExtractsIntoParent && englishExplainsInstalledRoot;+ : language === 'ja'+ ? japaneseExtractsIntoParent && japaneseExplainsInstalledRoot+ : englishExtractsIntoParent && englishExplainsInstalledRoot;const nestedDestination = new RegExp(String.raw`(?:\b(?:extract|unpack)[^\n]{0,220}(?:into|to)|解压(?:到|至))\s*[\x60'"<]*${installedRoot}`,'i',- ).test(source);+ ).test(source)+ || new RegExp(+ String.raw`${installedRoot}[^\n]{0,4}(?:に|へ)[^\n]{0,4}(?:展開|解凍)`,+ 'i',+ ).test(source);const inventsSwitcher = /data-agent=["']raven["']/i.test(source)|| /--agent\s+raven\b/i.test(source)|| /[?&]agent=raven\b/i.test(source);@@ -249,12 +270,15 @@ if (hasSupportedVersion) {const english = read('README.md');const englishMirror = read('README_EN.md');const chinese = read('README_ZH.md');+ const japanese = read('README_JA.md');checkReadme('README.md', english, version, 'en', isDevelopment);checkReadme('README_EN.md', englishMirror, version, 'en', isDevelopment);checkReadme('README_ZH.md', chinese, version, 'zh', isDevelopment);+ checkReadme('README_JA.md', japanese, version, 'ja', isDevelopment);checkRavenBoundary('README.md', english, 'en');checkRavenBoundary('README_EN.md', englishMirror, 'en');checkRavenBoundary('README_ZH.md', chinese, 'zh');+ checkRavenBoundary('README_JA.md', japanese, 'ja');if (english !== englishMirror) fail('README_EN.md must remain byte-identical to README.md.');if (newestStableLabel && isDevelopment) {