sourceloop 0.1.1

package/README.md

@@ -0,0 +1,401 @@
+# SourceLoop
+
+**A local-first research runtime for Codex, Claude Code, and Gemini CLI.**
+
+SourceLoop helps AI tools work through NotebookLM with a managed browser, repeatable question planning, and local Markdown archives.
+
+It is built for a simple idea:
+
+- use AI for research
+- keep grounding in real sources
+- keep the workflow reusable
+- keep human ownership over judgment and expression
+
+SourceLoop is not a NotebookLM replacement. It is the workflow and archive layer around NotebookLM-based research.
+
+## Why This Exists
+
+Most research workflows break in three places:
+
+- **weak questions**
+  - the model can answer well only if someone asks the right questions
+- **untrusted answers**
+  - generic AI answers drift, summarize poorly, or hallucinate beyond the source base
+- **no durable archive**
+  - browser-only Q&A disappears into a tab and becomes hard to reuse later
+
+SourceLoop exists to make that workflow repeatable.
+
+It gives your AI tool:
+
+- a topic model
+- a managed NotebookLM browser path
+- notebook creation or binding
+- source import and source declaration
+- planned question batches
+- local answer and citation archives
+
+## The IPO Model
+
+SourceLoop follows a simple **Input -> Process -> Output** model.
+
+### Input
+
+- local notes, files, transcripts, and URLs
+- a NotebookLM notebook
+- a managed research browser session
+
+### Process
+
+- plan better questions
+- run NotebookLM Q&A against grounded sources
+- capture answers and citations into local files
+
+### Output
+
+- a reusable Markdown research archive
+- question batches you can rerun or extend
+- material that can become memos, articles, scripts, decks, or teaching assets
+
+In short:
+
+```text
+Sources
+  -> NotebookLM
+  -> Planned questions
+  -> Grounded answers with citations
+  -> Local Markdown archive
+  -> Your own memo, deck, article, or presentation
+```
+
+## What SourceLoop Gives Your AI Tool
+
+- topic-first research workspaces
+- managed Chrome setup for NotebookLM work
+- notebook create or notebook bind flows
+- source import for local files and supported remote URLs
+- source declaration when material already exists in NotebookLM
+- default 10-question planning
+- full-batch execution by default unless you explicitly want a partial run
+- local Markdown storage for runs, answers, and citations
+
+## Why NotebookLM
+
+SourceLoop uses NotebookLM as the answer engine because NotebookLM is already strong at document-grounded research.
+
+- **Gemini-powered preprocessing**
+  - upload source material once and work from prepared source context
+- **natural-language Q&A**
+  - go beyond keyword lookup into explanation, synthesis, and comparison
+- **multi-source reasoning**
+  - connect ideas across a notebook worth of source material
+- **built-in citations**
+  - answers come with traceable source references
+- **no separate RAG infrastructure**
+  - no vector database, embedding pipeline, chunking strategy, or retrieval tuning stack to maintain
+
+SourceLoop does not try to replace those strengths. It makes them operational for AI tools.
+
+## Markdown-First Output
+![alt text](docs/graph-sample.png)
+SourceLoop is designed so the result does not disappear into a browser tab.
+
+Every run is captured as local Markdown artifacts:
+
+- planned questions
+- NotebookLM answers
+- citation-backed notes
+- run-level archives
+
+This makes the output:
+
+- **easy to reuse**
+  - turn answers into memos, decks, scripts, articles, or teaching material
+- **easy to search**
+  - keep everything in local files instead of browser history
+- **easy to extend**
+  - use previous runs as source material for later research
+- **easy to organize**
+  - keep an Obsidian-friendly archive that can grow into a real knowledge base
+- **easy to version**
+  - fit naturally into Git-based workflows
+
+SourceLoop does not just help you get answers. It helps you keep them in a form you can build on.
+
+## Security Model
+
+SourceLoop recommends using a dedicated SourceLoop-managed Chrome profile for research work.
+
+- do not use your normal personal Chrome profile as the preferred research path
+- `sourceloop chrome launch` creates a separate research browser profile
+- after signing in to Google and NotebookLM once, you can keep reusing that research session
+- this keeps research activity separate from your personal cookies, tabs, and extension context
+- if the preferred SourceLoop browser is unavailable, another Chrome session can still be used, but only after explicit user approval
+
+In short:
+
+- preferred path: a dedicated research browser
+- fallback path: another existing Chrome session
+- fallback use requires explicit user confirmation
+
+## Installation
+
+```bash
+# Install the CLI globally
+npm install -g sourceloop
+
+# Go to your project
+cd /path/to/your/project
+
+# Initialize SourceLoop
+sourceloop init
+
+# Install project-local AI bootstrap
+sourceloop init --ai codex
+sourceloop init --ai claude
+sourceloop init --ai gemini
+```
+
+## Usage
+
+Use SourceLoop through your AI tool in plain language.
+
+### Start New Research
+
+You can say:
+
+```text
+Start research on attention in transformers.
+```
+
+Or:
+
+```text
+Start research on attention in transformers and use this video first:
+https://www.youtube.com/watch?v=eMlx5fFNoYc
+```
+
+SourceLoop helps the AI tool:
+
+- prepare a managed research browser
+- create a topic and notebook
+- import the provided sources
+- plan a question batch
+- archive answers and citations locally
+
+### Continue Existing Research
+
+You can say:
+
+```text
+Continue research from this NotebookLM notebook:
+https://notebooklm.google.com/notebook/<real-notebook-id>
+```
+
+SourceLoop helps the AI tool:
+
+- bind the existing notebook
+- inspect the current research state
+- continue planning or running from there
+
+### If You Prefer Direct CLI
+
+Use the Golden Path below.
+
+## Golden Path
+
+```bash
+mkdir my-research-workspace
+cd my-research-workspace
+sourceloop init --ai codex
+
+sourceloop status --json
+sourceloop doctor --json
+
+sourceloop topic create --name "AI agents market" --json
+
+# visible setup step: launch a dedicated research browser,
+# sign in yourself, then validate NotebookLM home access
+sourceloop chrome launch --name work-chrome
+sourceloop attach validate attach-work-chrome
+
+sourceloop notebook-create \
+  --name "AI Agents" \
+  --topic-id topic-ai-agents-market \
+  --attach-target attach-work-chrome \
+  --json
+
+# read the returned binding id from JSON or status output
+sourceloop ingest ./research-notes.md --topic topic-ai-agents-market
+
+sourceloop notebook-import \
+  --notebook <managed-notebook-binding-id> \
+  --source-id <source-id> \
+  --json
+
+sourceloop notebook-import \
+  --notebook <managed-notebook-binding-id> \
+  --url "https://youtube.com/watch?v=..." \
+  --json
+
+sourceloop plan topic-ai-agents-market --max-questions 10 --json
+sourceloop run <run-id> --json
+```
+
+## Operator Defaults
+
+If you use SourceLoop through Codex, Claude Code, Gemini CLI, or another local AI tool, these are the intended defaults:
+
+- start with `sourceloop status --json` and `sourceloop doctor --json`
+- ask for the topic first if the user did not provide one
+- if the user provided a topic but not sources, ask which sources to use before collecting or importing anything
+- mention that planning defaults to 10 questions unless the user wants another count
+- prefer `sourceloop chrome launch` over attaching to an unrelated Chrome profile
+- treat `sourceloop attach validate <target>` as NotebookLM home validation
+- use `--notebook-url` only when you specifically need to validate an existing notebook detail page
+- after initial setup, prefer hidden notebook actions by default and use `--show-browser` only for debugging or when the user wants to watch
+- if the plan was created for 10 questions and the user did not ask for a partial pass, run the planned batch end to end
+- use `--limit` only for explicit partial runs
+- tell the user briefly that NotebookLM actions can take a bit before waiting
+- if the wait becomes long, ask whether to keep waiting or report the current state
+- if the preferred SourceLoop browser is unavailable, ask whether to continue with the current Chrome or switch back to the SourceLoop browser
+
+## Existing Notebook Path
+
+If the notebook already exists and already has sources loaded in NotebookLM:
+
+```bash
+sourceloop notebook-bind \
+  --name "AI Agents" \
+  --topic-id topic-ai-agents-market \
+  --url "https://notebooklm.google.com/notebook/<real-notebook-id>" \
+  --attach-target attach-work-chrome \
+  --json
+
+sourceloop notebook-source declare \
+  --topic-id topic-ai-agents-market \
+  --notebook <notebook-binding-id> \
+  --kind mixed \
+  --title "AI agents market source set" \
+  --json
+```
+
+## Partial Runs and Backfills
+
+Use partial execution only when you explicitly want it.
+
+```bash
+sourceloop run <run-id> --limit 2 --json
+sourceloop run <run-id> --from-question <question-id> --json
+sourceloop run <run-id> --question-id <question-id> --json
+sourceloop import-latest <run-id> --question-id <question-id> --show-browser
+```
+
+## Machine-Readable Workflow
+
+Core operator commands support `--json`:
+
+- `topic create|list|show`
+- `notebook-create`
+- `notebook-bind`
+- `notebook-import`
+- `notebook-source declare|list|show`
+- `plan`
+- `run`
+- `status`
+- `doctor`
+
+Example:
+
+```bash
+sourceloop status --json
+sourceloop doctor --json
+sourceloop topic create --name "AI agents market" --json
+sourceloop chrome launch --name work-chrome
+sourceloop attach validate attach-work-chrome
+sourceloop notebook-create --name "AI Agents" --topic-id topic-ai-agents-market --attach-target attach-work-chrome --json
+sourceloop notebook-import --notebook <managed-notebook-binding-id> --url "https://youtube.com/watch?v=..." --json
+sourceloop plan topic-ai-agents-market --max-questions 10 --json
+sourceloop run <run-id> --json
+```
+
+## Vault Layout
+
+```text
+vault/
+├─ chrome-targets/
+├─ notebook-imports/
+├─ notebook-setups/
+├─ notebooks/
+├─ notebook-sources/
+├─ runs/
+├─ sources/
+└─ topics/
+```
+
+Main result:
+
+```text
+vault/runs/<run-id>/
+├─ index.md
+├─ questions.md
+└─ exchanges/
+   ├─ q01....md
+   ├─ q02....md
+   └─ ...
+```
+
+## Project Boundary
+
+SourceLoop stops at research packaging and Q&A archive creation.
+
+- humans choose the topic
+- NotebookLM answers from the bound notebook
+- SourceLoop stores the research trace
+- humans turn that archive into slides, scripts, memos, lessons, or deliverables
+
+This is the intended split:
+
+- use AI for research
+- use humans for judgment and expression
+
+## Current Status
+
+Current focus:
+
+- topic-first NotebookLM workflow
+- managed notebook setup workflow
+- attached Chrome execution
+- Obsidian-friendly Markdown archive
+
+Still rough around:
+
+- NotebookLM UI selector stability
+- citation capture fidelity
+- automatic NotebookLM source introspection beyond operator-declared manifests
+
+## Development
+
+```bash
+pnpm install
+pnpm build
+pnpm test
+```
+
+For local CLI usage:
+
+```bash
+pnpm install
+pnpm build
+pnpm link --global
+
+sourceloop init --ai codex
+sourceloop --help
+```
+
+Reference docs:
+
+- [Architecture](./docs/architecture.md)
+- [LLM Playbook](./docs/llm-playbook.md)
+- [Tasks](./docs/tasks.md)
+- [Test Plan](./docs/test-plan.md)

