mirai-graph 1.3.0 → 2.1.0

package/releases/0.1.0-alpha.1.md

@@ -1,63 +0,0 @@
-# Mirai Graph 0.1.0-alpha.1
-
-Release type: standard, tooling and pilot evidence alpha
-
-## Summary
-
-This release turns the initial public foundation into a more usable
-research-engineering alpha. It adds graph seed/embryo methods, transfer mapping
-from the practical `$graph` skill, alpha tooling, profiles, research protocols
-and the first independent implementation pilot.
-
-## Added
-
-- Practice-and-science program framing.
-- `$graph` to Mirai Graph transfer map.
-- Standard gap report.
-- Graph DNA, Graph Seed and Graph Embryo standard sections.
-- Graph seed and graph embryo schemas.
-- Minimal graph seed example.
-- Seed preview CLI command.
-- Readiness score CLI command.
-- Context-pack generator alpha command.
-- Profile validation command.
-- Context-pack, profile and readiness score schemas.
-- Software specification and project management profiles.
-- Measure-convert-optimize benchmark protocol.
-- Semantic completeness review protocol.
-- Independent implementation pilot plan.
-- Independent implementation pilot 001 for synthetic conference planning.
-- Worked tutorial from graph seed to validated package.
-- Negative validation fixtures.
-- `release:check` script.
-- GitHub Actions CI workflow.
-
-## Validation
-
-Run:
-
-```bash
-npm run release:check
-```
-
-Expected:
-
-- minimal graph validates;
-- synthetic benchmark validates;
-- graph seed validates;
-- profiles validate;
-- seed preview emits a graph embryo;
-- context-pack generator emits a context pack;
-- readiness score returns a capped pilot score for synthetic evidence;
-- synthetic benchmark returns `56.4516%`;
-- negative fixture fails as expected;
-- whitespace check passes.
-
-## Important Limitations
-
-- Context-pack generation is still alpha and includes the full package graph.
-- Readiness scoring is a navigation signal, not approval.
-- Pilot 001 is synthetic; it validates package creation, not real-world
-  productivity.
-- Broader scientific claims require current-mode vs graph-mode comparisons,
-  semantic completeness reviews and cross-domain replication.

package/releases/0.1.0-alpha.10.md

@@ -1,93 +0,0 @@
-# Mirai Graph v0.1.0-alpha.10
-
-Status: GitHub prerelease prepared; npm publication pending registry
-authentication.
-
-## Theme
-
-Adopter Workflow.
-
-Alpha.10 makes Mirai Graph easier to apply without author-side guidance. The
-release turns the current standards, profiles, templates, examples and CLI
-validators into a clearer self-service adoption path.
-
-## Included Scope
-
-### Adopter Journey
-
-- A concise profile-selection guide for developers, researchers, product teams
-  and organization-governance adopters.
-- A runnable path from starter template to validated package.
-- A single practical workflow:
-
-```text
-choose profile -> copy starter -> fill graph package -> validate -> generate report -> launch work -> record evidence -> run feedback/kaizen
-```
-
-### CLI Usability
-
-- `mirai-graph choose-profile` for role/profile/starter selection.
-- `mirai-graph adopter plan <role-or-profile>` for next-command guidance.
-- `mirai-graph adopter report <template-dir>` for a readable starter report.
-- `mirai-graph release state` for non-secret release-state checks across the
-  package version, git tag, GitHub Release, npm registry and npm auth boundary.
-- `validate:adopter-workflow` for command-level regression checks.
-- `validate:release-state` for pre-tag release-state report regression checks.
-- `mirai-graph release state --require-github-release` for post-GitHub-Release
-  verification.
-- Import/export helper skeletons remain a follow-up unless they directly
-  support the adopter happy path.
-
-### Adoption Evidence
-
-- Clearer organization-governance validation report.
-- Updated public-safe adopter examples.
-- Research evidence notes that distinguish synthetic evidence, pilot evidence
-  and scientific proof boundaries.
-
-## Out Of Scope
-
-- Runtime autonomy.
-- Production execution.
-- Automatic canonical updates from evidence, feedback or proposals.
-- Private SIMAI/Larena/skill-federation payloads.
-- Broad scientific proof claims.
-
-## Done
-
-- A new adopter can pick a profile and run a complete local validation path.
-- The CLI has a documented happy path for the starter templates.
-- Validation reports are readable enough to support review without inspecting
-  raw JSON first.
-- Organization-governance adoption has a stronger public-safe example/report.
-- Release-state reporting separates GitHub Release readiness, npm registry
-  state and npm authentication state.
-- `npm test` and `npm run release:check` pass.
-
-## Release State
-
-- GitHub repository: `zabarov/mirai-graph`.
-- Git tag: `v0.1.0-alpha.10`.
-- GitHub Release: `v0.1.0-alpha.10`.
-- NPM package: pending publication until npm registry authentication is
-  available.
-
-## Validation
-
-```bash
-npm run validate:adopter-workflow
-npm run validate:release-state
-npm run validate:cli-unified
-npm run validate:templates
-npm run release:check
-node packages/cli/mirai-graph.js release state --require-github-release --markdown
-```
-
-## Claim Boundary
-
-This release supports public alpha claims for starter-template adoption,
-role/profile selection, readable local reports and release-state visibility.
-
-It does not claim npm publication, peer-reviewed proof, runtime autonomy,
-production safety or automatic canonical updates from generated context,
-evidence, feedback or proposals.

