@a5c-ai/krate 5.0.1-staging.f672fe79b

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (174) hide show
  1. package/Dockerfile +29 -0
  2. package/README.md +183 -0
  3. package/bin/krate-demo.mjs +23 -0
  4. package/bin/krate-server.mjs +14 -0
  5. package/dist/krate-controller-ui.json +2407 -0
  6. package/dist/krate-lifecycle.json +201 -0
  7. package/dist/krate-runtime-snapshot.json +2955 -0
  8. package/dist/krate-summary.json +687 -0
  9. package/docs/README.md +61 -0
  10. package/docs/agents/README.md +83 -0
  11. package/docs/agents/acceptance-test-matrix.md +193 -0
  12. package/docs/agents/agent-mux-adapter-contract.md +167 -0
  13. package/docs/agents/agent-mux-source-map.md +310 -0
  14. package/docs/agents/agent-run-memory-import-spec.md +256 -0
  15. package/docs/agents/agent-stack-management-spec.md +421 -0
  16. package/docs/agents/api-contract-spec.md +309 -0
  17. package/docs/agents/artifacts-writeback-spec.md +145 -0
  18. package/docs/agents/chart-packaging-spec.md +128 -0
  19. package/docs/agents/ci-orchestration-spec.md +140 -0
  20. package/docs/agents/context-assembly-spec.md +219 -0
  21. package/docs/agents/controller-reconciliation-spec.md +255 -0
  22. package/docs/agents/crd-schema-spec.md +315 -0
  23. package/docs/agents/decision-log-open-questions.md +169 -0
  24. package/docs/agents/developer-implementation-checklist.md +329 -0
  25. package/docs/agents/dispatching-design.md +262 -0
  26. package/docs/agents/glossary.md +66 -0
  27. package/docs/agents/implementation-blueprint.md +324 -0
  28. package/docs/agents/implementation-rollout-slices.md +251 -0
  29. package/docs/agents/memory-context-integration-spec.md +194 -0
  30. package/docs/agents/memory-ontology-schema-spec.md +253 -0
  31. package/docs/agents/memory-operations-runbook.md +121 -0
  32. package/docs/agents/mvp-vertical-slice-spec.md +146 -0
  33. package/docs/agents/observability-audit-spec.md +265 -0
  34. package/docs/agents/operator-runbook.md +174 -0
  35. package/docs/agents/org-memory-api-payload-examples.md +333 -0
  36. package/docs/agents/org-memory-controller-sequence-spec.md +181 -0
  37. package/docs/agents/org-memory-e2e-fixture-plan.md +161 -0
  38. package/docs/agents/org-memory-ui-implementation-map.md +114 -0
  39. package/docs/agents/org-memory-vertical-slice-spec.md +168 -0
  40. package/docs/agents/org-resource-model-delta-spec.md +111 -0
  41. package/docs/agents/org-route-resource-model-spec.md +183 -0
  42. package/docs/agents/org-scoping-namespace-spec.md +114 -0
  43. package/docs/agents/rbac-secrets-management-spec.md +406 -0
  44. package/docs/agents/repository-page-integration-spec.md +255 -0
  45. package/docs/agents/resource-contract-examples.md +808 -0
  46. package/docs/agents/resource-relationship-map.md +190 -0
  47. package/docs/agents/security-threat-model.md +188 -0
  48. package/docs/agents/shared-memory-company-brain-spec.md +358 -0
  49. package/docs/agents/storage-migration-spec.md +168 -0
  50. package/docs/agents/subagent-orchestration-spec.md +152 -0
  51. package/docs/agents/system-overview.md +88 -0
  52. package/docs/agents/tools-mcp-skills-spec.md +189 -0
  53. package/docs/agents/traceability-matrix.md +79 -0
  54. package/docs/agents/ui-flow-spec.md +211 -0
  55. package/docs/agents/ui-ux-system-spec.md +426 -0
  56. package/docs/agents/workspace-lifecycle-spec.md +166 -0
  57. package/docs/architecture-spec.md +78 -0
  58. package/docs/components/control-plane.md +78 -0
  59. package/docs/components/data-plane.md +69 -0
  60. package/docs/components/hooks-events.md +67 -0
  61. package/docs/components/identity-rbac-policy.md +73 -0
  62. package/docs/components/kubevela-oam.md +70 -0
  63. package/docs/components/operations-publishing.md +81 -0
  64. package/docs/components/runners-ci.md +66 -0
  65. package/docs/components/web-ui.md +94 -0
  66. package/docs/external/README.md +47 -0
  67. package/docs/external/bidirectional-sync-design.md +134 -0
  68. package/docs/external/cicd-interface.md +64 -0
  69. package/docs/external/external-backend-controllers.md +170 -0
  70. package/docs/external/external-backend-crds.md +234 -0
  71. package/docs/external/external-backend-ui-spec.md +151 -0
  72. package/docs/external/external-backend-ux-flows.md +115 -0
  73. package/docs/external/external-object-mapping.md +125 -0
  74. package/docs/external/git-forge-interface.md +68 -0
  75. package/docs/external/github-integration-design.md +151 -0
  76. package/docs/external/issue-tracking-interface.md +66 -0
  77. package/docs/external/provider-capability-manifests.md +204 -0
  78. package/docs/external/provider-catalog.md +139 -0
  79. package/docs/external/provider-rollout-testing.md +78 -0
  80. package/docs/external/research-results.md +48 -0
  81. package/docs/external/security-auth-permissions.md +81 -0
  82. package/docs/external/sync-state-machines.md +108 -0
  83. package/docs/external/unified-external-backend-model.md +107 -0
  84. package/docs/external/user-facing-changes.md +67 -0
  85. package/docs/gaps.md +161 -0
  86. package/docs/install.md +94 -0
  87. package/docs/krate-design.md +334 -0
  88. package/docs/local-minikube.md +55 -0
  89. package/docs/ontology/README.md +32 -0
  90. package/docs/ontology/bounded-contexts.md +29 -0
  91. package/docs/ontology/events-and-hooks.md +32 -0
  92. package/docs/ontology/oam-kubevela.md +32 -0
  93. package/docs/ontology/operations-and-release.md +25 -0
  94. package/docs/ontology/personas-and-actors.md +32 -0
  95. package/docs/ontology/policies-and-invariants.md +33 -0
  96. package/docs/ontology/problem-space.md +30 -0
  97. package/docs/ontology/resource-contracts.md +40 -0
  98. package/docs/ontology/resource-taxonomy.md +42 -0
  99. package/docs/ontology/runners-and-ci.md +29 -0
  100. package/docs/ontology/solution-space.md +24 -0
  101. package/docs/ontology/storage-and-data-boundaries.md +29 -0
  102. package/docs/ontology/validation-matrix.md +24 -0
  103. package/docs/ontology/web-ui-excellent-flows.md +32 -0
  104. package/docs/ontology/workflows.md +39 -0
  105. package/docs/ontology/world.md +35 -0
  106. package/docs/product-requirements.md +62 -0
  107. package/docs/roadmap-mvp.md +87 -0
  108. package/docs/system-requirements.md +90 -0
  109. package/docs/tests/README.md +53 -0
  110. package/docs/tests/agent-qa-plan.md +63 -0
  111. package/docs/tests/browser-ui-tests.md +62 -0
  112. package/docs/tests/ci-quality-gates.md +48 -0
  113. package/docs/tests/coverage-model.md +64 -0
  114. package/docs/tests/e2e-scenario-tests.md +53 -0
  115. package/docs/tests/fixtures-test-data.md +63 -0
  116. package/docs/tests/observability-reliability-tests.md +54 -0
  117. package/docs/tests/product-test-matrix.md +145 -0
  118. package/docs/tests/qa-adoption-roadmap.md +130 -0
  119. package/docs/tests/qa-automation-plan.md +101 -0
  120. package/docs/tests/security-compliance-tests.md +57 -0
  121. package/docs/tests/test-framework-tools.md +88 -0
  122. package/docs/tests/test-suite-layout.md +121 -0
  123. package/docs/tests/unit-integration-tests.md +48 -0
  124. package/docs/todo-kyverno +714 -0
  125. package/docs/user-stories.md +78 -0
  126. package/examples/minikube-demo.yaml +190 -0
  127. package/examples/oam-application.yaml +23 -0
  128. package/examples/policy-kyverno-pr-title.yaml +18 -0
  129. package/package.json +63 -0
  130. package/scripts/build.mjs +29 -0
  131. package/scripts/setup-minikube.mjs +65 -0
  132. package/scripts/smoke.mjs +37 -0
  133. package/scripts/validate-doc-coverage.mjs +152 -0
  134. package/scripts/validate-package.mjs +93 -0
  135. package/scripts/validate-ui.mjs +207 -0
  136. package/src/agent-approval-controller.js +123 -0
  137. package/src/agent-context-bundles.js +242 -0
  138. package/src/agent-dispatch-controller.js +86 -0
  139. package/src/agent-mux-client.js +280 -0
  140. package/src/agent-permission-review.js +162 -0
  141. package/src/agent-stack-controller.js +296 -0
  142. package/src/agent-trigger-controller.js +108 -0
  143. package/src/api-controller.js +206 -0
  144. package/src/argocd-gitops.js +43 -0
  145. package/src/auth.js +265 -0
  146. package/src/component-catalog.js +41 -0
  147. package/src/control-plane.js +136 -0
  148. package/src/controller-client.js +38 -0
  149. package/src/controller-ui.js +538 -0
  150. package/src/data-plane.js +178 -0
  151. package/src/gitea-backend.js +95 -0
  152. package/src/handoff.js +98 -0
  153. package/src/hooks-events.js +63 -0
  154. package/src/http-server.js +151 -0
  155. package/src/identity-policy.js +86 -0
  156. package/src/index.js +30 -0
  157. package/src/kubernetes-controller.js +812 -0
  158. package/src/kubernetes-resource-gateway.js +48 -0
  159. package/src/operations.js +112 -0
  160. package/src/resource-model.js +203 -0
  161. package/src/runners-ci.js +48 -0
  162. package/src/runtime.js +196 -0
  163. package/src/web-ui.js +40 -0
  164. package/tests/agent-approval-controller.test.js +173 -0
  165. package/tests/agent-context-bundles.test.js +278 -0
  166. package/tests/agent-dispatch-controller.test.js +176 -0
  167. package/tests/agent-mux-client.test.js +204 -0
  168. package/tests/agent-permission-review.test.js +209 -0
  169. package/tests/agent-resources.test.js +212 -0
  170. package/tests/agent-stack-controller.test.js +221 -0
  171. package/tests/agent-trigger-controller.test.js +211 -0
  172. package/tests/deployment.test.js +395 -0
  173. package/tests/e2e/lifecycle.test.js +117 -0
  174. package/tests/krate.test.js +727 -0
