@hunsu/protocol 0.1.0

package/dist/model.js

@@ -0,0 +1 @@
+export {};

package/dist/primitives.d.ts

@@ -0,0 +1,59 @@
+import { type Result } from "./result.ts";
+export type Brand<T, Name extends string> = T & {
+    readonly __brand: Name;
+};
+export type NonEmptyText = Brand<string, "NonEmptyText">;
+export type RequestTitle = Brand<string, "RequestTitle">;
+export type RequestGoal = Brand<string, "RequestGoal">;
+export type DestinationTitle = Brand<string, "DestinationTitle">;
+export type DestinationAcceptanceCriterion = Brand<string, "DestinationAcceptanceCriterion">;
+export type DestinationConstraint = Brand<string, "DestinationConstraint">;
+export type DestinationNotes = Brand<string, "DestinationNotes">;
+export type Summary = Brand<string, "Summary">;
+export type EvidenceText = Brand<string, "EvidenceText">;
+export type FailureReason = Brand<string, "FailureReason">;
+export type RiskText = Brand<string, "RiskText">;
+export type MoveCommit = Brand<string, "MoveCommit">;
+export type TeamName = Brand<string, "TeamName">;
+export type PositiveInteger = Brand<number, "PositiveInteger">;
+export type NonNegativeInteger = Brand<number, "NonNegativeInteger">;
+export type NonEmptyArray<T> = [T, ...T[]];
+export type SingleItemArray<T> = [T];
+export type PrimitiveValidationError = {
+    type: "PrimitiveValidationError";
+    field: string;
+    message: string;
+};
+export declare function makeNonEmptyText(value: unknown, field?: string): Result<NonEmptyText, PrimitiveValidationError>;
+export declare function makeRequestTitle(value: unknown): Result<RequestTitle, PrimitiveValidationError>;
+export declare function makeRequestGoal(value: unknown): Result<RequestGoal, PrimitiveValidationError>;
+export declare function makeDestinationTitle(value: unknown, field?: string): Result<DestinationTitle, PrimitiveValidationError>;
+export declare function makeDestinationAcceptanceCriterion(value: unknown, field?: string): Result<DestinationAcceptanceCriterion, PrimitiveValidationError>;
+export declare function makeDestinationConstraint(value: unknown, field?: string): Result<DestinationConstraint, PrimitiveValidationError>;
+export declare function makeDestinationNotes(value: unknown, field?: string): Result<DestinationNotes, PrimitiveValidationError>;
+export declare function makeSummary(value: unknown, field?: string): Result<Summary, PrimitiveValidationError>;
+export declare function makeEvidenceText(value: unknown, field?: string): Result<EvidenceText, PrimitiveValidationError>;
+export declare function makeFailureReason(value: unknown, field?: string): Result<FailureReason, PrimitiveValidationError>;
+export declare function makeRiskText(value: unknown, field?: string): Result<RiskText, PrimitiveValidationError>;
+export declare function makeMoveCommit(value: unknown, field?: string): Result<MoveCommit, PrimitiveValidationError>;
+export declare function makeTeamName(value: unknown, field?: string): Result<TeamName, PrimitiveValidationError>;
+export declare function makePositiveInteger(value: unknown, field?: string): Result<PositiveInteger, PrimitiveValidationError>;
+export declare function makeNonNegativeInteger(value: unknown, field?: string): Result<NonNegativeInteger, PrimitiveValidationError>;
+export declare function makeNonEmptyArray<T>(value: T[], field?: string): Result<NonEmptyArray<T>, PrimitiveValidationError>;
+export declare function makeSingleItemArray<T>(value: T[], field?: string): Result<SingleItemArray<T>, PrimitiveValidationError>;
+export declare function makeDomainId<T extends string>(value: unknown, field: string): Result<Brand<string, T>, PrimitiveValidationError>;
+export declare function makeRequestId(value: unknown): Result<Brand<string, "RequestId">, PrimitiveValidationError>;
+export declare function makeDestinationId(value: unknown): Result<Brand<string, "DestinationId">, PrimitiveValidationError>;
+export declare function makeMoveId(value: unknown): Result<Brand<string, "MoveId">, PrimitiveValidationError>;
+export declare function makeHunsuId(value: unknown): Result<Brand<string, "HunsuId">, PrimitiveValidationError>;
+export declare function makeHunsuDraftId(value: unknown): Result<Brand<string, "HunsuDraftId">, PrimitiveValidationError>;
+export declare function makeLineId(value: unknown): Result<Brand<string, "LineId">, PrimitiveValidationError>;
+export declare function makeNodeId(value: unknown): Result<Brand<string, "NodeId">, PrimitiveValidationError>;
+export declare function makeArtifactId(value: unknown): Result<Brand<string, "ArtifactId">, PrimitiveValidationError>;
+export declare function makeArtifactActionId(value: unknown): Result<Brand<string, "ArtifactActionId">, PrimitiveValidationError>;
+export declare function makeTeamId(value: unknown): Result<Brand<string, "TeamId">, PrimitiveValidationError>;
+export declare function makeSkillDraftId(value: unknown): Result<Brand<string, "SkillDraftId">, PrimitiveValidationError>;
+export declare function makeAgentConversationHash(value: unknown): Result<Brand<string, "AgentConversationHash">, PrimitiveValidationError>;
+export declare function makeExecuteId(value: unknown): Result<Brand<string, "ExecuteId">, PrimitiveValidationError>;
+export declare function makeRouteId(value: unknown): Result<Brand<string, "RouteId">, PrimitiveValidationError>;
+export declare function makeWorktreeHash(value: unknown): Result<Brand<string, "WorktreeHash">, PrimitiveValidationError>;

