projscan 4.16.0 → 4.17.0

package/dist/core/passport.js

@@ -0,0 +1,278 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { createBaseframeAssessment } from './baseframeAssessment.js';
+import { computeProve } from './prove.js';
+import { prepareProofArtifactWritePath } from './proofLedger.js';
+import { quoteShellArg } from './startShellArgs.js';
+import { atomicWriteFile } from '../utils/atomicWrite.js';
+const DEFAULT_CONTRACT_PATH = '.projscan/proof-contract.json';
+const DEFAULT_PASSPORT_PATH = '.projscan/passport.json';
+export async function computePassport(rootPath, options = {}) {
+    const root = path.resolve(rootPath);
+    const intent = normalizeOptionalText(options.intent);
+    const contractReport = intent
+        ? await computeProve(root, {
+            intent,
+            saveContractPath: options.saveContractPath,
+            maxFiles: options.maxFiles,
+            feedbackPath: options.feedbackPath,
+            baseRef: options.baseRef,
+            proofRecipes: options.proofRecipes,
+        })
+        : undefined;
+    const contractPath = options.contractPath ?? contractReport?.savedContractPath;
+    const changedReport = await computeProve(root, {
+        changed: true,
+        contract: contractReport?.contract,
+        contractPath,
+        baseRef: options.baseRef,
+        ledgerPath: options.ledgerPath,
+    });
+    const baseframe = await maybeCreateBaseframe(root, {
+        intent,
+        taskId: options.taskId,
+        emitBaseframe: options.emitBaseframe,
+    });
+    const artifacts = {
+        ...(contractPath ? { contractPath } : {}),
+        ...(contractReport?.savedContractPath ? { contractPath: contractReport.savedContractPath } : {}),
+    };
+    const passport = buildPassport({
+        contractReport,
+        changedReport,
+        intent: intent ?? changedReport.contract?.intent,
+        contractPath: artifacts.contractPath ?? options.contractPath,
+        baseframe,
+    });
+    if (options.outputPath) {
+        const passportPath = await writePassportArtifact(root, options.outputPath, passport);
+        return {
+            ...passport,
+            artifacts: {
+                ...passport.artifacts,
+                passportPath,
+            },
+        };
+    }
+    return passport;
+}
+function buildPassport(input) {
+    const contract = input.changedReport.contract ?? input.contractReport?.contract;
+    const receipt = input.changedReport.receipt;
+    const receiptSummary = summarizeReceipt(receipt);
+    const reviewer = reviewerSummary(input.changedReport, receipt);
+    const status = passportStatus(input.changedReport, receipt, reviewer.action);
+    const boundary = summarizeBoundary(contract);
+    const nextCommands = nextCommandsFor({
+        contractPath: input.contractPath,
+        boundary,
+        receipt: receiptSummary,
+        reviewerAction: reviewer.action,
+    });
+    const artifacts = {
+        ...(input.contractPath ? { contractPath: input.contractPath } : {}),
+    };
+    const passport = {
+        schemaVersion: 1,
+        kind: 'agent-change-passport',
+        generatedAt: new Date().toISOString(),
+        status,
+        ...(input.intent ? { intent: input.intent } : {}),
+        summary: summarizePassport(status, reviewer),
+        boundary,
+        receipt: receiptSummary,
+        reviewer,
+        nextCommands,
+        warnings: unique([...(input.contractReport?.warnings ?? []), ...input.changedReport.warnings]),
+        artifacts,
+        ...(input.baseframe ? { baseframe: input.baseframe } : {}),
+        prove: {
+            verdict: input.changedReport.verdict,
+            verifiedWorkflow: input.changedReport.verifiedWorkflow,
+            ...(contract ? { contract } : {}),
+            ...(receipt ? { receipt } : {}),
+        },
+    };
+    return passport;
+}
+function summarizeBoundary(contract) {
+    return {
+        ...(contract?.id ? { contractId: contract.id } : {}),
+        allowedFiles: contract?.allowedFiles ?? [],
+        forbiddenFiles: contract?.forbiddenFiles ?? [],
+        likelyTests: contract?.likelyTests ?? [],
+        riskyContracts: contract?.riskyContracts ?? [],
+        proofCommands: contract?.proofCommands ?? [],
+        ...(contract?.receiptCommand ? { receiptCommand: contract.receiptCommand } : {}),
+    };
+}
+function summarizeReceipt(receipt) {
+    return {
+        scopeStatus: receipt?.scope.status ?? 'missing-contract',
+        proofStatus: receipt?.proofStatus.status ?? 'missing',
+        ...(receipt?.proofSufficiency?.status ? { proofSufficiencyStatus: receipt.proofSufficiency.status } : {}),
+        ...(receipt?.proofReplay?.status ? { proofReplayStatus: receipt.proofReplay.status } : {}),
+        changedFiles: receipt?.scope.changedFiles ?? [],
+        forbiddenTouched: receipt?.scope.forbiddenTouched ?? [],
+        outsideAllowed: receipt?.scope.outsideAllowed ?? [],
+        changedAfterProof: receipt?.proofReplay?.changedAfterProof ?? [],
+        missingCommands: receipt?.proofStatus.missingCommands ?? [],
+        failedCommands: receipt?.proofStatus.failedCommands ?? [],
+        staleCommands: receipt?.proofStatus.staleCommands ?? [],
+        requiredReviewers: receipt?.requiredReviewers ?? [],
+    };
+}
+function reviewerSummary(report, receipt) {
+    const action = reviewerAction(report, receipt);
+    const decision = receipt?.reviewerDecision ?? 'needs-focused-review';
+    return {
+        decision,
+        action,
+        summary: reviewerSummaryText(action, receipt),
+    };
+}
+function reviewerAction(report, receipt) {
+    if (!receipt || receipt.scope.status === 'missing-contract')
+        return 'stop-and-recontract';
+    if (receipt.scope.status === 'drifted' || report.verdict === 'blocked')
+        return 'stop-and-recontract';
+    if (receipt.proofStatus.status === 'failed')
+        return 'rerun-proof';
+    if (receipt.proofStatus.status === 'stale' || receipt.proofReplay?.changedAfterProof.length) {
+        return 'rerun-proof';
+    }
+    if (receipt.proofStatus.status === 'missing' ||
+        receipt.proofStatus.status === 'not-run' ||
+        receipt.proofStatus.status === 'partial' ||
+        receipt.proofSufficiency?.status === 'missing' ||
+        receipt.proofSufficiency?.status === 'weak') {
+        return 'run-proof';
+    }
+    return 'review';
+}
+function reviewerSummaryText(action, receipt) {
+    if (action === 'stop-and-recontract') {
+        const drift = receipt?.scope.forbiddenTouched.concat(receipt.scope.outsideAllowed) ?? [];
+        return drift.length > 0
+            ? `Stop and create a new contract before reviewing: ${drift.join(', ')} drifted.`
+            : 'Stop and create a Proof Contract before reviewing.';
+    }
+    if (action === 'rerun-proof')
+        return 'Rerun proof before review because proof is failed or stale.';
+    if (action === 'run-proof')
+        return 'Run the missing proof commands before review.';
+    return 'Review can proceed with the current passport evidence.';
+}
+function passportStatus(report, receipt, action) {
+    if (!receipt || report.verdict === 'blocked')
+        return 'blocked';
+    if (action === 'stop-and-recontract')
+        return 'drifted';
+    if (action === 'run-proof' || action === 'rerun-proof')
+        return 'needs-proof';
+    return 'ready';
+}
+function summarizePassport(status, reviewer) {
+    if (status === 'ready')
+        return 'ready: scope and proof are review-ready.';
+    if (status === 'needs-proof')
+        return `needs-proof: ${reviewer.summary}`;
+    if (status === 'drifted')
+        return `drifted: ${reviewer.summary}`;
+    return `blocked: ${reviewer.summary}`;
+}
+function nextCommandsFor(input) {
+    const commands = [];
+    const contractPath = input.contractPath ?? DEFAULT_CONTRACT_PATH;
+    if (input.reviewerAction === 'stop-and-recontract') {
+        commands.push('projscan prove --intent "<change intent>" --save-contract .projscan/proof-contract.json');
+    }
+    if (input.reviewerAction === 'run-proof' || input.reviewerAction === 'rerun-proof') {
+        commands.push(...input.receipt.missingCommands);
+        commands.push(...input.receipt.failedCommands);
+        commands.push(...input.receipt.staleCommands);
+        if (commands.length === 0)
+            commands.push(...input.boundary.proofCommands);
+    }
+    commands.push(`projscan prove --changed --contract ${quoteShellArg(contractPath)} --format markdown`);
+    commands.push(`projscan passport --contract ${quoteShellArg(contractPath)} --format markdown`);
+    return unique(commands);
+}
+async function maybeCreateBaseframe(root, input) {
+    if (!input.emitBaseframe && !input.taskId)
+        return undefined;
+    if (!input.intent)
+        throw new Error('passport Baseframe export requires --intent.');
+    if (!input.taskId)
+        throw new Error('passport Baseframe export requires --task-id.');
+    await createBaseframeAssessment({
+        root,
+        intent: input.intent,
+        taskId: input.taskId,
+    });
+    return {
+        taskId: input.taskId,
+        assessmentPath: `.baseframe/evidence/${input.taskId}/projscan-assessment.json`,
+        workflowPath: '.baseframe/agent-workflow.json',
+    };
+}
+async function writePassportArtifact(root, outputPath, passport) {
+    const fullPath = resolvePassportOutputPath(root, outputPath);
+    await prepareProofArtifactWritePath(root, fullPath);
+    await assertWritablePassportOutput(fullPath);
+    await atomicWriteFile(fullPath, `${JSON.stringify(passport, null, 2)}\n`);
+    return path.relative(root, fullPath).split(path.sep).join('/');
+}
+function resolvePassportOutputPath(rootPath, outputPath) {
+    const root = path.resolve(rootPath);
+    const requested = outputPath.trim() || DEFAULT_PASSPORT_PATH;
+    const fullPath = path.resolve(root, requested);
+    const relative = path.relative(root, fullPath);
+    if (!relative || relative.startsWith('..') || path.isAbsolute(relative)) {
+        throw new Error('Passport artifact path must stay inside the project root.');
+    }
+    const normalized = relative.split(path.sep).join('/');
+    if (normalized !== DEFAULT_PASSPORT_PATH && !/^\.projscan\/passports\/[^/]+\.json$/.test(normalized)) {
+        throw new Error('Passport artifact path must be .projscan/passport.json or .projscan/passports/<name>.json.');
+    }
+    return fullPath;
+}
+async function assertWritablePassportOutput(fullPath) {
+    let stat;
+    try {
+        stat = await fs.lstat(fullPath);
+    }
+    catch (error) {
+        if (isNodeErrorCode(error, 'ENOENT'))
+            return;
+        throw error;
+    }
+    if (stat.isSymbolicLink())
+        throw new Error(`Refusing to overwrite symlinked passport: ${fullPath}`);
+    if (!stat.isFile())
+        throw new Error(`Existing passport path is not a file: ${fullPath}`);
+    let parsed;
+    try {
+        parsed = JSON.parse(await fs.readFile(fullPath, 'utf-8'));
+    }
+    catch {
+        throw new Error(`Refusing to overwrite existing output that is not an Agent Change Passport: ${fullPath}`);
+    }
+    if (!isRecord(parsed) || parsed.kind !== 'agent-change-passport' || parsed.schemaVersion !== 1) {
+        throw new Error(`Refusing to overwrite existing output that is not an Agent Change Passport: ${fullPath}`);
+    }
+}
+function normalizeOptionalText(value) {
+    const trimmed = value?.trim() ?? '';
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function unique(values) {
+    return [...new Set(values.filter(Boolean))];
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isNodeErrorCode(error, code) {
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === code;
+}
+//# sourceMappingURL=passport.js.map

package/dist/core/passport.js.map

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

package/dist/mcp/toolCatalog.js

@@ -43,6 +43,7 @@ import { qualityScorecardTool } from './tools/qualityScorecard.js';
 import { assessTool } from './tools/assess.js';
 import { simulateTool } from './tools/simulate.js';
 import { proveTool } from './tools/prove.js';
+import { passportTool } from './tools/passport.js';
 import { adoptionTool } from './tools/adoption.js';
 import { startTool } from './tools/start.js';
 import { understandTool } from './tools/understand.js';
@@ -86,6 +87,7 @@ export const mcpTools = [
     assessTool,
     simulateTool,
     proveTool,
+    passportTool,
     adoptionTool,
     startTool,
     understandTool,

package/dist/mcp/toolCatalog.js.map

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

package/dist/mcp/tools/passport.d.ts

@@ -0,0 +1,2 @@
+import type { McpTool } from './_shared.js';
+export declare const passportTool: McpTool;

package/dist/mcp/tools/passport.js

@@ -0,0 +1,80 @@
+import { computePassport } from '../../core/passport.js';
+import { loadConfig } from '../../utils/config.js';
+export const passportTool = {
+    name: 'projscan_passport',
+    description: 'Create a local Agent Change Passport for reviewer handoff. Returns Proof Contract boundary, changed-file scope, proof replay, proof sufficiency, reviewer action, next commands, and optional Baseframe assessment paths without executing proof commands.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            intent: {
+                type: 'string',
+                description: 'Plain-language change intent to contract before or during work.',
+            },
+            contract_path: {
+                type: 'string',
+                description: 'Optional local Proof Contract JSON path for receipt validation.',
+            },
+            save_contract_path: {
+                type: 'string',
+                description: 'Optional local path to write the generated Proof Contract in intent mode.',
+            },
+            output_path: {
+                type: 'string',
+                description: 'Optional local passport JSON path under .projscan/passport.json or .projscan/passports/.',
+            },
+            max_files: {
+                type: 'number',
+                description: 'Maximum likely touched files to include. Default: 5, max: 25.',
+            },
+            feedback_path: {
+                type: 'string',
+                description: 'Optional local feedback artifact path to apply as trust memory.',
+            },
+            base_ref: {
+                type: 'string',
+                description: 'Optional git base ref for changed-file detection.',
+            },
+            ledger_path: {
+                type: 'string',
+                description: 'Optional local Proof Ledger JSONL path.',
+            },
+            task_id: {
+                type: 'string',
+                description: 'Optional Baseframe task ID when emit_baseframe is true.',
+            },
+            emit_baseframe: {
+                type: 'boolean',
+                description: 'Write the Baseframe ProjScan assessment artifact for this task.',
+            },
+            max_tokens: {
+                type: 'number',
+                description: 'Cap the response to roughly this many tokens.',
+            },
+        },
+    },
+    handler: async (args, rootPath) => {
+        const { config } = await loadConfig(rootPath);
+        return {
+            passport: await computePassport(rootPath, {
+                intent: stringArg(args.intent),
+                contractPath: stringArg(args.contract_path),
+                saveContractPath: stringArg(args.save_contract_path),
+                outputPath: stringArg(args.output_path),
+                maxFiles: finiteNumberArg(args.max_files),
+                feedbackPath: stringArg(args.feedback_path),
+                baseRef: stringArg(args.base_ref),
+                ledgerPath: stringArg(args.ledger_path),
+                taskId: stringArg(args.task_id),
+                emitBaseframe: args.emit_baseframe === true,
+                proofRecipes: config.proofRecipes,
+            }),
+        };
+    },
+};
+function stringArg(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function finiteNumberArg(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+//# sourceMappingURL=passport.js.map

package/dist/mcp/tools/passport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passport.js","sourceRoot":"","sources":["../../../src/mcp/tools/passport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,4PAA4P;IAC9P,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,kBAAkB,EAAE;gBAClB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2EAA2E;aACzF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0FAA0F;aACxG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC7E;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yDAAyD;aACvE;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,iEAAiE;aAC/E;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;QAChC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC9C,OAAO;YACL,QAAQ,EAAE,MAAM,eAAe,CAAC,QAAQ,EAAE;gBACxC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC9B,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC;gBAC3C,gBAAgB,EAAE,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC;gBACpD,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC;gBACvC,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC;gBACzC,YAAY,EAAE,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC;gBAC3C,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;gBACjC,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC;gBACvC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;gBAC/B,aAAa,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI;gBAC3C,YAAY,EAAE,MAAM,CAAC,YAAY;aAClC,CAAC;SACH,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC"}

package/dist/projscan-sbom.cdx.json

@@ -1,23 +1,23 @@
 {
   "bomFormat": "CycloneDX",
   "specVersion": "1.5",
-  "serialNumber": "urn:uuid:12b15eac-df3a-433e-8905-e162e6e28c3c",
+  "serialNumber": "urn:uuid:2ec981e4-2508-486e-9eb4-ab553d92dabb",
   "version": 1,
   "metadata": {
-    "timestamp": "2026-06-26T21:00:43.477Z",
+    "timestamp": "2026-06-27T22:41:33.247Z",
     "tools": [
       {
         "vendor": "projscan",
         "name": "projscan-sbom-generator",
-        "version": "4.16.0"
+        "version": "4.17.0"
       }
     ],
     "component": {
       "type": "application",
-      "bom-ref": "pkg:npm/projscan@4.16.0",
+      "bom-ref": "pkg:npm/projscan@4.17.0",
       "name": "projscan",
-      "version": "4.16.0",
-      "purl": "pkg:npm/projscan@4.16.0"
+      "version": "4.17.0",
+      "purl": "pkg:npm/projscan@4.17.0"
     }
   },
   "components": [

package/dist/publicCore.d.ts

@@ -8,6 +8,8 @@ export { computeAssess } from './core/assess.js';
 export { createBaseframeAssessment, type CreateBaseframeAssessmentOptions, } from './core/baseframeAssessment.js';
 export { computeSimulation } from './core/simulate.js';
 export { computeProve } from './core/prove.js';
+export { computePassport } from './core/passport.js';
+export { computeGuard } from './core/guard.js';
 export { inspectFile } from './core/fileInspector.js';
 export { buildImportGraph, toPackageName, isPackageUsed, filesImporting, } from './core/importGraph.js';
 export { detectOutdated } from './core/outdatedDetector.js';

package/dist/publicCore.js

@@ -8,6 +8,8 @@ export { computeAssess } from './core/assess.js';
 export { createBaseframeAssessment, } from './core/baseframeAssessment.js';
 export { computeSimulation } from './core/simulate.js';
 export { computeProve } from './core/prove.js';
+export { computePassport } from './core/passport.js';
+export { computeGuard } from './core/guard.js';
 export { inspectFile } from './core/fileInspector.js';
 export { buildImportGraph, toPackageName, isPackageUsed, filesImporting, } from './core/importGraph.js';
 export { detectOutdated } from './core/outdatedDetector.js';

package/dist/publicCore.js.map

@@ -1 +1 @@
-{"version":3,"file":"publicCore.js","sourceRoot":"","sources":["../src/publicCore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,yBAAyB,GAE1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAqB,MAAM,eAAe,CAAC;AAC5E,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,WAAW,GAGZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAwD,MAAM,mBAAmB,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EACL,gBAAgB,EAChB,MAAM,EACN,QAAQ,EACR,WAAW,EACX,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,WAAW,GAEZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EACL,KAAK,IAAI,WAAW,EACpB,OAAO,IAAI,aAAa,EACxB,KAAK,IAAI,WAAW,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"publicCore.js","sourceRoot":"","sources":["../src/publicCore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,yBAAyB,GAE1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAqB,MAAM,eAAe,CAAC;AAC5E,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,WAAW,GAGZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAwD,MAAM,mBAAmB,CAAC;AACvG,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,EACL,gBAAgB,EAChB,MAAM,EACN,QAAQ,EACR,WAAW,EACX,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,WAAW,GAEZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EACL,KAAK,IAAI,WAAW,EACpB,OAAO,IAAI,aAAa,EACxB,KAAK,IAAI,WAAW,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/tool-manifest.json

@@ -1,9 +1,9 @@
 {
   "name": "projscan",
-  "version": "4.16.0",
+  "version": "4.17.0",
   "mcpProtocolVersion": null,
-  "generatedAt": "2026-06-26T21:00:51.373Z",
-  "toolCount": 48,
+  "generatedAt": "2026-06-27T22:41:40.825Z",
+  "toolCount": 49,
   "tools": [
     {
       "name": "projscan_analyze",
@@ -1119,6 +1119,59 @@
         }
       }
     },
+    {
+      "name": "projscan_passport",
+      "description": "Create a local Agent Change Passport for reviewer handoff. Returns Proof Contract boundary, changed-file scope, proof replay, proof sufficiency, reviewer action, next commands, and optional Baseframe assessment paths without executing proof commands.",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "intent": {
+            "type": "string",
+            "description": "Plain-language change intent to contract before or during work."
+          },
+          "contract_path": {
+            "type": "string",
+            "description": "Optional local Proof Contract JSON path for receipt validation."
+          },
+          "save_contract_path": {
+            "type": "string",
+            "description": "Optional local path to write the generated Proof Contract in intent mode."
+          },
+          "output_path": {
+            "type": "string",
+            "description": "Optional local passport JSON path under .projscan/passport.json or .projscan/passports/."
+          },
+          "max_files": {
+            "type": "number",
+            "description": "Maximum likely touched files to include. Default: 5, max: 25."
+          },
+          "feedback_path": {
+            "type": "string",
+            "description": "Optional local feedback artifact path to apply as trust memory."
+          },
+          "base_ref": {
+            "type": "string",
+            "description": "Optional git base ref for changed-file detection."
+          },
+          "ledger_path": {
+            "type": "string",
+            "description": "Optional local Proof Ledger JSONL path."
+          },
+          "task_id": {
+            "type": "string",
+            "description": "Optional Baseframe task ID when emit_baseframe is true."
+          },
+          "emit_baseframe": {
+            "type": "boolean",
+            "description": "Write the Baseframe ProjScan assessment artifact for this task."
+          },
+          "max_tokens": {
+            "type": "number",
+            "description": "Cap the response to roughly this many tokens."
+          }
+        }
+      }
+    },
     {
       "name": "projscan_adoption",
       "description": "Adoption helper for new projscan users and agents. Returns ready-to-paste MCP client configs, workflow recipes, or first-run diagnostics without mutating the repo.",

package/dist/types/guard.d.ts

@@ -0,0 +1,32 @@
+import type { ProveProofStatus, ProveProofSufficiencyStatus, ProveReceipt, ProveScopeStatus } from './prove.js';
+export type GuardStatus = 'clear' | 'attention' | 'drift' | 'blocked';
+export type GuardReviewerAction = 'continue' | 'run-proof' | 'rerun-proof' | 'stop-and-recontract';
+export interface ComputeGuardOptions {
+    contractPath?: string;
+    baseRef?: string;
+    ledgerPath?: string;
+}
+export interface GuardReport {
+    schemaVersion: 1;
+    kind: 'agent-scope-guard';
+    status: GuardStatus;
+    exitCode: number;
+    summary: string;
+    reviewerAction: GuardReviewerAction;
+    drift: {
+        status: ProveScopeStatus;
+        files: string[];
+        forbiddenTouched: string[];
+        outsideAllowed: string[];
+        changedAfterProof: string[];
+    };
+    proof: {
+        status: ProveProofStatus;
+        sufficiencyStatus?: ProveProofSufficiencyStatus;
+        missingCommands: string[];
+        failedCommands: string[];
+        staleCommands: string[];
+    };
+    mutatedFiles: string[];
+    receipt?: ProveReceipt;
+}

package/dist/types/guard.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=guard.js.map

package/dist/types/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/types/guard.ts"],"names":[],"mappings":""}