package/dist/commands/attach.d.ts

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

package/dist/commands/attach.js

@@ -0,0 +1,103 @@
+import { Command } from "commander";
+import { listChromeAttachTargets, loadChromeAttachTarget, registerChromeEndpointTarget, registerChromeProfileTarget, removeChromeAttachTarget, upsertChromeAttachTarget } from "../core/attach/manage-targets.js";
+import { validateChromeAttachTarget } from "../core/notebooklm/browser-agent.js";
+import { chromeProfileIsolationSchema } from "../schemas/attach.js";
+export const attachCommand = new Command("attach").description("Register and inspect attached Chrome targets for NotebookLM execution");
+attachCommand
+    .command("profile")
+    .description("Register a Chrome profile directory to launch and attach for NotebookLM runs")
+    .requiredOption("--name <name>", "attach target name")
+    .requiredOption("--profile-dir <path>", "Chrome user data directory that is already signed in")
+    .option("--profile-isolation <isolation>", "Chrome profile isolation posture: isolated, unknown, or shared", "unknown")
+    .option("--chrome-path <path>", "explicit Google Chrome executable path")
+    .option("--port <port>", "preferred remote debugging port for launched Chrome")
+    .option("--launch-arg <arg...>", "additional Chrome launch arguments")
+    .option("--description <description>", "target description")
+    .option("--force", "overwrite an existing attach target with the same id", false)
+    .action(async (options) => {
+    const result = await registerChromeProfileTarget({
+        name: options.name,
+        profileDirPath: options.profileDir,
+        profileIsolation: chromeProfileIsolationSchema.parse(options.profileIsolation),
+        launchArgs: options.launchArg ?? [],
+        force: options.force,
+        ...(options.chromePath ? { chromeExecutablePath: options.chromePath } : {}),
+        ...(options.port ? { remoteDebuggingPort: Number(options.port) } : {}),
+        ...(options.description ? { description: options.description } : {})
+    });
+    process.stdout.write(`Registered attach target ${result.target.id} at ${result.markdownPath}\n`);
+});
+attachCommand
+    .command("endpoint")
+    .description("Register an existing Chrome remote debugging endpoint for NotebookLM runs")
+    .requiredOption("--name <name>", "attach target name")
+    .requiredOption("--endpoint <url>", "Chrome remote debugging endpoint, for example http://127.0.0.1:9222")
+    .option("--profile-isolation <isolation>", "Chrome profile isolation posture behind the endpoint: isolated, unknown, or shared", "unknown")
+    .option("--description <description>", "target description")
+    .option("--force", "overwrite an existing attach target with the same id", false)
+    .action(async (options) => {
+    const result = await registerChromeEndpointTarget({
+        name: options.name,
+        endpoint: options.endpoint,
+        profileIsolation: chromeProfileIsolationSchema.parse(options.profileIsolation),
+        force: options.force,
+        ...(options.description ? { description: options.description } : {})
+    });
+    process.stdout.write(`Registered attach target ${result.target.id} at ${result.markdownPath}\n`);
+});
+attachCommand
+    .command("list")
+    .description("List registered Chrome attach targets")
+    .action(async () => {
+    const targets = await listChromeAttachTargets();
+    if (targets.length === 0) {
+        process.stdout.write("No Chrome attach targets registered.\n");
+        return;
+    }
+    for (const target of targets) {
+        const summary = target.targetType === "profile" ? target.profileDirPath : target.endpoint;
+        process.stdout.write(`${target.id}\t${target.targetType}\t${target.profileIsolation}\t${summary}\n`);
+    }
+});
+attachCommand
+    .command("show")
+    .description("Show one registered Chrome attach target")
+    .argument("<target-id>", "attach target id")
+    .action(async (targetId) => {
+    const { target } = await loadChromeAttachTarget(targetId);
+    process.stdout.write(`${JSON.stringify(target, null, 2)}\n`);
+});
+attachCommand
+    .command("validate")
+    .description("Validate that a Chrome attach target can reach NotebookLM")
+    .argument("<target-id>", "attach target id")
+    .option("--notebook-url <url>", "NotebookLM notebook URL to preflight")
+    .option("--show-browser", "show Chrome while validating a profile attach target", false)
+    .action(async (targetId, options) => {
+    const { target } = await loadChromeAttachTarget(targetId);
+    const result = await validateChromeAttachTarget({
+        target,
+        ...(options.notebookUrl ? { notebookUrl: options.notebookUrl } : {}),
+        showBrowser: options.showBrowser
+    });
+    if (result.ok) {
+        const validatedTarget = {
+            ...target,
+            notebooklmReadiness: "validated",
+            notebooklmValidatedAt: new Date().toISOString()
+        };
+        await upsertChromeAttachTarget(validatedTarget);
+        process.stdout.write(`Attach target ${targetId} is ready for NotebookLM execution.\n`);
+        return;
+    }
+    throw new Error(`[${result.code}] ${result.message}`);
+});
+attachCommand
+    .command("remove")
+    .description("Remove a registered Chrome attach target")
+    .argument("<target-id>", "attach target id")
+    .action(async (targetId) => {
+    await removeChromeAttachTarget({ targetId });
+    process.stdout.write(`Removed attach target ${targetId}\n`);
+});
+//# sourceMappingURL=attach.js.map

