sourceloop 0.1.1

package/dist/commands/import-latest.js

@@ -0,0 +1,42 @@
+import { Command } from "commander";
+import { loadChromeAttachTarget } from "../core/attach/manage-targets.js";
+import { loadNotebookBinding, loadQuestionBatch } from "../core/runs/load-artifacts.js";
+import { defaultNotebookBrowserSessionFactory } from "../core/notebooklm/browser-agent.js";
+import { importLatestAnswerIntoRun } from "../core/runs/run-qa.js";
+export const importLatestCommand = new Command("import-latest")
+    .description("Import the latest visible NotebookLM answer into an existing planned run")
+    .argument("<run-id>", "run id to import into")
+    .option("--question-id <question-id>", "planned question id to attach this imported answer to")
+    .option("--attach-target <target-id>", "override the notebook binding attach target")
+    .option("--show-browser", "show Chrome while attaching to NotebookLM", false)
+    .action(async (runId, options) => {
+    const { run } = await loadQuestionBatch(runId);
+    const { binding } = await loadNotebookBinding(run.notebookBindingId);
+    const attachTargetId = options.attachTarget ?? binding.attachTargetId;
+    if (!attachTargetId) {
+        throw new Error(`Run ${runId} does not have an attached Chrome target. Re-run with --attach-target <target-id> or bind the notebook with --attach-target.`);
+    }
+    const { target } = await loadChromeAttachTarget(attachTargetId);
+    const session = await defaultNotebookBrowserSessionFactory.createSession({
+        target,
+        showBrowser: options.showBrowser,
+        reuseExistingNotebookPage: true
+    });
+    try {
+        await session.preflight(binding.notebookUrl);
+        const latestAnswer = await session.captureLatestAnswer();
+        const result = await importLatestAnswerIntoRun({
+            runId,
+            answer: {
+                ...latestAnswer,
+                answerSource: "notebooklm"
+            },
+            ...(options.questionId ? { questionId: options.questionId } : {})
+        });
+        process.stdout.write(`Imported latest NotebookLM answer into ${result.importedQuestionId} (${result.run.status})\n`);
+    }
+    finally {
+        await session.close();
+    }
+});
+//# sourceMappingURL=import-latest.js.map

package/dist/commands/import-latest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-latest.js","sourceRoot":"","sources":["../../src/commands/import-latest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxF,OAAO,EAAE,oCAAoC,EAAE,MAAM,qCAAqC,CAAC;AAC3F,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC;KAC5D,WAAW,CAAC,0EAA0E,CAAC;KACvF,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;KAC7C,MAAM,CAAC,6BAA6B,EAAE,uDAAuD,CAAC;KAC9F,MAAM,CAAC,6BAA6B,EAAE,6CAA6C,CAAC;KACpF,MAAM,CAAC,gBAAgB,EAAE,2CAA2C,EAAE,KAAK,CAAC;KAC5E,MAAM,CACL,KAAK,EACH,KAAa,EACb,OAIC,EACD,EAAE;IACF,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC;IAEtE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,OAAO,KAAK,8HAA8H,CAC3I,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,MAAM,oCAAoC,CAAC,aAAa,CAAC;QACvE,MAAM;QACN,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,yBAAyB,EAAE,IAAI;KAChC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7C,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,mBAAmB,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC;YAC7C,KAAK;YACL,MAAM,EAAE;gBACN,GAAG,YAAY;gBACf,YAAY,EAAE,YAAY;aAC3B;YACD,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClE,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0CAA0C,MAAM,CAAC,kBAAkB,KAAK,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,CAC/F,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC,CACF,CAAC"}

package/dist/commands/ingest.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const ingestCommand: Command;

package/dist/commands/ingest.js

@@ -0,0 +1,14 @@
+import { Command } from "commander";
+import { ingestSource } from "../core/ingest/ingest-source.js";
+export const ingestCommand = new Command("ingest")
+    .description("Ingest a local file or URL into the current SourceLoop workspace")
+    .argument("<input>", "file path or URL to ingest")
+    .option("--topic <topic-id>", "topic to attach this source to")
+    .action(async (input, options) => {
+    const result = await ingestSource({
+        input,
+        ...(options.topic ? { topicId: options.topic } : {})
+    });
+    process.stdout.write(`Ingested ${result.source.type} source into ${result.outputPath}\n`);
+});
+//# sourceMappingURL=ingest.js.map

