@owlmeans/planning 0.1.18-rc.0 → 0.1.18-rc.1

package/README.md

@@ -9,7 +9,7 @@ the executor with `@owlmeans/server-planning` and reads remotely with `@owlmeans
 ## Installation
 
 ```sh
-bun add @owlmeans/planning@^0.1.18-rc.0 ajv ajv-formats
+bun add @owlmeans/planning@^0.1.18-rc.1 ajv ajv-formats
 ```
 
 ## Concepts
@@ -160,7 +160,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.27
+npx @owlmeans/agent-skills@^0.1.18-rc.28
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/planning",
-  "version": "0.1.18-rc.0",
-  "generatedAt": "2026-09-16T15:11:05.003Z",
+  "version": "0.1.18-rc.1",
+  "generatedAt": "2026-09-17T08:16:11.225Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/planning/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/planning
 
 **Layer:** Cross-cutting domain
-**Install:** `"@owlmeans/planning": "^0.1.18-rc.0"` in `dependencies` (`ajv` and `ajv-formats` are peers)
+**Install:** `"@owlmeans/planning": "^0.1.18-rc.1"` in `dependencies` (`ajv` and `ajv-formats` are peers)
 
 The contracts of project planning: record shapes, schemas, refusals, the protocol tree, the pure
 fold and the models. No database, no fastify, no React. The executor, the plugin registry, the
@@ -202,23 +202,32 @@ by kind) is the same object on a server and in a browser. `schema`, `flow`, `sta
 Every refusal is a registered `ResilientError` whose message is `planning:<marker>:<detail>` —
 the marker survives a hop where the class is unknown, so match on it there:
 
-| Class | Marker |
-|---|---|
-| `PlanningError` | `planning:` (`fold:out-of-order`, `immutable:<field>`, `malformed:<what>`) |
-| `WorkcardNotFound` | `workcard-not-found:` — also the answer for another entity's card |
-| `UnknownWorkcardType` / `UnknownStatusFlow` | `unknown-type:` / `unknown-flow:` |
-| `ParentNotFound` / `CardTypeNotAllowed` | `parent-not-found:` / `card-type-not-allowed:` |
-| `PlanningRefused` | `refused:` — a plugin middleware said no |
-| `IllegalTransition` | `illegal-transition:<flow>:<transition>:<from>` |
-| `FieldsInvalid` / `LabelNotAllowed` | `fields-invalid:` / `label-not-allowed:` |
-| `SpecificationSlotUnknown` / `SpecificationRevisionConflict` | `specification-slot-unknown:` / `specification-revision-conflict:` |
-| `RelationshipRefused` / `CodeTaken` | `relationship-refused:` / `code-taken:` |
-| `WorkcardConflict` | `workcard-conflict:` — stale `expectSeq` |
-| `CommitTimeout` / `CommitFailed` | `commit-timeout:` (still pending, nothing undone) / `commit-failed:` |
-| `PlanningScopeMismatch` / `PlanningUnsupported` | `scope-mismatch:` / `unsupported:` |
+| Class | Marker | HTTP |
+|---|---|---|
+| `PlanningError` | `planning:` (`fold:out-of-order`, `immutable:<field>`, `malformed:<what>`) | 500 |
+| `WorkcardNotFound` | `workcard-not-found:` — also the answer for another entity's card | 404 |
+| `UnknownWorkcardType` / `UnknownStatusFlow` | `unknown-type:` / `unknown-flow:` | 422 |
+| `ParentNotFound` / `CardTypeNotAllowed` | `parent-not-found:` / `card-type-not-allowed:` | 422 |
+| `PlanningRefused` | `refused:` — a plugin middleware said no | 422 |
+| `IllegalTransition` | `illegal-transition:<flow>:<transition>:<from>` | 409 |
+| `FieldsInvalid` / `LabelNotAllowed` | `fields-invalid:` / `label-not-allowed:` | 422 |
+| `SpecificationSlotUnknown` / `SpecificationRevisionConflict` | `specification-slot-unknown:` / `specification-revision-conflict:` | 422 / 409 |
+| `RelationshipRefused` / `CodeTaken` | `relationship-refused:` / `code-taken:` | 422 / 409 |
+| `WorkcardConflict` | `workcard-conflict:` — stale `expectSeq` | 409 |
+| `CommitTimeout` / `CommitFailed` | `commit-timeout:` (still pending, nothing undone) / `commit-failed:` | 500 |
+| `PlanningScopeMismatch` / `PlanningUnsupported` | `scope-mismatch:` / `unsupported:` | 404 / 500 |
 
 Type names are `PlanningError<Suffix>` (`PlanningErrorWorkcardNotFound`).
 
