cscec-super-code 0.0.53

package/dist/features/background-agent/background-task-notification-template.d.ts

@@ -0,0 +1,10 @@
+import type { BackgroundTask } from "./types";
+export type BackgroundTaskNotificationStatus = "COMPLETED" | "CANCELLED" | "INTERRUPTED";
+export declare function buildBackgroundTaskNotificationText(input: {
+    task: BackgroundTask;
+    duration: string;
+    statusText: BackgroundTaskNotificationStatus;
+    allComplete: boolean;
+    remainingCount: number;
+    completedTasks: BackgroundTask[];
+}): string;

package/dist/features/background-agent/compaction-aware-message-resolver.d.ts

@@ -0,0 +1,3 @@
+import type { StoredMessage } from "../hook-message-injector";
+export declare function isCompactionAgent(agent: string | undefined): boolean;
+export declare function findNearestMessageExcludingCompaction(messageDir: string): StoredMessage | null;

package/dist/features/background-agent/concurrency.d.ts

@@ -0,0 +1,27 @@
+import type { BackgroundTaskConfig } from "../../config/schema";
+export declare class ConcurrencyManager {
+    private config?;
+    private counts;
+    private queues;
+    constructor(config?: BackgroundTaskConfig);
+    getConcurrencyLimit(model: string): number;
+    acquire(model: string): Promise<void>;
+    release(model: string): void;
+    /**
+     * Cancel all waiting acquires for a model. Used during cleanup.
+     */
+    cancelWaiters(model: string): void;
+    /**
+     * Clear all state. Used during manager cleanup/shutdown.
+     * Cancels all pending waiters.
+     */
+    clear(): void;
+    /**
+     * Get current count for a model (for testing/debugging)
+     */
+    getCount(model: string): number;
+    /**
+     * Get queue length for a model (for testing/debugging)
+     */
+    getQueueLength(model: string): number;
+}

package/dist/features/background-agent/constants.d.ts

@@ -0,0 +1,45 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { BackgroundTask, LaunchInput } from "./types";
+export declare const TASK_TTL_MS: number;
+export declare const MIN_STABILITY_TIME_MS: number;
+export declare const DEFAULT_STALE_TIMEOUT_MS = 180000;
+export declare const DEFAULT_MESSAGE_STALENESS_TIMEOUT_MS = 600000;
+export declare const MIN_RUNTIME_BEFORE_STALE_MS = 30000;
+export declare const MIN_IDLE_TIME_MS = 5000;
+export declare const POLLING_INTERVAL_MS = 3000;
+export declare const TASK_CLEANUP_DELAY_MS: number;
+export declare const TMUX_CALLBACK_DELAY_MS = 200;
+export type ProcessCleanupEvent = NodeJS.Signals | "beforeExit" | "exit";
+export type OpencodeClient = PluginInput["client"];
+export interface MessagePartInfo {
+    sessionID?: string;
+    type?: string;
+    tool?: string;
+}
+export interface EventProperties {
+    sessionID?: string;
+    info?: {
+        id?: string;
+    };
+    [key: string]: unknown;
+}
+export interface BackgroundEvent {
+    type: string;
+    properties?: EventProperties;
+}
+export interface Todo {
+    content: string;
+    status: string;
+    priority: string;
+    id?: string;
+}
+export interface QueueItem {
+    task: BackgroundTask;
+    input: LaunchInput;
+}
+export interface SubagentSessionCreatedEvent {
+    sessionID: string;
+    parentID: string;
+    title: string;
+}
+export type OnSubagentSessionCreated = (event: SubagentSessionCreatedEvent) => Promise<void>;

package/dist/features/background-agent/duration-formatter.d.ts

@@ -0,0 +1 @@
+export declare function formatDuration(start: Date, end?: Date): string;

package/dist/features/background-agent/error-classifier.d.ts

@@ -0,0 +1,10 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function isAbortedSessionError(error: unknown): boolean;
+export declare function getErrorText(error: unknown): string;
+export declare function extractErrorName(error: unknown): string | undefined;
+export declare function extractErrorMessage(error: unknown): string | undefined;
+interface EventPropertiesLike {
+    [key: string]: unknown;
+}
+export declare function getSessionErrorMessage(properties: EventPropertiesLike): string | undefined;
+export {};

package/dist/features/background-agent/fallback-retry-handler.d.ts

@@ -0,0 +1,16 @@
+import type { BackgroundTask } from "./types";
+import type { ConcurrencyManager } from "./concurrency";
+import type { OpencodeClient, QueueItem } from "./constants";
+export declare function tryFallbackRetry(args: {
+    task: BackgroundTask;
+    errorInfo: {
+        name?: string;
+        message?: string;
+    };
+    source: string;
+    concurrencyManager: ConcurrencyManager;
+    client: OpencodeClient;
+    idleDeferralTimers: Map<string, ReturnType<typeof setTimeout>>;
+    queuesByKey: Map<string, QueueItem[]>;
+    processKey: (key: string) => void;
+}): boolean;

