arc-1 0.6.9 → 0.7.0

package/dist/probe/format.js

@@ -0,0 +1,114 @@
+/**
+ * Human-readable formatters for probe reports.
+ *
+ * Kept separate from the runner so the runner stays pure and JSON-serializable,
+ * and so the CLI can opt between `--format table` and `--format json`.
+ */
+const VERDICT_LABEL = {
+    'available-high': 'AVAILABLE (high)',
+    'available-medium': 'AVAILABLE (medium)',
+    'unavailable-high': 'UNAVAILABLE (high)',
+    'unavailable-likely': 'UNAVAILABLE (likely)',
+    'auth-blocked': 'AUTH BLOCKED',
+    ambiguous: 'AMBIGUOUS',
+};
+const DISCOVERY_SHORT = { discovered: 'Y', 'not-discovered': 'N', 'no-discovery-map': '-' };
+function signalShortForKnown(k) {
+    switch (k.kind) {
+        case 'ok':
+            return `OK(${k.objectName})`;
+        case 'all-missing':
+            return `404×${k.attempted.length}`;
+        case 'auth-blocked':
+            return '401/403';
+        case 'error':
+            return 'ERR';
+        case 'not-tested':
+            return '—';
+    }
+}
+function signalShortForRelease(r) {
+    switch (r.kind) {
+        case 'ok':
+            return `${r.detected}>=${r.floor || '?'}`;
+        case 'below-floor':
+            return `${r.detected}<${r.floor}`;
+        case 'unknown':
+            return '?';
+    }
+}
+function padRight(s, n) {
+    return s.length >= n ? s : s + ' '.repeat(n - s.length);
+}
+/** Render the full report as a plain-text block (for terminal output). */
+export function formatTable(report) {
+    const lines = [];
+    lines.push(`SAP system:       ${report.system.baseUrl}`);
+    lines.push(`SAP_BASIS:        ${report.system.abapRelease ?? '(unknown)'}`);
+    lines.push(`System type:      ${report.system.systemType ?? 'unknown'}`);
+    lines.push(`SAP client:       ${report.system.client ?? '(default)'}`);
+    lines.push(`Discovery size:   ${report.system.discoveryMapSize} collections`);
+    lines.push(`Probed at:        ${report.system.probedAt}`);
+    if (report.system.products && report.system.products.length > 0) {
+        // Surface the product-line markers that matter for "which SAP is this really".
+        const markers = ['SAP_BASIS', 'SAP_ABA', 'S4FND', 'S4CORE', 'SAP_CLOUD', 'SAP_UI'];
+        const shown = report.system.products.filter((p) => markers.includes(p.name.toUpperCase()));
+        if (shown.length > 0) {
+            const joined = shown.map((p) => `${p.name} ${p.release}${p.spLevel ? ` SP${p.spLevel}` : ''}`).join(', ');
+            lines.push(`Key components:   ${joined}`);
+        }
+    }
+    lines.push('');
+    const header = [
+        padRight('TYPE', 6),
+        padRight('VERDICT', 21),
+        padRight('DISCO', 5),
+        padRight('COLLECTION', 22),
+        padRight('KNOWN', 14),
+        padRight('RELEASE', 11),
+        'REASON',
+    ].join(' ');
+    lines.push(header);
+    lines.push('-'.repeat(header.length));
+    for (const r of report.results) {
+        const statusFragment = r.signals.collection.statusCode
+            ? `${r.signals.collection.classification} ${r.signals.collection.statusCode}`
+            : r.signals.collection.classification;
+        lines.push([
+            padRight(r.type, 6),
+            padRight(VERDICT_LABEL[r.verdict], 21),
+            padRight(DISCOVERY_SHORT[r.signals.discovery], 5),
+            padRight(statusFragment, 22),
+            padRight(signalShortForKnown(r.signals.knownObject), 14),
+            padRight(signalShortForRelease(r.signals.release), 11),
+            r.reason,
+        ].join(' '));
+    }
+    lines.push('');
+    lines.push('Quality metrics');
+    lines.push('---------------');
+    const q = report.quality;
+    const pct = (n) => `${(n * 100).toFixed(0)}%`;
+    lines.push(`  Coverage — discovery:     ${pct(q.coverage.discovery)}`);
+    lines.push(`  Coverage — collection:    ${pct(q.coverage.collection)}`);
+    lines.push(`  Coverage — known-object:  ${pct(q.coverage.knownObject)}`);
+    lines.push(`  Coverage — release:       ${pct(q.coverage.release)}`);
+    lines.push(`  Discovery vs known-object: ${q.discoveryAccuracyVsKnownObject === null
+        ? 'n/a (no known-object positives)'
+        : pct(q.discoveryAccuracyVsKnownObject)}`);
+    lines.push('');
+    lines.push('  Verdicts:');
+    for (const [k, v] of Object.entries(q.verdictHistogram)) {
+        lines.push(`    ${padRight(k, 20)} ${v}`);
+    }
+    if (q.ambiguousTypes.length > 0) {
+        lines.push('');
+        lines.push(`  Ambiguous (signals disagree — review): ${q.ambiguousTypes.join(', ')}`);
+    }
+    if (q.uncoveredByKnownObject.length > 0) {
+        lines.push('');
+        lines.push(`  No known-object fixture (probe blind spot): ${q.uncoveredByKnownObject.join(', ')}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=format.js.map

package/dist/probe/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/probe/format.ts"],"names":[],"mappings":"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"}

package/dist/probe/quality.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Quality-of-probe metrics.
+ *
+ * The probe's outputs are only as trustworthy as the signals it gathered.
+ * These aggregate metrics tell a reader at a glance:
+ *   - how many types each signal could answer
+ *   - which types were flagged ambiguous (the danger zone)
+ *   - whether the discovery map lines up with the authoritative known-object
+ *     signal on this system (if not, discovery is unreliable here)
+ */
+import type { QualityMetrics, TypeResult } from './types.js';
+export declare function computeQuality(results: TypeResult[]): QualityMetrics;
+//# sourceMappingURL=quality.d.ts.map

package/dist/probe/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/probe/quality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAW,MAAM,YAAY,CAAC;AAWtE,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,cAAc,CAkCpE"}

package/dist/probe/quality.js

@@ -0,0 +1,50 @@
+/**
+ * Quality-of-probe metrics.
+ *
+ * The probe's outputs are only as trustworthy as the signals it gathered.
+ * These aggregate metrics tell a reader at a glance:
+ *   - how many types each signal could answer
+ *   - which types were flagged ambiguous (the danger zone)
+ *   - whether the discovery map lines up with the authoritative known-object
+ *     signal on this system (if not, discovery is unreliable here)
+ */
+import { CATALOG } from './catalog.js';
+const ALL_VERDICTS = [
+    'available-high',
+    'available-medium',
+    'unavailable-high',
+    'unavailable-likely',
+    'auth-blocked',
+    'ambiguous',
+];
+export function computeQuality(results) {
+    const total = results.length || 1; // avoid div-by-zero on empty catalog
+    const discoveryDefinitive = results.filter((r) => r.signals.discovery !== 'no-discovery-map').length;
+    const collectionDefinitive = results.filter((r) => r.signals.collection.classification !== 'network-error').length;
+    const knownObjectTested = results.filter((r) => r.signals.knownObject.kind !== 'not-tested').length;
+    const releaseKnown = results.filter((r) => r.signals.release.kind !== 'unknown').length;
+    // discoveryAccuracyVsKnownObject: of types where known-object confirmed
+    // availability, how many did discovery also list?
+    const knownOk = results.filter((r) => r.signals.knownObject.kind === 'ok');
+    const discoveryAccuracyVsKnownObject = knownOk.length === 0 ? null : knownOk.filter((r) => r.signals.discovery === 'discovered').length / knownOk.length;
+    const verdictHistogram = {};
+    for (const v of ALL_VERDICTS)
+        verdictHistogram[v] = 0;
+    for (const r of results)
+        verdictHistogram[r.verdict] += 1;
+    const ambiguousTypes = results.filter((r) => r.verdict === 'ambiguous').map((r) => r.type);
+    const uncoveredByKnownObject = CATALOG.filter((e) => (e.knownObjects?.length ?? 0) === 0).map((e) => e.type);
+    return {
+        coverage: {
+            discovery: discoveryDefinitive / total,
+            collection: collectionDefinitive / total,
+            knownObject: knownObjectTested / total,
+            release: releaseKnown / total,
+        },
+        discoveryAccuracyVsKnownObject,
+        verdictHistogram,
+        ambiguousTypes,
+        uncoveredByKnownObject,
+    };
+}
+//# sourceMappingURL=quality.js.map

package/dist/probe/quality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.js","sourceRoot":"","sources":["../../src/probe/quality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,MAAM,YAAY,GAAc;IAC9B,gBAAgB;IAChB,kBAAkB;IAClB,kBAAkB;IAClB,oBAAoB;IACpB,cAAc;IACd,WAAW;CACZ,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,qCAAqC;IAExE,MAAM,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,KAAK,kBAAkB,CAAC,CAAC,MAAM,CAAC;IACrG,MAAM,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,KAAK,eAAe,CAAC,CAAC,MAAM,CAAC;IACnH,MAAM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,MAAM,CAAC;IACpG,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAExF,wEAAwE;IACxE,kDAAkD;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC3E,MAAM,8BAA8B,GAClC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAEpH,MAAM,gBAAgB,GAAG,EAA6B,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,YAAY;QAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtD,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE3F,MAAM,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE7G,OAAO;QACL,QAAQ,EAAE;YACR,SAAS,EAAE,mBAAmB,GAAG,KAAK;YACtC,UAAU,EAAE,oBAAoB,GAAG,KAAK;YACxC,WAAW,EAAE,iBAAiB,GAAG,KAAK;YACtC,OAAO,EAAE,YAAY,GAAG,KAAK;SAC9B;QACD,8BAA8B;QAC9B,gBAAgB;QAChB,cAAc;QACd,sBAAsB;KACvB,CAAC;AACJ,CAAC"}

package/dist/probe/runner.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Probe runner — classifies each ADT type against four independent signals:
+ *
+ *   1. Discovery map presence (free; from the already-fetched /discovery doc)
+ *   2. Collection-URL GET (tolerates 400/403/405 as "endpoint exists" — the
+ *      #94/#95 lesson: only 404 is a hard negative)
+ *   3. Known-object GET on an SAP-shipped fixture (authoritative when available)
+ *   4. SAP_BASIS release vs. a hand-curated floor (weak tie-breaker only)
+ *
+ * The runner is deliberately pure: it takes a simple `HttpProbeFn` that never
+ * throws and returns a neutral shape. This makes it trivially testable by
+ * replaying recorded SAP responses from fixtures.
+ */
+import type { CatalogEntry, DiscoverySignal, HttpClassification, HttpProbe, KnownObjectOutcome, TypeResult, TypeSignals, Verdict } from './types.js';
+/** Neutral HTTP-result shape the runner consumes. Never throws. */
+export interface ProbeFetchResult {
+    statusCode?: number;
+    body?: string;
+    /** True when no HTTP response was obtained at all (connection refused, DNS, TLS). */
+    networkError?: boolean;
+    errorMessage?: string;
+    durationMs: number;
+}
+/** Function the runner calls to probe one URL. Implementations must not throw. */
+export type HttpProbeFn = (url: string, method: 'GET' | 'HEAD') => Promise<ProbeFetchResult>;
+/** Parse SAP_BASIS release string like "750", "7.57", "sap_btp" to a number, or null. */
+export declare function parseRelease(release: string | undefined): number | null;
+/** Classify an HTTP response code into a discrete bucket. */
+export declare function classifyHttp(result: ProbeFetchResult): HttpClassification;
+/** Run the collection-URL probe. Normalized, never throws. */
+export declare function probeCollection(fetchFn: HttpProbeFn, collectionUrl: string): Promise<HttpProbe>;
+/**
+ * Try each known object in order and classify the outcome.
+ * We stop at the first 2xx; if all fail, we aggregate the attempted list.
+ */
+export declare function probeKnownObject(fetchFn: HttpProbeFn, entry: CatalogEntry): Promise<KnownObjectOutcome>;
+/** Classify the release signal. */
+export declare function classifyRelease(detectedRelease: string | undefined, floor: number | undefined): TypeSignals['release'];
+/** Collapse the four signals into a final verdict + one-line reason. */
+export declare function classifyVerdict(signals: TypeSignals): {
+    verdict: Verdict;
+    reason: string;
+};
+/** Compute a discovery-map lookup for a collection URL. */
+export declare function resolveDiscovery(discoveryMap: Map<string, string[]> | undefined, collectionUrl: string): DiscoverySignal;
+/** Probe one catalog entry end-to-end. */
+export declare function probeType(fetchFn: HttpProbeFn, entry: CatalogEntry, discoveryMap: Map<string, string[]> | undefined, detectedRelease: string | undefined): Promise<TypeResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/probe/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/probe/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,OAAO,EACR,MAAM,YAAY,CAAC;AAEpB,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,kFAAkF;AAClF,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE7F,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAMvE;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAWzE;AASD,8DAA8D;AAC9D,wBAAsB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAUrG;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6B7G;AAED,mCAAmC;AACnC,wBAAgB,eAAe,CAC7B,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,WAAW,CAAC,SAAS,CAAC,CAMxB;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAkF1F;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,EAC/C,aAAa,EAAE,MAAM,GACpB,eAAe,CAKjB;AAED,0CAA0C;AAC1C,wBAAsB,SAAS,CAC7B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,EAC/C,eAAe,EAAE,MAAM,GAAG,SAAS,GAClC,OAAO,CAAC,UAAU,CAAC,CAarB"}

package/dist/probe/runner.js

@@ -0,0 +1,211 @@
+/**
+ * Probe runner — classifies each ADT type against four independent signals:
+ *
+ *   1. Discovery map presence (free; from the already-fetched /discovery doc)
+ *   2. Collection-URL GET (tolerates 400/403/405 as "endpoint exists" — the
+ *      #94/#95 lesson: only 404 is a hard negative)
+ *   3. Known-object GET on an SAP-shipped fixture (authoritative when available)
+ *   4. SAP_BASIS release vs. a hand-curated floor (weak tie-breaker only)
+ *
+ * The runner is deliberately pure: it takes a simple `HttpProbeFn` that never
+ * throws and returns a neutral shape. This makes it trivially testable by
+ * replaying recorded SAP responses from fixtures.
+ */
+import { buildObjectUrl } from './catalog.js';
+/** Parse SAP_BASIS release string like "750", "7.57", "sap_btp" to a number, or null. */
+export function parseRelease(release) {
+    if (!release)
+        return null;
+    const digits = release.replace(/\D/g, '');
+    if (!digits)
+        return null;
+    const n = Number.parseInt(digits, 10);
+    return Number.isFinite(n) && n > 0 ? n : null;
+}
+/** Classify an HTTP response code into a discrete bucket. */
+export function classifyHttp(result) {
+    if (result.networkError)
+        return 'network-error';
+    const s = result.statusCode;
+    if (s === undefined)
+        return 'network-error';
+    if (s >= 200 && s < 300)
+        return 'ok-2xx';
+    if (s === 400)
+        return 'ok-400-bad-params';
+    if (s === 401 || s === 403)
+        return 'auth-blocked';
+    if (s === 404)
+        return 'not-found';
+    if (s === 405)
+        return 'ok-405-method';
+    if (s >= 500 && s < 600)
+        return 'server-error';
+    return 'other-error';
+}
+/** Truncate an HTTP body for inclusion in reports; strips whitespace. */
+function snippet(body) {
+    if (!body)
+        return undefined;
+    const trimmed = body.replace(/\s+/g, ' ').trim();
+    return trimmed.length > 200 ? `${trimmed.slice(0, 200)}…` : trimmed;
+}
+/** Run the collection-URL probe. Normalized, never throws. */
+export async function probeCollection(fetchFn, collectionUrl) {
+    const res = await fetchFn(collectionUrl, 'GET');
+    return {
+        url: collectionUrl,
+        classification: classifyHttp(res),
+        statusCode: res.statusCode,
+        errorMessage: res.errorMessage,
+        bodySnippet: snippet(res.body),
+        durationMs: res.durationMs,
+    };
+}
+/**
+ * Try each known object in order and classify the outcome.
+ * We stop at the first 2xx; if all fail, we aggregate the attempted list.
+ */
+export async function probeKnownObject(fetchFn, entry) {
+    const list = entry.knownObjects ?? [];
+    if (list.length === 0 || !entry.objectUrlTemplate)
+        return { kind: 'not-tested' };
+    const attempted = [];
+    let sawAuthBlock = false;
+    let lastError;
+    for (const name of list) {
+        attempted.push(name);
+        const url = buildObjectUrl(entry.objectUrlTemplate, name);
+        const res = await fetchFn(url, 'GET');
+        const klass = classifyHttp(res);
+        if (klass === 'ok-2xx') {
+            return { kind: 'ok', objectName: name, statusCode: res.statusCode ?? 200 };
+        }
+        if (klass === 'auth-blocked')
+            sawAuthBlock = true;
+        if (klass === 'network-error') {
+            lastError = res.errorMessage ?? 'network error';
+        }
+        if (klass === 'server-error' || klass === 'other-error') {
+            lastError = `HTTP ${res.statusCode}`;
+        }
+        // 404 is expected for objects that don't exist on this system — keep trying.
+    }
+    if (lastError)
+        return { kind: 'error', attempted, message: lastError };
+    if (sawAuthBlock)
+        return { kind: 'auth-blocked', attempted };
+    return { kind: 'all-missing', attempted };
+}
+/** Classify the release signal. */
+export function classifyRelease(detectedRelease, floor) {
+    const detected = parseRelease(detectedRelease);
+    if (detected === null)
+        return { kind: 'unknown', floor };
+    if (floor === undefined)
+        return { kind: 'ok', detected: detectedRelease ?? '', floor: 0 };
+    if (detected < floor)
+        return { kind: 'below-floor', detected: detectedRelease ?? '', floor };
+    return { kind: 'ok', detected: detectedRelease ?? '', floor };
+}
+/** Collapse the four signals into a final verdict + one-line reason. */
+export function classifyVerdict(signals) {
+    const { discovery, collection, knownObject, release } = signals;
+    // Rule 1 — known-object is authoritative.
+    if (knownObject.kind === 'ok') {
+        const discoHint = discovery === 'discovered'
+            ? 'discovery confirms'
+            : discovery === 'not-discovered'
+                ? 'but discovery map did NOT list the collection (discovery incomplete?)'
+                : 'no discovery map available';
+        return {
+            verdict: 'available-high',
+            reason: `known-object read of "${knownObject.objectName}" returned 200; ${discoHint}`,
+        };
+    }
+    // Rule 2 — unanimous auth blocking.
+    if (collection.classification === 'auth-blocked' && knownObject.kind === 'auth-blocked') {
+        return {
+            verdict: 'auth-blocked',
+            reason: `collection and known-object both returned 401/403 — endpoint exists, probe user lacks rights`,
+        };
+    }
+    // Rule 3 — collection 404 paths (the real "not available" signal).
+    if (collection.classification === 'not-found') {
+        if (discovery === 'discovered') {
+            return {
+                verdict: 'ambiguous',
+                reason: `discovery lists this collection but GET returned 404 — endpoint registered but inactive?`,
+            };
+        }
+        const discoNegative = discovery === 'not-discovered';
+        const knownNegative = knownObject.kind === 'all-missing' || knownObject.kind === 'not-tested';
+        const releaseNegative = release.kind === 'below-floor';
+        if (discoNegative && knownNegative && releaseNegative) {
+            return {
+                verdict: 'unavailable-high',
+                reason: `discovery miss + collection 404 + release ${release.detected}<${release.floor} — high confidence`,
+            };
+        }
+        return {
+            verdict: 'unavailable-likely',
+            reason: `collection returned 404${discoNegative ? ' and not in discovery map' : ''}`,
+        };
+    }
+    // Rule 4 — collection responded in a way that suggests the endpoint exists.
+    const okBuckets = ['ok-2xx', 'ok-400-bad-params', 'ok-405-method'];
+    if (okBuckets.includes(collection.classification)) {
+        if (knownObject.kind === 'all-missing') {
+            return {
+                verdict: discovery === 'discovered' ? 'available-high' : 'available-medium',
+                reason: `collection HTTP ${collection.statusCode}; known-object candidates not present on this system`,
+            };
+        }
+        if (discovery === 'discovered') {
+            return {
+                verdict: 'available-high',
+                reason: `discovered + collection HTTP ${collection.statusCode}`,
+            };
+        }
+        return {
+            verdict: 'available-medium',
+            reason: `collection HTTP ${collection.statusCode} but not in discovery map`,
+        };
+    }
+    // Rule 5 — auth-blocked with weaker corroboration.
+    if (collection.classification === 'auth-blocked') {
+        return {
+            verdict: 'auth-blocked',
+            reason: `collection returned 401/403 — endpoint likely exists but probe user lacks rights`,
+        };
+    }
+    // Rule 6 — anything else (5xx, network errors, unexpected codes).
+    return {
+        verdict: 'ambiguous',
+        reason: `collection returned ${collection.classification}${collection.statusCode ? ` (${collection.statusCode})` : ''}; cannot decide`,
+    };
+}
+/** Compute a discovery-map lookup for a collection URL. */
+export function resolveDiscovery(discoveryMap, collectionUrl) {
+    if (!discoveryMap || discoveryMap.size === 0)
+        return 'no-discovery-map';
+    // Discovery keys are normalized with no trailing slash; catalog URLs follow the same convention.
+    const normalized = collectionUrl.endsWith('/') ? collectionUrl.slice(0, -1) : collectionUrl;
+    return discoveryMap.has(normalized) ? 'discovered' : 'not-discovered';
+}
+/** Probe one catalog entry end-to-end. */
+export async function probeType(fetchFn, entry, discoveryMap, detectedRelease) {
+    const [collection, knownObject] = await Promise.all([
+        probeCollection(fetchFn, entry.collectionUrl),
+        probeKnownObject(fetchFn, entry),
+    ]);
+    const signals = {
+        discovery: resolveDiscovery(discoveryMap, entry.collectionUrl),
+        collection,
+        knownObject,
+        release: classifyRelease(detectedRelease, entry.minRelease),
+    };
+    const { verdict, reason } = classifyVerdict(signals);
+    return { type: entry.type, signals, verdict, reason };
+}
+//# sourceMappingURL=runner.js.map

package/dist/probe/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/probe/runner.ts"],"names":[],"mappings":"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"}

package/dist/probe/types.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Types for the ADT type-availability probe.
+ *
+ * The probe is pure diagnostic tooling — it does not change product behavior.
+ * It collects multiple independent signals per ADT object type and reports
+ * both the per-type verdict AND the quality-of-probe metrics, so anyone
+ * running it against their own system can see not just "is TABL supported"
+ * but "how confident should we be in that answer".
+ */
+/** SAPREAD/SAPWrite type code (TABL, BDEF, DDLS, …). */
+export type TypeCode = string;
+/** A catalog entry for one ADT object type. */
+export interface CatalogEntry {
+    /** 4-letter type code used in SAPRead/SAPWrite. */
+    type: TypeCode;
+    /** Canonical collection URL (e.g. "/sap/bc/adt/ddic/tables"). */
+    collectionUrl: string;
+    /**
+     * Object-level URL template, where `{name}` is the encoded object name.
+     * Used for the known-object probe. If absent, that signal is NOT_TESTED.
+     */
+    objectUrlTemplate?: string;
+    /**
+     * SAP-shipped objects that should exist on (almost) every system for this type.
+     * The probe tries each until one returns 200 (or it exhausts the list).
+     * Leave empty for types where no widely-shipped object exists (BDEF, SRVD, …).
+     */
+    knownObjects?: string[];
+    /**
+     * Minimum SAP_BASIS release where this type's endpoint is expected to exist.
+     * Used only as a weak signal; release strings vary (BTP reports differently).
+     * Encoded as the 3-digit release number (750, 752, 757, …).
+     */
+    minRelease?: number;
+    /** Freeform note shown in the report (e.g. "RAP BDEF — needs SAP_BASIS >= 7.57"). */
+    note?: string;
+}
+/** Result of the discovery-map lookup for a single type. */
+export type DiscoverySignal = 'discovered' | 'not-discovered' | 'no-discovery-map';
+/** Status classification for a single HTTP probe. */
+export type HttpClassification = 'ok-2xx' | 'ok-400-bad-params' | 'ok-405-method' | 'auth-blocked' | 'not-found' | 'server-error' | 'other-error' | 'network-error';
+/** Single HTTP probe result. */
+export interface HttpProbe {
+    url: string;
+    classification: HttpClassification;
+    statusCode?: number;
+    /** Raw error message if the call threw without an HTTP response. */
+    errorMessage?: string;
+    /** First ~200 chars of the response body, for human review. */
+    bodySnippet?: string;
+    durationMs: number;
+}
+/** Outcome of the known-object probe. */
+export type KnownObjectOutcome = {
+    kind: 'ok';
+    objectName: string;
+    statusCode: number;
+} | {
+    kind: 'all-missing';
+    attempted: string[];
+} | {
+    kind: 'auth-blocked';
+    attempted: string[];
+} | {
+    kind: 'error';
+    attempted: string[];
+    message: string;
+} | {
+    kind: 'not-tested';
+};
+/** Four independent signals combined per type. */
+export interface TypeSignals {
+    discovery: DiscoverySignal;
+    collection: HttpProbe;
+    knownObject: KnownObjectOutcome;
+    release: {
+        kind: 'ok';
+        detected: string;
+        floor: number;
+    } | {
+        kind: 'below-floor';
+        detected: string;
+        floor: number;
+    } | {
+        kind: 'unknown';
+        floor?: number;
+    };
+}
+/** Final verdict the probe reports for a type. */
+export type Verdict = 'available-high' | 'available-medium' | 'unavailable-high' | 'unavailable-likely' | 'auth-blocked' | 'ambiguous';
+/** Per-type probe result. */
+export interface TypeResult {
+    type: TypeCode;
+    signals: TypeSignals;
+    verdict: Verdict;
+    /** Human-readable one-liner explaining which signals drove the verdict. */
+    reason: string;
+}
+/**
+ * One installed software component as reported by /sap/bc/adt/system/components.
+ * Captured so future readers of a fixture can tell a plain NW 7.58 apart from
+ * an S/4HANA 2023 — SAP_BASIS alone is not enough signal.
+ */
+export interface InstalledProduct {
+    /** Component id (e.g. "SAP_BASIS", "S4FND"). */
+    name: string;
+    /** Numeric release (e.g. "758", "108"). */
+    release: string;
+    /** Support package level (e.g. "0002"), if reported. */
+    spLevel?: string;
+    /** Human-readable description (e.g. "SAP Basis Component"). */
+    description?: string;
+}
+/** System-level info the probe captures for context. */
+export interface ProbedSystem {
+    baseUrl: string;
+    client?: string;
+    abapRelease?: string;
+    systemType?: 'onprem' | 'btp' | 'unknown';
+    /** Full component list from /sap/bc/adt/system/components when available. */
+    products?: InstalledProduct[];
+    discoveryMapSize: number;
+    probedAt: string;
+}
+/** Aggregated quality metrics across all types — "how good is the probe itself". */
+export interface QualityMetrics {
+    /** Fraction of types for which each signal returned a definitive answer. */
+    coverage: {
+        discovery: number;
+        collection: number;
+        knownObject: number;
+        release: number;
+    };
+    /**
+     * Of the types that tested positive via the authoritative known-object signal,
+     * what fraction were also present in the discovery map?
+     * Low number = the discovery map is unreliable for this release; deweight it.
+     */
+    discoveryAccuracyVsKnownObject: number | null;
+    /** Count of verdicts per bucket. */
+    verdictHistogram: Record<Verdict, number>;
+    /** Types flagged ambiguous — the danger zone where signals disagree. */
+    ambiguousTypes: TypeCode[];
+    /** Types for which no known-object fixture was listed in the catalog (probe blind spot). */
+    uncoveredByKnownObject: TypeCode[];
+}
+/** Full probe report, serializable to JSON for sharing. */
+export interface ProbeReport {
+    /** Metadata so anyone reading the JSON can compare their run against others. */
+    system: ProbedSystem;
+    results: TypeResult[];
+    quality: QualityMetrics;
+    /**
+     * Schema version for the report file. Bump when the shape changes so
+     * replay tests can refuse to load incompatible fixtures.
+     */
+    schemaVersion: 1;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/probe/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/probe/types.ts"],"names":[],"mappings":"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"}