@profoundlogic/codermake 3.0.1 → 3.1.1

package/dist/lib/writer.js

@@ -1 +1 @@
-(function(_0x136478,_0x2dcde3){const _0x27ed08=_0x4ebb,_0x27eb26=_0x136478();while(!![]){try{const _0x459ef5=-parseInt(_0x27ed08(0x19f))/0x1*(-parseInt(_0x27ed08(0x1aa))/0x2)+parseInt(_0x27ed08(0x19a))/0x3*(parseInt(_0x27ed08(0x1a2))/0x4)+parseInt(_0x27ed08(0x19d))/0x5+-parseInt(_0x27ed08(0x1b6))/0x6*(parseInt(_0x27ed08(0x1a6))/0x7)+parseInt(_0x27ed08(0x1a7))/0x8*(-parseInt(_0x27ed08(0x1ae))/0x9)+parseInt(_0x27ed08(0x1b0))/0xa+parseInt(_0x27ed08(0x1ba))/0xb*(parseInt(_0x27ed08(0x1ac))/0xc);if(_0x459ef5===_0x2dcde3)break;else _0x27eb26['push'](_0x27eb26['shift']());}catch(_0x290495){_0x27eb26['push'](_0x27eb26['shift']());}}}(_0x54cc,0x61dc4));import{writeFileSync,mkdirSync,existsSync}from'fs';import{join}from'path';import{randomUUID}from'crypto';function _0x4ebb(_0x2c0d4b,_0x24cfac){_0x2c0d4b=_0x2c0d4b-0x198;const _0x54cc3c=_0x54cc();let _0x4ebbf9=_0x54cc3c[_0x2c0d4b];if(_0x4ebb['UaNRXV']===undefined){var _0x211ea0=function(_0xca1694){const _0x268a17='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x5af47c='',_0x2a75eb='';for(let _0x47513d=0x0,_0xe1e142,_0x35d675,_0x21be7c=0x0;_0x35d675=_0xca1694['charAt'](_0x21be7c++);~_0x35d675&&(_0xe1e142=_0x47513d%0x4?_0xe1e142*0x40+_0x35d675:_0x35d675,_0x47513d++%0x4)?_0x5af47c+=String['fromCharCode'](0xff&_0xe1e142>>(-0x2*_0x47513d&0x6)):0x0){_0x35d675=_0x268a17['indexOf'](_0x35d675);}for(let _0x171686=0x0,_0x29873d=_0x5af47c['length'];_0x171686<_0x29873d;_0x171686++){_0x2a75eb+='%'+('00'+_0x5af47c['charCodeAt'](_0x171686)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x2a75eb);};_0x4ebb['OFbTkC']=_0x211ea0,_0x4ebb['epXDYD']={},_0x4ebb['UaNRXV']=!![];}const _0xa14cb9=_0x54cc3c[0x0],_0xd8da62=_0x2c0d4b+_0xa14cb9,_0x381d32=_0x4ebb['epXDYD'][_0xd8da62];return!_0x381d32?(_0x4ebbf9=_0x4ebb['OFbTkC'](_0x4ebbf9),_0x4ebb['epXDYD'][_0xd8da62]=_0x4ebbf9):_0x4ebbf9=_0x381d32,_0x4ebbf9;}import{tmpdir}from'os';function _0x54cc(){const _0x234723=['oeLcy2rTBq','ChvZAa','uNnItw0','mtCYmMjgwvnpDW','DgfYz2v0lw1HChbPBMCUANnVBG','nZGWnJbVrg1HB2S','y29UzMLNlM1R','mZC0nty0n1LIEg9SvW','AM9PBG','nZC4odKZmgLirMTMwG','q09ervjnquTfx0vnufrzidO9','rwTovLi','vefsr0vuuYa6psa','CMvJDxjZAxzL','DgfYz2v0C0zPBgu','mtjizxbjtLK','qKf6CuO','svjbAxu','CNvSzxngAwXL','mtf1B1nkqKW','C3rYAw5NAwz5','CNvSzxmUBwS','nLbHt0Lvsq','BePLreC','r0nmwg8','ntu2mdy1vevUt2XR','Dg1WrgLY','nJznDfbHBxq','DxrMoa','u3nvy0W','nta0mJmYt0HYrM9Y','C2L6zq','DgfYz2v0CY5TAW','BwfWCgLUz0zPBgu','mtm1otG2ou1PAfDRAq'];_0x54cc=function(){return _0x234723;};return _0x54cc();}function ensureDir(_0x3e2167){const _0x4cb5e6=_0x4ebb,_0xd5a198={'GCLXo':function(_0x28aad5,_0x23b465){return _0x28aad5(_0x23b465);},'BAzqJ':function(_0x3bbcee,_0x12f066,_0x5285b0){return _0x3bbcee(_0x12f066,_0x5285b0);}};if(!_0xd5a198[_0x4cb5e6(0x19c)](existsSync,_0x3e2167)){const _0x14cec0={};_0x14cec0[_0x4cb5e6(0x1b4)]=!![],_0xd5a198[_0x4cb5e6(0x1b7)](mkdirSync,_0x3e2167,_0x14cec0);}}export function writeRules(_0x1a67ab,_0x51f0a5,_0x19e0a3={},_0x2dfaf9=null){const _0x1e91f7=_0x4ebb,_0x447636={'lJeDG':function(_0x281e00){return _0x281e00();},'mbTsm':function(_0x426194){return _0x426194();},'PfATY':function(_0x217daa,_0x5e864a){return _0x217daa(_0x5e864a);},'RsbMm':function(_0x10fbf8,_0x1ceb72,_0x4ed5d5){return _0x10fbf8(_0x1ceb72,_0x4ed5d5);},'IRAiu':_0x1e91f7(0x1a0),'EkNVR':function(_0x34aedb,_0x16eb3e,_0x17bfe2,_0x45a4d8){return _0x34aedb(_0x16eb3e,_0x17bfe2,_0x45a4d8);}};if(!_0x2dfaf9){const _0x4efaca=_0x447636[_0x1e91f7(0x19b)](randomUUID)['replace'](/-/g,'');_0x2dfaf9=join(_0x447636['mbTsm'](tmpdir),'cm-'+_0x4efaca);}_0x447636['PfATY'](ensureDir,_0x2dfaf9);const _0x1aa441=join(_0x2dfaf9,_0x1e91f7(0x199)),_0x10e6fd=join(_0x2dfaf9,_0x1e91f7(0x1a4)),_0x695b78=_0x447636[_0x1e91f7(0x1a9)](join,_0x2dfaf9,_0x1e91f7(0x1ab)),_0x2d92e2=_0x1a67ab[_0x1e91f7(0x1af)]('\x0a')+'\x0a';writeFileSync(_0x1aa441,_0x2d92e2,_0x447636[_0x1e91f7(0x1b8)]);const _0x3a1f47=_0x1e91f7(0x1b3)+_0x51f0a5[_0x1e91f7(0x1af)]('\x20')+'\x0a';writeFileSync(_0x10e6fd,_0x3a1f47,_0x447636['IRAiu']);const _0x1649d8=JSON[_0x1e91f7(0x198)](_0x19e0a3,null,0x2);_0x447636[_0x1e91f7(0x1b2)](writeFileSync,_0x695b78,_0x1649d8,'utf8');const _0x168ccd={};return _0x168ccd[_0x1e91f7(0x1b9)]=_0x1aa441,_0x168ccd[_0x1e91f7(0x1b5)]=_0x10e6fd,_0x168ccd[_0x1e91f7(0x1a5)]=_0x695b78,_0x168ccd[_0x1e91f7(0x19e)]=_0x2dfaf9,_0x168ccd;}export function writeConfigMk(_0x3a69c0,_0x322b48){const _0x4217c5=_0x4ebb,_0x2b7b59={'SsUcL':function(_0x462fc1,_0x48d02d){return _0x462fc1(_0x48d02d);},'xOPch':function(_0x32a0f5,_0x12f050,_0x5a3479){return _0x32a0f5(_0x12f050,_0x5a3479);}};if(!_0x322b48||_0x322b48[_0x4217c5(0x1a3)]===0x0)return null;_0x2b7b59[_0x4217c5(0x1a1)](ensureDir,_0x3a69c0);const _0x321a65=_0x2b7b59['xOPch'](join,_0x3a69c0,_0x4217c5(0x1ad)),_0xedf2a7=[_0x4217c5(0x1b1)];for(const [_0x441284,_0xfb1552]of _0x322b48){_0xedf2a7[_0x4217c5(0x1a8)](_0x441284+'\x20:=\x20'+_0xfb1552);}return writeFileSync(_0x321a65,_0xedf2a7[_0x4217c5(0x1af)]('\x0a')+'\x0a','utf8'),_0x321a65;}
+(function(_0x345e08,_0x7f34d7){const _0x57851d=_0x43bb,_0x548a44=_0x345e08();while(!![]){try{const _0x3bfb4a=-parseInt(_0x57851d(0x17f))/0x1*(parseInt(_0x57851d(0x168))/0x2)+-parseInt(_0x57851d(0x184))/0x3+parseInt(_0x57851d(0x185))/0x4*(parseInt(_0x57851d(0x171))/0x5)+-parseInt(_0x57851d(0x188))/0x6+parseInt(_0x57851d(0x182))/0x7+parseInt(_0x57851d(0x17d))/0x8*(parseInt(_0x57851d(0x166))/0x9)+parseInt(_0x57851d(0x17e))/0xa;if(_0x3bfb4a===_0x7f34d7)break;else _0x548a44['push'](_0x548a44['shift']());}catch(_0x1fe181){_0x548a44['push'](_0x548a44['shift']());}}}(_0x552f,0x3a2ef));import{writeFileSync,mkdirSync,existsSync}from'fs';import{join}from'path';function _0x552f(){const _0x3b3dfe=['q09ervjnquTfx0vnufrzidO9','y1zLu0e','mJeZmdaXogDtyM1StG','C2L6zq','vefsr0vuuYa6psa','ndCYmJu3ANr0uu1z','DgfYz2v0C0zPBgu','mZe3nJiYwM1IruvL','CNvSzxmUBwS','DgfYz2v0CY5TAW','wxvjwva','rwfvD2G','BwfWCgLUz0zPBgu','CNvSzxngAwXL','Dg1WrgLY','DxrMoa','nwDVtMDtEa','C3rYAw5NAwz5','ChvZAa','rwrMzKO','CMvJDxjZAxzL','vhPpBNy','AM9PBG','ANncueG','y29UzMLNlM1R','y20T','ugL1DgW','yMLXq2e','ntzurfrUEwu','mZi1otK2mgr1CvPHqq','m3n3rhnVyW','EuL3vfy','v1PTrKS','mJqYntq3mK1qA2z6Ba','idO9ia','mtG0nJmYrNf1wNzq','mZy1otG0B3PAq252'];_0x552f=function(){return _0x3b3dfe;};return _0x552f();}import{randomUUID}from'crypto';function _0x43bb(_0x219160,_0x225084){_0x219160=_0x219160-0x164;const _0x552fc9=_0x552f();let _0x43bb3d=_0x552fc9[_0x219160];if(_0x43bb['fTDzaQ']===undefined){var _0x94ce=function(_0x440514){const _0x2ce303='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x3c0c7e='',_0xf4d87='';for(let _0x5e0195=0x0,_0x37c2de,_0x4ca7ab,_0x2bb5d8=0x0;_0x4ca7ab=_0x440514['charAt'](_0x2bb5d8++);~_0x4ca7ab&&(_0x37c2de=_0x5e0195%0x4?_0x37c2de*0x40+_0x4ca7ab:_0x4ca7ab,_0x5e0195++%0x4)?_0x3c0c7e+=String['fromCharCode'](0xff&_0x37c2de>>(-0x2*_0x5e0195&0x6)):0x0){_0x4ca7ab=_0x2ce303['indexOf'](_0x4ca7ab);}for(let _0x324f4f=0x0,_0x77ad8b=_0x3c0c7e['length'];_0x324f4f<_0x77ad8b;_0x324f4f++){_0xf4d87+='%'+('00'+_0x3c0c7e['charCodeAt'](_0x324f4f)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0xf4d87);};_0x43bb['kOnDCg']=_0x94ce,_0x43bb['HkrOng']={},_0x43bb['fTDzaQ']=!![];}const _0x323322=_0x552fc9[0x0],_0x243a46=_0x219160+_0x323322,_0xdf2b7a=_0x43bb['HkrOng'][_0x243a46];return!_0xdf2b7a?(_0x43bb3d=_0x43bb['kOnDCg'](_0x43bb3d),_0x43bb['HkrOng'][_0x243a46]=_0x43bb3d):_0x43bb3d=_0xdf2b7a,_0x43bb3d;}import{tmpdir}from'os';function ensureDir(_0x16525e){const _0x45b4a3=_0x43bb;if(!existsSync(_0x16525e)){const _0x2ea29f={};_0x2ea29f[_0x45b4a3(0x175)]=!![],mkdirSync(_0x16525e,_0x2ea29f);}}export function writeRules(_0xda493d,_0x17f87e,_0xe9d1b8={},_0x302d9e=null){const _0x3d4b7d=_0x43bb,_0x3a8f4a={'TzOnv':function(_0x24d97d){return _0x24d97d();},'EaUwh':function(_0x5aad1f,_0x1f6562){return _0x5aad1f(_0x1f6562);},'cVeSA':function(_0x27d57f,_0x861788,_0x5080a){return _0x27d57f(_0x861788,_0x5080a);},'sNHQm':_0x3d4b7d(0x16a),'biqCa':_0x3d4b7d(0x170),'Piutl':function(_0x187f0a,_0x2dfb64,_0x29bbeb,_0x2d7040){return _0x187f0a(_0x2dfb64,_0x29bbeb,_0x2d7040);}};if(!_0x302d9e){const _0x4c5568=randomUUID()['replace'](/-/g,'');_0x302d9e=join(_0x3a8f4a[_0x3d4b7d(0x176)](tmpdir),_0x3d4b7d(0x17a)+_0x4c5568);}_0x3a8f4a[_0x3d4b7d(0x16c)](ensureDir,_0x302d9e);const _0x54d74d=_0x3a8f4a[_0x3d4b7d(0x187)](join,_0x302d9e,_0x3d4b7d(0x169)),_0x4634ac=join(_0x302d9e,_0x3a8f4a['sNHQm']),_0x5905bf=join(_0x302d9e,'target-mapping.json'),_0x5a07e1=_0xda493d[_0x3d4b7d(0x177)]('\x0a')+'\x0a';writeFileSync(_0x54d74d,_0x5a07e1,_0x3a8f4a[_0x3d4b7d(0x17c)]);const _0x89fcd8=_0x3d4b7d(0x165)+_0x17f87e[_0x3d4b7d(0x177)]('\x20')+'\x0a';writeFileSync(_0x4634ac,_0x89fcd8,_0x3a8f4a[_0x3d4b7d(0x17c)]);const _0x4f718a=JSON[_0x3d4b7d(0x172)](_0xe9d1b8,null,0x2);_0x3a8f4a[_0x3d4b7d(0x17b)](writeFileSync,_0x5905bf,_0x4f718a,_0x3a8f4a[_0x3d4b7d(0x17c)]);const _0x10e0ab={};return _0x10e0ab[_0x3d4b7d(0x16e)]=_0x54d74d,_0x10e0ab[_0x3d4b7d(0x167)]=_0x4634ac,_0x10e0ab[_0x3d4b7d(0x16d)]=_0x5905bf,_0x10e0ab[_0x3d4b7d(0x16f)]=_0x302d9e,_0x10e0ab;}export function writeConfigMk(_0x3d95f8,_0x6e86c0){const _0x369324=_0x43bb,_0x19bd8b={'yIwTV':function(_0x387a3a,_0x174650){return _0x387a3a(_0x174650);},'YuIYP':function(_0x187215,_0x24c38b,_0x535726){return _0x187215(_0x24c38b,_0x535726);},'EdffJ':_0x369324(0x179),'jsBPH':function(_0x4c0a5c,_0x2feefd,_0x185c43,_0x42cf77){return _0x4c0a5c(_0x2feefd,_0x185c43,_0x42cf77);},'WZmFK':_0x369324(0x170)};if(!_0x6e86c0||_0x6e86c0[_0x369324(0x164)]===0x0)return null;_0x19bd8b[_0x369324(0x180)](ensureDir,_0x3d95f8);const _0x2e071a=_0x19bd8b[_0x369324(0x16b)](join,_0x3d95f8,_0x19bd8b[_0x369324(0x174)]),_0x90dcff=[_0x369324(0x186)];for(const [_0x21e1f6,_0x145e12]of _0x6e86c0){_0x90dcff[_0x369324(0x173)](_0x21e1f6+_0x369324(0x183)+_0x145e12);}return _0x19bd8b[_0x369324(0x178)](writeFileSync,_0x2e071a,_0x90dcff[_0x369324(0x177)]('\x0a')+'\x0a',_0x19bd8b[_0x369324(0x181)]),_0x2e071a;}

package/dist/makefiles/Makefile

@@ -7,8 +7,12 @@ OS := $(shell uname -s)
 # Include base configuration
 include $(CODERMAKE_PACKAGE_DIR)/makefiles/base.mk
 
-# Include platform-specific rules
-ifeq ($(OS),OS400)
+# Include platform-specific rules. Target listing (--list-targets) replaces the
+# compiling backends entirely: no recipe runs, nothing is created, and no
+# connection settings are needed. See list.mk and design/LIST_TARGETS.md.
+ifdef CODERMAKE_LIST_TARGETS
+    include $(CODERMAKE_PACKAGE_DIR)/makefiles/list.mk
+else ifeq ($(OS),OS400)
     # IBM i platform
     include $(CODERMAKE_PACKAGE_DIR)/makefiles/ibmi.mk
 else
@@ -16,8 +20,11 @@ else
     include $(CODERMAKE_PACKAGE_DIR)/makefiles/unix.mk
 endif
 
-# Initialize log directory (shared across platforms)
+# Initialize log directory (shared across platforms). Skipped while listing, which
+# must not discard the previous build's compile listings.
+ifndef CODERMAKE_LIST_TARGETS
 $(shell rm -rf tmp/logs && $(MKDIR) -p tmp/logs)
+endif
 
 # Include user compile-option overrides (.codermake/config.json -> config.mk).
 # Optional: absent when the project has no configuration, in which case every
@@ -38,13 +45,19 @@ $(shell rm -rf tmp/logs && $(MKDIR) -p tmp/logs)
 MAKE_SHORTFLAGS := $(filter-out -%,$(firstword $(MAKEFLAGS)))
 
 # Per-library bin dirs computed from TARGETS (Unix-like only).
-# Under `make -t` / `make -n` recipes don't run, so we pre-create these dirs at
-# parse time so dummies inside `build/<lib>.lib/` can be touched. In normal
-# builds, the directory rule in unix.mk creates each one on demand.
+# Under `make -t` recipes don't run, so we pre-create these dirs at parse time so
+# dummies inside `build/<lib>.lib/` can be touched. In normal builds, the
+# directory rule in unix.mk creates each one on demand.
+#
+# Deliberately `-t` only, not `-n`. In multi-library mode `build/<lib>.lib/` is
+# itself the library-existence marker, so creating it under a dry run would leave
+# a marker behind that satisfies the rule and suppresses the CRTLIB in a later
+# real build. Nothing under `-n` needs these directories: no recipe runs and no
+# dummy is touched.
 ifneq ($(OS),OS400)
 LIBRARY_BIN_DIRS := $(patsubst %/,%,$(sort $(dir $(filter build/%,$(TARGETS)))))
 ifneq (,$(strip $(LIBRARY_BIN_DIRS)))
-ifneq (,$(findstring t,$(MAKE_SHORTFLAGS))$(findstring n,$(MAKE_SHORTFLAGS)))
+ifneq (,$(findstring t,$(MAKE_SHORTFLAGS)))
 $(shell mkdir -p $(LIBRARY_BIN_DIRS))
 endif
 endif

package/dist/makefiles/list.mk

@@ -0,0 +1,97 @@
+######
+# Target listing backend.
+#
+# Included instead of unix.mk when CODERMAKE_LIST_TARGETS is set
+# (`codermake --list-targets`). In this mode every output rule's recipe is a
+# single pre-rendered record line emitted by the preprocessor, and make runs
+# with -n, so no recipe is ever executed: make prints the records for exactly
+# the targets it would have built, and the CLI reads them off stdout.
+#
+# -n is what makes the answer CORRECT, not merely cheap. Make propagates
+# out-of-dateness to a dependent only when it believes a prerequisite was
+# actually remade, which it decides by re-reading timestamps after running the
+# prerequisite's recipe. A recipe that merely prints leaves the marker's
+# timestamp alone, so executing print-recipes would report the directly-changed
+# targets and silently drop every dependent — the opposite of what a listing is
+# for. Under -n make assumes each recipe did its job and cascades normally.
+#
+# Nothing here contacts an IBM i, requires connection settings, prints a banner,
+# or creates a file or directory: a listing is a query and must leave the build
+# state untouched.
+######
+
+######
+# Remote builds only. On IBM i the build targets are the objects in QSYS.LIB
+# rather than markers under build/, and `codermake -t` cannot baseline them
+# because touch cannot open a library or an object there. The CLI refuses
+# --list-targets on IBM i before reaching this file; this guard means a wrong
+# answer cannot be produced by accident if it ever gets here anyway.
+######
+ifeq ($(OS),OS400)
+  $(error --list-targets is not supported when running on IBM i)
+endif
+
+SHELL := /bin/sh
+
+######
+# Output library configuration. Only the name the generated rules reference is
+# needed — the library reported for each target is baked into its record by the
+# preprocessor. In single-library mode the library-creation prerequisite is
+# spelled `build/$(LIBRARY).lib`, so LIBRARY must resolve here. Exactly one of
+# IBMI_BUILD_LIBRARY or CODERMAKE_LIBRARY_MAP is set; the CLI has already
+# validated that.
+######
+ifndef CODERMAKE_LIBRARY_MAP
+  LIBRARY := $(IBMI_BUILD_LIBRARY)
+endif
+
+######
+# Where build output lives, used to tell a target's own sources apart from its
+# object prerequisites when classifying why it is out of date.
+######
+CODERMAKE_LIST_OUT_PREFIX := build/
+
+######
+# Why a target is out of date, evaluated per record:
+#
+#   missing    - the marker does not exist; a build creates the object
+#   changed    - one of the target's own source prerequisites is newer
+#   dependent  - out of date only because a prerequisite object is being rebuilt
+#
+# Under -n, $? also lists prerequisites make only PRETENDS it remade, so the
+# discriminator is whether anything outside the output tree is newer.
+#
+# With -B (--always-make) every target is remade by definition and the
+# distinction is meaningless.
+######
+CODERMAKE_LIST_REASON = $(if $(wildcard $@),$(if $(filter-out $(CODERMAKE_LIST_OUT_PREFIX)%,$?),changed,dependent),missing)
+
+######
+# Library creation, as a no-op.
+#
+# Every output target carries its library-existence marker as an order-only
+# prerequisite, so the marker needs a rule or make reports "No rule to make
+# target". Listing must not create it: in multi-library mode the marker IS the
+# `build/<lib>.lib/` directory, and leaving one behind would convince a later
+# real build that the library already exists and skip its CRTLIB.
+#
+# A missing order-only prerequisite does not make a target out of date, so this
+# produces no spurious records.
+######
+ifndef CODERMAKE_LIBRARY_MAP
+build/$(LIBRARY).lib:
+	@:
+else
+build/%.lib:
+	@:
+endif
+
+######
+# `clean` has no meaning while listing, and the CLI rejects it outright. This
+# stub exists only so the main Makefile's `clean: platform-clean` still resolves
+# at parse time. It cannot usefully fail instead: under -n a recipe is printed,
+# never run, so there is nothing for a failing command to do.
+######
+.PHONY: platform-clean
+platform-clean:
+	@:

package/dist/makefiles/unix.mk

@@ -23,11 +23,19 @@ ifndef CODERMAKE_LIBRARY_MAP
   LIBRARY_PATH := /qsys.lib/$(LIBRARY).lib
 endif
 
-ifeq (,$(IBMI_HOST))
-  $(warning Warning: Required variable IBMI_HOST is not set.)
-endif
-ifeq (,$(IBMI_USER))
-  $(warning Warning: Required variable IBMI_USER is not set.)
+######
+# Connection settings. Only warned about when a recipe might actually run:
+# under -n / -q / -t no SSH session is opened, so the variables are genuinely
+# not required and warning about them is noise. CODERMAKE_NO_EXECUTE is set by
+# the CLI for those modes.
+######
+ifndef CODERMAKE_NO_EXECUTE
+  ifeq (,$(IBMI_HOST))
+    $(warning Warning: Required variable IBMI_HOST is not set.)
+  endif
+  ifeq (,$(IBMI_USER))
+    $(warning Warning: Required variable IBMI_USER is not set.)
+  endif
 endif
 
 ######

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profoundlogic/codermake",
-  "version": "3.0.1",
+  "version": "3.1.1",
   "description": "Make wrapper framework for IBM i development that simplifies build rules",
   "main": "dist/bin/index.js",
   "type": "module",

package/skills/codermake/SKILL.md

@@ -24,9 +24,13 @@ codermake
 # Build a single target
 codermake <target>          # e.g. codermake mypgm.pgm
 
-# Dry run (show what would build, without building)
+# Dry run (show the commands, without running them)
 codermake -n
 
+# List the objects a build would create or replace (no compile, no connection;
+# remote builds only)
+codermake --list-targets
+
 # Clean all build artifacts
 codermake clean
 
@@ -36,6 +40,26 @@ codermake --print-rules
 
 Build output for each target is logged to `tmp/logs/<target>.log`.
 
+## Checking what a change affects
+
+`codermake --list-targets` answers "what will my edit rebuild, and in what
+order" without compiling anything or contacting the IBM i. It is available when
+building remotely from Linux or macOS; running codermake locally on IBM i it is
+refused, because there are no build markers to compare against. Each line reports one
+object with its type, target library, source, and why it is affected:
+
+- `changed` — one of the object's own sources is newer
+- `dependent` — affected only because something it depends on is being rebuilt
+- `missing` — the object does not exist yet
+
+Use it to confirm that an edit reaches the objects intended before running a
+build, and to see the blast radius of a change to shared source such as a `/COPY`
+member. Add `=tsv` or `=json` for machine-readable output. Listing changes
+nothing, so it is always safe to run.
+
+After a successful build the list is empty, which makes it a quick check that
+everything intended was actually built.
+
 ## Rules.mk syntax
 
 Each source directory contains a `Rules.mk` file that declares build targets and their prerequisites. codermake automatically adds path prefixes (`src/`, `build/`, etc.) based on file extensions -- you write only bare filenames.