@trungtamcongnghedigital/vsaf 1.4.2 → 1.4.3-rc.2

package/README.md

@@ -163,8 +163,11 @@ vsaf source list [--json]                     # List every declared source
 vsaf source remove kho                        # Drop one
 ```
 
-Declared in `~/.vsaf/sources.yaml`, a separate file next to `registry.yaml`. Read-only MCP tools
-`vsaf_source_path` and `vsaf_source_list` expose the same lookup to an agent.
+Declared in `~/.vsaf/sources.yaml`, a separate file next to `registry.yaml`.
+
+These CLI commands are unchanged: they print paths, for humans and scripts. Agents take a
+different road — the read-only MCP tool `vsaf_knowledge_query` returns **content** with citation
+labels and never a path. The two older path-returning tools were removed in this release.
 
 Full guide (Vietnamese): [docs/huong-dan-nguon-tren-may.md](docs/huong-dan-nguon-tren-may.md).
 

package/package.json

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

package/packages/cli/dist/commands/domains/domains.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Danh bạ domain của Master Knowledge: tên domain → các dự án của nó.
+ *
+ * File RIÊNG, KHÔNG trộn vào `registry.yaml`. Lý do không phải gọn gàng mà là một tai nạn
+ * đo được: `readRegistry()` duyệt MỌI khoá cấp 1 và đòi mỗi khoá có `repo:` TRƯỚC KHI tra
+ * tên người dùng vừa gõ — nên một khoá lạ nằm trong đó giết luôn `vsaf install NTAPP`,
+ * một flow không liên quan gì.
+ *
+ * Bài học rộng hơn "tách file ra": một bộ đọc kiểm mọi khoá sẽ giết những lệnh không liên
+ * quan khi gặp một khoá hỏng. Nên file này phải được đọc CHỈ trên đường của master — tách
+ * ra mà vẫn đọc trên đường cài chung thì chỉ DỜI cái bẫy sang chỗ mới.
+ *
+ * Engine sở hữu **cơ chế file**: đường dẫn, đọc, ghi, luật `from:`, báo cũ khi mất mạng.
+ * Nó cố ý KHÔNG biết "domain" nghĩa là gì — ý nghĩa nội dung là của master.
+ */
+/** Tên file. Nằm cạnh `registry.yaml` và `sources.yaml` trong thư mục nhà của vsaf. */
+export declare const DOMAINS_FILE = "domains.yaml";
+export interface DomainEntry {
+    /**
+     * Địa chỉ master đang quản mục này.
+     *
+     * CÓ dòng này = mục MÁY QUẢN: lượt đồng bộ sau ghi đè cả mục.
+     * KHÔNG có = người dùng tự giữ: máy không đụng, kể cả khi master khai domain cùng tên.
+     *
+     * Đây là công tắc duy nhất, và nó nằm trong tay người dùng: xoá một dòng là ghim.
+     */
+    from?: string;
+    /**
+     * Mốc đồng bộ THÀNH CÔNG gần nhất của CHÍNH mục này, dạng ISO-8601 UTC.
+     *
+     * Theo từng mục chứ không một mốc chung cho cả file: người dùng ghim một domain (xoá
+     * `from:`) thì mốc chung không còn nói đúng về domain đó, mà một mốc nói sai về một
+     * phần dữ liệu đúng là thứ cơ chế này sinh ra để tránh.
+     */
+    synced_at?: string;
+    /** Tên dự án → địa chỉ spec repo. Master ghi sẵn tên; engine KHÔNG suy lại lúc đọc. */
+    projects?: Record<string, string>;
+}
+/** Lỗi có MÃ THOÁT đi kèm — cùng giao kèo với `SourceError`. */
+export declare class DomainError extends Error {
+    readonly exitCode: number;
+    constructor(exitCode: number, message: string);
+}
+export declare const DOMAIN_EXIT: {
+    /** File cấu hình hỏng, hoặc tên domain sai hình dạng. */
+    readonly brokenFile: 6;
+    /**
+     * Gặp một ca trang yêu cầu KHÔNG nói tới.
+     *
+     * Nguyên tắc của dự án: ca nào tài liệu không nói thì MÁY DỪNG VÀ HỎI NGƯỜI, không tự
+     * quyết. Mã riêng để người gọi phân biệt "file hỏng" với "file đúng nhưng có một tình
+     * huống cần người xử".
+     */
+    readonly canNguoiXu: 7;
+};
+export declare function assertDomainName(name: string): void;
+export declare function domainsPath(): string;
+/**
+ * Toàn bộ danh bạ, theo đúng thứ tự người dùng viết.
+ *
+ * Chưa có file thì coi như RỖNG và KHÔNG tự tạo. Khác `readRegistry()` một cách có chủ ý:
+ * thiếu `registry.yaml` là bế tắc thật (không cài được flow nào), còn thiếu `domains.yaml`
+ * là trạng thái BÌNH THƯỜNG của máy chưa cài master bao giờ. Đọc theo nghĩa chặt "cùng
+ * luật với registry.yaml" thì lượt cài master ĐẦU TIÊN bất khả thi — một cách đọc tự loại
+ * mình bằng hệ quả của chính nó.
+ *
+ * File hỏng thì DỪNG, không trả map rỗng: người vừa khai mười domain mà nhận câu "chưa
+ * khai domain nào" sẽ đi sửa đúng chỗ không hỏng.
+ */
+export declare function readDomains(): Map<string, DomainEntry>;
+/** Mục này do máy quản (có `from:`) hay người dùng tự giữ? */
+export declare function mayQuan(entry: DomainEntry): boolean;
+export interface MocDongBo {
+    domain: string;
+    /** Mốc đồng bộ thành công gần nhất, hoặc `undefined` nếu chưa từng. */
+    syncedAt?: string;
+    /** Người dùng đã ghim mục này (xoá `from:`) — máy không đụng tới. */
+    nguoiGiu: boolean;
+}
+/**
+ * Mốc đồng bộ của từng domain, để BÁO RA khi dùng bản đã lưu.
+ *
+ * Trang yêu cầu nói: mất mạng thì "máy dùng bản danh bạ đã lưu lần trước **và báo bản đó
+ * cũ từ ngày nào**". Vế sau mới là phần người dùng cần — dùng bản cũ mà không nói thì
+ * người ta tưởng mình đang nhìn danh bạ hôm nay.
+ *
+ * Trả về theo TỪNG domain, không phải một mốc chung: xem lý do ở `DomainEntry.synced_at`.
+ */
+export declare function mocDongBo(entries: Map<string, DomainEntry>): MocDongBo[];
+/** Câu người dùng đọc khi máy phải dùng bản danh bạ đã lưu. */
+export declare function cauBaoCu(moc: MocDongBo[]): string;
+//# sourceMappingURL=domains.d.ts.map

package/packages/cli/dist/commands/domains/domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../../../src/commands/domains/domains.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;GAcG;AAEH,uFAAuF;AACvF,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,MAAM,WAAW,WAAW;IAC1B;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,gEAAgE;AAChE,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK9C;AAED,eAAO,MAAM,WAAW;IACtB,yDAAyD;;IAEzD;;;;;;OAMG;;CAEK,CAAC;AAkBX,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAYnD;AAED,wBAAgB,WAAW,IAAI,MAAM,CAMpC;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAuFtD;AAED,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEnD;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,SAAS,EAAE,CAMxE;AAED,+DAA+D;AAC/D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,MAAM,CAQjD"}

package/packages/cli/dist/commands/domains/domains.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOMAIN_EXIT = exports.DomainError = exports.DOMAINS_FILE = void 0;
+exports.assertDomainName = assertDomainName;
+exports.domainsPath = domainsPath;
+exports.readDomains = readDomains;
+exports.mayQuan = mayQuan;
+exports.mocDongBo = mocDongBo;
+exports.cauBaoCu = cauBaoCu;
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const js_yaml_1 = require("js-yaml");
+/**
+ * Danh bạ domain của Master Knowledge: tên domain → các dự án của nó.
+ *
+ * File RIÊNG, KHÔNG trộn vào `registry.yaml`. Lý do không phải gọn gàng mà là một tai nạn
+ * đo được: `readRegistry()` duyệt MỌI khoá cấp 1 và đòi mỗi khoá có `repo:` TRƯỚC KHI tra
+ * tên người dùng vừa gõ — nên một khoá lạ nằm trong đó giết luôn `vsaf install NTAPP`,
+ * một flow không liên quan gì.
+ *
+ * Bài học rộng hơn "tách file ra": một bộ đọc kiểm mọi khoá sẽ giết những lệnh không liên
+ * quan khi gặp một khoá hỏng. Nên file này phải được đọc CHỈ trên đường của master — tách
+ * ra mà vẫn đọc trên đường cài chung thì chỉ DỜI cái bẫy sang chỗ mới.
+ *
+ * Engine sở hữu **cơ chế file**: đường dẫn, đọc, ghi, luật `from:`, báo cũ khi mất mạng.
+ * Nó cố ý KHÔNG biết "domain" nghĩa là gì — ý nghĩa nội dung là của master.
+ */
+/** Tên file. Nằm cạnh `registry.yaml` và `sources.yaml` trong thư mục nhà của vsaf. */
+exports.DOMAINS_FILE = 'domains.yaml';
+/** Lỗi có MÃ THOÁT đi kèm — cùng giao kèo với `SourceError`. */
+class DomainError extends Error {
+    exitCode;
+    constructor(exitCode, message) {
+        super(message);
+        this.name = 'DomainError';
+        this.exitCode = exitCode;
+    }
+}
+exports.DomainError = DomainError;
+exports.DOMAIN_EXIT = {
+    /** File cấu hình hỏng, hoặc tên domain sai hình dạng. */
+    brokenFile: 6,
+    /**
+     * Gặp một ca trang yêu cầu KHÔNG nói tới.
+     *
+     * Nguyên tắc của dự án: ca nào tài liệu không nói thì MÁY DỪNG VÀ HỎI NGƯỜI, không tự
+     * quyết. Mã riêng để người gọi phân biệt "file hỏng" với "file đúng nhưng có một tình
+     * huống cần người xử".
+     */
+    canNguoiXu: 7,
+};
+/**
+ * Tên domain hợp lệ.
+ *
+ * Cấm `://`, `@`, dấu phẩy và khoảng trắng KHÔNG phải để cho đẹp. Luật phân biệt hai dạng
+ * của `--clone` chỉ đứng được nhờ nó: `--clone <giá-trị>` đọc ra LINK REPO khi thấy `://`
+ * hoặc `@…:`, đọc ra TÊN DOMAIN với mọi thứ còn lại. Cho phép `@` trong tên domain là phá
+ * phép phân biệt đó ở một chỗ khác hẳn trong mã, và lỗi hiện ra dưới dạng
+ * "`--clone payment@v2` tự nhiên đi tải một repo".
+ *
+ * Ai nới luật này thì BẮT BUỘC sửa phép phân biệt `--clone` cùng lượt. Chúng là một cặp.
+ *
+ * `/` và `\` và `..` bị chặn thêm một lý do nữa: tên domain đi vào đường dẫn thư mục, nên
+ * một tên mang dấu phân cách là một đường trỏ ra ngoài chỗ nó được phép ghi.
+ */
+const DOMAIN_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+function assertDomainName(name) {
+    // `..` phải chặn RIÊNG: mẫu trên cho phép `.` (để đặt được `v2.core`), nên `a..b` lọt
+    // qua mẫu. Chú thích nói chặn mà mẫu không chặn là đúng loại lỗi khó thấy nhất — chính
+    // test của luật này bắt được nó.
+    if (name.includes('..') || !DOMAIN_PATTERN.test(name)) {
+        throw new DomainError(exports.DOMAIN_EXIT.brokenFile, `Tên domain không hợp lệ: "${name}"\n`
+            + '  Tên bắt đầu bằng chữ hoặc số, rồi chỉ gồm chữ, số và . _ -\n'
+            + '  Không chứa "://", "@", dấu phẩy, khoảng trắng, "/" hay "..".');
+    }
+}
+function domainsPath() {
+    // `||` chứ không phải `??`, cùng lý do với `registryPath` và `sourcesPath`:
+    // `VSAF_HOME=""` vẫn phải rơi về mặc định, nếu không đường dẫn thành tương đối so với
+    // thư mục hiện hành.
+    const home = process.env.VSAF_HOME || (0, path_1.join)((0, os_1.homedir)(), '.vsaf');
+    return (0, path_1.join)(home, exports.DOMAINS_FILE);
+}
+/** Số dòng (đếm từ 1) của dòng khai một khoá, hoặc 0 nếu không tìm ra. */
+function lineOfKey(text, key) {
+    const lines = text.split('\n');
+    const escaped = key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    for (let i = 0; i < lines.length; i += 1) {
+        if (new RegExp(`^["']?${escaped}["']?\\s*:`).test(lines[i]))
+            return i + 1;
+    }
+    return 0;
+}
+/** Một trường tuỳ chọn: chuỗi rỗng cũng là bỏ trống, không phải một giá trị. */
+function textOrNothing(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const text = value.trim();
+    return text === '' ? undefined : text;
+}
+/**
+ * Toàn bộ danh bạ, theo đúng thứ tự người dùng viết.
+ *
+ * Chưa có file thì coi như RỖNG và KHÔNG tự tạo. Khác `readRegistry()` một cách có chủ ý:
+ * thiếu `registry.yaml` là bế tắc thật (không cài được flow nào), còn thiếu `domains.yaml`
+ * là trạng thái BÌNH THƯỜNG của máy chưa cài master bao giờ. Đọc theo nghĩa chặt "cùng
+ * luật với registry.yaml" thì lượt cài master ĐẦU TIÊN bất khả thi — một cách đọc tự loại
+ * mình bằng hệ quả của chính nó.
+ *
+ * File hỏng thì DỪNG, không trả map rỗng: người vừa khai mười domain mà nhận câu "chưa
+ * khai domain nào" sẽ đi sửa đúng chỗ không hỏng.
+ */
+function readDomains() {
+    const path = domainsPath();
+    if (!(0, fs_1.existsSync)(path))
+        return new Map();
+    const text = (0, fs_1.readFileSync)(path, 'utf-8');
+    let parsed;
+    try {
+        parsed = (0, js_yaml_1.load)(text);
+    }
+    catch (error) {
+        const nguyenVan = error.message;
+        if (/duplicated mapping key/i.test(nguyenVan)) {
+            // Trang yêu cầu không nói ca này. Theo nguyên tắc: máy BÁO NGƯỜI, không tự chọn
+            // mục nào thắng — hai mục cho cùng một domain là một mâu thuẫn, không phải một
+            // lựa chọn, và đoán hộ ở đây là lặng lẽ bỏ đi một nửa danh bạ.
+            throw new DomainError(exports.DOMAIN_EXIT.canNguoiXu, `${path} khai hai lần cùng một domain.\n`
+                + `  ${nguyenVan.split('\n')[0]}\n`
+                + '  Máy không tự chọn mục nào thắng. Mở file trên, xoá bớt một mục rồi chạy lại.');
+        }
+        throw new DomainError(exports.DOMAIN_EXIT.brokenFile, `Không đọc được ${path}:\n  ${nguyenVan}`);
+    }
+    // File rỗng cho ra `null`, và đó là một file hợp lệ: chưa khai domain nào.
+    if (parsed === null || parsed === undefined)
+        return new Map();
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new DomainError(exports.DOMAIN_EXIT.brokenFile, `${path} phải là danh sách tên domain → mục, không phải ${Array.isArray(parsed) ? 'một dãy' : typeof parsed}.\n`
+            + '  Một dãy thì tra theo TÊN phải quét tuần tự, và không có gì chặn hai mục trùng tên.');
+    }
+    const entries = new Map();
+    for (const [name, value] of Object.entries(parsed)) {
+        assertDomainName(name);
+        const dong = lineOfKey(text, name);
+        const tai = `${path}${dong > 0 ? `, dòng ${dong}` : ''}`;
+        const entry = (value ?? {});
+        const from = textOrNothing(entry.from);
+        const syncedAt = textOrNothing(entry.synced_at);
+        let projects;
+        if (entry.projects !== undefined && entry.projects !== null) {
+            if (typeof entry.projects !== 'object' || Array.isArray(entry.projects)) {
+                throw new DomainError(exports.DOMAIN_EXIT.brokenFile, `Domain "${name}" (${tai}) khai "projects" không phải danh sách tên → địa chỉ.`);
+            }
+            projects = {};
+            const thay = new Map();
+            for (const [tenDuAn, diaChi] of Object.entries(entry.projects)) {
+                const url = textOrNothing(diaChi);
+                if (url === undefined) {
+                    throw new DomainError(exports.DOMAIN_EXIT.brokenFile, `Dự án "${tenDuAn}" của domain "${name}" (${tai}) không khai địa chỉ.`);
+                }
+                // So theo tên ĐÃ CẮT khoảng trắng. YAML coi `a-spec` và `a-spec ` là hai khoá
+                // khác nhau, nhưng người đọc thì không phân biệt được — và hai mục trông giống
+                // hệt nhau trong danh bạ là đúng lớp lỗi ta đang tránh. Cắt để SO, giữ nguyên
+                // chữ người dùng viết để NÓI trong câu lỗi.
+                const khoa = tenDuAn.trim();
+                const daCo = thay.get(khoa);
+                if (daCo !== undefined) {
+                    throw new DomainError(exports.DOMAIN_EXIT.canNguoiXu, `Domain "${name}" (${tai}) có hai dự án cùng tên "${khoa}":\n`
+                        + `    ${daCo}\n    ${url}\n`
+                        + '  Máy không tự đổi tên và không tự ghi đè. Admin đặt tên khác cho một trong hai.');
+                }
+                thay.set(khoa, url);
+                projects[khoa] = url;
+            }
+        }
+        // Khoá lạ bỏ qua: một file viết cho bản sau vẫn phải đọc được bằng bản này.
+        entries.set(name, { from, synced_at: syncedAt, projects });
+    }
+    return entries;
+}
+/** Mục này do máy quản (có `from:`) hay người dùng tự giữ? */
+function mayQuan(entry) {
+    return entry.from !== undefined;
+}
+/**
+ * Mốc đồng bộ của từng domain, để BÁO RA khi dùng bản đã lưu.
+ *
+ * Trang yêu cầu nói: mất mạng thì "máy dùng bản danh bạ đã lưu lần trước **và báo bản đó
+ * cũ từ ngày nào**". Vế sau mới là phần người dùng cần — dùng bản cũ mà không nói thì
+ * người ta tưởng mình đang nhìn danh bạ hôm nay.
+ *
+ * Trả về theo TỪNG domain, không phải một mốc chung: xem lý do ở `DomainEntry.synced_at`.
+ */
+function mocDongBo(entries) {
+    return [...entries.entries()].map(([domain, entry]) => ({
+        domain,
+        syncedAt: mayQuan(entry) ? entry.synced_at : undefined,
+        nguoiGiu: !mayQuan(entry),
+    }));
+}
+/** Câu người dùng đọc khi máy phải dùng bản danh bạ đã lưu. */
+function cauBaoCu(moc) {
+    if (moc.length === 0)
+        return 'Chưa có danh bạ domain nào trên máy này.';
+    const dong = moc.map(m => {
+        if (m.nguoiGiu)
+            return `  ${m.domain} — bạn tự giữ (không có dòng "from:"), máy không cập nhật`;
+        if (m.syncedAt === undefined)
+            return `  ${m.domain} — chưa đồng bộ lần nào`;
+        return `  ${m.domain} — bản lưu từ ${m.syncedAt}`;
+    });
+    return `Đang dùng danh bạ đã lưu trên máy:\n${dong.join('\n')}`;
+}
+//# sourceMappingURL=domains.js.map

