aiwg/agentic/code/frameworks/sdlc-complete/schemas/research/bibtex-export.yaml

Deployment tool and support utility for AI context. Copies agents, skills, commands, rules, and behaviors into the paths each AI platform reads (Claude Code, Codex, Copilot, Cursor, Warp, OpenClaw, and 6 more) so one source of truth works across 10 platfo

# BibTeX/Citation Export Schema
# Based on REF-061 OAIS (Dissemination Information Package)
# Issues: #109, #121

$schema: "https://json-schema.org/draft/2020-12/schema"
$id: "https://aiwg.io/schemas/bibtex-export/v1"
title: "Citation Export Schema"
description: |
  Schema for exporting research corpus as BibTeX, CSL JSON, or RIS formats.
  Implements OAIS DIP (Dissemination Information Package) generation.

type: object
required:
  - export_id
  - format
  - entries

properties:
  export_id:
    type: string
    format: uuid

  generated_at:
    type: string
    format: date-time

  format:
    type: string
    enum:
      - bibtex
      - csl_json
      - ris
      - endnote
    description: "Export format"

  filters:
    type: object
    properties:
      quality:
        type: array
        items:
          type: string
          enum: [high, moderate, low, very_low]
        description: "Filter by GRADE quality"
      relevance:
        type: array
        items:
          type: string
          enum: [critical, high, medium, low]
        description: "Filter by AIWG relevance"
      categories:
        type: array
        items:
          type: string
        description: "Filter by category"
      year_range:
        type: object
        properties:
          min:
            type: integer
          max:
            type: integer
      ref_ids:
        type: array
        items:
          type: string
        description: "Specific REF-XXX to include"
    description: "Export filters"

  entries:
    type: array
    items:
      $ref: "#/$defs/Entry"
    description: "Exported entries"

  statistics:
    type: object
    properties:
      total_in_corpus:
        type: integer
      filtered_count:
        type: integer
      exported_count:
        type: integer

$defs:
  Entry:
    type: object
    required:
      - ref_id
      - entry_type
      - fields
    properties:
      ref_id:
        type: string
        pattern: "^REF-[0-9]{3}(-[a-z]+)?$"

      entry_type:
        type: string
        enum:
          - article
          - inproceedings
          - book
          - incollection
          - techreport
          - misc
          - phdthesis
          - mastersthesis
        description: "BibTeX entry type"

      cite_key:
        type: string
        description: "Citation key (e.g., FAIR2016)"

      fields:
        type: object
        properties:
          title:
            type: string
          author:
            type: string
            description: "Authors in BibTeX format"
          year:
            type: string
          month:
            type: string
          journal:
            type: string
          booktitle:
            type: string
          publisher:
            type: string
          volume:
            type: string
          number:
            type: string
          pages:
            type: string
          doi:
            type: string
          url:
            type: string
          arxiv:
            type: string
          abstract:
            type: string
          keywords:
            type: string

      aiwg_metadata:
        type: object
        properties:
          quality:
            type: string
          relevance:
            type: string
          categories:
            type: array
            items:
              type: string
        description: "AIWG-specific metadata (as BibTeX keywords)"

# Format templates
format_templates:
  bibtex:
    template: |
      @{{entry_type}}{{{cite_key}},
        author = {{{fields.author}}},
        title = {{{fields.title}}},
        year = {{{fields.year}}},
        {{#if fields.journal}}journal = {{{fields.journal}}},{{/if}}
        {{#if fields.booktitle}}booktitle = {{{fields.booktitle}}},{{/if}}
        {{#if fields.volume}}volume = {{{fields.volume}}},{{/if}}
        {{#if fields.pages}}pages = {{{fields.pages}}},{{/if}}
        {{#if fields.doi}}doi = {{{fields.doi}}},{{/if}}
        {{#if fields.url}}url = {{{fields.url}}},{{/if}}
        keywords = {aiwg-{{aiwg_metadata.relevance}}}
      }

  csl_json:
    description: "Citation Style Language JSON format"
    structure: |
      {
        "id": "REF-XXX",
        "type": "article-journal",
        "title": "...",
        "author": [{"family": "...", "given": "..."}],
        "issued": {"date-parts": [[2024]]},
        "DOI": "...",
        "URL": "..."
      }

  ris:
    template: |
      TY  - {{ris_type}}
      AU  - {{author_ris}}
      TI  - {{fields.title}}
      PY  - {{fields.year}}
      {{#if fields.journal}}JO  - {{fields.journal}}{{/if}}
      {{#if fields.doi}}DO  - {{fields.doi}}{{/if}}
      {{#if fields.url}}UR  - {{fields.url}}{{/if}}
      KW  - aiwg-{{aiwg_metadata.relevance}}
      ER  -

# Mapping tables
entry_type_mapping:
  peer_reviewed_journal: article
  peer_reviewed_conference: inproceedings
  preprint: misc
  technical_report: techreport
  book_chapter: incollection
  industry_whitepaper: misc
  standard: misc
  thesis: phdthesis

ris_type_mapping:
  article: JOUR
  inproceedings: CONF
  book: BOOK
  techreport: RPRT
  misc: GEN

# Agent protocol
agent_protocol:
  export_workflow:
    steps:
      - load_frontmatter_from_corpus
      - apply_filters
      - map_to_entry_type
      - generate_cite_keys
      - render_to_format
      - validate_output

  cite_key_generation:
    pattern: "{{first_author_last}}{{year}}{{title_word}}"
    example: "Wilkinson2016FAIR"
    collision_handling: append_letter  # Wilkinson2016a, Wilkinson2016b

# Examples
examples:
  bibtex_output: |
    @article{Wilkinson2016FAIR,
      author = {Wilkinson, Mark D. and Dumontier, Michel and others},
      title = {The FAIR Guiding Principles for scientific data management and stewardship},
      year = {2016},
      journal = {Scientific Data},
      volume = {3},
      doi = {10.1038/sdata.2016.18},
      keywords = {aiwg-critical}
    }

    @inproceedings{Hong2023MetaGPT,
      author = {Hong, Sirui and others},
      title = {MetaGPT: Meta Programming for Multi-Agent Collaboration},
      year = {2023},
      booktitle = {arXiv preprint},
      arxiv = {2308.00352},
      keywords = {aiwg-critical}
    }

# References
references:
  research:
    - "@.aiwg/research/findings/REF-061-oais.md"
  implementation:
    - "#109"
    - "#121"
  related:
    - "@agentic/code/frameworks/sdlc-complete/schemas/research/frontmatter-schema.yaml"