@undefineds.co/models 0.2.36 → 0.2.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (16) hide show
  1. package/dist/evidence.schema.d.ts +5 -3
  2. package/dist/evidence.schema.js +5 -3
  3. package/dist/message.repository.d.ts +7 -3
  4. package/dist/message.schema.d.ts +11 -5
  5. package/dist/message.schema.js +25 -7
  6. package/dist/namespaces.js +1 -2
  7. package/dist/schema.d.ts +6 -2
  8. package/dist/thread.repository.d.ts +4 -0
  9. package/dist/thread.schema.d.ts +6 -0
  10. package/dist/thread.schema.js +13 -5
  11. package/dist/vocab/message.vocab.d.ts +1 -0
  12. package/dist/vocab/message.vocab.js +1 -0
  13. package/dist/vocab/thread.vocab.d.ts +1 -0
  14. package/dist/vocab/thread.vocab.js +1 -0
  15. package/package.json +1 -1
  16. package/skills/solid-modeling/SKILL.md +18 -5
package/dist/evidence.schema.d.ts CHANGED
@@ -13,9 +13,11 @@ export declare const EvidenceKind: {
13
13
  /**
14
14
  * Evidence resource.
15
15
  *
16
- * Evidence is append-only proof or finding. The resource subject is the
17
- * evidence file/record itself; `about` points to the work/control object it
18
- * supports. It is not a status owner by itself.
16
+ * Evidence is append-only proof or finding metadata. Long evidence bodies
17
+ * such as logs, patches, screenshots, transcripts, and reports are Pod files;
18
+ * this TTL record stores the queryable meta and `source` points to the
19
+ * evidence file when one exists. `about` points to the work/control object it
20
+ * supports. Evidence is not a status owner by itself.
19
21
  */
20
22
  export declare const evidenceResource: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
21
23
  id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
package/dist/evidence.schema.js CHANGED
@@ -19,9 +19,11 @@ export const EvidenceKind = {
19
19
  /**
20
20
  * Evidence resource.
21
21
  *
22
- * Evidence is append-only proof or finding. The resource subject is the
23
- * evidence file/record itself; `about` points to the work/control object it
24
- * supports. It is not a status owner by itself.
22
+ * Evidence is append-only proof or finding metadata. Long evidence bodies
23
+ * such as logs, patches, screenshots, transcripts, and reports are Pod files;
24
+ * this TTL record stores the queryable meta and `source` points to the
25
+ * evidence file when one exists. `about` points to the work/control object it
26
+ * supports. Evidence is not a status owner by itself.
25
27
  */
26
28
  export const evidenceResource = podTable('evidence', {
27
29
  id: id('id').default('evidence/{yyyy}/{MM}/{dd}.ttl#{key}'),
package/dist/message.repository.d.ts CHANGED
@@ -1,6 +1,7 @@
1
1
  export declare const messageRepository: import("@undefineds.co/drizzle-solid/dist/core/repository").PodRepositoryDescriptor<import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
2
2
  id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
3
- chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
3
+ scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
4
+ chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
4
5
  thread: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
5
6
  maker: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
6
7
  role: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
@@ -23,6 +24,7 @@ export declare const messageRepository: import("@undefineds.co/drizzle-solid/dis
23
24
  updatedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, false, false>;
24
25
  }>>, {
25
26
  id: string;
27
+ scope: string;
26
28
  chat: string;
27
29
  thread: string;
28
30
  maker: string;
@@ -45,9 +47,10 @@ export declare const messageRepository: import("@undefineds.co/drizzle-solid/dis
45
47
  createdAt: Date;
46
48
  updatedAt: Date;
47
49
  }, {
48
- chat: string;
49
50
  content: string;
50
51
  id?: string | undefined;
52
+ scope?: string | undefined;
53
+ chat?: string | undefined;
51
54
  thread?: string | undefined;
52
55
  maker?: string | undefined;
53
56
  role?: string | undefined;
@@ -69,7 +72,8 @@ export declare const messageRepository: import("@undefineds.co/drizzle-solid/dis
69
72
  updatedAt?: Date | undefined;
70
73
  }, {
71
74
  id?: string | null | undefined;
72
- chat?: string | undefined;
75
+ scope?: string | null | undefined;
76
+ chat?: string | null | undefined;
73
77
  thread?: string | null | undefined;
74
78
  maker?: string | null | undefined;
75
79
  role?: string | undefined;
package/dist/message.schema.d.ts CHANGED
@@ -15,9 +15,13 @@ export declare const MessageStatus: {
15
15
  * Message resource (aligned with xpod).
16
16
  *
17
17
  * Product semantics:
18
- * - Message belongs to a Chat counterpart.
19
- * - Thread is optional and appears only when a message participates in an
20
- * explicit AI/task/branch timeline.
18
+ * - Message belongs to a neutral product scope: usually a Chat, sometimes a
19
+ * Task/thread execution timeline.
20
+ * - Chat remains the Solid Chat compatibility relation. When present, the
21
+ * message is written under the Chat message bucket and projected through
22
+ * wf:message.
23
+ * - Thread is optional and appears when a message participates in an explicit
24
+ * AI/task/branch timeline.
21
25
  *
22
26
  * Storage structure:
23
27
  * - Location: /.data/chat/{chat|id}/{yyyy}/{MM}/{dd}/messages.ttl#{id}
@@ -26,7 +30,8 @@ export declare const MessageStatus: {
26
30
  */
27
31
  export declare const messageResource: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
28
32
  id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
29
- chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
33
+ scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
34
+ chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
30
35
  thread: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
31
36
  maker: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
32
37
  role: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
@@ -50,7 +55,8 @@ export declare const messageResource: import("@undefineds.co/drizzle-solid/dist/
50
55
  }>>;
51
56
  export declare const messageTable: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
52
57
  id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
53
- chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
58
+ scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
59
+ chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
54
60
  thread: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
55
61
  maker: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
56
62
  role: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
package/dist/message.schema.js CHANGED
@@ -1,7 +1,8 @@
1
- import { object, podTable, uri, string, text, timestamp, id } from '@undefineds.co/drizzle-solid';
1
+ import { object, podTable, uri, string, text, timestamp, id, renderDefaultIdTemplate } from '@undefineds.co/drizzle-solid';
2
2
  import { UDFS, DCTerms, FOAF, MEETING, SCHEMA, SIOC, WF } from './namespaces.js';
3
3
  import { chatResource } from './chat.schema.js';
4
4
  import { threadResource } from './thread.schema.js';
5
+ import { resourceKey } from './resource-id-defaults.js';
5
6
  export const MessageRole = {
6
7
  USER: 'user',
7
8
  ASSISTANT: 'assistant',
@@ -17,9 +18,13 @@ export const MessageStatus = {
17
18
  * Message resource (aligned with xpod).
18
19
  *
19
20
  * Product semantics:
20
- * - Message belongs to a Chat counterpart.
21
- * - Thread is optional and appears only when a message participates in an
22
- * explicit AI/task/branch timeline.
21
+ * - Message belongs to a neutral product scope: usually a Chat, sometimes a
22
+ * Task/thread execution timeline.
23
+ * - Chat remains the Solid Chat compatibility relation. When present, the
24
+ * message is written under the Chat message bucket and projected through
25
+ * wf:message.
26
+ * - Thread is optional and appears when a message participates in an explicit
27
+ * AI/task/branch timeline.
23
28
  *
24
29
  * Storage structure:
25
30
  * - Location: /.data/chat/{chat|id}/{yyyy}/{MM}/{dd}/messages.ttl#{id}
@@ -27,9 +32,22 @@ export const MessageStatus = {
27
32
  * - chat/thread are RDF URI relations. Short ids remain accepted at API/query call sites via ORM URI template resolution.
28
33
  */
29
34
  export const messageResource = podTable('chat_message', {
30
- id: id('id').default('chat/{chat.key}/{yyyy}/{MM}/{dd}/messages.ttl#{key}'),
31
- // Chat relation. In RDF this is an inverse Solid Chat link: <chat> wf:message <message>.
32
- chat: uri('chat').predicate(WF.message).inverse().notNull().link(chatResource),
35
+ id: id('id').default((key, row) => (renderDefaultIdTemplate(row?.chat
36
+ ? 'chat/{chat.key}/{yyyy}/{MM}/{dd}/messages.ttl#{key}'
37
+ : row?.thread
38
+ ? '{thread.dir}/{yyyy}/{MM}/{dd}/messages.ttl#{key}'
39
+ : '{scope.dir}/{yyyy}/{MM}/{dd}/messages.ttl#{key}', {
40
+ key: resourceKey(key, 'msg'),
41
+ row,
42
+ links: {
43
+ chat: chatResource,
44
+ thread: threadResource,
45
+ },
46
+ }))),
47
+ // Canonical product owner scope. The object can be a Chat, Task, Thread, or future command surface.
48
+ scope: uri('scope').predicate(UDFS.inScope),
49
+ // Solid Chat compatibility relation. In RDF this is an inverse link: <chat> wf:message <message>.
50
+ chat: uri('chat').predicate(WF.message).inverse().link(chatResource),
33
51
  // Optional Thread relation. In RDF this is an inverse Solid Chat/SIOC link: <thread> sioc:has_member <message>.
34
52
  thread: uri('thread').predicate(SIOC.has_member).inverse().link(threadResource),
35
53
  // maker is the entity URI of the message author:
package/dist/namespaces.js CHANGED
@@ -132,6 +132,7 @@ export const UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {
132
132
  sortKey: 'sortKey',
133
133
  hasThread: 'hasThread',
134
134
  inThread: 'inThread',
135
+ inScope: 'inScope',
135
136
  participants: 'participants',
136
137
  message: 'message',
137
138
  messageContent: 'messageContent',
@@ -314,9 +315,7 @@ export const UDFS = createNamespace('udfs', 'https://undefineds.co/ns#', {
314
315
  evidenceKind: 'evidenceKind',
315
316
  report: 'report',
316
317
  reportKind: 'reportKind',
317
- subject: 'subject',
318
318
  outcome: 'outcome',
319
- artifact: 'artifact',
320
319
  metricFacts: 'metricFacts',
321
320
  publishedAt: 'publishedAt',
322
321
  reviewer: 'reviewer',
package/dist/schema.d.ts CHANGED
@@ -116,6 +116,7 @@ export declare const solidResources: {
116
116
  }>>;
117
117
  threadResource: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
118
118
  id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
119
+ scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
119
120
  chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
120
121
  task: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
121
122
  title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
@@ -128,7 +129,8 @@ export declare const solidResources: {
128
129
  }>>;
129
130
  messageResource: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
130
131
  id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
131
- chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
132
+ scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
133
+ chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
132
134
  thread: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
133
135
  maker: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
134
136
  role: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
@@ -626,6 +628,7 @@ export declare const solidSchema: {
626
628
  }>>;
627
629
  threadTable: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
628
630
  id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
631
+ scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
629
632
  chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
630
633
  task: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
631
634
  title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
@@ -638,7 +641,8 @@ export declare const solidSchema: {
638
641
  }>>;
639
642
  messageTable: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
640
643
  id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
641
- chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, true, false>;
644
+ scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
645
+ chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
642
646
  thread: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
643
647
  maker: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
644
648
  role: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, true, true>;
package/dist/thread.repository.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  export declare const threadRepository: import("@undefineds.co/drizzle-solid/dist/core/repository").PodRepositoryDescriptor<import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
2
2
  id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
3
+ scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
3
4
  chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
4
5
  task: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
5
6
  title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
@@ -11,6 +12,7 @@ export declare const threadRepository: import("@undefineds.co/drizzle-solid/dist
11
12
  updatedAt: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"datetime", null, true, true>;
12
13
  }>>, {
13
14
  id: string;
15
+ scope: string;
14
16
  chat: string;
15
17
  task: string;
16
18
  title: string;
@@ -22,6 +24,7 @@ export declare const threadRepository: import("@undefineds.co/drizzle-solid/dist
22
24
  updatedAt: Date;
23
25
  }, {
24
26
  id?: string | undefined;
27
+ scope?: string | undefined;
25
28
  chat?: string | undefined;
26
29
  task?: string | undefined;
27
30
  title?: string | undefined;
@@ -33,6 +36,7 @@ export declare const threadRepository: import("@undefineds.co/drizzle-solid/dist
33
36
  updatedAt?: Date | undefined;
34
37
  }, {
35
38
  id?: string | null | undefined;
39
+ scope?: string | null | undefined;
36
40
  chat?: string | null | undefined;
37
41
  task?: string | null | undefined;
38
42
  title?: string | null | undefined;
package/dist/thread.schema.d.ts CHANGED
@@ -10,6 +10,10 @@ export declare const ThreadStatus: {
10
10
  * Product semantics:
11
11
  * - Thread is the implicit concrete timeline/place under exactly one surface:
12
12
  * Chat for conversation timelines, or Task for task execution timelines.
13
+ * - `scope` is the neutral LinX ownership relation for that surface. When the
14
+ * scope is a Chat, also write `chat` so Solid Chat clients can keep using
15
+ * sioc:has_parent. When the scope is a Task, also write `task` for workflow
16
+ * indexes.
13
17
  * - AI product runtime sessions map to Thread when they represent a concrete
14
18
  * conversation timeline/place/run.
15
19
  * - Thread carries workspace/place relations and runtime metadata. Chat only
@@ -29,6 +33,7 @@ export declare const ThreadStatus: {
29
33
  */
30
34
  export declare const threadResource: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
31
35
  id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
36
+ scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
32
37
  chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
33
38
  task: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
34
39
  title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
@@ -41,6 +46,7 @@ export declare const threadResource: import("@undefineds.co/drizzle-solid/dist/c
41
46
  }>>;
42
47
  export declare const threadTable: import("@undefineds.co/drizzle-solid/dist/core/schema").PodTableWithColumns<import("@undefineds.co/drizzle-solid/dist/core/schema").ResolvedColumns<{
43
48
  id: import("@undefineds.co/drizzle-solid/dist/core/schema").PodStringColumn<false, false>;
49
+ scope: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
44
50
  chat: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
45
51
  task: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"uri", null, false, false>;
46
52
  title: import("@undefineds.co/drizzle-solid/dist/core/schema").ColumnBuilder<"string", null, false, false>;
package/dist/thread.schema.js CHANGED
@@ -14,6 +14,10 @@ export const ThreadStatus = {
14
14
  * Product semantics:
15
15
  * - Thread is the implicit concrete timeline/place under exactly one surface:
16
16
  * Chat for conversation timelines, or Task for task execution timelines.
17
+ * - `scope` is the neutral LinX ownership relation for that surface. When the
18
+ * scope is a Chat, also write `chat` so Solid Chat clients can keep using
19
+ * sioc:has_parent. When the scope is a Task, also write `task` for workflow
20
+ * indexes.
17
21
  * - AI product runtime sessions map to Thread when they represent a concrete
18
22
  * conversation timeline/place/run.
19
23
  * - Thread carries workspace/place relations and runtime metadata. Chat only
@@ -32,9 +36,11 @@ export const ThreadStatus = {
32
36
  * container URI here and store portable metadata with that container/resource.
33
37
  */
34
38
  export const threadResource = podTable('thread', {
35
- id: id('id').default((key, row) => (renderDefaultIdTemplate(row?.task
36
- ? 'task/{task.key}/index.ttl#{key}'
37
- : 'chat/{chat.key}/index.ttl#{key}', {
39
+ id: id('id').default((key, row) => (renderDefaultIdTemplate(row?.chat
40
+ ? 'chat/{chat.key}/index.ttl#{key}'
41
+ : row?.task
42
+ ? 'task/{task.key}/index.ttl#{key}'
43
+ : '{scope.dir}/index.ttl#{key}', {
38
44
  key: resourceKey(key, 'thread'),
39
45
  row,
40
46
  links: {
@@ -42,9 +48,11 @@ export const threadResource = podTable('thread', {
42
48
  task: taskResource,
43
49
  },
44
50
  }))),
45
- // Owner surface for conversation timelines. Do not set together with `task`.
51
+ // Canonical product owner surface. The object can be a Chat, Task, or future command surface.
52
+ scope: uri('scope').predicate(UDFS.inScope),
53
+ // Solid Chat compatibility owner for conversation timelines. Do not set together with `task`.
46
54
  chat: uri('chat').predicate(SIOC.has_parent).link(chatResource),
47
- // Owner surface for task execution timelines. Do not set together with `chat`.
55
+ // Workflow compatibility/index owner for task execution timelines. Do not set together with `chat`.
48
56
  task: uri('task').predicate(UDFS.task).link(taskResource),
49
57
  // Display / state
50
58
  title: string('title').predicate(DCTerms.title),
package/dist/vocab/message.vocab.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  export declare const MessageVocab: {
2
+ readonly scope: string;
2
3
  readonly thread: string;
3
4
  readonly chat: string;
4
5
  readonly maker: string;
package/dist/vocab/message.vocab.js CHANGED
@@ -1,6 +1,7 @@
1
1
  import { DCTerms, FOAF, SCHEMA, SIOC, UDFS, WF } from '../namespaces.js';
2
2
  export const MessageVocab = {
3
3
  // Existing
4
+ scope: UDFS.inScope,
4
5
  thread: SIOC.has_member,
5
6
  chat: WF.message,
6
7
  maker: FOAF.maker,
package/dist/vocab/thread.vocab.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  export declare const ThreadVocab: {
2
+ readonly scope: string;
2
3
  readonly chat: string;
3
4
  readonly task: string;
4
5
  readonly title: string;
package/dist/vocab/thread.vocab.js CHANGED
@@ -1,5 +1,6 @@
1
1
  import { DCTerms, SIOC, UDFS } from '../namespaces.js';
2
2
  export const ThreadVocab = {
3
+ scope: UDFS.inScope,
3
4
  chat: SIOC.has_parent,
4
5
  task: UDFS.task,
5
6
  title: DCTerms.title,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@undefineds.co/models",
3
- "version": "0.2.36",
3
+ "version": "0.2.37",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
package/skills/solid-modeling/SKILL.md CHANGED
@@ -36,9 +36,14 @@ Before adding a schema, decide what the resource fundamentally is.
36
36
  - File-primary resources have a meaningful body: markdown, JSONL, source file,
37
37
  artifact, uploaded file, or generated report. Examples include `Spec`,
38
38
  `Plan`, `Report`, and most `Evidence`.
39
- - For file-primary resources, model the queryable metadata: subject, kind,
40
- status or outcome, actor/reviewer, evidence links, revision, body/artifact
41
- URI, and relations to the controlling issue/task/run.
39
+ - For file-primary resources, model only queryable metadata: aboutness, kind,
40
+ status or outcome, abstract/summary when it is needed for indexing,
41
+ actor/reviewer, evidence links, revision, and relations to the controlling
42
+ issue/task/run.
43
+ - Evidence is file-primary when the proof body is a log, diff, patch,
44
+ transcript, screenshot, or report. Keep the body as a Pod file and store only
45
+ queryable metadata in TTL; use `schema:about` for the control object and
46
+ `dcterms:source` for the concrete evidence file when needed.
42
47
  - Do not create a parallel model just because a file needs metadata. Add schema
43
48
  fields only for facts that must be searched, joined, synchronized, audited, or
44
49
  used for routing/recovery across clients.
@@ -170,8 +175,9 @@ Use these concepts consistently across products:
170
175
  triggered, or one-off task intent.
171
176
  - `Thread`: implicit concrete timeline/place under exactly one command surface:
172
177
  Chat for conversation timelines, or Task for task execution timelines.
173
- - `Message`: human/runtime communication item in a Chat, optionally linked to a
174
- Thread when it participates in an AI/task/branch timeline.
178
+ - `Message`: human/runtime communication item in a command scope. It usually
179
+ belongs to a Chat, but task/runtime messages may belong to a Task or Thread
180
+ scope without inventing a Chat.
175
181
  - `Run`: one concrete execution attempt by an Agent Runtime.
176
182
  - `RunStep`: append-only execution facts for a Run.
177
183
 
@@ -185,11 +191,18 @@ Align with graph semantics:
185
191
 
186
192
  | Concept | Preferred RDF direction | Typical predicate |
187
193
  |---|---|---|
194
+ | resource belongs to command scope | `resource -> scope` | `udfs:inScope` |
188
195
  | chat contains message | `chat -> message` | `wf:message` / project vocabulary |
196
+ | chat owns thread | `thread -> chat` | `sioc:has_parent` for compatibility |
189
197
  | thread contains message | `thread -> message` | `sioc:has_member` or equivalent |
190
198
  | reply points to original | `replyMessage -> originalMessage` | `sioc:has_reply` / project predicate |
191
199
  | author/maker | `message -> maker` | `foaf:maker` |
192
200
 
201
+ Use `udfs:inScope` for LinX product semantics when a Thread or Message can
202
+ belong to either Chat or Task. Preserve Solid Chat compatibility by also writing
203
+ `sioc:has_parent` for Chat-scoped Threads and `wf:message` for Chat-scoped
204
+ Messages. Do not stretch Solid Chat predicates to mean Task ownership.
205
+
193
206
  When inverse predicates are supported, use them for read/write symmetry. If the
194
207
  ORM cannot safely express the inverse write, put the relation writer in the
195
208
  repository and cover it with integration tests.