package/packages/cli/dist/commands/domains/domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../../src/commands/domains/domains.ts"],"names":[],"mappings":"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"}

package/packages/cli/dist/commands/domains/sync.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Ghi danh bạ domain theo thứ master khai.
+ *
+ * Engine KHÔNG đọc `federation.yaml` và không biết nó có hình gì — flow trích rồi đưa
+ * vào một JSON phẳng. Ranh giới ấy do nhóm chốt: engine sở hữu **cơ chế file**, flow sở
+ * hữu **ý nghĩa nội dung**. Giữ nó thì flow đổi cấu trúc `federation.yaml` lúc nào cũng
+ * được mà không phải chờ engine ra bản mới.
+ */
+/** Thứ master khai, sau khi flow đã trích. Chỉ hai trường; engine không cần gì hơn. */
+export interface DomainTuMaster {
+    projects?: Record<string, string>;
+}
+export interface KetQuaGhi {
+    /** Domain mới, chưa có trên máy. */
+    them: string[];
+    /** Domain máy quản, đã ghi đè theo bản master. */
+    capNhat: string[];
+    /** Domain người dùng đã ghim (không có `from:`) — KHÔNG đụng. */
+    nguoiGiu: string[];
+    /**
+     * Domain máy quản mà master KHÔNG còn khai.
+     *
+     * Trang yêu cầu không nói một chữ nào về ca này, nên theo nguyên tắc của dự án: máy
+     * BÁO NGƯỜI, không tự xử. Không xoá, không đánh dấu, không gỡ `from:`.
+     */
+    canNguoiXu: string[];
+}
+/**
+ * Trộn bản master vào danh bạ trên máy.
+ *
+ * Năm cảnh, và cảnh thứ năm là cảnh trang yêu cầu không nói — máy báo người.
+ */
+export declare function tronDanhBa(tuMaster: Map<string, DomainTuMaster>, from: string, luc: string): KetQuaGhi;
+/** Đọc JSON từ stdin. Flow trích `federation.yaml` rồi đẩy vào đây. */
+export declare function docTuStdin(raw: string): Map<string, DomainTuMaster>;
+export interface KetQuaLenh {
+    code: number;
+    out: string[];
+    err: string[];
+}
+/**
+ * `vsaf domains sync --from <url>` — đọc JSON ở stdin, trộn vào danh bạ.
+ *
+ * Mọi lượt `vsaf install MASTER` đều gọi lệnh này, bất kể cờ nào: `--new`, `--clone`,
+ * `--update`. Trang yêu cầu nói danh bạ *"tự cập nhật, không cần link"*, mà không có lịch
+ * chạy định kỳ ở đợt này — nên lượt cài là chỗ duy nhất nó được làm mới.
+ *
+ * `--update` KHÁC `--clone` ở chỗ tải về máy, KHÔNG ở chỗ danh bạ: cả hai đều làm mới đủ
+ * mọi tên domain, chỉ `--clone` mới tải thêm domain mới về.
+ */
+export declare function syncCommand(stdin: string, from: string, luc?: string): KetQuaLenh;
+//# sourceMappingURL=sync.d.ts.map

