mirai-graph 1.0.0-rc.4 → 1.0.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 (177) hide show
  1. package/CHANGELOG.md +142 -0
  2. package/README.md +65 -9
  3. package/ROADMAP.md +14 -3
  4. package/benchmarks/synthetic-context-reduction-v0/graph.json +37 -0
  5. package/docs/README.md +7 -0
  6. package/docs/adoption/adopter-kit.md +1 -1
  7. package/docs/adoption/choose-profile.md +8 -0
  8. package/docs/adoption/connect-project-15-minutes.md +2 -2
  9. package/docs/adoption/for-developers.md +1 -1
  10. package/docs/adoption/getting-started.md +2 -2
  11. package/docs/adoption/mirai-graph-transition.md +8 -6
  12. package/docs/adoption/seed-to-validated-package.md +1 -1
  13. package/docs/repository-purpose.md +3 -3
  14. package/docs/research/evidence-package-v0.3.md +29 -3
  15. package/docs/research/independent-implementation-pilot-plan.md +1 -1
  16. package/docs/research/scientific-evidence-package.md +34 -0
  17. package/examples/ai-employee-minimal/graph.json +37 -0
  18. package/examples/character-layer-minimal/README.md +1 -1
  19. package/examples/character-layer-minimal/graph.json +37 -0
  20. package/examples/dynamic-episode-minimal/graph.json +47 -0
  21. package/examples/goal-vector-quality-control-minimal/README.md +22 -0
  22. package/examples/goal-vector-quality-control-minimal/gates/results.json +22 -0
  23. package/examples/goal-vector-quality-control-minimal/graph/objects.json +56 -0
  24. package/examples/goal-vector-quality-control-minimal/graph/relations.json +29 -0
  25. package/examples/goal-vector-quality-control-minimal/graph.json +41 -0
  26. package/examples/goal-vector-quality-control-minimal/invalid-complete-without-evidence.json +77 -0
  27. package/examples/goal-vector-quality-control-minimal/invalid-correction-without-route.json +86 -0
  28. package/examples/goal-vector-quality-control-minimal/invalid-missing-reverse-audit.json +77 -0
  29. package/examples/goal-vector-quality-control-minimal/invalid-missing-vector-link.json +62 -0
  30. package/examples/goal-vector-quality-control-minimal/invalid-tests-as-acceptance.json +72 -0
  31. package/examples/goal-vector-quality-control-minimal/results/goal-vector-quality-control.json +130 -0
  32. package/examples/graph-dna-alignment-minimal/graph.json +37 -0
  33. package/examples/implementation-control-cycles/graph.json +37 -0
  34. package/examples/implementation-control-minimal/graph.json +37 -0
  35. package/examples/instrumentation-layer-minimal/graph.json +37 -0
  36. package/examples/invalid-character-layer-context-authorization/graph.json +35 -0
  37. package/examples/invalid-character-layer-correction-loop-no-review/graph.json +35 -0
  38. package/examples/invalid-character-layer-feedback-auto-update/graph.json +35 -0
  39. package/examples/invalid-character-layer-object-kind/graph.json +35 -0
  40. package/examples/invalid-character-layer-relation-direction/graph.json +35 -0
  41. package/examples/invalid-character-layer-relation-type/graph.json +35 -0
  42. package/examples/invalid-character-layer-role-permission/graph.json +35 -0
  43. package/examples/invalid-missing-relation-target/graph.json +32 -0
  44. package/examples/invalid-profile-object-kind/graph.json +32 -0
  45. package/examples/invalid-profile-relation-type/graph.json +32 -0
  46. package/examples/invalid-relation-id-mismatch/graph.json +32 -0
  47. package/examples/invalid-societal-governance-auto-learning-update/graph.json +35 -0
  48. package/examples/invalid-societal-governance-avatar-no-consent/graph.json +35 -0
  49. package/examples/invalid-societal-governance-generated-context-authorization/graph.json +35 -0
  50. package/examples/invalid-societal-governance-missing-appeal-path/graph.json +35 -0
  51. package/examples/invalid-societal-governance-private-trace-exposed/graph.json +35 -0
  52. package/examples/invalid-societal-governance-rights-overridden/graph.json +35 -0
  53. package/examples/launch-record-minimal/graph.json +34 -0
  54. package/examples/managed-project-control-loop/graph.json +37 -0
  55. package/examples/minimal-graph/graph.json +37 -0
  56. package/examples/organization-governance-minimal/graph.json +37 -0
  57. package/examples/process-control-contract-minimal/graph.json +34 -0
  58. package/examples/risk-and-coordination-minimal/graph.json +37 -0
  59. package/examples/self-service-onboarding/existing-graph/graph.json +36 -0
  60. package/examples/self-service-onboarding/no-graph/README.md +1 -1
  61. package/examples/self-service-onboarding/stale-graph/graph.json +36 -0
  62. package/examples/semantic-intent-resolution-minimal/README.md +13 -0
  63. package/examples/semantic-intent-resolution-minimal/invalid-low-confidence-executes.json +26 -0
  64. package/examples/semantic-intent-resolution-minimal/invalid-proposal-canonical-update.json +27 -0
  65. package/examples/semantic-intent-resolution-minimal/results/semantic-intent-resolution.json +45 -0
  66. package/examples/skill-runtime-minimal/graph.json +37 -0
  67. package/examples/societal-governance-minimal/graph.json +37 -0
  68. package/examples/source-boundary-minimal/graph.json +37 -0
  69. package/examples/technology-quality-feedback-minimal/graph.json +34 -0
  70. package/examples/work-recovery-minimal/graph.json +37 -0
  71. package/package.json +14 -3
  72. package/packages/cli/adopter-workflow.js +5 -4
  73. package/packages/cli/context-pack.js +4 -2
  74. package/packages/cli/graph-manifest.js +366 -0
  75. package/packages/cli/migrate-graph-manifest.js +33 -0
  76. package/packages/cli/mirai-graph.js +18 -2
  77. package/packages/cli/playground-demo.js +1 -1
  78. package/packages/cli/project-technology.js +64 -0
  79. package/packages/cli/readiness-score.js +2 -0
  80. package/packages/cli/self-service-onboarding.js +16 -7
  81. package/packages/cli/validate-graph-manifest-migration.js +64 -0
  82. package/packages/cli/validate-mirai-graph.js +441 -8
  83. package/packages/cli/validate-project-technology.js +272 -0
  84. package/packages/cli/validate-self-service-onboarding.js +2 -2
  85. package/packages/project-technology/index.js +742 -0
  86. package/pilots/independent-implementation-001-conference-planning/README.md +1 -1
  87. package/pilots/independent-implementation-001-conference-planning/graph.json +37 -0
  88. package/pilots/independent-implementation-002-software-specification/README.md +1 -1
  89. package/pilots/independent-implementation-002-software-specification/graph.json +37 -0
  90. package/pilots/independent-implementation-003-ai-employee-workflow/README.md +1 -1
  91. package/pilots/independent-implementation-003-ai-employee-workflow/graph.json +37 -0
  92. package/pilots/independent-implementation-004-research-program/README.md +1 -1
  93. package/pilots/independent-implementation-004-research-program/graph.json +37 -0
  94. package/pilots/independent-implementation-005-organization-governance/README.md +1 -1
  95. package/pilots/independent-implementation-005-organization-governance/graph.json +37 -0
  96. package/playground/demo-report.md +1 -1
  97. package/profiles/README.md +3 -0
  98. package/profiles/implementation-control/README.md +4 -0
  99. package/profiles/project-management/README.md +4 -0
  100. package/profiles/skill-runtime/README.md +5 -0
  101. package/publications/README.md +15 -0
  102. package/publications/observable-self-correcting-ai-workflows/README.md +105 -0
  103. package/publications/semantic-intent-goal-vector-control/README.md +99 -0
  104. package/releases/1.0.0-rc.10.md +14 -0
  105. package/releases/1.0.0-rc.11.md +14 -0
  106. package/releases/1.0.0-rc.4.md +3 -0
  107. package/releases/1.0.0-rc.5.md +88 -0
  108. package/releases/1.0.0-rc.6.md +76 -0
  109. package/releases/1.0.0-rc.8.md +17 -0
  110. package/releases/1.0.0-rc.9.md +14 -0
  111. package/releases/1.0.0.md +23 -0
  112. package/releases/README.md +7 -1
  113. package/schemas/goal-vector-quality-control.schema.json +131 -0
  114. package/schemas/graph-lock.schema.json +28 -0
  115. package/schemas/graph-manifest.schema.json +154 -0
  116. package/schemas/project-technology-extension.schema.json +14 -0
  117. package/schemas/project-technology-target-export.schema.json +35 -0
  118. package/schemas/semantic-intent-resolution.schema.json +151 -0
  119. package/standard/goal-vector-quality-control.md +128 -0
  120. package/standard/profile-boundaries.md +225 -0
  121. package/standard/profiles.md +27 -7
  122. package/standard/project-technology.md +75 -0
  123. package/standard/semantic-intent-resolution.md +91 -0
  124. package/standard/test-suite.md +22 -0
  125. package/templates/ai-employee-starter/graph.json +37 -0
  126. package/templates/character-layer-starter/graph.json +37 -0
  127. package/templates/organization-governance-starter/graph.json +37 -0
  128. package/templates/research-program-starter/graph.json +37 -0
  129. package/templates/software-project-starter/graph.json +37 -0
  130. package/benchmarks/synthetic-context-reduction-v0/mirai-graph-package.json +0 -14
  131. package/examples/ai-employee-minimal/mirai-graph-package.json +0 -14
  132. package/examples/character-layer-minimal/mirai-graph-package.json +0 -14
  133. package/examples/dynamic-episode-minimal/mirai-graph-package.json +0 -21
  134. package/examples/graph-dna-alignment-minimal/mirai-graph-package.json +0 -14
  135. package/examples/implementation-control-cycles/mirai-graph-package.json +0 -14
  136. package/examples/implementation-control-minimal/mirai-graph-package.json +0 -14
  137. package/examples/instrumentation-layer-minimal/mirai-graph-package.json +0 -14
  138. package/examples/invalid-character-layer-context-authorization/mirai-graph-package.json +0 -14
  139. package/examples/invalid-character-layer-correction-loop-no-review/mirai-graph-package.json +0 -14
  140. package/examples/invalid-character-layer-feedback-auto-update/mirai-graph-package.json +0 -14
  141. package/examples/invalid-character-layer-object-kind/mirai-graph-package.json +0 -14
  142. package/examples/invalid-character-layer-relation-direction/mirai-graph-package.json +0 -14
  143. package/examples/invalid-character-layer-relation-type/mirai-graph-package.json +0 -14
  144. package/examples/invalid-character-layer-role-permission/mirai-graph-package.json +0 -14
  145. package/examples/invalid-missing-relation-target/mirai-graph-package.json +0 -11
  146. package/examples/invalid-profile-object-kind/mirai-graph-package.json +0 -11
  147. package/examples/invalid-profile-relation-type/mirai-graph-package.json +0 -11
  148. package/examples/invalid-relation-id-mismatch/mirai-graph-package.json +0 -11
  149. package/examples/invalid-societal-governance-auto-learning-update/mirai-graph-package.json +0 -14
  150. package/examples/invalid-societal-governance-avatar-no-consent/mirai-graph-package.json +0 -14
  151. package/examples/invalid-societal-governance-generated-context-authorization/mirai-graph-package.json +0 -14
  152. package/examples/invalid-societal-governance-missing-appeal-path/mirai-graph-package.json +0 -14
  153. package/examples/invalid-societal-governance-private-trace-exposed/mirai-graph-package.json +0 -14
  154. package/examples/invalid-societal-governance-rights-overridden/mirai-graph-package.json +0 -14
  155. package/examples/launch-record-minimal/mirai-graph-package.json +0 -11
  156. package/examples/managed-project-control-loop/mirai-graph-package.json +0 -14
  157. package/examples/minimal-graph/mirai-graph-package.json +0 -14
  158. package/examples/organization-governance-minimal/mirai-graph-package.json +0 -15
  159. package/examples/process-control-contract-minimal/mirai-graph-package.json +0 -11
  160. package/examples/risk-and-coordination-minimal/mirai-graph-package.json +0 -14
  161. package/examples/self-service-onboarding/existing-graph/mirai-graph-package.json +0 -13
  162. package/examples/self-service-onboarding/stale-graph/mirai-graph-package.json +0 -13
  163. package/examples/skill-runtime-minimal/mirai-graph-package.json +0 -14
  164. package/examples/societal-governance-minimal/mirai-graph-package.json +0 -14
  165. package/examples/source-boundary-minimal/mirai-graph-package.json +0 -14
  166. package/examples/technology-quality-feedback-minimal/mirai-graph-package.json +0 -11
  167. package/examples/work-recovery-minimal/mirai-graph-package.json +0 -14
  168. package/pilots/independent-implementation-001-conference-planning/mirai-graph-package.json +0 -14
  169. package/pilots/independent-implementation-002-software-specification/mirai-graph-package.json +0 -14
  170. package/pilots/independent-implementation-003-ai-employee-workflow/mirai-graph-package.json +0 -15
  171. package/pilots/independent-implementation-004-research-program/mirai-graph-package.json +0 -15
  172. package/pilots/independent-implementation-005-organization-governance/mirai-graph-package.json +0 -14
  173. package/templates/ai-employee-starter/mirai-graph-package.json +0 -14
  174. package/templates/character-layer-starter/mirai-graph-package.json +0 -14
  175. package/templates/organization-governance-starter/mirai-graph-package.json +0 -14
  176. package/templates/research-program-starter/mirai-graph-package.json +0 -14
  177. package/templates/software-project-starter/mirai-graph-package.json +0 -14
