owlrunkit 0.20.0 → 0.22.0

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 (50) hide show
  1. package/CHANGELOG.md +88 -0
  2. package/README.md +102 -10
  3. package/docs/architecture/OWLCODA_RUNKIT_0201_RELEASE_TRUTH_AND_PROFILE_NORMALIZATION_PATCH_DECISION_20260813.md +95 -0
  4. package/docs/architecture/OWLCODA_RUNKIT_021_TEAM_DELIVERY_PHASE2_PRODUCT_DECISION_20260813.md +249 -0
  5. package/integrations/codex/skills/owlcoda-runkit/SKILL.md +117 -12
  6. package/integrations/codex/skills/owlcoda-runkit/assets/templates/config.json +3 -3
  7. package/package.json +1 -1
  8. package/packages/attest/README.md +7 -1
  9. package/packages/attest/consumer-surface-v3.json +275 -0
  10. package/packages/attest/distribution-manifest-v1.json +24 -0
  11. package/packages/attest/schemas/canonical-candidate-identity-v1.schema.json +112 -0
  12. package/packages/attest/schemas/foreign-workspace-filesystem-identity-v1.schema.json +32 -0
  13. package/packages/attest/schemas/quick-verification-receipt-v4.schema.json +226 -0
  14. package/packages/attest/src/candidate-identity.mjs +454 -0
  15. package/packages/attest/src/index.mjs +11 -0
  16. package/packages/attest/src/quick-receipt-contract.mjs +126 -5
  17. package/packages/attest/src/quick.mjs +53 -8
  18. package/{registry-release-policy-v1.json → registry-release-policy-v2.json} +8 -9
  19. package/sbom.spdx.json +4 -4
  20. package/scripts/runkit-contract/core-contract.mjs +19 -1
  21. package/scripts/runkit-contract/fleet-skill-plan.mjs +223 -0
  22. package/scripts/runkit-contract/formal-workflow.mjs +3 -1
  23. package/scripts/runkit-contract/hook-recovery.mjs +496 -0
  24. package/scripts/runkit-contract/inspect-presentation.mjs +187 -0
  25. package/scripts/runkit-contract/install-codex-skill.mjs +1 -0
  26. package/scripts/runkit-contract/onboarding-bootstrap.mjs +15 -0
  27. package/scripts/runkit-contract/onboarding-doctor.mjs +378 -9
  28. package/scripts/runkit-contract/profile-onboarding.mjs +6 -0
  29. package/scripts/runkit-contract/project-cli-resolver.mjs +17 -1
  30. package/scripts/runkit-contract/quick-metrics.mjs +9 -5
  31. package/scripts/runkit-contract/quick-verify.mjs +108 -24
  32. package/scripts/runkit-contract/registry-adoption-gate.mjs +12 -3
  33. package/scripts/runkit-contract/registry-adoption.mjs +10 -5
  34. package/scripts/runkit-contract/runkit-bootstrap.mjs +1 -0
  35. package/scripts/runkit-contract/runkit-cli.mjs +332 -30
  36. package/scripts/runkit-contract/schemas/delivery-lifecycle-v1.schema.json +91 -0
  37. package/scripts/runkit-contract/schemas/external-gate-v1.schema.json +68 -0
  38. package/scripts/runkit-contract/schemas/fleet-skill-upgrade-plan-v1.schema.json +140 -0
  39. package/scripts/runkit-contract/schemas/hook-recovery-v1.schema.json +592 -0
  40. package/scripts/runkit-contract/schemas/inspect-compact-v1.schema.json +93 -0
  41. package/scripts/runkit-contract/schemas/inspect-compact-v2.schema.json +122 -0
  42. package/scripts/runkit-contract/schemas/team-delivery-status-v2.schema.json +219 -0
  43. package/scripts/runkit-contract/schemas/team-delivery-status-v3.schema.json +113 -0
  44. package/scripts/runkit-contract/schemas/team-project-event-v6.schema.json +82 -0
  45. package/scripts/runkit-contract/schemas/team-project-event-v7.schema.json +80 -0
  46. package/scripts/runkit-contract/schemas/team-project-status-v4.schema.json +208 -0
  47. package/scripts/runkit-contract/schemas/team-recommendation-v2.schema.json +120 -0
  48. package/scripts/runkit-contract/sync-release-identity.mjs +87 -0
  49. package/scripts/runkit-contract/team-delivery.mjs +203 -3
  50. package/scripts/runkit-contract/team-project.mjs +1032 -11
