@agent-ix/spec-artifacts-app 0.5.0 → 0.6.0

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 (48) hide show
  1. package/README.md +40 -1
  2. package/manifest.yaml +276 -4
  3. package/mappings.schema.json +318 -0
  4. package/mappings.yaml +386 -0
  5. package/package.json +10 -2
  6. package/schemas/Actor.json +34 -0
  7. package/schemas/ActorId.json +7 -0
  8. package/schemas/ActorKind.json +13 -0
  9. package/schemas/ApplicationSpec.json +116 -0
  10. package/schemas/ArtifactId.json +7 -0
  11. package/schemas/ArtifactStatus.json +7 -0
  12. package/schemas/Boundary.json +34 -0
  13. package/schemas/BoundaryId.json +7 -0
  14. package/schemas/BoundaryKind.json +12 -0
  15. package/schemas/Capability.json +37 -0
  16. package/schemas/CapabilityId.json +7 -0
  17. package/schemas/Cardinality.json +7 -0
  18. package/schemas/DataAccessMode.json +11 -0
  19. package/schemas/DataDependency.json +33 -0
  20. package/schemas/DataDependencyId.json +7 -0
  21. package/schemas/EdgeVerb.json +7 -0
  22. package/schemas/ImportedTypeRef.json +21 -0
  23. package/schemas/Interface.json +38 -0
  24. package/schemas/InterfaceDirection.json +11 -0
  25. package/schemas/InterfaceId.json +7 -0
  26. package/schemas/InterfaceKind.json +15 -0
  27. package/schemas/IxTarget.json +7 -0
  28. package/schemas/LineNumber.json +8 -0
  29. package/schemas/MasterRequirements.json +80 -0
  30. package/schemas/ModuleRef.json +7 -0
  31. package/schemas/NonEmptyText.json +7 -0
  32. package/schemas/Provenance.json +25 -0
  33. package/schemas/Relationship.json +24 -0
  34. package/schemas/RenderingRequirement.json +34 -0
  35. package/schemas/RenderingRequirementId.json +7 -0
  36. package/schemas/RequirementKind.json +14 -0
  37. package/schemas/RequirementRef.json +33 -0
  38. package/schemas/RequirementRefId.json +7 -0
  39. package/schemas/Section.json +26 -0
  40. package/schemas/Sha256Digest.json +7 -0
  41. package/schemas/TestCaseRef.json +7 -0
  42. package/schemas/TypeName.json +7 -0
  43. package/schemas/UiSurface.json +7 -0
  44. package/schemas/Verification.json +29 -0
  45. package/schemas/toolchain.json +65 -0
  46. package/skeletons/application-spec.md +163 -0
  47. package/skeletons/application-spec.sysml.md +167 -0
  48. package/skeletons/master-requirements.md +104 -0