package/dist/commands/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../src/commands/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KAC/C,WAAW,CAAC,kEAAkE,CAAC;KAC/E,QAAQ,CAAC,SAAS,EAAE,4BAA4B,CAAC;KACjD,MAAM,CAAC,oBAAoB,EAAE,gCAAgC,CAAC;KAC9D,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,OAA2B,EAAE,EAAE;IAC3D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,KAAK;QACL,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,IAAI,gBAAgB,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;AAC5F,CAAC,CAAC,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const initCommand: Command;

package/dist/commands/init.js

@@ -0,0 +1,24 @@
+import { Command, Option } from "commander";
+import { initializeWorkspace } from "../core/workspace/init-workspace.js";
+import { SUPPORTED_AGENT_BOOTSTRAPS } from "../core/workspace/bootstrap.js";
+import { writeJsonOutput, writeTextOutput } from "../lib/cli-output.js";
+export const initCommand = new Command("init")
+    .description("Initialize a SourceLoop workspace in the target directory")
+    .argument("[directory]", "target directory to initialize", ".")
+    .addOption(new Option("--ai <target>", "generate a project-local AI operator bootstrap")
+    .choices(SUPPORTED_AGENT_BOOTSTRAPS))
+    .option("--force", "overwrite an existing SourceLoop config file", false)
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (directory, options) => {
+    const result = await initializeWorkspace({
+        directory,
+        force: options.force,
+        ...(options.ai ? { ai: options.ai } : {})
+    });
+    if (options.json) {
+        writeJsonOutput(result);
+        return;
+    }
+    writeTextOutput(result.message);
+});
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAgC,MAAM,gCAAgC,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC3C,WAAW,CAAC,2DAA2D,CAAC;KACxE,QAAQ,CAAC,aAAa,EAAE,gCAAgC,EAAE,GAAG,CAAC;KAC9D,SAAS,CACR,IAAI,MAAM,CAAC,eAAe,EAAE,gDAAgD,CAAC;KAC1E,OAAO,CAAC,0BAAiD,CAAC,CAC9D;KACA,MAAM,CAAC,SAAS,EAAE,8CAA8C,EAAE,KAAK,CAAC;KACxE,MAAM,CAAC,QAAQ,EAAE,4BAA4B,EAAE,KAAK,CAAC;KACrD,MAAM,CAAC,KAAK,EAAE,SAAiB,EAAE,OAAwE,EAAE,EAAE;IAC5G,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;QACvC,SAAS;QACT,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,eAAe,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IAED,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC"}

package/dist/commands/notebook-bind.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const notebookBindCommand: Command;

package/dist/commands/notebook-bind.js

@@ -0,0 +1,39 @@
+import { Command } from "commander";
+import { bindNotebook } from "../core/notebooks/bind-notebook.js";
+import { writeJsonOutput, writeTextOutput } from "../lib/cli-output.js";
+export const notebookBindCommand = new Command("notebook-bind")
+    .description("Create a notebook binding record for a NotebookLM target")
+    .requiredOption("--name <name>", "binding display name")
+    .option("--topic <topic>", "legacy freeform research topic for the notebook")
+    .option("--topic-id <topic-id>", "topic id for the preferred topic-first workflow")
+    .requiredOption("--url <url>", "NotebookLM notebook URL")
+    .option("--access <mode>", "notebook access mode", "owner")
+    .option("--force", "overwrite an existing binding with the same id", false)
+    .option("--description <description>", "description of the notebook contents")
+    .option("--topics <topics>", "comma-separated notebook topics")
+    .option("--attach-target <target-id>", "default attached Chrome target for this notebook")
+    .option("--browser-profile <profile>", "browser profile alias for this binding")
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (options) => {
+    if (!options.topicId && !options.topic) {
+        throw new Error("Provide --topic-id for the preferred topic-first flow or --topic for the legacy notebook-first flow.");
+    }
+    const result = await bindNotebook({
+        name: options.name,
+        topic: options.topic ?? options.topicId ?? options.name,
+        notebookUrl: options.url,
+        accessMode: options.access,
+        force: options.force,
+        topics: options.topics?.split(",").map((topic) => topic.trim()).filter(Boolean) ?? [],
+        ...(options.description ? { description: options.description } : {}),
+        ...(options.topicId ? { topicId: options.topicId } : {}),
+        ...(options.attachTarget ? { attachTargetId: options.attachTarget } : {}),
+        ...(options.browserProfile ? { browserProfile: options.browserProfile } : {})
+    });
+    if (options.json) {
+        writeJsonOutput(result);
+        return;
+    }
+    writeTextOutput(`Bound notebook ${result.binding.id} at ${result.markdownPath}`);
+});
+//# sourceMappingURL=notebook-bind.js.map

