snipara-companion 3.0.6 → 3.0.7

package/README.md

@@ -43,6 +43,7 @@ These commands are useful without hosted Snipara:
 | ------------------------------------------------------------ | ------------------------------------------------------------ |
 | `source init` / `source sync` / `source status`              | Local source snapshot, document preview, and code overlay    |
 | `impact` / `code impact`                                     | File-level blast-radius from the local code overlay          |
+| `reality-check`                                              | Intent/verification checks for local or supplied changes     |
 | `code callers` / `imports` / `neighbors` / `shortest-path`   | Structural repo questions from local files                   |
 | `workflow start` / `phase-start` / `phase-commit` / `resume` | Agent continuity that survives compaction                    |
 | `context-pack`                                               | Reversible local packs for long logs, diffs, and tool output |

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { ProjectIntelligenceEngineeringLeadPlanSummary } from '@snipara/project-intelligence-contracts';
+import { ProjectRealityCheckResult, ProjectIntelligenceEngineeringLeadPlanSummary } from '@snipara/project-intelligence-contracts';
 
 declare function resolveQueryFromToolInput(toolInput?: string, tool?: string): string | null;
 
@@ -1946,6 +1946,23 @@ interface ProjectIntelligenceBrief {
 declare function buildProjectIntelligenceBrief(options: ProjectIntelligenceBriefOptions): Promise<ProjectIntelligenceBrief>;
 declare function projectIntelligenceBriefCommand(options: ProjectIntelligenceBriefOptions): Promise<void>;
 
+interface RealityCheckCommandOptions {
+    task?: string;
+    branch?: string;
+    base?: string;
+    changedFiles?: string[];
+    diffSummary?: string;
+    decision?: string[];
+    document?: string[];
+    verification?: string[];
+    includeDirty?: boolean;
+    enforce?: boolean;
+    dir?: string;
+    json?: boolean;
+}
+declare function buildLocalProjectRealityCheck(options: RealityCheckCommandOptions): ProjectRealityCheckResult;
+declare function realityCheckCommand(options: RealityCheckCommandOptions): Promise<void>;
+
 interface MemoryHealthCommandOptions {
     scope?: MemoryScope;
     includeInactive?: boolean;
@@ -3935,4 +3952,4 @@ declare function buildOrchestratorHandoff(options: OrchestratorHandoffOptions):
 declare function buildAdaptiveWorkRoutingRecommendation(options: AdaptiveWorkRoutingOptions): AdaptiveWorkRoutingRecommendation;
 declare function writeOrchestratorHandoff(options: OrchestratorHandoffOptions): WrittenOrchestratorHandoff;
 
-export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, TEAM_SYNC_STATE_RELATIVE_PATH, WHY_OUTCOME_CAPTURE_VERSION, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentReadinessAuditCommand, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workersLocalAddCommand, workersLocalStatusCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff };
+export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, TEAM_SYNC_STATE_RELATIVE_PATH, WHY_OUTCOME_CAPTURE_VERSION, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentReadinessAuditCommand, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectRealityCheck, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workersLocalAddCommand, workersLocalStatusCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff };

package/dist/index.js

