@trungtamcongnghedigital/vsaf 1.0.0 → 1.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trungtamcongnghedigital/vsaf",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "is it ready to use ?",
   "main": "packages/core/dist/index.js",
   "types": "packages/core/dist/index.d.ts",

package/packages/cli/dist/commands/apply-pack.d.ts

@@ -1,29 +0,0 @@
-import { type InstallResult } from './install.js';
-/**
- * Cài một pack nằm sẵn trên đĩa.
- *
- * Đây là lối vào cho script của chính flow: `install.sh` của flow gọi lệnh này để
- * engine làm phần chung — rải skill, nhân bản sang thư mục IDE, quản gitignore, ghi
- * sổ để gỡ được — rồi flow tự làm phần riêng của nó.
- *
- * Bên trong không có gì mới: `execInstall` vốn đã nhận được một thư mục qua tuỳ chọn
- * nội bộ `_packDir`, trước nay chỉ test dùng. Mở nó ra thành lệnh thật giữ cho đường
- * cài đặt chỉ có một, nên sổ ghi và cách gỡ không phải viết lại lần thứ hai.
- */
-export interface ApplyPackOptions {
-    force?: boolean;
-    skipDeps?: boolean;
-    dryRun?: boolean;
-    verbose?: boolean;
-    projectRoot?: boolean;
-    /**
-     * Bỏ qua bước cài graphify.
-     *
-     * Có cờ `--skip-graphify` ngoài dòng lệnh chứ không chỉ dùng trong test: bước này gọi
-     * `pipx install` và ghi vào thư mục công cụ dưới home, tức là ra ngoài dự án. Một lượt
-     * chạy tự động hoặc một lần cài lại flow không nên trả giá đó lần nữa.
-     */
-    _skipGraphify?: boolean;
-}
-export declare function execApplyPack(packDir: string, projectPath: string, options?: ApplyPackOptions): InstallResult;
-//# sourceMappingURL=apply-pack.d.ts.map

package/packages/cli/dist/commands/apply-pack.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"apply-pack.d.ts","sourceRoot":"","sources":["../../src/commands/apply-pack.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAI/D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,gBAAqB,GAC7B,aAAa,CAwBf"}

package/packages/cli/dist/commands/apply-pack.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.execApplyPack = execApplyPack;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const install_js_1 = require("./install.js");
-const install_plan_js_1 = require("./install/install-plan.js");
-const skill_js_1 = require("./skill.js");
-function execApplyPack(packDir, projectPath, options = {}) {
-    const dir = (0, path_1.resolve)(packDir);
-    // Nói ra ngay tại đây thay vì để hỏng sâu bên trong: người đọc lỗi này là người
-    // vừa viết `install.sh` cho flow của họ, và thứ họ cần biết là thư mục đưa vào sai.
-    if (!(0, fs_1.existsSync)((0, path_1.join)(dir, 'pack.yaml'))) {
-        throw new Error(`"${dir}" không phải thư mục flow — không tìm thấy pack.yaml trong đó.`);
-    }
-    // Tên cài đặt phải đến từ chính `pack.yaml`, không phải tên thư mục đang giữ nó: một
-    // cache bị đổi tên, một tarball giải nén ra chỗ khác, một worktree checkout — không
-    // cái nào có nghĩa vụ giữ đúng tên thư mục gốc. Dùng `basename(dir)` làm tên cài đặt
-    // sẽ làm sổ ghi mang tên thư mục thay vì tên pack, và `vsaf uninstall <tên-thật>` sẽ
-    // không tìm thấy gì để gỡ. Chỉ lùi về tên thư mục khi chính `pack.yaml` không khai `name`.
-    const name = (0, skill_js_1.readPackInfoFrom)(dir).name ?? (0, path_1.basename)(dir);
-    // Kế hoạch trước, cờ dòng lệnh sau — để một cờ người dùng gõ tay là cờ thắng khi hai
-    // bên nói khác nhau. Hai tập không giao nhau (kế hoạch mang hình dạng dự án, dòng lệnh
-    // mang năm cờ hành vi), nên thứ tự này chỉ là để dành cho tương lai.
-    const planPath = process.env[install_plan_js_1.PLAN_ENV];
-    const plan = planPath ? (0, install_plan_js_1.readInstallPlan)(planPath, projectPath, name) : null;
-    const fromPlan = plan ? (0, install_plan_js_1.planToOptions)(plan) : {};
-    return (0, install_js_1.execInstall)(name, projectPath, { ...fromPlan, ...options, _packDir: dir });
-}
-//# sourceMappingURL=apply-pack.js.map