package/dist/commands/attach.js.map

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

package/dist/commands/auth.d.ts

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

package/dist/commands/auth.js

@@ -0,0 +1,33 @@
+import { Command } from "commander";
+import { clearNotebookAuth, getNotebookAuthStatus, setupNotebookAuth } from "../core/notebooklm/auth.js";
+export const authCommand = new Command("auth").description("Legacy NotebookLM auth helpers (deprecated: use attach-first workflow instead)");
+authCommand
+    .command("setup")
+    .description("Legacy login bootstrap for NotebookLM (deprecated; use attach profile/endpoint instead)")
+    .option("--profile <profile>", "browser profile alias", "default")
+    .option("--timeout-minutes <minutes>", "login timeout in minutes", "10")
+    .action(async (options) => {
+    process.stderr.write("Warning: auth setup is deprecated. Preferred workflow: sign in to Chrome yourself, register it with `sourceloop attach`, then run NotebookLM batches.\n");
+    const status = await setupNotebookAuth({
+        profile: options.profile,
+        timeoutMinutes: Number(options.timeoutMinutes)
+    });
+    process.stdout.write(`NotebookLM auth ready for profile ${status.profile} (${status.stateFilePath})\n`);
+});
+authCommand
+    .command("status")
+    .description("Check legacy NotebookLM authentication status")
+    .option("--profile <profile>", "browser profile alias", "default")
+    .action(async (options) => {
+    const status = await getNotebookAuthStatus({ profile: options.profile });
+    process.stdout.write(`${status.profile}: ${status.authenticated ? "authenticated" : "not authenticated"} (${status.stateFilePath})\n`);
+});
+authCommand
+    .command("clear")
+    .description("Clear legacy NotebookLM authentication state for a profile")
+    .option("--profile <profile>", "browser profile alias", "default")
+    .action(async (options) => {
+    const status = await clearNotebookAuth({ profile: options.profile });
+    process.stdout.write(`Cleared NotebookLM auth for profile ${status.profile}\n`);
+});
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEzG,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CACxD,gFAAgF,CACjF,CAAC;AAEF,WAAW;KACR,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,yFAAyF,CAAC;KACtG,MAAM,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,SAAS,CAAC;KACjE,MAAM,CAAC,6BAA6B,EAAE,0BAA0B,EAAE,IAAI,CAAC;KACvE,MAAM,CAAC,KAAK,EAAE,OAAoD,EAAE,EAAE;IACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yJAAyJ,CAC1J,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;QACrC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC;KAC/C,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qCAAqC,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,aAAa,KAAK,CAClF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL,WAAW;KACR,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,+CAA+C,CAAC;KAC5D,MAAM,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,SAAS,CAAC;KACjE,MAAM,CAAC,KAAK,EAAE,OAA4B,EAAE,EAAE;IAC7C,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,KAAK,MAAM,CAAC,aAAa,KAAK,CACjH,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL,WAAW;KACR,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,4DAA4D,CAAC;KACzE,MAAM,CAAC,qBAAqB,EAAE,uBAAuB,EAAE,SAAS,CAAC;KACjE,MAAM,CAAC,KAAK,EAAE,OAA4B,EAAE,EAAE;IAC7C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;AAClF,CAAC,CAAC,CAAC"}