package/dist/commands/notebook-bind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-bind.js","sourceRoot":"","sources":["../../src/commands/notebook-bind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC;KAC5D,WAAW,CAAC,0DAA0D,CAAC;KACvE,cAAc,CAAC,eAAe,EAAE,sBAAsB,CAAC;KACvD,MAAM,CAAC,iBAAiB,EAAE,iDAAiD,CAAC;KAC5E,MAAM,CAAC,uBAAuB,EAAE,iDAAiD,CAAC;KAClF,cAAc,CAAC,aAAa,EAAE,yBAAyB,CAAC;KACxD,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,OAAO,CAAC;KAC1D,MAAM,CAAC,SAAS,EAAE,gDAAgD,EAAE,KAAK,CAAC;KAC1E,MAAM,CAAC,6BAA6B,EAAE,sCAAsC,CAAC;KAC7E,MAAM,CAAC,mBAAmB,EAAE,iCAAiC,CAAC;KAC9D,MAAM,CAAC,6BAA6B,EAAE,kDAAkD,CAAC;KACzF,MAAM,CAAC,6BAA6B,EAAE,wCAAwC,CAAC;KAC/E,MAAM,CAAC,QAAQ,EAAE,4BAA4B,EAAE,KAAK,CAAC;KACrD,MAAM,CACL,KAAK,EAAE,OAYN,EAAE,EAAE;IACH,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,sGAAsG,CAAC,CAAC;IAC1H,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI;QACvD,WAAW,EAAE,OAAO,CAAC,GAAG;QACxB,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QACrF,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9E,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,eAAe,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IAED,eAAe,CAAC,kBAAkB,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;AACnF,CAAC,CACF,CAAC"}

package/dist/commands/notebook-create.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const notebookCreateCommand: Command;

package/dist/commands/notebook-create.js

@@ -0,0 +1,39 @@
+import { Command } from "commander";
+import { createManagedNotebook } from "../core/notebooks/manage-managed-notebooks.js";
+import { writeJsonOutput, writeTextOutput } from "../lib/cli-output.js";
+export const notebookCreateCommand = new Command("notebook-create")
+    .description("Create a fresh NotebookLM notebook through an attached Chrome session")
+    .requiredOption("--name <name>", "notebook display name")
+    .requiredOption("--topic-id <topic-id>", "topic id")
+    .requiredOption("--attach-target <target-id>", "attached Chrome target id")
+    .option("--access <mode>", "notebook access mode", "owner")
+    .option("--description <description>", "description of the notebook contents")
+    .option("--topics <topics>", "comma-separated notebook tags")
+    .option("--force", "overwrite an existing managed setup with the same id", false)
+    .option("--show-browser", "show the attached browser while creating the notebook", false)
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (options) => {
+    const result = await createManagedNotebook({
+        name: options.name,
+        topicId: options.topicId,
+        attachTargetId: options.attachTarget,
+        accessMode: options.access,
+        ...(options.description ? { description: options.description } : {}),
+        ...(options.topics
+            ? {
+                topics: options.topics
+                    .split(",")
+                    .map((value) => value.trim())
+                    .filter(Boolean)
+            }
+            : {}),
+        force: options.force,
+        showBrowser: options.showBrowser
+    });
+    if (options.json) {
+        writeJsonOutput(result);
+        return;
+    }
+    writeTextOutput(`Created managed notebook ${result.binding.id} at ${result.bindingMarkdownPath}`);
+});
+//# sourceMappingURL=notebook-create.js.map

