@nalvietnam/avatar-cli 3.25.3 → 3.26.0

package/dist/lib/compare-pack-semver-and-detect-downgrade.d.ts

@@ -0,0 +1,2 @@
+export type PackVersionTransition = "upgrade" | "noop" | "downgrade" | "unknown";
+export declare function classifyPackVersionTransition(current: string | null | undefined, target: string | null | undefined): PackVersionTransition;

package/dist/lib/pack-manifest-contract.d.ts

@@ -0,0 +1,26 @@
+export declare const PACK_MANIFEST_FILENAME = ".avatar-pack-manifest.json";
+export declare const PACK_VERSION_FILENAME = ".pack-version";
+export interface PackManifest {
+    version: string;
+    downloadedObject: string;
+    sha256?: string;
+    extractedAt: string;
+}
+/**
+ * Hình dạng ĐỌC được từ đĩa — khác hình dạng GHI ở chỗ chỉ `version` được kiểm.
+ *
+ * Vì sao không dùng thẳng `PackManifest`: manifest do bản CLI cũ (hoặc pack cài
+ * tay) ghi có thể thiếu `downloadedObject`/`extractedAt`. Siết đủ 3 field sẽ biến
+ * những manifest đó thành "không có manifest" một cách IM LẶNG. Nhưng khai kiểu
+ * trả về là `PackManifest` thì type nói dối: TypeScript hứa `downloadedObject` là
+ * `string` trong khi runtime có thể `undefined`. Tách kiểu ra là cách giữ cả hai —
+ * đường GHI vẫn bị bắt buộc đủ field, đường ĐỌC nói đúng những gì nó kiểm.
+ */
+export type ParsedPackManifest = Pick<PackManifest, "version"> & Partial<Omit<PackManifest, "version">>;
+/**
+ * Đọc manifest từ chuỗi JSON thô.
+ *
+ * JSON hỏng / không phải object / thiếu `version` ⇒ `null`, KHÔNG throw:
+ * workspace vừa `avatar init` mà chưa `sync` là trạng thái HỢP LỆ, không phải lỗi.
+ */
+export declare function parsePackManifest(raw: string): ParsedPackManifest | null;

package/dist/lib/pick-latest-stable-semver-tag.d.ts

@@ -0,0 +1,10 @@
+interface ParsedSemVer {
+    raw: string;
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease: string | null;
+}
+export declare function parseSemVerTag(tag: string): ParsedSemVer | null;
+export declare function pickLatestStableSemVerTag(tags: string[], includePrerelease?: boolean): string | null;
+export {};

package/package.json

@@ -1,11 +1,19 @@
 {
   "name": "@nalvietnam/avatar-cli",
-  "version": "3.25.3",
+  "version": "3.26.0",
   "description": "AI harness CLI for NAL Vietnam engineering",
   "type": "module",
   "bin": {
     "avatar": "./bin/avatar.js"
   },
+  "exports": {
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "require": "./dist/core/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
   "files": [
     "bin",
     "dist",
@@ -16,7 +24,7 @@
     "node": ">=18.17.0"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && tsc -p tsconfig.core-dts.json",
     "dev": "tsup --watch",
     "test": "vitest run --passWithNoTests --exclude 'test/integration/**' --testTimeout=15000",
     "test:watch": "vitest --exclude 'test/integration/**'",