package/releases/0.1.0-alpha.11.md

@@ -1,114 +0,0 @@
-# Mirai Graph v0.1.0-alpha.11
-
-Status: release candidate prepared in repository; tag, GitHub Release and npm
-publish require separate release execution.
-
-## Theme
-
-Instrumentation Layer.
-
-Alpha.11 prepares Mirai Graph to model not only governed process transitions,
-but the instruments used to steer them: development cockpit signals, feature
-implementation traceability and multi-source quality feedback.
-
-It also adds a role-oriented adopter kit that connects starter templates, CLI
-commands, validation checks and public-safety boundaries into a single entry
-point for external evaluators.
-
-The current alpha.11 evidence index is
-`docs/research/evidence-package-v0.3.md`, which connects synthetic benchmarks,
-instrumentation artifacts, public-safe pilots and claim boundaries.
-
-## Included Scope
-
-### Development Cockpit
-
-- New standard: `standard/development-cockpit.md`.
-- New schema: `schemas/development-cockpit.schema.json`.
-- New result validator mode: `development-cockpit`.
-- Synthetic report in `examples/instrumentation-layer-minimal`.
-
-The cockpit is an instrument panel. It can recommend a bounded next action, but
-it cannot authorize execution, acceptance, release or canonical graph update.
-
-### Feature Implementation Traceability
-
-- New standard: `standard/feature-implementation-traceability.md`.
-- New schema: `schemas/feature-implementation-traceability.schema.json`.
-- New result validator mode: `feature-implementation-traceability`.
-
-The traceability layer connects feature intent to implementation references,
-tests, review, documentation and evidence. It keeps `specified`, `mapped`,
-`implemented`, `tested`, `reviewed`, `accepted` and `released` separate.
-
-### Multi-Source Quality Feedback
-
-- New standard: `standard/multi-source-quality-feedback.md`.
-- New schema: `schemas/multi-source-quality-feedback.schema.json`.
-- New result validator mode: `multi-source-quality-feedback`.
-
-The feedback layer combines tests, validators, cockpit signals, traceability,
-human review and runtime observations into classified findings and transition
-routes. Blocking findings stop the transitions they block.
-
-### Synthetic Example
-
-- New package: `examples/instrumentation-layer-minimal`.
-- New npm checks:
-  - `validate:development-cockpit`;
-  - `validate:feature-implementation-traceability`;
-  - `validate:multi-source-quality-feedback`;
-  - `validate:instrumentation-layer`;
-  - `validate:instrumentation-report`;
-  - `test:instrumentation-layer-negative`.
-
-### Readable Reports And Playground
-
-- `mirai-graph report instrumentation examples/instrumentation-layer-minimal`
-  produces a readable instrumentation report.
-- `docs/adoption/adopter-kit.md` gives developers, researchers, AI product
-  teams and organization adopters a one-hour and one-day adoption path.
-- `docs/research/evidence-package-v0.3.md` summarizes public evidence maturity,
-  pilot coverage, current measured signals and reproducibility commands.
-- The deterministic playground now includes:
-
-```text
-seed -> graph -> context -> launch -> transition explanation -> cockpit -> traceability -> multi-source feedback -> evidence -> kaizen -> baseline comparison
-```
-
-### Negative Fixtures
-
-Alpha.11 fails closed on these instrumentation mistakes:
-
-- cockpit next action without required gates;
-- feature implementation mapping without evidence;
-- accepted transition feedback while a blocking finding exists;
-- process improvement without Kaizen route.
-
-## Out Of Scope
-
-- Runtime autonomy.
-- Production execution.
-- Automatic canonical updates from evidence, feedback, cockpit metrics or
-  proposals.
-- Private pilot payloads or private runtime traces.
-- Peer-reviewed scientific proof.
-
-## Validation
-
-```bash
-npm run validate:instrumentation-layer
-npm run validate:instrumentation-report
-npm run test:instrumentation-layer-negative
-npm test
-npm run release:check
-```
-
-## Claim Boundary
-
-This layer supports public alpha claims for observable process steering and
-reproducible instrumentation artifacts.
-
-It does not claim that synthetic cockpit scores predict real production
-outcomes, that tests are acceptance, or that evidence/proposals authorize
-canonical updates.

