Arcane.development.context()

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

Syntax

Arcane.development.context(root, query)

Parameters

Approved checkout root; 1–4,096-character query

Return value

Promise<{root, query, files, totals}>

Description

Gets redacted context from at most ten tracked safe text files, bounded to 6,144 characters per file and 49,152 characters overall. Developer-only; requires development.read.

Overview

Returns bounded, redacted source excerpts from tracked text files in an approved Arcane checkout. It is intended for local developer assistance, not arbitrary filesystem search. Core excludes Git metadata, dependencies, generated output, credential-like paths, secret file names, binary extensions, links, and files outside the checkout.

Query and result bounds

Requires development.read and the developer app ID. query must contain 1–4,096 text characters. Core derives at most six search terms, ranks tracked files, and returns at most ten files, 6,144 characters of excerpt per file, and 49,152 characters of excerpt text overall. Individual candidates over 512 KiB are excluded. Git and valid repository lineage are prerequisites; a missing Git installation rejects with DEVELOPMENT_GIT_REQUIRED before source collection.

The promise resolves to {root,query,files,totals}. Each file record contains {path,bytes,sha256,truncated,redacted,content}. A digest identifies the read bytes for correlation only; it is not publisher authentication. Review returned content before sending it to any external service even when redacted is true.

Example

async function findStorageImplementation(root) {
    const result = await Arcane.development.context(
        root,
        'Where is app-scoped storage validated and persisted?'
    );
    return result.files.map(function selectContextFile(file) {
        return { path: file.path, content: file.content, redacted: file.redacted };
    });
}

console.log(await findStorageImplementation('C:\\ArcaneOS'));

Reference group

Session, provisioning, diagnostics, and development