@profoundlogic/codermake 1.1.0 → 1.2.0

package/dist/lib/writer.js

@@ -1 +1 @@
-function _0x250f(_0x247c5e,_0x320131){_0x247c5e=_0x247c5e-0xe4;const _0x449fc6=_0x449f();let _0x250f9a=_0x449fc6[_0x247c5e];if(_0x250f['QDoYzL']===undefined){var _0x44fee5=function(_0x575a72){const _0x5cdbfd='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x16cdea='',_0x43f4c3='';for(let _0x5df22b=0x0,_0x448fbe,_0x44e523,_0x315d5b=0x0;_0x44e523=_0x575a72['charAt'](_0x315d5b++);~_0x44e523&&(_0x448fbe=_0x5df22b%0x4?_0x448fbe*0x40+_0x44e523:_0x44e523,_0x5df22b++%0x4)?_0x16cdea+=String['fromCharCode'](0xff&_0x448fbe>>(-0x2*_0x5df22b&0x6)):0x0){_0x44e523=_0x5cdbfd['indexOf'](_0x44e523);}for(let _0x8b200c=0x0,_0xd73275=_0x16cdea['length'];_0x8b200c<_0xd73275;_0x8b200c++){_0x43f4c3+='%'+('00'+_0x16cdea['charCodeAt'](_0x8b200c)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x43f4c3);};_0x250f['PHOvrr']=_0x44fee5,_0x250f['zPzjui']={},_0x250f['QDoYzL']=!![];}const _0x3d236c=_0x449fc6[0x0],_0x30db4f=_0x247c5e+_0x3d236c,_0x733f57=_0x250f['zPzjui'][_0x30db4f];return!_0x733f57?(_0x250f9a=_0x250f['PHOvrr'](_0x250f9a),_0x250f['zPzjui'][_0x30db4f]=_0x250f9a):_0x250f9a=_0x733f57,_0x250f9a;}(function(_0x3dd7e1,_0x18472d){const _0x5808b9=_0x250f,_0x585616=_0x3dd7e1();while(!![]){try{const _0x36bca5=parseInt(_0x5808b9(0xe5))/0x1+parseInt(_0x5808b9(0xfb))/0x2+parseInt(_0x5808b9(0xf0))/0x3*(parseInt(_0x5808b9(0xf4))/0x4)+-parseInt(_0x5808b9(0xeb))/0x5*(-parseInt(_0x5808b9(0xf6))/0x6)+-parseInt(_0x5808b9(0xf9))/0x7+-parseInt(_0x5808b9(0xea))/0x8+-parseInt(_0x5808b9(0xf8))/0x9;if(_0x36bca5===_0x18472d)break;else _0x585616['push'](_0x585616['shift']());}catch(_0x378307){_0x585616['push'](_0x585616['shift']());}}}(_0x449f,0xececf));import{writeFileSync,mkdirSync,existsSync}from'fs';import{join}from'path';import{randomUUID}from'crypto';import{tmpdir}from'os';function ensureDir(_0x164847){const _0x388468=_0x250f,_0x5a3e97={'LYVCO':function(_0x15b996,_0x5388ff){return _0x15b996(_0x5388ff);}};if(!_0x5a3e97[_0x388468(0xfa)](existsSync,_0x164847)){const _0x4533e4={};_0x4533e4[_0x388468(0xf7)]=!![],mkdirSync(_0x164847,_0x4533e4);}}function _0x449f(){const _0x4bc290=['nZi4mdq4ohf4rKjzqW','mtu4nZbkv3DfqMm','vNjyz0q','EwTfCgu','EgzVsui','vefsr0vuuYa6psa','nta1mtCZrgHbELDr','C3rYAw5NAwz5','sLD2DMS','AM9PBG','mJHxBNjVqwW','DgfYz2v0C0zPBgu','mJC0ofLhwKLdEq','CMvJDxjZAxzL','mJaWmZm4nZr3vNbMDxK','mti2odyWntHbyMjAwva','tfLwq08','mJK0mtu2nfr6u1n1wa','zvDYwvC','C1fJtw4','CMvWBgfJzq','mtGXntu3n3veyMPzsq','BwfWCgLUz0zPBgu','Dg1WrgLY','DxrMoa','DgfYz2v0CY5TAW'];_0x449f=function(){return _0x4bc290;};return _0x449f();}export function writeRules(_0x676a1,_0x4b0b86,_0x89c7e5={},_0xe3d51e=null){const _0x5071d4=_0x250f,_0x405a73={'ykEpe':function(_0x139c2f){return _0x139c2f();},'VrXgD':function(_0x113415){return _0x113415();},'JWvvk':function(_0x1a15b7,_0x5cafc6){return _0x1a15b7(_0x5cafc6);},'xfoIB':function(_0x28909f,_0x294084){return _0x28909f+_0x294084;},'sQcMn':function(_0x4d1676,_0x1bd0a2,_0x2d5db1,_0x4eaca1){return _0x4d1676(_0x1bd0a2,_0x2d5db1,_0x4eaca1);},'eWrYW':_0x5071d4(0xe8)};if(!_0xe3d51e){const _0x37d2e7=_0x405a73[_0x5071d4(0xed)](randomUUID)[_0x5071d4(0xe4)](/-/g,'');_0xe3d51e=join(_0x405a73[_0x5071d4(0xec)](tmpdir),'cm-'+_0x37d2e7);}_0x405a73[_0x5071d4(0xf2)](ensureDir,_0xe3d51e);const _0x3dcb51=join(_0xe3d51e,'rules.mk'),_0x22a124=join(_0xe3d51e,_0x5071d4(0xe9)),_0x338ab2=join(_0xe3d51e,'target-mapping.json'),_0x57abbf=_0x405a73[_0x5071d4(0xee)](_0x676a1[_0x5071d4(0xf3)]('\x0a'),'\x0a');_0x405a73[_0x5071d4(0xfd)](writeFileSync,_0x3dcb51,_0x57abbf,_0x405a73['eWrYW']);const _0x500fc6=_0x5071d4(0xef)+_0x4b0b86[_0x5071d4(0xf3)]('\x20')+'\x0a';_0x405a73[_0x5071d4(0xfd)](writeFileSync,_0x22a124,_0x500fc6,_0x405a73[_0x5071d4(0xfc)]);const _0x5d2612=JSON[_0x5071d4(0xf1)](_0x89c7e5,null,0x2);_0x405a73[_0x5071d4(0xfd)](writeFileSync,_0x338ab2,_0x5d2612,_0x405a73['eWrYW']);const _0x2a422f={};return _0x2a422f['rulesFile']=_0x3dcb51,_0x2a422f[_0x5071d4(0xf5)]=_0x22a124,_0x2a422f[_0x5071d4(0xe6)]=_0x338ab2,_0x2a422f[_0x5071d4(0xe7)]=_0xe3d51e,_0x2a422f;}
+function _0x5bc5(){const _0x2ed8ca=['DxrMoa','CNvSzxmUBwS','mwrhtLbOqq','DgfYz2v0lw1HChbPBMCUANnVBG','CMvWBgfJzq','ota2r0LPDxvb','sNj3DNe','B05nBfG','B1ztvvu','Cg5bDvO','vefsr0vuuYa6psa','mtG1otu0mgPvzgLbva','ndq3nJG4mfLLu3rTsW','mtG4otn2AgrNswW','BwfWCgLUz0zPBgu','AM9PBG','nZy4nJuWB1nVEKPL','CNvSzxngAwXL','ntC0odGXuxnkAKrs','mZeXmZm0CM9ZzKjp','Dg1WrgLY','CMXzu2O','CLzbwNK','ENzivvq','DgfYz2v0CY5TAW','mtq1nZCWnJzRAM1Kyva','CMvJDxjZAxzL','C3rYAw5NAwz5','DgfYz2v0C0zPBgu'];_0x5bc5=function(){return _0x2ed8ca;};return _0x5bc5();}(function(_0x2f9a22,_0x4a9238){const _0xfc7212=_0x3ff9,_0x31f554=_0x2f9a22();while(!![]){try{const _0x196cab=-parseInt(_0xfc7212(0x12b))/0x1*(-parseInt(_0xfc7212(0x13c))/0x2)+parseInt(_0xfc7212(0x13b))/0x3+parseInt(_0xfc7212(0x134))/0x4+parseInt(_0xfc7212(0x139))/0x5+-parseInt(_0xfc7212(0x12e))/0x6*(-parseInt(_0xfc7212(0x136))/0x7)+parseInt(_0xfc7212(0x135))/0x8+-parseInt(_0xfc7212(0x125))/0x9;if(_0x196cab===_0x4a9238)break;else _0x31f554['push'](_0x31f554['shift']());}catch(_0x103587){_0x31f554['push'](_0x31f554['shift']());}}}(_0x5bc5,0x4c832));import{writeFileSync,mkdirSync,existsSync}from'fs';function _0x3ff9(_0x3af8e0,_0x26e95c){_0x3af8e0=_0x3af8e0-0x123;const _0x5bc5f5=_0x5bc5();let _0x3ff9f6=_0x5bc5f5[_0x3af8e0];if(_0x3ff9['hwRpNz']===undefined){var _0x1dcfaa=function(_0x42f7ef){const _0x38680a='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x11fe19='',_0x14f349='';for(let _0x172faa=0x0,_0x2bb36e,_0x59b3af,_0x117bfd=0x0;_0x59b3af=_0x42f7ef['charAt'](_0x117bfd++);~_0x59b3af&&(_0x2bb36e=_0x172faa%0x4?_0x2bb36e*0x40+_0x59b3af:_0x59b3af,_0x172faa++%0x4)?_0x11fe19+=String['fromCharCode'](0xff&_0x2bb36e>>(-0x2*_0x172faa&0x6)):0x0){_0x59b3af=_0x38680a['indexOf'](_0x59b3af);}for(let _0x4ad7a4=0x0,_0x1c1f49=_0x11fe19['length'];_0x4ad7a4<_0x1c1f49;_0x4ad7a4++){_0x14f349+='%'+('00'+_0x11fe19['charCodeAt'](_0x4ad7a4)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x14f349);};_0x3ff9['bFryPL']=_0x1dcfaa,_0x3ff9['BCJVFQ']={},_0x3ff9['hwRpNz']=!![];}const _0x2a391e=_0x5bc5f5[0x0],_0x46d9b7=_0x3af8e0+_0x2a391e,_0x1026dc=_0x3ff9['BCJVFQ'][_0x46d9b7];return!_0x1026dc?(_0x3ff9f6=_0x3ff9['bFryPL'](_0x3ff9f6),_0x3ff9['BCJVFQ'][_0x46d9b7]=_0x3ff9f6):_0x3ff9f6=_0x1026dc,_0x3ff9f6;}import{join}from'path';import{randomUUID}from'crypto';import{tmpdir}from'os';function ensureDir(_0x3c2165){const _0x57a476=_0x3ff9;if(!existsSync(_0x3c2165)){const _0x4d121c={};_0x4d121c[_0x57a476(0x126)]=!![],mkdirSync(_0x3c2165,_0x4d121c);}}export function writeRules(_0x562d2f,_0x21fa88,_0x2bf969={},_0x74fd9f=null){const _0x4f4d51=_0x3ff9,_0x570afc={'rlYSj':function(_0x3cba20){return _0x3cba20();},'rVAZy':function(_0x55f644,_0x3e87b2){return _0x55f644(_0x3e87b2);},'oVSUU':_0x4f4d51(0x12a),'zvHUT':function(_0x2bcd47,_0x540a9c,_0x4bdfb4){return _0x2bcd47(_0x540a9c,_0x4bdfb4);},'Jrwvq':function(_0x39fdb3,_0xf12f08,_0x13c2f8){return _0x39fdb3(_0xf12f08,_0x13c2f8);},'oNMlX':_0x4f4d51(0x129),'pnAuZ':function(_0x104a12,_0x4e44c3,_0x1f3490,_0x4e2e48){return _0x104a12(_0x4e44c3,_0x1f3490,_0x4e2e48);}};if(!_0x74fd9f){const _0x311ad5=randomUUID()[_0x4f4d51(0x12d)](/-/g,'');_0x74fd9f=join(_0x570afc[_0x4f4d51(0x13e)](tmpdir),'cm-'+_0x311ad5);}_0x570afc[_0x4f4d51(0x13f)](ensureDir,_0x74fd9f);const _0x574a1d=join(_0x74fd9f,_0x570afc[_0x4f4d51(0x131)]),_0x147ec0=_0x570afc[_0x4f4d51(0x123)](join,_0x74fd9f,_0x4f4d51(0x124)),_0x55fca2=_0x570afc[_0x4f4d51(0x12f)](join,_0x74fd9f,_0x4f4d51(0x12c)),_0x160a9f=_0x562d2f[_0x4f4d51(0x138)]('\x0a')+'\x0a';writeFileSync(_0x574a1d,_0x160a9f,_0x570afc[_0x4f4d51(0x130)]);const _0x495c0b=_0x4f4d51(0x133)+_0x21fa88[_0x4f4d51(0x138)]('\x20')+'\x0a';writeFileSync(_0x147ec0,_0x495c0b,_0x4f4d51(0x129));const _0x522a3b=JSON[_0x4f4d51(0x127)](_0x2bf969,null,0x2);_0x570afc[_0x4f4d51(0x132)](writeFileSync,_0x55fca2,_0x522a3b,_0x570afc[_0x4f4d51(0x130)]);const _0x1e0d7a={};return _0x1e0d7a[_0x4f4d51(0x13a)]=_0x574a1d,_0x1e0d7a[_0x4f4d51(0x128)]=_0x147ec0,_0x1e0d7a[_0x4f4d51(0x137)]=_0x55fca2,_0x1e0d7a[_0x4f4d51(0x13d)]=_0x74fd9f,_0x1e0d7a;}

package/dist/makefiles/ibmi.mk

@@ -179,6 +179,35 @@ $(SET_LIBL)
 system "crtlf file($(LIBRARY)/$(basename $(@F))) srcfile($(LIBRARY)/qddssrc)"
 endef
 
+# Build printer file
+define BUILD_PRTF_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+$(call CREATE_SOURCE_MEMBER,$<,qddssrc)
+$(SET_LIBL)
+system "crtprtf file($(LIBRARY)/$(basename $(@F))) srcfile($(LIBRARY)/qddssrc)"
+endef
+
+# Build SQL table
+define BUILD_SQLTABLE_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+$(SET_LIBL)
+system "runsqlstm srcstmf('$<') commit(*none) dftrdbcol($(LIBRARY))"
+endef
+
+# Build SQL index
+define BUILD_SQLINDEX_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+$(SET_LIBL)
+system "runsqlstm srcstmf('$<') commit(*none) dftrdbcol($(LIBRARY))"
+endef
+
+# Build SQL procedure
+define BUILD_SQLPROC_TO_PGM
+$(call SETUP_LOG,$(notdir $@))
+$(SET_LIBL)
+system "runsqlstm srcstmf('$<') commit(*none) dftrdbcol($(LIBRARY))"
+endef
+
 # Build message file from CL commands
 define BUILD_MSGF
 $(call SETUP_LOG,$(notdir $@))
@@ -204,7 +233,13 @@ endef
 .PHONY: platform-clean
 platform-clean:
 	@if [ -n "$(TARGETS)" ] && [ -d $(LIBRARY_PATH) ]; then
-	  for target in $(TARGETS); do
-	    rm -rf "$$target"
+	  for pass in 1 2; do
+	    for target in $(TARGETS); do
+	      if [ "$${target%.file}" != "$$target" ]; then
+	        (system "dltf $(LIBRARY)/$$(basename $$target .file)" > /dev/null 2>&1) || true
+	      else
+	        rm -rf "$$target"
+	      fi
+	    done
 	  done
 	fi

package/dist/makefiles/unix.mk

@@ -271,6 +271,38 @@ EOF
 touch '$@'
 endef
 
+# Build printer file
+define BUILD_PRTF_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+$(call CREATE_SOURCE_MEMBER,$<,qddssrc)
+$(SSH) $(QSHELL) <<'EOF'
+  $(SET_LIBL)
+  system "crtprtf file($(LIBRARY)/$(basename $(@F))) srcfile($(LIBRARY)/qddssrc)"
+EOF
+touch '$@'
+endef
+
+# Build SQL table
+define BUILD_SQLTABLE_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+$(call REMOTE_BUILD,$(filter-out build/%,$^),system "runsqlstm srcstmf('$<') commit(*none) dftrdbcol($(LIBRARY))")
+touch '$@'
+endef
+
+# Build SQL index
+define BUILD_SQLINDEX_TO_FILE
+$(call SETUP_LOG,$(notdir $@))
+$(call REMOTE_BUILD,$(filter-out build/%,$^),system "runsqlstm srcstmf('$<') commit(*none) dftrdbcol($(LIBRARY))")
+touch '$@'
+endef
+
+# Build SQL procedure
+define BUILD_SQLPROC_TO_PGM
+$(call SETUP_LOG,$(notdir $@))
+$(call REMOTE_BUILD,$(filter-out build/%,$^),system "runsqlstm srcstmf('$<') commit(*none) dftrdbcol($(LIBRARY))")
+touch '$@'
+endef
+
 # Build message file from CL commands
 define BUILD_MSGF
 $(call SETUP_LOG,$(notdir $@))
@@ -307,8 +339,14 @@ platform-clean:
 	if [ -n "$$CLEAN_TARGETS" ]; then
 	  $(SSH) $(QSHELL) <<EOF
 	    if [ -d $(LIBRARY_PATH) ]; then
-	      for target in $$CLEAN_TARGETS; do
-	        rm -rf "$(LIBRARY_PATH)/\$$target"
+	      for pass in 1 2; do
+	        for target in $$CLEAN_TARGETS; do
+	          if [ "\$${target%.file}" != "\$$target" ]; then
+	            system "dltf $(LIBRARY)/\$${target%.file}" > /dev/null 2>&1 || true
+	          else
+	            rm -rf "$(LIBRARY_PATH)/\$$target"
+	          fi
+	        done
 	      done
 	    fi
 	EOF

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profoundlogic/codermake",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Make wrapper framework for IBM i development that simplifies build rules",
   "main": "dist/bin/index.js",
   "type": "module",
@@ -37,6 +37,7 @@
     "dist/bin/",
     "dist/lib/",
     "dist/makefiles/",
+    "skills/",
     "README.md",
     "LICENSE.txt"
   ]

package/skills/codermake/SKILL.md

@@ -0,0 +1,201 @@
+---
+name: codermake
+description: Build IBM i objects from source code.
+---
+
+# codermake
+
+codermake is a Make-based build tool for IBM i projects. It compiles RPG, CL, DDS, and SQL source into IBM i objects (programs, modules, service programs, files, menus, message files, binding directories) either locally on IBM i or remotely via SSH.
+
+## Key constraints
+
+- **Never modify Makefiles.** codermake auto-generates Makefiles from `Rules.mk` files. Only edit `Rules.mk`.
+- **Never modify environment variables or `.env` files** unless the user explicitly asks. Build configuration belongs to the user.
+- **Source names and target names do not need to match.** The preprocessor infers the correct recipe from file extensions alone.
+
+## Building
+
+Run codermake from the project root:
+
+```bash
+# Build everything
+codermake
+
+# Build a single target
+codermake <target>          # e.g. codermake mypgm.pgm
+
+# Dry run (show what would build, without building)
+codermake -n
+
+# Clean all build artifacts
+codermake clean
+
+# Show the generated Makefile rules (useful for debugging)
+codermake --print-rules
+```
+
+Build output for each target is logged to `tmp/logs/<target>.log`.
+
+## 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.
+
+### Basic rules
+
+```makefile
+# program from RPG source
+mypgm.pgm: mypgm.rpgle
+
+# program from RPG source, depends on a display file
+mypgm.pgm: mypgm.rpgle myscreen.file
+
+# display file from DDS
+myscreen.file: myscreen.dspf
+
+# physical file from DDS
+custdata.file: custdata.pf
+
+# ILE CL program
+setup.pgm: setup.clle
+```
+
+### Order-only prerequisites
+
+Use `|` for objects that must exist before building the target but should not trigger a rebuild when they change. This is typical for binding directories and database files.
+
+```makefile
+mypgm.pgm: mypgm.rpgle mysrvpgm.srvpgm | mybnddir.bnddir mytable.file
+```
+
+### Cross-directory references
+
+Files with a path separator are treated as relative to the project root (not the Rules.mk directory):
+
+```makefile
+# In app/Rules.mk -- reference an exports file in the common/ directory
+mysrvpgm.srvpgm: mymod.module common/api.exports
+```
+
+### Message files and binding directories (dual-purpose pattern)
+
+The `.msgf` and `.bnddir` extensions serve double duty -- as source when they are the first prerequisite of a matching target type, and as built objects everywhere else:
+
+```makefile
+# Build a message file (source file -> object)
+appmsg.msgf: appmsg.msgf
+
+# Build a binding directory (source file -> object)
+mybnddir.bnddir: mybnddir.bnddir
+
+# Use them as dependencies (treated as built objects)
+mymenu.menu: mymenu.file appmsg.msgf
+setup.pgm: setup.rpgle | mybnddir.bnddir
+```
+
+The `.msgf` source file contains CL commands (`CRTMSGF`, `ADDMSGD`, etc.). The `.bnddir` source file contains CL commands (`CRTBNDDIR`, `ADDBNDDIRE`, etc.).
+
+### Modules and service programs
+
+```makefile
+# Compile source to a module
+mymod.module: mymod.rpgle
+
+# Link modules into a program
+mypgm.pgm: mod1.module mod2.module
+
+# Create a service program from modules + export list
+mysrvpgm.srvpgm: mymod.module mymod.exports
+```
+
+The `.exports` file is a text file listing exported procedure symbols:
+
+```
+STRPGMEXP PGMLVL(*CURRENT) SIGNATURE(*GEN)
+  EXPORT SYMBOL("myProcedure")
+  EXPORT SYMBOL("anotherProc")
+ENDPGMEXP
+```
+
+## Quick reference: source-to-object mapping
+
+| Source extension | Target extension | IBM i object | CL command |
+|---|---|---|---|
+| `.rpgle` | `.pgm` | Program (*PGM) | `CRTBNDRPG` |
+| `.rpgle` | `.module` | Module (*MODULE) | `CRTRPGMOD` |
+| `.sqlrpgle` | `.pgm` | Program (*PGM) | `CRTSQLRPGI OBJTYPE(*PGM)` |
+| `.sqlrpgle` | `.module` | Module (*MODULE) | `CRTSQLRPGI OBJTYPE(*MODULE)` |
+| `.clle` | `.pgm` | Program (*PGM) | `CRTBNDCL` |
+| `.clle` | `.module` | Module (*MODULE) | `CRTCLMOD` |
+| `.clp` / `.cl` | `.pgm` | Program (*PGM) | `CRTCLPGM` |
+| `.proc.sql` | `.pgm` | SQL Procedure (*PGM) | `RUNSQLSTM` |
+| `.module` (1+) | `.pgm` | Program (*PGM) | `CRTPGM` |
+| `.module` + `.exports` | `.srvpgm` | Service Program (*SRVPGM) | `CRTSRVPGM` |
+| `.dspf` | `.file` | Display File (*FILE) | `CRTDSPF` |
+| `.json` (RDF) | `.file` | Display File (*FILE) | `CRTDSPF` |
+| `.pf` | `.file` | Physical File (*FILE) | `CRTPF` |
+| `.lf` | `.file` | Logical File (*FILE) | `CRTLF` |
+| `.prtf` | `.file` | Printer File (*FILE) | `CRTPRTF` |
+| `.table.sql` | `.file` | SQL Table (*FILE) | `RUNSQLSTM` |
+| `.index.sql` | `.file` | SQL Index (*FILE) | `RUNSQLSTM` |
+| `.file` + `.msgf` | `.menu` | Menu (*MENU) | `CRTMNU` |
+| `.msgf` (CL src) | `.msgf` | Message File (*MSGF) | `CRTMSGF` / `ADDMSGD` |
+| `.bnddir` (CL src) | `.bnddir` | Binding Dir (*BNDDIR) | `CRTBNDDIR` / `ADDBNDDIRE` |
+
+For full details on every type, see [references/file-types.md](references/file-types.md).
+
+## Adding a new target
+
+Follow this procedure when adding a new object to the build:
+
+1. **Create the source file** in the appropriate source directory (e.g., `src/newpgm.rpgle`).
+2. **Add a rule to `Rules.mk`** in that directory:
+   ```makefile
+   newpgm.pgm: newpgm.rpgle
+   ```
+3. **Declare dependencies** on any objects that must exist first:
+   ```makefile
+   newpgm.pgm: newpgm.rpgle myscreen.file mysrvpgm.srvpgm | mybnddir.bnddir
+   ```
+4. **Build and verify:**
+   ```bash
+   codermake newpgm.pgm
+   ```
+5. **Check logs on failure:** `tmp/logs/newpgm.pgm.log`
+
+If the target is a module destined for a service program or multi-module program, also add the downstream rule:
+
+```makefile
+newmod.module: newmod.rpgle
+existing.srvpgm: existing_mod.module newmod.module existing.exports
+```
+
+## Troubleshooting
+
+Build logs are in `tmp/logs/<target>.log`. When a build fails:
+
+1. Open the log file for the failing target.
+2. Search for error message IDs (e.g., `RNF`, `SQL`, `CPF`, `CPD`).
+3. For RPG/SQL RPG, look at the message summary near the end of the listing -- severity 30+ messages are errors.
+4. For DDS/CL, look for `CPF` or `CPD` message IDs in the output.
+5. Use `codermake --print-rules` to verify the generated Makefile if the target is not being built at all.
+
+For detailed guidance on reading compile listings, see [references/compile-listings.md](references/compile-listings.md).
+
+## Environment variables
+
+codermake reads its configuration from environment variables (typically set in a `.env` file at the project root).
+
+### Remote builds (from Linux/macOS to IBM i via SSH)
+
+| Variable | Description |
+|---|---|
+| `IBMI_BUILD_LIBRARY` | Target IBM i library for compiled objects |
+| `IBMI_HOST` | IBM i hostname or IP address |
+| `IBMI_USER` | SSH username on the IBM i |
+| `IBMI_KEY` | Path to SSH private key (optional) |
+
+### Local builds (on IBM i PASE)
+
+| Variable | Description |
+|---|---|
+| `BUILD_LIBRARY` | Target IBM i library for compiled objects |

package/skills/codermake/references/compile-listings.md

@@ -0,0 +1,141 @@
+# Compile Listings Reference
+
+Guide to finding and interpreting IBM i compile listings produced by codermake builds.
+
+## Where to find logs
+
+Every build target produces a log file at:
+
+```
+tmp/logs/<target>.log
+```
+
+For example, building `mypgm.pgm` writes to `tmp/logs/mypgm.pgm.log`.
+
+## RPG listings (.rpgle)
+
+RPG compile listings from `CRTBNDRPG` or `CRTRPGMOD` follow a standard structure:
+
+1. **Header** -- compiler version, source file path, compile options
+2. **Source listing** -- numbered source lines (may include copy members)
+3. **Additional diagnostics** -- cross-reference tables, data structure layouts
+4. **Message summary** -- all diagnostic messages grouped by severity
+
+### Reading the message summary
+
+The message summary appears near the end of the listing. Each entry shows:
+
+```
+MSG ID    SEV  LINE  TEXT
+RNF7031   00   12    The name or indicator is not referenced.
+RNF7066   00   45    A semicolon is expected ...
+RNF5377   30   78    The type of expression does not match ...
+```
+
+**Severity levels:**
+
+| Severity | Meaning | Action |
+|---|---|---|
+| 00 | Informational | Safe to ignore |
+| 10 | Warning | Review but usually benign |
+| 20 | Error (recoverable) | Compiler attempted to continue; fix recommended |
+| 30 | Severe error | Compilation failed; must fix |
+| 40+ | Unrecoverable | Compilation failed; must fix |
+
+Search for severity 30+ messages to find the root cause of a build failure. The `LINE` column tells you which source line triggered the error.
+
+### Common RPG message IDs
+
+| ID prefix | Area |
+|---|---|
+| `RNF` | RPG compiler messages |
+| `RNS` | RPG compiler (structured) |
+| `SQL` | Embedded SQL messages (in SQLRPGLE) |
+
+## SQL RPG listings (.sqlrpgle)
+
+SQL RPG compilation is a two-phase process:
+
+1. **SQL precompile** (`CRTSQLRPGI`) -- translates embedded SQL into RPG call statements
+2. **RPG compile** -- compiles the resulting RPG source
+
+The log contains output from both phases. When debugging:
+
+- **SQL errors** appear in the first phase. Look for `SQL` message IDs.
+- **RPG errors** appear in the second phase. Look for `RNF`/`RNS` message IDs.
+- If the SQL precompile fails, the RPG compile does not run.
+
+### SQL precompile messages
+
+```
+SQL0104   30   Position 45  Token "SELEC" was not valid. Valid tokens: ...
+SQL0204   20   Table "MYLIB/NOTABLE" not found.
+```
+
+The position or line number tells you where in the embedded SQL the error occurred.
+
+## CL listings (.clle, .clp, .cl)
+
+CL compile errors appear as `CPD` or `CPF` messages:
+
+```
+CPD0727   30   The character value specified is not a valid name.
+CPF0001   40   Error found on CALL command.
+```
+
+For ILE CL (`CRTBNDCL`, `CRTCLMOD`), the listing structure is similar to RPG -- source listing followed by a message summary.
+
+For OPM CL (`CRTCLPGM`), the output is typically shorter and errors reference source sequence numbers.
+
+## DDS listings (.dspf, .pf, .lf, .prtf)
+
+DDS compilation errors from `CRTDSPF`, `CRTPF`, `CRTLF`, or `CRTPRTF` produce `CPD` messages:
+
+```
+CPD7302   30   Record format SCREEN1 not found in file referenced.
+CPD7344   30   Keyword REF not valid for this type of file.
+```
+
+DDS errors typically reference a specific record format and line within the source.
+
+## SQL DDL listings (.table.sql, .index.sql, .proc.sql)
+
+SQL DDL statements executed via `RUNSQLSTM` produce SQL messages:
+
+```
+SQL0104   30   Token "CREAT" was not valid.
+SQL0601   20   Table EMPLOYEE in MYLIB already exists.
+SQL7905   10   Module *N in *N not found.
+```
+
+- Severity 30+ means the statement failed.
+- Severity 20 warnings (like "already exists") may or may not be a problem depending on context.
+
+## Message files and binding directories (.msgf, .bnddir)
+
+These execute CL commands from a source file. Errors appear as `CPF` or `CPD` messages from the individual CL commands:
+
+```
+CPF2112   40   Object APPMSG type *MSGF already exists in library MYLIB.
+CPF2105   30   Object MYSRVPGM in MYLIB type *SRVPGM not found.
+```
+
+## Practical example
+
+A build of `mypgm.pgm` fails. Here is how to diagnose it:
+
+```bash
+# 1. Check the log
+cat tmp/logs/mypgm.pgm.log
+
+# 2. Search for high-severity messages
+grep -E 'RNF.{4}\s+[34]0|SQL.{4}\s+[34]0|CPD.{4}\s+[34]0|CPF.{4}\s+[34]0' tmp/logs/mypgm.pgm.log
+```
+
+Example output:
+
+```
+RNF5377   30   42    The type of expression does not match the type expected.
+```
+
+This tells you line 42 of the RPG source has a type mismatch. Open the source file, go to line 42, and fix the expression type.