Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

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.mjs
index 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 behavi
assert.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.mjs
index 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 publi
assert.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.mjs
index 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.mjs
index 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.mjs
index 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-co
const 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, and
test('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.mjs
index 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 expli
assert.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.mjs
index 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 animated
assert.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 existin
assert.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.mjs
index 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.mjs
index 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 = [
+ '![開発版](https://img.shields.io/badge/version-2.13.0--dev.0-blue)',
+ '',
+ `現在の開発版: \`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 = [
+ '![安定版](https://img.shields.io/badge/version-2.13.0-blue)',
+ '',
+ `現在の安定版: \`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 docs
writeFile(fixture, 'README.md', staleEnglish);
writeFile(fixture, 'README_EN.md', staleEnglish);
writeFile(fixture, 'README_ZH.md', '![Version](https://img.shields.io/badge/version-2.13.0-blue)\n\nArchify 2.12 包含未发布能力。\n');
+ writeFile(fixture, 'README_JA.md', '![Version](https://img.shields.io/badge/version-2.13.0-blue)\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 docs
assert.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': [
+ '![開発版](https://img.shields.io/badge/version-2.13.0--dev.0-blue)',
+ '',
+ '現在の開発版: `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': [
+ '![開発版](https://img.shields.io/badge/version-2.13.0--dev.0-blue)',
+ '',
+ '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.mjs
index 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 c
assert.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.mjs
index 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.mjs
index 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 sn
assert.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 wordi
assert.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.mjs
index 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.mjs
index 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) {