package/packages/cli/dist/commands/apply-pack.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"apply-pack.js","sourceRoot":"","sources":["../../src/commands/apply-pack.ts"],"names":[],"mappings":";;AAiCA,sCA4BC;AA7DD,2BAAgC;AAChC,+BAA+C;AAC/C,6CAA+D;AAC/D,+DAAqF;AACrF,yCAA8C;AA6B9C,SAAgB,aAAa,CAC3B,OAAe,EACf,WAAmB,EACnB,UAA4B,EAAE;IAE9B,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,OAAO,CAAC,CAAC;IAE7B,gFAAgF;IAChF,oFAAoF;IACpF,IAAI,CAAC,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,IAAI,GAAG,gEAAgE,CAAC,CAAC;IAC3F,CAAC;IAED,qFAAqF;IACrF,oFAAoF;IACpF,qFAAqF;IACrF,qFAAqF;IACrF,2FAA2F;IAC3F,MAAM,IAAI,GAAG,IAAA,2BAAgB,EAAC,GAAG,CAAC,CAAC,IAAI,IAAI,IAAA,eAAQ,EAAC,GAAG,CAAC,CAAC;IAEzD,qFAAqF;IACrF,uFAAuF;IACvF,qEAAqE;IACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,0BAAQ,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAA,iCAAe,EAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,IAAA,+BAAa,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjD,OAAO,IAAA,wBAAW,EAAC,IAAI,EAAE,WAAW,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;AACpF,CAAC"}

package/packages/cli/dist/commands/install/engine-range.d.ts

@@ -1,13 +0,0 @@
-/**
- * Chốt chặn giữa flow và engine.
- *
- * Flow phát hành ở repo riêng, không cùng nhịp với engine, nên một flow mới hoàn toàn
- * có thể đòi tính năng engine trên máy chưa có. Chặn ở đây — trước khi ghi file nào —
- * đổi một lỗi lạ giữa chừng cài đặt thành một câu bảo nâng engine.
- *
- * Chỉ nhận đúng một dạng khai báo. Không kéo `semver` về chỉ để đọc một dấu `>=`:
- * repo này không có dependency đó, và mọi dạng khai báo khác chưa ai cần tới.
- */
-export declare function satisfiesEngineRange(version: string, range: string): boolean;
-export declare function assertEngineSatisfies(packName: string, requires: string | undefined, engineVersion: string): void;
-//# sourceMappingURL=engine-range.d.ts.map

package/packages/cli/dist/commands/install/engine-range.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine-range.d.ts","sourceRoot":"","sources":["../../../src/commands/install/engine-range.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAmB5E;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,aAAa,EAAE,MAAM,GACpB,IAAI,CAgBN"}

package/packages/cli/dist/commands/install/engine-range.js

