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.760-0.930
4 checks / 0 warned
No answer warnings recorded
What is PlatformApp?
`PlatformApp`: Kubernetes custom resource for one application in one environment. `Intent`: app-owned `PlatformApp` source kept close to application code. `AppliedState`: environment-specific state Platform reconciles.
class PlatformApp(BaseModel): apiVersion: Literal['platform.krakenmind.com/v1']; kind: Literal['PlatformApp']; metadata: AppMetadata; spec: PlatformAppSpec.
The API-owned contract surface accepts app declarations, validates owner and environment metadata, and prevents callers from mutating cloud resources directly.
`platformctl app repo create`, `platformctl app init`, `platformctl app register`, and `platformctl app applied propose` are the expected operator-facing commands.
`PlatformApp`: Kubernetes custom resource for one application in one environment. `Intent`: app-owned `PlatformApp` source kept close to application code. `AppliedState`: environment-specific state Platform reconciles.
demo source allowlist matched
demo source allowlist matched
demo source allowlist matched
demo source allowlist matched
PlatformApp is the app-owned contract that describes one Platform application inside a Kubernetes environment. In practice it combines product and owner metadata, declarative intent, and the applied state that Platform reconciles 1,2.
Platform treats it as a contract surface: the API validates the declaration and prevents callers from mutating cloud resources directly 3. The expected operator flow is to create or register it with platformctl, then request proposals or applications against that state 4.
apiVersion: platform.krakenmind.com/v1
kind: PlatformApp
metadata:
name: payments-api
spec:
product: payments
owner: platformIn short: PlatformApp is the declarative unit that tells Platform which app exists, who owns it, and which state should converge.
{
"id": "demo-platformapp",
"query_id": "query-demo-platformapp",
"principal": "team:krakenmind-platform",
"query_text": "What is PlatformApp?",
"retrieval_plan": {
"mode": "hybrid",
"retrieval_version": "demo-golden-v1",
"limit": 4,
"rrf_k": 60,
"embedding_model": "fake-embedding-32",
"terms": [
{
"kind": "entity",
"value": "PlatformApp",
"weight": 1
},
{
"kind": "keyword",
"value": "AppliedState",
"weight": 0.6
},
{
"kind": "keyword",
"value": "platformctl",
"weight": 0.6
},
{
"kind": "keyword",
"value": "Kubernetes",
"weight": 0.6
}
]
},
"selected_evidence": [
{
"trace_id": "demo-platformapp",
"source_id": "demo_src_krakenmind_docs",
"document_id": "doc_platform_mvp_scope",
"node_id": "node_platform_mvp_scope_platformapp",
"source_snapshot_id": "doc_platform_mvp_scope_snapshot",
"locator": "markdown:p:8",
"title": "platform/docs/decisions/0001-mvp-scope.md",
"snippet": "`PlatformApp`: Kubernetes custom resource for one application in one environment. `Intent`: app-owned `PlatformApp` source kept close to application code. `AppliedState`: environment-specific state Platform reconciles.",
"score": 0.93,
"lexical_score": 12,
"vector_score": 0.57,
"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/0001-mvp-scope.md",
"citation": {
"source_id": "demo_src_krakenmind_docs",
"document_id": "doc_platform_mvp_scope",
"node_id": "node_platform_mvp_scope_platformapp",
"locator": "markdown:p:8"
},
"rank_signals": {
"mode": "hybrid",
"lexical_rank": 1,
"vector_rank": 1,
"lexical_component": 12,
"vector_component": 0.57,
"rrf_k": 60,
"rerank_score": 0.93,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
"rerank_score": 0.93,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
{
"trace_id": "demo-platformapp",
"source_id": "demo_src_platform_code",
"document_id": "doc_platform_api_schema",
"node_id": "node_platform_api_schema_platformapp",
"source_snapshot_id": "doc_platform_api_schema_snapshot",
"locator": "python:packages/platform_core/schemas.py:41-78",
"title": "platform-api/packages/platform_core/schemas.py · PlatformApp",
"snippet": "class PlatformApp(BaseModel): apiVersion: Literal['platform.krakenmind.com/v1']; kind: Literal['PlatformApp']; metadata: AppMetadata; spec: PlatformAppSpec.",
"score": 0.88,
"lexical_score": 10,
"vector_score": 0.52,
"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/schemas.py",
"citation": {
"source_id": "demo_src_platform_code",
"document_id": "doc_platform_api_schema",
"node_id": "node_platform_api_schema_platformapp",
"locator": "python:packages/platform_core/schemas.py:41-78"
},
"rank_signals": {
"mode": "hybrid",
"lexical_rank": 2,
"vector_rank": 2,
"lexical_component": 10,
"vector_component": 0.52,
"rrf_k": 60,
"rerank_score": 0.88,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
"rerank_score": 0.88,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
{
"trace_id": "demo-platformapp",
"source_id": "demo_src_platform_code",
"document_id": "doc_platform_deployment",
"node_id": "node_platform_deployment_contract",
"source_snapshot_id": "doc_platform_deployment_snapshot",
"locator": "markdown:p:27",
"title": "platform-api/docs/deployment.md",
"snippet": "The API-owned contract surface accepts app declarations, validates owner and environment metadata, and prevents callers from mutating cloud resources directly.",
"score": 0.81,
"lexical_score": 7,
"vector_score": 0.45,
"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/docs/deployment.md",
"citation": {
"source_id": "demo_src_platform_code",
"document_id": "doc_platform_deployment",
"node_id": "node_platform_deployment_contract",
"locator": "markdown:p:27"
},
"rank_signals": {
"mode": "hybrid",
"lexical_rank": 3,
"vector_rank": 3,
"lexical_component": 7,
"vector_component": 0.45,
"rrf_k": 60,
"rerank_score": 0.81,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
"rerank_score": 0.81,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
{
"trace_id": "demo-platformapp",
"source_id": "demo_src_platform_code",
"document_id": "doc_platformctl_readme",
"node_id": "node_platformctl_readme_app_flow",
"source_snapshot_id": "doc_platformctl_readme_snapshot",
"locator": "markdown:p:10",
"title": "platformctl/README.md",
"snippet": "`platformctl app repo create`, `platformctl app init`, `platformctl app register`, and `platformctl app applied propose` are the expected operator-facing commands.",
"score": 0.76,
"lexical_score": 9,
"vector_score": 0.35,
"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_app_flow",
"locator": "markdown:p:10"
},
"rank_signals": {
"mode": "hybrid",
"lexical_rank": 4,
"vector_rank": 4,
"lexical_component": 9,
"vector_component": 0.35,
"rrf_k": 60,
"rerank_score": 0.76,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
},
"rerank_score": 0.76,
"rerank_reason": "Golden demo evidence selected for repeatable presentation."
}
],
"policy_decisions": [
{
"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"
]
},
{
"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": "PlatformApp is the app-owned contract that describes one Platform application inside a Kubernetes environment. In practice it combines product and owner metadata, declarative intent, and the applied state that Platform reconciles [1,2].\n\nPlatform treats it as a contract surface: the API validates the declaration and prevents callers from mutating cloud resources directly [3]. The expected operator flow is to create or register it with `platformctl`, then request proposals or applications against that state [4].\n\n```yaml\napiVersion: platform.krakenmind.com/v1\nkind: PlatformApp\nmetadata:\n name: payments-api\nspec:\n product: payments\n owner: platform\n```\n\nIn short: `PlatformApp` is the declarative unit that tells Platform which app exists, who owns it, and which state should converge.",
"citations": [
{
"marker": "[1]",
"evidence_index": 1,
"source_id": "demo_src_krakenmind_docs",
"document_id": "doc_platform_mvp_scope",
"node_id": "node_platform_mvp_scope_platformapp",
"source_snapshot_id": "doc_platform_mvp_scope_snapshot",
"locator": "markdown:p:8",
"inferred_from_inline": false
},
{
"marker": "[2]",
"evidence_index": 2,
"source_id": "demo_src_platform_code",
"document_id": "doc_platform_api_schema",
"node_id": "node_platform_api_schema_platformapp",
"source_snapshot_id": "doc_platform_api_schema_snapshot",
"locator": "python:packages/platform_core/schemas.py:41-78",
"inferred_from_inline": false
},
{
"marker": "[3]",
"evidence_index": 3,
"source_id": "demo_src_platform_code",
"document_id": "doc_platform_deployment",
"node_id": "node_platform_deployment_contract",
"source_snapshot_id": "doc_platform_deployment_snapshot",
"locator": "markdown:p:27",
"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_app_flow",
"source_snapshot_id": "doc_platformctl_readme_snapshot",
"locator": "markdown:p:10",
"inferred_from_inline": false
}
],
"rejected_citations": [],
"confidence": "high",
"unknowns": [],
"contradictions": [],
"followups": [
"What is AppCatalogRegistration?",
"How do I apply a PlatformApp with platformctl?"
],
"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 PlatformApp?"
},
"created_at": "2026-05-12T17:40:00.000Z"
}class PlatformApp(BaseModel): apiVersion: Literal['platform.krakenmind.com/v1']; kind: Literal['PlatformApp']; metadata: AppMetadata; spec: PlatformAppSpec.
The API-owned contract surface accepts app declarations, validates owner and environment metadata, and prevents callers from mutating cloud resources directly.
`platformctl app repo create`, `platformctl app init`, `platformctl app register`, and `platformctl app applied propose` are the expected operator-facing commands.