sourceloop 0.1.1

package/dist/core/attach/launch-managed-chrome.d.ts

@@ -0,0 +1,27 @@
+import { type ChildProcess } from "node:child_process";
+import { type RegisterChromeAttachTargetResult } from "./manage-targets.js";
+import { allocateFreePort, resolveChromeExecutablePath, waitForRemoteDebuggingEndpoint } from "../notebooklm/browser-agent.js";
+export type LaunchManagedChromeInput = {
+    name?: string;
+    chromeExecutablePath?: string;
+    remoteDebuggingPort?: number;
+    launchArgs?: string[];
+    description?: string;
+    force?: boolean;
+    cwd?: string;
+};
+export type LaunchManagedChromeResult = RegisterChromeAttachTargetResult & {
+    endpoint: string;
+    profileDirPath: string;
+    launched: boolean;
+    reusedTarget: boolean;
+};
+type SpawnedChromeProcess = Pick<ChildProcess, "kill" | "unref">;
+type LaunchManagedChromeDeps = {
+    resolveChromeExecutablePath: typeof resolveChromeExecutablePath;
+    allocateFreePort: typeof allocateFreePort;
+    waitForRemoteDebuggingEndpoint: typeof waitForRemoteDebuggingEndpoint;
+    spawnChromeProcess: (executablePath: string, args: string[]) => SpawnedChromeProcess;
+};
+export declare function launchManagedChrome(input: LaunchManagedChromeInput, deps?: LaunchManagedChromeDeps): Promise<LaunchManagedChromeResult>;
+export {};

package/dist/core/attach/launch-managed-chrome.js

