schema_version: open-reuse.integration.v1
id: markitect-quarkdown
name: Markitect Quarkdown Render Adapter
upstream:
  name: Quarkdown
  project_url: https://github.com/iamgio/quarkdown
  homepage: https://quarkdown.com/
  version_policy: quarkdown-2.x
reuse:
  primary_reuse_mode: adapter
  secondary_reuse_modes:
    - dependency-reuse
    - cli-boundary
boundary:
  local_adapter: markitect_quarkdown.adapter.MarkitectQuarkdownAdapter
  markitect_adapter_id: render.quarkdown
  entry_point_group: markitect_tool.render_export_adapters
  core_contracts:
    - markitect.render.export.v1
    - markitect.render.reference.v1
runtime:
  required_for_real_render:
    - Quarkdown 2.x CLI
    - Java 17+
  required_for_pdf:
    - Node.js
    - npm
    - Puppeteer
permissions:
  known_flags:
    - project-read
    - global-read
    - network
    - native-content
    - all
  default_allow:
    - project-read
  default_deny:
    - network
validation:
  harness: python3 -m pytest
  skip_without_runtime: true
  checks:
    - descriptor compatibility
    - profile matrix
    - command-plan construction
    - fake-runner artifact validation
    - missing runtime diagnostic
    - real Quarkdown smoke test when CLI is installed
risks:
  sensitivity:
    - CLI command changes
    - permission model changes
    - output directory changes
    - artifact naming changes
    - PDF export dependency changes
    - Java runtime changes
    - Node/npm/Puppeteer changes
    - license or security advisories
maintenance:
  escalation_conditions:
    - upstream Quarkdown release
    - validation failure
    - dependency requirement change
    - permission behavior change
    - generated artifact convention change