Cargando trace…
Traces
Cargando…Replayable record of past answers, grouped by query when repeated.
Replayable record of past answers, grouped by query when repeated.
4 selected / score 0.780-0.960
4 checks / 0 warned
No answer warnings recorded
What is AppCatalogRegistration?
`kind`: `AppCatalogRegistration`, `metadata.name`: app name, `spec.product`: product, `spec.repo`: repository, `spec.owner`: owning team.
demo source allowlist matched
demo source allowlist matched
demo source allowlist matched
demo source allowlist matched
AppCatalogRegistration is the object that registers an application in Platform's catalog. It does not describe the full app runtime; it describes the minimum discoverable identity: name, product, repo, and owner 1.
Its purpose is to separate discovery from apply: Platform first knows which apps exist and where their definitions live, then it can list, validate, and operate environment state 2,3. In the CLI, this appears as catalog commands for listing or inspecting registered apps 4.
{
"apiVersion": "platform.krakenmind.com/v1",
"kind": "AppCatalogRegistration",
"metadata": { "name": "payments-api" },
"spec": {
"product": "payments",
"repo": "krakenmind/payments-api",
"owner": "platform"
}
}In short: AppCatalogRegistration makes an app visible to Platform before Platform tries to reconcile it.
{
"id": "demo-app-catalog-registration",
"query_id": "query-demo-app-catalog-registration",
"principal": "team:krakenmind-platform",
"query_text": "What is AppCatalogRegistration?",
"retrieval_plan": {
"mode": "hybrid",
"retrieval_version": "demo-golden-v1",
"limit": 4,
"rrf_k": 60,
"embedding_model": "fake-embedding-32",
"terms": [
{
"kind": "entity",
"value": "AppCatalogRegistration",
"weight": 1
},
{
"kind": "keyword",
"value": "catalog",
"weight": 0.6
},
{
"kind": "keyword",
"value": "registration",
"weight": 0.6
},
{
"kind": "keyword",
"value": "platformctl",
"weight": 0.6
}
]
},
"selected_evidence": [
{
"trace_id": "demo-app-catalog-registration",
"source_id": "demo_src_platform_code",
"document_id": "doc_platform_api_readme",
"node_id": "node_platform_api_readme_catalog_registration",
"source_snapshot_id": "doc_platform_api_readme_snapshot",
"locator": "markdown:p:70",
"title": "platform-api/README.md · AppCatalogRegistration",
"snippet": "`kind`: `AppCatalogRegistration`, `metadata.name`: app name, `spec.product`: product, `spec.repo`: repository, `spec.owner`: owning team.",
"score": 0.96,
"lexical_score": 13,
"vector_score": 0.62,
"matched_terms": [],
"freshness": {
"fetched_at": "2026-05-12T17:40:00.000Z",
"external_version": "demo-golden-v1",
"source_freshness_sla": "P1D"
},
"authority": {
"source_name": "Platform code, schemas, examples",
"source_type": "github",
"owner_ref": "team:krakenmind-platform",
"sensitivity": "internal",
"access_mode": "allowlist"
},
"source_uri": "https://github.com/krakenmind/platform-api/blob/main/README.md",
"citation": {
"source_id": "demo_src_platform_code",
"document_id": "doc_platform_api_readme",
"node_id": "node_platform_api_readme_catalog_registration",
"locator": "markdown:p:70"
},
"rank_signals": {
"mode": "hybrid",
"lexical_rank": 1,
"vector_rank": 1,
"lexical_component": 13,
"vector_component": 0.62,
"rrf_k": 60,
"rerank_score": 0.96,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
"rerank_score": 0.96,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
{
"trace_id": "demo-app-catalog-registration",
"source_id": "demo_src_krakenmind_docs",
"document_id": "doc_platform_catalog_adr",
"node_id": "node_platform_catalog_adr_flow",
"source_snapshot_id": "doc_platform_catalog_adr_snapshot",
"locator": "markdown:h2:15",
"title": "platform/docs/decisions/0006-app-catalog-and-registration.md",
"snippet": "Registration is the bridge between repository-owned app definitions and the platform catalog. Platform should make app discovery explicit before applying environment state.",
"score": 0.85,
"lexical_score": 8,
"vector_score": 0.5,
"matched_terms": [],
"freshness": {
"fetched_at": "2026-05-12T17:40:00.000Z",
"external_version": "demo-golden-v1",
"source_freshness_sla": "P1D"
},
"authority": {
"source_name": "Krakenmind docs, ADRs, skills, modules",
"source_type": "filesystem",
"owner_ref": "team:krakenmind-platform",
"sensitivity": "internal",
"access_mode": "allowlist"
},
"source_uri": "https://github.com/krakenmind/platform/blob/main/docs/decisions/0006-app-catalog-and-registration.md",
"citation": {
"source_id": "demo_src_krakenmind_docs",
"document_id": "doc_platform_catalog_adr",
"node_id": "node_platform_catalog_adr_flow",
"locator": "markdown:h2:15"
},
"rank_signals": {
"mode": "hybrid",
"lexical_rank": 2,
"vector_rank": 2,
"lexical_component": 8,
"vector_component": 0.5,
"rrf_k": 60,
"rerank_score": 0.85,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
"rerank_score": 0.85,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
{
"trace_id": "demo-app-catalog-registration",
"source_id": "demo_src_platform_code",
"document_id": "doc_platform_catalog_code",
"node_id": "node_platform_catalog_code_validation",
"source_snapshot_id": "doc_platform_catalog_code_snapshot",
"locator": "python:packages/platform_core/catalog.py:96-142",
"title": "platform-api/packages/platform_core/catalog.py",
"snippet": "The catalog layer normalizes registration payloads, checks required metadata, and emits a catalog entry that can be listed by environment.",
"score": 0.8,
"lexical_score": 6,
"vector_score": 0.47,
"matched_terms": [],
"freshness": {
"fetched_at": "2026-05-12T17:40:00.000Z",
"external_version": "demo-golden-v1",
"source_freshness_sla": "P1D"
},
"authority": {
"source_name": "Platform code, schemas, examples",
"source_type": "github",
"owner_ref": "team:krakenmind-platform",
"sensitivity": "internal",
"access_mode": "allowlist"
},
"source_uri": "https://github.com/krakenmind/platform-api/blob/main/packages/platform_core/catalog.py",
"citation": {
"source_id": "demo_src_platform_code",
"document_id": "doc_platform_catalog_code",
"node_id": "node_platform_catalog_code_validation",
"locator": "python:packages/platform_core/catalog.py:96-142"
},
"rank_signals": {
"mode": "hybrid",
"lexical_rank": 3,
"vector_rank": 3,
"lexical_component": 6,
"vector_component": 0.47,
"rrf_k": 60,
"rerank_score": 0.8,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
"rerank_score": 0.8,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
{
"trace_id": "demo-app-catalog-registration",
"source_id": "demo_src_platform_code",
"document_id": "doc_platformctl_readme",
"node_id": "node_platformctl_readme_catalog_commands",
"source_snapshot_id": "doc_platformctl_readme_snapshot",
"locator": "markdown:p:25",
"title": "platformctl/README.md · catalog commands",
"snippet": "`platformctl catalog apps list --env <env>` lists app catalog metadata. `platformctl catalog apps get <app>` fetches one registered app.",
"score": 0.78,
"lexical_score": 7,
"vector_score": 0.41,
"matched_terms": [],
"freshness": {
"fetched_at": "2026-05-12T17:40:00.000Z",
"external_version": "demo-golden-v1",
"source_freshness_sla": "P1D"
},
"authority": {
"source_name": "Platform code, schemas, examples",
"source_type": "github",
"owner_ref": "team:krakenmind-platform",
"sensitivity": "internal",
"access_mode": "allowlist"
},
"source_uri": "https://github.com/krakenmind/platformctl/blob/main/README.md",
"citation": {
"source_id": "demo_src_platform_code",
"document_id": "doc_platformctl_readme",
"node_id": "node_platformctl_readme_catalog_commands",
"locator": "markdown:p:25"
},
"rank_signals": {
"mode": "hybrid",
"lexical_rank": 4,
"vector_rank": 4,
"lexical_component": 7,
"vector_component": 0.41,
"rrf_k": 60,
"rerank_score": 0.78,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
"rerank_score": 0.78,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
}
],
"policy_decisions": [
{
"stage": "source_access",
"decision": "allow",
"source_id": "demo_src_platform_code",
"principal": "team:krakenmind-platform",
"agent_scope": "mind-core",
"reasons": [
"demo source allowlist matched"
]
},
{
"stage": "source_access",
"decision": "allow",
"source_id": "demo_src_krakenmind_docs",
"principal": "team:krakenmind-platform",
"agent_scope": "mind-core",
"reasons": [
"demo source allowlist matched"
]
},
{
"stage": "source_access",
"decision": "allow",
"source_id": "demo_src_platform_code",
"principal": "team:krakenmind-platform",
"agent_scope": "mind-core",
"reasons": [
"demo source allowlist matched"
]
},
{
"stage": "source_access",
"decision": "allow",
"source_id": "demo_src_platform_code",
"principal": "team:krakenmind-platform",
"agent_scope": "mind-core",
"reasons": [
"demo source allowlist matched"
]
}
],
"answer": {
"status": "answered",
"answer_text": "`AppCatalogRegistration` is the object that registers an application in Platform's catalog. It does not describe the full app runtime; it describes the minimum discoverable identity: name, product, repo, and owner [1].\n\nIts purpose is to separate discovery from apply: Platform first knows which apps exist and where their definitions live, then it can list, validate, and operate environment state [2,3]. In the CLI, this appears as catalog commands for listing or inspecting registered apps [4].\n\n```json\n{\n \"apiVersion\": \"platform.krakenmind.com/v1\",\n \"kind\": \"AppCatalogRegistration\",\n \"metadata\": { \"name\": \"payments-api\" },\n \"spec\": {\n \"product\": \"payments\",\n \"repo\": \"krakenmind/payments-api\",\n \"owner\": \"platform\"\n }\n}\n```\n\nIn short: `AppCatalogRegistration` makes an app visible to Platform before Platform tries to reconcile it.",
"citations": [
{
"marker": "[1]",
"evidence_index": 1,
"source_id": "demo_src_platform_code",
"document_id": "doc_platform_api_readme",
"node_id": "node_platform_api_readme_catalog_registration",
"source_snapshot_id": "doc_platform_api_readme_snapshot",
"locator": "markdown:p:70",
"inferred_from_inline": false
},
{
"marker": "[2]",
"evidence_index": 2,
"source_id": "demo_src_krakenmind_docs",
"document_id": "doc_platform_catalog_adr",
"node_id": "node_platform_catalog_adr_flow",
"source_snapshot_id": "doc_platform_catalog_adr_snapshot",
"locator": "markdown:h2:15",
"inferred_from_inline": false
},
{
"marker": "[3]",
"evidence_index": 3,
"source_id": "demo_src_platform_code",
"document_id": "doc_platform_catalog_code",
"node_id": "node_platform_catalog_code_validation",
"source_snapshot_id": "doc_platform_catalog_code_snapshot",
"locator": "python:packages/platform_core/catalog.py:96-142",
"inferred_from_inline": false
},
{
"marker": "[4]",
"evidence_index": 4,
"source_id": "demo_src_platform_code",
"document_id": "doc_platformctl_readme",
"node_id": "node_platformctl_readme_catalog_commands",
"source_snapshot_id": "doc_platformctl_readme_snapshot",
"locator": "markdown:p:25",
"inferred_from_inline": false
}
],
"rejected_citations": [],
"confidence": "high",
"unknowns": [],
"contradictions": [],
"followups": [
"What is PlatformApp?",
"How does AppCatalogRegistration relate to AppliedState?"
],
"warnings": [],
"model": "demo-trace-v1",
"provider": "golden",
"answer_version": "demo-golden-v1",
"raw_output": null
},
"metadata": {
"demo": true,
"demo_kind": "golden_trace",
"live_query": "What is AppCatalogRegistration?"
},
"created_at": "2026-05-12T17:40:00.000Z"
}Registration is the bridge between repository-owned app definitions and the platform catalog. Platform should make app discovery explicit before applying environment state.
The catalog layer normalizes registration payloads, checks required metadata, and emits a catalog entry that can be listed by environment.
`platformctl catalog apps list --env <env>` lists app catalog metadata. `platformctl catalog apps get <app>` fetches one registered app.
`kind`: `AppCatalogRegistration`, `metadata.name`: app name, `spec.product`: product, `spec.repo`: repository, `spec.owner`: owning team.
Registration is the bridge between repository-owned app definitions and the platform catalog. Platform should make app discovery explicit before applying environment state.
The catalog layer normalizes registration payloads, checks required metadata, and emits a catalog entry that can be listed by environment.
`platformctl catalog apps list --env <env>` lists app catalog metadata. `platformctl catalog apps get <app>` fetches one registered app.
`kind`: `AppCatalogRegistration`, `metadata.name`: app name, `spec.product`: product, `spec.repo`: repository, `spec.owner`: owning team.
Registration is the bridge between repository-owned app definitions and the platform catalog. Platform should make app discovery explicit before applying environment state.
The catalog layer normalizes registration payloads, checks required metadata, and emits a catalog entry that can be listed by environment.
`platformctl catalog apps list --env <env>` lists app catalog metadata. `platformctl catalog apps get <app>` fetches one registered app.