sourceloop 0.1.1

package/dist/core/notebooks/manage-notebook-source-manifests.js

@@ -0,0 +1,127 @@
+import { access, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { loadWorkspace } from "../workspace/load-workspace.js";
+import { getVaultPaths } from "../vault/paths.js";
+import { getNotebookNote, getNotebookSourceManifestNote, getTopicIndexNote, toWikiLink } from "../vault/notes.js";
+import { notebookSourceKindSchema, notebookSourceManifestSchema } from "../../schemas/notebook-source.js";
+import { loadNotebookBinding } from "../runs/load-artifacts.js";
+import { loadTopic, refreshTopicArtifacts } from "../topics/manage-topics.js";
+import { toFrontmatterMarkdown } from "../ingest/frontmatter.js";
+import { writeJsonFile } from "../../lib/write-json.js";
+import { makeAliases, makeTags, normalizeObsidianText } from "../../lib/obsidian.js";
+import { slugify } from "../../lib/slugify.js";
+export async function declareNotebookSourceManifest(input) {
+    const workspace = await loadWorkspace(input.cwd);
+    const vault = getVaultPaths(workspace);
+    await mkdir(vault.notebookSourcesDir, { recursive: true });
+    const [{ topic }, { binding }] = await Promise.all([
+        loadTopic(input.topicId, input.cwd),
+        loadNotebookBinding(input.notebookBindingId, input.cwd)
+    ]);
+    if (binding.topicId !== input.topicId) {
+        throw new Error(`Notebook binding ${binding.id} belongs to ${binding.topicId ?? "legacy-notebook-first"}, not topic ${input.topicId}.`);
+    }
+    const kind = notebookSourceKindSchema.parse(input.kind);
+    const title = normalizeObsidianText(input.title);
+    const now = new Date().toISOString();
+    const id = `notebook-source-${slugify(`${input.topicId}-${binding.id}-${title}`)}`;
+    const jsonPath = path.join(vault.notebookSourcesDir, `${id}.json`);
+    if (!input.force && (await fileExists(jsonPath))) {
+        throw new Error(`Notebook source manifest ${id} already exists. Re-run with --force to overwrite it.`);
+    }
+    const manifest = notebookSourceManifestSchema.parse({
+        id,
+        type: "notebook_source_manifest",
+        topicId: input.topicId,
+        notebookBindingId: input.notebookBindingId,
+        kind,
+        title,
+        ...(input.description ? { description: normalizeObsidianText(input.description) } : {}),
+        ...(input.itemCount !== undefined ? { itemCount: input.itemCount } : {}),
+        refs: input.refs ?? [],
+        createdAt: now,
+        updatedAt: now
+    });
+    const note = getNotebookSourceManifestNote(workspace, manifest);
+    await writeJsonFile(jsonPath, manifest);
+    await writeFile(note.absolutePath, buildManifestMarkdown(workspace, manifest, topic, binding), "utf8");
+    await refreshTopicArtifacts(input.topicId, input.cwd);
+    return {
+        manifest,
+        markdownPath: note.absolutePath,
+        jsonPath
+    };
+}
+export async function loadNotebookSourceManifest(manifestId, cwd) {
+    const workspace = await loadWorkspace(cwd);
+    const vault = getVaultPaths(workspace);
+    const manifestPath = path.join(vault.notebookSourcesDir, `${manifestId}.json`);
+    const raw = await readFile(manifestPath, "utf8");
+    return {
+        workspace,
+        manifest: notebookSourceManifestSchema.parse(JSON.parse(raw)),
+        path: manifestPath
+    };
+}
+export async function listNotebookSourceManifests(cwd) {
+    const workspace = await loadWorkspace(cwd);
+    const vault = getVaultPaths(workspace);
+    try {
+        const entries = await readdir(vault.notebookSourcesDir);
+        const jsonFiles = entries.filter((entry) => entry.endsWith(".json"));
+        const raw = await Promise.all(jsonFiles.map((entry) => readFile(path.join(vault.notebookSourcesDir, entry), "utf8")));
+        return raw
+            .map((value) => notebookSourceManifestSchema.parse(JSON.parse(value)))
+            .sort((left, right) => left.title.localeCompare(right.title));
+    }
+    catch (error) {
+        if (isMissingDirectoryError(error)) {
+            return [];
+        }
+        throw error;
+    }
+}
+function buildManifestMarkdown(workspace, manifest, topic, binding) {
+    const title = normalizeObsidianText(manifest.title, manifest.id);
+    return toFrontmatterMarkdown({
+        type: "notebook-source",
+        title,
+        aliases: makeAliases(manifest.id),
+        tags: makeTags("sourceloop", "source", "notebook-backed", manifest.kind),
+        topic: normalizeObsidianText(topic.name, topic.id),
+        notebook: normalizeObsidianText(binding.name, binding.id),
+        source_kind: manifest.kind,
+        ...(manifest.itemCount !== undefined ? { item_count: String(manifest.itemCount) } : {}),
+        created: manifest.createdAt,
+        updated: manifest.updatedAt
+    }, `# ${title}
+
+## Topic
+- ${toWikiLink(workspace, getTopicIndexNote(workspace, topic).absolutePath, normalizeObsidianText(topic.name, topic.id))}
+
+## Notebook
+- ${toWikiLink(workspace, getNotebookNote(workspace, binding).absolutePath, normalizeObsidianText(binding.name, binding.id))}
+
+## Source Kind
+- ${manifest.kind}
+
+## Description
+${manifest.description ?? "No description provided."}
+
+## Declared References
+${manifest.refs.length > 0 ? manifest.refs.map((ref) => `- ${ref}`).join("\n") : "- none"}
+`);
+}
+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-notebook-source-manifests.js.map

package/dist/core/notebooks/manage-notebook-source-manifests.js.map

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

package/dist/core/operator/workspace-operator.d.ts

@@ -0,0 +1,82 @@
+import { type QARunIndex } from "../../schemas/run.js";
+import { type TopicStatus } from "../../schemas/topic.js";
+export type OperatorNextAction = {
+    kind: "create_topic" | "launch_isolated_browser" | "validate_attach" | "bind_notebook" | "declare_evidence" | "import_managed_source" | "plan_questions" | "resume_run" | "run_planned" | "review_attach_safety";
+    message: string;
+    command: string;
+    topicId?: string;
+    runId?: string;
+    notebookBindingId?: string;
+};
+export type TopicStatusSummary = {
+    id: string;
+    name: string;
+    status: TopicStatus;
+    notebookBindingCount: number;
+    localSourceCount: number;
+    notebookEvidenceCount: number;
+    managedNotebookImportCount: number;
+    runCount: number;
+    plannedRunCount: number;
+    incompleteRunCount: number;
+    completedRunCount: number;
+};
+export type RunStatusSummary = {
+    id: string;
+    topic: string;
+    topicId?: string;
+    notebookBindingId: string;
+    status: QARunIndex["status"];
+    completedQuestionCount: number;
+    totalQuestionCount: number;
+    failedQuestionId?: string;
+    executionMode?: QARunIndex["executionMode"];
+};
+export type WorkspaceStatusReport = {
+    workspaceRoot: string;
+    summary: {
+        topicCount: number;
+        notebookBindingCount: number;
+        localSourceCount: number;
+        notebookEvidenceCount: number;
+        managedNotebookCount: number;
+        managedImportCount: number;
+        attachTargetCount: number;
+        trustedIsolatedAttachTargetCount: number;
+        attachIsolation: {
+            isolated: number;
+            unknown: number;
+            shared: number;
+        };
+        runCount: number;
+        plannedRunCount: number;
+        incompleteRunCount: number;
+        completedRunCount: number;
+    };
+    topics: TopicStatusSummary[];
+    runs: RunStatusSummary[];
+    nextActions: OperatorNextAction[];
+};
+export type DoctorFinding = {
+    severity: "error" | "warning" | "info";
+    category: "workspace" | "topic" | "binding" | "evidence" | "run" | "attach";
+    message: string;
+    suggestedCommand?: string;
+    topicId?: string;
+    notebookBindingId?: string;
+    runId?: string;
+};
+export type DoctorReport = {
+    workspaceRoot: string;
+    healthy: boolean;
+    summary: {
+        errorCount: number;
+        warningCount: number;
+        infoCount: number;
+    };
+    findings: DoctorFinding[];
+};
+export declare function buildWorkspaceStatusReport(cwd?: string): Promise<WorkspaceStatusReport>;
+export declare function buildDoctorReport(cwd?: string): Promise<DoctorReport>;
+export declare function formatWorkspaceStatusReport(report: WorkspaceStatusReport): string;
+export declare function formatDoctorReport(report: DoctorReport): string;