# Capabilities Manifest — perardua.dev
# Spec: https://perardua.dev/specs/capabilities

manifest:
  spec: "0.1"
  updated: "2026-08-31T00:00:00Z"
  canonical: "https://perardua.dev/specs/capabilities"

domain:
  name: "Per Ardua"
  url: "https://perardua.dev"
  description: >
    Research portfolio of Jeremy McEntire. 25 papers across activation geometry,
    organizational theory, and applied analysis, plus an academic monograph on
    Structural Compression Theory. 15 essays. 5 books. 30 open-source projects.
    5 US patent filings (3 granted, 2 pending). Primary research focus:
    exploitable structure in AI training trajectories and agent governance
    architectures.
  contact: "jmc@cageandmirror.com"
  tos: "/tos"
  privacy: "/privacy"

read:
  # ── Essays ──────────────────────────────────────────────
  - id: essays_index
    path: /essays/
    description: "Index of 15 essays on AI, organizational theory, and epistemology"
    auth: public
    response:
      format: text/html
    cache:
      ttl: 86400
      signal: stable

  - id: essay
    path: /essays/{slug}/
    description: "Individual essay"
    auth: public
    params:
      - name: slug
        type: string
        required: true
        description: "Essay URL slug"
    response:
      format: text/html
    cache:
      ttl: 86400
      signal: stable

  # ── Research ────────────────────────────────────────────
  - id: research_index
    path: /research/
    description: >
      Index of 25 research papers organized by series: Activation Geometry (13),
      Bridge Theory (1), Organizational Theory (5), Applied and Market
      Analysis (6). Includes monograph on Structural Compression Theory.
    auth: public
    response:
      format: text/html
    cache:
      ttl: 86400
      signal: stable

  - id: research_paper
    path: /research/{slug}/
    description: "Individual research paper page with executive summary, key findings, and PDF"
    auth: public
    params:
      - name: slug
        type: string
        required: true
        description: "Paper URL slug"
    response:
      format: text/html
    cache:
      ttl: 86400
      signal: stable

  - id: research_pdf
    path: /assets/papers/{filename}
    description: "Research paper PDF download"
    auth: public
    params:
      - name: filename
        type: string
        required: true
        description: "PDF filename"
    response:
      format: application/pdf
    cache:
      ttl: 604800
      signal: immutable

  # ── Books ───────────────────────────────────────────────
  - id: books_index
    path: /books/
    description: "5 books: The Cage and the Mirror, The Key and the Current (coming soon), Introduction to Applied Synthesis (3rd ed.), Beyond Code (Packt), Privacy: The Architecture of Forgetting"
    auth: public
    response:
      format: text/html
    cache:
      ttl: 86400
      signal: stable

  - id: book
    path: /books/{slug}/
    description: "Individual book page with description, cover image, and purchase links"
    auth: public
    params:
      - name: slug
        type: string
        required: true
    response:
      format: text/html
    cache:
      ttl: 86400
      signal: stable

  # ── Projects ────────────────────────────────────────────
  - id: projects
    path: /projects/
    description: "30 open-source projects organized by category: Reference Implementation, AI Agents, Stack Governance, Organizational Tools, Infrastructure & Privacy"
    auth: public
    response:
      format: text/html
    cache:
      ttl: 86400
      signal: stable

  # ── Patents ─────────────────────────────────────────────
  - id: patents
    path: /patents/
    description: "3 granted US patents, 2 pending provisional applications, and 1 historical application"
    auth: public
    response:
      format: text/html
    cache:
      ttl: 604800
      signal: stable

  # ── Photography ─────────────────────────────────────────
  - id: photography
    path: /photography/
    description: "Astrophotography, aurora, landscape, wildlife, weather, portrait, abstract"
    auth: public
    response:
      format: text/html
    cache:
      ttl: 604800
      signal: stable

  # ── About / Contact / Press ─────────────────────────────
  - id: about
    path: /about/
    description: "Professional biography and career summary"
    auth: public
    response:
      format: text/html
    cache:
      ttl: 604800
      signal: stable

  - id: press
    path: /press/
    description: "Media coverage and external publications"
    auth: public
    response:
      format: text/html
    cache:
      ttl: 86400
      signal: stable

  # ── Machine-readable index ──────────────────────────────
  - id: llms_txt
    path: /llms.txt
    description: "Machine-readable site summary for LLM consumption"
    auth: public
    response:
      format: text/plain
    cache:
      ttl: 86400
      signal: stable

  - id: sitemap
    path: /sitemap-index.xml
    description: "XML sitemap of all pages"
    auth: public
    response:
      format: application/xml
    cache:
      ttl: 86400
      signal: stable