package/CHANGELOG.md CHANGED
@@ -4,6 +4,148 @@ All notable changes to Mirai Graph will be documented in this file.
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [1.0.0] - 2026-08-17
8
+
9
+ ### Changed
10
+
11
+ - Project Technology is now the stable public execution mechanism for ordinary
12
+ projects, skills, platforms and multi-repository systems.
13
+ - The package, CLI and programmatic API leave release-candidate status without
14
+ changing the public `graph.json` schema or the accepted safety boundaries.
15
+
16
+ ### Evidence Boundary
17
+
18
+ - Stable means the documented contracts and release checks are supported for
19
+ production adoption. It does not claim that every project outcome is correct
20
+ without project-specific goals, evidence and review.
21
+
22
+ ## [1.0.0-rc.11] - 2026-08-17
23
+
24
+ ### Fixed
25
+
26
+ - The bounded architecture contract now preserves the exact human architecture
27
+ owner together with component, capability and operational ownership data.
28
+ - Federation adapters can consume the public contract without reconstructing
29
+ owner identity from a package owner.
30
+
31
+ ## [1.0.0-rc.10] - 2026-08-17
32
+
33
+ ### Fixed
34
+
35
+ - Project Technology now reads complete tracked-file inventories in large
36
+ repositories instead of accepting Node's default child-process buffer.
37
+ - A regression proves that an accepted target remains discoverable after more
38
+ than one megabyte of earlier tracked paths.
39
+
40
+ ## [1.0.0-rc.9] - 2026-08-17
41
+
42
+ ### Fixed
43
+
44
+ - `mirai-graph technology ...` now resolves an omitted repository or `.` from
45
+ the caller's working directory instead of the installed package directory.
46
+ - CLI regressions cover omitted, relative and absolute repository selection.
47
+
48
+ ## [1.0.0-rc.8] - 2026-08-17
49
+
50
+ ### Added
51
+
52
+ - Public `mirai.project_technology` extension contract for projects, skills,
53
+ platforms and multi-repository systems.
54
+ - One CLI and programmatic API for safe inventory, task-scoped context, target
55
+ provider export/import, exact verification and idempotent refresh-binding.
56
+ - Fail-closed fixtures for incomplete or tampered contracts, stale providers,
57
+ dependency cycles, disabled state and blocked significant work.
58
+
59
+ ### Changed
60
+
61
+ - `skill_runtime` remains the vocabulary for skill-specific knowledge, while
62
+ Project Technology supplies the shared execution mechanism.
63
+ - Local mutable state now belongs under `.mirai-graph/project-technology/`.
64
+
65
+ ### Safety Boundary
66
+
67
+ - Bounded provider exports contain identifiers, constraints, approved scope
68
+ and digests only. Raw documents, private source and full graph content remain
69
+ with their owners.
70
+ - Read-only diagnostics remain available when significant work is blocked.
71
+
72
+ ## [1.0.0-rc.7] - 2026-08-06
73
+
74
+ ### Added
75
+
76
+ - Public `graph.json` schema `2.0.0` and separate immutable dependency-lock schema.
77
+ - Read-only-by-default `mirai-graph migrate`, with `--apply`, backup, atomic activation, automatic rollback and idempotent repeat execution.
78
+ - Cross-format readers for the former root workspace descriptor, inner graph manifest and public package manifest.
79
+
80
+ ### Changed
81
+
82
+ - `init`, examples, pilots and starters now write one root `graph.json`; `graph/` contains graph data only.
83
+ - Legacy identifiers become aliases, while known legacy metadata is preserved in namespaced extensions.
84
+ - Validation, context, readiness and adopter workflows consume the same v2 manifest.
85
+
86
+ ### Compatibility Boundary
87
+
88
+ - Legacy manifests remain readable for one public RC, but all writers emit v2 only.
89
+ - Migration fails closed on identity conflicts, unknown legacy fields or missing package entrypoints.
90
+ - Graph objects, relations and raw technology sources are not rewritten by manifest migration.
91
+
92
+ ## [1.0.0-rc.6] - 2026-06-27
93
+
94
+ ### Added
95
+
96
+ - Release consolidation notes for the anti-drift / quality-control contour that
97
+ connects Semantic Intent Resolution, Dynamic Episode tracing, Goal Vector
98
+ Quality Control and Technology Quality Feedback.
99
+ - Publication foundation package for Semantic Intent and Goal-Vector Control.
100
+ - Publication foundation package for Observable Self-Correcting AI Workflows.
101
+
102
+ ### Changed
103
+
104
+ - Working package version is now `1.0.0-rc.6`.
105
+ - README, release index and evidence package now describe the consolidated
106
+ anti-drift contour as a review surface instead of separate isolated features.
107
+ - Publications index now separates the two article candidates and their evidence
108
+ requirements.
109
+
110
+ ### Claim Boundary
111
+
112
+ - This release candidate consolidates already validator-backed public shapes and
113
+ publication scaffolds.
114
+ - It does not claim peer-reviewed effectiveness, real-world drift reduction,
115
+ production autonomous execution safety or authorization from traces, evidence,
116
+ feedback, goal vectors, semantic confidence or proposals.
117
+
118
+ ## [1.0.0-rc.5] - 2026-06-27
119
+
120
+ ### Added
121
+
122
+ - Semantic Intent Resolution standard as an input-control extension contract.
123
+ - Semantic intent schema, synthetic positive example and negative fixtures for
124
+ low-confidence execution and proposal-as-canonical-update violations.
125
+ - CLI validation support for `semantic-intent-resolution`.
126
+ - Goal Vector Quality Control standard as a quality-control extension contract.
127
+ - Goal-vector schema, synthetic positive example and negative fixtures for
128
+ missing vector links, false completion, tests-as-acceptance, missing reverse
129
+ audit and correction-without-route violations.
130
+ - CLI validation support for `goal-vector-quality-control`.
131
+
132
+ ### Changed
133
+
134
+ - Working package version is now `1.0.0-rc.5`.
135
+ - README, documentation map and release index now list Semantic Intent
136
+ Resolution and Goal Vector Quality Control as part of the release-candidate
137
+ standard surface.
138
+ - `npm test` includes Semantic Intent Resolution and Goal Vector Quality
139
+ Control positive and negative checks.
140
+
141
+ ### Claim Boundary
142
+
143
+ - This release validates the public shape and safety boundaries of Semantic
144
+ Intent Resolution.
145
+ - It does not claim production readiness, automatic correct process selection,
146
+ live-action authorization or canonical updates from generated briefs,
147
+ proposals, evidence, reverse audits, goal vectors or semantic confidence.
148
+
7
149
  ## [1.0.0-rc.4] - 2026-06-16