@@ -1,50 +0,0 @@
-"use strict";
-/**
- * Chốt chặn giữa flow và engine.
- *
- * Flow phát hành ở repo riêng, không cùng nhịp với engine, nên một flow mới hoàn toàn
- * có thể đòi tính năng engine trên máy chưa có. Chặn ở đây — trước khi ghi file nào —
- * đổi một lỗi lạ giữa chừng cài đặt thành một câu bảo nâng engine.
- *
- * Chỉ nhận đúng một dạng khai báo. Không kéo `semver` về chỉ để đọc một dấu `>=`:
- * repo này không có dependency đó, và mọi dạng khai báo khác chưa ai cần tới.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.satisfiesEngineRange = satisfiesEngineRange;
-exports.assertEngineSatisfies = assertEngineSatisfies;
-const RANGE = /^>=\s*(\d+)\.(\d+)\.(\d+)$/;
-const VERSION = /^(\d+)\.(\d+)\.(\d+)/;
-function satisfiesEngineRange(version, range) {
-    const wanted = RANGE.exec(range.trim());
-    if (!wanted) {
-        throw new Error(`requiresEngine: "${range}" không đọc được. Dạng duy nhất được nhận là ">=X.Y.Z", ví dụ ">=6.20.0".`);
-    }
-    // Phần đuôi phát hành thử được bỏ qua: '6.20.0-rc.1' tính là 6.20.0.
-    const have = VERSION.exec(version.trim());
-    if (!have)
-        return false;
-    for (let part = 1; part <= 3; part++) {
-        const mine = Number(have[part]);
-        const need = Number(wanted[part]);
-        if (mine > need)
-            return true;
-        if (mine < need)
-            return false;
-    }
-    return true;
-}
-function assertEngineSatisfies(packName, requires, engineVersion) {
-    if (!requires)
-        return;
-    // Chạy thẳng từ mã nguồn thì không có package.json đã phát hành để đọc. Chặn hết
-    // mọi flow ở đây sẽ làm hỏng máy người phát triển, nên chỉ nói ra rồi đi tiếp.
-    if (engineVersion === 'unknown') {
-        console.log(`[vsaf] không đọc được bản engine nên bỏ qua chốt chặn của flow "${packName}" (${requires})`);
-        return;
-    }
-    if (satisfiesEngineRange(engineVersion, requires))
-        return;
-    throw new Error(`Flow "${packName}" cần vsaf ${requires}, máy đang chạy ${engineVersion}.\n`
-        + '  Nâng engine rồi cài lại:  npm i -g @ngocsangairvds/vsaf@latest');
-}
-//# sourceMappingURL=engine-range.js.map

package/packages/cli/dist/commands/install/engine-range.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine-range.js","sourceRoot":"","sources":["../../../src/commands/install/engine-range.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAKH,oDAmBC;AAED,sDAoBC;AA5CD,MAAM,KAAK,GAAG,4BAA4B,CAAC;AAC3C,MAAM,OAAO,GAAG,sBAAsB,CAAC;AAEvC,SAAgB,oBAAoB,CAAC,OAAe,EAAE,KAAa;IACjE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,oBAAoB,KAAK,2EAA2E,CACrG,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAExB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAClC,IAAI,IAAI,GAAG,IAAI;YAAE,OAAO,IAAI,CAAC;QAC7B,IAAI,IAAI,GAAG,IAAI;YAAE,OAAO,KAAK,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,qBAAqB,CACnC,QAAgB,EAChB,QAA4B,EAC5B,aAAqB;IAErB,IAAI,CAAC,QAAQ;QAAE,OAAO;IAEtB,iFAAiF;IACjF,+EAA+E;IAC/E,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,mEAAmE,QAAQ,MAAM,QAAQ,GAAG,CAAC,CAAC;QAC1G,OAAO;IACT,CAAC;IAED,IAAI,oBAAoB,CAAC,aAAa,EAAE,QAAQ,CAAC;QAAE,OAAO;IAE1D,MAAM,IAAI,KAAK,CACb,SAAS,QAAQ,cAAc,QAAQ,mBAAmB,aAAa,KAAK;UAC1E,kEAAkE,CACrE,CAAC;AACJ,CAAC"}

package/packages/cli/dist/commands/install/engine-version.d.ts

@@ -1,16 +0,0 @@
-/**
- * Real package version, read from the root package.json at runtime.
- *
- * Walks up from this file (dist/commands/install → … → package root) and picks the
- * first package.json whose name is the published root (`…/vsaf`), skipping the
- * workspace's own `@vsaf/cli`. Reading it at runtime keeps `vsaf --version` truthful
- * after a release bump — the previous hardcoded '0.1.0' reported the (never-bumped)
- * workspace version instead.
- *
- * Lives here rather than in `index.ts` because the install path needs it too: the
- * `requiresEngine` gate compares a flow's demand against this number, and a version it
- * cannot read means the gate never refuses anything. Left unexported in `index.ts` it
- * was unreachable from there, so the gate would have passed every flow in silence.
- */
-export declare function resolveEngineVersion(): string;
-//# sourceMappingURL=engine-version.d.ts.map

