mn-ws 0.0.0-stage → 0.2.0

package/dist/core/skills/index.js

@@ -0,0 +1,268 @@
+// 随包 skill 的发现、分组、安装与导出。
+//
+// 与 templates/ 的关系：templates 是「生成器要物化的项目模板」；
+// assets/ 是「随 nx-nx 包分发给 agent 的 skill 文档」。两者都是包内资产，互不依赖。
+//
+// 多 skill 约定（见脚手架 B04）：
+//   - 主 skill 名 = package.json.name（nx-nx），默认 install 装它
+//   - groups.json 是便捷聚合而非第二事实源；缺失/损坏时降级为目录扫描
+import fsp from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { badInput, blocked, notFound, specError } from '../errors/index.js';
+import { assertSafeName } from '../paths.js';
+import { asAbsolutePath } from '../brand.js';
+import { hasInstallHooks, runPreInstall, runPostInstall, diffRendered, copyRendered, } from './install.js';
+import { emit, loadHookConfig } from './bus.js';
+const HERE = dirname(fileURLToPath(import.meta.url));
+export function assetsDir() {
+    // MN_WS_ASSETS 为测试/隔离入口（调用时读取）：指向临时资产树以验证降级路径
+    const override = process.env.MN_WS_ASSETS;
+    const candidates = [
+        ...(override ? [override] : []),
+        join(HERE, '..', '..', '..', 'assets'),
+        join(process.cwd(), 'assets'),
+    ];
+    for (const dir of candidates) {
+        if (existsSync(dir))
+            return asAbsolutePath(dir);
+    }
+    throw specError('找不到 assets/ 目录（尝试过: ' + candidates.join(', ') + ')');
+}
+export const defaultSkillsDir = () => asAbsolutePath(join(process.env.HOME || process.env.USERPROFILE || '', '.claude', 'skills'));
+// 读 groups.json；文件缺失或 JSON 损坏 → 降级为目录扫描（每个含 SKILL.md 的
+// 目录自成一个 group）。schema 错误不降级——那是作者打包事故，必须显眼。
+export async function loadGroups() {
+    const root = assetsDir();
+    const file = join(root, 'groups.json');
+    if (!existsSync(file)) {
+        return { groups: await scanGroups(root), defaultGroup: null, source: 'assets-dirs' };
+    }
+    let raw;
+    try {
+        raw = await fsp.readFile(file, 'utf8');
+    }
+    catch {
+        return { groups: await scanGroups(root), defaultGroup: null, source: 'assets-dirs' };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return {
+            groups: await scanGroups(root),
+            defaultGroup: null,
+            source: 'assets-dirs',
+            warning: 'groups.json 不是合法 JSON，已降级为目录扫描',
+        };
+    }
+    const groups = parsed.groups;
+    if (!groups || typeof groups !== 'object') {
+        throw specError('groups.json schema 错误：缺少 groups 对象');
+    }
+    for (const [key, g] of Object.entries(groups)) {
+        if (!g || !Array.isArray(g.skills) || !g.skills.length) {
+            throw specError(`groups.json 的 group "${key}" 缺少非空 skills 数组`);
+        }
+        for (const s of g.skills) {
+            if (typeof s !== 'string' || !/^[\w.-]+$/.test(s)) {
+                throw specError(`groups.json 的 group "${key}" 含非法 skill 名: ${String(s)}`);
+            }
+        }
+    }
+    return { groups, defaultGroup: 'mn-ws' in groups ? 'mn-ws' : null, source: 'manifest' };
+}
+async function scanGroups(root) {
+    const out = {};
+    let entries;
+    try {
+        entries = await fsp.readdir(root, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const e of entries) {
+        if (e.isDirectory() && existsSync(join(root, e.name, 'SKILL.md'))) {
+            out[e.name] = { skills: [e.name] };
+        }
+    }
+    return out;
+}
+export async function bundledSkillNames() {
+    const root = assetsDir();
+    try {
+        const entries = await fsp.readdir(root, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isDirectory() && existsSync(join(root, e.name, 'SKILL.md')))
+            .map((e) => e.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+// 无副作用地查看某个 skill 的安装状态：目标是否存在、有哪些差异文件。
+// installOne 与 installGroup 的预检共用它——预检绝不能边查边装。
+export async function inspectInstall(name, toRoot) {
+    const safe = assertSafeName(name, 'skill 名');
+    const src = join(assetsDir(), safe);
+    if (!existsSync(join(src, 'SKILL.md'))) {
+        const available = await bundledSkillNames();
+        throw notFound(`未找到内置 skill: ${safe}（可用: ${available || '(无)'}）`);
+    }
+    const dst = join(toRoot || defaultSkillsDir(), safe);
+    const changed = await diffTrees(src, dst);
+    return { name: safe, path: dst, changed, dstExisted: existsSync(dst) };
+}
+// 安装单个 skill。
+//   无安装钩子：字节级 diff → skipped / conflict / 整树复制（旧路径）
+//   有安装钩子：preInstall（抛错 = 拒绝安装；返回 vars = 动态字符串）→
+//     渲染后 diff → skipped / conflict → 渲染复制 → postInstall
+// 无差异时即使给了 force 也返回 skipped（没有要做的事）。
+export async function installOne(name, opts = {}) {
+    const safe = assertSafeName(name, 'skill 名');
+    const src = join(assetsDir(), safe);
+    if (!existsSync(join(src, 'SKILL.md'))) {
+        const available = await bundledSkillNames();
+        throw notFound(`未找到内置 skill: ${safe}（可用: ${available || '(无)'}）`);
+    }
+    const skillsRoot = opts.to || defaultSkillsDir();
+    const dst = join(skillsRoot, safe);
+    if (!hasInstallHooks(safe)) {
+        const changed = await diffTrees(src, dst);
+        if (!changed.length)
+            return { status: 'skipped', name: safe, path: dst, files: 0 };
+        const dstExisted = existsSync(dst);
+        if (dstExisted && !opts.force) {
+            return { status: 'conflict', name: safe, path: dst, files: changed.length };
+        }
+        if (dstExisted)
+            await fsp.rm(dst, { recursive: true, force: true });
+        await fsp.cp(src, dst, { recursive: true, dereference: true, force: true });
+        return {
+            status: 'ok',
+            name: safe,
+            path: dst,
+            files: changed.length,
+            installed: !dstExisted,
+            replaced: dstExisted,
+        };
+    }
+    const { config, vars } = await runPreInstall(safe, {
+        skillsRoot,
+        dst,
+        force: !!opts.force,
+    });
+    const changed = await diffRendered(src, dst, vars);
+    if (!changed.length)
+        return { status: 'skipped', name: safe, path: dst, files: 0 };
+    const dstExisted = existsSync(dst);
+    if (dstExisted && !opts.force) {
+        return { status: 'conflict', name: safe, path: dst, files: changed.length };
+    }
+    if (dstExisted)
+        await fsp.rm(dst, { recursive: true, force: true });
+    const files = await copyRendered(src, dst, vars);
+    await runPostInstall(safe, { skillsRoot, dst, force: !!opts.force }, config, vars);
+    return {
+        status: 'ok',
+        name: safe,
+        path: dst,
+        files,
+        installed: !dstExisted,
+        replaced: dstExisted,
+    };
+}
+// 一键装一组。任一冲突 → 整体 conflict 且不落任何文件（让用户决策后 --force 整组重来）。
+export async function installGroup(group, opts = {}) {
+    const key = String(group || '').trim();
+    const manifest = await loadGroups();
+    const spec = manifest.groups[key];
+    if (!spec) {
+        throw badInput(`未知 group: ${key}（可用: ${Object.keys(manifest.groups).join(', ')}）`);
+    }
+    return installNames([...new Set(spec.skills)], key, opts);
+}
+// 一键装全部内置 skill（--all）。事实源是 assets/ 目录扫描，与 groups.json 无关——
+// 即使清单漏登记某个 skill，--all 也不会漏掉它。
+export async function installAll(opts = {}) {
+    const names = await bundledSkillNames();
+    if (!names.length)
+        throw specError('assets/ 内没有可安装的 skill（找不到任何 SKILL.md）');
+    return installNames(names, '*', opts);
+}
+// 批量安装共用实现：无副作用预检 → 任一冲突整体不落文件 → 逐项安装。
+// label 为 group key；'*' 表示 --all（渲染时据此换措辞）。
+async function installNames(names, label, opts) {
+    // 无副作用预检：任一项「已存在且有差异」→ 整体 conflict，不落任何文件。
+    // 有安装钩子的 skill：先跑 preInstall 取 vars（pre 抛错 = 整批拒绝），
+    // 再按渲染结果比较；无钩子走字节 diff。
+    if (!opts.force) {
+        const conflicts = [];
+        for (const n of names) {
+            const targetDir = join(opts.to || defaultSkillsDir(), n);
+            let changed;
+            if (hasInstallHooks(n)) {
+                const srcN = join(assetsDir(), n);
+                const cfg = await loadHookConfig(srcN);
+                const pre = await emit('skill:pre-install', n, cfg, {
+                    cwd: process.cwd(),
+                    skillsDir: opts.to || defaultSkillsDir(),
+                    sourceDir: srcN,
+                    targetDir,
+                    force: false,
+                    vars: {},
+                });
+                if (pre.blocked)
+                    throw blocked(pre.reason || '安装被 hook 阻断');
+                changed = await diffRendered(srcN, targetDir, pre.vars);
+            }
+            else {
+                changed = (await inspectInstall(n, opts.to)).changed;
+            }
+            if (existsSync(targetDir) && changed.length) {
+                conflicts.push({ status: 'conflict', name: n, path: targetDir, files: changed.length });
+            }
+        }
+        if (conflicts.length)
+            return { status: 'conflict', group: label, skills: conflicts };
+    }
+    const skills = [];
+    for (const n of names)
+        skills.push(await installOne(n, { to: opts.to, force: opts.force }));
+    return { status: 'ok', group: label, skills };
+}
+// 对比两棵树，返回内容不同的相对路径（安装器据此判断跳过 / 冲突 / 覆盖）。
+async function diffTrees(src, dst, rel = '') {
+    const changed = [];
+    let entries;
+    try {
+        entries = await fsp.readdir(src, { withFileTypes: true });
+    }
+    catch {
+        return changed;
+    }
+    for (const e of entries) {
+        const s = join(src, e.name);
+        const d = join(dst, e.name);
+        if (e.isDirectory()) {
+            changed.push(...(await diffTrees(s, d, rel ? rel + '/' + e.name : e.name)));
+        }
+        else if (e.isFile()) {
+            let same = false;
+            try {
+                const [a, b] = await Promise.all([fsp.readFile(s), fsp.readFile(d)]);
+                same = a.equals(b);
+            }
+            catch {
+                same = false;
+            }
+            if (!same)
+                changed.push(rel ? `${rel}/${e.name}` : e.name);
+        }
+    }
+    return changed;
+}
+//# sourceMappingURL=index.js.map

package/dist/core/skills/index.js.map

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

package/dist/core/skills/install.d.ts

@@ -0,0 +1,18 @@
+import { type HookConfig } from './bus.js';
+export declare function skillSourceDir(name: string): string;
+export declare function hasInstallHooks(name: string): boolean;
+interface InstallAddress {
+    skillsRoot: string;
+    dst: string;
+    force: boolean;
+}
+export declare function runPreInstall(name: string, addr: InstallAddress): Promise<{
+    config: HookConfig | null;
+    vars: Record<string, string>;
+}>;
+export declare function runPostInstall(name: string, addr: InstallAddress, config: HookConfig | null, vars: Record<string, string>): Promise<void>;
+export declare function renderVars(text: string, vars: Record<string, string>): string;
+export declare function diffRendered(src: string, dst: string, vars: Record<string, string>, rel?: string): Promise<string[]>;
+export declare function copyRendered(src: string, dst: string, vars: Record<string, string>, rel?: string): Promise<number>;
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/core/skills/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/core/skills/install.ts"],"names":[],"mappings":"AAaA,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,UAAU,CAAC;AAElB,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;CAChB;AAeD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAMtE;AAGD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,UAAU,GAAG,IAAI,EACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAEf;AAQD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAI7E;AAGD,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,GAAG,SAAK,GACP,OAAO,CAAC,MAAM,EAAE,CAAC,CAgCnB;AAID,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,GAAG,SAAK,GACP,OAAO,CAAC,MAAM,CAAC,CAwBjB"}

package/dist/core/skills/install.js

@@ -0,0 +1,123 @@
+// skill 安装与 hook 总线的桥接，以及带动态字符串的渲染复制。
+//
+// 安装生命周期映射为总线上的两个开放事件：
+//   skill:pre-install   复制前；handler 可 block（拒绝安装）或返回 vars（动态字符串）
+//   skill:post-install  复制后；做额外动作
+// 配置来自被安装 skill 源目录的 hooks.json；配置文件与 install/ 脚本目录
+// 属于安装期机制，不复制进目标。
+import fsp from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { assetsDir } from './index.js';
+import { isTextPath } from './text-util.js';
+import { blocked } from '../errors/index.js';
+import { emit, loadHookConfig, HOOK_CONFIG_FILE, } from './bus.js';
+export function skillSourceDir(name) {
+    return join(assetsDir(), name);
+}
+// 有安装钩子 = 源目录含 hooks.json
+export function hasInstallHooks(name) {
+    return existsSync(join(skillSourceDir(name), HOOK_CONFIG_FILE));
+}
+function baseFields(name, a, vars) {
+    const src = skillSourceDir(name);
+    return {
+        cwd: process.cwd(),
+        skillsDir: a.skillsRoot,
+        sourceDir: src,
+        targetDir: a.dst,
+        force: a.force,
+        vars,
+    };
+}
+// pre-install：返回配置与聚合后的 vars；被 block 则抛 blocked（拒绝安装）。
+export async function runPreInstall(name, addr) {
+    const src = skillSourceDir(name);
+    const config = await loadHookConfig(src);
+    const out = await emit('skill:pre-install', name, config, baseFields(name, addr, {}));
+    if (out.blocked)
+        throw blocked(out.reason || '安装被 hook 阻断');
+    return { config, vars: out.vars };
+}
+// post-install：复制完成后触发（block 语义不适用，忽略）。
+export async function runPostInstall(name, addr, config, vars) {
+    await emit('skill:post-install', name, config, baseFields(name, addr, vars));
+}
+// 安装期资产不进目标：hooks.json 与 install/ 目录。
+const SKIP_FILES = new Set([HOOK_CONFIG_FILE]);
+const SKIP_DIRS = new Set(['install']);
+// 动态字符串渲染：只替换 vars 中存在的占位符，其余原样（宽松——
+// skill 文档可能含示例花括号，不该被动态机制误伤）。
+export function renderVars(text, vars) {
+    return text.replace(/\{\{([\w-]+)\}\}/g, (m, key) => key in vars ? vars[key] ?? m : m);
+}
+// 遍历源树（跳过安装期资产），逐文件比较「渲染后的源」与目标，返回差异清单。
+export async function diffRendered(src, dst, vars, rel = '') {
+    const changed = [];
+    let entries;
+    try {
+        entries = await fsp.readdir(src, { withFileTypes: true });
+    }
+    catch {
+        return changed;
+    }
+    for (const e of entries) {
+        if (e.isDirectory() && SKIP_DIRS.has(e.name))
+            continue;
+        if (e.isFile() && SKIP_FILES.has(e.name))
+            continue;
+        const s = join(src, e.name);
+        const d = join(dst, e.name);
+        const childRel = rel ? rel + '/' + e.name : e.name;
+        if (e.isDirectory()) {
+            changed.push(...(await diffRendered(s, d, vars, childRel)));
+        }
+        else if (e.isFile()) {
+            let same = false;
+            try {
+                const raw = await fsp.readFile(s);
+                const target = await fsp.readFile(d);
+                same = isTextPath(childRel)
+                    ? renderVars(raw.toString('utf8'), vars) === target.toString('utf8')
+                    : raw.equals(target);
+            }
+            catch {
+                same = false;
+            }
+            if (!same)
+                changed.push(childRel);
+        }
+    }
+    return changed;
+}
+// 复制源树到目标：文本文件渲染 vars，二进制原样；安装期资产不复制。
+// 返回写入的文件数。
+export async function copyRendered(src, dst, vars, rel = '') {
+    let count = 0;
+    const entries = await fsp.readdir(src, { withFileTypes: true });
+    for (const e of entries) {
+        if (e.isDirectory() && SKIP_DIRS.has(e.name))
+            continue;
+        if (e.isFile() && SKIP_FILES.has(e.name))
+            continue;
+        const s = join(src, e.name);
+        const d = join(dst, e.name);
+        const childRel = rel ? rel + '/' + e.name : e.name;
+        if (e.isDirectory()) {
+            count += await copyRendered(s, d, vars, childRel);
+        }
+        else if (e.isFile()) {
+            await fsp.mkdir(dirname(d), { recursive: true });
+            if (isTextPath(childRel)) {
+                const text = await fsp.readFile(s, 'utf8');
+                await fsp.writeFile(d, renderVars(text, vars), 'utf8');
+            }
+            else {
+                await fsp.copyFile(s, d);
+            }
+            count++;
+        }
+    }
+    return count;
+}
+//# sourceMappingURL=install.js.map

package/dist/core/skills/install.js.map

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

package/dist/core/skills/text-util.d.ts

@@ -0,0 +1,2 @@
+export declare function isTextPath(rel: string): boolean;
+//# sourceMappingURL=text-util.d.ts.map

package/dist/core/skills/text-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-util.d.ts","sourceRoot":"","sources":["../../../src/core/skills/text-util.ts"],"names":[],"mappings":"AASA,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAK/C"}

package/dist/core/skills/text-util.js

@@ -0,0 +1,14 @@
+// 文本/二进制路径判定（skill 标准模块自包含，不依赖项目里的生成器）。
+import { basename } from 'node:path';
+const TEXT_EXT = new Set([
+    '.js', '.mjs', '.cjs', '.jsx', '.ts', '.tsx', '.json', '.md', '.txt',
+    '.css', '.html', '.yml', '.yaml', '.toml', '.ini', '.cfg', '.sh',
+    '.gitignore', '.npmrc', '.env', '.editorconfig', '',
+]);
+export function isTextPath(rel) {
+    const name = basename(rel);
+    const dot = name.lastIndexOf('.');
+    const ext = dot <= 0 ? '' : name.slice(dot).toLowerCase();
+    return TEXT_EXT.has(ext) || /\.(gitignore|npmrc|editorconfig)$/.test(name);
+}
+//# sourceMappingURL=text-util.js.map

package/dist/core/skills/text-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-util.js","sourceRoot":"","sources":["../../../src/core/skills/text-util.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;IACpE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK;IAChE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE;CACpD,CAAC,CAAC;AAEH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7E,CAAC"}

package/dist/core/store.d.ts

@@ -0,0 +1,29 @@
+export interface NavGroup {
+    title: string;
+    /** 组内页面 id（数组顺序 = 头部展开列表里的顺序） */
+    views: string[];
+}
+export interface Settings {
+    /** 头部导航分组：数组顺序 = 显示顺序；一个页面最多属于一个组 */
+    navGroups: NavGroup[];
+    /** 被隐藏的页面 id：头部不显示入口，`#/id` 直达仍可用 */
+    navHidden: string[];
+    /** 平铺区的显示顺序（页面 id 数组；没列进去的按页面自身顺序跟在后面） */
+    navOrder: string[];
+    /** 色彩主题：light（浅色）/ dark（深色）/ auto（跟随系统） */
+    theme: string;
+    [k: string]: unknown;
+}
+export interface StoreState {
+    version: number;
+    settings: Settings;
+    [k: string]: unknown;
+}
+export declare function initialState(): StoreState;
+export declare function newId(prefix: string): string;
+export declare function loadStore(explicitPath?: string): Promise<StoreState>;
+export declare function saveStore(next: StoreState, explicitPath?: string): Promise<StoreState>;
+export declare function mutateStore<T>(fn: (s: StoreState) => T, explicitPath?: string): Promise<T | StoreState>;
+export declare function normalize(data: unknown): StoreState;
+export declare function clearCache(): void;
+//# sourceMappingURL=store.d.ts.map

package/dist/core/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/core/store.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,qCAAqC;IACrC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACtB;AAED,wBAAgB,YAAY,IAAI,UAAU,CAKzC;AAKD,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAsB,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAe1E;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAc5F;AAID,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,CAAC,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,GAAG,UAAU,CAAC,CAKzB;AAKD,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAuBnD;AAGD,wBAAgB,UAAU,IAAI,IAAI,CAGjC"}

package/dist/core/store.js

@@ -0,0 +1,100 @@
+// JSON 存储：用户目录下的单一数据文件，Web 表单与 agent CLI 共同读写。
+//
+// 设计要点：
+// - 原子写（临时文件 + rename），进程中断不会损坏数据
+// - 进程内缓存 + mtime 失效检测：外部进程（如 CLI）改写后，Web 服务侧能立刻看到
+// - 自己写入后主动刷新缓存 mtime，避免「自己触发自己重读」
+//
+// 这是**通用**存储：结构由 initialState() 决定。项目要加字段就改它，
+// normalize 会自动给老数据补默认值——不需要写迁移脚本。
+import fsp from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { storePathFromEnv } from './paths.js';
+export function initialState() {
+    return {
+        version: 1,
+        settings: { navGroups: [], navHidden: [], navOrder: [], theme: 'light' },
+    };
+}
+let cache = null;
+let cacheMtime = -1;
+export function newId(prefix) {
+    return prefix + '_' + Date.now().toString(36) + Math.random().toString(36).slice(2, 7);
+}
+export async function loadStore(explicitPath) {
+    const p = explicitPath || storePathFromEnv();
+    try {
+        const st = await fsp.stat(p);
+        if (cache && cacheMtime === st.mtimeMs)
+            return cache;
+        const raw = await fsp.readFile(p, 'utf8');
+        cache = normalize(JSON.parse(raw));
+        cacheMtime = st.mtimeMs;
+        return cache;
+    }
+    catch {
+        // 文件不存在或损坏：返回空结构（首次运行 / 允许外部修复后恢复）
+        cache = normalize(null);
+        cacheMtime = -1;
+        return cache;
+    }
+}
+export async function saveStore(next, explicitPath) {
+    const p = explicitPath || storePathFromEnv();
+    const data = normalize(next);
+    await fsp.mkdir(dirname(p), { recursive: true });
+    const tmp = p + '.tmp';
+    await fsp.writeFile(tmp, JSON.stringify(data, null, 2), 'utf8');
+    await fsp.rename(tmp, p);
+    cache = data;
+    try {
+        cacheMtime = (await fsp.stat(p)).mtimeMs;
+    }
+    catch {
+        cacheMtime = -1;
+    }
+    return data;
+}
+// 读-改-写事务：fn 直接修改传入的深拷贝 store；fn 抛错则不落盘。
+// 这条语义很重要——半个事务写进磁盘比不写更糟。
+export async function mutateStore(fn, explicitPath) {
+    const cur = structuredClone(await loadStore(explicitPath));
+    const result = fn(cur);
+    await saveStore(cur, explicitPath);
+    return result === undefined ? cur : result;
+}
+// 归一化：以 initialState() 为底，把已有数据合并上去。
+// 新增字段自动获得默认值，因此**不需要迁移脚本**——
+// 老 store.json 缺的键会在这里补齐，多出来的键也原样保留。
+export function normalize(data) {
+    const base = initialState();
+    if (!data || typeof data !== 'object')
+        return base;
+    const d = data;
+    base.version = typeof d.version === 'number' ? d.version : base.version;
+    if (base.settings && typeof base.settings === 'object') {
+        base.settings = { ...base.settings, ...(d.settings || {}) };
+    }
+    // 其余顶层键：base 里声明过的按 base 的形状兜底，没声明过的原样带过来
+    for (const [k, v] of Object.entries(d)) {
+        if (k === 'version' || k === 'settings')
+            continue;
+        if (Array.isArray(v)) {
+            base[k] = v;
+        }
+        else if (v && typeof v === 'object') {
+            const existing = base[k];
+            base[k] = { ...(existing || {}), ...v };
+        }
+        else {
+            base[k] = v;
+        }
+    }
+    return base;
+}
+// 测试与调试用：清掉进程内缓存，强制下次重读
+export function clearCache() {
+    cache = null;
+    cacheMtime = -1;
+}
+//# sourceMappingURL=store.js.map

package/dist/core/store.js.map

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

package/dist/core/views.d.ts

@@ -0,0 +1,11 @@
+export interface ViewMeta {
+    id: string;
+    title: string;
+    order: number;
+    /** 出厂默认是否隐藏（用户可在首页改；配置存在后以配置为准） */
+    hidden?: boolean;
+}
+export declare const VIEWS_META: readonly ViewMeta[];
+export declare function viewMetaOf(id: string): ViewMeta | null;
+export declare function viewIdsOf(): string[];
+//# sourceMappingURL=views.d.ts.map

package/dist/core/views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../src/core/views.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAGzC,CAAC;AAEF,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAEtD;AAED,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC"}