8
150
 
9
151
  ### Added
package/README.md CHANGED
@@ -10,7 +10,7 @@ Use it when a software project has useful knowledge spread across README files,
10
10
  docs, issues, chats, code comments and AI prompts, and you need a small
11
11
  machine-readable map that developers and AI assistants can validate and reuse.
12
12
 
13
- Status: public `1.0.0-rc.4` release candidate.
13
+ Status: stable public `1.0.0` release.
14
14
 
15
15
  ## What Problem Does It Solve?
16
16
 
@@ -42,9 +42,8 @@ Start with a normal repository and use Mirai Graph to:
42
42
 
43
43
  ## Current Installation Status
44
44
 
45
- The repository is ready as a release candidate, but `mirai-graph@1.0.0-rc.4` is
46
- not published on npm yet. Until npm publication is complete, use the repository
47
- checkout path:
45
+ The repository is ready as the stable `mirai-graph@1.0.0` package. To verify a
46
+ repository checkout directly, use:
48
47
 
49
48
  ```bash
50
49
  git clone https://github.com/zabarov/mirai-graph.git
@@ -53,7 +52,7 @@ npm install
53
52
  npm run release:check
54
53
  ```
55
54
 
56
- After npm publication, external projects will use:
55
+ External projects use:
57
56
 
