All files / core/blong-gogo/src/adapter/server workspace.ts

46.37% Statements 32/69
100% Branches 0/0
100% Functions 0/0
46.37% Lines 32/69

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 701x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x 1x                                                                            
import type {Adapter} from '@feasibleone/blong/types';
import {adapter} from '@feasibleone/blong/types';
 
import type {IWorkspaceCommand, IWorkspaceConfig} from '../impl/workspaceFs.ts';
import {
    workspaceList,
    workspacePrepare,
    workspaceRead,
    workspaceRemove,
    workspaceRollback,
    workspaceRun,
    workspaceWrite,
} from '../impl/workspaceFs.ts';
 
/**
 * `adapter.workspace` — the ticket's directory as one vocabulary.
 *
 * Seven methods, grouped by what they act on: `workspace.repo.prepare`, `workspace.repo.rollback`,
 * `workspace.repo.remove`, `workspace.file.read`, `workspace.file.write`, `workspace.file.list` and
 * `workspace.command.run`. The filesystem and process client is this adapter's, so no handler ever
 * opens a file or spawns anything itself (`@@D-710`).
 *
 * The root, the template and whether a command may run at all are deployment configuration, and the
 * same adapter may be instantiated more than once under different names (`@@D-712`) — one instance per
 * workspace root a deployment keeps.
 */
export interface IConfig extends IWorkspaceConfig {
    /** Directory a command may see, besides `PATH`. Always scrubbed to this map. */
    env?: Record<string, string>;
}
 
export default adapter<IConfig>(() => ({
    activation: {
        default: {
            namespace: 'workspace',
            imports: [/\.workspace$/],
            root: '.agent-workspace',
            shell: {enabled: false},
        },
    },
    /** Open the adapter's loop before the platform serves; without it `start` never settles (`@@F-651`). */
    start(this: Adapter<IConfig>) {
        super.connect();
        return super.start();
    },
    repoPrepare(this: Adapter<IConfig>, params: {ticketId: string}) {
        return workspacePrepare(this.config, params);
    },
    repoRollback(this: Adapter<IConfig>, params: {ticketId: string; baseCommit?: string}) {
        return workspaceRollback(this.config, params);
    },
    repoRemove(this: Adapter<IConfig>, params: {ticketId: string}) {
        return workspaceRemove(this.config, params);
    },
    fileRead(this: Adapter<IConfig>, params: {ticketId: string; path: string}) {
        return workspaceRead(this.config, params);
    },
    fileWrite(this: Adapter<IConfig>, params: {ticketId: string; path: string; content: string}) {
        return workspaceWrite(this.config, params);
    },
    fileList(this: Adapter<IConfig>, params: {ticketId: string; path?: string}) {
        return workspaceList(this.config, params);
    },
    commandRun(this: Adapter<IConfig>, params: IWorkspaceCommand) {
        // The account-level allowlist is the deployment's `shell.env`; the command itself is argv, so
        // there is no shell to interpret it.
        return workspaceRun(this.config, params);
    },
}));