veryfront 0.1.71 → 0.1.73

package/esm/cli/commands/files/command-help.d.ts

@@ -0,0 +1,3 @@
+import type { CommandHelp } from "../../help/types.js";
+export declare const filesHelp: CommandHelp;
+//# sourceMappingURL=command-help.d.ts.map

package/esm/cli/commands/files/command-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/files/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,SAAS,EAAE,WAqCvB,CAAC"}

package/esm/cli/commands/files/command-help.js

@@ -0,0 +1,38 @@
+export const filesHelp = {
+    name: "files",
+    description: "List, read, write, and delete project files",
+    usage: "veryfront files <command> [options]",
+    options: [
+        {
+            flag: "--project, -p <slug>",
+            description: "Project slug override (otherwise inferred from env/config)",
+        },
+        {
+            flag: "--path <prefix>",
+            description: "Prefix filter for files list",
+        },
+        {
+            flag: "--from <path>",
+            description: "Local file to upload with files put",
+        },
+        {
+            flag: "--output, -o <path>",
+            description: "Write files get output to a local file instead of stdout",
+        },
+        {
+            flag: "--json, -j",
+            description: "Output machine-readable JSON",
+        },
+    ],
+    examples: [
+        "veryfront files list --path knowledge/ --json",
+        "veryfront files get knowledge/q1-report.md",
+        "veryfront files put knowledge/q1-report.md --from /workspace/knowledge/q1-report.md",
+        "veryfront files delete knowledge/q1-report.md",
+    ],
+    notes: [
+        "Subcommands: list, get, put, delete",
+        "Uses the project files API, not the uploads store",
+        "Designed for precise sandbox writes where `veryfront push` would be too broad",
+    ],
+};

package/esm/cli/commands/files/command.d.ts

@@ -0,0 +1,105 @@
+import { z } from "zod";
+import { type ApiClient } from "../../shared/config.js";
+import type { ParsedArgs } from "../../shared/types.js";
+import { listAllFiles } from "../pull/command.js";
+type RemoteFileEntry = Awaited<ReturnType<typeof listAllFiles>>[number];
+declare const FilesListArgsSchema: z.ZodObject<{
+    projectSlug: z.ZodOptional<z.ZodString>;
+    projectDir: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    json: z.ZodDefault<z.ZodBoolean>;
+    quiet: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    json: boolean;
+    quiet: boolean;
+    path?: string | undefined;
+    projectSlug?: string | undefined;
+    projectDir?: string | undefined;
+}, {
+    path?: string | undefined;
+    projectSlug?: string | undefined;
+    json?: boolean | undefined;
+    projectDir?: string | undefined;
+    quiet?: boolean | undefined;
+}>;
+declare const FilesGetArgsSchema: z.ZodObject<{
+    projectSlug: z.ZodOptional<z.ZodString>;
+    projectDir: z.ZodOptional<z.ZodString>;
+    remotePath: z.ZodString;
+    output: z.ZodOptional<z.ZodString>;
+    json: z.ZodDefault<z.ZodBoolean>;
+    quiet: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    json: boolean;
+    quiet: boolean;
+    remotePath: string;
+    projectSlug?: string | undefined;
+    projectDir?: string | undefined;
+    output?: string | undefined;
+}, {
+    remotePath: string;
+    projectSlug?: string | undefined;
+    json?: boolean | undefined;
+    projectDir?: string | undefined;
+    output?: string | undefined;
+    quiet?: boolean | undefined;
+}>;
+declare const FilesPutArgsSchema: z.ZodObject<{
+    projectSlug: z.ZodOptional<z.ZodString>;
+    projectDir: z.ZodOptional<z.ZodString>;
+    remotePath: z.ZodString;
+    from: z.ZodString;
+    json: z.ZodDefault<z.ZodBoolean>;
+    quiet: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    json: boolean;
+    from: string;
+    quiet: boolean;
+    remotePath: string;
+    projectSlug?: string | undefined;
+    projectDir?: string | undefined;
+}, {
+    from: string;
+    remotePath: string;
+    projectSlug?: string | undefined;
+    json?: boolean | undefined;
+    projectDir?: string | undefined;
+    quiet?: boolean | undefined;
+}>;
+declare const FilesDeleteArgsSchema: z.ZodObject<{
+    projectSlug: z.ZodOptional<z.ZodString>;
+    projectDir: z.ZodOptional<z.ZodString>;
+    remotePath: z.ZodString;
+    json: z.ZodDefault<z.ZodBoolean>;
+    quiet: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    json: boolean;
+    quiet: boolean;
+    remotePath: string;
+    projectSlug?: string | undefined;
+    projectDir?: string | undefined;
+}, {
+    remotePath: string;
+    projectSlug?: string | undefined;
+    json?: boolean | undefined;
+    projectDir?: string | undefined;
+    quiet?: boolean | undefined;
+}>;
+export type FilesListOptions = z.infer<typeof FilesListArgsSchema>;
+export type FilesGetOptions = z.infer<typeof FilesGetArgsSchema>;
+export type FilesPutOptions = z.infer<typeof FilesPutArgsSchema>;
+export type FilesDeleteOptions = z.infer<typeof FilesDeleteArgsSchema>;
+export declare function parseFilesListArgs(args: ParsedArgs): z.SafeParseReturnType<unknown, FilesListOptions>;
+export declare function parseFilesGetArgs(args: ParsedArgs): z.SafeParseReturnType<unknown, FilesGetOptions>;
+export declare function parseFilesPutArgs(args: ParsedArgs): z.SafeParseReturnType<unknown, FilesPutOptions>;
+export declare function parseFilesDeleteArgs(args: ParsedArgs): z.SafeParseReturnType<unknown, FilesDeleteOptions>;
+export declare function buildRemoteFileUrl(projectSlug: string, remotePath: string): string;
+export declare function listRemoteFiles(client: ApiClient, projectSlug: string, options?: Pick<FilesListOptions, "path">): Promise<RemoteFileEntry[]>;
+export declare function getRemoteFile(client: ApiClient, projectSlug: string, remotePath: string): Promise<string>;
+export declare function putRemoteFileFromLocal(client: ApiClient, projectSlug: string, remotePath: string, localPath: string): Promise<{
+    path: string;
+}>;
+export declare function deleteRemoteFile(client: ApiClient, projectSlug: string, remotePath: string): Promise<void>;
+export declare function filesCommand(args: ParsedArgs): Promise<void>;
+export {};
+//# sourceMappingURL=command.d.ts.map