58
57
  ```bash
59
58
  npm install -D mirai-graph
@@ -68,6 +67,7 @@ npx mirai-graph detect . --markdown
68
67
  npx mirai-graph bootstrap . --mode suggest --markdown
69
68
  npx mirai-graph init . --profile software_specification
70
69
  npx mirai-graph validate .
70
+ npx mirai-graph migrate .
71
71
  ```
72
72
 
73
73
  What each command does:
@@ -76,16 +76,51 @@ What each command does:
76
76
  - `bootstrap --mode suggest` creates proposal/evidence only.
77
77
  - `init` creates starter graph files after you choose a profile.
78
78
  - `validate` checks the graph package structure and profile rules.
79
+ - `migrate` shows a read-only plan; add `--apply` only after reviewing it.
79
80
 
80
81
  If you are using a repository checkout before npm publication, run the same
81
82
  commands through `node packages/cli/mirai-graph.js` from this repository.
82
83
 
84
+ ## Project Technology
85
+
86
+ Project Technology is the executable part of Mirai Graph. It gives ordinary
87
+ projects, skills, platforms and federations one safe way to build task context,
88
+ bind an accepted target and verify that work still follows it.
89
+
90
+ Enable it in the existing root manifest:
91
+
92
+ ```json
93
+ {
94
+ "extensions": {
95
+ "mirai.project_technology": {
96
+ "contract_version": "1.0.0",
97
+ "enabled": true,
98
+ "context_policy": "task_scoped",
99
+ "source_boundary": "hybrid_sot"
100
+ }
101
+ }
102
+ }
103
+ ```
104
+
105
+ Read-only operations never need `--apply`:
106
+
107
+ ```bash
108
+ mirai-graph technology explain .
109
+ mirai-graph technology status .
110
+ mirai-graph technology context . --task "implement the approved feature"
111
+ mirai-graph technology verify . --significant-work
112
+ ```
113
+
114
+ Changing operations return a preview unless `--apply` is explicit. See
115
+ [Project Technology](standard/project-technology.md) for provider/consumer
116
+ binding, local state and safety boundaries.
117
+
83
118
  ## What Files Will Be Created?
84
119
 
85
120
  For a typical software project, `init` creates:
