@on-par/contracts 0.0.0-stage → 0.9.0

package/dist/trace.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+/** `INT-<DIMENSION>-<NN>`, e.g. INT-PROBLEM-01. Ordinals widen past 99 rather than wrapping. */
+export declare const INTENT_STATEMENT_ID_PATTERN: RegExp;
+export declare const IntentStatementIdSchema: z.ZodString;
+/** Every intent statement ID a downstream artifact traces to. */
+export declare const TracesToSchema: z.ZodArray<z.ZodString>;
+export type IntentStatementId = z.infer<typeof IntentStatementIdSchema>;
+/** Structural shape of anything that cites intent — Story, Epic, or a future design artifact. */
+export interface Traceable {
+    readonly tracesTo?: readonly IntentStatementId[];
+}
+/**
+ * Mint an ID. The grammar lives with the validator so minting and checking can never drift:
+ * the dimension is upper-cased with non-letters stripped (`nonGoals` -> `NONGOALS`) and the
+ * ordinal is 1-based, zero-padded to two digits.
+ */
+export declare function formatIntentStatementId(dimension: string, ordinal: number): IntentStatementId;
+export declare function isIntentStatementId(value: unknown): value is IntentStatementId;
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gGAAgG;AAChG,eAAO,MAAM,2BAA2B,QAAwB,CAAC;AAEjE,eAAO,MAAM,uBAAuB,aAAiF,CAAC;AAEtH,iEAAiE;AACjE,eAAO,MAAM,cAAc,yBAAmC,CAAC;AAE/D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,iGAAiG;AACjG,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAG7F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E"}

package/dist/trace.js

@@ -0,0 +1,20 @@
+// src/trace.ts — Intent-statement IDs: the traceability seam downstream artifacts cite (#471).
+import { z } from 'zod';
+/** `INT-<DIMENSION>-<NN>`, e.g. INT-PROBLEM-01. Ordinals widen past 99 rather than wrapping. */
+export const INTENT_STATEMENT_ID_PATTERN = /^INT-[A-Z]+-\d{2,}$/;
+export const IntentStatementIdSchema = z.string().regex(INTENT_STATEMENT_ID_PATTERN, 'must look like INT-PROBLEM-01');
+/** Every intent statement ID a downstream artifact traces to. */
+export const TracesToSchema = z.array(IntentStatementIdSchema);
+/**
+ * Mint an ID. The grammar lives with the validator so minting and checking can never drift:
+ * the dimension is upper-cased with non-letters stripped (`nonGoals` -> `NONGOALS`) and the
+ * ordinal is 1-based, zero-padded to two digits.
+ */
+export function formatIntentStatementId(dimension, ordinal) {
+    const slug = dimension.toUpperCase().replace(/[^A-Z]/g, '');
+    return `INT-${slug}-${String(Math.max(1, Math.trunc(ordinal))).padStart(2, '0')}`;
+}
+export function isIntentStatementId(value) {
+    return typeof value === 'string' && INTENT_STATEMENT_ID_PATTERN.test(value);
+}
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gGAAgG;AAChG,MAAM,CAAC,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AAEjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,2BAA2B,EAAE,+BAA+B,CAAC,CAAC;AAEtH,iEAAiE;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;AAS/D;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAiB,EAAE,OAAe;IACxE,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC5D,OAAO,OAAO,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@on-par/contracts",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.9.0",
+  "description": "Shared typed seam: engineering-ready issue/epic/story, Gherkin acceptance criteria, and the DesignArtifact schema.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/on-par/software-factory.git",
+    "directory": "packages/contracts"
+  },
+  "homepage": "https://github.com/on-par/software-factory#readme",
+  "bugs": {
+    "url": "https://github.com/on-par/software-factory/issues"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build",
+    "prepack": "node ../../scripts/pack-hygiene-cli.ts prepack"
+  },
+  "dependencies": {
+    "zod": "^4.6.5"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^26.6.4"
+  }
+}