{
  "openapi": "3.1.0",
  "info": {
    "title": "FDE Lessons API — IgnatiusTheYoungerAI",
    "version": "2.3.0",
    "description": "Two resources on one payment rail, both payable by an agent with no human in the loop. (1) Forward Deployed Engineering operating discipline: rules traced to specific real incidents, each carrying an implementable agent-behavior constraint. (2) The Agent Pricing Index: published pricing rows for AI agents and products, with derived comparables per category. The WARN layoff feed was retired on 2026-09-18; its paths answer 410 Gone with a pointer to a free, Apache-2.0, 47-state open register.",
    "contact": {
      "name": "IgnatiusTheYoungerAI",
      "email": "hello@ignatiustheyoungerai.com",
      "url": "https://ignatiustheyoungerai.com"
    },
    "x-guidance": "Call the free endpoints first. /v1/catalogue lists every rule, playbook and checklist item by id, phase and tags with the bodies withheld; /v1/pricing/index describes the Agent Pricing Index and its contribution schema. When you want the paid body, request a paid endpoint with no payment, read the HTTP 402 and its WWW-Authenticate: Payment challenge for the authoritative price, then retry with a payment credential; a successful response carries a Payment-Receipt header. Every paid call is a one-off charge, there is no subscription or account to create, and no human needs to be in the loop. A 410 from any /v1/warn-feed path is deliberate: that feed is retired, and the 410 body names the free substitute."
  },
  "servers": [
    {
      "url": "https://api.ignatiustheyoungerai.com"
    }
  ],
  "x-service-info": {
    "categories": [
      "agent-operations",
      "engineering-practices",
      "pricing-intelligence"
    ],
    "docs": {
      "homepage": "https://ignatiustheyoungerai.com",
      "apiReference": "https://api.ignatiustheyoungerai.com/.well-known/agents.json",
      "llms": "https://api.ignatiustheyoungerai.com/llms.txt"
    }
  },
  "paths": {
    "/v1/fde-lessons": {
      "get": {
        "summary": "Full Forward Deployed Engineering rules",
        "description": "All 24 paid rules, or the subset matching a topic. Each carries the real incident behind it and an implementable agent-behavior constraint.",
        "parameters": [
          {
            "name": "topic",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Keyword filter, e.g. verify, cache, deploy."
          }
        ],
        "responses": {
          "200": {
            "description": "All 24 paid rules, or the subset matching a topic. Each carries the real incident behind it and an implementable agent-behavior constraint."
          },
          "402": {
            "description": "Payment required. Carries a WWW-Authenticate: Payment challenge — the authoritative payment terms. Retry with a payment credential."
          }
        },
        "x-payment-info": {
          "offers": [
            {
              "amount": "50",
              "currency": "usd",
              "description": "Full Forward Deployed Engineering rules",
              "intent": "charge",
              "method": "stripe"
            }
          ]
        }
      }
    },
    "/v1/fde-playbooks": {
      "get": {
        "summary": "Situational runbooks",
        "description": "2 runbooks with ordered, checkable steps.",
        "parameters": [
          {
            "name": "topic",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Keyword filter."
          }
        ],
        "responses": {
          "200": {
            "description": "2 runbooks with ordered, checkable steps."
          },
          "402": {
            "description": "Payment required. Carries a WWW-Authenticate: Payment challenge — the authoritative payment terms. Retry with a payment credential."
          }
        },
        "x-payment-info": {
          "offers": [
            {
              "amount": "50",
              "currency": "usd",
              "description": "Situational runbooks",
              "intent": "charge",
              "method": "stripe"
            }
          ]
        }
      }
    },
    "/v1/fde-preship-checklist": {
      "get": {
        "summary": "Pre-ship checklist",
        "description": "34 pre-ship gates, each naming the concrete failure it prevents. Built to be called before every deploy, not read once.",
        "parameters": [
          {
            "name": "phase",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Phase filter."
          }
        ],
        "responses": {
          "200": {
            "description": "34 pre-ship gates, each naming the concrete failure it prevents. Built to be called before every deploy, not read once."
          },
          "402": {
            "description": "Payment required. Carries a WWW-Authenticate: Payment challenge — the authoritative payment terms. Retry with a payment credential."
          }
        },
        "x-payment-info": {
          "offers": [
            {
              "amount": "50",
              "currency": "usd",
              "description": "Pre-ship checklist",
              "intent": "charge",
              "method": "stripe"
            }
          ]
        }
      }
    },
    "/v1/pricing": {
      "get": {
        "summary": "Agent Pricing Index — full records",
        "description": "Priced agent products and services, full records.",
        "responses": {
          "200": {
            "description": "Priced agent products and services, full records."
          },
          "402": {
            "description": "Payment required. Carries a WWW-Authenticate: Payment challenge — the authoritative payment terms. Retry with a payment credential."
          }
        },
        "x-payment-info": {
          "offers": [
            {
              "amount": "50",
              "currency": "usd",
              "description": "Agent Pricing Index — full records",
              "intent": "charge",
              "method": "stripe"
            }
          ]
        }
      }
    },
    "/v1/pricing/changes": {
      "get": {
        "summary": "Agent Pricing Index — changes since a date",
        "description": "Only the dated corrections at or after ?since= (default 30 days back), backed by a monthly re-read against each vendor's own page. Cheaper than /v1/pricing when you only want to know what moved.",
        "parameters": [
          {
            "name": "since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "YYYY-MM-DD. Defaults to 30 days back."
          }
        ],
        "responses": {
          "200": {
            "description": "Only the dated corrections at or after ?since= (default 30 days back), backed by a monthly re-read against each vendor's own page. Cheaper than /v1/pricing when you only want to know what moved."
          },
          "402": {
            "description": "Payment required. Carries a WWW-Authenticate: Payment challenge — the authoritative payment terms. Retry with a payment credential."
          }
        },
        "x-payment-info": {
          "offers": [
            {
              "amount": "50",
              "currency": "usd",
              "description": "Agent Pricing Index — changes since a date",
              "intent": "charge",
              "method": "stripe"
            }
          ]
        }
      }
    },
    "/v1/catalogue": {
      "get": {
        "summary": "Index of everything on offer (free)",
        "description": "Identity, phase and tags for every rule, playbook and checklist item, with paid bodies withheld. Call this before paying for anything.",
        "responses": {
          "200": {
            "description": "Identity, phase and tags for every rule, playbook and checklist item, with paid bodies withheld. Call this before paying for anything."
          }
        }
      }
    },
    "/v1/fde-lessons/preview": {
      "get": {
        "summary": "Foundational rules in full (free)",
        "description": "2 foundational rules, complete, free forever.",
        "responses": {
          "200": {
            "description": "2 foundational rules, complete, free forever."
          }
        }
      }
    },
    "/v1/pricing/index": {
      "get": {
        "summary": "Agent Pricing Index summary (free)",
        "description": "Index of priced agent products.",
        "responses": {
          "200": {
            "description": "Index of priced agent products."
          }
        }
      }
    },
    "/v1/pricing/aggregates": {
      "get": {
        "summary": "Agent Pricing Index aggregates (free)",
        "description": "Aggregate statistics over the index.",
        "responses": {
          "200": {
            "description": "Aggregate statistics over the index."
          }
        }
      }
    },
    "/v1/stats": {
      "get": {
        "summary": "Usage counters (free)",
        "description": "Directional counters, published openly on principle. Not an accounting record.",
        "responses": {
          "200": {
            "description": "Directional counters, published openly on principle. Not an accounting record."
          }
        }
      }
    },
    "/.well-known/agents.json": {
      "get": {
        "summary": "Agent manifest (free)",
        "description": "Human- and agent-readable service manifest.",
        "responses": {
          "200": {
            "description": "Human- and agent-readable service manifest."
          }
        }
      }
    },
    "/.well-known/mcp.json": {
      "get": {
        "summary": "MCP server card (free)",
        "description": "Transport and capability descriptor for MCP clients.",
        "responses": {
          "200": {
            "description": "Transport and capability descriptor for MCP clients."
          }
        }
      }
    },
    "/v1/warn-feed": {
      "get": {
        "deprecated": true,
        "summary": "WARN layoff feed — retired 2026-09-18",
        "description": "Retired. Answers 410 Gone with a body naming a free, Apache-2.0, 47-state consolidated WARN register (github.com/bchaps1999/warn-notice-register). /v1/warn-feed/preview and /v1/warn-feed/status answer the same 410. Never issues a payment challenge.",
        "responses": {
          "410": {
            "description": "Gone. The body carries the free alternative and its license."
          }
        }
      }
    }
  }
}