@@ -0,0 +1,136 @@
+import { mkdir } from "node:fs/promises";
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { getVaultPaths } from "../vault/paths.js";
+import { loadWorkspace } from "../workspace/load-workspace.js";
+import { slugify } from "../../lib/slugify.js";
+import { loadChromeAttachTarget, registerChromeProfileTarget } from "./manage-targets.js";
+import { allocateFreePort, resolveChromeExecutablePath, waitForRemoteDebuggingEndpoint } from "../notebooklm/browser-agent.js";
+const defaultDeps = {
+    resolveChromeExecutablePath,
+    allocateFreePort,
+    waitForRemoteDebuggingEndpoint,
+    spawnChromeProcess(executablePath, args) {
+        return spawn(executablePath, args, {
+            detached: true,
+            stdio: "ignore"
+        });
+    }
+};
+export async function launchManagedChrome(input, deps = defaultDeps) {
+    const workspace = await loadWorkspace(input.cwd);
+    const vault = getVaultPaths(workspace);
+    const name = input.name?.trim() || "research-browser";
+    const slug = slugify(name) || "research-browser";
+    const profileDirPath = path.join(vault.chromeProfilesDir, slug);
+    const targetId = `attach-${slug}`;
+    await mkdir(vault.chromeProfilesDir, { recursive: true });
+    await mkdir(profileDirPath, { recursive: true });
+    const existingTarget = await loadExistingTarget(targetId, workspace.rootDir);
+    if (existingTarget && !isSourceLoopManagedLaunchTarget(existingTarget.target) && !input.force) {
+        throw new Error(`Attach target ${targetId} already exists and is not a SourceLoop-managed isolated profile. Re-run with --force to replace it.`);
+    }
+    const reusableTarget = existingTarget && isSourceLoopManagedLaunchTarget(existingTarget.target)
+        ? existingTarget.target
+        : undefined;
+    const executablePath = await deps.resolveChromeExecutablePath(input.chromeExecutablePath ?? reusableTarget?.chromeExecutablePath);
+    const remoteDebuggingPort = input.remoteDebuggingPort ??
+        reusableTarget?.remoteDebuggingPort ??
+        (await deps.allocateFreePort());
+    const endpoint = `http://127.0.0.1:${remoteDebuggingPort}`;
+    if (reusableTarget && !input.force) {
+        try {
+            await deps.waitForRemoteDebuggingEndpoint(endpoint, 750);
+            const persisted = await registerChromeProfileTarget(buildRegisterInput({
+                cwd: workspace.rootDir,
+                name,
+                profileDirPath,
+                executablePath,
+                remoteDebuggingPort,
+                launchArgs: input.launchArgs ?? reusableTarget.launchArgs,
+                description: input.description ?? reusableTarget.description,
+                createdAt: reusableTarget.createdAt,
+                notebooklmReadiness: reusableTarget.notebooklmReadiness,
+                notebooklmValidatedAt: reusableTarget.notebooklmValidatedAt,
+                force: true
+            }));
+            return {
+                ...persisted,
+                endpoint,
+                profileDirPath,
+                launched: false,
+                reusedTarget: true
+            };
+        }
+        catch {
+            // endpoint not already serving this target; continue to launch
+        }
+    }
+    const launchArgs = [
+        `--user-data-dir=${profileDirPath}`,
+        `--remote-debugging-port=${remoteDebuggingPort}`,
+        "--no-first-run",
+        "--no-default-browser-check",
+        ...(input.launchArgs ?? reusableTarget?.launchArgs ?? []),
+        "https://notebooklm.google.com/"
+    ];
+    const processHandle = deps.spawnChromeProcess(executablePath, launchArgs);
+    try {
+        await deps.waitForRemoteDebuggingEndpoint(endpoint, 15_000);
+    }
+    catch (error) {
+        processHandle.kill("SIGTERM");
+        throw error;
+    }
+    processHandle.unref?.();
+    const persisted = await registerChromeProfileTarget(buildRegisterInput({
+        cwd: workspace.rootDir,
+        name,
+        profileDirPath,
+        executablePath,
+        remoteDebuggingPort,
+        launchArgs: input.launchArgs ?? reusableTarget?.launchArgs,
+        description: input.description ?? reusableTarget?.description,
+        createdAt: reusableTarget?.createdAt,
+        notebooklmReadiness: reusableTarget?.notebooklmReadiness,
+        notebooklmValidatedAt: reusableTarget?.notebooklmValidatedAt,
+        force: Boolean(existingTarget)
+    }));
+    return {
+        ...persisted,
+        endpoint,
+        profileDirPath,
+        launched: true,
+        reusedTarget: Boolean(reusableTarget)
+    };
+}
+function isSourceLoopManagedLaunchTarget(target) {
+    return target.targetType === "profile" && target.ownership === "sourceloop_managed" && target.profileIsolation === "isolated";
+}
+async function loadExistingTarget(targetId, cwd) {
+    try {
+        const loaded = await loadChromeAttachTarget(targetId, cwd);
+        return { target: loaded.target };
+    }
+    catch {
+        return undefined;
+    }
+}
+function buildRegisterInput(input) {
+    return {
+        cwd: input.cwd,
+        name: input.name,
+        profileDirPath: input.profileDirPath,
+        ownership: "sourceloop_managed",
+        profileIsolation: "isolated",
+        chromeExecutablePath: input.executablePath,
+        remoteDebuggingPort: input.remoteDebuggingPort,
+        ...(input.launchArgs ? { launchArgs: input.launchArgs } : {}),
+        ...(input.description ? { description: input.description } : {}),
+        ...(input.createdAt ? { createdAt: input.createdAt } : {}),
+        ...(input.notebooklmReadiness ? { notebooklmReadiness: input.notebooklmReadiness } : {}),
+        ...(input.notebooklmValidatedAt ? { notebooklmValidatedAt: input.notebooklmValidatedAt } : {}),
+        force: input.force
+    };
+}
+//# sourceMappingURL=launch-managed-chrome.js.map

package/dist/core/attach/launch-managed-chrome.js.map

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

package/dist/core/attach/manage-targets.d.ts