86
121
 
87
122
  ```text
88
- mirai-graph-package.json
123
+ graph.json
89
124
  graph/
90
125
  objects.json # features, requirements, risks, decisions, evidence
91
126
  relations.json # depends_on, implements, blocks, evidences, governs
@@ -162,10 +197,13 @@ releases/ Release notes and release process.
162
197
  - [Context Pack Generation](standard/context-pack-generation.md)
163
198
  - [Governance](standard/governance.md)
164
199
  - [Hybrid Source Of Truth](standard/hybrid-source-of-truth.md)
200
+ - [Profile Boundaries](standard/profile-boundaries.md)
165
201
  - [Implementation Control](standard/implementation-control.md)
166
202
  - [Process Control Contract](standard/process-control-contract.md)
167
203
  - [Technology Quality Feedback](standard/technology-quality-feedback.md)
168
204
  - [Dynamic Episode Layer](standard/dynamic-episode-layer.md)
205
+ - [Semantic Intent Resolution](standard/semantic-intent-resolution.md)
206
+ - [Goal Vector Quality Control](standard/goal-vector-quality-control.md)
169
207
  - [Character Layer Profile](profiles/character-layer/README.md)
170
208
  - [Organization Governance](standard/organization-governance.md)
171
209
 
@@ -226,13 +264,31 @@ Generated context, evidence, feedback, cockpit metrics and proposals do not
226
264
  authorize canonical updates by themselves. Controlled updates require explicit
227
265
  governance gates.
228
266
 
267
+ Mirai Graph also does not store bulk source content as canonical graph state.
268
+ Documents, code, CMS records, tickets and databases remain source systems. The
269
+ graph stores governable meaning: object ids, relations, summaries, source refs,
270
+ evidence refs, owners, readiness, gates, decisions, episode metadata and Kaizen
271
+ routes. See [Profile Boundaries](standard/profile-boundaries.md).
272
+
229
273
  ## Release Candidate
230
274
 
231
- The current release candidate consolidates the validator-backed public standard
275
+ The stable 1.0 release consolidates the validator-backed public standard
232
276
  across the core model, profiles, executable process control, instrumentation,
233
- Character Layer, Dynamic Episode tracing, adopter kit and evidence boundaries.
277
+ Character Layer, adopter kit and evidence boundaries.
278
+
279
+ `1.0.0-rc.6` specifically presents the anti-drift / quality-control contour as
280
+ one coherent review surface:
281
+
282
+ ```text
283
+ semantic intent
284
+ -> process and technology control
285
+ -> dynamic episode trace
286
+ -> goal-vector reverse audit
287
+ -> technology quality feedback
288
+ -> Kaizen / replay / regression candidate
289
+ ```
234
290
 
235
- See [v1.0.0-rc.4](releases/1.0.0-rc.4.md) and the
291
+ See [v1.0.0-rc.6](releases/1.0.0-rc.6.md) and the
236
292
  [Release Process](releases/README.md).
237
293
 
238
294
  ## What This Repository Is Not
package/ROADMAP.md CHANGED
@@ -56,6 +56,7 @@ Additional 1.0 RC artifacts now present:
56
56
 
57
57
  - graph seed and graph embryo;
58
58
  - hybrid source of truth;
59
+ - profile boundaries and the extension-before-profile rule;
59
60
  - graph-as-AI-brain;
60
61
  - action/runtime boundary;
61
62
  - implementation-control cycles;
@@ -63,6 +64,8 @@ Additional 1.0 RC artifacts now present:
63
64
  - work state machine;
64
65
  - process-control contract;
65
66
  - technology quality feedback;
67
+ - semantic intent resolution;
68
+ - goal vector quality control;
66
69
  - recovery/resume;
67
70
  - risk-control matrix;
68
71
  - multi-agent coordination;
@@ -73,7 +76,10 @@ Additional 1.0 RC artifacts now present:
73
76
  - Character Layer profile, starter pack, integration evidence, portability
74
77
  evidence shape and 1.0 readiness artifact.
75
78
  - proposal/experimental Dynamic Episode Layer, episode trace schema and
76
- synthetic code-generation trace example.
79
+ synthetic code-generation trace example;
80
+ - `1.0.0-rc.6` anti-drift / quality-control contour that connects semantic
81
+ intent, process control, dynamic episode tracing, goal-vector reverse audit,
82
+ technology quality feedback and Kaizen/replay follow-up.
77
83
 
78
84
  Readiness target:
79
85
 
@@ -108,6 +114,8 @@ Post-1.0 gaps:
108
114
  - import/export helpers for starter packages;
109
115
  - stronger non-software adoption recipes;
110
116
  - external adopter feedback from independent pilots.
117
+ - sanitized pilot/replay evidence for the anti-drift contour before claiming
118
+ real-world drift reduction.
111
119
 
112
120
  Implemented adopter-workflow focus:
113
121
 
@@ -160,6 +168,8 @@ Post-1.0 gaps:
160
168
  workflows.
161
169
  - evolve dynamic episode traces from synthetic validation to replay/regression
162
170
  support for internal pilots.
171
+ - add optional validator/report warnings for profile overlap and bulk-content
172
+ drift.
163
173
 
164
174
  Current tooling target:
165
175
 
@@ -220,7 +230,7 @@ Planned artifacts:
220
230
 
221
231
  ## Near-Term Work After 1.0 RC
222
232
 
223
- 1. Execute the `1.0.0-rc.4` release: tag, GitHub Release and npm publication
233
+ 1. Execute the `1.0.0-rc.6` release: tag, GitHub Release and npm publication
224
234
  only after release-state checks are accepted.
225
235
  2. Continue adopter workflow: import/export helper skeletons, richer report
226
236
  formatting and more adoption recipes when they directly support self-service
@@ -232,4 +242,5 @@ Planned artifacts:
232
242
  portability claims.
233
243
  6. Explore a local interactive playground only after deterministic report
234
244
  fixtures remain stable.
235
- 7. Turn evidence package v0.3 into a publication-ready reproducibility bundle.
245
+ 7. Turn evidence package v0.3 and the two article foundations into a
246
+ publication-ready reproducibility bundle.
@@ -0,0 +1,37 @@
1
+ {
2
+ "$schema": "https://mirai-graph.dev/schemas/graph-manifest.schema.json",
3
+ "format": "mirai-graph",
4
+ "schema_version": "2.0.0",
5
+ "id": "package.synthetic_context_reduction_v0",
6
+ "aliases": [],
7
+ "title": "Synthetic Context-Reduction Benchmark v0",
8
+ "scope": "package",
9
+ "kind": "graph_package",
10
+ "owner": "mirai-graph",
11
+ "profiles": [
12
+ "software_specification"
13
+ ],
14
+ "graph": {
15
+ "root": "graph",
16
+ "source_of_truth": [
17
+ "graph"
18
+ ],
19
+ "objects": [
20
+ "graph/objects.json"
21
+ ],
22
+ "relations": [
23
+ "graph/relations.json"
24
+ ],
25
+ "schemas": [],
26
+ "generated": [],
27
+ "raw_sources": [
28
+ "README.md"
29
+ ]
30
+ },
31
+ "imports": [],
32
+ "version": "0.1.0",
33
+ "conformance_level": "level_1",
34
+ "description": "A public-safe synthetic benchmark for inspecting Mirai Graph context-selection structure.",
35
+ "license": "CC-BY-4.0",
36
+ "public_safety": "synthetic_public"
37
+ }
package/docs/README.md CHANGED
@@ -38,6 +38,7 @@ Core model:
38
38
  - [Context Pack Generation](../standard/context-pack-generation.md)
39
39
  - [Governance](../standard/governance.md)
40
40
  - [Hybrid Source Of Truth](../standard/hybrid-source-of-truth.md)
41
+ - [Profile Boundaries](../standard/profile-boundaries.md)
41
42
 
42
43
  Executable process and implementation control:
43
44
 
@@ -48,6 +49,8 @@ Executable process and implementation control:
48
49
  - [Process Control Contract](../standard/process-control-contract.md)
49
50
  - [Technology Quality Feedback](../standard/technology-quality-feedback.md)
50
51
  - [Dynamic Episode Layer](../standard/dynamic-episode-layer.md)
52
+ - [Semantic Intent Resolution](../standard/semantic-intent-resolution.md)
53
+ - [Goal Vector Quality Control](../standard/goal-vector-quality-control.md)
51
54
  - [Episode Trace](../standard/episode-trace.md)
52
55
  - [Dynamic Layer For AI-Assisted Code Generation](../standard/dynamic-layer-code-generation.md)
53
56
  - [Recovery Resume](../standard/recovery-resume.md)
@@ -92,6 +95,8 @@ Proposal or experimental profile:
92
95
  - [Process Transition](../examples/process-transition-minimal/README.md)
93
96
  - [Technology Quality Feedback](../examples/technology-quality-feedback-minimal/README.md)
94
97
  - [Dynamic Episode Minimal Example](../examples/dynamic-episode-minimal/README.md)
98
+ - [Semantic Intent Resolution](../examples/semantic-intent-resolution-minimal/README.md)
99
+ - [Goal Vector Quality Control](../examples/goal-vector-quality-control-minimal/README.md)
95
100
  - [Instrumentation Layer](../examples/instrumentation-layer-minimal/README.md)
96
101
  - [Organization Governance](../examples/organization-governance-minimal/README.md)
97
102
  - [Societal Governance Proposal Example](../examples/societal-governance-minimal/README.md)
@@ -111,6 +116,8 @@ Proposal or experimental profile:
111
116
  - [Roadmap](../ROADMAP.md)
112
117
  - [Changelog](../CHANGELOG.md)
113
118
  - [Release Process](../releases/README.md)
119
+ - [v1.0.0-rc.6](../releases/1.0.0-rc.6.md)
120
+ - [v1.0.0-rc.5](../releases/1.0.0-rc.5.md)
114
121
  - [v1.0.0-rc.4](../releases/1.0.0-rc.4.md)
115
122
  - [Contributing](../CONTRIBUTING.md)
116
123
 
@@ -114,7 +114,7 @@ npm run validate:adopter-workflow
114
114
 
115
115
  A 1.0 release-candidate adopter package is ready for first internal use when:
116
116
 
117
- - `mirai-graph-package.json` exists and points to graph, gates and profile.
117
+ - root `graph.json` v2 exists and points to graph sources and profiles.
118
118
  - `graph/objects.json` has stable object ids, kinds, summaries and readiness.
119
119
  - `graph/relations.json` has directed relations with valid source/target ids.
120
120
  - `gates/results.json` records at least the initial validation gate.
@@ -10,6 +10,11 @@ the first profile, starter template and validation path.
10
10
  Start narrow. A useful first package should model one bounded system, not the
11
11
  entire organization.
12
12
 
13
+ If a new idea appears to need a new profile, first read
14
+ [Profile Boundaries](../../standard/profile-boundaries.md). Mirai Graph uses
15
+ `extension before profile`: prefer an existing profile object, relation, gate,
16
+ validator or proposal before adding a new profile name.
17
+
13
18
  ## Quick Choice
14
19
 
15
20
  | You are modeling | Start with profile | Starter template | Validate with |
@@ -96,3 +101,6 @@ node packages/cli/mirai-graph.js adopter report templates/software-project-start
96
101
  - Generated context, evidence, feedback and proposals do not authorize
97
102
  canonical updates.
98
103
  - Production execution stays outside the public alpha adopter workflow.
104
+ - Full documents, articles, code and raw logs should stay in source systems.
105
+ Mirai Graph stores references, governable meaning, gates and evidence links,
106
+ not bulk content.
@@ -17,7 +17,7 @@ From the project you want to connect:
17
17
  npm install -D mirai-graph
18
18
  ```
