Arcane.development.setup()

This focused page is derived from the mechanically checked full member inventory.

Syntax

Arcane.development.setup(root, taskId)

Parameters

Checkout root; root-dependencies, machine-dependencies, git-hooks, or windows-signing

Return value

Promise<{root, taskId, completed:true, exitCode, operation}>

Description

Runs one inspected allowlisted development setup task with operation progress. Developer-only; requires development.manage.

Overview

Runs one setup task previously reported by Arcane.development.inspect(). This is a Developer-only, exclusive mutation requiring development.manage. It can install dependency trees, configure Git hooks, or initialize local Microsoft NT development signing, so show the exact task and obtain confirmation before dispatch.

Task IDs and operation result

Pass the approved checkout root and one exact taskId:

• root-dependencies
• machine-dependencies
• git-hooks
• windows-signing (Microsoft NT only)

Core rejects every other value. Node.js 22+ with npm and Git are required for all four tasks because Core validates repository lineage before dispatching any setup operation. Missing Git rejects with DEVELOPMENT_GIT_REQUIRED. The promise resolves to {root,taskId,completed:true,exitCode,operation} after the owned task completes. Follow operation.started, operation.log, operation.progress, operation.completed, and operation.failed for visible long-work status.

Example

async function runConfirmedSetupTask(root, taskId) {
    const inspection = await Arcane.development.inspect(root);
    const task = inspection.readiness.tasks.find(function findSetupTask(item) {
        return item.id === taskId;
    });
    if (!task || !task.available) throw new Error('Setup task is unavailable');
    return Arcane.development.setup(root, taskId);
}

document.querySelector('#install-root-dependencies')?.addEventListener(
    'click',
    async function handleDependencySetup() {
        const result = await runConfirmedSetupTask('C:\\ArcaneOS', 'root-dependencies');
        console.log(result.completed, result.exitCode);
    }
);

Reference group

Session, provisioning, diagnostics, and development