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

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

package/dist/knowledge/scan.js

@@ -0,0 +1,91 @@
+import { discoverWorkspace } from '../workspace/discover.js';
+import { KnowledgeService } from './index.js';
+export function classifyScannedDocumentKind(path) {
+    const lower = path.toLowerCase();
+    if (lower.endsWith('agents.md') || lower.endsWith('claude.md'))
+        return 'rule';
+    if (lower.includes('/research/'))
+        return 'research';
+    if (lower.includes('/adr/') || lower.includes('decision'))
+        return 'decision';
+    if (lower.includes('review') || lower.includes('retro'))
+        return 'review';
+    if (lower.includes('plan'))
+        return 'plan';
+    return 'architecture';
+}
+/**
+ * Registers documents discovered under the configured knowledge sources.
+ * Without apply this is read-only and reports the candidates.
+ */
+export async function scanDiscoveredDocuments(root, options) {
+    const discovery = await discoverWorkspace(root);
+    const config = discovery.config;
+    if (config === null) {
+        return {
+            ok: false,
+            message: 'docs scan requires a valid .pappra/workspace.json; run pappra init first.',
+        };
+    }
+    const service = new KnowledgeService(root);
+    const listed = await service.list({ includePrivate: true });
+    const registered = new Set(listed.records.flatMap((record) => record.location.kind === 'workspace' ? [record.location.path] : []));
+    const sources = config.knowledge.sources;
+    const visibility = config.knowledge.taskVisibility === 'shared' ? 'shareable' : 'private';
+    const candidates = [];
+    for (const document of discovery.documents ?? []) {
+        const path = document.workspaceRelativePath;
+        if (path === null)
+            continue;
+        if (!sources.some((source) => path === source || path.startsWith(`${source}/`))) {
+            continue;
+        }
+        if (registered.has(path))
+            continue;
+        candidates.push({
+            path,
+            kind: classifyScannedDocumentKind(path),
+            visibility,
+        });
+    }
+    const diagnostics = [...listed.diagnostics];
+    if (!options.apply) {
+        return {
+            ok: true,
+            schema: 'pappra/docs-scan/1',
+            mode: 'plan',
+            workspaceRoot: root,
+            candidates,
+            registered: [],
+            skipped: candidates.length,
+            nextActions: [
+                'Rerun with apply: true to register these documents in the knowledge catalog.',
+            ],
+            diagnostics,
+        };
+    }
+    const registeredNow = [];
+    for (const candidate of candidates) {
+        const result = await service.register({
+            location: { kind: 'workspace', path: candidate.path },
+            kind: candidate.kind,
+            maturity: 'draft',
+            owner: 'human',
+            visibility: candidate.visibility,
+        });
+        diagnostics.push(...result.diagnostics);
+        if (result.ok)
+            registeredNow.push(result.record);
+    }
+    return {
+        ok: diagnostics.every((entry) => entry.severity !== 'error'),
+        schema: 'pappra/docs-scan/1',
+        mode: 'apply',
+        workspaceRoot: root,
+        candidates,
+        registered: registeredNow,
+        skipped: candidates.length - registeredNow.length,
+        nextActions: [],
+        diagnostics,
+    };
+}

package/dist/mcp/server.d.ts

@@ -0,0 +1,11 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const MCP_SERVER_NAME = "pappra";
+export interface PappraMcpServerOptions {
+    readonly root: string;
+}
+/**
+ * Builds the stdio MCP server for one workspace. Tools are read-only here; write
+ * operations are added separately and must stay behind apply/confirm gates.
+ */
+export declare function createPappraMcpServer(options: PappraMcpServerOptions): McpServer;
+export declare function runMcpServer(root: string): Promise<void>;