@mnemonik/shared 7.97.1 → 7.98.0

package/dist/readiness.d.ts

@@ -0,0 +1,143 @@
+export declare const READINESS_SCHEMA_VERSION: 1;
+export type ReadinessState = 'READY' | 'LIMITED' | 'ACTION_REQUIRED' | 'FAILED';
+export type ReadinessConditionKind = 'selected_component_failed' | 'host_trust_pending' | 'vendor_policy_pending' | 'login_pending' | 'restart_pending' | 'project_identity_choice_pending' | 'scanner_not_verified' | 'hook_not_verified' | 'hooks_missing' | 'host_grant_unbound' | 'host_not_connected' | 'scanner_omitted' | 'project_uncovered' | 'host_skipped' | 'windows_task_creation_failed' | 'post_commit_upload_failed' | 'indexing_failed' | 'indexing_stalled';
+export interface ReadinessCondition {
+    kind: ReadinessConditionKind;
+    component?: string;
+    reason: string;
+    action?: string;
+}
+export interface ReadinessSummary {
+    state: ReadinessState;
+    reasons: string[];
+    actions: string[];
+}
+export interface ReadinessSubjectInput {
+    conditions: readonly ReadinessCondition[];
+}
+export interface IndexingCounts {
+    total: number | null;
+    completed: number | null;
+}
+export interface ProjectReadinessInput {
+    projectId?: string | null;
+    displayName?: string | null;
+    owner?: string | null;
+    repositoryMatch?: string | null;
+    identityFile?: string | null;
+    summary: ReadinessSubjectInput | ReadinessSummary;
+    indexing?: Partial<IndexingCounts> | null;
+    action?: string | null;
+}
+export interface ProjectReadiness {
+    projectId: string | null;
+    displayName: string | null;
+    owner: string | null;
+    repositoryMatch: string | null;
+    identityFile: string | null;
+    summary: ReadinessSummary;
+    indexing: IndexingCounts | null;
+    action: string | null;
+}
+export interface InstallSessionStatus {
+    id: string | null;
+    status: string | null;
+    kind: string | null;
+    startedAt: string | null;
+    completedAt: string | null;
+}
+export interface DeviceGrantStatus {
+    id: string;
+    client: string;
+    device: string | null;
+    platform: string | null;
+    scopes: string[];
+    resource: string;
+    createdAt: string;
+    lastUsedAt: string | null;
+    expiresAt: string | null;
+    incompleteInstallation: boolean;
+    revokeAction: string;
+}
+export interface ComponentCredentialStatus {
+    id: string;
+    kind: string;
+    displayPrefix: string | null;
+    device: string | null;
+    scopes: string[];
+    lastUsedAt: string | null;
+    expiresAt: string | null;
+    revokeAction: string;
+}
+export interface ScannerStatus {
+    roots: string[] | null;
+    heartbeatAt: string | null;
+    version: string | null;
+    readiness: ReadinessSummary | null;
+    acceptedDisclosureVersion: string | null;
+}
+export interface ProjectSetupResult {
+    projectId: string | null;
+    displayName: string | null;
+    owner: string | null;
+    repositoryMatch: string | null;
+    identityFile: string | null;
+    action: string | null;
+}
+export interface DefaultOwnerStatus {
+    kind: 'personal' | 'team';
+    id: string | null;
+    name: string | null;
+}
+export interface LimitedModeStatus {
+    acknowledgement: string | null;
+    enableScannerAction: string;
+}
+/** Optional receipt metadata; older schema-1 installers omit these observations. */
+export interface ReadinessVersions {
+    cli?: string;
+    scanner?: string;
+    hosts?: Array<{
+        host: string;
+        editor?: string;
+        hooks?: string;
+    }>;
+}
+export interface ReadinessDocumentInput {
+    versions?: ReadinessVersions;
+    platform?: string;
+    installation: ReadinessSubjectInput | ReadinessSummary;
+    projects?: readonly ProjectReadinessInput[];
+    indexing?: Partial<IndexingCounts> | null;
+    installSession?: InstallSessionStatus | null;
+    devicesAndGrants?: readonly DeviceGrantStatus[] | null;
+    componentCredentials?: readonly ComponentCredentialStatus[] | null;
+    scanner?: ScannerStatus | null;
+    projectSetupResults?: readonly ProjectSetupResult[] | null;
+    defaultOwner?: DefaultOwnerStatus | null;
+    limitedMode?: LimitedModeStatus | null;
+    generatedAt?: string;
+}
+export interface ReadinessDocument {
+    versions?: ReadinessVersions;
+    platform?: string;
+    schemaVersion: typeof READINESS_SCHEMA_VERSION;
+    installation: ReadinessSummary;
+    projects?: ProjectReadiness[];
+    indexing: IndexingCounts | null;
+    installSession: InstallSessionStatus | null;
+    devicesAndGrants: DeviceGrantStatus[] | null;
+    componentCredentials: ComponentCredentialStatus[] | null;
+    scanner: ScannerStatus | null;
+    projectSetupResults: ProjectSetupResult[] | null;
+    defaultOwner: DefaultOwnerStatus | null;
+    limitedMode: LimitedModeStatus | null;
+    generatedAt: string;
+}
+export declare function reduceReadiness(input: readonly ReadinessCondition[]): ReadinessSummary;
+export declare function remainingReadinessCount(summary: ReadinessSummary): number;
+export declare function describeReadiness(summary: ReadinessSummary): string;
+export declare function serializeReadiness(input: ReadinessDocumentInput): ReadinessDocument;
+/** Strict enough for the install-session trust boundary; nested console rows stay JSON-only. */
+export declare function isReadinessDocument(value: unknown): value is ReadinessDocument;
+//# sourceMappingURL=readiness.d.ts.map

