@gate-forge/pack-workflow 0.1.0

package/dist/obligations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obligations.d.ts","sourceRoot":"","sources":["../src/obligations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,mEAAmE;AACnE,eAAO,MAAM,2BAA2B,gCAAgC,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,gCAAgC,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,8BAA8B,mCAAmC,CAAC;AAE/E,4EAA4E;AAC5E,eAAO,MAAM,6BAA6B,EAAE,SAAS,MAAM,EAM1D,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAKpF"}

package/dist/obligations.js

@@ -0,0 +1,69 @@
+/**
+ * Obligation contract vocabulary for the workflow pack.
+ *
+ * Every discovered `workflow.contract.*` resource generates the same
+ * five obligations (the policy stage of the engine chooses a subset
+ * based on classification; the contracts themselves are fixed). The
+ * contract names are the suffix of the obligation id
+ * `<resourceId>:<contract>`; resource ids always start with
+ * `workflow.contract.`, so obligation ids look like
+ * `workflow.contract.contracts.draft:workflow:transition-allowed`.
+ *
+ * The five contracts mirror the root plan §6 "Workflow pack" obligations
+ * (valid transition / invalid transition / persisted final state /
+ * audit event records actor and transition) plus an explicit
+ * terminal-immutability obligation that the e2e suite exercises.
+ */
+/** Valid transition succeeds + persists + appends an audit row. */
+export const WORKFLOW_TRANSITION_ALLOWED = 'workflow:transition-allowed';
+/**
+ * Invalid transition is rejected: the adapter's `attemptTransition`
+ * returns `{ accepted: false }`, the persisted state is unchanged, and
+ * no audit row is appended.
+ */
+export const WORKFLOW_TRANSITION_REJECTED = 'workflow:transition-rejected';
+/**
+ * Any write attempt against a terminal state is rejected with
+ * `{ accepted: false, reason: 'terminal-state' }`; no audit row is
+ * appended.
+ */
+export const WORKFLOW_TERMINAL_IMMUTABLE = 'workflow:terminal-immutable';
+/**
+ * Audit row emitted on every accepted transition contains `actor`,
+ * `from`, `to`, and a timestamp; the adapter's `readAuditLog()`
+ * returns the append-only log verbatim.
+ */
+export const WORKFLOW_AUDIT_EMITTED = 'workflow:audit-emitted';
+/**
+ * The persisted entity's `status` matches the machine's terminal state
+ * after the transition sequence (e.g. `terminated`, `signed`).
+ */
+export const WORKFLOW_PERSISTED_FINAL_STATE = 'workflow:persisted-final-state';
+/** Every workflow contract this pack ships, in stable declaration order. */
+export const WORKFLOW_OBLIGATION_CONTRACTS = [
+    WORKFLOW_TRANSITION_ALLOWED,
+    WORKFLOW_TRANSITION_REJECTED,
+    WORKFLOW_TERMINAL_IMMUTABLE,
+    WORKFLOW_AUDIT_EMITTED,
+    WORKFLOW_PERSISTED_FINAL_STATE,
+];
+/**
+ * Returns the obligation contracts applicable to a workflow resource.
+ * Currently every workflow resource is treated equally; the engine's
+ * classification stage may narrow this later.
+ *
+ * Args:
+ *   resourceId: The full `workflow.contract.<domain>.<name>` id.
+ *
+ * Returns:
+ *   readonly string[]: The full contract list — same for every workflow
+ *     resource today, returned as a fresh copy so callers may not mutate
+ *     the shared array.
+ */
+export function obligationsForWorkflowResource(resourceId) {
+    if (!resourceId.startsWith('workflow.contract.')) {
+        return [];
+    }
+    return [...WORKFLOW_OBLIGATION_CONTRACTS];
+}
+//# sourceMappingURL=obligations.js.map

package/dist/obligations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obligations.js","sourceRoot":"","sources":["../src/obligations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,mEAAmE;AACnE,MAAM,CAAC,MAAM,2BAA2B,GAAG,6BAA6B,CAAC;AAEzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,8BAA8B,CAAC;AAE3E;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,6BAA6B,CAAC;AAEzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,gCAAgC,CAAC;AAE/E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,6BAA6B,GAAsB;IAC9D,2BAA2B;IAC3B,4BAA4B;IAC5B,2BAA2B;IAC3B,sBAAsB;IACtB,8BAA8B;CAC/B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,8BAA8B,CAAC,UAAkB;IAC/D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;QACjD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,GAAG,6BAA6B,CAAC,CAAC;AAC5C,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Pack identity constants. The GPP/3 handshake pins these values: the
+ * `.gateforge.yml` plugin entry MUST declare the same `id` and `version`
+ * (see the pack README). `version` follows gateforge pack semantics
+ * (mirror pack-sqlalchemy).
+ */
+/** Plugin id every workflow pack contribution is pinned to. */
+export declare const PACK_PLUGIN_ID = "gateforge.pack-workflow";
+/** Detector/pack version. */
+export declare const PACK_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+DAA+D;AAC/D,eAAO,MAAM,cAAc,4BAA4B,CAAC;AAExD,6BAA6B;AAC7B,eAAO,MAAM,YAAY,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,11 @@
+/**
+ * Pack identity constants. The GPP/3 handshake pins these values: the
+ * `.gateforge.yml` plugin entry MUST declare the same `id` and `version`
+ * (see the pack README). `version` follows gateforge pack semantics
+ * (mirror pack-sqlalchemy).
+ */
+/** Plugin id every workflow pack contribution is pinned to. */
+export const PACK_PLUGIN_ID = 'gateforge.pack-workflow';
+/** Detector/pack version. */
+export const PACK_VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GAAG,yBAAyB,CAAC;AAExD,6BAA6B;AAC7B,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@gate-forge/pack-workflow",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "description": "Workflow / state-machine discovery pack: TS-only AST detector (GPP/3), five workflow contracts (transition-allowed, transition-rejected, terminal-immutable, audit-emitted, persisted-final-state), entity-adapter schema for state-machine witnesses.",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "README.md",
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@gate-forge/core": "^0.1.0",
+    "@gate-forge/plugin-protocol": "^0.1.0",
+    "zod": "^4.1.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/umiddey/gateforge.git",
+    "directory": "packages/pack-workflow"
+  },
+  "bugs": {
+    "url": "https://github.com/umiddey/gateforge/issues"
+  },
+  "homepage": "https://github.com/umiddey/gateforge#readme"
+}