@phyzess/pappra 0.1.0-beta.12 → 0.1.0-beta.13

package/dist/hosts/integration/pappra-extension-runtime.mjs

@@ -6,8 +6,8 @@ var __export = (target, all) => {
 
 // dist/hosts/integration/hook.js
 import { randomUUID as randomUUID3 } from "node:crypto";
-import { link as link2, mkdir as mkdir3, open as open5, rm as rm2 } from "node:fs/promises";
-import { isAbsolute as isAbsolute4, join as join8, relative as relative3, resolve as resolve6, sep as sep3 } from "node:path";
+import { link as link2, mkdir as mkdir4, open as open5, rm as rm2 } from "node:fs/promises";
+import { isAbsolute as isAbsolute4, join as join9, relative as relative3, resolve as resolve6, sep as sep3 } from "node:path";
 
 // dist/schemas/diagnostics.js
 function createDiagnostic(input2) {
@@ -20662,6 +20662,9 @@ var workspaceValidationSchema = external_exports.strictObject({
   executable: executableSchema,
   args: external_exports.array(argumentSchema).max(256)
 });
+var workspaceContinuitySchema = external_exports.strictObject({
+  autoResume: external_exports.boolean()
+});
 var workspaceConfigSchema = external_exports.strictObject({
   schema: external_exports.literal(WORKSPACE_SCHEMA),
   workspaceId: external_exports.uuid(),
@@ -20672,7 +20675,8 @@ var workspaceConfigSchema = external_exports.strictObject({
   code: workspaceCodeSchema,
   validation: external_exports.array(workspaceValidationSchema).max(128),
   excludes: external_exports.array(portablePathSchema).max(128),
-  extensions: external_exports.record(external_exports.string().min(1).max(128), external_exports.unknown())
+  extensions: external_exports.record(external_exports.string().min(1).max(128), external_exports.unknown()),
+  continuity: workspaceContinuitySchema.optional()
 });
 function pathDiagnostic(value, source, fieldPointer, label) {
   const hint = 'Use a workspace-relative path such as "docs" or "repos/app".';
@@ -23928,6 +23932,42 @@ async function ensureStatePathBoundary(root, path) {
   }
 }
 
+// dist/app/task-pin.js
+import { mkdir as mkdir3, readFile, rename as rename2, writeFile } from "node:fs/promises";
+import { dirname as dirname5, join as join8 } from "node:path";
+var TASK_PIN_SCHEMA = "pappra/task-pin/1";
+var TASK_ID2 = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+function pinPath(root) {
+  return join8(root, ".pappra", "local", "current-task");
+}
+async function readTaskPin(root) {
+  const read = await readTextFileBounded(pinPath(root), 64 * 1024);
+  if (!read.ok)
+    return null;
+  try {
+    const value = JSON.parse(read.value.text);
+    if (typeof value !== "object" || value === null || !("schema" in value) || value.schema !== TASK_PIN_SCHEMA || !("taskId" in value) || typeof value.taskId !== "string" || !TASK_ID2.test(value.taskId)) {
+      return null;
+    }
+    return value;
+  } catch {
+    return null;
+  }
+}
+async function readAutoResume(root) {
+  const read = await readFile(join8(root, ".pappra", "workspace.json"), "utf8");
+  try {
+    const raw = JSON.parse(read);
+    if (typeof raw !== "object" || raw === null || !("continuity" in raw)) {
+      return false;
+    }
+    const continuity = raw.continuity;
+    return typeof continuity === "object" && continuity !== null && "autoResume" in continuity && continuity.autoResume === true;
+  } catch {
+    return false;
+  }
+}
+
 // dist/hosts/integration/support.js
 var HOST_SUPPORT = {
   pi: {
@@ -24015,7 +24055,7 @@ async function privateSegmentsSafe(root, directory) {
   }
   let current = root;
   for (const segment of rel.split(sep3)) {
-    current = join8(current, segment);
+    current = join9(current, segment);
     const observed = await observePath(current);
     if (observed.kind === "missing")
       return true;
@@ -24256,7 +24296,7 @@ async function runHostHook(input2, options = {}) {
     });
   }
   const eventKey = value.eventId === null ? null : sha256Digest([value.host, value.event, value.sessionId ?? "", value.eventId].join("\0"));
-  const directory = join8(root, ".pappra", "local", "host-events", value.host);
+  const directory = join9(root, ".pappra", "local", "host-events", value.host);
   if (!await privateSegmentsSafe(root, directory)) {
     return result2({
       ok: false,
@@ -24301,7 +24341,7 @@ async function runHostHook(input2, options = {}) {
       ]
     });
   }
-  await mkdir3(directory, { recursive: true, mode: 448 });
+  await mkdir4(directory, { recursive: true, mode: 448 });
   const directoryAfter = await observePath(directory);
   const realDirectory = await resolveRealpath(directory);
   const privateAfter = await privateSegmentsSafe(root, directory);
@@ -24326,7 +24366,9 @@ async function runHostHook(input2, options = {}) {
     dev: directoryAfter.stats.dev,
     ino: directoryAfter.stats.ino
   };
-  const context = await boundedAdvisory(root, value.event, value.taskId, workspaceRead.value.name);
+  const pinnedTask = await readTaskPin(root);
+  const autoResume = pinnedTask !== null && await readAutoResume(root);
+  const context = await boundedAdvisory(root, value.event, value.taskId ?? (autoResume ? pinnedTask.taskId : null), workspaceRead.value.name);
   if (clock() - started > deadline) {
     return result2({
       ok: false,
@@ -24342,7 +24384,7 @@ async function runHostHook(input2, options = {}) {
     });
   }
   const fileName = eventKey === null ? `${sha256Digest(`${value.observedAt}\0${randomUUID3()}`).slice(7)}.json` : `${eventKey.slice(7)}.json`;
-  const path = join8(directory, fileName);
+  const path = join9(directory, fileName);
   const record2 = Buffer.from(`${JSON.stringify({
     schema: "pappra/host-event/1",
     host: value.host,

package/dist/hosts/integration/pappra-hook.mjs

@@ -6,8 +6,8 @@ var __export = (target, all) => {
 
 // dist/hosts/integration/hook.js
 import { randomUUID as randomUUID3 } from "node:crypto";
-import { link as link2, mkdir as mkdir3, open as open5, rm as rm2 } from "node:fs/promises";
-import { isAbsolute as isAbsolute4, join as join8, relative as relative3, resolve as resolve6, sep as sep3 } from "node:path";
+import { link as link2, mkdir as mkdir4, open as open5, rm as rm2 } from "node:fs/promises";
+import { isAbsolute as isAbsolute4, join as join9, relative as relative3, resolve as resolve6, sep as sep3 } from "node:path";
 
 // dist/schemas/diagnostics.js
 function createDiagnostic(input2) {
@@ -20667,6 +20667,9 @@ var workspaceValidationSchema = external_exports.strictObject({
   executable: executableSchema,
   args: external_exports.array(argumentSchema).max(256)
 });
+var workspaceContinuitySchema = external_exports.strictObject({
+  autoResume: external_exports.boolean()
+});
 var workspaceConfigSchema = external_exports.strictObject({
   schema: external_exports.literal(WORKSPACE_SCHEMA),
   workspaceId: external_exports.uuid(),
@@ -20677,7 +20680,8 @@ var workspaceConfigSchema = external_exports.strictObject({
   code: workspaceCodeSchema,
   validation: external_exports.array(workspaceValidationSchema).max(128),
   excludes: external_exports.array(portablePathSchema).max(128),
-  extensions: external_exports.record(external_exports.string().min(1).max(128), external_exports.unknown())
+  extensions: external_exports.record(external_exports.string().min(1).max(128), external_exports.unknown()),
+  continuity: workspaceContinuitySchema.optional()
 });
 function pathDiagnostic(value, source, fieldPointer, label) {
   const hint = 'Use a workspace-relative path such as "docs" or "repos/app".';
@@ -23933,6 +23937,42 @@ async function ensureStatePathBoundary(root, path) {
   }
 }
 
+// dist/app/task-pin.js
+import { mkdir as mkdir3, readFile, rename as rename2, writeFile } from "node:fs/promises";
+import { dirname as dirname5, join as join8 } from "node:path";
+var TASK_PIN_SCHEMA = "pappra/task-pin/1";
+var TASK_ID2 = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+function pinPath(root) {
+  return join8(root, ".pappra", "local", "current-task");
+}
+async function readTaskPin(root) {
+  const read = await readTextFileBounded(pinPath(root), 64 * 1024);
+  if (!read.ok)
+    return null;
+  try {
+    const value = JSON.parse(read.value.text);
+    if (typeof value !== "object" || value === null || !("schema" in value) || value.schema !== TASK_PIN_SCHEMA || !("taskId" in value) || typeof value.taskId !== "string" || !TASK_ID2.test(value.taskId)) {
+      return null;
+    }
+    return value;
+  } catch {
+    return null;
+  }
+}
+async function readAutoResume(root) {
+  const read = await readFile(join8(root, ".pappra", "workspace.json"), "utf8");
+  try {
+    const raw = JSON.parse(read);
+    if (typeof raw !== "object" || raw === null || !("continuity" in raw)) {
+      return false;
+    }
+    const continuity = raw.continuity;
+    return typeof continuity === "object" && continuity !== null && "autoResume" in continuity && continuity.autoResume === true;
+  } catch {
+    return false;
+  }
+}
+
 // dist/hosts/integration/support.js
 var HOST_SUPPORT = {
   pi: {
@@ -24038,7 +24078,7 @@ async function privateSegmentsSafe(root, directory) {
   }
   let current = root;
   for (const segment of rel.split(sep3)) {
-    current = join8(current, segment);
+    current = join9(current, segment);
     const observed = await observePath(current);
     if (observed.kind === "missing")
       return true;
@@ -24337,7 +24377,7 @@ async function runHostHook(input2, options = {}) {
     });
   }
   const eventKey = value.eventId === null ? null : sha256Digest([value.host, value.event, value.sessionId ?? "", value.eventId].join("\0"));
-  const directory = join8(root, ".pappra", "local", "host-events", value.host);
+  const directory = join9(root, ".pappra", "local", "host-events", value.host);
   if (!await privateSegmentsSafe(root, directory)) {
     return result2({
       ok: false,
@@ -24382,7 +24422,7 @@ async function runHostHook(input2, options = {}) {
       ]
     });
   }
-  await mkdir3(directory, { recursive: true, mode: 448 });
+  await mkdir4(directory, { recursive: true, mode: 448 });
   const directoryAfter = await observePath(directory);
   const realDirectory = await resolveRealpath(directory);
   const privateAfter = await privateSegmentsSafe(root, directory);
@@ -24407,7 +24447,9 @@ async function runHostHook(input2, options = {}) {
     dev: directoryAfter.stats.dev,
     ino: directoryAfter.stats.ino
   };
-  const context = await boundedAdvisory(root, value.event, value.taskId, workspaceRead.value.name);
+  const pinnedTask = await readTaskPin(root);
+  const autoResume = pinnedTask !== null && await readAutoResume(root);
+  const context = await boundedAdvisory(root, value.event, value.taskId ?? (autoResume ? pinnedTask.taskId : null), workspaceRead.value.name);
   if (clock() - started > deadline) {
     return result2({
       ok: false,
@@ -24423,7 +24465,7 @@ async function runHostHook(input2, options = {}) {
     });
   }
   const fileName = eventKey === null ? `${sha256Digest(`${value.observedAt}\0${randomUUID3()}`).slice(7)}.json` : `${eventKey.slice(7)}.json`;
-  const path = join8(directory, fileName);
+  const path = join9(directory, fileName);
   const record2 = Buffer.from(`${JSON.stringify({
     schema: "pappra/host-event/1",
     host: value.host,

package/dist/hosts/pilot.d.ts

@@ -26,13 +26,8 @@ export declare function readClaudeSessionId(file: string): string | null;
 export declare function readPiSessionId(file: string): string | null;
 export declare function runNativePilot({ harness, profile, cwd, promptFile, evidenceDir, sessionId, resume, timeoutMs, maxBudgetUsd, outputName, phase, trustProject, extraDirs, clock, assignmentFile, capabilitiesFile, taskRoot, maxAgeMinutes, launchKind, discovery, }: PilotOptions): Promise<{
     reservation?: never;
-    settlement?: never;
-    reservation_id?: never;
     refused: boolean;
     admission: {
-        owner_epoch?: never;
-        detail?: never;
-        state?: never;
         ok: false;
         reason: string;
         checks: Record<string, unknown>[];
@@ -41,6 +36,10 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         required_skills?: never;
         required_tools?: never;
         preflight?: never;
+        state?: never;
+        detail?: never;
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         resources?: never;
         mode?: never;
@@ -51,12 +50,7 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     } | {
-        expected?: never;
-        actual?: never;
-        owner_epoch?: never;
-        state?: never;
         ok: false;
         reason: string;
         checks: Record<string, unknown>[];
@@ -64,6 +58,11 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         required_skills?: never;
         required_tools?: never;
         preflight?: never;
+        state?: never;
+        expected?: never;
+        actual?: never;
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         resources?: never;
         mode?: never;
@@ -74,19 +73,19 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     } | {
-        expected?: never;
-        actual?: never;
-        owner_epoch?: never;
-        detail?: never;
-        state?: never;
         ok: false;
         reason: string;
         checks: Record<string, unknown>[];
         required_skills?: never;
         required_tools?: never;
         preflight?: never;
+        state?: never;
+        detail?: never;
+        expected?: never;
+        actual?: never;
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         resources?: never;
         mode?: never;
@@ -97,11 +96,7 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     } | {
-        owner_epoch?: never;
-        detail?: never;
-        state?: never;
         ok: false;
         reason: string;
         checks: Record<string, unknown>[];
@@ -110,6 +105,10 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         required_skills?: never;
         required_tools?: never;
         preflight?: never;
+        state?: never;
+        detail?: never;
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         resources?: never;
         mode?: never;
@@ -120,11 +119,7 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     } | {
-        owner_epoch?: never;
-        detail?: never;
-        state?: never;
         ok: false;
         reason: string;
         checks: Record<string, unknown>[];
@@ -138,6 +133,10 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         required_skills?: never;
         required_tools?: never;
         preflight?: never;
+        state?: never;
+        detail?: never;
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         resources?: never;
         mode?: never;
@@ -148,10 +147,7 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     } | {
-        owner_epoch?: never;
-        state?: never;
         ok: false;
         reason: string;
         checks: Record<string, unknown>[];
@@ -161,6 +157,9 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         required_skills?: never;
         required_tools?: never;
         preflight?: never;
+        state?: never;
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         resources?: never;
         mode?: never;
@@ -171,19 +170,19 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     } | {
-        expected?: never;
-        actual?: never;
-        owner_epoch?: never;
-        detail?: never;
-        state?: never;
         ok: false;
         reason: string;
         checks: Record<string, unknown>[];
         required_skills: number;
         required_tools: number;
         preflight?: never;
+        state?: never;
+        detail?: never;
+        expected?: never;
+        actual?: never;
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         resources?: never;
         mode?: never;
@@ -194,13 +193,7 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     } | {
-        expected?: never;
-        actual?: never;
-        owner_epoch?: never;
-        detail?: never;
-        state?: never;
         required_skills?: never;
         required_tools?: never;
         ok: false;
@@ -213,9 +206,9 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
             warnings: never[];
             task_id?: never;
             assignment_id?: never;
+            attempt?: never;
             checked_at?: never;
             limits?: never;
-            attempt?: never;
         } | {
             status: string;
             task_id: string;
@@ -227,6 +220,12 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
             warnings: import("../collab/preflight.js").Check[];
             limits: string[];
         };
+        state?: never;
+        detail?: never;
+        expected?: never;
+        actual?: never;
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         resources?: never;
         mode?: never;
@@ -237,12 +236,7 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     } | {
-        expected?: never;
-        actual?: never;
-        owner_epoch?: never;
-        detail?: never;
         required_skills?: never;
         required_tools?: never;
         preflight?: never;
@@ -250,6 +244,11 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         reason: string;
         checks: Record<string, unknown>[];
         state: string;
+        detail?: never;
+        expected?: never;
+        actual?: never;
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         resources?: never;
         mode?: never;
@@ -260,19 +259,19 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     } | {
-        owner_epoch?: never;
-        detail?: never;
-        state?: never;
         required_skills?: never;
         required_tools?: never;
         preflight?: never;
+        state?: never;
         ok: false;
         reason: string;
         checks: Record<string, unknown>[];
         expected: (string | null)[];
         actual: string;
+        detail?: never;
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         resources?: never;
         mode?: never;
@@ -283,20 +282,20 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     } | {
-        expected?: never;
-        actual?: never;
-        owner_epoch?: never;
-        state?: never;
         required_skills?: never;
         required_tools?: never;
         preflight?: never;
+        state?: never;
         ok: false;
         reason: string;
         checks: Record<string, unknown>[];
         resources: Record<string, unknown>[];
         detail: string;
+        expected?: never;
+        actual?: never;
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         mode?: never;
         launch_kind?: never;
@@ -306,20 +305,20 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     } | {
-        owner_epoch?: never;
-        detail?: never;
-        state?: never;
         required_skills?: never;
         required_tools?: never;
         preflight?: never;
+        state?: never;
+        detail?: never;
         ok: false;
         reason: string;
         checks: Record<string, unknown>[];
         resources: Record<string, unknown>[];
         expected: number | undefined;
         actual: number;
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         mode?: never;
         launch_kind?: never;
@@ -329,20 +328,20 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     } | {
-        expected?: never;
-        actual?: never;
-        owner_epoch?: never;
-        detail?: never;
-        state?: never;
         required_skills?: never;
         required_tools?: never;
         preflight?: never;
+        state?: never;
+        detail?: never;
+        expected?: never;
+        actual?: never;
         ok: false;
         reason: string;
         checks: Record<string, unknown>[];
         resources: Record<string, unknown>[];
+        state_revision?: never;
+        owner_epoch?: never;
         attempt_state?: never;
         mode?: never;
         launch_kind?: never;
@@ -352,7 +351,6 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
         capability_evidence?: never;
         assignment_digest?: never;
         input_revision?: never;
-        state_revision?: never;
     };
     reason: string;
     process?: never;
@@ -363,19 +361,19 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
     stdoutFile?: never;
     stderrFile?: never;
     nativeEvidence?: never;
-} | {
-    settlement?: never;
     reservation_id?: never;
+    settlement?: never;
+} | {
     refused: boolean;
     admission: {
-        reason?: never;
-        expected?: never;
-        actual?: never;
-        detail?: never;
-        state?: never;
         required_skills?: never;
         required_tools?: never;
         preflight?: never;
+        state?: never;
+        detail?: never;
+        expected?: never;
+        actual?: never;
+        reason?: never;
         ok: true;
         checks: Record<string, unknown>[];
         state_revision: number;
@@ -405,12 +403,13 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
     stdoutFile?: never;
     stderrFile?: never;
     nativeEvidence?: never;
+    reservation_id?: never;
+    settlement?: never;
 } | {
     reason?: never;
     reservation?: never;
-    admission?: never;
     refused?: never;
-    reservation_id?: never;
+    admission?: never;
     execution: null;
     evidenceError: string;
     settlement: {
@@ -436,12 +435,12 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
     stdoutFile?: never;
     stderrFile?: never;
     nativeEvidence?: never;
+    reservation_id?: never;
 } | {
     reason?: never;
     reservation?: never;
-    admission?: never;
     refused?: never;
-    reservation_id?: never;
+    admission?: never;
     process?: never;
     execution: Record<string, unknown> | null;
     evidenceError: string;
@@ -459,11 +458,12 @@ export declare function runNativePilot({ harness, profile, cwd, promptFile, evid
     stdoutFile?: never;
     stderrFile?: never;
     nativeEvidence?: never;
+    reservation_id?: never;
 } | {
     reason?: never;
     reservation?: never;
-    admission?: never;
     refused?: never;
+    admission?: never;
     process?: never;
     evidenceError?: never;
     execution: Record<string, unknown>;

package/dist/knowledge/scan.d.ts

@@ -0,0 +1,30 @@
+import type { Diagnostic } from '../schemas/diagnostics.js';
+import type { DocumentKind } from '../schemas/document.js';
+export interface DocumentScanCandidate {
+    readonly path: string;
+    readonly kind: DocumentKind;
+    readonly visibility: 'private' | 'shareable';
+}
+export interface DocumentScanResult {
+    readonly ok: boolean;
+    readonly schema: 'pappra/docs-scan/1';
+    readonly mode: 'plan' | 'apply';
+    readonly workspaceRoot: string;
+    readonly candidates: readonly DocumentScanCandidate[];
+    readonly registered: readonly unknown[];
+    readonly skipped: number;
+    readonly nextActions: readonly string[];
+    readonly diagnostics: readonly Diagnostic[];
+}
+export type DocumentScanFailure = {
+    readonly ok: false;
+    readonly message: string;
+} | DocumentScanResult;
+export declare function classifyScannedDocumentKind(path: string): DocumentKind;
+/**
+ * Registers documents discovered under the configured knowledge sources.
+ * Without apply this is read-only and reports the candidates.
+ */
+export declare function scanDiscoveredDocuments(root: string, options: {
+    readonly apply: boolean;
+}): Promise<DocumentScanFailure>;