package/dist/readiness.d.ts.map

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

package/dist/readiness.js

@@ -0,0 +1,304 @@
+export const READINESS_SCHEMA_VERSION = 1;
+const stateFor = {
+    selected_component_failed: 'FAILED',
+    host_trust_pending: 'ACTION_REQUIRED',
+    vendor_policy_pending: 'ACTION_REQUIRED',
+    login_pending: 'ACTION_REQUIRED',
+    restart_pending: 'ACTION_REQUIRED',
+    project_identity_choice_pending: 'ACTION_REQUIRED',
+    scanner_not_verified: 'LIMITED',
+    hook_not_verified: 'LIMITED',
+    hooks_missing: 'ACTION_REQUIRED',
+    host_grant_unbound: 'LIMITED',
+    host_not_connected: 'LIMITED',
+    scanner_omitted: 'LIMITED',
+    project_uncovered: 'LIMITED',
+    host_skipped: 'LIMITED',
+    windows_task_creation_failed: 'LIMITED',
+    post_commit_upload_failed: 'FAILED',
+    indexing_failed: 'FAILED',
+    indexing_stalled: 'FAILED',
+};
+const rank = {
+    READY: 0,
+    LIMITED: 1,
+    ACTION_REQUIRED: 2,
+    FAILED: 3,
+};
+function defaultAction(condition) {
+    if (condition.kind === 'host_skipped' && condition.component)
+        return `Connect it later: mnemonik connect ${condition.component}`;
+    if (condition.kind === 'windows_task_creation_failed')
+        return 'Run mnemonik scanner enable to try again.';
+    return condition.action;
+}
+export function reduceReadiness(input) {
+    let state = 'READY';
+    const reasons = [];
+    const actions = [];
+    for (const condition of input) {
+        const candidate = stateFor[condition.kind];
+        if (rank[candidate] > rank[state])
+            state = candidate;
+        if (!reasons.includes(condition.reason))
+            reasons.push(condition.reason);
+        const action = defaultAction(condition);
+        if (action && !actions.includes(action))
+            actions.push(action);
+    }
+    return { state, reasons, actions };
+}
+function sentence(value) {
+    return /[.!?]$/u.test(value) ? value : `${value}.`;
+}
+export function remainingReadinessCount(summary) {
+    return summary.reasons.filter((reason) => reason !== 'dev_release_source').length;
+}
+export function describeReadiness(summary) {
+    if (summary.state === 'READY')
+        return 'Done. Your editors will use Mnemonik on their next session.';
+    const count = remainingReadinessCount(summary);
+    const opening = summary.state === 'FAILED'
+        ? 'Setup failed.'
+        : count === 0
+            ? 'Done.'
+            : summary.state === 'ACTION_REQUIRED'
+                ? `Setup needs ${count === 1 ? 'one action' : `${count} actions`}.`
+                : `Done, with ${count === 1 ? 'one thing' : `${count} things`} left.`;
+    return [opening, ...summary.reasons.map(sentence), ...summary.actions].join(' ');
+}
+const counts = (value) => value ? { total: value.total ?? null, completed: value.completed ?? null } : null;
+const summary = (value) => 'conditions' in value
+    ? reduceReadiness(value.conditions)
+    : { state: value.state, reasons: [...value.reasons], actions: [...value.actions] };
+export function serializeReadiness(input) {
+    const projects = input.projects?.map((project) => ({
+        projectId: project.projectId ?? null,
+        displayName: project.displayName ?? null,
+        owner: project.owner ?? null,
+        repositoryMatch: project.repositoryMatch ?? null,
+        identityFile: project.identityFile ?? null,
+        summary: summary(project.summary),
+        indexing: counts(project.indexing),
+        action: project.action ?? null,
+    }));
+    return {
+        schemaVersion: READINESS_SCHEMA_VERSION,
+        ...(input.platform !== undefined ? { platform: input.platform } : {}),
+        ...(input.versions
+            ? {
+                versions: {
+                    ...input.versions,
+                    ...(input.versions.hosts
+                        ? { hosts: input.versions.hosts.map((host) => ({ ...host })) }
+                        : {}),
+                },
+            }
+            : {}),
+        installation: summary(input.installation),
+        ...(projects ? { projects } : {}),
+        indexing: counts(input.indexing),
+        installSession: input.installSession ?? null,
+        devicesAndGrants: input.devicesAndGrants ? [...input.devicesAndGrants] : null,
+        componentCredentials: input.componentCredentials ? [...input.componentCredentials] : null,
+        scanner: input.scanner ?? null,
+        projectSetupResults: input.projectSetupResults ? [...input.projectSetupResults] : null,
+        defaultOwner: input.defaultOwner ?? null,
+        limitedMode: input.limitedMode ?? null,
+        generatedAt: input.generatedAt ?? new Date().toISOString(),
+    };
+}
+const strings = (value) => Array.isArray(value) && value.every((item) => typeof item === 'string');
+const record = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+const exact = (value, keys) => Object.keys(value).every((key) => keys.includes(key)) && keys.every((key) => key in value);
+const nullableString = (value) => value === null || typeof value === 'string';
+const nullableCount = (value) => value === null || (Number.isInteger(value) && Number(value) >= 0);
+const versionString = (value) => typeof value === 'string' &&
+    value.length > 0 &&
+    value.length <= 128 &&
+    /^[\x20-\x7e]+$/u.test(value);
+const validVersions = (value) => record(value) &&
+    Object.keys(value).every((key) => ['cli', 'scanner', 'hosts'].includes(key)) &&
+    (value.cli === undefined || versionString(value.cli)) &&
+    (value.scanner === undefined || versionString(value.scanner)) &&
+    (value.hosts === undefined ||
+        (Array.isArray(value.hosts) &&
+            value.hosts.length <= 32 &&
+            value.hosts.every((host) => record(host) &&
+                versionString(host.host) &&
+                Object.keys(host).every((key) => ['host', 'editor', 'hooks'].includes(key)) &&
+                (host.editor === undefined || versionString(host.editor)) &&
+                (host.hooks === undefined || versionString(host.hooks)))));
+const validSummary = (value) => {
+    if (!record(value) || !exact(value, ['state', 'reasons', 'actions']))
+        return false;
+    const row = value;
+    return (['READY', 'LIMITED', 'ACTION_REQUIRED', 'FAILED'].includes(String(row.state)) &&
+        strings(row.reasons) &&
+        strings(row.actions));
+};
+const validCounts = (value) => {
+    if (value === null)
+        return true;
+    if (!record(value) || !exact(value, ['total', 'completed']))
+        return false;
+    const row = value;
+    return nullableCount(row.total) && nullableCount(row.completed);
+};
+const validProject = (value) => {
+    if (!record(value) ||
+        !exact(value, [
+            'projectId',
+            'displayName',
+            'owner',
+            'repositoryMatch',
+            'identityFile',
+            'summary',
+            'indexing',
+            'action',
+        ]))
+        return false;
+    return (nullableString(value.projectId) &&
+        nullableString(value.displayName) &&
+        nullableString(value.owner) &&
+        nullableString(value.repositoryMatch) &&
+        nullableString(value.identityFile) &&
+        validSummary(value.summary) &&
+        validCounts(value.indexing) &&
+        nullableString(value.action));
+};
+const validInstallSession = (value) => value === null ||
+    (record(value) &&
+        exact(value, ['id', 'status', 'kind', 'startedAt', 'completedAt']) &&
+        [value.id, value.status, value.kind, value.startedAt, value.completedAt].every(nullableString));
+const validGrant = (value) => record(value) &&
+    exact(value, [
+        'id',
+        'client',
+        'device',
+        'platform',
+        'scopes',
+        'resource',
+        'createdAt',
+        'lastUsedAt',
+        'expiresAt',
+        'incompleteInstallation',
+        'revokeAction',
+    ]) &&
+    typeof value.id === 'string' &&
+    typeof value.client === 'string' &&
+    nullableString(value.device) &&
+    nullableString(value.platform) &&
+    strings(value.scopes) &&
+    typeof value.resource === 'string' &&
+    typeof value.createdAt === 'string' &&
+    nullableString(value.lastUsedAt) &&
+    nullableString(value.expiresAt) &&
+    typeof value.incompleteInstallation === 'boolean' &&
+    typeof value.revokeAction === 'string';
+const validComponent = (value) => record(value) &&
+    exact(value, [
+        'id',
+        'kind',
+        'displayPrefix',
+        'device',
+        'scopes',
+        'lastUsedAt',
+        'expiresAt',
+        'revokeAction',
+    ]) &&
+    typeof value.id === 'string' &&
+    typeof value.kind === 'string' &&
+    nullableString(value.displayPrefix) &&
+    nullableString(value.device) &&
+    strings(value.scopes) &&
+    nullableString(value.lastUsedAt) &&
+    nullableString(value.expiresAt) &&
+    typeof value.revokeAction === 'string';
+const validScanner = (value) => value === null ||
+    (record(value) &&
+        exact(value, ['roots', 'heartbeatAt', 'version', 'readiness', 'acceptedDisclosureVersion']) &&
+        (value.roots === null || strings(value.roots)) &&
+        nullableString(value.heartbeatAt) &&
+        nullableString(value.version) &&
+        (value.readiness === null || validSummary(value.readiness)) &&
+        nullableString(value.acceptedDisclosureVersion));
+const validSetup = (value) => record(value) &&
+    exact(value, [
+        'projectId',
+        'displayName',
+        'owner',
+        'repositoryMatch',
+        'identityFile',
+        'action',
+    ]) &&
+    [
+        value.projectId,
+        value.displayName,
+        value.owner,
+        value.repositoryMatch,
+        value.identityFile,
+        value.action,
+    ].every(nullableString);
+/** Strict enough for the install-session trust boundary; nested console rows stay JSON-only. */
+export function isReadinessDocument(value) {
+    if (!record(value))
+        return false;
+    const required = [
+        'schemaVersion',
+        'installation',
+        'indexing',
+        'installSession',
+        'devicesAndGrants',
+        'componentCredentials',
+        'scanner',
+        'projectSetupResults',
+        'defaultOwner',
+        'limitedMode',
+        'generatedAt',
+    ];
+    if (!Object.keys(value).every((key) => [...required, 'projects', 'versions', 'platform'].includes(key)))
+        return false;
+    const row = value;
+    if ('versions' in row && !validVersions(row.versions))
+        return false;
+    if ('platform' in row && !versionString(row.platform))
+        return false;
+    if (row.schemaVersion !== READINESS_SCHEMA_VERSION ||
+        !validSummary(row.installation) ||
+        !validCounts(row.indexing) ||
+        typeof row.generatedAt !== 'string' ||
+        !Number.isFinite(Date.parse(row.generatedAt)))
+        return false;
+    if (row.projects !== undefined &&
+        (!Array.isArray(row.projects) || !row.projects.every(validProject)))
+        return false;
+    if (!required.every((field) => field in row))
+        return false;
+    if (!validInstallSession(row.installSession))
+        return false;
+    if (row.devicesAndGrants !== null &&
+        (!Array.isArray(row.devicesAndGrants) || !row.devicesAndGrants.every(validGrant)))
+        return false;
+    if (row.componentCredentials !== null &&
+        (!Array.isArray(row.componentCredentials) || !row.componentCredentials.every(validComponent)))
+        return false;
+    if (!validScanner(row.scanner))
+        return false;
+    if (row.projectSetupResults !== null &&
+        (!Array.isArray(row.projectSetupResults) || !row.projectSetupResults.every(validSetup)))
+        return false;
+    if (row.defaultOwner !== null &&
+        (!record(row.defaultOwner) ||
+            !exact(row.defaultOwner, ['kind', 'id', 'name']) ||
+            !['personal', 'team'].includes(String(row.defaultOwner.kind)) ||
+            !nullableString(row.defaultOwner.id) ||
+            !nullableString(row.defaultOwner.name)))
+        return false;
+    return (row.limitedMode === null ||
+        (record(row.limitedMode) &&
+            exact(row.limitedMode, ['acknowledgement', 'enableScannerAction']) &&
+            nullableString(row.limitedMode.acknowledgement) &&
+            typeof row.limitedMode.enableScannerAction === 'string'));
+}
+//# sourceMappingURL=readiness.js.map