package/dist/commands/notebook-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-create.js","sourceRoot":"","sources":["../../src/commands/notebook-create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;KAChE,WAAW,CAAC,uEAAuE,CAAC;KACpF,cAAc,CAAC,eAAe,EAAE,uBAAuB,CAAC;KACxD,cAAc,CAAC,uBAAuB,EAAE,UAAU,CAAC;KACnD,cAAc,CAAC,6BAA6B,EAAE,2BAA2B,CAAC;KAC1E,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,OAAO,CAAC;KAC1D,MAAM,CAAC,6BAA6B,EAAE,sCAAsC,CAAC;KAC7E,MAAM,CAAC,mBAAmB,EAAE,+BAA+B,CAAC;KAC5D,MAAM,CAAC,SAAS,EAAE,sDAAsD,EAAE,KAAK,CAAC;KAChF,MAAM,CAAC,gBAAgB,EAAE,uDAAuD,EAAE,KAAK,CAAC;KACxF,MAAM,CAAC,QAAQ,EAAE,4BAA4B,EAAE,KAAK,CAAC;KACrD,MAAM,CACL,KAAK,EAAE,OAUN,EAAE,EAAE;IACH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC;QACzC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,cAAc,EAAE,OAAO,CAAC,YAAY;QACpC,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,OAAO,CAAC,MAAM;YAChB,CAAC,CAAC;gBACE,MAAM,EAAE,OAAO,CAAC,MAAM;qBACnB,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;qBAC5B,MAAM,CAAC,OAAO,CAAC;aACnB;YACH,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,eAAe,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IAED,eAAe,CAAC,4BAA4B,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;AACpG,CAAC,CACF,CAAC"}

package/dist/commands/notebook-import.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const notebookImportCommand: Command;

package/dist/commands/notebook-import.js

@@ -0,0 +1,39 @@
+import { Command } from "commander";
+import { importIntoManagedNotebook } from "../core/notebooks/manage-managed-notebooks.js";
+import { writeJsonOutput, writeTextOutput } from "../lib/cli-output.js";
+export const notebookImportCommand = new Command("notebook-import")
+    .description("Import a local SourceLoop source or remote URL into a managed NotebookLM notebook")
+    .requiredOption("--notebook <binding-id>", "managed notebook binding id")
+    .option("--source-id <source-id>", "existing SourceLoop source artifact id")
+    .option("--url <url>", "remote URL to import")
+    .option("--title <title>", "override import title")
+    .option("--force", "overwrite an existing managed import with the same id", false)
+    .option("--show-browser", "show the attached browser while importing", false)
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (options) => {
+    const sourceModes = [options.sourceId ? "sourceId" : undefined, options.url ? "url" : undefined].filter(Boolean);
+    if (sourceModes.length !== 1) {
+        throw new Error("Provide exactly one of --source-id or --url.");
+    }
+    const result = await importIntoManagedNotebook(options.sourceId
+        ? {
+            notebookBindingId: options.notebook,
+            sourceId: options.sourceId,
+            ...(options.title ? { title: options.title } : {}),
+            force: options.force,
+            showBrowser: options.showBrowser
+        }
+        : {
+            notebookBindingId: options.notebook,
+            url: options.url,
+            ...(options.title ? { title: options.title } : {}),
+            force: options.force,
+            showBrowser: options.showBrowser
+        });
+    if (options.json) {
+        writeJsonOutput(result);
+        return;
+    }
+    writeTextOutput(`Imported ${result.managedImport.sourceUri} into ${result.managedImport.notebookBindingId} (${result.managedImport.status})`);
+});
+//# sourceMappingURL=notebook-import.js.map

package/dist/commands/notebook-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-import.js","sourceRoot":"","sources":["../../src/commands/notebook-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,+CAA+C,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,OAAO,CAAC,iBAAiB,CAAC;KAChE,WAAW,CAAC,mFAAmF,CAAC;KAChG,cAAc,CAAC,yBAAyB,EAAE,6BAA6B,CAAC;KACxE,MAAM,CAAC,yBAAyB,EAAE,wCAAwC,CAAC;KAC3E,MAAM,CAAC,aAAa,EAAE,sBAAsB,CAAC;KAC7C,MAAM,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;KAClD,MAAM,CAAC,SAAS,EAAE,uDAAuD,EAAE,KAAK,CAAC;KACjF,MAAM,CAAC,gBAAgB,EAAE,2CAA2C,EAAE,KAAK,CAAC;KAC5E,MAAM,CAAC,QAAQ,EAAE,4BAA4B,EAAE,KAAK,CAAC;KACrD,MAAM,CACL,KAAK,EAAE,OAQN,EAAE,EAAE;IACH,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjH,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAC5C,OAAO,CAAC,QAAQ;QACd,CAAC,CAAC;YACE,iBAAiB,EAAE,OAAO,CAAC,QAAQ;YACnC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC;QACH,CAAC,CAAC;YACE,iBAAiB,EAAE,OAAO,CAAC,QAAQ;YACnC,GAAG,EAAE,OAAO,CAAC,GAAI;YACjB,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CACN,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,eAAe,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IAED,eAAe,CAAC,YAAY,MAAM,CAAC,aAAa,CAAC,SAAS,SAAS,MAAM,CAAC,aAAa,CAAC,iBAAiB,KAAK,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;AAChJ,CAAC,CACF,CAAC"}

