@haneinfo/assignment 0.0.0-stage → 0.1.0

package/dist/prisma-store.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrismaAssignmentStore = void 0;
+class PrismaTx {
+    constructor(db) {
+        this.db = db;
+    }
+    async saveBindings(bindings) {
+        if (bindings.length === 0)
+            return;
+        await this.db.assignmentBinding.createMany({
+            data: bindings.map((binding) => ({
+                ...binding,
+                definition: binding.definition,
+            })),
+        });
+    }
+    async bindings(instanceId) {
+        const rows = await this.db.assignmentBinding.findMany({ where: { instanceId } });
+        return rows.map((row) => ({
+            ...row,
+            definition: row.definition,
+        }));
+    }
+    async createTasks(tasks) {
+        const created = [];
+        for (const task of tasks)
+            created.push(await this.db.assignmentTask.create({ data: task }));
+        return created;
+    }
+    task(id) {
+        return this.db.assignmentTask.findUnique({ where: { id } });
+    }
+    tasks(filter) {
+        return this.db.assignmentTask.findMany({
+            where: Object.fromEntries(Object.entries(filter).filter(([, value]) => value !== undefined)),
+            orderBy: [{ createdAt: 'desc' }],
+            take: 500,
+        });
+    }
+    async updateTask(id, expectedStatus, patch) {
+        const { count } = await this.db.assignmentTask.updateMany({
+            where: { id, status: expectedStatus },
+            data: patch,
+        });
+        return count > 0;
+    }
+    async lastRound(instanceId, assignmentCode) {
+        const result = await this.db.assignmentTask.aggregate({
+            where: { instanceId, assignmentCode },
+            _max: { round: true },
+        });
+        return result._max.round ?? 0;
+    }
+}
+class PrismaAssignmentStore {
+    constructor(prisma) {
+        this.prisma = prisma;
+    }
+    run(tx, work) {
+        if (tx !== undefined)
+            return work(new PrismaTx(tx), tx);
+        return this.prisma.$transaction((client) => work(new PrismaTx(client), client));
+    }
+}
+exports.PrismaAssignmentStore = PrismaAssignmentStore;
+//# sourceMappingURL=prisma-store.js.map

package/dist/prisma-store.js.map

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

package/dist/semantics.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Semantic rules of an Assignment. It hangs off a StateMachine, so most rules look into it through
+ * the validation context: the state must exist and not be FINAL, every response's transition must
+ * leave that state. A FORM_FIELD_USER must name a `user_select` field of the machine's subject Form.
+ */
+import { type DefinitionDiagnostic, type DefinitionValidationContext } from '@haneinfo/plugin-api';
+import type { AssignmentSpec } from './types';
+export declare function validateAssignmentSpec(spec: AssignmentSpec, context?: DefinitionValidationContext): DefinitionDiagnostic[];
+//# sourceMappingURL=semantics.d.ts.map

package/dist/semantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantics.d.ts","sourceRoot":"","sources":["../src/semantics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAIjC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAuB9C,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EACpB,OAAO,CAAC,EAAE,2BAA2B,GACpC,oBAAoB,EAAE,CAoIxB"}