@@ -0,0 +1,49 @@
+import { loadWorkspace } from "../workspace/load-workspace.js";
+import { type ChromeAttachTarget, type ChromeAttachOwnership, type ChromeNotebooklmReadiness, type ChromeProfileIsolation } from "../../schemas/attach.js";
+type RegisterChromeProfileTargetInput = {
+    name: string;
+    profileDirPath: string;
+    profileIsolation?: ChromeProfileIsolation;
+    ownership?: Exclude<ChromeAttachOwnership, "external">;
+    notebooklmReadiness?: ChromeNotebooklmReadiness;
+    notebooklmValidatedAt?: string;
+    chromeExecutablePath?: string;
+    remoteDebuggingPort?: number;
+    launchArgs?: string[];
+    description?: string;
+    createdAt?: string;
+    force?: boolean;
+    cwd?: string;
+};
+type RegisterChromeEndpointTargetInput = {
+    name: string;
+    endpoint: string;
+    profileIsolation?: ChromeProfileIsolation;
+    notebooklmReadiness?: ChromeNotebooklmReadiness;
+    notebooklmValidatedAt?: string;
+    description?: string;
+    force?: boolean;
+    cwd?: string;
+};
+export type RegisterChromeAttachTargetResult = {
+    target: ChromeAttachTarget;
+    markdownPath: string;
+    jsonPath: string;
+};
+export declare function registerChromeProfileTarget(input: RegisterChromeProfileTargetInput): Promise<RegisterChromeAttachTargetResult>;
+export declare function registerChromeEndpointTarget(input: RegisterChromeEndpointTargetInput): Promise<RegisterChromeAttachTargetResult>;
+export declare function loadChromeAttachTarget(targetId: string, cwd?: string): Promise<{
+    workspace: Awaited<ReturnType<typeof loadWorkspace>>;
+    target: ChromeAttachTarget;
+    path: string;
+}>;
+export declare function upsertChromeAttachTarget(target: ChromeAttachTarget, input?: {
+    cwd?: string;
+    force?: boolean;
+}): Promise<RegisterChromeAttachTargetResult>;
+export declare function listChromeAttachTargets(cwd?: string): Promise<ChromeAttachTarget[]>;
+export declare function removeChromeAttachTarget(input: {
+    targetId: string;
+    cwd?: string;
+}): Promise<void>;
+export {};

package/dist/core/attach/manage-targets.js