package/dist/features/background-agent/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export { BackgroundManager, type SubagentSessionCreatedEvent, type OnSubagentSessionCreated } from "./manager";

package/dist/features/background-agent/manager.d.ts

@@ -0,0 +1,140 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { BackgroundTask, LaunchInput, ResumeInput } from "./types";
+import { TaskHistory } from "./task-history";
+import type { BackgroundTaskConfig, TmuxConfig } from "../../config/schema";
+interface EventProperties {
+    sessionID?: string;
+    info?: {
+        id?: string;
+    };
+    [key: string]: unknown;
+}
+interface Event {
+    type: string;
+    properties?: EventProperties;
+}
+export interface SubagentSessionCreatedEvent {
+    sessionID: string;
+    parentID: string;
+    title: string;
+}
+export type OnSubagentSessionCreated = (event: SubagentSessionCreatedEvent) => Promise<void>;
+export declare class BackgroundManager {
+    private tasks;
+    private notifications;
+    private pendingNotifications;
+    private pendingByParent;
+    private client;
+    private directory;
+    private pollingInterval?;
+    private pollingInFlight;
+    private concurrencyManager;
+    private shutdownTriggered;
+    private config?;
+    private tmuxEnabled;
+    private onSubagentSessionCreated?;
+    private onShutdown?;
+    private queuesByKey;
+    private processingKeys;
+    private completionTimers;
+    private idleDeferralTimers;
+    private notificationQueueByParent;
+    private enableParentSessionNotifications;
+    readonly taskHistory: TaskHistory;
+    constructor(ctx: PluginInput, config?: BackgroundTaskConfig, options?: {
+        tmuxConfig?: TmuxConfig;
+        onSubagentSessionCreated?: OnSubagentSessionCreated;
+        onShutdown?: () => void;
+        enableParentSessionNotifications?: boolean;
+    });
+    launch(input: LaunchInput): Promise<BackgroundTask>;
+    private processKey;
+    private startTask;
+    getTask(id: string): BackgroundTask | undefined;
+    getTasksByParentSession(sessionID: string): BackgroundTask[];
+    getAllDescendantTasks(sessionID: string): BackgroundTask[];
+    findBySession(sessionID: string): BackgroundTask | undefined;
+    private getConcurrencyKeyFromInput;
+    /**
+     * Track a task created elsewhere (e.g., from task) for notification tracking.
+     * This allows tasks created by other tools to receive the same toast/prompt notifications.
+     */
+    trackTask(input: {
+        taskId: string;
+        sessionID: string;
+        parentSessionID: string;
+        description: string;
+        agent?: string;
+        parentAgent?: string;
+        concurrencyKey?: string;
+    }): Promise<BackgroundTask>;
+    resume(input: ResumeInput): Promise<BackgroundTask>;
+    private checkSessionTodos;
+    handleEvent(event: Event): void;
+    private tryFallbackRetry;
+    markForNotification(task: BackgroundTask): void;
+    getPendingNotifications(sessionID: string): BackgroundTask[];
+    clearNotifications(sessionID: string): void;
+    queuePendingNotification(sessionID: string | undefined, notification: string): void;
+    injectPendingNotificationsIntoChatMessage(output: {
+        parts: Array<{
+            type: string;
+            text?: string;
+            [key: string]: unknown;
+        }>;
+    }, sessionID: string): void;
+    /**
+     * Validates that a session has actual assistant/tool output before marking complete.
+     * Prevents premature completion when session.idle fires before agent responds.
+     */
+    private validateSessionHasOutput;
+    private clearNotificationsForTask;
+    /**
+     * Remove task from pending tracking for its parent session.
+     * Cleans up the parent entry if no pending tasks remain.
+     */
+    private cleanupPendingByParent;
+    cancelTask(taskId: string, options?: {
+        source?: string;
+        reason?: string;
+        abortSession?: boolean;
+        skipNotification?: boolean;
+    }): Promise<boolean>;
+    /**
+     * Cancels a pending task by removing it from queue and marking as cancelled.
+     * Does NOT abort session (no session exists yet) or release concurrency slot (wasn't acquired).
+     */
+    cancelPendingTask(taskId: string): boolean;
+    private startPolling;
+    private stopPolling;
+    private registerProcessCleanup;
+    private unregisterProcessCleanup;
+    /**
+     * Get all running tasks (for compaction hook)
+     */
+    getRunningTasks(): BackgroundTask[];
+    /**
+     * Get all non-running tasks still in memory (for compaction hook)
+     */
+    getNonRunningTasks(): BackgroundTask[];
+    /**
+     * Safely complete a task with race condition protection.
+     * Returns true if task was successfully completed, false if already completed by another path.
+     */
+    private tryCompleteTask;
+    private notifyParentSession;
+    private formatDuration;
+    private isAbortedSessionError;
+    private hasRunningTasks;
+    private pruneStaleTasksAndNotifications;
+    private checkAndInterruptStaleTasks;
+    private pollRunningTasks;
+    /**
+     * Shutdown the manager gracefully.
+     * Cancels all pending concurrency waiters and clears timers.
+     * Should be called when the plugin is unloaded.
+     */
+    shutdown(): void;
+    private enqueueNotificationForParent;
+}
+export {};

