@autopilot-agent/cli 0.0.0-stage → 0.2.0

package/dist/file-mention-context.js

@@ -0,0 +1,173 @@
+/**
+ * CLI 提交侧 @文件 mention 解析：从 prompt 原文提取 @ 引用，校验工作区边界后读取文件或
+ * 列目录一层，把有界内容以 `<system-reminder>` 附加块按出现顺序拼回 content；
+ * 失败路径（未找到/越界/过大/读取失败）降级为 notice，不阻断提交。
+ */
+import { readFile as nodeReadFile, readdir as nodeReaddir, stat as nodeStat } from "node:fs/promises";
+import path from "node:path";
+import { FILE_MENTION_TOKEN_CHARACTER } from "./tui/input/file-mention.js";
+/** 单文件扫描上限（对齐 core read_file 的 8MiB 扫描上限），超出直接拒绝。 */
+const FILE_MENTION_SIZE_LIMIT = 8 * 1024 * 1024;
+/** 附加内容行数上限，超出截断。 */
+const FILE_MENTION_LINE_LIMIT = 2000;
+/** 附加内容字节上限（UTF-8），超出截断。 */
+const FILE_MENTION_BYTES_LIMIT = 256 * 1024;
+/** 目录一层条目上限，超出截断并标注。 */
+const FILE_MENTION_DIRECTORY_LIMIT = 100;
+/** 默认接缝实现：直接使用 node:fs/promises。 */
+const nodeFileMentionFs = {
+    async stat(absolutePath) {
+        const stats = await nodeStat(absolutePath);
+        return { isFile: stats.isFile(), isDirectory: stats.isDirectory(), size: stats.size };
+    },
+    readFile(absolutePath) {
+        return nodeReadFile(absolutePath, "utf8");
+    },
+    async listDirectory(absolutePath) {
+        const entries = await nodeReaddir(absolutePath, { withFileTypes: true });
+        return entries.map(function toEntry(entry) {
+            return { name: entry.name, isDirectory: entry.isDirectory() };
+        });
+    },
+};
+/** 从 prompt 原文提取 @ 引用的相对路径；`@` 必须位于行首或空白后，去重保序，`\` 归一为 `/`。 */
+export function extractFileMentions(content) {
+    const mentions = [];
+    for (const match of content.matchAll(/(^|\s)@/gu)) {
+        // 从 @ 后取连续合法 token 字符：空白结束，中文标点等非法字符同样结束（plan 冻结的 token 字符集契约）。
+        const atEnd = match.index + match[0].length;
+        let end = atEnd;
+        while (end < content.length && FILE_MENTION_TOKEN_CHARACTER.test(content[end]))
+            end += 1;
+        if (end === atEnd)
+            continue;
+        const mentionPath = content.slice(atEnd, end).replace(/\\/g, "/");
+        if (!mentions.includes(mentionPath))
+            mentions.push(mentionPath);
+    }
+    return mentions;
+}
+/** 校验 mention 为工作区内相对路径：拒绝空路径、绝对路径、UNC/盘符与 `..` 逃逸。 */
+function isInsideWorkspace(workspaceRoot, mentionPath) {
+    if (mentionPath === "" || mentionPath.includes("\0"))
+        return false;
+    if (mentionPath.startsWith("/") || path.win32.isAbsolute(mentionPath))
+        return false;
+    const relative = path.relative(workspaceRoot, path.resolve(workspaceRoot, mentionPath));
+    return relative !== "" && !relative.startsWith("..") && !path.isAbsolute(relative);
+}
+/** 按 UTF-8 字节边界截断单行文本，回退扫描避免切断多字节字符。 */
+function truncateUtf8ByBytes(text, maxBytes) {
+    const buffer = Buffer.from(text, "utf8");
+    if (buffer.length <= maxBytes)
+        return text;
+    let end = maxBytes;
+    while (end > 0 && (buffer[end] & 0xc0) === 0x80)
+        end -= 1;
+    return buffer.subarray(0, end).toString("utf8");
+}
+/** 逐行累积保留前 2000 行且不超过 256KiB；单行超限时对该行做字节级截断兜底。 */
+function boundedFileText(text) {
+    const allLines = text.split("\n");
+    if (allLines.length > 0 && allLines[allLines.length - 1] === "")
+        allLines.pop();
+    const selected = [];
+    let bytes = 0;
+    for (const line of allLines) {
+        const lineBytes = Buffer.byteLength(line, "utf8") + (selected.length > 0 ? 1 : 0);
+        if (selected.length >= FILE_MENTION_LINE_LIMIT || bytes + lineBytes > FILE_MENTION_BYTES_LIMIT)
+            break;
+        selected.push(line);
+        bytes += lineBytes;
+    }
+    if (selected.length === 0 && allLines.length > 0) {
+        return {
+            content: truncateUtf8ByBytes(allLines[0], FILE_MENTION_BYTES_LIMIT),
+            label: `前 256KiB，共 ${allLines.length} 行`,
+        };
+    }
+    if (selected.length < allLines.length) {
+        return { content: selected.join("\n"), label: `前 ${selected.length} 行，共 ${allLines.length} 行` };
+    }
+    return { content: selected.join("\n"), label: `${allLines.length} 行` };
+}
+/** 解析单个 @ 引用；成功返回附加块小节，失败写入 notice 并返回 undefined。 */
+async function resolveSingleMention(mentionPath, workspaceRoot, fs, notices) {
+    if (!isInsideWorkspace(workspaceRoot, mentionPath)) {
+        notices.push(`@${mentionPath} 超出工作区边界，已拒绝读取`);
+        return undefined;
+    }
+    const absolutePath = path.resolve(workspaceRoot, mentionPath);
+    let stats;
+    try {
+        stats = await fs.stat(absolutePath);
+    }
+    catch {
+        notices.push(`@${mentionPath} 未找到`);
+        return undefined;
+    }
+    if (stats.isFile) {
+        if (stats.size > FILE_MENTION_SIZE_LIMIT) {
+            notices.push(`@${mentionPath} 超过 8MiB，已拒绝读取`);
+            return undefined;
+        }
+        let text;
+        try {
+            text = await fs.readFile(absolutePath);
+        }
+        catch {
+            notices.push(`@${mentionPath} 读取失败`);
+            return undefined;
+        }
+        const bounded = boundedFileText(text);
+        return `--- @${mentionPath} (${bounded.label}) ---\n${bounded.content}`;
+    }
+    if (stats.isDirectory) {
+        let entries;
+        try {
+            entries = await fs.listDirectory(absolutePath);
+        }
+        catch {
+            notices.push(`@${mentionPath} 读取失败`);
+            return undefined;
+        }
+        const sorted = entries.slice().sort(function compareEntries(left, right) {
+            return left.name.localeCompare(right.name);
+        });
+        const selected = sorted.slice(0, FILE_MENTION_DIRECTORY_LIMIT);
+        const label = sorted.length > FILE_MENTION_DIRECTORY_LIMIT
+            ? `前 ${FILE_MENTION_DIRECTORY_LIMIT} 项，共 ${sorted.length} 项`
+            : `${sorted.length} 项`;
+        const content = selected
+            .map(function renderEntry(entry) {
+            return entry.isDirectory ? `${entry.name}/` : entry.name;
+        })
+            .join("\n");
+        return `--- @${mentionPath} (${label}) ---\n${content}`;
+    }
+    notices.push(`@${mentionPath} 未找到`);
+    return undefined;
+}
+/** 解析 prompt 中的全部 @ 引用并构造增强 content；至少一个引用成功时在原文后追加附加块。 */
+export async function resolveFileMentionContext(content, workspaceRoot, options = {}) {
+    const mentions = extractFileMentions(content);
+    if (mentions.length === 0)
+        return { content, notices: [] };
+    const fs = options.fs ?? nodeFileMentionFs;
+    const sections = [];
+    const notices = [];
+    for (const mentionPath of mentions) {
+        const section = await resolveSingleMention(mentionPath, workspaceRoot, fs, notices);
+        if (section !== undefined)
+            sections.push(section);
+    }
+    if (sections.length === 0)
+        return { content, notices };
+    const block = [
+        "<system-reminder>",
+        "用户通过 @ 引用了以下工作区文件，内容已直接附加：",
+        ...sections,
+        "</system-reminder>",
+    ].join("\n");
+    return { content: `${content}\n\n${block}`, notices };
+}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @autopilot-agent/cli — Step 5.2 CLI 宿主壳公开出口。
+ *
+ * 这里只暴露 parser、Composition Root、Controller、事件投影和 Plain Renderer；
+ * 不暴露 Core private 类型，不加载 React/Ink，也不在模块导入时启动 Runtime。
+ */
+export { createCliCompositionRoot } from "./composition-root.js";
+export type { CliCapabilityLoader, CliCompositionRoot, CreateCliCompositionRootOptions } from "./composition-root.js";
+export { exitCodeForSignal, main } from "./main.js";
+export type { CliMainStreams } from "./main.js";
+export { createCliController, commandToAction } from "./controller.js";
+export type { CliApprovalSubmit, CliController, CliControllerResult, CreateCliControllerOptions, } from "./controller.js";
+export { createCliEventProjector, createInitialCliProjection, reduceCliEvent } from "./event-projector.js";
+export { createPlainRenderer } from "./renderer.js";
+export { parseArgv, parseSlashAction, renderHelp } from "./parser.js";
+export type { CliAction, CliActionParseResult, CliCommand, CliEventEnvelope, CliEventListener, CliQueuedInputStarted, CliQueuedInputStartedListener, CliExitCode, CliHostOptions, CliInvocation, CliOutputFormat, CliPermissionMode, CliPermissionOption, CliParseResult, CliProjection, CliPublicEvent, CliRenderer, CliStatusView, CliRuntime, CliTurnStatus, } from "./types.js";
+export { createCliTuiStore, runCliTui } from "./tui.js";
+export type { CliTuiInitialOperation, CliTuiRecap, CliTuiSnapshot, CliTuiStore, CliTuiTranscriptItem, RunCliTuiOptions, RunCliTuiResult, } from "./tui.js";
+export { formatCliTuiRecap } from "./tui.js";

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @autopilot-agent/cli — Step 5.2 CLI 宿主壳公开出口。
+ *
+ * 这里只暴露 parser、Composition Root、Controller、事件投影和 Plain Renderer；
+ * 不暴露 Core private 类型，不加载 React/Ink，也不在模块导入时启动 Runtime。
+ */
+export { createCliCompositionRoot } from "./composition-root.js";
+export { exitCodeForSignal, main } from "./main.js";
+export { createCliController, commandToAction } from "./controller.js";
+export { createCliEventProjector, createInitialCliProjection, reduceCliEvent } from "./event-projector.js";
+export { createPlainRenderer } from "./renderer.js";
+export { parseArgv, parseSlashAction, renderHelp } from "./parser.js";
+export { createCliTuiStore, runCliTui } from "./tui.js";
+export { formatCliTuiRecap } from "./tui.js";

