owlrunkit 0.18.3 → 0.18.4

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 (29) hide show
  1. package/CHANGELOG.md +42 -0
  2. package/README.md +125 -52
  3. package/docs/architecture/OWLCODA_RUNKIT_0184_EXTERNAL_DELIVERY_INTAKE_PRODUCT_DECISION_20260812.md +209 -0
  4. package/docs/architecture/OWLCODA_RUNKIT_USAGE_MODE_SELECTION_PRODUCT_DECISION_20260811.md +8 -7
  5. package/integrations/codex/skills/owlcoda-runkit/SKILL.md +109 -77
  6. package/integrations/codex/skills/owlcoda-runkit/assets/templates/config.json +3 -3
  7. package/package.json +1 -1
  8. package/packages/attest/distribution-manifest-v1.json +5 -0
  9. package/packages/attest/src/quick-receipt-contract.mjs +3 -3
  10. package/packages/attest/src/quick.mjs +5 -0
  11. package/packages/attest/src/workspace-snapshot.mjs +10 -1
  12. package/registry-release-policy-v1.json +5 -5
  13. package/sbom.spdx.json +5 -5
  14. package/scripts/runkit-contract/assurance-router.mjs +25 -6
  15. package/scripts/runkit-contract/core-contract.mjs +9 -1
  16. package/scripts/runkit-contract/onboarding-doctor.mjs +1 -1
  17. package/scripts/runkit-contract/profile-onboarding.mjs +263 -15
  18. package/scripts/runkit-contract/project-cli-resolver.mjs +6 -0
  19. package/scripts/runkit-contract/project-external-delivery.mjs +707 -0
  20. package/scripts/runkit-contract/quick-verify.mjs +1 -1
  21. package/scripts/runkit-contract/runkit-bootstrap.mjs +6 -1
  22. package/scripts/runkit-contract/runkit-cli.mjs +278 -140
  23. package/scripts/runkit-contract/schemas/assurance-route-v2.schema.json +26 -0
  24. package/scripts/runkit-contract/schemas/profile-detection-v3.schema.json +170 -0
  25. package/scripts/runkit-contract/schemas/team-project-event-v3.schema.json +146 -0
  26. package/scripts/runkit-contract/schemas/team-project-status-v2.schema.json +85 -0
  27. package/scripts/runkit-contract/schemas/usage-mode-recommendation-v2.schema.json +136 -0
  28. package/scripts/runkit-contract/team-project.mjs +477 -15
  29. package/scripts/runkit-contract/usage-mode.mjs +28 -7
@@ -109,16 +109,16 @@ function shellQuote(value) {
109
109
  return `'${String(value).replaceAll("'", `'"'"'`)}'`;
110
110
  }
111
111
 
112
- function nextCommand({ workspaceRoot, continuity, assurance }) {
112
+ function nextCommand({ workspaceRoot, continuity, assurance, commandPrefix }) {
113
113
  const workspace = shellQuote(workspaceRoot ?? ".");
114
114
  if (assurance === "formal") {
115
- return `owlrunkit formal start --workspace ${workspace}`;
115
+ return `${commandPrefix} formal start --workspace ${workspace}`;
116
116
  }
117
117
  if (continuity === "project_driver") {
118
- return `owlrunkit project status --workspace ${workspace}`;
118
+ return `${commandPrefix} project status --workspace ${workspace}`;
119
119
  }
120
120
  if (assurance === "quick") {
121
- return `owlrunkit quick-verify --workspace ${workspace} -- <command> [args...]`;
121
+ return `${commandPrefix} quick-verify --workspace ${workspace} -- <command> [args...]`;
122
122
  }
123
123
  return null;
124
124
  }
@@ -133,7 +133,7 @@ function rejectedModes(recommendedMode, reasonCodes) {
133
133
  return lighter.map((mode) => ({ mode, reasonCodes }));
134
134
  }
135
135
 
136
- export function recommendUsageModeV1(input) {
136
+ function recommendUsageMode(input, { schemaVersion, commandPrefix }) {
137
137
  requireFacts(input);
138
138
  const forcedFormalReasons = formalReasonCodes(input);
139
139
  const continuityReasons = continuityReasonCodes(input);
@@ -184,7 +184,7 @@ export function recommendUsageModeV1(input) {
184
184
  const downgradeAllowed = forcedFormalReasons.length === 0;
185
185
 
186
186
  return {
187
- schemaVersion: "OwlCodaRunKitUsageModeRecommendationV1",
187
+ schemaVersion,
188
188
  status: "mode_recommended",
189
189
  requestedMode,
190
190
  recommendedMode,
@@ -193,7 +193,12 @@ export function recommendUsageModeV1(input) {
193
193
  triggerReasons: uniqueSorted(triggerReasons),
194
194
  rejectedLighterModes: rejectedModes(recommendedMode, blockingReasons),
195
195
  estimatedOverhead: estimateOverhead(continuity, assurance),
196
- nextCommand: nextCommand({ workspaceRoot: input.workspaceRoot, continuity, assurance }),
196
+ nextCommand: nextCommand({
197
+ workspaceRoot: input.workspaceRoot,
198
+ continuity,
199
+ assurance,
200
+ commandPrefix,
201
+ }),
197
202
  downgrade: {
198
203
  allowed: downgradeAllowed,
199
204
  reasonCodes: downgradeAllowed ? [] : forcedFormalReasons,
@@ -203,6 +208,20 @@ export function recommendUsageModeV1(input) {
203
208
  };
204
209
  }
205
210
 
211
+ export function recommendUsageModeV1(input) {
212
+ return recommendUsageMode(input, {
213
+ schemaVersion: "OwlCodaRunKitUsageModeRecommendationV1",
214
+ commandPrefix: "owlrunkit",
215
+ });
216
+ }
217
+
218
+ export function recommendUsageModeV2(input) {
219
+ return recommendUsageMode(input, {
220
+ schemaVersion: "OwlCodaRunKitUsageModeRecommendationV2",
221
+ commandPrefix: "npx --no-install owlrunkit",
222
+ });
223
+ }
224
+
206
225
  export function formatUsageModeHumanV1(result) {
207
226
  const triggers = result.triggerReasons.length > 0
208
227
  ? result.triggerReasons.join(", ")
@@ -225,3 +244,5 @@ export function formatUsageModeHumanV1(result) {
225
244
  "",
226
245
  ].join("\n");
227
246
  }
247
+
248
+ export const formatUsageModeHumanV2 = formatUsageModeHumanV1;