guide-registry

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'The guide slug, e.g. start-a-company.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['api_version', 'guide'], 'properties': {'guide': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'api_version': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Substring match on the element label.'}, 'role': {'type': 'string', 'description': 'Elements required by this job role, e.g. compensation-analyst.'}, 'limit': {'type': 'number', 'description': 'Cap the rows returned (default 200). `total` always reports the true count.'}, 'has_job': {'type': 'boolean', 'description': 'Only elements that some job requires (via a career guide).'}, 'ksao_type': {'type': 'string', 'description': "knowledge | skill | ability | other — from a panel validated at 95.1% on gold O*NET labels. 'other' is UNVALIDATED (no gold labels existed for it)."}, 'capability': {'type': 'string', 'description': 'Elements taught by this capability (guide slug).'}, 'min_guides': {'type': 'number', 'description': 'Only elements taught by >= N capabilities. 2 gives the cross-cutting spine.'}, 'conflicting': {'type': 'boolean', 'description': 'Only elements where 2+ non-career guides define the same label differently — these need a ruling.'}, 'construct_class': {'type': 'string', 'description': "person-attribute (knowledge/skill/ability — what a JOB requires and a learner develops) | condition-or-outcome (what a capability PRODUCES, e.g. 'Retention & Workforce Stability'). Only ~30% of elements are person attributes — filter to these for 'what does this role need'."}, 'capability_detail': {'type': 'string', 'description': 'Return ONE capability with its elements and books hydrated, instead of querying elements.'}, 'has_canon_identity': {'type': 'boolean', 'description': 'true = only elements resolved to a JobFrame canon component (an IDENTITY, panel-adjudicated). false = only unresolved.'}, 'canon_promotion_candidate': {'type': 'boolean', 'description': 'true = only elements the JobFrame canon has NO component for. This is a real answer, not a failed lookup — these are the constructs to PROMOTE into the canon.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['api_version', 'spine_meta'], 'properties': {'total': {'type': 'number'}, 'elements': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'returned': {'type': 'number'}, 'capability': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'spine_meta': {}, 'api_version': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'home': {'type': 'string', 'description': 'Filter by owning property, e.g. jobframe, peopleanalyst, penwright.'}, 'limit': {'type': 'number', 'description': 'Cap the rows returned. Default 100, max 500.'}, 'access': {'type': 'string', 'description': 'Filter by access: free | gated.'}, 'domain': {'type': 'string', 'description': "Filter by life-domain — the layer ABOVE the subject shelf: work | life | play. Derived from the guide's category via content/registry/shelves.json. `rollup.by_domain` lists them."}, 'fields': {'enum': ['compact', 'full'], 'type': 'string', 'description': 'Row shape. "compact" returns only slug/title/home/status/access/price_cents/has_artifact/category/domain/personas/canonical_url — no rollup, no registry_meta. "full" returns the entire decorated registry row plus the rollup and registry_meta, as before. Default over this server: "compact".'}, 'series': {'type': 'string', 'description': 'Filter by guide series — the operational grouping of guides made to be used together, e.g. competencies, penwright-writing, startup-journey, ladder:hr-business-partner.'}, 'status': {'type': 'string', 'description': 'Filter by status: on | draft.'}, 'persona': {'type': 'string', 'description': 'Filter by the audience a guide serves, e.g. people-analytics-professional, aspiring-author, executive-performance-leader. A guide can serve several; this matches any of them.'}, 'category': {'type': 'string', 'description': 'Filter by subject shelf — the reader-facing topic axis, e.g. field, skills, analytics, writing, comp. Matches the primary category OR a cross-shelf tag.'}, 'standard': {'type': 'string', 'description': 'Filter by standard: bicycle | life-stage | problem-opportunity.'}, 'guide_type': {'type': 'string', 'description': "Filter by guide CLASS: career (level-based job guides, their own program) | capability | book_profile. Combine with series=ladder:<role> to get one role's whole ladder."}, 'has_artifact': {'type': 'boolean', 'description': 'Only guides that do (true) / do not (false) have a new-design artifact.'}, 'home_unrouted': {'type': 'boolean', 'description': 'Only guides whose home has NO rendering surface at all (the distribution gap).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['api_version', 'fields', 'count', 'total_matching', 'limit', 'filters', 'guides'], 'properties': {'count': {'type': 'number'}, 'limit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'fields': {'enum': ['compact', 'full'], 'type': 'string'}, 'guides': {'type': 'array', 'items': {'anyOf': [{'type': 'object', 'required': ['slug', 'title', 'home', 'status', 'access', 'price_cents', 'has_artifact', 'category', 'domain', 'personas', 'canonical_url'], 'properties': {'home': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'access': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'personas': {'type': 'array', 'items': {'type': 'string'}}, 'price_cents': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'has_artifact': {'type': 'boolean'}, 'canonical_url': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}]}}, 'rollup': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'filters': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'api_version': {'type': 'string'}, 'registry_meta': {}, 'total_matching': {'type': 'number'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['api_version', 'registry_meta', 'counts_basis', 'domains', 'shelves', 'series', 'personas', 'guide_types', 'conventions', 'unclassified'], 'properties': {'series': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'domains': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'shelves': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'personas': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'api_version': {'type': 'string'}, 'conventions': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'guide_types': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'counts_basis': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'unclassified': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'registry_meta': {}}, 'additionalProperties': False}