@fantasticit/sumi 0.0.0-stage → 0.5.0

package/node_modules/@sumi/kernel/README.md

@@ -0,0 +1,128 @@
+# @sumi/kernel
+
+策略中立的编排内核：读项目配置、加载插件、按流程运行步骤、汇总结论、写运行记录。内核不包含任何检查或门禁策略，也不知道有哪些插件包——这些全部由插件提供。
+
+## 主要导出
+
+| 导出                                                                                                         | 说明                                                                              |
+| ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------- |
+| `run(options: RunOptions): Promise<RunOutcome>`                                                              | 运行一个流程，返回 `runId`、`runDir`、`conclusion`、`exitCode`、`brief`、`record` |
+| `loadConfig(root)`                                                                                           | 读取并校验项目配置，返回 `SumiConfig`                                             |
+| `loadRegistry(root, config)`                                                                                 | 加载已启用的插件，返回 `{ plugins, commands }`                                    |
+| `loadFlow(root, config, registry, flowId)`                                                                   | 读取 `<flows>/<flowId>.flow.yaml`，展开分组并校验步骤                             |
+| `parseCondition`、`validateSteps`、`parallelGroups`                                                          | 流程条件解析、步骤校验、并发组编号                                                |
+| `mergePlans`                                                                                                 | 合并规划器返回的计划（追加步骤、注入、运行标签）                                  |
+| `execute(plugin, ctx, cwd)`、`MAX_OUTPUT_BYTES`                                                              | 以独立进程组运行单个插件；输出上限 1 MiB                                          |
+| `resolveBase`、`changedFiles`、`changedFilesAtCommit`、`listFiles`、`contentDigest`、`deriveTier`、`matches` | 基准、改动范围、内容摘要、档位推导、glob 匹配                                     |
+| `renderBrief`、`aggregate`、`collectNext`、`exitCodeForConclusion`、`formatAction`                           | 简报与结论                                                                        |
+| `createRunDir`、`readRecords`、`writeRecord`、`fingerprint`、`repeatedFingerprints`、`runsRoot`              | 运行记录                                                                          |
+| `resolveArgv`、`resolvePackageDir`、`PACKAGE_MANIFEST`、`LOCAL_MANIFEST`                                     | 插件命令参数与插件包解析                                                          |
+| `setBuiltinRoots`、`setCliVersion`、`getCliVersion`                                                          | 由 CLI 在启动时注入内置插件包位置与自身版本                                       |
+| `KernelError`                                                                                                | 配置、声明或流程不合法时抛出，`exitCode` 为 3                                     |
+
+### RunOptions
+
+| 字段     | 类型                                     | 说明                                                                        |
+| -------- | ---------------------------------------- | --------------------------------------------------------------------------- |
+| `root`   | `string`                                 | 项目根目录，必须是 git 仓库                                                 |
+| `flow`   | `string`                                 | 流程 id                                                                     |
+| `tier`   | `string?`                                | 请求的档位；缺省为 `tiers` 的第一个                                         |
+| `all`    | `boolean?`                               | 以全部文件而不是改动文件作为范围                                            |
+| `base`   | `string?`                                | 基准 ref，覆盖配置中的 `base`                                               |
+| `labels` | `Record<string, string>?`                | 运行标签，规划器可以追加                                                    |
+| `commit` | `{ oid: string; base: string \| null }?` | 固定提交模式：`root` 是该提交的独立检出，`base` 必须给出（`null` 表示空树） |
+
+## 项目配置
+
+位置按优先级为 `control/config.yaml`、`sumi.config.yaml`（旧位置）。未知字段原样保留，供 CLI 与插件读取（例如 CLI 读取的 `agents`）。
+
+| 字段        | 默认值                              | 校验与含义                                                                         |
+| ----------- | ----------------------------------- | ---------------------------------------------------------------------------------- |
+| `tiers`     | `[delta, runtime, full]`            | 非空字符串数组，从低到高                                                           |
+| `zones`     | `{}`                                | 区域名 → glob 数组，供 `changed:<zone>` 条件使用                                   |
+| `neutral`   | `[]`                                | 字符串数组                                                                         |
+| `exclude`   | `[]`                                | 字符串数组；命中的文件不传给检查步骤                                               |
+| `base`      | —                                   | 基准 ref                                                                           |
+| `upgrade`   | `[]`                                | `{ paths, tier }` 列表：改动命中 `paths` 时升至 `tier`（`tier` 必须在 `tiers` 中） |
+| `packages`  | `[]`                                | 启用的插件包（包名或本地路径）                                                     |
+| `plugins`   | `[]`                                | 本地插件目录，每个子目录含 `plugin.yaml`                                           |
+| `groups`    | `{}`                                | 分组名 → 插件 id 数组                                                              |
+| `flows`     | `control/flows`                     | 流程目录                                                                           |
+| `sumi`      | —                                   | 兼容的 CLI 版本范围（vendor 写精确版本）；不满足时报错并指向项目 launcher          |
+| `sumiBuild` | —                                   | 可选的精确 CLI 构建身份；同版本异构建时拒绝项目感知命令                            |
+| `brief`     | `{ maxLines: 40, maxFindings: 10 }` | 简报行数与 findings 条数上限                                                       |
+| `loop`      | `{ threshold: 3 }`                  | 同一 error 连续出现多少次后改为请人判断                                            |
+
+## 流程定义
+
+流程文件为 `<flows>/<id>.flow.yaml`，顶层字段 `id`（缺省取文件名）、`purpose`、`steps`。
+
+| 步骤字段   | 说明                                                                               |
+| ---------- | ---------------------------------------------------------------------------------- |
+| `use`      | 插件 id，或 `group:<分组名>`（按 `groups` 展开，成员 id 为 `<分组 id>/<插件 id>`） |
+| `id`       | 步骤实例 id；缺省为 `use`。同一插件出现多次时必须声明                              |
+| `with`     | 步骤配置，逐键覆盖插件声明中的 `with`                                              |
+| `when`     | 条件字符串，见下                                                                   |
+| `required` | 缺省为 `true`；非必需步骤不影响结论                                                |
+| `parallel` | 为 `true` 的相邻步骤组成一个并发组，同时运行                                       |
+
+`when` 由若干原子以 `and` 连接，全部成立才运行：
+
+| 原子                                  | 含义                                                                                                      |
+| ------------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| `tier == x`、`tier >= x`、`tier <= x` | 按档位顺序比较                                                                                            |
+| `step:<id> == <状态>`                 | 引用之前（且不在同一并发组）步骤的状态：`pass`、`fail`、`blocked`、`skipped`、`pending`、`not-applicable` |
+| `changed:<zone>`                      | 范围内有文件命中该区域                                                                                    |
+
+加载时校验：步骤 id 不重复、引用的插件已注册且不是只提供命令的插件、条件不引用后面或同组的步骤。
+
+### 执行顺序
+
+1. **规划阶段**：`kind: planner` 的步骤先运行，始终必需，返回 `skipped` 视为 `blocked`。规划器的条件只能引用规划器步骤。
+2. **合并计划**：追加步骤（按 `before` / `after` 锚点插入，id 为 `<规划器 id>/<步骤 id>`）、注入文件与义务、合并运行标签，然后重新校验。计划不合法或规划器未通过时，其余步骤不执行。
+3. **执行**：按并发组分批运行。条件不满足、低于插件的 `minTier`、或插件声明了 `triggers` 而未命中改动时，记为 `not-applicable`（被注入且标记 required 的步骤不受条件与 `minTier` 限制）。必需义务失败记为 `fail`，缺失、跳过或未执行记为 `blocked`。
+
+## 插件加载
+
+| 来源     | 规则                                                                                                                                                                                        |
+| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 插件包   | `packages` 中的每一项：本地路径直接使用，包名先在 CLI 内置位置、再在项目 `node_modules` 中查找；包根必须有 `sumi-plugins.yaml`（`plugins:` 列表）                                           |
+| 本地插件 | `plugins` 中每个目录下、含 `plugin.yaml` 的子目录                                                                                                                                           |
+| 派生插件 | 声明 `base` 的插件在其余插件之后登记，沿用 base 的 `command`（不能自行声明），未声明 `kind`、`timeout` 时取 base 的值，`with` 以 base 为默认逐键覆盖；base 不能是派生插件或只提供命令的插件 |
+
+插件 id 与命令名必须全局唯一；`requires` 中的插件包必须已在 `packages` 中启用。以 `./`、`../` 开头的命令参数相对声明所在目录解析（派生插件相对 base 的目录）。
+
+## 档位与改动范围
+
+- **基准**：`--base` 或配置的 `base` 必须存在；否则取与上游的合并基础；无上游时依次尝试与 `origin/HEAD`、`origin/main`、`origin/master` 的合并基础，再退到 `HEAD`；没有提交时为空树（全部文件视为改动）。
+- **改动文件**：工作区模式为相对基准的 diff 加未跟踪且未忽略的文件；固定提交模式为基准与该提交之间的 diff。
+- **档位**：请求的档位或最低档位；`upgrade` 规则命中时取较高者，原因写入简报。
+- **漂移**：工作区模式下运行前后计算内容摘要，不一致则结论为 `blocked` 并提示重跑。
+
+## 运行记录
+
+每次运行写入 `.sumi/runs/<runId>/`（`.sumi/` 自带 `*` 的 `.gitignore`）：
+
+| 文件                     | 内容                                                                               |
+| ------------------------ | ---------------------------------------------------------------------------------- |
+| `plan.json`              | 流程 id、档位、已注册插件、展开后的步骤                                            |
+| `<stepId>/result.json`   | 每个步骤完成时写出的记录，后续步骤可以读取                                         |
+| `<stepId>/stderr.log` 等 | 插件的 stderr；结果未被采纳时的原始输出 `stdout.raw`；遗留子进程说明 `orphans.log` |
+| `result.json`            | 整次运行的 `RunRecord`（结论、步骤、指纹、摘要等）                                 |
+| `brief.txt`              | 简报                                                                               |
+
+## 简报与退出码
+
+简报首行为 `<结论（大写）> <flow>#<runId>  tier=<档位>`，例如 `PASS check#r…  tier=delta`，随后是说明、未通过的步骤、按严重度排序的 findings、合并去重后的 `next`；超出 `brief.maxLines` 时截断并指向完整结果。同一 error（按步骤、规则、文件、subject 计算指纹）在工作区模式下、同流程同标签的运行中连续出现 `loop.threshold` 次时，`next` 首项改为 `ask-human`。
+
+结论只看必需步骤：有 `fail` 为 `fail`；否则有 `blocked` / `skipped`（或计划不合法、输入漂移）为 `blocked`；否则有 `pending` 为 `pending`；否则为 `pass`。
+
+| 结论      | 退出码 |
+| --------- | ------ |
+| `pass`    | 0      |
+| `fail`    | 1      |
+| `blocked` | 2      |
+| `pending` | 4      |
+| 内核错误  | 3      |
+
+插件结果只有在进程正常退出、未超时、输出为合法 JSON 且不超过 1 MiB、退出码与 `status` 一致时才被采纳，否则该步骤记为 `blocked`。