package/releases/0.1.0-alpha.2.md

@@ -1,37 +0,0 @@
-# Mirai Graph 0.1.0-alpha.2
-
-Release type: context selection and profile documentation alpha
-
-## Summary
-
-This release improves the alpha context-pack generator and documents the first
-project-management profile lessons from independent implementation pilot 001.
-
-## Added
-
-- Token matching and one-hop relation expansion for context-pack generation.
-- Updated generated context-pack artifacts.
-- Project-management profile documentation.
-- Pilot report and adoption guide wording updated to reflect alpha context
-  selection instead of full-graph-only context generation.
-
-## Validation
-
-Run:
-
-```bash
-npm run release:check
-```
-
-Expected:
-
-- all existing package, seed and profile validation checks pass;
-- context generation succeeds;
-- synthetic benchmark remains reproducible;
-- negative fixture fails as expected.
-
-## Important Limitations
-
-- Context selection is heuristic.
-- Selection explanations are not yet detailed enough for semantic review.
-- Semantic completeness must still be reviewed separately.

package/releases/0.1.0-alpha.3.md

@@ -1,61 +0,0 @@
-# Mirai Graph 0.1.0-alpha.3
-
-Release type: profile conformance, semantic review and release-process alpha
-
-## Summary
-
-This release strengthens Mirai Graph as a public research-engineering package.
-It adds a second independent implementation pilot, executable profile
-conformance checks, semantic-completeness review artifacts and a public release
-process.
-
-## Added
-
-- Independent implementation pilot 002 for a synthetic software specification
-  workflow.
-- Software-specification profile documentation.
-- Profile conformance fixture guide.
-- Validator checks for:
-  - relation id consistency with source, type and target;
-  - profile object-kind conformance;
-  - profile relation-type conformance.
-- Negative fixtures for profile and relation-id failures.
-- Semantic-completeness review artifacts for:
-  - synthetic benchmark context pack;
-  - software-specification pilot context pack.
-- Safety-context inclusion policy for context-pack generation.
-- Public release process and GitHub Release notes policy.
-
-## Validation
-
-Run:
-
-```bash
-npm run release:check
-```
-
-Expected:
-
-- package, seed, profile and pilot validation passes;
-- context-pack generation succeeds;
-- readiness score remains reproducible;
-- synthetic benchmark remains reproducible;
-- negative fixtures fail as expected;
-- whitespace check passes.
-
-## Evidence Notes
-
-- Pilot 002 supports the limited claim that a valid Level 1 Mirai Graph package
-  can be created for a small synthetic software specification.
-- Semantic review of pilot 002 improved from `13/16` to `15/16` after
-  safety-sensitive context inclusion.
-- The synthetic benchmark semantic review records `15/16`.
-
-## Important Limitations
-
-- Evidence remains synthetic and public-safe.
-- This release does not prove real-world productivity improvement.
-- Context-pack selection still lacks per-object explanations and relevance
-  scores.
-- Semantic review artifacts are maintained review records, not automated
-  consensus or peer review.

package/releases/0.1.0-alpha.4.md

@@ -1,53 +0,0 @@
-# Mirai Graph v0.1.0-alpha.4
-
-Status: release notes
-
-## Theme
-
-Executable standard hardening plus the first public AI employee profile.
-
-## Included Since v0.1.0-alpha.3
-
-- Context-pack selection explanations with object relevance scores and relation
-  inclusion reasons.
-- Context-pack validation mode for generated pack metadata, graph references
-  and explanation coverage.
-- Negative fixture for missing context-pack selection explanations.
-- Positive profile conformance result artifacts.
-- Public capability map from practical graph-method areas to Mirai Graph
-  standard, schema, tooling, profile and research artifacts.
-- Alpha `ai_employee` profile.
-- Graph-as-AI-brain standard draft.
-- Action/runtime boundary standard draft.
-- Feedback learning gate standard draft.
-- Minimal synthetic AI employee fixture.
-- AI employee adoption guide.
-
-## Validation
-
-Validated with:
-
-```bash
-npm run release:check
-```
-
-The release also passed the public safety scan used by maintainers to check for
-private paths, obvious secrets and unsupported claims.
-
-## Claim Boundary
-
-This release should claim only:
-
-```text
-Mirai Graph v0.1.0-alpha.4 improves executable alpha validation and introduces
-the first public AI employee graph profile with explicit action/runtime and
-feedback-learning boundaries.
-```
-
-It should not claim:
-
-- real-world AI employee safety;
-- autonomous execution readiness;
-- Larena/AI runtime conformance;
-- productivity improvement;
-- external empirical validation.