package/dist/commands/chrome.d.ts

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

package/dist/commands/chrome.js

@@ -0,0 +1,30 @@
+import { Command } from "commander";
+import { launchManagedChrome } from "../core/attach/launch-managed-chrome.js";
+import { writeJsonOutput, writeTextOutput } from "../lib/cli-output.js";
+export const chromeCommand = new Command("chrome").description("Launch and inspect SourceLoop-managed Chrome browser workflows");
+chromeCommand
+    .command("launch")
+    .description("Launch a dedicated isolated Chrome research profile and register it as an attach target")
+    .option("--name <name>", "managed Chrome launch target name", "research-browser")
+    .option("--chrome-path <path>", "explicit Google Chrome executable path")
+    .option("--port <port>", "preferred remote debugging port")
+    .option("--launch-arg <arg...>", "additional Chrome launch arguments")
+    .option("--description <description>", "target description")
+    .option("--force", "replace an existing attach target with the same id", false)
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (options) => {
+    const result = await launchManagedChrome({
+        name: options.name,
+        ...(options.chromePath ? { chromeExecutablePath: options.chromePath } : {}),
+        ...(options.port ? { remoteDebuggingPort: Number(options.port) } : {}),
+        ...(options.launchArg ? { launchArgs: options.launchArg } : {}),
+        ...(options.description ? { description: options.description } : {}),
+        force: options.force
+    });
+    if (options.json) {
+        writeJsonOutput(result);
+        return;
+    }
+    writeTextOutput(`${result.launched ? "Launched" : "Reused"} managed Chrome ${result.target.id} at ${result.endpoint} using ${result.profileDirPath}`);
+});
+//# sourceMappingURL=chrome.js.map