package/dist/commands/notebook-source.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const notebookSourceCommand: Command;

package/dist/commands/notebook-source.js

@@ -0,0 +1,71 @@
+import { Command } from "commander";
+import { declareNotebookSourceManifest, listNotebookSourceManifests, loadNotebookSourceManifest } from "../core/notebooks/manage-notebook-source-manifests.js";
+import { writeJsonOutput, writeTextOutput } from "../lib/cli-output.js";
+export const notebookSourceCommand = new Command("notebook-source").description("Declare and inspect NotebookLM-backed source manifests");
+notebookSourceCommand
+    .command("declare")
+    .description("Declare an existing NotebookLM source bundle for a topic-bound notebook")
+    .requiredOption("--topic-id <topic-id>", "topic id")
+    .requiredOption("--notebook <binding-id>", "notebook binding id")
+    .requiredOption("--kind <kind>", "source bundle kind")
+    .requiredOption("--title <title>", "manifest display title")
+    .option("--description <description>", "manifest description")
+    .option("--item-count <count>", "optional bundle item count", parsePositiveInteger)
+    .option("--ref <ref>", "reference URL or note", collectValue, [])
+    .option("--force", "overwrite an existing manifest with the same id", false)
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (options) => {
+    const result = await declareNotebookSourceManifest({
+        topicId: options.topicId,
+        notebookBindingId: options.notebook,
+        kind: options.kind,
+        title: options.title,
+        ...(options.description ? { description: options.description } : {}),
+        ...(options.itemCount !== undefined ? { itemCount: options.itemCount } : {}),
+        ...(options.ref.length ? { refs: options.ref } : {}),
+        force: options.force
+    });
+    if (options.json) {
+        writeJsonOutput(result);
+        return;
+    }
+    writeTextOutput(`Declared notebook source manifest ${result.manifest.id} at ${result.markdownPath}`);
+});
+notebookSourceCommand
+    .command("list")
+    .description("List notebook-backed source manifests in the current workspace")
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (options) => {
+    const manifests = await listNotebookSourceManifests();
+    if (options.json) {
+        writeJsonOutput({ manifests });
+        return;
+    }
+    if (manifests.length === 0) {
+        writeTextOutput("No notebook source manifests found.");
+        return;
+    }
+    for (const manifest of manifests) {
+        writeTextOutput(`${manifest.id}\t${manifest.topicId}\t${manifest.notebookBindingId}\t${manifest.title}`);
+    }
+});
+notebookSourceCommand
+    .command("show")
+    .description("Show one notebook-backed source manifest")
+    .argument("<manifest-id>", "manifest id")
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (manifestId, options) => {
+    const { manifest } = await loadNotebookSourceManifest(manifestId);
+    writeJsonOutput({ manifest });
+});
+function parsePositiveInteger(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`Expected a positive integer, received "${value}".`);
+    }
+    return parsed;
+}
+function collectValue(value, previous) {
+    return [...previous, value.trim()].filter(Boolean);
+}
+//# sourceMappingURL=notebook-source.js.map

package/dist/commands/notebook-source.js.map

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

package/dist/commands/plan.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+import { createQuestionPlan } from "../core/runs/question-planner.js";
+export declare function resolvePlanInput(topicOrId: string, options: {
+    notebook?: string;
+    objective?: string;
+    maxQuestions?: number;
+    families?: string[];
+}): Promise<Parameters<typeof createQuestionPlan>[0]>;
+export declare const planCommand: Command;

package/dist/commands/plan.js