package/releases/0.1.0-alpha.5.md

@@ -1,48 +0,0 @@
-# Mirai Graph v0.1.0-alpha.5
-
-Status: release notes
-
-## Theme
-
-Public standardization of graph-managed skill runtime patterns.
-
-## Included Since v0.1.0-alpha.4
-
-- Hybrid Source Of Truth standard draft.
-- Mirai Graph Adoption Levels standard draft with `GGA0..GGA10`.
-- Runtime Enablement standard draft for task-scoped graph-mode use.
-- Projection Views standard draft.
-- Alpha `skill_runtime` profile.
-- Minimal synthetic skill-runtime fixture.
-- Profile conformance result for the skill-runtime fixture.
-- Public-safe transfer note for reusable lessons from graph-managed skills.
-- README and profile fixture documentation updates.
-
-## Validation
-
-Validated with:
-
-```bash
-npm run release:check
-```
-
-The release also passed the public safety scan used by maintainers to check for
-private paths, obvious secrets and unsupported claims.
-
-## Claim Boundary
-
-This release should claim only:
-
-```text
-Mirai Graph v0.1.0-alpha.5 adds public alpha standard sections and an executable
-skill-runtime profile for governed capability graphs.
-```
-
-It should not claim:
-
-- graph-only runtime readiness;
-- semantic completeness;
-- operational effectiveness;
-- runtime safety;
-- universal validity;
-- publication of private skill internals.

package/releases/0.1.0-alpha.6.md

@@ -1,96 +0,0 @@
-# Mirai Graph v0.1.0-alpha.6
-
-Status: release notes
-
-## Theme
-
-Public standardization of executable Mirai Graph governance patterns.
-
-This alpha started with explainable federation routing control-loop patterns and
-now also packages the implementation-control and process-control layer needed
-to make Mirai Graph adoption inspectable with public-safe schemas, fixtures and
-validators.
-
-## Included Since v0.1.0-alpha.5
-
-### Routing Control
-
-- Route Explanation standard draft.
-- Routing Fixtures standard draft with forbidden route shapes.
-- Federation Health standard draft with conflict details.
-- Route Regression standard draft.
-- Public schemas for route explanation, routing fixtures, routing fixture run,
-  federation health dashboard and route regression result.
-- Synthetic federation routing smoke example with per-fixture route evidence,
-  high-risk explanation, route regression and federation health dashboard.
-- `validate:routing-control` validation command.
-- Public-safe transfer note for federation routing control-loop lessons.
-
-### Implementation And Process Control
-
-- Implementation Control profile hardening.
-- Implementation Control Cycles standard and synthetic example.
-- Launch Record standard, schema, example and validator.
-- Process Transition request schema, passing fixtures and negative fixtures.
-- Process Control Contract standard, schema, example and validator.
-- Work State Machine and Recovery/Resume schemas and examples.
-- Terminal Kaizen closure rule for significant process transitions.
-- Clear boundary between human/projection stages and executable state-machine
-  movement.
-
-### Governance Standard Modules
-
-- Graph DNA Alignment standard, schema and synthetic example.
-- Risk Control Matrix standard, schema and synthetic example.
-- Multi-Agent Coordination standard, schema and synthetic example.
-- Source Boundary Contract standard, schema and synthetic example.
-- Organization Governance profile, standard draft and synthetic example.
-- Public-safe project-management transfer note for implementation-control
-  patterns.
-
-### Developer Tooling
-
-- Validation commands for implementation-control cycles, launch records,
-  process transitions, process-control contracts, DNA alignment, work state,
-  recovery, risk, coordination, source-boundary and organization-governance
-  examples.
-- Negative test coverage for invalid graph packages and invalid process
-  transitions.
-
-### Navigation And Evidence Packaging
-
-- Role-based README navigation.
-- End-to-end control-loop tutorial.
-- Playground index for runnable CLI demos.
-- Scientific evidence package framing synthetic evidence, pilot evidence and
-  scientific claim boundaries.
-
-## Validation
-
-Validate with:
-
-```bash
-npm run release:check
-```
-
-## Claim Boundary
-
-This release should claim only:
-
-```text
-Mirai Graph v0.1.0-alpha.6 adds public alpha standard and schema shapes for
-explainable federation routing, implementation-control cycles, launch records,
-process transitions, process-control contracts, governance boundaries and
-public-safe evidence packaging.
-```
-
-It should not claim:
-
-- private federation behavior;
-- graph-only runtime readiness;
-- runtime safety;
-- owner-source rewrite permission;
-- scientific proof of effectiveness;
-- production readiness for autonomous execution;
-- automatic canonical update from generated context, feedback, evidence or
-  proposals.

