@epoint-testtech/stage-create 0.0.3-alpha.1 → 0.0.4-alpha.0

package/dist/index.js

@@ -5,7 +5,7 @@ import { fileURLToPath } from 'url';
 import { program } from 'commander';
 import prompts from 'prompts';
 import { copyTemplateDir } from './render-template.js';
-import { writeGlueProjectContext, validateRequiredContextInput } from './stage-context.js';
+import { writeGlueProjectContext } from './stage-context.js';
 const currentFilePath = fileURLToPath(import.meta.url);
 const TEMPLATES_DIR = path.resolve(path.dirname(currentFilePath), '..', 'templates');
 const DEFAULT_STAGE_CORE_DEPENDENCY = '^0.0.3-alpha.1';
@@ -28,14 +28,14 @@ program
             name: 'mode',
             message: '选择模式',
             choices: [
-                { title: '默认 — 基础 playwright.config.ts 配置', value: 'default' },
                 { title: '胶水模式 — 完整骨架（CrudPage + LoginPage + MenuPage 示例）', value: 'glue' },
+                { title: '默认 — 基础 playwright.config.ts 配置', value: 'default' },
             ],
             initial: 0,
         },
     ]);
     const rawName = projectName ?? answers.projectName;
-    const mode = options?.mode ?? answers.mode ?? 'default';
+    const mode = options?.mode ?? answers.mode ?? 'glue';
     if (!rawName) {
         console.error('项目名称不能为空');
         process.exit(1);
@@ -50,17 +50,6 @@ program
         console.error(`目录已存在: ${outputDir}`);
         process.exit(1);
     }
-    const glueContextAnswers = mode === 'glue'
-        ? await readGlueContextAnswers()
-        : {};
-    // glue 模式必填项校验必须早于 mkdirSync，避免缺失输入时留下空项目骨架。
-    if (mode === 'glue') {
-        validateRequiredContextInput({
-            loginSystemUrl: glueContextAnswers.loginSystemUrl ?? '',
-            loginUsername: glueContextAnswers.loginUsername ?? '',
-            loginPassword: glueContextAnswers.loginPassword ?? '',
-        });
-    }
     console.log('生成中...');
     fs.mkdirSync(outputDir, { recursive: true });
     copyTemplateDir(templateDir, outputDir, {
@@ -72,10 +61,6 @@ program
         writeGlueProjectContext({
             projectName: name,
             projectDir: outputDir,
-            loginSystemUrl: glueContextAnswers.loginSystemUrl ?? '',
-            loginUsername: glueContextAnswers.loginUsername ?? '',
-            loginPassword: glueContextAnswers.loginPassword ?? '',
-            knowledgeRoot: glueContextAnswers.knowledgeRoot,
         });
     }
     console.log(`\n完成！执行以下命令开始：`);
@@ -87,43 +72,3 @@ program
     console.log(`  pnpm test`);
 });
 program.parse();
-/**
- * 读取 glue 模式项目上下文输入。
- *
- * @returns 登录配置和可选知识库路径。
- */
-async function readGlueContextAnswers() {
-    if (!process.stdin.isTTY) {
-        const [loginSystemUrl, loginUsername, loginPassword, knowledgeRoot] = fs
-            .readFileSync(0, 'utf8')
-            .split(/\r?\n/);
-        return {
-            loginSystemUrl,
-            loginUsername,
-            loginPassword,
-            knowledgeRoot,
-        };
-    }
-    return prompts([
-        {
-            type: 'text',
-            name: 'loginSystemUrl',
-            message: '登录页面地址',
-        },
-        {
-            type: 'text',
-            name: 'loginUsername',
-            message: '登录用户名',
-        },
-        {
-            type: 'password',
-            name: 'loginPassword',
-            message: '登录密码',
-        },
-        {
-            type: 'text',
-            name: 'knowledgeRoot',
-            message: '知识库路径（可选）',
-        },
-    ]);
-}

package/dist/stage-context.d.ts

@@ -1,27 +1,19 @@
 export type WriteGlueProjectContextInput = {
     projectName: string;
     projectDir: string;
-    loginSystemUrl: string;
-    loginUsername: string;
-    loginPassword: string;
-    knowledgeRoot?: string;
+    stageCreateVersion?: string;
     homeDir?: string;
 };
 /**
- * 写入 glue 项目的运行上下文文件和用户级项目索引。
+ * 写入用户级项目索引（REQ-ENV-01 修订）。
  *
- * @param input - 项目目录、登录配置和可选知识库路径。
- * @returns 写入的 .env、stage-context.md 和项目索引路径。
+ * 中性化：不写 .env、不写 stage-context.md；项目元信息合并到 projects.index.json5。
+ * index 条目含 stageCreateVersion，不含 stageContextPath/envPath/knowledgeRoot/codeListPaths。
+ * 顶层加 systems: []（首次创建时）。
+ *
+ * @param input - 项目名、项目目录、可选 stageCreateVersion 与 homeDir。
+ * @returns 写入的 projects.index.json5 路径。
  */
 export declare function writeGlueProjectContext(input: WriteGlueProjectContextInput): {
-    envPath: string;
-    stageContextPath: string;
     projectIndexPath: string;
 };