@@ -0,0 +1,59 @@
+import { Command } from "commander";
+import { createQuestionPlan } from "../core/runs/question-planner.js";
+import { loadTopic } from "../core/topics/manage-topics.js";
+import { writeJsonOutput, writeTextOutput } from "../lib/cli-output.js";
+export async function resolvePlanInput(topicOrId, options) {
+    const baseInput = {
+        ...(options.notebook ? { notebookBindingId: options.notebook } : {}),
+        ...(options.objective ? { objective: options.objective } : {}),
+        ...(options.maxQuestions !== undefined ? { maxQuestions: options.maxQuestions } : {}),
+        ...(options.families?.length ? { families: options.families } : {})
+    };
+    try {
+        await loadTopic(topicOrId);
+        return {
+            topicId: topicOrId,
+            ...baseInput
+        };
+    }
+    catch {
+        return {
+            topic: topicOrId,
+            ...baseInput
+        };
+    }
+}
+export const planCommand = new Command("plan")
+    .description("Create a deep planned question batch for a topic-backed research run")
+    .argument("<topic-or-id>", "topic id for the preferred flow, or a legacy freeform topic string")
+    .option("--notebook <binding-id>", "notebook binding id to use for the legacy flow or explicit topic notebook selection")
+    .option("--objective <objective>", "objective for the research run")
+    .option("--max-questions <count>", "cap the number of planned questions", parsePositiveInteger)
+    .option("--families <families>", "comma-separated question families to include", parseCsvList)
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (topicOrId, options) => {
+    const result = await createQuestionPlan(await resolvePlanInput(topicOrId, options));
+    if (options.json) {
+        writeJsonOutput(result);
+        return;
+    }
+    writeTextOutput(`Planned run ${result.run.id} at ${result.runDir}`);
+});
+function parsePositiveInteger(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`Expected a positive integer, received "${value}".`);
+    }
+    return parsed;
+}
+function parseCsvList(value) {
+    const items = value
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+    if (items.length === 0) {
+        throw new Error("Expected at least one comma-separated value.");
+    }
+    return items;
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const runCommand: Command;

package/dist/commands/run.js

@@ -0,0 +1,76 @@
+import { Command } from "commander";
+import path from "node:path";
+import { executeQARun } from "../core/runs/run-qa.js";
+import { FixtureNotebookRunnerAdapter } from "../core/notebooklm/fixture-adapter.js";
+import { BrowserAgentNotebookRunnerAdapter } from "../core/notebooklm/browser-agent-adapter.js";
+import { loadChromeAttachTarget } from "../core/attach/manage-targets.js";
+import { loadNotebookBinding, loadQuestionBatch } from "../core/runs/load-artifacts.js";
+import { writeJsonOutput, writeTextOutput } from "../lib/cli-output.js";
+export const runCommand = new Command("run")
+    .description("Execute a planned NotebookLM Q&A run")
+    .argument("<run-id>", "run id to execute")
+    .option("--adapter <adapter>", "runner adapter to use", "browser-agent")
+    .option("--attach-target <target-id>", "attached Chrome target to use for NotebookLM execution")
+    .option("--fixture-file <path>", "fixture response file for local verification")
+    .option("--question-id <question-id>", "explicit planned question id to execute", collectCsvValues, [])
+    .option("--from-question <question-id>", "start execution from this planned question id")
+    .option("--limit <count>", "execute at most this many new questions", parsePositiveInteger)
+    .option("--show-browser", "show the browser while the browser-agent adapter runs", false)
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (runId, options) => {
+    if (options.adapter === "fixture" && !options.fixtureFile) {
+        throw new Error("--fixture-file is required when --adapter fixture is used.");
+    }
+    if (options.questionId.length > 0 && options.fromQuestion) {
+        throw new Error("--question-id and --from-question cannot be used together.");
+    }
+    const adapter = options.adapter === "fixture"
+        ? await FixtureNotebookRunnerAdapter.fromFile(path.resolve(options.fixtureFile ?? ""))
+        : await createAttachedBrowserAdapter(runId, options.attachTarget, options.showBrowser);
+    const result = await executeQARun({
+        runId,
+        adapter,
+        ...(options.questionId.length ? { questionIds: options.questionId } : {}),
+        ...(options.fromQuestion ? { fromQuestionId: options.fromQuestion } : {}),
+        ...(options.limit !== undefined ? { limit: options.limit } : {})
+    });
+    if (options.json) {
+        writeJsonOutput({
+            run: result.run,
+            completedExchangeIds: result.completedExchanges.map((exchange) => exchange.id),
+            completedExchangeCount: result.completedExchanges.length
+        });
+        return;
+    }
+    writeTextOutput(`Run ${result.run.id} finished with status ${result.run.status} (${result.completedExchanges.length} exchanges archived)`);
+});
+function parsePositiveInteger(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`Expected a positive integer, received "${value}".`);
+    }
+    return parsed;
+}
+function collectCsvValues(value, previous) {
+    return [
+        ...previous,
+        ...value
+            .split(",")
+            .map((item) => item.trim())
+            .filter(Boolean)
+    ];
+}
+async function createAttachedBrowserAdapter(runId, explicitAttachTargetId, showBrowser) {
+    const { run } = await loadQuestionBatch(runId);
+    const { binding } = await loadNotebookBinding(run.notebookBindingId);
+    const attachTargetId = explicitAttachTargetId ?? binding.attachTargetId;
+    if (!attachTargetId) {
+        throw new Error(`Run ${runId} does not have an attached Chrome target. Re-run with --attach-target <target-id> or bind the notebook with --attach-target.`);
+    }
+    const { target } = await loadChromeAttachTarget(attachTargetId);
+    return new BrowserAgentNotebookRunnerAdapter({
+        attachTarget: target,
+        showBrowser
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,iCAAiC,EAAE,MAAM,6CAA6C,CAAC;AAChG,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACzC,WAAW,CAAC,sCAAsC,CAAC;KACnD,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;KACzC,MAAM,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,eAAe,CAAC;KACvE,MAAM,CAAC,6BAA6B,EAAE,wDAAwD,CAAC;KAC/F,MAAM,CAAC,uBAAuB,EAAE,8CAA8C,CAAC;KAC/E,MAAM,CAAC,6BAA6B,EAAE,yCAAyC,EAAE,gBAAgB,EAAE,EAAE,CAAC;KACtG,MAAM,CAAC,+BAA+B,EAAE,+CAA+C,CAAC;KACxF,MAAM,CAAC,iBAAiB,EAAE,yCAAyC,EAAE,oBAAoB,CAAC;KAC1F,MAAM,CAAC,gBAAgB,EAAE,uDAAuD,EAAE,KAAK,CAAC;KACxF,MAAM,CAAC,QAAQ,EAAE,4BAA4B,EAAE,KAAK,CAAC;KACrD,MAAM,CACL,KAAK,EACH,KAAa,EACb,OASC,EACD,EAAE;IACF,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,OAAO,GACX,OAAO,CAAC,OAAO,KAAK,SAAS;QAC3B,CAAC,CAAC,MAAM,4BAA4B,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACtF,CAAC,CAAC,MAAM,4BAA4B,CAAC,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3F,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;QAChC,KAAK;QACL,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjE,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,eAAe,CAAC;YACd,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,oBAAoB,EAAE,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9E,sBAAsB,EAAE,MAAM,CAAC,kBAAkB,CAAC,MAAM;SACzD,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,eAAe,CAAC,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,yBAAyB,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,kBAAkB,CAAC,MAAM,sBAAsB,CAAC,CAAC;AAC7I,CAAC,CACF,CAAC;AAEJ,SAAS,oBAAoB,CAAC,KAAa;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,0CAA0C,KAAK,IAAI,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,QAAkB;IACzD,OAAO;QACL,GAAG,QAAQ;QACX,GAAG,KAAK;aACL,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,OAAO,CAAC;KACnB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,4BAA4B,CACzC,KAAa,EACb,sBAA0C,EAC1C,WAAoB;IAEpB,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,sBAAsB,IAAI,OAAO,CAAC,cAAc,CAAC;IAExE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,OAAO,KAAK,8HAA8H,CAC3I,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,sBAAsB,CAAC,cAAc,CAAC,CAAC;IAChE,OAAO,IAAI,iCAAiC,CAAC;QAC3C,YAAY,EAAE,MAAM;QACpB,WAAW;KACZ,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const statusCommand: Command;

package/dist/commands/status.js

@@ -0,0 +1,15 @@
+import { Command } from "commander";
+import { formatWorkspaceStatusReport, buildWorkspaceStatusReport } from "../core/operator/workspace-operator.js";
+import { writeJsonOutput, writeTextOutput } from "../lib/cli-output.js";
+export const statusCommand = new Command("status")
+    .description("Show a workspace-level SourceLoop status overview")
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (options) => {
+    const report = await buildWorkspaceStatusReport();
+    if (options.json) {
+        writeJsonOutput(report);
+        return;
+    }
+    writeTextOutput(formatWorkspaceStatusReport(report));
+});
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACjH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KAC/C,WAAW,CAAC,mDAAmD,CAAC;KAChE,MAAM,CAAC,QAAQ,EAAE,4BAA4B,EAAE,KAAK,CAAC;KACrD,MAAM,CAAC,KAAK,EAAE,OAA0B,EAAE,EAAE;IAC3C,MAAM,MAAM,GAAG,MAAM,0BAA0B,EAAE,CAAC;IAElD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,eAAe,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IAED,eAAe,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC"}

package/dist/commands/topic.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const topicCommand: Command;

package/dist/commands/topic.js

@@ -0,0 +1,53 @@
+import { Command } from "commander";
+import { createTopic, listTopics, loadTopic } from "../core/topics/manage-topics.js";
+import { writeJsonOutput, writeTextOutput } from "../lib/cli-output.js";
+export const topicCommand = new Command("topic").description("Create and inspect topic-first research roots");
+topicCommand
+    .command("create")
+    .description("Create a research topic root")
+    .requiredOption("--name <name>", "topic display name")
+    .option("--goal <goal>", "optional research goal for this topic")
+    .option("--output <output>", "optional output hint, for example lecture, brief, or playbook")
+    .option("--force", "overwrite an existing topic with the same id", false)
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (options) => {
+    const result = await createTopic({
+        name: options.name,
+        ...(options.goal ? { goal: options.goal } : {}),
+        ...(options.output ? { intendedOutput: options.output } : {}),
+        force: options.force
+    });
+    if (options.json) {
+        writeJsonOutput(result);
+        return;
+    }
+    writeTextOutput(`Created topic ${result.topic.id} at ${result.topicDir}`);
+});
+topicCommand
+    .command("list")
+    .description("List research topics in the current workspace")
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (options) => {
+    const topics = await listTopics();
+    if (options.json) {
+        writeJsonOutput({ topics });
+        return;
+    }
+    if (topics.length === 0) {
+        writeTextOutput("No research topics found.");
+        return;
+    }
+    for (const topic of topics) {
+        writeTextOutput(`${topic.id}\t${topic.status}\t${topic.name}`);
+    }
+});
+topicCommand
+    .command("show")
+    .description("Show one research topic and its corpus metadata")
+    .argument("<topic-id>", "topic id")
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (topicId, options) => {
+    const { topic, corpus } = await loadTopic(topicId);
+    writeJsonOutput({ topic, corpus });
+});
+//# sourceMappingURL=topic.js.map