package/dist/primitives.js

@@ -0,0 +1,135 @@
+import { err, ok } from "./result.js";
+export function makeNonEmptyText(value, field = "text") {
+    if (typeof value !== "string" || value.trim() === "") {
+        return invalid(field, `${field} must be a non-empty string`);
+    }
+    return ok(value);
+}
+export function makeRequestTitle(value) {
+    return makeTextBrand(value, "title");
+}
+export function makeRequestGoal(value) {
+    return makeTextBrand(value, "goal");
+}
+export function makeDestinationTitle(value, field = "title") {
+    return makeTextBrand(value, field);
+}
+export function makeDestinationAcceptanceCriterion(value, field = "acceptanceCriterion") {
+    return makeTextBrand(value, field);
+}
+export function makeDestinationConstraint(value, field = "constraint") {
+    return makeTextBrand(value, field);
+}
+export function makeDestinationNotes(value, field = "notes") {
+    return makeTextBrand(value, field);
+}
+export function makeSummary(value, field = "summary") {
+    return makeTextBrand(value, field);
+}
+export function makeEvidenceText(value, field = "evidence") {
+    return makeTextBrand(value, field);
+}
+export function makeFailureReason(value, field = "failureReason") {
+    return makeTextBrand(value, field);
+}
+export function makeRiskText(value, field = "risk") {
+    return makeTextBrand(value, field);
+}
+export function makeMoveCommit(value, field = "commit") {
+    return makeTextBrand(value, field);
+}
+export function makeTeamName(value, field = "teamName") {
+    return makeTextBrand(value, field);
+}
+export function makePositiveInteger(value, field = "number") {
+    if (!Number.isInteger(value) || Number(value) < 1) {
+        return invalid(field, `${field} must be a positive integer`);
+    }
+    return ok(value);
+}
+export function makeNonNegativeInteger(value, field = "number") {
+    if (!Number.isInteger(value) || Number(value) < 0) {
+        return invalid(field, `${field} must be a non-negative integer`);
+    }
+    return ok(value);
+}
+export function makeNonEmptyArray(value, field = "array") {
+    if (value.length === 0) {
+        return invalid(field, `${field} must include at least one item`);
+    }
+    return ok(value);
+}
+export function makeSingleItemArray(value, field = "array") {
+    if (value.length !== 1) {
+        return invalid(field, `${field} must include exactly one item`);
+    }
+    return ok(value);
+}
+export function makeDomainId(value, field) {
+    const text = makeNonEmptyText(value, field);
+    if (!text.ok) {
+        return text;
+    }
+    if (/\s/.test(text.value)) {
+        return invalid(field, `${field} must not contain whitespace`);
+    }
+    return ok(text.value);
+}
+export function makeRequestId(value) {
+    return makeDomainId(value, "requestId");
+}
+export function makeDestinationId(value) {
+    return makeDomainId(value, "destinationId");
+}
+export function makeMoveId(value) {
+    return makeDomainId(value, "moveId");
+}
+export function makeHunsuId(value) {
+    return makeDomainId(value, "hunsuId");
+}
+export function makeHunsuDraftId(value) {
+    return makeDomainId(value, "hunsuDraftId");
+}
+export function makeLineId(value) {
+    return makeDomainId(value, "lineId");
+}
+export function makeNodeId(value) {
+    return makeDomainId(value, "nodeId");
+}
+export function makeArtifactId(value) {
+    return makeDomainId(value, "artifactId");
+}
+export function makeArtifactActionId(value) {
+    return makeDomainId(value, "artifactActionId");
+}
+export function makeTeamId(value) {
+    return makeDomainId(value, "teamId");
+}
+export function makeSkillDraftId(value) {
+    return makeDomainId(value, "skillDraftId");
+}
+export function makeAgentConversationHash(value) {
+    return makeDomainId(value, "agentConversationHash");
+}
+export function makeExecuteId(value) {
+    return makeDomainId(value, "executeId");
+}
+export function makeRouteId(value) {
+    return makeDomainId(value, "routeId");
+}
+export function makeWorktreeHash(value) {
+    return makeDomainId(value, "worktreeHash");
+}
+function invalid(field, message) {
+    return err({ type: "PrimitiveValidationError", field, message });
+}
+function makeTextBrand(value, field) {
+    const text = makeNonEmptyText(value, field);
+    return text.ok ? ok(text.value) : text;
+}
+function makeStringBrand(value, field) {
+    if (typeof value !== "string") {
+        return invalid(field, `${field} must be a string`);
+    }
+    return ok(value);
+}

package/dist/projection.d.ts

@@ -0,0 +1,8 @@
+import { type DomainWorkflowError } from "./errors.ts";
+import type { BoardProjection, DomainEvent } from "./model.ts";
+import { type Result } from "./result.ts";
+export declare function emptyBoardProjection(): BoardProjection;
+export declare function projectBoard(events: DomainEvent[]): BoardProjection;
+export declare function tryProjectBoard(events: DomainEvent[]): Result<BoardProjection, DomainWorkflowError>;
+export declare function validateEventStream(events: DomainEvent[]): Result<DomainEvent[], DomainWorkflowError>;
+export declare function projectEvent(state: BoardProjection, event: DomainEvent): BoardProjection;