package/packages/cli/dist/commands/install/engine-version.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine-version.d.ts","sourceRoot":"","sources":["../../../src/commands/install/engine-version.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAuB7C"}

package/packages/cli/dist/commands/install/engine-version.js

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveEngineVersion = resolveEngineVersion;
-const fs_1 = require("fs");
-const path_1 = require("path");
-/**
- * Real package version, read from the root package.json at runtime.
- *
- * Walks up from this file (dist/commands/install → … → package root) and picks the
- * first package.json whose name is the published root (`…/vsaf`), skipping the
- * workspace's own `@vsaf/cli`. Reading it at runtime keeps `vsaf --version` truthful
- * after a release bump — the previous hardcoded '0.1.0' reported the (never-bumped)
- * workspace version instead.
- *
- * Lives here rather than in `index.ts` because the install path needs it too: the
- * `requiresEngine` gate compares a flow's demand against this number, and a version it
- * cannot read means the gate never refuses anything. Left unexported in `index.ts` it
- * was unreachable from there, so the gate would have passed every flow in silence.
- */
-function resolveEngineVersion() {
-    let dir = __dirname;
-    // Eight rather than the six this walk needs from its deepest known home
-    // (`dist/commands/install`). Six was exactly enough, which means one more directory
-    // between this file and the package root would return 'unknown' — and 'unknown'
-    // does not fail loudly, it turns the engine gate off without a word.
-    for (let i = 0; i < 8; i++) {
-        try {
-            const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(dir, 'package.json'), 'utf8'));
-            if (typeof pkg.name === 'string' && pkg.name.endsWith('/vsaf') && pkg.version) {
-                return pkg.version;
-            }
-        }
-        catch {
-            // no package.json here (or unreadable) — keep walking up
-        }
-        const parent = (0, path_1.dirname)(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    return 'unknown';
-}
-//# sourceMappingURL=engine-version.js.map

package/packages/cli/dist/commands/install/engine-version.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine-version.js","sourceRoot":"","sources":["../../../src/commands/install/engine-version.ts"],"names":[],"mappings":";;AAiBA,oDAuBC;AAxCD,2BAAkC;AAClC,+BAAqC;AAErC;;;;;;;;;;;;;GAaG;AACH,SAAgB,oBAAoB;IAClC,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,wEAAwE;IACxE,oFAAoF;IACpF,gFAAgF;IAChF,qEAAqE;IACrE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAA,WAAI,EAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAGrE,CAAC;YACF,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC9E,OAAO,GAAG,CAAC,OAAO,CAAC;YACrB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;QACD,MAAM,MAAM,GAAG,IAAA,cAAO,EAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/packages/cli/dist/commands/install/flow-home.d.ts

@@ -1,24 +0,0 @@
-/**
- * Nơi cache flow nằm trên máy, và những flow đã có trong đó.
- *
- * Tách khỏi `flow-source.ts` vì `skill.ts` cũng cần đọc: sau khi flow ra khỏi gói npm,
- * "những pack máy này biết" không còn là "những thư mục gói npm mang theo" nữa. Đặt
- * chung vào `flow-source.ts` thì `skill.ts` phải import nó, mà nó lại import `skill.ts`
- * — một vòng import, và cách vòng đó hỏng phụ thuộc vào thứ tự nạp module.
- *
- * Chỉ đọc đĩa. Không lệnh git nào ở đây, nên gọi từ đâu cũng an toàn.
- */
-/** Tên flow phải là một thư mục ở gốc repo, không phải một đường dẫn. */
-export declare function assertFlowName(flow: string): void;
-export declare function flowsCacheDir(): string;
-/**
- * Bản flow đã có sẵn trong cache trên máy, hoặc rỗng nếu chưa từng kéo về.
- *
- * Đọc thôi, không chạm git. Có đúng một chỗ cần thế: `--dry-run` hứa không ghi gì, nên
- * nó không được phép kéo repo về — kéo là ghi vào cache, và trên đường mặc định còn là
- * trả giá một lượt clone qua mạng cho một lệnh vốn chỉ để đọc.
- */
-export declare function cachedFlowDir(flow: string): string | null;
-/** Những flow đã kéo về máy — thư mục trong cache có `pack.yaml`. */
-export declare function cachedFlowNames(): string[];
-//# sourceMappingURL=flow-home.d.ts.map

