@clawplays/ospec-cli 0.1.1

package/dist/presets/ProjectPresets.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjectPresetFirstChangeSuggestion = exports.inferProjectPresetFromDescription = exports.getLocalizedProjectPresetContent = exports.getProjectPresetById = exports.PROJECT_PRESETS = void 0;
+exports.PROJECT_PRESETS = [
+    {
+        id: 'official-site',
+        name: 'Official Site',
+        description: 'Marketing website with docs center, blog or changelog, admin content management, and auth.',
+        recommendedMode: 'full',
+        recommendedTechStack: ['Next.js', 'TypeScript', 'Tailwind CSS', 'Node.js'],
+        architecture: 'Use a web/documentation/content architecture with a dedicated admin surface and shared auth boundaries.',
+        modules: ['web', 'docs', 'content', 'admin', 'auth'],
+        apiAreas: ['content api', 'auth api', 'admin api'],
+        designDocs: ['ui information architecture', 'content model', 'cms workflow'],
+        planningDocs: ['delivery plan', 'launch checklist'],
+        keywords: ['官网', 'website', 'official site', 'docs', 'documentation', 'blog', 'changelog', 'cms'],
+        buildFirstChangeSuggestion: (language, projectName) => language === 'zh-CN'
+            ? {
+                name: 'launch-official-site-foundation',
+                background: `${projectName} 已完成初始框架搭建，下一步需要把官网首页、文档入口、内容流和后台入口串成第一版可演示链路。`,
+                goals: [
+                    '打通首页、文档中心、博客/更新日志、后台入口的主导航',
+                    '沉淀官网内容模块与后台内容流的第一版边界',
+                    '让首个 change 明确承接官网 MVP 的实现路径',
+                ],
+                inScope: ['web', 'docs', 'content', 'admin', 'auth'],
+                outOfScope: ['复杂权限模型', '正式 CMS 实现', '多语言内容系统'],
+                acceptanceCriteria: [
+                    '首页可导航到 docs、blog、admin、login',
+                    'docs/blog/admin 页面具备清晰的占位结构与模块说明',
+                    'proposal/tasks/verification 明确覆盖官网 MVP 范围',
+                ],
+                affects: ['web', 'docs', 'content', 'admin', 'auth'],
+                flags: ['multi_file_change'],
+            }
+            : {
+                name: 'launch-official-site-foundation',
+                background: `${projectName} has the initial scaffold in place. The next change should connect the homepage, docs entry, content flow, and admin entry into the first demonstrable vertical slice.`,
+                goals: [
+                    'Connect homepage navigation across home, docs, blog, admin, and login',
+                    'Define the first content and admin workflow boundaries for the official site',
+                    'Turn the first change into a concrete MVP delivery slice',
+                ],
+                inScope: ['web', 'docs', 'content', 'admin', 'auth'],
+                outOfScope: ['advanced RBAC', 'production CMS integration', 'full multilingual content system'],
+                acceptanceCriteria: [
+                    'Homepage navigation reaches docs, blog, admin, and login',
+                    'docs/blog/admin pages expose clear placeholder structures and module intent',
+                    'proposal/tasks/verification cover the official-site MVP slice',
+                ],
+                affects: ['web', 'docs', 'content', 'admin', 'auth'],
+                flags: ['multi_file_change'],
+            },
+    },
+    {
+        id: 'nextjs-web',
+        name: 'Next.js Web App',
+        description: 'General-purpose Next.js web product with web, account, and API surfaces.',
+        recommendedMode: 'standard',
+        recommendedTechStack: ['Next.js', 'TypeScript', 'Tailwind CSS', 'Node.js'],
+        architecture: 'Use a web-first architecture with shared auth/account boundaries and clear API ownership.',
+        modules: ['web', 'account', 'auth', 'api'],
+        apiAreas: ['auth api', 'user api'],
+        designDocs: ['ui information architecture', 'system architecture'],
+        planningDocs: ['delivery plan'],
+        keywords: ['next.js', 'nextjs', 'react', 'web app', 'web', 'portal'],
+        buildFirstChangeSuggestion: (language, projectName) => language === 'zh-CN'
+            ? {
+                name: 'establish-web-app-shell',
+                background: `${projectName} 已初始化基础 Web App 骨架，下一步需要把首页、账户、登录与基础 API 入口连成第一版产品骨架。`,
+                goals: [
+                    '打通首页、账户页与登录页的基础导航',
+                    '明确 auth api / user api 的第一版职责边界',
+                    '让首个 change 形成可持续迭代的产品外壳',
+                ],
+                inScope: ['web', 'account', 'auth', 'api'],
+                outOfScope: ['支付流程', '复杂后台模块', '完整通知系统'],
+                acceptanceCriteria: [
+                    '首页、账户页、登录页导航可达',
+                    'auth api 与 user api 文档已能支撑首轮实现',
+                    '首个 change 文档明确产品骨架的交付范围',
+                ],
+                affects: ['web', 'account', 'auth', 'api'],
+                flags: ['multi_file_change'],
+            }
+            : {
+                name: 'establish-web-app-shell',
+                background: `${projectName} now has the base web-app scaffold. The next change should connect the homepage, account surface, login flow, and base API surface into the first product shell.`,
+                goals: [
+                    'Connect navigation across home, account, and login',
+                    'Define the first auth api and user api ownership boundaries',
+                    'Turn the first change into a maintainable product shell milestone',
+                ],
+                inScope: ['web', 'account', 'auth', 'api'],
+                outOfScope: ['payments', 'complex admin modules', 'full notification systems'],
+                acceptanceCriteria: [
+                    'Home, account, and login surfaces are navigable',
+                    'auth api and user api docs are sufficient for the first implementation slice',
+                    'The first change documents clearly scope the initial product shell',
+                ],
+                affects: ['web', 'account', 'auth', 'api'],
+                flags: ['multi_file_change'],
+            },
+    },
+];
+const getProjectPresetById = (presetId) => exports.PROJECT_PRESETS.find(preset => preset.id === presetId);
+exports.getProjectPresetById = getProjectPresetById;
+const getLocalizedProjectPresetContent = (presetId, language) => {
+    if (!presetId) {
+        return null;
+    }
+    if (presetId === 'official-site') {
+        return language === 'zh-CN'
+            ? {
+                name: '官网站点',
+                description: '用于官网展示、文档中心、博客/更新日志、后台内容管理与鉴权的一体化官网项目。',
+                architecture: '采用 web / docs / content 分层，并提供独立 admin 面与共享 auth 边界。',
+                designDocs: ['界面信息架构', '内容模型', 'CMS 工作流'],
+                planningDocs: ['交付计划', '上线检查清单'],
+            }
+            : {
+                name: 'Official Site',
+                description: 'Marketing website with docs center, blog or changelog, admin content management, and auth.',
+                architecture: 'Use a web/documentation/content architecture with a dedicated admin surface and shared auth boundaries.',
+                designDocs: ['ui information architecture', 'content model', 'cms workflow'],
+                planningDocs: ['delivery plan', 'launch checklist'],
+            };
+    }
+    if (presetId === 'nextjs-web') {
+        return language === 'zh-CN'
+            ? {
+                name: 'Next.js Web 应用',
+                description: '适用于标准 Web 产品的 Next.js 项目骨架，内置 web、account、auth 与 API 边界。',
+                architecture: '采用以 web 为中心的架构，并保持 account / auth / api 的清晰职责边界。',
+                designDocs: ['界面信息架构', '系统架构'],
+                planningDocs: ['交付计划'],
+            }
+            : {
+                name: 'Next.js Web App',
+                description: 'General-purpose Next.js web product with web, account, and API surfaces.',
+                architecture: 'Use a web-first architecture with shared auth/account boundaries and clear API ownership.',
+                designDocs: ['ui information architecture', 'system architecture'],
+                planningDocs: ['delivery plan'],
+            };
+    }
+    return null;
+};
+exports.getLocalizedProjectPresetContent = getLocalizedProjectPresetContent;
+const inferProjectPresetFromDescription = (description) => {
+    const normalized = description.toLowerCase();
+    const scores = exports.PROJECT_PRESETS.map(preset => {
+        const matchedKeywords = preset.keywords.filter(keyword => normalized.includes(keyword.toLowerCase()));
+        const weightedScore = matchedKeywords.reduce((score, keyword) => {
+            const normalizedKeyword = keyword.toLowerCase();
+            if (['官网', 'official site', 'website', 'docs', 'documentation', 'blog', 'changelog', 'cms'].includes(normalizedKeyword)) {
+                return score + 3;
+            }
+            if (['next.js', 'nextjs', 'react', 'web app', 'portal'].includes(normalizedKeyword)) {
+                return score + 2;
+            }
+            return score + 1;
+        }, 0);
+        return {
+            preset,
+            weightedScore,
+            matchedKeywordCount: matchedKeywords.length,
+        };
+    })
+        .filter(item => item.matchedKeywordCount > 0)
+        .sort((left, right) => {
+        if (right.weightedScore !== left.weightedScore) {
+            return right.weightedScore - left.weightedScore;
+        }
+        if (right.matchedKeywordCount !== left.matchedKeywordCount) {
+            return right.matchedKeywordCount - left.matchedKeywordCount;
+        }
+        return 0;
+    });
+    return scores[0]?.preset;
+};
+exports.inferProjectPresetFromDescription = inferProjectPresetFromDescription;
+const getProjectPresetFirstChangeSuggestion = (presetId, language, projectName) => {
+    const preset = (0, exports.getProjectPresetById)(presetId);
+    if (!preset) {
+        return null;
+    }
+    return preset.buildFirstChangeSuggestion(language, projectName);
+};
+exports.getProjectPresetFirstChangeSuggestion = getProjectPresetFirstChangeSuggestion;
+//# sourceMappingURL=ProjectPresets.js.map