package/dist/readiness.js.map

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

package/dist/repositoryFingerprint.d.ts

@@ -0,0 +1,50 @@
+/** Only this hash/version pair may be sent to or stored by the server. */
+export interface RepositoryFingerprint {
+    algorithmVersion: 1;
+    hash: string;
+}
+export type RemoteRejectionReason = 'invalid_remote' | 'unsupported_transport' | 'local_remote' | 'scp_unreviewed_remote' | 'https_userinfo' | 'ssh_password' | 'ssh_user_required' | 'invalid_ssh_user' | 'invalid_host' | 'invalid_port' | 'invalid_encoding' | 'escaped_separator' | 'control_character' | 'backslash' | 'empty_segment' | 'dot_segment';
+export type RemoteResult = (RepositoryFingerprint & {
+    canonical: string;
+}) | {
+    status: 'rejected';
+    reason: RemoteRejectionReason;
+};
+export interface RepositoryProviderRule {
+    readonly name: string;
+    readonly host: string;
+    readonly sshUser: string;
+    readonly removeTerminalDotGit: boolean;
+}
+/** Registry changes require review and golden cases; changed v1 outputs require v2. */
+export declare const REPOSITORY_PROVIDER_RULES: readonly RepositoryProviderRule[];
+/** Parse the raw path ourselves: WHATWG URL would silently resolve dot segments. */
+export declare function canonicalizeRemote(url: string, { providerRules, }?: {
+    providerRules?: readonly RepositoryProviderRule[];
+}): RemoteResult;
+export interface RepositoryRemote {
+    name: string;
+    fetchUrls: readonly string[];
+    pushUrls?: readonly string[];
+}
+export type RemoteSelection = {
+    status: 'fingerprint';
+    remote: string;
+    fingerprint: RepositoryFingerprint & {
+        canonical: string;
+    };
+} | {
+    status: 'none';
+    reason: 'no_remote' | 'no_fetch_url';
+} | {
+    status: 'rejected';
+    remote: string;
+    reason: RemoteRejectionReason;
+} | {
+    status: 'choice_required';
+    reason: 'multiple_remotes' | 'different_urls';
+    remotes: string[];
+};
+/** Choice results carry names, never credential-bearing URLs. No URL is guessed. */
+export declare function selectRemote(remotes: readonly RepositoryRemote[]): RemoteSelection;
+//# sourceMappingURL=repositoryFingerprint.d.ts.map

package/dist/repositoryFingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repositoryFingerprint.d.ts","sourceRoot":"","sources":["../src/repositoryFingerprint.ts"],"names":[],"mappings":"AAGA,0EAA0E;AAC1E,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,CAAC,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,uBAAuB,GACvB,cAAc,GACd,uBAAuB,GACvB,gBAAgB,GAChB,cAAc,GACd,mBAAmB,GACnB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,mBAAmB,GACnB,mBAAmB,GACnB,WAAW,GACX,eAAe,GACf,aAAa,CAAC;AAClB,MAAM,MAAM,YAAY,GACpB,CAAC,qBAAqB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/C;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAS1D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AACD,uFAAuF;AACvF,eAAO,MAAM,yBAAyB,EAAE,SAAS,sBAAsB,EAErE,CAAC;AASH,oFAAoF;AACpF,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,EACE,aAAyC,GAC1C,GAAE;IAAE,aAAa,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAA;CAAO,GAC5D,YAAY,CA8Fd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AACD,MAAM,MAAM,eAAe,GACvB;IACE,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,qBAAqB,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D,GACD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GACrE;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,kBAAkB,GAAG,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpG,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,eAAe,CA0BlF"}