code-workspace-zhuiyi 1.0.0-beta.5 → 1.0.0

package/artifacts/manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 2,
-  "releaseVersion": "1.0.0-beta.5",
+  "releaseVersion": "1.0.0",
   "requirements": {
     "node": ">=20.19.0"
   },

package/artifacts/templates/extension-init/extension/init.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+"use strict";
+
+// TODO: implement the extension init protocol.

package/artifacts/templates/extension-init/gitignore

@@ -0,0 +1 @@
+/dist

package/docs/extension-development/extension-development-guide.zh-CN.md

@@ -45,12 +45,16 @@ codew extension init ./example-extension --yes
 
 ```text
 example-extension/
+├── .gitignore
+├── README.md
 ├── extension/
 │   ├── manifest.json
 │   └── init.js
 └── package.json
 ```
 
+初始化产物中的静态文件模板位于仓库的 `artifacts/templates/extension-init/`。后续调整 README、`.gitignore` 或 `extension/` 下的默认文件时，直接修改该模板目录即可；其中 `gitignore` 会在生成时映射为 `.gitignore`，以避免 npm 发布包排除点文件。`extension init` 只负责注入元数据、生成摘要并写入 package envelope。
+
 系统扩展仍使用固定版本目录：
 
 ```text

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "code-workspace-zhuiyi",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0",
   "description": "Local multi-project registry and safety layer for AI coding workspaces",
   "author": "icebearx-ai",
   "license": "MIT",

package/src/core/extension-scaffold.js

@@ -38,8 +38,25 @@ function validateScaffoldMetadata(options = {}, targetRoot) {
   return Object.freeze({ id, name, description, version });
 }
 
-function shellEntry() {
-  return "#!/usr/bin/env node\n\"use strict\";\n\n// TODO: implement the extension init protocol.\n";
+const SCAFFOLD_TEMPLATE_ROOT = path.join(__dirname, "..", "..", "artifacts", "templates", "extension-init");
+
+function readTemplateFiles(root = SCAFFOLD_TEMPLATE_ROOT, current = root, result = {}) {
+  let entries;
+  try {
+    entries = fs.readdirSync(current, { withFileTypes: true }).sort((left, right) => left.name.localeCompare(right.name));
+  } catch (error) {
+    throw scaffoldError("EXTENSION_TEMPLATE_INVALID", `Cannot read extension init template: ${root}`, { path: root, cause: error.code || error.message });
+  }
+  for (const entry of entries) {
+    const file = path.join(current, entry.name);
+    const relative = path.relative(root, file).split(path.sep).join("/");
+    const stat = fs.lstatSync(file);
+    if (stat.isSymbolicLink()) throw scaffoldError("EXTENSION_TEMPLATE_INVALID", `Extension init template contains a symbolic link: ${relative}`, { path: relative });
+    if (stat.isDirectory()) readTemplateFiles(root, file, result);
+    else if (stat.isFile()) result[relative === "gitignore" ? ".gitignore" : relative] = fs.readFileSync(file);
+    else throw scaffoldError("EXTENSION_TEMPLATE_INVALID", `Extension init template contains a special file: ${relative}`, { path: relative });
+  }
+  return result;
 }
 
 function validateShellManifest(raw) {
@@ -107,7 +124,9 @@ function shellEnvelope(metadata, packageSha256) {
 function scaffoldExtensionPackage(target, options = {}) {
   const targetRoot = path.resolve(target || ".");
   const metadata = validateScaffoldMetadata(options, targetRoot);
-  const entry = shellEntry();
+  const templateFiles = readTemplateFiles();
+  const entry = templateFiles["extension/init.js"];
+  if (!entry) throw scaffoldError("EXTENSION_TEMPLATE_INVALID", "Extension init template must contain extension/init.js", { path: "extension/init.js" });
   const manifest = {
     schemaVersion: 3,
     extensionSpecVersion: 1,
@@ -121,9 +140,9 @@ function scaffoldExtensionPackage(target, options = {}) {
     timeoutMs: 30000,
   };
   const files = {
+    ...templateFiles,
     "package.json": null,
     "extension/manifest.json": Buffer.from(`${JSON.stringify(manifest, null, 2)}\n`, "utf8"),
-    "extension/init.js": Buffer.from(entry, "utf8"),
   };
   const temporary = fs.mkdtempSync(path.join(path.dirname(targetRoot), `.${path.basename(targetRoot)}-`));
   try {