@lark-apaas/miaoda-cli 0.1.4 → 0.1.5-alpha.2f1e0ff

package/dist/cli/handlers/observability/log.js

@@ -38,6 +38,12 @@ const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const index_1 = require("../../../api/observability/index");
 const helpers_1 = require("./helpers");
+function stringIdFilter(value) {
+    if (Array.isArray(value)) {
+        return value.length > 0 ? (0, helpers_1.inFilter)(value) : undefined;
+    }
+    return value ? (0, helpers_1.eqFilter)(value) : undefined;
+}
 /** miaoda observability log */
 async function handleObservabilityLog(opts) {
     const appID = opts.appId;
@@ -50,8 +56,8 @@ async function handleObservabilityLog(opts) {
     //   - duration_ms 暂未在 BAM 描述里明确列出，留 TODO 等 e2e 验证
     const fieldFilters = (0, helpers_1.buildFieldFilters)([
         { key: 'severity_text', value: opts.level ? (0, helpers_1.eqFilter)(opts.level) : undefined },
-        { key: 'attributes.ob_data_id', value: opts.logId ? (0, helpers_1.eqFilter)(opts.logId) : undefined },
-        { key: 'trace_id', value: opts.traceId ? (0, helpers_1.eqFilter)(opts.traceId) : undefined },
+        { key: 'attributes.ob_data_id', value: stringIdFilter(opts.logId) },
+        { key: 'trace_id', value: stringIdFilter(opts.traceId) },
         { key: 'module', value: opts.module ? (0, helpers_1.eqFilter)(opts.module) : undefined },
         { key: 'user_id', value: opts.userId ? (0, helpers_1.eqFilter)(opts.userId, 'i64') : undefined },
         { key: 'page', value: opts.page ? (0, helpers_1.eqFilter)(opts.page) : undefined },

package/dist/cli/handlers/observability/source-stack.js

@@ -0,0 +1,389 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleObservabilitySourceStack = handleObservabilitySourceStack;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const args_1 = require("../../../utils/args");
+const helpers_1 = require("./helpers");
+const SOURCE_MAP_FILE_PREFIX = 'client/assets/';
+/** miaoda observability source-stack */
+async function handleObservabilitySourceStack(opts) {
+    const logIds = normalizeValues(opts.logId);
+    const traceIds = normalizeValues(opts.traceId);
+    if (logIds.length === 0 && traceIds.length === 0) {
+        (0, args_1.failArgs)('至少传入线上环境日志 ID 或 trace ID');
+    }
+    const logs = await collectCandidateLogs(opts, { logIds, traceIds });
+    const results = await resolveCandidateLogs(opts.appId, logs);
+    (0, output_1.emit)({ data: results, next_cursor: null, has_more: false });
+}
+async function collectCandidateLogs(opts, params) {
+    const limit = (0, helpers_1.validateLimit)(opts.limit ?? 50);
+    const searches = [];
+    if (params.logIds.length > 0) {
+        searches.push(searchLogs(opts, {
+            limit,
+            fieldFilters: (0, helpers_1.buildFieldFilters)([
+                { key: 'attributes.ob_data_id', value: stringIdFilter(params.logIds) },
+            ]),
+        }));
+    }
+    if (params.traceIds.length > 0) {
+        searches.push(searchLogs(opts, {
+            limit,
+            fieldFilters: (0, helpers_1.buildFieldFilters)([
+                { key: 'trace_id', value: stringIdFilter(params.traceIds) },
+            ]),
+        }));
+    }
+    const allLogs = (await Promise.all(searches)).flat();
+    const deduped = new Map();
+    for (const log of allLogs) {
+        deduped.set(log.id, log);
+    }
+    return Array.from(deduped.values());
+}
+async function searchLogs(opts, params) {
+    const req = {
+        appID: opts.appId,
+        appEnv: 'runtime',
+        startTimestampNs: (0, helpers_1.parseToNs)(opts.since),
+        endTimestampNs: (0, helpers_1.parseToNs)(opts.until),
+        limit: params.limit,
+        fieldFilters: params.fieldFilters,
+    };
+    const resp = await api.observability.searchLogs(req);
+    return resp.logItems ?? [];
+}
+async function resolveCandidateLogs(appID, logs) {
+    const results = [];
+    for (const log of logs) {
+        const attrs = log.attributes ?? {};
+        const rawStack = pickAttr(attrs, ['stack', 'error_stack', 'errorStack']) ??
+            pickBodyStack(log.body) ??
+            log.body;
+        const frames = parseGeneratedFrames(rawStack);
+        const commitID = pickAttr(attrs, [
+            'release_commit_id',
+            'releaseCommitID',
+            'commit_id',
+            'commitID',
+        ]);
+        const message = pickErrorMessage(log, rawStack);
+        const base = {
+            log_id: log.id,
+            trace_id: log.traceID ?? attrs.trace_id,
+            commit_id: commitID,
+            source_map_files: sourceMapFilesForFrames(frames),
+        };
+        const reason = missingReason({ frames, commitID });
+        if (reason) {
+            results.push({
+                ...base,
+                status: 'unresolved',
+                reason,
+                error_message_stack: formatStack(message, frames),
+            });
+            continue;
+        }
+        const resolvedCommitID = commitID;
+        if (!resolvedCommitID)
+            continue;
+        let resolvedFrames;
+        try {
+            resolvedFrames = await resolveFramesBySourceMap(appID, resolvedCommitID, frames);
+        }
+        catch (err) {
+            results.push({
+                ...base,
+                status: 'unresolved',
+                reason: `调用 resolve_stack_trace 失败：${errorMessage(err)}`,
+                error_message_stack: formatStack(message, frames),
+            });
+            continue;
+        }
+        results.push({
+            ...base,
+            status: 'resolved',
+            error_message_stack: formatStack(message, resolvedFrames),
+        });
+    }
+    return results;
+}
+function normalizeValues(value) {
+    if (Array.isArray(value)) {
+        return value.filter((item) => item.length > 0);
+    }
+    return value ? [value] : [];
+}
+function stringIdFilter(values) {
+    if (values.length === 0)
+        return undefined;
+    return values.length === 1 ? (0, helpers_1.eqFilter)(values[0]) : (0, helpers_1.inFilter)(values);
+}
+function pickAttr(attrs, keys) {
+    for (const key of keys) {
+        const value = attrs[key];
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+async function resolveFramesBySourceMap(appID, commitID, frames) {
+    const resp = await api.observability.resolveStackTrace({
+        appID,
+        commitID,
+        sourceMapFilePrefix: SOURCE_MAP_FILE_PREFIX,
+        frames,
+    });
+    return resp.frames ?? frames;
+}
+function parseGeneratedFrames(stack) {
+    if (!stack)
+        return [];
+    const jsonFrames = parseJsonStackFrames(stack);
+    if (jsonFrames.length > 0)
+        return jsonFrames;
+    const frames = [];
+    const parenFramePattern = /\((.+):(\d+):(\d+)\)$/;
+    const plainFramePattern = /(?:at\s+)?(.+):(\d+):(\d+)$/;
+    for (const line of stack.split('\n')) {
+        const trimmed = line.trim();
+        const match = parenFramePattern.exec(trimmed) ?? plainFramePattern.exec(trimmed);
+        if (!match)
+            continue;
+        const [, fileName, lineNumber, columnNumber] = match;
+        if (!fileName || !lineNumber || !columnNumber)
+            continue;
+        frames.push({
+            fileName: normalizeFrameFileName(fileName),
+            line: Number(lineNumber),
+            column: Number(columnNumber),
+        });
+    }
+    return frames.slice(0, 2000);
+}
+function parseJsonStackFrames(stack) {
+    const trimmed = stack.trim();
+    if (!trimmed.startsWith('['))
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return [];
+    }
+    if (!Array.isArray(parsed))
+        return [];
+    return parsed
+        .map((item) => normalizeJsonFrame(item))
+        .filter((frame) => Boolean(frame))
+        .slice(0, 2000);
+}
+function normalizeJsonFrame(item) {
+    if (!isRecord(item))
+        return undefined;
+    const fileName = item.fileName;
+    const line = item.line;
+    const column = item.column;
+    if (typeof fileName !== 'string')
+        return undefined;
+    const lineNumber = toFiniteNumber(line);
+    const columnNumber = toFiniteNumber(column);
+    if (lineNumber === undefined || columnNumber === undefined)
+        return undefined;
+    return {
+        fileName: normalizeFrameFileName(fileName),
+        line: lineNumber,
+        column: columnNumber,
+    };
+}
+function pickErrorMessage(log, rawStack) {
+    return (pickBodyErrorMessage(log.body) ??
+        firstTextStackLine(rawStack) ??
+        pickAttr(log.attributes ?? {}, ['error_message', 'errorMessage', 'message']));
+}
+function pickBodyStack(body) {
+    const parsed = parseBodyRecord(body);
+    if (!parsed)
+        return undefined;
+    return (stringProp(parsed, 'stack') ??
+        nestedStringProp(parsed, ['error', 'stack']) ??
+        nestedStringProp(parsed, ['response', 'error', 'stack']) ??
+        pickConsoleArgsStack(parsed));
+}
+function pickBodyErrorMessage(body) {
+    const parsed = parseBodyRecord(body);
+    if (!parsed)
+        return undefined;
+    return (stringProp(parsed, 'error_message') ??
+        stringProp(parsed, 'message') ??
+        nestedStringProp(parsed, ['error', 'message']) ??
+        nestedStringProp(parsed, ['response', 'error', 'message']) ??
+        pickConsoleArgsMessage(parsed));
+}
+function pickConsoleArgsMessage(record) {
+    const parts = Object.entries(record)
+        .filter(([key]) => /^\d+$/.test(key))
+        .sort(([left], [right]) => Number(left) - Number(right))
+        .map(([, value]) => consoleArgMessage(value))
+        .filter((message) => Boolean(message));
+    if (parts.length === 0)
+        return undefined;
+    return parts.join(' ').replace(/\s+/g, ' ').trim();
+}
+function pickConsoleArgsStack(record) {
+    return Object.entries(record)
+        .filter(([key]) => /^\d+$/.test(key))
+        .sort(([left], [right]) => Number(left) - Number(right))
+        .map(([, value]) => consoleArgStack(value))
+        .find((stack) => Boolean(stack));
+}
+function consoleArgStack(value) {
+    if (typeof value === 'string') {
+        const stack = value.trim();
+        return looksLikeTextStack(stack) ? stack : undefined;
+    }
+    if (!isRecord(value))
+        return undefined;
+    return (stringProp(value, 'stack') ??
+        nestedStringProp(value, ['error', 'stack']) ??
+        nestedStringProp(value, ['response', 'error', 'stack']));
+}
+function consoleArgMessage(value) {
+    if (typeof value === 'string') {
+        const message = value.trim();
+        return message.length > 0 ? message : undefined;
+    }
+    if (!isRecord(value))
+        return undefined;
+    return errorRecordMessage(value);
+}
+function errorRecordMessage(record) {
+    const stackTitle = firstTextStackLine(stringProp(record, 'stack'));
+    if (stackTitle)
+        return stackTitle;
+    const name = stringProp(record, 'name');
+    const message = stringProp(record, 'message') ??
+        nestedStringProp(record, ['error', 'message']) ??
+        nestedStringProp(record, ['response', 'error', 'message']);
+    if (name && message && !message.startsWith(`${name}:`)) {
+        return `${name}: ${message}`;
+    }
+    return message ?? name;
+}
+function parseBodyRecord(body) {
+    if (!body)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        return undefined;
+    }
+    return isRecord(parsed) ? parsed : undefined;
+}
+function firstTextStackLine(stack) {
+    const trimmed = stack?.trim();
+    if (!trimmed || trimmed.startsWith('['))
+        return undefined;
+    return trimmed
+        .split('\n')
+        .map((line) => line.trim())
+        .find((line) => line.length > 0 && !line.startsWith('at '));
+}
+function looksLikeTextStack(value) {
+    return value.length > 0 && /:\d+:\d+(?:\)|$)/.test(value);
+}
+function missingReason(params) {
+    if (!params.commitID)
+        return '日志缺少 release_commit_id / commit_id，无法定位构建产物';
+    if (params.frames.length === 0)
+        return '日志中没有可解析的 generated stack frame';
+    return undefined;
+}
+function normalizeFrameFileName(fileName) {
+    return fileName.split(/[/?#]/).filter(Boolean).pop() ?? fileName;
+}
+function formatStack(message, frames) {
+    const stack = frames
+        .map((frame) => {
+        if (frame.sourceFileName) {
+            return `  at ${frame.sourceFileName}:${String(frame.sourceLine)}:${String(frame.sourceColumn)}`;
+        }
+        return `  at ${frame.fileName}:${String(frame.line)}:${String(frame.column)}`;
+    })
+        .join('\n');
+    if (message && stack)
+        return `${message}\n${stack}`;
+    return message ?? stack;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function toFiniteNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.trim()) {
+        const numberValue = Number(value);
+        return Number.isFinite(numberValue) ? numberValue : undefined;
+    }
+    return undefined;
+}
+function stringProp(record, key) {
+    const value = record[key];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function nestedStringProp(record, path) {
+    let current = record;
+    for (const key of path) {
+        if (!isRecord(current))
+            return undefined;
+        current = current[key];
+    }
+    return typeof current === 'string' && current.length > 0 ? current : undefined;
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function sourceMapFileForFrame(fileName) {
+    return `${SOURCE_MAP_FILE_PREFIX}${fileName}.map`;
+}
+function sourceMapFilesForFrames(frames) {
+    return Array.from(new Set(frames.map((frame) => sourceMapFileForFrame(frame.fileName))));
+}

package/dist/cli/handlers/observability/trace.js

@@ -40,6 +40,12 @@ const output_1 = require("../../../utils/output");
 const args_1 = require("../../../utils/args");
 const index_1 = require("../../../api/observability/index");
 const helpers_1 = require("./helpers");
+function stringIdFilter(value) {
+    if (Array.isArray(value)) {
+        return value.length > 0 ? (0, helpers_1.inFilter)(value) : undefined;
+    }
+    return value ? (0, helpers_1.eqFilter)(value) : undefined;
+}
 /** miaoda observability trace list */
 async function handleObservabilityTraceList(opts) {
     const appID = opts.appId;
@@ -51,7 +57,7 @@ async function handleObservabilityTraceList(opts) {
     //   - 入口 span：BAM 没有 entrySpanName fieldFilter，统一走 fuzzyFilter（trace endpoint
     //     默认作用于 span name），所以 --root-span 不进 fieldFilters
     const fieldFilters = (0, helpers_1.buildFieldFilters)([
-        { key: 'trace_id', value: opts.traceId ? (0, helpers_1.eqFilter)(opts.traceId) : undefined },
+        { key: 'trace_id', value: stringIdFilter(opts.traceId) },
         { key: 'user_id', value: opts.userId ? (0, helpers_1.eqFilter)(opts.userId, 'i64') : undefined },
     ]);
     const req = {

package/dist/cli/handlers/skills/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSkillsStatus = exports.handleSkillsSync = void 0;
+var sync_1 = require("./sync");
+Object.defineProperty(exports, "handleSkillsSync", { enumerable: true, get: function () { return sync_1.handleSkillsSync; } });
+var status_1 = require("./status");
+Object.defineProperty(exports, "handleSkillsStatus", { enumerable: true, get: function () { return status_1.handleSkillsStatus; } });

package/dist/cli/handlers/skills/status.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSkillsStatus = handleSkillsStatus;
+const node_path_1 = __importDefault(require("node:path"));
+const index_1 = require("../../../services/skills/index");
+const spark_meta_1 = require("../../../utils/spark-meta");
+const output_1 = require("../../../utils/output");
+/**
+ * miaoda skills status [--dir <path>]
+ *
+ * 从 .spark/meta.json 读 stack，扫描 <dir>/.agent/steering/<stack>/，
+ * 给出当前装了哪些 skills、tech.md 是否在。纯本地操作，不联网。
+ * meta 缺 stack 时返回 present=false（不抛错，方便和 init 的引导分开）。
+ */
+async function handleSkillsStatus(opts) {
+    await Promise.resolve();
+    const targetDir = node_path_1.default.resolve(opts.dir ?? process.cwd());
+    const meta = (0, spark_meta_1.readSparkMeta)(targetDir);
+    const status = (0, index_1.readSkillsStatus)({ targetDir, stack: meta.stack });
+    (0, output_1.emit)({
+        data: {
+            stack: meta.stack ?? null,
+            present: status.present,
+            skills: status.skills,
+            techSynced: status.techSynced,
+        },
+    });
+}

package/dist/cli/handlers/skills/sync.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSkillsSync = handleSkillsSync;
+const node_path_1 = __importDefault(require("node:path"));
+const coding_steering_1 = require("../../../utils/coding-steering");
+const spark_meta_1 = require("../../../utils/spark-meta");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+/**
+ * miaoda skills sync [version] [--dir <path>]
+ *
+ * 从 .spark/meta.json 读 stack（+ 默认 steeringVersion），把 coding-steering 包内对应 stack
+ * 的 skills + tech.md 同步到 <dir>/.agent/steering/。需要先跑过 `miaoda app init`。
+ */
+async function handleSkillsSync(opts) {
+    await Promise.resolve();
+    const targetDir = node_path_1.default.resolve(opts.dir ?? process.cwd());
+    const meta = (0, spark_meta_1.readSparkMeta)(targetDir);
+    if (meta.stack === undefined || meta.stack === '') {
+        throw new error_1.AppError('SKILLS_META_INCOMPLETE', '.spark/meta.json missing stack — run `miaoda app init` first');
+    }
+    const version = opts.version ?? meta.steeringVersion;
+    const versionSource = opts.version
+        ? 'cli-arg'
+        : meta.steeringVersion
+            ? 'meta.json'
+            : 'default-latest';
+    const result = (0, coding_steering_1.syncCodingSteering)({
+        stack: meta.stack,
+        targetDir,
+        version,
+        outputLayout: opts.local === true ? 'flat' : 'nested',
+    });
+    (0, output_1.emit)({
+        data: {
+            stack: meta.stack,
+            version: result.version,
+            versionSource,
+            syncedSkills: result.syncedSkills,
+            techSynced: result.techSynced,
+            ...(result.claudeSkillsLink !== undefined
+                ? { claudeSkillsLink: result.claudeSkillsLink }
+                : {}),
+        },
+    });
+}

package/dist/config/fullstack-cli-pin.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FULLSTACK_CLI_PIN_SPEC = void 0;
+/**
+ * 临时钉死 `@lark-apaas/fullstack-cli` 的 npx 调用版本。
+ *
+ * 用于 user app `package.json` 里所有 `npx -y @lark-apaas/fullstack-cli ...` 调用 ——
+ * sync 规则会按本常量生成 `npx -y <FULLSTACK_CLI_PIN_SPEC> ...`，确保 user app 每次
+ * postinstall / gen-db-schema / sync 都拉到验证过能装插件的版本（避免 npx 拉 latest
+ * 时碰到外部 prerelease 回归版本）。
+ *
+ * 维护：
+ *   - 跟 src/cli/handlers/app/sync.ts 里 PINNED_PLATFORM_VERSIONS['@lark-apaas/fullstack-cli']
+ *     **保持一致**（前者用于 user app dependencies dep bump，后者用于 npm script 里 npx 调用）
+ *   - 一旦 latest fullstack-cli 稳定且 token 鉴权回归 OK，可以去掉版本钉，让 npx 走 latest
+ */
+exports.FULLSTACK_CLI_PIN_SPEC = '@lark-apaas/fullstack-cli@1.1.49-alpha.0';

package/dist/config/sync-configs/design-stack.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * design-stack 的 sync 规则。
+ *
+ * design-stack 是 SSR-only 全栈 stack（design scene，MIAODA_APP_TYPE=4），无 nest 后端、
+ * 无数据库、无 nestjs-cli。所以规则集是 nestjs-react-fullstack 的子集：只保留
+ * scripts/.githooks/ 派生 + 基础 npm scripts，不动 nest-cli.json / drizzle / tsconfig.node.json。
+ *
+ * dev-local.sh 跟 nestjs-react-fullstack 不同（单进程 npm run dev，MIAODA_APP_TYPE=4），
+ * 单独维护在 upgrade/templates/design-stack/templates/scripts/dev-local.sh。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYNC_CONFIG = void 0;
+const fullstack_cli_pin_1 = require("../../config/fullstack-cli-pin");
+exports.SYNC_CONFIG = {
+    sync: [
+        // 1. 派生 scripts/（含 design 专属 dev-local.sh + 通用 dev.sh / hooks/run-precommit.js）
+        {
+            type: 'directory',
+            from: 'scripts',
+            to: 'scripts',
+            overwrite: true,
+        },
+        // 1a. 同步 .githooks/（hook 入口，可执行 sh）
+        {
+            type: 'directory',
+            from: '.githooks',
+            to: '.githooks',
+            overwrite: true,
+        },
+        // 1b. scripts.prepare：npm install 后激活 git hooks
+        {
+            type: 'add-script',
+            name: 'prepare',
+            command: 'chmod +x .githooks/pre-commit 2>/dev/null; git config core.hooksPath .githooks 2>/dev/null || true',
+            overwrite: false,
+        },
+        // 1c. scripts.precommit
+        {
+            type: 'add-script',
+            name: 'precommit',
+            command: 'node scripts/hooks/run-precommit.js',
+            overwrite: false,
+        },
+        // 2. .gitignore 卫生：移除 package-lock.json + 加 .agent/
+        {
+            type: 'remove-line',
+            to: '.gitignore',
+            pattern: 'package-lock.json',
+        },
+        {
+            type: 'add-line',
+            to: '.gitignore',
+            line: '.agent/',
+        },
+        // 3. 老 npm scripts 迁移（裸 fullstack-cli → 钉版 npx）。两条 ifStartsWith 分别覆盖
+        //    "裸 fullstack-cli"（最老形态）和 "npx 未钉版" 形态，统一升到 FULLSTACK_CLI_PIN_SPEC。
+        {
+            type: 'patch-script',
+            name: 'postinstall',
+            to: `npx -y ${fullstack_cli_pin_1.FULLSTACK_CLI_PIN_SPEC} action-plugin init`,
+            ifStartsWith: 'fullstack-cli action-plugin init',
+        },
+        {
+            type: 'patch-script',
+            name: 'postinstall',
+            to: `npx -y ${fullstack_cli_pin_1.FULLSTACK_CLI_PIN_SPEC} action-plugin init`,
+            ifStartsWith: 'npx -y @lark-apaas/fullstack-cli action-plugin init',
+        },
+        {
+            type: 'patch-script',
+            name: 'upgrade',
+            to: `npx -y ${fullstack_cli_pin_1.FULLSTACK_CLI_PIN_SPEC} sync --disable-gen-openapi`,
+            ifStartsWith: 'fullstack-cli sync',
+        },
+        {
+            type: 'patch-script',
+            name: 'upgrade',
+            to: `npx -y ${fullstack_cli_pin_1.FULLSTACK_CLI_PIN_SPEC} sync --disable-gen-openapi`,
+            ifStartsWith: 'npx -y @lark-apaas/fullstack-cli sync',
+        },
+        {
+            type: 'patch-script',
+            name: 'dev',
+            to: './scripts/dev.sh',
+            ifStartsWith: 'npm run upgrade && ',
+        },
+        // ===== miaoda-cli 本地开发新增规则 =====
+        // M1. scripts.dev:local —— 本地用户绕过 SANDBOX_ID 分发直接跑本地链路（npm run dev:local）。
+        {
+            type: 'add-script',
+            name: 'dev:local',
+            command: './scripts/dev-local.sh',
+            overwrite: false,
+        },
+    ],
+};
+exports.default = exports.SYNC_CONFIG;