package/dist/features/background-agent/opencode-client.d.ts

@@ -0,0 +1,2 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export type OpencodeClient = PluginInput["client"];

package/dist/features/background-agent/process-cleanup.d.ts

@@ -0,0 +1,8 @@
+interface CleanupTarget {
+    shutdown(): void;
+}
+export declare function registerManagerForCleanup(manager: CleanupTarget): void;
+export declare function unregisterManagerForCleanup(manager: CleanupTarget): void;
+/** @internal — test-only reset for module-level singleton state */
+export declare function _resetForTesting(): void;
+export {};

package/dist/features/background-agent/session-idle-event-handler.d.ts

@@ -0,0 +1,10 @@
+import type { BackgroundTask } from "./types";
+export declare function handleSessionIdleBackgroundEvent(args: {
+    properties: Record<string, unknown>;
+    findBySession: (sessionID: string) => BackgroundTask | undefined;
+    idleDeferralTimers: Map<string, ReturnType<typeof setTimeout>>;
+    validateSessionHasOutput: (sessionID: string) => Promise<boolean>;
+    checkSessionTodos: (sessionID: string) => Promise<boolean>;
+    tryCompleteTask: (task: BackgroundTask, source: string) => Promise<boolean>;
+    emitIdleEvent: (sessionID: string) => void;
+}): void;

package/dist/features/background-agent/spawner/parent-directory-resolver.d.ts

@@ -0,0 +1,6 @@
+import type { OpencodeClient } from "../constants";
+export declare function resolveParentDirectory(options: {
+    client: OpencodeClient;
+    parentSessionID: string;
+    defaultDirectory: string;
+}): Promise<string>;

package/dist/features/background-agent/spawner.d.ts

@@ -0,0 +1,14 @@
+import type { BackgroundTask, LaunchInput, ResumeInput } from "./types";
+import type { OpencodeClient, OnSubagentSessionCreated, QueueItem } from "./constants";
+import type { ConcurrencyManager } from "./concurrency";
+export interface SpawnerContext {
+    client: OpencodeClient;
+    directory: string;
+    concurrencyManager: ConcurrencyManager;
+    tmuxEnabled: boolean;
+    onSubagentSessionCreated?: OnSubagentSessionCreated;
+    onTaskError: (task: BackgroundTask, error: Error) => void;
+}
+export declare function createTask(input: LaunchInput): BackgroundTask;
+export declare function startTask(item: QueueItem, ctx: SpawnerContext): Promise<void>;
+export declare function resumeTask(task: BackgroundTask, input: ResumeInput, ctx: Pick<SpawnerContext, "client" | "concurrencyManager" | "onTaskError">): Promise<void>;

package/dist/features/background-agent/state.d.ts

@@ -0,0 +1,35 @@
+import type { BackgroundTask, LaunchInput } from "./types";
+import type { QueueItem } from "./constants";
+export declare class TaskStateManager {
+    readonly tasks: Map<string, BackgroundTask>;
+    readonly notifications: Map<string, BackgroundTask[]>;
+    readonly pendingByParent: Map<string, Set<string>>;
+    readonly queuesByKey: Map<string, QueueItem[]>;
+    readonly processingKeys: Set<string>;
+    readonly completionTimers: Map<string, ReturnType<typeof setTimeout>>;
+    getTask(id: string): BackgroundTask | undefined;
+    findBySession(sessionID: string): BackgroundTask | undefined;
+    getTasksByParentSession(sessionID: string): BackgroundTask[];
+    getAllDescendantTasks(sessionID: string): BackgroundTask[];
+    getRunningTasks(): BackgroundTask[];
+    getNonRunningTasks(): BackgroundTask[];
+    hasRunningTasks(): boolean;
+    getConcurrencyKeyFromInput(input: LaunchInput): string;
+    getConcurrencyKeyFromTask(task: BackgroundTask): string;
+    addTask(task: BackgroundTask): void;
+    removeTask(taskId: string): void;
+    trackPendingTask(parentSessionID: string, taskId: string): void;
+    cleanupPendingByParent(task: BackgroundTask): void;
+    markForNotification(task: BackgroundTask): void;
+    getPendingNotifications(sessionID: string): BackgroundTask[];
+    clearNotifications(sessionID: string): void;
+    clearNotificationsForTask(taskId: string): void;
+    addToQueue(key: string, item: QueueItem): void;
+    getQueue(key: string): QueueItem[] | undefined;
+    removeFromQueue(key: string, taskId: string): boolean;
+    setCompletionTimer(taskId: string, timer: ReturnType<typeof setTimeout>): void;
+    clearCompletionTimer(taskId: string): void;
+    clearAllCompletionTimers(): void;
+    clear(): void;
+    cancelPendingTask(taskId: string): boolean;
+}

