@astrale-domains/issues 0.1.1

package/README.md

@@ -0,0 +1,36 @@
+# Issues Domain
+
+`issues.astrale.ai` owns caller-scoped Trackers, numbered Issues, Comments, Tags, Issue relations, and replay-safe command receipts.
+
+This is a current Astrale Application, not the former repository/module abstraction:
+
+```text
+schema/       public Classes, relationships, Functions, and application View
+states/       closed Issue lifecycle
+rules/        pure normalization, transitions, and receipt decisions
+queries/      named owner-scoped graph observations
+mutations/    atomic graph changes and receipt preconditions
+actions/      one-operation list handler
+workflows/    authorization observation, replay, and Mutation coordination
+views/        Shell-bound Tracker projection
+ui/           Domain-free presentation
+frontend/     Vite and TanStack Router application
+```
+
+Every mutation creates a `Command` receipt in the same MutationAST as its business change. The receipt key is scoped through `command_requested_by`; its mutation precondition proves the key is unused. A repeated call reads the receipt, verifies the kind and fingerprint, and returns the retained target rather than submitting the change again. Reusing a key for different input fails closed.
+
+The deleted Events Domain is not replaced by a fake package or hidden adapter. Issues no longer owns an Events outbox. Event publication can return later only as an explicit provider-neutral Integration with a real consumer and delivery contract.
+
+## Development
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm test
+pnpm lint
+pnpm frontend:build
+pnpm build
+pnpm package
+```
+
+Domain source imports Kernel concepts through semantic `@astrale-os/sdk/*` facades and owns no `.spec` tree.

package/dist/schema/application/functions.js

@@ -0,0 +1,156 @@
+import { func } from '@astrale-os/sdk/schema';
+import { z } from 'zod';
+const id = z.string().min(1);
+const idempotencyKey = z.string().min(1).max(200);
+const status = z.enum(['open', 'in_progress', 'resolved', 'canceled']);
+const priority = z.number().int().min(0).max(4);
+const tracker = z.strictObject({
+    id,
+    key: z.string().min(2).max(10),
+    name: z.string().min(1),
+    description: z.string(),
+});
+const issue = z.strictObject({
+    id,
+    reference: z.string().min(1),
+    title: z.string().min(1),
+    description: z.string(),
+    status,
+    priority,
+});
+const comment = z.strictObject({ id, body: z.string().min(1) });
+const tag = z.strictObject({
+    id,
+    name: z.string().min(1),
+    slug: z.string().min(1),
+    color: z.string().optional(),
+});
+export const listTrackers = func({
+    description: 'List Trackers owned by the authenticated caller.',
+    auth: 'authenticated',
+    input: z.strictObject({}),
+    output: z.array(tracker),
+});
+export const createTracker = func({
+    description: 'Create one caller-owned Tracker.',
+    auth: 'authenticated',
+    input: z.strictObject({
+        key: z.string().min(1),
+        name: z.string().min(1).max(120),
+        description: z.string().max(5_000).optional(),
+        idempotencyKey,
+    }),
+    output: tracker,
+});
+export const listIssues = func({
+    description: 'List Issues in one caller-owned Tracker.',
+    auth: 'authenticated',
+    input: z.strictObject({ trackerId: id }),
+    output: z.array(issue),
+});
+export const createIssue = func({
+    description: 'Create one numbered Issue in a caller-owned Tracker.',
+    auth: 'authenticated',
+    input: z.strictObject({
+        trackerId: id,
+        title: z.string().min(1).max(200),
+        description: z.string().max(50_000).optional(),
+        priority: priority.optional(),
+        idempotencyKey,
+    }),
+    output: issue,
+});
+export const updateIssue = func({
+    description: 'Update one caller-owned Issue.',
+    auth: 'authenticated',
+    input: z.strictObject({
+        issueId: id,
+        title: z.string().min(1).max(200).optional(),
+        description: z.string().max(50_000).optional(),
+        status: status.optional(),
+        priority: priority.optional(),
+        idempotencyKey,
+    }),
+    output: issue,
+});
+export const deleteIssue = func({
+    description: 'Delete one caller-owned Issue.',
+    auth: 'authenticated',
+    input: z.strictObject({ issueId: id, idempotencyKey }),
+    output: z.strictObject({ deleted: z.literal(true) }),
+});
+export const addComment = func({
+    description: 'Add one Comment to a caller-owned Issue.',
+    auth: 'authenticated',
+    input: z.strictObject({ issueId: id, body: z.string().min(1).max(50_000), idempotencyKey }),
+    output: comment,
+});
+export const editComment = func({
+    description: 'Edit one Comment in a caller-owned Tracker.',
+    auth: 'authenticated',
+    input: z.strictObject({ commentId: id, body: z.string().min(1).max(50_000), idempotencyKey }),
+    output: comment,
+});
+export const deleteComment = func({
+    description: 'Delete one Comment in a caller-owned Tracker.',
+    auth: 'authenticated',
+    input: z.strictObject({ commentId: id, idempotencyKey }),
+    output: z.strictObject({ deleted: z.literal(true) }),
+});
+export const createTag = func({
+    description: 'Create one Tag in a caller-owned Tracker.',
+    auth: 'authenticated',
+    input: z.strictObject({
+        trackerId: id,
+        name: z.string().min(1).max(64),
+        color: z.string().optional(),
+        idempotencyKey,
+    }),
+    output: tag,
+});
+export const editTag = func({
+    description: 'Edit one Tag in a caller-owned Tracker.',
+    auth: 'authenticated',
+    input: z.strictObject({
+        tagId: id,
+        name: z.string().min(1).max(64).optional(),
+        color: z.string().optional(),
+        idempotencyKey,
+    }),
+    output: tag,
+});
+export const deleteTag = func({
+    description: 'Delete one Tag in a caller-owned Tracker.',
+    auth: 'authenticated',
+    input: z.strictObject({ tagId: id, idempotencyKey }),
+    output: z.strictObject({ deleted: z.literal(true) }),
+});
+export const changeIssueTag = func({
+    description: 'Add or remove a Tracker-local Tag on an Issue.',
+    auth: 'authenticated',
+    input: z.strictObject({
+        issueId: id,
+        tagId: id,
+        change: z.enum(['add', 'remove']),
+        idempotencyKey,
+    }),
+    output: z.strictObject({ issueId: id, changed: z.boolean() }),
+});
+export const relateIssue = func({
+    description: 'Add or remove one relation between caller-owned Issues.',
+    auth: 'authenticated',
+    input: z.strictObject({
+        issueId: id,
+        targetId: id,
+        relation: z.enum(['blocks', 'duplicates', 'relates_to', 'subtask_of']),
+        change: z.enum(['add', 'remove']),
+        idempotencyKey,
+    }),
+    output: z.strictObject({ issueId: id, changed: z.boolean() }),
+});
+export const exportTracker = func({
+    description: 'Export the current visible Issue snapshot for one Tracker.',
+    auth: 'authenticated',
+    input: z.strictObject({ trackerId: id }),
+    output: z.strictObject({ issues: z.array(issue) }),
+});