@@ -0,0 +1,179 @@
+import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { loadWorkspace } from "../workspace/load-workspace.js";
+import { chromeAttachTargetSchema } from "../../schemas/attach.js";
+import { slugify } from "../../lib/slugify.js";
+import { getVaultPaths } from "../vault/paths.js";
+import { writeJsonFile } from "../../lib/write-json.js";
+import { makeAliases, makeTags, normalizeObsidianText } from "../../lib/obsidian.js";
+import { toFrontmatterMarkdown } from "../ingest/frontmatter.js";
+import { getChromeTargetNote } from "../vault/notes.js";
+export async function registerChromeProfileTarget(input) {
+    return persistChromeAttachTarget(input.cwd, chromeAttachTargetSchema.parse({
+        id: `attach-${slugify(input.name)}`,
+        type: "chrome_attach_target",
+        name: input.name,
+        description: input.description,
+        profileIsolation: input.profileIsolation ?? "unknown",
+        ownership: input.ownership ?? "user_managed",
+        notebooklmReadiness: input.notebooklmReadiness ?? "unknown",
+        notebooklmValidatedAt: input.notebooklmValidatedAt,
+        targetType: "profile",
+        profileDirPath: path.resolve(input.profileDirPath),
+        chromeExecutablePath: input.chromeExecutablePath ? path.resolve(input.chromeExecutablePath) : undefined,
+        remoteDebuggingPort: input.remoteDebuggingPort,
+        launchArgs: input.launchArgs ?? [],
+        createdAt: input.createdAt ?? new Date().toISOString()
+    }), input.force ?? false);
+}
+export async function registerChromeEndpointTarget(input) {
+    return persistChromeAttachTarget(input.cwd, chromeAttachTargetSchema.parse({
+        id: `attach-${slugify(input.name)}`,
+        type: "chrome_attach_target",
+        name: input.name,
+        description: input.description,
+        profileIsolation: input.profileIsolation ?? "unknown",
+        ownership: "external",
+        notebooklmReadiness: input.notebooklmReadiness ?? "unknown",
+        notebooklmValidatedAt: input.notebooklmValidatedAt,
+        targetType: "remote_debugging_endpoint",
+        endpoint: input.endpoint,
+        createdAt: new Date().toISOString()
+    }), input.force ?? false);
+}
+export async function loadChromeAttachTarget(targetId, cwd) {
+    const workspace = await loadWorkspace(cwd);
+    const vault = getVaultPaths(workspace);
+    const targetPath = path.join(vault.chromeTargetsDir, `${targetId}.json`);
+    const raw = await readFile(targetPath, "utf8");
+    const target = chromeAttachTargetSchema.parse(JSON.parse(raw));
+    return { workspace, target, path: targetPath };
+}
+export async function upsertChromeAttachTarget(target, input) {
+    return persistChromeAttachTarget(input?.cwd, target, input?.force ?? true);
+}
+export async function listChromeAttachTargets(cwd) {
+    const workspace = await loadWorkspace(cwd);
+    const vault = getVaultPaths(workspace);
+    try {
+        const entries = await readdir(vault.chromeTargetsDir);
+        const jsonFiles = entries.filter((entry) => entry.endsWith(".json"));
+        const raw = await Promise.all(jsonFiles.map((entry) => readFile(path.join(vault.chromeTargetsDir, entry), "utf8")));
+        return raw.map((value) => chromeAttachTargetSchema.parse(JSON.parse(value))).sort((left, right) => left.name.localeCompare(right.name));
+    }
+    catch (error) {
+        if (isMissingDirectoryError(error)) {
+            return [];
+        }
+        throw error;
+    }
+}
+export async function removeChromeAttachTarget(input) {
+    const workspace = await loadWorkspace(input.cwd);
+    const vault = getVaultPaths(workspace);
+    const basePath = path.join(vault.chromeTargetsDir, input.targetId);
+    let notePath = `${basePath}.md`;
+    try {
+        const raw = await readFile(`${basePath}.json`, "utf8");
+        const target = chromeAttachTargetSchema.parse(JSON.parse(raw));
+        notePath = getChromeTargetNote(workspace, target).absolutePath;
+    }
+    catch {
+        // fall back to the legacy id-first markdown path
+    }
+    await Promise.all([rm(`${basePath}.json`, { force: true }), rm(notePath, { force: true }), rm(`${basePath}.md`, { force: true })]);
+}
+async function persistChromeAttachTarget(cwd, target, force) {
+    const workspace = await loadWorkspace(cwd);
+    const vault = getVaultPaths(workspace);
+    await mkdir(vault.chromeTargetsDir, { recursive: true });
+    const basePath = path.join(vault.chromeTargetsDir, target.id);
+    const jsonPath = `${basePath}.json`;
+    const markdownPath = getChromeTargetNote(workspace, target).absolutePath;
+    if (!force && (await fileExists(jsonPath))) {
+        throw new Error(`Chrome attach target ${target.id} already exists. Re-run with --force to overwrite it.`);
+    }
+    await writeJsonFile(jsonPath, target);
+    await writeFile(markdownPath, buildChromeAttachMarkdown(target), "utf8");
+    return {
+        target,
+        markdownPath,
+        jsonPath
+    };
+}
+function buildChromeAttachMarkdown(target) {
+    const title = normalizeObsidianText(target.name, target.id);
+    const frontmatter = target.targetType === "profile"
+        ? {
+            type: "chrome-target",
+            title,
+            aliases: makeAliases(target.id),
+            tags: makeTags("sourceloop", "chrome-target", target.targetType),
+            mode: target.targetType,
+            ...(target.description ? { description: target.description } : {}),
+            created: target.createdAt,
+            updated: target.createdAt
+        }
+        : {
+            type: "chrome-target",
+            title,
+            aliases: makeAliases(target.id),
+            tags: makeTags("sourceloop", "chrome-target", target.targetType),
+            mode: target.targetType,
+            ...(target.description ? { description: target.description } : {}),
+            created: target.createdAt,
+            updated: target.createdAt
+        };
+    return toFrontmatterMarkdown(frontmatter, buildChromeAttachBody(target));
+}
+function buildChromeAttachBody(target) {
+    const lines = [
+        `# ${normalizeObsidianText(target.name, target.id)}`,
+        "",
+        `- Target Type: ${target.targetType}`,
+        `- Profile Isolation: ${target.profileIsolation}`,
+        `- Ownership: ${target.ownership}`,
+        `- NotebookLM Readiness: ${target.notebooklmReadiness}`
+    ];
+    if (target.notebooklmValidatedAt) {
+        lines.push(`- NotebookLM Validated At: ${target.notebooklmValidatedAt}`);
+    }
+    if (target.targetType === "profile") {
+        appendProfileBody(lines, target);
+    }
+    else {
+        appendEndpointBody(lines, target);
+    }
+    if (target.description) {
+        lines.push("", "## Description", target.description);
+    }
+    return lines.join("\n");
+}
+function appendProfileBody(lines, target) {
+    lines.push(`- Profile Directory: ${target.profileDirPath}`);
+    if (target.chromeExecutablePath) {
+        lines.push(`- Chrome Executable: ${target.chromeExecutablePath}`);
+    }
+    if (target.remoteDebuggingPort) {
+        lines.push(`- Preferred Remote Debugging Port: ${target.remoteDebuggingPort}`);
+    }
+    if (target.launchArgs.length > 0) {
+        lines.push("", "## Launch Args", ...target.launchArgs.map((arg) => `- ${arg}`));
+    }
+}
+function appendEndpointBody(lines, target) {
+    lines.push(`- Endpoint: ${target.endpoint}`);
+}
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isMissingDirectoryError(error) {
+    return Boolean(error && typeof error === "object" && "code" in error && error.code === "ENOENT");
+}
+//# sourceMappingURL=manage-targets.js.map