package/node_modules/@sumi/kernel/dist/brief.d.ts

@@ -0,0 +1,41 @@
+import type { Finding, NextAction, StepState } from '@sumi/plugin-sdk';
+export type Conclusion = 'pass' | 'fail' | 'blocked' | 'pending';
+export interface StepRecord {
+    id: string;
+    use: string;
+    required: boolean;
+    state: StepState;
+    summary: string;
+    findings: Finding[];
+    next: NextAction[];
+    checked: 'all' | string[];
+    metrics: {
+        name: string;
+        value: number;
+        added?: number;
+    }[];
+    /** 插件给出的报告段落（Markdown）。 */
+    report?: string;
+    evidenceDir?: string;
+    durationMs?: number;
+}
+export declare function exitCodeForConclusion(conclusion: Conclusion): number;
+/** 汇总：必需步骤 fail → fail；否则 blocked/skipped → blocked；否则 pending → pending；否则 pass。 */
+export declare function aggregate(steps: StepRecord[], extraBlocked?: boolean): Conclusion;
+export declare function formatAction(action: NextAction): string;
+export interface BriefInput {
+    conclusion: Conclusion;
+    flowId: string;
+    runId: string;
+    tier: string;
+    notes: string[];
+    steps: StepRecord[];
+    next: NextAction[];
+    runDir: string;
+    maxLines: number;
+    maxFindings: number;
+}
+/** 简报：首行结论；然后是说明、未通过步骤、findings、下一步；超出行数上限时截断。 */
+export declare function renderBrief(input: BriefInput): string;
+/** 合并去重各步骤的下一步动作。 */
+export declare function collectNext(steps: StepRecord[]): NextAction[];