package/dist/scaffolds/ProjectScaffoldPresets.d.ts

@@ -0,0 +1,20 @@
+import { ProjectPresetDocumentLanguage, ProjectPresetId } from '../presets/ProjectPresets';
+export interface ProjectScaffoldFileDefinition {
+    path: string;
+    category: 'config' | 'app' | 'library' | 'static';
+    purpose: string;
+}
+export interface ProjectScaffoldDefinition {
+    presetId: ProjectPresetId;
+    title: string;
+    description: string;
+    framework: string;
+    installCommand: string;
+    directories: string[];
+    files: ProjectScaffoldFileDefinition[];
+}
+export declare const PROJECT_SCAFFOLD_PRESETS: ProjectScaffoldDefinition[];
+export declare const getProjectScaffoldPreset: (presetId?: ProjectPresetId | null) => ProjectScaffoldDefinition | undefined;
+export declare const getLocalizedProjectScaffoldMeta: (presetId: ProjectPresetId, language: ProjectPresetDocumentLanguage) => Pick<ProjectScaffoldDefinition, "title" | "description" | "framework" | "installCommand">;
+export declare const getLocalizedProjectScaffoldPurpose: (filePath: string, language: ProjectPresetDocumentLanguage) => string;
+//# sourceMappingURL=ProjectScaffoldPresets.d.ts.map