-/**
- * 校验 glue 模式运行所需的必填输入。
- *
- * @param input - glue 项目上下文输入。
- * @throws 当登录地址、用户名或密码为空时抛出错误。
- */
-export declare function validateRequiredContextInput(input: Pick<WriteGlueProjectContextInput, 'loginSystemUrl' | 'loginUsername' | 'loginPassword'>): void;

package/dist/stage-context.js

@@ -1,175 +1,70 @@
 import * as fs from 'fs';
 import * as os from 'os';
 import * as path from 'path';
+import { fileURLToPath } from 'url';
 import JSON5 from 'json5';
 /**
- * 写入 glue 项目的运行上下文文件和用户级项目索引。
+ * 写入用户级项目索引（REQ-ENV-01 修订）。
  *
- * @param input - 项目目录、登录配置和可选知识库路径。
- * @returns 写入的 .env、stage-context.md 和项目索引路径。
+ * 中性化：不写 .env、不写 stage-context.md；项目元信息合并到 projects.index.json5。
+ * index 条目含 stageCreateVersion，不含 stageContextPath/envPath/knowledgeRoot/codeListPaths。
+ * 顶层加 systems: []（首次创建时）。
+ *
+ * @param input - 项目名、项目目录、可选 stageCreateVersion 与 homeDir。
+ * @returns 写入的 projects.index.json5 路径。
  */
 export function writeGlueProjectContext(input) {
     const projectDir = path.resolve(input.projectDir);
-    const envPath = path.join(projectDir, '.env');
-    const stageContextPath = path.join(projectDir, 'stage-context.md');
     const projectIndexPath = path.join(input.homeDir ?? os.homedir(), '.ep-stage', 'projects.index.json5');
-    const knowledgeRoot = normalizeOptionalPath(input.knowledgeRoot);
-    const codeListPaths = getExistingCodeListPaths(knowledgeRoot);
-    validateRequiredContextInput(input);
-    fs.writeFileSync(envPath, renderEnv(input), 'utf8');
-    fs.writeFileSync(stageContextPath, renderStageContext({
-        projectName: input.projectName,
-        knowledgeRoot,
-        codeListPaths,
-    }), 'utf8');
+    const stageCreateVersion = input.stageCreateVersion ?? readSelfVersion();
     const index = readProjectIndex(projectIndexPath);
     const nextEntry = {
         projectName: input.projectName,
         projectDir,
         mode: 'glue',
-        envPath: '.env',
-        ...(knowledgeRoot ? { knowledgeRoot } : {}),
-        codeListPaths,
-        stageContextPath,
+        createdAt: new Date().toISOString(),
+        stageCreateVersion,
+        requirements: [],
     };
     const dedupedProjects = index.projects.filter((project) => path.resolve(project.projectDir) !== projectDir);
     fs.mkdirSync(path.dirname(projectIndexPath), { recursive: true });
-    fs.writeFileSync(projectIndexPath, `${JSON5.stringify({ version: 1, projects: [...dedupedProjects, nextEntry] }, null, 2)}\n`, 'utf8');
-    return { envPath, stageContextPath, projectIndexPath };
-}
-/**
- * 渲染 glue 模式运行所需的 .env 文件。
- *
- * @param input - 登录地址、账号和密码。
- * @returns .env 文件内容。
- */
-function renderEnv(input) {
-    return [
-        '# Stage 环境变量配置',
-        '',
-        'LOGIN_SYSTEM_URL=' + renderEnvValue(input.loginSystemUrl),
-        'LOGIN_USERNAME=' + renderEnvValue(input.loginUsername),
-        'LOGIN_PASSWORD=' + renderEnvValue(input.loginPassword),
-        '',
-    ].join('\n');
-}
-/**
- * 渲染项目级 stage-context.md。
- *
- * @param input - 项目名和可选知识库路径。
- * @returns stage-context.md 文件内容。
- */
-function renderStageContext(input) {
-    const frontmatter = [
-        '---',
-        `projectName: ${renderYamlString(input.projectName)}`,
-        `projectDir: ${renderYamlString('.')}`,
-        `mode: ${renderYamlString('glue')}`,
-        `envPath: ${renderYamlString('.env')}`,
-        ...(input.knowledgeRoot ? [`knowledgeRoot: ${renderYamlString(input.knowledgeRoot)}`] : []),
-        ...renderYamlStringArray('codeListPaths', input.codeListPaths),
-        '---',
-    ];
-    return [
-        ...frontmatter,
-        '',
-        `# ${input.projectName}`,
-        '',
-        '此文件由 stage-create glue 模式生成，用于 ep-stage skills/CLI 解析项目上下文。',
-        '',
-    ].join('\n');
+    const next = {
+        version: 1,
+        projects: [...dedupedProjects, nextEntry],
+        systems: index.systems ?? [],
+    };
+    fs.writeFileSync(projectIndexPath, `${JSON5.stringify(next, null, 2)}\n`, 'utf8');
+    return { projectIndexPath };
 }
 /**
  * 读取已有用户级项目索引，允许 JSON5 注释和尾逗号。
  *
  * @param projectIndexPath - 用户级项目索引路径。
- * @returns 解析后的项目索引。
+ * @returns 解析后的项目索引；缺失时返回空 projects/systems。
  */
 function readProjectIndex(projectIndexPath) {
     if (!fs.existsSync(projectIndexPath)) {
-        return { projects: [] };
+        return { projects: [], systems: [] };
     }
     const parsed = JSON5.parse(fs.readFileSync(projectIndexPath, 'utf8'));
-    return { projects: parsed.projects ?? [] };
-}
-/**
- * 校验 glue 模式运行所需的必填输入。
- *
- * @param input - glue 项目上下文输入。
- * @throws 当登录地址、用户名或密码为空时抛出错误。
- */
-export function validateRequiredContextInput(input) {
-    if (!input.loginSystemUrl.trim()) {
-        throw new Error('登录页面地址不能为空');
-    }
-    if (!input.loginUsername.trim()) {
-        throw new Error('登录用户名不能为空');
-    }
-    if (!input.loginPassword.trim()) {
-        throw new Error('登录密码不能为空');
-    }
-}
-/**
- * 渲染 .env 值，必要时使用双引号并转义特殊字符。
- *
- * @param value - 原始环境变量值。
- * @returns 可写入 .env 的安全值。
- */
-function renderEnvValue(value) {
-    if (!/[\s#"\\\r\n]/.test(value)) {
-        return value;
-    }
-    return `"${value
-        .replace(/\\/g, '\\\\')
-        .replace(/"/g, '\\"')
-        .replace(/\n/g, '\\n')
-        .replace(/\r/g, '\\r')}"`;
-}
-/**
- * 渲染 YAML 字符串标量。
- *
- * @param value - 原始字符串。
- * @returns 可放入 YAML frontmatter 的双引号标量。
- */
-function renderYamlString(value) {
-    return JSON.stringify(value);
+    return {
+        projects: parsed.projects ?? [],
+        systems: parsed.systems ?? [],
+    };
 }
 /**
- * 渲染 YAML 字符串数组。
+ * 读取自身 package.json 版本号，作为 stageCreateVersion 默认值。
  *
- * @param key - 字段名。
- * @param values - 字符串数组。
- * @returns YAML 行数组。
+ * @returns 当前 stage-create 的版本号；无法解析时返回 'unknown'。
  */
-function renderYamlStringArray(key, values) {
-    if (values.length === 0) {
-        return [`${key}: []`];
+function readSelfVersion() {
+    try {
+        const currentFilePath = fileURLToPath(import.meta.url);
+        const packageJsonPath = path.resolve(path.dirname(currentFilePath), '..', 'package.json');
+        const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        return pkg.version ?? 'unknown';
     }
-    return [
-        `${key}:`,
-        ...values.map((value) => `  - ${renderYamlString(value)}`),
-    ];
-}
-/**
- * 只在 knowledgeRoot/_docs/code_list.md 实际存在时登记 code list。
- *
- * @param knowledgeRoot - 可选知识库根目录。
- * @returns 已存在的 code_list.md 路径列表。
- */
-function getExistingCodeListPaths(knowledgeRoot) {
-    if (!knowledgeRoot) {
-        return [];
+    catch {
+        return 'unknown';
     }
-    const codeListPath = path.join(knowledgeRoot, '_docs', 'code_list.md');
-    return fs.existsSync(codeListPath) ? [codeListPath] : [];
-}
-/**
- * 归一化可选路径，空字符串视为未提供。
- *
- * @param value - 用户输入的可选路径。
- * @returns 绝对路径或 undefined。
- */
-function normalizeOptionalPath(value) {
-    const trimmed = value?.trim();
-    return trimmed ? path.resolve(trimmed) : undefined;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoint-testtech/stage-create",
-  "version": "0.0.3-alpha.1",
+  "version": "0.0.4-alpha.0",
   "description": "Epoint Stage — Playwright 脚手架 CLI",
   "type": "module",
   "bin": {