package/packages/cli/dist/commands/install/flow-home.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"flow-home.d.ts","sourceRoot":"","sources":["../../../src/commands/install/flow-home.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAUjD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIzD;AAED,qEAAqE;AACrE,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAW1C"}

package/packages/cli/dist/commands/install/flow-home.js

@@ -1,63 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertFlowName = assertFlowName;
-exports.flowsCacheDir = flowsCacheDir;
-exports.cachedFlowDir = cachedFlowDir;
-exports.cachedFlowNames = cachedFlowNames;
-const fs_1 = require("fs");
-const os_1 = require("os");
-const path_1 = require("path");
-/**
- * Nơi cache flow nằm trên máy, và những flow đã có trong đó.
- *
- * Tách khỏi `flow-source.ts` vì `skill.ts` cũng cần đọc: sau khi flow ra khỏi gói npm,
- * "những pack máy này biết" không còn là "những thư mục gói npm mang theo" nữa. Đặt
- * chung vào `flow-source.ts` thì `skill.ts` phải import nó, mà nó lại import `skill.ts`
- * — một vòng import, và cách vòng đó hỏng phụ thuộc vào thứ tự nạp module.
- *
- * Chỉ đọc đĩa. Không lệnh git nào ở đây, nên gọi từ đâu cũng an toàn.
- */
-/** Tên flow phải là một thư mục ở gốc repo, không phải một đường dẫn. */
-function assertFlowName(flow) {
-    // Ba hình dạng, một lý do: tên flow đi thẳng vào `join(cache, flow)` và vào
-    // `sparse-checkout add`, nên một tên mang dấu phân cách hay `..` là một đường dẫn
-    // trỏ ra ngoài cache — và `--refresh-flows` thì `rmSync` đúng chỗ nó trỏ tới.
-    if (flow.trim() === '' || flow.includes('/') || flow.includes('\\') || flow.includes('..')) {
-        throw new Error(`"${flow}" không phải tên flow hợp lệ.\n`
-            + '  Tên flow là tên một thư mục ở gốc repo flows — không chứa "/", "\\" hay "..".');
-    }
-}
-function flowsCacheDir() {
-    // `||` chứ không phải `??`: `VSAF_HOME=""` vẫn phải rơi về mặc định. Nếu không, `cache`
-    // thành đường dẫn tương đối `flows` dưới thư mục hiện hành, và `ensureCache` sẽ `rmSync`
-    // đúng thư mục đó — xoá nhầm một thư mục `./flows` chẳng liên quan gì của người dùng.
-    const home = process.env.VSAF_HOME || (0, path_1.join)((0, os_1.homedir)(), '.vsaf');
-    return (0, path_1.join)(home, 'flows');
-}
-/**
- * Bản flow đã có sẵn trong cache trên máy, hoặc rỗng nếu chưa từng kéo về.
- *
- * Đọc thôi, không chạm git. Có đúng một chỗ cần thế: `--dry-run` hứa không ghi gì, nên
- * nó không được phép kéo repo về — kéo là ghi vào cache, và trên đường mặc định còn là
- * trả giá một lượt clone qua mạng cho một lệnh vốn chỉ để đọc.
- */
-function cachedFlowDir(flow) {
-    assertFlowName(flow);
-    const dir = (0, path_1.join)(flowsCacheDir(), flow);
-    return (0, fs_1.existsSync)((0, path_1.join)(dir, 'pack.yaml')) ? dir : null;
-}
-/** Những flow đã kéo về máy — thư mục trong cache có `pack.yaml`. */
-function cachedFlowNames() {
-    const cache = flowsCacheDir();
-    try {
-        return (0, fs_1.readdirSync)(cache, { withFileTypes: true })
-            .filter(entry => entry.isDirectory() && (0, fs_1.existsSync)((0, path_1.join)(cache, entry.name, 'pack.yaml')))
-            .map(entry => entry.name)
-            .sort();
-    }
-    catch {
-        // Chưa có cache. Không phải sự cố, chỉ là chưa cài flow nào.
-        return [];
-    }
-}
-//# sourceMappingURL=flow-home.js.map

