@kaelio/ktx 0.1.0-rc.0 → 0.1.0-rc.1

package/LICENSE

@@ -199,4 +199,3 @@
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
-

package/assets/demo/orbit/links/provenance.json

@@ -2,7 +2,7 @@
   {
     "id": "link-001",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/arr-contract-first.md",
+    "artifactKey": "wiki/global/arr-contract-first.md",
     "sourceKind": "warehouse",
     "sourcePath": "contracts",
     "relationship": "describes",
@@ -11,7 +11,7 @@
   {
     "id": "link-002",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/arr-contract-first.md",
+    "artifactKey": "wiki/global/arr-contract-first.md",
     "sourceKind": "notion",
     "sourcePath": "raw-sources/notion/arr-and-contract-reporting-notes.md",
     "relationship": "derived_from",
@@ -20,7 +20,7 @@
   {
     "id": "link-003",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/revenue-gross-to-net.md",
+    "artifactKey": "wiki/global/revenue-gross-to-net.md",
     "sourceKind": "warehouse",
     "sourcePath": "invoices",
     "relationship": "describes",
@@ -29,7 +29,7 @@
   {
     "id": "link-004",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/revenue-gross-to-net.md",
+    "artifactKey": "wiki/global/revenue-gross-to-net.md",
     "sourceKind": "notion",
     "sourcePath": "raw-sources/notion/revenue-reporting-policy.md",
     "relationship": "derived_from",
@@ -38,7 +38,7 @@
   {
     "id": "link-005",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/discount-expiration.md",
+    "artifactKey": "wiki/global/discount-expiration.md",
     "sourceKind": "warehouse",
     "sourcePath": "arr_movements",
     "relationship": "describes",
@@ -47,7 +47,7 @@
   {
     "id": "link-006",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/nrr-retention.md",
+    "artifactKey": "wiki/global/nrr-retention.md",
     "sourceKind": "warehouse",
     "sourcePath": "arr_movements",
     "relationship": "describes",
@@ -56,7 +56,7 @@
   {
     "id": "link-007",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/nrr-retention.md",
+    "artifactKey": "wiki/global/nrr-retention.md",
     "sourceKind": "notion",
     "sourcePath": "raw-sources/notion/retention-and-nrr-definition-notes.md",
     "relationship": "derived_from",
@@ -65,7 +65,7 @@
   {
     "id": "link-008",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/nrr-retention.md",
+    "artifactKey": "wiki/global/nrr-retention.md",
     "sourceKind": "bi",
     "sourcePath": "raw-sources/bi/account_retention.view.lkml",
     "relationship": "derived_from",
@@ -74,7 +74,7 @@
   {
     "id": "link-009",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/segment-classification.md",
+    "artifactKey": "wiki/global/segment-classification.md",
     "sourceKind": "warehouse",
     "sourcePath": "plans",
     "relationship": "describes",
@@ -83,7 +83,7 @@
   {
     "id": "link-010",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/segment-classification.md",
+    "artifactKey": "wiki/global/segment-classification.md",
     "sourceKind": "notion",
     "sourcePath": "raw-sources/notion/sales-ops-segmentation-guide.md",
     "relationship": "derived_from",
@@ -92,7 +92,7 @@
   {
     "id": "link-011",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/activation-policy.md",
+    "artifactKey": "wiki/global/activation-policy.md",
     "sourceKind": "notion",
     "sourcePath": "raw-sources/notion/activation-policy-decision-record.md",
     "relationship": "derived_from",
@@ -101,7 +101,7 @@
   {
     "id": "link-012",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/procurement-workflows.md",
+    "artifactKey": "wiki/global/procurement-workflows.md",
     "sourceKind": "warehouse",
     "sourcePath": "purchase_requests",
     "relationship": "describes",
@@ -110,7 +110,7 @@
   {
     "id": "link-013",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/customer-health-scoring.md",
+    "artifactKey": "wiki/global/customer-health-scoring.md",
     "sourceKind": "notion",
     "sourcePath": "raw-sources/notion/customer-health-playbook.md",
     "relationship": "derived_from",
@@ -119,7 +119,7 @@
   {
     "id": "link-014",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/customer-health-scoring.md",
+    "artifactKey": "wiki/global/customer-health-scoring.md",
     "sourceKind": "warehouse",
     "sourcePath": "support_tickets",
     "relationship": "describes",
@@ -128,7 +128,7 @@
   {
     "id": "link-015",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/support-escalation.md",
+    "artifactKey": "wiki/global/support-escalation.md",
     "sourceKind": "notion",
     "sourcePath": "raw-sources/notion/support-escalation-runbook.md",
     "relationship": "derived_from",
@@ -137,7 +137,7 @@
   {
     "id": "link-016",
     "artifactKind": "wiki",
-    "artifactKey": "knowledge/global/internal-test-exclusion.md",
+    "artifactKey": "wiki/global/internal-test-exclusion.md",
     "sourceKind": "notion",
     "sourcePath": "raw-sources/notion/analyst-onboarding.md",
     "relationship": "derived_from",

package/assets/demo/orbit/manifest.json

@@ -43,12 +43,12 @@
   },
   "generated": {
     "semanticLayer": {
-      "path": "semantic-layer/orbit_demo",
-      "sourceCount": 6
+      "path": "semantic-layer",
+      "sourceCount": 46
     },
     "knowledge": {
-      "path": "knowledge/global",
-      "pageCount": 10
+      "path": "wiki/global",
+      "pageCount": 28
     },
     "links": {
       "path": "links",

package/assets/demo/orbit/replay.memory-flow.v1.json

@@ -71,7 +71,7 @@
         "type": "work_unit_started",
         "unitKey": "revenue-and-contracts",
         "skills": [
-          "knowledge_capture",
+          "wiki_capture",
           "sl_capture"
         ],
         "stepBudget": 40
@@ -81,21 +81,21 @@
         "unitKey": "revenue-and-contracts",
         "target": "wiki",
         "action": "created",
-        "key": "knowledge/global/arr-contract-first.md"
+        "key": "wiki/global/arr-contract-first.md"
       },
       {
         "type": "candidate_action",
         "unitKey": "revenue-and-contracts",
         "target": "wiki",
         "action": "created",
-        "key": "knowledge/global/revenue-gross-to-net.md"
+        "key": "wiki/global/revenue-gross-to-net.md"
       },
       {
         "type": "candidate_action",
         "unitKey": "revenue-and-contracts",
         "target": "wiki",
         "action": "created",
-        "key": "knowledge/global/discount-expiration.md"
+        "key": "wiki/global/discount-expiration.md"
       },
       {
         "type": "candidate_action",
@@ -127,7 +127,7 @@
         "type": "work_unit_started",
         "unitKey": "retention-and-segments",
         "skills": [
-          "knowledge_capture",
+          "wiki_capture",
           "sl_capture"
         ],
         "stepBudget": 40
@@ -137,14 +137,14 @@
         "unitKey": "retention-and-segments",
         "target": "wiki",
         "action": "created",
-        "key": "knowledge/global/nrr-retention.md"
+        "key": "wiki/global/nrr-retention.md"
       },
       {
         "type": "candidate_action",
         "unitKey": "retention-and-segments",
         "target": "wiki",
         "action": "created",
-        "key": "knowledge/global/segment-classification.md"
+        "key": "wiki/global/segment-classification.md"
       },
       {
         "type": "candidate_action",
@@ -162,7 +162,7 @@
         "type": "work_unit_started",
         "unitKey": "procurement-and-activation",
         "skills": [
-          "knowledge_capture",
+          "wiki_capture",
           "sl_capture"
         ],
         "stepBudget": 40
@@ -172,14 +172,14 @@
         "unitKey": "procurement-and-activation",
         "target": "wiki",
         "action": "created",
-        "key": "knowledge/global/activation-policy.md"
+        "key": "wiki/global/activation-policy.md"
       },
       {
         "type": "candidate_action",
         "unitKey": "procurement-and-activation",
         "target": "wiki",
         "action": "created",
-        "key": "knowledge/global/procurement-workflows.md"
+        "key": "wiki/global/procurement-workflows.md"
       },
       {
         "type": "candidate_action",
@@ -197,7 +197,7 @@
         "type": "work_unit_started",
         "unitKey": "support-and-health",
         "skills": [
-          "knowledge_capture",
+          "wiki_capture",
           "sl_capture"
         ],
         "stepBudget": 40
@@ -207,14 +207,14 @@
         "unitKey": "support-and-health",
         "target": "wiki",
         "action": "created",
-        "key": "knowledge/global/customer-health-scoring.md"
+        "key": "wiki/global/customer-health-scoring.md"
       },
       {
         "type": "candidate_action",
         "unitKey": "support-and-health",
         "target": "wiki",
         "action": "created",
-        "key": "knowledge/global/support-escalation.md"
+        "key": "wiki/global/support-escalation.md"
       },
       {
         "type": "candidate_action",
@@ -232,7 +232,7 @@
         "type": "work_unit_started",
         "unitKey": "governance-and-exclusions",
         "skills": [
-          "knowledge_capture"
+          "wiki_capture"
         ],
         "stepBudget": 40
       },
@@ -241,7 +241,7 @@
         "unitKey": "governance-and-exclusions",
         "target": "wiki",
         "action": "created",
-        "key": "knowledge/global/internal-test-exclusion.md"
+        "key": "wiki/global/internal-test-exclusion.md"
       },
       {
         "type": "work_unit_finished",
@@ -321,7 +321,7 @@
           "unitKey": "revenue-and-contracts",
           "target": "wiki",
           "action": "created",
-          "key": "knowledge/global/arr-contract-first.md",
+          "key": "wiki/global/arr-contract-first.md",
           "summary": "ARR follows contract precedence with cancellation and discount caveats.",
           "rawFiles": [
             "contracts",
@@ -334,7 +334,7 @@
           "unitKey": "revenue-and-contracts",
           "target": "wiki",
           "action": "created",
-          "key": "knowledge/global/revenue-gross-to-net.md",
+          "key": "wiki/global/revenue-gross-to-net.md",
           "summary": "Invoice, refund, and revenue dashboard evidence reconcile gross to net revenue.",
           "rawFiles": [
             "invoices",
@@ -346,7 +346,7 @@
           "unitKey": "revenue-and-contracts",
           "target": "wiki",
           "action": "created",
-          "key": "knowledge/global/discount-expiration.md",
+          "key": "wiki/global/discount-expiration.md",
           "summary": "Discount expiration is separated from organic contraction for retention reporting.",
           "rawFiles": [
             "contracts",
@@ -394,7 +394,7 @@
           "unitKey": "retention-and-segments",
           "target": "wiki",
           "action": "created",
-          "key": "knowledge/global/nrr-retention.md",
+          "key": "wiki/global/nrr-retention.md",
           "summary": "NRR uses parent-account rollups and quarterly ARR movement windows.",
           "rawFiles": [
             "accounts",
@@ -407,7 +407,7 @@
           "unitKey": "retention-and-segments",
           "target": "wiki",
           "action": "created",
-          "key": "knowledge/global/segment-classification.md",
+          "key": "wiki/global/segment-classification.md",
           "summary": "Segment labels come from plan mapping and sales-ops policy notes.",
           "rawFiles": [
             "accounts",
@@ -432,7 +432,7 @@
           "unitKey": "procurement-and-activation",
           "target": "wiki",
           "action": "created",
-          "key": "knowledge/global/activation-policy.md",
+          "key": "wiki/global/activation-policy.md",
           "summary": "Activation policy changed on January 15, 2026 and is encoded for agents.",
           "rawFiles": [
             "purchase_requests",
@@ -445,7 +445,7 @@
           "unitKey": "procurement-and-activation",
           "target": "wiki",
           "action": "created",
-          "key": "knowledge/global/procurement-workflows.md",
+          "key": "wiki/global/procurement-workflows.md",
           "summary": "Procurement requester activity and approval events explain product usage.",
           "rawFiles": [
             "purchase_requests",
@@ -468,7 +468,7 @@
           "unitKey": "support-and-health",
           "target": "wiki",
           "action": "created",
-          "key": "knowledge/global/customer-health-scoring.md",
+          "key": "wiki/global/customer-health-scoring.md",
           "summary": "Customer health combines support severity, ARR exposure, and product usage.",
           "rawFiles": [
             "support_tickets",
@@ -480,7 +480,7 @@
           "unitKey": "support-and-health",
           "target": "wiki",
           "action": "created",
-          "key": "knowledge/global/support-escalation.md",
+          "key": "wiki/global/support-escalation.md",
           "summary": "Escalation tiers map ticket severity to SLA expectations.",
           "rawFiles": [
             "support_tickets",
@@ -503,7 +503,7 @@
           "unitKey": "governance-and-exclusions",
           "target": "wiki",
           "action": "created",
-          "key": "knowledge/global/internal-test-exclusion.md",
+          "key": "wiki/global/internal-test-exclusion.md",
           "summary": "Canonical metrics exclude internal and test accounts across source families.",
           "rawFiles": [
             "raw-sources/notion/analyst-onboarding.md"
@@ -515,97 +515,97 @@
         {
           "rawPath": "contracts",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/arr-contract-first.md",
+          "artifactKey": "wiki/global/arr-contract-first.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "raw-sources/notion/arr-and-contract-reporting-notes.md",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/arr-contract-first.md",
+          "artifactKey": "wiki/global/arr-contract-first.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "invoices",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/revenue-gross-to-net.md",
+          "artifactKey": "wiki/global/revenue-gross-to-net.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "raw-sources/notion/revenue-reporting-policy.md",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/revenue-gross-to-net.md",
+          "artifactKey": "wiki/global/revenue-gross-to-net.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "arr_movements",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/discount-expiration.md",
+          "artifactKey": "wiki/global/discount-expiration.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "arr_movements",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/nrr-retention.md",
+          "artifactKey": "wiki/global/nrr-retention.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "raw-sources/notion/retention-and-nrr-definition-notes.md",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/nrr-retention.md",
+          "artifactKey": "wiki/global/nrr-retention.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "raw-sources/bi/account_retention.view.lkml",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/nrr-retention.md",
+          "artifactKey": "wiki/global/nrr-retention.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "plans",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/segment-classification.md",
+          "artifactKey": "wiki/global/segment-classification.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "raw-sources/notion/sales-ops-segmentation-guide.md",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/segment-classification.md",
+          "artifactKey": "wiki/global/segment-classification.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "raw-sources/notion/activation-policy-decision-record.md",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/activation-policy.md",
+          "artifactKey": "wiki/global/activation-policy.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "purchase_requests",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/procurement-workflows.md",
+          "artifactKey": "wiki/global/procurement-workflows.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "raw-sources/notion/customer-health-playbook.md",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/customer-health-scoring.md",
+          "artifactKey": "wiki/global/customer-health-scoring.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "support_tickets",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/customer-health-scoring.md",
+          "artifactKey": "wiki/global/customer-health-scoring.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "raw-sources/notion/support-escalation-runbook.md",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/support-escalation.md",
+          "artifactKey": "wiki/global/support-escalation.md",
           "actionType": "wiki_written"
         },
         {
           "rawPath": "raw-sources/notion/analyst-onboarding.md",
           "artifactKind": "wiki",
-          "artifactKey": "knowledge/global/internal-test-exclusion.md",
+          "artifactKey": "wiki/global/internal-test-exclusion.md",
           "actionType": "wiki_written"
         },
         {

package/assets/demo/orbit/semantic-layer/dbt-main/int_activation_policy_windows.yaml

@@ -0,0 +1,27 @@
+name: int_activation_policy_windows
+table: orbit_analytics.int_activation_policy_windows
+grain:
+  - policy_version
+columns:
+  - name: policy_version
+    type: string
+    descriptions:
+      user: pre_2026_01_15 or post_2026_01_15
+  - name: activated_account_count
+    type: number
+    descriptions:
+      ktx: Column activated account count from int_activation_policy_windows.
+  - name: window_start
+    type: time
+    descriptions:
+      ktx: Column window start from int_activation_policy_windows.
+  - name: window_end
+    type: time
+    descriptions:
+      ktx: Column window end from int_activation_policy_windows.
+joins: []
+measures:
+  - name: total_activated_accounts
+    expr: sum(activated_account_count)
+descriptions:
+  user: Activation cohort counts around the January 2026 policy change.

package/assets/demo/orbit/semantic-layer/dbt-main/int_active_contract_arr.yaml

@@ -0,0 +1,24 @@
+name: int_active_contract_arr
+table: orbit_analytics.int_active_contract_arr
+grain:
+  - contract_id
+columns:
+  - name: contract_id
+    type: string
+    descriptions:
+      user: "dbt: not_null, unique"
+  - name: account_id
+    type: string
+    descriptions:
+      ktx: Identifier for the related account on int_active_contract_arr.
+  - name: arr_cents
+    type: number
+    descriptions:
+      ktx: Column arr cents from int_active_contract_arr.
+joins: []
+measures:
+  - name: total_arr_cents
+    expr: sum(arr_cents)
+    description: Total active contract ARR in cents as of 2026-03-31.
+descriptions:
+  user: Active contract ARR as of 2026-03-31.

package/assets/demo/orbit/semantic-layer/dbt-main/int_customer_health_signals.yaml

@@ -0,0 +1,25 @@
+name: int_customer_health_signals
+table: orbit_analytics.int_customer_health_signals
+grain:
+  - account_id
+columns:
+  - name: account_id
+    type: string
+    descriptions:
+      ktx: Identifier for the related account on int_customer_health_signals.
+  - name: open_critical_ticket_count
+    type: number
+    descriptions:
+      ktx: Column open critical ticket count from int_customer_health_signals.
+  - name: recent_procurement_action_count
+    type: number
+    descriptions:
+      ktx: Column recent procurement action count from int_customer_health_signals.
+  - name: risk_level
+    type: string
+    descriptions:
+      user: "Derived risk level: low, medium, high"
+joins: []
+measures: []
+descriptions:
+  user: Support-ticket and recent-procurement signals for customer health risk.

package/assets/demo/orbit/semantic-layer/dbt-main/int_parent_account_arr_movements.yaml

@@ -0,0 +1,49 @@
+name: int_parent_account_arr_movements
+table: orbit_analytics.int_parent_account_arr_movements
+grain:
+  - arr_movement_id
+columns:
+  - name: arr_movement_id
+    type: string
+    descriptions:
+      user: "dbt: not_null, unique"
+  - name: parent_account_id
+    type: string
+    descriptions:
+      ktx: Identifier for the related parent account on int_parent_account_arr_movements.
+  - name: movement_type
+    type: string
+    descriptions:
+      user: "dbt: accepted_values [new, expansion, contraction, churn, reactivation]"
+  - name: is_discount_expiration_contraction
+    type: boolean
+    descriptions:
+      user: Discount expiration contraction flag used to keep discount movement separate from churn.
+  - name: movement_date
+    type: time
+    descriptions:
+      ktx: Date or time value for movement date on int_parent_account_arr_movements.
+  - name: arr_cents
+    type: number
+    descriptions:
+      ktx: Column arr cents from int_parent_account_arr_movements.
+joins: []
+measures:
+  - name: expansion_arr_cents
+    expr: sum(arr_cents)
+    filter: movement_type = 'expansion'
+    description: Sum of expansion ARR movements in cents.
+  - name: contraction_arr_cents
+    expr: sum(arr_cents)
+    filter: movement_type = 'contraction'
+    description: Sum of contraction ARR movements in cents.
+  - name: churn_arr_cents
+    expr: sum(arr_cents)
+    filter: movement_type = 'churn'
+    description: Sum of churn ARR movements in cents.
+  - name: discount_expiration_contraction_arr_cents
+    expr: sum(arr_cents)
+    filter: is_discount_expiration_contraction = true
+    description: Contraction ARR from discount expirations — kept separate from churn in NRR calculation.
+descriptions:
+  user: Parent-account movement rollups for retention metrics.

package/assets/demo/orbit/semantic-layer/dbt-main/int_procurement_qualifying_actions.yaml

@@ -0,0 +1,27 @@
+name: int_procurement_qualifying_actions
+table: orbit_analytics.int_procurement_qualifying_actions
+grain:
+  - purchase_request_id
+columns:
+  - name: purchase_request_id
+    type: string
+    descriptions:
+      ktx: Identifier for the related purchase request on int_procurement_qualifying_actions.
+  - name: account_id
+    type: string
+    descriptions:
+      ktx: Identifier for the related account on int_procurement_qualifying_actions.
+  - name: requester_user_id
+    type: string
+    descriptions:
+      ktx: Identifier for the related requester user on int_procurement_qualifying_actions.
+  - name: action_week
+    type: time
+    descriptions:
+      ktx: Column action week from int_procurement_qualifying_actions.
+joins: []
+measures:
+  - name: qualifying_action_count
+    expr: count(purchase_request_id)
+descriptions:
+  user: Non-internal, non-test requester activity for large active contracts in the golden week.