package/dist/main.d.ts

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * agent CLI 的 Step 5.3 运行入口。
+ *
+ * 入口只负责 argv、Composition Root、Plain Controller 和进程生命周期的编排；
+ * Session、Turn、审批、恢复和持久化规则全部委托给 Core Runtime。
+ */
+import { type CliCompositionRoot, type CreateCliCompositionRootOptions } from "./composition-root.js";
+import type { CliExitCode } from "./types.js";
+/** CLI 主入口使用的最小输出/输入流接口。 */
+export interface CliMainStreams {
+    stdout: {
+        write(chunk: string): void;
+        isTTY?: boolean;
+        columns?: number;
+    };
+    stderr: {
+        write(chunk: string): void;
+        isTTY?: boolean;
+    };
+    stdin?: (NodeJS.ReadableStream & {
+        isTTY?: boolean;
+    });
+}
+/** CLI 可监听的进程信号来源；抽象后可测试且不会残留真实监听器。 */
+export interface CliSignalSource {
+    on(signal: "SIGINT" | "SIGTERM", listener: () => void): void;
+    removeListener(signal: "SIGINT" | "SIGTERM", listener: () => void): void;
+}
+/** CLI 运行依赖；生产入口使用真实 Composition Root 和 process，测试可注入 double。 */
+export interface CliMainDependencies {
+    createCompositionRoot?: (options: CreateCliCompositionRootOptions) => CliCompositionRoot;
+    signalSource?: CliSignalSource;
+    forceExit?: (code: 130) => void;
+    cwd?: string;
+}
+/** 将宿主信号映射为固定 CLI 退出码。 */
+export declare function exitCodeForSignal(signal: "SIGINT" | "SIGTERM"): 130 | 143;
+/** 执行 Step 5.3 CLI 入口并返回固定退出码。 */
+export declare function main(argv?: readonly string[], streams?: CliMainStreams, dependencies?: CliMainDependencies): Promise<CliExitCode>;