feat(adt): add INCL (PROG/I) write support for WriteSource, EditSource, CLI

[frd1201]

Closes #116

Summary

• New WriteInclude() workflow — full SyntaxCheck → Lock → UpdateSource → Unlock → Activate cycle for ABAP program includes
• WriteSource / EditSource now accept object_type="INCL" (MCP tools and CLI vsp source write/edit)
• vsp source edit INCL — CLI surgical string replacement for includes
• DeployFromFile / ImportFromFile — .incl.abap file extension recognized; object name extracted from filename (includes have no declaration statement)
• Three bug fixes for the shared /includes/ URL segment that caused program includes to be misidentified as class sub-resources:
  • normalizeObjectURLForPackageCheck: was stripping /includes/NAME from program include URLs → SearchObject("PROGRAMS") → "package metadata not found"
  • SyntaxCheck artifactURI: was missing /source/main for program includes → SAP returned wrong content-type
  • EditSourceWithOptions isClassInclude: was missing /source/main in sourceURL → GET/PUT to XML object descriptor endpoint → HTTP 406
• SyntaxCheck moved before Lock in UpdateFromFile — stateless SyntaxCheck between stateful Lock/Write broke the SAP session (HTTP 423 ExceptionResourceInvalidLockHandle)

Test plan

• GetSource(object_type="INCL", name="ZZ_FABD1_DUSH8_CICD2") — read works
• WriteSource(object_type="INCL", name="ZZ_FABD1_DUSH8_CICD2", source="...", mode="upsert") — create and update works
• EditSource(object_url="/sap/bc/adt/programs/includes/ZZ_FABD1_DUSH8_CICD2", old_string="...", new_string="...") — surgical edit works
• vsp source read INCL ZZ_FABD1_DUSH8_CICD2 — CLI read works
• vsp source write INCL ZZ_FABD1_DUSH8_CICD2 < file.abap — CLI write works
• vsp source edit INCL ZZ_FABD1_DUSH8_CICD2 --old "..." --new "..." — CLI edit works
• ImportFromFile(file_path="zz_test.incl.abap") — deploy from file works (Updated PROG/I ZZ_FABD1_DUSH8_CICD2, activated)

[txape10]

Hi! I opened PR #134 (now closed) targeting the same root cause described in #133,
which overlaps with this one on client.go and workflows_edit.go.

Since your fix covers the same ground and does more, I closed mine. The one thing
I'd suggest adding here is a unit test that pins the normalizeObjectURLForPackageCheck
cases explicitly — program includes must not be truncated, class includes must be:

func TestNormalizeObjectURLForPackageCheck(t *testing.T) {
	cases := []struct {
		input string
		want  string
	}{
		// Program includes (INCL) — must not be mangled
		{"/sap/bc/adt/programs/includes/ZTEST_INCL", "/sap/bc/adt/programs/includes/ZTEST_INCL"},
		{"/sap/bc/adt/programs/includes/ZTEST_INCL/source/main", "/sap/bc/adt/programs/includes/ZTEST_INCL"},
		// Regular programs — unchanged
		{"/sap/bc/adt/programs/programs/ZTEST/source/main", "/sap/bc/adt/programs/programs/ZTEST"},
		// Class includes — strip to parent class
		{"/sap/bc/adt/oo/classes/ZCL_FOO/includes/testclasses", "/sap/bc/adt/oo/classes/ZCL_FOO"},
		{"/sap/bc/adt/oo/classes/ZCL_FOO/includes/definitions", "/sap/bc/adt/oo/classes/ZCL_FOO"},
		// Class source — strip /source/main only
		{"/sap/bc/adt/oo/classes/ZCL_FOO/source/main", "/sap/bc/adt/oo/classes/ZCL_FOO"},
	}
	for _, tc := range cases {
		got := normalizeObjectURLForPackageCheck(tc.input)
		if got != tc.want {
			t.Errorf("normalizeObjectURLForPackageCheck(%q)\n  got  %q\n  want %q", tc.input, got, tc.want)
		}
	}
}

Verified on-prem S/4HANA 758: matchCount: 1 reading ZREPORT_PRUEBA_TOP (package ZABAP01)
after the fix; write reaches SAP and returns corrNr not found instead of the pre-flight abort.
Also links to #133 for the on-prem reproduction case.
Also found the same overly-broad /includes/ check in SyntaxCheck() (devtools.go line 42) — program includes need /source/main in artifactURI or SAP can't locate errors. Same one-line fix: require /oo/classes/ alongside /includes/.

[frd1201]

Thanks @txape10 — added TestNormalizeObjectURLForPackageCheck with exactly those cases (program includes stay intact, class includes strip to the parent class). Good catch on SyntaxCheck() too — that /includes/ fix is already part of this PR (devtools.go: isClassInclude now requires /oo/classes/ alongside /includes/, so the artifactURI gets /source/main for program includes). Pushed.