@bstage-sdk/cli 0.6.0 → 0.6.1

package/dist/MIGRATION.md

@@ -88,6 +88,8 @@
 
 - `bstage ai install`·`update`·`doctor`가 혼합 레포를 지원한다 — 스킬은 sdk 세트와 liquid 세트의 **합집합**(5종)을 설치하고, `AGENTS.md` 관리 영역은 두 구조와 혼합 규칙(어느 방식으로 만들지 · sdk 페이지 `user`·`admin` 금지 · `bstage build`·`dev --kind` 동작)을 담은 **혼합 본문**이 된다. `mixed`는 판정으로만 나오며 `--kind`로 지정하는 값이 아니다 — 혼합 레포에 `--kind sdk|liquid`를 주면 판정과 어긋나 멈춘다.
 - `bstage doctor`는 혼합 레포에서 스킬 검사를 건너뛰지 않고 두 세트를 모두 보며, liquid 검증 결과도 함께 낸다. `--json`의 `skillsSkipped`는 항상 `false`다(필드는 비파괴적으로 남긴다).
+- **레포 종류가 바뀐 뒤의 `AGENTS.md`** — sdk 레포에 liquid 템플릿을 더해 혼합이 되면 관리 영역 마커 버전은 그대로라, 예전에는 옛 sdk 본문이 "최신"으로 남았다. 이제 `bstage ai install`·`update`·`doctor`가 본문을 현재 종류의 렌더 결과와 비교해 다르면 갱신(`update`)·`stale`로 본다. 자유 영역은 보존된다.
+- **관리 영역이 이 CLI보다 새 버전이면 하향임을 알린다.** 프로젝트에 고정된 옛 CLI로 `ai install`·`update`·`doctor`를 돌리면 새 CLI가 놓은 관리 영역을 옛 본문으로 되돌리게 된다 — 그 사실을 알리고 최신 CLI로 다시 실행하라고 안내한다. 덮어쓰기 자체는 막지 않는다(마커 버전은 파일 안의 자기선언 값이다).
 - `bstage-onboarding`·`bstage-liquid` 스킬과 `AGENTS.md`의 "한 레포에 한 방식만" 문구를 공존 규칙(예약 이름 · `dev --kind liquid`)으로 바꿨다.
 
 **적용**

package/dist/index.js

@@ -4621,9 +4621,12 @@ import { readFile as readFile8 } from "fs/promises";
 import { join as join14 } from "path";
 import {
   VERSION as TOOLKIT_VERSION,
+  AGENTS_MANAGED_VERSION,
   agentsMdStatus,
   compareVersions,
+  extractManagedBlock,
   parseAgentsIdentity as parseAgentsIdentity2,
+  readManagedVersion as readManagedVersion2,
   readSkillStamp as readSkillStamp2,
   renderManagedBlock,
   sanitizeIdentity as sanitizeIdentity2,
@@ -4663,12 +4666,18 @@ async function diagnoseAgentsMd(root, pkgName, kind = "sdk") {
     return { status: "missing", managedBlock: null };
   }
   const status = agentsMdStatus(content);
-  if (status === "ok") return { status, managedBlock: null };
   const parsed = parseAgentsIdentity2(content);
   const projectName = sanitizeIdentity2(parsed.projectName) ?? sanitizeIdentity2(pkgName) ?? "custom-templates";
   const space = sanitizeIdentity2(parsed.space) ?? projectName.split("-custom-templates-")[0] ?? projectName;
   const target = resolveProjectTarget(root);
-  return { status, managedBlock: renderManagedBlock({ space, projectName, target, kind }) };
+  const block = renderManagedBlock({ space, projectName, target, kind });
+  if (status === "ok") {
+    if (extractManagedBlock(content) === block) return { status, managedBlock: null };
+    const fileVersion = readManagedVersion2(content);
+    const downgrade = fileVersion !== null && fileVersion > AGENTS_MANAGED_VERSION;
+    return downgrade ? { status: "stale", managedBlock: block, downgrade: true } : { status: "stale", managedBlock: block };
+  }
+  return { status, managedBlock: block };
 }
 
 // src/commands/doctor/report.ts
@@ -4960,6 +4969,14 @@ function printAgentsMd(r) {
       console.log(pc15.dim("  \xB7 \uD30C\uC77C \uC5C6\uC74C \u2014 bstage \uD504\uB85C\uC81D\uD2B8\uB77C\uBA74 init/\uB9C8\uC774\uADF8\uB808\uC774\uC158\uC73C\uB85C \uC0DD\uC131\uD558\uC138\uC694."));
       break;
     case "stale":
+      if (r.agentsMd.downgrade) {
+        console.log(
+          pc15.yellow("  ! \uAD00\uB9AC \uC601\uC5ED\uC774 \uC774 CLI\uBCF4\uB2E4 \uC0C8 \uBC84\uC804") + pc15.dim(
+            " \u2014 \uC774 CLI\uAC00 \uC624\uB798\uB3FC \uAC31\uC2E0\uD558\uBA74 \uC61B \uBCF8\uBB38\uC73C\uB85C \uB418\uB3CC\uC544\uAC11\uB2C8\uB2E4(\uD558\uD5A5). \uCD5C\uC2E0 CLI(npx @bstage-sdk/cli@latest)\uB85C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694."
+          )
+        );
+        break;
+      }
       console.log(
         pc15.yellow("  \u2192 \uAD00\uB9AC \uC601\uC5ED\uC774 \uC624\uB798\uB428") + pc15.dim(" \u2014 `bstage ai update`\uB85C \uAC31\uC2E0(\uC790\uC720 \uC601\uC5ED\uC740 \uBCF4\uC874).")
       );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bstage-sdk/cli",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "bstage SDK CLI — build b.stage templates",
   "type": "module",
   "publishConfig": {
@@ -32,14 +32,14 @@
     "liquidjs": "^10.24.0",
     "picocolors": "^1.1.1",
     "vite": "^7.0.0",
-    "@bstage-sdk/ai-toolkit": "0.6.0",
-    "@bstage-sdk/core": "0.6.0"
+    "@bstage-sdk/ai-toolkit": "0.6.1",
+    "@bstage-sdk/core": "0.6.1"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
     "tsup": "^8.0.0",
     "typescript": "^5.5.0",
-    "@bstage-sdk/design": "0.6.0"
+    "@bstage-sdk/design": "0.6.1"
   },
   "license": "MIT",
   "scripts": {