package/releases/0.1.0-alpha.7.md

@@ -1,114 +0,0 @@
-# Mirai Graph v0.1.0-alpha.7
-
-Status: release preparation notes
-
-## Theme
-
-Readiness jump for explainable executable process control.
-
-This alpha makes Mirai Graph easier to inspect without maintainer guidance by
-adding process-transition decision explanations, a deterministic local
-playground report, baseline-comparison evidence and an additional public-safe
-pilot outside the original software and AI-employee examples.
-
-## Included Since v0.1.0-alpha.6
-
-### Process-Transition Explanations
-
-- Process-transition validator JSON output now includes an `explanation`
-  section.
-- Explanation output records current and target states, matched transition,
-  required and provided evidence, missing evidence, launch-record status,
-  terminal/Kaizen decision and false-transition guard summary.
-- Markdown process-transition output is now a transition decision report.
-- Passing and failing explanation fixtures are committed under
-  `examples/process-transition-minimal/results/`.
-- `validate:process-transition-report` checks explanation-critical fields.
-
-### Playground Report
-
-- Playground remains CLI-first and deterministic.
-- `playground:report` generates the same report as `playground:demo`.
-- `playground/demo-report.md` now shows:
-  - seed;
-  - graph package;
-  - context pack;
-  - launch record;
-  - transition explanation;
-  - evidence;
-  - Kaizen;
-  - baseline comparison.
-- `validate:playground-report` keeps the stored demo report aligned with the
-  generated output.
-
-### Baseline Comparison Evidence
-
-- Added `schemas/baseline-comparison-result.schema.json`.
-- Added public-safe synthetic result artifact at
-  `benchmarks/synthetic-context-reduction-v0/results/baseline-comparison-result.json`.
-- Added `validate:baseline-comparison`.
-- Evidence docs now separate synthetic comparison, pilot evidence and
-  scientific proof boundaries.
-
-### Public-Safe Pilot Coverage
-
-- Added independent implementation pilot 004:
-  `pilots/independent-implementation-004-research-program/`.
-- The pilot models a synthetic research-program governance workflow using the
-  existing `project_management` profile.
-- The pilot includes seed, package, graph objects, graph relations, gates,
-  report and profile-conformance result.
-- Public safety boundary excludes private research repositories, reviewer
-  notes, handoff text, internal traces, secrets and customer or employee data.
-
-### Release Packaging
-
-- Updated package version to `0.1.0-alpha.7`.
-- Updated README navigation, roadmap, playground docs, evidence docs,
-  conformance fixture docs and changelog.
-
-## Validation
-
-Validate with:
-
-```bash
-npm test
-npm run release:check
-```
-
-Targeted alpha.7 checks:
-
-```bash
-npm run validate:process-transition-report
-npm run playground:report
-npm run validate:playground-report
-npm run validate:baseline-comparison
-npm run validate:pilots
-```
-
-## Claim Boundary
-
-This release should claim only:
-
-```text
-Mirai Graph v0.1.0-alpha.7 adds public alpha readiness for explainable
-process-transition reports, deterministic local demos, bounded baseline
-comparison evidence and wider public-safe pilot coverage.
-```
-
-It should not claim:
-
-- peer-reviewed proof of effectiveness;
-- production runtime safety;
-- autonomous execution readiness;
-- graph-only runtime readiness;
-- universal superiority over document or task-tracker workflows;
-- automatic canonical update from generated context, feedback, evidence,
-  runtime results or proposals.
-
-## Known Limits
-
-- CLI remains reference tooling, not a full SDK.
-- Playground is deterministic and local, not a hosted interactive environment.
-- Baseline comparison is synthetic and requires replication.
-- Public pilots show applicability, not broad external validity.