gudong-content-cli 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gudong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,68 @@
-# Temporary Holding Version
+# gudong-content-cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+让 AI Agent（ZCode / Codex / Claude / Cursor…）用一条 shell 命令读你的「好内容」收藏与精读数据：
+收了哪些文章、读到哪了、划了哪些金句、写了什么想法。
+
+不造 AI、不建服务端。数据在你自己的 WebDAV / S3 云盘上（与「好内容」App 的多端云同步共用同一份
+`content-snapshot.json` 快照），CLI 只是那根「线」。**v1 全部命令只读。**
+
+配套 Skill：`skills/gudong-content/SKILL.md`（SkillHub 搜 `gudong-content`）。
+
+## 安装
+
+```bash
+npm install -g gudong-content-cli@latest
+```
+
+## 配置
+
+在「好内容」App → 我的 → 多端云同步里配好 WebDAV 并测试通过后，把同一套凭据给 CLI
+（App 的「AI Agent 接入」页可以直接生成带真实凭据的一条龙提示词）：
+
+```bash
+# WebDAV（坚果云等）
+gudong-content config init \
+  --cloud-type webdav \
+  --url https://dav.jianguoyun.com/dav \
+  --username user@example.com \
+  --password 应用密码 \
+  --root-dir GdContent \
+  --timezone Asia/Shanghai
+
+# 验证
+gudong-content config test
+```
+
+- `root-dir` 必须与 App 云盘同步设置里的目录一致（家族 Gd 命名规范，默认 `GdContent`，开发包为 `GdContentDebug`）。
+- 配置保存在 `~/.gudong-content/config.json`（chmod 600），也支持环境变量回退
+  （`CONTENT_CLOUD_TYPE`、`CONTENT_WEBDAV_URL`、`CONTENT_S3_ENDPOINT` 等，家族 CLI 同约定加 CONTENT_ 前缀）。
+
+## 命令
+
+| 命令 | 用途 |
+|------|------|
+| `articles [--status unread\|reading\|finished] [--starred] [--limit N]` | 文章清单：进度/星标/划线想法计数（收录时间倒序） |
+| `highlights [--article <id\|标题>] [--color ...] [--since/--until] [--limit]` | 划线金句（时间倒序） |
+| `notes [--article ...] [--limit N]` | 想法：划线想法（附原文上下文）+ 文章级批注 |
+| `search --query "关键词"` | 标题、摘要、划线原文、想法内容的全文搜索 |
+| `stats` | 全库统计：状态分布、划线/想法总数、阅读天数、估算时长、积压未读 |
+| `config init/show/test` | 配置管理（show 已脱敏） |
+
+所有命令成功输出 JSON（exit 0），失败 exit 1 并给 stderr 错误。v1 无写命令、无冲突语义。
+
+## 口径
+
+云端只有一个文件：`{rootDir}/content-snapshot.json`，App 是唯一写者、CLI 只读镜像。
+协议权威源在 App 侧（content-dong 的 `intents/20261005-feature-agent-access.md` 与
+`lib/features/agent/content_snapshot.dart`）；TS 类型是它的镜像，遵守 wire 纪律：
+读端忽略未知字段、全字段带默认值、禁止严格校验。CLI 上线不是协议变更。
+
+stats 口径逐字复刻 App `ArticleRepository.getReadingStats`
+（content-dong `lib/features/library/article_repository.dart`）：
+`estimated_hours` = finished×0.4 + reading×0.2 + Σ(excerpt×8×progress)/24000（估算值，非计时）；
+`days_read` = lastReadAt 去重自然日数；`stale_unread` = 收录超 14 天未读。
+
+## 相关
+
+- 先例：`gudong-moushi-cli`（谋事/Todo）、`gudong-xiexia-cli`（写下）
+- 家族接入规范：ReKnowledge/app-standard/agent-access.md

package/dist/cloud/factory.d.ts

@@ -0,0 +1,5 @@
+import type { CloudProvider } from './types.js';
+import type { ParsedConfig } from '../config.js';
+export declare function createCloudProvider(cfg: ParsedConfig): CloudProvider;
+/** 文章快照文件名（相对 rootDir），与 App 端快照文件名约定一致（content-dong lib/features/agent/content_snapshot.dart）。 */
+export declare const SNAPSHOT_FILE = "content-snapshot.json";

package/dist/cloud/factory.js

