devchain-cli 0.24.1 → 0.24.2

package/dist/server/modules/file-sync/ignore-pattern-matcher.d.ts

@@ -0,0 +1,30 @@
+export type CompiledIgnorePattern = {
+    kind: 'pattern';
+    ignored: boolean;
+    deletable: boolean;
+    matches: (path: string) => boolean;
+} | {
+    kind: 'comment';
+} | {
+    kind: 'include';
+} | {
+    kind: 'error';
+    error: string;
+};
+export type IgnoreMatch = {
+    kind: 'matched';
+    index: number;
+    ignored: boolean;
+    deletable: boolean;
+} | {
+    kind: 'none';
+} | {
+    kind: 'unknown';
+    index: number;
+    reason: 'include' | 'syntax';
+    error?: string;
+};
+export declare function compileIgnorePattern(line: string): CompiledIgnorePattern;
+export declare function compileIgnoreList(lines: readonly string[]): (path: string) => IgnoreMatch;
+export declare function firstMatch(lines: readonly string[], path: string): IgnoreMatch;
+export declare function ignorePatternProblem(list: readonly string[], pattern: string): string | null;

package/dist/server/modules/file-sync/ignore-pattern-matcher.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileIgnorePattern = compileIgnorePattern;
+exports.compileIgnoreList = compileIgnoreList;
+exports.firstMatch = firstMatch;
+exports.ignorePatternProblem = ignorePatternProblem;
+const file_sync_dto_1 = require("./file-sync.dto");
+const literal = (value) => value.replace(/[\\^$.*+?()[\]{}|]/g, '\\$&');
+const classLiteral = (value) => value.replace(/[\\\]\[\^\-]/g, '\\$&');
+function globExpression(pattern) {
+    const chars = [...pattern];
+    let cursor = 0;
+    const sequence = (inTerms) => {
+        let result = '';
+        while (cursor < chars.length) {
+            const char = chars[cursor++];
+            if (inTerms && (char === ',' || char === '}')) {
+                cursor--;
+                break;
+            }
+            switch (char) {
+                case '\\':
+                    if (cursor < chars.length)
+                        result += literal(chars[cursor++]);
+                    break;
+                case '*':
+                    if (chars[cursor] === '*') {
+                        cursor++;
+                        result += '[\\s\\S]*';
+                    }
+                    else
+                        result += '[^/]*';
+                    break;
+                case '?':
+                    result += '[^/]';
+                    break;
+                case '{': {
+                    const alternatives = [sequence(true)];
+                    while (chars[cursor] === ',') {
+                        cursor++;
+                        alternatives.push(sequence(true));
+                    }
+                    if (chars[cursor] === '}')
+                        cursor++;
+                    result += `(?:${alternatives.join('|')})`;
+                    break;
+                }
+                case '[': {
+                    const negated = chars[cursor] === '!';
+                    if (negated)
+                        cursor++;
+                    let content = '';
+                    if (chars[cursor + 1] === '-') {
+                        const low = chars[cursor];
+                        const high = chars[cursor + 2];
+                        cursor += 3;
+                        if (!high || chars[cursor] !== ']')
+                            throw new Error('Expected closing bracket.');
+                        if (high.codePointAt(0) < low.codePointAt(0)) {
+                            throw new Error('Character range is reversed.');
+                        }
+                        content = `${classLiteral(low)}-${classLiteral(high)}`;
+                    }
+                    else {
+                        while (cursor < chars.length && chars[cursor] !== ']') {
+                            const next = chars[cursor++];
+                            if (next === '\\') {
+                                if (cursor < chars.length)
+                                    content += classLiteral(chars[cursor++]);
+                            }
+                            else
+                                content += classLiteral(next);
+                        }
+                    }
+                    if (!content || chars[cursor] !== ']')
+                        throw new Error('Expected a nonempty character class and closing bracket.');
+                    cursor++;
+                    result += `[${negated ? '^' : ''}${content}]`;
+                    break;
+                }
+                default:
+                    result += literal(char);
+            }
+        }
+        return result;
+    };
+    return sequence(false);
+}
+function compileIgnorePattern(line) {
+    let pattern = line.trim().normalize('NFC');
+    if (!pattern || pattern.startsWith('//'))
+        return { kind: 'comment' };
+    if (pattern.startsWith('#include')) {
+        const space = pattern.indexOf(' ');
+        return space >= 0 && pattern.slice(space + 1).trim()
+            ? { kind: 'include' }
+            : { kind: 'error', error: 'Invalid ignore pattern: #include needs a file.' };
+    }
+    let ignored = true;
+    let folded = false;
+    let deletable = false;
+    const seen = new Set();
+    while (true) {
+        const prefix = ['!', '(?i)', '(?d)'].find((item) => pattern.startsWith(item) && !seen.has(item));
+        if (!prefix)
+            break;
+        seen.add(prefix);
+        pattern = pattern.slice(prefix.length);
+        if (prefix === '!')
+            ignored = false;
+        if (prefix === '(?i)')
+            folded = true;
+        if (prefix === '(?d)')
+            deletable = true;
+    }
+    if (!pattern)
+        return { kind: 'error', error: 'Invalid ignore pattern: missing pattern.' };
+    if (folded)
+        pattern = pattern.toLowerCase();
+    const expanded = pattern.endsWith('/**')
+        ? [pattern]
+        : pattern.endsWith('/')
+            ? [pattern + '**']
+            : [pattern, pattern + '/**'];
+    try {
+        const expressions = expanded.flatMap((item) => {
+            if (item.startsWith('/'))
+                return [item.slice(1)];
+            if (item.startsWith('**/'))
+                return item.length === 3 ? [item] : [item, item.slice(3)];
+            return [item, '**/' + item];
+        });
+        const regexes = expressions.map((item) => new RegExp(`^(?:${globExpression(item)})(?![\\s\\S])`, 'u'));
+        return {
+            kind: 'pattern',
+            ignored,
+            deletable: ignored && deletable,
+            matches: (path) => {
+                const normalized = path.normalize('NFC');
+                const candidate = folded ? normalized.toLowerCase() : normalized;
+                return regexes.some((regex) => regex.test(candidate));
+            },
+        };
+    }
+    catch (error) {
+        return {
+            kind: 'error',
+            error: `Invalid ignore pattern: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+function compileIgnoreList(lines) {
+    const compiled = lines.map(compileIgnorePattern);
+    return (path) => {
+        for (const [index, line] of compiled.entries()) {
+            if (line.kind === 'include')
+                return { kind: 'unknown', index, reason: 'include' };
+            if (line.kind === 'error')
+                return { kind: 'unknown', index, reason: 'syntax', error: line.error };
+            if (line.kind === 'pattern' && line.matches(path)) {
+                return { kind: 'matched', index, ignored: line.ignored, deletable: line.deletable };
+            }
+        }
+        return { kind: 'none' };
+    };
+}
+function firstMatch(lines, path) {
+    return compileIgnoreList(lines)(path);
+}
+function ignorePatternProblem(list, pattern) {
+    const trimmed = pattern.trim();
+    if (!trimmed)
+        return 'Enter a pattern.';
+    if (list.includes(trimmed))
+        return `${trimmed} is already in the list.`;
+    if (trimmed.length > file_sync_dto_1.IGNORE_PATTERN_MAX_LENGTH)
+        return `A pattern can have at most ${file_sync_dto_1.IGNORE_PATTERN_MAX_LENGTH} characters.`;
+    if (list.length >= file_sync_dto_1.IGNORE_PATTERNS_MAX)
+        return `The list can hold at most ${file_sync_dto_1.IGNORE_PATTERNS_MAX} patterns.`;
+    const compiled = compileIgnorePattern(trimmed);
+    return compiled.kind === 'error' ? compiled.error : null;
+}
+//# sourceMappingURL=ignore-pattern-matcher.js.map

package/dist/server/modules/file-sync/ignore-pattern-matcher.js.map

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

package/dist/server/modules/file-sync/project-repository.d.ts

@@ -0,0 +1,2 @@
+export type ProjectRepository = 'repository' | 'missing' | 'worktree';
+export declare function projectRepository(root: string): Promise<ProjectRepository>;

package/dist/server/modules/file-sync/project-repository.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectRepository = projectRepository;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+async function projectRepository(root) {
+    try {
+        const git = await (0, promises_1.lstat)((0, node_path_1.join)(root, '.git'));
+        if (!git.isDirectory())
+            return 'worktree';
+        const [, objects, refs] = await Promise.all(['HEAD', 'objects', 'refs'].map((name) => (0, promises_1.stat)((0, node_path_1.join)(root, '.git', name))));
+        return objects.isDirectory() && refs.isDirectory() ? 'repository' : 'missing';
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return 'missing';
+        throw error;
+    }
+}
+//# sourceMappingURL=project-repository.js.map

package/dist/server/modules/file-sync/project-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-repository.js","sourceRoot":"","sources":["../../../src/modules/file-sync/project-repository.ts"],"names":[],"mappings":";;AAaA,8CAYC;AAzBD,+CAA+C;AAC/C,yCAAiC;AAY1B,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAClD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAA,gBAAK,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE;YAAE,OAAO,UAAU,CAAC;QAC1C,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CACzC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,eAAI,EAAC,IAAA,gBAAI,EAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAC1E,CAAC;QACF,OAAO,OAAO,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACzE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/server/modules/file-sync/sync-chown.dto.d.ts

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+export declare const SYNC_CHOWN_PATHS_MAX = 200;
+export declare const SyncChownItemSchema: z.ZodObject<{
+    path: z.ZodEffects<z.ZodString, string, string>;
+    mode: z.ZodEnum<["automatic", "give"]>;
+}, "strict", z.ZodTypeAny, {
+    path: string;
+    mode: "automatic" | "give";
+}, {
+    path: string;
+    mode: "automatic" | "give";
+}>;
+export declare const SyncChownRequestSchema: z.ZodObject<{
+    root: z.ZodEffects<z.ZodString, string, string>;
+    items: z.ZodArray<z.ZodObject<{
+        path: z.ZodEffects<z.ZodString, string, string>;
+        mode: z.ZodEnum<["automatic", "give"]>;
+    }, "strict", z.ZodTypeAny, {
+        path: string;
+        mode: "automatic" | "give";
+    }, {
+        path: string;
+        mode: "automatic" | "give";
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    items: {
+        path: string;
+        mode: "automatic" | "give";
+    }[];
+    root: string;
+}, {
+    items: {
+        path: string;
+        mode: "automatic" | "give";
+    }[];
+    root: string;
+}>;
+export declare const SyncChownResultSchema: z.ZodObject<{
+    user: z.ZodNullable<z.ZodObject<{
+        uid: z.ZodNumber;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        uid: number;
+    }, {
+        name: string;
+        uid: number;
+    }>>;
+    items: z.ZodArray<z.ZodObject<{
+        path: z.ZodEffects<z.ZodString, string, string>;
+        state: z.ZodEnum<["repaired", "unchanged", "refused", "unsupported"]>;
+        paths: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        state: "unsupported" | "unchanged" | "refused" | "repaired";
+        path: string;
+        paths: string[];
+        reason?: string | undefined;
+    }, {
+        state: "unsupported" | "unchanged" | "refused" | "repaired";
+        path: string;
+        paths: string[];
+        reason?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    user: {
+        name: string;
+        uid: number;
+    } | null;
+    items: {
+        state: "unsupported" | "unchanged" | "refused" | "repaired";
+        path: string;
+        paths: string[];
+        reason?: string | undefined;
+    }[];
+}, {
+    user: {
+        name: string;
+        uid: number;
+    } | null;
+    items: {
+        state: "unsupported" | "unchanged" | "refused" | "repaired";
+        path: string;
+        paths: string[];
+        reason?: string | undefined;
+    }[];
+}>;
+export declare const GiveOwnershipRequestSchema: z.ZodObject<{
+    paths: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+}, "strict", z.ZodTypeAny, {
+    paths: string[];
+}, {
+    paths: string[];
+}>;
+export type SyncChownRequest = z.infer<typeof SyncChownRequestSchema>;
+export type SyncChownResult = z.infer<typeof SyncChownResultSchema>;
+export declare function unsupportedChown(user: SyncChownResult['user'], items: readonly {
+    path: string;
+}[]): SyncChownResult;

package/dist/server/modules/file-sync/sync-chown.dto.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GiveOwnershipRequestSchema = exports.SyncChownResultSchema = exports.SyncChownRequestSchema = exports.SyncChownItemSchema = exports.SYNC_CHOWN_PATHS_MAX = void 0;
+exports.unsupportedChown = unsupportedChown;
+const zod_1 = require("zod");
+const sync_path_inspection_dto_1 = require("./sync-path-inspection.dto");
+exports.SYNC_CHOWN_PATHS_MAX = 200;
+exports.SyncChownItemSchema = zod_1.z
+    .object({ path: sync_path_inspection_dto_1.SyncRelativePathSchema, mode: zod_1.z.enum(['automatic', 'give']) })
+    .strict();
+exports.SyncChownRequestSchema = zod_1.z
+    .object({
+    root: zod_1.z
+        .string()
+        .min(1)
+        .max(4096)
+        .refine((value) => value.startsWith('/') &&
+        !/[\x00\r\n]/.test(value) &&
+        value.split('/').every((part) => part !== '..' && part !== '.'), 'Expected an absolute project root without traversal'),
+    items: zod_1.z.array(exports.SyncChownItemSchema),
+})
+    .strict();
+exports.SyncChownResultSchema = zod_1.z.object({
+    user: sync_path_inspection_dto_1.SyncPathOwnerSchema.nullable(),
+    items: zod_1.z.array(zod_1.z.object({
+        path: sync_path_inspection_dto_1.SyncRelativePathSchema,
+        state: zod_1.z.enum(['repaired', 'unchanged', 'refused', 'unsupported']),
+        paths: zod_1.z.array(sync_path_inspection_dto_1.SyncRelativePathSchema),
+        reason: zod_1.z.string().optional(),
+    })),
+});
+exports.GiveOwnershipRequestSchema = zod_1.z
+    .object({ paths: zod_1.z.array(sync_path_inspection_dto_1.SyncRelativePathSchema).min(1).max(exports.SYNC_CHOWN_PATHS_MAX) })
+    .strict();
+function unsupportedChown(user, items) {
+    return {
+        user,
+        items: items.map(({ path }) => ({
+            path,
+            state: 'unsupported',
+            paths: [],
+            reason: 'The VM ownership helper is unavailable. Update the VM or use the copy command.',
+        })),
+    };
+}
+//# sourceMappingURL=sync-chown.dto.js.map

package/dist/server/modules/file-sync/sync-chown.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-chown.dto.js","sourceRoot":"","sources":["../../../src/modules/file-sync/sync-chown.dto.ts"],"names":[],"mappings":";;;AA0CA,4CAaC;AAvDD,6BAAwB;AACxB,yEAAyF;AAG5E,QAAA,oBAAoB,GAAG,GAAG,CAAC;AAC3B,QAAA,mBAAmB,GAAG,OAAC;KACjC,MAAM,CAAC,EAAE,IAAI,EAAE,iDAAsB,EAAE,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;KAC7E,MAAM,EAAE,CAAC;AACC,QAAA,sBAAsB,GAAG,OAAC;KACpC,MAAM,CAAC;IACN,IAAI,EAAE,OAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,IAAI,CAAC;SACT,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;QACzB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,GAAG,CAAC,EACjE,qDAAqD,CACtD;IACH,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,2BAAmB,CAAC;CACpC,CAAC;KACD,MAAM,EAAE,CAAC;AACC,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,8CAAmB,CAAC,QAAQ,EAAE;IACpC,KAAK,EAAE,OAAC,CAAC,KAAK,CACZ,OAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,iDAAsB;QAC5B,KAAK,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAClE,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,iDAAsB,CAAC;QACtC,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC9B,CAAC,CACH;CACF,CAAC,CAAC;AACU,QAAA,0BAA0B,GAAG,OAAC;KACxC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,iDAAsB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,4BAAoB,CAAC,EAAE,CAAC;KACnF,MAAM,EAAE,CAAC;AAKZ,SAAgB,gBAAgB,CAC9B,IAA6B,EAC7B,KAAkC;IAElC,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI;YACJ,KAAK,EAAE,aAAa;YACpB,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,gFAAgF;SACzF,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/server/modules/file-sync/sync-chown.service.d.ts

@@ -0,0 +1,12 @@
+import { ProcessExecutor } from '../terminal/services/process-executor/process-executor.port';
+import { type SyncChownRequest, type SyncChownResult } from './sync-chown.dto';
+export declare class SyncChownService {
+    private readonly executor;
+    constructor(executor: ProcessExecutor);
+    user(): Promise<SyncChownResult['user']>;
+    repair(request: SyncChownRequest): Promise<SyncChownResult>;
+    private git;
+    private ignored;
+    private hasGit;
+    private checked;
+}

package/dist/server/modules/file-sync/sync-chown.service.js

@@ -0,0 +1,230 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncChownService = void 0;
+const common_1 = require("@nestjs/common");
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const zod_1 = require("zod");
+const env_config_1 = require("../../common/config/env.config");
+const vm_home_path_1 = require("../../common/filesystem/vm-home-path");
+const error_types_1 = require("../../common/errors/error-types");
+const process_executor_port_1 = require("../terminal/services/process-executor/process-executor.port");
+const project_repository_1 = require("./project-repository");
+const sync_chown_dto_1 = require("./sync-chown.dto");
+const sync_path_inspection_dto_1 = require("./sync-path-inspection.dto");
+let SyncChownService = class SyncChownService {
+    executor;
+    constructor(executor) {
+        this.executor = executor;
+    }
+    async user() {
+        const claim = await (0, promises_1.readFile)((0, node_path_1.join)((0, env_config_1.getEnvConfig)().DEVCHAIN_HOST_ETC_DIR, 'claim.json'), 'utf8').catch(() => null);
+        let user = null;
+        if (claim) {
+            let value;
+            try {
+                value = JSON.parse(claim);
+            }
+            catch {
+                return null;
+            }
+            const parsed = zod_1.z
+                .object({ userName: zod_1.z.string().regex(/^[a-z_][a-z0-9_-]{0,31}$/) })
+                .safeParse(value);
+            if (!parsed.success)
+                return null;
+            const { userName } = parsed.data;
+            const account = await this.executor.run({
+                argv: ['getent', 'passwd', userName],
+                mode: 'pipe',
+            });
+            const fields = account.stdout.trim().split(':');
+            if (account.success && /^\d+$/.test(fields[2] ?? ''))
+                user = { name: userName, uid: Number(fields[2]) };
+        }
+        return user;
+    }
+    async repair(request) {
+        const { root, items } = sync_chown_dto_1.SyncChownRequestSchema.parse(request);
+        if (root !== (0, node_path_1.resolve)(root))
+            throw new error_types_1.ValidationError('The project root must be normalized.');
+        await (0, vm_home_path_1.assertVmHomePath)(root, {
+            code: 'FILE_SYNC_CHOWN_OUTSIDE_HOME',
+            message: 'Ownership repairs must be under the VM home',
+            linkMessage: 'Ownership paths must not be links',
+            rejectAncestorLinks: true,
+        });
+        const helper = (0, node_path_1.join)((0, env_config_1.getEnvConfig)().DEVCHAIN_HOST_BIN_DIR, 'devchain-host-project-chown');
+        const user = await this.user();
+        if (!user || !(0, node_fs_1.existsSync)(helper))
+            return (0, sync_chown_dto_1.unsupportedChown)(user, items);
+        const result = { user, items: [] };
+        let tracked;
+        try {
+            if ((await (0, project_repository_1.projectRepository)(root)) !== 'repository')
+                throw new Error('A regular Git repository is required.');
+            const index = await this.git(root, ['ls-files', '-s', '-z']);
+            if (!index.success || index.truncated)
+                throw new Error('Git tracking could not be checked.');
+            tracked = new Map(index.stdout
+                .split('\0')
+                .filter(Boolean)
+                .map((entry) => {
+                const match = /^(\d{6}) [a-f0-9]+ (\d+)\t([\s\S]+)$/.exec(entry);
+                if (!match)
+                    throw new Error('Git returned an invalid index entry.');
+                return [match[3], match[2] === '0' ? match[1] : 'unmerged'];
+            }));
+        }
+        catch (error) {
+            return {
+                user,
+                items: items.map(({ path }) => ({
+                    path,
+                    state: 'refused',
+                    paths: [],
+                    reason: error instanceof Error ? error.message : 'Git could not be checked.',
+                })),
+            };
+        }
+        for (const item of items) {
+            const paths = [];
+            try {
+                const target = (0, node_path_1.join)(root, item.path);
+                const info = await this.checked(root, target);
+                const parents = [];
+                for (let parent = (0, node_path_1.dirname)(target); parent !== root; parent = (0, node_path_1.dirname)(parent))
+                    parents.unshift(parent);
+                if (item.mode === 'automatic') {
+                    if (!['100644', '100755'].includes(tracked.get(item.path) ?? '') || !info.isFile())
+                        throw new Error('Automatic repair requires a tracked regular file.');
+                }
+                else {
+                    if (!info.isFile() && !info.isDirectory())
+                        throw new Error('Give to requires a regular file or folder.');
+                    if ([...tracked.keys()].some((name) => (0, sync_path_inspection_dto_1.within)(name, item.path)) ||
+                        (await this.ignored(root, item.path)))
+                        throw new Error('Give to requires a path Git neither tracks nor ignores.');
+                    if (info.isDirectory() && (await this.hasGit(target)))
+                        throw new Error('The selected folder is a repository.');
+                }
+                const run = async (path, mode) => {
+                    await this.checked(root, path);
+                    const response = await this.executor.run({
+                        argv: ['sudo', '-n', helper, root, mode, path],
+                        mode: 'pipe',
+                        timeout: 60_000,
+                    });
+                    const remember = (changed) => {
+                        for (const changedPath of changed) {
+                            const name = (0, node_path_1.relative)(root, changedPath);
+                            if (!name || name.startsWith('../') || name.startsWith('/'))
+                                throw new Error('The helper returned a path outside the project.');
+                            paths.push(name);
+                        }
+                    };
+                    if (!response.success || response.timedOut || response.truncated) {
+                        let message = 'The VM refused the ownership repair.';
+                        try {
+                            const failure = zod_1.z
+                                .object({ message: zod_1.z.string(), changed: zod_1.z.array(zod_1.z.string()).default([]) })
+                                .parse(JSON.parse(response.stderr.trim().split('\n').at(-1)));
+                            message = failure.message;
+                            remember(failure.changed);
+                        }
+                        catch {
+                        }
+                        throw new Error(message);
+                    }
+                    const changed = zod_1.z
+                        .object({ changed: zod_1.z.array(zod_1.z.string()) })
+                        .parse(JSON.parse(response.stdout)).changed;
+                    remember(changed);
+                };
+                for (const parent of parents) {
+                    const parentInfo = await this.checked(root, parent);
+                    const name = (0, node_path_1.relative)(root, parent);
+                    const code = item.mode === 'give'
+                        ? !(await this.ignored(root, name))
+                        : [...tracked.entries()].some(([file, mode]) => file.startsWith(name + '/') &&
+                            ['100644', '100755'].includes(mode) &&
+                            !['.gitkeep', '.keep', '.gitignore'].includes((0, node_path_1.basename)(file)));
+                    if (parentInfo.uid !== user.uid && code)
+                        await run(parent, '--dir');
+                }
+                const current = await this.checked(root, target);
+                if (item.mode === 'give' && current.isDirectory())
+                    await run(target, '--tree');
+                else if (current.uid !== user.uid)
+                    await run(target, '--file');
+                result.items.push({
+                    path: item.path,
+                    state: paths.length ? 'repaired' : 'unchanged',
+                    paths: [...new Set(paths)],
+                });
+            }
+            catch (error) {
+                result.items.push({
+                    path: item.path,
+                    state: 'refused',
+                    paths: [...new Set(paths)],
+                    reason: error instanceof Error ? error.message : 'The VM refused the ownership repair.',
+                });
+            }
+        }
+        return result;
+    }
+    git(root, args, input) {
+        return this.executor.run({
+            argv: ['git', '-c', `safe.directory=${root}`, '-C', root, ...args],
+            mode: 'pipe',
+            input,
+            timeout: 30_000,
+        });
+    }
+    async ignored(root, path) {
+        const result = await this.git(root, ['check-ignore', '--no-index', '-z', '--stdin'], path + '\0');
+        if (result.timedOut || result.truncated || ![0, 1].includes(result.exitCode ?? -1))
+            throw new Error('Git ignore rules could not be checked.');
+        return result.exitCode === 0;
+    }
+    async hasGit(path) {
+        try {
+            await (0, promises_1.lstat)((0, node_path_1.join)(path, '.git'));
+            return true;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return false;
+            throw error;
+        }
+    }
+    async checked(root, target) {
+        let current = root;
+        for (const part of (0, node_path_1.relative)(root, target).split('/').filter(Boolean)) {
+            current = (0, node_path_1.join)(current, part);
+            const info = await (0, promises_1.lstat)(current);
+            if (info.isSymbolicLink() || part === '.git')
+                throw new Error('Ownership paths must not contain links or Git metadata.');
+            if (info.isDirectory() && current !== root && (await this.hasGit(current)))
+                throw new Error('Ownership paths must not enter another repository.');
+        }
+        return (0, promises_1.lstat)(target);
+    }
+};
+exports.SyncChownService = SyncChownService;
+exports.SyncChownService = SyncChownService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [process_executor_port_1.ProcessExecutor])
+], SyncChownService);
+//# sourceMappingURL=sync-chown.service.js.map