package/esm/cli/commands/files/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/files/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,KAAK,SAAS,EAA0C,MAAM,wBAAwB,CAAC;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAkB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlE,KAAK,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAMvB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAOtB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAOtB,CAAC;AAEH,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAMzB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACnE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AA4CvE,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,GACf,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAQlD;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,GACf,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,CASjD;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,GACf,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,CASjD;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,GACf,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAQpD;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAGlF;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAM,GAC3C,OAAO,CAAC,eAAe,EAAE,CAAC,CAI5B;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAO3B;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0IlE"}

package/esm/cli/commands/files/command.js

@@ -0,0 +1,250 @@
+import { z } from "zod";
+import { createFileSystem } from "../../../src/platform/index.js";
+import { dirname, normalize } from "../../../src/platform/compat/path/index.js";
+import { withSpan } from "../../../src/observability/tracing/otlp-setup.js";
+import { cliLogger } from "../../utils/index.js";
+import { createApiClient, resolveConfigWithAuth } from "../../shared/config.js";
+import { getFileContent, listAllFiles } from "../pull/command.js";
+const MAIN_SOURCE = { type: "main" };
+const FilesListArgsSchema = z.object({
+    projectSlug: z.string().optional(),
+    projectDir: z.string().optional(),
+    path: z.string().optional(),
+    json: z.boolean().default(false),
+    quiet: z.boolean().default(false),
+});
+const FilesGetArgsSchema = z.object({
+    projectSlug: z.string().optional(),
+    projectDir: z.string().optional(),
+    remotePath: z.string().min(1),
+    output: z.string().optional(),
+    json: z.boolean().default(false),
+    quiet: z.boolean().default(false),
+});
+const FilesPutArgsSchema = z.object({
+    projectSlug: z.string().optional(),
+    projectDir: z.string().optional(),
+    remotePath: z.string().min(1),
+    from: z.string().min(1),
+    json: z.boolean().default(false),
+    quiet: z.boolean().default(false),
+});
+const FilesDeleteArgsSchema = z.object({
+    projectSlug: z.string().optional(),
+    projectDir: z.string().optional(),
+    remotePath: z.string().min(1),
+    json: z.boolean().default(false),
+    quiet: z.boolean().default(false),
+});
+function getStringArg(args, ...keys) {
+    for (const key of keys) {
+        const value = args[key];
+        if (typeof value === "string" && value)
+            return value;
+    }
+    return undefined;
+}
+function getBooleanArg(args, ...keys) {
+    return keys.some((key) => Boolean(args[key]));
+}
+function printJson(value) {
+    console.log(JSON.stringify(value, null, 2));
+}
+function showFilesUsage() {
+    console.log(`
+Veryfront Files
+
+Usage:
+  veryfront files list [options]
+  veryfront files get <remote-path> [--output <local-file>] [options]
+  veryfront files put <remote-path> --from <local-file> [options]
+  veryfront files delete <remote-path> [options]
+
+Subcommands:
+  list     List project files
+  get      Read a remote project file
+  put      Upload a local file into the project files tree
+  delete   Delete a remote project file
+`);
+}
+function normalizeProjectFilePath(remotePath) {
+    const normalizedPath = normalize(remotePath).replace(/^\/+/, "");
+    if (!normalizedPath || normalizedPath.startsWith("..") || normalizedPath.startsWith("/")) {
+        throw new Error(`Invalid remote file path: ${remotePath}`);
+    }
+    return normalizedPath;
+}
+export function parseFilesListArgs(args) {
+    return FilesListArgsSchema.safeParse({
+        projectSlug: getStringArg(args, "project", "p", "project-slug"),
+        projectDir: getStringArg(args, "project-dir", "dir", "d"),
+        path: getStringArg(args, "path"),
+        json: getBooleanArg(args, "json", "j"),
+        quiet: getBooleanArg(args, "quiet", "q"),
+    });
+}
+export function parseFilesGetArgs(args) {
+    return FilesGetArgsSchema.safeParse({
+        projectSlug: getStringArg(args, "project", "p", "project-slug"),
+        projectDir: getStringArg(args, "project-dir", "dir", "d"),
+        remotePath: typeof args._[2] === "string" ? args._[2] : "",
+        output: getStringArg(args, "output", "o"),
+        json: getBooleanArg(args, "json", "j"),
+        quiet: getBooleanArg(args, "quiet", "q"),
+    });
+}
+export function parseFilesPutArgs(args) {
+    return FilesPutArgsSchema.safeParse({
+        projectSlug: getStringArg(args, "project", "p", "project-slug"),
+        projectDir: getStringArg(args, "project-dir", "dir", "d"),
+        remotePath: typeof args._[2] === "string" ? args._[2] : "",
+        from: getStringArg(args, "from") ?? "",
+        json: getBooleanArg(args, "json", "j"),
+        quiet: getBooleanArg(args, "quiet", "q"),
+    });
+}
+export function parseFilesDeleteArgs(args) {
+    return FilesDeleteArgsSchema.safeParse({
+        projectSlug: getStringArg(args, "project", "p", "project-slug"),
+        projectDir: getStringArg(args, "project-dir", "dir", "d"),
+        remotePath: typeof args._[2] === "string" ? args._[2] : "",
+        json: getBooleanArg(args, "json", "j"),
+        quiet: getBooleanArg(args, "quiet", "q"),
+    });
+}
+export function buildRemoteFileUrl(projectSlug, remotePath) {
+    const normalizedPath = normalizeProjectFilePath(remotePath);
+    return `/projects/${projectSlug}/files/${encodeURIComponent(normalizedPath)}`;
+}
+export async function listRemoteFiles(client, projectSlug, options = {}) {
+    const files = await listAllFiles(client, projectSlug, MAIN_SOURCE);
+    if (!options.path)
+        return files;
+    return files.filter((file) => file.path.startsWith(options.path));
+}
+export async function getRemoteFile(client, projectSlug, remotePath) {
+    return getFileContent(client, projectSlug, normalizeProjectFilePath(remotePath), MAIN_SOURCE);
+}
+export async function putRemoteFileFromLocal(client, projectSlug, remotePath, localPath) {
+    const fs = createFileSystem();
+    const content = await fs.readTextFile(localPath);
+    const result = await client.put(buildRemoteFileUrl(projectSlug, remotePath), {
+        content,
+    });
+    return { path: result.path ?? normalizeProjectFilePath(remotePath) };
+}
+export async function deleteRemoteFile(client, projectSlug, remotePath) {
+    await client.delete(buildRemoteFileUrl(projectSlug, remotePath));
+}
+export async function filesCommand(args) {
+    const subcommand = typeof args._[1] === "string" ? args._[1] : undefined;
+    if (!subcommand || subcommand === "help") {
+        showFilesUsage();
+        return;
+    }
+    await withSpan("cli.command.files", async () => {
+        switch (subcommand) {
+            case "list": {
+                const parsed = parseFilesListArgs(args);
+                if (!parsed.success) {
+                    throw new Error(`Invalid files list arguments: ${parsed.error.message}`);
+                }
+                const options = parsed.data;
+                let config = await resolveConfigWithAuth(options.projectDir);
+                if (options.projectSlug)
+                    config = { ...config, projectSlug: options.projectSlug };
+                const client = createApiClient(config);
+                const files = await listRemoteFiles(client, config.projectSlug, options);
+                if (options.json) {
+                    printJson(files);
+                    return;
+                }
+                if (!files.length) {
+                    cliLogger.info("No files found.");
+                    return;
+                }
+                for (const file of files) {
+                    console.log(file.path);
+                }
+                return;
+            }
+            case "get": {
+                const parsed = parseFilesGetArgs(args);
+                if (!parsed.success) {
+                    throw new Error(`Invalid files get arguments: ${parsed.error.message}`);
+                }
+                const options = parsed.data;
+                let config = await resolveConfigWithAuth(options.projectDir);
+                if (options.projectSlug)
+                    config = { ...config, projectSlug: options.projectSlug };
+                const client = createApiClient(config);
+                const content = await getRemoteFile(client, config.projectSlug, options.remotePath);
+                if (options.output) {
+                    const fs = createFileSystem();
+                    await fs.mkdir(dirname(options.output), { recursive: true });
+                    await fs.writeTextFile(options.output, content);
+                    if (options.json) {
+                        printJson({
+                            path: normalizeProjectFilePath(options.remotePath),
+                            output: options.output,
+                        });
+                        return;
+                    }
+                    if (!options.quiet) {
+                        cliLogger.info(`Downloaded ${normalizeProjectFilePath(options.remotePath)} -> ${options.output}`);
+                    }
+                    return;
+                }
+                if (options.json) {
+                    printJson({ path: normalizeProjectFilePath(options.remotePath), content });
+                    return;
+                }
+                console.log(content);
+                return;
+            }
+            case "put": {
+                const parsed = parseFilesPutArgs(args);
+                if (!parsed.success) {
+                    throw new Error(`Invalid files put arguments: ${parsed.error.message}`);
+                }
+                const options = parsed.data;
+                let config = await resolveConfigWithAuth(options.projectDir);
+                if (options.projectSlug)
+                    config = { ...config, projectSlug: options.projectSlug };
+                const client = createApiClient(config);
+                const result = await putRemoteFileFromLocal(client, config.projectSlug, options.remotePath, options.from);
+                if (options.json) {
+                    printJson(result);
+                    return;
+                }
+                if (!options.quiet) {
+                    cliLogger.info(`Uploaded ${options.from} -> ${result.path}`);
+                }
+                return;
+            }
+            case "delete":
+            case "rm": {
+                const parsed = parseFilesDeleteArgs(args);
+                if (!parsed.success) {
+                    throw new Error(`Invalid files delete arguments: ${parsed.error.message}`);
+                }
+                const options = parsed.data;
+                let config = await resolveConfigWithAuth(options.projectDir);
+                if (options.projectSlug)
+                    config = { ...config, projectSlug: options.projectSlug };
+                const client = createApiClient(config);
+                await deleteRemoteFile(client, config.projectSlug, options.remotePath);
+                if (options.json) {
+                    printJson({ success: true, path: normalizeProjectFilePath(options.remotePath) });
+                    return;
+                }
+                if (!options.quiet) {
+                    cliLogger.info(`Deleted ${normalizeProjectFilePath(options.remotePath)}`);
+                }
+                return;
+            }
+            default:
+                showFilesUsage();
+        }
+    });
+}