package/packages/cli/dist/commands/install/flow-home.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flow-home.js","sourceRoot":"","sources":["../../../src/commands/install/flow-home.ts"],"names":[],"mappings":";;AAgBA,wCAUC;AAED,sCAMC;AASD,sCAIC;AAGD,0CAWC;AA7DD,2BAA6C;AAC7C,2BAA6B;AAC7B,+BAA4B;AAE5B;;;;;;;;;GASG;AAEH,yEAAyE;AACzE,SAAgB,cAAc,CAAC,IAAY;IACzC,4EAA4E;IAC5E,kFAAkF;IAClF,8EAA8E;IAC9E,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3F,MAAM,IAAI,KAAK,CACb,IAAI,IAAI,iCAAiC;cACvC,iFAAiF,CACpF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAgB,aAAa;IAC3B,wFAAwF;IACxF,yFAAyF;IACzF,sFAAsF;IACtF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,IAAA,WAAI,EAAC,IAAA,YAAO,GAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,OAAO,IAAA,WAAI,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,cAAc,CAAC,IAAI,CAAC,CAAC;IACrB,MAAM,GAAG,GAAG,IAAA,WAAI,EAAC,aAAa,EAAE,EAAE,IAAI,CAAC,CAAC;IACxC,OAAO,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAED,qEAAqE;AACrE,SAAgB,eAAe;IAC7B,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,OAAO,IAAA,gBAAW,EAAC,KAAK,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aAC/C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;aACxF,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aACxB,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;QAC7D,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/packages/cli/dist/commands/install/flow-script.d.ts

