@wirecat/mail-cli 0.0.0-stage → 0.1.0

package/dist/bundle/store-2BUX6LVX.js

@@ -0,0 +1,124 @@
+import { createRequire as __bundleRequire } from "node:module";
+const require = __bundleRequire(import.meta.url);
+import {
+  AGENDA_COLUMNS,
+  BACKFILL_ON_OPEN,
+  CHAT_COLUMNS,
+  CHAT_LIST_KEY,
+  CONVERSATION_COLUMNS,
+  DEFAULT_AGENT_CLOSE,
+  DEFAULT_FIRST_PASS_PER_CHAT,
+  MENTION_QUERY,
+  MENTION_STATUSES,
+  OTHER_SOURCES,
+  TRACKED_CHAT_COLUMNS,
+  accountGroupsOf,
+  attachmentColumns,
+  drainNoteIndex,
+  dropAllUnusedVectors,
+  fetchedKey,
+  fileFacts,
+  fillSearchIndex,
+  fillStems,
+  firstPassPerChatOf,
+  historyStartKey,
+  inboxKey,
+  involvementStoreOver,
+  messageOfEmail,
+  noteIndexState,
+  openSqlite,
+  openStore,
+  orphanPointers,
+  pendingNormalization,
+  queryFilter,
+  readStoreTables,
+  registerProvider,
+  resetAttachmentWords,
+  resetNoteIndex,
+  resetSearchIndex,
+  resetStems,
+  rowCounts,
+  saveStorePhoneCountries,
+  savedAgentClose,
+  savedFirstPassPerChat,
+  savedPhoneCountries,
+  savedStemmers,
+  savedTaskCategories,
+  searchIndexState,
+  stemmerCache,
+  stemmersOrigin,
+  stemsState,
+  storeClients,
+  storeContents,
+  threadConversation,
+  titlePart,
+  vectorIndexCounts
+} from "./chunk-NK7EB63L.js";
+import "./chunk-4FEMINO2.js";
+import "./chunk-3KEVLSNN.js";
+import "./chunk-UH4DDRHA.js";
+import "./chunk-NPGVOZVK.js";
+import "./chunk-MNOIRJEO.js";
+import "./chunk-KHTO2Q6E.js";
+import "./chunk-F6D6PJ34.js";
+import "./chunk-EOEDICIE.js";
+import "./chunk-FZ5FXIG6.js";
+import "./chunk-J3QXTBD2.js";
+import "./chunk-LQ37ALDJ.js";
+import "./chunk-Y5E2WNWB.js";
+import "./chunk-5BVIWP3S.js";
+import "./chunk-ZVVMGPBJ.js";
+export {
+  AGENDA_COLUMNS,
+  BACKFILL_ON_OPEN,
+  CHAT_COLUMNS,
+  CHAT_LIST_KEY,
+  CONVERSATION_COLUMNS,
+  DEFAULT_AGENT_CLOSE,
+  DEFAULT_FIRST_PASS_PER_CHAT,
+  MENTION_QUERY,
+  MENTION_STATUSES,
+  OTHER_SOURCES,
+  TRACKED_CHAT_COLUMNS,
+  accountGroupsOf,
+  attachmentColumns,
+  drainNoteIndex,
+  dropAllUnusedVectors,
+  fetchedKey,
+  fileFacts,
+  fillSearchIndex,
+  fillStems,
+  firstPassPerChatOf,
+  historyStartKey,
+  inboxKey,
+  involvementStoreOver,
+  messageOfEmail,
+  noteIndexState,
+  openSqlite,
+  openStore,
+  orphanPointers,
+  pendingNormalization,
+  queryFilter,
+  readStoreTables,
+  registerProvider,
+  resetAttachmentWords,
+  resetNoteIndex,
+  resetSearchIndex,
+  resetStems,
+  rowCounts,
+  saveStorePhoneCountries,
+  savedAgentClose,
+  savedFirstPassPerChat,
+  savedPhoneCountries,
+  savedStemmers,
+  savedTaskCategories,
+  searchIndexState,
+  stemmerCache,
+  stemmersOrigin,
+  stemsState,
+  storeClients,
+  storeContents,
+  threadConversation,
+  titlePart,
+  vectorIndexCounts
+};

package/dist/bundle/store-UJ7SNKXI.js

@@ -0,0 +1,141 @@
+import { createRequire as __bundleRequire } from "node:module";
+const require = __bundleRequire(import.meta.url);
+import {
+  ORGANIZATIONS_QUERY,
+  PROJECTS_QUERY,
+  REMINDERS_QUERY,
+  applyDocumentTransfer,
+  previewDocumentTransfer,
+  previewProjectAnnotationSnapshot,
+  snapshotProjectAnnotations
+} from "./chunk-YPQQ5J4X.js";
+import {
+  note,
+  organization,
+  project,
+  reminder
+} from "./chunk-6MAZWSC3.js";
+import {
+  CATALOG_QUERY,
+  EVENT_FIELDS,
+  EVIDENCE_FINDINGS_KIND,
+  IMPORTED_DOCUMENT_QUERY,
+  MENTION_QUERY,
+  MENTION_STATUSES,
+  MIGRATIONS,
+  NOTE_FIELDS,
+  ORGANIZATION_KINDS,
+  OTHER_SOURCES,
+  PROJECT_ANNOTATIONS_MAX_BYTES,
+  PROJECT_TYPES,
+  PROPOSAL_STATUSES,
+  SCOPES,
+  TASK_EVENT_KINDS,
+  TASK_PAIR_DECISIONS,
+  TASK_RELATION_KINDS,
+  TASK_ROLES,
+  backfillNormalized,
+  certaintyOf,
+  createTagRedirectIndex,
+  decodeProjectAnnotationSnapshot,
+  decodeProjectAnnotations,
+  fillSearchIndex,
+  migrate,
+  openStore,
+  pendingNormalization,
+  planProjectAnnotationSnapshot,
+  planProjectAnnotations,
+  projectAnnotationSnapshotFingerprint,
+  projectAnnotationSnapshotSchema,
+  projectAnnotationsFingerprint,
+  resetAttachmentWords,
+  resetSearchIndex,
+  searchIndexState,
+  validateEvidenceFindings
+} from "./chunk-NK7EB63L.js";
+import "./chunk-4FEMINO2.js";
+import {
+  FACT_STATUSES,
+  FACT_TYPES,
+  MEMORY_KINDS,
+  MEMORY_SCOPES,
+  MEMORY_STATUSES,
+  TASK_TYPES,
+  WORK_TASK_TYPES
+} from "./chunk-3KEVLSNN.js";
+import "./chunk-UH4DDRHA.js";
+import "./chunk-NPGVOZVK.js";
+import "./chunk-MNOIRJEO.js";
+import "./chunk-KHTO2Q6E.js";
+import {
+  PRAGMAS,
+  openCache
+} from "./chunk-F6D6PJ34.js";
+import "./chunk-EOEDICIE.js";
+import {
+  storePath
+} from "./chunk-FZ5FXIG6.js";
+import "./chunk-J3QXTBD2.js";
+import "./chunk-LQ37ALDJ.js";
+import "./chunk-Y5E2WNWB.js";
+import "./chunk-5BVIWP3S.js";
+import "./chunk-ZVVMGPBJ.js";
+export {
+  CATALOG_QUERY,
+  EVENT_FIELDS,
+  EVIDENCE_FINDINGS_KIND,
+  FACT_STATUSES,
+  FACT_TYPES,
+  IMPORTED_DOCUMENT_QUERY,
+  MEMORY_KINDS,
+  MEMORY_SCOPES,
+  MEMORY_STATUSES,
+  MENTION_QUERY,
+  MENTION_STATUSES,
+  MIGRATIONS,
+  NOTE_FIELDS,
+  ORGANIZATIONS_QUERY,
+  ORGANIZATION_KINDS,
+  OTHER_SOURCES,
+  PRAGMAS,
+  PROJECTS_QUERY,
+  PROJECT_ANNOTATIONS_MAX_BYTES,
+  PROJECT_TYPES,
+  PROPOSAL_STATUSES,
+  REMINDERS_QUERY,
+  SCOPES,
+  TASK_EVENT_KINDS,
+  TASK_PAIR_DECISIONS,
+  TASK_RELATION_KINDS,
+  TASK_ROLES,
+  TASK_TYPES,
+  WORK_TASK_TYPES,
+  applyDocumentTransfer,
+  backfillNormalized,
+  certaintyOf,
+  createTagRedirectIndex,
+  decodeProjectAnnotationSnapshot,
+  decodeProjectAnnotations,
+  fillSearchIndex,
+  migrate,
+  note,
+  openCache,
+  openStore,
+  organization,
+  pendingNormalization,
+  planProjectAnnotationSnapshot,
+  planProjectAnnotations,
+  previewDocumentTransfer,
+  previewProjectAnnotationSnapshot,
+  project,
+  projectAnnotationSnapshotFingerprint,
+  projectAnnotationSnapshotSchema,
+  projectAnnotationsFingerprint,
+  reminder,
+  resetAttachmentWords,
+  resetSearchIndex,
+  searchIndexState,
+  snapshotProjectAnnotations,
+  storePath,
+  validateEvidenceFindings
+};

package/dist/bundle/store-maintenance-command-I7V5C44K.js

@@ -0,0 +1,52 @@
+import { createRequire as __bundleRequire } from "node:module";
+const require = __bundleRequire(import.meta.url);
+import {
+  buildStems,
+  storeMaintenanceCommands,
+  storeSummary
+} from "./chunk-GAH7N7HO.js";
+import "./chunk-GK4M2SUP.js";
+import "./chunk-3E3WA2L6.js";
+import "./chunk-T6464KYA.js";
+import "./chunk-75CWWETH.js";
+import "./chunk-WXAXYJJ7.js";
+import "./chunk-YO4CUH5E.js";
+import "./chunk-J6MSJLIW.js";
+import "./chunk-OTUOZ33L.js";
+import "./chunk-CH6RXYAX.js";
+import "./chunk-HTQTIKWP.js";
+import "./chunk-GQQJOH7A.js";
+import "./chunk-QLEUNU6G.js";
+import "./chunk-7SXGLT6T.js";
+import "./chunk-ZD3WUGR2.js";
+import "./chunk-P7P5MNAU.js";
+import "./chunk-WLFLBWNH.js";
+import "./chunk-TE5U5OAM.js";
+import "./chunk-KM7Q67Z3.js";
+import "./chunk-4E7BN3TC.js";
+import "./chunk-YPQQ5J4X.js";
+import "./chunk-6MAZWSC3.js";
+import "./chunk-NK7EB63L.js";
+import "./chunk-4FEMINO2.js";
+import "./chunk-3KEVLSNN.js";
+import "./chunk-UH4DDRHA.js";
+import "./chunk-NPGVOZVK.js";
+import "./chunk-MNOIRJEO.js";
+import "./chunk-KHTO2Q6E.js";
+import "./chunk-F6D6PJ34.js";
+import "./chunk-EOEDICIE.js";
+import "./chunk-QX7RCLRS.js";
+import "./chunk-D72URWJE.js";
+import "./chunk-Z34ICZA3.js";
+import "./chunk-5NYMNSSO.js";
+import "./chunk-FZ5FXIG6.js";
+import "./chunk-J3QXTBD2.js";
+import "./chunk-LQ37ALDJ.js";
+import "./chunk-Y5E2WNWB.js";
+import "./chunk-5BVIWP3S.js";
+import "./chunk-ZVVMGPBJ.js";
+export {
+  buildStems,
+  storeMaintenanceCommands,
+  storeSummary
+};

package/dist/commands/account.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const accountCommand: () => Command;
+//# sourceMappingURL=account.d.ts.map

package/dist/commands/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/commands/account.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAoDnC,eAAO,MAAM,cAAc,QAAO,OAGH,CAAA"}

package/dist/commands/account.js

