owlrunkit 0.16.0 → 0.17.0

package/scripts/runkit-contract/templates/team-project-definition.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "OwlCodaRunKitTeamProjectDefinitionV1",
+  "projectId": "project-id",
+  "objective": "State the durable project outcome",
+  "milestones": [
+    { "id": "m1", "title": "First milestone" }
+  ],
+  "workstreams": [
+    { "id": "runtime", "title": "Runtime", "milestoneId": "m1" }
+  ],
+  "workItems": [
+    {
+      "id": "work-item-1",
+      "title": "Deliver one evidence-backed outcome",
+      "milestoneId": "m1",
+      "workstreamId": "runtime",
+      "dependencies": [],
+      "ownedPaths": ["src/**"],
+      "measurable": { "unit": "acceptance_tests", "total": 1 }
+    }
+  ],
+  "integrationGates": [
+    {
+      "id": "integration-ready",
+      "title": "All required work accepted",
+      "requiredWorkItemIds": ["work-item-1"],
+      "requiredDecisionIds": []
+    }
+  ]
+}

package/scripts/runkit-contract/templates/team-project-event.json

@@ -0,0 +1,9 @@
+{
+  "schemaVersion": "OwlCodaRunKitTeamProjectEventV1",
+  "eventId": "event-001",
+  "type": "agent_assigned",
+  "occurredAt": "2026-08-08T00:00:00.000Z",
+  "assignmentId": "assignment-001",
+  "workItemId": "work-item-1",
+  "agentId": "agent-runtime"
+}

package/scripts/runkit-contract/templates/verification-envelope.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": "OwlCodaRunKitVerificationEnvelopeV1",
+  "envelopeId": "quality-v1",
+  "cwd": ".",
+  "lockfiles": ["package-lock.json"],
+  "paths": {
+    "immutableSource": ["src/**", "tests/**", "package-lock.json"],
+    "declaredOutput": ["dist/**", "coverage/**"],
+    "disposableScratch": [".tmp/**"],
+    "forbidden": [".env", ".ssh/**", ".owlcoda/**"]
+  },
+  "environment": { "allowNames": ["PATH"], "values": {} },
+  "network": { "mode": "deny" },
+  "process": {
+    "allowSubprocesses": false,
+    "allowedExecutables": [],
+    "allowBackgroundAfterFinish": false
+  },
+  "phases": {
+    "setup": null,
+    "check": {
+      "executable": "/absolute/path/to/node",
+      "argv": ["tests/run.mjs"],
+      "timeoutMs": 120000
+    },
+    "teardown": null
+  }
+}

package/scripts/runkit-contract/verification-envelope-check.mjs

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+
+import { realpathSync } from "node:fs";
+import { pathToFileURL } from "node:url";
+
+import { verifyVerificationEnvelopeReceiptV1 } from "./verification-envelope.mjs";
+
+function option(argv, name) {
+  const index = argv.indexOf(name);
+  if (index < 0 || index === argv.length - 1) {
+    throw new Error(`${name} is required.`);
+  }
+  return argv[index + 1];
+}
+
+export function verifyEnvelopeForFormalV1(argv = process.argv.slice(2)) {
+  if (argv.length !== 4
+    || argv[0] !== "--workspace"
+    || argv[2] !== "--receipt") {
+    throw new Error("Usage: verification-envelope-check.mjs --workspace <path> --receipt <path>");
+  }
+  const workspaceRoot = realpathSync(option(argv, "--workspace"));
+  const result = verifyVerificationEnvelopeReceiptV1({
+    workspaceRoot,
+    receiptPath: option(argv, "--receipt"),
+  });
+  return {
+    ...result,
+    status: result.formalEligible
+      ? "verification_envelope_formal_eligible"
+      : "verification_envelope_not_formal_eligible",
+    exitCode: result.formalEligible ? 0 : 2,
+  };
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  try {
+    const result = verifyEnvelopeForFormalV1();
+    process.stdout.write(`${JSON.stringify(result)}\n`);
+    process.exitCode = result.exitCode;
+  } catch (error) {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 3;
+  }
+}