@@ -0,0 +1,27 @@
+import { S3Provider } from './s3.js';
+import { WebdavProvider } from './webdav.js';
+export function createCloudProvider(cfg) {
+    if (cfg.cloudType === 's3' && cfg.s3) {
+        return new S3Provider({
+            endpoint: cfg.s3.endpoint,
+            bucket: cfg.s3.bucket,
+            accessKey: cfg.s3.accessKey,
+            secretKey: cfg.s3.secretKey,
+            region: cfg.s3.region,
+            forcePathStyle: cfg.s3.forcePathStyle,
+            rootDir: cfg.rootDir,
+        });
+    }
+    if (cfg.cloudType === 'webdav' && cfg.webdav) {
+        return new WebdavProvider({
+            url: cfg.webdav.url,
+            username: cfg.webdav.username,
+            password: cfg.webdav.password,
+            rootDir: cfg.rootDir,
+        });
+    }
+    throw new Error(`unsupported cloud type or missing config: ${cfg.cloudType}`);
+}
+/** 文章快照文件名（相对 rootDir），与 App 端快照文件名约定一致（content-dong lib/features/agent/content_snapshot.dart）。 */
+export const SNAPSHOT_FILE = 'content-snapshot.json';
+//# sourceMappingURL=factory.js.map

package/dist/cloud/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/cloud/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,UAAU,mBAAmB,CAAC,GAAiB;IACnD,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;QACrC,OAAO,IAAI,UAAU,CAAC;YACpB,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ;YACzB,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM;YACrB,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS;YAC3B,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS;YAC3B,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,MAAM;YACrB,cAAc,EAAE,GAAG,CAAC,EAAE,CAAC,cAAc;YACrC,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC7C,OAAO,IAAI,cAAc,CAAC;YACxB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG;YACnB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ;YAC7B,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ;YAC7B,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,6CAA6C,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,MAAM,aAAa,GAAG,uBAAuB,CAAC"}

package/dist/cloud/s3.d.ts

@@ -0,0 +1,29 @@
+import type { CloudProvider, EntryFile } from './types.js';
+export interface S3ProviderConfig {
+    endpoint: string;
+    bucket: string;
+    accessKey: string;
+    secretKey: string;
+    region: string;
+    forcePathStyle: boolean;
+    rootDir: string;
+}
+export declare class S3Provider implements CloudProvider {
+    readonly type: "s3";
+    private readonly client;
+    private readonly bucket;
+    private readonly rootDir;
+    constructor(cfg: S3ProviderConfig);
+    private key;
+    /**
+     * 服务层传相对 rootDir 的 key（entries/x.json），listFiles 返回的是全 key
+     * （GdContent/content-snapshot.json）——统一归一为全 key，与 WebDAV resolve() 对齐，
+     * 否则写/删会落到桶根丢掉 rootDir 前缀。
+     */
+    private resolve;
+    listFiles(dirPath: string): Promise<EntryFile[]>;
+    read(key: string): Promise<Buffer>;
+    write(key: string, data: Buffer): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    ensureDirectory(): Promise<void>;
+}

package/dist/cloud/s3.js

