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

package/dist/cli/run.js

@@ -1,6 +1,9 @@
 import { parseArgs } from 'node:util';
 import { getPackageInfo } from '../package-info.js';
 import { initUsage, runInitCommand } from './commands/init.js';
+import { onboardUsage, runOnboardCommand } from './commands/onboard.js';
+import { mcpUsage, runMcpCommand } from './commands/mcp.js';
+import { taskUsage, runTaskCommand } from './commands/task.js';
 import { doctorUsage, runDoctorCommand } from './commands/doctor.js';
 import { docsUsage, runDocsCommand } from './commands/docs.js';
 import { checkpointUsage, resumeUsage, runCheckpointCommand, runResumeCommand, } from './commands/continuity.js';
@@ -21,6 +24,11 @@ function parseOptions(args) {
             yes: { type: 'boolean', short: 'y' },
             'no-runtime': { type: 'boolean' },
             reconfigure: { type: 'boolean' },
+            hosts: { type: 'string' },
+            'apply-host': { type: 'boolean' },
+            'dry-run': { type: 'boolean' },
+            'print-handoff': { type: 'boolean' },
+            'auto-resume': { type: 'boolean' },
             from: { type: 'string' },
             tarball: { type: 'string' },
             out: { type: 'string' },
@@ -74,6 +82,25 @@ function parseOptions(args) {
         throw new Error('Use either --help or --version, not both.');
     }
     const command = positionals[0] ?? null;
+    if (command === 'task') {
+        if (positionals.length > 3) {
+            throw new Error('task accepts one action and an optional task id.');
+        }
+        return {
+            values,
+            command,
+            docsAction: null,
+            docsArgument: null,
+            codeAction: null,
+            hostAction: null,
+            hostSubAction: null,
+            collaborationAction: null,
+            resumeTaskId: null,
+            runtimeAction: null,
+            taskAction: positionals[1] ?? null,
+            taskArgument: positionals[2] ?? null,
+        };
+    }
     if (command === 'docs') {
         if (positionals.length > 3) {
             throw new Error('Unknown command; docs accepts one action and one argument.');
@@ -85,9 +112,12 @@ function parseOptions(args) {
             docsAction: positionals[1] ?? null,
             docsArgument: positionals[2] ?? null,
             hostAction: null,
+            hostSubAction: null,
             collaborationAction: null,
             resumeTaskId: null,
             runtimeAction: null,
+            taskAction: null,
+            taskArgument: null,
         };
     }
     if (command === 'resume') {
@@ -101,9 +131,12 @@ function parseOptions(args) {
             docsArgument: null,
             codeAction: null,
             hostAction: null,
+            hostSubAction: null,
             collaborationAction: null,
             resumeTaskId: positionals[1] ?? null,
             runtimeAction: null,
+            taskAction: null,
+            taskArgument: null,
         };
     }
     if (command === 'code') {
@@ -117,14 +150,17 @@ function parseOptions(args) {
             docsArgument: null,
             codeAction: positionals[1] ?? null,
             hostAction: null,
+            hostSubAction: null,
             collaborationAction: null,
             resumeTaskId: null,
             runtimeAction: null,
+            taskAction: null,
+            taskArgument: null,
         };
     }
     if (command === 'host') {
-        if (positionals.length > 2) {
-            throw new Error('host accepts one action: detect, describe, plan, install, or verify.');
+        if (positionals.length > 3) {
+            throw new Error('host accepts one action and an optional mcp sub-action.');
         }
         return {
             values,
@@ -133,9 +169,12 @@ function parseOptions(args) {
             docsArgument: null,
             codeAction: null,
             hostAction: positionals[1] ?? null,
+            hostSubAction: positionals[2] ?? null,
             collaborationAction: null,
             resumeTaskId: null,
             runtimeAction: null,
+            taskAction: null,
+            taskArgument: null,
         };
     }
     if (command === 'runtime') {
@@ -149,9 +188,12 @@ function parseOptions(args) {
             docsArgument: null,
             codeAction: null,
             hostAction: null,
+            hostSubAction: null,
             collaborationAction: null,
             resumeTaskId: null,
             runtimeAction: positionals[1] ?? null,
+            taskAction: null,
+            taskArgument: null,
         };
     }
     if (command === 'collab') {
@@ -165,9 +207,12 @@ function parseOptions(args) {
             docsArgument: null,
             codeAction: null,
             hostAction: null,
+            hostSubAction: null,
             collaborationAction: positionals[1] ?? null,
             resumeTaskId: null,
             runtimeAction: null,
+            taskAction: null,
+            taskArgument: null,
         };
     }
     if (positionals.length > 1) {
@@ -216,6 +261,10 @@ function hasContinuityOptions(values, includeSession = true) {
         (includeSession && values.session !== undefined));
 }
 const globalUsage = 'pappra [--help | --version] [--json]\n' +
+    'pappra task <pin|unpin|show> [taskId] [--auto-resume] [--json]\n' +
+    'pappra mcp [--root <dir>] [--help]\n' +
+    'pappra onboard [--root <dir>] [--config <file>] [--hosts <list>] [--yes]\n' +
+    '               [--apply-host] [--dry-run] [--print-handoff] [--json]\n' +
     'pappra init [--config <file> | --yes] [--apply] [--json] [--print-choices]\n' +
     '              [--install-runtime (--runtime-tarball <file> | --runtime-version <version>)]\n' +
     'pappra doctor [--root <path>] [--json]\n' +
@@ -236,16 +285,31 @@ export async function runCli(args, output) {
         failure(output, jsonRequested, 'invalid_arguments', error);
         return 2;
     }
-    const { values, command, docsAction, docsArgument, codeAction, hostAction, collaborationAction, resumeTaskId, runtimeAction, } = parsed;
+    const { values, command, docsAction, docsArgument, codeAction, hostAction, collaborationAction, resumeTaskId, runtimeAction, hostSubAction, taskAction, taskArgument, } = parsed;
     const json = values.json === true;
     const applyRequested = values.apply === true;
     if (command !== 'init' &&
-        (values.yes === true ||
-            values['no-interactive'] === true ||
+        (values['no-interactive'] === true ||
             values['print-choices'] === true ||
             values['no-runtime'] === true ||
             values.reconfigure === true)) {
-        failure(output, json, 'invalid_arguments', '--yes, --no-interactive, --print-choices, --no-runtime and --reconfigure are only valid for init.');
+        failure(output, json, 'invalid_arguments', '--no-interactive, --print-choices, --no-runtime and --reconfigure are only valid for init.');
+        return 2;
+    }
+    if (command !== 'init' && command !== 'onboard' && values.yes === true) {
+        failure(output, json, 'invalid_arguments', '--yes is only valid for init and onboard.');
+        return 2;
+    }
+    if (command !== 'task' && values['auto-resume'] === true) {
+        failure(output, json, 'invalid_arguments', '--auto-resume is only valid for task pin.');
+        return 2;
+    }
+    if (command !== 'onboard' &&
+        (values.hosts !== undefined ||
+            values['apply-host'] === true ||
+            values['dry-run'] === true ||
+            values['print-handoff'] === true)) {
+        failure(output, json, 'invalid_arguments', '--hosts, --apply-host, --dry-run and --print-handoff are only valid for onboard.');
         return 2;
     }
     if (command !== 'host' && values.out !== undefined) {
@@ -279,6 +343,7 @@ export async function runCli(args, output) {
         return 2;
     }
     if (command !== 'runtime' &&
+        command !== 'host' &&
         (values.from !== undefined ||
             values.tarball !== undefined ||
             values.bind === true ||
@@ -398,6 +463,136 @@ export async function runCli(args, output) {
             json,
         }, output);
     }
+    if (command === 'task') {
+        const action = taskAction === 'pin' || taskAction === 'unpin' || taskAction === 'show'
+            ? taskAction
+            : null;
+        if (values.config !== undefined ||
+            values.apply === true ||
+            values.yes === true ||
+            values['install-runtime'] === true ||
+            values['runtime-tarball'] !== undefined ||
+            values['runtime-version'] !== undefined ||
+            values.host !== undefined ||
+            values.repo !== undefined ||
+            values.kind !== undefined ||
+            values.query !== undefined ||
+            values.root !== undefined ||
+            hasContinuityOptions(values)) {
+            failure(output, json, 'invalid_arguments', 'task accepts pin|unpin|show, an optional task id, --auto-resume, --help, and --json.');
+            return 2;
+        }
+        if (values.help) {
+            if (json) {
+                output.stdout(`${JSON.stringify({ ...info, commands: ['task'], usage: taskUsage })}\n`);
+            }
+            else {
+                output.stdout(taskUsage);
+            }
+            return 0;
+        }
+        if (values.version) {
+            failure(output, json, 'invalid_arguments', '--version cannot be combined with task.');
+            return 2;
+        }
+        return runTaskCommand({
+            cwd: process.cwd(),
+            action,
+            taskId: taskArgument ?? null,
+            autoResume: values['auto-resume'] === true,
+            json,
+        }, output);
+    }
+    if (command === 'mcp') {
+        if (values.config !== undefined ||
+            values.apply === true ||
+            values.yes === true ||
+            values['install-runtime'] === true ||
+            values['runtime-tarball'] !== undefined ||
+            values['runtime-version'] !== undefined ||
+            values['include-private'] === true ||
+            values['include-archived'] === true ||
+            values['apply-host'] === true ||
+            values['dry-run'] === true ||
+            values['print-handoff'] === true ||
+            values.hosts !== undefined ||
+            values.repo !== undefined ||
+            values.kind !== undefined ||
+            values.query !== undefined ||
+            values.limit !== undefined ||
+            values['max-bytes'] !== undefined ||
+            values.rebuild === true ||
+            values.host !== undefined ||
+            hasContinuityOptions(values)) {
+            failure(output, json, 'invalid_arguments', 'mcp accepts only --root, --help, and --json.');
+            return 2;
+        }
+        if (values.help) {
+            if (json) {
+                output.stdout(`${JSON.stringify({ ...info, commands: ['mcp'], usage: mcpUsage })}\n`);
+            }
+            else {
+                output.stdout(mcpUsage);
+            }
+            return 0;
+        }
+        if (values.version) {
+            failure(output, json, 'invalid_arguments', '--version cannot be combined with mcp.');
+            return 2;
+        }
+        return runMcpCommand({ cwd: process.cwd(), root: values.root ?? null, json }, output);
+    }
+    if (command === 'onboard') {
+        if (values.apply === true ||
+            values['install-runtime'] === true ||
+            values['runtime-tarball'] !== undefined ||
+            values['runtime-version'] !== undefined ||
+            values['host-root'] !== undefined ||
+            values['host-version'] !== undefined ||
+            values.mode !== undefined ||
+            values.from !== undefined ||
+            values.tarball !== undefined ||
+            values.bind === true ||
+            values.force === true ||
+            values.marketplace === true ||
+            values.scope !== undefined ||
+            values.repo !== undefined ||
+            values.kind !== undefined ||
+            values.query !== undefined ||
+            values.limit !== undefined ||
+            values['max-bytes'] !== undefined ||
+            values.rebuild === true ||
+            values['include-private'] === true ||
+            values['include-archived'] === true ||
+            hasContinuityOptions(values)) {
+            failure(output, json, 'invalid_arguments', 'onboard accepts --root, --config, --hosts, --yes, --apply-host, --dry-run, --print-handoff, --help, and --json.');
+            return 2;
+        }
+        if (values.help) {
+            if (json) {
+                output.stdout(`${JSON.stringify({ ...info, commands: ['onboard'], usage: onboardUsage })}\n`);
+            }
+            else {
+                output.stdout(onboardUsage);
+            }
+            return 0;
+        }
+        if (values.version) {
+            failure(output, json, 'invalid_arguments', '--version cannot be combined with onboard.');
+            return 2;
+        }
+        return runOnboardCommand({
+            cwd: process.cwd(),
+            root: values.root ?? null,
+            configPath: values.config ?? null,
+            hosts: values.hosts ?? null,
+            apply: values.yes === true,
+            applyHosts: values['apply-host'] === true,
+            dryRun: values['dry-run'] === true,
+            printHandoff: values['print-handoff'] === true,
+            json,
+        }, output);
+    }
     if (command === 'init') {
         if (values.root !== undefined ||
             values['include-private'] === true ||
@@ -654,6 +849,8 @@ export async function runCli(args, output) {
             'install',
             'verify',
             'bundle',
+            'mcp',
+            'probe',
         ];
         const action = allowedActions.find((item) => item === hostAction) ?? null;
         const parsedHost = hostNameSchema.safeParse(values.host);
@@ -673,7 +870,7 @@ export async function runCli(args, output) {
             values['max-bytes'] !== undefined ||
             values.rebuild === true ||
             hasContinuityOptions(values) ||
-            (values.apply === true && action !== 'install') ||
+            (values.apply === true && action !== 'install' && action !== 'mcp') ||
             (values.mode !== undefined && action !== 'install') ||
             (values.marketplace === true && action !== 'bundle') ||
             (values.scope !== undefined &&
@@ -703,6 +900,8 @@ export async function runCli(args, output) {
             hostRoot: values['host-root'] ?? null,
             hostVersion: values['host-version'] ?? null,
             apply: values.apply === true,
+            force: values.force === true,
+            subAction: hostSubAction ?? null,
             out: values.out ?? null,
             mode: values.mode === 'project-settings' || values.mode === 'plugin'
                 ? values.mode

package/dist/hosts/integration/hook.js

@@ -10,6 +10,7 @@ import { resolveWorkspaceRoot } from '../../workspace/resolve.js';
 import { inspectMachineConfig, loadWorkspaceConfig, } from '../../workspace/config.js';
 import { CheckpointService } from '../../continuity/service.js';
 import { ensureStatePathBoundary } from '../../install/ownership.js';
+import { readAutoResume, readTaskPin } from '../../app/task-pin.js';
 import { nativeEventFor } from './support.js';
 const DEFAULT_MAX_INPUT_BYTES = 1024 * 1024;
 const DEFAULT_DEADLINE_MS = 1000;
@@ -489,7 +490,9 @@ export async function runHostHook(input, 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 result({
             ok: false,

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/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>;