@@ -1,97 +0,0 @@
-import type { FlowSource } from './flow-source.js';
-/**
- * Chạy file cài đặt của chính flow.
- *
- * Mỗi flow mang theo file cài của nó, để một flow tương lai cần làm việc mà engine
- * chưa có khái niệm thì người viết flow thêm dòng vào file đó và phát hành lại flow —
- * không ai phải chạm vào engine, không ai phải chờ engine ra bản mới.
- *
- * Hôm nay cả bốn flow đều dùng đúng một nội dung dài một dòng: gọi `vsaf apply-pack`.
- * Đó là dự tính, không phải thiếu sót.
- */
-export interface FlowScriptContext {
-    source: FlowSource;
-    flow: string;
-    projectPath: string;
-    projectName: string;
-    engineVersion: string;
-    /**
-     * File kế hoạch lượt cài, hoặc chuỗi rỗng.
-     *
-     * LUÔN đặt biến này, kể cả khi rỗng: `runFlowScript` trộn `process.env` vào môi trường
-     * của tiến trình con, nên bỏ trống khoá sẽ để một giá trị còn sót trong shell của người
-     * dùng chảy vào lượt cài này.
-     */
-    planPath: string;
-}
-/**
- * Những cờ engine biết mà lượt cài thật cũng phải biết.
- *
- * Đây là chỗ `vsaf install --skip-deps` từng mất tác dụng: engine chỉ chuyển cho script
- * phần người dùng gõ sau `--`, nên bốn cờ engine tự nhận ở dòng lệnh đứng lại ở tiến
- * trình cha. Đo được: `vsaf install sdlc --skip-deps` vẫn chạy `npm install` thật, tải
- * 255 gói, mất 2 phút; và `--force` thì in `⊘ (exists, use --force to overwrite)` —
- * làm đúng ngược lại điều được yêu cầu, không báo lỗi.
- */
-export interface FlowScriptFlags {
-    force?: boolean;
-    skipDeps?: boolean;
-    skipGraphify?: boolean;
-    projectRoot?: boolean;
-    verbose?: boolean;
-}
-/**
- * Dòng lệnh đưa cho script của flow: cờ engine trước, cờ người dùng gõ sau `--` sau.
- *
- * Đưa vào **tham số** chứ không vào một biến môi trường kiểu `VSAF_INSTALL_FLAGS`, vì
- * mẫu `install.sh` ở §4.3 spec đã có `"$@"` ở cuối: người viết flow không phải thêm gì,
- * không phải nhớ bỏ dấu ngoặc kép để bash tách từ, và không phải nghĩ về chuỗi rỗng.
- * Mọi cờ ở đây đều là cờ `vsaf apply-pack` nhận, tức là đúng lệnh mà `"$@"` chảy vào.
- *
- * Cờ engine đứng trước cờ người dùng, để một cờ người dùng gõ tay là cờ thắng khi hai
- * bên nói khác nhau.
- */
-export declare function flowScriptArgs(flags: FlowScriptFlags, passthrough?: string[]): string[];
-export declare function flowScriptName(platform: NodeJS.Platform): string;
-export declare function flowScriptEnv(context: FlowScriptContext): Record<string, string>;
-/**
- * Script chưa hề chạy: thiếu file cài cho hệ điều hành này, thiếu bash, hoặc tiến trình
- * không spawn được.
- *
- * Có lớp riêng vì phía gọi phải phân biệt được. Khi script ĐÃ chạy rồi mới thoát khác 0,
- * nó có thể đã rải file và đã ghi sổ, nên engine vẫn phải đọc sổ và in danh sách vấn đề
- * của tự kiểm. Khi nó chưa chạy thì không có gì để đọc, và ba dòng chẩn đoán "flow không
- * ghi sổ, cần gọi apply-pack" ở đó là ba dòng chỉ sai hướng.
- */
-export declare class FlowScriptNotRunError extends Error {
-}
-export interface FlowScriptFailure {
-    status?: number | null;
-    /**
-     * Tín hiệu đã giết tiến trình, nếu có.
-     *
-     * Có mặt vì lượt tràn bộ đệm để lại `status: null` cùng `signal: 'SIGTERM'` — đo được
-     * kể cả khi script định thoát mã 3 ngay sau khi tràn. `code === 'ENOBUFS'` mới là thứ
-     * phép phân loại dựa vào, nhưng giữ trường này để hình dạng ở đây khớp hình dạng
-     * `spawnSync` thật sự trả về.
-     */
-    signal?: NodeJS.Signals;
-    code?: string;
-    message?: string;
-    stdout?: Buffer;
-    stderr?: Buffer;
-}
-/** Phần cuối của những gì script đã in, đủ để thấy nó chết ở đâu. */
-export declare function tailOfOutput(failure: FlowScriptFailure): string;
-/**
- * Câu báo cho từng kiểu hỏng của script — ba kiểu, ba câu khác nhau.
- *
- * Tách khỏi `runFlowScript` để khoá được bằng test mà không phải dựng lại đúng cảnh
- * hỏng: sinh 64 MB output chỉ để xem câu chữ có đúng không là cái giá không đáng trả.
- */
-export declare function describeFlowScriptFailure(flow: string, failure: FlowScriptFailure): string;
-export declare function runFlowScript(context: FlowScriptContext & {
-    flags: FlowScriptFlags;
-    passthrough: string[];
-}): void;
-//# sourceMappingURL=flow-script.d.ts.map

package/packages/cli/dist/commands/install/flow-script.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"flow-script.d.ts","sourceRoot":"","sources":["../../../src/commands/install/flow-script.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD;;;;;;;;;GASG;AAEH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAQ3F;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAEhE;AAyBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkChF;AAaD;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;CAAG;AAEnD,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqBD,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAU/D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CA8B1F;AAwBD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,GAAG;IAAE,KAAK,EAAE,eAAe,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAC7E,IAAI,CAgGN"}