package/dist/features/background-agent/task-history.d.ts

@@ -0,0 +1,18 @@
+import type { BackgroundTaskStatus } from "./types";
+export interface TaskHistoryEntry {
+    id: string;
+    sessionID?: string;
+    agent: string;
+    description: string;
+    status: BackgroundTaskStatus;
+    category?: string;
+    startedAt?: Date;
+    completedAt?: Date;
+}
+export declare class TaskHistory {
+    private entries;
+    record(parentSessionID: string | undefined, entry: TaskHistoryEntry): void;
+    getByParentSession(parentSessionID: string): TaskHistoryEntry[];
+    clearSession(parentSessionID: string): void;
+    formatForCompaction(parentSessionID: string): string | null;
+}

package/dist/features/background-agent/task-poller.d.ts

@@ -0,0 +1,20 @@
+import type { BackgroundTaskConfig } from "../../config/schema";
+import type { BackgroundTask } from "./types";
+import type { ConcurrencyManager } from "./concurrency";
+import type { OpencodeClient } from "./opencode-client";
+export declare function pruneStaleTasksAndNotifications(args: {
+    tasks: Map<string, BackgroundTask>;
+    notifications: Map<string, BackgroundTask[]>;
+    onTaskPruned: (taskId: string, task: BackgroundTask, errorMessage: string) => void;
+}): void;
+export type SessionStatusMap = Record<string, {
+    type: string;
+}>;
+export declare function checkAndInterruptStaleTasks(args: {
+    tasks: Iterable<BackgroundTask>;
+    client: OpencodeClient;
+    config: BackgroundTaskConfig | undefined;
+    concurrencyManager: ConcurrencyManager;
+    notifyParentSession: (task: BackgroundTask) => Promise<void>;
+    sessionStatuses?: SessionStatusMap;
+}): Promise<void>;

package/dist/features/background-agent/types.d.ts

@@ -0,0 +1,90 @@
+import type { FallbackEntry } from "../../shared/model-requirements";
+export type BackgroundTaskStatus = "pending" | "running" | "completed" | "error" | "cancelled" | "interrupt";
+export interface TaskProgress {
+    toolCalls: number;
+    lastTool?: string;
+    lastUpdate: Date;
+    lastMessage?: string;
+    lastMessageAt?: Date;
+}
+export interface BackgroundTask {
+    id: string;
+    sessionID?: string;
+    parentSessionID: string;
+    parentMessageID: string;
+    description: string;
+    prompt: string;
+    agent: string;
+    status: BackgroundTaskStatus;
+    queuedAt?: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    result?: string;
+    error?: string;
+    progress?: TaskProgress;
+    parentModel?: {
+        providerID: string;
+        modelID: string;
+    };
+    model?: {
+        providerID: string;
+        modelID: string;
+        variant?: string;
+    };
+    /** Fallback chain for runtime retry on model errors */
+    fallbackChain?: FallbackEntry[];
+    /** Number of fallback retry attempts made */
+    attemptCount?: number;
+    /** Active concurrency slot key */
+    concurrencyKey?: string;
+    /** Persistent key for re-acquiring concurrency on resume */
+    concurrencyGroup?: string;
+    /** Parent session's agent name for notification */
+    parentAgent?: string;
+    /** Parent session's tool restrictions for notification prompts */
+    parentTools?: Record<string, boolean>;
+    /** Marks if the task was launched from an unstable agent/category */
+    isUnstableAgent?: boolean;
+    /** Category used for this task (e.g., 'quick', 'visual-engineering') */
+    category?: string;
+    /** Last message count for stability detection */
+    lastMsgCount?: number;
+    /** Number of consecutive polls with stable message count */
+    stablePolls?: number;
+}
+export interface LaunchInput {
+    description: string;
+    prompt: string;
+    agent: string;
+    parentSessionID: string;
+    parentMessageID: string;
+    parentModel?: {
+        providerID: string;
+        modelID: string;
+    };
+    parentAgent?: string;
+    parentTools?: Record<string, boolean>;
+    model?: {
+        providerID: string;
+        modelID: string;
+        variant?: string;
+    };
+    /** Fallback chain for runtime retry on model errors */
+    fallbackChain?: FallbackEntry[];
+    isUnstableAgent?: boolean;
+    skills?: string[];
+    skillContent?: string;
+    category?: string;
+}
+export interface ResumeInput {
+    sessionId: string;
+    prompt: string;
+    parentSessionID: string;
+    parentMessageID: string;
+    parentModel?: {
+        providerID: string;
+        modelID: string;
+    };
+    parentAgent?: string;
+    parentTools?: Record<string, boolean>;
+}

