orizu 0.5.20 → 0.5.21

package/dist/workbench-cli.d.ts

@@ -0,0 +1,233 @@
+/**
+ * Workspace session/run visibility commands (ALI-902 CLI half).
+ *
+ * Pure logic + injected HTTP: command functions do not parse process.argv and
+ * do not print. The thin `workbenchCommand` entry point owns CLI argument
+ * parsing and human/JSON output.
+ */
+import { type StartIntentIdGenerator } from './start-intent.js';
+export interface WorkbenchFetcher {
+    (path: string, init?: RequestInit): Promise<Response>;
+}
+export interface WorkbenchSleep {
+    (ms: number): Promise<void>;
+}
+export interface WorkbenchRunCosts {
+    modelCostUsd?: number | null;
+    tokensInput?: number | null;
+    tokensOutput?: number | null;
+    tokensCacheRead?: number | null;
+    tokensCacheWrite?: number | null;
+    tokensReasoning?: number | null;
+    costUpdatedAt?: string | null;
+}
+export interface WorkbenchRunSummary extends WorkbenchRunCosts {
+    id: string;
+    status: string;
+}
+export interface WorkbenchSession {
+    id: string;
+    workspaceId?: string;
+    projectId?: string | null;
+    actorUserId?: string;
+    actorType?: string;
+    status: string;
+    clientInfo?: Record<string, unknown>;
+    startedAt?: string | null;
+    endedAt?: string | null;
+    createdAt?: string;
+    updatedAt?: string;
+    runs?: WorkbenchRunSummary[];
+    /** Session rollup: sum of the runs' server-aggregated cost totals (ALI-1089). */
+    costs?: WorkbenchRunCosts;
+    [key: string]: unknown;
+}
+export interface WorkbenchRun extends WorkbenchRunCosts {
+    id: string;
+    workspaceSessionId?: string;
+    workspaceId?: string;
+    projectId?: string | null;
+    actorUserId?: string;
+    actorType?: string;
+    title?: string;
+    status: string;
+    evidence?: Record<string, unknown>;
+    summary?: Record<string, unknown>;
+    latestSequence?: number;
+    startedAt?: string | null;
+    finishedAt?: string | null;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+export interface WorkbenchRunEvent {
+    sequence: number;
+    eventId: string;
+    eventType: string;
+    occurredAt?: string | null;
+    payload?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface CommonWorkbenchOptions {
+    fetcher?: WorkbenchFetcher;
+    cwd?: string;
+}
+export interface SessionGitResult {
+    status: number;
+    stdout: string;
+    stderr: string;
+}
+/** Injectable git seam (tests use a recording fake; prod spawns git). */
+export type SessionGitRunner = (args: string[], opts?: {
+    cwd?: string;
+}) => SessionGitResult;
+export interface SessionCheckout {
+    branch: string;
+    state: 'checked-out' | 'skipped';
+    detail: string;
+}
+export interface SessionBranchSync {
+    branch: string;
+    /** Local-only commit count vs origin/<branch>; null when not computable. */
+    ahead: number | null;
+    /** origin/<branch>-only commit count; null when not computable. */
+    behind: number | null;
+}
+export interface SessionStartOptions extends CommonWorkbenchOptions {
+    workspaceId?: string | null;
+    projectSlug?: string | null;
+    clientInfo?: Record<string, unknown>;
+    git?: SessionGitRunner;
+    /**
+     * Opt-in local ergonomics (ALI-1028): fetch + check out the session branch
+     * when cwd is the workbench clone. Off by default so library callers (e.g.
+     * smoke) never mutate the local checkout; the human CLI path turns it on.
+     */
+    localCheckout?: boolean;
+    /** Injectable bounded repository-readiness delay for tests. */
+    sleep?: WorkbenchSleep;
+    /** Injectable UUIDv4 generator; one value is replayed for every retry. */
+    generateStartIntentId?: StartIntentIdGenerator;
+    /** Existing immutable intent when resuming a bounded pending start. */
+    startIntentId?: string | null;
+    /** Existing session bound to startIntentId when resuming provisioning. */
+    reconcileSessionId?: string | null;
+}
+export interface SessionStatusOptions extends CommonWorkbenchOptions {
+    workspaceId?: string | null;
+    sessionId?: string | null;
+    status?: string | null;
+    git?: SessionGitRunner;
+}
+export interface SessionEndOptions {
+    fetcher?: WorkbenchFetcher;
+    sessionId: string;
+}
+export interface SessionFinishOptions {
+    fetcher?: WorkbenchFetcher;
+    sessionId: string;
+    projectSlug?: string | null;
+    cwd?: string;
+    git?: SessionGitRunner;
+    /** Opt-in: stage/commit/push local session-branch work before finishing. */
+    push?: boolean;
+    /** Commit message for --push; a default is used when omitted. */
+    message?: string | null;
+}
+export interface SessionFinishResult {
+    outcome: string;
+    branch?: string;
+    branchDeleted?: boolean;
+    manifest?: Record<string, unknown>;
+    /** Local uncommitted/unpushed work detected at finish time (ALI-1028). */
+    localWarnings?: string[];
+    /** True when --push staged/committed/pushed local work before finishing. */
+    pushed?: boolean;
+}
+export interface SessionStartResult {
+    session: WorkbenchSession;
+    /** Local checkout attempt for the session branch; null when the session has no branch. */
+    checkout?: SessionCheckout | null;
+}
+/** A bounded repository wait exhausted without losing the immutable identity
+ * needed to resume safely. CLI callers can show the command; library callers
+ * can use the structured fields directly. */
+export declare class SessionRepositoryPendingError extends Error {
+    readonly sessionId: string;
+    readonly startIntentId: string;
+    readonly resumeCommand: string;
+    constructor(input: {
+        readonly sessionId: string;
+        readonly startIntentId: string;
+        readonly projectSlug: string | null;
+        readonly workspaceDirectory: string | null;
+    });
+}
+export interface SessionStatusResult {
+    session?: WorkbenchSession;
+    sessions?: WorkbenchSession[];
+    /** Local ahead/behind vs the remote session branch (single-session status only). */
+    branchSync?: SessionBranchSync | null;
+}
+export interface SessionEndResult {
+    session: WorkbenchSession;
+    branchStatus?: string;
+}
+export interface WorkbenchRunStartOptions {
+    fetcher?: WorkbenchFetcher;
+    sessionId: string;
+    title: string;
+    projectSlug?: string | null;
+}
+export interface WorkbenchRunStatusOptions {
+    fetcher?: WorkbenchFetcher;
+    runId: string;
+}
+export interface WorkbenchRunTerminalOptions {
+    fetcher?: WorkbenchFetcher;
+    runId: string;
+    status: string;
+    summary?: string | null;
+    evidence?: Record<string, unknown> | null;
+}
+export interface WorkbenchRunResult {
+    run: WorkbenchRun;
+}
+export interface TailOnceResult {
+    events: WorkbenchRunEvent[];
+    cursor: number;
+    runStatus: string;
+}
+export interface TailWorkbenchRunOptions {
+    fetcher?: WorkbenchFetcher;
+    runId: string;
+    after?: number;
+    limit?: number;
+    intervalSeconds?: number;
+    once?: boolean;
+    sleep?: WorkbenchSleep;
+    onEvent?: (event: WorkbenchRunEvent) => void;
+}
+export interface WorkbenchCommandIo {
+    json: boolean;
+    print: (line: string) => void;
+    fetcher?: WorkbenchFetcher;
+    sleep?: WorkbenchSleep;
+    /** Injectable git for the session-branch ergonomics (ALI-1028). */
+    git?: SessionGitRunner;
+    /** Test seam for the session-start idempotency UUID. */
+    generateStartIntentId?: StartIntentIdGenerator;
+}
+export declare const SESSION_REPOSITORY_PENDING_RETRY_MS = 2000;
+export declare const SESSION_REPOSITORY_PENDING_MAX_RETRIES = 30;
+export declare function runSessionStart(opts?: SessionStartOptions): Promise<SessionStartResult>;
+export declare function runSessionStatus(opts?: SessionStatusOptions): Promise<SessionStatusResult>;
+export declare function runSessionEnd(opts: SessionEndOptions): Promise<SessionEndResult>;
+export declare function runSessionFinish(opts: SessionFinishOptions): Promise<SessionFinishResult>;
+export declare function runWorkbenchRunStart(opts: WorkbenchRunStartOptions): Promise<WorkbenchRunResult>;
+export declare function runWorkbenchRunStatus(opts: WorkbenchRunStatusOptions): Promise<WorkbenchRunResult>;
+export declare function runWorkbenchRunTerminal(opts: WorkbenchRunTerminalOptions): Promise<WorkbenchRunResult>;
+export declare function tailOnce(fetcher: WorkbenchFetcher, runId: string, cursor: number, limit?: number): Promise<TailOnceResult>;
+export declare function tailWorkbenchRun(opts: TailWorkbenchRunOptions): Promise<TailOnceResult>;
+export declare function workbenchCommand(args: string[], io: WorkbenchCommandIo): Promise<number>;
+//# sourceMappingURL=workbench-cli.d.ts.map

package/dist/workbench-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbench-cli.d.ts","sourceRoot":"","sources":["../src/workbench-cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAKL,KAAK,sBAAsB,EAC5B,MAAM,mBAAmB,CAAA;AAI1B,MAAM,WAAW,gBAAgB;IAC/B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CACtD;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B;AAKD,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC5B,iFAAiF;IACjF,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,YAAa,SAAQ,iBAAiB;IACrD,EAAE,EAAE,MAAM,CAAA;IACV,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAUD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAED,yEAAyE;AACzE,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,gBAAgB,CAAA;AA0B5F,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,aAAa,GAAG,SAAS,CAAA;IAChC,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,mEAAmE;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,GAAG,CAAC,EAAE,gBAAgB,CAAA;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,0EAA0E;IAC1E,qBAAqB,CAAC,EAAE,sBAAsB,CAAA;IAC9C,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAClE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,GAAG,CAAC,EAAE,gBAAgB,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,gBAAgB,CAAA;IACtB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,gBAAgB,CAAA;IACzB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;CAClC;AAED;;6CAE6C;AAC7C,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;gBAElB,KAAK,EAAE;QACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;QAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;QACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;KAC3C;CAqBF;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC7B,oFAAoF;IACpF,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAA;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,gBAAgB,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAC1C;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,YAAY,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,iBAAiB,EAAE,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAA;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,mEAAmE;IACnE,GAAG,CAAC,EAAE,gBAAgB,CAAA;IACtB,wDAAwD;IACxD,qBAAqB,CAAC,EAAE,sBAAsB,CAAA;CAC/C;AAoCD,eAAO,MAAM,mCAAmC,OAAQ,CAAA;AACxD,eAAO,MAAM,sCAAsC,KAAK,CAAA;AAgKxD,wBAAsB,eAAe,CAAC,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqIjG;AAED,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyBpG;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgBtF;AAsGD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgC/F;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA4BtG;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CASxG;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiC5G;AAED,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,SAAqB,GACzB,OAAO,CAAC,cAAc,CAAC,CAezB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2C7F;AA4OD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqB9F"}

package/dist/workspace-sync.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Workspace tracked-resource sync commands (ALI-976 CLI half, revised spec).
+ *
+ * Pure logic + injected HTTP: no process.argv parsing and no printing live in
+ * the command functions (the thin `workspaceSyncCommand` entry point prints).
+ * This module implements the client side of the ALI-933 sync semantics:
+ *
+ *   - Inventory: walk the durable workspace contract (manifests + instruction/
+ *     memory/readme files) and compute each tracked file's content sha256.
+ *     `.orizu/**` is cache-only by definition (spec §6) and never inventoried.
+ *     Symlinked plain files hash the LINK TARGET PATH string (spec §3.1), so
+ *     editing `AGENTS.md` never falsely dirties a symlinked `CLAUDE.md`;
+ *     pointer files (no-symlinks mode) hash their own bytes.
+ *   - Missing/untracked visibility (spec §3.2): cache-known paths absent from
+ *     the inventory are reported `missing` locally and sent to sync as
+ *     `{path, missing: true}` (the server echoes without touching stored
+ *     truth). Files under managed primitive dirs covered by no manifest are
+ *     reported `untracked` in LOCAL status only — never sent to sync.
+ *   - Cache snapshots: last-sync `base` hashes stored under
+ *     `.orizu/cache/sync/<sha256-of-path>.json`. Filenames are path-hashed so
+ *     the cache never mirrors the workspace directory structure. Cache is
+ *     gitignored and safely deletable (spec §6); it is `local`/`cache`, never a
+ *     contract.
+ *   - Commands: `status` (local three-way against the cache; `--remote`
+ *     performs the SAME server-side reconciliation as `sync` — it registers
+ *     and updates tracked-resource records; there is no read-only remote
+ *     status in v0, spec §3.1 — but never writes local cache), `sync`
+ *     (metadata-first; cache base advances ONLY on a `clean`
+ *     convergence-confirmation), `pull` (metadata fast-forward, only when the
+ *     server carries real truth), and `apply` (repo → server promotion;
+ *     refuses DB-native owners, conflicts, and remote-newer via server 409s).
+ *
+ * v0 boundary: `pull` reconciles the manifest canonical block + cache only,
+ * and ONLY from server-carried truth (serverSha256/serverVersionId) — never
+ * from local bytes. It does not materialize bulk primitive content — source
+ * files converge through Git, and DB-native/object bytes materialize through
+ * the primitive-specific commands (e.g. `orizu prompts pull`,
+ * `orizu datasets download`). Full bulk-content pull is deferred (spec §8).
+ *
+ * Apply identity (spec §3.1): strictly the sync-recorded tracked-resource ROW
+ * id from the cache snapshot (`resourceId`). There is NO fallback to the
+ * manifest's `canonical.serviceId` (informational/legacy). Without a recorded
+ * row id the command directs the user to run `orizu workspace sync` first.
+ * On any apply 409 (owner refusal, conflicted, remote-newer, CAS loss) the
+ * recovery loop is: re-sync, converge per the reported status, retry.
+ */
+import { type CanonicalOwner, type RepoState } from './workspace.js';
+export declare const TRACKED_RESOURCE_KINDS: readonly ["team_manifest", "project_manifest", "instruction_file", "memory_file", "readme", "dataset", "app", "task", "prompt", "scorer", "optimization", "other"];
+export type TrackedResourceKind = (typeof TRACKED_RESOURCE_KINDS)[number];
+export type WorkspaceSyncFetcher = (path: string, init?: RequestInit) => Promise<Response>;
+export interface InventoryEntry {
+    path: string;
+    absPath: string;
+    kind: TrackedResourceKind;
+    owner: CanonicalOwner;
+    repoState: RepoState;
+    projectSlug: string | null;
+    serviceResourceId: string | null;
+    versionId: string | null;
+    contentSha256: string;
+    manifestPath: string | null;
+    isManifest: boolean;
+}
+export interface CacheSnapshot {
+    path: string;
+    baseSha256: string | null;
+    versionId: string | null;
+    lastSyncedAt: string | null;
+    /** Server tracked-resource ROW id — the ONLY apply identity (spec §3.1). */
+    resourceId?: string | null;
+    /**
+     * Metadata-only-pull guard (spec §3.3): set when a `pull` advanced this
+     * repo-owned resource's base to a server hash the working content does not
+     * yet match — i.e. the base moved without the bytes being delivered. While
+     * set, `apply` MUST refuse (a CAS apply would pass and silently revert the
+     * pulled version). Absent/false means not pending (backward-compatible with
+     * pre-guard snapshots that lack the field).
+     */
+    contentPending?: boolean;
+    /** The pulled base hash the working content must reconcile to before apply. */
+    pendingBaseSha256?: string | null;
+}
+export interface CommonOptions {
+    cwd?: string;
+    fetcher?: WorkspaceSyncFetcher;
+    workspaceId?: string | null;
+}
+export declare function sha256Hex(value: string | Buffer): string;
+export declare function readCanonical(manifest: Record<string, unknown> | null): Record<string, unknown>;
+export declare function stringOrNull(value: unknown): string | null;
+/** Walk the durable workspace contract and return one entry per tracked file. */
+export declare function collectInventory(cwd?: string): InventoryEntry[];
+/**
+ * Files present under managed primitive dirs that no inventory rule covers
+ * (spec §3.2 `untracked`). A file is covered when an inventoried manifest
+ * lives in its directory or any ancestor within the managed dir — body files
+ * adjacent to their manifest belong to that resource and converge via Git.
+ * Reported in LOCAL status only; never sent to sync.
+ */
+export declare function collectUntrackedPaths(cwd: string, inventory: InventoryEntry[]): string[];
+export declare function cacheSnapshotPath(cwd: string, relPath: string): string;
+export declare function readCacheSnapshot(cwd: string, relPath: string): CacheSnapshot | null;
+export declare function writeCacheSnapshot(cwd: string, snapshot: CacheSnapshot): void;
+interface SyncResourceResult {
+    /** Server tracked-resource ROW id (null for untracked — no row exists). */
+    id: string | null;
+    path: string;
+    status: string;
+    serverVersionId: string | null;
+    serverSha256: string | null;
+    lastSyncedAt: string | null;
+}
+export declare function attachedWorkspaceId(root: string): string | null;
+export interface StatusResourceLine {
+    path: string;
+    kind: TrackedResourceKind | null;
+    owner: CanonicalOwner | null;
+    repoState: RepoState | null;
+    localSha: string | null;
+    baseSha: string | null;
+    dirty: boolean;
+    /**
+     * Metadata-only-pull guard (spec §3.3): the base was pulled ahead of the
+     * working content, so `apply` will refuse until the bytes are delivered.
+     */
+    contentPending?: boolean;
+    /** Definitional local statuses: cache-known-but-deleted / rule-less files. */
+    localStatus?: 'missing' | 'untracked';
+    remoteStatus?: string;
+    serverVersionId?: string | null;
+}
+/** Resolves a git ref (e.g. `origin/main`) to a SHA; null when absent/non-git. */
+export type GitRefReader = (cwd: string, ref: string) => string | null;
+/**
+ * "repo moved since your last pull" — the server's recorded DEFAULT-branch push
+ * SHA differs from what the LOCAL repo knows the default branch to be. Compared
+ * against the default-branch ref (never bare HEAD) so being on a feature branch
+ * or carrying local commits never triggers a false positive.
+ */
+export interface FreshnessSignal {
+    serverSha: string;
+    branch: string | null;
+    pushedAt: string | null;
+    localDefaultSha: string;
+}
+/** A session branch worth reporting: an old active session or an ended, unmerged one. */
+export interface StaleSessionBranch {
+    sessionId: string;
+    branch: string;
+    startedAt: string | null;
+    reason: 'active-stale' | 'unmerged';
+}
+export interface StatusResult {
+    root: string;
+    workspaceId: string | null;
+    remote: boolean;
+    resources: StatusResourceLine[];
+    /** Set only when the hosted repo's default branch moved past the local ref (ALI-996). */
+    freshness?: FreshnessSignal | null;
+    /** Branched sessions worth attention; empty for local-only workspaces (ALI-972). */
+    staleSessionBranches?: StaleSessionBranch[];
+}
+export declare function runWorkspaceStatus(opts?: CommonOptions & {
+    remote?: boolean;
+    gitRef?: GitRefReader;
+    now?: () => number;
+}): Promise<StatusResult>;
+export interface SyncResultLine extends SyncResourceResult {
+    cacheAdvanced: boolean;
+}
+export interface SyncResult {
+    root: string;
+    workspaceId: string;
+    resources: SyncResultLine[];
+}
+export declare function runWorkspaceSync(opts?: CommonOptions): Promise<SyncResult>;
+export interface PullResult {
+    path: string;
+    status: 'converged' | 'refused' | 'noop';
+    remoteStatus: string | null;
+    reason?: string;
+    note?: string;
+    manifestUpdated: boolean;
+    cacheAdvanced: boolean;
+}
+export declare function runWorkspacePull(targetPath: string, opts?: CommonOptions): Promise<PullResult>;
+export interface ApplyResult {
+    path: string;
+    status: 'applied' | 'refused' | 'noop';
+    reason?: string;
+    /** Recovery guidance for server 409 refusals (re-sync, then re-drive). */
+    hint?: string;
+    versionId?: string | null;
+    contentSha256?: string | null;
+    lastSyncedAt?: string | null;
+    manifestUpdated: boolean;
+    cacheAdvanced: boolean;
+}
+export declare function runWorkspaceApply(targetPath: string, opts?: CommonOptions): Promise<ApplyResult>;
+export interface WorkspaceSyncIo {
+    json: boolean;
+    print: (line: string) => void;
+    fetcher?: WorkspaceSyncFetcher;
+}
+export declare function workspaceSyncCommand(args: string[], io: WorkspaceSyncIo): Promise<number>;
+export {};
+//# sourceMappingURL=workspace-sync.d.ts.map

package/dist/workspace-sync.d.ts.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,92 @@
+export declare const WORKSPACE_DIR_NAME = ".orizu";
+export declare const WORKSPACE_SCHEMA_VERSION = "orizu.workspace.v0";
+export declare const WORKSPACE_SETUP_VERSION = "0.1.0";
+export declare const WORKSPACE_ROOT_FILES: readonly ["README.md", "orizu.team.json", "AGENTS.md", "CLAUDE.md", "Memory.md", ".gitignore"];
+export declare const WORKSPACE_ROOT_DIRS: readonly [".orizu", "source-repos", "projects", "sessions"];
+export declare const PROJECT_ROOT_FILES: readonly ["README.md", "memory.md", "orizu.project.json", ".gitignore"];
+export declare const PROJECT_PRIMITIVE_DIRS: readonly ["datasets", "apps", "tasks", "prompts", "judges", "scorers", "runners", "optimizations"];
+export declare const REPO_STATES: readonly ["source", "draft", "snapshot", "mirror", "cache", "object_ref_only"];
+export declare const CANONICAL_OWNERS: readonly ["repo", "orizu-db", "object-storage", "local"];
+export type RepoState = typeof REPO_STATES[number];
+export type CanonicalOwner = typeof CANONICAL_OWNERS[number];
+export type WorkspaceOperationAction = 'create_file' | 'create_dir' | 'append_gitignore' | 'create_symlink' | 'write_pointer_file' | 'rename_file' | 'replace_file' | 'replace_symlink';
+export interface WorkspaceOperation {
+    action: WorkspaceOperationAction;
+    path: string;
+    safe: boolean;
+    reason: string;
+    content?: string;
+    entries?: string[];
+    sourcePath?: string;
+    target?: string;
+}
+export interface WorkspaceProjectSeed {
+    slug: string;
+    id?: string | null;
+    name?: string | null;
+}
+export type WorkspaceFindingSeverity = 'error' | 'warning' | 'info';
+export interface WorkspaceFinding {
+    severity: WorkspaceFindingSeverity;
+    code: string;
+    path?: string;
+    message: string;
+    fixable: boolean;
+}
+export interface WorkspaceInitOptions {
+    cwd?: string;
+    workspaceRoot?: string;
+    teamSlug?: string | null;
+    teamId?: string | null;
+    projectSlug?: string | null;
+    projects?: WorkspaceProjectSeed[];
+    baseUrl?: string | null;
+    serviceOrigin?: string | null;
+    attachWorkspaceId?: string | null;
+    cliVersion?: string | null;
+    dryRun?: boolean;
+    validateOnly?: boolean;
+    fix?: boolean;
+    noSymlinks?: boolean;
+}
+export interface WorkspaceInitResult {
+    root: string;
+    state: 'created' | 'exists' | 'would-create' | 'validated' | 'invalid' | 'repaired';
+    gitignoreUpdated: boolean;
+    actions: string[];
+    operations: WorkspaceOperation[];
+    findings: WorkspaceFinding[];
+}
+interface WorkspaceSetupPlan {
+    root: string;
+    teamSlug: string;
+    projects: WorkspaceProjectSeed[];
+    operations: WorkspaceOperation[];
+    findings: WorkspaceFinding[];
+    exists: boolean;
+}
+export declare function getWorkspaceRoot(cwd?: string): string;
+export declare function workspaceExists(cwd?: string): boolean;
+/**
+ * `orizu setup`'s hosted path clones the workbench repo into the resolved
+ * workspace root; `git clone` refuses to write into ANY non-empty directory —
+ * including one holding only macOS `.DS_Store` cruft — and fails late with a
+ * raw git error (ALI QA: founder ran `orizu setup` from an existing folder).
+ * Call this right before the hosted clone so the failure is immediate and
+ * actionable instead of surfacing mid-clone.
+ *
+ * A directory is usable only when it doesn't exist yet, is STRICTLY empty
+ * (`readdirSync(...).length === 0` — no `.DS_Store` allowance, since git itself
+ * grants none), or is already a recognized Orizu workspace for a re-run
+ * (`workspaceExists`, i.e. it has `orizu.team.json`) — the legitimate
+ * idempotent-setup case, which must proceed. Symlinks are followed (a symlink
+ * to an empty dir is fine); a file, an unreadable dir, and a non-empty dir each
+ * get a distinct, friendly message.
+ */
+export declare function assertWorkspaceDirUsable(root: string): void;
+export declare function planWorkspaceSetup(options?: WorkspaceInitOptions): WorkspaceSetupPlan;
+export declare function readJsonManifest(path: string): Record<string, unknown> | null;
+export declare function validateWorkspaceContract(options?: WorkspaceInitOptions): WorkspaceFinding[];
+export declare function initOrizuWorkspace(options?: WorkspaceInitOptions): WorkspaceInitResult;
+export {};
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

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

package/dist/zip-draft-push.d.ts

@@ -0,0 +1,55 @@
+/**
+ * ADR-007 P5 (ALI-1074): the session-scoped, commit-first runner/optimizer
+ * push.
+ *
+ * `orizu runners|optimizers push --session <id>` sends the SAME deterministic
+ * zip as the legacy push to POST /api/cli/{runners|optimizers}/drafts: the
+ * server unpacks the zip's file set and commits it to the session's
+ * `orizu/session-*` branch (one Git Data API commit; binary entries travel
+ * base64), keeps uploading the zip to storage (dual-write until ALI-1046),
+ * and writes a DRAFT row pinning repo_path/content_sha/commit_sha. The draft
+ * seals — and gets its version number — when the session branch merges via
+ * `orizu session finish` + promotion-manifest apply.
+ *
+ * Labels cannot ride a draft push (`--label` with `--session` is an error at
+ * the command layer): labels address sealed versions only.
+ *
+ * Lives outside index.ts per the CLI line ratchet (ALI-976); mirrors
+ * prompt-draft-push.ts.
+ */
+/** index.ts helpers injected by the command dispatcher (report-comments-cli
+ * precedent: command modules receive a ctx instead of importing the CLI
+ * entrypoint). */
+export interface ZipArtifactPushContext {
+    getArg: (name: string) => string | null;
+    getPositionalArg: (index: number) => string | null;
+    resolveProjectSlug: (projectArg: string | null) => Promise<string>;
+    readManifestFile: (dirArg: string) => Record<string, unknown>;
+    expandHomePath: (path: string) => string;
+    hasJsonFlag: () => boolean;
+    printJson: (value: Record<string, unknown>) => void;
+    printLine: (message?: string) => void;
+    parseJsonResponse: (response: Response, label: string) => Promise<Record<string, unknown>>;
+}
+/** The full `orizu runners|optimizers push` command (moved out of index.ts
+ * for the CLI line ratchet): --session takes the ADR-007 P5 commit-first
+ * draft path, sessionless stays on the legacy zip-only endpoint. */
+export declare function runZipArtifactPush(kind: 'runner' | 'optimizer', ctx: ZipArtifactPushContext): Promise<void>;
+export interface PushZipDraftInput {
+    kind: 'runner' | 'optimizer';
+    project: string;
+    sessionId: string;
+    name: string;
+    description?: string;
+    manifest: Record<string, unknown>;
+    zipBase64: string;
+    contentSha256: string;
+    /** Test seam; defaults to the authenticated CLI fetcher. */
+    fetcher?: (path: string, init?: RequestInit) => Promise<Response>;
+}
+export interface PushZipDraftResult {
+    data: Record<string, unknown>;
+    message: string;
+}
+export declare function pushZipDraft(input: PushZipDraftInput): Promise<PushZipDraftResult>;
+//# sourceMappingURL=zip-draft-push.d.ts.map

package/dist/zip-draft-push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-draft-push.d.ts","sourceRoot":"","sources":["../src/zip-draft-push.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;kBAEkB;AAClB,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IACvC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IAClD,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAClE,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7D,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACxC,WAAW,EAAE,MAAM,OAAO,CAAA;IAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IACnD,SAAS,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CAC3F;AAED;;oEAEoE;AACpE,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,QAAQ,GAAG,WAAW,EAC5B,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAkEf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAClE;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAwCxF"}

package/package.json

@@ -1,14 +1,27 @@
 {
   "name": "orizu",
-  "version": "0.5.20",
+  "version": "0.5.21",
   "private": false,
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./instruction-set-loader": {
+      "types": "./dist/instruction-set-loader.d.ts",
+      "default": "./dist/instruction-set-loader.js"
+    }
+  },
   "bin": {
     "orizu": "dist/index.js"
   },
   "files": [
     "README.md",
     "dist",
+    "requirements",
     "scripts",
     "src",
     "tsconfig.json",