hikoutei 0.10.23-dev → 0.10.25-dev

package/dist/cli/infer.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Pure `hikoutei infer` core: raw grid cells in, descriptor block out.
+ *
+ * The flow is injectable and network-free: the production CLI reads one tab
+ * range through the Sheets API and hands the raw grid here; tests inject a
+ * fake grid. Cell normalization ports the provider's getValues semantics
+ * (formula cells resolve to their computed effective value, the canonical
+ * DATE_TIME number format marks dates, blank stays null) so Sheets-provided
+ * typed cell info wins over heuristics — there are no date-format guesses
+ * beyond the canonical format the provider itself writes.
+ *
+ * Source parity notes: the canonical date pattern is byte-identical to
+ * `GOOGLE_SHEETS_API_DATE_NUMBER_FORMAT` and the serial math matches
+ * `isoFromDateSerial` in the google-sheets-api provider's
+ * `model/valueNormalization.ts`. A local port (not an import) keeps the CLI
+ * runtime dependency-closed: `@hikoutei/sheets` is not a CLI dependency.
+ *
+ * Redaction contract: warnings carry COLUMN NAMES ONLY, never cell values.
+ */
+import { type HikouteiDescriptorFile } from "../sync-engine/api/entity.js";
+/** Machine-readable CLI error prefix, shared with inferMain.ts. */
+export declare const INFER_ERROR_PREFIX = "hikoutei-infer";
+/** Closed set of scalar kinds the inference can emit. */
+export type InferScalarType = "string" | "number" | "boolean" | "date";
+/** One normalized cell: `null` is an empty cell. */
+export type InferCell = null | {
+    readonly kind: "string";
+    readonly value: string;
+} | {
+    readonly kind: "number";
+    readonly value: number;
+} | {
+    readonly kind: "boolean";
+    readonly value: boolean;
+} | {
+    readonly kind: "date";
+    readonly value: string;
+};
+/** Raw tab grid handed to the inference (raw Sheets grid cell objects). */
+export interface InferTabGrid {
+    readonly tabName: string;
+    /** Raw grid cells of the header row (rowData values entries). */
+    readonly headerCells: readonly unknown[];
+    /** Raw grid cells of sampled data rows (rowData values entries per row). */
+    readonly dataCells: readonly (readonly unknown[])[];
+}
+/** Injectable tab sampler; production wraps the Sheets API, tests use fakes. */
+export type InferTabReader = (input: {
+    readonly spreadsheetId: string;
+    readonly tabName: string;
+    readonly limit: number;
+}) => Promise<InferTabGrid>;
+/** One column-name-only inference warning. */
+export interface InferWarning {
+    readonly column: string;
+    readonly reason: string;
+}
+/** One headed column of a successful inference (feeds `--emit`). */
+export interface InferColumn {
+    /** Original sheet header, preserved for adopt's column mapping. */
+    readonly header: string;
+    /** camelCase entity property name derived from the header. */
+    readonly property: string;
+    /** Inferred scalar type (PK-normalized: a boolean/date PK reads string). */
+    readonly type: InferScalarType;
+    /** True for the single primary-key/business-key column. */
+    readonly primary: boolean;
+}
+/** Successful inference: the TS block plus its summary. */
+export interface InferDescriptorResult {
+    readonly entityName: string;
+    readonly tableName: string;
+    readonly tsBlock: string;
+    readonly summary: string;
+    readonly warnings: readonly InferWarning[];
+    readonly sampledRows: number;
+    readonly columnCount: number;
+    readonly distribution: Readonly<Record<InferScalarType, number>>;
+    readonly pkProperty: string;
+    /**
+     * Headed columns in sheet order. `--emit` builds the descriptor file
+     * from these, so the JSON file and the printed block always agree.
+     */
+    readonly columns: readonly InferColumn[];
+}
+/** Coded failure thrown by the pure inference (mapped to stderr + exit 1/2). */
+export declare class InferError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Normalizes one raw grid cell with getValues semantics: formula cells
+ * resolve to their computed effective value, error cells to their display
+ * string, literals keep their typed kind, blank cells become `null`.
+ */
+export declare function normalizeInferCell(cell: unknown): InferCell;
+/**
+ * Infers the entity descriptor block from a raw tab grid.
+ *
+ * Throws `InferError`: `empty_tab` (no header row), `pk_not_found` (the
+ * `--pk` header names no sampled column). Warnings carry column names only.
+ */
+export declare function inferFromGrid(grid: InferTabGrid, options?: {
+    readonly pkHeader?: string;
+}): InferDescriptorResult;
+/**
+ * Builds the versioned descriptor file for an inference result.
+ *
+ * Pure and network-free: `--emit` serializes this file next to the printed
+ * block, and the file's `header` fields later feed `adopt --descriptor`
+ * without manual `--map` flags. Delegates to the contracts builder so the
+ * file envelope has one owner; the scalar core matches the printed block
+ * column-for-column (same `columns` source), so the two never disagree.
+ */
+export declare function inferResultToDescriptorFile(result: InferDescriptorResult): HikouteiDescriptorFile;
+/** Serializes an inference result to the stable descriptor-file JSON text. */
+export declare function serializeInferDescriptorFile(result: InferDescriptorResult): string;
+//# sourceMappingURL=infer.d.ts.map

