projscan 4.3.1 → 4.5.0

package/dist/types/understand.d.ts

@@ -0,0 +1,153 @@
+import type { WorkplanPriority } from './workplan.js';
+export type UnderstandView = 'map' | 'flow' | 'contracts' | 'change' | 'verify';
+export interface UnderstandCitation {
+    file: string;
+    symbol?: string;
+    line?: number;
+    reason: string;
+}
+export interface UnderstandClaim {
+    id: string;
+    title: string;
+    detail: string;
+    confidence: 'low' | 'medium' | 'high';
+    citations: UnderstandCitation[];
+}
+export interface UnderstandEntrypoint {
+    file: string;
+    kind: 'cli' | 'server' | 'route' | 'package-export' | 'test' | 'script' | 'module';
+    symbols: string[];
+    why: string;
+    citations: UnderstandCitation[];
+}
+export interface UnderstandBoundary {
+    name: string;
+    files: number;
+    publicExports: string[];
+    dependsOn: string[];
+    citations: UnderstandCitation[];
+}
+export interface UnderstandFlowSideEffect {
+    kind: 'database' | 'filesystem' | 'network' | 'process' | 'env' | 'unknown';
+    label: string;
+    files: string[];
+    citations: UnderstandCitation[];
+}
+export interface UnderstandFlow {
+    id: string;
+    label: string;
+    entry: UnderstandEntrypoint;
+    path: string[];
+    sideEffects: UnderstandFlowSideEffect[];
+    confidence: 'low' | 'medium' | 'high';
+    citations: UnderstandCitation[];
+}
+export interface UnderstandPublicExport {
+    name: string;
+    file: string;
+    kind: 'package' | 'symbol';
+    citations: UnderstandCitation[];
+}
+export interface UnderstandConfigContract {
+    name: string;
+    file: string;
+    kind: 'env' | 'package-script' | 'config-file';
+    required: boolean;
+    citations: UnderstandCitation[];
+}
+export interface UnderstandBreakingChangeRisk {
+    id: string;
+    title: string;
+    files: string[];
+    why: string;
+    command: string;
+}
+export interface UnderstandContracts {
+    publicExports: UnderstandPublicExport[];
+    configContracts: UnderstandConfigContract[];
+    breakingChangeRisks: UnderstandBreakingChangeRisk[];
+}
+export interface UnderstandChangeReadiness {
+    intent: string;
+    blastRadius: Array<{
+        label: string;
+        files: string[];
+        why: string;
+        command: string;
+    }>;
+    safeEdit: {
+        title: string;
+        files: string[];
+        command: string;
+        why: string;
+    };
+    owners: Array<{
+        owner: string;
+        files: string[];
+        reason: string;
+    }>;
+    rollback: {
+        command: string;
+        why: string;
+    };
+    verificationCommands: string[];
+}
+export interface UnderstandVerificationTier {
+    id: 'minimal' | 'focused' | 'full';
+    label: string;
+    commands: string[];
+    when: string;
+}
+export interface UnderstandDirectTest {
+    file: string;
+    tests: string[];
+    confidence: 'none' | 'low' | 'medium' | 'high';
+}
+export interface UnderstandVerification {
+    tiers: UnderstandVerificationTier[];
+    directTests: UnderstandDirectTest[];
+    gaps: Array<{
+        file: string;
+        reason: string;
+        command: string;
+    }>;
+}
+export interface UnderstandReadFirst {
+    file: string;
+    why: string;
+    command: string;
+    citations: UnderstandCitation[];
+}
+export interface UnderstandRisk {
+    id: string;
+    priority: WorkplanPriority;
+    title: string;
+    files: string[];
+    why: string;
+    command: string;
+}
+export interface UnderstandUnknown {
+    id: string;
+    question: string;
+    whyUnknown: string;
+    command: string;
+}
+export interface UnderstandReport {
+    schemaVersion: 1;
+    view: UnderstandView;
+    rootPath: string;
+    intent?: string;
+    summary: string;
+    claims: UnderstandClaim[];
+    entrypoints: UnderstandEntrypoint[];
+    boundaries: UnderstandBoundary[];
+    flows: UnderstandFlow[];
+    contracts: UnderstandContracts;
+    changeReadiness: UnderstandChangeReadiness;
+    verification: UnderstandVerification;
+    readFirst: UnderstandReadFirst[];
+    risks: UnderstandRisk[];
+    unknowns: UnderstandUnknown[];
+    commands: string[];
+    truncated?: boolean;
+}