package/packages/cli/dist/commands/domains/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/commands/domains/sync.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AAEH,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,kDAAkD;IAClD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAoDD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACrC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,SAAS,CAoDX;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAwCnE;AAED,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE;AAE1E;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,UAAU,CA6BjF"}

package/packages/cli/dist/commands/domains/sync.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tronDanhBa = tronDanhBa;
+exports.docTuStdin = docTuStdin;
+exports.syncCommand = syncCommand;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const domains_js_1 = require("./domains.js");
+/** Khối YAML của một mục máy quản. Chỉ sinh cho mục máy quản — mục ghim không đi qua đây. */
+function khoiYaml(ten, from, syncedAt, muc) {
+    const dong = [`${ten}:`, `  from: ${from}`, `  synced_at: "${syncedAt}"`];
+    const duAn = Object.entries(muc.projects ?? {});
+    if (duAn.length > 0) {
+        dong.push('  projects:');
+        for (const [tenDuAn, url] of duAn)
+            dong.push(`    ${tenDuAn}: ${url}`);
+    }
+    return dong.join('\n');
+}
+/**
+ * Dải dòng (bắt đầu, kết thúc — nửa mở) của từng khoá cấp 1 trong file.
+ *
+ * Làm trên VĂN BẢN chứ không dựng lại file từ dữ liệu đã đọc, vì `D4` đòi mục người dùng
+ * ghim phải còn nguyên **từng ký tự**: chú thích họ tự viết, thứ tự họ tự sắp, khoảng
+ * trắng họ tự để. Dựng lại từ dữ liệu là mất hết những thứ đó trong một lượt mà họ không
+ * hề yêu cầu.
+ */
+function daiCuaKhoa(text) {
+    const dong = text.split('\n');
+    const dai = new Map();
+    let dangMo;
+    /**
+     * Dòng trống và dòng chú thích NGAY TRƯỚC một khoá thuộc về khoá ĐÓ, không thuộc khoá
+     * phía trên.
+     *
+     * Bỏ qua chuyện này là lỗi đo được: ghi đè `payment` nuốt luôn dòng trống và dòng
+     * `# tôi trỏ sang bản nội bộ vì mạng công ty chặn` của `lending` nằm bên dưới — tức
+     * xoá đúng câu giải thích VÌ SAO người dùng ghim mục đó. Mục ghim thì còn, lý do ghim
+     * thì mất, và không ai được báo.
+     */
+    const luiVeCuoiThat = (den) => {
+        let i = den;
+        while (i > 0 && (dong[i - 1].trim() === '' || dong[i - 1].trimStart().startsWith('#')))
+            i -= 1;
+        return i;
+    };
+    for (let i = 0; i < dong.length; i += 1) {
+        const khop = /^(["']?)([^\s:#][^:]*?)\1\s*:/.exec(dong[i]);
+        if (khop) {
+            if (dangMo)
+                dai.set(dangMo.ten, { dau: dangMo.dau, cuoi: luiVeCuoiThat(i) });
+            dangMo = { ten: khop[2], dau: i };
+        }
+    }
+    if (dangMo)
+        dai.set(dangMo.ten, { dau: dangMo.dau, cuoi: luiVeCuoiThat(dong.length) });
+    return dai;
+}
+/**
+ * Trộn bản master vào danh bạ trên máy.
+ *
+ * Năm cảnh, và cảnh thứ năm là cảnh trang yêu cầu không nói — máy báo người.
+ */
+function tronDanhBa(tuMaster, from, luc) {
+    for (const ten of tuMaster.keys())
+        (0, domains_js_1.assertDomainName)(ten);
+    const daCo = (0, domains_js_1.readDomains)();
+    const path = (0, domains_js_1.domainsPath)();
+    const text = (0, fs_1.existsSync)(path) ? (0, fs_1.readFileSync)(path, 'utf-8') : '';
+    const dai = daiCuaKhoa(text);
+    const dong = text === '' ? [] : text.split('\n');
+    const ra = { them: [], capNhat: [], nguoiGiu: [], canNguoiXu: [] };
+    // Thay tại chỗ: gom việc rồi áp từ DƯỚI LÊN, để số dòng của việc chưa áp không trôi.
+    const thayTaiCho = [];
+    for (const [ten, muc] of tuMaster) {
+        const cu = daCo.get(ten);
+        if (cu === undefined) {
+            ra.them.push(ten);
+            continue;
+        }
+        if (!(0, domains_js_1.mayQuan)(cu)) {
+            // Người dùng đã ghim bằng cách xoá dòng `from:`. Không đụng — đây là công tắc duy
+            // nhất họ có, và nó chỉ có nghĩa nếu máy thật sự tôn trọng nó.
+            ra.nguoiGiu.push(ten);
+            continue;
+        }
+        const vt = dai.get(ten);
+        if (vt) {
+            thayTaiCho.push({ dau: vt.dau, cuoi: vt.cuoi, moi: khoiYaml(ten, from, luc, muc).split('\n') });
+            ra.capNhat.push(ten);
+        }
+    }
+    // Mục máy quản mà master không còn khai: BÁO, không xử.
+    for (const [ten, muc] of daCo) {
+        if (!tuMaster.has(ten) && (0, domains_js_1.mayQuan)(muc))
+            ra.canNguoiXu.push(ten);
+    }
+    thayTaiCho.sort((a, b) => b.dau - a.dau);
+    for (const v of thayTaiCho)
+        dong.splice(v.dau, v.cuoi - v.dau, ...v.moi);
+    const themMoi = ra.them.map(ten => khoiYaml(ten, from, luc, tuMaster.get(ten)));
+    if (themMoi.length > 0) {
+        if (dong.length > 0 && dong[dong.length - 1].trim() !== '')
+            dong.push('');
+        for (const khoi of themMoi) {
+            dong.push(khoi);
+            dong.push('');
+        }
+    }
+    if (thayTaiCho.length > 0 || themMoi.length > 0) {
+        (0, fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true });
+        (0, fs_1.writeFileSync)(path, `${dong.join('\n').replace(/\n*$/, '')}\n`);
+    }
+    return ra;
+}
+/** Đọc JSON từ stdin. Flow trích `federation.yaml` rồi đẩy vào đây. */
+function docTuStdin(raw) {
+    const text = raw.trim();
+    if (text === '') {
+        throw new domains_js_1.DomainError(domains_js_1.DOMAIN_EXIT.brokenFile, 'Không nhận được gì ở stdin.\n'
+            + '  Đưa vào một JSON dạng {"<domain>": {"projects": {"<tên>": "<địa chỉ>"}}}\n'
+            + '  Ví dụ:  echo \'{"payment":{"projects":{}}}\' | vsaf domains sync --from <url>');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (error) {
+        throw new domains_js_1.DomainError(domains_js_1.DOMAIN_EXIT.brokenFile, `stdin không phải JSON hợp lệ:\n  ${error.message}`);
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new domains_js_1.DomainError(domains_js_1.DOMAIN_EXIT.brokenFile, 'stdin phải là một đối tượng JSON: tên domain → mục.');
+    }
+    const ra = new Map();
+    for (const [ten, giaTri] of Object.entries(parsed)) {
+        const muc = (giaTri ?? {});
+        let projects;
+        if (muc.projects !== undefined && muc.projects !== null) {
+            if (typeof muc.projects !== 'object' || Array.isArray(muc.projects)) {
+                throw new domains_js_1.DomainError(domains_js_1.DOMAIN_EXIT.brokenFile, `Domain "${ten}": "projects" phải là tên → địa chỉ.`);
+            }
+            projects = {};
+            for (const [k, v] of Object.entries(muc.projects)) {
+                if (typeof v !== 'string' || v.trim() === '') {
+                    throw new domains_js_1.DomainError(domains_js_1.DOMAIN_EXIT.brokenFile, `Dự án "${k}" của domain "${ten}" không có địa chỉ.`);
+                }
+                projects[k.trim()] = v.trim();
+            }
+        }
+        ra.set(ten, { projects });
+    }
+    return ra;
+}
+/**
+ * `vsaf domains sync --from <url>` — đọc JSON ở stdin, trộn vào danh bạ.
+ *
+ * Mọi lượt `vsaf install MASTER` đều gọi lệnh này, bất kể cờ nào: `--new`, `--clone`,
+ * `--update`. Trang yêu cầu nói danh bạ *"tự cập nhật, không cần link"*, mà không có lịch
+ * chạy định kỳ ở đợt này — nên lượt cài là chỗ duy nhất nó được làm mới.
+ *
+ * `--update` KHÁC `--clone` ở chỗ tải về máy, KHÔNG ở chỗ danh bạ: cả hai đều làm mới đủ
+ * mọi tên domain, chỉ `--clone` mới tải thêm domain mới về.
+ */
+function syncCommand(stdin, from, luc) {
+    const out = [];
+    const err = [];
+    try {
+        if (from.trim() === '') {
+            throw new domains_js_1.DomainError(domains_js_1.DOMAIN_EXIT.brokenFile, 'Thiếu --from <địa-chỉ-master>: không biết mục nào do master nào quản.');
+        }
+        const tuMaster = docTuStdin(stdin);
+        const kq = tronDanhBa(tuMaster, from.trim(), luc ?? new Date().toISOString().replace(/\.\d{3}Z$/, 'Z'));
+        if (kq.them.length > 0)
+            out.push(`Thêm: ${kq.them.join(', ')}`);
+        if (kq.capNhat.length > 0)
+            out.push(`Cập nhật: ${kq.capNhat.join(', ')}`);
+        for (const ten of kq.nguoiGiu) {
+            out.push(`Bỏ qua "${ten}" — bạn tự giữ (mục không có dòng "from:"). Máy không đụng tới.`);
+        }
+        if (kq.canNguoiXu.length > 0) {
+            err.push(`Master không còn khai ${kq.canNguoiXu.length} domain đang có trên máy: ${kq.canNguoiXu.join(', ')}`);
+            err.push(`  Máy KHÔNG tự xoá và KHÔNG tự đánh dấu — trang yêu cầu không nói ca này.`);
+            err.push(`  Bạn quyết: giữ thì xoá dòng "from:" của mục đó, bỏ thì xoá cả mục.`);
+            err.push(`  Sửa tại: ${(0, domains_js_1.domainsPath)()}`);
+            return { code: domains_js_1.DOMAIN_EXIT.canNguoiXu, out, err };
+        }
+        if (out.length === 0)
+            out.push('Danh bạ không đổi.');
+        return { code: 0, out, err };
+    }
+    catch (error) {
+        if (error instanceof domains_js_1.DomainError)
+            return { code: error.exitCode, out, err: [error.message] };
+        throw error;
+    }
+}
+//# sourceMappingURL=sync.js.map

package/packages/cli/dist/commands/domains/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../src/commands/domains/sync.ts"],"names":[],"mappings":"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"}

package/packages/cli/dist/commands/install.d.ts

@@ -99,7 +99,7 @@ export interface InstallResult {
  * không ai đặt chúng nữa — đường duy nhất còn lại là file kế hoạch mà `apply-pack` đọc,
  * và hiện chưa có bên nào ghi file đó.
  *
- * Giữ lại chứ không xoá vì chúng là đầu vào của phần nối dây đa repo, và Sáng chốt là
+ * Giữ lại chứ không xoá vì chúng là đầu vào của phần nối dây đa repo, và chủ dự án chốt là
  * phần đó **chuyển sang `install.sh` của flow, sửa sau** — chứ không phải bỏ. Xoá bây
  * giờ là ném đi thứ sắp được gọi lại từ chỗ khác. Ai đọc tới đây mà `install.sh` đã có
  * cách tự khai: nối nó vào đây, đừng dựng lại cờ ở engine.

package/packages/cli/dist/commands/source/knowledge-okf.d.ts

@@ -0,0 +1,9 @@
+import { SearchHit } from './knowledge-types.js';
+/** Tìm thư mục `.okf` trong kho. Trả chuỗi rỗng nếu không có. */
+export declare function thuMucOkf(goc: string, ghiChu?: string[]): string;
+export declare function coOkf(goc: string): boolean;
+export declare function timTrenOkf(goc: string, query: string, tenNguon: string): {
+    hits: SearchHit[];
+    note: string;
+};
+//# sourceMappingURL=knowledge-okf.d.ts.map

package/packages/cli/dist/commands/source/knowledge-okf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-okf.d.ts","sourceRoot":"","sources":["../../../src/commands/source/knowledge-okf.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AA0BjD,iEAAiE;AACjE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,EAAO,GAAG,MAAM,CAWpE;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1C;AAcD,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA8BrC"}