package/node_modules/@sumi/kernel/dist/brief.js

@@ -0,0 +1,82 @@
+export function exitCodeForConclusion(conclusion) {
+    return { pass: 0, fail: 1, blocked: 2, pending: 4 }[conclusion];
+}
+/** 汇总：必需步骤 fail → fail；否则 blocked/skipped → blocked；否则 pending → pending；否则 pass。 */
+export function aggregate(steps, extraBlocked = false) {
+    const required = steps.filter((s) => s.required);
+    if (required.some((s) => s.state === 'fail'))
+        return 'fail';
+    if (extraBlocked || required.some((s) => s.state === 'blocked' || s.state === 'skipped'))
+        return 'blocked';
+    if (required.some((s) => s.state === 'pending'))
+        return 'pending';
+    return 'pass';
+}
+const MARK = {
+    pass: '✓',
+    fail: '✗',
+    blocked: '⊘',
+    skipped: '–',
+    pending: '…',
+    'not-applicable': ' ',
+};
+const SEVERITY_ORDER = { error: 0, warning: 1, info: 2 };
+export function formatAction(action) {
+    switch (action.type) {
+        case 'run':
+            return `[run ${action.effects.join(',')}${action.kind ? ` ${action.kind}` : ''}] ${action.argv.join(' ')} — ${action.why}`;
+        case 'edit':
+            return `[edit] ${action.file}${action.line ? `:${action.line}` : ''} ${action.intent} — ${action.why}`;
+        case 'ask-human':
+            return `[ask-human] ${action.question}${action.argv ? `（建议由人执行：${action.argv.join(' ')}）` : ''} — ${action.why}`;
+        case 'stop':
+            return `[stop] ${action.reason} — ${action.why}`;
+    }
+}
+/** 简报：首行结论；然后是说明、未通过步骤、findings、下一步；超出行数上限时截断。 */
+export function renderBrief(input) {
+    const lines = [`${input.conclusion.toUpperCase()} ${input.flowId}#${input.runId}  tier=${input.tier}`];
+    lines.push(...input.notes.map((n) => `  ${n}`));
+    for (const step of input.steps) {
+        if (step.state === 'pass' || step.state === 'not-applicable')
+            continue;
+        lines.push(`${MARK[step.state]} ${step.id}${step.required ? '' : '（非必需）'}  ${step.summary}`);
+    }
+    const findings = input.steps
+        .flatMap((step, order) => step.findings.map((f) => ({ f, step, order })))
+        .sort((a, b) => SEVERITY_ORDER[a.f.severity] - SEVERITY_ORDER[b.f.severity] || a.order - b.order);
+    if (findings.length) {
+        const shown = findings.slice(0, input.maxFindings);
+        lines.push(`findings（${shown.length}/${findings.length}）：`);
+        for (const { f, step } of shown) {
+            const at = f.file ? `${f.file}${f.line ? `:${f.line}` : ''}  ` : '';
+            lines.push(`  ${f.severity} ${at}${step.id}: ${f.message}`);
+        }
+        if (findings.length > shown.length)
+            lines.push(`  …另有 ${findings.length - shown.length} 条见 ${input.runDir}`);
+    }
+    if (input.next.length) {
+        lines.push('next:');
+        lines.push(...input.next.map((a) => `  ${formatAction(a)}`));
+    }
+    if (lines.length > input.maxLines) {
+        return [...lines.slice(0, input.maxLines - 1), `…简报已截断，完整结果见 ${input.runDir}/result.json`].join('\n');
+    }
+    return lines.join('\n');
+}
+/** 合并去重各步骤的下一步动作。 */
+export function collectNext(steps) {
+    const seen = new Set();
+    const out = [];
+    for (const step of steps) {
+        for (const action of step.next) {
+            const key = JSON.stringify({ ...action, why: undefined });
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push(action);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=brief.js.map

package/node_modules/@sumi/kernel/dist/brief.js.map

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

package/node_modules/@sumi/kernel/dist/config.d.ts

@@ -0,0 +1,40 @@
+export interface UpgradeRule {
+    paths: string[];
+    tier: string;
+}
+export interface SumiConfig {
+    tiers: string[];
+    zones: Record<string, string[]>;
+    neutral: string[];
+    exclude: string[];
+    /** 基准 ref；缺省时取当前分支上游，再缺省为空树。 */
+    base?: string;
+    upgrade: UpgradeRule[];
+    /** 启用的插件包（包名）。 */
+    packages: string[];
+    /** 本地插件目录，每个子目录含 plugin.yaml。 */
+    plugins: string[];
+    groups: Record<string, string[]>;
+    flows: string;
+    /** 兼容的 CLI 版本范围。 */
+    sumi?: string;
+    /** 精确的 CLI 构建身份；由 sumi vendor 写入。 */
+    sumiBuild?: string;
+    brief: {
+        maxLines: number;
+        maxFindings: number;
+    };
+    loop: {
+        threshold: number;
+    };
+}
+/** 首选的项目配置位置。 */
+export declare const CONFIG_FILE: "control/config.yaml";
+/** 由 CLI 在启动时设置当前版本，用于检查项目声明的兼容范围。 */
+export declare function setCliVersion(version: string | undefined): void;
+export declare function getCliVersion(): string | undefined;
+/** 由 CLI 在启动时设置当前构建身份，用于防止同版本不同内容的 CLI 混用。 */
+export declare function setCliBuild(build: string | undefined): void;
+export declare function getCliBuild(): string | undefined;
+export declare function loadConfig(root: string): SumiConfig;
+export declare function tierIndex(config: SumiConfig, tier: string): number;

package/node_modules/@sumi/kernel/dist/config.js

@@ -0,0 +1,94 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { CONFIG_FILES, configFile, satisfies } from '@sumi/plugin-sdk';
+import { parse } from 'yaml';
+import { KernelError } from './errors.js';
+/** 首选的项目配置位置。 */
+export const CONFIG_FILE = CONFIG_FILES[0];
+let cliVersion;
+let cliBuild;
+/** 由 CLI 在启动时设置当前版本，用于检查项目声明的兼容范围。 */
+export function setCliVersion(version) {
+    cliVersion = version;
+}
+export function getCliVersion() {
+    return cliVersion;
+}
+/** 由 CLI 在启动时设置当前构建身份，用于防止同版本不同内容的 CLI 混用。 */
+export function setCliBuild(build) {
+    cliBuild = build;
+}
+export function getCliBuild() {
+    return cliBuild;
+}
+const DEFAULTS = {
+    tiers: ['delta', 'runtime', 'full'],
+    zones: {},
+    neutral: [],
+    exclude: [],
+    upgrade: [],
+    packages: [],
+    plugins: [],
+    groups: {},
+    flows: 'control/flows',
+    brief: { maxLines: 40, maxFindings: 10 },
+    loop: { threshold: 3 },
+};
+const isStringArray = (v) => Array.isArray(v) && v.every((x) => typeof x === 'string');
+export function loadConfig(root) {
+    const rel = configFile(root);
+    if (!rel)
+        throw new KernelError(`缺少项目配置：${join(root, CONFIG_FILE)}（或旧位置 ${join(root, CONFIG_FILES[1])}）`);
+    const path = join(root, rel);
+    let raw;
+    try {
+        raw = parse(readFileSync(path, 'utf8')) ?? {};
+    }
+    catch (error) {
+        throw new KernelError(`项目配置无法解析：${path}：${error.message}`);
+    }
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        throw new KernelError(`项目配置必须是对象：${path}`);
+    const config = { ...DEFAULTS, ...raw };
+    config.brief = { ...DEFAULTS.brief, ...raw.brief };
+    config.loop = { ...DEFAULTS.loop, ...raw.loop };
+    const errors = [];
+    if (!isStringArray(config.tiers) || config.tiers.length === 0)
+        errors.push('tiers 必须是非空字符串数组');
+    for (const key of ['neutral', 'exclude', 'packages', 'plugins']) {
+        if (!isStringArray(config[key]))
+            errors.push(`${key} 必须是字符串数组`);
+    }
+    for (const [zone, globs] of Object.entries(config.zones ?? {})) {
+        if (!isStringArray(globs))
+            errors.push(`zones.${zone} 必须是字符串数组`);
+    }
+    for (const [group, ids] of Object.entries(config.groups ?? {})) {
+        if (!isStringArray(ids))
+            errors.push(`groups.${group} 必须是字符串数组`);
+    }
+    for (const rule of config.upgrade ?? []) {
+        if (!isStringArray(rule.paths) || !config.tiers.includes(rule.tier))
+            errors.push(`upgrade 规则非法：${JSON.stringify(rule)}`);
+    }
+    if (config.sumiBuild !== undefined && (typeof config.sumiBuild !== 'string' || !/^sha256:[0-9a-f]{64}$/.test(config.sumiBuild))) {
+        errors.push('sumiBuild 必须是 sha256:<64 位小写十六进制>');
+    }
+    if (errors.length)
+        throw new KernelError(`项目配置不合法（${path}）：${errors.join('；')}`);
+    if (config.sumi && cliVersion && !satisfies(cliVersion, config.sumi)) {
+        throw new KernelError(`当前 sumi ${cliVersion} 不满足项目要求的 ${config.sumi}，请从项目声明的 CLI 入口重新启动`);
+    }
+    if (config.sumiBuild && config.sumiBuild !== cliBuild) {
+        const current = cliBuild ?? 'unknown';
+        throw new KernelError(`当前 sumi 构建 ${current} 不满足项目要求的 ${config.sumiBuild}，请从项目声明的 CLI 入口重新启动`);
+    }
+    return config;
+}
+export function tierIndex(config, tier) {
+    const index = config.tiers.indexOf(tier);
+    if (index < 0)
+        throw new KernelError(`未知档位：${tier}（可用：${config.tiers.join(', ')}）`);
+    return index;
+}
+//# sourceMappingURL=config.js.map

package/node_modules/@sumi/kernel/dist/config.js.map

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

package/node_modules/@sumi/kernel/dist/engine.d.ts

@@ -0,0 +1,33 @@
+import type { NextAction } from '@sumi/plugin-sdk';
+import { type Conclusion, type StepRecord } from './brief.js';
+import { KernelError } from './errors.js';
+import { type RunRecord } from './record.js';
+import { type Registry } from './registry.js';
+export interface RunOptions {
+    root: string;
+    flow: string;
+    tier?: string;
+    all?: boolean;
+    base?: string;
+    labels?: Record<string, string>;
+    /** 固定提交模式：root 是该提交的独立检出，base 必须给出（null 表示空树）。 */
+    commit?: {
+        oid: string;
+        base: string | null;
+    };
+    /** 每个步骤得出结论后调用（按得出结论的先后，并发组内可能与流程顺序不同），供调用方展示进度；回调拿到副本，出错被忽略，不影响运行结果。 */
+    onStep?: (step: StepRecord) => void;
+    /** 宿主可把插件给出的逻辑动作映射为具体执行入口；内核不解释命令语义。 */
+    mapNextAction?: (action: NextAction) => NextAction;
+}
+export interface RunOutcome {
+    runId: string;
+    runDir: string;
+    conclusion: Conclusion;
+    exitCode: number;
+    brief: string;
+    record: RunRecord;
+}
+export declare function run(options: RunOptions): Promise<RunOutcome>;
+export { KernelError };
+export type { Registry };