package/dist/core/attach/manage-targets.js.map

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

package/dist/core/ingest/frontmatter.d.ts

@@ -0,0 +1,4 @@
+type FrontmatterValue = string | string[] | undefined;
+type FrontmatterRecord = Record<string, FrontmatterValue>;
+export declare function toFrontmatterMarkdown(metadata: FrontmatterRecord, body: string): string;
+export {};

package/dist/core/ingest/frontmatter.js

@@ -0,0 +1,30 @@
+export function toFrontmatterMarkdown(metadata, body) {
+    const lines = ["---"];
+    for (const [key, value] of Object.entries(metadata)) {
+        if (value === undefined) {
+            continue;
+        }
+        if (Array.isArray(value)) {
+            lines.push(`${key}:`);
+            if (value.length === 0) {
+                lines.push("  []");
+            }
+            else {
+                for (const entry of value) {
+                    lines.push(`  - ${escapeScalar(entry)}`);
+                }
+            }
+            continue;
+        }
+        lines.push(`${key}: ${escapeScalar(value)}`);
+    }
+    lines.push("---", "", body.trimEnd(), "");
+    return lines.join("\n");
+}
+function escapeScalar(value) {
+    if (/^[A-Za-z0-9._:/-]+$/.test(value)) {
+        return value;
+    }
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/core/ingest/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../src/core/ingest/frontmatter.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,qBAAqB,CAAC,QAA2B,EAAE,IAAY;IAC7E,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;IAEtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;YAEtB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;oBAC1B,KAAK,CAAC,IAAI,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;YAED,SAAS;QACX,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/core/ingest/html-to-markdown.d.ts

@@ -0,0 +1,5 @@
+export declare function htmlToMarkdown(html: string): {
+    title: string;
+    body: string;
+    language?: string;
+};

package/dist/core/ingest/html-to-markdown.js

@@ -0,0 +1,53 @@
+export function htmlToMarkdown(html) {
+    const title = extractTitle(html) ?? "Untitled";
+    const language = extractLanguage(html);
+    const stripped = stripHtmlToText(html);
+    const body = `# ${title}\n\n${stripped}`.trim();
+    return language
+        ? {
+            title,
+            body,
+            language
+        }
+        : {
+            title,
+            body
+        };
+}
+function extractTitle(html) {
+    const match = html.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+    if (!match) {
+        return undefined;
+    }
+    return decodeEntities(match[1] ?? "").trim();
+}
+function extractLanguage(html) {
+    const match = html.match(/<html[^>]*\slang=["']([^"']+)["']/i);
+    return match?.[1]?.trim() || undefined;
+}
+function stripHtmlToText(html) {
+    const withoutScripts = html
+        .replace(/<script[\s\S]*?<\/script>/gi, " ")
+        .replace(/<style[\s\S]*?<\/style>/gi, " ");
+    const blockSeparated = withoutScripts
+        .replace(/<\/(p|div|section|article|li|h1|h2|h3|h4|h5|h6|br)>/gi, "\n")
+        .replace(/<(ul|ol)>/gi, "\n")
+        .replace(/<(li)>/gi, "- ");
+    const noTags = blockSeparated.replace(/<[^>]+>/g, " ");
+    const decoded = decodeEntities(noTags);
+    return decoded
+        .split("\n")
+        .map((line) => line.replace(/[ \t]+/g, " ").trim())
+        .filter(Boolean)
+        .join("\n\n");
+}
+function decodeEntities(value) {
+    return value
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'");
+}
+//# sourceMappingURL=html-to-markdown.js.map

package/dist/core/ingest/html-to-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-markdown.js","sourceRoot":"","sources":["../../../src/core/ingest/html-to-markdown.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC;IAC/C,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,KAAK,OAAO,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;IAEhD,OAAO,QAAQ;QACb,CAAC,CAAC;YACE,KAAK;YACL,IAAI;YACJ,QAAQ;SACT;QACH,CAAC,CAAC;YACE,KAAK;YACL,IAAI;SACL,CAAC;AACR,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAE7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAE/D,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AACzC,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,cAAc,GAAG,IAAI;SACxB,OAAO,CAAC,6BAA6B,EAAE,GAAG,CAAC;SAC3C,OAAO,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;IAE7C,MAAM,cAAc,GAAG,cAAc;SAClC,OAAO,CAAC,uDAAuD,EAAE,IAAI,CAAC;SACtE,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC;SAC5B,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAE7B,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvC,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;SAClD,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/dist/core/ingest/ingest-source.d.ts

@@ -0,0 +1,11 @@
+import { type SourceDocument } from "../../schemas/source.js";
+export type IngestSourceInput = {
+    input: string;
+    topicId?: string;
+    cwd?: string;
+};
+export type IngestSourceResult = {
+    source: SourceDocument;
+    outputPath: string;
+};
+export declare function ingestSource(input: IngestSourceInput): Promise<IngestSourceResult>;

package/dist/core/ingest/ingest-source.js

@@ -0,0 +1,115 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { loadWorkspace } from "../workspace/load-workspace.js";
+import { sourceDocumentSchema } from "../../schemas/source.js";
+import { htmlToMarkdown } from "./html-to-markdown.js";
+import { toFrontmatterMarkdown } from "./frontmatter.js";
+import { loadTopic, refreshTopicArtifacts } from "../topics/manage-topics.js";
+import { writeJsonFile } from "../../lib/write-json.js";
+import { makeAliases, makeTags, normalizeObsidianText } from "../../lib/obsidian.js";
+import { getSourceNote } from "../vault/notes.js";
+export async function ingestSource(input) {
+    const cwd = input.cwd ?? process.cwd();
+    const workspace = await loadWorkspace(cwd);
+    const now = new Date().toISOString();
+    if (input.topicId) {
+        await loadTopic(input.topicId, cwd);
+    }
+    if (isUrl(input.input)) {
+        const source = await ingestUrl(input.input, now, input.topicId);
+        const outputPath = await writeSourceArtifact(workspace.rootDir, source);
+        if (input.topicId) {
+            await refreshTopicArtifacts(input.topicId, cwd);
+        }
+        return { source, outputPath };
+    }
+    const source = await ingestFile(input.input, cwd, now, input.topicId);
+    const outputPath = await writeSourceArtifact(workspace.rootDir, source);
+    if (input.topicId) {
+        await refreshTopicArtifacts(input.topicId, cwd);
+    }
+    return { source, outputPath };
+}
+async function ingestFile(inputPath, cwd, capturedAt, topicId) {
+    const absolutePath = path.resolve(cwd, inputPath);
+    const content = await readFile(absolutePath, "utf8");
+    const title = normalizeObsidianText(path.basename(absolutePath, path.extname(absolutePath)));
+    return {
+        id: createSourceId(),
+        type: "file",
+        sourceUri: absolutePath,
+        title,
+        topicId,
+        capturedAt,
+        topicTags: [],
+        body: `# ${title}\n\n${content.trim()}`
+    };
+}
+async function ingestUrl(inputUrl, capturedAt, topicId) {
+    const response = await fetch(inputUrl);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch ${inputUrl}: ${response.status} ${response.statusText}`);
+    }
+    const html = await response.text();
+    const converted = htmlToMarkdown(html);
+    return {
+        id: createSourceId(),
+        type: "url",
+        sourceUri: inputUrl,
+        title: normalizeObsidianText(converted.title, inputUrl),
+        topicId,
+        capturedAt,
+        topicTags: [],
+        language: converted.language,
+        body: converted.body
+    };
+}
+async function writeSourceArtifact(workspaceRoot, draft) {
+    const topicRecord = draft.topicId ? await loadTopic(draft.topicId, workspaceRoot) : undefined;
+    const source = sourceDocumentSchema.parse({
+        id: draft.id,
+        type: draft.type,
+        sourceUri: draft.sourceUri,
+        title: draft.title,
+        topicId: draft.topicId,
+        author: draft.author,
+        capturedAt: draft.capturedAt,
+        topicTags: draft.topicTags,
+        language: draft.language
+    });
+    const markdown = toFrontmatterMarkdown({
+        type: "source",
+        title: normalizeObsidianText(source.title, source.id),
+        aliases: makeAliases(source.id),
+        tags: makeTags("sourceloop", "source", source.type),
+        ...(topicRecord ? { topic: normalizeObsidianText(topicRecord.topic.name, topicRecord.topic.id) } : {}),
+        source_kind: source.type,
+        ...(source.author ? { author: source.author } : {}),
+        ...(source.language ? { language: source.language } : {}),
+        created: source.capturedAt,
+        updated: source.capturedAt
+    }, draft.body);
+    const workspace = await loadWorkspace(workspaceRoot);
+    const note = getSourceNote(workspace, source);
+    const sourcesDir = path.join(workspaceRoot, "vault/sources");
+    await mkdir(sourcesDir, { recursive: true });
+    const markdownPath = note.absolutePath;
+    const jsonPath = path.join(sourcesDir, `${source.id}.json`);
+    await writeFile(markdownPath, markdown, "utf8");
+    await writeJsonFile(jsonPath, source);
+    return markdownPath;
+}
+function isUrl(value) {
+    try {
+        const parsed = new URL(value);
+        return parsed.protocol === "http:" || parsed.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+function createSourceId() {
+    return `src_${randomUUID().replace(/-/g, "").slice(0, 12)}`;
+}
+//# sourceMappingURL=ingest-source.js.map