@@ -0,0 +1,47 @@
+import { annotate } from "@wirecat/cli-base/commands";
+import { answerEntity, baseContext, itemOf, LOCAL_READ, outputFor, REMOTE_READ, renderAnswer, } from "@wirecat/cli-core/cli";
+import { Command } from "commander";
+import * as v from "valibot";
+import { configuration } from "../config.js";
+import { IDENTITY } from "../identity.js";
+import { contextOf, openSource, refuseOffline } from "./context.js";
+const mailAccountCheck = v.strictObject({
+    profile: v.string(),
+    host: v.string(),
+    port: v.number(),
+    security: v.picklist(["tls", "starttls", "plain"]),
+    password_from: v.picklist(["environment", "keyring", "himalaya"]),
+    login: v.string(),
+    capabilities: v.array(v.string()),
+    features: v.record(v.string(), v.boolean()),
+    folders: v.number(),
+});
+const checkCommand = () => answerEntity(annotate(new Command("check"), {
+    effects: REMOTE_READ,
+    examples: [`${IDENTITY.command} ya account check`, `${IDENTITY.command} ya account check --json`],
+}), "mail_account_check", mailAccountCheck)
+    .summary("log in and list what the server supports")
+    .description("log in to the server and list what it supports (IDLE, CONDSTORE, MOVE, Gmail extensions)")
+    .action(async function () {
+    const context = contextOf(this);
+    refuseOffline(context.flags);
+    const { source, endpoint, passwordFrom } = await openSource(context);
+    try {
+        const checked = await baseContext(this, configuration.resolveSettings).run(() => source.check());
+        renderAnswer(this, outputFor(this), itemOf({
+            profile: context.profile,
+            host: endpoint.host,
+            port: endpoint.port,
+            security: endpoint.security,
+            password_from: passwordFrom,
+            ...checked,
+        }));
+    }
+    finally {
+        await source.close();
+    }
+});
+export const accountCommand = () => annotate(new Command("account"), { effects: LOCAL_READ })
+    .description("the mailbox behind this profile")
+    .addCommand(checkCommand());
+//# sourceMappingURL=account.js.map

package/dist/commands/account.js.map

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

package/dist/commands/context.d.ts

@@ -0,0 +1,41 @@
+import type { KeyringStore } from "@wirecat/cli-base";
+import { type BaseEnvironment, type GlobalFlags } from "@wirecat/cli-core/cli";
+import type { Command } from "commander";
+import type { DiscoveryDeps } from "../discovery.js";
+import { type ImapEndpoint, type ImapMailSource, type ImapTuning } from "../mail/imap.js";
+import { type LookupHimalaya } from "../secret.js";
+/** What a test hands `run()` in place of the network, the keyring and `secret-tool`. */
+export interface MailEnvironment extends BaseEnvironment {
+    keyring?: KeyringStore;
+    himalaya?: LookupHimalaya;
+    discovery?: DiscoveryDeps;
+    connect?: (endpoint: ImapEndpoint, password: string, tuning?: ImapTuning) => ImapMailSource;
+}
+export declare const contextOf: (command: Command) => {
+    environment: MailEnvironment;
+    env: NodeJS.ProcessEnv;
+    flags: GlobalFlags;
+    settings: import("@wirecat/cli-core/cli").Settings & {
+        mailbox: import("../config.js").Mailbox;
+    };
+    profile: string;
+};
+export declare const refuseOffline: (flags: GlobalFlags) => void;
+export declare const endpointOf: (settings: ReturnType<typeof contextOf>["settings"]) => ImapEndpoint;
+export declare const passwordsOf: (context: ReturnType<typeof contextOf>) => {
+    read: () => Promise<{
+        secret: string;
+        source: import("../secret.js").PasswordSource;
+    } | undefined>;
+    write: (secret: string, storage?: "keyring" | "file") => "keyring" | "file";
+    usesOwnersSignIn: () => boolean;
+    remove: () => boolean;
+};
+/** An opened source for the profile, with the password read from the keyring; call `close` when done. */
+export declare const openSource: (context: ReturnType<typeof contextOf>, tuning?: ImapTuning) => Promise<{
+    source: ImapMailSource;
+    endpoint: ImapEndpoint;
+    passwordFrom: import("../secret.js").PasswordSource;
+}>;
+export declare const collect: (value: string, previous?: string[]) => string[];
+//# sourceMappingURL=context.d.ts.map

package/dist/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,EAAE,KAAK,eAAe,EAAiB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAC7F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAc,MAAM,iBAAiB,CAAA;AACrG,OAAO,EAAE,KAAK,cAAc,EAAiB,MAAM,cAAc,CAAA;AAEjE,wFAAwF;AACxF,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,KAAK,cAAc,CAAA;CAC5F;AAED,eAAO,MAAM,SAAS,YAAa,OAAO;;;;;;;;CAMzC,CAAA;AAED,eAAO,MAAM,aAAa,UAAW,WAAW,SAE/C,CAAA;AAED,eAAO,MAAM,UAAU,aAAc,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,CAAC,KAAG,YAQ/E,CAAA;AAED,eAAO,MAAM,WAAW,YAAa,UAAU,CAAC,OAAO,SAAS,CAAC;;;;;;;;CAM7D,CAAA;AAKJ,yGAAyG;AACzG,eAAO,MAAM,UAAU,YAAmB,UAAU,CAAC,OAAO,SAAS,CAAC,WAAU,UAAU;;;;EAqBzF,CAAA;AAED,eAAO,MAAM,OAAO,UAAW,MAAM,aAAY,MAAM,EAAE,KAAQ,MAAM,EAA0B,CAAA"}

package/dist/commands/context.js

@@ -0,0 +1,52 @@
+import { CliError } from "@wirecat/cli-base";
+import { environmentOf } from "@wirecat/cli-core/cli";
+import { configuration } from "../config.js";
+import { IDENTITY } from "../identity.js";
+import { imapSource } from "../mail/imap.js";
+import { passwordStore } from "../secret.js";
+export const contextOf = (command) => {
+    const environment = environmentOf(command);
+    const env = environment.env ?? process.env;
+    const flags = command.optsWithGlobals();
+    const settings = configuration.resolveSettings(flags, { env });
+    return { environment, env, flags, settings, profile: settings.profile };
+};
+export const refuseOffline = (flags) => {
+    if (flags.offline)
+        throw new CliError("permission_error", "this needs the mail server; leave out --offline");
+};
+export const endpointOf = (settings) => {
+    const { address, login, host, port, security } = settings.mailbox;
+    if (!address || !host || !port || !security)
+        throw new CliError("configuration_error", `profile ${settings.profile} has no mail server; run \`${IDENTITY.command} ${settings.profile} session start --address <email>\``);
+    return { host, port, security, login: login ?? address };
+};
+export const passwordsOf = (context) => passwordStore({
+    env: context.env,
+    profile: context.profile,
+    keyring: context.environment.keyring,
+    himalaya: context.environment.himalaya,
+});
+/** A retry that would end after the run's deadline is not made; this much is kept back for saving and answering. */
+const RETRY_MARGIN_MS = 3_000;
+/** An opened source for the profile, with the password read from the keyring; call `close` when done. */
+export const openSource = async (context, tuning = {}) => {
+    const { deadline, signal } = context.environment;
+    const endpoint = endpointOf(context.settings);
+    const stored = await passwordsOf(context).read();
+    if (!stored)
+        throw new CliError("authentication_error", `no app password for profile ${context.profile}; run \`${IDENTITY.command} ${context.profile} session start\``, { reason: "mail.no-password" });
+    const connect = context.environment.connect ?? imapSource;
+    const bounds = {
+        timeLeftMs: () => {
+            const now = deadline?.();
+            return now ? now.endsAt - Date.now() - RETRY_MARGIN_MS : undefined;
+        },
+        ...(signal ? { signal } : {}),
+    };
+    const source = connect(endpoint, stored.secret, { ...bounds, ...tuning });
+    context.environment.trackCloseable?.(source);
+    return { source, endpoint, passwordFrom: stored.source };
+};
+export const collect = (value, previous = []) => [...previous, value];
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,77 @@
+import { Command } from "commander";
+/**
+ * It is run when everything else is broken, so a problem in the config file is a field in the answer, never a throw.
+ * `fixes` are the `chmod` commands that make the config private; they go to stderr, not into the answer.
+ */
+export declare const doctorReport: (env: NodeJS.ProcessEnv) => {
+    report: {
+        version: string;
+        runtime: {
+            node: string;
+            platform: NodeJS.Platform;
+        };
+        paths: {
+            config: string;
+            state: string;
+            cache: string;
+        };
+        config: {
+            path: string;
+            found: boolean;
+            issues: import("@wirecat/cli-core/cli").ConfigIssue[];
+        };
+        profiles: string[];
+        read_only: string | null;
+        files: {
+            checked: false;
+            reason: string;
+        } | {
+            checked: true;
+            ok: boolean;
+            problems: {
+                path: string;
+                mode: string;
+                want: string;
+            }[];
+        };
+    };
+    fixes: string[] | never[];
+} | {
+    report: {
+        version: string;
+        runtime: {
+            node: string;
+            platform: NodeJS.Platform;
+        };
+        paths: {
+            config: string;
+            state: string;
+            cache: string;
+        };
+        config: {
+            path: string;
+            found: boolean;
+            issues: never[];
+        };
+        settings: {
+            error: string;
+        };
+        profiles: null;
+        read_only: string | null;
+        files: {
+            checked: false;
+            reason: string;
+        } | {
+            checked: true;
+            ok: boolean;
+            problems: {
+                path: string;
+                mode: string;
+                want: string;
+            }[];
+        };
+    };
+    fixes: string[] | never[];
+};
+export declare const doctorCommand: () => Command;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAenC;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAS,MAAM,CAAC,UAAU;;;;YAIpC,IAAI;YAAyB,QAAQ;;;YACvC,MAAM;YAAgB,KAAK;YAAe,KAAK;;;YAS1C,IAAI;YAAuB,KAAK;YAAwB,MAAM;;;;;;;;;;;;;;;;;;;;;;YAVjE,IAAI;YAAyB,QAAQ;;;YACvC,MAAM;YAAgB,KAAK;YAAe,KAAK;;;YAsB1C,IAAI;YAAQ,KAAK;YAAoB,MAAM;;;YACzC,KAAK;;;;;;;;;;;;;;;;;;CAQxB,CAAA;AAED,eAAO,MAAM,aAAa,QAAO,OAc3B,CAAA"}

package/dist/commands/doctor.js

@@ -0,0 +1,74 @@
+import { existsSync } from "node:fs";
+import { dirname } from "node:path";
+import { configFilePath, resolvePaths } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { environmentOf, itemOf, LOCAL_READ, outputFor, privateFiles, profileFree, readOnlyLockOf, renderAnswer, } from "@wirecat/cli-core/cli";
+import { Command } from "commander";
+import { configuration } from "../config.js";
+import { IDENTITY } from "../identity.js";
+const failure = (error) => (error instanceof Error ? error.message : String(error));
+const configFiles = (path) => {
+    const files = privateFiles({ files: [path], dirs: [dirname(path)] });
+    if (!files.checked)
+        return { files, fixes: [] };
+    return {
+        files: { ...files, problems: files.problems.map(({ path, mode, want }) => ({ path, mode, want })) },
+        fixes: files.problems.map((problem) => problem.fix),
+    };
+};
+/**
+ * It is run when everything else is broken, so a problem in the config file is a field in the answer, never a throw.
+ * `fixes` are the `chmod` commands that make the config private; they go to stderr, not into the answer.
+ */
+export const doctorReport = (env) => {
+    const paths = resolvePaths({ appName: IDENTITY.appName, prefix: IDENTITY.envPrefix, env });
+    const common = {
+        version: IDENTITY.version,
+        runtime: { node: process.versions.node, platform: process.platform },
+        paths: { config: paths.config, state: paths.state, cache: paths.cache },
+    };
+    const readOnly = readOnlyLockOf(IDENTITY, env) ?? null;
+    try {
+        const settings = configuration.resolveSettings({}, { env, readOnly: true, needsProfile: false, withIssues: true });
+        const { files, fixes } = configFiles(settings.configPath);
+        return {
+            report: {
+                ...common,
+                config: { path: settings.configPath, found: settings.configFound, issues: settings.configIssues ?? [] },
+                profiles: settings.configuredProfiles,
+                read_only: readOnly,
+                files,
+            },
+            fixes,
+        };
+    }
+    catch (error) {
+        const file = configFilePath(paths.config);
+        const { files, fixes } = configFiles(file);
+        return {
+            report: {
+                ...common,
+                config: { path: file, found: existsSync(file), issues: [] },
+                settings: { error: failure(error) },
+                profiles: null,
+                read_only: readOnly,
+                files,
+            },
+            fixes,
+        };
+    }
+};
+export const doctorCommand = () => profileFree(annotate(new Command("doctor"), {
+    effects: LOCAL_READ,
+    examples: [`${IDENTITY.command} doctor`, `${IDENTITY.command} doctor --json`],
+}))
+    .description("check this installation: version, paths, config, profiles; no keyring or network")
+    .action(function () {
+    const env = environmentOf(this).env ?? process.env;
+    const { report, fixes } = doctorReport(env);
+    const output = outputFor(this);
+    renderAnswer(this, output, itemOf(report));
+    for (const fix of fixes)
+        output.renderer.note(`to make it private: ${fix}`);
+});
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/folders.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const foldersCommand: () => Command;
+//# sourceMappingURL=folders.d.ts.map

package/dist/commands/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/commands/folders.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAyCnC,eAAO,MAAM,cAAc,QAAO,OAGJ,CAAA"}