package/esm/cli/commands/files/handler.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedArgs } from "../../shared/types.js";
+export declare function handleFilesCommand(args: ParsedArgs): Promise<void>;
+//# sourceMappingURL=handler.d.ts.map

package/esm/cli/commands/files/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/files/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAExE"}

package/esm/cli/commands/files/handler.js

@@ -0,0 +1,4 @@
+import { filesCommand } from "./command.js";
+export async function handleFilesCommand(args) {
+    await filesCommand(args);
+}

package/esm/cli/commands/files/index.d.ts

@@ -0,0 +1,4 @@
+export { buildRemoteFileUrl, deleteRemoteFile, filesCommand, getRemoteFile, listRemoteFiles, parseFilesDeleteArgs, parseFilesGetArgs, parseFilesListArgs, parseFilesPutArgs, putRemoteFileFromLocal, } from "./command.js";
+export type { FilesDeleteOptions, FilesGetOptions, FilesListOptions, FilesPutOptions, } from "./command.js";
+export { handleFilesCommand } from "./handler.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/cli/commands/files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/files/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/esm/cli/commands/files/index.js

@@ -0,0 +1,2 @@
+export { buildRemoteFileUrl, deleteRemoteFile, filesCommand, getRemoteFile, listRemoteFiles, parseFilesDeleteArgs, parseFilesGetArgs, parseFilesListArgs, parseFilesPutArgs, putRemoteFileFromLocal, } from "./command.js";
+export { handleFilesCommand } from "./handler.js";

package/esm/cli/commands/knowledge/command-help.d.ts

@@ -0,0 +1,3 @@
+import type { CommandHelp } from "../../help/types.js";
+export declare const knowledgeHelp: CommandHelp;
+//# sourceMappingURL=command-help.d.ts.map

package/esm/cli/commands/knowledge/command-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,aAAa,EAAE,WAqC3B,CAAC"}

package/esm/cli/commands/knowledge/command-help.js

@@ -0,0 +1,38 @@
+export const knowledgeHelp = {
+    name: "knowledge",
+    description: "Ingest documents into the project knowledge base",
+    usage: "veryfront knowledge ingest <source> [options]",
+    options: [
+        {
+            flag: "--project, -p <slug>",
+            description: "Project slug override (otherwise inferred from env/config)",
+        },
+        {
+            flag: "--path <prefix>",
+            description: "Upload prefix or local directory used with --all",
+        },
+        {
+            flag: "--all",
+            description: "Ingest all files under the given --path prefix or directory",
+        },
+        {
+            flag: "--recursive",
+            description: "Recurse into subdirectories for local directory ingestion",
+        },
+        {
+            flag: "--json, -j",
+            description: "Output machine-readable JSON",
+        },
+    ],
+    examples: [
+        "veryfront knowledge ingest uploads/contracts/q1.pdf --json",
+        "veryfront knowledge ingest /workspace/uploads/q1.pdf --json",
+        "veryfront knowledge ingest --path uploads/ --all --json",
+    ],
+    notes: [
+        "Primary subcommand: ingest",
+        "`uploads/...` means a remote project upload; use `./uploads/...` or `/workspace/uploads/...` to force a local file",
+        "`ingest` orchestrates upload resolution, parsing, and project file writes",
+        "Requires python3; non-text formats also require the supported parser packages unless you run inside the Veryfront sandbox",
+    ],
+};