+**The HTTP column is each class's `static httpStatus`** (the `error` skill's principle; 500 = none
+declared): an addressed card that is absent or another entity's is 404, a card whose state or head
+refuses the write is 409, a body naming what the registry, the parent or a schema refuses is 422.
+Faults declare nothing, and so does `PlanningError` itself — its three causes share one class, and
+a base's static would reach every subclass. A new refusal declares on its own leaf class, and
+`tests/error-status.spec.ts` refuses an exported refusal whose status was not decided. A plugin's
+plain `throw` inside `before` becomes `PlanningRefused` and answers 422, so a plugin FAULT must
+throw a `ResilientError` that declares nothing.
+
 ## i18n
 
 Importing the package registers, in all seven languages, `lib:planning.*` labels (`kind.*`,

package/build/errors.d.ts

@@ -13,63 +13,91 @@ export declare class PlanningError extends ResilientError {
 /** The card does not exist — or belongs to another entity, which is deliberately the same answer. */
 export declare class WorkcardNotFound extends PlanningError {
     static typeName: string;
+    /** The addressed card is absent or another entity's: answered 404. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 export declare class UnknownWorkcardType extends PlanningError {
     static typeName: string;
+    /** The execution names a type the registry does not declare: answered 422. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 export declare class UnknownStatusFlow extends PlanningError {
     static typeName: string;
+    /** The execution names a flow the type does not run: answered 422. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 export declare class ParentNotFound extends PlanningError {
     static typeName: string;
+    /** A parent the body references does not resolve: answered 422. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 /** The parent project's type does not list this card (or project) type. */
 export declare class CardTypeNotAllowed extends PlanningError {
     static typeName: string;
+    /** The parent refuses a child of this type: answered 422. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 /** A plugin's `before` middleware refused the execution without a class of its own. */
 export declare class PlanningRefused extends PlanningError {
     static typeName: string;
+    /** A plugin refused what was submitted: answered 422. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 /** The flow offers no rule of that name from the card's current status. */
 export declare class IllegalTransition extends PlanningError {
     static typeName: string;
+    /** The card's current status offers no such rule: answered 409. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 export declare class FieldsInvalid extends PlanningError {
     static typeName: string;
+    /** The submitted fields fail the type's schema: answered 422. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 export declare class LabelNotAllowed extends PlanningError {
     static typeName: string;
+    /** The submitted label is refused: answered 422. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 export declare class SpecificationSlotUnknown extends PlanningError {
     static typeName: string;
+    /** The body names a slot the parent type does not declare: answered 422. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 /** A second document for a slot that holds one — revise the existing record instead. */
 export declare class SpecificationRevisionConflict extends PlanningError {
     static typeName: string;
+    /** The slot already holds its document: answered 409. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 export declare class RelationshipRefused extends PlanningError {
     static typeName: string;
+    /** The submitted link is refused: answered 422. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 export declare class CodeTaken extends PlanningError {
     static typeName: string;
+    /** Another card holds the code: answered 409. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 /** `expectSeq` no longer matches the card's head — somebody else wrote first. Re-read and retry. */
 export declare class WorkcardConflict extends PlanningError {
     static typeName: string;
+    /** The card moved past the expected head: answered 409. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 /** The transition was appended but did not commit in time. It stays pending — nothing is undone. */
@@ -84,6 +112,8 @@ export declare class CommitFailed extends PlanningError {
 /** A card of another entity was addressed. Handlers answer it as {@link WorkcardNotFound}. */
 export declare class PlanningScopeMismatch extends PlanningError {
     static typeName: string;
+    /** Another entity's card, answered as absent: answered 404. */
+    static httpStatus: number;
     constructor(message?: string);
 }
 /** The store behind this type cannot do what was asked (a foreign provider without a log). */

package/build/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/build/errors.js

@@ -15,6 +15,8 @@ export class PlanningError extends ResilientError {
 /** The card does not exist — or belongs to another entity, which is deliberately the same answer. */
 export class WorkcardNotFound extends PlanningError {
     static typeName = `${PlanningError.typeName}WorkcardNotFound`;
+    /** The addressed card is absent or another entity's: answered 404. */
+    static httpStatus = 404;
     constructor(message = 'error') {
         super(`workcard-not-found:${message}`);
         this.type = WorkcardNotFound.typeName;
@@ -22,6 +24,8 @@ export class WorkcardNotFound extends PlanningError {
 }
 export class UnknownWorkcardType extends PlanningError {
     static typeName = `${PlanningError.typeName}UnknownWorkcardType`;
+    /** The execution names a type the registry does not declare: answered 422. */
+    static httpStatus = 422;
     constructor(message = 'error') {
         super(`unknown-type:${message}`);
         this.type = UnknownWorkcardType.typeName;
@@ -29,6 +33,8 @@ export class UnknownWorkcardType extends PlanningError {
 }
 export class UnknownStatusFlow extends PlanningError {
     static typeName = `${PlanningError.typeName}UnknownStatusFlow`;
+    /** The execution names a flow the type does not run: answered 422. */
+    static httpStatus = 422;
     constructor(message = 'error') {
         super(`unknown-flow:${message}`);
         this.type = UnknownStatusFlow.typeName;
@@ -36,6 +42,8 @@ export class UnknownStatusFlow extends PlanningError {
 }
 export class ParentNotFound extends PlanningError {
     static typeName = `${PlanningError.typeName}ParentNotFound`;
+    /** A parent the body references does not resolve: answered 422. */
+    static httpStatus = 422;
     constructor(message = 'error') {
         super(`parent-not-found:${message}`);
         this.type = ParentNotFound.typeName;
@@ -44,6 +52,8 @@ export class ParentNotFound extends PlanningError {
 /** The parent project's type does not list this card (or project) type. */
 export class CardTypeNotAllowed extends PlanningError {
     static typeName = `${PlanningError.typeName}CardTypeNotAllowed`;
+    /** The parent refuses a child of this type: answered 422. */
+    static httpStatus = 422;
     constructor(message = 'error') {
         super(`card-type-not-allowed:${message}`);
         this.type = CardTypeNotAllowed.typeName;
@@ -52,6 +62,8 @@ export class CardTypeNotAllowed extends PlanningError {
 /** A plugin's `before` middleware refused the execution without a class of its own. */
 export class PlanningRefused extends PlanningError {
     static typeName = `${PlanningError.typeName}Refused`;
+    /** A plugin refused what was submitted: answered 422. */
+    static httpStatus = 422;
     constructor(message = 'error') {
         super(`refused:${message}`);
         this.type = PlanningRefused.typeName;
@@ -60,6 +72,8 @@ export class PlanningRefused extends PlanningError {
 /** The flow offers no rule of that name from the card's current status. */
 export class IllegalTransition extends PlanningError {
     static typeName = `${PlanningError.typeName}IllegalTransition`;
+    /** The card's current status offers no such rule: answered 409. */
+    static httpStatus = 409;
     constructor(message = 'error') {
         super(`illegal-transition:${message}`);
         this.type = IllegalTransition.typeName;
@@ -67,6 +81,8 @@ export class IllegalTransition extends PlanningError {
 }
 export class FieldsInvalid extends PlanningError {
     static typeName = `${PlanningError.typeName}FieldsInvalid`;
+    /** The submitted fields fail the type's schema: answered 422. */
+    static httpStatus = 422;
     constructor(message = 'error') {
         super(`fields-invalid:${message}`);
         this.type = FieldsInvalid.typeName;
@@ -74,6 +90,8 @@ export class FieldsInvalid extends PlanningError {
 }
 export class LabelNotAllowed extends PlanningError {
     static typeName = `${PlanningError.typeName}LabelNotAllowed`;
+    /** The submitted label is refused: answered 422. */
+    static httpStatus = 422;
     constructor(message = 'error') {
         super(`label-not-allowed:${message}`);
         this.type = LabelNotAllowed.typeName;
@@ -81,6 +99,8 @@ export class LabelNotAllowed extends PlanningError {
 }
 export class SpecificationSlotUnknown extends PlanningError {
     static typeName = `${PlanningError.typeName}SpecificationSlotUnknown`;
+    /** The body names a slot the parent type does not declare: answered 422. */
+    static httpStatus = 422;
     constructor(message = 'error') {
         super(`specification-slot-unknown:${message}`);
         this.type = SpecificationSlotUnknown.typeName;
@@ -89,6 +109,8 @@ export class SpecificationSlotUnknown extends PlanningError {
 /** A second document for a slot that holds one — revise the existing record instead. */
 export class SpecificationRevisionConflict extends PlanningError {
     static typeName = `${PlanningError.typeName}SpecificationRevisionConflict`;
+    /** The slot already holds its document: answered 409. */
+    static httpStatus = 409;
     constructor(message = 'error') {
         super(`specification-revision-conflict:${message}`);
         this.type = SpecificationRevisionConflict.typeName;
@@ -96,6 +118,8 @@ export class SpecificationRevisionConflict extends PlanningError {
 }
 export class RelationshipRefused extends PlanningError {
     static typeName = `${PlanningError.typeName}RelationshipRefused`;
+    /** The submitted link is refused: answered 422. */
+    static httpStatus = 422;
     constructor(message = 'error') {
         super(`relationship-refused:${message}`);
         this.type = RelationshipRefused.typeName;
@@ -103,6 +127,8 @@ export class RelationshipRefused extends PlanningError {
 }
 export class CodeTaken extends PlanningError {
     static typeName = `${PlanningError.typeName}CodeTaken`;
+    /** Another card holds the code: answered 409. */
+    static httpStatus = 409;
     constructor(message = 'error') {
         super(`code-taken:${message}`);
         this.type = CodeTaken.typeName;
@@ -111,6 +137,8 @@ export class CodeTaken extends PlanningError {
 /** `expectSeq` no longer matches the card's head — somebody else wrote first. Re-read and retry. */
 export class WorkcardConflict extends PlanningError {
     static typeName = `${PlanningError.typeName}WorkcardConflict`;
+    /** The card moved past the expected head: answered 409. */
+    static httpStatus = 409;
     constructor(message = 'error') {
         super(`workcard-conflict:${message}`);
         this.type = WorkcardConflict.typeName;
@@ -134,6 +162,8 @@ export class CommitFailed extends PlanningError {
 /** A card of another entity was addressed. Handlers answer it as {@link WorkcardNotFound}. */
 export class PlanningScopeMismatch extends PlanningError {
     static typeName = `${PlanningError.typeName}ScopeMismatch`;
+    /** Another entity's card, answered as absent: answered 404. */
+    static httpStatus = 404;
     constructor(message = 'error') {
         super(`scope-mismatch:${message}`);
         this.type = PlanningScopeMismatch.typeName;

package/build/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/planning",
-  "version": "0.1.18-rc.0",
+  "version": "0.1.18-rc.1",
   "license": "MIT",
   "description": "Runtime-free project-planning contracts — the workcard super type, projects, specifications, typed relationships, status flows with three intrinsic states, the transition event and its pure fold, the schema registry, the models and the protocol tree.",
   "type": "module",
@@ -30,15 +30,15 @@
     }
   },
   "dependencies": {
-    "@owlmeans/auth": "^0.1.18-rc.26",
-    "@owlmeans/basic-ids": "^0.1.18-rc.25",
-    "@owlmeans/context": "^0.1.18-rc.24",
-    "@owlmeans/entrypoint": "^0.1.18-rc.27",
-    "@owlmeans/error": "^0.1.18-rc.26",
-    "@owlmeans/i18n": "^0.1.18-rc.27",
-    "@owlmeans/queue": "^0.1.18-rc.22",
-    "@owlmeans/resource": "^0.1.18-rc.26",
-    "@owlmeans/route": "^0.1.18-rc.25"
+    "@owlmeans/auth": "^0.1.18-rc.27",
+    "@owlmeans/basic-ids": "^0.1.18-rc.26",
+    "@owlmeans/context": "^0.1.18-rc.25",
+    "@owlmeans/entrypoint": "^0.1.18-rc.28",
+    "@owlmeans/error": "^0.1.18-rc.27",
+    "@owlmeans/i18n": "^0.1.18-rc.28",
+    "@owlmeans/queue": "^0.1.18-rc.23",
+    "@owlmeans/resource": "^0.1.18-rc.27",
+    "@owlmeans/route": "^0.1.18-rc.26"
   },
   "peerDependencies": {
     "ajv": "*",

package/src/errors.ts

@@ -18,6 +18,8 @@ export class PlanningError extends ResilientError {
 /** The card does not exist — or belongs to another entity, which is deliberately the same answer. */
 export class WorkcardNotFound extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}WorkcardNotFound`
+  /** The addressed card is absent or another entity's: answered 404. */
+  public static httpStatus = 404
 
   constructor(message: string = 'error') {
     super(`workcard-not-found:${message}`)
@@ -27,6 +29,8 @@ export class WorkcardNotFound extends PlanningError {
 
 export class UnknownWorkcardType extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}UnknownWorkcardType`
+  /** The execution names a type the registry does not declare: answered 422. */
+  public static httpStatus = 422
 
   constructor(message: string = 'error') {
     super(`unknown-type:${message}`)
@@ -36,6 +40,8 @@ export class UnknownWorkcardType extends PlanningError {
 
 export class UnknownStatusFlow extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}UnknownStatusFlow`
+  /** The execution names a flow the type does not run: answered 422. */
+  public static httpStatus = 422
 
   constructor(message: string = 'error') {
     super(`unknown-flow:${message}`)
@@ -45,6 +51,8 @@ export class UnknownStatusFlow extends PlanningError {
 
 export class ParentNotFound extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}ParentNotFound`
+  /** A parent the body references does not resolve: answered 422. */
+  public static httpStatus = 422
 
   constructor(message: string = 'error') {
     super(`parent-not-found:${message}`)
@@ -55,6 +63,8 @@ export class ParentNotFound extends PlanningError {
 /** The parent project's type does not list this card (or project) type. */
 export class CardTypeNotAllowed extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}CardTypeNotAllowed`
+  /** The parent refuses a child of this type: answered 422. */
+  public static httpStatus = 422
 
   constructor(message: string = 'error') {
     super(`card-type-not-allowed:${message}`)
@@ -65,6 +75,8 @@ export class CardTypeNotAllowed extends PlanningError {
 /** A plugin's `before` middleware refused the execution without a class of its own. */
 export class PlanningRefused extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}Refused`
+  /** A plugin refused what was submitted: answered 422. */
+  public static httpStatus = 422
 
   constructor(message: string = 'error') {
     super(`refused:${message}`)
@@ -75,6 +87,8 @@ export class PlanningRefused extends PlanningError {
 /** The flow offers no rule of that name from the card's current status. */
 export class IllegalTransition extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}IllegalTransition`
+  /** The card's current status offers no such rule: answered 409. */
+  public static httpStatus = 409
 
   constructor(message: string = 'error') {
     super(`illegal-transition:${message}`)
@@ -84,6 +98,8 @@ export class IllegalTransition extends PlanningError {
 
 export class FieldsInvalid extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}FieldsInvalid`
+  /** The submitted fields fail the type's schema: answered 422. */
+  public static httpStatus = 422
 
   constructor(message: string = 'error') {
     super(`fields-invalid:${message}`)
@@ -93,6 +109,8 @@ export class FieldsInvalid extends PlanningError {
 
 export class LabelNotAllowed extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}LabelNotAllowed`
+  /** The submitted label is refused: answered 422. */
+  public static httpStatus = 422
 
   constructor(message: string = 'error') {
     super(`label-not-allowed:${message}`)
@@ -102,6 +120,8 @@ export class LabelNotAllowed extends PlanningError {
 
 export class SpecificationSlotUnknown extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}SpecificationSlotUnknown`
+  /** The body names a slot the parent type does not declare: answered 422. */
+  public static httpStatus = 422
 
   constructor(message: string = 'error') {
     super(`specification-slot-unknown:${message}`)
@@ -112,6 +132,8 @@ export class SpecificationSlotUnknown extends PlanningError {
 /** A second document for a slot that holds one — revise the existing record instead. */
 export class SpecificationRevisionConflict extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}SpecificationRevisionConflict`
+  /** The slot already holds its document: answered 409. */
+  public static httpStatus = 409
 
   constructor(message: string = 'error') {
     super(`specification-revision-conflict:${message}`)
@@ -121,6 +143,8 @@ export class SpecificationRevisionConflict extends PlanningError {
 
 export class RelationshipRefused extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}RelationshipRefused`
+  /** The submitted link is refused: answered 422. */
+  public static httpStatus = 422
 
   constructor(message: string = 'error') {
     super(`relationship-refused:${message}`)
@@ -130,6 +154,8 @@ export class RelationshipRefused extends PlanningError {
 
 export class CodeTaken extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}CodeTaken`
+  /** Another card holds the code: answered 409. */
+  public static httpStatus = 409
 
   constructor(message: string = 'error') {
     super(`code-taken:${message}`)
@@ -140,6 +166,8 @@ export class CodeTaken extends PlanningError {
 /** `expectSeq` no longer matches the card's head — somebody else wrote first. Re-read and retry. */
 export class WorkcardConflict extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}WorkcardConflict`
+  /** The card moved past the expected head: answered 409. */
+  public static httpStatus = 409
 
   constructor(message: string = 'error') {
     super(`workcard-conflict:${message}`)
@@ -169,6 +197,8 @@ export class CommitFailed extends PlanningError {
 /** A card of another entity was addressed. Handlers answer it as {@link WorkcardNotFound}. */
 export class PlanningScopeMismatch extends PlanningError {
   public static override typeName: string = `${PlanningError.typeName}ScopeMismatch`
+  /** Another entity's card, answered as absent: answered 404. */
+  public static httpStatus = 404
 
   constructor(message: string = 'error') {
     super(`scope-mismatch:${message}`)

package/tests/error-status.spec.ts

@@ -0,0 +1,55 @@
+import { describe, expect, test } from 'bun:test'
+import { ResilientError } from '@owlmeans/error'
+import * as errors from '../src/errors.js'
+
+/**
+ * The status an HTTP boundary (`@owlmeans/server-api` `errorStatus`) reads off a class: a static
+ * `httpStatus` inherited through the constructor chain. A refusal of the caller's condition declares
+ * a 4xx; a fault declares nothing and answers 500.
+ */
+const statusOf = (error: Error): unknown => (error.constructor as { httpStatus?: unknown }).httpStatus
+
+const DECLARED: Record<string, number | undefined> = {
+  PlanningError: undefined,
+  WorkcardNotFound: 404,
+  PlanningScopeMismatch: 404,
+  IllegalTransition: 409,
+  SpecificationRevisionConflict: 409,
+  CodeTaken: 409,
+  WorkcardConflict: 409,
+  UnknownWorkcardType: 422,
+  UnknownStatusFlow: 422,
+  ParentNotFound: 422,
+  CardTypeNotAllowed: 422,
+  PlanningRefused: 422,
+  FieldsInvalid: 422,
+  LabelNotAllowed: 422,
+  SpecificationSlotUnknown: 422,
+  RelationshipRefused: 422,
+  CommitTimeout: undefined,
+  CommitFailed: undefined,
+  PlanningUnsupported: undefined,
+}
+
+const classes = Object.entries(errors).filter(([, value]) =>
+  typeof value === 'function' && value.prototype instanceof ResilientError
+) as [string, new (message?: string) => ResilientError][]
+
+describe('planning refusals — declared HTTP statuses', () => {
+  test('every refusal class has decided its status', () => {
+    expect(classes.map(([name]) => name).sort()).toEqual(Object.keys(DECLARED).sort())
+  })
+
+  test('an absent card is 404, a card in another state 409, refused content 422; faults declare nothing', () => {
+    for (const [name, Class] of classes) {
+      expect([name, statusOf(new Class('x'))]).toEqual([name, DECLARED[name]])
+    }
+  })
+
+  test('a refusal rebuilt from its marshalled form keeps its class and its status', () => {
+    for (const [name, Class] of classes) {
+      const back = ResilientError.ensure(new Class('x').marshal())
+      expect([name, back.constructor === Class, statusOf(back)]).toEqual([name, true, DECLARED[name]])
+    }
+  })
+})