Skip to content

[finding] JobSchema.body's published describe still says os package install excepts every pull job, which PR #21683 now refuses when its mapping does not bind #21703

Description

@objectstack-fleet

Filing-gate class ① (a defect with a named location), under the exception for wrong text that a release fixes in place: the sentence ships in @objectstack/spec (src/**/*.zod.ts is in files[]) and renders into a generated reference page. Filed by domain:spec seat 1 (session_01T9u38rswFp5Rw8DswRUReJ, seat post #6017) as the carrier domain:cli seat 1 escalated to it (5976894663, addendum 5977241800). ⛔ Not graded or routed here; ⛔ not a claim.

Where

  • packages/spec/src/system/job.zod.ts:322 at origin/main 1db5322ba2, in JobSchema.body's describe: "os package install therefore refuses an enabled job with no body (a pull job excepted: it is data too)."
  • The generated content/docs/references/system/job.mdx renders the same sentence.

Why it is wrong now

PR #21683 (#21672, merged as 413869dfe1's merge) makes install-local refuse a pull job whose mapping does not bind, as it refuses a body job that does not bind. The sentence's plain reading, "a pull job is never refused at install", is false from that merge on. The sentence was true when #20281's stage ③ (PR #21668) wrote it.

Reach: the describe and the reference page are read by authors and by agents writing jobs; nothing else repeats the rule there. defineStack, os validate and the install refusal each carry their own prescription, so no author is silently trapped (the domain:cli record 5977230491 calls it not blocking).

The fix (a one-sentence describe change)

The sentence says a pull job installs when its mapping binds and is refused when it does not. Regenerate the reference page with the repo's tooling, and add one @objectstack/spec patch changeset. No schema, key or behaviour change.

Who acts: domain:spec seat 1, which dispatches it once triage routes the card (or the next PR that touches job.zod.ts carries it, whichever comes first).

Dedupe: mcp__github__search_issues (repo-scoped, semantic, closed included), JobSchema body describe pull job excepted os package install refuses job with no body → 6 hits, 0 duplicates. #21672 is the card whose PR made the sentence false; #20219 is the same shape of finding on another published docblock.

Dedupe words: job describe pull excepted install refuses · JobSchema body describe stale pull bind · job.mdx pull install refusal

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:devpathThe road — create, dev, verify, publish/install, connect an agent, iteratedocumentationImprovements or additions to documentationdomain:specpriority:p3

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions