yowtf 0.1.0

package/dist/index.js

@@ -0,0 +1,286 @@
+import {
+  APP_FULL_NAME,
+  APP_NAME,
+  APP_TAGLINE,
+  APP_VERSION,
+  BASE_SEVERITY_PENALTIES,
+  CANONICAL_DIAGNOSTIC_CATEGORIES,
+  CliError,
+  CliUsageError,
+  CommandExecutionError,
+  DIAGNOSTIC_CATEGORIES,
+  DefaultRuleRegistry,
+  DefaultScoreCalculator,
+  DetectionEngine,
+  DetectionService,
+  EXIT_APPLICATION_ERROR,
+  EXIT_SUCCESS,
+  EXIT_USAGE_ERROR,
+  FINDING_CONFIDENCES,
+  FINDING_SEVERITIES,
+  FINDING_STATUSES,
+  JsonReporter,
+  LinuxPlatformAdapter,
+  MacOSPlatformAdapter,
+  ProjectCollectionService,
+  ProjectCollector,
+  ProjectDiscovery,
+  SCORE_BANDS,
+  SEVERITY_PENALTIES,
+  SUPPORTED_PLATFORMS,
+  ScanOrchestratorService,
+  SystemCollectionService,
+  SystemCollector,
+  TerminalReporter,
+  UnsupportedPlatformAdapter,
+  WARN_PENALTY_MULTIPLIER,
+  WindowsPlatformAdapter,
+  allV1Rules,
+  cache001StorageLarge,
+  cache002BuildArtifactLarge,
+  cacheRules,
+  calculateScore,
+  cfg001EnvFileMissing,
+  cfg002RequiredValueMissing,
+  configRules,
+  createDefaultRuleRegistry,
+  createFinding,
+  createProgram,
+  createReportModel,
+  dep001LockfileMissing,
+  dep002LockfileMismatch,
+  dep003PackageManagerMismatch,
+  dep004DirectoryInconsistent,
+  dependencyRules,
+  detectPlatform,
+  disk001SpaceLow,
+  disk002DeveloperStoragePressure,
+  disk003ProjectLocationUnavailable,
+  disk004FilesystemReadonly,
+  diskRules,
+  dispatchCommand,
+  env001EmptyPathEntry,
+  env002SecretExposure,
+  env003DuplicatePath,
+  env004ShellPathMismatch,
+  environmentRules,
+  executeCommand,
+  executeSafeCommand,
+  formatCliError,
+  getScoreBand,
+  git001RepositoryMissing,
+  git002WorkingTreeDirty,
+  git003UntrackedFiles,
+  git004BranchDivergence,
+  gitRules,
+  isDiagnosticCategory,
+  isFindingConfidence,
+  isFindingSeverity,
+  isFindingStatus,
+  isSupportedPlatform,
+  isValidRuleId,
+  net001InterfaceUnavailable,
+  net002DnsMissing,
+  net003ProxySuspicious,
+  net004RouteUnavailable,
+  networkRules,
+  parseRuleId,
+  path001ExecutableMissing,
+  path002ExecutableMultiple,
+  path003EntryInvalid,
+  path004OrderShadowing,
+  pathRules,
+  port001DevConflict,
+  port002DuplicateListener,
+  port003UnexpectedExposure,
+  port004ProcessUnavailable,
+  portRules,
+  proc001ResourceHog,
+  proc002MemoryHog,
+  proc003Zombie,
+  proc004Duplicate,
+  processRules,
+  proj001ManifestMissing,
+  proj002LockfileMissing,
+  proj003RuntimePolicyMissing,
+  proj004RootAmbiguous,
+  projectRules,
+  registerGlobalOptions,
+  resolveAndValidatePath,
+  resolvePlatformAdapter,
+  run001NodeUnavailable,
+  run002NodeUnpinned,
+  run003PythonUnavailable,
+  run004PythonUnpinned,
+  run005JavaUnavailable,
+  run006VersionMismatch,
+  runCli,
+  runtimeRules,
+  sys001MemoryPressure,
+  sys002CpuPressure,
+  sys003UptimeShort,
+  sys004ArchitectureMismatch,
+  sys005PlatformSupported,
+  systemRules,
+  tool001GitUnavailable,
+  tool002PackageManagerMismatch,
+  tool003PackageManagerMissing,
+  tool004DockerUnavailable,
+  tool005ExecutableShadowing,
+  toolRules,
+  ver001RuntimeConflict,
+  ver002ToolConflict,
+  ver003ProjectRuntimeUnsatisfied,
+  ver004ToolOutdated,
+  versionRules
+} from "./chunk-2PCP3AKH.js";
+
+// src/domain/evidence.ts
+var EVIDENCE_AVAILABILITIES = [
+  "AVAILABLE",
+  "UNAVAILABLE",
+  "FAILED",
+  "NOT_APPLICABLE"
+];
+function isEvidenceAvailability(value) {
+  return typeof value === "string" && EVIDENCE_AVAILABILITIES.includes(value);
+}
+export {
+  APP_FULL_NAME,
+  APP_NAME,
+  APP_TAGLINE,
+  APP_VERSION,
+  BASE_SEVERITY_PENALTIES,
+  CANONICAL_DIAGNOSTIC_CATEGORIES,
+  CliError,
+  CliUsageError,
+  CommandExecutionError,
+  DIAGNOSTIC_CATEGORIES,
+  DefaultRuleRegistry,
+  DefaultScoreCalculator,
+  DetectionEngine,
+  DetectionService,
+  EVIDENCE_AVAILABILITIES,
+  EXIT_APPLICATION_ERROR,
+  EXIT_SUCCESS,
+  EXIT_USAGE_ERROR,
+  FINDING_CONFIDENCES,
+  FINDING_SEVERITIES,
+  FINDING_STATUSES,
+  JsonReporter,
+  LinuxPlatformAdapter,
+  MacOSPlatformAdapter,
+  ProjectCollectionService,
+  ProjectCollector,
+  ProjectDiscovery,
+  SCORE_BANDS,
+  SEVERITY_PENALTIES,
+  SUPPORTED_PLATFORMS,
+  ScanOrchestratorService,
+  SystemCollectionService,
+  SystemCollector,
+  TerminalReporter,
+  UnsupportedPlatformAdapter,
+  WARN_PENALTY_MULTIPLIER,
+  WindowsPlatformAdapter,
+  allV1Rules,
+  cache001StorageLarge,
+  cache002BuildArtifactLarge,
+  cacheRules,
+  calculateScore,
+  cfg001EnvFileMissing,
+  cfg002RequiredValueMissing,
+  configRules,
+  createDefaultRuleRegistry,
+  createFinding,
+  createProgram,
+  createReportModel,
+  dep001LockfileMissing,
+  dep002LockfileMismatch,
+  dep003PackageManagerMismatch,
+  dep004DirectoryInconsistent,
+  dependencyRules,
+  detectPlatform,
+  disk001SpaceLow,
+  disk002DeveloperStoragePressure,
+  disk003ProjectLocationUnavailable,
+  disk004FilesystemReadonly,
+  diskRules,
+  dispatchCommand,
+  env001EmptyPathEntry,
+  env002SecretExposure,
+  env003DuplicatePath,
+  env004ShellPathMismatch,
+  environmentRules,
+  executeCommand,
+  executeSafeCommand,
+  formatCliError,
+  getScoreBand,
+  git001RepositoryMissing,
+  git002WorkingTreeDirty,
+  git003UntrackedFiles,
+  git004BranchDivergence,
+  gitRules,
+  isDiagnosticCategory,
+  isEvidenceAvailability,
+  isFindingConfidence,
+  isFindingSeverity,
+  isFindingStatus,
+  isSupportedPlatform,
+  isValidRuleId,
+  net001InterfaceUnavailable,
+  net002DnsMissing,
+  net003ProxySuspicious,
+  net004RouteUnavailable,
+  networkRules,
+  parseRuleId,
+  path001ExecutableMissing,
+  path002ExecutableMultiple,
+  path003EntryInvalid,
+  path004OrderShadowing,
+  pathRules,
+  port001DevConflict,
+  port002DuplicateListener,
+  port003UnexpectedExposure,
+  port004ProcessUnavailable,
+  portRules,
+  proc001ResourceHog,
+  proc002MemoryHog,
+  proc003Zombie,
+  proc004Duplicate,
+  processRules,
+  proj001ManifestMissing,
+  proj002LockfileMissing,
+  proj003RuntimePolicyMissing,
+  proj004RootAmbiguous,
+  projectRules,
+  registerGlobalOptions,
+  resolveAndValidatePath,
+  resolvePlatformAdapter,
+  run001NodeUnavailable,
+  run002NodeUnpinned,
+  run003PythonUnavailable,
+  run004PythonUnpinned,
+  run005JavaUnavailable,
+  run006VersionMismatch,
+  runCli,
+  runtimeRules,
+  sys001MemoryPressure,
+  sys002CpuPressure,
+  sys003UptimeShort,
+  sys004ArchitectureMismatch,
+  sys005PlatformSupported,
+  systemRules,
+  tool001GitUnavailable,
+  tool002PackageManagerMismatch,
+  tool003PackageManagerMissing,
+  tool004DockerUnavailable,
+  tool005ExecutableShadowing,
+  toolRules,
+  ver001RuntimeConflict,
+  ver002ToolConflict,
+  ver003ProjectRuntimeUnsatisfied,
+  ver004ToolOutdated,
+  versionRules
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/domain/evidence.ts"],"sourcesContent":["import type { DiagnosticCategory } from './category.js';\n\n/**\n * Authoritative evidence availability states.\n * Adheres to docs/DETECTION-ENGINE.md Section 7.\n */\nexport const EVIDENCE_AVAILABILITIES = [\n  'AVAILABLE',\n  'UNAVAILABLE',\n  'FAILED',\n  'NOT_APPLICABLE',\n] as const;\n\nexport type EvidenceAvailability = (typeof EVIDENCE_AVAILABILITIES)[number];\n\nexport function isEvidenceAvailability(value: unknown): value is EvidenceAvailability {\n  return (\n    typeof value === 'string' && (EVIDENCE_AVAILABILITIES as readonly string[]).includes(value)\n  );\n}\n\n/**\n * Primitive metadata value types safe for evidence representation without secret exposure.\n */\nexport type EvidenceMetadataValue = string | number | boolean;\n\n/**\n * Represents a single normalized piece of collected diagnostic evidence.\n * Adheres to docs/DETECTION-ENGINE.md Section 8-9.\n */\nexport interface EvidenceItem<T = unknown> {\n  readonly key: string;\n  readonly source: string;\n  readonly type?: string;\n  readonly availability: EvidenceAvailability;\n  readonly value?: T;\n  readonly unit?: string;\n  readonly metadata?: Readonly<Record<string, EvidenceMetadataValue>>;\n}\n\n/**\n * Structured evidence attached to a diagnostic finding explaining why the rule produced its result.\n * Adheres to docs/DETECTION-ENGINE.md Section 28.\n */\nexport interface FindingEvidence {\n  readonly items: readonly EvidenceItem[];\n  readonly details?: Readonly<Record<string, EvidenceMetadataValue | readonly string[]>>;\n}\n\n/**\n * Collection of evidence items grouped by category or collector scope.\n * Adheres to docs/DETECTION-ENGINE.md Section 5.\n */\nexport interface EvidenceSet {\n  readonly category?: DiagnosticCategory;\n  readonly items: readonly EvidenceItem[];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMO,IAAM,0BAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,SAAS,uBAAuB,OAA+C;AACpF,SACE,OAAO,UAAU,YAAa,wBAA8C,SAAS,KAAK;AAE9F;","names":[]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "yowtf",
+  "version": "0.1.0",
+  "description": "Your Operating Workstation Trouble Finder",
+  "keywords": [
+    "cli",
+    "developer-tools",
+    "diagnostics",
+    "troubleshooting",
+    "workstation-health",
+    "doctor"
+  ],
+  "author": "YOWTF Contributors",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "yowtf": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/isthatpratham/yowtf.git"
+  },
+  "bugs": {
+    "url": "https://github.com/isthatpratham/yowtf/issues"
+  },
+  "homepage": "https://github.com/isthatpratham/yowtf#readme",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  },
+  "dependencies": {
+    "boxen": "^8.0.1",
+    "chalk": "^5.4.1",
+    "cli-table3": "^0.6.5",
+    "commander": "^13.1.0",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.21.0",
+    "@types/node": "^20.17.19",
+    "eslint": "^9.21.0",
+    "prettier": "^3.5.2",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.25.0",
+    "vitest": "^3.0.7"
+  }
+}