@astrale-domains/issues 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.1.4](https://github.com/astrale-os/domains/compare/issues-v0.1.3...issues-v0.1.4) (2026-08-29)
+
+
+### Features
+
+* **domains:** remove Property visibility annotations from V1 schemas ([#118](https://github.com/astrale-os/domains/issues/118)) ([215e5e0](https://github.com/astrale-os/domains/commit/215e5e0ca3b849cb56fcccc685d4e3fc51cc41f5))
+* **issues:** restore native reporting continuity ([#119](https://github.com/astrale-os/domains/issues/119)) ([4c0738d](https://github.com/astrale-os/domains/commit/4c0738d05fb5b1281b1d480376960fd494b98840))
+* **states:** adopt intrinsic property transitions ([#108](https://github.com/astrale-os/domains/issues/108)) ([0d137c2](https://github.com/astrale-os/domains/commit/0d137c2832e8f9b732b337086ccb17ad0c49bb4e))
+
 ## [0.1.3](https://github.com/astrale-os/domains/compare/issues-v0.1.2...issues-v0.1.3) (2026-08-27)
 
 

package/README.md

@@ -22,10 +22,11 @@ Tag
   name; Project-local slug; optional color; belongs to one Project
 ```
 
-The public mutation surface is receiver-owned:
+The public callable surface keeps observation Project-owned and mutations receiver-owned:
 
 ```text
 Project.create
+Project.list
 Project.update | addMember | removeMember | createIssue | createTag | archive
 Issue.update | assign | setTags | setParent | addComment | archive
 Comment.edit | delete
@@ -37,20 +38,23 @@ execution ceiling after its containment and Node removals. Larger Tags must firs
 enough Issues through `Issue.setTags`; the Workflow rejects them explicitly instead of submitting an
 oversized Mutation with a backend-dependent failure.
 
-`Project.create` requires authentication. Receiver Methods use Schema-owned Policies: Project owners
-administer metadata, membership, Tags, and archival; owners and members contribute to Issues; only a
-Comment author edits or deletes it. Reads are visible only through a Project the caller owns or has
-joined.
+`Project.create` and `Project.list` require authentication. `Project.list` returns only Projects the
+caller owns or has joined, with their visible Issues and Comment threads nested for one CLI/agent
+observation. Receiver Methods use Schema-owned Policies: Project owners administer metadata,
+membership, Tags, and archival; owners and members contribute to Issues; only a Comment author edits
+or deletes it. Reads are visible only through a Project the caller owns or has joined.
 
 Ownership, membership, reporting, assignment, and authorship remain graph-native Policy facts. The
 owning Project, Issue, or Comment also stores the corresponding Identity IDs privately, updated in
-the same atomic Mutation as each edge. Recipes and Workflows can therefore validate current collaboration state
-without requesting authority over every possible concrete Identity subtype from another Domain.
+the same atomic Mutation as each edge. Recipes and Workflows can therefore validate current
+collaboration state without requesting authority over every possible concrete Identity subtype from
+another Domain.
 Those private execution fields are not a second public model and never replace the Policy edges.
 
 There is no Domain `Command`, receipt, universal idempotency layer, activity log, or undo system.
-`Project.create` is one Action; the sixteen multi-step receiver operations are explicit Workflows
-whose Query and Mutation effects use stable steps. Set-style changes converge naturally and stale
+`Project.create` and `Project.list` are Actions; the seventeen multi-step receiver operations are
+explicit Workflows whose Query and Mutation effects use stable steps. Set-style changes converge
+naturally and stale
 concurrent writes reject through atomic Mutation preconditions. Creation retries have no Domain
 replay guarantee; generic invocation idempotency belongs to the platform when it exists.
 
@@ -63,16 +67,6 @@ shortcuts whenever the user is not typing. The selected Issue description and it
 inbox as one continuous Markdown conversation with strict Mermaid diagrams. Project, Issue, and Tag
 creation and Project membership administration intentionally remain API-first.
 
-## Breaking migration
-
-`Tracker` to `Project`, the status revision (`in_progress` to `accepted`, `canceled` to `closed`, and
-the new `deferred` outcome), receiver Methods, and Command removal are one
-deliberate breaking revision. A reinstall does not migrate installed graph keys. Use the private
-[legacy snapshot/import workflow](https://github.com/astrale-os/domains/tree/main/issues/scripts/legacy-issues-import)
-before production cutover. It retains excluded source data for audit, deprovisions the exact
-digest-confirmed legacy graph before uninstall, and replays owner-authored legacy aggregates through
-the supported public Project receiver API while writing step-level old-to-new Node ID checkpoints.
-
 ## Development
 
 Dependency changes must refresh both `issues/pnpm-lock.yaml` and the workspace-root `pnpm-lock.yaml`;

package/dist/schema/.runtime/states/issue/index.d.ts

@@ -1,5 +1,5 @@
-import { type EventOf, type StateOf, type TransitionDecision } from '@astrale-os/sdk/state';
-export declare const issueLifecycle: import("@astrale-os/sdk/state").StateMachine<{
+import { type EventOf, type StateOf } from '@astrale-os/sdk/state';
+export declare const issueStatus: import("@astrale-os/sdk/state").StateMachine<{
     readonly open: {
         readonly accept: "accepted";
         readonly defer: "deferred";
@@ -23,8 +23,5 @@ export declare const issueLifecycle: import("@astrale-os/sdk/state").StateMachin
         readonly reopen: "open";
     };
 }, "open">;
-export type IssueStatus = StateOf<typeof issueLifecycle>;
-export type IssueEvent = EventOf<typeof issueLifecycle>;
-export type AllowedIssueTransition = Extract<TransitionDecision<typeof issueLifecycle, IssueStatus, IssueEvent>, {
-    readonly kind: 'allowed';
-}>;
+export type IssueStatus = StateOf<typeof issueStatus>;
+export type IssueEvent = EventOf<typeof issueStatus>;

package/dist/schema/.runtime/states/issue/index.js

@@ -1,5 +1,5 @@
-import { stateMachine, } from '@astrale-os/sdk/state';
-export const issueLifecycle = stateMachine({
+import { stateMachine } from '@astrale-os/sdk/state';
+export const issueStatus = stateMachine({
     initial: 'open',
     transitions: {
         open: { accept: 'accepted', defer: 'deferred', close: 'closed' },

package/dist/schema/index.d.ts

@@ -1,6 +1,6 @@
 export { schema } from './schema.js';
 export type { IssuesDomain, IssuesSchema } from './schema.js';
-export { Comment, comment_authored_by, issue_has_comment } from './comment/index.js';
-export { Issue, issue_assigned_to, issue_reported_by, issue_subtask_of, project_contains_issue, } from './issue/index.js';
-export { Project, project_has_member, project_owned_by } from './project/index.js';
-export { Tag, issue_tagged_with, project_contains_tag } from './tag/index.js';
+export { Project, project_has_member, project_owned_by } from './modules/project/index.js';
+export { Issue, issue_assigned_to, issue_reported_by, issue_subtask_of, project_contains_issue, } from './modules/issue/index.js';
+export { Comment, comment_authored_by, issue_has_comment } from './modules/comment/index.js';
+export { Tag, issue_tagged_with, project_contains_tag } from './modules/tag/index.js';

package/dist/schema/index.js

@@ -1,5 +1,5 @@
 export { schema } from './schema.js';
-export { Comment, comment_authored_by, issue_has_comment } from './comment/index.js';
-export { Issue, issue_assigned_to, issue_reported_by, issue_subtask_of, project_contains_issue, } from './issue/index.js';
-export { Project, project_has_member, project_owned_by } from './project/index.js';
-export { Tag, issue_tagged_with, project_contains_tag } from './tag/index.js';
+export { Project, project_has_member, project_owned_by } from './modules/project/index.js';
+export { Issue, issue_assigned_to, issue_reported_by, issue_subtask_of, project_contains_issue, } from './modules/issue/index.js';
+export { Comment, comment_authored_by, issue_has_comment } from './modules/comment/index.js';
+export { Tag, issue_tagged_with, project_contains_tag } from './modules/tag/index.js';

package/dist/schema/{comment/relationships.d.ts → modules/comment/classes/comment-authored-by.d.ts}

@@ -1,19 +1,3 @@
-export declare const issue_has_comment: import("@astrale-os/sdk/schema").DirectedEdgeClass<{
-    readonly depth: 0;
-    readonly abstract: false;
-    readonly extends: readonly [];
-    readonly properties: never;
-    readonly source: {
-        readonly as: "issue";
-        readonly outgoing: "0..*";
-    };
-    readonly target: {
-        readonly as: "comment";
-        readonly incoming: "1";
-    };
-    readonly constraints: Record<never, never>;
-    readonly effectiveProperties: never;
-}>;
 export declare const comment_authored_by: import("@astrale-os/sdk/schema").DirectedEdgeClass<{
     readonly depth: 0;
     readonly abstract: false;

package/dist/schema/modules/comment/classes/comment-authored-by.js

@@ -0,0 +1,9 @@
+import { K, edgeClass } from '@astrale-os/sdk/schema';
+import { TraverseCommentRelationship } from '../policies/traverse-comment-relationship.js';
+import { Comment } from './comment.js';
+export const comment_authored_by = edgeClass.directed({
+    description: 'The immutable author of one Comment.',
+    source: { as: 'author', accepts: [K.classes.Identity], outgoing: '0..*' },
+    target: { as: 'comment', accepts: [() => Comment], incoming: '1' },
+    policies: { traverse: () => TraverseCommentRelationship },
+});

package/dist/schema/{comment/class.d.ts → modules/comment/classes/comment.d.ts}

@@ -63,4 +63,4 @@ export declare const Comment: import("@astrale-os/sdk/schema").NodeClass<{
         };
     }, "authorized", false, "default">>, "edit", "self">;
     readonly effectiveStaticMethods: never;
-}>;
+}> & import("@astrale-os/sdk/schema").StateClass<Readonly<Omit<Readonly<Record<never, never>>, never> & {}>>;

package/dist/schema/{comment/class.js → modules/comment/classes/comment.js}

@@ -1,15 +1,16 @@
 import { K, nodeClass, property } from '@astrale-os/sdk/schema';
 import { z } from 'zod';
-import { nodeIdValue } from '../value/index.js';
-import { ContributeToComment } from './contribute-to-comment-policy.js';
-import { deleteCommentMethod, editCommentMethod } from './methods.js';
+import { nodeIdValue } from '../../../types/index.js';
+import { deleteCommentMethod } from '../functions/delete-comment.js';
+import { editCommentMethod } from '../functions/edit-comment.js';
+import { ContributeToComment } from '../policies/contribute-to-comment.js';
 export const Comment = nodeClass({
     description: 'One authored discussion entry attached to an Issue.',
     icon: 'message-square',
     extends: [K.classes.Timestamped],
     properties: {
         body: z.string().min(1).max(50_000),
-        authorId: property(nodeIdValue, { visibility: 'private' }),
+        authorId: property(nodeIdValue, {}),
     },
     methods: { edit: editCommentMethod, delete: deleteCommentMethod },
     policies: { read: () => ContributeToComment },

package/dist/schema/modules/comment/classes/index.d.ts

@@ -0,0 +1,3 @@
+export { comment_authored_by } from './comment-authored-by.js';
+export { Comment } from './comment.js';
+export { issue_has_comment } from './issue-has-comment.js';

package/dist/schema/modules/comment/classes/index.js

@@ -0,0 +1,3 @@
+export { comment_authored_by } from './comment-authored-by.js';
+export { Comment } from './comment.js';
+export { issue_has_comment } from './issue-has-comment.js';

package/dist/schema/modules/comment/classes/issue-has-comment.d.ts

@@ -0,0 +1,16 @@
+export declare const issue_has_comment: import("@astrale-os/sdk/schema").DirectedEdgeClass<{
+    readonly depth: 0;
+    readonly abstract: false;
+    readonly extends: readonly [];
+    readonly properties: never;
+    readonly source: {
+        readonly as: "issue";
+        readonly outgoing: "0..*";
+    };
+    readonly target: {
+        readonly as: "comment";
+        readonly incoming: "1";
+    };
+    readonly constraints: Record<never, never>;
+    readonly effectiveProperties: never;
+}>;

package/dist/schema/modules/comment/classes/issue-has-comment.js

@@ -0,0 +1,10 @@
+import { edgeClass } from '@astrale-os/sdk/schema';
+import { Issue } from '../../issue/index.js';
+import { TraverseIssueComment } from '../policies/traverse-issue-comment.js';
+import { Comment } from './comment.js';
+export const issue_has_comment = edgeClass.directed({
+    description: 'One Issue contains one Comment.',
+    source: { as: 'issue', accepts: [() => Issue], outgoing: '0..*' },
+    target: { as: 'comment', accepts: [() => Comment], incoming: '1' },
+    policies: { traverse: () => TraverseIssueComment },
+});

package/dist/schema/modules/comment/functions/delete-comment.d.ts

@@ -0,0 +1,7 @@
+export declare const deleteCommentMethod: import("@astrale-os/sdk/schema").Method<import("@astrale-os/sdk/schema").CallableProjection<Record<string, never>, {
+    readonly mode: 'value';
+    readonly value: {
+        commentId: string;
+        deleted: true;
+    };
+}, "authorized", false, "default">>;

package/dist/schema/modules/comment/functions/delete-comment.js

@@ -0,0 +1,11 @@
+import { method } from '@astrale-os/sdk/schema';
+import { z } from 'zod';
+import { nodeIdValue } from '../../../types/index.js';
+import { EditOwnComment } from '../policies/edit-own-comment.js';
+export const deleteCommentMethod = method({
+    description: 'Delete this Comment as its author.',
+    auth: 'authorized',
+    policy: ({ check, self }) => check(EditOwnComment, self),
+    input: z.strictObject({}),
+    output: z.strictObject({ commentId: nodeIdValue, deleted: z.literal(true) }),
+});

package/dist/schema/modules/comment/functions/edit-comment.d.ts

@@ -0,0 +1,9 @@
+export declare const editCommentMethod: import("@astrale-os/sdk/schema").Method<import("@astrale-os/sdk/schema").CallableProjection<{
+    body: string;
+}, {
+    readonly mode: 'value';
+    readonly value: {
+        id: string;
+        body: string;
+    };
+}, "authorized", false, "default">>;

package/dist/schema/modules/comment/functions/edit-comment.js

@@ -0,0 +1,11 @@
+import { method } from '@astrale-os/sdk/schema';
+import { z } from 'zod';
+import { EditOwnComment } from '../policies/edit-own-comment.js';
+import { commentValue } from '../types/comment.js';
+export const editCommentMethod = method({
+    description: 'Edit this Comment as its author.',
+    auth: 'authorized',
+    policy: ({ check, self }) => check(EditOwnComment, self),
+    input: z.strictObject({ body: z.string().min(1).max(50_000) }),
+    output: commentValue,
+});

package/dist/schema/modules/comment/functions/index.d.ts

@@ -0,0 +1,2 @@
+export { deleteCommentMethod } from './delete-comment.js';
+export { editCommentMethod } from './edit-comment.js';

package/dist/schema/modules/comment/functions/index.js

@@ -0,0 +1,2 @@
+export { deleteCommentMethod } from './delete-comment.js';
+export { editCommentMethod } from './edit-comment.js';

package/dist/schema/modules/comment/index.d.ts

@@ -0,0 +1,4 @@
+export { commentValue } from './types/index.js';
+export { comment_authored_by, Comment, issue_has_comment } from './classes/index.js';
+export { deleteCommentMethod, editCommentMethod } from './functions/index.js';
+export { ContributeToComment, EditOwnComment, TraverseCommentRelationship, TraverseIssueComment, } from './policies/index.js';

package/dist/schema/modules/comment/index.js

@@ -0,0 +1,4 @@
+export { commentValue } from './types/index.js';
+export { comment_authored_by, Comment, issue_has_comment } from './classes/index.js';
+export { deleteCommentMethod, editCommentMethod } from './functions/index.js';
+export { ContributeToComment, EditOwnComment, TraverseCommentRelationship, TraverseIssueComment, } from './policies/index.js';

package/dist/schema/{comment/contribute-to-comment-policy.js → modules/comment/policies/contribute-to-comment.js}

@@ -1,7 +1,7 @@
 import { policy } from '@astrale-os/sdk/schema';
-import { Issue, project_contains_issue } from '../issue/index.js';
-import { Project, project_has_member, project_owned_by } from '../project/index.js';
-import { issue_has_comment } from './relationships.js';
+import { Issue, project_contains_issue } from '../../issue/index.js';
+import { Project, project_has_member, project_owned_by } from '../../project/index.js';
+import { issue_has_comment } from '../classes/issue-has-comment.js';
 export const ContributeToComment = policy({
     description: 'The caller owns or belongs to the Project containing this Comment.',
     match: ({ allOf, anyOf, edge, exists, object, subject }) => exists(({ node }) => {

package/dist/schema/{comment/edit-own-comment-policy.js → modules/comment/policies/edit-own-comment.js}

@@ -1,5 +1,5 @@
 import { policy } from '@astrale-os/sdk/schema';
-import { comment_authored_by } from './relationships.js';
+import { comment_authored_by } from '../classes/comment-authored-by.js';
 export const EditOwnComment = policy({
     description: 'The caller is the immutable author of this Comment.',
     match: ({ edge, object, subject }) => edge({ source: subject, class: () => comment_authored_by, target: object }),

package/dist/schema/modules/comment/policies/index.d.ts

@@ -0,0 +1,4 @@
+export { ContributeToComment } from './contribute-to-comment.js';
+export { EditOwnComment } from './edit-own-comment.js';
+export { TraverseCommentRelationship } from './traverse-comment-relationship.js';
+export { TraverseIssueComment } from './traverse-issue-comment.js';

package/dist/schema/modules/comment/policies/index.js

@@ -0,0 +1,4 @@
+export { ContributeToComment } from './contribute-to-comment.js';
+export { EditOwnComment } from './edit-own-comment.js';
+export { TraverseCommentRelationship } from './traverse-comment-relationship.js';
+export { TraverseIssueComment } from './traverse-issue-comment.js';

package/dist/schema/{comment/traverse-comment-relationship-policy.d.ts → modules/comment/policies/traverse-comment-relationship.d.ts}

@@ -1,2 +1 @@
-/** Comment relationships disclose only inside the containing Project. */
 export declare const TraverseCommentRelationship: import("@astrale-os/sdk/schema").Policy;

package/dist/schema/{comment/traverse-comment-relationship-policy.js → modules/comment/policies/traverse-comment-relationship.js}

@@ -1,8 +1,8 @@
 import { policy } from '@astrale-os/sdk/schema';
-import { Issue, project_contains_issue } from '../issue/index.js';
-import { Project, project_has_member, project_owned_by } from '../project/index.js';
-import { comment_authored_by, issue_has_comment } from './relationships.js';
-/** Comment relationships disclose only inside the containing Project. */
+import { Issue, project_contains_issue } from '../../issue/index.js';
+import { Project, project_has_member, project_owned_by } from '../../project/index.js';
+import { comment_authored_by } from '../classes/comment-authored-by.js';
+import { issue_has_comment } from '../classes/issue-has-comment.js';
 export const TraverseCommentRelationship = policy({
     description: 'The caller owns or belongs to the Project containing the source Comment.',
     match: ({ allOf, anyOf, edge, exists, source, subject, target }) => anyOf(exists(({ node }) => {

package/dist/schema/modules/comment/policies/traverse-issue-comment.d.ts

@@ -0,0 +1 @@
+export declare const TraverseIssueComment: import("@astrale-os/sdk/schema").Policy;

package/dist/schema/modules/comment/policies/traverse-issue-comment.js

@@ -0,0 +1,14 @@
+import { policy } from '@astrale-os/sdk/schema';
+import { project_contains_issue } from '../../issue/index.js';
+import { Project, project_has_member, project_owned_by } from '../../project/index.js';
+import { issue_has_comment } from '../classes/issue-has-comment.js';
+export const TraverseIssueComment = policy({
+    description: 'Issue Comment containment is visible only inside the containing Project.',
+    match: ({ allOf, anyOf, edge, exists, source, subject, target }) => anyOf(exists(({ node }) => {
+        const project = node(() => Project);
+        return allOf(edge({ source, class: () => issue_has_comment, target }), edge({ source: project, class: () => project_contains_issue, target: source }), edge({ source: subject, class: () => project_owned_by, target: project }));
+    }), exists(({ node }) => {
+        const project = node(() => Project);
+        return allOf(edge({ source, class: () => issue_has_comment, target }), edge({ source: project, class: () => project_contains_issue, target: source }), edge({ source: subject, class: () => project_has_member, target: project }));
+    })),
+});

package/dist/schema/modules/comment/types/comment.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const commentValue: z.ZodObject<{
+    id: z.ZodString;
+    body: z.ZodString;
+}, z.core.$strict>;

package/dist/schema/modules/comment/types/comment.js

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import { nodeIdValue } from '../../../types/index.js';
+export const commentValue = z.strictObject({
+    id: nodeIdValue,
+    body: z.string().min(1).max(50_000),
+});

package/dist/schema/modules/comment/types/index.d.ts

@@ -0,0 +1 @@
+export { commentValue } from './comment.js';

package/dist/schema/modules/comment/types/index.js

@@ -0,0 +1 @@
+export { commentValue } from './comment.js';

package/dist/schema/modules/issue/classes/index.d.ts

@@ -0,0 +1,5 @@
+export { issue_assigned_to } from './issue-assigned-to.js';
+export { issue_reported_by } from './issue-reported-by.js';
+export { issue_subtask_of } from './issue-subtask-of.js';
+export { Issue } from './issue.js';
+export { project_contains_issue } from './project-contains-issue.js';

package/dist/schema/modules/issue/classes/index.js

@@ -0,0 +1,5 @@
+export { issue_assigned_to } from './issue-assigned-to.js';
+export { issue_reported_by } from './issue-reported-by.js';
+export { issue_subtask_of } from './issue-subtask-of.js';
+export { Issue } from './issue.js';
+export { project_contains_issue } from './project-contains-issue.js';

package/dist/schema/modules/issue/classes/issue-assigned-to.d.ts

@@ -0,0 +1,16 @@
+export declare const issue_assigned_to: import("@astrale-os/sdk/schema").DirectedEdgeClass<{
+    readonly depth: 0;
+    readonly abstract: false;
+    readonly extends: readonly [];
+    readonly properties: never;
+    readonly source: {
+        readonly as: "assignee";
+        readonly outgoing: "0..*";
+    };
+    readonly target: {
+        readonly as: "issue";
+        readonly incoming: "0..1";
+    };
+    readonly constraints: Record<never, never>;
+    readonly effectiveProperties: never;
+}>;

package/dist/schema/modules/issue/classes/issue-assigned-to.js

@@ -0,0 +1,9 @@
+import { K, edgeClass } from '@astrale-os/sdk/schema';
+import { TraverseIssueAssignee } from '../policies/traverse-issue-assignee.js';
+import { Issue } from './issue.js';
+export const issue_assigned_to = edgeClass.directed({
+    description: 'The optional current assignee of one Issue.',
+    source: { as: 'assignee', accepts: [K.classes.Identity], outgoing: '0..*' },
+    target: { as: 'issue', accepts: [() => Issue], incoming: '0..1' },
+    policies: { traverse: () => TraverseIssueAssignee },
+});

package/dist/schema/modules/issue/classes/issue-reported-by.d.ts

@@ -0,0 +1,16 @@
+export declare const issue_reported_by: import("@astrale-os/sdk/schema").DirectedEdgeClass<{
+    readonly depth: 0;
+    readonly abstract: false;
+    readonly extends: readonly [];
+    readonly properties: never;
+    readonly source: {
+        readonly as: "reporter";
+        readonly outgoing: "0..*";
+    };
+    readonly target: {
+        readonly as: "issue";
+        readonly incoming: "1";
+    };
+    readonly constraints: Record<never, never>;
+    readonly effectiveProperties: never;
+}>;

package/dist/schema/modules/issue/classes/issue-reported-by.js

@@ -0,0 +1,9 @@
+import { K, edgeClass } from '@astrale-os/sdk/schema';
+import { TraverseIssueReporter } from '../policies/traverse-issue-reporter.js';
+import { Issue } from './issue.js';
+export const issue_reported_by = edgeClass.directed({
+    description: 'The immutable reporter of one Issue.',
+    source: { as: 'reporter', accepts: [K.classes.Identity], outgoing: '0..*' },
+    target: { as: 'issue', accepts: [() => Issue], incoming: '1' },
+    policies: { traverse: () => TraverseIssueReporter },
+});

package/dist/schema/modules/issue/classes/issue-subtask-of.d.ts

@@ -0,0 +1,19 @@
+export declare const issue_subtask_of: import("@astrale-os/sdk/schema").DirectedEdgeClass<{
+    readonly depth: 0;
+    readonly abstract: false;
+    readonly extends: readonly [];
+    readonly properties: never;
+    readonly source: {
+        readonly as: "child";
+        readonly outgoing: "0..1";
+    };
+    readonly target: {
+        readonly as: "parent";
+        readonly incoming: "0..*";
+    };
+    readonly constraints: {
+        readonly noSelf: true;
+        readonly acyclic: true;
+    };
+    readonly effectiveProperties: never;
+}>;

package/dist/schema/modules/issue/classes/issue-subtask-of.js

@@ -0,0 +1,10 @@
+import { edgeClass } from '@astrale-os/sdk/schema';
+import { TraverseIssueParent } from '../policies/traverse-issue-parent.js';
+import { Issue } from './issue.js';
+export const issue_subtask_of = edgeClass.directed({
+    description: 'One Issue is an acyclic subtask of at most one Issue in the same Project.',
+    source: { as: 'child', accepts: [() => Issue], outgoing: '0..1' },
+    target: { as: 'parent', accepts: [() => Issue], incoming: '0..*' },
+    constraints: { noSelf: true, acyclic: true },
+    policies: { traverse: () => TraverseIssueParent },
+});

package/dist/schema/{issue/class.d.ts → modules/issue/classes/issue.d.ts}

@@ -54,7 +54,7 @@ export declare const Issue: import("@astrale-os/sdk/schema").NodeClass<{
         readonly reference: import("@astrale-os/sdk/schema").AuthoredPropertyProjection<string, string, true, "reference", "self">;
         readonly reporterId: import("@astrale-os/sdk/schema").AuthoredPropertyProjection<string, string, true, "reporterId", "self">;
         readonly assigneeId: import("@astrale-os/sdk/schema").AuthoredPropertyProjection<string | undefined, string | undefined, false, "assigneeId", "self">;
-        readonly status: import("@astrale-os/sdk/schema").AuthoredPropertyProjection<unknown, "accepted" | "closed" | "deferred" | "open" | "resolved", false, "status", "self">;
+        readonly status: import("@astrale-os/sdk/schema").AuthoredPropertyProjection<unknown, "accepted" | "closed" | "deferred" | "open" | "resolved", true, "status", "self">;
         readonly priority: import("@astrale-os/sdk/schema").AuthoredPropertyProjection<number, number, true, "priority", "self">;
         readonly archived: import("@astrale-os/sdk/schema").AuthoredPropertyProjection<boolean, boolean, true, "archived", "self">;
     };
@@ -141,7 +141,7 @@ export declare const Issue: import("@astrale-os/sdk/schema").NodeClass<{
             };
         }, "authorized", false, "default">>;
     };
-    readonly effectiveProperties: (import("@astrale-os/sdk/schema").AuthoredPropertyProjection<boolean, boolean, true, "archived", "self"> | import("@astrale-os/sdk/schema").AuthoredPropertyProjection<string | undefined, string | undefined, false, "assigneeId", "self"> | import("@astrale-os/sdk/schema").AuthoredPropertyProjection<number, number, true, "priority", "self"> | import("@astrale-os/sdk/schema").AuthoredPropertyProjection<string, string, true, "reference", "self"> | import("@astrale-os/sdk/schema").AuthoredPropertyProjection<string, string, true, "reporterId", "self"> | import("@astrale-os/sdk/schema").AuthoredPropertyProjection<unknown, "accepted" | "closed" | "deferred" | "open" | "resolved", false, "status", "self">) | (import("@astrale-os/sdk/schema").ResolvedProperty<import("@astrale-os/sdk/schema").Value, false> & {
+    readonly effectiveProperties: (import("@astrale-os/sdk/schema").AuthoredPropertyProjection<boolean, boolean, true, "archived", "self"> | import("@astrale-os/sdk/schema").AuthoredPropertyProjection<string | undefined, string | undefined, false, "assigneeId", "self"> | import("@astrale-os/sdk/schema").AuthoredPropertyProjection<number, number, true, "priority", "self"> | import("@astrale-os/sdk/schema").AuthoredPropertyProjection<string, string, true, "reference", "self"> | import("@astrale-os/sdk/schema").AuthoredPropertyProjection<string, string, true, "reporterId", "self"> | import("@astrale-os/sdk/schema").AuthoredPropertyProjection<unknown, "accepted" | "closed" | "deferred" | "open" | "resolved", true, "status", "self">) | (import("@astrale-os/sdk/schema").ResolvedProperty<import("@astrale-os/sdk/schema").Value, false> & {
         readonly name: "description";
         readonly key: "kernel.astrale.ai:class.Descriptable.property.description";
     }) | (import("@astrale-os/sdk/schema").ResolvedProperty<import("@astrale-os/sdk/schema").Value, true> & {
@@ -230,4 +230,29 @@ export declare const Issue: import("@astrale-os/sdk/schema").NodeClass<{
         };
     }, "authorized", false, "default">>, "addComment", "self">;
     readonly effectiveStaticMethods: never;
-}>;
+}> & import("@astrale-os/sdk/schema").StateClass<Readonly<Omit<Readonly<Record<never, never>>, "status"> & {
+    readonly status: import("@astrale-os/sdk/state").StateMachine<{
+        readonly open: {
+            readonly accept: "accepted";
+            readonly defer: "deferred";
+            readonly close: "closed";
+        };
+        readonly accepted: {
+            readonly resolve: "resolved";
+            readonly defer: "deferred";
+            readonly close: "closed";
+        };
+        readonly deferred: {
+            readonly reopen: "open";
+            readonly accept: "accepted";
+            readonly close: "closed";
+        };
+        readonly resolved: {
+            readonly reopen: "open";
+            readonly close: "closed";
+        };
+        readonly closed: {
+            readonly reopen: "open";
+        };
+    }, "open">;
+}>>;

package/dist/schema/modules/issue/classes/issue.js

@@ -0,0 +1,35 @@
+import { K, nodeClass, property, stateProperty } from '@astrale-os/sdk/schema';
+import { z } from 'zod';
+import { nodeIdValue } from '../../../types/index.js';
+import { issueStatus } from '../../../.runtime/states/issue/index.js';
+import { addIssueCommentMethod } from '../functions/add-issue-comment.js';
+import { archiveIssueMethod } from '../functions/archive-issue.js';
+import { assignIssueMethod } from '../functions/assign-issue.js';
+import { setIssueParentMethod } from '../functions/set-issue-parent.js';
+import { setIssueTagsMethod } from '../functions/set-issue-tags.js';
+import { transitionIssueMethod } from '../functions/transition-issue.js';
+import { updateIssueMethod } from '../functions/update-issue.js';
+import { ContributeToIssue } from '../policies/contribute-to-issue.js';
+export const Issue = nodeClass({
+    description: 'One immutable-reference work item contained by exactly one Project.',
+    icon: 'circle-dot',
+    extends: [K.classes.Named, K.classes.Descriptable, K.classes.Timestamped],
+    properties: {
+        reference: z.string().min(1).max(32),
+        reporterId: property(nodeIdValue, {}),
+        assigneeId: property(nodeIdValue.optional(), {}),
+        status: stateProperty(issueStatus),
+        priority: z.number().int().min(0).max(4),
+        archived: z.boolean(),
+    },
+    methods: {
+        update: updateIssueMethod,
+        transition: transitionIssueMethod,
+        assign: assignIssueMethod,
+        setTags: setIssueTagsMethod,
+        setParent: setIssueParentMethod,
+        addComment: addIssueCommentMethod,
+        archive: archiveIssueMethod,
+    },
+    policies: { read: () => ContributeToIssue },
+});

package/dist/schema/modules/issue/classes/project-contains-issue.d.ts

@@ -0,0 +1,16 @@
+export declare const project_contains_issue: import("@astrale-os/sdk/schema").DirectedEdgeClass<{
+    readonly depth: 0;
+    readonly abstract: false;
+    readonly extends: readonly [];
+    readonly properties: never;
+    readonly source: {
+        readonly as: "project";
+        readonly outgoing: "0..*";
+    };
+    readonly target: {
+        readonly as: "issue";
+        readonly incoming: "1";
+    };
+    readonly constraints: Record<never, never>;
+    readonly effectiveProperties: never;
+}>;

package/dist/schema/modules/issue/classes/project-contains-issue.js

@@ -0,0 +1,10 @@
+import { edgeClass } from '@astrale-os/sdk/schema';
+import { Project } from '../../project/index.js';
+import { TraverseProjectIssue } from '../policies/traverse-project-issue.js';
+import { Issue } from './issue.js';
+export const project_contains_issue = edgeClass.directed({
+    description: 'One Project contains and numbers one Issue.',
+    source: { as: 'project', accepts: [() => Project], outgoing: '0..*' },
+    target: { as: 'issue', accepts: [() => Issue], incoming: '1' },
+    policies: { traverse: () => TraverseProjectIssue },
+});