package/esm/cli/commands/knowledge/command.d.ts

@@ -0,0 +1,122 @@
+import { z } from "zod";
+import { type ApiClient } from "../../shared/config.js";
+import type { ParsedArgs } from "../../shared/types.js";
+export interface KnowledgeParserResult {
+    success: true;
+    source_path: string;
+    source_filename: string;
+    source_type: string;
+    slug: string;
+    sandbox_output_path: string;
+    suggested_project_path: string;
+    description: string;
+    title: string;
+    summary: string;
+    stats: Record<string, unknown>;
+    warnings: string[];
+}
+export interface KnowledgeIngestFileResult {
+    source: string;
+    localSourcePath: string;
+    outputPath: string;
+    remotePath: string;
+    slug: string;
+    sourceType: string;
+    summary: string;
+    stats: Record<string, unknown>;
+    warnings: string[];
+}
+type KnowledgeSource = {
+    kind: "local";
+    input: string;
+    localPath: string;
+} | {
+    kind: "upload";
+    input: string;
+    uploadPath: string;
+    localPath: string;
+};
+type DownloadResult = {
+    uploadPath: string;
+    localPath: string;
+    bytes?: number;
+};
+declare const KnowledgeIngestArgsSchema: z.ZodObject<{
+    projectSlug: z.ZodOptional<z.ZodString>;
+    projectDir: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    all: z.ZodDefault<z.ZodBoolean>;
+    recursive: z.ZodDefault<z.ZodBoolean>;
+    outputDir: z.ZodOptional<z.ZodString>;
+    knowledgePath: z.ZodDefault<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    json: z.ZodDefault<z.ZodBoolean>;
+    quiet: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    json: boolean;
+    recursive: boolean;
+    all: boolean;
+    quiet: boolean;
+    knowledgePath: string;
+    path?: string | undefined;
+    projectSlug?: string | undefined;
+    description?: string | undefined;
+    outputDir?: string | undefined;
+    projectDir?: string | undefined;
+    slug?: string | undefined;
+    source?: string | undefined;
+}, {
+    path?: string | undefined;
+    projectSlug?: string | undefined;
+    description?: string | undefined;
+    outputDir?: string | undefined;
+    json?: boolean | undefined;
+    recursive?: boolean | undefined;
+    projectDir?: string | undefined;
+    slug?: string | undefined;
+    all?: boolean | undefined;
+    source?: string | undefined;
+    quiet?: boolean | undefined;
+    knowledgePath?: string | undefined;
+}>;
+export type KnowledgeIngestOptions = z.infer<typeof KnowledgeIngestArgsSchema>;
+export declare function parseKnowledgeIngestArgs(args: ParsedArgs): z.SafeParseReturnType<unknown, KnowledgeIngestOptions>;
+export declare function normalizeKnowledgeInputPath(inputPath: string): string;
+export declare function normalizeProjectUploadPath(inputPath: string): string;
+export declare function formatKnowledgeUploadSource(uploadPath: string): string;
+export declare function isLikelyLocalPath(value: string): boolean;
+export declare function resolveKnowledgeDownloadOutputDir(outputDir: string): string;
+export declare function deriveKnowledgeRemotePath(outputPath: string, outputDir: string, knowledgePath: string): string;
+export declare function createKnowledgeIngestResult(input: {
+    source: string;
+    localSourcePath: string;
+    outputPath: string;
+    remotePath: string;
+    parser: Pick<KnowledgeParserResult, "slug" | "stats" | "warnings" | "source_type" | "summary">;
+}): KnowledgeIngestFileResult;
+export declare function runKnowledgeParser(input: {
+    filePath: string;
+    outputDir: string;
+    description?: string;
+    slug?: string;
+    sourceReference?: string;
+}): Promise<KnowledgeParserResult>;
+export declare function collectKnowledgeSources(options: Pick<KnowledgeIngestOptions, "source" | "path" | "all" | "recursive">, deps: {
+    client: ApiClient;
+    projectSlug: string;
+    downloadUploads: (uploadPaths: string[]) => Promise<DownloadResult[]>;
+}): Promise<KnowledgeSource[]>;
+export declare function ingestResolvedSources(sources: KnowledgeSource[], options: KnowledgeIngestOptions, deps: {
+    client: ApiClient;
+    projectSlug: string;
+    outputDir: string;
+    runParser: typeof runKnowledgeParser;
+    uploadKnowledgeFile: (remotePath: string, localPath: string) => Promise<{
+        path: string;
+    }>;
+}): Promise<KnowledgeIngestFileResult[]>;
+export declare function knowledgeCommand(args: ParsedArgs): Promise<void>;
+export {};
+//# sourceMappingURL=command.d.ts.map

package/esm/cli/commands/knowledge/command.d.ts.map

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