Skip to main content
VelinStyle v1.4.0
⌂ Home

Migration Intelligence 1.4.0

Migration Intelligence analyzes migrations first, structures fachliche decisions, and only allows residual rewrites when an explicit mapping exists. Deutsch: Migration Intelligence

Safety boundary: In the current pilot there are 0 freigegebene Residual source→target mappings. Therefore SAFE_REWRITE = 0. v1.4.0 does not invent rewrite targets. That is intentional — not a missing feature.
Not the same as Design Intelligence. Design Intelligence is a separate product surface. Migration Intelligence lives under .velin/migration/intelligence/ after velinstyle migrate tailwind.

Status v1.4.0

Migration Intelligence is documented and technically prepared. Residual mappings currently have no fachlich freigegebene source→target pairs. Therefore:

SurfaceValue
Catalog Entries0 (catalogVersion: 0.0.0-empty)
Manifest Entries0
SAFE_REWRITE0
Apply candidates0
THEME_CATALOG_READY0 (16 sources reviewed, 16 not freigegeben)
PALETTE_CATALOG_READY0 (39 sources reviewed, 39 not freigegeben)

That is a deliberate safety result — not a missing implementation status. Layers stay separate: Policy · Strategy · Acceptance · Catalog · Manifest · Apply.

Pipeline

Analysis (Classifier)
→ Groups
→ Decision Clusters
→ Policy
→ Strategy Blocks
→ User Actions
→ Acceptance (+ persistence)
→ Rewrite Catalog (fachlich)
→ Rewrite Manifest
→ Apply-Gate Preflight
→ Dry-Run
→ Apply (+ Snapshot / Rollback)

Hard separations

StatementMeaning
Analyse ≠ AcceptanceReports explain residuals; Acceptance stores decisions
Acceptance ≠ MappingStrategy options are not token targets
Mapping ≠ ManifestCatalog is fachlich; Manifest adds file/hash/occurrence
Manifest ≠ ApplyApply needs GATE_READY + DRY_RUN_OK
ACCEPTED ≠ APPLIEDapplied stays false until Apply Write succeeds
Enrichment ≠ RewriteStrategy Blocks mirror policies; they do not rewrite sources

Pilot metrics (unchanged by Intelligence)

MetricValue
User Actions23 (1 clear · 18 fachlich · 4 info)
Strategy Blocks6/6 enriched
Rewrite Catalog entries0 (0.0.0-empty)
Manifest entries0
SAFE_REWRITE0
Apply candidates0
Coverage806 / 559 / 74 / 173 / 69.4% / 351
Tests (Intelligence + migrate CLI)94 (41 intelligence · 53 cli-migrate)
Tests (+ release-sync)102 (+ 8 release-sync)

Six Strategy Blocks

All blocks are enriched from existing Decision Policies. safeMappingExists is false for every block. Enrichment does not create mappings.

THEME

STATE

HALF_STEP

PALETTE

DIM_PX

TYPO

Acceptance

Store: .velin/migration/intelligence/acceptance.json · schemaVersion: 1

Acceptance stores developer decisions, not rewrite targets. Status values: OPEN · ACCEPTED · DEFERRED.

CLI: velinstyle migrate acceptance <project> --show · --ua …

FieldRole
userActionId / actionKeyStable resume keys
selectedOptionIdChosen strategy option (A/B/C…)
statusOPEN · ACCEPTED · DEFERRED
decisionStatusMirrors policy review state (e.g. NEEDS_POLICY · REVIEW)
acceptanceKinde.g. CHOSE_OPTION
decidedAt / user / noteAudit trail
caseRefs / groupRefsLinked cases/groups
coverageSnapshotCoverage at decision time
appliedAlways false until Apply Write succeeds

Queue drift / orphans are reported on load; resume matches userActionId then actionKey. Acceptance never rewrites sources. ACCEPTED ≠ APPLIED.

Rewrite Catalog (fachlich)

Rewrite Manifest

Separate file: rewrite-manifest.json (not acceptance). Pilot: 0 productive entries.

Apply-Gate → Dry-Run → Apply

Load → Validate → Acceptance → Path → Target → MappingSource
→ Hash → TOCTOU → Conflict → Occurrence → Snapshot-Preflight
→ GATE_READY

Then:
Dry-Run → re-check Gate → Snapshot → TOCTOU → Write
→ Rollback on failure → applied:true only after success
velinstyle migrate acceptance ./my-project --show
velinstyle migrate rewrite-manifest ./my-project --preflight
velinstyle migrate rewrite-manifest ./my-project --dry-run
# --apply only with GATE_READY + DRY_RUN_OK and explicit mappings

Conscious non-goals in 1.4.0

Later versions

Only after an explicit Design/Dev Catalog line: Manifest --add → Preflight → Dry-Run review → Apply.

Historical phase documents describe intermediate development states and were not rewritten after the fact.