create-agentic-dev-env 0.2.5 → 0.2.7

package/lib/runner.js

@@ -8,10 +8,12 @@ const END = '<!-- ADE:END -->'
 
 function run(cmd, pkgDir) {
   try {
-    if (cmd === 'init') init(process.cwd(), pkgDir)
-    else if (cmd === 'update') update(process.cwd())
+    const i = process.argv.indexOf('--workspaces')
+    const ws = i !== -1 ? process.argv[i + 1] : undefined
+    if (cmd === 'init') init(process.cwd(), pkgDir, ws)
+    else if (cmd === 'update') update(process.cwd(), ws)
     else {
-      console.error('Usage: init | update')
+      console.error('Usage: init | update  [--workspaces <path>]')
       process.exit(1)
     }
   } catch (e) {
@@ -20,15 +22,15 @@ function run(cmd, pkgDir) {
   }
 }
 
-function init(cwd, srcDir) {
+function init(cwd, srcDir, ws) {
   if (fs.existsSync(path.join(cwd, '.ade.json'))) {
     throw new Error('Already initialized here; run update instead')
   }
-  install(cwd, srcDir)
+  install(cwd, srcDir, ws)
   console.log('ADE init done')
 }
 
-function update(cwd) {
+function update(cwd, ws) {
   const cfgPath = path.join(cwd, '.ade.json')
   if (!fs.existsSync(cfgPath)) throw new Error('Not initialized here; run init first')
   const cfg = JSON.parse(fs.readFileSync(cfgPath, 'utf8'))
@@ -40,7 +42,7 @@ function update(cwd) {
   try {
     execSync(`git clone --depth 1 "${cfg.source}" "${path.join(tmp, 'repo')}"`, { stdio: 'inherit' })
     removeManaged(cwd)
-    install(cwd, path.join(tmp, 'repo'))
+    install(cwd, path.join(tmp, 'repo'), ws)
   } finally {
     fs.rmSync(tmp, { recursive: true, force: true })
   }
@@ -57,7 +59,7 @@ function removeManaged(cwd) {
   }
 }
 
-function install(cwd, srcDir) {
+function install(cwd, srcDir, wsOverride) {
   // 先驗證再動手：update 只清理 ade- 前綴，非前綴 skill 裝了就清不掉
   const srcSkills = path.join(srcDir, 'skills')
   const skillDirs = fs.existsSync(srcSkills)
@@ -90,15 +92,29 @@ function install(cwd, srcDir) {
   }
   fs.writeFileSync(claudePath, md)
 
-  fs.mkdirSync(path.join(cwd, 'workspaces'), { recursive: true })
+  const prevPath = path.join(cwd, '.ade.json')
+  const prev = fs.existsSync(prevPath) ? JSON.parse(fs.readFileSync(prevPath, 'utf8')) : {}
+
+  // 作業區固定叫 workspaces/；指定既有 repo 存放資料夾時（--workspaces 或 .ade.json 的
+  // workspaces），workspaces 建成指向它的 symlink，cd workspaces 即達、已下載的 repo 直接沿用
+  const ws = wsOverride || prev.workspaces || null
+  const wsDir = path.join(cwd, 'workspaces')
+  if (ws && path.resolve(cwd, ws) !== wsDir) {
+    fs.mkdirSync(path.resolve(cwd, ws), { recursive: true })
+    let st = null
+    try { st = fs.lstatSync(wsDir) } catch {}
+    if (st && st.isSymbolicLink()) fs.unlinkSync(wsDir)
+    else if (st) throw new Error('workspaces already exists and is not a symlink; move its contents into the target folder and remove it, then retry')
+    fs.symlinkSync(ws, wsDir, 'dir')
+  } else {
+    fs.mkdirSync(wsDir, { recursive: true })
+  }
   const giPath = path.join(cwd, '.gitignore')
   const gi = fs.existsSync(giPath) ? fs.readFileSync(giPath, 'utf8') : ''
-  if (!gi.split('\n').some((l) => l.trim().replace(/\/$/, '') === 'workspaces')) {
-    fs.writeFileSync(giPath, (gi ? gi.trimEnd() + '\n' : '') + 'workspaces/\n')
+  // 不帶斜線才涵蓋 symlink 形態（gitignore 的 `dir/` 不匹配 symlink）
+  if (!gi.split('\n').some((l) => l.trim() === 'workspaces')) {
+    fs.writeFileSync(giPath, (gi ? gi.trimEnd() + '\n' : '') + 'workspaces\n')
   }
-
-  const prevPath = path.join(cwd, '.ade.json')
-  const prev = fs.existsSync(prevPath) ? JSON.parse(fs.readFileSync(prevPath, 'utf8')) : {}
   let source = null
   try {
     const pkg = JSON.parse(fs.readFileSync(path.join(srcDir, 'package.json'), 'utf8'))
@@ -114,7 +130,7 @@ function install(cwd, srcDir) {
   } catch {}
   fs.writeFileSync(
     prevPath,
-    JSON.stringify({ source: source || prev.source || null, commit }, null, 2) + '\n'
+    JSON.stringify({ source: source || prev.source || null, commit, workspaces: ws }, null, 2) + '\n'
   )
   if (!source && !prev.source) {
     console.warn('Warning: repository.url is not set in the ADE repo package.json; update will not work — set source in .ade.json manually')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-agentic-dev-env",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "Scaffold and manage team Agentic Dev Environment (ADE) knowledge repos",
   "repository": {
     "type": "git",

package/template/README.md

@@ -40,8 +40,8 @@ init 會在當前目錄建立：
 
 - `CLAUDE.md` 的 `<!-- ADE:BEGIN/END -->` managed 區段（原有內容不動）
 - `.claude/ade/knowledge/` 知識庫副本、`.claude/skills/ade-*/` skills
-- `workspaces/`（agent clone 服務 repo 的作業區，自動加入 .gitignore）
-- `.ade.json`（記錄來源與版本）
+- `workspaces/`（agent clone 服務 repo 的作業區，自動加入 .gitignore。已有固定放 repo 的資料夾時用 `init --workspaces <path>` 指向它——`workspaces` 會建成該資料夾的 symlink，`cd workspaces` 即達、已下載的 repo 直接沿用不重 clone）
+- `.ade.json`（設定檔：`source` 來源、`commit` 版本、`workspaces` 作業區實際位置（symlink 目標，預設 null）。改 `workspaces` 後跑一次 update 重建 symlink）
 
 之後同指令改跑 `update` 拉取最新知識（update 會直接 clone 最新版，不受 dlx 快取影響）。
 

package/template/claude-md/section.md

@@ -16,7 +16,7 @@
 
 1. 讀 `.claude/ade/knowledge/services/index.md`（全服務總覽）定位目標服務
 2. 讀 `.claude/ade/knowledge/services/<service>.yaml` 取得定位、repo、技術棧、依賴關係
-3. 若 `workspaces/<service>/` 不存在，依 `repo.url` / `repo.branch` clone 到 `workspaces/<service>/`
+3. `workspaces/<service>/` 已存在就直接用，不存在才依 `repo.url` / `repo.branch` clone 到 `workspaces/<service>/`
 4. 讀服務 repo 自身的 README／CLAUDE.md／AGENTS.md 完成安裝、啟動、測試；跨服務流程慣例見 `knowledge/process/`，功能規格見 `knowledge/specs/`
 
 ### 知識維護