@clawplays/ospec-cli 0.1.1 → 0.3.0

package/dist/services/ProjectService.js

@@ -2463,7 +2463,23 @@ class ProjectService {
 
 
 
-        const execution = await this.getExecutionStatus(rootDir);
+        let activeChangeCount = 0;
+        if (structure.initialized) {
+            const execution = await this.getExecutionStatus(rootDir);
+            activeChangeCount = execution.totalActiveChanges;
+        }
+        else {
+            const activeDir = path_1.default.join(rootDir, constants_1.DIR_NAMES.CHANGES, constants_1.DIR_NAMES.ACTIVE);
+            if (await this.fileService.exists(activeDir)) {
+                try {
+                    const entries = await fs_extra_1.default.readdir(activeDir, { withFileTypes: true });
+                    activeChangeCount = entries.filter(entry => entry.isDirectory()).length;
+                }
+                catch {
+                    activeChangeCount = 0;
+                }
+            }
+        }
 
 
 
@@ -2527,7 +2543,7 @@ class ProjectService {
 
 
 
-            activeChangeCount: execution.totalActiveChanges,
+            activeChangeCount,
 
 
 
@@ -5114,413 +5130,211 @@ class ProjectService {
 
 
     async getBootstrapUpgradePlan(rootDir) {
-
-
-
-
-
-
-
         const docsRoot = path_1.default.join(rootDir, constants_1.DIR_NAMES.DOCS, constants_1.DIR_NAMES.PROJECT);
-
-
-
-
-
-
-
         const readMarkdown = async (filePath) => {
-
-
-
-
-
-
-
             if (!(await this.fileService.exists(filePath))) {
-
-
-
-
-
-
-
                 return '';
-
-
-
-
-
-
-
             }
-
-
-
-
-
-
-
             try {
-
-
-
-
-
-
-
                 const parsed = (0, gray_matter_1.default)(await this.fileService.readFile(filePath));
-
-
-
-
-
-
-
                 return parsed.content.trim();
-
-
-
-
-
-
-
             }
-
-
-
-
-
-
-
             catch {
-
-
-
-
-
-
-
                 return '';
-
-
-
-
-
-
-
             }
-
-
-
-
-
-
-
         };
-
-
-
-
-
-
-
         const extractBulletList = (content) => content
-
-
-
-
-
-
-
             .split(/\r?\n/)
-
-
-
-
-
-
-
             .map(line => line.trim())
-
-
-
-
-
-
-
             .filter(line => /^-\s+/.test(line))
-
-
-
-
-
-
-
             .map(line => line.replace(/^-\s+/, '').trim())
-
-
-
-
-
-
-
             .filter(Boolean);
-
-
-
-
-
-
-
         const extractParagraph = (content) => content
-
-
-
-
-
-
-
             .split(/\r?\n\r?\n/)
-
-
-
-
-
-
-
             .map(block => block.trim())
-
-
-
-
-
-
-
             .find(block => block && !block.startsWith('#') && !block.startsWith('- '))
-
-
-
-
-
-
-
             ?.replace(/\r?\n/g, ' ')
-
-
-
-
-
-
-
             .trim() || '';
-
-
-
-
-
-
-
-        const [overviewContent, techStackContent, architectureContent] = await Promise.all([
-
-
-
-
-
-
-
+        const [overviewContent, techStackContent, architectureContent, readmeContent, localizedReadmeContent, inferredSummary, inferredTechStack] = await Promise.all([
             readMarkdown(path_1.default.join(docsRoot, 'overview.md')),
-
-
-
-
-
-
-
             readMarkdown(path_1.default.join(docsRoot, 'tech-stack.md')),
-
-
-
-
-
-
-
             readMarkdown(path_1.default.join(docsRoot, 'architecture.md')),
-
-
-
-
-
-
-
+            readMarkdown(path_1.default.join(rootDir, constants_1.FILE_NAMES.README)),
+            readMarkdown(path_1.default.join(rootDir, 'README.zh-CN.md')),
+            this.inferBootstrapSummary(rootDir),
+            this.inferBootstrapTechStack(rootDir),
+        ]);
+        const summary = extractParagraph(overviewContent) ||
+            extractParagraph(readmeContent) ||
+            extractParagraph(localizedReadmeContent) ||
+            inferredSummary;
+        const explicitTechStack = extractBulletList(techStackContent);
+        const documentLanguage = this.detectDocumentLanguageFromTexts([
+            overviewContent,
+            techStackContent,
+            architectureContent,
+            readmeContent,
+            localizedReadmeContent,
         ]);
-
-
-
-
-
-
-
         const modules = await this.inferBootstrapModules(rootDir);
-
-
-
-
-
-
-
         const apiDocs = await this.scanApiDocs(rootDir);
-
-
-
-
-
-
-
         const designDocs = await this.scanDesignDocs(rootDir);
-
-
-
-
-
-
-
         const planningDocs = await this.scanPlanningDocs(rootDir);
-
-
-
-
-
-
-
         return {
-
-
-
-
-
-
-
             projectName: path_1.default.basename(path_1.default.resolve(rootDir)),
-
-
-
-
-
-
-
-            summary: extractParagraph(overviewContent),
-
-
-
-
-
-
-
-            techStack: extractBulletList(techStackContent),
-
-
-
-
-
-
-
+            summary,
+            techStack: explicitTechStack.length > 0 ? explicitTechStack : inferredTechStack,
             architecture: extractParagraph(architectureContent),
-
-
-
-
-
-
-
             modules,
-
-
-
-
-
-
-
             apiAreas: apiDocs
-
-
-
-
-
-
-
                 .filter(item => item.name.toLowerCase() !== 'readme.md')
-
-
-
-
-
-
-
                 .map(item => item.name.replace(/\.md$/i, '').replace(/-/g, ' ')),
-
-
-
-
-
-
-
             designDocs: designDocs
-
-
-
-
-
-
-
                 .filter(item => item.name.toLowerCase() !== 'readme.md')
-
-
-
-
-
-
-
                 .map(item => item.name.replace(/\.md$/i, '').replace(/-/g, ' ')),
-
-
-
-
-
-
-
             planningDocs: planningDocs
-
-
-
-
-
-
-
                 .filter(item => item.name.toLowerCase() !== 'readme.md')
-
-
-
-
-
-
-
                 .map(item => item.name.replace(/\.md$/i, '').replace(/-/g, ' ')),
-
-
-
-
-
-
-
+            documentLanguage,
         };
+    }
 
+    async inferBootstrapSummary(rootDir) {
+        const packageJsonPath = path_1.default.join(rootDir, 'package.json');
+        if (await this.fileService.exists(packageJsonPath)) {
+            try {
+                const packageJson = await this.fileService.readJSON(packageJsonPath);
+                if (typeof packageJson?.description === 'string' && packageJson.description.trim().length > 0) {
+                    return packageJson.description.trim();
+                }
+            }
+            catch {
+            }
+        }
+        const pyprojectPath = path_1.default.join(rootDir, 'pyproject.toml');
+        if (await this.fileService.exists(pyprojectPath)) {
+            try {
+                const content = await this.fileService.readFile(pyprojectPath);
+                const match = content.match(/^\s*description\s*=\s*["'](.+?)["']\s*$/m);
+                if (match?.[1]?.trim()) {
+                    return match[1].trim();
+                }
+            }
+            catch {
+            }
+        }
+        return '';
+    }
 
+    async inferBootstrapTechStack(rootDir) {
+        const stack = new Set();
+        const add = (...items) => {
+            for (const item of items) {
+                if (typeof item === 'string' && item.trim().length > 0) {
+                    stack.add(item.trim());
+                }
+            }
+        };
+        const packageJsonPath = path_1.default.join(rootDir, 'package.json');
+        if (await this.fileService.exists(packageJsonPath)) {
+            add('Node.js');
+            try {
+                const packageJson = await this.fileService.readJSON(packageJsonPath);
+                const deps = {
+                    ...(packageJson?.dependencies || {}),
+                    ...(packageJson?.devDependencies || {}),
+                    ...(packageJson?.peerDependencies || {}),
+                };
+                const depNames = Object.keys(deps);
+                if (depNames.some(name => name === 'typescript' || name.startsWith('@types/'))) {
+                    add('TypeScript');
+                }
+                if (depNames.includes('react')) {
+                    add('React');
+                }
+                if (depNames.includes('next')) {
+                    add('Next.js');
+                }
+                if (depNames.includes('vue')) {
+                    add('Vue');
+                }
+                if (depNames.includes('nuxt') || depNames.includes('nuxt3')) {
+                    add('Nuxt');
+                }
+                if (depNames.includes('svelte')) {
+                    add('Svelte');
+                }
+                if (depNames.includes('astro')) {
+                    add('Astro');
+                }
+                if (depNames.includes('express')) {
+                    add('Express');
+                }
+                if (depNames.includes('@nestjs/core')) {
+                    add('NestJS');
+                }
+                if (depNames.includes('fastify')) {
+                    add('Fastify');
+                }
+                if (depNames.includes('electron')) {
+                    add('Electron');
+                }
+                if (depNames.includes('vite')) {
+                    add('Vite');
+                }
+            }
+            catch {
+            }
+        }
+        if (await this.fileService.exists(path_1.default.join(rootDir, 'tsconfig.json'))) {
+            add('TypeScript');
+        }
+        if (await this.fileService.exists(path_1.default.join(rootDir, 'requirements.txt')) ||
+            await this.fileService.exists(path_1.default.join(rootDir, 'pyproject.toml'))) {
+            add('Python');
+        }
+        if (await this.fileService.exists(path_1.default.join(rootDir, 'manage.py'))) {
+            add('Django');
+        }
+        if (await this.fileService.exists(path_1.default.join(rootDir, 'go.mod'))) {
+            add('Go');
+        }
+        if (await this.fileService.exists(path_1.default.join(rootDir, 'Cargo.toml'))) {
+            add('Rust');
+        }
+        if (await this.fileService.exists(path_1.default.join(rootDir, 'composer.json'))) {
+            add('PHP');
+        }
+        if (await this.fileService.exists(path_1.default.join(rootDir, 'Gemfile'))) {
+            add('Ruby');
+        }
+        if (await this.fileService.exists(path_1.default.join(rootDir, 'pom.xml')) ||
+            await this.fileService.exists(path_1.default.join(rootDir, 'build.gradle')) ||
+            await this.fileService.exists(path_1.default.join(rootDir, 'build.gradle.kts'))) {
+            add('Java');
+        }
+        if (await this.fileService.exists(path_1.default.join(rootDir, 'pubspec.yaml'))) {
+            add('Dart');
+        }
+        if (await this.fileService.exists(path_1.default.join(rootDir, 'Dockerfile'))) {
+            add('Docker');
+        }
+        return Array.from(stack);
+    }
 
-
-
-
-
+    detectDocumentLanguageFromTexts(contents) {
+        for (const content of contents) {
+            if (typeof content !== 'string' || content.trim().length === 0) {
+                continue;
+            }
+            if (/[一-龥]/.test(content)) {
+                return 'zh-CN';
+            }
+            if (/[A-Za-z]/.test(content)) {
+                return 'en-US';
+            }
+        }
+        return undefined;
     }
 
 

package/dist/services/templates/ProjectTemplateBuilder.js

@@ -142,7 +142,6 @@ ${context.architecture}
 ## Navigation
 
 - Project overview: [project/overview.md](project/overview.md)
-- Bootstrap summary: [project/bootstrap-summary.md](project/bootstrap-summary.md)
 - Tech stack: [project/tech-stack.md](project/tech-stack.md)
 - Architecture: [project/architecture.md](project/architecture.md)
 - Module map: [project/module-map.md](project/module-map.md)
@@ -157,7 +156,6 @@ ${context.architecture}
 ## 文档导航
 
 - 项目概览：[project/overview.md](project/overview.md)
-- 初始化摘要：[project/bootstrap-summary.md](project/bootstrap-summary.md)
 - 技术栈：[project/tech-stack.md](project/tech-stack.md)
 - 架构说明：[project/architecture.md](project/architecture.md)
 - 模块地图：[project/module-map.md](project/module-map.md)
@@ -283,8 +281,7 @@ ${context.summary}
 
 ## Current Goals
 
-- Complete the project knowledge layer
-- Use [bootstrap-summary.md](bootstrap-summary.md) as the recorded bootstrap output
+- Keep the project knowledge docs aligned with the real repository state
 - Establish layered skill files
 - Manage delivery through the change workflow`
             : `# 项目概览
@@ -299,8 +296,7 @@ ${context.summary}
 
 ## 当前目标
 
-- 补齐项目知识层
-- 以 [bootstrap-summary.md](bootstrap-summary.md) 记录初始化结果与脚手架输出
+- 保持项目知识文档与仓库真实状态一致
 - 建立分层 SKILL 体系
 - 使用 change workflow 管理需求交付`;
         return this.withFrontmatter({
@@ -1008,11 +1004,9 @@ scan(rootDir)
         const docsLink = this.formatReferenceList(refs, this.copy(context.documentLanguage, '待补充', 'TBD'));
         const relatedDocs = this.isEnglish(context.documentLanguage)
             ? `- Module map: [../../../docs/project/module-map.md](../../../docs/project/module-map.md)
-- API overview: [../../../docs/project/api-overview.md](../../../docs/project/api-overview.md)
-- Bootstrap summary: [../../../docs/project/bootstrap-summary.md](../../../docs/project/bootstrap-summary.md)`
+- API overview: [../../../docs/project/api-overview.md](../../../docs/project/api-overview.md)`
             : `- 项目模块地图：[../../../docs/project/module-map.md](../../../docs/project/module-map.md)
-- API 总览：[../../../docs/project/api-overview.md](../../../docs/project/api-overview.md)
-- 初始化摘要：[../../../docs/project/bootstrap-summary.md](../../../docs/project/bootstrap-summary.md)`;
+- API 总览：[../../../docs/project/api-overview.md](../../../docs/project/api-overview.md)`;
         const templates = {
             web: {
                 zh: `# ${moduleName} 模块

package/dist/services/templates/TemplateInputFactory.js

@@ -89,20 +89,28 @@ class TemplateInputFactory {
         const presetPlanningDocs = (presetDefaults?.planningDocs ?? []).map(item => item.trim()).filter(Boolean);
         const presetSummary = presetDefaults?.summary?.trim();
         const presetArchitecture = presetDefaults?.architecture?.trim();
+        const documentLanguage = this.normalizeDocumentLanguage(input?.documentLanguage);
+        const placeholderText = documentLanguage === 'en-US' ? 'TBD' : '待补充';
+        const defaultSummary = documentLanguage === 'en-US'
+            ? `${fallbackName} has been initialized with OSpec and is ready for change-based delivery. Fill in the missing project context as the repository becomes clearer.`
+            : `${fallbackName} 已通过 OSpec 初始化，当前已具备按 change 推进交付的基础条件。请继续补充缺失的项目上下文。`;
+        const defaultArchitecture = documentLanguage === 'en-US'
+            ? 'OSpec initialized the protocol shell and baseline project knowledge docs. Refine the architecture details as the repository direction becomes clearer.'
+            : 'OSpec 已初始化协议壳和基础项目知识文档，后续可结合仓库实际方向继续细化架构。';
         const projectName = normalizedInputProjectName || fallbackName;
         const summary = normalizedInputSummary ||
             presetSummary ||
-            `${fallbackName} 已通过 OSpec 初始化，当前处于项目知识层搭建阶段。`;
+            defaultSummary;
         const techStack = normalizedInputTechStack.length > 0
             ? Array.from(new Set(normalizedInputTechStack))
             : inferredTechStack.length > 0
                 ? Array.from(new Set(inferredTechStack))
                 : presetTechStack.length > 0
                     ? Array.from(new Set(presetTechStack))
-                    : ['待补充'];
+                    : [placeholderText];
         const architecture = normalizedInputArchitecture ||
             presetArchitecture ||
-            '当前先建立项目知识层、分层技能层和执行层骨架，后续继续细化架构。';
+            defaultArchitecture;
         const modules = normalizedInputModules.length > 0
             ? Array.from(new Set(normalizedInputModules))
             : inferredModules.length > 0
@@ -116,22 +124,21 @@ class TemplateInputFactory {
                 ? Array.from(new Set(inferredApiAreas))
                 : presetApiAreas.length > 0
                     ? Array.from(new Set(presetApiAreas))
-                    : ['待补充'];
+                    : [placeholderText];
         const designDocs = normalizedInputDesignDocs.length > 0
             ? Array.from(new Set(normalizedInputDesignDocs))
             : inferredDesignDocs.length > 0
                 ? Array.from(new Set(inferredDesignDocs))
                 : presetDesignDocs.length > 0
                     ? Array.from(new Set(presetDesignDocs))
-                    : ['待补充'];
+                    : [placeholderText];
         const planningDocs = normalizedInputPlanningDocs.length > 0
             ? Array.from(new Set(normalizedInputPlanningDocs))
             : inferredPlanningDocs.length > 0
                 ? Array.from(new Set(inferredPlanningDocs))
                 : presetPlanningDocs.length > 0
                     ? Array.from(new Set(presetPlanningDocs))
-                    : ['待补充'];
-        const documentLanguage = this.normalizeDocumentLanguage(input?.documentLanguage);
+                    : [placeholderText];
         const executeScaffoldCommands = Boolean(input?.executeScaffoldCommands);
         const fieldSources = {
             projectName: normalizedInputProjectName ? 'user' : 'placeholder',