baxian 0.0.1 → 0.2.0

package/dist/shared/types.d.ts

@@ -0,0 +1,263 @@
+export type AgentRuntime = 'claude-code' | 'codex';
+export type AgentRole = 'dev' | 'qa';
+export type AgentMode = 'local' | 'remote';
+export type MergeStrategy = 'auto' | null;
+export interface HostConfig {
+    hostname: string;
+    user?: string;
+}
+export interface AgentConfig {
+    id: string;
+    runtime: AgentRuntime;
+    role: AgentRole;
+    mode: AgentMode;
+    host?: HostConfig;
+    workdir?: string;
+    yolo?: boolean;
+    model?: string;
+    addDirs?: string[];
+}
+export interface ProjectConfig {
+    id: string;
+    repo: string;
+    merge: MergeStrategy;
+    agent: AgentConfig[][];
+}
+export interface ReviewConfig {
+    /**
+     * Maximum review iterations for this task. Applies to BOTH the code-review
+     * loop (dev↔qa code rounds) AND the spec-review loop (dev↔qa spec rounds);
+     * same numeric cap. If the two ever need to diverge, split this field then.
+     */
+    rounds: number;
+}
+export interface HttpsConfig {
+    /** Absolute path to PEM-encoded private key, readable by the server user. */
+    keyFile: string;
+    /** Absolute path to PEM-encoded full-chain certificate. */
+    certFile: string;
+}
+export interface ServerConfig {
+    port: number;
+    token?: string;
+    host?: string;
+    /** When set, server listens with TLS instead of plain HTTP. */
+    https?: HttpsConfig;
+    /**
+     * Allowed Host header values. Empty/undefined = accept any (dev default).
+     * Set in production to mitigate Host-header attacks.
+     */
+    allowedHosts?: string[];
+    /** Per-repo poller cadence in ms. Default 30_000. */
+    githubPollIntervalMs?: number;
+    tmuxProbePollIntervalMs?: number;
+    tmuxProbeTimeoutMs?: number;
+    tmuxProbeConcurrency?: number;
+    bootstrapRetryIntervalMs?: number;
+}
+export interface BaxianConfig {
+    review: ReviewConfig;
+    server: ServerConfig;
+    project: ProjectConfig[];
+}
+export type AgentRuntimeStatus = 'unknown' | 'idle' | 'pending' | 'working' | 'waiting' | 'error';
+export type TmuxSessionStatus = 'unknown' | 'present' | 'absent' | 'unreachable';
+export type TaskStatus = 'pending' | 'in_progress' | 'review' | 'fixing' | 'approved' | 'merged' | 'max_rounds' | 'failed' | 'cancelled';
+export type TaskPhase = 'spec' | 'code';
+export type AgentLifecycleStatus = 'ok' | 'awaiting_human';
+export interface AgentBindingFacts {
+    id: string;
+    projectId: string;
+    taskId?: string;
+    worktreePath?: string;
+    repoPath?: string;
+    startedAt?: string;
+    updatedAt: string;
+    paneId?: string;
+    creationToken?: string;
+    status?: AgentLifecycleStatus;
+    awaitingPhase?: string;
+    awaitingReason?: string;
+    awaitingSince?: string;
+    injectedSkills?: InjectedSkillsRecord;
+}
+export interface InjectedSkillsRecord {
+    taskId: string;
+    paneId: string;
+    skills: string[];
+}
+export interface AgentErrorSummary {
+    id: string;
+    reason: string;
+    message: string;
+    occurredAt: string;
+    recommendation?: string;
+}
+export interface AgentSnapshot {
+    id: string;
+    projectId: string;
+    runtimeStatus: AgentRuntimeStatus;
+    tmuxSessionStatus: TmuxSessionStatus;
+    stale: boolean;
+    observedAt?: string;
+    binding?: AgentBindingFacts;
+    latestError?: AgentErrorSummary;
+    latestBootstrapError?: AgentErrorSummary;
+    reason?: string;
+    message?: string;
+}
+export interface TaskState {
+    id: string;
+    projectId: string;
+    title: string;
+    description: string;
+    preferredAgentId: string;
+    agentId: string;
+    qaAgentId?: string;
+    prNumber?: number;
+    prUrl?: string;
+    branch?: string;
+    /** Server-trusted PR head SHA — anchor for review.submitted staleness checks. */
+    latestHeadSha?: string;
+    reviewRound: number;
+    /** Spec review round, isolated from PR review round. */
+    specReviewRound?: number;
+    /** undefined ≡ 'code' for backward compatibility. */
+    phase?: TaskPhase;
+    /** Marker token for the current spec dispatch; regenerated each dispatch. */
+    specMarkerToken?: string;
+    status: TaskStatus;
+    createdAt: string;
+    updatedAt: string;
+}
+export type EventType = 'task.created' | 'task.assigned' | 'task.updated' | 'session.started' | 'session.completed' | 'pr.created' | 'pr.updated' | 'pr.merged' | 'review.dispatched' | 'review.submitted' | 'review.max_rounds' | 'spec.ready' | 'spec.review.submitted' | 'spec.fix.submitted' | 'agent.bootstrap_failed' | 'agent.bootstrap_succeeded' | 'agent.recovered' | 'agent.stream_started' | 'agent.stream_stopped' | 'human.intervention';
+export interface BaxianEvent {
+    id: string;
+    type: EventType;
+    timestamp: string;
+    projectId: string;
+    agentId?: string;
+    taskId?: string;
+    data: Record<string, unknown>;
+}
+export type StreamSubMode = 'preview' | 'full';
+export interface StreamSubscribeMsg {
+    op: 'subscribe';
+    subscriberId: string;
+    agentId: string;
+    mode: StreamSubMode;
+}
+export interface StreamUnsubscribeMsg {
+    op: 'unsubscribe';
+    subscriberId: string;
+}
+export interface StreamInputMsg {
+    op: 'input';
+    subscriberId: string;
+    data: string;
+}
+export interface StreamResizeMsg {
+    op: 'resize';
+    subscriberId: string;
+    cols: number;
+    rows: number;
+}
+export interface StreamPingMsg {
+    op: 'ping';
+}
+export type StreamClientMsg = StreamSubscribeMsg | StreamUnsubscribeMsg | StreamInputMsg | StreamResizeMsg | StreamPingMsg;
+export interface StreamSnapshotMsg {
+    type: 'snapshot';
+    subscriberId: string;
+    cols: number;
+    rows: number;
+    data: string;
+    snapshotSeq: number;
+}
+export interface StreamDataMsg {
+    type: 'data';
+    agentId: string;
+    data: string;
+    seq: number;
+}
+export interface StreamSubscribedMsg {
+    type: 'subscribed';
+    subscriberId: string;
+    agentId: string;
+    cols: number;
+    rows: number;
+    snapshotSeq: number;
+}
+export interface StreamErrorMsg {
+    type: 'error';
+    subscriberId?: string;
+    agentId?: string;
+    code: string;
+    message: string;
+}
+export interface StreamSessionGoneMsg {
+    type: 'session_gone';
+    agentId: string;
+}
+export interface StreamPongMsg {
+    type: 'pong';
+}
+export type StreamServerMsg = StreamSnapshotMsg | StreamDataMsg | StreamSubscribedMsg | StreamErrorMsg | StreamSessionGoneMsg | StreamPongMsg;
+export type PollerHealth = 'healthy' | 'degraded' | 'failed' | 'unknown';
+export interface PollerSnapshot {
+    repo: string;
+    projectId: string;
+    intervalMs: number;
+    isPolling: boolean;
+    lastPollStartedAt?: string;
+    lastPollEndedAt?: string;
+    lastPollDurationMs?: number;
+    lastErrorAt?: string;
+    lastErrorMessage?: string;
+    consecutiveFailures: number;
+    health: PollerHealth;
+}
+export type EventsTopicAgents = 'agents';
+export type EventsTopicAgent = `agent:${string}`;
+export type EventsTopicTask = `task:${string}`;
+export type EventsTopicProjectTasks = `project-tasks:${string}`;
+export type EventsTopicPollers = 'pollers';
+export type EventsTopic = EventsTopicAgents | EventsTopicAgent | EventsTopicTask | EventsTopicProjectTasks | EventsTopicPollers;
+export type EventsClientMsg = {
+    op: 'subscribe';
+    topic: EventsTopic;
+} | {
+    op: 'unsubscribe';
+    topic: EventsTopic;
+} | {
+    op: 'ping';
+};
+export type EventsServerMsg = {
+    type: 'data';
+    topic: EventsTopicAgents;
+    data: AgentSnapshot[];
+} | {
+    type: 'data';
+    topic: EventsTopicAgent;
+    data: AgentSnapshot | null;
+} | {
+    type: 'data';
+    topic: EventsTopicTask;
+    data: TaskState | null;
+} | {
+    type: 'data';
+    topic: EventsTopicProjectTasks;
+    data: TaskState[];
+} | {
+    type: 'data';
+    topic: EventsTopicPollers;
+    data: PollerSnapshot[];
+} | {
+    type: 'error';
+    topic?: EventsTopic;
+    code: string;
+    message: string;
+} | {
+    type: 'pong';
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,OAAO,CAAC;AACnD,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC;AACrC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAC3C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,IAAI,CAAC;AAE1C,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,MAAM,GACN,SAAS,GACT,SAAS,GACT,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,aAAa,CAAC;AAElB,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAIxC,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,gBAAgB,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IAKvB,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,kBAAkB,CAAC;IAClC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,oBAAoB,CAAC,EAAE,iBAAiB,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,eAAe,GACf,cAAc,GACd,iBAAiB,GACjB,mBAAmB,GACnB,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,YAAY,GACZ,uBAAuB,GACvB,oBAAoB,GACpB,wBAAwB,GACxB,2BAA2B,GAC3B,iBAAiB,GACjB,sBAAsB,GACtB,sBAAsB,GACtB,oBAAoB,CAAC;AAEzB,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,WAAW,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,aAAa,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,oBAAoB,GACpB,cAAc,GACd,eAAe,GACf,aAAa,CAAC;AAElB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,eAAe,GACvB,iBAAiB,GACjB,aAAa,GACb,mBAAmB,GACnB,cAAc,GACd,oBAAoB,GACpB,aAAa,CAAC;AAElB,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AACzC,MAAM,MAAM,gBAAgB,GAAG,SAAS,MAAM,EAAE,CAAC;AACjD,MAAM,MAAM,eAAe,GAAG,QAAQ,MAAM,EAAE,CAAC;AAC/C,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,MAAM,EAAE,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAC3C,MAAM,MAAM,WAAW,GACnB,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,GACf,uBAAuB,GACvB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GACvC;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnB,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,aAAa,EAAE,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,uBAAuB,CAAC;IAAC,IAAI,EAAE,SAAS,EAAE,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,cAAc,EAAE,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/shared/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":""}

package/dist/skill/index.d.ts

@@ -0,0 +1,2 @@
+export { SkillRegistry, type SkillDef } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/skill/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/skill/index.js

@@ -0,0 +1,2 @@
+export { SkillRegistry } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/skill/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAiB,MAAM,eAAe,CAAC"}

package/dist/skill/registry.d.ts

@@ -0,0 +1,30 @@
+import type { AgentRole } from '../shared/index.js';
+export interface SkillFile {
+    relPath: string;
+    content: Buffer;
+    text: string;
+}
+export interface SkillDef {
+    name: string;
+    dir: string;
+    path: string;
+    content: string;
+    description: string;
+    files: SkillFile[];
+}
+export declare class SkillScanError extends Error {
+    constructor(message: string);
+}
+export declare class SkillRegistry {
+    private sourceDir;
+    private builtinDir?;
+    private skills;
+    constructor(sourceDir: string, builtinDir?: string | undefined);
+    scan(): Promise<void>;
+    private loadFrom;
+    has(name: string): boolean;
+    get(name: string): SkillDef | undefined;
+    names(): string[];
+    skillsForPhase(role: AgentRole, phase: string): string[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/skill/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/skill/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AA2FD,qBAAa,aAAa;IAKZ,OAAO,CAAC,SAAS;IAAU,OAAO,CAAC,UAAU,CAAC;IAJ1D,OAAO,CAAC,MAAM,CAA+B;gBAIzB,SAAS,EAAE,MAAM,EAAU,UAAU,CAAC,EAAE,MAAM,YAAA;IAE5D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAMb,QAAQ;IAoCtB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC,KAAK,IAAI,MAAM,EAAE;IAIjB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAOzD"}

package/dist/skill/registry.js

@@ -0,0 +1,174 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { TextDecoder } from 'node:util';
+import { AGENT_PHASES } from '../shared/index.js';
+export class SkillScanError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SkillScanError';
+    }
+}
+const MAX_SKILL_FILE_BYTES = 100 * 1024;
+// XML 1.0 illegal control chars (tab/LF/CR valid; everything else in 0x00-0x1F is not).
+const ILLEGAL_XML = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\uFFFE\uFFFF]/u;
+const utf8Strict = new TextDecoder('utf-8', { fatal: true });
+function decodeStrictUtf8(path, buf) {
+    let text;
+    try {
+        text = utf8Strict.decode(buf);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new SkillScanError(`${path}: invalid UTF-8 (${message})`);
+    }
+    if (ILLEGAL_XML.test(text)) {
+        throw new SkillScanError(`${path}: contains XML-illegal control character`);
+    }
+    if (Buffer.byteLength(text, 'utf8') > MAX_SKILL_FILE_BYTES) {
+        throw new SkillScanError(`${path}: ${Buffer.byteLength(text, 'utf8')} bytes exceeds ${MAX_SKILL_FILE_BYTES} limit`);
+    }
+    return text;
+}
+// Narrow frontmatter parser: pulls a single-line `description: <value>` from the
+// leading `---\n...\n---` block. Avoids a full YAML dependency.
+function parseSkillDescription(content) {
+    if (!content.startsWith('---\n'))
+        return firstParagraph(content);
+    const end = content.indexOf('\n---', 4);
+    if (end === -1)
+        return firstParagraph(content);
+    const block = content.slice(4, end);
+    for (const line of block.split('\n')) {
+        const m = line.match(/^description:\s*(.*?)\s*$/);
+        if (m) {
+            return stripMatchedQuotes(m[1]);
+        }
+    }
+    return firstParagraph(content.slice(end + 4));
+}
+function stripMatchedQuotes(v) {
+    if (v.length >= 2) {
+        const first = v[0];
+        const last = v[v.length - 1];
+        if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+            return v.slice(1, -1);
+        }
+    }
+    return v;
+}
+function firstParagraph(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return '';
+    const para = trimmed.split(/\n\s*\n/, 1)[0];
+    return para.replace(/\s+/g, ' ').slice(0, 200);
+}
+async function walk(dir, base = dir) {
+    const out = [];
+    let entries;
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return out;
+    }
+    for (const entry of entries) {
+        const entryPath = join(dir, entry);
+        let s;
+        try {
+            s = await stat(entryPath);
+        }
+        catch {
+            continue; // broken symlink / race; skip
+        }
+        if (s.isDirectory()) {
+            out.push(...(await walk(entryPath, base)));
+        }
+        else if (s.isFile()) {
+            const buf = await readFile(entryPath);
+            const text = decodeStrictUtf8(entryPath, buf);
+            out.push({
+                relPath: relative(base, entryPath),
+                content: buf,
+                text,
+            });
+        }
+    }
+    return out;
+}
+export class SkillRegistry {
+    sourceDir;
+    builtinDir;
+    skills = new Map();
+    // builtinDir holds the package-shipped skills (npm packaging puts them next to dist).
+    // sourceDir is the cfgDir/skills override — user customisations win on name collision,
+    // so installed users get a working set out of the box without copying anything.
+    constructor(sourceDir, builtinDir) {
+        this.sourceDir = sourceDir;
+        this.builtinDir = builtinDir;
+    }
+    async scan() {
+        this.skills.clear();
+        if (this.builtinDir)
+            await this.loadFrom(this.builtinDir);
+        await this.loadFrom(this.sourceDir);
+    }
+    async loadFrom(dir) {
+        let entries;
+        try {
+            entries = await readdir(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const entryPath = join(dir, entry);
+            let s;
+            try {
+                s = await stat(entryPath);
+            }
+            catch {
+                continue; // broken symlink / race
+            }
+            if (!s.isDirectory())
+                continue;
+            const skillFile = join(entryPath, 'SKILL.md');
+            let skillBuf;
+            try {
+                skillBuf = await readFile(skillFile);
+            }
+            catch {
+                continue;
+            }
+            const skillMd = decodeStrictUtf8(skillFile, skillBuf);
+            const files = await walk(entryPath);
+            this.skills.set(entry, {
+                name: entry,
+                dir: entryPath,
+                path: skillFile,
+                content: skillMd,
+                description: parseSkillDescription(skillMd),
+                files,
+            });
+        }
+    }
+    has(name) {
+        return this.skills.has(name);
+    }
+    get(name) {
+        return this.skills.get(name);
+    }
+    names() {
+        return [...this.skills.keys()];
+    }
+    skillsForPhase(role, phase) {
+        const phases = AGENT_PHASES[role];
+        if (!phases)
+            return [];
+        const phaseConfig = phases[phase];
+        if (!phaseConfig)
+            return [];
+        return phaseConfig.skills.filter((name) => this.skills.has(name));
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/skill/registry.js.map

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

package/dist/skills/UPSTREAM.md

@@ -0,0 +1,38 @@
+# Upstream sync record
+
+This file tracks which `rockdai/agent-scripts` commit the synced skills under `skills/` are aligned with. Update by hand on every manual sync (we removed the automated sync script in favor of explicit, reviewable updates).
+
+## Currently aligned
+
+- Upstream: https://github.com/rockdai/agent-scripts
+- Commit: `911beb66b0`
+- Date: 2026-05-17
+
+## Synced skills (replaced verbatim on each sync)
+
+- `pr-feedback`
+- `pr-review`
+- `pr-recheck`
+- `merge-sync`
+- `spells`
+
+## Local-only skills (never touched by sync)
+
+- `baxian-rules` — baxian backend invariants (verdict marker grammar, PR marker, fail-and-fallback flow)
+- `task-check` — baxian-specific pre-implementation check
+
+## Intentionally NOT synced from upstream
+
+- `code-review` — overlaps with `baxian-rules`; describes a chat-driven workflow that conflicts with baxian's backend-event model
+- `issue-check` — baxian has no issue-handling phase
+- `review-notify` — baxian dispatches dev↔qa via backend events; agents do not chat-notify peers
+- `tmux-send` — agents run inside tmux panes themselves; injecting this is a strange loop
+
+## How to sync
+
+1. `git clone https://github.com/rockdai/agent-scripts /tmp/agent-scripts` (or `git pull` if already cloned)
+2. Note the new HEAD SHA
+3. For each name in the **Synced skills** list, copy `/tmp/agent-scripts/skills/<name>/` over `skills/<name>/`
+4. `diff` to review the delta — reject anything that conflicts with `baxian-rules` overrides
+5. Update the `Commit` and `Date` lines above
+6. Commit + push on a new branch + open a PR

package/dist/skills/baxian-rules/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: baxian-rules
+description: General rules and conventions for all baxian-managed agents
+---
+
+# Baxian Agent Rules
+
+You are an agent managed by the baxian platform.
+
+## Communication Rules
+- All collaboration happens through GitHub PR records (description, commits, reviews, comments).
+- Never rely on chat memory or tmux output for cross-agent communication.
+- PR is the single source of truth for the entire review process.
+
+## PR Creation (Dev)
+- The PR description MUST start with the marker `<!-- baxian:managed -->` on its own line. This is how the platform recognises a baxian-managed PR; without it events for the PR are ignored.
+- If a human gave you special instructions (skip tests, override rules), record the authorization in the PR description or a PR comment.
+
+## Code Review Response (Dev)
+- Respond to EVERY finding. No exceptions.
+- `Fixed` (on its own line) = you made the change.
+- `Won't fix` (on its own line) + reason = you decided not to change it.
+- Silent ignoring is never acceptable.
+- For out-of-scope findings, follow the `pr-feedback` skill (create a follow-up GitHub Issue, then reply with the link).
+
+## Code Review Reading (Both)
+- Use `gh` commands with `--paginate` to read all feedback.
+- Read all three sources: reviews, review comments, and issue comments.
+- Never assume you've seen everything without checking.
+
+## Authorization Independence (QA)
+- A human authorization recorded in the PR does not automatically override risk assessment.
+- Read the rationale, then judge independently whether it actually covers the risk before approving.
+
+## QA Verdict Emission (baxian-specific)
+baxian's backend derives a `review.submitted` verdict from one of:
+1. A GitHub review with state `APPROVED` (→ approve).
+2. A GitHub review with state `CHANGES_REQUESTED` (→ request changes).
+3. A `COMMENTED` review whose body contains a single standalone line `<!-- baxian:<your-agent-id>:approve -->` or `<!-- baxian:<your-agent-id>:request-changes -->` outside fenced code blocks (verdict marker).
+
+A bare `:+1:`, an emoji, or a generic positive comment is NOT recognized by the backend — only the three signals above advance the state machine.
+
+### Verdict emission: fail-and-fallback (always do this)
+
+When dev and qa share the same GitHub identity (common on solo / single-token setups), GitHub returns `422 Can not approve your own pull request` to `gh pr review --approve`. The qa agent MUST run the fail-and-fallback flow below every time — it is a no-op extra step in the multi-account case and the only path that works in the shared-account case.
+
+To emit `APPROVE`:
+
+1. Try `gh pr review N --approve`.
+2. If it succeeds, you are done with the verdict signal. Skip to step 4.
+3. If it fails for any reason, fall back: submit a COMMENTED review carrying the verdict marker. The marker MUST be on its own line, outside any fenced code block, and appear exactly once in the body:
+   ```bash
+   gh pr review N --comment --body $'LGTM\n\n<!-- baxian:<your-agent-id>:approve -->'
+   ```
+4. After the verdict is durable on the PR, post a `:+1:` review comment as human-readable reinforcement: `gh pr review N --comment --body ':+1:'`. This is not a backend signal; it is a courtesy for human reviewers.
+
+To emit `CHANGES_REQUESTED`, use the same fail-and-fallback pattern: try `gh pr review N --request-changes --body '<findings>'` first; on any failure, switch to `gh pr review N --comment --body $'<findings>\n\n<!-- baxian:<your-agent-id>:request-changes -->'`.
+
+## Backend Dispatch (baxian overrides chat-driven skills)
+baxian orchestrates dev↔qa hand-offs via backend events, not chat triggers. Concretely:
+- You will NOT receive `pr N` / `review N` / `recheck N` / `issue N` chat triggers; baxian dispatches you via task / pane prompts.
+- You do NOT need to "notify the peer agent" via `tmux-send` / `review-notify` / any chat transport; the backend takes over once your PR push / review submit lands.
+- When an imported skill (`spells`, `pr-feedback`, `pr-review`, `pr-recheck`) describes a `tmux-send` / `review-notify` / `issue N → issue-check` branch, treat it as conditional and skip it in baxian.
+
+## Scope Discipline
+- Stay within the scope of the current task.
+- If you discover something out of scope that needs fixing, open a GitHub Issue on the repo to track it.
+- Never make unrelated changes in a PR without human authorization.

package/dist/skills/merge-sync/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: merge-sync
+description: Use when an agent workspace must synchronize after a pull request has merged, including project aliases like "merged" or "merged N", branch cleanup, main/default-branch updates, docs or agent-rule rereads, and peer notifications.
+---
+
+# Merge Sync
+
+## Overview
+
+After a PR merges, each agent workspace must update to the merged default branch and refresh any changed agent rules before doing more work. The workflow differs depending on whether the message came from a human on the merged branch owner side or from another agent.
+
+Project-specific trigger aliases such as `merged` and `merged N` are compatibility shims. The reusable concept is "sync after PR merge".
+
+## Identify Source
+
+Read the project instructions to decide how merge-sync is triggered. Common patterns:
+
+- Human-originated local sync: the agent that owned the PR is on or knows the PR's head branch.
+- Peer-originated sync: another agent sends the PR number so this workspace can update without deleting an unrelated current branch.
+
+If the PR number is missing, recover it from the current branch, recent PRs, or the user before deleting any branch.
+
+## Human-Originated Sync
+
+1. Fetch remote state and identify the PR head branch and default branch.
+2. Switch to the default branch and pull the latest remote default branch.
+3. Delete the merged local feature branch only after confirming it is the PR head branch.
+4. Inspect merged file paths. If agent rules, docs, or skill pointers changed, reread the affected files before starting new work.
+5. If the project has peer agents, notify them with the project-defined merge-sync message after local sync completes.
+
+## Peer-Originated Sync
+
+1. Fetch remote state, switch to the default branch, and pull latest.
+2. Inspect the merged PR's changed files. Reread changed agent rules, docs, or skill pointers.
+3. Optionally delete stale local branches for that PR if they are clearly associated with the merged PR.
+4. Do not notify the peer again; merge-sync notifications must not bounce forever.
+
+## Safety Rules
+
+- Never delete the current branch unless it is confirmed to be the merged PR head branch.
+- Never treat tmux or chat output as proof of merge; verify through the VCS or hosting provider.
+- If docs or agent rules changed, reread them before accepting another task.