@@ -0,0 +1,84 @@
+import { S3Client, ListObjectsV2Command, GetObjectCommand, PutObjectCommand, DeleteObjectCommand, } from '@aws-sdk/client-s3';
+const FILE_PATTERN = /\.(json)$/;
+export class S3Provider {
+    type = 's3';
+    client;
+    bucket;
+    rootDir;
+    constructor(cfg) {
+        this.bucket = cfg.bucket;
+        this.rootDir = cfg.rootDir;
+        this.client = new S3Client({
+            endpoint: cfg.endpoint,
+            region: cfg.region,
+            credentials: {
+                accessKeyId: cfg.accessKey,
+                secretAccessKey: cfg.secretKey,
+            },
+            forcePathStyle: cfg.forcePathStyle,
+        });
+    }
+    key(remotePath) {
+        return `${this.rootDir}/${remotePath.replace(/^\/+/, '')}`;
+    }
+    /**
+     * 服务层传相对 rootDir 的 key（entries/x.json），listFiles 返回的是全 key
+     * （GdContent/content-snapshot.json）——统一归一为全 key，与 WebDAV resolve() 对齐，
+     * 否则写/删会落到桶根丢掉 rootDir 前缀。
+     */
+    resolve(key) {
+        const k = key.replace(/^\/+/, '');
+        return k.startsWith(`${this.rootDir}/`) ? k : this.key(k);
+    }
+    async listFiles(dirPath) {
+        const prefix = this.key(dirPath).replace(/\/+$/, '') + '/';
+        const out = [];
+        let token;
+        do {
+            const res = await this.client.send(new ListObjectsV2Command({
+                Bucket: this.bucket,
+                Prefix: prefix,
+                ContinuationToken: token,
+            }));
+            for (const obj of res.Contents ?? []) {
+                if (!obj.Key || obj.Key.endsWith('/'))
+                    continue;
+                if (!FILE_PATTERN.test(obj.Key))
+                    continue;
+                out.push({
+                    id: obj.Key.substring(obj.Key.lastIndexOf('/') + 1).replace(/\.json$/, ''),
+                    key: obj.Key,
+                    etag: obj.ETag?.replace(/"/g, '') || undefined,
+                    lastModified: obj.LastModified,
+                    size: obj.Size,
+                });
+            }
+            token = res.IsTruncated ? res.NextContinuationToken : undefined;
+        } while (token);
+        return out;
+    }
+    async read(key) {
+        const res = await this.client.send(new GetObjectCommand({ Bucket: this.bucket, Key: this.resolve(key) }));
+        if (!res.Body) {
+            throw new Error(`empty body for s3://${this.bucket}/${key}`);
+        }
+        const bytes = await res.Body.transformToByteArray();
+        return Buffer.from(bytes);
+    }
+    async write(key, data) {
+        await this.client.send(new PutObjectCommand({
+            Bucket: this.bucket,
+            Key: this.resolve(key),
+            Body: data,
+            ContentType: 'application/json',
+        }));
+    }
+    async delete(key) {
+        await this.client.send(new DeleteObjectCommand({ Bucket: this.bucket, Key: this.resolve(key) }));
+        return true;
+    }
+    async ensureDirectory() {
+        // S3 没有目录对象
+    }
+}
+//# sourceMappingURL=s3.js.map

package/dist/cloud/s3.js.map

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

package/dist/cloud/types.d.ts

@@ -0,0 +1,21 @@
+export interface EntryFile {
+    id: string;
+    /** 完整云端路径（含 rootDir，如 GdContent/content-snapshot.json 或 WebDAV 的绝对路径） */
+    key: string;
+    etag?: string;
+    lastModified?: Date;
+    size?: number;
+}
+/**
+ * 云端抽象：与 App 端 CloudService 对齐的最小子集。
+ * S3 路径 = {rootDir}/{path}；WebDAV 路径 = {serverUrl}/{rootDir}/{path}。
+ */
+export interface CloudProvider {
+    readonly type: 's3' | 'webdav';
+    listFiles(dirPath: string): Promise<EntryFile[]>;
+    read(key: string): Promise<Buffer>;
+    write(key: string, data: Buffer): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    /** 确保 rootDir 与子目录存在（WebDAV 需要 MKCOL，S3 无目录概念直接成功） */
+    ensureDirectory(dirPath: string): Promise<void>;
+}

package/dist/cloud/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cloud/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cloud/types.ts"],"names":[],"mappings":""}

package/dist/cloud/webdav.d.ts

@@ -0,0 +1,23 @@
+import type { CloudProvider, EntryFile } from './types.js';
+export interface WebdavProviderConfig {
+    url: string;
+    username: string;
+    password: string;
+    rootDir: string;
+}
+export declare class WebdavProvider implements CloudProvider {
+    readonly type: "webdav";
+    private readonly client;
+    private readonly rootDir;
+    constructor(cfg: WebdavProviderConfig);
+    /** WebDAV 远端路径带前导斜杠：/{rootDir}/{path}，与 App 端 url() 拼接一致。 */
+    private path;
+    listFiles(dirPath: string): Promise<EntryFile[]>;
+    /** 服务层传相对 rootDir 的 key（content-snapshot.json）或绝对路径（/GdContent/content-snapshot.json），统一归一为绝对路径。 */
+    private resolve;
+    read(key: string): Promise<Buffer>;
+    write(key: string, data: Buffer): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    ensureDirectory(dirPath: string): Promise<void>;
+    private mkcol;
+}

package/dist/cloud/webdav.js

@@ -0,0 +1,96 @@
+import { createClient } from 'webdav';
+const FILE_PATTERN = /\.(json)$/;
+export class WebdavProvider {
+    type = 'webdav';
+    client;
+    rootDir;
+    constructor(cfg) {
+        this.rootDir = cfg.rootDir.replace(/^\/+|\/+$/g, '');
+        this.client = createClient(cfg.url.replace(/\/+$/, ''), {
+            username: cfg.username,
+            password: cfg.password,
+        });
+    }
+    /** WebDAV 远端路径带前导斜杠：/{rootDir}/{path}，与 App 端 url() 拼接一致。 */
+    path(remotePath) {
+        return `/${this.rootDir}/${remotePath.replace(/^\/+/, '')}`;
+    }
+    async listFiles(dirPath) {
+        const dir = this.path(dirPath).replace(/\/+$/, '');
+        const contents = (await this.client.getDirectoryContents(dir, {
+            glob: '*.json',
+        }));
+        const out = [];
+        for (const item of contents) {
+            if (!FILE_PATTERN.test(item.basename))
+                continue;
+            out.push({
+                id: item.basename.replace(/\.json$/, ''),
+                key: item.filename,
+                etag: item.etag?.replace(/"/g, '') || undefined,
+                lastModified: item.lastmod ? new Date(item.lastmod) : undefined,
+                size: item.size,
+            });
+        }
+        return out;
+    }
+    /** 服务层传相对 rootDir 的 key（content-snapshot.json）或绝对路径（/GdContent/content-snapshot.json），统一归一为绝对路径。 */
+    resolve(key) {
+        return key.startsWith('/') ? key : this.path(key);
+    }
+    async read(key) {
+        const buf = await this.client.getFileContents(this.resolve(key), { format: 'binary' });
+        return Buffer.isBuffer(buf) ? buf : Buffer.from(buf);
+    }
+    async write(key, data) {
+        await this.client.putFileContents(this.resolve(key), data, { overwrite: true });
+    }
+    async delete(key) {
+        try {
+            await this.client.deleteFile(this.resolve(key));
+            return true;
+        }
+        catch (e) {
+            if (isMissingObjectError(e))
+                return true; // 已不存在视为成功
+            throw e;
+        }
+    }
+    async ensureDirectory(dirPath) {
+        // 对齐 App 端 ensureDirectory：rootDir 与逐级子目录 MKCOL，已存在（405/parent exists）忽略
+        let current = `/${this.rootDir}`;
+        await this.mkcol(current);
+        for (const segment of dirPath.split('/').filter((s) => s.trim() !== '')) {
+            current = `${current}/${segment}`;
+            await this.mkcol(current);
+        }
+    }
+    async mkcol(path) {
+        try {
+            await this.client.createDirectory(path);
+        }
+        catch (e) {
+            const msg = e.message ?? '';
+            // 已存在（405）或因父目录已存在而报的错都视为成功
+            if (!/405|exists|exist/i.test(msg)) {
+                try {
+                    const ok = await this.client.exists(path);
+                    if (ok)
+                        return;
+                }
+                catch {
+                    /* fallthrough */
+                }
+                throw e;
+            }
+        }
+    }
+}
+function isMissingObjectError(e) {
+    const err = e;
+    const status = err.status ?? err.statusCode;
+    if (status === 404)
+        return true;
+    return (err.message ?? '').toLowerCase().includes('not found');
+}
+//# sourceMappingURL=webdav.js.map

package/dist/cloud/webdav.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,39 @@
+export interface S3Config {
+    endpoint: string;
+    bucket: string;
+    accessKey: string;
+    secretKey: string;
+    region: string;
+    forcePathStyle: boolean;
+}
+export interface WebdavConfig {
+    url: string;
+    username: string;
+    password: string;
+}
+export interface ParsedConfig {
+    cloudType: 's3' | 'webdav';
+    /** 云端根目录，与「好内容」App 云盘同步设置里的目录一致（默认 GdContent，开发包 GdContentDebug） */
+    rootDir: string;
+    /** 折算"今天"用的时区，默认 Asia/Shanghai（与 App 端手机时区对应） */
+    timezone: string;
+    s3?: S3Config;
+    webdav?: WebdavConfig;
+}
+interface RawConfig {
+    cloud_type?: string;
+    root_dir?: string;
+    timezone?: string;
+    s3?: Partial<S3Config>;
+    webdav?: Partial<WebdavConfig>;
+}
+/**
+ * Load config: file first (~/.gudong-content/config.json), then env vars as fallback.
+ * Env var names follow the family CLI convention with a CONTENT_ prefix.
+ */
+export declare function loadConfig(): ParsedConfig;
+export declare function saveConfig(cfg: RawConfig): void;
+export declare function configExists(): boolean;
+export declare function getConfigPath(): string;
+export declare function getConfigDir(): string;
+export {};

package/dist/config.js

@@ -0,0 +1,93 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const CONFIG_DIR = join(homedir(), '.gudong-content');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+/**
+ * Load config: file first (~/.gudong-content/config.json), then env vars as fallback.
+ * Env var names follow the family CLI convention with a CONTENT_ prefix.
+ */
+export function loadConfig() {
+    let raw = {};
+    if (existsSync(CONFIG_FILE)) {
+        raw = JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+    }
+    const env = process.env;
+    const cloudType = raw.cloud_type ?? env.CONTENT_CLOUD_TYPE;
+    if (!cloudType || (cloudType !== 's3' && cloudType !== 'webdav')) {
+        fail('CONTENT_CLOUD_TYPE must be "s3" or "webdav". Run `gudong-content config init` first.');
+    }
+    const rootDir = (raw.root_dir ?? env.CONTENT_ROOT_DIR ?? 'GdContent').replace(/^\/+|\/+$/g, '');
+    const timezone = raw.timezone ?? env.CONTENT_TIMEZONE ?? 'Asia/Shanghai';
+    if (cloudType === 's3') {
+        const s3 = raw.s3 ?? {};
+        const endpoint = s3.endpoint ?? env.CONTENT_S3_ENDPOINT;
+        const bucket = s3.bucket ?? env.CONTENT_S3_BUCKET;
+        const accessKey = s3.accessKey ?? env.CONTENT_S3_ACCESS_KEY;
+        const secretKey = s3.secretKey ?? env.CONTENT_S3_SECRET_KEY;
+        const region = s3.region ?? env.CONTENT_S3_REGION ?? 'auto';
+        const forcePathStyle = s3.forcePathStyle != null
+            ? s3.forcePathStyle
+            : parseBool(env.CONTENT_S3_FORCE_PATH_STYLE, true);
+        if (!endpoint)
+            fail('CONTENT_S3_ENDPOINT is required. Run `gudong-content config init` first.');
+        if (!bucket)
+            fail('CONTENT_S3_BUCKET is required. Run `gudong-content config init` first.');
+        if (!accessKey)
+            fail('CONTENT_S3_ACCESS_KEY is required. Run `gudong-content config init` first.');
+        if (!secretKey)
+            fail('CONTENT_S3_SECRET_KEY is required. Run `gudong-content config init` first.');
+        return {
+            cloudType: 's3',
+            rootDir,
+            timezone,
+            s3: { endpoint: ensureHttps(endpoint), bucket, accessKey, secretKey, region, forcePathStyle },
+        };
+    }
+    const webdav = raw.webdav ?? {};
+    const url = webdav.url ?? env.CONTENT_WEBDAV_URL;
+    const username = webdav.username ?? env.CONTENT_WEBDAV_USERNAME;
+    const password = webdav.password ?? env.CONTENT_WEBDAV_PASSWORD;
+    if (!url)
+        fail('CONTENT_WEBDAV_URL is required. Run `gudong-content config init` first.');
+    if (!username)
+        fail('CONTENT_WEBDAV_USERNAME is required. Run `gudong-content config init` first.');
+    if (!password)
+        fail('CONTENT_WEBDAV_PASSWORD is required. Run `gudong-content config init` first.');
+    return {
+        cloudType: 'webdav',
+        rootDir,
+        timezone,
+        webdav: { url, username, password },
+    };
+}
+export function saveConfig(cfg) {
+    if (!existsSync(CONFIG_DIR))
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2) + '\n', 'utf-8');
+    chmodSync(CONFIG_FILE, 0o600);
+}
+export function configExists() {
+    return existsSync(CONFIG_FILE);
+}
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+export function getConfigDir() {
+    return CONFIG_DIR;
+}
+function ensureHttps(endpoint) {
+    if (endpoint.startsWith('http://') || endpoint.startsWith('https://'))
+        return endpoint;
+    return `https://${endpoint}`;
+}
+function parseBool(v, fallback) {
+    if (v == null)
+        return fallback;
+    return v === 'true' || v === '1';
+}
+function fail(msg) {
+    process.stderr.write(`[gudong-content] config error: ${msg}\n`);
+    process.exit(1);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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