@struktoai/mirage-core/dist/commands/builtin/generic/tar/mode.js

A Unified Virtual Filesystem For AI Agents

// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
import { expandTableLong } from "../../../spec/compile.js";
import { TAR_LONG_OPTIONS } from "../../../spec/constants.js";
/**
 * Whether a tar line reads the filesystem rather than an archive.
 *
 * Only -c makes tar's operands source paths. Under -t and -x they are
 * member selectors matched against names inside the archive, so a
 * selector that happens to spell a mount root is not a mount at all and
 * refusing it would deny an ordinary listing.
 *
 * Scanned raw because both callers fire before flag parsing: the
 * mount-root policy at admission, and the cross-mount router deciding
 * whether a span is real. Only the first word may be GNU's dashless
 * option cluster (`tar cf a.tar d`), so a later bare word is an operand
 * and cannot turn the mode on. `--` ends the scan the way it ends GNU's
 * option parsing: a later `-c` names a member, and reading it as the
 * create flag would refuse the very selector fix this gate exists to
 * protect (`tar -xf a.tar -C /dst -- -c`). A long word is read the way
 * tar's getopt_long reads it, against tar's whole table, so an abbreviation
 * (`--crea`) is create too.
 */
export function isCreateMode(argv) {
    for (const [i, tok] of argv.entries()) {
        if (tok === '--')
            return false;
        if (tok.startsWith('--')) {
            const found = expandTableLong(TAR_LONG_OPTIONS, tok.split('=', 1)[0] ?? tok);
            if (found.length === 1 && found[0] === '--create')
                return true;
            continue;
        }
        if (tok.startsWith('-')) {
            if (tok.slice(1).includes('c'))
                return true;
            continue;
        }
        if (i === 0 && tok.includes('c'))
            return true;
    }
    return false;
}
//# sourceMappingURL=mode.js.map