pi-harness-runtime 0.5.0 → 0.6.3-beta.13

package/packages/project-analyzer/dist/types.d.ts

@@ -0,0 +1,277 @@
+/**
+ * Project Analyzer Types
+ *
+ * Type definitions for project analysis output and plugin interface.
+ */
+export declare const SDK_VERSION: "1.0.0";
+/**
+ * Primary output of project analysis.
+ * Contains all discovered project metadata, rules, and configuration.
+ */
+export interface ProjectProfile {
+    /** Absolute path to repository root */
+    repositoryRoot: string;
+    /** Repository name (last path segment) */
+    repositoryName: string;
+    /** Git revision or 'unknown' if not a git repo */
+    revision: string;
+    /** Detected frameworks with confidence scores */
+    frameworks: DetectedFramework[];
+    /** Detected programming languages */
+    languages: DetectedLanguage[];
+    /** Package manager configurations */
+    packageManagers: PackageManagerProfile[];
+    /** Discovered applications within monorepo */
+    applications: ApplicationProfile[];
+    /** Discovered project commands */
+    commands: ProjectCommands;
+    /** Project-specific rules from AGENTS.md, RULES.md, etc. */
+    rules: ProjectRule[];
+    /** Paths that should never be included in context */
+    sensitivePaths: string[];
+    /** Paths that are generated and should be ignored */
+    generatedPaths: string[];
+    /** Available test capabilities */
+    testCapabilities: TestCapability[];
+    /** Overall confidence score (0-1) */
+    confidence: number;
+    /** Warnings about conflicting or missing information */
+    warnings: ProjectWarning[];
+    /** ISO timestamp of analysis */
+    analyzedAt: string;
+}
+export type FrameworkCategory = "frappe" | "frappe_spa" | "nextjs" | "react" | "vite" | "django" | "laravel" | "express" | "fastapi" | "unknown";
+export interface DetectedFramework {
+    /** Framework category identifier */
+    category: FrameworkCategory;
+    /** Detected framework name (e.g., "Next.js", "Frappe") */
+    name: string;
+    /** Detected version or 'unknown' */
+    version?: string;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Files and patterns that matched */
+    signals: DetectionSignal[];
+    /** Whether this is the primary framework */
+    primary: boolean;
+}
+export interface DetectedLanguage {
+    /** Language name */
+    name: string;
+    /** Detected version or 'unknown' */
+    version?: string;
+    /** Percentage of codebase (0-1) */
+    coverage: number;
+}
+export type PackageManagerType = "npm" | "yarn" | "pnpm" | "bun" | "pip" | "poetry" | "bench";
+export interface PackageManagerProfile {
+    /** Package manager type */
+    type: PackageManagerType;
+    /** Path to lock file or config */
+    configPath: string;
+    /** Whether this is the primary package manager */
+    primary: boolean;
+}
+export interface ApplicationProfile {
+    /** Unique application identifier */
+    id: string;
+    /** Path to application root */
+    root: string;
+    /** Primary framework */
+    framework: string;
+    /** Package manager if applicable */
+    packageManager?: PackageManagerType;
+    /** Test commands for this application */
+    testCommands: string[];
+    /** Build commands for this application */
+    buildCommands: string[];
+    /** Entry point files */
+    entryPoints: string[];
+    /** Relative to repository root */
+    relativePath: string;
+}
+export interface ProjectCommands {
+    /** Unit test commands */
+    unitTest: string[];
+    /** Integration test commands */
+    integrationTest: string[];
+    /** End-to-end test commands */
+    e2eTest: string[];
+    /** Linting commands */
+    lint: string[];
+    /** Type checking commands */
+    typecheck: string[];
+    /** Build commands */
+    build: string[];
+    /** Migration commands */
+    migrate: string[];
+}
+export type RulePriority = "mandatory" | "advisory" | "convention";
+export interface ProjectRule {
+    /** Unique rule identifier */
+    id: string;
+    /** Rule file source */
+    source: string;
+    /** Rule priority */
+    priority: RulePriority;
+    /** Rule content (markdown or plain text) */
+    content: string;
+    /** Parsed rule sections */
+    sections: RuleSection[];
+    /** Whether user explicitly defined this rule */
+    userDefined: boolean;
+}
+export interface RuleSection {
+    /** Section identifier */
+    id: string;
+    /** Section title */
+    title: string;
+    /** Section content */
+    content: string;
+    /** Line number in source file */
+    line: number;
+}
+export type TestRunner = "vitest" | "jest" | "pytest" | "playwright" | "cypress" | "bun_test" | "bench_test" | "phpunit" | "unknown";
+export interface TestCapability {
+    /** Test runner type */
+    runner: TestRunner;
+    /** Config file path */
+    configPath?: string;
+    /** Whether tests are available */
+    available: boolean;
+    /** Test file pattern */
+    pattern?: string;
+}
+export type WarningCode = "CONFLICTING_FRAMEWORKS" | "MULTIPLE_PACKAGE_MANAGERS" | "NO_TEST_CONFIG" | "NO_FRAMEWORK_DETECTED" | "MISSING_RULES" | "UNKNOWN_LANGUAGE";
+export interface ProjectWarning {
+    /** Warning code */
+    code: WarningCode;
+    /** Human-readable message */
+    message: string;
+    /** Affected paths or files */
+    affected?: string[];
+}
+export interface DetectionSignal {
+    /** Signal type */
+    type: string;
+    /** File path or pattern that matched */
+    path: string;
+    /** Signal weight (0-1) */
+    weight: number;
+    /** Matched value if applicable */
+    value?: string;
+}
+/**
+ * Result of framework plugin detection phase.
+ */
+export interface DetectionResult {
+    /** Detected framework category */
+    category: FrameworkCategory;
+    /** Confidence score */
+    confidence: number;
+    /** Matched signals */
+    signals: DetectionSignal[];
+    /** Detected version if available */
+    version?: string;
+}
+/**
+ * Filesystem abstraction for plugin use.
+ * Readonly to ensure plugins cannot modify the filesystem.
+ */
+export interface ReadonlyFileSystem {
+    /** Check if path exists */
+    exists(path: string): Promise<boolean>;
+    /** Read file contents */
+    readFile(path: string): Promise<string>;
+    /** List directory contents */
+    readDir(path: string): Promise<string[]>;
+    /** Check if path is directory */
+    isDirectory(path: string): Promise<boolean>;
+    /** Glob pattern matching */
+    glob(pattern: string, cwd?: string): Promise<string[]>;
+}
+/**
+ * Framework analyzer plugin interface.
+ * Plugins provide framework-specific detection and analysis.
+ */
+export interface FrameworkAnalyzerPlugin {
+    /** Plugin identifier */
+    id: string;
+    /** Plugin version */
+    version: string;
+    /** Priority (lower = higher priority) */
+    priority: number;
+    /**
+     * Detect if this plugin's framework is present.
+     * Should be fast and read-only.
+     */
+    detect(fs: ReadonlyFileSystem): Promise<DetectionResult | null>;
+    /**
+     * Perform deeper analysis once framework is detected.
+     * May read additional files.
+     */
+    analyze(root: string, detection: DetectionResult, fs: ReadonlyFileSystem): Promise<Partial<ProjectProfile>>;
+}
+export interface AnalyzerConfig {
+    /** Maximum files to scan */
+    maxScanFiles: number;
+    /** Maximum file size to read (bytes) */
+    maxFileSize: number;
+    /** Maximum directory depth */
+    maxDepth: number;
+    /** Custom sensitive path patterns */
+    sensitivePatterns: string[];
+    /** Custom generated path patterns */
+    generatedPatterns: string[];
+    /** Rule file names to discover */
+    ruleFileNames: string[];
+    /** Whether to scan monorepo subdirectories */
+    detectMonorepo: boolean;
+}
+export declare const DEFAULT_ANALYZER_CONFIG: AnalyzerConfig;
+export interface AnalyzeRequest {
+    /** Path to repository root */
+    repositoryRoot: string;
+    /** Git revision to analyze (optional, uses current if not provided) */
+    revision?: string;
+    /** Analysis configuration overrides */
+    config?: Partial<AnalyzerConfig>;
+    /** Additional plugins to register */
+    plugins?: FrameworkAnalyzerPlugin[];
+}
+export interface AnalyzeResult {
+    /** Success status */
+    success: boolean;
+    /** Project profile if successful */
+    profile?: ProjectProfile;
+    /** Error message if failed */
+    error?: string;
+    /** Error code if failed */
+    errorCode?: AnalysisErrorCode;
+    /** Time taken to analyze (ms) */
+    durationMs: number;
+}
+export type AnalysisErrorCode = "REPOSITORY_NOT_FOUND" | "NOT_A_DIRECTORY" | "SYMLINK_ESCAPE" | "SCAN_LIMIT_EXCEEDED" | "INVALID_CONFIG" | "UNKNOWN_ERROR";
+export interface CacheEntry {
+    /** Cached project profile */
+    profile: ProjectProfile;
+    /** Hash of rule files */
+    ruleHash: string;
+    /** Hash of package manifests */
+    manifestHash: string;
+    /** Hash of framework config files */
+    configHash: string;
+    /** Git revision when cached */
+    revision: string;
+    /** When this entry was created */
+    cachedAt: string;
+}
+export interface CacheKey {
+    /** Repository root */
+    repositoryRoot: string;
+    /** Git revision */
+    revision: string;
+    /** Combined hash of configuration files */
+    configHash: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/project-analyzer/dist/types.d.ts.map

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

package/packages/project-analyzer/dist/types.js

@@ -0,0 +1,44 @@
+/**
+ * Project Analyzer Types
+ *
+ * Type definitions for project analysis output and plugin interface.
+ */
+// ─── SDK Version ───────────────────────────────────────────────────────
+export const SDK_VERSION = "1.0.0";
+export const DEFAULT_ANALYZER_CONFIG = {
+    maxScanFiles: 10000,
+    maxFileSize: 200000, // 200KB
+    maxDepth: 20,
+    sensitivePatterns: [
+        ".env",
+        ".env.*",
+        "*.pem",
+        "credentials/**",
+        "secrets/**",
+        "private/**",
+        "*.key",
+        "*.p12",
+        "*.pfx",
+    ],
+    generatedPatterns: [
+        "node_modules/**",
+        "dist/**",
+        "build/**",
+        "coverage/**",
+        "__pycache__/**",
+        ".pytest_cache/**",
+        ".next/**",
+        ".nuxt/**",
+        ".output/**",
+    ],
+    ruleFileNames: [
+        "AGENTS.md",
+        "RULES.md",
+        "PROJECT_RULES.md",
+        "CONTRIBUTING.md",
+        ".claude.md",
+        "CLAUDE.md",
+    ],
+    detectMonorepo: true,
+};
+//# sourceMappingURL=types.js.map

package/packages/project-analyzer/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0EAA0E;AAE1E,MAAM,CAAC,MAAM,WAAW,GAAG,OAAgB,CAAC;AAoT5C,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACtD,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,MAAM,EAAE,QAAQ;IAC7B,QAAQ,EAAE,EAAE;IACZ,iBAAiB,EAAE;QAClB,MAAM;QACN,QAAQ;QACR,OAAO;QACP,gBAAgB;QAChB,YAAY;QACZ,YAAY;QACZ,OAAO;QACP,OAAO;QACP,OAAO;KACP;IACD,iBAAiB,EAAE;QAClB,iBAAiB;QACjB,SAAS;QACT,UAAU;QACV,aAAa;QACb,gBAAgB;QAChB,kBAAkB;QAClB,UAAU;QACV,UAAU;QACV,YAAY;KACZ;IACD,aAAa,EAAE;QACd,WAAW;QACX,UAAU;QACV,kBAAkB;QAClB,iBAAiB;QACjB,YAAY;QACZ,WAAW;KACX;IACD,cAAc,EAAE,IAAI;CACpB,CAAC"}

package/packages/project-analyzer/dist/walker.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Bounded Filesystem Walker
+ *
+ * Provides safe, bounded filesystem traversal for project analysis.
+ * Implements security boundaries to prevent traversal outside repository.
+ */
+import { type AnalyzerConfig } from "./types.js";
+/**
+ * Scanned file record.
+ */
+export interface ScannedFile {
+    /** Absolute path to file */
+    path: string;
+    /** Relative path from repository root */
+    relativePath: string;
+    /** File size in bytes */
+    size: number;
+    /** Whether file matches a sensitive pattern */
+    sensitive: boolean;
+    /** Whether file matches a generated pattern */
+    generated: boolean;
+}
+/**
+ * Filesystem scan result.
+ */
+export interface ScanResult {
+    /** All scanned files */
+    files: ScannedFile[];
+    /** Directories scanned */
+    directoriesScanned: number;
+    /** Files skipped due to limits */
+    filesSkipped: number;
+    /** Whether scan was truncated */
+    truncated: boolean;
+    /** Error messages if any */
+    errors: string[];
+}
+/**
+ * Bounded filesystem walker for project analysis.
+ */
+export declare class FileSystemWalker {
+    private config;
+    private root;
+    private filesScanned;
+    private dirsScanned;
+    private skippedFiles;
+    private errors;
+    private visitedDirs;
+    constructor(root: string, config?: Partial<AnalyzerConfig>);
+    /**
+     * Get canonical path and verify it's within repository root.
+     */
+    resolvePath(path: string): string;
+    /**
+     * Check if a path should be skipped based on patterns.
+     */
+    private isSensitive;
+    /**
+     * Check if a path is a generated file/directory.
+     */
+    private isGenerated;
+    /**
+     * Get relative path from repository root.
+     */
+    private getRelativePath;
+    /**
+     * Recursively scan directory with depth limiting.
+     */
+    private scanDir;
+    /**
+     * Scan the repository and return all relevant files.
+     */
+    scan(): Promise<ScanResult>;
+    /**
+     * Read a file if it's within size limits.
+     */
+    readFileSafe(path: string): Promise<string | null>;
+    /**
+     * Find files matching a pattern.
+     */
+    findFiles(pattern: RegExp, maxResults?: number): Promise<string[]>;
+    /**
+     * Check if a path exists within the repository.
+     */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Get statistics about the scan.
+     */
+    getStats(): {
+        filesScanned: number;
+        directoriesScanned: number;
+        skippedFiles: number;
+        root: string;
+    };
+}
+/**
+ * Create a readonly filesystem abstraction from walker.
+ */
+export declare function createReadonlyFileSystem(walker: FileSystemWalker): {
+    exists(path: string): Promise<boolean>;
+    readFile(path: string): Promise<string>;
+    readDir(path: string): Promise<string[]>;
+    isDirectory(path: string): Promise<boolean>;
+    glob(pattern: string, cwd?: string): Promise<string[]>;
+};
+//# sourceMappingURL=walker.d.ts.map

package/packages/project-analyzer/dist/walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walker.d.ts","sourceRoot":"","sources":["../src/walker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,YAAY,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,wBAAwB;IACxB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,0BAA0B;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAyCD;;GAEG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAqB;gBAE5B,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAQ1D;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQjC;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;YACW,OAAO;IAsFrB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAYjC;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAexD;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,SAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAcrE;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU5C;;OAEG;IACH,QAAQ;;;;;;CAQR;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG;IACnE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACvD,CAyDA"}