@@ -0,0 +1,32 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://owlcoda.dev/schemas/runkit/trust/foreign-workspace-filesystem-identity-v1.schema.json",
4
+ "title": "OwlCoda RunKit Foreign Workspace Filesystem Identity V1",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": [
8
+ "schemaVersion",
9
+ "manifestAlgorithmId",
10
+ "workspaceRoot",
11
+ "excludedRoots",
12
+ "entryCount",
13
+ "totalFileBytes",
14
+ "ledgerByteLength",
15
+ "ledgerSha256",
16
+ "filesystemFingerprint"
17
+ ],
18
+ "properties": {
19
+ "schemaVersion": { "const": "OwlCodaRunKitForeignWorkspaceFilesystemIdentityV1" },
20
+ "manifestAlgorithmId": { "const": "owlcoda-foreign-workspace-ledger-v1" },
21
+ "workspaceRoot": { "type": "string", "minLength": 1 },
22
+ "excludedRoots": { "const": [".git"] },
23
+ "entryCount": { "type": "integer", "minimum": 0 },
24
+ "totalFileBytes": { "type": "integer", "minimum": 0 },
25
+ "ledgerByteLength": { "type": "integer", "minimum": 2 },
26
+ "ledgerSha256": { "$ref": "#/$defs/hash" },
27
+ "filesystemFingerprint": { "$ref": "#/$defs/hash" }
28
+ },
29
+ "$defs": {
30
+ "hash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
31
+ }
32
+ }
@@ -0,0 +1,226 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://owlcoda.dev/schemas/runkit/trust/quick-verification-receipt-v4.schema.json",
4
+ "title": "OwlCoda Quick Verification Receipt V4",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": [
8
+ "schemaVersion",
9
+ "receiptId",
10
+ "assurance",
11
+ "authorizationGranted",
12
+ "coreIdentity",
13
+ "controllerWorkspaceRoot",
14
+ "workspaceBefore",
15
+ "sourceWorkspaceRoot",
16
+ "exactCommand",
17
+ "executionIsolation",
18
+ "mutationClasses",
19
+ "foreignWorkspace",
20
+ "verificationContext",
21
+ "startedAt",
22
+ "finishedAt",
23
+ "exitResult",
24
+ "outputArtifacts",
25
+ "workspaceAfter",
26
+ "mutationDecision",
27
+ "issueCodes"
28
+ ],
29
+ "properties": {
30
+ "schemaVersion": { "const": "OwlCodaQuickVerificationReceiptV4" },
31
+ "receiptId": { "type": "string", "minLength": 1 },
32
+ "assurance": { "const": "captured_verification" },
33
+ "authorizationGranted": { "const": false },
34
+ "coreIdentity": {
35
+ "type": "object",
36
+ "additionalProperties": false,
37
+ "required": ["contractVersion", "coreVersion", "coreManifestSha256"],
38
+ "properties": {
39
+ "contractVersion": { "type": "string", "minLength": 1 },
40
+ "coreVersion": { "type": "string", "minLength": 1 },
41
+ "coreManifestSha256": { "$ref": "#/$defs/hash" }
42
+ }
43
+ },
44
+ "controllerWorkspaceRoot": { "type": "string", "minLength": 1 },
45
+ "workspaceBefore": {
46
+ "$ref": "quick-verification-receipt-v3.schema.json#/$defs/workspaceSnapshot"
47
+ },
48
+ "sourceWorkspaceRoot": { "type": "string", "minLength": 1 },
49
+ "exactCommand": {
50
+ "type": "object",
51
+ "additionalProperties": false,
52
+ "required": ["executable", "argv", "cwd"],
53
+ "properties": {
54
+ "executable": { "type": "string", "minLength": 1 },
55
+ "argv": { "type": "array", "items": { "type": "string" } },
56
+ "cwd": { "type": "string", "minLength": 1 }
57
+ }
58
+ },
59
+ "inputArtifacts": {
60
+ "type": "object",
61
+ "additionalProperties": false,
62
+ "required": ["stdin"],
63
+ "properties": {
64
+ "stdin": { "$ref": "quick-verification-receipt-v3.schema.json#/$defs/materialArtifact" }
65
+ }
66
+ },
67
+ "executionIsolation": {
68
+ "type": "object",
69
+ "additionalProperties": false,
70
+ "required": [
71
+ "schemaVersion",
72
+ "mode",
73
+ "consumerRoot",
74
+ "sourceCopy",
75
+ "cacheEnvironmentVariables",
76
+ "dependencyEnvironment",
77
+ "dependencyEnvironmentAfter",
78
+ "consumerDelta",
79
+ "cleanupStatus"
80
+ ],
81
+ "properties": {
82
+ "schemaVersion": { "const": "OwlCodaRunKitQuickIsolationV1" },
83
+ "mode": { "const": "temporary_consumer" },
84
+ "consumerRoot": { "type": "string", "minLength": 1 },
85
+ "sourceCopy": {
86
+ "type": "object",
87
+ "additionalProperties": false,
88
+ "required": ["fileCount", "totalBytes", "fingerprint"],
89
+ "properties": {
90
+ "fileCount": { "type": "integer", "minimum": 0 },
91
+ "totalBytes": { "type": "integer", "minimum": 0 },
92
+ "fingerprint": { "$ref": "#/$defs/hash" }
93
+ }
94
+ },
95
+ "cacheEnvironmentVariables": {
96
+ "type": "array",
97
+ "minItems": 1,
98
+ "uniqueItems": true,
99
+ "items": { "type": "string", "minLength": 1 }
100
+ },
101
+ "dependencyEnvironment": {
102
+ "oneOf": [
103
+ { "type": "null" },
104
+ { "$ref": "quick-verification-receipt-v3.schema.json#/$defs/dependencyEnvironment" }
105
+ ]
106
+ },
107
+ "dependencyEnvironmentAfter": {
108
+ "oneOf": [
109
+ { "type": "null" },
110
+ { "$ref": "quick-verification-receipt-v3.schema.json#/$defs/dependencyEnvironment" }
111
+ ]
112
+ },
113
+ "consumerDelta": {
114
+ "type": "object",
115
+ "additionalProperties": false,
116
+ "required": ["sourcePaths", "ignoredPaths"],
117
+ "properties": {
118
+ "sourcePaths": { "$ref": "quick-verification-receipt-v3.schema.json#/$defs/paths" },
119
+ "ignoredPaths": { "$ref": "quick-verification-receipt-v3.schema.json#/$defs/paths" }
120
+ }
121
+ },
122
+ "cleanupStatus": { "enum": ["removed", "cleanup_failed"] }
123
+ }
124
+ },
125
+ "mutationClasses": {
126
+ "type": "object",
127
+ "additionalProperties": false,
128
+ "required": [
129
+ "workspaceSource",
130
+ "boundIgnoredPaths",
131
+ "dependencyEnvironment",
132
+ "consumerSource",
133
+ "consumerIgnoredArtifacts",
134
+ "foreignTarget"
135
+ ],
136
+ "properties": {
137
+ "workspaceSource": { "enum": ["unchanged", "changed"] },
138
+ "boundIgnoredPaths": { "enum": ["not_bound", "unchanged", "changed"] },
139
+ "dependencyEnvironment": { "enum": ["not_bound", "unchanged", "changed"] },
140
+ "consumerSource": { "enum": ["unchanged", "changed"] },
141
+ "consumerIgnoredArtifacts": { "enum": ["none", "changed_and_discarded"] },
142
+ "foreignTarget": { "enum": ["unchanged", "changed"] }
143
+ }
144
+ },
145
+ "foreignWorkspace": {
146
+ "type": "object",
147
+ "additionalProperties": false,
148
+ "required": [
149
+ "candidateBefore",
150
+ "candidateAfter",
151
+ "filesystemBefore",
152
+ "filesystemAfter",
153
+ "zeroWriteObserved"
154
+ ],
155
+ "properties": {
156
+ "candidateBefore": { "$ref": "canonical-candidate-identity-v1.schema.json" },
157
+ "candidateAfter": { "$ref": "canonical-candidate-identity-v1.schema.json" },
158
+ "filesystemBefore": { "$ref": "foreign-workspace-filesystem-identity-v1.schema.json" },
159
+ "filesystemAfter": { "$ref": "foreign-workspace-filesystem-identity-v1.schema.json" },
160
+ "zeroWriteObserved": { "type": "boolean" }
161
+ }
162
+ },
163
+ "verificationContext": {
164
+ "type": "object",
165
+ "additionalProperties": false,
166
+ "required": ["platform", "architecture", "runtime"],
167
+ "properties": {
168
+ "platform": { "type": "string", "minLength": 1 },
169
+ "architecture": { "type": "string", "minLength": 1 },
170
+ "runtime": { "type": "string", "minLength": 1 }
171
+ }
172
+ },
173
+ "startedAt": { "type": "string", "format": "date-time" },
174
+ "finishedAt": { "type": "string", "format": "date-time" },
175
+ "exitResult": {
176
+ "type": "object",
177
+ "additionalProperties": false,
178
+ "required": ["exitCode", "signal"],
179
+ "properties": {
180
+ "exitCode": { "type": ["integer", "null"] },
181
+ "signal": { "type": ["string", "null"] }
182
+ }
183
+ },
184
+ "outputArtifacts": {
185
+ "type": "object",
186
+ "additionalProperties": false,
187
+ "required": ["stdout", "stderr"],
188
+ "properties": {
189
+ "stdout": { "$ref": "quick-verification-receipt-v3.schema.json#/$defs/materialArtifact" },
190
+ "stderr": { "$ref": "quick-verification-receipt-v3.schema.json#/$defs/materialArtifact" }
191
+ }
192
+ },
193
+ "workspaceAfter": {
194
+ "$ref": "quick-verification-receipt-v3.schema.json#/$defs/workspaceSnapshot"
195
+ },
196
+ "mutationDecision": {
197
+ "enum": [
198
+ "source_unchanged",
199
+ "invalidated_by_command_source_mutation",
200
+ "invalidated_by_bound_ignored_mutation",
201
+ "invalidated_by_dependency_environment_mutation",
202
+ "invalidated_by_consumer_source_mutation",
203
+ "invalidated_by_isolation_cleanup_failure",
204
+ "invalidated_by_foreign_workspace_mutation",
205
+ "invalidated_by_multiple_mutations"
206
+ ]
207
+ },
208
+ "issueCodes": {
209
+ "type": "array",
210
+ "uniqueItems": true,
211
+ "items": { "type": "string", "minLength": 1 }
212
+ },
213
+ "signatureRef": {
214
+ "type": "object",
215
+ "additionalProperties": false,
216
+ "required": ["path", "sha256"],
217
+ "properties": {
218
+ "path": { "type": "string", "minLength": 1 },
219
+ "sha256": { "$ref": "#/$defs/hash" }
220
+ }
221
+ }
222
+ },
223
+ "$defs": {
224
+ "hash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
225
+ }
226
+ }