package/dist/features/boulder-state/constants.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Boulder State Constants
+ */
+export declare const BOULDER_DIR = ".yugong";
+export declare const BOULDER_FILE = "boulder.json";
+export declare const BOULDER_STATE_PATH = ".yugong/boulder.json";
+export declare const NOTEPAD_DIR = "notepads";
+export declare const NOTEPAD_BASE_PATH = ".yugong/notepads";
+/** Suirenshi plan directory pattern */
+export declare const SUIRENSHI_PLANS_DIR = ".yugong/plans";

package/dist/features/boulder-state/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./constants";
+export * from "./storage";

package/dist/features/boulder-state/storage.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Boulder State Storage
+ *
+ * Handles reading/writing boulder.json for active plan tracking.
+ */
+import type { BoulderState, PlanProgress } from "./types";
+export declare function getBoulderFilePath(directory: string): string;
+export declare function readBoulderState(directory: string): BoulderState | null;
+export declare function writeBoulderState(directory: string, state: BoulderState): boolean;
+export declare function appendSessionId(directory: string, sessionId: string): BoulderState | null;
+export declare function clearBoulderState(directory: string): boolean;
+/**
+ * Find Suirenshi plan files for this project.
+ * Suirenshi stores plans at: {project}/.yugong/plans/{name}.md
+ */
+export declare function findSuirenshiPlans(directory: string): string[];
+/**
+ * Parse a plan file and count checkbox progress.
+ */
+export declare function getPlanProgress(planPath: string): PlanProgress;
+/**
+ * Extract plan name from file path.
+ */
+export declare function getPlanName(planPath: string): string;
+/**
+ * Create a new boulder state for a plan.
+ */
+export declare function createBoulderState(planPath: string, sessionId: string, agent?: string, worktreePath?: string): BoulderState;

package/dist/features/boulder-state/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Boulder State Types
+ *
+ * Manages the active work plan state for Yugong orchestrator.
+ * Named after Yugong's boulder - the eternal task that must be rolled.
+ */
+export interface BoulderState {
+    /** Absolute path to the active plan file */
+    active_plan: string;
+    /** ISO timestamp when work started */
+    started_at: string;
+    /** Session IDs that have worked on this plan */
+    session_ids: string[];
+    /** Plan name derived from filename */
+    plan_name: string;
+    /** Agent type to use when resuming (e.g., 'buzhoushan') */
+    agent?: string;
+    /** Absolute path to the git worktree root where work happens */
+    worktree_path?: string;
+}
+export interface PlanProgress {
+    /** Total number of checkboxes */
+    total: number;
+    /** Number of completed checkboxes */
+    completed: number;
+    /** Whether all tasks are done */
+    isComplete: boolean;
+}

package/dist/features/builtin-commands/commands.d.ts

@@ -0,0 +1,2 @@
+import type { BuiltinCommandName, BuiltinCommands } from "./types";
+export declare function loadBuiltinCommands(disabledCommands?: BuiltinCommandName[]): BuiltinCommands;

package/dist/features/builtin-commands/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./commands";

package/dist/features/builtin-commands/templates/handoff.d.ts

