@untangle-code/cli 0.0.0-stage → 0.1.1

package/dist/commands/init/languages.js

@@ -0,0 +1,245 @@
+/**
+ * The language census: which languages a project is written in, weighted by
+ * lines (WP-125 "Gewichtung nach Zeilen").
+ *
+ * Discovery is `@untangle-code/scanner`'s job and is not re-implemented here:
+ * `discoverFiles` already applies the security tier, the default excludes,
+ * every nested `.gitignore`/`.untangleignore`, the size ceiling, the symlink
+ * sandbox and the binary classifier, and it already reports a language id per
+ * file. What this module adds is the one thing the scanner has no reason to
+ * compute — the LINE count — plus the cross-check against
+ * `@untangle-code/parser-registry`: a language that dominates the line count
+ * but has no adapter is the single most useful thing `init` can tell a user,
+ * because it is the difference between "Untangle understands your code" and
+ * "Untangle can only search its text".
+ */
+import { buildSkipLedgerEntry, compareCodepoints } from "@untangle-code/domain";
+import { discoverFiles, mapConcurrent } from "@untangle-code/scanner";
+import { probeLanguageSupport } from "../../cli/language-support.js";
+/**
+ * Exclusion reasons that are the DESIGNED scope of a scan rather than a
+ * surprise. They are reported as counts (`LanguageCensusV1.excluded`); the
+ * rest additionally earn an individual skip-ledger entry.
+ */
+const ROUTINE_EXCLUSIONS = new Set([
+    "security",
+    "config-exclude",
+    "untangleignore",
+    "gitignore",
+    "default-exclude",
+    "binary",
+]);
+/**
+ * Maps a scanner exclusion reason onto the closed `SkipReason` set of
+ * `@untangle-code/domain`. The domain set has no "I/O error" member, so an
+ * unreadable path is filed as `provider_unavailable` (the file system IS the
+ * provider at this stage) and marked recoverable; a symlink that cycles or
+ * escapes the workspace is a failed resolution.
+ */
+function skipReasonOf(reason) {
+    switch (reason) {
+        case "size-limit":
+            return "file_too_large";
+        case "binary":
+            return "binary_content";
+        case "symlink-cycle":
+        case "symlink-escape":
+            return "resolution_failed";
+        case "unreadable":
+            return "provider_unavailable";
+        default:
+            return "excluded_by_configuration";
+    }
+}
+/**
+ * Counts lines the way a line-oriented tool does: the number of newline
+ * characters, plus one when the last line is unterminated. Empty content has
+ * zero lines. `\r\n` counts once, because the `\n` is what is counted.
+ */
+export function countLines(text) {
+    if (text.length === 0) {
+        return 0;
+    }
+    let newlines = 0;
+    for (let index = 0; index < text.length; index += 1) {
+        if (text.charCodeAt(index) === 0x0a) {
+            newlines += 1;
+        }
+    }
+    return text.endsWith("\n") ? newlines : newlines + 1;
+}
+/** Rounds a ratio to four decimals so the value is stable across runs. */
+export function roundShare(value) {
+    if (!Number.isFinite(value)) {
+        return 0;
+    }
+    return Math.round(value * 10_000) / 10_000;
+}
+/**
+ * Sorting rule of the census: most lines first, ties broken by language id
+ * codepoints. Descending on a number and ascending on codepoints — never
+ * `localeCompare`, so the order is the same on every machine.
+ */
+export function compareCensusEntries(a, b) {
+    if (a.lineCount !== b.lineCount) {
+        return b.lineCount - a.lineCount;
+    }
+    return compareCodepoints(a.languageId, b.languageId);
+}
+export async function buildLanguageCensus(input) {
+    const { fs, parserRegistry, repoRoot, limits, onSkipEntry, signal } = input;
+    const byLanguage = new Map();
+    const exclusionCounts = new Map();
+    let totalFiles = 0;
+    let totalLines = 0;
+    let truncated = false;
+    const selfManaged = new Set(input.selfManagedPaths);
+    const onSkip = (skip) => {
+        if (selfManaged.has(skip.relativePath)) {
+            return;
+        }
+        exclusionCounts.set(skip.reason, (exclusionCounts.get(skip.reason) ?? 0) + 1);
+        if (ROUTINE_EXCLUSIONS.has(skip.reason)) {
+            return;
+        }
+        onSkipEntry(buildSkipLedgerEntry({
+            stage: "scan",
+            subjectKind: "file",
+            path: skip.relativePath,
+            reason: skipReasonOf(skip.reason),
+            detail: skip.detail ?? `scanner reason: ${skip.reason}`,
+            recoverable: skip.reason === "unreadable",
+        }));
+    };
+    const discovered = discoverFiles({
+        fs,
+        roots: [repoRoot],
+        repoRoot,
+        maxFileSizeBytes: limits.maxFileSizeBytes,
+        concurrency: limits.concurrency,
+        onSkip,
+        ignore: {
+            additionalDefaultExcludes: [...input.additionalExcludes, ...input.selfManagedPaths],
+        },
+        ...(signal === undefined ? {} : { signal }),
+    });
+    /**
+     * The scanner has already read every accepted file once (to hash it), but
+     * `FileSystemPort` exposes no way to hand that buffer on, so the line count
+     * costs a second read. Bounded parallelism keeps that from turning a large
+     * repository into a serial walk; a file that cannot be re-read lands in the
+     * ledger instead of quietly counting as zero lines.
+     */
+    const counted = mapConcurrent(limitFiles(discovered, limits.maxFilesScanned, () => {
+        truncated = true;
+    }), limits.concurrency, async (file) => {
+        try {
+            const text = await fs.readTextFile(file.absolutePath, signal === undefined ? {} : { signal });
+            return { file, lines: countLines(text) };
+        }
+        catch {
+            return { file, lines: null };
+        }
+    }, signal);
+    for await (const { file, lines } of counted) {
+        input.onDiscoveredFile?.(file);
+        if (lines === null) {
+            onSkipEntry(buildSkipLedgerEntry({
+                stage: "scan",
+                subjectKind: "file",
+                path: file.relativePath,
+                reason: "provider_unavailable",
+                detail: "The file was discovered but became unreadable before line counting.",
+                recoverable: true,
+            }));
+            continue;
+        }
+        totalFiles += 1;
+        totalLines += lines;
+        const accumulator = byLanguage.get(file.languageId) ?? {
+            fileCount: 0,
+            lineCount: 0,
+            byteCount: 0,
+            // WP-240: EIN Pfad je Sprache, damit die Adapterfrage auch fuer die
+            // Sprachen beantwortbar bleibt, deren Scanner-ID keine Adapter-ID ist.
+            // Der Scanner meldet "yaml", "json" und "toml"; die Registry fuehrt sie
+            // alle drei als "structured-text". `getAdapterByLanguage("yaml")` gab
+            // deshalb null zurueck, und `init` meldete "kein Parser — nur
+            // Textsuche" ueber ein Format, das sehr wohl einen Adapter hat.
+            samplePath: file.relativePath,
+        };
+        accumulator.fileCount += 1;
+        accumulator.lineCount += lines;
+        accumulator.byteCount += file.sizeBytes;
+        byLanguage.set(file.languageId, accumulator);
+    }
+    if (truncated) {
+        onSkipEntry(buildSkipLedgerEntry({
+            stage: "scan",
+            subjectKind: "file",
+            reason: "excluded_by_configuration",
+            detail: `Language counting stopped after ${String(limits.maxFilesScanned)} files (maxFilesScanned); proportions describe only those files.`,
+            recoverable: true,
+        }));
+    }
+    const entries = [];
+    let parsedLines = 0;
+    for (const [languageId, accumulator] of byLanguage) {
+        const adapter = parserRegistry.getAdapterByLanguage(languageId) ??
+            parserRegistry.getAdapterForPath(accumulator.samplePath);
+        if (adapter !== null) {
+            parsedLines += accumulator.lineCount;
+        }
+        // WP-240: NICHT `adapter.supportLevel`. Das ist die Konstante aus der
+        // Sprachtabelle und sagt nichts darueber, ob die Grammatik auf dieser
+        // Maschine geladen werden kann. `probeLanguageSupport` misst es (die
+        // Begruendung steht in `cli/language-support.ts`) — und eine Sprache
+        // ohne Grammatik erscheint hier mit Stufe "text" und einem Grund, statt
+        // mit einem "deep", das der erste Indexlauf widerlegt.
+        const support = adapter === null ? null : probeLanguageSupport(parserRegistry, adapter.languageId);
+        entries.push({
+            languageId,
+            fileCount: accumulator.fileCount,
+            lineCount: accumulator.lineCount,
+            byteCount: accumulator.byteCount,
+            lineShare: roundShare(totalLines === 0 ? 0 : accumulator.lineCount / totalLines),
+            hasParserAdapter: adapter !== null,
+            ...(support === null
+                ? {}
+                : {
+                    supportLevel: support.effectiveSupportLevel,
+                    ...(support.available
+                        ? {}
+                        : {
+                            declaredSupportLevel: support.declaredSupportLevel,
+                            grammarUnavailableReason: support.reason ?? "no details",
+                        }),
+                }),
+        });
+    }
+    entries.sort(compareCensusEntries);
+    const excluded = [...exclusionCounts.entries()]
+        .map(([reason, count]) => ({ reason, count }))
+        .sort((a, b) => compareCodepoints(a.reason, b.reason));
+    return {
+        entries,
+        totalFiles,
+        totalLines,
+        parsedLineShare: roundShare(totalLines === 0 ? 0 : parsedLines / totalLines),
+        truncated,
+        excluded,
+    };
+}
+/** Yields at most `max` items, invoking `onTruncate` the first time it stops early. */
+async function* limitFiles(source, max, onTruncate) {
+    let seen = 0;
+    for await (const item of source) {
+        if (seen >= max) {
+            onTruncate();
+            return;
+        }
+        seen += 1;
+        yield item;
+    }
+}
+//# sourceMappingURL=languages.js.map

