@tekmemo/cli 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,276 @@
+import { TekMemoCloudClient, TekMemoCloudClientOptions } from "@tekmemo/cloud-client";
+import { TEKMEMO_DIR, TekMemoManifest } from "tekmemo";
+
+//#region src/cloud/client.d.ts
+interface CloudConnectionOptions {
+  cloudUrl?: string | undefined;
+  apiKey?: string | undefined;
+  workspaceId?: string | undefined;
+  projectId?: string | undefined;
+  timeoutMs?: number | string | undefined;
+  allowMissingApiKey?: boolean | undefined;
+  allowMissingProjectId?: boolean | undefined;
+}
+interface NormalizedCloudConnectionOptions {
+  baseUrl: string;
+  apiKey?: string | undefined;
+  workspaceId?: string | undefined;
+  projectId?: string | undefined;
+  timeoutMs?: number | undefined;
+}
+declare function createCliCloudClient(options?: CloudConnectionOptions): TekMemoCloudClient;
+declare function toCloudClientOptions(options?: CloudConnectionOptions): TekMemoCloudClientOptions;
+declare function normalizeCloudConnectionOptions(options?: CloudConnectionOptions): NormalizedCloudConnectionOptions;
+declare function formatCloudError(error: unknown): string;
+declare function cloudConnectionSummary(options: NormalizedCloudConnectionOptions): Record<string, unknown>;
+//#endregion
+//#region src/config/runtime.d.ts
+type TekMemoRuntimeMode = "local" | "cloud" | "hybrid";
+type TekMemoReadPolicy = "local-first" | "cloud-first" | "local-only" | "cloud-only";
+type TekMemoWritePolicy = "local-first" | "cloud-first" | "local-only" | "cloud-only";
+interface TekMemoConfigFile {
+  version?: number;
+  runtime?: TekMemoRuntimeMode;
+  root?: string;
+  cloud?: {
+    baseUrl?: string;
+    workspaceId?: string;
+    projectId?: string;
+    timeoutMs?: number;
+  };
+  hybrid?: {
+    readPolicy?: TekMemoReadPolicy;
+    writePolicy?: TekMemoWritePolicy;
+  };
+}
+interface CliRuntimeFlags {
+  root?: string;
+  runtime?: string;
+  cloudUrl?: string;
+  apiKey?: string;
+  workspaceId?: string;
+  projectId?: string;
+  timeoutMs?: string | number;
+  readPolicy?: string;
+  writePolicy?: string;
+}
+interface ResolvedCliRuntimeConfig {
+  runtime: TekMemoRuntimeMode;
+  root: string;
+  configPath: string;
+  configLoaded: boolean;
+  cloud: {
+    cloudUrl?: string;
+    apiKey?: string;
+    workspaceId?: string;
+    projectId?: string;
+    timeoutMs?: number;
+  };
+  hybrid: {
+    readPolicy: TekMemoReadPolicy;
+    writePolicy: TekMemoWritePolicy;
+  };
+}
+declare function resolveCliRuntimeConfig(input: {
+  cwd: string;
+  flags?: CliRuntimeFlags;
+  env?: NodeJS.ProcessEnv;
+}): Promise<ResolvedCliRuntimeConfig>;
+declare function writeDefaultCliConfig(input: {
+  cwd: string;
+  root?: string;
+  config?: TekMemoConfigFile;
+  force?: boolean;
+}): Promise<{
+  path: string;
+  created: boolean;
+  overwritten: boolean;
+}>;
+//#endregion
+//#region src/errors/cli-errors.d.ts
+type CliErrorCode = "CLI_USAGE_ERROR" | "CLI_VALIDATION_ERROR" | "CLI_FS_ERROR" | "CLI_PROTOCOL_ERROR" | "CLI_JSONL_ERROR";
+declare class CliError extends Error {
+  readonly code: CliErrorCode;
+  readonly exitCode: number;
+  readonly cause?: unknown;
+  constructor(code: CliErrorCode, message: string, options?: {
+    exitCode?: number;
+    cause?: unknown;
+  });
+}
+declare class CliUsageError extends CliError {
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
+declare class CliValidationError extends CliError {
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
+declare class CliFsError extends CliError {
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
+declare class CliProtocolError extends CliError {
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
+declare class CliJsonlError extends CliError {
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
+//#endregion
+//#region src/fs/tekmemo-fs.d.ts
+interface TekMemoFileSystemOptions {
+  rootDir: string;
+  rejectSymlinkedTekMemoDir?: boolean;
+}
+declare class TekMemoFileSystem {
+  readonly rootDir: string;
+  private readonly rejectSymlinkedTekMemoDir;
+  constructor(options: TekMemoFileSystemOptions);
+  resolve(relativePath: string): string;
+  ensureSafeRoot(): Promise<void>;
+  exists(relativePath: string): Promise<boolean>;
+  readText(relativePath: string): Promise<string>;
+  readTextIfExists(relativePath: string): Promise<string | undefined>;
+  writeText(relativePath: string, content: string): Promise<void>;
+  appendText(relativePath: string, content: string): Promise<void>;
+  mkdir(relativePath: string): Promise<void>;
+  stat(relativePath: string): Promise<{
+    isFile: boolean;
+    isDirectory: boolean;
+    isSymbolicLink: boolean;
+    size: number;
+  }>;
+  private rejectUnsafeTekMemoSymlinkIfNeeded;
+}
+//#endregion
+//#region src/output/output.d.ts
+interface CliOutput {
+  stdout: string[];
+  stderr: string[];
+  write(message: string): void;
+  error(message: string): void;
+  success(message: string): void;
+  warn(message: string): void;
+}
+interface JsonEnvelope<T = unknown> {
+  ok: boolean;
+  command: string;
+  data?: T;
+  error?: {
+    code: string;
+    message: string;
+    details?: unknown;
+  };
+}
+interface BufferedOutputOptions {
+  noColor?: boolean;
+}
+declare function createBufferedOutput(options?: BufferedOutputOptions): CliOutput;
+declare function printHumanOrJson(output: CliOutput, value: unknown, human: string, json?: boolean): void;
+declare function printJsonEnvelope<T>(output: CliOutput, command: string, data: T): void;
+declare function printJsonError(output: CliOutput, command: string, code: string, message: string, details?: unknown): void;
+//#endregion
+//#region src/protocol/constants.d.ts
+/**
+ * Flat CLI path map kept for command ergonomics.
+ * The values intentionally come from `tekmemo`, so the CLI cannot drift from
+ * the canonical protocol owned by the core package.
+ */
+declare const TEKMEMO_PATHS: {
+  readonly manifest: ".tekmemo/manifest.json";
+  readonly coreMemory: ".tekmemo/memory/core.md";
+  readonly notesMemory: ".tekmemo/memory/notes.md";
+  readonly memoryEvents: ".tekmemo/events/memory-events.jsonl";
+  readonly conversations: ".tekmemo/events/conversations.jsonl";
+  readonly chunks: ".tekmemo/indexes/chunks.jsonl";
+  readonly graphNodes: ".tekmemo/graph/nodes.jsonl";
+  readonly graphEdges: ".tekmemo/graph/edges.jsonl";
+  readonly snapshots: ".tekmemo/snapshots/snapshots.jsonl";
+  readonly snapshotsDir: ".tekmemo/snapshots";
+  readonly tmpDir: ".tekmemo/tmp";
+};
+declare const REQUIRED_FILES: readonly [".tekmemo/manifest.json", ".tekmemo/memory/core.md", ".tekmemo/memory/notes.md", ".tekmemo/events/memory-events.jsonl", ".tekmemo/events/conversations.jsonl", ".tekmemo/indexes/chunks.jsonl", ".tekmemo/graph/nodes.jsonl", ".tekmemo/graph/edges.jsonl", ".tekmemo/snapshots/snapshots.jsonl"];
+declare const REQUIRED_DIRS: readonly [".tekmemo", ".tekmemo/memory", ".tekmemo/events", ".tekmemo/indexes", ".tekmemo/graph", ".tekmemo/snapshots", ".tekmemo/tmp"];
+//#endregion
+//#region src/protocol/jsonl.d.ts
+interface JsonlParseOptions {
+  strict?: boolean | undefined;
+}
+interface JsonlRecord {
+  line: number;
+  value: Record<string, unknown>;
+}
+declare function parseJsonl(content: string, options?: JsonlParseOptions): JsonlRecord[];
+declare function stringifyJsonl(records: readonly Record<string, unknown>[]): string;
+//#endregion
+//#region src/protocol/manifest.d.ts
+type TekMemoCliManifest = TekMemoManifest;
+declare function createDefaultManifest(input?: {
+  projectId?: string;
+  now?: string;
+}): TekMemoCliManifest;
+declare function parseManifest(content: string): TekMemoCliManifest;
+declare function validateManifest(value: unknown): TekMemoCliManifest;
+//#endregion
+//#region src/protocol/summary.d.ts
+interface TekMemoInspection {
+  rootDir: string;
+  exists: boolean;
+  manifest?: TekMemoCliManifest;
+  files: Array<{
+    path: string;
+    exists: boolean;
+    bytes: number;
+    lines?: number;
+    records?: number;
+  }>;
+  summary: {
+    eventCount: number;
+    conversationCount: number;
+    chunkCount: number;
+    graphNodeCount: number;
+    graphEdgeCount: number;
+    snapshotCount: number;
+  };
+}
+declare function inspectTekMemo(fs: TekMemoFileSystem): Promise<TekMemoInspection>;
+//#endregion
+//#region src/runner.d.ts
+interface RunTekMemoCliInput {
+  argv: string[];
+  cwd?: string;
+  output?: CliOutput;
+  verbose?: boolean;
+  quiet?: boolean;
+  noColor?: boolean;
+  stdinContent?: string;
+}
+interface RunTekMemoCliResult {
+  exitCode: number;
+  stdout: string[];
+  stderr: string[];
+}
+declare function runTekMemoCli(input: RunTekMemoCliInput): Promise<RunTekMemoCliResult>;
+//#endregion
+//#region src/utils/labels.d.ts
+declare function validateSnapshotLabel(label: string): string;
+declare function createSafeIdFromLabel(label: string, timestamp?: string): string;
+//#endregion
+//#region src/utils/secrets.d.ts
+interface SecretScanFinding {
+  kind: string;
+  index: number;
+  preview: string;
+}
+declare function scanForSecrets(content: string): SecretScanFinding[];
+declare function redactSecretPreview(value: string): string;
+//#endregion
+export { type BufferedOutputOptions, CliError, type CliErrorCode, CliFsError, CliJsonlError, type CliOutput, CliProtocolError, type CliRuntimeFlags, CliUsageError, CliValidationError, type CloudConnectionOptions, type JsonEnvelope, type JsonlParseOptions, type JsonlRecord, type NormalizedCloudConnectionOptions, REQUIRED_DIRS, REQUIRED_FILES, type ResolvedCliRuntimeConfig, type RunTekMemoCliInput, type RunTekMemoCliResult, TEKMEMO_DIR, TEKMEMO_PATHS, type TekMemoCliManifest, type TekMemoConfigFile, TekMemoFileSystem, type TekMemoFileSystemOptions, type TekMemoInspection, type TekMemoReadPolicy, type TekMemoRuntimeMode, type TekMemoWritePolicy, cloudConnectionSummary, createBufferedOutput, createCliCloudClient, createDefaultManifest, createSafeIdFromLabel, formatCloudError, inspectTekMemo, normalizeCloudConnectionOptions, parseJsonl, parseManifest, printHumanOrJson, printJsonEnvelope, printJsonError, redactSecretPreview, resolveCliRuntimeConfig, runTekMemoCli, scanForSecrets, stringifyJsonl, toCloudClientOptions, validateManifest, validateSnapshotLabel, writeDefaultCliConfig };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/cloud/client.ts","../src/config/runtime.ts","../src/errors/cli-errors.ts","../src/fs/tekmemo-fs.ts","../src/output/output.ts","../src/protocol/constants.ts","../src/protocol/jsonl.ts","../src/protocol/manifest.ts","../src/protocol/summary.ts","../src/runner.ts","../src/utils/labels.ts","../src/utils/secrets.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,3 @@
+import { A as CliJsonlError, C as cloudConnectionSummary, D as toCloudClientOptions, E as normalizeCloudConnectionOptions, M as CliUsageError, N as CliValidationError, O as CliError, S as writeDefaultCliConfig, T as formatCloudError, _ as printHumanOrJson, a as scanForSecrets, b as TekMemoFileSystem, c as parseManifest, d as stringifyJsonl, f as REQUIRED_DIRS, g as createBufferedOutput, h as TEKMEMO_PATHS, i as redactSecretPreview, j as CliProtocolError, k as CliFsError, l as validateManifest, m as TEKMEMO_DIR, n as createSafeIdFromLabel, o as inspectTekMemo, p as REQUIRED_FILES, r as validateSnapshotLabel, s as createDefaultManifest, t as runTekMemoCli, u as parseJsonl, v as printJsonEnvelope, w as createCliCloudClient, x as resolveCliRuntimeConfig, y as printJsonError } from "./runner-Bz3RPzFc.mjs";
+
+export { CliError, CliFsError, CliJsonlError, CliProtocolError, CliUsageError, CliValidationError, REQUIRED_DIRS, REQUIRED_FILES, TEKMEMO_DIR, TEKMEMO_PATHS, TekMemoFileSystem, cloudConnectionSummary, createBufferedOutput, createCliCloudClient, createDefaultManifest, createSafeIdFromLabel, formatCloudError, inspectTekMemo, normalizeCloudConnectionOptions, parseJsonl, parseManifest, printHumanOrJson, printJsonEnvelope, printJsonError, redactSecretPreview, resolveCliRuntimeConfig, runTekMemoCli, scanForSecrets, stringifyJsonl, toCloudClientOptions, validateManifest, validateSnapshotLabel, writeDefaultCliConfig };