package/dist/semantics.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Semantic rules of an Assignment. It hangs off a StateMachine, so most rules look into it through
+ * the validation context: the state must exist and not be FINAL, every response's transition must
+ * leave that state. A FORM_FIELD_USER must name a `user_select` field of the machine's subject Form.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAssignmentSpec = validateAssignmentSpec;
+const plugin_api_1 = require("@haneinfo/plugin-api");
+function formFieldTypes(fields, out = new Map()) {
+    for (const field of fields) {
+        out.set(field.id ?? field.key, field.type);
+        if (field.children)
+            formFieldTypes(field.children, out);
+    }
+    return out;
+}
+function validateAssignmentSpec(spec, context) {
+    const diagnostics = [];
+    const add = (code, message, segments, suggestion, severity = 'ERROR') => diagnostics.push((0, plugin_api_1.definitionDiagnostic)(code, message, (0, plugin_api_1.toJsonPointer)(['spec', ...segments]), {
+        suggestion,
+        severity,
+    }));
+    const keys = new Set();
+    spec.responses.forEach((response, index) => {
+        if (keys.has(response.key))
+            add('DUPLICATE_RESPONSE_KEY', `response key "${response.key}" is used twice`, ['responses', index, 'key'], 'Give every response a unique key');
+        keys.add(response.key);
+        if (response.decisive && spec.policy !== 'JOINT') {
+            add('DECISIVE_NOT_JOINT', '"decisive" only applies to the JOINT policy', ['responses', index, 'decisive'], 'Remove it; with SINGLE and ANY_ONE every response decides');
+        }
+    });
+    if (spec.policy === 'JOINT' &&
+        spec.responses.filter((response) => !response.decisive).length !== 1) {
+        add('JOINT_NEEDS_ONE_AGREEMENT', 'JOINT needs exactly one non-decisive response — the one everybody must give', ['responses'], 'Mark the others (e.g. reject) as "decisive": true');
+    }
+    if (spec.policy === 'SINGLE' &&
+        (spec.assignees.length > 1 ||
+            spec.assignees.some((a) => a.type === 'ROLE' || (a.type === 'SPECIFIC_USER' && a.userIds.length > 1)))) {
+        add('SINGLE_MAY_RESOLVE_MANY', 'SINGLE expects one assignee, but these resolvers can produce several', ['assignees'], 'Use ANY_ONE when any of them may respond', 'WARNING');
+    }
+    if (spec.dueIn !== undefined && ((0, plugin_api_1.parseIsoDuration)(spec.dueIn) ?? 0) <= 0) {
+        add('INVALID_DURATION', `"${spec.dueIn}" is not a positive ISO 8601 duration`, ['dueIn'], 'Use for example "P2D" or "PT4H"; months and years are not supported');
+    }
+    const machine = context?.resolve(spec.stateMachine)?.spec;
+    if (!machine)
+        return diagnostics; // the registry reports the missing reference itself
+    const state = machine.states.find((candidate) => candidate.key === spec.onEnter);
+    if (!state) {
+        add('UNKNOWN_STATE', `"${spec.onEnter}" is not a state of StateMachine/${spec.stateMachine.code}`, ['onEnter'], `Use one of: ${machine.states.map((s) => s.key).join(', ')}`);
+    }
+    else if (state.type === 'FINAL') {
+        add('ASSIGNMENT_ON_FINAL_STATE', `"${spec.onEnter}" is FINAL, so nobody could act on the task`, ['onEnter'], 'Open the assignment on a state that has transitions out');
+    }
+    spec.responses.forEach((response, index) => {
+        const transition = machine.transitions.find((candidate) => candidate.key === response.transition);
+        if (!transition) {
+            add('UNKNOWN_TRANSITION', `"${response.transition}" is not a transition of StateMachine/${spec.stateMachine.code}`, ['responses', index, 'transition'], `Use one of: ${machine.transitions.map((t) => t.key).join(', ')}`);
+        }
+        else if (!transition.from.includes(spec.onEnter)) {
+            add('TRANSITION_NOT_FROM_STATE', `"${response.transition}" does not leave "${spec.onEnter}"`, ['responses', index, 'transition'], `Use a transition whose "from" contains "${spec.onEnter}"`);
+        }
+    });
+    const subject = machine.subject ? context?.resolve(machine.subject) : undefined;
+    const fieldTypes = subject
+        ? formFieldTypes(subject.spec.fields ?? [])
+        : undefined;
+    spec.assignees.forEach((assignee, index) => {
+        if (assignee.type !== 'FORM_FIELD_USER')
+            return;
+        if (!fieldTypes) {
+            add('NO_SUBJECT_FORM', 'FORM_FIELD_USER needs the state machine to have a subject Form', ['assignees', index], 'Give the state machine a subject, or use another resolver');
+        }
+        else if (fieldTypes.get(assignee.fieldId) !== 'user_select') {
+            add('NOT_A_USER_FIELD', `"${assignee.fieldId}" is not a user_select field of the subject Form`, ['assignees', index, 'fieldId'], 'Reference a user_select field by id');
+        }
+    });
+    return diagnostics;
+}
+//# sourceMappingURL=semantics.js.map

