devarmor 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,91 @@
+/** Severity levels for scan findings, ordered by criticality. */
+export declare enum Severity {
+    CRITICAL = "CRITICAL",
+    HIGH = "HIGH",
+    MEDIUM = "MEDIUM",
+    LOW = "LOW",
+    INFO = "INFO"
+}
+/** A single security finding discovered during a scan. */
+export interface ScanFinding {
+    /** Which scanner module produced this finding. */
+    module: ModuleName;
+    /** Severity of the finding. */
+    severity: Severity;
+    /** Human-readable title. */
+    title: string;
+    /** Detailed description of the issue. */
+    description: string;
+    /** Absolute file path where the issue was found (if applicable). */
+    filePath?: string;
+    /** Line number within the file (if applicable). */
+    line?: number;
+    /** The matched content snippet (redacted if sensitive). */
+    evidence?: string;
+    /** Suggested remediation action. */
+    remediation?: string;
+}
+/** Names of all scanner modules. */
+export type ModuleName = 'SecretScanner' | 'AgentResidueScanner' | 'MCPAuditor' | 'SkillScanner' | 'PostureChecker';
+/** Result returned by each scanner module after execution. */
+export interface ModuleResult {
+    /** Module identifier. */
+    module: ModuleName;
+    /** Human-readable module label. */
+    label: string;
+    /** Whether the module ran successfully. */
+    success: boolean;
+    /** Time taken in milliseconds. */
+    durationMs: number;
+    /** Number of files/items scanned. */
+    itemsScanned: number;
+    /** All findings from this module. */
+    findings: ScanFinding[];
+    /** Optional error message if the module failed. */
+    error?: string;
+}
+/** Overall scan report aggregating all module results. */
+export interface ScanReport {
+    /** Timestamp when the scan started. */
+    timestamp: string;
+    /** Root path that was scanned. */
+    scanPath: string;
+    /** DevArmor version. */
+    version: string;
+    /** Total scan duration in milliseconds. */
+    totalDurationMs: number;
+    /** Results from each module. */
+    modules: ModuleResult[];
+    /** Aggregated summary counts. */
+    summary: {
+        totalFindings: number;
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+        info: number;
+    };
+}
+/** Configuration options for the scan command. */
+export interface ScanOptions {
+    /** Root directory to scan. */
+    path: string;
+    /** Report output format. */
+    report: 'terminal' | 'html' | 'json';
+    /** Whether to attempt auto-fix for certain issues. */
+    fix: boolean;
+    /** Specific modules to run (empty = all). */
+    modules: ModuleName[];
+    /** Verbose logging. */
+    verbose: boolean;
+}
+/** Interface that all scanner modules must implement. */
+export interface ScannerModule {
+    /** Module name identifier. */
+    name: ModuleName;
+    /** Human-readable label. */
+    label: string;
+    /** Run the scan and return results. */
+    scan(options: ScanOptions): Promise<ModuleResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,iEAAiE;AACjE,oBAAY,QAAQ;IAClB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,MAAM,EAAE,UAAU,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,oCAAoC;AACpC,MAAM,MAAM,UAAU,GAClB,eAAe,GACf,qBAAqB,GACrB,YAAY,GACZ,cAAc,GACd,gBAAgB,CAAC;AAErB,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,iCAAiC;IACjC,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,sDAAsD;IACtD,GAAG,EAAE,OAAO,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACnD"}

package/dist/types.js

@@ -0,0 +1,17 @@
+"use strict";
+// ============================================================
+// DevArmor — Shared Types
+// One CLI command to secure your AI-powered developer workstation.
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Severity = void 0;
+/** Severity levels for scan findings, ordered by criticality. */
+var Severity;
+(function (Severity) {
+    Severity["CRITICAL"] = "CRITICAL";
+    Severity["HIGH"] = "HIGH";
+    Severity["MEDIUM"] = "MEDIUM";
+    Severity["LOW"] = "LOW";
+    Severity["INFO"] = "INFO";
+})(Severity || (exports.Severity = Severity = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,0BAA0B;AAC1B,mEAAmE;AACnE,+DAA+D;;;AAE/D,iEAAiE;AACjE,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,iCAAqB,CAAA;IACrB,yBAAa,CAAA;IACb,6BAAiB,CAAA;IACjB,uBAAW,CAAA;IACX,yBAAa,CAAA;AACf,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "devarmor",
+  "version": "1.0.0",
+  "description": "One CLI command to secure your entire AI-powered developer workstation.",
+  "main": "dist/index.js",
+  "bin": {
+    "devarmor": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "jest --verbose",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "security",
+    "developer-tools",
+    "ai-agent",
+    "secret-scanner",
+    "mcp",
+    "workstation-security",
+    "devarmor",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "glob": "^11.0.0",
+    "ora": "^8.1.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^22.10.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}