# job.yaml — schema definition for village job/assignment slot definitions
#
# Jobs define what characters can be assigned to and what passive resources
# they generate. All tuning values should be content-driven so the economy
# can be rebalanced without code changes.
#
# PoC jobs (from spec): mining, woodcutting, research, construction, farming

$schema: "xyvera/content-schema/job/v1"

type: object
required:
  - id
  - name
  - profession
  - output_resource
  - base_output_per_hour
  - max_slots

properties:

  id:
    type: string
    pattern: "^[a-z][a-z0-9_]*$"
    example: "lumber_camp"

  name:
    type: string
    example: "Lumber Camp"

  description:
    type: string
    example: "Workers harvest wood from the forest edge. Essential for construction and upgrades."

  profession:
    type: string
    enum: [miner, lumberjack, researcher, construction, farmer, trainer]
    description: "Determines which characters receive the suitability bonus when assigned here."

  output_resource:
    type: string
    description: "Resource ID produced passively by characters in this job slot."
    example: "wood"

  secondary_output:
    type: object
    description: "Optional secondary resource produced at a lower rate."
    properties:
      resource:
        type: string
      rate_fraction:
        type: number
        minimum: 0.0
        maximum: 1.0
        description: "Fraction of base_output_per_hour for the secondary resource."
    additionalProperties: false

  base_output_per_hour:
    type: number
    minimum: 0.0
    description: >
      Base resource units generated per assigned character per hour.
      Actual output = base * suitability_multiplier * character_level_factor.
      Level factor formula: (level / max_level) ^ 0.5 — tunable in constants.yaml.

  max_slots:
    type: integer
    minimum: 1
    maximum: 10
    description: "Maximum number of characters that can be simultaneously assigned to this job."

  unlock_condition:
    type: object
    description: "What the player must have done before this job slot is available."
    properties:
      building_level:
        type: integer
        minimum: 0
        description: "Village building level required to unlock this slot."
      prerequisite_job_id:
        type: string
        description: "Another job that must be unlocked first."
    additionalProperties: false

  manual_work_eligible:
    type: boolean
    default: false
    description: >
      If true, this job can be targeted by the manual micro-management action.
      Only one or two jobs should have this enabled in PoC to keep the system focused.

  passive_cap_hours:
    type: number
    minimum: 1.0
    default: 8.0
    description: >
      Hours after which passive accumulation stops until the player collects.
      Prevents long absences from breaking the economy. Default is 8 hours
      matching the server-side MAX_PASSIVE_HOURS constant.