package/dist/types/understand.js

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

package/dist/types/understand.js.map

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

package/dist/types/workplan.d.ts

@@ -0,0 +1,67 @@
+import type { IssueSeverity } from './common.js';
+import type { PreflightMode, PreflightReasonSource, PreflightSuggestedAction, PreflightVerdict } from './preflight.js';
+export type WorkplanMode = PreflightMode | 'refactor' | 'release' | 'bug_hunt' | 'hardening';
+export type WorkplanPriority = 'p0' | 'p1' | 'p2';
+export interface WorkplanEvidence {
+    source: PreflightReasonSource | 'coordination' | 'release' | 'verification' | 'graph';
+    message: string;
+    severity?: IssueSeverity;
+    file?: string;
+    issueId?: string;
+    tool?: string;
+}
+export interface WorkplanVerification {
+    commands: string[];
+    expected: string;
+}
+export interface FixFirstRecommendation {
+    id: string;
+    title: string;
+    source: string;
+    priority: WorkplanPriority;
+    whyFirst: string;
+    files: string[];
+    owner?: string;
+    commands: string[];
+    expected?: string;
+}
+export interface WorkplanTask {
+    id: string;
+    priority: WorkplanPriority;
+    title: string;
+    why: string;
+    evidence: WorkplanEvidence[];
+    files: string[];
+    owner?: string;
+    suggestedTools: string[];
+    verification: WorkplanVerification;
+    handoffText: string;
+}
+export interface WorkplanTopRisk extends WorkplanEvidence {
+    priority: WorkplanPriority;
+    owner?: string;
+}
+interface WorkplanConflict {
+    kind: 'same-file' | 'import-related' | 'same-workspace' | 'taint-related' | 'hotspot-overlap';
+    files: string[];
+    message: string;
+    severity: 'warning' | 'error';
+}
+export interface WorkplanCoordination {
+    touchedFiles: string[];
+    conflicts: WorkplanConflict[];
+    recommendedNextAgent: string;
+}
+export interface WorkplanReport {
+    schemaVersion: 1;
+    mode: WorkplanMode;
+    verdict: PreflightVerdict;
+    summary: string;
+    topRisks: WorkplanTopRisk[];
+    tasks: WorkplanTask[];
+    fixFirst?: FixFirstRecommendation;
+    coordination: WorkplanCoordination;
+    suggestedNextActions: PreflightSuggestedAction[];
+    truncated?: boolean;
+}
+export {};

package/dist/types/workplan.js

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

package/dist/types/workplan.js.map

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

package/dist/types/workplanHandoff.d.ts

@@ -0,0 +1,11 @@
+import type { PreflightVerdict } from './preflight.js';
+import type { WorkplanCoordination, WorkplanMode } from './workplan.js';
+export interface WorkplanHandoffPayload {
+    summary: string;
+    verdict: PreflightVerdict;
+    mode: WorkplanMode;
+    next: string[];
+    verificationCommands: string[];
+    coordination: WorkplanCoordination;
+    markdown: string;
+}

package/dist/types/workplanHandoff.js

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

package/dist/types/workplanHandoff.js.map

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

package/dist/types/workspace.d.ts

@@ -0,0 +1,18 @@
+export type WorkspaceKind = 'npm' | 'yarn' | 'pnpm' | 'nx' | 'turbo' | 'lerna' | 'none';
+export interface WorkspacePackage {
+    /** package.json `name` field, or directory basename when missing. */
+    name: string;
+    /** Workspace-relative path of the package root (no leading `/`, no trailing `/`). */
+    relativePath: string;
+    /** package.json `version` if available. */
+    version?: string;
+    /** True when this is the workspace root itself. */
+    isRoot: boolean;
+}
+export interface WorkspaceInfo {
+    kind: WorkspaceKind;
+    /** All packages, including the root if it has its own package.json. */
+    packages: WorkspacePackage[];
+    /** Source manifest used to discover packages, e.g. "package.json#workspaces" or "pnpm-workspace.yaml". */
+    source?: string;
+}

package/dist/types/workspace.js

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

package/dist/types/workspace.js.map

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