NEWS

mwTensor 1.2.2 (2026-05-07)

refineFactor: @param algorithm doc corrected to say "R search path" instead of "global environment"
MWCAProgramRefinement: roxygen now explicitly states one-step only / depth > 1 not supported
Tests: added user-supplied function algorithm test for refineFactor; added runtime dim-exceeds error propagation test for executeMWCAProgram

refineFactor: replaced eval(parse()) with match.fun() for safer algorithm resolution
initCoupledMWCA: improved seed management (on.exit with add=TRUE, seed registration before validation for robust RNG state restoration on error)
validateMWCAProgram: added refinement name vs factor name collision check; added duplicate refinement warning; clarified depth > 1 check semantics
compileMWCAProgram: documented dummy factor necessity (CoupledMWCAParams requires models to cover all Xs)
executeMWCAProgram: documented two-phase architecture and proof-of-concept status
Tests: added tests for seed=NULL behavior, on.exit restoration, refinement name collision, duplicate refinement, dummy factor verification, single-block execute, invalid algorithm/fit object handling

checkCoupledMWCA was added for static validation of CoupledMWCAParams without running optimization (collects all errors and warnings)
initCoupledMWCA was added for reproducible initialization of CoupledMWCA factors with seed control and multiple init policies (random, svd, nonneg_random)
CoupledMWCAInit class was added; CoupledMWCA now accepts CoupledMWCAInit objects to use pre-computed initial values
MWCAProgram, MWCAProgramBlock, MWCAProgramFactor, MWCAProgramRefinement were added as a lightweight internal representation for factorization programs
validateMWCAProgram and compileMWCAProgram were added to validate and compile programs to MWCAParams/CoupledMWCAParams
executeMWCAProgram was added to run programs including one-step factor refinements
refineFactor was added for experimental one-step factor refinement (decomposition of a decomposition)
RefinedFactor class was added with sub_factors and coef slots providing the mathematical relation A ~ coef %*% sub_factors
Internal: duplicate function definitions across CoupledMWCA_Check*.R files were resolved
Internal: shared rank check helpers (.checkRanks_matrix, .checkRanks_one, .checkRanks_projected) were extracted to mwTensor-internal.R