package/dist/commands/init/languages.js.map

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

package/dist/commands/init/product-context.d.ts

@@ -0,0 +1,63 @@
+import type { FileSystemPort } from "@untangle-code/domain";
+import type { ScannedFileV1 } from "@untangle-code/scanner";
+export type ProductContextRoleV1 = "vision" | "specification" | "product";
+export type ProductContextSourceStatusV1 = "readable" | "empty" | "unreadable" | "changed" | "not_in_scan" | "not_assessed";
+export interface ProductContextSourceV1 {
+    role: ProductContextRoleV1;
+    /** Repository-relative path, including a visible escape for rejected explicit paths. */
+    path: string;
+    /** Hash of the exact bytes read; absent when no content was read. */
+    contentHash?: string;
+    /** Accepted scanner hash, retained separately when the subsequent read differs. */
+    scannedContentHash?: string;
+    status: ProductContextSourceStatusV1;
+    selected: boolean;
+    selection: "explicit" | "filename_candidate";
+    sections: {
+        title: string;
+        startLine: number;
+        endLine: number;
+    }[];
+}
+export interface ProductContextReferenceV1 {
+    sourcePath: string;
+    sourceLine: number;
+    targetPath: string;
+    status: "present" | "missing" | "not_in_scan" | "outside_workspace";
+    /** Hash from the accepted scan, never a claim of semantic implementation. */
+    targetContentHash?: string;
+}
+export interface ProductContextAssessmentV1 {
+    schemaVersion: 1;
+    status: "needs_context" | "needs_selection" | "ready_for_review" | "incomplete";
+    sources: ProductContextSourceV1[];
+    missingRoles: ProductContextRoleV1[];
+    ambiguousRoles: ProductContextRoleV1[];
+    references: ProductContextReferenceV1[];
+    referencesTruncated: boolean;
+    alignment: {
+        status: "unverified";
+        reason: "feature_and_ownership_not_confirmed";
+    };
+    reviewDraft: {
+        features: [];
+        ownership: [];
+        questions: string[];
+    };
+    limitations: string[];
+}
+export interface AssessProductContextInputV1 {
+    fs: FileSystemPort;
+    root: string;
+    /** Files already accepted by the same bounded, ignore-aware scanner pass. */
+    files: readonly ScannedFileV1[];
+    inventoryTruncated: boolean;
+    visionPath?: string;
+    specPath?: string;
+    signal?: AbortSignal;
+    /** Number of distinct documents to read, from zero to the hard ceiling of 32. */
+    maxDocuments?: number;
+}
+/** Discover and bind product documents; neither filenames nor links prove conformance. */
+export declare function assessProductContext(input: AssessProductContextInputV1): Promise<ProductContextAssessmentV1>;
+//# sourceMappingURL=product-context.d.ts.map

package/dist/commands/init/product-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-context.d.ts","sourceRoot":"","sources":["../../../src/commands/init/product-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,eAAe,GAAG,SAAS,CAAC;AAC1E,MAAM,MAAM,4BAA4B,GACtC,UAAU,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,cAAc,CAAC;AAEnF,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,4BAA4B,CAAC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,UAAU,GAAG,oBAAoB,CAAC;IAC7C,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnE;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,mBAAmB,CAAC;IACpE,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,eAAe,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,YAAY,CAAC;IAChF,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,cAAc,EAAE,oBAAoB,EAAE,CAAC;IACvC,UAAU,EAAE,yBAAyB,EAAE,CAAC;IACxC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,qCAAqC,CAAA;KAAE,CAAC;IACnF,WAAW,EAAE;QAAE,QAAQ,EAAE,EAAE,CAAC;QAAC,SAAS,EAAE,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAClE,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,cAAc,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAyBD,0FAA0F;AAC1F,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,0BAA0B,CAAC,CA0CrC"}