19
19
 
20
- Release-candidate note: `mirai-graph@1.0.0-rc.4` is not published on npm yet.
20
+ Release-candidate note: `mirai-graph@1.0.0-rc.6` is not published on npm yet.
21
21
  Until npm publication is complete, use a repository checkout and run the same
22
22
  commands through `node packages/cli/mirai-graph.js`.
23
23
 
@@ -75,7 +75,7 @@ npx mirai-graph init . --profile organization_governance
75
75
  `init` creates:
76
76
 
77
77
  ```text
78
- mirai-graph-package.json
78
+ graph.json
79
79
  graph/objects.json
80
80
  graph/relations.json
81
81
  gates/results.json
@@ -71,7 +71,7 @@ package remains structurally usable.
71
71
  A starter software graph usually looks like this:
72
72
 
73
73
  ```text
74
- mirai-graph-package.json
74
+ graph.json
75
75
  graph/
76
76
  objects.json
77
77
  relations.json
@@ -25,7 +25,7 @@ npx mirai-graph init . --profile software_specification
25
25
  npx mirai-graph validate .
26
26
  ```
27
27
 
28
- Release-candidate note: `mirai-graph@1.0.0-rc.4` is not published on npm yet.
28
+ Release-candidate note: `mirai-graph@1.0.0-rc.6` is not published on npm yet.
29
29
  Until npm publication is complete, use the repository checkout path and run the
30
30
  same commands through `node packages/cli/mirai-graph.js`.
31
31
 
@@ -74,7 +74,7 @@ Do not try to model everything at once.
74
74
  Recommended minimal structure:
75
75
 
76
76
  ```text
