@overdeck/contracts 0.69.0 → 0.70.0

package/dist/index.cjs

@@ -108,7 +108,8 @@ const IssueAttention = effect.Schema.Literals([
 	"needs-you",
 	"stuck",
 	"api-error",
-	"work-not-started"
+	"work-not-started",
+	"pr-outside-pipeline"
 ]);
 /** Latest review decision on the PR, as the forge reports it. */
 const PrReviewState = effect.Schema.Literals([
@@ -151,6 +152,14 @@ const DerivedWorkStart = effect.Schema.Struct({
 	/** The retry is journaled but not actually running because the Deacon is frozen (PAN-4210). Present only when true. */
 	held: effect.Schema.optional(effect.Schema.Literal(true))
 });
+/** An open pull request the pipeline never picked up (PAN-4605). */
+const DerivedPrOutsidePipeline = effect.Schema.Struct({
+	prNumber: effect.Schema.Number,
+	/** One operator-facing paragraph naming the PR, the reason and the exact commands. */
+	fix: effect.Schema.String,
+	/** The other worktree that has the branch checked out, when that is the reason. */
+	worktreePath: effect.Schema.optional(effect.Schema.String)
+});
 /** Everything the dashboard needs to render an issue's pipeline position. */
 const DerivedIssueState = effect.Schema.Struct({
 	issueId: effect.Schema.String,
@@ -165,7 +174,9 @@ const DerivedIssueState = effect.Schema.Struct({
 	*/
 	trackerUnknown: effect.Schema.optional(effect.Schema.Literal(true)),
 	/** A deferred or gave-up post-planning auto-start read from the workspace journal (PAN-4399). */
-	workStart: effect.Schema.optional(DerivedWorkStart)
+	workStart: effect.Schema.optional(DerivedWorkStart),
+	/** An outside PR the pipeline never picked up (PAN-4605). */
+	prOutsidePipeline: effect.Schema.optional(DerivedPrOutsidePipeline)
 });
 const ISSUE_STATES = [
 	"backlog",
@@ -194,7 +205,8 @@ const ISSUE_ATTENTIONS = [
 	"needs-you",
 	"stuck",
 	"api-error",
-	"work-not-started"
+	"work-not-started",
+	"pr-outside-pipeline"
 ];
 function isIssueState(value) {
 	return typeof value === "string" && ISSUE_STATES.includes(value);
@@ -220,6 +232,7 @@ const GITHUB_QUOTA_CALLERS = [
 	"app-rest",
 	"quota-sampler",
 	"agent",
+	"pr-adoption",
 	"other"
 ];
 const GitHubQuotaCaller = effect.Schema.Literals(GITHUB_QUOTA_CALLERS);
@@ -1552,7 +1565,8 @@ const BeadsFreshnessChangedEvent = effect.Schema.Struct({
 * (PAN-3537).
 *
 * Emitted by the `check_suite` webhook handler for live updates, only after an
-* independent branch-head lookup verifies the payload SHA is still current.
+* independent lookup verifies the payload SHA is still the current CI head
+* (the newest push run of the CI workflow, PAN-4618).
 * `suiteId` is the check suite id — for GitHub Actions that is one suite per
 * workflow run. The webhook payload does not carry `htmlUrl`.
 *
@@ -1575,15 +1589,16 @@ const ProjectCiSuiteObservedEvent = effect.Schema.Struct({
 		conclusion: effect.Schema.NullOr(effect.Schema.String),
 		htmlUrl: effect.Schema.optional(effect.Schema.String),
 		observedAt: effect.Schema.String,
-		/** True only after the emitter verified headSha against the branch head. */
+		/** True only after the emitter verified headSha against the current CI head. */
 		authoritativeHead: effect.Schema.optional(effect.Schema.Boolean)
 	})
 });
 /**
-* Complete GitHub Actions projection for the verified default-branch head.
-* The REST seed/repair emits one event after paginating every run and verifying
-* the branch head a second time. An empty suites record explicitly clears stale
-* CI when the current commit has no Actions runs.
+* Complete GitHub Actions projection for the verified current CI head (the
+* newest push run of the CI workflow, PAN-4618). The REST seed/repair emits
+* one event after paginating every run and verifying the CI head a second
+* time. An empty suites record explicitly clears stale CI when the current
+* commit has no Actions runs.
 */
 const ProjectCiHeadObservedEvent = effect.Schema.Struct({
 	type: effect.Schema.Literal("project.ci_head_observed"),
@@ -3575,15 +3590,20 @@ const ReadFileAtPathResult = effect.Schema.Struct({
 	text: effect.Schema.String,
 	lang: effect.Schema.String,
 	mtimeMs: effect.Schema.Number,
-	totalLines: effect.Schema.Number
+	totalLines: effect.Schema.Number,
+	/** True when the resolved file is inside a registered project root or OVERDECK_HOME, so writeFileAtPath will accept it (PAN-4583). */
+	writable: effect.Schema.Boolean
 });
 /**
 * 10b-2. Read an allowlisted markdown file by absolute path (PAN-3260).
 *
 * Unlike ReadWorkspaceFileRpc this takes no issueId — the internal markdown
 * editor pane opens files reached from surfaces with no workspace context
-* (e.g. a repo-root file chip inside a conversation). The server validates
-* `path` against registered project roots + OVERDECK_HOME before reading.
+* (e.g. a repo-root file chip inside a conversation). The server reads any
+* existing markdown file whose realpath is inside the operator's home
+* directory or a write root (registered project roots + OVERDECK_HOME), and
+* sets `writable` to whether it is inside a write root (PAN-4583). Writes
+* stay limited to the write roots — see WriteFileAtPathRpc.
 */
 const ReadFileAtPathRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.readFileAtPath, {
 	payload: ReadFileAtPathInput,
@@ -3602,6 +3622,8 @@ const WriteFileAtPathResult = effect.Schema.Struct({ mtimeMs: effect.Schema.Numb
 * `expectedMtimeMs` enables optimistic concurrency: a stale value is
 * rejected with a PanRpcError code of WRITE_CONFLICT and nothing is
 * written. Omitting it (e.g. an explicit Overwrite action) skips the check.
+* The path must resolve inside a registered project root or OVERDECK_HOME;
+* anything else rejects with PATH_NOT_ALLOWED.
 */
 const WriteFileAtPathRpc = effect_unstable_rpc_Rpc.make(WS_METHODS.writeFileAtPath, {
 	payload: WriteFileAtPathInput,
@@ -6726,6 +6748,7 @@ const TELEMETRY_PROPERTY_DOMAINS = {
 		"app_rest",
 		"quota_sampler",
 		"agent",
+		"pr_adoption",
 		"other"
 	],
 	harness: [
@@ -16554,6 +16577,7 @@ exports.DeepWipeRpc = DeepWipeRpc;
 exports.DeployStalenessSnapshot = DeployStalenessSnapshot;
 exports.DerivedBranchState = DerivedBranchState;
 exports.DerivedIssueState = DerivedIssueState;
+exports.DerivedPrOutsidePipeline = DerivedPrOutsidePipeline;
 exports.DerivedPrState = DerivedPrState;
 exports.DerivedWorkStart = DerivedWorkStart;
 exports.DirectoryEntry = DirectoryEntry;