@@ -0,0 +1 @@
+export declare const HANDOFF_TEMPLATE = "# Handoff \u547D\u4EE4\n\n## \u76EE\u7684\n\n\u5728\u4EE5\u4E0B\u60C5\u51B5\u4F7F\u7528 /handoff:\n- \u5F53\u524D\u4F1A\u8BDD\u4E0A\u4E0B\u6587\u53D8\u5F97\u592A\u957F\uFF0C\u8D28\u91CF\u5728\u4E0B\u964D\n- \u4F60\u60F3\u5728\u4FDD\u7559\u672C\u4F1A\u8BDD\u5173\u952E\u4E0A\u4E0B\u6587\u7684\u540C\u65F6\u91CD\u65B0\u5F00\u59CB\n- \u4E0A\u4E0B\u6587\u7A97\u53E3\u63A5\u8FD1\u5BB9\u91CF\n\n\u8FD9\u5C06\u521B\u5EFA\u4E00\u4E2A\u8BE6\u7EC6\u7684\u4E0A\u4E0B\u6587\u6458\u8981\uFF0C\u53EF\u7528\u4E8E\u5728\u65B0\u4F1A\u8BDD\u4E2D\u7EE7\u7EED\u5DE5\u4F5C\u3002\n\n---\n\n# \u9636\u6BB5 0: \u9A8C\u8BC1\u8BF7\u6C42\n\n\u7EE7\u7EED\u4E4B\u524D\uFF0C\u786E\u8BA4:\n- [ ] \u672C\u4F1A\u8BDD\u6709\u6709\u610F\u4E49\u7684\u5DE5\u4F5C\u6216\u4E0A\u4E0B\u6587\u9700\u8981\u4FDD\u7559\n- [ ] \u7528\u6237\u60F3\u8981\u521B\u5EFA handoff \u6458\u8981 (\u800C\u4E0D\u4EC5\u4EC5\u662F\u8BE2\u95EE\u5B83)\n\n\u5982\u679C\u4F1A\u8BDD\u51E0\u4E4E\u4E3A\u7A7A\u6216\u6CA1\u6709\u6709\u610F\u4E49\u7684\u4E0A\u4E0B\u6587\uFF0C\u901A\u77E5\u7528\u6237\u6CA1\u6709\u5B9E\u8D28\u6027\u7684\u5185\u5BB9\u53EF\u4EE5\u4EA4\u63A5\u3002\n\n---\n\n# \u9636\u6BB5 1: \u6536\u96C6\u7A0B\u5E8F\u5316\u4E0A\u4E0B\u6587\n\n\u6267\u884C\u8FD9\u4E9B\u5DE5\u5177\u6536\u96C6\u5177\u4F53\u6570\u636E:\n\n1. session_read({ session_id: \"$SESSION_ID\" }) \u2014 \u5B8C\u6574\u4F1A\u8BDD\u5386\u53F2\n2. todoread() \u2014 \u5F53\u524D\u4EFB\u52A1\u8FDB\u5EA6\n3. Bash({ command: \"git diff --stat HEAD~10..HEAD\" }) \u2014 \u8FD1\u671F\u6587\u4EF6\u66F4\u6539\n4. Bash({ command: \"git status --porcelain\" }) \u2014 \u672A\u63D0\u4EA4\u7684\u66F4\u6539\n\n\u5EFA\u8BAE\u6267\u884C\u987A\u5E8F:\n\n```\nsession_read({ session_id: \"$SESSION_ID\" })\ntodoread()\nBash({ command: \"git diff --stat HEAD~10..HEAD\" })\nBash({ command: \"git status --porcelain\" })\n```\n\n\u5206\u6790\u6536\u96C6\u7684\u8F93\u51FA\u4EE5\u4E86\u89E3:\n- \u7528\u6237\u8981\u6C42\u4EC0\u4E48 (\u786E\u5207\u63AA\u8F9E)\n- \u5B8C\u6210\u4E86\u4EC0\u4E48\u5DE5\u4F5C\n- \u54EA\u4E9B\u4EFB\u52A1\u4ECD\u672A\u5B8C\u6210 (\u5305\u62EC todo \u72B6\u6001)\n- \u505A\u4E86\u4EC0\u4E48\u51B3\u7B56\n- \u4FEE\u6539\u6216\u8BA8\u8BBA\u4E86\u54EA\u4E9B\u6587\u4EF6 (\u5305\u62EC git diff/stat + status)\n- \u786E\u7ACB\u4E86\u54EA\u4E9B\u6A21\u5F0F\u3001\u7EA6\u675F\u6216\u504F\u597D\n\n---\n\n# \u9636\u6BB5 2: \u63D0\u53D6\u4E0A\u4E0B\u6587\n\n\u4EE5\u7B2C\u4E00\u4EBA\u79F0\u89C6\u89D2\u7F16\u5199\u4E0A\u4E0B\u6587\u6458\u8981 (\"\u6211\u505A\u4E86...\", \"\u6211\u544A\u8BC9\u4F60...\")\u3002\n\n\u91CD\u70B9\u5173\u6CE8:\n- \u80FD\u529B\u548C\u884C\u4E3A\uFF0C\u800C\u4E0D\u662F\u9010\u6587\u4EF6\u7684\u5B9E\u73B0\u7EC6\u8282\n- \u5BF9\u7EE7\u7EED\u5DE5\u4F5C\u91CD\u8981\u7684\u4E8B\u60C5\n- \u907F\u514D\u8FC7\u591A\u7684\u5B9E\u73B0\u7EC6\u8282 (\u53D8\u91CF\u540D\u3001\u5B58\u50A8\u952E\u3001\u5E38\u91CF) \u9664\u975E\u5173\u952E\n- \u7528\u6237\u8BF7\u6C42 (\u539F\u6587) \u5FC5\u987B\u9010\u5B57\u5F15\u7528 (\u4E0D\u8981\u6539\u5199)\n- \u660E\u786E\u7EA6\u675F \u5FC5\u987B\u9010\u5B57\u5F15\u7528 (\u4E0D\u8981\u7F16\u9020)\n\n\u63D0\u53D6\u65F6\u8003\u8651\u7684\u95EE\u9898:\n- \u6211\u521A\u521A\u505A\u4E86\u4EC0\u4E48\u6216\u5B9E\u73B0\u4E86\u4EC0\u4E48\uFF1F\n- \u6211\u5DF2\u7ECF\u7ED9\u51FA\u7684\u54EA\u4E9B\u6307\u793A\u4ECD\u7136\u76F8\u5173 (\u4F8B\u5982\u9075\u5FAA\u4EE3\u7801\u5E93\u4E2D\u7684\u6A21\u5F0F)\uFF1F\n- \u6211\u544A\u8BC9\u4F60\u54EA\u4E9B\u6587\u4EF6\u91CD\u8981\u6216\u6211\u6B63\u5728\u5904\u7406\uFF1F\n- \u6211\u662F\u5426\u63D0\u4F9B\u4E86\u5E94\u8BE5\u5305\u542B\u7684\u8BA1\u5212\u6216\u89C4\u683C\uFF1F\n- \u6211\u544A\u8BC9\u4F60\u54EA\u4E9B\u91CD\u8981\u7684\u4E8B\u60C5 (\u5E93\u3001\u6A21\u5F0F\u3001\u7EA6\u675F\u3001\u504F\u597D)\uFF1F\n- \u6211\u53D1\u73B0\u4E86\u54EA\u4E9B\u91CD\u8981\u7684\u6280\u672F\u7EC6\u8282 (API\u3001\u65B9\u6CD5\u3001\u6A21\u5F0F)\uFF1F\n- \u6211\u53D1\u73B0\u4E86\u54EA\u4E9B\u6CE8\u610F\u4E8B\u9879\u3001\u9650\u5236\u6216\u5F00\u653E\u95EE\u9898\uFF1F\n\n---\n\n# \u9636\u6BB5 3: \u683C\u5F0F\u5316\u8F93\u51FA\n\n\u4F7F\u7528\u4EE5\u4E0B\u786E\u5207\u683C\u5F0F\u751F\u6210 handoff \u6458\u8981:\n\n```\n\u4EA4\u63A5\u4E0A\u4E0B\u6587\n==============\n\n\u7528\u6237\u8BF7\u6C42 (\u539F\u6587)\n---------------------\n- [\u9010\u5B57\u7684\u7528\u6237\u8BF7\u6C42 - \u672A\u6539\u5199]\n\n\u76EE\u6807\n----\n[\u4E00\u53E5\u8BDD\u63CF\u8FF0\u63A5\u4E0B\u6765\u5E94\u8BE5\u505A\u4EC0\u4E48]\n\n\u5DF2\u5B8C\u6210\u7684\u5DE5\u4F5C\n--------------\n- [\u4EE5\u7B2C\u4E00\u4EBA\u79F0\u5217\u51FA\u6240\u505A\u4E4B\u4E8B]\n- [\u76F8\u5173\u65F6\u5305\u542B\u5177\u4F53\u6587\u4EF6\u8DEF\u5F84]\n- [\u6CE8\u660E\u5173\u952E\u5B9E\u73B0\u51B3\u7B56]\n\n\u5F53\u524D\u72B6\u6001\n-------------\n- [\u4EE3\u7801\u5E93\u6216\u4EFB\u52A1\u7684\u5F53\u524D\u72B6\u6001]\n- [\u9002\u7528\u65F6\u7684\u6784\u5EFA/\u6D4B\u8BD5\u72B6\u6001]\n- [\u4EFB\u4F55\u73AF\u5883\u6216\u914D\u7F6E\u72B6\u6001]\n\n\u5F85\u5904\u7406\u4EFB\u52A1\n-------------\n- [\u8BA1\u5212\u4F46\u672A\u5B8C\u6210\u7684\u4EFB\u52A1]\n- [\u4E0B\u4E00\u6B65\u903B\u8F91\u6B65\u9AA4]\n- [\u9047\u5230\u7684\u4EFB\u4F55\u963B\u788D\u6216\u95EE\u9898]\n- [\u5305\u542B\u6765\u81EA todoread() \u7684\u5F53\u524D todo \u72B6\u6001]\n\n\u5173\u952E\u6587\u4EF6\n---------\n- [path/to/file1] - [\u7B80\u77ED\u89D2\u8272\u63CF\u8FF0]\n- [path/to/file2] - [\u7B80\u77ED\u89D2\u8272\u63CF\u8FF0]\n(\u6700\u591A 10 \u4E2A\u6587\u4EF6\uFF0C\u6309\u91CD\u8981\u6027\u6392\u5E8F)\n- (\u5305\u542B\u6765\u81EA git diff/stat \u548C git status \u7684\u6587\u4EF6)\n\n\u91CD\u8981\u51B3\u7B56\n-------------------\n- [\u505A\u51FA\u7684\u6280\u672F\u51B3\u7B56\u53CA\u539F\u56E0]\n- [\u8003\u8651\u7684\u6743\u8861]\n- [\u786E\u7ACB\u7684\u6A21\u5F0F\u6216\u7EA6\u5B9A]\n\n\u660E\u786E\u7EA6\u675F\n--------------------\n- [\u4EC5\u9010\u5B57\u7EA6\u675F - \u6765\u81EA\u7528\u6237\u6216\u73B0\u6709 AGENTS.md]\n- \u5982\u679C\u6CA1\u6709\uFF0C\u5199: \u65E0\n\n\u5EF6\u7EED\u4E0A\u4E0B\u6587\n------------------------\n- [\u4E0B\u4E00\u4E2A\u4F1A\u8BDD\u9700\u8981\u77E5\u9053\u4EC0\u4E48\u624D\u80FD\u7EE7\u7EED]\n- [\u8981\u6CE8\u610F\u7684\u8B66\u544A\u6216\u9677\u9631]\n- [\u76F8\u5173\u6587\u6863\u5F15\u7528]\n```\n\n\u6458\u8981\u89C4\u5219:\n- \u7EAF\u6587\u672C\u52A0\u9879\u76EE\u7B26\u53F7\n- \u4E0D\u8981\u4F7F\u7528 # \u7684 markdown \u6807\u9898 (\u4F7F\u7528\u4E0A\u9762\u7684\u5E26\u7834\u6298\u53F7\u683C\u5F0F)\n- \u5185\u5BB9\u4E2D\u4E0D\u8981\u52A0\u7C97\u3001\u659C\u4F53\u6216\u4EE3\u7801\u56F4\u680F\n- \u6587\u4EF6\u4F7F\u7528\u5DE5\u4F5C\u533A\u76F8\u5BF9\u8DEF\u5F84\n- \u4FDD\u6301\u805A\u7126 - \u53EA\u5305\u542B\u5BF9\u7EE7\u7EED\u91CD\u8981\u7684\u4E8B\u60C5\n- \u6839\u636E\u590D\u6742\u5EA6\u9009\u62E9\u9002\u5F53\u7684\u957F\u5EA6\n- \u7528\u6237\u8BF7\u6C42 (\u539F\u6587) \u548C\u660E\u786E\u7EA6\u675F\u5FC5\u987B\u9010\u5B57\u5F15\u7528\n\n---\n\n# \u9636\u6BB5 4: \u63D0\u4F9B\u8BF4\u660E\n\n\u751F\u6210\u6458\u8981\u540E\uFF0C\u6307\u793A\u7528\u6237:\n\n```\n---\n\n\u5728\u65B0\u4F1A\u8BDD\u4E2D\u7EE7\u7EED:\n\n1. \u5728 OpenCode TUI \u4E2D\u6309 'n' \u6253\u5F00\u65B0\u4F1A\u8BDD\uFF0C\u6216\u5728\u65B0\u7684\u7EC8\u7AEF\u8FD0\u884C 'opencode'\n2. \u5C06\u4E0A\u9762\u7684\u4EA4\u63A5\u4E0A\u4E0B\u6587\u7C98\u8D34\u4E3A\u4F60\u7684\u7B2C\u4E00\u6761\u6D88\u606F\n3. \u6DFB\u52A0\u4F60\u7684\u8BF7\u6C42: \"\u4ECE\u4E0A\u9762\u7684\u4EA4\u63A5\u4E0A\u4E0B\u6587\u7EE7\u7EED\u3002[\u4F60\u7684\u4E0B\u4E00\u4E2A\u4EFB\u52A1]\"\n\n\u65B0\u4F1A\u8BDD\u5C06\u62E5\u6709\u65E0\u7F1D\u7EE7\u7EED\u6240\u9700\u7684\u6240\u6709\u4E0A\u4E0B\u6587\u3002\n```\n\n---\n\n# \u91CD\u8981\u7EA6\u675F\n\n- \u4E0D\u8981\u5C1D\u8BD5\u4EE5\u7F16\u7A0B\u65B9\u5F0F\u521B\u5EFA\u65B0\u4F1A\u8BDD (\u667A\u80FD\u4F53\u6CA1\u6709\u53EF\u7528\u7684 API)\n- \u8981\u63D0\u4F9B\u4E00\u4E2A\u81EA\u5305\u542B\u7684\u6458\u8981\uFF0C\u65E0\u9700\u8BBF\u95EE\u672C\u4F1A\u8BDD\u5373\u53EF\u5DE5\u4F5C\n- \u8981\u5305\u542B\u5DE5\u4F5C\u533A\u76F8\u5BF9\u6587\u4EF6\u8DEF\u5F84\n- \u4E0D\u8981\u5305\u542B\u654F\u611F\u4FE1\u606F (API \u5BC6\u94A5\u3001\u51ED\u636E\u3001\u673A\u5BC6)\n- \u4E0D\u8981\u5728\u5173\u952E\u6587\u4EF6\u90E8\u5206\u8D85\u8FC7 10 \u4E2A\u6587\u4EF6\n- \u8981\u4FDD\u6301\u76EE\u6807\u90E8\u5206\u4E3A\u5355\u53E5\u8BDD\u6216\u77ED\u6BB5\u843D\n\n---\n\n# \u7ACB\u5373\u6267\u884C\n\n\u4ECE\u6536\u96C6\u7A0B\u5E8F\u5316\u4E0A\u4E0B\u6587\u5F00\u59CB\uFF0C\u7136\u540E\u7EFC\u5408\u4EA4\u63A5\u6458\u8981\u3002";