package/dist/scaffolds/ProjectScaffoldPresets.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLocalizedProjectScaffoldPurpose = exports.getLocalizedProjectScaffoldMeta = exports.getProjectScaffoldPreset = exports.PROJECT_SCAFFOLD_PRESETS = void 0;
+exports.PROJECT_SCAFFOLD_PRESETS = [
+    {
+        presetId: 'official-site',
+        title: 'Official Site Scaffold',
+        description: 'Bootstrap a Next.js App Router website with docs, blog, admin, auth, and shared content services.',
+        framework: 'Next.js + TypeScript + Tailwind CSS',
+        installCommand: 'npm install && npm run dev',
+        directories: [
+            'app',
+            'app/api',
+            'app/api/health',
+            'app/admin',
+            'app/blog',
+            'app/docs',
+            'app/login',
+            'public',
+            'src',
+            'src/components',
+            'src/lib',
+            'src/lib/auth',
+            'src/lib/content',
+        ],
+        files: [
+            { path: '.gitignore', category: 'config', purpose: 'Ignore Next.js build and dependency outputs.' },
+            { path: 'package.json', category: 'config', purpose: 'Define Next.js runtime and development dependencies.' },
+            { path: 'tsconfig.json', category: 'config', purpose: 'Provide TypeScript compiler settings for the app.' },
+            { path: 'next-env.d.ts', category: 'config', purpose: 'Expose Next.js ambient types.' },
+            { path: 'next.config.mjs', category: 'config', purpose: 'Enable strict Next.js runtime defaults.' },
+            { path: 'postcss.config.js', category: 'config', purpose: 'Wire Tailwind CSS into PostCSS.' },
+            { path: 'tailwind.config.ts', category: 'config', purpose: 'Scan app and src files for Tailwind classes.' },
+            { path: 'app/globals.css', category: 'app', purpose: 'Define shared visual tokens and page-level styling.' },
+            { path: 'app/layout.tsx', category: 'app', purpose: 'Provide the global shell and metadata.' },
+            { path: 'app/page.tsx', category: 'app', purpose: 'Render the marketing homepage.' },
+            { path: 'app/docs/page.tsx', category: 'app', purpose: 'Render the docs landing page.' },
+            { path: 'app/blog/page.tsx', category: 'app', purpose: 'Render the changelog and blog surface.' },
+            { path: 'app/admin/page.tsx', category: 'app', purpose: 'Render the CMS/admin entry surface.' },
+            { path: 'app/login/page.tsx', category: 'app', purpose: 'Render the auth/login entry surface.' },
+            { path: 'app/api/health/route.ts', category: 'app', purpose: 'Expose a basic health endpoint.' },
+            { path: 'src/components/site-shell.tsx', category: 'library', purpose: 'Provide the shared navigation shell.' },
+            { path: 'src/components/home-hero.tsx', category: 'library', purpose: 'Render the homepage hero section.' },
+            { path: 'src/lib/content/navigation.ts', category: 'library', purpose: 'Define shared navigation and content entry points.' },
+            { path: 'src/lib/auth/session.ts', category: 'library', purpose: 'Stub the auth session boundary for future implementation.' },
+        ],
+    },
+    {
+        presetId: 'nextjs-web',
+        title: 'Next.js Web App Scaffold',
+        description: 'Bootstrap a standard Next.js application with account, auth, and API surfaces.',
+        framework: 'Next.js + TypeScript + Tailwind CSS',
+        installCommand: 'npm install && npm run dev',
+        directories: [
+            'app',
+            'app/account',
+            'app/api',
+            'app/api/health',
+            'app/login',
+            'public',
+            'src',
+            'src/components',
+            'src/lib',
+            'src/lib/auth',
+            'src/lib/navigation',
+        ],
+        files: [
+            { path: '.gitignore', category: 'config', purpose: 'Ignore Next.js build and dependency outputs.' },
+            { path: 'package.json', category: 'config', purpose: 'Define Next.js runtime and development dependencies.' },
+            { path: 'tsconfig.json', category: 'config', purpose: 'Provide TypeScript compiler settings for the app.' },
+            { path: 'next-env.d.ts', category: 'config', purpose: 'Expose Next.js ambient types.' },
+            { path: 'next.config.mjs', category: 'config', purpose: 'Enable strict Next.js runtime defaults.' },
+            { path: 'postcss.config.js', category: 'config', purpose: 'Wire Tailwind CSS into PostCSS.' },
+            { path: 'tailwind.config.ts', category: 'config', purpose: 'Scan app and src files for Tailwind classes.' },
+            { path: 'app/globals.css', category: 'app', purpose: 'Define shared visual tokens and page-level styling.' },
+            { path: 'app/layout.tsx', category: 'app', purpose: 'Provide the global shell and metadata.' },
+            { path: 'app/page.tsx', category: 'app', purpose: 'Render the primary product homepage.' },
+            { path: 'app/account/page.tsx', category: 'app', purpose: 'Render the account surface.' },
+            { path: 'app/login/page.tsx', category: 'app', purpose: 'Render the auth/login entry surface.' },
+            { path: 'app/api/health/route.ts', category: 'app', purpose: 'Expose a basic health endpoint.' },
+            { path: 'src/components/site-shell.tsx', category: 'library', purpose: 'Provide the shared navigation shell.' },
+            { path: 'src/lib/navigation/primary-nav.ts', category: 'library', purpose: 'Define app navigation entry points.' },
+            { path: 'src/lib/auth/session.ts', category: 'library', purpose: 'Stub the auth session boundary for future implementation.' },
+        ],
+    },
+];
+const getProjectScaffoldPreset = (presetId) => exports.PROJECT_SCAFFOLD_PRESETS.find(preset => preset.presetId === presetId);
+exports.getProjectScaffoldPreset = getProjectScaffoldPreset;
+const getLocalizedProjectScaffoldMeta = (presetId, language) => {
+    if (presetId === 'official-site') {
+        return language === 'zh-CN'
+            ? {
+                title: '官网站点脚手架',
+                description: '初始化一个包含 docs、blog、admin、auth 与共享内容服务的 Next.js App Router 官网骨架。',
+                framework: 'Next.js + TypeScript + Tailwind CSS',
+                installCommand: 'npm install && npm run dev',
+            }
+            : {
+                title: 'Official Site Scaffold',
+                description: 'Bootstrap a Next.js App Router website with docs, blog, admin, auth, and shared content services.',
+                framework: 'Next.js + TypeScript + Tailwind CSS',
+                installCommand: 'npm install && npm run dev',
+            };
+    }
+    return language === 'zh-CN'
+        ? {
+            title: 'Next.js Web 应用脚手架',
+            description: '初始化一个包含 account、auth 与 API 边界的标准 Next.js Web 应用骨架。',
+            framework: 'Next.js + TypeScript + Tailwind CSS',
+            installCommand: 'npm install && npm run dev',
+        }
+        : {
+            title: 'Next.js Web App Scaffold',
+            description: 'Bootstrap a standard Next.js application with account, auth, and API surfaces.',
+            framework: 'Next.js + TypeScript + Tailwind CSS',
+            installCommand: 'npm install && npm run dev',
+        };
+};
+exports.getLocalizedProjectScaffoldMeta = getLocalizedProjectScaffoldMeta;
+const getLocalizedProjectScaffoldPurpose = (filePath, language) => {
+    if (language !== 'zh-CN') {
+        const matchedPreset = exports.PROJECT_SCAFFOLD_PRESETS.find(preset => preset.files.some(file => file.path === filePath));
+        return matchedPreset?.files.find(file => file.path === filePath)?.purpose || '';
+    }
+    const zhPurposes = {
+        '.gitignore': '忽略 Next.js 构建产物与依赖目录。',
+        'package.json': '定义 Next.js 运行时与开发依赖。',
+        'tsconfig.json': '提供应用的 TypeScript 编译配置。',
+        'next-env.d.ts': '暴露 Next.js 环境类型定义。',
+        'next.config.mjs': '启用默认的 Next.js 严格运行配置。',
+        'postcss.config.js': '把 Tailwind CSS 接入 PostCSS。',
+        'tailwind.config.ts': '扫描 app 与 src 中的 Tailwind 类名。',
+        'app/globals.css': '定义共享视觉变量与页面级样式。',
+        'app/layout.tsx': '提供全局页面壳与元数据。',
+        'app/page.tsx': '渲染首页或主站入口页面。',
+        'app/docs/page.tsx': '渲染文档中心入口页面。',
+        'app/blog/page.tsx': '渲染博客与更新日志入口页面。',
+        'app/admin/page.tsx': '渲染 CMS 与后台入口页面。',
+        'app/login/page.tsx': '渲染登录与鉴权入口页面。',
+        'app/account/page.tsx': '渲染账户中心入口页面。',
+        'app/api/health/route.ts': '提供基础健康检查接口。',
+        'src/components/site-shell.tsx': '提供共享的站点导航壳。',
+        'src/components/home-hero.tsx': '渲染首页英雄区块。',
+        'src/lib/content/navigation.ts': '定义共享导航与内容入口。',
+        'src/lib/navigation/primary-nav.ts': '定义应用导航入口。',
+        'src/lib/auth/session.ts': '预留后续鉴权会话边界实现。',
+    };
+    return zhPurposes[filePath] || '';
+};
+exports.getLocalizedProjectScaffoldPurpose = getLocalizedProjectScaffoldPurpose;
+//# sourceMappingURL=ProjectScaffoldPresets.js.map

package/dist/services/ConfigManager.d.ts

@@ -0,0 +1,14 @@
+import { ProjectMode, SkillrcConfig } from '../core/types';
+import { FileService } from './FileService';
+export declare class ConfigManager {
+    private fileService;
+    constructor(fileService: FileService);
+    loadConfig(rootDir: string): Promise<SkillrcConfig>;
+    saveConfig(rootDir: string, config: SkillrcConfig): Promise<void>;
+    getMode(rootDir: string): Promise<ProjectMode>;
+    isInitialized(rootDir: string): Promise<boolean>;
+    createDefaultConfig(mode?: ProjectMode): Promise<SkillrcConfig>;
+    private normalizeConfig;
+}
+export declare function createConfigManager(fileService: FileService): ConfigManager;
+//# sourceMappingURL=ConfigManager.d.ts.map