package/dist/commands/chrome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.js","sourceRoot":"","sources":["../../src/commands/chrome.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAC5D,gEAAgE,CACjE,CAAC;AAEF,aAAa;KACV,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,yFAAyF,CAAC;KACtG,MAAM,CAAC,eAAe,EAAE,mCAAmC,EAAE,kBAAkB,CAAC;KAChF,MAAM,CAAC,sBAAsB,EAAE,wCAAwC,CAAC;KACxE,MAAM,CAAC,eAAe,EAAE,iCAAiC,CAAC;KAC1D,MAAM,CAAC,uBAAuB,EAAE,oCAAoC,CAAC;KACrE,MAAM,CAAC,6BAA6B,EAAE,oBAAoB,CAAC;KAC3D,MAAM,CAAC,SAAS,EAAE,oDAAoD,EAAE,KAAK,CAAC;KAC9E,MAAM,CAAC,QAAQ,EAAE,4BAA4B,EAAE,KAAK,CAAC;KACrD,MAAM,CACL,KAAK,EAAE,OAQN,EAAE,EAAE;IACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;QACvC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,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,CACb,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,mBAAmB,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC,QAAQ,UAAU,MAAM,CAAC,cAAc,EAAE,CACrI,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/commands/compose.d.ts

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

package/dist/commands/compose.js