77
- mirai-graph-package.json
77
+ graph.json
78
78
  graph/
79
79
  objects.json
80
80
  relations.json
@@ -22,7 +22,8 @@ feedback and controlled evolution.
22
22
 
23
23
  - Package name: `mirai-graph`.
24
24
  - Primary CLI: `mirai-graph`.
25
- - Preferred package manifest: `mirai-graph-package.json`.
25
+ - Canonical workspace and package manifest: root `graph.json` schema `2.0.0`.
26
+ - `mirai-graph-package.json` and `graph/graph.json` are read-only legacy inputs during the compatibility window.
26
27
  - Public docs and examples use Mirai Graph naming.
27
28
 
28
29
  ## Current Command Surfaces
@@ -33,18 +34,19 @@ The supported current command surfaces are:
33
34
  - `node packages/cli/mirai-graph.js ...` for repository checkout maintenance;
34
35
  - `node packages/cli/mirai_graph.js ...` as an underscore alias;
35
36
  - `node packages/cli/validate-mirai-graph.js ...` for direct validator calls;
36
- - `mirai-graph-package.json`
37
+ - `graph.json` plus `graph.lock.json` for immutable external pins
37
38
 
38
39
  The underscore CLI is an alias for local environments that prefer identifier
39
40
  style command names. It is not a separate standard.
40
41
 
41
42
  ## Migration Steps
42
43
 
43
- 1. Use `mirai-graph-package.json` for package manifests.
44
- 2. Use `npx mirai-graph validate .` in adopter projects.
45
- 3. Use direct validator calls from repository checkout only when maintaining
44
+ 1. Run `mirai-graph migrate .` for a read-only plan and add `--apply` only after review.
45
+ 2. Keep exactly one root `graph.json`; do not write a second manifest into `graph/`.
46
+ 3. Use `npx mirai-graph validate .` in adopter projects.
47
+ 4. Use direct validator calls from repository checkout only when maintaining
46
48
  Mirai Graph itself.
47
- 4. Keep generated reports as historical evidence; do not rewrite evidence
49
+ 5. Keep generated reports as historical evidence; do not rewrite evidence
48
50
  payloads unless they are regenerated by the current tooling.
49
51
 
50
52
  ## Schema Namespace
@@ -41,7 +41,7 @@ The embryo is a reviewable candidate state. It is not canonical graph state.
41
41
  Minimum package shape:
42
42
 
