@forgrit/shared-contracts-prompt

Type-only contracts for ForGrit prompt-engine surfaces — 29 type exports across 7 thematic sub-modules: scoring, features, entities, requirements, frozen, responses, quality.

Status: early-access (v0.x). Internal-monorepo seam package. Pre-1.0 may include breaking changes in minor bumps.

Source-of-truth reversal package: ForGrit's apps/api/src/prompt/ consumes these via a 22-LOC wildcard re-export shim; the 396 LOC source lives here.

Install

npm install @forgrit/shared-contracts-prompt

Zero hard runtime deps (one runtime export: ApprovalStatus enum).

Sub-modules

import { RequirementsScoreCard, DimensionScores } from '@forgrit/shared-contracts-prompt/scoring';
import { FeatureSpec, FeatureIntent } from '@forgrit/shared-contracts-prompt/features';
import { EntityDefinition, EntityRelationship } from '@forgrit/shared-contracts-prompt/entities';
import { RequirementsContractV2 } from '@forgrit/shared-contracts-prompt/requirements';
import { FrozenPromptContract } from '@forgrit/shared-contracts-prompt/frozen';
import {} from /* LLM response shapes */ '@forgrit/shared-contracts-prompt/responses';
import {} from /* quality-gate shapes */ '@forgrit/shared-contracts-prompt/quality';

Or all from the root barrel:

import {
  RequirementsContractV2,
  FeatureSpec,
  ApprovalStatus,
} from '@forgrit/shared-contracts-prompt';

License

MIT — see LICENSE.

Sibling packages

• @forgrit/contracts — domain Zod schemas + types
• @forgrit/blueprint — app-spec format (consumes these contracts internally)
• @forgrit/shared-contracts-platform
• @forgrit/shared-contracts-jobs-queue