package/dist/commands/topic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic.js","sourceRoot":"","sources":["../../src/commands/topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,+CAA+C,CAAC,CAAC;AAE9G,YAAY;KACT,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,8BAA8B,CAAC;KAC3C,cAAc,CAAC,eAAe,EAAE,oBAAoB,CAAC;KACrD,MAAM,CAAC,eAAe,EAAE,uCAAuC,CAAC;KAChE,MAAM,CAAC,mBAAmB,EAAE,+DAA+D,CAAC;KAC5F,MAAM,CAAC,SAAS,EAAE,8CAA8C,EAAE,KAAK,CAAC;KACxE,MAAM,CAAC,QAAQ,EAAE,4BAA4B,EAAE,KAAK,CAAC;KACrD,MAAM,CAAC,KAAK,EAAE,OAAwF,EAAE,EAAE;IACzG,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;QAC/B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,eAAe,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IAED,eAAe,CAAC,iBAAiB,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC;AAEL,YAAY;KACT,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,+CAA+C,CAAC;KAC5D,MAAM,CAAC,QAAQ,EAAE,4BAA4B,EAAE,KAAK,CAAC;KACrD,MAAM,CAAC,KAAK,EAAE,OAA0B,EAAE,EAAE;IAC3C,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAElC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,eAAe,CAAC,2BAA2B,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,eAAe,CAAC,GAAG,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,YAAY;KACT,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,iDAAiD,CAAC;KAC9D,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;KAClC,MAAM,CAAC,QAAQ,EAAE,4BAA4B,EAAE,KAAK,CAAC;KACrD,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,OAA0B,EAAE,EAAE;IAC5D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;IACnD,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC"}