@neuralis/brain-core 0.3.1 → 0.4.0

package/dist/scripts/sourceRootPairV1.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The source-root-pair OFFLINE upgrade (`neuralis upgrade`, app STOPPED):
+ * `brain-core/source-config` v2 → v3. A `local` source's absolute root gets the
+ * missing half of its pair wherever one derives (`domain/sourceRootPair.ts` —
+ * the same derivation the create route and the store's fill run), so a source
+ * attached on one plane opens on the other over the same data home:
+ *  - (i)   a container-home root gets the machine home's path;
+ *  - (ii)  a mount root with a known host path gets that path;
+ *  - (iii) a machine path under the machine home becomes the container spelling,
+ *          the machine path its `hostRoot`.
+ * A root nothing derives (iv) and a relative root are kept as written. An
+ * existing pair is NEVER rewritten: one that disagrees with the derivation, or
+ * one no table can derive (a hand-set `hostRoot`), is LISTED by project and slug
+ * and left as it is. Every record — every kind — is stamped `formatVersion: 3`,
+ * so "the store is v3" is true record by record.
+ *
+ * The plane facts come from the operator command's runtime stack (`stackFor`):
+ * inside the container its own home is the container spelling and
+ * `NEURALIS_HOST_HOME` the machine's; on the host the data home IS the machine
+ * home. `dryRun` writes nothing; `apply` is idempotent — a second run finds
+ * every record v3 and every derivable half filled, and writes nothing.
+ */
+import { type OfflineUpgradeContext, type OfflineUpgradeModule } from '@neuralis/package-system/data';
+import { type SourceRootPlane, type SourceRootRule, type SourceRootStack } from '../src/domain/sourceRootPair.js';
+export declare const SOURCE_ROOT_PAIR_STEP: {
+    readonly id: 'source-root-pair-v1';
+    readonly kind: "brain-core/source-config";
+    readonly to: 3;
+};
+type Json = Record<string, unknown>;
+/** One source config: what it is under the derivation, and the record to write (absent ⇒ unchanged). */
+export type SourceRootPairRow = {
+    /** Home-relative path of the record. */
+    file: string;
+    projectId: string;
+    slug: string;
+    /** `filled` — a half was derived; `kept` — nothing to derive; `hand-set` / `disagrees` — an existing pair left as it is. */
+    outcome: 'filled' | 'kept' | 'hand-set' | 'disagrees' | 'not-local';
+    rule?: SourceRootRule;
+    next?: Json;
+};
+/** Every source config of the install, classified. Reads only. */
+export declare function inspectSourceRootPairs(ctx: OfflineUpgradeContext, plane: SourceRootPlane): Promise<SourceRootPairRow[]>;
+/** The step over the plane facts the operator command's runtime stack names. */
+export declare function createSourceRootPairUpgrade(stackFor: (ctx: OfflineUpgradeContext) => SourceRootStack): OfflineUpgradeModule;
+export {};
+//# sourceMappingURL=sourceRootPairV1.d.ts.map

package/dist/scripts/sourceRootPairV1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceRootPairV1.d.ts","sourceRoot":"","sources":["../../scripts/sourceRootPairV1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAsB,KAAK,qBAAqB,EAAE,KAAK,oBAAoB,EAA2B,MAAM,+BAA+B,CAAC;AAEnJ,OAAO,EAAmC,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,iCAAiC,CAAC;AASnJ,eAAO,MAAM,qBAAqB;aAAK,EAAE,EAAE,qBAAqB;aAAE,IAAI;aAA6B,EAAE;CAAyB,CAAC;AAE/H,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAGpC,wGAAwG;AACxG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,4HAA4H;IAC5H,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;IACpE,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,CAAC;AAiBF,kEAAkE;AAClE,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAkD7H;AA4BD,gFAAgF;AAChF,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,eAAe,GAAG,oBAAoB,CAW3H"}

package/dist/scripts/sourceRootPairV1.js

@@ -0,0 +1,147 @@
+/**
+ * The source-root-pair OFFLINE upgrade (`neuralis upgrade`, app STOPPED):
+ * `brain-core/source-config` v2 → v3. A `local` source's absolute root gets the
+ * missing half of its pair wherever one derives (`domain/sourceRootPair.ts` —
+ * the same derivation the create route and the store's fill run), so a source
+ * attached on one plane opens on the other over the same data home:
+ *  - (i)   a container-home root gets the machine home's path;
+ *  - (ii)  a mount root with a known host path gets that path;
+ *  - (iii) a machine path under the machine home becomes the container spelling,
+ *          the machine path its `hostRoot`.
+ * A root nothing derives (iv) and a relative root are kept as written. An
+ * existing pair is NEVER rewritten: one that disagrees with the derivation, or
+ * one no table can derive (a hand-set `hostRoot`), is LISTED by project and slug
+ * and left as it is. Every record — every kind — is stamped `formatVersion: 3`,
+ * so "the store is v3" is true record by record.
+ *
+ * The plane facts come from the operator command's runtime stack (`stackFor`):
+ * inside the container its own home is the container spelling and
+ * `NEURALIS_HOST_HOME` the machine's; on the host the data home IS the machine
+ * home. `dryRun` writes nothing; `apply` is idempotent — a second run finds
+ * every record v3 and every derivable half filled, and writes nothing.
+ */
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { isAbsolute, join, relative, resolve } from 'node:path';
+import { durableReplaceFile } from '@neuralis/package-system/data';
+import { SOURCE_CONFIG_FORMAT } from '../src/store/dataFormats.js';
+import { pairSourceRoot, sourceRootPlane } from '../src/domain/sourceRootPair.js';
+/**
+ * The format THIS step writes. A chained step pins its own and never imports
+ * the live `SOURCE_CONFIG_FORMAT.version`: a later step raises the live one,
+ * and this step must still stamp what IT wrote.
+ */
+const STEP_VERSION = 3;
+export const SOURCE_ROOT_PAIR_STEP = { id: 'source-root-pair-v1', kind: SOURCE_CONFIG_FORMAT.kind, to: STEP_VERSION };
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** Classify an EXISTING absolute pair against the derivation: agrees, disagrees, or nothing derives it. */
+function judgeStoredPair(root, hostRoot, plane) {
+    const fromRoot = pairSourceRoot(root, plane);
+    if (fromRoot.hostRoot !== undefined)
+        return fromRoot.hostRoot === resolve(hostRoot) ? 'agrees' : 'disagrees';
+    const fromHost = pairSourceRoot(hostRoot, plane);
+    if (fromHost.rule === 'machine-home')
+        return fromHost.root === fromRoot.root ? 'agrees' : 'disagrees';
+    return 'hand-set';
+}
+async function readJson(file) {
+    const record = JSON.parse(await readFile(file, 'utf8'));
+    if (!isObject(record))
+        throw new Error(`${file} is not a source config`);
+    return record;
+}
+/** Every source config of the install, classified. Reads only. */
+export async function inspectSourceRootPairs(ctx, plane) {
+    const base = join(ctx.appRoot, 'config', 'sources');
+    let projects;
+    try {
+        projects = (await readdir(base)).sort();
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    const rows = [];
+    for (const projectId of projects) {
+        const dir = join(base, projectId);
+        if (!(await stat(dir)).isDirectory())
+            continue;
+        for (const name of (await readdir(dir)).filter((entry) => entry.endsWith('.json')).sort()) {
+            const path = join(dir, name);
+            const record = await readJson(path);
+            const file = relative(ctx.home, path);
+            const slug = typeof record.source === 'string' ? record.source : name.slice(0, -'.json'.length);
+            const connection = isObject(record.connection) ? record.connection : {};
+            const config = isObject(connection.config) ? connection.config : {};
+            let row = { file, projectId, slug, outcome: 'not-local' };
+            let nextConfig = config;
+            // A record a later step already raised is past this one (a resumed chain): never re-read, never lowered.
+            const raised = typeof record.formatVersion === 'number' && record.formatVersion > STEP_VERSION;
+            if (!raised && connection.kind === 'local' && typeof config.root === 'string' && config.root.length > 0) {
+                const { root, hostRoot } = config;
+                if (!isAbsolute(root)) {
+                    row = { ...row, outcome: 'kept', rule: 'relative' };
+                }
+                else if (typeof hostRoot === 'string') {
+                    const verdict = judgeStoredPair(root, hostRoot, plane);
+                    row = { ...row, outcome: verdict === 'agrees' ? 'kept' : verdict };
+                }
+                else {
+                    const derived = pairSourceRoot(root, plane);
+                    if (derived.hostRoot !== undefined) {
+                        nextConfig = { ...config, root: derived.root, hostRoot: derived.hostRoot };
+                        row = { ...row, outcome: 'filled', rule: derived.rule };
+                    }
+                    else {
+                        row = { ...row, outcome: 'kept', rule: derived.rule };
+                    }
+                }
+            }
+            const next = raised
+                ? record
+                : nextConfig === config
+                    ? { ...record, formatVersion: STEP_VERSION }
+                    : { ...record, connection: { ...connection, config: nextConfig }, formatVersion: STEP_VERSION };
+            rows.push(JSON.stringify(next) === JSON.stringify(record) ? row : { ...row, next });
+        }
+    }
+    return rows;
+}
+const RULE_LABEL = {
+    'container-home': '(i) data home', mount: '(ii) mount', 'machine-home': '(iii) machine path', none: '(iv) one spelling', relative: 'relative',
+};
+function asPlan(rows) {
+    const count = (outcome, rule) => rows.filter((row) => row.outcome === outcome && (rule === undefined || row.rule === rule)).length;
+    const named = (outcome, rule) => rows.filter((row) => row.outcome === outcome && (rule === undefined || row.rule === rule)).map((row) => `  ${row.projectId} · ${row.slug}`);
+    const writes = rows.filter((row) => row.next).length;
+    const notDerivable = named('kept', 'none');
+    const handSet = named('hand-set');
+    const disagreeing = named('disagrees');
+    return {
+        files: writes > 0 ? ['app/config/sources'] : [],
+        summary: [
+            `source configs: ${rows.length} read, ${writes} to rewrite (every record stamped v${STEP_VERSION})`,
+            `root pairs filled: ${['container-home', 'mount', 'machine-home'].map((rule) => `${RULE_LABEL[rule]} ${count('filled', rule)}`).join(', ')}`,
+            `kept as written: ${RULE_LABEL.none} ${count('kept', 'none')}, ${RULE_LABEL.relative} ${count('kept', 'relative')}, hand-set ${handSet.length}, disagreeing ${disagreeing.length}`,
+            ...(notDerivable.length > 0 ? ['Not derivable — the root is read as written on both planes (project · source):', ...notDerivable] : []),
+            ...(handSet.length > 0 ? ['Hand-set hostRoot no table derives, left as it is (project · source):', ...handSet] : []),
+            ...(disagreeing.length > 0 ? ['Pairs that disagree with the derivation, left as they are (project · source):', ...disagreeing] : []),
+        ],
+    };
+}
+/** The step over the plane facts the operator command's runtime stack names. */
+export function createSourceRootPairUpgrade(stackFor) {
+    return {
+        id: SOURCE_ROOT_PAIR_STEP.id,
+        kinds: [{ kind: SOURCE_ROOT_PAIR_STEP.kind, to: SOURCE_ROOT_PAIR_STEP.to }],
+        dryRun: async (ctx) => asPlan(await inspectSourceRootPairs(ctx, sourceRootPlane(stackFor(ctx)))),
+        async apply(ctx) {
+            const rows = await inspectSourceRootPairs(ctx, sourceRootPlane(stackFor(ctx)));
+            for (const row of rows)
+                if (row.next)
+                    await durableReplaceFile(join(ctx.home, row.file), JSON.stringify(row.next, null, 2));
+            ctx.log(`${SOURCE_ROOT_PAIR_STEP.id}: ${rows.filter((row) => row.next).length} of ${rows.length} source config(s) rewritten, ${rows.filter((row) => row.outcome === 'filled').length} root pair(s) filled`);
+        },
+    };
+}
+//# sourceMappingURL=sourceRootPairV1.js.map

package/dist/scripts/sourceRootPairV1.js.map

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

package/dist/scripts/sourceToFolderV1.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The source-to-folder OFFLINE upgrade (`neuralis upgrade`, app STOPPED):
+ * `brain-core/source-config` v3 → v4. The two folder kinds become ONE, the
+ * `folder` kind, whose transport the stored config picks:
+ *  - a `local` record becomes a `folder` with its config unchanged (the
+ *    in-process filesystem, its root pair kept as written);
+ *  - a `host` record (or a `host-*` kind) becomes a `folder` carrying its
+ *    `device` (the device transport) — `source-device-v1`, which runs first,
+ *    stamped that device into every host record that named none;
+ *  - `recognizesPackages: true` becomes `packageFolders: ['']` (the whole source
+ *    as one package folder); `recognizesPackages: false` is dropped.
+ * Every record — every kind — is stamped `formatVersion: 4`, so "the store is
+ * v4" is true record by record; the agent-core `host-source-config` kind the
+ * host records also answered to is retired with this step.
+ *
+ * The kind literals this step reads are pinned HERE (`local`, `host`,
+ * `host-*`): the live code no longer names them. A host record without a
+ * well-formed device, or with a `hostRoot` beside its device (the folder kind
+ * refuses the two together), is a BLOCKER listed by project and slug — the
+ * operator removes or repairs it in the running older build first. `dryRun`
+ * writes nothing; `apply` is idempotent — a second run finds every record v4
+ * and writes nothing.
+ */
+import { type OfflineUpgradeContext, type OfflineUpgradeModule } from '@neuralis/package-system/data';
+export declare const SOURCE_TO_FOLDER_STEP: {
+    readonly id: 'source-to-folder-v1';
+    readonly kind: "brain-core/source-config";
+    readonly to: 4;
+};
+type Json = Record<string, unknown>;
+/** One source config: what the merge makes of it, and the record to write (absent ⇒ unchanged). */
+export type SourceToFolderRow = {
+    /** Home-relative path of the record. */
+    file: string;
+    projectId: string;
+    slug: string;
+    /** `in-process` — was `local`; `device` — was a host kind; `other` — another kind (stamp only); `blocked` — see `blocker`. */
+    outcome: 'in-process' | 'device' | 'other' | 'blocked';
+    /** The record carried `recognizesPackages: true` and now carries `packageFolders: ['']`. */
+    packages: boolean;
+    blocker?: string;
+    next?: Json;
+};
+/** The merged record for one stored config (pure; exported for the unit suite). */
+export declare function mergeSourceRecord(record: Json): {
+    next: Json;
+    outcome: SourceToFolderRow['outcome'];
+    packages: boolean;
+    blocker?: string;
+};
+/** Every source config of the install, classified. Reads only. */
+export declare function inspectSourceToFolder(ctx: OfflineUpgradeContext): Promise<SourceToFolderRow[]>;
+/** The step (the host module names it for `scripts/upgrade.mts`). */
+export declare function createSourceToFolderUpgrade(): OfflineUpgradeModule;
+export {};
+//# sourceMappingURL=sourceToFolderV1.d.ts.map

package/dist/scripts/sourceToFolderV1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceToFolderV1.d.ts","sourceRoot":"","sources":["../../scripts/sourceToFolderV1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,EAAsB,KAAK,qBAAqB,EAAE,KAAK,oBAAoB,EAA2B,MAAM,+BAA+B,CAAC;AAanJ,eAAO,MAAM,qBAAqB;aAAK,EAAE,EAAE,qBAAqB;aAAE,IAAI;aAA6B,EAAE;CAAyB,CAAC;AAO/H,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAGpC,mGAAmG;AACnG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,8HAA8H;IAC9H,OAAO,EAAE,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IACvD,4FAA4F;IAC5F,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,CAAC;AAQF,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAkC1I;AAED,kEAAkE;AAClE,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA2BpG;AAmBD,qEAAqE;AACrE,wBAAgB,2BAA2B,IAAI,oBAAoB,CAelE"}

package/dist/scripts/sourceToFolderV1.js

@@ -0,0 +1,152 @@
+/**
+ * The source-to-folder OFFLINE upgrade (`neuralis upgrade`, app STOPPED):
+ * `brain-core/source-config` v3 → v4. The two folder kinds become ONE, the
+ * `folder` kind, whose transport the stored config picks:
+ *  - a `local` record becomes a `folder` with its config unchanged (the
+ *    in-process filesystem, its root pair kept as written);
+ *  - a `host` record (or a `host-*` kind) becomes a `folder` carrying its
+ *    `device` (the device transport) — `source-device-v1`, which runs first,
+ *    stamped that device into every host record that named none;
+ *  - `recognizesPackages: true` becomes `packageFolders: ['']` (the whole source
+ *    as one package folder); `recognizesPackages: false` is dropped.
+ * Every record — every kind — is stamped `formatVersion: 4`, so "the store is
+ * v4" is true record by record; the agent-core `host-source-config` kind the
+ * host records also answered to is retired with this step.
+ *
+ * The kind literals this step reads are pinned HERE (`local`, `host`,
+ * `host-*`): the live code no longer names them. A host record without a
+ * well-formed device, or with a `hostRoot` beside its device (the folder kind
+ * refuses the two together), is a BLOCKER listed by project and slug — the
+ * operator removes or repairs it in the running older build first. `dryRun`
+ * writes nothing; `apply` is idempotent — a second run finds every record v4
+ * and writes nothing.
+ */
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { durableReplaceFile } from '@neuralis/package-system/data';
+import { SOURCE_CONFIG_FORMAT } from '../src/store/dataFormats.js';
+/** The kind this step WROTE (v4) — pinned: a later step renames it, so the live constant cannot stand in. */
+const FOLDER_SOURCE_KIND = 'folder';
+/**
+ * The format THIS step writes. A chained step pins its own and never imports
+ * the live `SOURCE_CONFIG_FORMAT.version`: a later step raises the live one,
+ * and this step must still stamp what IT wrote.
+ */
+const STEP_VERSION = 4;
+export const SOURCE_TO_FOLDER_STEP = { id: 'source-to-folder-v1', kind: SOURCE_CONFIG_FORMAT.kind, to: STEP_VERSION };
+/** The pre-merge kinds, pinned as they were written (never the live plane predicate). */
+const OLD_IN_PROCESS_KIND = 'local';
+const isOldDeviceKind = (kind) => kind === 'host' || kind.startsWith('host-');
+const DEVICE_ID = /^dev_[A-Za-z0-9]+$/;
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+async function readJson(file) {
+    const record = JSON.parse(await readFile(file, 'utf8'));
+    if (!isObject(record))
+        throw new Error(`${file} is not a source config`);
+    return record;
+}
+/** The merged record for one stored config (pure; exported for the unit suite). */
+export function mergeSourceRecord(record) {
+    // A record a later step already raised (a resumed chain over a v5 store,
+    // where `host` names the ONE folder kind, not the old device kind) is past
+    // this step: passed through untouched, never re-read in the old vocabulary.
+    if (typeof record.formatVersion === 'number' && record.formatVersion > STEP_VERSION) {
+        return { next: record, outcome: 'other', packages: false };
+    }
+    const connection = isObject(record.connection) ? record.connection : {};
+    const kind = typeof connection.kind === 'string' ? connection.kind : '';
+    const config = isObject(connection.config) ? connection.config : {};
+    let outcome = 'other';
+    let nextConnection = connection;
+    if (kind === OLD_IN_PROCESS_KIND) {
+        outcome = 'in-process';
+        nextConnection = { ...connection, kind: FOLDER_SOURCE_KIND };
+    }
+    else if (isOldDeviceKind(kind)) {
+        if (typeof config.device !== 'string' || !DEVICE_ID.test(config.device)) {
+            return { next: record, outcome: 'blocked', packages: false, blocker: 'names no paired device (connection.config.device)' };
+        }
+        if (config.hostRoot !== undefined) {
+            return { next: record, outcome: 'blocked', packages: false, blocker: 'carries a hostRoot beside its device' };
+        }
+        outcome = 'device';
+        nextConnection = { ...connection, kind: FOLDER_SOURCE_KIND };
+    }
+    const { recognizesPackages, ...rest } = record;
+    const packages = recognizesPackages === true;
+    const next = {
+        ...rest,
+        connection: nextConnection,
+        ...(packages ? { packageFolders: [''] } : {}),
+        formatVersion: STEP_VERSION,
+    };
+    return { next, outcome, packages };
+}
+/** Every source config of the install, classified. Reads only. */
+export async function inspectSourceToFolder(ctx) {
+    const base = join(ctx.appRoot, 'config', 'sources');
+    let projects;
+    try {
+        projects = (await readdir(base)).sort();
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    const rows = [];
+    for (const projectId of projects) {
+        const dir = join(base, projectId);
+        if (!(await stat(dir)).isDirectory())
+            continue;
+        for (const name of (await readdir(dir)).filter((entry) => entry.endsWith('.json')).sort()) {
+            const path = join(dir, name);
+            const record = await readJson(path);
+            const file = relative(ctx.home, path);
+            const slug = typeof record.source === 'string' ? record.source : name.slice(0, -'.json'.length);
+            const merged = mergeSourceRecord(record);
+            const row = {
+                file, projectId, slug, outcome: merged.outcome, packages: merged.packages,
+                ...(merged.blocker ? { blocker: merged.blocker } : {}),
+            };
+            rows.push(merged.outcome === 'blocked' || JSON.stringify(merged.next) === JSON.stringify(record) ? row : { ...row, next: merged.next });
+        }
+    }
+    return rows;
+}
+function asPlan(rows) {
+    const count = (outcome) => rows.filter((row) => row.outcome === outcome).length;
+    const writes = rows.filter((row) => row.next).length;
+    const blocked = rows.filter((row) => row.blocker).map((row) => `${row.projectId} · ${row.slug} · ${row.file} · ${row.blocker}`);
+    return {
+        files: writes > 0 ? ['app/config/sources'] : [],
+        summary: [
+            `source configs: ${rows.length} read, ${writes} to rewrite (every record stamped v${STEP_VERSION})`,
+            `folders: ${count('in-process')} on this server (was local), ${count('device')} on a device (was host); other kinds ${count('other')}`,
+            `package folders: ${rows.filter((row) => row.packages).length} source(s) recognizing packages carry packageFolders ['']`,
+        ],
+        ...(blocked.length > 0
+            ? { blockers: { lines: blocked, remedy: 'in the running older build, remove that host source or re-attach it on its device, then stop the app and run the upgrade again' } }
+            : {}),
+    };
+}
+/** The step (the host module names it for `scripts/upgrade.mts`). */
+export function createSourceToFolderUpgrade() {
+    return {
+        id: SOURCE_TO_FOLDER_STEP.id,
+        kinds: [{ kind: SOURCE_TO_FOLDER_STEP.kind, to: SOURCE_TO_FOLDER_STEP.to }],
+        dryRun: async (ctx) => asPlan(await inspectSourceToFolder(ctx)),
+        async apply(ctx) {
+            const rows = await inspectSourceToFolder(ctx);
+            const blocked = rows.filter((row) => row.blocker);
+            if (blocked.length > 0) {
+                throw new Error(`${SOURCE_TO_FOLDER_STEP.id}: ${blocked.map((row) => `${row.projectId} · ${row.slug} · ${row.blocker}`).join('; ')}`);
+            }
+            for (const row of rows)
+                if (row.next)
+                    await durableReplaceFile(join(ctx.home, row.file), JSON.stringify(row.next, null, 2));
+            ctx.log(`${SOURCE_TO_FOLDER_STEP.id}: ${rows.filter((row) => row.next).length} of ${rows.length} source config(s) rewritten — ${rows.filter((row) => row.outcome === 'in-process').length} folder(s) on this server, ${rows.filter((row) => row.outcome === 'device').length} on a device`);
+        },
+    };
+}
+//# sourceMappingURL=sourceToFolderV1.js.map

package/dist/scripts/sourceToFolderV1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceToFolderV1.js","sourceRoot":"","sources":["../../scripts/sourceToFolderV1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAkF,MAAM,+BAA+B,CAAC;AACnJ,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,6GAA6G;AAC7G,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAEpC;;;;GAIG;AACH,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,oBAAoB,CAAC,IAAI,EAAE,EAAE,EAAE,YAAY,EAAW,CAAC;AAE/H,yFAAyF;AACzF,MAAM,mBAAmB,GAAG,OAAO,CAAC;AACpC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAC/F,MAAM,SAAS,GAAG,oBAAoB,CAAC;AAGvC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAiB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAgBzH,KAAK,UAAU,QAAQ,CAAC,IAAY;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC;IACnE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,yBAAyB,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,MAAY;IAC5C,yEAAyE;IACzE,2EAA2E;IAC3E,4EAA4E;IAC5E,IAAI,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,GAAG,YAAY,EAAE,CAAC;QACpF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7D,CAAC;IACD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,IAAI,GAAG,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,IAAI,OAAO,GAAiC,OAAO,CAAC;IACpD,IAAI,cAAc,GAAS,UAAU,CAAC;IACtC,IAAI,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACjC,OAAO,GAAG,YAAY,CAAC;QACvB,cAAc,GAAG,EAAE,GAAG,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC/D,CAAC;SAAM,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACxE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC;QAC7H,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;QAChH,CAAC;QACD,OAAO,GAAG,QAAQ,CAAC;QACnB,cAAc,GAAG,EAAE,GAAG,UAAU,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,EAAE,kBAAkB,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IAC/C,MAAM,QAAQ,GAAG,kBAAkB,KAAK,IAAI,CAAC;IAC7C,MAAM,IAAI,GAAS;QACjB,GAAG,IAAI;QACP,UAAU,EAAE,cAAc;QAC1B,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,aAAa,EAAE,YAAY;KAC5B,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACrC,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAA0B;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACpD,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAClE,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAwB,EAAE,CAAC;IACrC,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAClC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE;YAAE,SAAS;QAC/C,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1F,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAChG,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACzC,MAAM,GAAG,GAAsB;gBAC7B,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1I,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,MAAM,CAAC,IAAkC;IAChD,MAAM,KAAK,GAAG,CAAC,OAAqC,EAAU,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IACtH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAChI,OAAO;QACL,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAAE;QAC/C,OAAO,EAAE;YACP,mBAAmB,IAAI,CAAC,MAAM,UAAU,MAAM,sCAAsC,YAAY,GAAG;YACnG,YAAY,KAAK,CAAC,YAAY,CAAC,gCAAgC,KAAK,CAAC,QAAQ,CAAC,wCAAwC,KAAK,CAAC,OAAO,CAAC,EAAE;YACtI,oBAAoB,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,2DAA2D;SACzH;QACD,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YACpB,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,gIAAgI,EAAE,EAAE;YAC5K,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,EAAE,EAAE,qBAAqB,CAAC,EAAE;QAC5B,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,IAAI,EAAE,EAAE,EAAE,qBAAqB,CAAC,EAAE,EAAE,CAAC;QAC3E,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAC/D,KAAK,CAAC,KAAK,CAAC,GAAG;YACb,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,GAAG,qBAAqB,CAAC,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxI,CAAC;YACD,KAAK,MAAM,GAAG,IAAI,IAAI;gBAAE,IAAI,GAAG,CAAC,IAAI;oBAAE,MAAM,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5H,GAAG,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,OAAO,IAAI,CAAC,MAAM,iCAAiC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,YAAY,CAAC,CAAC,MAAM,8BAA8B,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,MAAM,cAAc,CAAC,CAAC;QAC9R,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/scripts/sourceToHostV1.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Offline upgrade `source-to-host-v1`, brain-core's half: the ONE folder kind
+ * is spelled `host` — `brain-core/source-config` v4 → v5. What a source MEANS
+ * does not move: `root`, `hostRoot` (the Docker mount's machine half) and
+ * `device` (the transport) are carried byte for byte, so every coordinate the
+ * runtime derives — the container path, the machine path, the device path — is
+ * the one it derived before.
+ *
+ * ONE root does move, in the same step: a folder on this server rooted in the
+ * Docker image's Neuralis tree (`/neuralis` or a folder under it — the
+ * `--neuralis` overlay's container spelling, where "Neuralis Skills" was
+ * attached) becomes the LOGICAL root `neuralis-tree:<folder>` and drops its
+ * machine half; the runtime resolves it on each plane (the overlay in Docker,
+ * the host's own tree natively), so the attach opens on both. Nothing reads the
+ * old spelling as an alias.
+ *
+ * Every record — every kind — is stamped `formatVersion: 5`, so "the store is
+ * v5" is a fact a reader can check per record. A record a later step already
+ * raised is passed through untouched. `dryRun` writes nothing; `apply` is
+ * idempotent — a second run finds every record v5 and writes nothing.
+ */
+import { type OfflineUpgradeContext, type OfflineUpgradePlan } from '@neuralis/package-system/data';
+export declare const SOURCE_TO_HOST_STEP: {
+    readonly id: 'source-to-host-v1';
+    readonly kind: "brain-core/source-config";
+    readonly to: 5;
+};
+/** `neuralis-tree:<rel>` for a root in the image tree; `null` for any other root. */
+export declare function treeAnchorFor(root: unknown): string | null;
+type Json = Record<string, unknown>;
+/** One source config: what the step makes of it, and the record to write (absent ⇒ unchanged). */
+export type SourceToHostRow = {
+    /** Home-relative path of the record. */
+    file: string;
+    projectId: string;
+    slug: string;
+    /** `local` / `device` — a v4 folder by its transport; `other` — another kind (stamp only); `current` — already v5. */
+    outcome: 'local' | 'device' | 'other' | 'current';
+    /** A folder on this server whose image-tree root became a `neuralis-tree:` root. */
+    anchored?: true;
+    next?: Json;
+};
+/** The v5 record for one stored v4 config (pure; exported for the unit suite). */
+export declare function hostRecordOf(record: Json): {
+    next: Json;
+    outcome: SourceToHostRow['outcome'];
+    anchored?: true;
+};
+/** Every source config of the install, classified. Reads only. */
+export declare function inspectSourceToHost(ctx: Pick<OfflineUpgradeContext, 'appRoot' | 'home'>): Promise<SourceToHostRow[]>;
+/** The dry-run lines of brain-core's half (the host module adds agent-core's). */
+export declare function sourceToHostSummary(rows: readonly SourceToHostRow[]): OfflineUpgradePlan;
+/** Write every changed record (idempotent: an unchanged one has no `next`). */
+export declare function applySourceToHost(ctx: Pick<OfflineUpgradeContext, 'home'>, rows: readonly SourceToHostRow[]): Promise<number>;
+export {};
+//# sourceMappingURL=sourceToHostV1.d.ts.map

package/dist/scripts/sourceToHostV1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceToHostV1.d.ts","sourceRoot":"","sources":["../../scripts/sourceToHostV1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,EAAsB,KAAK,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAMxH,eAAO,MAAM,mBAAmB;aAAK,EAAE,EAAE,mBAAmB;aAAE,IAAI;aAA6B,EAAE;CAAyB,CAAC;AAM3H,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAQ1D;AAMD,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAGpC,kGAAkG;AAClG,MAAM,MAAM,eAAe,GAAG;IAC5B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,sHAAsH;IACtH,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAClD,oFAAoF;IACpF,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb,CAAC;AAEF,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;CAAE,CAsB/G;AAQD,kEAAkE;AAClE,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,qBAAqB,EAAE,SAAS,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAuB1H;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,kBAAkB,CAWxF;AAED,+EAA+E;AAC/E,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAQnI"}

package/dist/scripts/sourceToHostV1.js

@@ -0,0 +1,132 @@
+/**
+ * Offline upgrade `source-to-host-v1`, brain-core's half: the ONE folder kind
+ * is spelled `host` — `brain-core/source-config` v4 → v5. What a source MEANS
+ * does not move: `root`, `hostRoot` (the Docker mount's machine half) and
+ * `device` (the transport) are carried byte for byte, so every coordinate the
+ * runtime derives — the container path, the machine path, the device path — is
+ * the one it derived before.
+ *
+ * ONE root does move, in the same step: a folder on this server rooted in the
+ * Docker image's Neuralis tree (`/neuralis` or a folder under it — the
+ * `--neuralis` overlay's container spelling, where "Neuralis Skills" was
+ * attached) becomes the LOGICAL root `neuralis-tree:<folder>` and drops its
+ * machine half; the runtime resolves it on each plane (the overlay in Docker,
+ * the host's own tree natively), so the attach opens on both. Nothing reads the
+ * old spelling as an alias.
+ *
+ * Every record — every kind — is stamped `formatVersion: 5`, so "the store is
+ * v5" is a fact a reader can check per record. A record a later step already
+ * raised is passed through untouched. `dryRun` writes nothing; `apply` is
+ * idempotent — a second run finds every record v5 and writes nothing.
+ */
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { durableReplaceFile } from '@neuralis/package-system/data';
+import { SOURCE_CONFIG_FORMAT } from '../src/store/dataFormats.js';
+/** The format THIS step writes — pinned, never the live `SOURCE_CONFIG_FORMAT.version`. */
+const STEP_VERSION = 5;
+export const SOURCE_TO_HOST_STEP = { id: 'source-to-host-v1', kind: SOURCE_CONFIG_FORMAT.kind, to: STEP_VERSION };
+/** The Docker spelling of the Neuralis tree, and the logical root this step writes for it — both pinned. */
+const IMAGE_NEURALIS_TREE = '/neuralis';
+const V5_TREE_ANCHOR = 'neuralis-tree:';
+/** `neuralis-tree:<rel>` for a root in the image tree; `null` for any other root. */
+export function treeAnchorFor(root) {
+    if (typeof root !== 'string')
+        return null;
+    const trimmed = root.replace(/\/+$/, '');
+    if (trimmed === IMAGE_NEURALIS_TREE)
+        return V5_TREE_ANCHOR;
+    if (!trimmed.startsWith(`${IMAGE_NEURALIS_TREE}/`))
+        return null;
+    const rel = trimmed.slice(IMAGE_NEURALIS_TREE.length + 1);
+    const segments = rel.split('/');
+    return segments.every((s) => s !== '' && s !== '.' && s !== '..') ? `${V5_TREE_ANCHOR}${rel}` : null;
+}
+/** The kind as v4 wrote it, and as this step writes it — both pinned (a later rename must not move them). */
+const V4_FOLDER_KIND = 'folder';
+const V5_HOST_KIND = 'host';
+const isObject = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** The v5 record for one stored v4 config (pure; exported for the unit suite). */
+export function hostRecordOf(record) {
+    if (typeof record.formatVersion === 'number' && record.formatVersion >= STEP_VERSION)
+        return { next: record, outcome: 'current' };
+    const connection = isObject(record.connection) ? record.connection : undefined;
+    const kind = typeof connection?.kind === 'string' ? connection.kind : '';
+    if (connection && kind === V4_FOLDER_KIND) {
+        const config = isObject(connection.config) ? connection.config : {};
+        const onDevice = typeof config.device === 'string' && config.device.length > 0;
+        const anchor = onDevice ? null : treeAnchorFor(config.root);
+        if (anchor !== null) {
+            const { hostRoot: _machineHalf, ...rest } = config;
+            return {
+                next: { ...record, connection: { ...connection, kind: V5_HOST_KIND, config: { ...rest, root: anchor } }, formatVersion: STEP_VERSION },
+                outcome: 'local',
+                anchored: true,
+            };
+        }
+        return {
+            next: { ...record, connection: { ...connection, kind: V5_HOST_KIND }, formatVersion: STEP_VERSION },
+            outcome: onDevice ? 'device' : 'local',
+        };
+    }
+    return { next: { ...record, formatVersion: STEP_VERSION }, outcome: 'other' };
+}
+async function readJson(file) {
+    const record = JSON.parse(await readFile(file, 'utf8'));
+    if (!isObject(record))
+        throw new Error(`${file} is not a source config`);
+    return record;
+}
+/** Every source config of the install, classified. Reads only. */
+export async function inspectSourceToHost(ctx) {
+    const base = join(ctx.appRoot, 'config', 'sources');
+    let projects;
+    try {
+        projects = (await readdir(base)).sort();
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    const rows = [];
+    for (const projectId of projects) {
+        const dir = join(base, projectId);
+        if (!(await stat(dir)).isDirectory())
+            continue;
+        for (const name of (await readdir(dir)).filter((entry) => entry.endsWith('.json')).sort()) {
+            const path = join(dir, name);
+            const record = await readJson(path);
+            const slug = typeof record.source === 'string' ? record.source : name.slice(0, -'.json'.length);
+            const { next, outcome, anchored } = hostRecordOf(record);
+            const row = { file: relative(ctx.home, path), projectId, slug, outcome, ...(anchored ? { anchored } : {}) };
+            rows.push(JSON.stringify(next) === JSON.stringify(record) ? row : { ...row, next });
+        }
+    }
+    return rows;
+}
+/** The dry-run lines of brain-core's half (the host module adds agent-core's). */
+export function sourceToHostSummary(rows) {
+    const count = (outcome) => rows.filter((row) => row.outcome === outcome).length;
+    const writes = rows.filter((row) => row.next).length;
+    return {
+        files: writes > 0 ? ['app/config/sources'] : [],
+        summary: [
+            `source configs: ${rows.length} read, ${writes} to rewrite (every record stamped v${STEP_VERSION})`,
+            `host sources: ${count('local')} on this server, ${count('device')} on a device (was folder); other kinds ${count('other')}; already v${STEP_VERSION} ${count('current')}`,
+            `Neuralis-tree roots: ${rows.filter((row) => row.anchored).length} folder(s) in the image tree take a logical root (\`neuralis-tree:…\`)`,
+        ],
+    };
+}
+/** Write every changed record (idempotent: an unchanged one has no `next`). */
+export async function applySourceToHost(ctx, rows) {
+    let written = 0;
+    for (const row of rows) {
+        if (!row.next)
+            continue;
+        await durableReplaceFile(join(ctx.home, row.file), JSON.stringify(row.next, null, 2));
+        written += 1;
+    }
+    return written;
+}
+//# sourceMappingURL=sourceToHostV1.js.map