@@ -85,6 +85,7 @@ __export(index_exports, {
   buildLocalImpactResult: () => buildLocalImpactResult,
   buildLocalImportsResult: () => buildLocalImportsResult,
   buildLocalNeighborsResult: () => buildLocalNeighborsResult,
+  buildLocalProjectRealityCheck: () => buildLocalProjectRealityCheck,
   buildLocalShortestPathResult: () => buildLocalShortestPathResult,
   buildLocalSourceSnapshot: () => buildLocalSourceSnapshot,
   buildLocalSourceStatus: () => buildLocalSourceStatus,
@@ -179,6 +180,7 @@ __export(index_exports, {
   readLocalCodePromotionState: () => readLocalCodePromotionState,
   readLocalSourceSnapshot: () => readLocalSourceSnapshot,
   readLocalWorkersConfig: () => readLocalWorkersConfig,
+  realityCheckCommand: () => realityCheckCommand,
   referencesIngestCommand: () => referencesIngestCommand,
   referencesScanCommand: () => referencesScanCommand,
   resolveContextPackRecord: () => resolveContextPackRecord,
@@ -1460,9 +1462,9 @@ var RLMClient = class {
       ...maxTokens ? { max_tokens: maxTokens } : {}
     });
   }
-  async uploadDocument(path27, content, options = {}) {
+  async uploadDocument(path28, content, options = {}) {
     return this.mcpCall("snipara_upload_document", {
-      path: path27,
+      path: path28,
       content,
       ...options.kind ? { kind: options.kind } : {},
       ...options.format ? { format: options.format } : {},
@@ -1549,9 +1551,9 @@ var RLMClient = class {
       ...maxTokens ? { max_tokens: maxTokens } : {}
     });
   }
-  async loadDocument(path27) {
+  async loadDocument(path28) {
     return this.mcpCall("snipara_load_document", {
-      path: path27
+      path: path28
     });
   }
   async getSessionMemories(maxCriticalTokens, maxDailyTokens, includeYesterday) {
@@ -13430,12 +13432,12 @@ function uniqueStringList(values) {
   if (!values) {
     return void 0;
   }
-  const unique5 = Array.from(
+  const unique6 = Array.from(
     new Set(
       values.map((value) => stringValue4(value)).filter((value) => Boolean(value))
     )
   );
-  return unique5.length > 0 ? unique5 : void 0;
+  return unique6.length > 0 ? unique6 : void 0;
 }
 function sanitizeWorkflowId(value, fallback) {
   const normalized = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64);
@@ -15680,8 +15682,8 @@ function enrichAdaptiveRoutingWithLocalOrchestrator(routing, options, cwd = proc
     };
   }
 }
-function printUploadResult(path27, result) {
-  printKeyValue2("Uploaded:", path27);
+function printUploadResult(path28, result) {
+  printKeyValue2("Uploaded:", path28);
   printCompactObject(result, ["message", "document_id", "documentId", "version", "status"]);
   console.log("");
   printJson2(result);
@@ -15989,9 +15991,9 @@ function printOrchestrateResult(result) {
   }
   printJson2(result);
 }
-function printLoadDocumentResult(path27, result) {
+function printLoadDocumentResult(path28, result) {
   printKeyValue2("Tool:", "snipara_load_document");
-  printKeyValue2("Path:", path27);
+  printKeyValue2("Path:", path28);
   console.log("");
   if (typeof result === "string") {
     console.log(result.trim());
@@ -19684,6 +19686,339 @@ var PROJECT_INTELLIGENCE_ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES = [
   "manual",
   "unknown"
 ];
+var PROJECT_REALITY_CHECK_VERSION = "project-reality-check-v0";
+var SENSITIVE_SURFACES = [
+  {
+    key: "billing_atomicity",
+    label: "Billing or payment settlement",
+    type: "intent_vs_code",
+    patterns: [/billing/i, /payment/i, /settlement/i, /invoice/i, /stripe/i],
+    verificationPatterns: [/test/i, /spec/i, /e2e/i, /vitest/i, /pytest/i],
+    riskTerms: [/async/i, /queue/i, /retry/i, /eventual/i, /background/i, /worker/i],
+    defaultSeverity: "review_required"
+  },
+  {
+    key: "auth_security",
+    label: "Authentication or authorization",
+    type: "verification_vs_claim",
+    patterns: [/auth/i, /session/i, /permission/i, /role/i, /oauth/i, /token/i],
+    verificationPatterns: [/test/i, /spec/i, /e2e/i, /permission/i, /auth/i],
+    riskTerms: [/bypass/i, /public/i, /admin/i, /token/i, /session/i],
+    defaultSeverity: "review_required"
+  },
+  {
+    key: "schema_migration",
+    label: "Database schema or migration",
+    type: "verification_vs_claim",
+    patterns: [/schema\.prisma$/i, /prisma\/migrations/i, /migration/i, /sql$/i],
+    verificationPatterns: [/migration/i, /schema/i, /prisma/i, /test/i],
+    riskTerms: [/drop/i, /delete/i, /reset/i, /force/i, /accept-data-loss/i],
+    defaultSeverity: "review_required"
+  },
+  {
+    key: "package_surface",
+    label: "Published package or agent surface",
+    type: "verification_vs_claim",
+    patterns: [/packages\//i, /package\.json$/i, /CHANGELOG\.md$/i, /README\.md$/i],
+    verificationPatterns: [/pack/i, /smoke/i, /help/i, /test/i, /type-check/i],
+    riskTerms: [/bin/i, /cli/i, /npx/i, /command/i, /public/i],
+    defaultSeverity: "watch"
+  },
+  {
+    key: "deployment_surface",
+    label: "Deployment or production operations",
+    type: "verification_vs_claim",
+    patterns: [/deploy/i, /docker/i, /traefik/i, /infomaniak/i, /production/i],
+    verificationPatterns: [/smoke/i, /health/i, /ready/i, /deploy/i, /test/i],
+    riskTerms: [/production/i, /secret/i, /migrate/i, /zero-downtime/i],
+    defaultSeverity: "review_required"
+  }
+];
+var ARCHITECTURE_RULES = [
+  {
+    key: "web_mcp_boundary",
+    title: "Web/MCP runtime boundary needs review",
+    files: [/apps\/web\//i, /apps\/mcp-server\//i]
+  },
+  {
+    key: "database_runtime_boundary",
+    title: "Database contract crosses runtime boundary",
+    files: [/packages\/database\//i, /apps\/mcp-server\/prisma/i, /apps\/web\//i]
+  }
+];
+function uniqueStrings8(values) {
+  return [
+    ...new Set(
+      values.map((value) => value?.trim()).filter((value) => Boolean(value))
+    )
+  ];
+}
+function normalizeText(value) {
+  return value?.toLowerCase() ?? "";
+}
+function hasPattern(values, patterns) {
+  return values.some((value) => patterns.some((pattern) => pattern.test(value)));
+}
+function matchesAnyText(text, patterns) {
+  return patterns.some((pattern) => pattern.test(text));
+}
+function findingSeverityScore(severity) {
+  if (severity === "blocking") return 0;
+  if (severity === "review_required") return 30;
+  if (severity === "watch") return 70;
+  return 90;
+}
+function resultStatusFromFindings(findings) {
+  if (findings.some((finding) => finding.severity === "blocking")) return "blocking";
+  if (findings.some((finding) => finding.severity === "review_required")) return "review_required";
+  if (findings.some((finding) => finding.severity === "watch")) return "advisory";
+  return "pass";
+}
+function makeFindingId(type, key, files) {
+  const compactFiles = files.slice(0, 3).map(
+    (file) => file.replace(/[^a-z0-9]+/gi, "-").replace(/^-|-$/g, "").toLowerCase()
+  ).filter(Boolean).join("-");
+  return ["reality", type, key, compactFiles || "project"].join(":").slice(0, 180);
+}
+function decisionMatchesChangedFiles(decision, changedFiles) {
+  const anchors = decision.affectedAnchors ?? [];
+  if (anchors.length === 0) return false;
+  return anchors.some(
+    (anchor) => changedFiles.some((file) => file.includes(anchor) || anchor.includes(file))
+  );
+}
+function decisionText(decision) {
+  return [
+    decision.title,
+    decision.decision,
+    decision.rationale,
+    decision.scope,
+    ...decision.constraints ?? []
+  ].filter(Boolean).join(" ");
+}
+function surfaceFiles(surface, changedFiles) {
+  return changedFiles.filter((file) => surface.patterns.some((pattern) => pattern.test(file)));
+}
+function testFiles(changedFiles) {
+  return changedFiles.filter(
+    (file) => /(^|\/)(__tests__|tests?|e2e)(\/|$)|(\.test|\.spec)\.[jt]sx?$/i.test(file)
+  );
+}
+function docEvidence(input) {
+  return (input.documents ?? []).slice(0, 5).map((doc) => ({
+    kind: "document",
+    label: doc.title ? `${doc.path}: ${doc.title}` : doc.path,
+    sourceRef: doc.sourceRef ?? doc.path,
+    strength: 0.6
+  }));
+}
+function symbolEvidence(input) {
+  return (input.symbols ?? []).slice(0, 5).map((symbol) => ({
+    kind: "code",
+    label: `${symbol.qualifiedName} (${symbol.modulePath})`,
+    sourceRef: symbol.modulePath,
+    strength: 0.7
+  }));
+}
+function decisionEvidence(decisions) {
+  return decisions.slice(0, 5).map((decision) => ({
+    kind: "decision",
+    label: `${decision.id}: ${decision.title}`,
+    sourceRef: decision.id,
+    strength: decision.confidenceScore ?? 0.8
+  }));
+}
+function buildProjectRealityCheck(input) {
+  const changedFiles = uniqueStrings8(input.changedFiles);
+  const dirtyFiles = uniqueStrings8(input.dirtyFiles ?? []);
+  const diffText = normalizeText(input.diffSummary);
+  const tests = testFiles(changedFiles);
+  const findings = [];
+  const decisions = input.decisions ?? [];
+  const contextEvidence2 = [...docEvidence(input), ...symbolEvidence(input)];
+  for (const surface of SENSITIVE_SURFACES) {
+    const files = surfaceFiles(surface, changedFiles);
+    if (files.length === 0) continue;
+    const relatedDecisions = decisions.filter(
+      (decision) => decisionMatchesChangedFiles(decision, files) || matchesAnyText(normalizeText(decisionText(decision)), surface.patterns)
+    );
+    const hasVerification = tests.length > 0 || hasPattern(input.verificationChecklist ?? [], surface.verificationPatterns);
+    const hasRiskTerm = matchesAnyText(diffText, surface.riskTerms);
+    const severity = surface.defaultSeverity === "watch" ? relatedDecisions.length > 0 && !hasVerification ? "review_required" : "watch" : hasVerification && !hasRiskTerm ? "watch" : surface.defaultSeverity;
+    const reasonCodes2 = uniqueStrings8([
+      surface.key,
+      relatedDecisions.length > 0 ? "linked_decision_touched" : "no_linked_decision",
+      hasVerification ? "verification_present" : "verification_missing",
+      hasRiskTerm ? "risk_term_in_diff" : void 0
+    ]);
+    const recommendedActions = [
+      hasVerification ? `Verify the ${surface.label.toLowerCase()} tests cover the changed behavior.` : `Add or cite verification for the ${surface.label.toLowerCase()} change before merge.`,
+      relatedDecisions.length > 0 ? "Review the linked decision intent and supersede it if the implementation intentionally changes the rule." : "Capture or link the governing intent if this surface has no reviewed decision."
+    ];
+    findings.push({
+      id: makeFindingId(surface.type, surface.key, files),
+      type: surface.type,
+      severity,
+      title: `${surface.label} needs a reality check`,
+      summary: `${files.length} changed file(s) touch ${surface.label.toLowerCase()} with ${relatedDecisions.length > 0 ? `${relatedDecisions.length} linked decision(s)` : "no linked decision"} and ${hasVerification ? "some verification evidence" : "no obvious verification evidence"}.`,
+      changedFiles: files.slice(0, 12),
+      decisionIds: relatedDecisions.map((decision) => decision.id).slice(0, 8),
+      evidence: [...decisionEvidence(relatedDecisions), ...contextEvidence2].slice(0, 8),
+      reasonCodes: reasonCodes2,
+      recommendedActions,
+      caveats: [
+        "V0 uses path, decision, document, and verification signals; it does not prove semantic causality."
+      ]
+    });
+  }
+  for (const rule of ARCHITECTURE_RULES) {
+    const matchedGroups = rule.files.filter(
+      (patterns) => changedFiles.some((file) => patterns.test(file))
+    );
+    if (matchedGroups.length < 2) continue;
+    const files = changedFiles.filter((file) => rule.files.some((pattern) => pattern.test(file)));
+    findings.push({
+      id: makeFindingId("architecture_drift", rule.key, files),
+      type: "architecture_drift",
+      severity: "watch",
+      title: rule.title,
+      summary: "This change spans architectural boundaries. Verify that the dependency direction and runtime ownership still match the intended architecture.",
+      changedFiles: files.slice(0, 12),
+      decisionIds: [],
+      evidence: contextEvidence2.slice(0, 6),
+      reasonCodes: [rule.key, "cross_boundary_change"],
+      recommendedActions: [
+        "Check that the changed modules do not introduce a forbidden runtime dependency.",
+        "Document the boundary intent if this cross-boundary change is intentional."
+      ],
+      caveats: [
+        "Architecture drift V0 is boundary-based; import-level drift needs code graph confirmation."
+      ]
+    });
+  }
+  if (changedFiles.length > 0 && decisions.length === 0 && (input.source === "pull_request" || findings.length > 0)) {
+    findings.push({
+      id: makeFindingId("decision_vs_code", "missing_intent", changedFiles),
+      type: "decision_vs_code",
+      severity: findings.some((finding) => finding.severity === "review_required") ? "watch" : "info",
+      title: "No governing intent was linked",
+      summary: "No reviewed decision or intent was linked to this change. This is an unknown, not proof that no constraint exists.",
+      changedFiles: changedFiles.slice(0, 12),
+      decisionIds: [],
+      evidence: contextEvidence2.slice(0, 6),
+      reasonCodes: ["missing_intent", "unknown_governing_decision"],
+      recommendedActions: [
+        "Link an existing decision or capture a review-pending intent if this change establishes a durable rule."
+      ],
+      caveats: [
+        "A missing linked decision can reflect retrieval/index freshness rather than missing project truth."
+      ]
+    });
+  }
+  if (dirtyFiles.length > 0 && input.source === "local") {
+    findings.push({
+      id: makeFindingId("verification_vs_claim", "dirty_worktree", dirtyFiles),
+      type: "verification_vs_claim",
+      severity: "watch",
+      title: "Dirty local files are part of the reality check",
+      summary: `${dirtyFiles.length} dirty file(s) were included in the local scan; verify they are intentional before push.`,
+      changedFiles: dirtyFiles.slice(0, 12),
+      decisionIds: [],
+      evidence: dirtyFiles.slice(0, 6).map((file) => ({
+        kind: "repository",
+        label: file,
+        sourceRef: file,
+        strength: 0.5
+      })),
+      reasonCodes: ["dirty_working_tree"],
+      recommendedActions: [
+        "Review dirty files separately from committed PR or upstream diff evidence."
+      ],
+      caveats: [
+        "Dirty working-tree evidence is local-only and will not exist in hosted PR checks until committed."
+      ]
+    });
+  }
+  const status = resultStatusFromFindings(findings);
+  const score = findings.length === 0 ? 95 : Math.max(
+    0,
+    Math.min(
+      100,
+      Math.round(
+        Math.min(...findings.map((finding) => findingSeverityScore(finding.severity))) - Math.max(0, findings.length - 1) * 4
+      )
+    )
+  );
+  const requiredActions = uniqueStrings8(
+    findings.filter(
+      (finding) => finding.severity === "review_required" || finding.severity === "blocking"
+    ).flatMap((finding) => finding.recommendedActions)
+  ).slice(0, 10);
+  const watchItems = uniqueStrings8(
+    findings.filter((finding) => finding.severity === "watch" || finding.severity === "info").map((finding) => finding.summary)
+  ).slice(0, 10);
+  const reasonCodes = uniqueStrings8(findings.flatMap((finding) => finding.reasonCodes)).slice(
+    0,
+    20
+  );
+  const caveats = uniqueStrings8([
+    "Project Reality Check V0 is advisory and evidence-backed; it is not deterministic repository simulation.",
+    input.source === "local" ? "Local results may include dirty files that hosted PR checks cannot see." : "PR results are scoped to GitHub-provided PR files and indexed Snipara context."
+  ]);
+  return {
+    version: PROJECT_REALITY_CHECK_VERSION,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    status,
+    score,
+    source: input.source,
+    summary: findings.length === 0 ? "No contradiction-to-reality finding was detected for this scope." : `${findings.length} reality check finding(s): ${status.replace("_", " ")}.`,
+    changedFileCount: changedFiles.length,
+    findingCount: findings.length,
+    findings,
+    requiredActions,
+    watchItems,
+    reasonCodes,
+    caveats
+  };
+}
+function renderProjectRealityCheckMarkdown(result) {
+  const lines = [
+    `- Status: ${result.status}; score ${result.score}/100.`,
+    `- Scope: ${result.changedFileCount} changed file(s), ${result.findingCount} finding(s).`,
+    `- Summary: ${result.summary}`
+  ];
+  if (result.findings.length > 0) {
+    lines.push("", "Findings:");
+    for (const finding of result.findings.slice(0, 8)) {
+      lines.push(
+        `- ${finding.severity.toUpperCase()} ${finding.type}: ${finding.title}`,
+        `  ${finding.summary}`
+      );
+      if (finding.changedFiles.length > 0) {
+        lines.push(`  Files: ${finding.changedFiles.map((file) => `\`${file}\``).join(", ")}`);
+      }
+      if (finding.decisionIds.length > 0) {
+        lines.push(`  Decisions: ${finding.decisionIds.join(", ")}`);
+      }
+      if (finding.recommendedActions.length > 0) {
+        lines.push(`  Action: ${finding.recommendedActions[0]}`);
+      }
+    }
+  }
+  if (result.requiredActions.length > 0) {
+    lines.push("", "Required actions:");
+    lines.push(...result.requiredActions.map((action) => `- ${action}`));
+  }
+  if (result.watchItems.length > 0) {
+    lines.push("", "Watch items:");
+    lines.push(...result.watchItems.map((item) => `- ${item}`));
+  }
+  if (result.caveats.length > 0) {
+    lines.push("", "Caveats:");
+    lines.push(...result.caveats.map((caveat) => `- ${caveat}`));
+  }
+  return lines.join("\n");
+}
 
 // src/commands/execution-receipts.ts
 var ENGINEERING_LEAD_PROOF_VERIFICATION_MAX_AGE_MS = 14 * 24 * 60 * 60 * 1e3;
@@ -21378,7 +21713,7 @@ function normalizeCaptureEvent(event, now, index) {
   const reasons = normalizeStringList3(event.reason).map(redactText);
   const evidence = normalizeStringList3(event.evidence).map(redactText);
   const commands = normalizeStringList3(event.commands).map(redactText);
-  const redactionPatterns = uniqueStrings8([
+  const redactionPatterns = uniqueStrings9([
     ...summary.patterns,
     ...outcome.patterns,
     ...status.patterns,
@@ -21411,7 +21746,7 @@ function normalizeEventKind(value) {
   return "feedback";
 }
 function reasonCodesForEvent(event, kind, status) {
-  return uniqueStrings8([
+  return uniqueStrings9([
     "why_outcome_capture_v1",
     "review_pending_authority",
     `source_${event.kind}`,
@@ -21476,7 +21811,7 @@ function readEventsFromFile(filePath) {
 function stableHash(parts) {
   return (0, import_node_crypto3.createHash)("sha256").update(parts.join("\0")).digest("hex");
 }
-function uniqueStrings8(values) {
+function uniqueStrings9(values) {
   return Array.from(new Set(values.filter(Boolean)));
 }
 function compactWhitespace2(value) {
@@ -21574,7 +21909,7 @@ function createRedactor(rootDir) {
       patterns.add(item.name);
       item.pattern.lastIndex = 0;
     }
-    const uniqueMatchedPatterns = uniqueStrings9(matchedPatterns);
+    const uniqueMatchedPatterns = uniqueStrings10(matchedPatterns);
     if (uniqueMatchedPatterns.length > 0) {
       redactedValueCount += 1;
     }
@@ -21689,14 +22024,14 @@ function buildRepoState(input, options, rootDir, redactor) {
   const inputRepo = inputRecord(input, "repoState", "repo_state", "repo");
   const detected = detectGitState(rootDir);
   const statusCounts = countGitStatus(detected.statusLines);
-  const changedFiles = uniqueStrings9([
+  const changedFiles = uniqueStrings10([
     ...normalizeUnknownStringList(inputRepo.changedFiles),
     ...normalizeUnknownStringList(inputRepo.changed_files),
     ...normalizeUnknownStringList(input.changedFiles),
     ...normalizeUnknownStringList(input.changed_files),
     ...options.changedFiles ?? []
   ]).map((item) => redactor.redact(item).value);
-  const recentFiles = uniqueStrings9([
+  const recentFiles = uniqueStrings10([
     ...normalizeUnknownStringList(inputRepo.recentFiles),
     ...normalizeUnknownStringList(inputRepo.recent_files),
     ...normalizeUnknownStringList(input.recentFiles),
@@ -21764,18 +22099,18 @@ function normalizeEvidenceItem(value, section, index, redactor) {
     "command",
     "check"
   ]) ?? fallbackSummary(value, section, index);
-  const reasonCodes = uniqueStrings9([
+  const reasonCodes = uniqueStrings10([
     `section_${section}`,
     ...normalizeUnknownStringList(value.reasonCodes),
     ...normalizeUnknownStringList(value.reason_codes)
   ]).map((item) => redactor.redact(item).value);
-  const files = uniqueStrings9([
+  const files = uniqueStrings10([
     ...normalizeUnknownStringList(value.files),
     ...normalizeUnknownStringList(value.changedFiles),
     ...normalizeUnknownStringList(value.changed_files),
     ...normalizeUnknownStringList(value.file)
   ]).slice(0, MAX_LIST_ITEMS2).map((item) => redactor.redact(item).value);
-  const commands = uniqueStrings9([
+  const commands = uniqueStrings10([
     ...normalizeUnknownStringList(value.commands),
     ...normalizeUnknownStringList(value.command),
     ...normalizeUnknownStringList(value.checks),
@@ -21799,7 +22134,7 @@ function normalizeEvidenceItem(value, section, index, redactor) {
   });
 }
 function collectReasonCodes(input, cliValues, items, redactor) {
-  return uniqueStrings9([
+  return uniqueStrings10([
     "coding_intelligence_ledger_v0",
     ...normalizeUnknownStringList(input.reasonCodes),
     ...normalizeUnknownStringList(input.reason_codes),
@@ -21830,13 +22165,13 @@ function buildCalibrationMetadata(input, cliValues, redactor) {
     "calibration",
     "calibration_metadata"
   );
-  const notes = uniqueStrings9([
+  const notes = uniqueStrings10([
     ...normalizeUnknownStringList(calibration.notes),
     ...normalizeUnknownStringList(calibration.note),
     ...normalizeUnknownStringList(input.calibrationNotes),
     ...cliValues ?? []
   ]).slice(0, MAX_LIST_ITEMS2).map((item) => redactor.redact(item).value);
-  const caveats = uniqueStrings9([
+  const caveats = uniqueStrings10([
     ...normalizeUnknownStringList(calibration.caveats),
     ...normalizeUnknownStringList(calibration.caveat),
     ...normalizeUnknownStringList(input.calibrationCaveats)
@@ -22033,7 +22368,7 @@ function validIso(value) {
   const date = new Date(value);
   return Number.isNaN(date.getTime()) ? void 0 : date.toISOString();
 }
-function uniqueStrings9(values) {
+function uniqueStrings10(values) {
   return Array.from(new Set(values.map((value) => value.trim()).filter(Boolean)));
 }
 function compactWhitespace3(value) {
@@ -23516,14 +23851,154 @@ async function projectIntelligenceBriefCommand(options) {
   }
 }
 
+// src/commands/reality-check.ts
+var import_node_child_process8 = require("child_process");
+var import_node_path = __toESM(require("path"));
+var import_chalk10 = __toESM(require("chalk"));
+function runGit2(args, cwd, options = {}) {
+  try {
+    const output = (0, import_node_child_process8.execFileSync)("git", args, {
+      cwd,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      timeout: 5e3
+    });
+    return options.preserveLeadingWhitespace ? output.trimEnd() : output.trim();
+  } catch {
+    return void 0;
+  }
+}
+function splitLines(value) {
+  return value ? value.split(/\r?\n/g).map((line) => line.trim()).filter(Boolean) : [];
+}
+function unique5(values) {
+  return [
+    ...new Set(
+      values.map((value) => value?.trim()).filter((value) => Boolean(value))
+    )
+  ];
+}
+function parseDirtyFile(line) {
+  if (!line.trim()) return void 0;
+  const withoutStatus = line.length >= 3 ? line.slice(3).trim() : line.trim();
+  const renameParts = withoutStatus.split(" -> ");
+  return renameParts[renameParts.length - 1]?.replace(/^"|"$/g, "");
+}
+function resolveGitRoot(cwd) {
+  return runGit2(["rev-parse", "--show-toplevel"], cwd) ?? cwd;
+}
+function resolveBaseRef(root, explicitBase) {
+  if (explicitBase) return explicitBase;
+  return runGit2(["rev-parse", "--abbrev-ref", "--symbolic-full-name", "@{u}"], root) ?? void 0;
+}
+function buildLocalGitScope(options) {
+  const requestedRoot = import_node_path.default.resolve(options.dir ?? process.cwd());
+  const workspaceRoot = findWorkspaceRoot(requestedRoot, true) ?? requestedRoot;
+  const root = resolveGitRoot(workspaceRoot);
+  const branch = options.branch ?? runGit2(["rev-parse", "--abbrev-ref", "HEAD"], root);
+  const baseRef = resolveBaseRef(root, options.base);
+  const headRef = runGit2(["rev-parse", "--verify", "HEAD"], root);
+  const statusLines = runGit2(["status", "--short"], root, { preserveLeadingWhitespace: true })?.split(/\r?\n/g).filter((line) => line.trim()) ?? [];
+  const dirtyFiles = unique5(statusLines.map(parseDirtyFile));
+  const committedFiles = baseRef ? splitLines(runGit2(["diff", "--name-only", `${baseRef}...HEAD`], root)) : [];
+  const cachedFiles = splitLines(runGit2(["diff", "--cached", "--name-only"], root));
+  const unstagedFiles = splitLines(runGit2(["diff", "--name-only"], root));
+  const changedFiles = unique5([
+    ...options.changedFiles ?? [],
+    ...committedFiles,
+    ...cachedFiles,
+    ...options.includeDirty === false ? [] : unstagedFiles
+  ]);
+  const diffSummary = options.diffSummary ?? [
+    baseRef ? runGit2(["diff", "--stat", `${baseRef}...HEAD`], root) : void 0,
+    options.includeDirty === false ? void 0 : runGit2(["diff", "--stat"], root)
+  ].filter(Boolean).join("\n");
+  const caveats = [
+    baseRef ? void 0 : "No upstream/base ref was resolved; local reality check used dirty/cached files only.",
+    dirtyFiles.length > 0 && options.includeDirty === false ? "Dirty files were detected but excluded by --no-include-dirty." : void 0
+  ].filter((item) => Boolean(item));
+  return {
+    root,
+    ...branch && branch !== "HEAD" ? { branch } : {},
+    ...baseRef ? { baseRef } : {},
+    ...headRef ? { headRef } : {},
+    changedFiles,
+    dirtyFiles: options.includeDirty === false ? [] : dirtyFiles,
+    ...diffSummary ? { diffSummary } : {},
+    caveats
+  };
+}
+function parseDecision(value, index) {
+  const [rawId, ...rest] = value.split(":");
+  const hasExplicitId = rest.length > 0 && rawId.trim().length > 0;
+  const id = hasExplicitId ? rawId.trim() : `local-decision-${index + 1}`;
+  const title = hasExplicitId ? rest.join(":").trim() : value.trim();
+  return {
+    id,
+    title: title || id,
+    decision: title || value,
+    confidenceScore: 0.75
+  };
+}
+function parseDocument(value) {
+  const [rawPath, ...rest] = value.split(":");
+  return {
+    path: rawPath.trim() || value,
+    contentPreview: rest.join(":").trim() || null
+  };
+}
+function buildLocalProjectRealityCheck(options) {
+  const scope = buildLocalGitScope(options);
+  const result = buildProjectRealityCheck({
+    source: "local",
+    task: options.task,
+    branch: scope.branch,
+    baseRef: scope.baseRef,
+    headRef: scope.headRef,
+    changedFiles: scope.changedFiles,
+    dirtyFiles: scope.dirtyFiles,
+    diffSummary: scope.diffSummary,
+    decisions: (options.decision ?? []).map(parseDecision),
+    documents: (options.document ?? []).map(parseDocument),
+    verificationChecklist: options.verification ?? []
+  });
+  if (scope.caveats.length === 0) {
+    return result;
+  }
+  return {
+    ...result,
+    caveats: [...result.caveats, ...scope.caveats]
+  };
+}
+function printRealityCheck(result) {
+  console.log(import_chalk10.default.bold("Project Reality Check"));
+  console.log(`Status: ${result.status}`);
+  console.log(`Score: ${result.score}/100`);
+  console.log(`Changed files: ${result.changedFileCount}`);
+  console.log(`Findings: ${result.findingCount}`);
+  console.log("");
+  console.log(renderProjectRealityCheckMarkdown(result));
+}
+async function realityCheckCommand(options) {
+  const result = buildLocalProjectRealityCheck(options);
+  if (options.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    printRealityCheck(result);
+  }
+  if (options.enforce && (result.status === "review_required" || result.status === "blocking")) {
+    process.exitCode = 1;
+  }
+}
+
 // src/commands/references.ts
 var crypto6 = __toESM(require("crypto"));
 var fs25 = __toESM(require("fs"));
-var path24 = __toESM(require("path"));
-var import_chalk10 = __toESM(require("chalk"));
+var path25 = __toESM(require("path"));
+var import_chalk11 = __toESM(require("chalk"));
 var MANIFEST_VERSION2 = "snipara.references.v1";
-var DEFAULT_MANIFEST_PATH = path24.join(".snipara", "references", "manifest.json");
-var DEFAULT_SNAPSHOT_DIR = path24.join(".snipara", "references", "snapshots");
+var DEFAULT_MANIFEST_PATH = path25.join(".snipara", "references", "manifest.json");
+var DEFAULT_SNAPSHOT_DIR = path25.join(".snipara", "references", "snapshots");
 var DEFAULT_DESTINATION_PREFIX = "external-references";
 var DEFAULT_SCAN_EXTENSIONS = /* @__PURE__ */ new Set([".md", ".mdx", ".txt", ".rst"]);
 var DEFAULT_IGNORE_DIRS = /* @__PURE__ */ new Set([
@@ -23599,10 +24074,10 @@ function sanitizeSegment(value, fallback) {
   return sanitized || fallback;
 }
 function toRelative(root, file) {
-  return path24.relative(root, file).split(path24.sep).join("/");
+  return path25.relative(root, file).split(path25.sep).join("/");
 }
 function ensureParentDir(file) {
-  fs25.mkdirSync(path24.dirname(file), { recursive: true });
+  fs25.mkdirSync(path25.dirname(file), { recursive: true });
 }
 function walkFiles(root, extensions, maxFiles, files = []) {
   if (files.length >= maxFiles) {
@@ -23612,14 +24087,14 @@ function walkFiles(root, extensions, maxFiles, files = []) {
     if (files.length >= maxFiles) {
       break;
     }
-    const fullPath = path24.join(root, entry.name);
+    const fullPath = path25.join(root, entry.name);
     if (entry.isDirectory()) {
       if (!DEFAULT_IGNORE_DIRS.has(entry.name)) {
         walkFiles(fullPath, extensions, maxFiles, files);
       }
       continue;
     }
-    if (entry.isFile() && extensions.has(path24.extname(entry.name).toLowerCase())) {
+    if (entry.isFile() && extensions.has(path25.extname(entry.name).toLowerCase())) {
       files.push(fullPath);
     }
   }
@@ -23674,8 +24149,8 @@ function collectReferenceItems(root, files, allowDomains, denyDomains) {
   return Array.from(byUrl.values()).sort((a, b) => a.normalizedUrl.localeCompare(b.normalizedUrl));
 }
 function scanReferences(options = {}) {
-  const root = path24.resolve(options.root ?? process.cwd());
-  const outputPath = path24.resolve(root, options.output ?? DEFAULT_MANIFEST_PATH);
+  const root = path25.resolve(options.root ?? process.cwd());
+  const outputPath = path25.resolve(root, options.output ?? DEFAULT_MANIFEST_PATH);
   const allowDomains = normalizeList(options.allowDomain);
   const denyDomains = normalizeList(options.denyDomain);
   const extensions = new Set(
@@ -23777,8 +24252,8 @@ async function fetchReference(item, outputDir, destinationPrefix, timeoutMs, max
       slugSource,
       item.id
     )}-${item.id}.md`;
-    const snapshotPath = path24.resolve(outputDir, fileName);
-    const destinationPath = path24.posix.join(
+    const snapshotPath = path25.resolve(outputDir, fileName);
+    const destinationPath = path25.posix.join(
       destinationPrefix.replace(/^\/+|\/+$/g, "") || DEFAULT_DESTINATION_PREFIX,
       fileName
     );
@@ -23823,14 +24298,14 @@ function selectItems(manifest, options, allowDomains) {
   return typeof options.max === "number" && options.max > 0 ? selected.slice(0, options.max) : selected;
 }
 async function ingestReferences(options = {}) {
-  const manifestPath = path24.resolve(options.manifest ?? DEFAULT_MANIFEST_PATH);
+  const manifestPath = path25.resolve(options.manifest ?? DEFAULT_MANIFEST_PATH);
   const manifest = readManifest2(manifestPath);
-  const root = manifest.root ? path24.resolve(manifest.root) : process.cwd();
+  const root = manifest.root ? path25.resolve(manifest.root) : process.cwd();
   const allowDomains = normalizeList([
     ...manifest.allowDomains ?? [],
     ...options.allowDomain ?? []
   ]);
-  const outputDir = path24.resolve(root, options.outputDir ?? DEFAULT_SNAPSHOT_DIR);
+  const outputDir = path25.resolve(root, options.outputDir ?? DEFAULT_SNAPSHOT_DIR);
   const destinationPrefix = options.destinationPrefix ?? DEFAULT_DESTINATION_PREFIX;
   const items = selectItems(manifest, options, allowDomains);
   const summary = {
@@ -23857,7 +24332,7 @@ async function ingestReferences(options = {}) {
         options.maxBytes ?? 512 * 1024
       );
       summary.fetched += 1;
-      item.latestSnapshotPath = path24.relative(root, snapshot.snapshotPath).split(path24.sep).join("/");
+      item.latestSnapshotPath = path25.relative(root, snapshot.snapshotPath).split(path25.sep).join("/");
       item.latestFetchStatus = snapshot.status;
       item.latestFetchAt = snapshot.fetchedAt;
       item.latestContentHash = snapshot.contentHash;
@@ -23920,7 +24395,7 @@ async function referencesScanCommand(options) {
     printJson4(result);
     return;
   }
-  console.log(import_chalk10.default.bold("External References"));
+  console.log(import_chalk11.default.bold("External References"));
   console.log(`Manifest: ${result.outputPath}`);
   console.log(`Files scanned: ${result.scannedFiles}`);
   console.log(`URLs found: ${result.foundUrls}`);
@@ -23929,7 +24404,7 @@ async function referencesScanCommand(options) {
   console.log(`Denied: ${result.denied}`);
   if (result.pending > 0) {
     console.log(
-      import_chalk10.default.gray("Re-run with --allow-domain <domain> or pass --allow-domain to ingest.")
+      import_chalk11.default.gray("Re-run with --allow-domain <domain> or pass --allow-domain to ingest.")
     );
   }
 }
@@ -23939,7 +24414,7 @@ async function referencesIngestCommand(options) {
     printJson4(result);
     return;
   }
-  console.log(import_chalk10.default.bold("External Reference Ingest"));
+  console.log(import_chalk11.default.bold("External Reference Ingest"));
   console.log(`Manifest: ${result.manifestPath}`);
   console.log(`Selected: ${result.selected}`);
   if (result.dryRun) {
@@ -23956,8 +24431,8 @@ async function referencesIngestCommand(options) {
 }
 
 // src/commands/run.ts
-var import_node_child_process8 = require("child_process");
-var import_chalk11 = __toESM(require("chalk"));
+var import_node_child_process9 = require("child_process");
+var import_chalk12 = __toESM(require("chalk"));
 
 // src/commands/policy-gates.ts
 var REGISTRY_VERSION = "project-intelligence.policy-gates.registry.v1";
@@ -24721,7 +25196,7 @@ function runGuard(options, changedFiles) {
   if (options.task) {
     args.push("--action", options.release ? "release" : "run");
   }
-  const result = (0, import_node_child_process8.spawnSync)(process.execPath, args, {
+  const result = (0, import_node_child_process9.spawnSync)(process.execPath, args, {
     cwd: process.cwd(),
     encoding: "utf8",
     env: process.env,
@@ -24753,7 +25228,7 @@ function runPackageReview(options) {
     };
   }
   try {
-    const output = (0, import_node_child_process8.execFileSync)(
+    const output = (0, import_node_child_process9.execFileSync)(
       "npm",
       ["view", "snipara-companion", "version", "bin", "dist-tags", "--json"],
       {
@@ -24866,19 +25341,19 @@ async function projectIntelligenceRunCommand(options) {
   if (options.json) {
     console.log(JSON.stringify(result, null, 2));
   } else {
-    console.log(import_chalk11.default.bold("Project Intelligence Run"));
+    console.log(import_chalk12.default.bold("Project Intelligence Run"));
     if (result.brief.task) {
       console.log(`Task: ${result.brief.task}`);
     }
     console.log(`Release: ${result.release ? "yes" : "no"}`);
     console.log("");
-    console.log(import_chalk11.default.bold("Project Judgment"));
+    console.log(import_chalk12.default.bold("Project Judgment"));
     for (const line of formatProjectJudgmentCard(result.judgmentCard)) {
       console.log(line);
     }
     console.log("");
     if (result.policyGates.gates.length > 0) {
-      console.log(import_chalk11.default.bold("Policy Gates"));
+      console.log(import_chalk12.default.bold("Policy Gates"));
       console.log(
         `Strongest: ${result.policyGates.summary.strongestSeverity}; advisory ${result.policyGates.summary.advisory}, required ${result.policyGates.summary.requiredAction}, block ${result.policyGates.summary.block}`
       );
@@ -24890,7 +25365,7 @@ async function projectIntelligenceRunCommand(options) {
       console.log("");
     }
     if (result.guard) {
-      console.log(import_chalk11.default.bold("Guard"));
+      console.log(import_chalk12.default.bold("Guard"));
       console.log(`Status: ${result.guard.status}`);
       const actionCards = isRecord15(result.guard.payload) ? result.guard.payload.actionCards : [];
       if (Array.isArray(actionCards) && actionCards.length > 0) {
@@ -24902,7 +25377,7 @@ async function projectIntelligenceRunCommand(options) {
       console.log("");
     }
     if (result.packageReview) {
-      console.log(import_chalk11.default.bold("Package Review"));
+      console.log(import_chalk12.default.bold("Package Review"));
       console.log(`${result.packageReview.packageName}: ${result.packageReview.status}`);
       if (result.packageReview.error) {
         console.log(result.packageReview.error);
@@ -24910,7 +25385,7 @@ async function projectIntelligenceRunCommand(options) {
       console.log("");
     }
     if (result.advisorReceiptCapture) {
-      console.log(import_chalk11.default.bold("Advisor Receipts"));
+      console.log(import_chalk12.default.bold("Advisor Receipts"));
       console.log(`Status: ${result.advisorReceiptCapture.status}`);
       if (result.advisorReceiptCapture.servedJudgmentId) {
         console.log(`Served judgment: ${result.advisorReceiptCapture.servedJudgmentId}`);
@@ -24931,7 +25406,7 @@ async function projectIntelligenceRunCommand(options) {
       }
       console.log("");
     }
-    console.log(import_chalk11.default.bold("Suggested Commands"));
+    console.log(import_chalk12.default.bold("Suggested Commands"));
     for (const command of result.suggestedCommands.slice(0, 8)) {
       console.log(command);
     }
@@ -24942,12 +25417,12 @@ async function projectIntelligenceRunCommand(options) {
 }
 
 // src/commands/collaboration.ts
-var import_node_child_process9 = require("child_process");
+var import_node_child_process10 = require("child_process");
 var import_node_crypto5 = require("crypto");
 var fs26 = __toESM(require("fs"));
 var os6 = __toESM(require("os"));
-var path25 = __toESM(require("path"));
-var COLLABORATION_STATE_RELATIVE_PATH = path25.join(
+var path26 = __toESM(require("path"));
+var COLLABORATION_STATE_RELATIVE_PATH = path26.join(
   ".snipara",
   "collaboration",
   "session.json"
@@ -25034,7 +25509,7 @@ function createEmptyCollaborationState(now = /* @__PURE__ */ new Date()) {
   };
 }
 function getCollaborationStatePath(rootDir = process.cwd()) {
-  return path25.join(rootDir, COLLABORATION_STATE_RELATIVE_PATH);
+  return path26.join(rootDir, COLLABORATION_STATE_RELATIVE_PATH);
 }
 function loadCollaborationState(rootDir = process.cwd()) {
   const statePath = getCollaborationStatePath(rootDir);
@@ -25068,7 +25543,7 @@ function loadCollaborationState(rootDir = process.cwd()) {
 }
 function saveCollaborationState(state, rootDir = process.cwd()) {
   const statePath = getCollaborationStatePath(rootDir);
-  fs26.mkdirSync(path25.dirname(statePath), { recursive: true });
+  fs26.mkdirSync(path26.dirname(statePath), { recursive: true });
   const tempPath = `${statePath}.${process.pid}.${Date.now()}.tmp`;
   try {
     fs26.writeFileSync(tempPath, `${JSON.stringify(state, null, 2)}
@@ -25487,7 +25962,7 @@ async function collaborationIdeStatusCommand(options) {
   console.log(`Active leases: ${payload.hosted.activeLeases.length}`);
 }
 function resolveCollaborationContext(options) {
-  const rootDir = path25.resolve(options.dir ?? process.cwd());
+  const rootDir = path26.resolve(options.dir ?? process.cwd());
   const config = loadConfig({ cwd: rootDir });
   const actor = buildCollaborationActor(options, config);
   return {
@@ -25823,9 +26298,9 @@ function readGitChangedFiles(rootDir, args) {
   return output ? normalizeFiles2(output.split(/\r?\n/)) : [];
 }
 function resolveRepoRoot3(cwd) {
-  const resolved = path25.resolve(cwd);
+  const resolved = path26.resolve(cwd);
   const gitRoot = readGitValue3(resolved, ["rev-parse", "--show-toplevel"]);
-  return gitRoot ? path25.resolve(gitRoot) : resolved;
+  return gitRoot ? path26.resolve(gitRoot) : resolved;
 }
 function deriveGuardProfileResources(profile, files) {
   const resources = [];
@@ -26030,7 +26505,7 @@ function readGitRawValue(rootDir, args) {
       stdio: ["ignore", "pipe", "ignore"],
       timeout: 1e3
     };
-    const output = (0, import_node_child_process9.execFileSync)("git", args, execOptions);
+    const output = (0, import_node_child_process10.execFileSync)("git", args, execOptions);
     return output || void 0;
   } catch {
     return void 0;
@@ -26076,16 +26551,16 @@ ${nextBlock}`);
 }
 function resolveGitHooksDir2(repoRoot) {
   const gitHooksPath = readGitValue3(repoRoot, ["rev-parse", "--git-path", "hooks"]);
-  const hooksDir = path25.resolve(repoRoot, gitHooksPath ?? path25.join(".git", "hooks"));
-  const huskyUserHooksDir = path25.dirname(hooksDir);
-  if (path25.basename(hooksDir) === "_" && path25.basename(huskyUserHooksDir) === ".husky" && fs26.existsSync(path25.join(hooksDir, "h"))) {
+  const hooksDir = path26.resolve(repoRoot, gitHooksPath ?? path26.join(".git", "hooks"));
+  const huskyUserHooksDir = path26.dirname(hooksDir);
+  if (path26.basename(hooksDir) === "_" && path26.basename(huskyUserHooksDir) === ".husky" && fs26.existsSync(path26.join(hooksDir, "h"))) {
     return huskyUserHooksDir;
   }
   return hooksDir;
 }
 function installManagedCollaborationGitHook(repoRoot, hookName, options) {
   const hooksDir = resolveGitHooksDir2(repoRoot);
-  const hookPath = path25.join(hooksDir, hookName);
+  const hookPath = path26.join(hooksDir, hookName);
   const currentContent = fs26.existsSync(hookPath) ? fs26.readFileSync(hookPath, "utf8") : null;
   const block = buildCollaborationGitHookBlock(hookName);
   const nextContent = mergeManagedCollaborationHookBlock(hookName, currentContent, block);
@@ -26566,7 +27041,7 @@ function normalizeResourceId(kind, id) {
   return normalized;
 }
 function normalizeRepoPath3(value) {
-  return value.trim().split(path25.sep).join("/").replace(/^\.?\//, "");
+  return value.trim().split(path26.sep).join("/").replace(/^\.?\//, "");
 }
 function normalizeOptionalString2(value) {
   const normalized = typeof value === "string" ? value.trim() : "";
@@ -26807,6 +27282,24 @@ var program = new import_commander.Command();
 function collectOption(value, previous = []) {
   return [...previous, value];
 }
+function configureRealityCheckCommand(command) {
+  return command.description("Run a Project Reality Check against local or supplied change scope").option("--task <task>", "Task or change summary").option("--branch <branch>", "Branch to scope the check").option("--base <ref>", "Base ref for committed local changes (default: upstream)").option("--changed-files <files...>", "Changed files to analyze").option("--diff-summary <summary>", "Natural-language diff summary").option("--decision <decision...>", "Decision or intent in ID: text form").option("--document <document...>", "Document/context hint in path: preview form").option("--verification <item...>", "Verification evidence or checklist item").option("--no-include-dirty", "Exclude dirty working-tree files from local scope").option("--enforce", "Exit non-zero for review-required or blocking findings").option("-d, --dir <directory>", "Project directory (default: current)").option("--json", "Print raw JSON").action(async (options) => {
+    await realityCheckCommand({
+      task: options.task,
+      branch: options.branch,
+      base: options.base,
+      changedFiles: options.changedFiles,
+      diffSummary: options.diffSummary,
+      decision: options.decision,
+      document: options.document,
+      verification: options.verification,
+      includeDirty: options.includeDirty,
+      enforce: Boolean(options.enforce),
+      dir: options.dir,
+      json: Boolean(options.json)
+    });
+  });
+}
 program.name("snipara-companion").description("Snipara companion CLI for local hooks and automation workflows").version(readCliVersion());
 program.command("login").description("Authenticate this workspace through the Snipara project picker").option("--api-url <url>", "Override the API URL (default: https://api.snipara.com)").option("-c, --client <client>", "Client type for the project API key label").option("-p, --project <project>", "Project slug or ID to preselect in the browser").option("--project-id <id>", "Project slug or ID (deprecated alias)").option("-d, --dir <directory>", "Project directory (default: current)").option("--user-key", "Use the legacy project-agnostic user-key login flow").action(async (options) => {
   try {
@@ -27572,6 +28065,7 @@ program.command("brief").description("Build a Project Intelligence continuity br
     json: Boolean(options.json)
   });
 });
+configureRealityCheckCommand(program.command("reality-check"));
 var intelligence = program.command("intelligence").description(
   "Compose Project Intelligence briefs from continuity, memory health, and code impact"
 );
@@ -27588,6 +28082,7 @@ intelligence.command("brief").description("Build a Project Intelligence continui
     json: Boolean(options.json)
   });
 });
+configureRealityCheckCommand(intelligence.command("reality-check"));
 intelligence.command("ledger-export").description("Export a structured, redacted Coding Intelligence Ledger JSON artifact").option("--from-file <file>", "Read ledger inputs from a JSON object").option("--task <task>", "Task or work package summary").option("--prompt <prompt>", "Prompt or operator request summary").option("--source-ref <ref>", "Stable prompt or source reference").option("--branch <branch>", "Repository branch").option("--commit <commit>", "Repository commit or revision").option("--changed-files <files...>", "Changed files represented by the ledger").option("--recent-files <files...>", "Recently relevant files").option("--diff-summary <summary>", "Diff summary represented by the ledger").option("--served-context <context>", "Served context item; repeatable", collectOption, []).option("--plan <plan>", "Plan or decision item; repeatable", collectOption, []).option("--diff <diff>", "Diff item; repeatable", collectOption, []).option("--test <test>", "Test or verification item; repeatable", collectOption, []).option("--ci <ci>", "CI or build item; repeatable", collectOption, []).option("--review <review>", "Review item; repeatable", collectOption, []).option("--outcome <outcome>", "Outcome item; repeatable", collectOption, []).option(
   "--influence-receipt <receipt>",
   "Advisor influence or receipt item; repeatable",
@@ -28659,6 +29154,7 @@ if (require.main === module) {
   buildLocalImpactResult,
   buildLocalImportsResult,
   buildLocalNeighborsResult,
+  buildLocalProjectRealityCheck,
   buildLocalShortestPathResult,
   buildLocalSourceSnapshot,
   buildLocalSourceStatus,
@@ -28753,6 +29249,7 @@ if (require.main === module) {
   readLocalCodePromotionState,
   readLocalSourceSnapshot,
   readLocalWorkersConfig,
+  realityCheckCommand,
   referencesIngestCommand,
   referencesScanCommand,
   resolveContextPackRecord,

package/docs/FULL_REFERENCE.md

@@ -174,6 +174,7 @@ snipara-companion status
 snipara-companion source init .
 snipara-companion source sync --json
 snipara-companion brief --task "ship auth hardening" --changed-files src/auth.ts
+snipara-companion reality-check --task "ship auth hardening" --changed-files src/auth.ts --enforce
 snipara-companion timeline
 snipara-companion workflow phase-commit build --summary "tests green"
 snipara-companion workflow impact-gate
@@ -192,6 +193,10 @@ snipara-companion workflow resume --include-session-context
   it writes a source snapshot, previews supported document sync, and refreshes
   the local code overlay cache without requiring GitHub.
 - `brief` is the short alias for `intelligence brief`.
+- `reality-check` compares changed files, linked intent, context docs, symbols,
+  and verification hints to flag contradiction-to-reality risks before commit or
+  merge. Use `--enforce` in local hooks when review-required findings should
+  fail the hook.
 - `timeline` is the Git-style log for workflow starts, phase starts, phase
   commits, final commits, and Team Sync handoffs.
 - `workflow impact-gate` audits committed local workflow phases that are ahead
@@ -741,6 +746,7 @@ snipara-companion query --query "auth middleware"
 snipara-companion query --query "who calls src.mcp_transport.handle_call_tool" --follow-recommendation
 snipara-companion status
 snipara-companion brief --task "ship auth hardening" --changed-files apps/web/src/lib/auth.ts tests/auth.test.ts --diff-summary "auth hardening"
+snipara-companion reality-check --task "ship auth hardening" --changed-files apps/web/src/lib/auth.ts --verification "pnpm test auth" --enforce
 snipara-companion handoff --summary "auth hardening implemented" --next "run permissions tests" --files apps/web/src/lib/auth.ts --output handoff.md
 snipara-companion intelligence brief --task "ship auth hardening" --changed-files apps/web/src/lib/auth.ts tests/auth.test.ts --diff-summary "auth hardening"
 snipara-companion workflow scaffold --preset project-intelligence-continuity-layer --output .snipara/workflow/plans/project-intelligence-plan.json
@@ -930,6 +936,23 @@ checkouts use hosted graph impact. It prints continuity signals, memory health,
 risk and verification hints, degraded surfaces, and the Judgment Card's
 weighted readiness, evidence, and required actions.
 
+Use `reality-check` or `intelligence reality-check` when a local hook, agent, or
+CI adapter needs the contradiction-to-reality gate without a full hosted brief:
+
+```bash
+snipara-companion reality-check \
+  --task "refactor auth middleware" \
+  --changed-files src/auth/middleware.ts \
+  --decision "DEC-001: auth middleware must keep side effects explicit" \
+  --verification "pnpm test auth" \
+  --enforce
+```
+
+The command reads the local Git scope by default, includes dirty files unless
+`--no-include-dirty` is set, and also accepts explicit `--changed-files` for
+hooks or CI collectors. `--enforce` exits non-zero for `review_required` or
+`blocking` findings; JSON output is available with `--json`.
+
 Use `intelligence ledger-export` when an agent run, review, or replay benchmark
 needs a portable Coding Intelligence Ledger instead of a raw transcript:
 
@@ -1005,9 +1028,11 @@ Semantics:
 - `snipara-companion status` = top-level agentic work status across local workflow state, git dirtiness, and Team Sync carryover
 - `snipara-companion source init|sync|status|snapshot|watch` = automatic local source activation for folders with or without Git metadata; writes `.snipara/source/latest.json`, previews document sync, and refreshes the local code overlay cache
 - `snipara-companion brief` = short alias for `snipara-companion intelligence brief`
+- `snipara-companion reality-check` = local Project Reality Check for supplied or Git-derived changed files; `--enforce` makes review-required contradiction-to-reality findings fail hooks
 - `snipara-companion timeline` = local timeline of workflow starts, phase starts, phase commits, final commits, and Team Sync handoffs
 - `snipara-companion handoff` = top-level agent-ready Markdown/JSON handoff artifact plus the same local/hosted Team Sync handoff persistence
 - `snipara-companion intelligence brief` = one local Project Intelligence brief that combines resume context, memory health, and code impact for a task
+- `snipara-companion intelligence reality-check` = Project Intelligence namespace alias for the same local Reality Check gate
 - `snipara-companion intelligence ledger-export` = structured redacted Coding Intelligence Ledger JSON for replay, review, and commercial proof assets without dumping raw transcripts
 - `snipara-companion run` = production Project Intelligence flow that combines the brief, guard action cards, package review, verification hints, and a final weighted Judgment Card
 - `snipara-companion workflow start --plan-file` = records the visible LLM plan locally so phase state survives agent compaction; prefer JSON plans with explicit ids for stable machine phase state

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snipara-companion",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "description": "Local-first CLI that asks your repo what breaks before an AI coding agent edits it.",
   "main": "dist/index.js",
   "bin": {