{
  "name": "cp",
  "section": 1,
  "title": "copy files",
  "synopsis": [
    "cp [OPTION]... [OPERAND]..."
  ],
  "description": "Bare OS implementation of copy files. Full behavior is defined in packages/bare-os-coreutils/src/cp.js.",
  "options": [
    { "flag": "-R, -r, --recursive", "meaning": "[Issue 7 cp] Recursive directory copy; skips .bareos_empty marker files in tree walks." },
    { "flag": "-L, --dereference", "meaning": "[Issue 7 cp] Follow symlinks to copy referent file or directory." },
    { "flag": "-P, --no-dereference", "meaning": "[Issue 7 cp] Copy symlink itself (default)." },
    { "flag": "-u, --update", "meaning": "[Issue 7 cp] Skip copy when destination mtime >= source mtime." },
    { "flag": "-v, --verbose", "meaning": "[Issue 7 cp] Log each copy." },
    { "flag": "-p, --preserve", "meaning": "[Issue 7 cp] Preserve timestamps via mtimeMs/ctimeMs on writeFile when supported." },
    { "flag": "--preserve=timestamps|time|all", "meaning": "[Issue 7 cp] Subset: timestamps|time|all enables preserveTime only." }
  ],
  "keywords": [
    "cp",
    "bare-os",
    "coreutils"
  ],
  "bareOsNotes": "Issue 7 option matrix above is for traceability; behavior is bounded by the Hyperdrive VFS (no hard links, no xattr copy).",
  "examples": [
    {
      "caption": "copy file",
      "code": "cp src.txt dest.txt"
    },
    {
      "caption": "into directory",
      "code": "cp a b c ~/backup/"
    },
    {
      "caption": "preserve implied (if implemented)",
      "code": "cp -R proj proj.bak"
    }
  ]
}