@clawplays/ospec-cli 0.3.2 → 0.3.4

package/dist/services/ConfigManager.js

@@ -91,6 +91,11 @@ class ConfigManager {
             checkpoint: PluginWorkflowComposer_1.DEFAULT_CHECKPOINT_PLUGIN_CONFIG,
         }));
     }
+    normalizeDocumentLanguage(input) {
+        return input === 'en-US' || input === 'zh-CN' || input === 'ja-JP' || input === 'ar'
+            ? input
+            : undefined;
+    }
     normalizePluginsConfig(plugins) {
         const defaults = this.createDefaultPluginsConfig();
         const stitch = plugins?.stitch && typeof plugins.stitch === 'object' ? plugins.stitch : {};
@@ -364,6 +369,7 @@ class ConfigManager {
             ...config,
             version: config.version === '3.0' ? '4.0' : config.version,
             mode,
+            documentLanguage: this.normalizeDocumentLanguage(config.documentLanguage),
             hooks: {
                 ...normalizedHooks,
                 ...(legacyWarnDefaults

package/dist/services/ProjectAssetRegistry.d.ts

@@ -5,8 +5,8 @@ export interface DirectCopyProjectAssetDefinition {
     description: string;
     targetRelativePath: string;
     overwritePolicy: 'if_missing';
-    localizedSources?: Partial<Record<'zh-CN' | 'en-US', string>>;
+    localizedSources?: Partial<Record<'zh-CN' | 'en-US' | 'ja-JP' | 'ar', string>>;
     sourceRelativePaths?: string[];
 }
 export declare const DIRECT_COPY_PROJECT_ASSETS: DirectCopyProjectAssetDefinition[];
-//# sourceMappingURL=ProjectAssetRegistry.d.ts.map
+//# sourceMappingURL=ProjectAssetRegistry.d.ts.map

package/dist/services/ProjectAssetRegistry.js

@@ -11,6 +11,8 @@ exports.DIRECT_COPY_PROJECT_ASSETS = [
         localizedSources: {
             'zh-CN': 'assets/for-ai/zh-CN/ai-guide.md',
             'en-US': 'assets/for-ai/en-US/ai-guide.md',
+            'ja-JP': 'assets/for-ai/ja-JP/ai-guide.md',
+            'ar': 'assets/for-ai/ar/ai-guide.md',
         },
     },
     {
@@ -22,6 +24,8 @@ exports.DIRECT_COPY_PROJECT_ASSETS = [
         localizedSources: {
             'zh-CN': 'assets/for-ai/zh-CN/execution-protocol.md',
             'en-US': 'assets/for-ai/en-US/execution-protocol.md',
+            'ja-JP': 'assets/for-ai/ja-JP/execution-protocol.md',
+            'ar': 'assets/for-ai/ar/execution-protocol.md',
         },
     },
     {
@@ -41,6 +45,8 @@ exports.DIRECT_COPY_PROJECT_ASSETS = [
         localizedSources: {
             'zh-CN': 'assets/project-conventions/zh-CN/naming-conventions.md',
             'en-US': 'assets/project-conventions/en-US/naming-conventions.md',
+            'ja-JP': 'assets/project-conventions/ja-JP/naming-conventions.md',
+            'ar': 'assets/project-conventions/ar/naming-conventions.md',
         },
     },
     {
@@ -52,6 +58,8 @@ exports.DIRECT_COPY_PROJECT_ASSETS = [
         localizedSources: {
             'zh-CN': 'assets/project-conventions/zh-CN/skill-conventions.md',
             'en-US': 'assets/project-conventions/en-US/skill-conventions.md',
+            'ja-JP': 'assets/project-conventions/ja-JP/skill-conventions.md',
+            'ar': 'assets/project-conventions/ar/skill-conventions.md',
         },
     },
     {
@@ -63,6 +71,8 @@ exports.DIRECT_COPY_PROJECT_ASSETS = [
         localizedSources: {
             'zh-CN': 'assets/project-conventions/zh-CN/development-guide.md',
             'en-US': 'assets/project-conventions/en-US/development-guide.md',
+            'ja-JP': 'assets/project-conventions/ja-JP/development-guide.md',
+            'ar': 'assets/project-conventions/ar/development-guide.md',
         },
     },
     {
@@ -74,6 +84,8 @@ exports.DIRECT_COPY_PROJECT_ASSETS = [
         localizedSources: {
             'zh-CN': 'assets/project-conventions/zh-CN/workflow-conventions.md',
             'en-US': 'assets/project-conventions/en-US/workflow-conventions.md',
+            'ja-JP': 'assets/project-conventions/ja-JP/workflow-conventions.md',
+            'ar': 'assets/project-conventions/ar/workflow-conventions.md',
         },
     },
     {

package/dist/services/ProjectAssetService.js

@@ -164,7 +164,7 @@ class ProjectAssetService {
         const manifest = {
             version: '1.0',
             generatedAt: new Date().toISOString(),
-            documentLanguage: options.documentLanguage || 'zh-CN',
+            documentLanguage: options.documentLanguage || 'en-US',
             assets,
             summary: {
                 directCopy: copyEntries.length,
@@ -179,6 +179,9 @@ class ProjectAssetService {
         if (documentLanguage && asset.localizedSources?.[documentLanguage]) {
             candidates.push(asset.localizedSources[documentLanguage]);
         }
+        if (asset.localizedSources?.['en-US']) {
+            candidates.push(asset.localizedSources['en-US']);
+        }
         if (asset.localizedSources?.['zh-CN']) {
             candidates.push(asset.localizedSources['zh-CN']);
         }
@@ -197,6 +200,9 @@ class ProjectAssetService {
         if (documentLanguage && asset.localizedSources?.[documentLanguage]) {
             return asset.localizedSources[documentLanguage];
         }
+        if (asset.localizedSources?.['en-US']) {
+            return asset.localizedSources['en-US'];
+        }
         if (asset.localizedSources?.['zh-CN']) {
             return asset.localizedSources['zh-CN'];
         }

package/dist/services/ProjectScaffoldCommandService.js

@@ -16,27 +16,22 @@ class ProjectScaffoldCommandService {
             return null;
         }
         const installRunner = this.resolvePackageManagerRunner('npm');
+        const copy = this.getLocalizedCopy(normalized.documentLanguage);
         return {
             presetId: scaffoldPlan.presetId,
             autoExecute: normalized.executeScaffoldCommands,
             steps: [
                 {
                     id: 'install-dependencies',
-                    title: normalized.documentLanguage === 'zh-CN'
-                        ? '安装框架依赖'
-                        : 'Install framework dependencies',
+                    title: copy.installTitle,
                     command: installRunner,
                     args: ['install'],
                     shellCommand: 'npm install',
-                    description: normalized.documentLanguage === 'zh-CN'
-                        ? '安装脚手架依赖，让生成的应用可以直接运行。'
-                        : 'Install scaffold dependencies so the generated app can run immediately.',
+                    description: copy.installDescription,
                     phase: 'install',
                 },
             ],
-            deferredMessage: normalized.documentLanguage === 'zh-CN'
-                ? '脚手架命令已生成但暂未执行。准备好后请在项目根目录运行 npm install。'
-                : 'Scaffold commands are prepared but deferred. Run npm install in the project root when you are ready.',
+            deferredMessage: copy.deferredMessage,
         };
     }
     async executePlan(rootDir, plan) {
@@ -67,6 +62,7 @@ class ProjectScaffoldCommandService {
     }
     async writeRecoveryRecord(rootDir, input) {
         const recoveryPath = path_1.default.join(rootDir, '.ospec', 'bootstrap-recovery.json');
+        const copy = this.getLocalizedCopy(input.normalized.documentLanguage);
         const record = {
             generatedAt: new Date().toISOString(),
             projectPresetId: input.normalized.projectPresetId,
@@ -82,17 +78,7 @@ class ProjectScaffoldCommandService {
                 directCopyFiles: input.directCopyCreatedFiles,
                 hooks: input.hookInstalledFiles,
             },
-            remediation: [
-                input.normalized.documentLanguage === 'zh-CN'
-                    ? '先检查网络与 npm registry 可用性，再重新执行安装命令。'
-                    : 'Check network access and npm registry availability, then rerun the install command.',
-                input.normalized.documentLanguage === 'zh-CN'
-                    ? '重试前先查看已创建的脚手架文件，确认哪些内容已经生成。'
-                    : 'Review the created scaffold files before retrying so you know which files were already generated.',
-                input.normalized.documentLanguage === 'zh-CN'
-                    ? '修复环境后，可重新执行 bootstrap，或手动执行延后的安装命令。'
-                    : 'After fixing the environment, rerun bootstrap or manually execute the deferred install command.',
-            ],
+            remediation: copy.remediation,
         };
         await this.fileService.writeJSON(recoveryPath, record);
         return recoveryPath;
@@ -152,8 +138,56 @@ class ProjectScaffoldCommandService {
         }
         return `${normalized.slice(0, 600)}...`;
     }
+    getLocalizedCopy(documentLanguage) {
+        if (documentLanguage === 'zh-CN') {
+            return {
+                installTitle: '安装框架依赖',
+                installDescription: '安装脚手架依赖，让生成的应用可以直接运行。',
+                deferredMessage: '脚手架命令已生成但暂未执行。准备好后请在项目根目录运行 npm install。',
+                remediation: [
+                    '先检查网络与 npm registry 可用性，再重新执行安装命令。',
+                    '重试前先查看已创建的脚手架文件，确认哪些内容已经生成。',
+                    '修复环境后，可重新执行 bootstrap，或手动执行延后的安装命令。',
+                ],
+            };
+        }
+        if (documentLanguage === 'ja-JP') {
+            return {
+                installTitle: 'フレームワーク依存関係をインストール',
+                installDescription: '生成されたアプリをすぐに動かせるように scaffold の依存関係をインストールします。',
+                deferredMessage: 'scaffold コマンドは生成されましたがまだ実行していません。準備ができたらプロジェクトルートで npm install を実行してください。',
+                remediation: [
+                    'まずネットワークと npm registry の利用可否を確認してからインストールを再実行してください。',
+                    '再試行前に生成済みの scaffold ファイルを確認し、どこまで生成済みか把握してください。',
+                    '環境を修正した後は bootstrap を再実行するか、保留された install コマンドを手動で実行してください。',
+                ],
+            };
+        }
+        if (documentLanguage === 'ar') {
+            return {
+                installTitle: 'تثبيت اعتماديات الإطار',
+                installDescription: 'ثبّت اعتماديات scaffold حتى يعمل التطبيق المولَّد مباشرةً.',
+                deferredMessage: 'تم إعداد أوامر scaffold ولكن تم تأجيل تنفيذها. شغّل npm install من جذر المشروع عندما تكون جاهزاً.',
+                remediation: [
+                    'تحقق أولاً من توفر الشبكة وإمكانية الوصول إلى npm registry ثم أعد تنفيذ أمر التثبيت.',
+                    'راجع ملفات scaffold التي تم إنشاؤها قبل إعادة المحاولة لمعرفة ما الذي تم توليده بالفعل.',
+                    'بعد إصلاح البيئة، أعد bootstrap أو نفّذ أمر التثبيت المؤجل يدوياً.',
+                ],
+            };
+        }
+        return {
+            installTitle: 'Install framework dependencies',
+            installDescription: 'Install scaffold dependencies so the generated app can run immediately.',
+            deferredMessage: 'Scaffold commands are prepared but deferred. Run npm install in the project root when you are ready.',
+            remediation: [
+                'Check network access and npm registry availability, then rerun the install command.',
+                'Review the created scaffold files before retrying so you know which files were already generated.',
+                'After fixing the environment, rerun bootstrap or manually execute the deferred install command.',
+            ],
+        };
+    }
 }
 exports.ProjectScaffoldCommandService = ProjectScaffoldCommandService;
 const createProjectScaffoldCommandService = (fileService, logger) => new ProjectScaffoldCommandService(fileService, logger);
 exports.createProjectScaffoldCommandService = createProjectScaffoldCommandService;
-//# sourceMappingURL=ProjectScaffoldCommandService.js.map
+//# sourceMappingURL=ProjectScaffoldCommandService.js.map

package/dist/services/ProjectScaffoldService.js

@@ -234,7 +234,7 @@ export default function RootLayout({
   children: React.ReactNode;
 }) {
   return (
-    <html lang="${normalized.documentLanguage === 'zh-CN' ? 'zh-CN' : 'en'}">
+    <html lang="${this.getHtmlLang(normalized.documentLanguage)}">
       <body>
         <SiteShell>${'\n'}          {children}${'\n'}        </SiteShell>
       </body>
@@ -245,25 +245,75 @@ export default function RootLayout({
             case 'app/page.tsx':
                 return this.renderHomePage(normalized);
             case 'app/docs/page.tsx':
-                return this.renderSectionPage(normalized, normalized.documentLanguage === 'zh-CN' ? '文档中心' : 'Docs Center', normalized.documentLanguage === 'zh-CN'
+                return this.renderSectionPage(normalized, normalized.documentLanguage === 'zh-CN'
+                    ? '文档中心'
+                    : normalized.documentLanguage === 'ja-JP'
+                        ? 'ドキュメントセンター'
+                        : normalized.documentLanguage === 'ar'
+                            ? 'مركز الوثائق'
+                            : 'Docs Center', normalized.documentLanguage === 'zh-CN'
                     ? '在这里沉淀架构说明、API 边界和团队执行流程。'
-                    : 'Document architecture, API boundaries, and team workflows in one place.');
+                    : normalized.documentLanguage === 'ja-JP'
+                        ? 'ここでアーキテクチャ、API 境界、チームの実行フローをまとめます。'
+                        : normalized.documentLanguage === 'ar'
+                            ? 'دوّن هنا المعمارية وحدود API ومسارات تنفيذ الفريق في مكان واحد.'
+                            : 'Document architecture, API boundaries, and team workflows in one place.');
             case 'app/blog/page.tsx':
-                return this.renderSectionPage(normalized, normalized.documentLanguage === 'zh-CN' ? '博客与更新日志' : 'Blog & Changelog', normalized.documentLanguage === 'zh-CN'
+                return this.renderSectionPage(normalized, normalized.documentLanguage === 'zh-CN'
+                    ? '博客与更新日志'
+                    : normalized.documentLanguage === 'ja-JP'
+                        ? 'ブログと変更履歴'
+                        : normalized.documentLanguage === 'ar'
+                            ? 'المدونة وسجل التغييرات'
+                            : 'Blog & Changelog', normalized.documentLanguage === 'zh-CN'
                     ? '在这里发布产品更新、版本发布说明和技术长文。'
-                    : 'Publish product updates, release notes, and long-form technical posts.');
+                    : normalized.documentLanguage === 'ja-JP'
+                        ? 'ここで製品アップデート、リリースノート、技術記事を公開します。'
+                        : normalized.documentLanguage === 'ar'
+                            ? 'انشر هنا تحديثات المنتج وملاحظات الإصدار والمقالات التقنية الطويلة.'
+                            : 'Publish product updates, release notes, and long-form technical posts.');
             case 'app/admin/page.tsx':
-                return this.renderSectionPage(normalized, normalized.documentLanguage === 'zh-CN' ? '后台控制台' : 'Admin Console', normalized.documentLanguage === 'zh-CN'
+                return this.renderSectionPage(normalized, normalized.documentLanguage === 'zh-CN'
+                    ? '后台控制台'
+                    : normalized.documentLanguage === 'ja-JP'
+                        ? '管理コンソール'
+                        : normalized.documentLanguage === 'ar'
+                            ? 'وحدة التحكم الإدارية'
+                            : 'Admin Console', normalized.documentLanguage === 'zh-CN'
                     ? '在这里承接内容工作流、发布条目和审核队列。'
-                    : 'Operate content workflows, release entries, and editorial review queues.');
+                    : normalized.documentLanguage === 'ja-JP'
+                        ? 'ここでコンテンツワークフロー、公開項目、レビュー待ちキューを扱います。'
+                        : normalized.documentLanguage === 'ar'
+                            ? 'أدر هنا سير عمل المحتوى وعناصر النشر وطوابير المراجعة التحريرية.'
+                            : 'Operate content workflows, release entries, and editorial review queues.');
             case 'app/login/page.tsx':
-                return this.renderSectionPage(normalized, normalized.documentLanguage === 'zh-CN' ? '鉴权入口' : 'Authentication', normalized.documentLanguage === 'zh-CN'
+                return this.renderSectionPage(normalized, normalized.documentLanguage === 'zh-CN'
+                    ? '鉴权入口'
+                    : normalized.documentLanguage === 'ja-JP'
+                        ? '認証入口'
+                        : normalized.documentLanguage === 'ar'
+                            ? 'بوابة المصادقة'
+                            : 'Authentication', normalized.documentLanguage === 'zh-CN'
                     ? '后续可在这里接入身份提供方、角色策略和团队登录流程。'
-                    : 'Connect your future identity provider, role policies, and staff sign-in flows here.');
+                    : normalized.documentLanguage === 'ja-JP'
+                        ? 'ここで将来の ID プロバイダー、権限ポリシー、チーム向けサインインフローを接続できます。'
+                        : normalized.documentLanguage === 'ar'
+                            ? 'اربط هنا لاحقاً مزود الهوية وسياسات الأدوار ومسارات تسجيل دخول الفريق.'
+                            : 'Connect your future identity provider, role policies, and staff sign-in flows here.');
             case 'app/account/page.tsx':
-                return this.renderSectionPage(normalized, normalized.documentLanguage === 'zh-CN' ? '账户中心' : 'Account', normalized.documentLanguage === 'zh-CN'
+                return this.renderSectionPage(normalized, normalized.documentLanguage === 'zh-CN'
+                    ? '账户中心'
+                    : normalized.documentLanguage === 'ja-JP'
+                        ? 'アカウント'
+                        : normalized.documentLanguage === 'ar'
+                            ? 'الحساب'
+                            : 'Account', normalized.documentLanguage === 'zh-CN'
                     ? '在这里管理登录用户的工作区、个人资料和团队级设置。'
-                    : 'Manage the signed-in user workspace, profile, and team-level settings.');
+                    : normalized.documentLanguage === 'ja-JP'
+                        ? 'ここでログイン済みユーザーのワークスペース、プロフィール、チーム設定を管理します。'
+                        : normalized.documentLanguage === 'ar'
+                            ? 'أدِر هنا مساحة عمل المستخدم المسجّل وملفه الشخصي وإعدادات الفريق.'
+                            : 'Manage the signed-in user workspace, profile, and team-level settings.');
             case 'app/api/health/route.ts':
                 return `export async function GET() {
   return Response.json({
@@ -460,6 +510,8 @@ export function SiteShell({ children }: { children: React.ReactNode }) {
         const normalized = value.trim().toLowerCase();
         return (!normalized ||
             normalized === '待补充' ||
+            normalized === '未定' ||
+            normalized === 'قيد التحديد' ||
             normalized === 'todo' ||
             normalized === 'tbd' ||
             normalized.includes('<') ||
@@ -468,6 +520,18 @@ export function SiteShell({ children }: { children: React.ReactNode }) {
     escapeTemplateString(value) {
         return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
     }
+    getHtmlLang(documentLanguage) {
+        if (documentLanguage === 'zh-CN') {
+            return 'zh-CN';
+        }
+        if (documentLanguage === 'ja-JP') {
+            return 'ja';
+        }
+        if (documentLanguage === 'ar') {
+            return 'ar';
+        }
+        return 'en';
+    }
     getCopy(normalized) {
         if (normalized.documentLanguage === 'zh-CN') {
             return {
@@ -485,6 +549,38 @@ export function SiteShell({ children }: { children: React.ReactNode }) {
                 navAccount: '账户',
             };
         }
+        if (normalized.documentLanguage === 'ja-JP') {
+            return {
+                heroBadge: 'OSpec スキャフォールド',
+                scaffoldBadge: 'OSpec により業務 scaffold を生成済み',
+                projectSummary: 'プロジェクト概要',
+                initialModules: '初期モジュール',
+                fillModulesHint: 'OSpec のプロジェクト文書でモジュール計画をさらに補ってください。',
+                projectLabel: 'プロジェクトページ',
+                navHome: 'ホーム',
+                navDocs: 'Docs',
+                navBlog: 'ブログ',
+                navAdmin: 'Admin',
+                navLogin: 'ログイン',
+                navAccount: 'アカウント',
+            };
+        }
+        if (normalized.documentLanguage === 'ar') {
+            return {
+                heroBadge: 'هيكل OSpec',
+                scaffoldBadge: 'تم توليد scaffold الأعمال بواسطة OSpec',
+                projectSummary: 'ملخص المشروع',
+                initialModules: 'الوحدات الأولية',
+                fillModulesHint: 'واصل تحسين تخطيط الوحدات في وثائق مشروع OSpec.',
+                projectLabel: 'صفحة المشروع',
+                navHome: 'الرئيسية',
+                navDocs: 'الوثائق',
+                navBlog: 'المدونة',
+                navAdmin: 'الإدارة',
+                navLogin: 'تسجيل الدخول',
+                navAccount: 'الحساب',
+            };
+        }
         return {
             heroBadge: 'OSpec Scaffold',
             scaffoldBadge: 'Business scaffold generated by OSpec',
@@ -504,4 +600,4 @@ export function SiteShell({ children }: { children: React.ReactNode }) {
 exports.ProjectScaffoldService = ProjectScaffoldService;
 const createProjectScaffoldService = (fileService) => new ProjectScaffoldService(fileService);
 exports.createProjectScaffoldService = createProjectScaffoldService;
-//# sourceMappingURL=ProjectScaffoldService.js.map
+//# sourceMappingURL=ProjectScaffoldService.js.map