@@ -0,0 +1,86 @@
1
+ import { clone } from './resource-model.js';
2
+
3
+ export function mapOidcIdentity({ subject, email, groups = [] }) {
4
+ if (!subject && !email) throw new Error('OIDC identity requires subject or email');
5
+ const name = email || subject;
6
+ return { name, uid: subject || email, groups: [...new Set(['system:authenticated', ...groups])], extra: { email } };
7
+ }
8
+
9
+ export class RbacAuthorizer {
10
+ constructor(bindings = []) { this.bindings = bindings; }
11
+ allow(subject, rule) { this.bindings.push({ subject, rule }); return this; }
12
+ can(user, verb, kind, namespace = 'default') {
13
+ const subjects = new Set([user?.name, ...(user?.groups || [])]);
14
+ return this.bindings.some(({ subject, rule }) => {
15
+ if (!subjects.has(subject)) return false;
16
+ if (rule.namespace && rule.namespace !== namespace) return false;
17
+ const verbs = new Set(rule.verbs || []);
18
+ const kinds = new Set(rule.kinds || []);
19
+ return (verbs.has('*') || verbs.has(verb)) && (kinds.has('*') || kinds.has(kind));
20
+ });
21
+ }
22
+ }
23
+
24
+ export function defaultAuthorizer() {
25
+ return new RbacAuthorizer()
26
+ .allow('system:authenticated', { verbs: ['get', 'list', 'watch'], kinds: ['*'] })
27
+ .allow('krate:developers', { verbs: ['create', 'update'], kinds: ['PullRequest', 'Issue', 'Review', 'Pipeline', 'Job'] })
28
+ .allow('krate:repo-admins', { verbs: ['create', 'update', 'delete'], kinds: ['Organization', 'User', 'Team', 'Invite', 'IdentityMapping', 'AuthProvider', 'Repository', 'SSHKey', 'RepositoryPermission', 'BranchProtection', 'RefPolicy', 'WebhookSubscription', 'WebhookDelivery', 'View', 'Selector', 'PullRequest', 'Issue', 'Review', 'Pipeline', 'Job'] })
29
+ .allow('krate:platform-engineers', { verbs: ['*'], kinds: ['*'] });
30
+ }
31
+
32
+ export function createAdmissionPolicy({ name, mode = 'enforce', match, validate, message }) {
33
+ if (!name) throw new Error('admission policy requires name');
34
+ if (!['audit', 'enforce'].includes(mode)) throw new Error('mode must be audit or enforce');
35
+ return { name, mode, match, validate, message };
36
+ }
37
+
38
+ export function evaluateAdmission(policies, request) {
39
+ const warnings = [];
40
+ const violations = [];
41
+ for (const policy of policies) {
42
+ if (policy.match && !policy.match(request)) continue;
43
+ const valid = policy.validate ? policy.validate(request) : true;
44
+ if (valid) continue;
45
+ const entry = { policy: policy.name, mode: policy.mode, message: policy.message || `admission policy ${policy.name} rejected request` };
46
+ if (policy.mode === 'audit') warnings.push(entry); else violations.push(entry);
47
+ }
48
+ return { allowed: violations.length === 0, warnings, violations };
49
+ }
50
+
51
+ export function serviceAccountForJob({ namespace = 'default', repository, pipeline, trustTier = 'trusted' }) {
52
+ return {
53
+ name: `krate-job-${pipeline}`,
54
+ namespace,
55
+ groups: ['system:serviceaccounts', `system:serviceaccounts:${namespace}`, 'krate:ci-jobs'],
56
+ trustTier,
57
+ scopes: trustTier === 'untrusted'
58
+ ? { repository, pipeline, secrets: false, clusterApi: false }
59
+ : { repository, pipeline, secrets: true, clusterApi: 'scoped' }
60
+ };
61
+ }
62
+
63
+ function scalarToYaml(value) {
64
+ if (value === null || value === undefined) return 'null';
65
+ if (typeof value === 'number' || typeof value === 'boolean') return String(value);
66
+ if (typeof value === 'string' && /^[a-zA-Z0-9_.:/-]+$/.test(value)) return value;
67
+ return JSON.stringify(value);
68
+ }
69
+
70
+ export function toResourceYaml(value, indent = 0) {
71
+ const spaces = ' '.repeat(indent);
72
+ if (Array.isArray(value)) {
73
+ if (value.length === 0) return '[]';
74
+ return value.map((item) => item && typeof item === 'object'
75
+ ? `${spaces}- ${toResourceYaml(item, indent + 2).trimStart()}`
76
+ : `${spaces}- ${scalarToYaml(item)}`).join('\n');
77
+ }
78
+ if (value && typeof value === 'object') {
79
+ return Object.entries(clone(value)).map(([key, child]) => {
80
+ if (child && typeof child === 'object') return `${spaces}${key}:\n${toResourceYaml(child, indent + 2)}`;
81
+ return `${spaces}${key}: ${scalarToYaml(child)}`;
82
+ }).join('\n');
83
+ }
84
+ return `${spaces}${scalarToYaml(value)}`;
85
+ }
86
+
package/src/index.js ADDED
@@ -0,0 +1,30 @@
1
+ export * from './resource-model.js';
2
+ export * from './identity-policy.js';
3
+ export * from './auth.js';
4
+ export * from './control-plane.js';
5
+ export * from './data-plane.js';
6
+ export * from './runners-ci.js';
7
+ export * from './hooks-events.js';
8
+ export * from './web-ui.js';
9
+ export * from './operations.js';
10
+ export * from './component-catalog.js';
11
+
12
+ export * from './handoff.js';
13
+
14
+
15
+ export * from './runtime.js';
16
+ export * from './http-server.js';
17
+ export * from './controller-ui.js';
18
+ export * from './controller-client.js';
19
+ export * from './api-controller.js';
20
+ export * from './kubernetes-controller.js';
21
+ export * from './kubernetes-resource-gateway.js';
22
+ export * from './gitea-backend.js';
23
+ export * from './argocd-gitops.js';
24
+ export * from './agent-permission-review.js';
25
+ export * from './agent-stack-controller.js';
26
+ export * from './agent-context-bundles.js';
27
+ export * from './agent-mux-client.js';
28
+ export * from './agent-dispatch-controller.js';
29
+ export * from './agent-approval-controller.js';
30
+ export * from './agent-trigger-controller.js';