@airmark/quiver 0.32.1 → 0.33.0

package/quills/cyber_ribbon_chart/0.0.1/Quill.yaml

@@ -0,0 +1,320 @@
+quill:
+  name: cyber_ribbon_chart
+  version: 0.0.1
+  backend: typst
+  description: 17X Cyber Operations Officer ribbon chart and career vector planner
+
+typst:
+  plate_file: plate.typ
+
+# One landscape page an officer hands to a senior rater or a development team.
+# The top half is the plan — alternative assignment vectors laid over the years
+# the boards and schools fall in. The bottom half is the record that makes the
+# plan credible.
+main:
+  ui:
+    groups:
+      officer: {}
+      timeline: {}
+      record: {}
+      qualifications: { title: "Qualifications & experience" }
+  # The chart's one piece of prose. It heads the notes area at the foot of the
+  # page, above ruled lines a rater writes on during the discussion.
+  body:
+    example: |
+      What you want out of this discussion, and anything that constrains it — a join-spouse, a degree finishing, a date you cannot move before.
+  fields:
+    name:
+      # Read as `string` rather than `plaintext`: it reaches
+      # `set document(author:)`, which takes no content.
+      type: string
+      example: Capt John A. Snuffy
+      ui:
+        group: officer
+      description: "Grade and name as you want them read, set largest on the page. This is also the exported PDF's title and author, so it is written out rather than marked up."
+
+    duty_title:
+      type: plaintext
+      inline: true
+      default: ""
+      example: 17S Instructor · 333 TRS, Keesler AFB
+      ui:
+        group: officer
+      description: "Current duty title and unit, printed in one line under your name. Where you are today, not where you are going."
+
+    commissioning_yg:
+      type: integer
+      example: 2022
+      ui:
+        group: officer
+        compact: true
+      description: "Commissioning year group. Every milestone on the timeline is counted from this year, so it is the one number that changes the whole chart — a board at YG+8 lands in this year plus eight."
+
+    adjusted_yg:
+      type: integer
+      default: 0
+      ui:
+        group: officer
+        compact: true
+      description: "Adjusted year group, if a board or a break in service moved yours. Leave at 0 when it is unchanged; the chart then counts from your commissioning year group and prints nothing here."
+
+    date_of_rank:
+      type: date
+      default: ""
+      example: 2026-05-01
+      ui:
+        group: officer
+        compact: true
+      description: "Date of rank in your current grade, YYYY-MM-DD. Leave blank to print a dash."
+
+    date_arrived_station:
+      type: date
+      default: ""
+      example: 2025-06-15
+      ui:
+        group: officer
+        compact: true
+      description: "Date arrived station, YYYY-MM-DD. Read together with your first tour's length, it is what tells a rater when you are actually available to move."
+
+    advanced_degree:
+      type: plaintext
+      inline: true
+      default: ""
+      example: MS Cyber Operations, AFIT
+      ui:
+        group: officer
+        compact: true
+      description: "Advanced academic degree, in hand or in progress. Leave blank if you hold none — the slot prints a dash rather than disappearing, because its absence is itself information to a board."
+
+    timeline_start_year:
+      type: integer
+      example: 2026
+      ui:
+        group: timeline
+        compact: true
+      description: "First calendar year the timeline shows. Usually the current year: the chart is a plan, so it starts where you are, not where you commissioned."
+
+    timeline_years:
+      type: integer
+      default: 12
+      ui:
+        group: timeline
+        compact: true
+      description: "How many years wide the timeline is. Twelve carries a Captain from today past the Lt Col board and is the comfortable reading width. The full milestone ladder runs to YG+17, so widening it toward eighteen brings the SDE looks into view at the cost of narrower columns; any milestone that falls outside the window is counted in a note rather than dropped."
+
+    vectors:
+      type: array
+      max: 3
+      items:
+        type: object
+        properties:
+          label:
+            type: plaintext
+            inline: true
+            default: ""
+            example: Command track
+            description: "Short name for the row, set in bold at the left of the timeline. Leave blank to print 'Vector 1', 'Vector 2' and so on in the order the rows stand."
+          focus:
+            type: plaintext
+            inline: true
+            default: ""
+            example: Primary
+            description: "What this vector is for, set small under the label — 'Primary', 'Alternate', 'Backup'. Leave blank where the label already says it."
+          tours:
+            type: array
+            ui:
+              layout: table
+            items:
+              type: object
+              properties:
+                title:
+                  type: plaintext
+                  inline: true
+                  example: 333 TRS Instructor
+                  title: Assignment
+                  description: "Assignment and unit, set in the block. Keep it to what fits — roughly twenty characters per year of length at the default width."
+                duration:
+                  type: enum
+                  values: ["0.5", "1", "1.5", "2", "2.5", "3", "3.5", "4"]
+                  default: "2"
+                  title: Years
+                  description: "Length in years. The timeline is ruled in half-years, which is why the choices stop at the half."
+                vml:
+                  type: enum
+                  values: [Summer, Winter]
+                  default: Summer
+                  title: VML
+                  description: "Which VML cycle you would move on. This places the tour rather than labelling it: a Summer tour starts in the second half of a year and a Winter tour in the first. Where that means waiting, the wait is added to the tour before it rather than left as a hole — you hold a job until you move — so a tour can print longer than the length you gave it."
+                school:
+                  type: boolean
+                  default: false
+                  description: "Tick for a school you would move for — IDE or SDE in residence, Weapons School — rather than a duty assignment. It prints outlined instead of filled, so a year in a classroom does not read as a year in a job."
+            description: "The assignments on this row, in the order you would serve them. Tours lay end to end from the start of the timeline, so there are no dates to keep in step."
+      default:
+        - { label: Vector 1, focus: Primary, tours: [] }
+        - { label: Vector 2, focus: Alternate, tours: [] }
+        - { label: Vector 3, focus: Backup, tours: [] }
+      example:
+        - label: Vector 1
+          focus: Primary — command track
+          tours:
+            - { title: 333 TRS Instructor, duration: "4", vml: Summer }
+            - { title: 333 TRS / DO, duration: "3.5", vml: Winter }
+            - { title: IDE in residence, duration: "1", vml: Summer, school: true }
+        - label: Vector 2
+          focus: Alternate — staff depth
+          tours:
+            - { title: 17X CFM Staff, duration: "2.5", vml: Winter }
+            - { title: MAJCOM A3 Division Chief, duration: "2", vml: Summer }
+        - label: Vector 3
+          focus: Backup — joint
+          tours:
+            - { title: Joint Staff J6, duration: "3", vml: Summer }
+            - { title: USCYBERCOM JFHQ-C, duration: "2.5", vml: Winter }
+      ui:
+        group: timeline
+      description: "One row per alternative career path. Three is the conventional chart and all the page holds — a primary, an alternate, and a backup. One is a plan; three is a conversation."
+
+    stratifications:
+      type: array
+      ui:
+        group: record
+        layout: table
+      items:
+        type: object
+        properties:
+          year:
+            type: plaintext
+            inline: true
+            example: "2026"
+            description: "The reporting year."
+          rater_strat:
+            type: plaintext
+            inline: true
+            default: ""
+            example: "#1/14 Capts"
+            title: Rater
+            description: "Your rater's stratification as it was written, such as '#1/14 Capts'."
+          hlr_strat:
+            type: plaintext
+            inline: true
+            default: ""
+            example: "#1/45 Capts"
+            title: Higher Level Reviewer
+            description: "Your Higher Level Reviewer's stratification as it was written, such as '#1/45 Capts'. Leave blank where you drew none."
+      default: []
+      example:
+        - { year: "2026", rater_strat: "#1/14 Capts", hlr_strat: "#1/45 Capts" }
+        - { year: "2025", rater_strat: "#2/12 Capts", hlr_strat: "#3/40 Capts" }
+        - { year: "2024", rater_strat: "#1/8 Lts, #2/40 Instructors", hlr_strat: "" }
+      description: "Your last three years of stratifications, most recent first. Three is what the page is built for; more rows will set, and the section grows to hold them. Written out, a row is `{year: \"2026\", rater_strat: \"#1/14 Capts\", hlr_strat: \"#1/45 CGOs\"}`."
+
+    awards:
+      type: array
+      items:
+        type: plaintext
+        inline: true
+      default: []
+      example:
+        - Wing CGOQ ×2
+        - HAF A2/6 CGOY 2025
+      ui:
+        group: record
+      description: "Major awards, one per line, strongest first. Wing level and above earns a line; anything smaller costs more room than it wins."
+
+    certifications:
+      type: array
+      items:
+        type: plaintext
+        inline: true
+      default: []
+      example:
+        - SANS FOR577 (GLIR)
+        - CISSP
+        - Security+
+      ui:
+        group: record
+      description: "Certifications and courses, one per line. Name the certification a board would recognize rather than every course you have sat."
+
+    deployments:
+      type: array
+      items:
+        type: plaintext
+        inline: true
+      default: []
+      example:
+        - 1× short tour — returned Jan 2024
+      ui:
+        group: record
+      description: "Deployments and short tours, one per line. Include the return date: it is what a rater needs to work out when you are next eligible."
+
+    # The page prints every member in four columns and marks the held ones, so
+    # an empty box is as much of the chart as a filled one. A column is a
+    # property here rather than a heading in the plate, so the partition is in
+    # the value and the address as well as on the page.
+    qualifications:
+      type: object
+      ui:
+        group: qualifications
+      description: "Tick what you hold. The page prints the whole 17X vocabulary and marks these — a rater reads the empty boxes as readily as the filled ones, so what you have not done yet is on the page whether you tick it or not. Written out, a tick is `flight_cc: true`, and a tick with its detail `flight_cc: {held: true, detail: 333 TRS/DO}`."
+      properties:
+        command:
+          type: matrix
+          title: Leadership & Command
+          ui:
+            compact: true
+          members:
+            sq_cc_candidate: Sq/CC Candidate
+            do_det_cc_candidate: DO / Det CC Candidate
+            flight_cc: Flight CC
+            director_of_operations: Director of Operations
+            detachment_cc: Detachment CC
+            squadron_cc: Squadron CC
+          properties: &detail
+            detail:
+              type: plaintext
+              inline: true
+              default: ""
+              example: "2025"
+              description: "The unit, course, or year that proves it, set in italics under the label. Leave blank where the label says enough on its own."
+        operations:
+          type: matrix
+          ui:
+            compact: true
+          members:
+            dodin_ops: DODIN Ops
+            dco: DCO (Defensive)
+            oco: OCO (Offensive)
+            crew_cc: Crew CC
+            cyber_engineer: Cyber Engineer
+            team_lead: Team Lead (MDT / CPT)
+            expeditionary_comms: Expeditionary Comms
+            mission_cc: Mission CC
+          properties: *detail
+        staff:
+          type: matrix
+          title: Staff & Functional
+          ui:
+            compact: true
+          members:
+            exec_aide_cag: Exec / Aide / CAG
+            haf_staff: HAF Staff
+            majcom_naf_staff: MAJCOM / NAF Staff
+            joint_staff: Joint Staff
+            instructor: Instructor
+            jqo: Joint Qualified Officer (JQO)
+          properties: *detail
+        education:
+          type: matrix
+          title: Education & PME
+          ui:
+            compact: true
+          members:
+            commissioning_dg: Commissioning Source DG
+            sos_dg: SOS DG / Top Third
+            cyber_200: Cyber 200
+            cyber_300: Cyber 300
+            ide: IDE Candidate / Graduate
+            sde: SDE Candidate / Graduate
+            weapons_school: Weapons School / WIC DG
+          properties: *detail