@@ -0,0 +1,37 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Capability.json",
4
+ "type": "object",
5
+ "properties": {
6
+ "id": {
7
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/CapabilityId.json"
8
+ },
9
+ "name": {
10
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/NonEmptyText.json"
11
+ },
12
+ "description": {
13
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/NonEmptyText.json",
14
+ "description": "free text: authored prose stating the capability; the requirements beneath it carry the normative form."
15
+ },
16
+ "actors": {
17
+ "type": "array",
18
+ "items": {
19
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/ActorId.json"
20
+ }
21
+ },
22
+ "line": {
23
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/LineNumber.json"
24
+ }
25
+ },
26
+ "required": [
27
+ "id",
28
+ "name",
29
+ "description",
30
+ "actors",
31
+ "line"
32
+ ],
33
+ "unevaluatedProperties": {
34
+ "not": {}
35
+ },
36
+ "description": "One row of `## Capabilities`: what the application does, and for whom."
37
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/CapabilityId.json",
4
+ "type": "string",
5
+ "pattern": "^[A-Z]{2,4}-[0-9]+-CAP-[0-9]+$",
6
+ "description": "Capability row id, `<document id>-CAP-N`; anchored on the artifact type, not the document."
7
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Cardinality.json",
4
+ "type": "string",
5
+ "pattern": "^[0-9A-Za-z*]+(\\.\\.[0-9A-Za-z*]+)?(:[0-9A-Za-z*]+(\\.\\.[0-9A-Za-z*]+)?)?$",
6
+ "description": "Relationship cardinality as authored: each side is a number, a letter token,\nor `*`, optionally a `..` range (`1:1`, `1:N`, `0..1`)."
7
+ }
@@ -0,0 +1,11 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/DataAccessMode.json",
4
+ "type": "string",
5
+ "enum": [
6
+ "read",
7
+ "write",
8
+ "read_write"
9
+ ],
10
+ "description": "How the application touches a data dependency."
11
+ }
@@ -0,0 +1,33 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/DataDependency.json",
4
+ "type": "object",
5
+ "properties": {
6
+ "id": {
7
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/DataDependencyId.json"
8
+ },
9
+ "name": {
10
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/NonEmptyText.json"
11
+ },
12
+ "source": {
13
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/ImportedTypeRef.json"
14
+ },
15
+ "access": {
16
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/DataAccessMode.json"
17
+ },
18
+ "line": {
19
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/LineNumber.json"
20
+ }
21
+ },
22
+ "required": [
23
+ "id",
24
+ "name",
25
+ "source",
26
+ "access",
27
+ "line"
28
+ ],
29
+ "unevaluatedProperties": {
30
+ "not": {}
31
+ },
32
+ "description": "One row of `## Data Dependencies`: a typed source the application reads or writes."
33
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/DataDependencyId.json",
4
+ "type": "string",
5
+ "pattern": "^[A-Z]{2,4}-[0-9]+-DAT-[0-9]+$",
6
+ "description": "Data-dependency row id, `<document id>-DAT-N`."
7
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/EdgeVerb.json",
4
+ "type": "string",
5
+ "pattern": "^[a-z][a-z0-9_]*$",
6
+ "description": "A relationship verb from the module's edge vocabulary."
7
+ }
@@ -0,0 +1,21 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/ImportedTypeRef.json",
4
+ "type": "object",
5
+ "properties": {
6
+ "module": {
7
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/ModuleRef.json"
8
+ },
9
+ "type": {
10
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/TypeName.json"
11
+ }
12
+ },
13
+ "required": [
14
+ "module",
15
+ "type"
16
+ ],
17
+ "unevaluatedProperties": {
18
+ "not": {}
19
+ },
20
+ "description": "A reference to a type another module owns. The reference form this module\npublishes: a module and a type name, never a copy of the imported type's\nfields, and never a cross-module `$ref` (FR-002-AC-10)."
21
+ }
@@ -0,0 +1,38 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Interface.json",
4
+ "type": "object",
5
+ "properties": {
6
+ "id": {
7
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/InterfaceId.json"
8
+ },
9
+ "name": {
10
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/NonEmptyText.json"
11
+ },
12
+ "kind": {
13
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/InterfaceKind.json"
14
+ },
15
+ "direction": {
16
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/InterfaceDirection.json"
17
+ },
18
+ "contract": {
19
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/NonEmptyText.json",
20
+ "description": "free text: how the contract is named — an OpenAPI path, a topic, a command; no one vocabulary spans them."
21
+ },
22
+ "line": {
23
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/LineNumber.json"
24
+ }
25
+ },
26
+ "required": [
27
+ "id",
28
+ "name",
29
+ "kind",
30
+ "direction",
31
+ "contract",
32
+ "line"
33
+ ],
34
+ "unevaluatedProperties": {
35
+ "not": {}
36
+ },
37
+ "description": "One row of `## Interfaces`: a surface the application exposes or consumes."
38
+ }
@@ -0,0 +1,11 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/InterfaceDirection.json",
4
+ "type": "string",
5
+ "enum": [
6
+ "inbound",
7
+ "outbound",
8
+ "bidirectional"
9
+ ],
10
+ "description": "Which way an interface faces relative to the application."
11
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/InterfaceId.json",
4
+ "type": "string",
5
+ "pattern": "^[A-Z]{2,4}-[0-9]+-IFC-[0-9]+$",
6
+ "description": "Interface row id, `<document id>-IFC-N`."
7
+ }
@@ -0,0 +1,15 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/InterfaceKind.json",
4
+ "type": "string",
5
+ "enum": [
6
+ "http_api",
7
+ "grpc",
8
+ "cli",
9
+ "event_stream",
10
+ "ui",
11
+ "library",
12
+ "file"
13
+ ],
14
+ "description": "The shape of an interface the application exposes or consumes."
15
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/IxTarget.json",
4
+ "type": "string",
5
+ "pattern": "^ix://.+$",
6
+ "description": "A relationship target: an `ix://` identity, as the frontmatter schemas require."
7
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/LineNumber.json",
4
+ "type": "integer",
5
+ "minimum": 1,
6
+ "maximum": 2147483647,
7
+ "description": "A 1-based document line number."
8
+ }
@@ -0,0 +1,80 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/MasterRequirements.json",
4
+ "type": "object",
5
+ "properties": {
6
+ "id": {
7
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/ArtifactId.json"
8
+ },
9
+ "title": {
10
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/NonEmptyText.json"
11
+ },
12
+ "type": {
13
+ "type": "string",
14
+ "const": "MasterRequirements"
15
+ },
16
+ "status": {
17
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/ArtifactStatus.json"
18
+ },
19
+ "relationships": {
20
+ "type": "array",
21
+ "items": {
22
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Relationship.json"
23
+ }
24
+ },
25
+ "provenance": {
26
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Provenance.json"
27
+ },
28
+ "purpose": {
29
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Section.json"
30
+ },
31
+ "scope": {
32
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Section.json"
33
+ },
34
+ "systemOverview": {
35
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Section.json"
36
+ },
37
+ "structure": {
38
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Section.json"
39
+ },
40
+ "requirementsArchitecture": {
41
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Section.json"
42
+ },
43
+ "references": {
44
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Section.json"
45
+ },
46
+ "fields": {
47
+ "type": "array",
48
+ "items": {
49
+ "$ref": "https://schemas.agent-ix.org/semantic-core/0.3.0/FieldDecl.json"
50
+ },
51
+ "minItems": 1,
52
+ "description": "The specification's identity attributes, declared as one typed row per\nfield in `## Properties`, or as the alternate `sysml` fence form of the\nsame declarations (quoin FR-071)."
53
+ },
54
+ "requirements": {
55
+ "type": "array",
56
+ "items": {
57
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/RequirementRef.json"
58
+ }
59
+ },
60
+ "invariants": {
61
+ "type": "array",
62
+ "items": {
63
+ "$ref": "https://schemas.agent-ix.org/semantic-core/0.3.0/ClauseRef.json"
64
+ },
65
+ "minItems": 1
66
+ }
67
+ },
68
+ "required": [
69
+ "id",
70
+ "title",
71
+ "type",
72
+ "relationships",
73
+ "provenance",
74
+ "purpose"
75
+ ],
76
+ "unevaluatedProperties": {
77
+ "not": {}
78
+ },
79
+ "description": "The record of a `MasterRequirements` document: the front page of a\nspecification — its purpose, scope, and the set of requirements it rolls up.\n\nLike `ApplicationSpec`, it references the requirements it aggregates rather\nthan restating them, so the module that owns a requirement type stays the one\ndefinition of it."
80
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/ModuleRef.json",
4
+ "type": "string",
5
+ "pattern": "^[a-z][a-z0-9-]*/[a-z][a-z0-9-]*$",
6
+ "description": "A module reference, `<org>/<repo>`; the key form of `semantic.imports`."
7
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/NonEmptyText.json",
4
+ "type": "string",
5
+ "minLength": 1,
6
+ "description": "A non-empty string; the base of every prose cell and every name."
7
+ }
@@ -0,0 +1,25 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Provenance.json",
4
+ "type": "object",
5
+ "properties": {
6
+ "path": {
7
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/NonEmptyText.json",
8
+ "description": "free text: a corpus-relative filesystem path, whose shape is the checkout's, not this module's."
9
+ },
10
+ "sourceIdentity": {
11
+ "$ref": "https://schemas.agent-ix.org/semantic-core/0.3.0/SemanticId.json"
12
+ },
13
+ "digest": {
14
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Sha256Digest.json"
15
+ }
16
+ },
17
+ "required": [
18
+ "path",
19
+ "digest"
20
+ ],
21
+ "unevaluatedProperties": {
22
+ "not": {}
23
+ },
24
+ "description": "Where the record came from. `sourceIdentity` is never synthesized (FR-004)."
25
+ }
@@ -0,0 +1,24 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Relationship.json",
4
+ "type": "object",
5
+ "properties": {
6
+ "target": {
7
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/IxTarget.json"
8
+ },
9
+ "type": {
10
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/EdgeVerb.json"
11
+ },
12
+ "cardinality": {
13
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Cardinality.json"
14
+ }
15
+ },
16
+ "required": [
17
+ "target",
18
+ "type"
19
+ ],
20
+ "unevaluatedProperties": {
21
+ "not": {}
22
+ },
23
+ "description": "A typed frontmatter edge. Exactly three properties; annotation keys are dropped (FR-004)."
24
+ }
@@ -0,0 +1,34 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/RenderingRequirement.json",
4
+ "type": "object",
5
+ "properties": {
6
+ "id": {
7
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/RenderingRequirementId.json"
8
+ },
9
+ "surface": {
10
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/UiSurface.json"
11
+ },
12
+ "requirement": {
13
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/NonEmptyText.json",
14
+ "description": "free text: the authored rendering obligation; its EARS grammar is an advisory lint, not a schema."
15
+ },
16
+ "verification": {
17
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Verification.json"
18
+ },
19
+ "line": {
20
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/LineNumber.json"
21
+ }
22
+ },
23
+ "required": [
24
+ "id",
25
+ "surface",
26
+ "requirement",
27
+ "verification",
28
+ "line"
29
+ ],
30
+ "unevaluatedProperties": {
31
+ "not": {}
32
+ },
33
+ "description": "One row of `## UI Rendering Requirements`: what a surface must render."
34
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/RenderingRequirementId.json",
4
+ "type": "string",
5
+ "pattern": "^[A-Z]{2,4}-[0-9]+-UI-[0-9]+$",
6
+ "description": "UI rendering-requirement row id, `<document id>-UI-N`."
7
+ }
@@ -0,0 +1,14 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/RequirementKind.json",
4
+ "type": "string",
5
+ "enum": [
6
+ "StR",
7
+ "US",
8
+ "FR",
9
+ "NFR",
10
+ "IT",
11
+ "TC"
12
+ ],
13
+ "description": "The ISO artifact type of an aggregated requirement."
14
+ }
@@ -0,0 +1,33 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/RequirementRef.json",
4
+ "type": "object",
5
+ "properties": {
6
+ "id": {
7
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/RequirementRefId.json"
8
+ },
9
+ "kind": {
10
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/RequirementKind.json"
11
+ },
12
+ "source": {
13
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/ImportedTypeRef.json"
14
+ },
15
+ "target": {
16
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/IxTarget.json"
17
+ },
18
+ "line": {
19
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/LineNumber.json"
20
+ }
21
+ },
22
+ "required": [
23
+ "id",
24
+ "kind",
25
+ "source",
26
+ "target",
27
+ "line"
28
+ ],
29
+ "unevaluatedProperties": {
30
+ "not": {}
31
+ },
32
+ "description": "One row of `## Requirements`: a requirement this composite rolls up. The\nrequirement's own fields belong to the module that owns its type; this record\ncarries only the reference."
33
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/RequirementRefId.json",
4
+ "type": "string",
5
+ "pattern": "^(StR|US|FR|NFR|IT|TC)-[0-9]+$",
6
+ "description": "An aggregated requirement's own id, in the ISO artifact-type forms."
7
+ }
@@ -0,0 +1,26 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Section.json",
4
+ "type": "object",
5
+ "properties": {
6
+ "text": {
7
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/NonEmptyText.json",
8
+ "description": "free text: authored prose; its sentence grammar is an advisory lint, not a schema."
9
+ },
10
+ "startLine": {
11
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/LineNumber.json"
12
+ },
13
+ "endLine": {
14
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/LineNumber.json"
15
+ }
16
+ },
17
+ "required": [
18
+ "text",
19
+ "startLine",
20
+ "endLine"
21
+ ],
22
+ "unevaluatedProperties": {
23
+ "not": {}
24
+ },
25
+ "description": "A level-2 section as extracted: byte-exact content and its 1-based line span."
26
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Sha256Digest.json",
4
+ "type": "string",
5
+ "pattern": "^sha256:[0-9a-f]{64}$",
6
+ "description": "SHA-256 over the document bytes, `sha256:<64 hex>` (the quoin FR-073 digest form)."
7
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/TestCaseRef.json",
4
+ "type": "string",
5
+ "pattern": "^TC-[0-9]+$",
6
+ "description": "A test-case reference annotated in a verification cell, `Test (TC-035)`."
7
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/TypeName.json",
4
+ "type": "string",
5
+ "pattern": "^[A-Za-z][A-Za-z0-9_-]*$",
6
+ "description": "A type name exported by a module (`FR`, `master-requirements`, `Entity`)."
7
+ }
@@ -0,0 +1,7 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/UiSurface.json",
4
+ "type": "string",
5
+ "pattern": "^[a-z][a-z0-9-]*$",
6
+ "description": "A UI surface an application renders on (`web`, `cli`, `ide-panel`).\nDeliberately open: the surface vocabulary belongs to the applications, not to\nthis module, and closing it here would reject the corpus it describes."
7
+ }
@@ -0,0 +1,29 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/Verification.json",
4
+ "type": "object",
5
+ "properties": {
6
+ "method": {
7
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/NonEmptyText.json",
8
+ "description": "free text: an ISO 29148 method name whose vocabulary is an advisory lint rule, not a schema."
9
+ },
10
+ "testRefs": {
11
+ "type": "array",
12
+ "items": {
13
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/TestCaseRef.json"
14
+ }
15
+ },
16
+ "annotation": {
17
+ "$ref": "https://schemas.agent-ix.org/agent-ix/spec-artifacts-app/0.2.0/NonEmptyText.json",
18
+ "description": "free text: the parenthesized remainder of the cell, carried verbatim so no byte is lost."
19
+ }
20
+ },
21
+ "required": [
22
+ "method",
23
+ "testRefs"
24
+ ],
25
+ "unevaluatedProperties": {
26
+ "not": {}
27
+ },
28
+ "description": "A verification cell split into its parts. For `<method> (<annotation>)`,\n`method` is the text before the first `(`, `annotation` the text between the\nfirst `(` and the last `)` verbatim, and `testRefs` the `TC-N` tokens found\nin `annotation`, in order. No byte of the cell is dropped."
29
+ }