package/dist/cli/infer.d.ts.map

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

package/dist/cli/infer.js

@@ -0,0 +1,319 @@
+/**
+ * Pure `hikoutei infer` core: raw grid cells in, descriptor block out.
+ *
+ * The flow is injectable and network-free: the production CLI reads one tab
+ * range through the Sheets API and hands the raw grid here; tests inject a
+ * fake grid. Cell normalization ports the provider's getValues semantics
+ * (formula cells resolve to their computed effective value, the canonical
+ * DATE_TIME number format marks dates, blank stays null) so Sheets-provided
+ * typed cell info wins over heuristics — there are no date-format guesses
+ * beyond the canonical format the provider itself writes.
+ *
+ * Source parity notes: the canonical date pattern is byte-identical to
+ * `GOOGLE_SHEETS_API_DATE_NUMBER_FORMAT` and the serial math matches
+ * `isoFromDateSerial` in the google-sheets-api provider's
+ * `model/valueNormalization.ts`. A local port (not an import) keeps the CLI
+ * runtime dependency-closed: `@hikoutei/sheets` is not a CLI dependency.
+ *
+ * Redaction contract: warnings carry COLUMN NAMES ONLY, never cell values.
+ */
+import { buildDescriptorFile, serializeDescriptorFile, } from "../sync-engine/api/entity.js";
+/** Machine-readable CLI error prefix, shared with inferMain.ts. */
+export const INFER_ERROR_PREFIX = "hikoutei-infer";
+/** Coded failure thrown by the pure inference (mapped to stderr + exit 1/2). */
+export class InferError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "InferError";
+        this.code = code;
+    }
+}
+/** Canonical UTC date pattern, byte-identical to the provider's own format. */
+const INFER_CANONICAL_DATE_PATTERN = 'yyyy"-"mm"-"dd"T"hh:mm:ss.000"Z"';
+function normalizedDatePattern(pattern) {
+    return pattern.replace(/["\s]/g, "");
+}
+const NORMALIZED_CANONICAL_DATE_PATTERN = normalizedDatePattern(INFER_CANONICAL_DATE_PATTERN);
+/** True when a REST `CellFormat.numberFormat` object is the canonical date format. */
+function isCanonicalDateFormat(format) {
+    if (format === null || typeof format !== "object" || Array.isArray(format))
+        return false;
+    const record = format;
+    if (record.type !== "DATE_TIME" || typeof record.pattern !== "string")
+        return false;
+    return normalizedDatePattern(record.pattern) === NORMALIZED_CANONICAL_DATE_PATTERN;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function malformedGrid() {
+    return new InferError("malformed_grid", "the sheet grid has an unsupported cell shape");
+}
+/** Prefers the user-entered number format, falls back to the effective one. */
+function cellNumberFormat(cell) {
+    const entered = cell.userEnteredFormat;
+    if (isRecord(entered) && entered.numberFormat !== undefined)
+        return entered.numberFormat;
+    const effective = cell.effectiveFormat;
+    if (isRecord(effective) && effective.numberFormat !== undefined)
+        return effective.numberFormat;
+    return undefined;
+}
+/** Display string of an error cell: formatted value, else the error message. */
+function errorDisplayString(cell, owner) {
+    const formatted = cell.formattedValue;
+    if (typeof formatted === "string" && formatted.length > 0)
+        return formatted;
+    const error = owner.errorValue;
+    if (isRecord(error) && typeof error.message === "string" && error.message.length > 0) {
+        return error.message;
+    }
+    throw malformedGrid();
+}
+/** Normalizes one literal ExtendedValue; `null` is blank. */
+function literalCell(value, format) {
+    if (value.stringValue !== undefined) {
+        if (typeof value.stringValue !== "string")
+            throw malformedGrid();
+        // An explicit empty string is blank (getValues semantics).
+        return value.stringValue.length === 0 ? null : { kind: "string", value: value.stringValue.normalize("NFC") };
+    }
+    if (value.boolValue !== undefined) {
+        if (typeof value.boolValue !== "boolean")
+            throw malformedGrid();
+        return { kind: "boolean", value: value.boolValue };
+    }
+    if (value.numberValue !== undefined) {
+        if (typeof value.numberValue !== "number" || !Number.isFinite(value.numberValue))
+            throw malformedGrid();
+        if (isCanonicalDateFormat(format)) {
+            return { kind: "date", value: isoFromDateSerial(value.numberValue) };
+        }
+        return { kind: "number", value: value.numberValue };
+    }
+    if (Object.keys(value).length === 0)
+        return null;
+    throw malformedGrid();
+}
+/**
+ * Normalizes one raw grid cell with getValues semantics: formula cells
+ * resolve to their computed effective value, error cells to their display
+ * string, literals keep their typed kind, blank cells become `null`.
+ */
+export function normalizeInferCell(cell) {
+    if (cell === null || cell === undefined)
+        return null;
+    if (!isRecord(cell))
+        throw malformedGrid();
+    const entered = isRecord(cell.userEnteredValue) ? cell.userEnteredValue : undefined;
+    const effective = isRecord(cell.effectiveValue) ? cell.effectiveValue : undefined;
+    const format = cellNumberFormat(cell);
+    if (entered !== undefined && entered.formulaValue !== undefined) {
+        if (effective === undefined)
+            throw malformedGrid();
+        if (effective.errorValue !== undefined) {
+            return { kind: "string", value: errorDisplayString(cell, effective) };
+        }
+        return literalCell(effective, format);
+    }
+    if (entered !== undefined && entered.errorValue !== undefined) {
+        return { kind: "string", value: errorDisplayString(cell, entered) };
+    }
+    if (entered === undefined)
+        return null;
+    return literalCell(entered, format);
+}
+/** Excel 1900-system serial (days since 1899-12-30 UTC) back to canonical ISO. */
+function isoFromDateSerial(serial) {
+    return new Date(Math.round(Date.UTC(1899, 11, 30) + serial * 86_400_000)).toISOString();
+}
+/** Display text of one raw header cell; blank when empty. */
+function headerTextOf(cell) {
+    if (!isRecord(cell))
+        return "";
+    const formatted = cell.formattedValue;
+    if (typeof formatted === "string")
+        return formatted.trim();
+    const entered = cell.userEnteredValue;
+    if (isRecord(entered) && typeof entered.stringValue === "string")
+        return entered.stringValue.trim();
+    return "";
+}
+const SQL_IDENTIFIER_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** Splits display text into alphanumeric words. */
+function wordsOf(text) {
+    return text.split(/[^A-Za-z0-9]+/).filter((word) => word !== "");
+}
+/** Makes a camelCase property name, suffixed on collision (`name`, `name2`, ...). */
+function toPropertyName(header, columnIndex, used) {
+    const words = wordsOf(header);
+    let base = words.length === 0
+        ? `field${columnIndex + 1}`
+        : words
+            .map((word, i) => (i === 0 ? word.charAt(0).toLowerCase() + word.slice(1) : word.charAt(0).toUpperCase() + word.slice(1)))
+            .join("");
+    base = base.replace(/^[^A-Za-z_]+/, "");
+    if (base === "" || !SQL_IDENTIFIER_PATTERN.test(base))
+        base = `field${columnIndex + 1}`;
+    let name = base;
+    let suffix = 2;
+    while (used.has(name)) {
+        name = `${base}${suffix}`;
+        suffix += 1;
+    }
+    used.add(name);
+    return name;
+}
+/** Derives the PascalCase entity name from the tab name. */
+function toEntityName(tabName) {
+    const words = wordsOf(tabName);
+    if (words.length === 0)
+        return "InferredEntity";
+    const name = words.map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join("");
+    return SQL_IDENTIFIER_PATTERN.test(name) ? name : "InferredEntity";
+}
+/** Derives the snake_case table name from the tab name. */
+function toTableName(tabName) {
+    const words = wordsOf(tabName);
+    if (words.length === 0)
+        return "inferred_entity";
+    return words.map((word) => word.toLowerCase()).join("_");
+}
+/**
+ * Infers the entity descriptor block from a raw tab grid.
+ *
+ * Throws `InferError`: `empty_tab` (no header row), `pk_not_found` (the
+ * `--pk` header names no sampled column). Warnings carry column names only.
+ */
+export function inferFromGrid(grid, options = {}) {
+    const headers = grid.headerCells.map((cell) => headerTextOf(cell));
+    const usable = headers
+        .map((header, index) => ({ header, index }))
+        .filter((entry) => entry.header !== "");
+    if (usable.length === 0) {
+        throw new InferError("empty_tab", `Tab "${grid.tabName}" has no header row.`);
+    }
+    const rows = grid.dataCells.map((cells) => usable.map((entry) => normalizeInferCell(cells[entry.index])));
+    const nonEmptyRows = rows.filter((cells) => cells.some((cell) => cell !== null));
+    // Column kinds over the sampled non-empty cells; empty/mixed → string.
+    const warnings = [];
+    const types = new Map();
+    const distribution = { string: 0, number: 0, boolean: 0, date: 0 };
+    usable.forEach((entry, position) => {
+        const kinds = new Set();
+        for (const cells of nonEmptyRows) {
+            const cell = cells[position];
+            if (cell !== null && cell !== undefined)
+                kinds.add(cell.kind);
+        }
+        let type;
+        if (kinds.size === 0) {
+            type = "string";
+            warnings.push({ column: entry.header, reason: "empty column; defaulted to string" });
+        }
+        else if (kinds.size === 1) {
+            type = [...kinds][0];
+        }
+        else {
+            type = "string";
+            warnings.push({ column: entry.header, reason: "mixed column types; defaulted to string" });
+        }
+        types.set(entry.index, type);
+        distribution[type] += 1;
+    });
+    // PK: override header, else the first column. v1 PKs are string|number, so
+    // a boolean/date PK column is emitted as string with a warning.
+    const pkHeader = options.pkHeader ?? usable[0].header;
+    const pkEntry = usable.find((entry) => entry.header === pkHeader);
+    if (pkEntry === undefined) {
+        throw new InferError("pk_not_found", options.pkHeader === undefined
+            ? `Tab "${grid.tabName}" has no usable first column.`
+            : `PK header "${options.pkHeader}" names no column of tab "${grid.tabName}".`);
+    }
+    let pkType = types.get(pkEntry.index);
+    if (pkType !== "string" && pkType !== "number") {
+        warnings.push({ column: pkEntry.header, reason: `PK type ${pkType} is not a v1 business key; emitted as string` });
+        distribution[pkType] -= 1;
+        distribution.string += 1;
+        pkType = "string";
+        types.set(pkEntry.index, "string");
+    }
+    const entityName = toEntityName(grid.tabName);
+    const tableName = toTableName(grid.tabName);
+    const used = new Set();
+    const props = usable.map((entry) => ({
+        header: entry.header,
+        name: toPropertyName(entry.header, entry.index, used),
+        type: entry.index === pkEntry.index ? pkType : types.get(entry.index),
+        primary: entry.index === pkEntry.index,
+    }));
+    const lines = [
+        `import { defineTypedSheetsEntity } from "hikoutei";`,
+        ``,
+        `export const ${entityName} = defineTypedSheetsEntity({`,
+        `  name: "${entityName}",`,
+        `  tableName: "${tableName}",`,
+        `  properties: {`,
+    ];
+    for (const prop of props) {
+        lines.push(`    // ${JSON.stringify(prop.header.replace(/[\r\n]+/g, " "))}`);
+        lines.push(prop.primary
+            ? `    ${prop.name}: { type: "${prop.type}", primary: true },`
+            : `    ${prop.name}: { type: "${prop.type}" },`);
+    }
+    lines.push(`  },`);
+    lines.push(`});`);
+    const pkProp = props.find((prop) => prop.primary);
+    const summaryLines = [
+        `Tab "${grid.tabName}": ${nonEmptyRows.length} sampled rows, ${usable.length} columns.`,
+        `Types: string=${distribution.string}, number=${distribution.number}, boolean=${distribution.boolean}, date=${distribution.date}.`,
+        `PK: ${pkProp.name} (from header "${pkEntry.header}").`,
+        warnings.length === 0
+            ? `Warnings: (none).`
+            : `Warnings:\n${warnings.map((warning) => `WARN "${warning.column}": ${warning.reason}.`).join("\n")}`,
+    ];
+    return {
+        entityName,
+        tableName,
+        tsBlock: lines.join("\n"),
+        summary: summaryLines.join("\n"),
+        warnings,
+        sampledRows: nonEmptyRows.length,
+        columnCount: usable.length,
+        distribution,
+        pkProperty: pkProp.name,
+        columns: props.map((prop) => ({
+            header: prop.header,
+            property: prop.name,
+            type: prop.type,
+            primary: prop.primary,
+        })),
+    };
+}
+/**
+ * Builds the versioned descriptor file for an inference result.
+ *
+ * Pure and network-free: `--emit` serializes this file next to the printed
+ * block, and the file's `header` fields later feed `adopt --descriptor`
+ * without manual `--map` flags. Delegates to the contracts builder so the
+ * file envelope has one owner; the scalar core matches the printed block
+ * column-for-column (same `columns` source), so the two never disagree.
+ */
+export function inferResultToDescriptorFile(result) {
+    return buildDescriptorFile({
+        name: result.entityName,
+        tableName: result.tableName,
+        columns: result.columns.map((column) => ({
+            property: column.property,
+            header: column.header,
+            type: column.type,
+            primary: column.primary,
+        })),
+    });
+}
+/** Serializes an inference result to the stable descriptor-file JSON text. */
+export function serializeInferDescriptorFile(result) {
+    return serializeDescriptorFile(inferResultToDescriptorFile(result));
+}
+//# sourceMappingURL=infer.js.map

package/dist/cli/infer.js.map

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

package/dist/cli/inferArgs.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Pure command-line parsing for `hikoutei infer`.
+ *
+ * This module owns flag syntax and defaults only; it never touches the
+ * filesystem, imports user modules, or contacts Google Sheets. The result is
+ * an explicit union so the CLI entry can branch on help / valid / invalid
+ * without inspecting message text.
+ *
+ * Infer (spike): read-only sampling of an existing spreadsheet tab to print
+ * a copy-pasteable `defineTypedSheetsEntity(...)` block. The flow never
+ * writes to the spreadsheet or provisions anything.
+ */
+import { type SetupFailure } from "./errors.js";
+/** Default number of data rows sampled from the tab (header excluded). */
+export declare const INFER_DEFAULT_LIMIT = 100;
+/** Hard cap on sampled data rows so one run cannot page a whole spreadsheet. */
+export declare const INFER_MAX_LIMIT = 1000;
+/** Parsed and defaulted infer options handed to the infer flow. */
+export interface InferOptions {
+    /** Spreadsheet URL; falls back to `HIKOUTEI_SYNC_SPREADSHEET_URL`. */
+    readonly spreadsheetUrl?: string;
+    /** Existing tab to sample (required). */
+    readonly tabName: string;
+    /** PK header override; defaults to the first column. */
+    readonly pkHeader?: string;
+    /** Data rows sampled below the header row (1..1000, default 100). */
+    readonly limit: number;
+    /** Service-account key file; falls back to `GOOGLE_APPLICATION_CREDENTIALS`. */
+    readonly credentialsPath?: string;
+    /**
+     * Descriptor-file path written after the block is printed (`--emit`).
+     * The file carries the versioned JSON form of the same inference, so a
+     * later `createTypedSheets({ descriptors })` / `adopt --descriptor`
+     * reuses it without manual `--map` flags.
+     */
+    readonly emitPath?: string;
+    /** Overwrite the `--emit` target when it already exists (`--force`). */
+    readonly force: boolean;
+}
+/** Discriminated result of `parseInferArgs`. */
+export type InferArgsParseResult = {
+    readonly status: "help";
+    readonly helpText: string;
+} | {
+    readonly status: "valid";
+    readonly options: InferOptions;
+} | {
+    readonly status: "invalid";
+    readonly failure: SetupFailure;
+};
+export declare const INFER_HELP_TEXT: string;
+/** Parses and defaults `hikoutei infer` arguments. */
+export declare function parseInferArgs(argv: readonly string[]): InferArgsParseResult;
+//# sourceMappingURL=inferArgs.d.ts.map

package/dist/cli/inferArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inferArgs.d.ts","sourceRoot":"","sources":["../../../../../../src/inferArgs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAK9D,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,gFAAgF;AAChF,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,gDAAgD;AAChD,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,GAC5D;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC;AAoBnE,eAAO,MAAM,eAAe,QAyBhB,CAAC;AAEb,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,oBAAoB,CAmE5E"}

package/dist/cli/inferArgs.js

@@ -0,0 +1,123 @@
+/**
+ * Pure command-line parsing for `hikoutei infer`.
+ *
+ * This module owns flag syntax and defaults only; it never touches the
+ * filesystem, imports user modules, or contacts Google Sheets. The result is
+ * an explicit union so the CLI entry can branch on help / valid / invalid
+ * without inspecting message text.
+ *
+ * Infer (spike): read-only sampling of an existing spreadsheet tab to print
+ * a copy-pasteable `defineTypedSheetsEntity(...)` block. The flow never
+ * writes to the spreadsheet or provisions anything.
+ */
+import { setupFailure } from "./errors.js";
+/** Machine-readable code shared with the setup taxonomy for argument errors. */
+const SETUP_ERROR_CODES_INVALID_ARGS = "invalid_args";
+/** Default number of data rows sampled from the tab (header excluded). */
+export const INFER_DEFAULT_LIMIT = 100;
+/** Hard cap on sampled data rows so one run cannot page a whole spreadsheet. */
+export const INFER_MAX_LIMIT = 1000;
+const INFER_FLAGS = {
+    HELP: "--help",
+    HELP_SHORT: "-h",
+    SPREADSHEET: "--spreadsheet",
+    TAB: "--tab",
+    PK: "--pk",
+    LIMIT: "--limit",
+    CREDENTIALS: "--credentials",
+    EMIT: "--emit",
+    FORCE: "--force",
+};
+const KNOWN_FLAGS = new Set(Object.values(INFER_FLAGS));
+const VALUE_FLAGS = new Set([
+    INFER_FLAGS.SPREADSHEET, INFER_FLAGS.TAB, INFER_FLAGS.PK,
+    INFER_FLAGS.LIMIT, INFER_FLAGS.CREDENTIALS, INFER_FLAGS.EMIT,
+]);
+export const INFER_HELP_TEXT = [
+    "hikoutei infer - sample an existing spreadsheet tab and print a",
+    "copy-pasteable defineTypedSheetsEntity(...) block. Read-only: the",
+    "spreadsheet is never written or provisioned.",
+    "",
+    "Usage: hikoutei infer --tab <TabName> [options]",
+    "",
+    "Required:",
+    "  --tab <TabName>           Existing tab to sample.",
+    "",
+    "Options:",
+    "  --spreadsheet <url>       Falls back to HIKOUTEI_SYNC_SPREADSHEET_URL.",
+    "  --pk <header>             PK column header (default: the first column).",
+    "  --limit <n>               Data rows sampled below the header",
+    "                            (default 100, max 1000).",
+    "  --credentials <path>      SA key file; falls back to",
+    "                            GOOGLE_APPLICATION_CREDENTIALS.",
+    "  --emit <path>             Write the versioned descriptor JSON file",
+    "                            after printing the block (parent dirs must",
+    "                            exist; refuses to overwrite unless --force).",
+    "  --force                   Overwrite the --emit target when it exists.",
+    "  -h, --help                Show this help.",
+    "",
+    "Exit codes: 0 success, 1 runtime failure (tab not found, empty tab,",
+    "missing credentials), 2 argument errors.",
+].join("\n");
+/** Parses and defaults `hikoutei infer` arguments. */
+export function parseInferArgs(argv) {
+    const values = new Map();
+    const flags = new Set();
+    let index = 0;
+    while (index < argv.length) {
+        const token = argv[index];
+        if (token === INFER_FLAGS.HELP || token === INFER_FLAGS.HELP_SHORT) {
+            return { status: "help", helpText: INFER_HELP_TEXT };
+        }
+        if (!KNOWN_FLAGS.has(token)) {
+            return { status: "invalid", failure: setupFailure(SETUP_ERROR_CODES_INVALID_ARGS, `unknown flag "${token}"`) };
+        }
+        if (VALUE_FLAGS.has(token)) {
+            const value = argv[index + 1];
+            if (value === undefined || value.startsWith("--")) {
+                return { status: "invalid", failure: setupFailure(SETUP_ERROR_CODES_INVALID_ARGS, `flag ${token} requires a value`) };
+            }
+            values.set(token, value);
+            index += 2;
+            continue;
+        }
+        flags.add(token);
+        index += 1;
+    }
+    const tabName = values.get(INFER_FLAGS.TAB);
+    if (tabName === undefined || tabName.trim() === "") {
+        return { status: "invalid", failure: setupFailure(SETUP_ERROR_CODES_INVALID_ARGS, "missing required flag(s): --tab") };
+    }
+    const rawLimit = values.get(INFER_FLAGS.LIMIT) ?? String(INFER_DEFAULT_LIMIT);
+    const limit = Number(rawLimit);
+    if (!/^\d+$/.test(rawLimit) || !Number.isSafeInteger(limit) || limit < 1 || limit > INFER_MAX_LIMIT) {
+        return {
+            status: "invalid",
+            failure: setupFailure(SETUP_ERROR_CODES_INVALID_ARGS, `--limit must be an integer between 1 and ${INFER_MAX_LIMIT}, received "${rawLimit}"`),
+        };
+    }
+    const optional = (flag) => {
+        const value = values.get(flag);
+        return value === undefined || value.trim() === "" ? undefined : value;
+    };
+    const spreadsheetUrl = optional(INFER_FLAGS.SPREADSHEET);
+    const pkHeader = optional(INFER_FLAGS.PK);
+    const credentialsPath = optional(INFER_FLAGS.CREDENTIALS);
+    const rawEmit = values.get(INFER_FLAGS.EMIT);
+    if (rawEmit !== undefined && rawEmit.trim() === "") {
+        return { status: "invalid", failure: setupFailure(SETUP_ERROR_CODES_INVALID_ARGS, "flag --emit requires a non-empty path") };
+    }
+    return {
+        status: "valid",
+        options: {
+            tabName,
+            limit,
+            force: flags.has(INFER_FLAGS.FORCE),
+            ...(spreadsheetUrl === undefined ? {} : { spreadsheetUrl }),
+            ...(pkHeader === undefined ? {} : { pkHeader }),
+            ...(credentialsPath === undefined ? {} : { credentialsPath }),
+            ...(rawEmit === undefined ? {} : { emitPath: rawEmit }),
+        },
+    };
+}
+//# sourceMappingURL=inferArgs.js.map

package/dist/cli/inferArgs.js.map

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