package/dist/semantics.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,52 @@
+/** Persistence of the Assignment definitions an instance pinned, and of the tasks people respond to. */
+import type { DefinitionEnvelope } from '@haneinfo/plugin-api';
+import type { AssignmentSpec } from './types';
+export declare const ASSIGNMENT_STORE: unique symbol;
+export interface BindingRecord {
+    instanceId: string;
+    assignmentCode: string;
+    version: number;
+    definition: DefinitionEnvelope<AssignmentSpec>;
+}
+export type TaskStatus = 'OPEN' | 'RESPONDED' | 'CLOSED' | 'CANCELLED';
+export interface TaskRecord {
+    id: string;
+    instanceId: string;
+    assignmentCode: string;
+    assignmentVersion: number;
+    /** Increments each time the instance re-enters the state and the assignment opens again. */
+    round: number;
+    assigneeId: string;
+    status: TaskStatus;
+    title: string;
+    response: string | null;
+    comment: string | null;
+    dueAt: Date | null;
+    respondedAt: Date | null;
+    createdAt: Date;
+}
+export interface AssignmentStoreTx {
+    saveBindings(bindings: BindingRecord[]): Promise<void>;
+    bindings(instanceId: string): Promise<BindingRecord[]>;
+    createTasks(tasks: Omit<TaskRecord, 'id'>[]): Promise<TaskRecord[]>;
+    task(id: string): Promise<TaskRecord | null>;
+    tasks(filter: {
+        instanceId?: string;
+        assignmentCode?: string;
+        round?: number;
+        assigneeId?: string;
+        status?: TaskStatus;
+    }): Promise<TaskRecord[]>;
+    /** Compare-and-set on status; returns false when it changed meanwhile. */
+    updateTask(id: string, expectedStatus: TaskStatus, patch: Partial<Pick<TaskRecord, 'status' | 'response' | 'comment' | 'respondedAt'>>): Promise<boolean>;
+    lastRound(instanceId: string, assignmentCode: string): Promise<number>;
+}
+export interface AssignmentStore {
+    run<T>(tx: unknown, work: (store: AssignmentStoreTx, tx: unknown) => Promise<T>): Promise<T>;
+}
+/** For tests. A transaction it opens itself rolls back on error. */
+export declare class InMemoryAssignmentStore implements AssignmentStore {
+    private state;
+    run<T>(tx: unknown, work: (store: AssignmentStoreTx, tx: unknown) => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,wGAAwG;AAExG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,eAAO,MAAM,gBAAgB,eAA0C,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;CAChD;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEvE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACvD,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACpE,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC7C,KAAK,CAAC,MAAM,EAAE;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,UAAU,CAAC;KACrB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1B,0EAA0E;IAC1E,UAAU,CACR,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,UAAU,EAC1B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC,CAAC,GAClF,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9F;AA+DD,oEAAoE;AACpE,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,KAAK,CAAuD;IAE9D,GAAG,CAAC,CAAC,EACT,EAAE,EAAE,OAAO,EACX,IAAI,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1D,OAAO,CAAC,CAAC,CAAC;CAUd"}

package/dist/store.js

@@ -0,0 +1,63 @@
+"use strict";
+/** Persistence of the Assignment definitions an instance pinned, and of the tasks people respond to. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryAssignmentStore = exports.ASSIGNMENT_STORE = void 0;
+exports.ASSIGNMENT_STORE = Symbol.for('haneinfo.assignment.store');
+const copy = (value) => structuredClone(value);
+class MemoryTx {
+    constructor(state) {
+        this.state = state;
+    }
+    async saveBindings(bindings) {
+        this.state.bindings.push(...copy(bindings));
+    }
+    async bindings(instanceId) {
+        return this.state.bindings.filter((b) => b.instanceId === instanceId).map(copy);
+    }
+    async createTasks(tasks) {
+        const created = tasks.map((task) => ({ ...copy(task), id: `task_${this.state.nextId++}` }));
+        this.state.tasks.push(...created);
+        return created.map(copy);
+    }
+    async task(id) {
+        const found = this.state.tasks.find((t) => t.id === id);
+        return found ? copy(found) : null;
+    }
+    async tasks(filter) {
+        return this.state.tasks
+            .filter((t) => Object.entries(filter).every(([key, value]) => value === undefined || t[key] === value))
+            .map(copy);
+    }
+    async updateTask(id, expectedStatus, patch) {
+        const found = this.state.tasks.find((t) => t.id === id);
+        if (!found || found.status !== expectedStatus)
+            return false;
+        Object.assign(found, copy(patch));
+        return true;
+    }
+    async lastRound(instanceId, assignmentCode) {
+        return Math.max(0, ...this.state.tasks
+            .filter((t) => t.instanceId === instanceId && t.assignmentCode === assignmentCode)
+            .map((t) => t.round));
+    }
+}
+/** For tests. A transaction it opens itself rolls back on error. */
+class InMemoryAssignmentStore {
+    constructor() {
+        this.state = { bindings: [], tasks: [], nextId: 1 };
+    }
+    async run(tx, work) {
+        if (tx !== undefined)
+            return work(new MemoryTx(this.state), tx);
+        const snapshot = structuredClone(this.state);
+        try {
+            return await work(new MemoryTx(this.state), { inMemory: true });
+        }
+        catch (error) {
+            this.state = snapshot;
+            throw error;
+        }
+    }
+}
+exports.InMemoryAssignmentStore = InMemoryAssignmentStore;
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/testing.d.ts

@@ -0,0 +1,19 @@
+/** `@haneinfo/assignment/testing` — the assignment runtime on in-memory stores, attached to a test state machine. */
+import type { DefinitionKindRegistration, NotificationInboxPort, RbacPolicyPort } from '@haneinfo/plugin-api';
+import { AssignmentService } from './assignment.service';
+import { InMemoryAssignmentStore } from './store';
+export { InMemoryAssignmentStore } from './store';
+export declare function createTestAssignmentRuntime(options?: {
+    kinds?: DefinitionKindRegistration[];
+    rbac?: RbacPolicyPort;
+    clock?: () => Date;
+    notifications?: NotificationInboxPort;
+}): {
+    assignments: AssignmentService;
+    assignmentStore: InMemoryAssignmentStore;
+    runtime: import("@haneinfo/state-machine/dist/runtime.service").StateMachineRuntime;
+    store: import("@haneinfo/state-machine/testing").InMemoryStateMachineStore;
+    registry: import("@haneinfo/definition-registry/dist/definition-registry.service").DefinitionRegistryService;
+    audit: unknown[];
+};
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,qHAAqH;AAErH,OAAO,KAAK,EACV,0BAA0B,EAC1B,qBAAqB,EACrB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAElD,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAElD,wBAAgB,2BAA2B,CACzC,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,0BAA0B,EAAE,CAAC;IACrC,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,aAAa,CAAC,EAAE,qBAAqB,CAAC;CAClC;;;;;;;EAmBP"}

package/dist/testing.js

@@ -0,0 +1,23 @@
+"use strict";
+/** `@haneinfo/assignment/testing` — the assignment runtime on in-memory stores, attached to a test state machine. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryAssignmentStore = void 0;
+exports.createTestAssignmentRuntime = createTestAssignmentRuntime;
+const testing_1 = require("@haneinfo/state-machine/testing");
+const assignment_service_1 = require("./assignment.service");
+const kind_1 = require("./kind");
+const store_1 = require("./store");
+var store_2 = require("./store");
+Object.defineProperty(exports, "InMemoryAssignmentStore", { enumerable: true, get: function () { return store_2.InMemoryAssignmentStore; } });
+function createTestAssignmentRuntime(options = {}) {
+    const base = (0, testing_1.createTestStateMachineRuntime)({
+        kinds: [kind_1.assignmentDefinitionKind, ...(options.kinds ?? [])],
+        rbac: options.rbac,
+        clock: options.clock,
+    });
+    const assignmentStore = new store_1.InMemoryAssignmentStore();
+    const assignments = new assignment_service_1.AssignmentService(assignmentStore, base.runtime, base.registry, options.rbac, options.notifications, options.clock, 'test');
+    assignments.onModuleInit();
+    return { ...base, assignments, assignmentStore };
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":";AAAA,qHAAqH;;;AAcrH,kEAyBC;AAhCD,6DAAgF;AAChF,6DAAyD;AACzD,iCAAkD;AAClD,mCAAkD;AAElD,iCAAkD;AAAzC,gHAAA,uBAAuB,OAAA;AAEhC,SAAgB,2BAA2B,CACzC,UAKI,EAAE;IAEN,MAAM,IAAI,GAAG,IAAA,uCAA6B,EAAC;QACzC,KAAK,EAAE,CAAC,+BAAwB,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3D,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,IAAI,+BAAuB,EAAE,CAAC;IACtD,MAAM,WAAW,GAAG,IAAI,sCAAiB,CACvC,eAAe,EACf,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,QAAQ,EACb,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,aAAa,EACrB,OAAO,CAAC,KAAK,EACb,MAAM,CACP,CAAC;IACF,WAAW,CAAC,YAAY,EAAE,CAAC;IAC3B,OAAO,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;AACnD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+import type { PersonResolver } from '@haneinfo/plugin-api';
+export type AssignmentPolicy = 'SINGLE' | 'ANY_ONE' | 'JOINT';
+export interface AssignmentResponse {
+    key: string;
+    label: string;
+    /** Transition of the state machine this response takes. */
+    transition: string;
+    /** JOINT only: completes the assignment at once. */
+    decisive?: boolean;
+}
+export interface AssignmentSpec {
+    stateMachine: {
+        kind: 'StateMachine';
+        code: string;
+    };
+    onEnter: string;
+    title?: string;
+    assignees: PersonResolver[];
+    policy: AssignmentPolicy;
+    responses: AssignmentResponse[];
+    /** ISO 8601 duration; only marks the due time — a Timer decides what happens. */
+    dueIn?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/examples/definitions/equipment-loan/equipment-manager-approval.assignment.json

@@ -0,0 +1,21 @@
+{
+  "kind": "Assignment",
+  "schemaVersion": 1,
+  "metadata": {
+    "code": "equipment-manager-approval",
+    "name": "Approve equipment loan",
+    "description": "Any equipment manager approves or rejects a submitted loan within two days."
+  },
+  "spec": {
+    "stateMachine": { "kind": "StateMachine", "code": "equipment-loan-flow" },
+    "onEnter": "SUBMITTED",
+    "title": "Equipment loan waiting for approval",
+    "assignees": [{ "type": "ROLE", "role": "EQUIPMENT_MANAGER" }],
+    "policy": "ANY_ONE",
+    "responses": [
+      { "key": "approve", "label": "Approve", "transition": "approve" },
+      { "key": "reject", "label": "Reject", "transition": "reject" }
+    ],
+    "dueIn": "P2D"
+  }
+}

package/haneinfo.plugin.json

@@ -0,0 +1,70 @@
+{
+  "schemaVersion": "haneinfo.plugin/v1",
+  "id": "assignment",
+  "displayName": "Assignment",
+  "cardinality": "singleton",
+  "distribution": "official",
+  "engine": {
+    "haneinfoPluginApi": "^1.6.0",
+    "node": ">=22.0.0",
+    "frameworks": {
+      "@nestjs/common": "^11.0.5",
+      "@nestjs/core": "^11.0.5",
+      "@prisma/client": "^6.2.0"
+    }
+  },
+  "provides": [],
+  "requires": [
+    "haneinfo.prisma",
+    "haneinfo.principal-context",
+    "haneinfo.definition-registry",
+    "haneinfo.state-machine-runtime"
+  ],
+  "optionalRequires": ["haneinfo.rbac-policy", "haneinfo.notification-inbox"],
+  "facets": {
+    "backend": {
+      "modulePath": "./dist/assignment.module.js",
+      "exportName": "AssignmentModule",
+      "controllerRoutes": ["assignments"],
+      "definitionKinds": [
+        {
+          "kind": "Assignment",
+          "schemaVersion": 1,
+          "specSchema": "schemas/assignment.spec.json",
+          "displayName": "Assignment"
+        }
+      ],
+      "mcpTools": [
+        {
+          "name": "list_my_assignments",
+          "requiredScopes": ["{namespace}:assignment:read"]
+        }
+      ],
+      "events": [
+        {
+          "type": "assignment.opened",
+          "schemaVersion": 1,
+          "description": "Tasks were opened; payload has assignmentCode, round, dueAt, assigneeIds"
+        },
+        {
+          "type": "assignment.closed",
+          "schemaVersion": 1,
+          "description": "The round completed or was cancelled; payload has assignmentCode, round, outcome"
+        }
+      ],
+      "agentGuide": "./agent-guide.md"
+    },
+    "prisma": {
+      "owns": ["AssignmentBinding", "AssignmentTask"],
+      "schemaFragment": "prisma/assignment.prisma",
+      "schemaDigest": "sha256:9f959ee518aac39217503bc666d06ec4aec444dadeb47a9204fd19425f6108d0"
+    },
+    "permissions": {
+      "definitions": [
+        "assignment:definition:read",
+        "assignment:definition:write",
+        "assignment:definition:publish"
+      ]
+    }
+  }
+}

package/package.json

@@ -1,6 +1,84 @@
 {
   "name": "@haneinfo/assignment",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "private": false,
+  "description": "Assignment mechanism: Assignment definitions (who must respond when a state machine enters a state) and the task runtime, registered with @haneinfo/definition-registry.",
+  "files": [
+    "dist",
+    "examples",
+    "schemas",
+    "prisma",
+    "agent-guide.md",
+    "haneinfo.plugin.json",
+    "plugin.js",
+    "plugin.d.ts",
+    "testing.js",
+    "testing.d.ts"
+  ],
+  "type": "commonjs",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "default": "./dist/plugin.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    },
+    "./schemas/assignment.spec.json": "./schemas/assignment.spec.json",
+    "./prisma/assignment.prisma": "./prisma/assignment.prisma",
+    "./haneinfo.plugin.json": "./haneinfo.plugin.json",
+    "./agent-guide.md": "./agent-guide.md",
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@haneinfo/plugin-api": "1.6.0"
+  },
+  "peerDependencies": {
+    "@haneinfo/common": "^0.3.4",
+    "@haneinfo/definition-registry": "^0.1.0",
+    "@haneinfo/state-machine": "^0.1.0",
+    "@haneinfo/plugin-host-nest": "^2.0.0",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@prisma/client": "^6.19.0",
+    "zod": "^4.4.0"
+  },
+  "peerDependenciesMeta": {
+    "@haneinfo/definition-registry": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@prisma/client": "^6.19.0",
+    "@types/node": "^24.13.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11",
+    "zod": "^4.4.0",
+    "@haneinfo/definition-registry": "0.1.0",
+    "@haneinfo/common": "0.3.4",
+    "@haneinfo/form": "0.1.0",
+    "@haneinfo/plugin-host-nest": "2.1.0",
+    "@haneinfo/state-machine": "0.1.0",
+    "@haneinfo/plugin-testkit": "2.3.0"
+  },
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
 }

package/plugin.d.ts

@@ -0,0 +1,2 @@
+// See plugin.js for why this file exists (classic/node10 moduleResolution compatibility shim).
+export * from './dist/plugin';

package/plugin.js

@@ -0,0 +1,4 @@
+// Compatibility shim for consumers whose TypeScript config uses "classic"/"node10"
+// moduleResolution, which resolves `@haneinfo/assignment/plugin` by looking for a real file
+// at the package root -- it does not consult package.json's "exports" map at all.
+module.exports = require('./dist/plugin');

package/prisma/assignment.prisma

@@ -0,0 +1,32 @@
+/// The Assignment definitions a state-machine instance pinned when it started. @internal
+model AssignmentBinding {
+  instanceId     String @map("instance_id")
+  assignmentCode String @map("assignment_code")
+  version        Int
+  definition     Json
+
+  @@id([instanceId, assignmentCode])
+  @@map("assignment_bindings")
+}
+
+/// One person's task in one round of an assignment. Status is compare-and-set. @internal
+model AssignmentTask {
+  id                String    @id @default(cuid())
+  instanceId        String    @map("instance_id")
+  assignmentCode    String    @map("assignment_code")
+  assignmentVersion Int       @map("assignment_version")
+  round             Int
+  assigneeId        String    @map("assignee_id")
+  /// OPEN, RESPONDED, CLOSED (decided by someone else) or CANCELLED (the instance left the state).
+  status            String
+  title             String
+  response          String?
+  comment           String?
+  dueAt             DateTime? @map("due_at")
+  respondedAt       DateTime? @map("responded_at")
+  createdAt         DateTime  @default(now()) @map("created_at")
+
+  @@index([assigneeId, status])
+  @@index([instanceId, assignmentCode, round])
+  @@map("assignment_tasks")
+}