@@ -0,0 +1,14 @@
+import { Command } from "commander";
+import { composeRun } from "../core/outputs/compose-run.js";
+export const composeCommand = new Command("compose")
+    .description("Compose a run archive into an Obsidian-friendly output artifact")
+    .argument("<run-id>", "run id to compose")
+    .requiredOption("--format <format>", "output format: brief or outline")
+    .action(async (runId, options) => {
+    const result = await composeRun({
+        runId,
+        format: options.format
+    });
+    process.stdout.write(`Composed ${result.artifact.format} at ${result.markdownPath}\n`);
+});
+//# sourceMappingURL=compose.js.map

package/dist/commands/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/commands/compose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;KACjD,WAAW,CAAC,iEAAiE,CAAC;KAC9E,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;KACzC,cAAc,CAAC,mBAAmB,EAAE,iCAAiC,CAAC;KACtE,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,OAAwC,EAAE,EAAE;IACxE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;QAC9B,KAAK;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,MAAM,CAAC,QAAQ,CAAC,MAAM,OAAO,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC;AACzF,CAAC,CAAC,CAAC"}

package/dist/commands/doctor.d.ts

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

package/dist/commands/doctor.js

@@ -0,0 +1,15 @@
+import { Command } from "commander";
+import { buildDoctorReport, formatDoctorReport } from "../core/operator/workspace-operator.js";
+import { writeJsonOutput, writeTextOutput } from "../lib/cli-output.js";
+export const doctorCommand = new Command("doctor")
+    .description("Diagnose missing or broken SourceLoop workflow prerequisites")
+    .option("--json", "emit machine-readable JSON", false)
+    .action(async (options) => {
+    const report = await buildDoctorReport();
+    if (options.json) {
+        writeJsonOutput(report);
+        return;
+    }
+    writeTextOutput(formatDoctorReport(report));
+});
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KAC/C,WAAW,CAAC,8DAA8D,CAAC;KAC3E,MAAM,CAAC,QAAQ,EAAE,4BAA4B,EAAE,KAAK,CAAC;KACrD,MAAM,CAAC,KAAK,EAAE,OAA0B,EAAE,EAAE;IAC3C,MAAM,MAAM,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAEzC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,eAAe,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IAED,eAAe,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC"}

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

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