43
43
  ```text
44
- mirai-graph-package.json
44
+ graph.json
45
45
  graph/
46
46
  objects.json
47
47
  relations.json
@@ -23,7 +23,7 @@ The repository should become the public source of truth for:
23
23
  - synthetic benchmarks and playground materials;
24
24
  - publications, citations and research evidence.
25
25
 
26
- For the current public release candidate, "source of truth" means public
26
+ For the current stable release, "source of truth" means public
27
27
  standardization and reproducible examples. It does not mean that private
28
28
  project graphs, internal workflows or generated context packs are published
29
29
  here.
@@ -87,7 +87,7 @@ The model is not just a knowledge graph. It combines:
87
87
  - implementation and adoption methods.
88
88
  - organization-governance coordination patterns.
89
89
 
90
- The current 1.0 release candidate also makes the operating model executable
90
+ The stable 1.0 release also makes the operating model executable
91
91
  enough to test:
92
92
 
93
93
  - launch records define bounded work permission;
@@ -182,7 +182,7 @@ test the model:
182
182
 
183
183
  Synthetic evidence must be clearly separated from real-world validation.
184
184
 
185
- In the current release candidate, `playground/` is an index of runnable CLI
185
+ In the stable release, `playground/` is an index of runnable CLI
186
186
  examples. A hosted or interactive playground is future work.
187
187
 
188
188
  ### 6. Link Publications And Research Evidence
@@ -5,7 +5,7 @@ Status: 1.0 release-candidate public evidence package
5
5
  ## Purpose
6
6
 
7
7
  This package is the current public evidence entrypoint for Mirai Graph
8
- `1.0.0-rc.4`. It connects three evidence layers:
8
+ `1.0.0-rc.6`. It connects three evidence layers:
9
9
 
10
10
  1. Synthetic benchmark and baseline comparison.
11
11
  2. Executable instrumentation artifacts.
@@ -27,6 +27,9 @@ It does not claim peer-reviewed proof of effectiveness.
27
27
  | Instrumentation | `examples/instrumentation-layer-minimal/` | cockpit, traceability and multi-source feedback shape | prediction of real production outcomes |
28
28
  | Character Layer | `examples/character-layer-readiness-1-0/` | reusable behavior-governance profile, integration shape and portability evidence format | proof of broad model equivalence or production replacement safety |
29
29
  | Dynamic Episode | `examples/dynamic-episode-minimal/` | event-to-decision trace shape, blocked alternatives and feedback routing | proof of reduced drift in real code generation |
30
+ | Semantic Intent | `examples/semantic-intent-resolution-minimal/` | input-control shape for intent, scale, owner, missing context and safe default action | proof that all real requests are interpreted correctly |
31
+ | Goal Vector | `examples/goal-vector-quality-control-minimal/` | final-outcome vector links, reverse audit and correction routing | proof of reduced real-world goal drift |
32
+ | Technology Feedback | `examples/technology-quality-feedback-minimal/` | conformance-check shape and classified process findings | proof that real work always followed the technology |
30
33
  | Public pilots | `pilots/independent-implementation-001..005-*` | profile applicability across domains | proof of real-world effectiveness |
31
34
  | Adopter kit | `docs/adoption/adopter-kit.md` | repeatable first adoption path | successful adoption without review |
32
35
 
@@ -54,6 +57,14 @@ H7. Externalized Character Layer constraints can improve behavior portability
54
57
  across model backends when measured through the same graph context, task set and
55
58
  fixtures.
56
59
 
60
+ H8. Semantic intent resolution plus goal-vector quality control can reduce
61
+ wrong-start errors, goal drift and false completion claims in AI-assisted
62
+ workflows.
63
+
64
+ H9. Dynamic episode traces plus technology quality feedback can make
65
+ AI-assisted work auditable enough to support replay, regression and Kaizen
66
+ improvement loops.
67
+
57
68
  These are hypotheses and engineering claims under test, not settled scientific
58
69
  facts.
59
70
 
@@ -67,6 +78,8 @@ facts.
67
78
  | Process transition | `examples/process-transition-minimal/` | `npm run validate:process-transition` | Executable fixture |
68
79
  | Process explanation report | `examples/process-transition-minimal/results/` | `npm run validate:process-transition-report` | Executable fixture |
69
80
  | Technology feedback | `examples/technology-quality-feedback-minimal/` | `npm run validate:technology-quality-feedback` | Executable fixture |
81
+ | Semantic intent | `examples/semantic-intent-resolution-minimal/` | `npm run validate:semantic-intent-resolution` | Executable fixture |
82
+ | Goal vector quality | `examples/goal-vector-quality-control-minimal/` | `npm run validate:goal-vector-quality-control` | Executable fixture |
70
83
  | Instrumentation layer | `examples/instrumentation-layer-minimal/` | `npm run validate:instrumentation-layer` | Executable fixture |
71
84
  | Instrumentation report | `examples/instrumentation-layer-minimal/` | `npm run validate:instrumentation-report` | Readable report |
72
85
  | Character Layer readiness | `examples/character-layer-readiness-1-0/` | `npm run validate:character-layer-readiness` | Profile readiness |
@@ -102,6 +115,8 @@ The public suite currently measures or validates:
102
115
  - process-transition validity;
103
116
  - missing transition evidence;
104
117
  - technology-feedback classification;
118
+ - semantic-intent route decision shape;
119
+ - goal-vector linkage and reverse-audit shape;
105
120
  - instrumentation report validity;
106
121
  - character-layer readiness;
107
122
  - model-portability evidence shape;
@@ -172,7 +187,7 @@ node packages/cli/mirai-graph.js report playground
172
187
 
173
188
  ## Current Evidence Verdict
174
189
 
175
- Mirai Graph `1.0.0-rc.4` supports these bounded claims:
190
+ Mirai Graph `1.0.0-rc.6` supports these bounded claims:
176
191
 
177
192
  - a public executable standard draft exists;
178
193
  - schemas, validators, templates, examples and pilots are runnable;
@@ -186,13 +201,20 @@ Mirai Graph `1.0.0-rc.4` supports these bounded claims:
186
201
  - Dynamic Episode traces can record a selected path, blocked alternatives,
187
202
  evidence refs, finding classification and feedback routing for one governed
188
203
  episode;
204
+ - Semantic Intent Resolution can represent and validate an intent, scale,
205
+ owner/process and safe-default-action decision before execution;
206
+ - Goal Vector Quality Control can represent and validate final-outcome vector
207
+ links, reverse audit, drift findings and correction routes;
208
+ - the current public anti-drift contour can be inspected as a connected
209
+ sequence of input control, process control, episode trace, goal-vector audit,
210
+ technology feedback and Kaizen/replay candidate;
189
211
  - synthetic baseline comparison can record context, evidence and assumption
190
212
  metrics;
191
213
  - public-safe pilots cover project-management, software-specification,
192
214
  AI-employee, research-program and organization-governance scenarios;
193
215
  - the adopter kit gives a reproducible first-use path.
194
216
 
195
- Mirai Graph `1.0.0-rc.4` does not yet support these claims:
217
+ Mirai Graph `1.0.0-rc.6` does not yet support these claims:
196
218
 
197
219
  - peer-reviewed effectiveness;
198
220
  - production autonomous execution safety;
@@ -202,6 +224,8 @@ Mirai Graph `1.0.0-rc.4` does not yet support these claims:
202
224
  - automatic correctness of generated context;
203
225
  - automatic canonical update authorization from evidence, feedback or
204
226
  proposals.
227
+ - proven real-world reduction of wrong-start, goal drift or process violation
228
+ rates without pilot/replay/regression evidence.
205
229
 
206
230
  ## Next Evidence Work
207
231
 
@@ -214,6 +238,8 @@ Mirai Graph `1.0.0-rc.4` does not yet support these claims:
214
238
  - Add reviewer-effort and time-to-relevant-context metrics.
215
239
  - Prepare a publication-ready reproducibility bundle that cites this package as
216
240
  the current release-candidate evidence index.
241
+ - Use the two article foundation packages in `publications/` to collect
242
+ sanitized pilot evidence and publication-ready limitations.
217
243
 
218
244
  ## Public Safety Boundary
219
245