@profoundlogic/codermake 3.0.0 → 3.1.0

package/dist/lib/writer.js

@@ -1 +1 @@
-function _0x3d76(_0x34b7ae,_0x34fe1f){_0x34b7ae=_0x34b7ae-0xb1;const _0x4e5606=_0x4e56();let _0x3d7600=_0x4e5606[_0x34b7ae];if(_0x3d76['qumTaU']===undefined){var _0x38b41f=function(_0x396d99){const _0x162b5e='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x2f4fde='',_0x57dcb8='';for(let _0x3173b1=0x0,_0x3bd8f4,_0x27f6cf,_0xad37e8=0x0;_0x27f6cf=_0x396d99['charAt'](_0xad37e8++);~_0x27f6cf&&(_0x3bd8f4=_0x3173b1%0x4?_0x3bd8f4*0x40+_0x27f6cf:_0x27f6cf,_0x3173b1++%0x4)?_0x2f4fde+=String['fromCharCode'](0xff&_0x3bd8f4>>(-0x2*_0x3173b1&0x6)):0x0){_0x27f6cf=_0x162b5e['indexOf'](_0x27f6cf);}for(let _0x51f22b=0x0,_0x5c2ac8=_0x2f4fde['length'];_0x51f22b<_0x5c2ac8;_0x51f22b++){_0x57dcb8+='%'+('00'+_0x2f4fde['charCodeAt'](_0x51f22b)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x57dcb8);};_0x3d76['pSmzUZ']=_0x38b41f,_0x3d76['cAluid']={},_0x3d76['qumTaU']=!![];}const _0x3b168d=_0x4e5606[0x0],_0x3a2d69=_0x34b7ae+_0x3b168d,_0x30db55=_0x3d76['cAluid'][_0x3a2d69];return!_0x30db55?(_0x3d7600=_0x3d76['pSmzUZ'](_0x3d7600),_0x3d76['cAluid'][_0x3a2d69]=_0x3d7600):_0x3d7600=_0x30db55,_0x3d7600;}function _0x4e56(){const _0x176d6f=['CMvJDxjZAxzL','DgfYz2v0lw1HChbPBMCUANnVBG','yKfHuLa','idO9ia','ChvZAa','Dg1WrgLY','z0HvwK0','otK0nZy4wejqt2Ls','DgfYz2v0C0zPBgu','AM9PBG','CNvSzxngAwXL','vezZtw0','CNvSzxmUBwS','ndqXmdiXzxDlv1fA','Cg5dB0m','ndq3oda4t0fwCfnY','CMfuv3e','sMD5qwW','DwHSEee','DxrMoa','DgfYz2v0CY5TAW','ntu5mKLJswHcwG','CMvWBgfJzq','q09ervjnquTfx0vnufrzidO9','y29UzMLNlM1R','qMXWv28','mtvezNbmrwW','y20T','tKX3zMG','BwfWCgLUz0zPBgu','mtiYntCYohDSBwrcDG','mZbNrwzksxC','m3fUvLbJvq','vefsr0vuuYa6psa','v3D1C2G','otCXnZy3mePnCKD3tW','mteZntu4n2Xiq2HTDW','BwT5qwO'];_0x4e56=function(){return _0x176d6f;};return _0x4e56();}(function(_0x404207,_0x3f7c93){const _0x4d45c9=_0x3d76,_0xab4579=_0x404207();while(!![]){try{const _0x21c902=parseInt(_0x4d45c9(0xc3))/0x1*(-parseInt(_0x4d45c9(0xb8))/0x2)+-parseInt(_0x4d45c9(0xc7))/0x3+-parseInt(_0x4d45c9(0xb2))/0x4*(parseInt(_0x4d45c9(0xbd))/0x5)+-parseInt(_0x4d45c9(0xc2))/0x6*(parseInt(_0x4d45c9(0xd6))/0x7)+parseInt(_0x4d45c9(0xd0))/0x8+parseInt(_0x4d45c9(0xc1))/0x9+parseInt(_0x4d45c9(0xc6))/0xa;if(_0x21c902===_0x3f7c93)break;else _0xab4579['push'](_0xab4579['shift']());}catch(_0x26c146){_0xab4579['push'](_0xab4579['shift']());}}}(_0x4e56,0x2f7d5));import{writeFileSync,mkdirSync,existsSync}from'fs';import{join}from'path';import{randomUUID}from'crypto';import{tmpdir}from'os';function ensureDir(_0x399ad9){const _0x4e25cf=_0x3d76,_0xfe8bfc={'raTWq':function(_0x44a4d5,_0x47025f,_0x5a02f7){return _0x44a4d5(_0x47025f,_0x5a02f7);}};if(!existsSync(_0x399ad9)){const _0x38f239={};_0x38f239[_0x4e25cf(0xc9)]=!![],_0xfe8bfc[_0x4e25cf(0xb3)](mkdirSync,_0x399ad9,_0x38f239);}}export function writeRules(_0x427669,_0x5f5ad4,_0x474bb6={},_0x5d4eba=null){const _0x14cf1f=_0x3d76,_0x35f9ca={'gHUZM':function(_0x5896db){return _0x5896db();},'uhlxA':function(_0x35180,_0x296415){return _0x35180(_0x296415);},'zZkDV':function(_0x2ba955,_0x38af39,_0x45457f){return _0x2ba955(_0x38af39,_0x45457f);},'bAaRP':_0x14cf1f(0xd5),'yvEmV':_0x14cf1f(0xca),'Wwush':function(_0xe4c97e,_0xde1aa4,_0x3de380,_0x2ae70e){return _0xe4c97e(_0xde1aa4,_0x3de380,_0x2ae70e);},'BlpWo':'utf8','dBARi':function(_0x2560be,_0x133b83,_0x10913c,_0x5dc8dc){return _0x2560be(_0x133b83,_0x10913c,_0x5dc8dc);}};if(!_0x5d4eba){const _0x5959e2=_0x35f9ca[_0x14cf1f(0xcf)](randomUUID)[_0x14cf1f(0xb9)](/-/g,'');_0x5d4eba=join(tmpdir(),_0x14cf1f(0xbe)+_0x5959e2);}_0x35f9ca[_0x14cf1f(0xb5)](ensureDir,_0x5d4eba);const _0x261d2f=_0x35f9ca['zZkDV'](join,_0x5d4eba,_0x35f9ca[_0x14cf1f(0xcb)]),_0x5bf454=join(_0x5d4eba,_0x14cf1f(0xb7)),_0x1bb089=join(_0x5d4eba,_0x35f9ca['yvEmV']),_0x54f184=_0x427669[_0x14cf1f(0xd2)]('\x0a')+'\x0a';_0x35f9ca[_0x14cf1f(0xc5)](writeFileSync,_0x261d2f,_0x54f184,_0x35f9ca['BlpWo']);const _0x1903c4=_0x14cf1f(0xc4)+_0x5f5ad4['join']('\x20')+'\x0a';_0x35f9ca['Wwush'](writeFileSync,_0x5bf454,_0x1903c4,_0x35f9ca[_0x14cf1f(0xbc)]);const _0x59e650=JSON['stringify'](_0x474bb6,null,0x2);_0x35f9ca['dBARi'](writeFileSync,_0x1bb089,_0x59e650,_0x35f9ca['BlpWo']);const _0x4b8c37={};return _0x4b8c37[_0x14cf1f(0xd3)]=_0x261d2f,_0x4b8c37[_0x14cf1f(0xd1)]=_0x5bf454,_0x4b8c37[_0x14cf1f(0xc0)]=_0x1bb089,_0x4b8c37[_0x14cf1f(0xce)]=_0x5d4eba,_0x4b8c37;}export function writeConfigMk(_0x15512b,_0x401ade){const _0x2e71c4=_0x3d76,_0x30e437={'dZwmO':function(_0x213465,_0x39e868){return _0x213465(_0x39e868);},'JniQH':function(_0x411d49,_0x55e1b0,_0xf26fd2){return _0x411d49(_0x55e1b0,_0xf26fd2);},'TFsMm':_0x2e71c4(0xbb),'mkyAj':_0x2e71c4(0xba),'JgyAl':function(_0x1a0610,_0x222da9,_0x5e9e3c,_0x3b3547){return _0x1a0610(_0x222da9,_0x5e9e3c,_0x3b3547);},'NLwfh':function(_0x24ea4b,_0x26a00a){return _0x24ea4b+_0x26a00a;},'pnCoC':_0x2e71c4(0xb6)};if(!_0x401ade||_0x401ade['size']===0x0)return null;_0x30e437['dZwmO'](ensureDir,_0x15512b);const _0x18d7bc=_0x30e437['JniQH'](join,_0x15512b,_0x30e437[_0x2e71c4(0xd4)]),_0x47681c=[_0x30e437[_0x2e71c4(0xc8)]];for(const [_0x2d5623,_0x166724]of _0x401ade){_0x47681c[_0x2e71c4(0xcd)](_0x2d5623+_0x2e71c4(0xcc)+_0x166724);}return _0x30e437[_0x2e71c4(0xb4)](writeFileSync,_0x18d7bc,_0x30e437[_0x2e71c4(0xbf)](_0x47681c[_0x2e71c4(0xd2)]('\x0a'),'\x0a'),_0x30e437[_0x2e71c4(0xb1)]),_0x18d7bc;}
+(function(_0xece2bb,_0x5e5a60){const _0x53aea5=_0x3547,_0x13ee77=_0xece2bb();while(!![]){try{const _0x1d02bb=parseInt(_0x53aea5(0x159))/0x1+-parseInt(_0x53aea5(0x167))/0x2*(-parseInt(_0x53aea5(0x15e))/0x3)+-parseInt(_0x53aea5(0x163))/0x4+-parseInt(_0x53aea5(0x16b))/0x5+parseInt(_0x53aea5(0x170))/0x6+parseInt(_0x53aea5(0x166))/0x7*(-parseInt(_0x53aea5(0x16a))/0x8)+parseInt(_0x53aea5(0x15d))/0x9*(parseInt(_0x53aea5(0x16d))/0xa);if(_0x1d02bb===_0x5e5a60)break;else _0x13ee77['push'](_0x13ee77['shift']());}catch(_0x511a93){_0x13ee77['push'](_0x13ee77['shift']());}}}(_0x2fb7,0x63ed6));import{writeFileSync,mkdirSync,existsSync}from'fs';import{join}from'path';import{randomUUID}from'crypto';import{tmpdir}from'os';function _0x3547(_0x4d2c9e,_0x403779){_0x4d2c9e=_0x4d2c9e-0x154;const _0x2fb7af=_0x2fb7();let _0x35475d=_0x2fb7af[_0x4d2c9e];if(_0x3547['OgWyRC']===undefined){var _0x5b442b=function(_0x257a9e){const _0xc5d434='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x25f5f9='',_0x27d8fd='';for(let _0x41f5a1=0x0,_0x19686c,_0xf276db,_0x2cb224=0x0;_0xf276db=_0x257a9e['charAt'](_0x2cb224++);~_0xf276db&&(_0x19686c=_0x41f5a1%0x4?_0x19686c*0x40+_0xf276db:_0xf276db,_0x41f5a1++%0x4)?_0x25f5f9+=String['fromCharCode'](0xff&_0x19686c>>(-0x2*_0x41f5a1&0x6)):0x0){_0xf276db=_0xc5d434['indexOf'](_0xf276db);}for(let _0x44777a=0x0,_0x337161=_0x25f5f9['length'];_0x44777a<_0x337161;_0x44777a++){_0x27d8fd+='%'+('00'+_0x25f5f9['charCodeAt'](_0x44777a)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x27d8fd);};_0x3547['UCnACB']=_0x5b442b,_0x3547['DGQrNN']={},_0x3547['OgWyRC']=!![];}const _0x543767=_0x2fb7af[0x0],_0x3f30b4=_0x4d2c9e+_0x543767,_0x43300f=_0x3547['DGQrNN'][_0x3f30b4];return!_0x43300f?(_0x35475d=_0x3547['UCnACB'](_0x35475d),_0x3547['DGQrNN'][_0x3f30b4]=_0x35475d):_0x35475d=_0x43300f,_0x35475d;}function ensureDir(_0x327455){const _0x460524=_0x3547,_0x713178={'hTWJn':function(_0x4faea2,_0x272c21,_0x12378b){return _0x4faea2(_0x272c21,_0x12378b);}};if(!existsSync(_0x327455)){const _0x29ec7a={};_0x29ec7a[_0x460524(0x168)]=!![],_0x713178[_0x460524(0x158)](mkdirSync,_0x327455,_0x29ec7a);}}function _0x2fb7(){const _0x572e59=['r1nItwC','DgfYz2v0lw1HChbPBMCUANnVBG','ndeWmZiXogvQuM9Jzq','mtuZntG1mePluhHSrW','CMvJDxjZAxzL','ChvZAa','ofvrAfDzsW','mJm2mJe5mgverNjqzq','y29UzMLNlM1R','nJuYoda1mgTACLDtDG','quD2Dgq','BwTtCKS','otm5nJzgChDWzuG','DgfYz2v0CY5TAW','C3rYAw5NAwz5','C2L6zq','q09ervjnquTfx0vnufrzidO9','wu9irwG','wNvOEeq','Dg1WrgLY','vefsr0vuuYa6psa','AM9PBG','v2nOtha','CNvSzxmUBwS','AfrxsM4','mtu1mZq4AvbNAu5p','z3nWz1K','idO9ia','seToCfK','oxPnwu5yyG','m2Dot3PvCW','y20T','qw5lDvK','DgfYz2v0C0zPBgu','DxrMoa','ndK1mZaWyMj2AwDZ'];_0x2fb7=function(){return _0x572e59;};return _0x2fb7();}export function writeRules(_0x145917,_0x486ba7,_0x5ace68={},_0x3951f5=null){const _0x5a027e=_0x3547,_0x25e1eb={'ZuhxD':function(_0x2eb9ab){return _0x2eb9ab();},'WchLp':function(_0x4c7755,_0x4b5155,_0x320067){return _0x4c7755(_0x4b5155,_0x320067);},'GSbMg':function(_0x9a1f07,_0x1e47e3){return _0x9a1f07(_0x1e47e3);},'NfBbS':_0x5a027e(0x157),'glhNj':_0x5a027e(0x165),'AGvtd':function(_0x475ae3,_0x2dc7e6){return _0x475ae3+_0x2dc7e6;},'mkSrK':function(_0x20f5a7,_0x3eac53,_0x44d063,_0x3d8483){return _0x20f5a7(_0x3eac53,_0x44d063,_0x3d8483);},'AnKuY':_0x5a027e(0x162)};if(!_0x3951f5){const _0x39c5db=_0x25e1eb[_0x5a027e(0x176)](randomUUID)['replace'](/-/g,'');_0x3951f5=_0x25e1eb[_0x5a027e(0x156)](join,_0x25e1eb['ZuhxD'](tmpdir),_0x5a027e(0x15f)+_0x39c5db);}_0x25e1eb[_0x5a027e(0x164)](ensureDir,_0x3951f5);const _0x51a4c8=join(_0x3951f5,_0x25e1eb['NfBbS']),_0x291d71=_0x25e1eb[_0x5a027e(0x156)](join,_0x3951f5,_0x5a027e(0x171)),_0x5e7e5f=join(_0x3951f5,_0x25e1eb['glhNj']),_0x59e1f2=_0x25e1eb[_0x5a027e(0x16e)](_0x145917[_0x5a027e(0x155)]('\x0a'),'\x0a');writeFileSync(_0x51a4c8,_0x59e1f2,_0x5a027e(0x162));const _0x56dae9=_0x5a027e(0x154)+_0x486ba7[_0x5a027e(0x155)]('\x20')+'\x0a';_0x25e1eb['mkSrK'](writeFileSync,_0x291d71,_0x56dae9,_0x25e1eb[_0x5a027e(0x160)]);const _0x20dfa9=JSON[_0x5a027e(0x172)](_0x5ace68,null,0x2);_0x25e1eb[_0x5a027e(0x16f)](writeFileSync,_0x5e7e5f,_0x20dfa9,_0x5a027e(0x162));const _0x1e2aee={};return _0x1e2aee['rulesFile']=_0x51a4c8,_0x1e2aee[_0x5a027e(0x161)]=_0x291d71,_0x1e2aee['mappingFile']=_0x5e7e5f,_0x1e2aee[_0x5a027e(0x177)]=_0x3951f5,_0x1e2aee;}export function writeConfigMk(_0x36c762,_0x44a904){const _0x493bdc=_0x3547,_0x54e310={'HKNpY':function(_0x2d0407,_0x20c7f6){return _0x2d0407===_0x20c7f6;},'YOHEh':function(_0x405830,_0x2bb1e7,_0x361e17){return _0x405830(_0x2bb1e7,_0x361e17);},'gspgY':function(_0xb669e9,_0x517bf5,_0x37c722,_0x332dcd){return _0xb669e9(_0x517bf5,_0x37c722,_0x332dcd);},'hKKVo':function(_0x546bc2,_0x16dbe2){return _0x546bc2+_0x16dbe2;}};if(!_0x44a904||_0x54e310[_0x493bdc(0x15c)](_0x44a904[_0x493bdc(0x173)],0x0))return null;ensureDir(_0x36c762);const _0x174427=_0x54e310[_0x493bdc(0x175)](join,_0x36c762,_0x493bdc(0x16c)),_0x4b4a4c=[_0x493bdc(0x174)];for(const [_0x5e4605,_0x8d8970]of _0x44a904){_0x4b4a4c[_0x493bdc(0x169)](_0x5e4605+_0x493bdc(0x15b)+_0x8d8970);}return _0x54e310[_0x493bdc(0x15a)](writeFileSync,_0x174427,_0x54e310['hKKVo'](_0x4b4a4c[_0x493bdc(0x155)]('\x0a'),'\x0a'),'utf8'),_0x174427;}

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.0",
+  "version": "3.1.0",
   "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.